@tea-agent/loop-agent 0.10.0-alpha.0 → 0.11.0

package/docs/init-surface.manifest.json

@@ -19,6 +19,7 @@
     "docs/skills/README.md",
     "docs/skills/vetted-skill-registry.md",
     "docs/templates/init-evolution-review.md",
+    "docs/templates/exec-plan.md",
     "docs/templates/production-readiness-checklist.md",
     "docs/templates/frontend-task-requirement.md",
     "docs/templates/frontend-task-constraints.md",
@@ -104,30 +105,6 @@
     ".harness/prompts/analyze.md",
     ".harness/tasks",
     ".harness/dag-runs/active",
-    "skills/agent-worker/SKILL.md",
-    "skills/agent-worker/references/agent-worker-operator.md",
-    "skills/loop-agent/SKILL.md",
-    "skills/loop-agent/references/command-reference.md",
-    "skills/loop-agent/references/docs-converge.md",
-    "skills/ai-engineering-context/SKILL.md",
-    "skills/verification-before-completion/SKILL.md",
-    "skills/systematic-debugging/SKILL.md",
-    "skills/requesting-code-review/SKILL.md",
-    "skills/codebase-scout/SKILL.md",
-    "skills/test-driven-development/SKILL.md",
-    "skills/code-review-core/SKILL.md",
-    "skills/init-capability-evolution/SKILL.md",
-    "skills/webapp-testing/SKILL.md",
-    "skills/frontend-implementation/SKILL.md",
-    "skills/frontend-implementation/references/node-contracts.md",
-    "skills/frontend-implementation/references/design-spec.md",
-    "skills/frontend-implementation/references/code-standards.md",
-    "skills/frontend-design-review/SKILL.md",
-    "skills/frontend-design-review/references/review-checklist.md",
-    "skills/frontend-review/SKILL.md",
-    "skills/frontend-review/references/review-findings.md",
-    "skills/frontend-verification/SKILL.md",
-    "skills/frontend-verification/references/verification-checklist.md",
     ".agents/skills/agent-worker/SKILL.md",
     ".agents/skills/agent-worker/references/agent-worker-operator.md",
     ".agents/skills/loop-agent/SKILL.md",
@@ -141,7 +118,17 @@
     ".agents/skills/test-driven-development/SKILL.md",
     ".agents/skills/code-review-core/SKILL.md",
     ".agents/skills/init-capability-evolution/SKILL.md",
-    ".agents/skills/webapp-testing/SKILL.md"
+    ".agents/skills/webapp-testing/SKILL.md",
+    ".agents/skills/frontend-implementation/SKILL.md",
+    ".agents/skills/frontend-implementation/references/node-contracts.md",
+    ".agents/skills/frontend-implementation/references/design-spec.md",
+    ".agents/skills/frontend-implementation/references/code-standards.md",
+    ".agents/skills/frontend-design-review/SKILL.md",
+    ".agents/skills/frontend-design-review/references/review-checklist.md",
+    ".agents/skills/frontend-review/SKILL.md",
+    ".agents/skills/frontend-review/references/review-findings.md",
+    ".agents/skills/frontend-verification/SKILL.md",
+    ".agents/skills/frontend-verification/references/verification-checklist.md"
   ],
   "initSurface": {
     "README.md": "managed-block",
@@ -182,30 +169,6 @@
     ".harness/tasks": "directory",
     ".harness/dag-runs/active": "directory",
     ".harness/init-surface.json": "state",
-    "skills/agent-worker/SKILL.md": "copied",
-    "skills/agent-worker/references/agent-worker-operator.md": "copied",
-    "skills/loop-agent/SKILL.md": "copied",
-    "skills/loop-agent/references/command-reference.md": "copied",
-    "skills/loop-agent/references/docs-converge.md": "copied",
-    "skills/ai-engineering-context/SKILL.md": "copied",
-    "skills/verification-before-completion/SKILL.md": "copied",
-    "skills/systematic-debugging/SKILL.md": "copied",
-    "skills/requesting-code-review/SKILL.md": "copied",
-    "skills/codebase-scout/SKILL.md": "copied",
-    "skills/test-driven-development/SKILL.md": "copied",
-    "skills/code-review-core/SKILL.md": "copied",
-    "skills/init-capability-evolution/SKILL.md": "copied",
-    "skills/webapp-testing/SKILL.md": "copied",
-    "skills/frontend-implementation/SKILL.md": "copied",
-    "skills/frontend-implementation/references/node-contracts.md": "copied",
-    "skills/frontend-implementation/references/design-spec.md": "copied",
-    "skills/frontend-implementation/references/code-standards.md": "copied",
-    "skills/frontend-design-review/SKILL.md": "copied",
-    "skills/frontend-design-review/references/review-checklist.md": "copied",
-    "skills/frontend-review/SKILL.md": "copied",
-    "skills/frontend-review/references/review-findings.md": "copied",
-    "skills/frontend-verification/SKILL.md": "copied",
-    "skills/frontend-verification/references/verification-checklist.md": "copied",
     ".agents/skills/agent-worker/SKILL.md": "copied",
     ".agents/skills/agent-worker/references/agent-worker-operator.md": "copied",
     ".agents/skills/loop-agent/SKILL.md": "copied",
@@ -219,7 +182,17 @@
     ".agents/skills/test-driven-development/SKILL.md": "copied",
     ".agents/skills/code-review-core/SKILL.md": "copied",
     ".agents/skills/init-capability-evolution/SKILL.md": "copied",
-    ".agents/skills/webapp-testing/SKILL.md": "copied"
+    ".agents/skills/webapp-testing/SKILL.md": "copied",
+    ".agents/skills/frontend-implementation/SKILL.md": "copied",
+    ".agents/skills/frontend-implementation/references/node-contracts.md": "copied",
+    ".agents/skills/frontend-implementation/references/design-spec.md": "copied",
+    ".agents/skills/frontend-implementation/references/code-standards.md": "copied",
+    ".agents/skills/frontend-design-review/SKILL.md": "copied",
+    ".agents/skills/frontend-design-review/references/review-checklist.md": "copied",
+    ".agents/skills/frontend-review/SKILL.md": "copied",
+    ".agents/skills/frontend-review/references/review-findings.md": "copied",
+    ".agents/skills/frontend-verification/SKILL.md": "copied",
+    ".agents/skills/frontend-verification/references/verification-checklist.md": "copied"
   },
   "packageExcluded": [
     "docs/progress/20*.md",

package/docs/loop-agent-harness.md

@@ -16,16 +16,18 @@ loop-agent 提供结构化 agent 工作的本地 harness。
 
 - `skills/loop-agent/` — loop-agent 仓库自有的 skill 指令与参考资料
 - `skills/agent-worker/` — Feature Packet、TaskSpec、Task Pool、controller pinning、自举 candidate canary 与 Worker recovery 的可选 outer-loop operator skill；不是 DAG node skill
-- `skills/<skill-name>/` — DAG 模板引用的 skill 本地副本，含 supervised implementation 角色
+- `.agents/skills/<skill-name>/` — 目标项目 repo-local skill 副本；`skills/<skill-name>/` 仍是 loop-agent 源仓库和 npm 包内置回退路径
 - 历史 `skill/` 不再是必需仓库路径；runtime 查找仅为 `loop-agent` 保留兼容 fallback
 
+目标项目若在 `.agents/skills/` 中提供 `SDD-requirement-analysis`、`SDD-design-analysis`、`SDD-implementation-test-review`，hybrid DAG 生成器会按节点追加对应 skill。该增强只复用 repo-local 知识与方法：loop-agent 仍拥有流程与状态控制权，embedded-mode 约束禁止 SDD 状态推进、确认门禁和归档；初始化/扫描类 SDD skill 不会自动执行。未命中时不会改变默认 DAG。命中的节点 skill 继续由同一 resolved instruction 和 run-owned snapshot 机制冻结，没有第二套 loader 或旁路。
+
 ## Package 资产
 
 npm 包包含运行与说明 harness 所需的静态能力资产：`bin/`、`dist/`、`skills/`（包括 `loop-agent` 与 `agent-worker`）、顶层 `docs/*.md`、`docs/templates/`、`examples/`、`harness.json`、`AGENTS.md`、`README.md`、`CHANGELOG.md`。
 
 生成或历史的 task facts 不是 package 资产。`docs/progress/`、`docs/reports/`、`docs/exec-plans/`、`docs/decisions/` 下现有文件属于目标仓库历史；包只携带这些目录的 README。
 
-从 npm 安装 `loop-agent` 并在其他项目使用时，DAG skill 指令按配置、用户或目标本地 skill 目录解析（若存在），再回退到包内 `skills/`。目标项目可添加本地 skills，但不必复制 loop-agent 源码历史或 `skills/` 目录即可使用默认 DAG 工作流。
+从 npm 安装 `loop-agent` 并在其他项目使用时，DAG skill 指令按配置、用户或目标项目 `.agents/skills/` 解析（若存在），再回退到包内 `skills/`。目标项目可添加本地 skills，但不必复制 loop-agent 源码历史或根 `skills/` 目录即可使用默认 DAG 工作流。
 
 `scripts/self-host-canary.mjs` 是源码仓库维护脚本，不进入 npm package `files`；安装后的 package 不把它作为用户命令 surface。
 
@@ -64,12 +66,15 @@ DAG agent 节点的输出语言由 `harness.json.workflowPolicy.dag.outputLangua
 
 - `new-task`、`status`、`inspect`、`doctor`
 - `dag run-task`、`dag validate`、`run-dag`、`dag report`、`dag resume`、`dag reconcile-run`
+- `plan list`、`plan create`、`plan complete`、`plan check`、`docs audit`、`docs archive`
 - `delegate`、`harvest`、`promote-run`、`closeout`
 - `loop init`、`loop run`、`loop status`、`loop closeout`
 - `pi-prompt`、`cursor-prompt`
-- `docs audit`、`handoff check`、`spine audit`、`knowledge curate`
+- `handoff check`、`spine audit`、`knowledge curate`
 - `agent-worker feature review|run|verify-final|delivery|closeout|approve-followup`、`agent-worker task validate|explain-profile|retry|draft-followup`、`agent-worker batch run-ready`、`agent-worker report morning|metrics`、`agent-worker observe serve|snapshot`
 
+`dag run-task` 在生成 DAG 草稿前会运行与 `plan check` 同源的 exec-plan 索引校验；active plan 与 `docs/exec-plans/active/README.md` 索引不一致时立即失败，避免运行昂贵节点后才在末端 shell verify 发现。`plan create` 优先复用目标项目模板并回退到发布包内置 `docs/templates/exec-plan.md`，`plan create`/`plan complete` 的多文件写入均有回滚保护；`new-task` 不自动绑定 exec-plan。
+
 ## Feature Review
 
 `agent-worker feature review --feature-dir <feature-dir> --repo <target-repo>` 是只读的 Feature 级决策入口。它复用 Feature Packet validation、task graph 和 `.harness/task-pool/` 事实，派生 `Draft`、`Ready`、`Running`、`NeedsAction`、`AwaitingQA`、`Deliverable`、`Closed`，同时展示 required AC 覆盖、阻塞、证据和唯一主行动。

package/docs/progress/README.md

@@ -6,18 +6,24 @@
 
 ## 近期要点（导读）
 
+- [`2026-07-14-init-canonical-layout-handoff.md`](2026-07-14-init-canonical-layout-handoff.md) — 目标项目初始化布局迁移到 `ai_workspace/loop-agent/` 与 `.agents/skills/` 的跨会话交接
+- [`2026-07-14-self-update-notifier-implementation.md`](2026-07-14-self-update-notifier-implementation.md) — loop-agent CLI 自更新提醒实现、TDD 验证和 bounded DAG fallback 交接
 - [`2026-07-14-docs-living-docs-calibration.md`](2026-07-14-docs-living-docs-calibration.md) — 活文档校准（Dynamic Workflow / 六个月 / ADR）
 - [`2026-07-14-docs-governance-hygiene.md`](2026-07-14-docs-governance-hygiene.md) — 文档治理与双树/索引收敛
 - [`2026-07-14-website-docs-ia-and-converge.md`](2026-07-14-website-docs-ia-and-converge.md) — Website 文档 IA 交接
+- [`2026-07-13-sdd-embedded-skills.md`](2026-07-13-sdd-embedded-skills.md) — 目标项目 repo-local SDD skills 的可选 DAG 节点嵌入、验证与基线风险交接
 - [`2026-07-13-dev-controller-001-implementation.md`](2026-07-13-dev-controller-001-implementation.md) — controller identity 实施
 - [`2026-07-13-dev-snapshot-001-implementation.md`](2026-07-13-dev-snapshot-001-implementation.md) — skill snapshot 实施
 - [`2026-07-13-dev-canary-001-implementation.md`](2026-07-13-dev-canary-001-implementation.md) — candidate canary 实施
 
 ## 全量列表（新→旧）
 
+- [`2026-07-14-init-canonical-layout-handoff.md`](2026-07-14-init-canonical-layout-handoff.md)
+- [`2026-07-14-self-update-notifier-implementation.md`](2026-07-14-self-update-notifier-implementation.md)
 - [`2026-07-14-website-docs-ia-and-converge.md`](2026-07-14-website-docs-ia-and-converge.md)
 - [`2026-07-14-docs-living-docs-calibration.md`](2026-07-14-docs-living-docs-calibration.md)
 - [`2026-07-14-docs-governance-hygiene.md`](2026-07-14-docs-governance-hygiene.md)
+- [`2026-07-13-sdd-embedded-skills.md`](2026-07-13-sdd-embedded-skills.md)
 - [`2026-07-13-dev-snapshot-001-implementation.md`](2026-07-13-dev-snapshot-001-implementation.md)
 - [`2026-07-13-dev-controller-001-implementation.md`](2026-07-13-dev-controller-001-implementation.md)
 - [`2026-07-13-dev-canary-001-implementation.md`](2026-07-13-dev-canary-001-implementation.md)

package/docs/reports/README.md

@@ -13,25 +13,35 @@
 ## 近期要点（导读，非权威全集）
 
 - [`current-capability-summary.md`](current-capability-summary.md) — **活**能力摘要（新进展写这里 / CHANGELOG / 新 report）
+- [`2026-07-15-init-canonical-layout-init-evolution-review.md`](2026-07-15-init-canonical-layout-init-evolution-review.md) — init canonical layout、旧布局安全迁移和废弃 harness 字段清理审查
+- [`2026-07-14-self-update-notifier-implementation.md`](2026-07-14-self-update-notifier-implementation.md) — loop-agent CLI 自更新提醒实现、DAG 边界、TDD 与 init surface 非影响证据
 - [`2026-07-14-docs-living-docs-calibration.md`](2026-07-14-docs-living-docs-calibration.md) — 活文档校准（Dynamic Workflow / 六个月 / analysis 冻结 / ADR）
 - [`2026-07-14-docs-governance-hygiene.md`](2026-07-14-docs-governance-hygiene.md) — 文档治理扫描与索引/双树收敛
 - [`2026-07-14-website-docs-ia-and-converge.md`](2026-07-14-website-docs-ia-and-converge.md) — Website IA 与 docs-converge 收口
+- [`2026-07-13-sdd-embedded-skills.md`](2026-07-13-sdd-embedded-skills.md) — repo-local SDD skill 嵌入增强的 DAG、TDD、独立审查、验证和基线风险证据
 - [`2026-07-13-versioned-self-hosting-bootstrap.md`](2026-07-13-versioned-self-hosting-bootstrap.md) — 版本化自举证据
 - [`2026-07-12-m2-completion-audit.md`](2026-07-12-m2-completion-audit.md) — 第二月完成审计
 - [`2026-07-02-repository-analysis.md`](2026-07-02-repository-analysis.md) — **已冻结**仓库能力基线快照（勿再当 CHANGELOG）
 
 ## 全量列表（新→旧）
 
+- [`2026-07-15-init-canonical-layout-init-evolution-review.md`](2026-07-15-init-canonical-layout-init-evolution-review.md)
 - [`dogfood-preflight-static-20260709090443.md`](dogfood-preflight-static-20260709090443.md)
 - [`current-capability-summary.md`](current-capability-summary.md)
 - [`2026-07-14-website-docs-ia-init-evolution-review.md`](2026-07-14-website-docs-ia-init-evolution-review.md)
 - [`2026-07-14-website-docs-ia-and-converge.md`](2026-07-14-website-docs-ia-and-converge.md)
+- [`2026-07-14-self-update-notifier-implementation.md`](2026-07-14-self-update-notifier-implementation.md)
 - [`2026-07-14-docs-living-docs-calibration.md`](2026-07-14-docs-living-docs-calibration.md)
 - [`2026-07-14-docs-governance-hygiene.md`](2026-07-14-docs-governance-hygiene.md)
 - [`2026-07-13-versioned-self-hosting-init-evolution-review.md`](2026-07-13-versioned-self-hosting-init-evolution-review.md)
 - [`2026-07-13-versioned-self-hosting-bootstrap.md`](2026-07-13-versioned-self-hosting-bootstrap.md)
+- [`2026-07-13-test-environment-stability.md`](2026-07-13-test-environment-stability.md)
+- [`2026-07-13-sdd-embedded-skills-init-evolution-review.md`](2026-07-13-sdd-embedded-skills-init-evolution-review.md)
+- [`2026-07-13-sdd-embedded-skills.md`](2026-07-13-sdd-embedded-skills.md)
 - [`2026-07-13-frontend-verification-command-safety-init-evolution-review.md`](2026-07-13-frontend-verification-command-safety-init-evolution-review.md)
 - [`2026-07-13-frontend-skill-contracts-init-evolution-review.md`](2026-07-13-frontend-skill-contracts-init-evolution-review.md)
+- [`2026-07-13-exec-plan-lifecycle-init-evolution-review.md`](2026-07-13-exec-plan-lifecycle-init-evolution-review.md)
+- [`2026-07-13-exec-plan-lifecycle.md`](2026-07-13-exec-plan-lifecycle.md)
 - [`2026-07-12-production-readiness-hardening.md`](2026-07-12-production-readiness-hardening.md)
 - [`2026-07-12-pi-only-agent-runtime-init-evolution-review.md`](2026-07-12-pi-only-agent-runtime-init-evolution-review.md)
 - [`2026-07-12-observe-warm-console-redesign.md`](2026-07-12-observe-warm-console-redesign.md)

package/docs/templates/project-start-checklist.md

@@ -1,9 +1,9 @@
 # 项目开工检查清单
 
 - [ ] 确认 `pwd`
-- [ ] 阅读 `README.md`、`harness.json`、`docs/README.md`
+- [ ] 阅读 `README.md`、`harness.json`，以及 `harness.json.governanceRoot` 指向的 `README.md`
 - [ ] 检查 `git status --short --branch`
 - [ ] 确定单一工作块
-- [ ] 从 `docs/verification-matrix.md` 选择验证命令
+- [ ] 从治理根目录下的 `verification-matrix.md` 选择验证命令
 - [ ] 保留无关用户变更
 - [ ] 非平凡工作时记录 handoff 证据

package/harness.json

@@ -12,8 +12,7 @@
         "minimal": "standard-dag",
         "standard": "standard-dag",
         "reviewed": "review-gated-dag",
-        "supervised": "supervised-implementation",
-        "backend-test": "backend-test-dag"
+        "supervised": "supervised-implementation"
       }
     },
     "humanGatePolicy": {
@@ -59,7 +58,6 @@
   "executors": {
     "pi": {
       "description": "Pi planning, review, diagnosis, and bounded writing when DAG toolProfile=write",
-      "defaultModel": "gpt-5.3-codex-spark",
       "LOW": "gpt-5.3-codex-spark",
       "MED": "grok-4.5",
       "HIGH": "gpt-5.6-sol"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tea-agent/loop-agent",
-  "version": "0.10.0-alpha.0",
+  "version": "0.11.0",
   "type": "module",
   "bin": {
     "loop-agent": "bin/loop-agent.js",
@@ -40,7 +40,7 @@
     "smoke:stale-serial": "node --import tsx/esm scripts/smoke-stale-plan-serial.ts",
     "self-host:canary": "node scripts/self-host-canary.mjs"
   },
-  "dependencies": { "commander": "^12.1.0", "yaml": "^2.9.0", "zod": "^3.25.76" },
+  "dependencies": { "commander": "^12.1.0", "semver": "^7.8.5", "yaml": "^2.9.0", "zod": "^3.25.76" },
   "optionalDependencies": { "@cursor/sdk": "^1.0.7", "@earendil-works/pi-ai": "*", "@earendil-works/pi-coding-agent": "*" },
-  "devDependencies": { "@types/node": "^24.6.0", "tsx": "^4.20.6", "typescript": "^5.9.3", "vitest": "^3.2.4" }
+  "devDependencies": { "@types/node": "^24.6.0", "@types/semver": "^7.7.1", "tsx": "^4.20.6", "typescript": "^5.9.3", "vitest": "^3.2.4" }
 }

package/skills/frontend-implementation/SKILL.md

@@ -5,10 +5,13 @@ description: >-
 references:
   - path: references/node-contracts.md
     required: true
+    maxChars: 3000
   - path: references/design-spec.md
     required: true
+    maxChars: 3000
   - path: references/code-standards.md
     required: true
+    maxChars: 3000
 ---
 
 # Frontend Implementation

package/skills/loop-agent/references/command-reference.md

@@ -303,6 +303,9 @@ loop-agent status <task-id>
 loop-agent docs audit
 loop-agent docs archive docs/exec-plans/active/<plan>.md
 loop-agent plan list
+loop-agent plan create <plan-id> "<title>"
+loop-agent plan complete <plan-id> --summary "<summary>"
+loop-agent plan check
 loop-agent handoff check [task-id]
 loop-agent handoff coverage <task-id> [--json|--markdown]
 ```
@@ -310,6 +313,9 @@ loop-agent handoff coverage <task-id> [--json|--markdown]
 - `docs audit`：扫描文档腐化风险，如 active/completed 漂移、失效链接、host-gap closeout
 - `docs archive`：将 active plan 迁入 completed，并自动重写常见 markdown 引用
 - `plan list`：列出当前 active plans 及其解析状态
+- `plan create`：优先从目标项目模板创建 active exec-plan，不存在时回退发布包内置模板；同步 `active/README.md`，拒绝重复 id、不安全文件名，失败时回滚
+- `plan complete`：将 active exec-plan 标记完成、迁入 completed、追加 `--summary` 并同步 active/completed 索引；失败时回滚所有已触碰文件
+- `plan check`：确定性校验 exec-plan 目录与索引之间的 missing、stale、duplicate、status mismatch；发现问题时输出 JSON 并以非零状态失败
 - `handoff check`：检查任务 source / artifacts / auto-commit scope 是否满足交付闭环
 - `handoff coverage`：从 `source/需求.md` 抽取 checklist / numbered / `REQ-*` 项并输出 coverage audit；未覆盖项 exit 1；`explicitly_out_of_scope` 不计为缺口
 

package/skills/loop-agent/references/docs-converge.md

@@ -1,9 +1,9 @@
-# Docs Converge（文档收敛）
+# Docs Converge（文档收敛）
 
-本 reference 把会话协议中的 **Converge Docs** 落成可执行检查表。  
+本 reference 把会话协议中的 **Converge Docs** 落成可执行检查表。
 定位是**收敛 / 同步**，不是「每次重新 invent 文档大纲」。
 
-权威规划：`docs/exec-plans/completed/2026-07-14-website-docs-ia-and-converge.md`。  
+权威规划：`docs/exec-plans/completed/2026-07-14-website-docs-ia-and-converge.md`。
 站与治理双树边界：`website/README.md`。
 
 ## 何时触发
@@ -61,8 +61,8 @@
 跨树链接规则：
 
 - 站内页面用 Docusaurus 相对文档链接。
-- 链到根目录 `docs/`、`AGENTS.md`、`CHANGELOG.md` 等时，使用  
-  `https://github.com/tea-agent/loop-agent/blob/main/<repo-path>`，  
+- 链到根目录 `docs/`、`AGENTS.md`、`CHANGELOG.md` 等时，使用
+  `https://github.com/tea-agent/loop-agent/blob/main/<repo-path>`，
   正文同时写出 repo-relative path；禁止伪造站内 `/docs/architecture/...` 作为根目录文档路由。
 
 ## 执行步骤（最小闭环）

package/skills/loop-agent/references/task-workflow.md

@@ -77,7 +77,7 @@ loop-agent --repo-root /path/to/target-repo <command>
 
 ## Verification
 
-完成声明必须来自新鲜验证证据。按目标 repo 的 `docs/verification-matrix.md` 选择最小证明命令；loop-agent 自身常用：
+完成声明必须来自新鲜验证证据。按目标 repo 的 `harness.json.governanceRoot` 下 `verification-matrix.md` 选择最小证明命令；loop-agent 自身常用：
 
 ```bash
 npm run typecheck

package/docs/templates/backend-test-dag.generate-pytest.prompt.md

@@ -1,131 +0,0 @@
-# Backend Test DAG Generate Pytest Prompt Template
-
-## Purpose
-
-Use this prompt for a **pytest code generation** node: `executor: "pi"`, `role: "implementer"`, `toolProfile: "write"`, `writePolicy: "exclusive"`. The implementer converts reviewed backend functional test cases into pytest automation code with 1:1 traceability.
-
-Do **not** create a new executor type. This is a standard `executor: pi` writer node.
-
-## Recommended DAG Node Shape
-
-```json
-{
-  "id": "generate-backend-pytest-pi",
-  "depends_on": ["review-backend-cases-pi"],
-  "complexity": "HIGH",
-  "executor": "pi",
-  "role": "implementer",
-  "toolProfile": "write",
-  "writePolicy": "exclusive",
-  "writeSet": ["testcase/**"],
-  "allowedPaths": ["testcase/**"],
-  "forbiddenPaths": [".harness/**", "artifacts/**"],
-  "outputContract": "Pytest test files under tests/backend/ with 1:1 mapping to functional test case IDs. Summary lists generated files, test function count, and any skipped cases with reasons.",
-  "subtask_prompt_markdown": "./backend-test-dag.generate-pytest.prompt.md"
-}
-```
-
-## Prompt Body
-
-You are the Backend Test DAG **pytest code generator**.
-
-Your job is to convert reviewed backend functional test cases into pytest automation code. You are an implementer — write test files under `tests/backend/` only. Stay within `writeSet`. Do not write root `artifacts/**`.
-
-### Mandatory First Line
-
-The **first non-empty line** of your response must be a summary line:
-
-```
-Generated N pytest functions across M files under tests/backend/.
-```
-
-### Inputs
-
-1. **Reviewed test cases** — files under `testcase/md/` (approved by `review-backend-cases-pi` with `VERDICT: pass`).
-2. **Source references** — `source/references/` for API specs, data models, database schemas.
-3. **Target project conventions** — inspect `conftest.py`, `pytest.ini` / `pyproject.toml` pytest config, fixture patterns, existing test structure.
-
-### Conversion Rules
-
-#### File Naming
-
-- Every test file must start with `test_` prefix (e.g. `test_order.py`, `test_user_api.py`)
-- pytest collects tests from files matching `test_*.py` or `*_test.py` — use `test_` prefix exclusively
-- Never create test files without the `test_` prefix
-
-#### Write Boundary
-
-- Only **create new** test script files under `testcase/`
-- Do NOT modify existing files: `conftest.py`, `pytest.ini`, `pyproject.toml`, `setup.cfg`, `__init__.py`, or any other framework/config file
-- If the project needs new fixtures, create them in new files (e.g. `testcase/conftest.py` if it does not exist), never edit existing ones
-- Read existing framework files to understand conventions, but treat them as immutable
-
-#### Naming Conflict Resolution
-
-- If a file with the target name already exists under `testcase/`, add a numeric suffix: `test_order.py` → `test_order_01.py` → `test_order_02.py`
-- Never overwrite or append to existing files — each test script must be a standalone file
-- Check for existing files before writing; if `test_<module>.py` exists, use `test_<module>_01.py`
-
-#### 1:1 Traceability
-
-Every functional test case ID (`BE-<MODULE>-<NNN>`) must map to exactly one pytest function:
-
-```python
-# test-cases/backend/BE-ORDER-001 → tests/backend/test_order.py
-def test_BE_ORDER_001_create_order_with_valid_data():
-    """BE-ORDER-001: Create order with valid request body."""
-    ...
-```
-
-- Function name: `test_<CASE_ID_with_underscores>` (e.g. `test_BE_ORDER_001_...`)
-- Docstring first line: `<CASE_ID>: <Case Title>`
-
-#### File Organization
-
-- All test files go under `testcase/` directory in the host project root
-- Group test files by MODULE segment: `BE-ORDER-*` → `testcase/test_order.py`, `BE-USER-*` → `testcase/test_user.py`
-- Follow existing project conventions for import style, fixture scope
-
-#### Fixture Strategy
-
-- Reuse existing project fixtures from `conftest.py` when available
-- Create new fixtures only when test data setup is complex or shared across cases
-- Prefer `@pytest.fixture(scope="function")` for test isolation
-- Use `@pytest.mark.parametrize` for boundary condition cases with multiple inputs
-
-#### Test Integrity
-
-- Tests verify implementation correctness — if a test fails, the implementation likely has a bug, not the test
-- Do NOT weaken assertions, remove test cases, or modify test logic to make tests pass
-- Do NOT add workarounds, skips, or try/except blocks to hide failures without explicit justification
-- Report all failures honestly in the output; the downstream `execute-backend-pytest-shell` node captures exit codes and stdout/stderr as-is
-
-#### Assertions
-
-- Use `assert` statements, not `unittest` assertions
-- Assert specific values, not just "no exception"
-- For API tests: assert status code, response body keys, and specific field values
-- For database tests: assert record state after operation
-
-#### Markers
-
-- `@pytest.mark.positive` — happy path cases
-- `@pytest.mark.negative` — error/exception cases
-- `@pytest.mark.boundary` — edge cases
-- `@pytest.mark.<MODULE>` — module-specific marker (e.g. `@pytest.mark.order`)
-
-#### Skip Policy
-
-If a test case cannot be automated (requires external service not mockable, requires manual verification), add it with `@pytest.mark.skip(reason="...")` and document the reason. Do not omit the function — traceability requires it exists.
-
-### Output Shape (after summary line)
-
-After the mandatory summary line, provide:
-
-1. **Generated Files** — list of files written under `tests/backend/`.
-2. **Function Mapping Table** — `| Test Case ID | Pytest Function | File | Marker |`.
-3. **Skipped Cases** — if any, list with reason.
-4. **Conventions Observed** — note project fixtures/config discovered and followed.
-5. **Residual Risks** — cases that may need manual verification or environment setup.
-
-Do not include chain-of-thought. Do not write root `artifacts/**`.