@tea-agent/loop-agent 0.5.0 → 0.7.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 (136) hide show
  1. package/AGENTS.md +142 -142
  2. package/CHANGELOG.md +132 -98
  3. package/README.md +195 -195
  4. package/bin/agent-worker.js +22 -22
  5. package/bin/loop-agent.js +21 -21
  6. package/dist/application/dag/args.js +9 -1
  7. package/dist/application/dag/run-dag.js +16 -2
  8. package/dist/cli/command-definitions.js +22 -4
  9. package/dist/cli/help.js +3 -2
  10. package/dist/cli/program.js +7 -5
  11. package/dist/commands/import-prd.js +76 -0
  12. package/dist/commands/init.js +467 -457
  13. package/dist/commands/instructions.js +90 -58
  14. package/dist/commands/loop-benchmark.js +11 -11
  15. package/dist/commands/pi-reuse-benchmark.js +16 -16
  16. package/dist/executors/cursor-executor.js +1 -1
  17. package/dist/executors/dag-pi-executor.js +1 -0
  18. package/dist/executors/pi-sdk-executor.js +63 -1
  19. package/dist/shared/preview.js +39 -0
  20. package/dist/task/config-types.js +3 -0
  21. package/dist/task/runtime.js +27 -27
  22. package/dist/task/source-references.js +221 -0
  23. package/dist/worker/cli.js +62 -1
  24. package/dist/worker/loop-agent/loop-agent-client.js +97 -5
  25. package/dist/worker/materialize/harness-task-materializer.js +166 -5
  26. package/dist/worker/observability/event-store.js +82 -0
  27. package/dist/worker/observability/events.js +79 -0
  28. package/dist/worker/observability/progress-composite.js +33 -0
  29. package/dist/worker/observability/read-model.js +1013 -0
  30. package/dist/worker/observability/snapshot-store.js +43 -0
  31. package/dist/worker/observability/types.js +1 -0
  32. package/dist/worker/observe/paths.js +64 -0
  33. package/dist/worker/observe/routes.js +423 -0
  34. package/dist/worker/observe/server.js +61 -0
  35. package/dist/worker/observe/static/app.js +1419 -0
  36. package/dist/worker/observe/static/index.html +63 -0
  37. package/dist/worker/observe/static/styles.css +613 -0
  38. package/dist/worker/pool/failure-routing.js +41 -6
  39. package/dist/worker/pool/run-store.js +50 -0
  40. package/dist/worker/progress-reporter.js +0 -18
  41. package/dist/worker/run-task/run-task.js +327 -92
  42. package/dist/worker/runner/run-ready.js +112 -4
  43. package/dist/worker/task-spec/schema.js +2 -1
  44. package/dist/workflows/dag/canvas-observer.js +275 -275
  45. package/dist/workflows/dag/event-observer.js +132 -0
  46. package/dist/workflows/dag/init-hybrid.js +182 -21
  47. package/dist/workflows/dag/observer-compose.js +52 -0
  48. package/docs/README.md +75 -72
  49. package/docs/agent-dag-recovery-playbook.md +184 -184
  50. package/docs/agent-dag-runner.md +42 -42
  51. package/docs/architecture/runtime-boundaries.md +162 -147
  52. package/docs/cursor-executor-usage.md +25 -25
  53. package/docs/decisions/README.md +3 -3
  54. package/docs/design/README.md +49 -36
  55. package/docs/development-principles.md +73 -73
  56. package/docs/dynamic-workflow-dag-engine-roadmap.md +1749 -1749
  57. package/docs/exec-plans/README.md +6 -6
  58. package/docs/exec-plans/active/README.md +12 -7
  59. package/docs/exec-plans/completed/README.md +32 -19
  60. package/docs/feature-workflow.md +186 -186
  61. package/docs/harness-methodology-debugging.md +153 -153
  62. package/docs/harness-methodology-tdd.md +130 -130
  63. package/docs/harness-methodology-verification.md +27 -27
  64. package/docs/init-surface.manifest.json +208 -199
  65. package/docs/loop-agent-harness.md +55 -42
  66. package/docs/production-readiness.md +96 -96
  67. package/docs/progress/README.md +3 -3
  68. package/docs/reports/README.md +9 -5
  69. package/docs/skills/README.md +6 -6
  70. package/docs/skills/vetted-skill-registry.md +26 -26
  71. package/docs/templates/adr.md +60 -60
  72. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  73. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  74. package/docs/templates/agent-dag-decision-gate-dogfood-report.md +117 -117
  75. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  76. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  77. package/docs/templates/agent-dag-report.schema.json +454 -454
  78. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  79. package/docs/templates/agent-dag.base.json +195 -195
  80. package/docs/templates/agent-dag.final-verification.json +190 -190
  81. package/docs/templates/agent-dag.schema.json +316 -316
  82. package/docs/templates/agent-dag.supervised-implementation.json +500 -500
  83. package/docs/templates/exec-plan.md +64 -64
  84. package/docs/templates/feature-spec.md +53 -53
  85. package/docs/templates/hybrid-dag.json +193 -193
  86. package/docs/templates/init-evolution-review.md +33 -33
  87. package/docs/templates/interactive-ui-round2-experiment.md +66 -0
  88. package/docs/templates/production-readiness-checklist.md +57 -57
  89. package/docs/templates/progress-log.md +17 -17
  90. package/docs/templates/project-start-checklist.md +9 -9
  91. package/docs/templates/qa-report.md +48 -48
  92. package/docs/templates/sprint-contract.md +29 -29
  93. package/docs/templates/worker-dogfood-evidence.md +52 -0
  94. package/docs/templates/worker-dogfood-setup.md +48 -0
  95. package/docs/verification-matrix.md +41 -41
  96. package/examples/decision-gate-agent-dag.json +123 -123
  97. package/examples/example-dag.json +51 -51
  98. package/examples/hybrid-loop-agent-dag.json +194 -194
  99. package/harness.json +70 -69
  100. package/package.json +66 -66
  101. package/skills/ai-engineering-context/SKILL.md +48 -48
  102. package/skills/code-review-core/SKILL.md +20 -20
  103. package/skills/codebase-scout/SKILL.md +19 -19
  104. package/skills/init-capability-evolution/SKILL.md +69 -69
  105. package/skills/loop-agent/SKILL.md +149 -147
  106. package/skills/loop-agent/references/README.md +67 -67
  107. package/skills/loop-agent/references/command-reference.md +412 -403
  108. package/skills/loop-agent/references/harness-policy.md +263 -259
  109. package/skills/loop-agent/references/hybrid-dag.md +216 -216
  110. package/skills/loop-agent/references/learned/README.md +21 -21
  111. package/skills/loop-agent/references/long-running-loop.md +59 -59
  112. package/skills/loop-agent/references/model-routing.md +36 -36
  113. package/skills/loop-agent/references/multi-worktree.md +54 -54
  114. package/skills/loop-agent/references/one-shot-runs.md +85 -85
  115. package/skills/loop-agent/references/orchestrator-and-interventions.md +169 -169
  116. package/skills/loop-agent/references/pi-prompt.md +23 -23
  117. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +81 -81
  118. package/skills/loop-agent/references/post-implementation-and-patterns.md +44 -44
  119. package/skills/loop-agent/references/task-workflow.md +89 -84
  120. package/skills/loop-agent/references/verification-and-failure-handling.md +128 -128
  121. package/skills/requesting-code-review/SKILL.md +101 -101
  122. package/skills/requesting-code-review/code-reviewer.md +168 -168
  123. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  124. package/skills/systematic-debugging/SKILL.md +296 -296
  125. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  126. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  127. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  128. package/skills/systematic-debugging/find-polluter.sh +63 -63
  129. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  130. package/skills/systematic-debugging/test-academic.md +14 -14
  131. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  132. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  133. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  134. package/skills/test-driven-development/SKILL.md +20 -20
  135. package/skills/verification-before-completion/SKILL.md +154 -154
  136. package/skills/webapp-testing/SKILL.md +19 -19
@@ -33,6 +33,7 @@ import { runKnowledge } from "../commands/knowledge.js";
33
33
  import { runLoop } from "../commands/loop.js";
34
34
  import { runLoopBenchmark } from "../commands/loop-benchmark.js";
35
35
  import { runNewTask } from "../commands/new-task.js";
36
+ import { runImportPrd } from "../commands/import-prd.js";
36
37
  import { runPiReuseBenchmark } from "../commands/pi-reuse-benchmark.js";
37
38
  import { parsePiPromptArgs, printPiPromptUsage, runPiPrompt, } from "../commands/pi-prompt.js";
38
39
  import { runPlanList } from "../commands/plan-list.js";
@@ -143,6 +144,9 @@ async function runCommanderAction(ctx, command, subcommand, rest) {
143
144
  await runNewTask(ctx.repoRoot, taskId, titleParts.join(" ") || undefined);
144
145
  return;
145
146
  }
147
+ case "import-prd":
148
+ await runImportPrd(ctx.repoRoot, compactArgs([subcommand, ...rest]));
149
+ return;
146
150
  case "status": {
147
151
  if (!subcommand)
148
152
  throw new Error("taskId required");
@@ -355,10 +359,7 @@ function configureDagValidate(command) {
355
359
  .option("--strict-models", "fail on model routing warnings")
356
360
  .option("--strict-governance", "fail on governance warnings")
357
361
  .option("--strict-skills", "fail on missing, errored, truncated, or unresolved skill instructions")
358
- .option("--forbid-executor <executor>", "forbid executor", (value, previous = []) => [
359
- ...previous,
360
- value,
361
- ])
362
+ .option("--forbid-executor <executor>", "forbid executor", (value, previous = []) => [...previous, value])
362
363
  .option("--spine-task <task-id>", "run spine audit for task id");
363
364
  }
364
365
  function configureRunDag(command) {
@@ -373,7 +374,8 @@ function configureRunDag(command) {
373
374
  .option("--no-cursor", "disable Cursor execution")
374
375
  .option("--canvas-path <path>", "absolute canvas output path")
375
376
  .option("--canvas <name>", "canvas name")
376
- .option("--canvases-dir <dir>", "canvas output directory");
377
+ .option("--canvases-dir <dir>", "canvas output directory")
378
+ .option("--events-jsonl <path>", "append DAG node events to a JSONL file");
377
379
  }
378
380
  function configureDagRunTask(command) {
379
381
  command
@@ -0,0 +1,76 @@
1
+ import path from "node:path";
2
+ import { importPrdDocument } from "../task/source-references.js";
3
+ export function parseImportPrdArgs(args) {
4
+ const options = {};
5
+ const positional = [];
6
+ for (let index = 0; index < args.length; index += 1) {
7
+ const token = args[index];
8
+ if (token === "--file" || token === "-f") {
9
+ options.file = args[index + 1];
10
+ index += 1;
11
+ continue;
12
+ }
13
+ if (token === "--name") {
14
+ options.name = args[index + 1];
15
+ index += 1;
16
+ continue;
17
+ }
18
+ if (token === "--role") {
19
+ options.role = args[index + 1];
20
+ index += 1;
21
+ continue;
22
+ }
23
+ if (token === "--json") {
24
+ options.json = true;
25
+ continue;
26
+ }
27
+ if (token.startsWith("-")) {
28
+ throw new Error(`unknown flag ${token}\nusage: import-prd <task-id> --file <path> [--name requirement] [--role requirement] [--json]`);
29
+ }
30
+ positional.push(token);
31
+ }
32
+ const taskId = positional[0];
33
+ if (!taskId) {
34
+ throw new Error("usage: import-prd <task-id> --file <path> [--name requirement] [--role requirement] [--json]");
35
+ }
36
+ if (!options.file) {
37
+ throw new Error("usage: import-prd <task-id> --file <path> [--name requirement] [--role requirement] [--json]");
38
+ }
39
+ return { taskId, options };
40
+ }
41
+ export async function runImportPrd(repoRoot, args) {
42
+ const { taskId, options } = parseImportPrdArgs(args);
43
+ const result = await importPrdDocument({
44
+ repoRoot,
45
+ taskId,
46
+ filePath: options.file,
47
+ name: options.name,
48
+ role: options.role,
49
+ });
50
+ if (options.json) {
51
+ console.log(JSON.stringify({
52
+ ok: true,
53
+ taskId: result.taskId,
54
+ sourcePath: result.sourcePath,
55
+ materializedPath: result.materializedRelativePath,
56
+ materializedAbsolutePath: result.materializedAbsolutePath,
57
+ sha256: result.sha256,
58
+ bytes: result.bytes,
59
+ manifestPath: path
60
+ .relative(repoRoot, result.manifestPath)
61
+ .split(path.sep)
62
+ .join("/"),
63
+ referenceDocs: result.referenceDocs,
64
+ message: "Imported PRD as an immutable source reference. Derive source/需求.md from it; do not rewrite the reference copy.",
65
+ }, null, 2));
66
+ return;
67
+ }
68
+ console.log([
69
+ `imported PRD for task ${result.taskId}`,
70
+ ` source: ${result.sourcePath}`,
71
+ ` materialized: ${result.materializedRelativePath}`,
72
+ ` sha256: ${result.sha256}`,
73
+ ` manifest: ${path.relative(repoRoot, result.manifestPath).split(path.sep).join("/")}`,
74
+ "Next: write source/需求.md as a derived execution contract with REQ/AC ids that map back to the original PRD. Do not edit source/references/*.",
75
+ ].join("\n"));
76
+ }