四类文档

<!-- PM Agent 维护，每次人类反馈追加 section -->
<article data-doc="prd" data-rev="3">
  <h1>Auto Auth System</h1>

  <section data-rev="1">
    <h3>登录</h3>
    <p>用户名密码登录，会话 7 天有效。</p>
  </section>

  <section data-rev="3" data-origin="yibo@2026-05-13">
    <h3>OAuth 登录</h3>
    <p>支持 GitHub OAuth。Token 刷新 ≤ 5s。</p>
  </section>

  <footer data-changelog>
    <p>rev 1 · init · 邮箱密码登录</p>
    <p>rev 2 · yibo · 加个人主页</p>
    <p>rev 3 · yibo · GitHub OAuth</p>
  </footer>
</article>

<!-- Architect 生成；嵌入可机读 unit 元数据 -->
<article data-doc="sdd" data-derived-from="prd@rev3">
  <section data-unit-id="auth-be" data-type="be"
           data-depends="">
    <h3>Unit · auth-be</h3>
    <p>提供登录 / 注册 / token 校验端点</p>
    <pre data-contract="openapi">
      POST /api/auth/login
        request:  { email, password }
        response: 200 { token } | 401 { error:"invalid_credentials" }
    </pre>
    <ul data-acceptance>
      <li>有效凭据 → 200 + JWT</li>
      <li>user 不存在 → 401 invalid_credentials</li>
    </ul>
  </section>
  <!-- 更多 section ... -->
</article>

{
  "project_id": "p-001",
  "prd_rev": "3",
  "sdd_rev": "5",
  "units": [
    {
      "id": "auth-be",
      "type": "be",
      "status": "passed",
      "depends_on": [],
      "retries": 1,
      "retry_budget": 5,
      "contract_hash": "sha256:7f3a...",
      "last_run": "run-20260513-0731"
    },
    {
      "id": "auth-fe",
      "type": "fe",
      "status": "testing",
      "depends_on": ["auth-be"],
      "retries": 0,
      "retry_budget": 5,
      "contract_hash": "sha256:9c1d..."
    }
  ],
  "l2_rounds": 0,
  "l2_budget": 3
}

{
  "run_id": "run-20260513-0731",
  "loop": "L1",
  "unit_id": "auth-be",
  "agent": "tester",
  "attempt": 2,
  "summary": { "total": 8, "passed": 7, "failed": 1 },
  "ok": false,
  "failures": [
    { "test": "login.invalid-pwd",
      "expected": 401, "got": 500,
      "stack": "TypeError: ...",
      "hint": "先查 user 再 bcrypt 比对" }
  ],
  "next_action": "retry_coder",
  "retry_budget_left": 3,
  "duration_ms": 1245
}