@tea-agent/loop-agent 0.5.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.
Files changed (133) hide show
  1. package/AGENTS.md +142 -142
  2. package/CHANGELOG.md +116 -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/runtime.js +27 -27
  21. package/dist/task/source-references.js +221 -0
  22. package/dist/worker/cli.js +62 -1
  23. package/dist/worker/loop-agent/loop-agent-client.js +97 -5
  24. package/dist/worker/materialize/harness-task-materializer.js +162 -5
  25. package/dist/worker/observability/event-store.js +82 -0
  26. package/dist/worker/observability/events.js +79 -0
  27. package/dist/worker/observability/progress-composite.js +33 -0
  28. package/dist/worker/observability/read-model.js +1013 -0
  29. package/dist/worker/observability/snapshot-store.js +43 -0
  30. package/dist/worker/observability/types.js +1 -0
  31. package/dist/worker/observe/paths.js +64 -0
  32. package/dist/worker/observe/routes.js +423 -0
  33. package/dist/worker/observe/server.js +61 -0
  34. package/dist/worker/observe/static/app.js +1419 -0
  35. package/dist/worker/observe/static/index.html +63 -0
  36. package/dist/worker/observe/static/styles.css +613 -0
  37. package/dist/worker/pool/failure-routing.js +41 -6
  38. package/dist/worker/pool/run-store.js +50 -0
  39. package/dist/worker/progress-reporter.js +0 -18
  40. package/dist/worker/run-task/run-task.js +327 -92
  41. package/dist/worker/runner/run-ready.js +112 -4
  42. package/dist/workflows/dag/canvas-observer.js +275 -275
  43. package/dist/workflows/dag/event-observer.js +132 -0
  44. package/dist/workflows/dag/init-hybrid.js +146 -13
  45. package/dist/workflows/dag/observer-compose.js +52 -0
  46. package/docs/README.md +74 -72
  47. package/docs/agent-dag-recovery-playbook.md +184 -184
  48. package/docs/agent-dag-runner.md +42 -42
  49. package/docs/architecture/runtime-boundaries.md +162 -147
  50. package/docs/cursor-executor-usage.md +25 -25
  51. package/docs/decisions/README.md +3 -3
  52. package/docs/design/README.md +49 -36
  53. package/docs/development-principles.md +73 -73
  54. package/docs/dynamic-workflow-dag-engine-roadmap.md +1749 -1749
  55. package/docs/exec-plans/README.md +6 -6
  56. package/docs/exec-plans/active/README.md +12 -7
  57. package/docs/exec-plans/completed/README.md +31 -19
  58. package/docs/feature-workflow.md +186 -186
  59. package/docs/harness-methodology-debugging.md +153 -153
  60. package/docs/harness-methodology-tdd.md +130 -130
  61. package/docs/harness-methodology-verification.md +27 -27
  62. package/docs/init-surface.manifest.json +205 -199
  63. package/docs/loop-agent-harness.md +55 -42
  64. package/docs/production-readiness.md +96 -96
  65. package/docs/progress/README.md +3 -3
  66. package/docs/reports/README.md +9 -5
  67. package/docs/skills/README.md +6 -6
  68. package/docs/skills/vetted-skill-registry.md +26 -26
  69. package/docs/templates/adr.md +60 -60
  70. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  71. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  72. package/docs/templates/agent-dag-decision-gate-dogfood-report.md +117 -117
  73. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  74. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  75. package/docs/templates/agent-dag-report.schema.json +454 -454
  76. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  77. package/docs/templates/agent-dag.base.json +195 -195
  78. package/docs/templates/agent-dag.final-verification.json +190 -190
  79. package/docs/templates/agent-dag.schema.json +316 -316
  80. package/docs/templates/agent-dag.supervised-implementation.json +500 -500
  81. package/docs/templates/exec-plan.md +64 -64
  82. package/docs/templates/feature-spec.md +53 -53
  83. package/docs/templates/hybrid-dag.json +193 -193
  84. package/docs/templates/init-evolution-review.md +33 -33
  85. package/docs/templates/production-readiness-checklist.md +57 -57
  86. package/docs/templates/progress-log.md +17 -17
  87. package/docs/templates/project-start-checklist.md +9 -9
  88. package/docs/templates/qa-report.md +48 -48
  89. package/docs/templates/sprint-contract.md +29 -29
  90. package/docs/templates/worker-dogfood-evidence.md +52 -0
  91. package/docs/templates/worker-dogfood-setup.md +48 -0
  92. package/docs/verification-matrix.md +41 -41
  93. package/examples/decision-gate-agent-dag.json +123 -123
  94. package/examples/example-dag.json +51 -51
  95. package/examples/hybrid-loop-agent-dag.json +194 -194
  96. package/harness.json +70 -69
  97. package/package.json +66 -66
  98. package/skills/ai-engineering-context/SKILL.md +48 -48
  99. package/skills/code-review-core/SKILL.md +20 -20
  100. package/skills/codebase-scout/SKILL.md +19 -19
  101. package/skills/init-capability-evolution/SKILL.md +69 -69
  102. package/skills/loop-agent/SKILL.md +149 -147
  103. package/skills/loop-agent/references/README.md +67 -67
  104. package/skills/loop-agent/references/command-reference.md +412 -403
  105. package/skills/loop-agent/references/harness-policy.md +263 -259
  106. package/skills/loop-agent/references/hybrid-dag.md +216 -216
  107. package/skills/loop-agent/references/learned/README.md +21 -21
  108. package/skills/loop-agent/references/long-running-loop.md +59 -59
  109. package/skills/loop-agent/references/model-routing.md +36 -36
  110. package/skills/loop-agent/references/multi-worktree.md +54 -54
  111. package/skills/loop-agent/references/one-shot-runs.md +85 -85
  112. package/skills/loop-agent/references/orchestrator-and-interventions.md +169 -169
  113. package/skills/loop-agent/references/pi-prompt.md +23 -23
  114. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +81 -81
  115. package/skills/loop-agent/references/post-implementation-and-patterns.md +44 -44
  116. package/skills/loop-agent/references/task-workflow.md +89 -84
  117. package/skills/loop-agent/references/verification-and-failure-handling.md +128 -128
  118. package/skills/requesting-code-review/SKILL.md +101 -101
  119. package/skills/requesting-code-review/code-reviewer.md +168 -168
  120. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  121. package/skills/systematic-debugging/SKILL.md +296 -296
  122. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  123. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  124. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  125. package/skills/systematic-debugging/find-polluter.sh +63 -63
  126. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  127. package/skills/systematic-debugging/test-academic.md +14 -14
  128. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  129. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  130. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  131. package/skills/test-driven-development/SKILL.md +20 -20
  132. package/skills/verification-before-completion/SKILL.md +154 -154
  133. 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
+ }