@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.
- package/AGENTS.md +142 -142
- package/CHANGELOG.md +116 -98
- package/README.md +195 -195
- package/bin/agent-worker.js +22 -22
- package/bin/loop-agent.js +21 -21
- package/dist/application/dag/args.js +9 -1
- package/dist/application/dag/run-dag.js +16 -2
- 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 +467 -457
- package/dist/commands/instructions.js +90 -58
- package/dist/commands/loop-benchmark.js +11 -11
- package/dist/commands/pi-reuse-benchmark.js +16 -16
- package/dist/executors/cursor-executor.js +1 -1
- package/dist/executors/dag-pi-executor.js +1 -0
- package/dist/executors/pi-sdk-executor.js +63 -1
- package/dist/shared/preview.js +39 -0
- package/dist/task/runtime.js +27 -27
- 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 +50 -0
- 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/canvas-observer.js +275 -275
- package/dist/workflows/dag/event-observer.js +132 -0
- package/dist/workflows/dag/init-hybrid.js +146 -13
- package/dist/workflows/dag/observer-compose.js +52 -0
- package/docs/README.md +74 -72
- package/docs/agent-dag-recovery-playbook.md +184 -184
- package/docs/agent-dag-runner.md +42 -42
- package/docs/architecture/runtime-boundaries.md +162 -147
- package/docs/cursor-executor-usage.md +25 -25
- package/docs/decisions/README.md +3 -3
- package/docs/design/README.md +49 -36
- package/docs/development-principles.md +73 -73
- package/docs/dynamic-workflow-dag-engine-roadmap.md +1749 -1749
- package/docs/exec-plans/README.md +6 -6
- package/docs/exec-plans/active/README.md +12 -7
- package/docs/exec-plans/completed/README.md +31 -19
- package/docs/feature-workflow.md +186 -186
- 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 +205 -199
- package/docs/loop-agent-harness.md +55 -42
- package/docs/production-readiness.md +96 -96
- package/docs/progress/README.md +3 -3
- package/docs/reports/README.md +9 -5
- package/docs/skills/README.md +6 -6
- package/docs/skills/vetted-skill-registry.md +26 -26
- 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 +454 -454
- package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
- package/docs/templates/agent-dag.base.json +195 -195
- package/docs/templates/agent-dag.final-verification.json +190 -190
- package/docs/templates/agent-dag.schema.json +316 -316
- package/docs/templates/agent-dag.supervised-implementation.json +500 -500
- package/docs/templates/exec-plan.md +64 -64
- package/docs/templates/feature-spec.md +53 -53
- package/docs/templates/hybrid-dag.json +193 -193
- package/docs/templates/init-evolution-review.md +33 -33
- 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 +52 -0
- package/docs/templates/worker-dogfood-setup.md +48 -0
- package/docs/verification-matrix.md +41 -41
- package/examples/decision-gate-agent-dag.json +123 -123
- package/examples/example-dag.json +51 -51
- package/examples/hybrid-loop-agent-dag.json +194 -194
- package/harness.json +70 -69
- package/package.json +66 -66
- package/skills/ai-engineering-context/SKILL.md +48 -48
- package/skills/code-review-core/SKILL.md +20 -20
- package/skills/codebase-scout/SKILL.md +19 -19
- package/skills/init-capability-evolution/SKILL.md +69 -69
- package/skills/loop-agent/SKILL.md +149 -147
- package/skills/loop-agent/references/README.md +67 -67
- package/skills/loop-agent/references/command-reference.md +412 -403
- package/skills/loop-agent/references/harness-policy.md +263 -259
- package/skills/loop-agent/references/hybrid-dag.md +216 -216
- package/skills/loop-agent/references/learned/README.md +21 -21
- package/skills/loop-agent/references/long-running-loop.md +59 -59
- 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 +81 -81
- package/skills/loop-agent/references/post-implementation-and-patterns.md +44 -44
- package/skills/loop-agent/references/task-workflow.md +89 -84
- package/skills/loop-agent/references/verification-and-failure-handling.md +128 -128
- 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/verification-before-completion/SKILL.md +154 -154
- package/skills/webapp-testing/SKILL.md +19 -19
package/dist/cli/program.js
CHANGED
|
@@ -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
|
+
}
|