@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.
- package/AGENTS.md +157 -155
- package/CHANGELOG.md +301 -322
- package/README.md +335 -345
- package/bin/agent-worker.js +22 -22
- package/bin/loop-agent.js +21 -21
- package/dist/commands/cursor-prompt.js +6 -6
- package/dist/commands/init.js +597 -528
- package/dist/commands/loop-benchmark.js +11 -11
- package/dist/commands/pi-reuse-benchmark.js +16 -16
- package/dist/executors/shell-executor.js +200 -21
- package/dist/infrastructure/evaluation/candidate-store.js +5 -1
- package/dist/sidecars/cursor-prompt/executor.js +1 -1
- package/dist/task/runtime.js +27 -27
- package/dist/worker/observe/static/api.js +46 -46
- package/dist/worker/observe/static/app.js +150 -150
- package/dist/worker/observe/static/constants.js +148 -148
- package/dist/worker/observe/static/copy.js +67 -67
- package/dist/worker/observe/static/dag-helpers.js +172 -172
- package/dist/worker/observe/static/dag-layout.d.ts +31 -31
- package/dist/worker/observe/static/dag-layout.js +83 -83
- package/dist/worker/observe/static/dag-model.js +72 -72
- package/dist/worker/observe/static/dom.js +212 -53
- package/dist/worker/observe/static/format-pool.js +67 -67
- package/dist/worker/observe/static/format.js +292 -292
- package/dist/worker/observe/static/index.html +308 -308
- package/dist/worker/observe/static/kpi.js +94 -94
- package/dist/worker/observe/static/relations.js +133 -133
- package/dist/worker/observe/static/router.js +93 -93
- package/dist/worker/observe/static/run-processing.js +148 -148
- package/dist/worker/observe/static/shell-chrome.js +68 -68
- package/dist/worker/observe/static/state.js +267 -253
- package/dist/worker/observe/static/styles.css +1902 -1902
- package/dist/worker/observe/static/views/batch.js +227 -227
- package/dist/worker/observe/static/views/dag-graph.js +172 -172
- package/dist/worker/observe/static/views/dag-inspector.js +627 -607
- package/dist/worker/observe/static/views/dag.js +371 -362
- package/dist/worker/observe/static/views/dashboard.js +509 -252
- package/dist/worker/observe/static/views/failures.js +143 -143
- package/dist/worker/observe/static/views/feature.js +492 -492
- package/dist/worker/observe/static/views/pool.js +350 -350
- package/dist/worker/observe/static/views/run.js +453 -453
- package/dist/worker/observe/static/views/session-timeline.js +219 -205
- package/dist/worker/observe/static/views/shell.js +7 -7
- package/dist/worker/observe/static/views/task.js +314 -314
- package/dist/worker/observe/static/views/timeline.js +163 -163
- package/dist/workflows/dag/backend-test-case-manifest.js +503 -0
- package/dist/workflows/dag/backend-test-execution-contract.js +353 -0
- package/dist/workflows/dag/backend-test-result-contract.js +568 -0
- package/dist/workflows/dag/canvas-observer.js +275 -275
- package/dist/workflows/dag/decision-envelope.js +57 -2
- package/dist/workflows/dag/frontend-implementation-contract.js +240 -0
- package/dist/workflows/dag/frontend-project-capability.js +309 -0
- package/dist/workflows/dag/frontend-repair.js +341 -0
- package/dist/workflows/dag/frontend-risk.js +161 -0
- package/dist/workflows/dag/frontend-verification-trace.js +190 -0
- package/dist/workflows/dag/init-hybrid.js +1020 -125
- package/dist/workflows/dag/repair-artifact.js +43 -3
- package/dist/workflows/dag/skill-instructions.js +4 -2
- package/dist/workflows/dag/types.js +29 -8
- package/docs/README.md +105 -104
- package/docs/agent-dag-recovery-playbook.md +195 -195
- package/docs/agent-dag-runner.md +67 -67
- package/docs/architecture/README.md +26 -26
- package/docs/architecture/dag-execution.md +140 -140
- package/docs/architecture/evolution.md +54 -54
- package/docs/architecture/facts-and-state.md +71 -71
- package/docs/architecture/runtime-boundaries.md +191 -191
- package/docs/architecture/system-overview.md +93 -93
- package/docs/architecture/worker-and-feature.md +85 -85
- package/docs/cursor-prompt-sidecar.md +36 -36
- package/docs/decisions/README.md +18 -18
- package/docs/design/README.md +167 -167
- package/docs/development-principles.md +73 -73
- package/docs/exec-plans/README.md +6 -6
- package/docs/exec-plans/active/README.md +1 -4
- package/docs/exec-plans/completed/README.md +106 -84
- package/docs/feature-workflow.md +414 -389
- package/docs/harness-methodology-debugging.md +153 -153
- package/docs/harness-methodology-tdd.md +130 -130
- package/docs/harness-methodology-verification.md +27 -27
- package/docs/init-surface.manifest.json +307 -289
- package/docs/loop-agent-harness.md +142 -142
- package/docs/production-readiness.md +96 -96
- package/docs/progress/README.md +76 -60
- package/docs/reports/README.md +150 -108
- package/docs/skills/README.md +7 -7
- package/docs/skills/vetted-skill-registry.md +29 -29
- package/docs/templates/adr.md +60 -60
- package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
- package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
- package/docs/templates/agent-dag-decision-gate-dogfood-report.md +117 -117
- package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
- package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
- package/docs/templates/agent-dag-report.schema.json +473 -473
- package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
- package/docs/templates/agent-dag.base.json +190 -190
- package/docs/templates/agent-dag.final-verification.json +185 -185
- package/docs/templates/agent-dag.schema.json +411 -411
- package/docs/templates/agent-dag.supervised-implementation.json +620 -501
- package/docs/templates/backend-test-analysis.schema.json +44 -44
- package/docs/templates/backend-test-case-manifest.schema.json +190 -0
- package/docs/templates/backend-test-dag.classify.prompt.md +75 -0
- package/docs/templates/backend-test-dag.generate-pytest.prompt.md +204 -202
- package/docs/templates/backend-test-dag.json +559 -311
- package/docs/templates/backend-test-dag.retrospect.prompt.md +139 -125
- package/docs/templates/backend-test-dag.review-cases.prompt.md +83 -81
- package/docs/templates/backend-test-execution.schema.json +133 -0
- package/docs/templates/backend-test-result.schema.json +99 -0
- package/docs/templates/branch-merge-report.md +93 -0
- package/docs/templates/exec-plan.md +64 -64
- package/docs/templates/feature-spec.md +53 -53
- package/docs/templates/frontend-design-contract.md +42 -42
- package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md +17 -0
- package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md +16 -0
- package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md +16 -0
- package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md +16 -0
- package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md +16 -0
- package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md +16 -0
- package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md +21 -0
- package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md +29 -0
- package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md +28 -0
- package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md +28 -0
- package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md +29 -0
- package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md +27 -0
- package/docs/templates/frontend-eval/fixtures/functional/06-ssr-server-client-boundary.md +28 -0
- package/docs/templates/frontend-eval/fixtures/functional/07-shared-public-component-api.md +28 -0
- package/docs/templates/frontend-eval/fixtures/functional/08-pure-local-no-remote.md +27 -0
- package/docs/templates/frontend-eval/metrics.md +138 -0
- package/docs/templates/frontend-eval/smoke-targets.md +53 -0
- package/docs/templates/frontend-implementation-contract.schema.json +27 -0
- package/docs/templates/frontend-task-constraints.md +35 -35
- package/docs/templates/frontend-task-requirement.md +70 -70
- package/docs/templates/frontend-test-dag.generate-cases.prompt.md +5 -5
- package/docs/templates/frontend-test-dag.json +23 -23
- package/docs/templates/frontend-test-dag.retrieve-context.prompt.md +3 -3
- package/docs/templates/frontend-test-dag.retrospect.prompt.md +3 -3
- package/docs/templates/frontend-test-dag.review-cases.prompt.md +3 -3
- package/docs/templates/frontend-test-dag.review-execution.prompt.md +3 -3
- package/docs/templates/harness.schema.json +221 -221
- package/docs/templates/hybrid-dag.json +188 -188
- package/docs/templates/init-evolution-review.md +35 -35
- package/docs/templates/interactive-ui-round2-experiment.md +66 -66
- package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -118
- package/docs/templates/knowledge-sync-dag.json +178 -178
- package/docs/templates/knowledge-sync-draft.schema.json +71 -71
- package/docs/templates/product-line/AGENTS.md +8 -8
- package/docs/templates/product-line/README.md +9 -9
- package/docs/templates/product-line/acceptance.yaml +14 -14
- package/docs/templates/product-line/closeout.yaml +9 -9
- package/docs/templates/product-line/design.md +13 -13
- package/docs/templates/product-line/links.md +10 -10
- package/docs/templates/product-line/requirement.md +17 -17
- package/docs/templates/product-line/task-graph.yaml +15 -15
- package/docs/templates/product-line/task.yaml +64 -64
- package/docs/templates/product-line/test-plan.md +7 -7
- package/docs/templates/production-readiness-checklist.md +57 -57
- package/docs/templates/progress-log.md +17 -17
- package/docs/templates/project-start-checklist.md +9 -9
- package/docs/templates/qa-report.md +48 -48
- package/docs/templates/sprint-contract.md +29 -29
- package/docs/templates/worker-dogfood-evidence.md +80 -80
- package/docs/templates/worker-dogfood-setup.md +68 -68
- package/docs/verification-matrix.md +70 -70
- package/examples/decision-gate-agent-dag.json +177 -177
- package/examples/example-dag.json +46 -46
- package/examples/hybrid-loop-agent-dag.json +189 -189
- package/harness.json +66 -66
- package/package.json +52 -88
- package/scripts/check-product-line-docs.sh +29 -29
- package/scripts/check-task-pool-root.sh +32 -32
- package/scripts/kb-bootstrap-init-skeleton.sh +240 -240
- package/scripts/kb-graph-incremental-prepare.mjs +386 -386
- package/scripts/kb-graph-incremental-prepare.sh +5 -5
- package/scripts/kb-graph-materialize.mjs +105 -105
- package/scripts/kb-graph-materialize.sh +4 -4
- package/scripts/kb-graph-promote.mjs +164 -164
- package/scripts/kb-graph-promote.sh +4 -4
- package/scripts/kb-query.mjs +554 -554
- package/scripts/kb-query.sh +5 -5
- package/skills/agent-worker/SKILL.md +39 -39
- package/skills/agent-worker/references/agent-worker-operator.md +60 -60
- package/skills/ai-engineering-context/SKILL.md +48 -48
- package/skills/analyze-product-dependencies/SKILL.md +67 -67
- package/skills/analyze-product-dependencies/agents/openai.yaml +4 -4
- package/skills/analyze-product-dependencies/references/api-documentation-schema.md +30 -30
- package/skills/analyze-product-dependencies/references/dependency-analysis-schema.md +28 -28
- package/skills/analyze-product-dependencies/references/example.md +76 -76
- package/skills/analyze-product-dependencies/references/forward-test-cases.md +35 -35
- package/skills/analyze-product-dependencies/references/input-contract.md +11 -11
- package/skills/analyze-product-dependencies/references/scouting-rules.md +61 -61
- package/skills/analyze-product-dependencies/scripts/test-validators.mjs +267 -267
- package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +101 -101
- package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +142 -142
- package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +76 -76
- package/skills/analyze-product-dependencies/scripts/validation-helpers.mjs +146 -146
- package/skills/analyze-product-requirements/SKILL.md +90 -90
- package/skills/analyze-product-requirements/agents/openai.yaml +4 -4
- package/skills/analyze-product-requirements/references/acceptance-criteria.md +91 -91
- package/skills/analyze-product-requirements/references/clarification-and-knowledge.md +56 -56
- package/skills/analyze-product-requirements/references/example.md +86 -86
- package/skills/analyze-product-requirements/references/forward-test-cases.md +66 -66
- package/skills/analyze-product-requirements/references/product-analysis-schema.md +32 -32
- package/skills/analyze-product-requirements/references/product-requirement-schema.md +33 -33
- package/skills/analyze-product-requirements/references/requirement-clarification-schema.md +35 -35
- package/skills/analyze-product-requirements/scripts/test-validators.mjs +193 -193
- package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +69 -69
- package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +97 -97
- package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +98 -98
- package/skills/analyze-product-requirements/scripts/validation-helpers.mjs +156 -156
- package/skills/browser-tools/SKILL.md +196 -0
- package/skills/browser-tools/browser-content.js +103 -0
- package/skills/browser-tools/browser-cookies.js +35 -0
- package/skills/browser-tools/browser-eval.js +53 -0
- package/skills/browser-tools/browser-hn-scraper.js +108 -0
- package/skills/browser-tools/browser-nav.js +44 -0
- package/skills/browser-tools/browser-pick.js +162 -0
- package/skills/browser-tools/browser-screenshot.js +34 -0
- package/skills/browser-tools/browser-start.js +86 -0
- package/skills/browser-tools/package-lock.json +2556 -0
- package/skills/browser-tools/package.json +19 -0
- package/skills/code-review-core/SKILL.md +20 -20
- package/skills/codebase-scout/SKILL.md +19 -19
- package/skills/frontend-design-review/SKILL.md +66 -66
- package/skills/frontend-design-review/references/review-checklist.md +58 -58
- package/skills/frontend-implementation/SKILL.md +49 -47
- package/skills/frontend-implementation/references/code-standards.md +32 -32
- package/skills/frontend-implementation/references/design-spec.md +46 -46
- package/skills/frontend-implementation/references/node-contracts.md +27 -76
- package/skills/frontend-review/SKILL.md +59 -59
- package/skills/frontend-review/references/review-findings.md +47 -47
- package/skills/frontend-verification/SKILL.md +53 -53
- package/skills/frontend-verification/references/verification-checklist.md +68 -68
- package/skills/grill-me/SKILL.md +10 -10
- package/skills/grill-with-docs/SKILL.md +88 -88
- package/skills/grill-with-docs/adr-format.md +47 -47
- package/skills/grill-with-docs/context-format.md +60 -60
- package/skills/init-capability-evolution/SKILL.md +70 -70
- package/skills/loop-agent/SKILL.md +151 -151
- package/skills/loop-agent/references/README.md +67 -67
- package/skills/loop-agent/references/command-reference.md +527 -505
- package/skills/loop-agent/references/docs-converge.md +126 -126
- package/skills/loop-agent/references/harness-policy.md +263 -263
- package/skills/loop-agent/references/hybrid-dag.md +243 -238
- package/skills/loop-agent/references/learned/README.md +21 -21
- package/skills/loop-agent/references/long-running-loop.md +57 -57
- package/skills/loop-agent/references/model-routing.md +36 -36
- package/skills/loop-agent/references/multi-worktree.md +54 -54
- package/skills/loop-agent/references/one-shot-runs.md +85 -85
- package/skills/loop-agent/references/orchestrator-and-interventions.md +169 -169
- package/skills/loop-agent/references/pi-prompt.md +23 -23
- package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
- package/skills/loop-agent/references/post-implementation-and-patterns.md +44 -44
- package/skills/loop-agent/references/task-workflow.md +89 -89
- package/skills/loop-agent/references/verification-and-failure-handling.md +141 -139
- package/skills/playwright-cli/SKILL.md +420 -420
- package/skills/playwright-cli/references/element-attributes.md +23 -23
- package/skills/playwright-cli/references/playwright-tests.md +39 -39
- package/skills/playwright-cli/references/request-mocking.md +87 -87
- package/skills/playwright-cli/references/running-code.md +241 -241
- package/skills/playwright-cli/references/session-management.md +225 -225
- package/skills/playwright-cli/references/storage-state.md +275 -275
- package/skills/playwright-cli/references/test-generation.md +433 -433
- package/skills/playwright-cli/references/tracing.md +139 -139
- package/skills/playwright-cli/references/video-recording.md +143 -143
- package/skills/playwright-cli-case-generator/SKILL.md +74 -74
- package/skills/requesting-code-review/SKILL.md +101 -101
- package/skills/requesting-code-review/code-reviewer.md +168 -168
- package/skills/systematic-debugging/CREATION-LOG.md +119 -119
- package/skills/systematic-debugging/SKILL.md +296 -296
- package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
- package/skills/systematic-debugging/condition-based-waiting.md +115 -115
- package/skills/systematic-debugging/defense-in-depth.md +122 -122
- package/skills/systematic-debugging/find-polluter.sh +63 -63
- package/skills/systematic-debugging/root-cause-tracing.md +169 -169
- package/skills/systematic-debugging/test-academic.md +14 -14
- package/skills/systematic-debugging/test-pressure-1.md +58 -58
- package/skills/systematic-debugging/test-pressure-2.md +68 -68
- package/skills/systematic-debugging/test-pressure-3.md +69 -69
- package/skills/test-driven-development/SKILL.md +20 -20
- package/skills/using-git-worktrees/SKILL.md +215 -215
- package/skills/verification-before-completion/SKILL.md +154 -154
- 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。长期方法论与决策属于 `
|
|
13
|
-
- 工作以小步、可逆、可验证的增量推进。
|
|
14
|
-
- 状态不确定时,先跑基线验证再开新工。
|
|
15
|
-
- 完成由新鲜证据定义,而非意图或信心。
|
|
16
|
-
|
|
17
|
-
## 原则
|
|
18
|
-
|
|
19
|
-
1. 一次任务只推进一个有边界的工作块。
|
|
20
|
-
2. 设计新行为前先搜索现有代码、文档、脚本与测试。
|
|
21
|
-
3. Shell 验证是完成权威。
|
|
22
|
-
4. Runtime 状态在 `.harness/`;持久决策在 `
|
|
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 包内置在
|
|
35
|
-
- 验证与维护脚本:`scripts/`
|
|
36
|
-
- 治理与交接产物:`
|
|
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-
|
|
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)
|