@tea-agent/loop-agent 0.35.1-beta.0 → 0.35.1-beta.1

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 (168) hide show
  1. package/AGENTS.md +110 -108
  2. package/CHANGELOG.md +16 -26
  3. package/README.md +165 -165
  4. package/bin/agent-worker.js +0 -0
  5. package/bin/loop-agent.js +57 -21
  6. package/dist/application/task-lifecycle/advance.js +0 -1
  7. package/dist/build-stamp.json +6 -0
  8. package/dist/cli/program.js +2 -2
  9. package/dist/commands/cursor-prompt.js +6 -6
  10. package/dist/commands/init-upgrade.js +19 -351
  11. package/dist/commands/init.js +67 -14
  12. package/dist/commands/loop-benchmark.js +11 -11
  13. package/dist/commands/pi-reuse-benchmark.js +16 -16
  14. package/dist/commands/run-dag-progress.js +0 -14
  15. package/dist/commands/task-advance.js +3 -33
  16. package/dist/shared/operator/capabilities.js +1 -38
  17. package/dist/shared/package-metadata.js +32 -0
  18. package/dist/sidecars/cursor-prompt/executor.js +1 -1
  19. package/dist/worker/console/chat/pi-runtime.js +25 -41
  20. package/dist/worker/console/chat/routes.js +4 -27
  21. package/dist/worker/console/operation-runner.js +0 -24
  22. package/dist/worker/console/operator-actions.js +0 -58
  23. package/dist/worker/console/static/assets/index-fsjzREob.js +56 -0
  24. package/dist/worker/console/static/assets/{index-Dups4sSM.css → index-hJqCPs_g.css} +1 -1
  25. package/dist/worker/console/static/index.html +2 -2
  26. package/dist/worker/console/static-src/operator-chat/useChatSessions.js +2 -13
  27. package/dist/worker/console/static-src/operator-chat/useComposer.js +7 -30
  28. package/dist/worker/loop-agent/loop-agent-client.js +13 -0
  29. package/dist/worker/observe/static/copy.js +67 -67
  30. package/dist/worker/observe/static/dag-layout.d.ts +36 -36
  31. package/dist/worker/observe/static/dom.js +220 -220
  32. package/dist/worker/observe/static/relations.js +133 -133
  33. package/dist/worker/observe/static/run-processing.js +148 -148
  34. package/dist/worker/observe/static/views/batch.js +227 -227
  35. package/dist/worker/observe/static/views/failures.js +143 -143
  36. package/dist/worker/observe/static/views/feature.js +492 -492
  37. package/dist/worker/observe/static/views/run.js +453 -453
  38. package/dist/worker/observe/static/views/shell.js +7 -7
  39. package/dist/worker/observe/static/views/timeline.js +163 -163
  40. package/dist/workflows/dag/canvas-observer.js +275 -275
  41. package/dist/workflows/dag/contract-output-registry.js +14 -0
  42. package/dist/workflows/dag/contract-validator-registrations.js +8 -0
  43. package/dist/workflows/dag/dynamic-runtime/shared.js +9 -1
  44. package/dist/workflows/dag/frontend-implementation-contract.js +233 -39
  45. package/dist/workflows/dag/frontend-prewrite-gate.js +364 -61
  46. package/dist/workflows/dag/frontend-repair.js +219 -18
  47. package/dist/workflows/dag/frontend-verification-trace.js +47 -32
  48. package/dist/workflows/dag/init-hybrid.js +41 -24
  49. package/dist/workflows/dag/node-execution.js +89 -0
  50. package/dist/workflows/dag/runner.js +52 -3
  51. package/dist/workflows/dag/scheduler.js +98 -3
  52. package/dist/workflows/dag/types.js +23 -2
  53. package/docs/architecture/evolution.md +73 -73
  54. package/docs/architecture/system-overview.md +100 -100
  55. package/docs/architecture/worker-and-feature.md +122 -122
  56. package/docs/skills/README.md +7 -7
  57. package/docs/templates/adr.md +60 -60
  58. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  59. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  60. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  61. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  62. package/docs/templates/agent-dag-report.schema.json +473 -473
  63. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  64. package/docs/templates/backend-test-result.schema.json +99 -99
  65. package/docs/templates/evaluation/agents-map-slim-v1.md +87 -87
  66. package/docs/templates/evaluation/agents-map-verbose-v0.md +153 -153
  67. package/docs/templates/feature-spec.md +53 -53
  68. package/docs/templates/frontend-design-contract.md +42 -42
  69. package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md +17 -17
  70. package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md +16 -16
  71. package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md +16 -16
  72. package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md +16 -16
  73. package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md +16 -16
  74. package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md +16 -16
  75. package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md +21 -21
  76. package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md +29 -29
  77. package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md +28 -28
  78. package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md +28 -28
  79. package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md +29 -29
  80. package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md +27 -27
  81. package/docs/templates/frontend-eval/fixtures/functional/06-ssr-server-client-boundary.md +28 -28
  82. package/docs/templates/frontend-eval/fixtures/functional/07-shared-public-component-api.md +28 -28
  83. package/docs/templates/frontend-eval/fixtures/functional/08-pure-local-no-remote.md +27 -27
  84. package/docs/templates/frontend-eval/metrics.md +138 -138
  85. package/docs/templates/frontend-eval/smoke-targets.md +53 -53
  86. package/docs/templates/frontend-task-constraints.md +35 -35
  87. package/docs/templates/frontend-task-requirement.md +70 -70
  88. package/docs/templates/init-evolution-review.md +35 -35
  89. package/docs/templates/init-managed-agents.md +154 -156
  90. package/docs/templates/interactive-ui-round2-experiment.md +66 -66
  91. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -118
  92. package/docs/templates/knowledge-sync-dag.json +178 -178
  93. package/docs/templates/knowledge-sync-draft.schema.json +71 -71
  94. package/docs/templates/product-line/closeout.yaml +9 -9
  95. package/docs/templates/product-line/design.md +13 -13
  96. package/docs/templates/product-line/links.md +10 -10
  97. package/docs/templates/product-line/requirement.md +17 -17
  98. package/docs/templates/product-line/test-plan.md +7 -7
  99. package/docs/templates/project-start-checklist.md +9 -9
  100. package/docs/templates/qa-report.md +48 -48
  101. package/docs/templates/sprint-contract.md +29 -29
  102. package/docs/templates/worker-dogfood-evidence.md +80 -80
  103. package/docs/templates/worker-dogfood-setup.md +68 -68
  104. package/harness.json +2 -5
  105. package/package.json +2 -2
  106. package/scripts/kb-bootstrap-init-skeleton.sh +0 -0
  107. package/scripts/kb-graph-incremental-prepare.mjs +0 -0
  108. package/scripts/kb-graph-materialize.mjs +105 -105
  109. package/scripts/kb-graph-promote.mjs +164 -164
  110. package/scripts/kb-query.mjs +554 -554
  111. package/skills/agent-worker/SKILL.md +48 -48
  112. package/skills/agent-worker/references/agent-worker-operator.md +159 -159
  113. package/skills/ai-engineering-context/SKILL.md +48 -48
  114. package/skills/analyze-product-dependencies/scripts/test-validators.mjs +0 -0
  115. package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +0 -0
  116. package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +0 -0
  117. package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +0 -0
  118. package/skills/analyze-product-requirements/scripts/compute-source-identity.mjs +0 -0
  119. package/skills/analyze-product-requirements/scripts/test-validators.mjs +0 -0
  120. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +0 -0
  121. package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +0 -0
  122. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +0 -0
  123. package/skills/browser-tools/browser-content.js +103 -103
  124. package/skills/browser-tools/browser-cookies.js +35 -35
  125. package/skills/browser-tools/browser-eval.js +53 -53
  126. package/skills/browser-tools/browser-hn-scraper.js +108 -108
  127. package/skills/browser-tools/browser-nav.js +44 -44
  128. package/skills/browser-tools/browser-pick.js +162 -162
  129. package/skills/browser-tools/browser-screenshot.js +34 -34
  130. package/skills/browser-tools/browser-start.js +86 -86
  131. package/skills/browser-tools/package-lock.json +2556 -2556
  132. package/skills/browser-tools/package.json +19 -19
  133. package/skills/code-review-core/SKILL.md +20 -20
  134. package/skills/codebase-scout/SKILL.md +19 -19
  135. package/skills/grill-me/SKILL.md +10 -10
  136. package/skills/local-jacoco-coverage/scripts/run-coverage-analysis.sh +0 -0
  137. package/skills/local-jacoco-coverage/scripts/start-jacoco-agent.sh +0 -0
  138. package/skills/loop-agent/SKILL.md +0 -1
  139. package/skills/loop-agent/references/command-reference.md +639 -641
  140. package/skills/loop-agent/references/docs-converge.md +126 -126
  141. package/skills/loop-agent/references/learned/README.md +21 -21
  142. package/skills/loop-agent/references/pi-prompt.md +23 -23
  143. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
  144. package/skills/playwright-cli/references/element-attributes.md +23 -23
  145. package/skills/playwright-cli/references/playwright-tests.md +39 -39
  146. package/skills/playwright-cli/references/request-mocking.md +87 -87
  147. package/skills/playwright-cli/references/running-code.md +241 -241
  148. package/skills/playwright-cli/references/session-management.md +225 -225
  149. package/skills/playwright-cli/references/storage-state.md +275 -275
  150. package/skills/playwright-cli/references/test-generation.md +433 -433
  151. package/skills/requesting-code-review/SKILL.md +101 -101
  152. package/skills/requesting-code-review/code-reviewer.md +168 -168
  153. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  154. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  155. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  156. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  157. package/skills/systematic-debugging/find-polluter.sh +63 -63
  158. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  159. package/skills/systematic-debugging/test-academic.md +14 -14
  160. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  161. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  162. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  163. package/skills/using-git-worktrees/SKILL.md +215 -215
  164. package/skills/verification-before-completion/SKILL.md +154 -154
  165. package/skills/webapp-testing/SKILL.md +19 -19
  166. package/dist/worker/console/operation-wait.js +0 -241
  167. package/dist/worker/console/static/assets/index-SjjjZnV3.js +0 -56
  168. package/dist/worker/console/static-src/operator-chat/slash-palette-nav.js +0 -141
@@ -7,6 +7,10 @@ import { parseCommandJson } from "./parse-json.js";
7
7
  export const DEFAULT_WORKER_COMMAND_TIMEOUT_MS = 120_000;
8
8
  export const DEFAULT_HEARTBEAT_INTERVAL_MS = 15_000;
9
9
  export const LOOP_AGENT_PACKAGE_NAME = "@tea-agent/loop-agent";
10
+ /** Grace window between the SIGTERM and SIGKILL stages of a hard timeout, so a
11
+ * runner can persist terminal state (see executeDagCheckpoint) before being
12
+ * force-killed. */
13
+ export const HARD_TIMEOUT_KILL_GRACE_MS = 10_000;
10
14
  const MAX_BUFFERED_OUTPUT_BYTES = 64 * 1024;
11
15
  /**
12
16
  * Bind evidence supplied by an orchestration layer to the identity exposed by
@@ -381,10 +385,17 @@ function spawnCommand(input) {
381
385
  });
382
386
  };
383
387
  let hardTimeout;
388
+ let killGraceTimeout;
384
389
  if (input.hardTimeoutMs !== undefined && input.hardTimeoutMs > 0) {
385
390
  hardTimeout = setTimeout(() => {
386
391
  timedOut = true;
392
+ // Two-stage termination: SIGTERM first so the runner can persist a
393
+ // terminal state (see executeDagCheckpoint signal handler), then
394
+ // SIGKILL only after the grace window expires.
387
395
  child.kill("SIGTERM");
396
+ killGraceTimeout = setTimeout(() => {
397
+ child.kill("SIGKILL");
398
+ }, HARD_TIMEOUT_KILL_GRACE_MS);
388
399
  }, input.hardTimeoutMs);
389
400
  }
390
401
  let heartbeatTimer;
@@ -394,6 +405,8 @@ function spawnCommand(input) {
394
405
  const clearTimers = () => {
395
406
  if (hardTimeout !== undefined)
396
407
  clearTimeout(hardTimeout);
408
+ if (killGraceTimeout !== undefined)
409
+ clearTimeout(killGraceTimeout);
397
410
  if (heartbeatTimer !== undefined) {
398
411
  clearInterval(heartbeatTimer);
399
412
  heartbeatTimer = undefined;
@@ -1,67 +1,67 @@
1
- /** Copy-only recommended commands (Observe UI R5). */
2
- import { el } from "./dom.js";
3
-
4
- export async function copyText(text) {
5
- const value = String(text ?? "");
6
- if (!value) return false;
7
- try {
8
- if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
9
- await navigator.clipboard.writeText(value);
10
- return true;
11
- }
12
- } catch {
13
- // fall through
14
- }
15
- try {
16
- const ta = document.createElement("textarea");
17
- ta.value = value;
18
- ta.setAttribute("readonly", "");
19
- ta.style.position = "fixed";
20
- ta.style.left = "-9999px";
21
- document.body.appendChild(ta);
22
- ta.select();
23
- const ok = document.execCommand("copy");
24
- document.body.removeChild(ta);
25
- return ok;
26
- } catch {
27
- return false;
28
- }
29
- }
30
-
31
- /** Advisory recommended command: copy-only, never executes. */
32
- export function renderRecommendedCommand(action) {
33
- const block = el("div", "recommended-command");
34
- if (!action) {
35
- block.appendChild(el("span", "muted", "缺失"));
36
- return block;
37
- }
38
- const head = el("div", "recommended-command-head");
39
- if (action.kind) {
40
- head.appendChild(el("span", "recommended-command-kind", action.kind));
41
- }
42
- head.appendChild(
43
- el("span", "recommended-command-label", action.label ?? "—"),
44
- );
45
- block.appendChild(head);
46
- if (action.command) {
47
- const body = el("div", "recommended-command-body");
48
- const code = el("code", "recommended-command-text", action.command);
49
- body.appendChild(code);
50
- const btn = el("button", "copy-command", "复制");
51
- btn.type = "button";
52
- btn.addEventListener("click", (e) => {
53
- e.preventDefault();
54
- e.stopPropagation();
55
- void copyText(action.command).then((ok) => {
56
- btn.textContent = ok ? "已复制" : "复制失败";
57
- setTimeout(() => {
58
- btn.textContent = "复制";
59
- }, 1500);
60
- });
61
- });
62
- body.appendChild(btn);
63
- block.appendChild(body);
64
- }
65
- return block;
66
- }
67
-
1
+ /** Copy-only recommended commands (Observe UI R5). */
2
+ import { el } from "./dom.js";
3
+
4
+ export async function copyText(text) {
5
+ const value = String(text ?? "");
6
+ if (!value) return false;
7
+ try {
8
+ if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
9
+ await navigator.clipboard.writeText(value);
10
+ return true;
11
+ }
12
+ } catch {
13
+ // fall through
14
+ }
15
+ try {
16
+ const ta = document.createElement("textarea");
17
+ ta.value = value;
18
+ ta.setAttribute("readonly", "");
19
+ ta.style.position = "fixed";
20
+ ta.style.left = "-9999px";
21
+ document.body.appendChild(ta);
22
+ ta.select();
23
+ const ok = document.execCommand("copy");
24
+ document.body.removeChild(ta);
25
+ return ok;
26
+ } catch {
27
+ return false;
28
+ }
29
+ }
30
+
31
+ /** Advisory recommended command: copy-only, never executes. */
32
+ export function renderRecommendedCommand(action) {
33
+ const block = el("div", "recommended-command");
34
+ if (!action) {
35
+ block.appendChild(el("span", "muted", "缺失"));
36
+ return block;
37
+ }
38
+ const head = el("div", "recommended-command-head");
39
+ if (action.kind) {
40
+ head.appendChild(el("span", "recommended-command-kind", action.kind));
41
+ }
42
+ head.appendChild(
43
+ el("span", "recommended-command-label", action.label ?? "—"),
44
+ );
45
+ block.appendChild(head);
46
+ if (action.command) {
47
+ const body = el("div", "recommended-command-body");
48
+ const code = el("code", "recommended-command-text", action.command);
49
+ body.appendChild(code);
50
+ const btn = el("button", "copy-command", "复制");
51
+ btn.type = "button";
52
+ btn.addEventListener("click", (e) => {
53
+ e.preventDefault();
54
+ e.stopPropagation();
55
+ void copyText(action.command).then((ok) => {
56
+ btn.textContent = ok ? "已复制" : "复制失败";
57
+ setTimeout(() => {
58
+ btn.textContent = "复制";
59
+ }, 1500);
60
+ });
61
+ });
62
+ body.appendChild(btn);
63
+ block.appendChild(body);
64
+ }
65
+ return block;
66
+ }
67
+
@@ -1,36 +1,36 @@
1
- export type DagLayoutNodeInput = { nodeId: string };
2
- export type DagLayoutEdgeInput = { from: string; to: string };
3
- export type DagLayoutNode = {
4
- nodeId: string;
5
- rank: number;
6
- index: number;
7
- x: number;
8
- y: number;
9
- width: number;
10
- height: number;
11
- };
12
- export type DagLayoutEdge = DagLayoutEdgeInput & { path: string };
13
- export type DagLayout = {
14
- width: number;
15
- height: number;
16
- nodes: DagLayoutNode[];
17
- edges: DagLayoutEdge[];
18
- };
19
-
20
- export type DagLayoutOptions = Partial<{
21
- nodeWidth: number;
22
- nodeHeight: number;
23
- rankGap: number;
24
- nodeGap: number;
25
- padding: number;
26
- controlLaneCount: number;
27
- /** Per-node visual card height overrides; ordinary ports still use nodeHeight axis. */
28
- nodeHeights: Record<string, number>;
29
- }>;
30
-
31
- export function layoutDag(
32
- nodes?: DagLayoutNodeInput[],
33
- edges?: DagLayoutEdgeInput[],
34
- ranks?: string[][],
35
- options?: DagLayoutOptions,
36
- ): DagLayout;
1
+ export type DagLayoutNodeInput = { nodeId: string };
2
+ export type DagLayoutEdgeInput = { from: string; to: string };
3
+ export type DagLayoutNode = {
4
+ nodeId: string;
5
+ rank: number;
6
+ index: number;
7
+ x: number;
8
+ y: number;
9
+ width: number;
10
+ height: number;
11
+ };
12
+ export type DagLayoutEdge = DagLayoutEdgeInput & { path: string };
13
+ export type DagLayout = {
14
+ width: number;
15
+ height: number;
16
+ nodes: DagLayoutNode[];
17
+ edges: DagLayoutEdge[];
18
+ };
19
+
20
+ export type DagLayoutOptions = Partial<{
21
+ nodeWidth: number;
22
+ nodeHeight: number;
23
+ rankGap: number;
24
+ nodeGap: number;
25
+ padding: number;
26
+ controlLaneCount: number;
27
+ /** Per-node visual card height overrides; ordinary ports still use nodeHeight axis. */
28
+ nodeHeights: Record<string, number>;
29
+ }>;
30
+
31
+ export function layoutDag(
32
+ nodes?: DagLayoutNodeInput[],
33
+ edges?: DagLayoutEdgeInput[],
34
+ ranks?: string[][],
35
+ options?: DagLayoutOptions,
36
+ ): DagLayout;