@tea-agent/loop-agent 0.4.0 → 0.6.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 +2 -2
- package/CHANGELOG.md +48 -38
- package/README.md +3 -3
- package/dist/application/dag/args.js +9 -1
- package/dist/application/dag/run-dag.js +16 -2
- package/dist/application/dag/validate-dag.js +14 -1
- package/dist/cli/command-definitions.js +22 -4
- package/dist/cli/help.js +3 -2
- package/dist/cli/program.js +7 -5
- package/dist/commands/import-prd.js +76 -0
- package/dist/commands/init.js +230 -32
- package/dist/commands/instructions.js +90 -58
- package/dist/executors/config-core.js +3 -2
- package/dist/executors/dag-pi-executor.js +1 -0
- package/dist/executors/model-routing.js +43 -0
- package/dist/executors/pi-sdk-executor.js +63 -1
- package/dist/governance/manifest-types.js +9 -1
- package/dist/shared/preview.js +39 -0
- package/dist/task/source-references.js +221 -0
- package/dist/worker/cli.js +62 -1
- package/dist/worker/loop-agent/loop-agent-client.js +97 -5
- package/dist/worker/materialize/harness-task-materializer.js +162 -5
- package/dist/worker/observability/event-store.js +82 -0
- package/dist/worker/observability/events.js +79 -0
- package/dist/worker/observability/progress-composite.js +33 -0
- package/dist/worker/observability/read-model.js +1013 -0
- package/dist/worker/observability/snapshot-store.js +43 -0
- package/dist/worker/observability/types.js +1 -0
- package/dist/worker/observe/paths.js +64 -0
- package/dist/worker/observe/routes.js +423 -0
- package/dist/worker/observe/server.js +61 -0
- package/dist/worker/observe/static/app.js +1419 -0
- package/dist/worker/observe/static/index.html +63 -0
- package/dist/worker/observe/static/styles.css +613 -0
- package/dist/worker/pool/failure-routing.js +41 -6
- package/dist/worker/pool/run-store.js +59 -1
- package/dist/worker/progress-reporter.js +0 -18
- package/dist/worker/run-task/run-task.js +327 -92
- package/dist/worker/runner/run-ready.js +112 -4
- package/dist/workflows/dag/event-observer.js +132 -0
- package/dist/workflows/dag/init-hybrid.js +150 -26
- package/dist/workflows/dag/observer-compose.js +52 -0
- package/dist/workflows/dag/skill-instructions.js +4 -0
- package/dist/workflows/dag/types.js +1 -1
- package/dist/workflows/dag/validate.js +3 -2
- package/docs/README.md +2 -0
- package/docs/architecture/runtime-boundaries.md +18 -3
- package/docs/design/README.md +22 -9
- package/docs/exec-plans/active/README.md +6 -1
- package/docs/exec-plans/completed/README.md +12 -0
- package/docs/init-surface.manifest.json +32 -2
- package/docs/loop-agent-harness.md +13 -0
- package/docs/reports/README.md +4 -0
- package/docs/templates/agent-dag.base.json +1 -1
- package/docs/templates/agent-dag.final-verification.json +1 -1
- package/docs/templates/agent-dag.supervised-implementation.json +1 -1
- package/docs/templates/hybrid-dag.json +1 -1
- package/docs/templates/worker-dogfood-evidence.md +52 -0
- package/docs/templates/worker-dogfood-setup.md +48 -0
- package/examples/example-dag.json +1 -1
- package/examples/hybrid-loop-agent-dag.json +1 -1
- package/harness.json +5 -29
- package/package.json +6 -6
- package/skills/loop-agent/SKILL.md +5 -3
- package/skills/loop-agent/references/command-reference.md +12 -3
- package/skills/loop-agent/references/harness-policy.md +7 -3
- package/skills/loop-agent/references/task-workflow.md +8 -3
|
@@ -47,7 +47,9 @@ Minimum governed path：
|
|
|
47
47
|
|
|
48
48
|
```bash
|
|
49
49
|
loop-agent new-task <task-id> "Task Title" [--repo-root <target-repo>]
|
|
50
|
-
#
|
|
50
|
+
# optional but recommended for user PRDs:
|
|
51
|
+
# loop-agent import-prd <task-id> --file <path-to-original-prd.md> [--repo-root <target-repo>]
|
|
52
|
+
# write derived <target-repo>/.harness/tasks/<task-id>/source/需求.md
|
|
51
53
|
# write <target-repo>/.harness/tasks/<task-id>/source/执行约束.md
|
|
52
54
|
|
|
53
55
|
loop-agent dag run-task <task-id> \
|
|
@@ -95,11 +97,13 @@ On Windows, run Bash scripts through Git Bash or a configured compatible Bash. D
|
|
|
95
97
|
.harness/tasks/<task-id>/
|
|
96
98
|
task.json
|
|
97
99
|
source/
|
|
98
|
-
|
|
100
|
+
references/ # immutable original PRD / acceptance / design
|
|
101
|
+
source-manifest.json # optional hash manifest from import-prd
|
|
102
|
+
需求.md # derived execution contract
|
|
99
103
|
执行约束.md
|
|
100
104
|
```
|
|
101
105
|
|
|
102
|
-
`需求.md` 应陈述 objective、scope、non-goals、acceptance criteria
|
|
106
|
+
`需求.md` 应陈述 objective、scope、non-goals、acceptance criteria，并链接或追溯 `source/references/*` / repo-local specs 或 plans。原始 PRD 优先 `import-prd` 归档；Worker materialize 会复制 `source_docs` 到 `references/`，并把 acceptance_refs 展开为短摘要。冲突时以 `source/references/*` 为准。
|
|
103
107
|
|
|
104
108
|
`执行约束.md` 应陈述：
|
|
105
109
|
|
|
@@ -26,14 +26,19 @@ loop-agent run-dag --dag <temp-dir>/<task-id>-dag.json --cwd <repo-root>
|
|
|
26
26
|
```text
|
|
27
27
|
.harness/tasks/<task-id>/
|
|
28
28
|
source/
|
|
29
|
-
|
|
29
|
+
references/ # 原始 PRD / design / acceptance（不可变）
|
|
30
|
+
source-manifest.json # import-prd 写入的 hash 清单
|
|
31
|
+
需求.md # 派生执行契约
|
|
30
32
|
执行约束.md
|
|
31
33
|
task.json
|
|
32
34
|
```
|
|
33
35
|
|
|
34
|
-
-
|
|
36
|
+
- 用户原始 PRD 用 `loop-agent import-prd <task-id> --file <prd>` 归档到 `source/references/`，禁止 AI 改写。
|
|
37
|
+
- `需求.md` 是派生执行契约：写清目标、验收标准、非目标，并用 REQ/AC 或原文锚点映射回 references。
|
|
35
38
|
- `执行约束.md` 写清允许文件、禁止改动、硬约束和验证命令。
|
|
36
|
-
- 若 `docs/` 已有权威 plan/spec/PRD
|
|
39
|
+
- 若 `docs/` 已有权威 plan/spec/PRD，优先 `import-prd` 复制，再在 `需求.md` 引用；避免把长 PRD 直接改写成唯一 source。
|
|
40
|
+
- Worker / TaskSpec materialize 路径会把 `source_docs` 复制到 `source/references/`，并在派生 `需求.md` 顶部声明“冲突以 references 为准”；`acceptance_refs` 应展开为短摘要而不只写 ID。
|
|
41
|
+
- review 节点必须三方对照：`source/references/*`（尤其 requirement/acceptance）、派生 `需求.md`、以及实现/验证证据。
|
|
37
42
|
|
|
38
43
|
## Task State
|
|
39
44
|
|