@tea-agent/loop-agent 0.13.0-beta.0 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (282) hide show
  1. package/AGENTS.md +157 -155
  2. package/CHANGELOG.md +301 -322
  3. package/README.md +335 -345
  4. package/bin/agent-worker.js +22 -22
  5. package/bin/loop-agent.js +21 -21
  6. package/dist/commands/cursor-prompt.js +6 -6
  7. package/dist/commands/init.js +597 -528
  8. package/dist/commands/loop-benchmark.js +11 -11
  9. package/dist/commands/pi-reuse-benchmark.js +16 -16
  10. package/dist/executors/shell-executor.js +200 -21
  11. package/dist/infrastructure/evaluation/candidate-store.js +5 -1
  12. package/dist/sidecars/cursor-prompt/executor.js +1 -1
  13. package/dist/task/runtime.js +27 -27
  14. package/dist/worker/observe/static/api.js +46 -46
  15. package/dist/worker/observe/static/app.js +150 -150
  16. package/dist/worker/observe/static/constants.js +148 -148
  17. package/dist/worker/observe/static/copy.js +67 -67
  18. package/dist/worker/observe/static/dag-helpers.js +172 -172
  19. package/dist/worker/observe/static/dag-layout.d.ts +31 -31
  20. package/dist/worker/observe/static/dag-layout.js +83 -83
  21. package/dist/worker/observe/static/dag-model.js +72 -72
  22. package/dist/worker/observe/static/dom.js +212 -53
  23. package/dist/worker/observe/static/format-pool.js +67 -67
  24. package/dist/worker/observe/static/format.js +292 -292
  25. package/dist/worker/observe/static/index.html +308 -308
  26. package/dist/worker/observe/static/kpi.js +94 -94
  27. package/dist/worker/observe/static/relations.js +133 -133
  28. package/dist/worker/observe/static/router.js +93 -93
  29. package/dist/worker/observe/static/run-processing.js +148 -148
  30. package/dist/worker/observe/static/shell-chrome.js +68 -68
  31. package/dist/worker/observe/static/state.js +267 -253
  32. package/dist/worker/observe/static/styles.css +1902 -1902
  33. package/dist/worker/observe/static/views/batch.js +227 -227
  34. package/dist/worker/observe/static/views/dag-graph.js +172 -172
  35. package/dist/worker/observe/static/views/dag-inspector.js +627 -607
  36. package/dist/worker/observe/static/views/dag.js +371 -362
  37. package/dist/worker/observe/static/views/dashboard.js +509 -252
  38. package/dist/worker/observe/static/views/failures.js +143 -143
  39. package/dist/worker/observe/static/views/feature.js +492 -492
  40. package/dist/worker/observe/static/views/pool.js +350 -350
  41. package/dist/worker/observe/static/views/run.js +453 -453
  42. package/dist/worker/observe/static/views/session-timeline.js +219 -205
  43. package/dist/worker/observe/static/views/shell.js +7 -7
  44. package/dist/worker/observe/static/views/task.js +314 -314
  45. package/dist/worker/observe/static/views/timeline.js +163 -163
  46. package/dist/workflows/dag/backend-test-case-manifest.js +503 -0
  47. package/dist/workflows/dag/backend-test-execution-contract.js +353 -0
  48. package/dist/workflows/dag/backend-test-result-contract.js +568 -0
  49. package/dist/workflows/dag/canvas-observer.js +275 -275
  50. package/dist/workflows/dag/decision-envelope.js +57 -2
  51. package/dist/workflows/dag/frontend-implementation-contract.js +240 -0
  52. package/dist/workflows/dag/frontend-project-capability.js +309 -0
  53. package/dist/workflows/dag/frontend-repair.js +341 -0
  54. package/dist/workflows/dag/frontend-risk.js +161 -0
  55. package/dist/workflows/dag/frontend-verification-trace.js +190 -0
  56. package/dist/workflows/dag/init-hybrid.js +1020 -125
  57. package/dist/workflows/dag/repair-artifact.js +43 -3
  58. package/dist/workflows/dag/skill-instructions.js +4 -2
  59. package/dist/workflows/dag/types.js +29 -8
  60. package/docs/README.md +105 -104
  61. package/docs/agent-dag-recovery-playbook.md +195 -195
  62. package/docs/agent-dag-runner.md +67 -67
  63. package/docs/architecture/README.md +26 -26
  64. package/docs/architecture/dag-execution.md +140 -140
  65. package/docs/architecture/evolution.md +54 -54
  66. package/docs/architecture/facts-and-state.md +71 -71
  67. package/docs/architecture/runtime-boundaries.md +191 -191
  68. package/docs/architecture/system-overview.md +93 -93
  69. package/docs/architecture/worker-and-feature.md +85 -85
  70. package/docs/cursor-prompt-sidecar.md +36 -36
  71. package/docs/decisions/README.md +18 -18
  72. package/docs/design/README.md +167 -167
  73. package/docs/development-principles.md +73 -73
  74. package/docs/exec-plans/README.md +6 -6
  75. package/docs/exec-plans/active/README.md +1 -4
  76. package/docs/exec-plans/completed/README.md +106 -84
  77. package/docs/feature-workflow.md +414 -389
  78. package/docs/harness-methodology-debugging.md +153 -153
  79. package/docs/harness-methodology-tdd.md +130 -130
  80. package/docs/harness-methodology-verification.md +27 -27
  81. package/docs/init-surface.manifest.json +307 -289
  82. package/docs/loop-agent-harness.md +142 -142
  83. package/docs/production-readiness.md +96 -96
  84. package/docs/progress/README.md +76 -60
  85. package/docs/reports/README.md +150 -108
  86. package/docs/skills/README.md +7 -7
  87. package/docs/skills/vetted-skill-registry.md +29 -29
  88. package/docs/templates/adr.md +60 -60
  89. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  90. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  91. package/docs/templates/agent-dag-decision-gate-dogfood-report.md +117 -117
  92. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  93. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  94. package/docs/templates/agent-dag-report.schema.json +473 -473
  95. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  96. package/docs/templates/agent-dag.base.json +190 -190
  97. package/docs/templates/agent-dag.final-verification.json +185 -185
  98. package/docs/templates/agent-dag.schema.json +411 -411
  99. package/docs/templates/agent-dag.supervised-implementation.json +620 -501
  100. package/docs/templates/backend-test-analysis.schema.json +44 -44
  101. package/docs/templates/backend-test-case-manifest.schema.json +190 -0
  102. package/docs/templates/backend-test-dag.classify.prompt.md +75 -0
  103. package/docs/templates/backend-test-dag.generate-pytest.prompt.md +204 -202
  104. package/docs/templates/backend-test-dag.json +559 -311
  105. package/docs/templates/backend-test-dag.retrospect.prompt.md +139 -125
  106. package/docs/templates/backend-test-dag.review-cases.prompt.md +83 -81
  107. package/docs/templates/backend-test-execution.schema.json +133 -0
  108. package/docs/templates/backend-test-result.schema.json +99 -0
  109. package/docs/templates/branch-merge-report.md +93 -0
  110. package/docs/templates/exec-plan.md +64 -64
  111. package/docs/templates/feature-spec.md +53 -53
  112. package/docs/templates/frontend-design-contract.md +42 -42
  113. package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md +17 -0
  114. package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md +16 -0
  115. package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md +16 -0
  116. package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md +16 -0
  117. package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md +16 -0
  118. package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md +16 -0
  119. package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md +21 -0
  120. package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md +29 -0
  121. package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md +28 -0
  122. package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md +28 -0
  123. package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md +29 -0
  124. package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md +27 -0
  125. package/docs/templates/frontend-eval/fixtures/functional/06-ssr-server-client-boundary.md +28 -0
  126. package/docs/templates/frontend-eval/fixtures/functional/07-shared-public-component-api.md +28 -0
  127. package/docs/templates/frontend-eval/fixtures/functional/08-pure-local-no-remote.md +27 -0
  128. package/docs/templates/frontend-eval/metrics.md +138 -0
  129. package/docs/templates/frontend-eval/smoke-targets.md +53 -0
  130. package/docs/templates/frontend-implementation-contract.schema.json +27 -0
  131. package/docs/templates/frontend-task-constraints.md +35 -35
  132. package/docs/templates/frontend-task-requirement.md +70 -70
  133. package/docs/templates/frontend-test-dag.generate-cases.prompt.md +5 -5
  134. package/docs/templates/frontend-test-dag.json +23 -23
  135. package/docs/templates/frontend-test-dag.retrieve-context.prompt.md +3 -3
  136. package/docs/templates/frontend-test-dag.retrospect.prompt.md +3 -3
  137. package/docs/templates/frontend-test-dag.review-cases.prompt.md +3 -3
  138. package/docs/templates/frontend-test-dag.review-execution.prompt.md +3 -3
  139. package/docs/templates/harness.schema.json +221 -221
  140. package/docs/templates/hybrid-dag.json +188 -188
  141. package/docs/templates/init-evolution-review.md +35 -35
  142. package/docs/templates/interactive-ui-round2-experiment.md +66 -66
  143. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -118
  144. package/docs/templates/knowledge-sync-dag.json +178 -178
  145. package/docs/templates/knowledge-sync-draft.schema.json +71 -71
  146. package/docs/templates/product-line/AGENTS.md +8 -8
  147. package/docs/templates/product-line/README.md +9 -9
  148. package/docs/templates/product-line/acceptance.yaml +14 -14
  149. package/docs/templates/product-line/closeout.yaml +9 -9
  150. package/docs/templates/product-line/design.md +13 -13
  151. package/docs/templates/product-line/links.md +10 -10
  152. package/docs/templates/product-line/requirement.md +17 -17
  153. package/docs/templates/product-line/task-graph.yaml +15 -15
  154. package/docs/templates/product-line/task.yaml +64 -64
  155. package/docs/templates/product-line/test-plan.md +7 -7
  156. package/docs/templates/production-readiness-checklist.md +57 -57
  157. package/docs/templates/progress-log.md +17 -17
  158. package/docs/templates/project-start-checklist.md +9 -9
  159. package/docs/templates/qa-report.md +48 -48
  160. package/docs/templates/sprint-contract.md +29 -29
  161. package/docs/templates/worker-dogfood-evidence.md +80 -80
  162. package/docs/templates/worker-dogfood-setup.md +68 -68
  163. package/docs/verification-matrix.md +70 -70
  164. package/examples/decision-gate-agent-dag.json +177 -177
  165. package/examples/example-dag.json +46 -46
  166. package/examples/hybrid-loop-agent-dag.json +189 -189
  167. package/harness.json +66 -66
  168. package/package.json +52 -88
  169. package/scripts/check-product-line-docs.sh +29 -29
  170. package/scripts/check-task-pool-root.sh +32 -32
  171. package/scripts/kb-bootstrap-init-skeleton.sh +240 -240
  172. package/scripts/kb-graph-incremental-prepare.mjs +386 -386
  173. package/scripts/kb-graph-incremental-prepare.sh +5 -5
  174. package/scripts/kb-graph-materialize.mjs +105 -105
  175. package/scripts/kb-graph-materialize.sh +4 -4
  176. package/scripts/kb-graph-promote.mjs +164 -164
  177. package/scripts/kb-graph-promote.sh +4 -4
  178. package/scripts/kb-query.mjs +554 -554
  179. package/scripts/kb-query.sh +5 -5
  180. package/skills/agent-worker/SKILL.md +39 -39
  181. package/skills/agent-worker/references/agent-worker-operator.md +60 -60
  182. package/skills/ai-engineering-context/SKILL.md +48 -48
  183. package/skills/analyze-product-dependencies/SKILL.md +67 -67
  184. package/skills/analyze-product-dependencies/agents/openai.yaml +4 -4
  185. package/skills/analyze-product-dependencies/references/api-documentation-schema.md +30 -30
  186. package/skills/analyze-product-dependencies/references/dependency-analysis-schema.md +28 -28
  187. package/skills/analyze-product-dependencies/references/example.md +76 -76
  188. package/skills/analyze-product-dependencies/references/forward-test-cases.md +35 -35
  189. package/skills/analyze-product-dependencies/references/input-contract.md +11 -11
  190. package/skills/analyze-product-dependencies/references/scouting-rules.md +61 -61
  191. package/skills/analyze-product-dependencies/scripts/test-validators.mjs +267 -267
  192. package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +101 -101
  193. package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +142 -142
  194. package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +76 -76
  195. package/skills/analyze-product-dependencies/scripts/validation-helpers.mjs +146 -146
  196. package/skills/analyze-product-requirements/SKILL.md +90 -90
  197. package/skills/analyze-product-requirements/agents/openai.yaml +4 -4
  198. package/skills/analyze-product-requirements/references/acceptance-criteria.md +91 -91
  199. package/skills/analyze-product-requirements/references/clarification-and-knowledge.md +56 -56
  200. package/skills/analyze-product-requirements/references/example.md +86 -86
  201. package/skills/analyze-product-requirements/references/forward-test-cases.md +66 -66
  202. package/skills/analyze-product-requirements/references/product-analysis-schema.md +32 -32
  203. package/skills/analyze-product-requirements/references/product-requirement-schema.md +33 -33
  204. package/skills/analyze-product-requirements/references/requirement-clarification-schema.md +35 -35
  205. package/skills/analyze-product-requirements/scripts/test-validators.mjs +193 -193
  206. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +69 -69
  207. package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +97 -97
  208. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +98 -98
  209. package/skills/analyze-product-requirements/scripts/validation-helpers.mjs +156 -156
  210. package/skills/browser-tools/SKILL.md +196 -0
  211. package/skills/browser-tools/browser-content.js +103 -0
  212. package/skills/browser-tools/browser-cookies.js +35 -0
  213. package/skills/browser-tools/browser-eval.js +53 -0
  214. package/skills/browser-tools/browser-hn-scraper.js +108 -0
  215. package/skills/browser-tools/browser-nav.js +44 -0
  216. package/skills/browser-tools/browser-pick.js +162 -0
  217. package/skills/browser-tools/browser-screenshot.js +34 -0
  218. package/skills/browser-tools/browser-start.js +86 -0
  219. package/skills/browser-tools/package-lock.json +2556 -0
  220. package/skills/browser-tools/package.json +19 -0
  221. package/skills/code-review-core/SKILL.md +20 -20
  222. package/skills/codebase-scout/SKILL.md +19 -19
  223. package/skills/frontend-design-review/SKILL.md +66 -66
  224. package/skills/frontend-design-review/references/review-checklist.md +58 -58
  225. package/skills/frontend-implementation/SKILL.md +49 -47
  226. package/skills/frontend-implementation/references/code-standards.md +32 -32
  227. package/skills/frontend-implementation/references/design-spec.md +46 -46
  228. package/skills/frontend-implementation/references/node-contracts.md +27 -76
  229. package/skills/frontend-review/SKILL.md +59 -59
  230. package/skills/frontend-review/references/review-findings.md +47 -47
  231. package/skills/frontend-verification/SKILL.md +53 -53
  232. package/skills/frontend-verification/references/verification-checklist.md +68 -68
  233. package/skills/grill-me/SKILL.md +10 -10
  234. package/skills/grill-with-docs/SKILL.md +88 -88
  235. package/skills/grill-with-docs/adr-format.md +47 -47
  236. package/skills/grill-with-docs/context-format.md +60 -60
  237. package/skills/init-capability-evolution/SKILL.md +70 -70
  238. package/skills/loop-agent/SKILL.md +151 -151
  239. package/skills/loop-agent/references/README.md +67 -67
  240. package/skills/loop-agent/references/command-reference.md +527 -505
  241. package/skills/loop-agent/references/docs-converge.md +126 -126
  242. package/skills/loop-agent/references/harness-policy.md +263 -263
  243. package/skills/loop-agent/references/hybrid-dag.md +243 -238
  244. package/skills/loop-agent/references/learned/README.md +21 -21
  245. package/skills/loop-agent/references/long-running-loop.md +57 -57
  246. package/skills/loop-agent/references/model-routing.md +36 -36
  247. package/skills/loop-agent/references/multi-worktree.md +54 -54
  248. package/skills/loop-agent/references/one-shot-runs.md +85 -85
  249. package/skills/loop-agent/references/orchestrator-and-interventions.md +169 -169
  250. package/skills/loop-agent/references/pi-prompt.md +23 -23
  251. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
  252. package/skills/loop-agent/references/post-implementation-and-patterns.md +44 -44
  253. package/skills/loop-agent/references/task-workflow.md +89 -89
  254. package/skills/loop-agent/references/verification-and-failure-handling.md +141 -139
  255. package/skills/playwright-cli/SKILL.md +420 -420
  256. package/skills/playwright-cli/references/element-attributes.md +23 -23
  257. package/skills/playwright-cli/references/playwright-tests.md +39 -39
  258. package/skills/playwright-cli/references/request-mocking.md +87 -87
  259. package/skills/playwright-cli/references/running-code.md +241 -241
  260. package/skills/playwright-cli/references/session-management.md +225 -225
  261. package/skills/playwright-cli/references/storage-state.md +275 -275
  262. package/skills/playwright-cli/references/test-generation.md +433 -433
  263. package/skills/playwright-cli/references/tracing.md +139 -139
  264. package/skills/playwright-cli/references/video-recording.md +143 -143
  265. package/skills/playwright-cli-case-generator/SKILL.md +74 -74
  266. package/skills/requesting-code-review/SKILL.md +101 -101
  267. package/skills/requesting-code-review/code-reviewer.md +168 -168
  268. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  269. package/skills/systematic-debugging/SKILL.md +296 -296
  270. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  271. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  272. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  273. package/skills/systematic-debugging/find-polluter.sh +63 -63
  274. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  275. package/skills/systematic-debugging/test-academic.md +14 -14
  276. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  277. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  278. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  279. package/skills/test-driven-development/SKILL.md +20 -20
  280. package/skills/using-git-worktrees/SKILL.md +215 -215
  281. package/skills/verification-before-completion/SKILL.md +154 -154
  282. package/skills/webapp-testing/SKILL.md +19 -19
@@ -1,73 +1,73 @@
1
- # 开发原则
2
-
3
- loop-agent 是面向 agentic coding 的工作流 runtime。仓库应保持小而显式、可验证。
4
-
5
- ## 操作立场
6
-
7
- 项目采用「人类掌舵、智能体执行」的工程模型。Agent 可实现、验证与总结,但持久意图与完成证据必须落在仓库中。
8
-
9
- 这个模型吸收了 Anthropic 长时运行 agent harness、OpenAI Codex harness engineering、腾讯端到端 Harness Engineering 和社区 agent harness 实践中的共同经验:用短入口文档导航长期知识,用结构化任务状态和 handoff artifact 跨 session 传递事实,用独立验证和评审回路约束 agent 输出,并把人类注意力集中在意图、边界、架构和反馈系统上。面向使用者的背景资料收录在 `website/docs/practices/`。
10
-
11
- - 仓库是记录系统。决策、契约、计划、测试、报告与交接属于 tracked files。
12
- - `AGENTS.md` 是操作地图,不是知识 dump。长期方法论与决策属于 `docs/`。
13
- - 工作以小步、可逆、可验证的增量推进。
14
- - 状态不确定时,先跑基线验证再开新工。
15
- - 完成由新鲜证据定义,而非意图或信心。
16
-
17
- ## 原则
18
-
19
- 1. 一次任务只推进一个有边界的工作块。
20
- 2. 设计新行为前先搜索现有代码、文档、脚本与测试。
21
- 3. Shell 验证是完成权威。
22
- 4. Runtime 状态在 `.harness/`;持久决策在 `docs/`。
23
- 5. Pi writer 节点必须由显式 allowed/forbidden paths 与 writeSet 约束;Cursor 仅可作为 `cursor-prompt` one-shot sidecar,不进入受治理 DAG/Loop 写入路径。
24
- 6. Pi review/planning 路径是 advisory,除非后跟确定性验证。
25
- 7. 反复出现的约束应固化为文档、测试、脚本、检查或模板。
26
- 8. 不要把隐藏流程状态只留在聊天里。
27
- 9. 不要把占位实现当作已完成交付。
28
- 10. 新增抽象前先沿用现有局部模式。
29
-
30
- ## 仓库结构
31
-
32
- - 源码:`src/`
33
- - 测试:`test/`
34
- - Skill 指令:源码仓库和 npm 包内置在 `skills/`,目标项目 repo-local skills 在 `.agents/skills/`
35
- - 验证与维护脚本:`scripts/`
36
- - 治理与交接产物:`docs/`
37
-
38
- ## 变更纪律
39
-
40
- 行为变更要更新测试;工作流或命令变更要更新文档与示例;治理变更要更新 `harness.json` 与相关检查脚本。
41
-
42
- 当工作影响需求、行为、跨命令契约或 harness 规则时,更新对应持久产物:
43
-
44
- - 设计/契约文档 — 变更后的预期
45
- - 测试或验证脚本 — 变更后的行为
46
- - progress log 或 report — 非平凡交接证据
47
- - ADR — 架构或公开契约决策
48
- - 模板 — 重复流程可复用时
49
-
50
- 除非 contract 明确说明必须一起移动,否则不要在一个工作块里混合无关重构、新功能与大规模文档迁移。
51
-
52
- ## 搜索与复用
53
-
54
- 实现前先检视现有系统:
55
-
56
- - 仓库已索引且任务需要理解代码时,优先用 CodeGraph。
57
- - 可用时用 `rg` 做文本搜索、`fd` 找文件。
58
- - 引入新 helper 前先读邻近测试与 helper。
59
- - 优先结构化 parser 与现有本地 API,避免 ad hoc 字符串处理。
60
-
61
- 在搜索证明否则之前,假设系统可能已有部分解法。
62
-
63
- ## 完成纪律
64
-
65
- 完成声明必须回答:
66
-
67
- - 改了什么
68
- - 为何选此方案
69
- - 哪条命令验证、结果如何
70
- - 是否影响契约、文档、测试或脚本
71
- - 剩余风险或后续项
72
-
73
- 验证失败时,报告失败命令与观察到的状态,而不是软化完成定义。
1
+ # 开发原则
2
+
3
+ loop-agent 是面向 agentic coding 的工作流 runtime。仓库应保持小而显式、可验证。
4
+
5
+ ## 操作立场
6
+
7
+ 项目采用「人类掌舵、智能体执行」的工程模型。Agent 可实现、验证与总结,但持久意图与完成证据必须落在仓库中。
8
+
9
+ 这个模型吸收了 Anthropic 长时运行 agent harness、OpenAI Codex harness engineering、腾讯端到端 Harness Engineering 和社区 agent harness 实践中的共同经验:用短入口文档导航长期知识,用结构化任务状态和 handoff artifact 跨 session 传递事实,用独立验证和评审回路约束 agent 输出,并把人类注意力集中在意图、边界、架构和反馈系统上。面向使用者的背景资料收录在 `website/docs/practices/`。
10
+
11
+ - 仓库是记录系统。决策、契约、计划、测试、报告与交接属于 tracked files。
12
+ - `AGENTS.md` 是操作地图,不是知识 dump。长期方法论与决策属于 `ai_workspace/loop-agent/`。
13
+ - 工作以小步、可逆、可验证的增量推进。
14
+ - 状态不确定时,先跑基线验证再开新工。
15
+ - 完成由新鲜证据定义,而非意图或信心。
16
+
17
+ ## 原则
18
+
19
+ 1. 一次任务只推进一个有边界的工作块。
20
+ 2. 设计新行为前先搜索现有代码、文档、脚本与测试。
21
+ 3. Shell 验证是完成权威。
22
+ 4. Runtime 状态在 `.harness/`;持久决策在 `ai_workspace/loop-agent/`。
23
+ 5. Pi writer 节点必须由显式 allowed/forbidden paths 与 writeSet 约束;Cursor 仅可作为 `cursor-prompt` one-shot sidecar,不进入受治理 DAG/Loop 写入路径。
24
+ 6. Pi review/planning 路径是 advisory,除非后跟确定性验证。
25
+ 7. 反复出现的约束应固化为文档、测试、脚本、检查或模板。
26
+ 8. 不要把隐藏流程状态只留在聊天里。
27
+ 9. 不要把占位实现当作已完成交付。
28
+ 10. 新增抽象前先沿用现有局部模式。
29
+
30
+ ## 仓库结构
31
+
32
+ - 源码:`src/`
33
+ - 测试:`test/`
34
+ - Skill 指令:源码仓库和 npm 包内置在 `.agents/skills/`,目标项目 repo-local skills 在 `.agents/skills/`
35
+ - 验证与维护脚本:`scripts/`
36
+ - 治理与交接产物:`ai_workspace/loop-agent/`
37
+
38
+ ## 变更纪律
39
+
40
+ 行为变更要更新测试;工作流或命令变更要更新文档与示例;治理变更要更新 `harness.json` 与相关检查脚本。
41
+
42
+ 当工作影响需求、行为、跨命令契约或 harness 规则时,更新对应持久产物:
43
+
44
+ - 设计/契约文档 — 变更后的预期
45
+ - 测试或验证脚本 — 变更后的行为
46
+ - progress log 或 report — 非平凡交接证据
47
+ - ADR — 架构或公开契约决策
48
+ - 模板 — 重复流程可复用时
49
+
50
+ 除非 contract 明确说明必须一起移动,否则不要在一个工作块里混合无关重构、新功能与大规模文档迁移。
51
+
52
+ ## 搜索与复用
53
+
54
+ 实现前先检视现有系统:
55
+
56
+ - 仓库已索引且任务需要理解代码时,优先用 CodeGraph。
57
+ - 可用时用 `rg` 做文本搜索、`fd` 找文件。
58
+ - 引入新 helper 前先读邻近测试与 helper。
59
+ - 优先结构化 parser 与现有本地 API,避免 ad hoc 字符串处理。
60
+
61
+ 在搜索证明否则之前,假设系统可能已有部分解法。
62
+
63
+ ## 完成纪律
64
+
65
+ 完成声明必须回答:
66
+
67
+ - 改了什么
68
+ - 为何选此方案
69
+ - 哪条命令验证、结果如何
70
+ - 是否影响契约、文档、测试或脚本
71
+ - 剩余风险或后续项
72
+
73
+ 验证失败时,报告失败命令与观察到的状态,而不是软化完成定义。
@@ -1,6 +1,6 @@
1
- # 执行计划
2
-
3
- - `active/README.md` — 当前进行中的计划
4
- - `completed/README.md` — 已完成的计划
5
-
6
- 影响多文件、公开命令行为或仓库治理的变更应使用 execution plan。
1
+ # 执行计划
2
+
3
+ - `active/README.md` — 当前进行中的计划
4
+ - `completed/README.md` — 已完成的计划
5
+
6
+ 影响多文件、公开命令行为或仓库治理的变更应使用 execution plan。
@@ -6,10 +6,7 @@
6
6
 
7
7
  当前 active execution plan:
8
8
 
9
- - [`2026-07-17-frontend-implementation-capability-deepening.md`](2026-07-17-frontend-implementation-capability-deepening.md) — frontend-implementation 结构化合同、修复闭环与项目适配深化
10
- - [`2026-07-17-backend-test-capability-deepening.md`](2026-07-17-backend-test-capability-deepening.md) — backend-test 执行合同、结果分类与可验证追踪深化
11
9
  - [`2026-07-16-recursive-self-improvement-eval-lab.md`](2026-07-16-recursive-self-improvement-eval-lab.md) — Eval Lab:**M0+M1+M2(W2.1–W2.3) done**;W2.4 alias/promotion 与 M3+ live campaign 仍 todo(设计真源 `docs/design/recursive-self-improvement-eval-lab.md`;CHANGELOG `[Unreleased]`)
12
10
  - [`2026-07-16-frontend-mock-node.md`](2026-07-16-frontend-mock-node.md) — 前端 DAG Mock 策略节点与安全验证
13
- - [`2026-07-16-fe-test-dag.md`](2026-07-16-fe-test-dag.md) — FE-test RAG:功能用例、Playwright CLI 浏览器执行与证据复盘链路
14
11
 
15
- - 已归档:`../completed/2026-07-17-frontend-beta-publish-guard.md`、`../completed/2026-07-16-backend-test-remediation.md`、`../completed/2026-07-16-frontend-demand-auto-routing.md`、`../completed/2026-07-16-frontend-mock-data-workflow.md`、`../completed/2026-07-14-knowledge-sync-and-graph.md`、`../completed/2026-07-15-repair-artifact-gate-runtime-contract.md`、`../completed/2026-07-14-observe-ui-r5.md`、`../completed/2026-07-14-observe-ui-r4.md`、`../completed/2026-07-14-observe-ui-r3.md`、`../completed/2026-07-14-observe-ui-r2.md`、`../completed/2026-07-14-observe-ui-r1.md`、`../completed/2026-07-14-init-canonical-layout.md`、`../completed/2026-07-12-observe-warm-console-redesign.md`、`../completed/2026-07-14-website-docs-ia-and-converge.md`、`../completed/2026-07-13-versioned-self-hosting-bootstrap.md`、`../completed/2026-07-12-pi-only-agent-runtime.md`、第二月 M2-01~M2-08、`../completed/2026-07-11-observe-dashboard-page-system.md`、`../completed/2026-07-11-observe-dashboard-detail-refinement.md`、`../completed/2026-07-11-observe-terminal-dag-kpi.md`、`../completed/2026-07-11-observe-polling-efficiency.md`、`../completed/2026-07-11-command-performance-guardrails.md` 及更早计划。
12
+ - 已归档:`../completed/2026-07-16-fe-test-dag.md`、`../completed/2026-07-17-frontend-implementation-capability-deepening.md`、`../completed/2026-07-17-backend-test-capability-deepening.md`、`../completed/2026-07-16-backend-test-remediation.md`、`../completed/2026-07-16-frontend-demand-auto-routing.md`、`../completed/2026-07-16-frontend-mock-data-workflow.md`、`../completed/2026-07-14-knowledge-sync-and-graph.md`、`../completed/2026-07-15-repair-artifact-gate-runtime-contract.md`、`../completed/2026-07-14-observe-ui-r5.md`、`../completed/2026-07-14-observe-ui-r4.md`、`../completed/2026-07-14-observe-ui-r3.md`、`../completed/2026-07-14-observe-ui-r2.md`、`../completed/2026-07-14-observe-ui-r1.md`、`../completed/2026-07-14-init-canonical-layout.md`、`../completed/2026-07-12-observe-warm-console-redesign.md`、`../completed/2026-07-14-website-docs-ia-and-converge.md`、`../completed/2026-07-13-versioned-self-hosting-bootstrap.md`、`../completed/2026-07-12-pi-only-agent-runtime.md`、第二月 M2-01~M2-08、`../completed/2026-07-11-observe-dashboard-page-system.md`、`../completed/2026-07-11-observe-dashboard-detail-refinement.md`、`../completed/2026-07-11-observe-terminal-dag-kpi.md`、`../completed/2026-07-11-observe-polling-efficiency.md`、`../completed/2026-07-11-command-performance-guardrails.md` 及更早计划。
@@ -1,85 +1,107 @@
1
- # 已完成的执行计划
1
+ # 已完成的执行计划
2
+
3
+ 实现与验证结束后,已完成计划移入此目录。
4
+
5
+ npm 包携带本 README 作为目录契约。具体 completed plan 属于目标仓库历史,不从 loop-agent 源码历史复制。
6
+
7
+ - [`2026-07-16-fe-test-dag.md`](2026-07-16-fe-test-dag.md) — FE-test RAG:`taskKind: "frontend-test"` 串行浏览器用例/证据 DAG(MVP + PR #25;prompt 深度 / 真实 browser smoke 等 residual 另开)
8
+ - [`2026-07-17-frontend-implementation-capability-deepening.md`](2026-07-17-frontend-implementation-capability-deepening.md) — frontend-implementation Contract/trace/repair、风险裁剪、React/Next/Vue capability、a11y/openSpec seed(M0–M6 核心完成;W2.7/W3.8/W6.8 residual)
9
+ - [`2026-07-17-backend-test-capability-deepening.md`](2026-07-17-backend-test-capability-deepening.md) — backend-test 执行合同、结果分类、Case Manifest/Traceability 与 M4 docs/init/tmpdir smoke 收敛(M0–M4 全完成)
10
+ - [`2026-07-17-review-findings-remediation.md`](2026-07-17-review-findings-remediation.md) — 收敛主干 review findings
11
+ - [`2026-07-16-frontend-mock-data-workflow.md`](2026-07-16-frontend-mock-data-workflow.md) — 前端 Mock 数据治理链
12
+ - [`2026-07-16-frontend-demand-auto-routing.md`](2026-07-16-frontend-demand-auto-routing.md) — 前端需求确定性自动路由
13
+ - [`2026-07-16-dag-source-binding-recovery.md`](2026-07-16-dag-source-binding-recovery.md) — DAG 任务源绑定与恢复门禁
14
+ - [`2026-07-16-backend-test-remediation.md`](2026-07-16-backend-test-remediation.md) — backend-test 报告、writeSet 与 prompt 修复
15
+ - [`2026-07-14-knowledge-sync-and-graph.md`](2026-07-14-knowledge-sync-and-graph.md) — knowledge-sync 与知识图谱 MVP 完成归档
16
+ - [`2026-07-16-target-agents-routing-observe.md`](2026-07-16-target-agents-routing-observe.md) — 让根与初始化目标 AGENTS 正确路由后端测试,并提供本地只读看板入口和安全更新回归
17
+ - [`2026-07-16-init-upgrade-continuity.md`](2026-07-16-init-upgrade-continuity.md) — 修复 apply-safe 降级 recorded state、补齐 knowledge taskKind/公共 CLI 指引,并将 kb runtime scripts 纳入 packageRequired
18
+ - [`2026-07-15-repair-artifact-gate-runtime-contract.md`](2026-07-15-repair-artifact-gate-runtime-contract.md) — 显式 `repairNodeId` + 严格 repair writer 契约、DagSpec `runtimeContract` capability preflight,以及 run-owned controller identity(resume 漂移 fail-closed)
19
+ - [`2026-07-14-backend-test-dag-template.md`](2026-07-14-backend-test-dag-template.md) — 通过 `taskKind: "backend-test"` 生成需求分析、功能用例、pytest 自动化、执行与复盘的 Pi-only 专用 DAG
20
+ - [`2026-07-14-observe-ui-r5.md`](2026-07-14-observe-ui-r5.md) — Observe 原生 ES module 拆分、四态 helper、Pool hash 筛选与入口 re-export
21
+ - [`2026-07-14-observe-ui-r4.md`](2026-07-14-observe-ui-r4.md) — Observe Batch/Pool 有界事件时间线、cursor/limit、JSONL 容量与投影 fault-first
22
+ - [`2026-07-14-observe-ui-r2.md`](2026-07-14-observe-ui-r2.md) — Observe Batch / Worker Run 证据化详情、三层只读结构与安全 artifact preview
23
+ - [`2026-07-14-observe-ui-r3.md`](2026-07-14-observe-ui-r3.md) — Observe Feature 决策详情、copy-only 建议命令与 canonical 对象关系导航
24
+ - [`2026-07-14-observe-ui-r1.md`](2026-07-14-observe-ui-r1.md) — Observe 资源池总览、Task 下钻、精确对象关联与有界 run history
25
+ - [`2026-07-14-init-canonical-layout.md`](2026-07-14-init-canonical-layout.md) — 目标项目治理资料统一到 `ai_workspace/loop-agent/` 与 `.agents/skills/`,并为旧布局提供保守安全迁移
26
+ - [`2026-07-14-self-update-notifier-implementation.md`](2026-07-14-self-update-notifier-implementation.md) — 实现 loop-agent CLI 自更新提醒,覆盖拒绝版本、精确安装、npm global 来源证明和验证收口
27
+ - [`2026-07-12-observe-warm-console-redesign.md`](2026-07-12-observe-warm-console-redesign.md) — 以暖白、细边界和高密度信息架构重构 Observe Dashboard;多轮细节调整后按用户确认收口归档。
28
+ - [`2026-07-14-website-docs-ia-and-converge.md`](2026-07-14-website-docs-ia-and-converge.md) — Website 文档信息架构、双树边界与 `docs-converge` 同步机制
29
+ - [`2026-07-14-frontend-spec-source-fallback.md`](2026-07-14-frontend-spec-source-fallback.md) — 统一前端规范来源为知识库优先、失败后强制检索当前项目 `openSpec/`
30
+ - [`2026-07-13-test-environment-stability.md`](2026-07-13-test-environment-stability.md) — 修复 Windows Git Bash、npm CLI 启动与 Git/Delivery 测试资源分类,避免验证节点反复失败并跳过 DAG 收口
31
+ - [`2026-07-13-sdd-embedded-skills.md`](2026-07-13-sdd-embedded-skills.md) — 目标项目 repo-local SDD skills 的可选 DAG 节点嵌入增强,loop-agent 保持流程、状态与写边界控制
32
+ - [`2026-07-13-frontend-skill-contracts.md`](2026-07-13-frontend-skill-contracts.md) — 补齐前端节点 Skill 的输入、输出、证据与阻断契约,并预留组件/设计知识库接入 TODO
33
+ - [`2026-07-13-versioned-self-hosting-bootstrap.md`](2026-07-13-versioned-self-hosting-bootstrap.md) — 固定已发布 controller identity、冻结 run-owned skills,并由隔离候选包完成 deterministic self-hosting takeover canary
34
+ - [`2026-07-12-pi-only-agent-runtime.md`](2026-07-12-pi-only-agent-runtime.md) — 将 DAG、Loop、Delegate 和 Worker 收敛为 Pi-only 受治理 runtime,仅保留独立的 one-shot `cursor-prompt` sidecar
35
+ - [`2026-07-11-m2-01-feature-review-model.md`](2026-07-11-m2-01-feature-review-model.md) — 第二月首个纵向切片:严格派生 Feature 状态、AC/Delivery/Closeout 证据与只读 `feature review`
36
+ - [`2026-07-12-m2-02-feature-run-orchestration.md`](2026-07-12-m2-02-feature-run-orchestration.md) — Feature 级 dry-run 与复用现有 Worker pipeline 的薄编排入口
37
+ - [`2026-07-12-m2-03-follow-up-tracer-bullet.md`](2026-07-12-m2-03-follow-up-tracer-bullet.md) — ProductBug 失败到人工批准 FIX、依赖重连、Ready 与 verified lineage 的纵向闭环
38
+ - [`2026-07-12-m2-04-follow-up-hardening.md`](2026-07-12-m2-04-follow-up-hardening.md) — 全 failure-category ActionCard/TaskDraft、EnvFailure 阈值、supersede 与审批事务故障回滚
39
+ - [`2026-07-12-m2-05-git-transaction.md`](2026-07-12-m2-05-git-transaction.md) — Feature branch checkpoint、失败证据/恢复、ignored 隔离与事务完整性
40
+ - [`2026-07-12-m2-06-delivery-closeout-preview.md`](2026-07-12-m2-06-delivery-closeout-preview.md) — Delivery Package、canonical AC evidence 与只读 Closeout gates
41
+ - [`2026-07-12-m2-07-feature-decision-metrics.md`](2026-07-12-m2-07-feature-decision-metrics.md) — 共享 Feature Decision Summary、Observe 层级、corruption 降级与月度 metrics
42
+ - [`2026-07-12-m2-08-closeout-dogfood-release.md`](2026-07-12-m2-08-closeout-dogfood-release.md) — Closeout apply、第二真实 Feature、真实 Follow-up 恢复、package/init/browser 与月度收口证据
43
+ - [`2026-07-11-observe-dashboard-page-system.md`](2026-07-11-observe-dashboard-page-system.md) — 完成 Observe 全页面信息层级与桌面布局优化,按用户确认收口归档。
44
+ - [`2026-07-11-observe-dashboard-detail-refinement.md`](2026-07-11-observe-dashboard-detail-refinement.md) — 完成 DAG 详情输出、依赖图与执行过程的轮询状态保持和桌面节点布局优化,按用户确认收口归档。
45
+ - [`2026-07-11-observe-terminal-dag-kpi.md`](2026-07-11-observe-terminal-dag-kpi.md) — 修复终态 DAG 因遗留未执行节点被误计为活跃的问题。
46
+ - [`2026-07-11-observe-polling-efficiency.md`](2026-07-11-observe-polling-efficiency.md) — 完成详情页终态停轮询、非重叠调度和后台降频。
47
+ - [`2026-07-11-command-performance-guardrails.md`](2026-07-11-command-performance-guardrails.md) — 完成命令并发参数、串行验证与 Observe SSE 的资源峰值护栏。
48
+ - [`2026-07-11-command-performance-followups.md`](2026-07-11-command-performance-followups.md) — 完成 Observe 快照复用、命令输出有界缓冲和 reference index 遍历优化。
49
+ - [`2026-07-02-loop-agent-subject-restructure.md`](2026-07-02-loop-agent-subject-restructure.md) — 将原 `tools/code-agent` runtime 提升到仓库根、重命名为 `loop-agent`,移除旧 memory plugin 产品线
50
+ - [`2026-07-04-remove-level1-fallback.md`](2026-07-04-remove-level1-fallback.md) — 移除历史顺序 Level 1 fallback,runtime、文档与 command surface 收敛到 DAG 执行
51
+ - [`2026-07-04-runtime-boundary-remediation.md`](2026-07-04-runtime-boundary-remediation.md) — 整合 CLI/skill/runtime 边界,抽出 DAG/Loop runtime seam,集中 harness store/guard 策略
52
+ - [`2026-07-10-next-stage-worker-evidence.md`](2026-07-10-next-stage-worker-evidence.md) — Worker retry、EnvFailure、边界治理、初始化投影与真实 BE/FE/QA dogfood evidence 闭环
53
+ - [`2026-07-10-release-0.6.0-nightly-drill.md`](2026-07-10-release-0.6.0-nightly-drill.md) — 发布 0.6.0、首轮夜间演练(6 worker runs / 3 success)、Observe 过程时间线验证;C6 owner gate 由 Round 3 morning decision 满足后正式关闭
54
+ - [`2026-07-10-harness-json-schema.md`](2026-07-10-harness-json-schema.md) — 新增 `harness.json` IDE JSON Schema、初始化投影、旧项目 update 修复和漂移防护
55
+ - [`2026-07-11-interactive-ui-writer-routing.md`](2026-07-11-interactive-ui-writer-routing.md) — 新增 interactive-ui writer-only HIGH 路由、UI 交付契约、真实 React dogfood fixture 与 Round-2 A/B/C 实验入口
56
+ - [`2026-07-11-round-2-interactive-ui-productization.md`](2026-07-11-round-2-interactive-ui-productization.md) — 完成 owner gate、0.7.0–0.7.4 发布、React A/B/C、20 个 Worker runs、外部 nightly、产品线模板与 docs CI
57
+ - [`2026-07-11-observe-dag-visualization.md`](2026-07-11-observe-dag-visualization.md) — Observe 投影 canonical DAG edges,新增确定性 SVG 依赖图、节点交互、视觉 tokens、可访问性与真实 Chrome smoke
58
+ - [`2026-07-04-dag-role-skill-alignment.md`](2026-07-04-dag-role-skill-alignment.md) — 对齐 DAG/Dynamic Workflow role 与 repo-local vetted skills,新增 strict skill audit
59
+ - [`2026-07-06-production-readiness-hardening.md`](2026-07-06-production-readiness-hardening.md) — 冻结 Production Readiness v0.1,打磨 DAG 主路径 next steps、failure routing、doctor/report/failure handoff 与 dogfood 验证
60
+ - [`2026-07-08-taskspec-schema-validate.md`](2026-07-08-taskspec-schema-validate.md) — 新增 TaskSpec v0.1 schema、三层校验器、risk→complexity 映射和 5 个 dogfood TaskSpec 样例
61
+ - [`2026-07-08-acceptance-taskgraph-ready.md`](2026-07-08-acceptance-taskgraph-ready.md) — 新增 AcceptanceSpec / TaskGraphSpec schema、Feature graph 校验、环检测和 Ready 队列计算
62
+ - [`2026-07-08-profile-mapping-agent-worker-cli.md`](2026-07-08-profile-mapping-agent-worker-cli.md) — 新增 business profile 到 loop-agent profile 映射、独立 `agent-worker` CLI 和 package bin surface
63
+ - [`2026-07-08-loop-agent-client-contract-smoke.md`](2026-07-08-loop-agent-client-contract-smoke.md) — 新增 LoopAgentClient、command artifact、JSON parse failure、repo resolver/preflight 与 Ring 0 CLI contract smoke
64
+ - [`2026-07-08-materializer-ring1-dag.md`](2026-07-08-materializer-ring1-dag.md) — 新增 TaskSpec materializer、materialize manifest、coverage-safe source 输出与 Ring 1 DAG generate/validate/dry-run smoke
65
+ - [`2026-07-08-run-task-pipeline-ring2.md`](2026-07-08-run-task-pipeline-ring2.md) — 新增 Worker run-task pipeline、task-local run record、成功/失败分流与 Ring 2 shell-only DAG success/failure smoke
66
+ - [`2026-07-08-task-pool-morning-report.md`](2026-07-08-task-pool-morning-report.md) — 新增 Worker Task Pool JSONL/state store、failure routing、串行 batch run-ready 和 morning report
67
+ - [`2026-07-08-taskspec-worker-master.md`](2026-07-08-taskspec-worker-master.md) — 完成 TaskSpec + Worker 7 步 master 编排,覆盖 schema、graph、profile、client、materialize、run-task、Task Pool 和 morning report
68
+ - [`2026-07-10-obs-001.md`](2026-07-10-obs-001.md) — WorkerEvent schema 与 append-only event/snapshot store
69
+ - [`2026-07-10-obs-002.md`](2026-07-10-obs-002.md) — LoopAgentClient 流式输出、heartbeat 与实时 artifact
70
+ - [`2026-07-10-obs-003.md`](2026-07-10-obs-003.md) — composite progress 与 Worker pipeline 事件打点
71
+ - [`2026-07-10-obs-004.md`](2026-07-10-obs-004.md) — observability snapshot read model
72
+ - [`2026-07-10-obs-005.md`](2026-07-10-obs-005.md) — 本地只读 observe HTTP/SSE server
73
+ - [`2026-07-10-obs-006.md`](2026-07-10-obs-006.md) — Dashboard、Batch Detail 与 Run Detail UI
74
+ - [`2026-07-10-obs-007.md`](2026-07-10-obs-007.md) — run-dag JSONL events 与 composite observer
75
+ - [`2026-07-10-obs-008.md`](2026-07-10-obs-008.md) — Worker DAG events 接线与 DAG Detail UI
76
+ - [`2026-07-10-obs-009.md`](2026-07-10-obs-009.md) — stale、quiet 与 timeout-risk 诊断
77
+ - [`2026-07-10-obs-010.md`](2026-07-10-obs-010.md) — Failure Inbox、文档、package surface 与 smoke 验证
78
+ - [`2026-07-10-observe-ui-review-remediation.md`](2026-07-10-observe-ui-review-remediation.md) — 修复 Observe UI 事件链路、历史 run 投影、artifact 安全边界与失败状态展示
79
+
80
+ - [`2026-07-13-exec-plan-lifecycle.md`](2026-07-13-exec-plan-lifecycle.md)
81
+
82
+ - [`2026-07-15-task-pool-priority-aware-ready-planner.md`](2026-07-15-task-pool-priority-aware-ready-planner.md)
83
+ - [`2026-07-15-task-pool-v2-feature-scoped-task-identity.md`](2026-07-15-task-pool-v2-feature-scoped-task-identity.md)
84
+ - [`2026-07-15-init-update-surface-coverage.md`](2026-07-15-init-update-surface-coverage.md)
85
+ - [`2026-07-15-readonly-node-retry.md`](2026-07-15-readonly-node-retry.md)
86
+
87
+ - [`2026-07-16-init-natural-language-routing.md`](2026-07-16-init-natural-language-routing.md)
88
+
89
+ - [`2026-07-16-observe-inspector-node-consistency.md`](2026-07-16-observe-inspector-node-consistency.md)
90
+
91
+ - [`2026-07-16-repair-artifact-pass-normalization.md`](2026-07-16-repair-artifact-pass-normalization.md)
92
+
93
+ - [`2026-07-16-decision-envelope-fence-tolerance.md`](2026-07-16-decision-envelope-fence-tolerance.md)
94
+
95
+ - [`2026-07-16-decision-envelope-prompt-contract.md`](2026-07-16-decision-envelope-prompt-contract.md)
96
+
97
+ - [`2026-07-17-source-target-structure-alignment.md`](2026-07-17-source-target-structure-alignment.md)
98
+
99
+ - [`2026-07-17-review-findings-remediation.md`](2026-07-17-review-findings-remediation.md)
100
+
101
+ - [`2026-07-16-backend-test-analysis-contract-artifact.md`](2026-07-16-backend-test-analysis-contract-artifact.md)
102
+
103
+ - [`2026-07-17-release-0130-reconcile.md`](2026-07-17-release-0130-reconcile.md)
104
+
105
+ - [`2026-07-17-observe-dashboard-incremental-polling.md`](2026-07-17-observe-dashboard-incremental-polling.md)
2
106
 
3
- 实现与验证结束后,已完成计划移入此目录。
4
-
5
- npm 包携带本 README 作为目录契约。具体 completed plan 属于目标仓库历史,不从 loop-agent 源码历史复制。
6
-
7
- - [`2026-07-17-frontend-beta-publish-guard.md`](2026-07-17-frontend-beta-publish-guard.md) — `frontend` 分支本地 npm 发布门禁,只允许 beta SemVer 与 beta dist-tag,避免预发布包误推 `latest`
8
- - [`2026-07-16-backend-test-remediation.md`](2026-07-16-backend-test-remediation.md) — 修正 backend-test 的 taskKind/profile 漂移、虚假 convergence、pytest write-guard/报告契约、pytest writer 边界、prompt 安全与 Observe events 失败可见性;analyze 结构化落盘拆为独立后续计划
9
- - [`2026-07-16-dag-source-binding-recovery.md`](2026-07-16-dag-source-binding-recovery.md) — 新生成 DAG 冻结任务源与需求编号,前端计划缺号在 writer 前阻断,v3 孤立 writer 严格拒绝二手摘要恢复
10
- - [`2026-07-14-knowledge-sync-and-graph.md`](2026-07-14-knowledge-sync-and-graph.md) — 知识库同步 DAG(featureId 硬化)+ 业务知识图谱开荒 / Phase A 查询 / 增量 prepare / `knowledge` CLI;随 0.12.0 发布并归档
11
- - [`2026-07-15-repair-artifact-gate-runtime-contract.md`](2026-07-15-repair-artifact-gate-runtime-contract.md) — 显式 `repairNodeId` + 严格 repair writer 契约、DagSpec `runtimeContract` capability preflight,以及 run-owned controller identity(resume 漂移 fail-closed)
12
- - [`2026-07-14-backend-test-dag-template.md`](2026-07-14-backend-test-dag-template.md) — 通过 `taskKind: "backend-test"` 生成需求分析、功能用例、pytest 自动化、执行与复盘的 Pi-only 专用 DAG
13
- - [`2026-07-14-observe-ui-r5.md`](2026-07-14-observe-ui-r5.md) — Observe 原生 ES module 拆分、四态 helper、Pool hash 筛选与入口 re-export
14
- - [`2026-07-14-observe-ui-r4.md`](2026-07-14-observe-ui-r4.md) — Observe Batch/Pool 有界事件时间线、cursor/limit、JSONL 容量与投影 fault-first
15
- - [`2026-07-14-observe-ui-r2.md`](2026-07-14-observe-ui-r2.md) — Observe Batch / Worker Run 证据化详情、三层只读结构与安全 artifact preview
16
- - [`2026-07-14-observe-ui-r3.md`](2026-07-14-observe-ui-r3.md) — Observe Feature 决策详情、copy-only 建议命令与 canonical 对象关系导航
17
- - [`2026-07-14-observe-ui-r1.md`](2026-07-14-observe-ui-r1.md) — Observe 资源池总览、Task 下钻、精确对象关联与有界 run history
18
- - [`2026-07-14-init-canonical-layout.md`](2026-07-14-init-canonical-layout.md) — 目标项目治理资料统一到 `ai_workspace/loop-agent/` 与 `.agents/skills/`,并为旧布局提供保守安全迁移
19
- - [`2026-07-14-self-update-notifier-implementation.md`](2026-07-14-self-update-notifier-implementation.md) — 实现 loop-agent CLI 自更新提醒,覆盖拒绝版本、精确安装、npm global 来源证明和验证收口
20
- - [`2026-07-12-observe-warm-console-redesign.md`](2026-07-12-observe-warm-console-redesign.md) — 以暖白、细边界和高密度信息架构重构 Observe Dashboard;多轮细节调整后按用户确认收口归档。
21
- - [`2026-07-14-website-docs-ia-and-converge.md`](2026-07-14-website-docs-ia-and-converge.md) — Website 文档信息架构、双树边界与 `docs-converge` 同步机制
22
- - [`2026-07-14-frontend-spec-source-fallback.md`](2026-07-14-frontend-spec-source-fallback.md) — 统一前端规范来源为知识库优先、失败后强制检索当前项目 `openSpec/`
23
- - [`2026-07-13-test-environment-stability.md`](2026-07-13-test-environment-stability.md) — 修复 Windows Git Bash、npm CLI 启动与 Git/Delivery 测试资源分类,避免验证节点反复失败并跳过 DAG 收口
24
- - [`2026-07-13-sdd-embedded-skills.md`](2026-07-13-sdd-embedded-skills.md) — 目标项目 repo-local SDD skills 的可选 DAG 节点嵌入增强,loop-agent 保持流程、状态与写边界控制
25
- - [`2026-07-13-frontend-skill-contracts.md`](2026-07-13-frontend-skill-contracts.md) — 补齐前端节点 Skill 的输入、输出、证据与阻断契约,并预留组件/设计知识库接入 TODO
26
- - [`2026-07-13-versioned-self-hosting-bootstrap.md`](2026-07-13-versioned-self-hosting-bootstrap.md) — 固定已发布 controller identity、冻结 run-owned skills,并由隔离候选包完成 deterministic self-hosting takeover canary
27
- - [`2026-07-12-pi-only-agent-runtime.md`](2026-07-12-pi-only-agent-runtime.md) — 将 DAG、Loop、Delegate 和 Worker 收敛为 Pi-only 受治理 runtime,仅保留独立的 one-shot `cursor-prompt` sidecar
28
- - [`2026-07-11-m2-01-feature-review-model.md`](2026-07-11-m2-01-feature-review-model.md) — 第二月首个纵向切片:严格派生 Feature 状态、AC/Delivery/Closeout 证据与只读 `feature review`
29
- - [`2026-07-12-m2-02-feature-run-orchestration.md`](2026-07-12-m2-02-feature-run-orchestration.md) — Feature 级 dry-run 与复用现有 Worker pipeline 的薄编排入口
30
- - [`2026-07-12-m2-03-follow-up-tracer-bullet.md`](2026-07-12-m2-03-follow-up-tracer-bullet.md) — ProductBug 失败到人工批准 FIX、依赖重连、Ready 与 verified lineage 的纵向闭环
31
- - [`2026-07-12-m2-04-follow-up-hardening.md`](2026-07-12-m2-04-follow-up-hardening.md) — 全 failure-category ActionCard/TaskDraft、EnvFailure 阈值、supersede 与审批事务故障回滚
32
- - [`2026-07-12-m2-05-git-transaction.md`](2026-07-12-m2-05-git-transaction.md) — Feature branch checkpoint、失败证据/恢复、ignored 隔离与事务完整性
33
- - [`2026-07-12-m2-06-delivery-closeout-preview.md`](2026-07-12-m2-06-delivery-closeout-preview.md) — Delivery Package、canonical AC evidence 与只读 Closeout gates
34
- - [`2026-07-12-m2-07-feature-decision-metrics.md`](2026-07-12-m2-07-feature-decision-metrics.md) — 共享 Feature Decision Summary、Observe 层级、corruption 降级与月度 metrics
35
- - [`2026-07-12-m2-08-closeout-dogfood-release.md`](2026-07-12-m2-08-closeout-dogfood-release.md) — Closeout apply、第二真实 Feature、真实 Follow-up 恢复、package/init/browser 与月度收口证据
36
- - [`2026-07-11-observe-dashboard-page-system.md`](2026-07-11-observe-dashboard-page-system.md) — 完成 Observe 全页面信息层级与桌面布局优化,按用户确认收口归档。
37
- - [`2026-07-11-observe-dashboard-detail-refinement.md`](2026-07-11-observe-dashboard-detail-refinement.md) — 完成 DAG 详情输出、依赖图与执行过程的轮询状态保持和桌面节点布局优化,按用户确认收口归档。
38
- - [`2026-07-11-observe-terminal-dag-kpi.md`](2026-07-11-observe-terminal-dag-kpi.md) — 修复终态 DAG 因遗留未执行节点被误计为活跃的问题。
39
- - [`2026-07-11-observe-polling-efficiency.md`](2026-07-11-observe-polling-efficiency.md) — 完成详情页终态停轮询、非重叠调度和后台降频。
40
- - [`2026-07-11-command-performance-guardrails.md`](2026-07-11-command-performance-guardrails.md) — 完成命令并发参数、串行验证与 Observe SSE 的资源峰值护栏。
41
- - [`2026-07-11-command-performance-followups.md`](2026-07-11-command-performance-followups.md) — 完成 Observe 快照复用、命令输出有界缓冲和 reference index 遍历优化。
42
- - [`2026-07-02-loop-agent-subject-restructure.md`](2026-07-02-loop-agent-subject-restructure.md) — 将原 `tools/code-agent` runtime 提升到仓库根、重命名为 `loop-agent`,移除旧 memory plugin 产品线
43
- - [`2026-07-04-remove-level1-fallback.md`](2026-07-04-remove-level1-fallback.md) — 移除历史顺序 Level 1 fallback,runtime、文档与 command surface 收敛到 DAG 执行
44
- - [`2026-07-04-runtime-boundary-remediation.md`](2026-07-04-runtime-boundary-remediation.md) — 整合 CLI/skill/runtime 边界,抽出 DAG/Loop runtime seam,集中 harness store/guard 策略
45
- - [`2026-07-10-next-stage-worker-evidence.md`](2026-07-10-next-stage-worker-evidence.md) — Worker retry、EnvFailure、边界治理、初始化投影与真实 BE/FE/QA dogfood evidence 闭环
46
- - [`2026-07-10-release-0.6.0-nightly-drill.md`](2026-07-10-release-0.6.0-nightly-drill.md) — 发布 0.6.0、首轮夜间演练(6 worker runs / 3 success)、Observe 过程时间线验证;C6 owner gate 由 Round 3 morning decision 满足后正式关闭
47
- - [`2026-07-10-harness-json-schema.md`](2026-07-10-harness-json-schema.md) — 新增 `harness.json` IDE JSON Schema、初始化投影、旧项目 update 修复和漂移防护
48
- - [`2026-07-11-interactive-ui-writer-routing.md`](2026-07-11-interactive-ui-writer-routing.md) — 新增 interactive-ui writer-only HIGH 路由、UI 交付契约、真实 React dogfood fixture 与 Round-2 A/B/C 实验入口
49
- - [`2026-07-11-round-2-interactive-ui-productization.md`](2026-07-11-round-2-interactive-ui-productization.md) — 完成 owner gate、0.7.0–0.7.4 发布、React A/B/C、20 个 Worker runs、外部 nightly、产品线模板与 docs CI
50
- - [`2026-07-11-observe-dag-visualization.md`](2026-07-11-observe-dag-visualization.md) — Observe 投影 canonical DAG edges,新增确定性 SVG 依赖图、节点交互、视觉 tokens、可访问性与真实 Chrome smoke
51
- - [`2026-07-04-dag-role-skill-alignment.md`](2026-07-04-dag-role-skill-alignment.md) — 对齐 DAG/Dynamic Workflow role 与 repo-local vetted skills,新增 strict skill audit
52
- - [`2026-07-06-production-readiness-hardening.md`](2026-07-06-production-readiness-hardening.md) — 冻结 Production Readiness v0.1,打磨 DAG 主路径 next steps、failure routing、doctor/report/failure handoff 与 dogfood 验证
53
- - [`2026-07-08-taskspec-schema-validate.md`](2026-07-08-taskspec-schema-validate.md) — 新增 TaskSpec v0.1 schema、三层校验器、risk→complexity 映射和 5 个 dogfood TaskSpec 样例
54
- - [`2026-07-08-acceptance-taskgraph-ready.md`](2026-07-08-acceptance-taskgraph-ready.md) — 新增 AcceptanceSpec / TaskGraphSpec schema、Feature graph 校验、环检测和 Ready 队列计算
55
- - [`2026-07-08-profile-mapping-agent-worker-cli.md`](2026-07-08-profile-mapping-agent-worker-cli.md) — 新增 business profile 到 loop-agent profile 映射、独立 `agent-worker` CLI 和 package bin surface
56
- - [`2026-07-08-loop-agent-client-contract-smoke.md`](2026-07-08-loop-agent-client-contract-smoke.md) — 新增 LoopAgentClient、command artifact、JSON parse failure、repo resolver/preflight 与 Ring 0 CLI contract smoke
57
- - [`2026-07-08-materializer-ring1-dag.md`](2026-07-08-materializer-ring1-dag.md) — 新增 TaskSpec materializer、materialize manifest、coverage-safe source 输出与 Ring 1 DAG generate/validate/dry-run smoke
58
- - [`2026-07-08-run-task-pipeline-ring2.md`](2026-07-08-run-task-pipeline-ring2.md) — 新增 Worker run-task pipeline、task-local run record、成功/失败分流与 Ring 2 shell-only DAG success/failure smoke
59
- - [`2026-07-08-task-pool-morning-report.md`](2026-07-08-task-pool-morning-report.md) — 新增 Worker Task Pool JSONL/state store、failure routing、串行 batch run-ready 和 morning report
60
- - [`2026-07-08-taskspec-worker-master.md`](2026-07-08-taskspec-worker-master.md) — 完成 TaskSpec + Worker 7 步 master 编排,覆盖 schema、graph、profile、client、materialize、run-task、Task Pool 和 morning report
61
- - [`2026-07-10-obs-001.md`](2026-07-10-obs-001.md) — WorkerEvent schema 与 append-only event/snapshot store
62
- - [`2026-07-10-obs-002.md`](2026-07-10-obs-002.md) — LoopAgentClient 流式输出、heartbeat 与实时 artifact
63
- - [`2026-07-10-obs-003.md`](2026-07-10-obs-003.md) — composite progress 与 Worker pipeline 事件打点
64
- - [`2026-07-10-obs-004.md`](2026-07-10-obs-004.md) — observability snapshot read model
65
- - [`2026-07-10-obs-005.md`](2026-07-10-obs-005.md) — 本地只读 observe HTTP/SSE server
66
- - [`2026-07-10-obs-006.md`](2026-07-10-obs-006.md) — Dashboard、Batch Detail 与 Run Detail UI
67
- - [`2026-07-10-obs-007.md`](2026-07-10-obs-007.md) — run-dag JSONL events 与 composite observer
68
- - [`2026-07-10-obs-008.md`](2026-07-10-obs-008.md) — Worker DAG events 接线与 DAG Detail UI
69
- - [`2026-07-10-obs-009.md`](2026-07-10-obs-009.md) — stale、quiet 与 timeout-risk 诊断
70
- - [`2026-07-10-obs-010.md`](2026-07-10-obs-010.md) — Failure Inbox、文档、package surface 与 smoke 验证
71
- - [`2026-07-10-observe-ui-review-remediation.md`](2026-07-10-observe-ui-review-remediation.md) — 修复 Observe UI 事件链路、历史 run 投影、artifact 安全边界与失败状态展示
72
-
73
- - [`2026-07-13-exec-plan-lifecycle.md`](2026-07-13-exec-plan-lifecycle.md)
74
-
75
- - [`2026-07-15-task-pool-priority-aware-ready-planner.md`](2026-07-15-task-pool-priority-aware-ready-planner.md)
76
- - [`2026-07-15-task-pool-v2-feature-scoped-task-identity.md`](2026-07-15-task-pool-v2-feature-scoped-task-identity.md)
77
- - [`2026-07-15-init-update-surface-coverage.md`](2026-07-15-init-update-surface-coverage.md)
78
- - [`2026-07-15-readonly-node-retry.md`](2026-07-15-readonly-node-retry.md)
79
-
80
- - [`2026-07-16-frontend-demand-auto-routing.md`](2026-07-16-frontend-demand-auto-routing.md)
81
- - [`2026-07-16-frontend-mock-data-workflow.md`](2026-07-16-frontend-mock-data-workflow.md)
82
-
83
- - [`2026-07-17-review-findings-remediation.md`](2026-07-17-review-findings-remediation.md)
84
-
85
- - [`2026-07-16-backend-test-analysis-contract-artifact.md`](2026-07-16-backend-test-analysis-contract-artifact.md)
107
+ - [`2026-07-18-origin-main-merge-43e86ad.md`](2026-07-18-origin-main-merge-43e86ad.md)