@tea-agent/loop-agent 0.26.0 → 0.26.2

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 (197) hide show
  1. package/CHANGELOG.md +1056 -1020
  2. package/README.md +8 -3
  3. package/bin/loop-agent.js +21 -21
  4. package/dist/application/dag/generate-task-dag.js +33 -0
  5. package/dist/cli/command-definitions.js +25 -10
  6. package/dist/cli/help.js +4 -3
  7. package/dist/cli/program.js +43 -17
  8. package/dist/commands/cursor-prompt.js +6 -6
  9. package/dist/commands/import-prd.js +7 -2
  10. package/dist/commands/init.js +7 -5
  11. package/dist/commands/loop-benchmark.js +11 -11
  12. package/dist/commands/pi-reuse-benchmark.js +16 -16
  13. package/dist/commands/task-source-prepare.js +474 -0
  14. package/dist/executors/dag-pi-executor.js +40 -5
  15. package/dist/executors/shell-executor.js +111 -0
  16. package/dist/executors/shell-presets.js +12 -4
  17. package/dist/executors/shell-write-guard.js +161 -25
  18. package/dist/sidecars/cursor-prompt/executor.js +1 -1
  19. package/dist/task/config-types.js +6 -0
  20. package/dist/task/contract/constants.js +1 -0
  21. package/dist/task/contract/project.js +8 -0
  22. package/dist/task/contract/schema.js +1 -0
  23. package/dist/task/frontend-preflight.js +131 -0
  24. package/dist/task/runtime.js +2 -4
  25. package/dist/task/source-prepare/build-draft.js +224 -0
  26. package/dist/task/source-prepare/completeness.js +195 -0
  27. package/dist/task/source-prepare/index.js +7 -0
  28. package/dist/task/source-prepare/parse-intent.js +373 -0
  29. package/dist/task/source-prepare/path-policy.js +197 -0
  30. package/dist/task/source-prepare/prepare.js +506 -0
  31. package/dist/task/source-prepare/reference-integrity.js +274 -0
  32. package/dist/task/source-prepare/types.js +7 -0
  33. package/dist/worker/observability/read-model.js +134 -0
  34. package/dist/worker/observe/static/copy.js +67 -67
  35. package/dist/worker/observe/static/dag-layout.d.ts +31 -31
  36. package/dist/worker/observe/static/dag-layout.js +83 -83
  37. package/dist/worker/observe/static/dom.js +220 -220
  38. package/dist/worker/observe/static/relations.js +133 -133
  39. package/dist/worker/observe/static/router.js +93 -93
  40. package/dist/worker/observe/static/run-processing.js +148 -148
  41. package/dist/worker/observe/static/state.js +61 -0
  42. package/dist/worker/observe/static/styles.css +8 -0
  43. package/dist/worker/observe/static/views/batch.js +227 -227
  44. package/dist/worker/observe/static/views/dag-graph.js +248 -172
  45. package/dist/worker/observe/static/views/dag-inspector.js +374 -157
  46. package/dist/worker/observe/static/views/dag.js +4 -11
  47. package/dist/worker/observe/static/views/failures.js +143 -143
  48. package/dist/worker/observe/static/views/feature.js +492 -492
  49. package/dist/worker/observe/static/views/run.js +453 -453
  50. package/dist/worker/observe/static/views/shell.js +7 -7
  51. package/dist/worker/observe/static/views/timeline.js +163 -163
  52. package/dist/workflows/dag/backend-test-pytest-collection.js +277 -0
  53. package/dist/workflows/dag/canvas-observer.js +275 -275
  54. package/dist/workflows/dag/convergence/controller.js +110 -21
  55. package/dist/workflows/dag/frontend-implementation-contract.js +218 -17
  56. package/dist/workflows/dag/frontend-review-context.js +7 -1
  57. package/dist/workflows/dag/frontend-verification-trace.js +14 -3
  58. package/dist/workflows/dag/frontend-worktree-diff.js +14 -3
  59. package/dist/workflows/dag/init-hybrid.js +96 -34
  60. package/dist/workflows/dag/output-protocol.js +180 -7
  61. package/dist/workflows/dag/runner.js +141 -52
  62. package/dist/workflows/dag/types.js +4 -0
  63. package/dist/workflows/dag/validate.js +3 -2
  64. package/docs/skills/README.md +7 -7
  65. package/docs/templates/adr.md +60 -60
  66. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  67. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  68. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  69. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  70. package/docs/templates/agent-dag-report.schema.json +473 -473
  71. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  72. package/docs/templates/backend-test-dag.json +100 -8
  73. package/docs/templates/backend-test-result.schema.json +99 -99
  74. package/docs/templates/feature-spec.md +53 -53
  75. package/docs/templates/frontend-design-contract.md +42 -42
  76. package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md +17 -17
  77. package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md +16 -16
  78. package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md +16 -16
  79. package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md +16 -16
  80. package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md +16 -16
  81. package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md +16 -16
  82. package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md +21 -21
  83. package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md +29 -29
  84. package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md +28 -28
  85. package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md +28 -28
  86. package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md +29 -29
  87. package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md +27 -27
  88. package/docs/templates/frontend-eval/fixtures/functional/06-ssr-server-client-boundary.md +28 -28
  89. package/docs/templates/frontend-eval/fixtures/functional/07-shared-public-component-api.md +28 -28
  90. package/docs/templates/frontend-eval/fixtures/functional/08-pure-local-no-remote.md +27 -27
  91. package/docs/templates/frontend-eval/metrics.md +138 -138
  92. package/docs/templates/frontend-eval/smoke-targets.md +53 -53
  93. package/docs/templates/frontend-task-constraints.md +35 -35
  94. package/docs/templates/frontend-task-requirement.md +70 -70
  95. package/docs/templates/init-evolution-review.md +35 -35
  96. package/docs/templates/init-managed-agents.md +10 -5
  97. package/docs/templates/interactive-ui-round2-experiment.md +66 -66
  98. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -118
  99. package/docs/templates/knowledge-sync-dag.json +178 -178
  100. package/docs/templates/knowledge-sync-draft.schema.json +71 -71
  101. package/docs/templates/product-line/closeout.yaml +9 -9
  102. package/docs/templates/product-line/design.md +13 -13
  103. package/docs/templates/product-line/links.md +10 -10
  104. package/docs/templates/product-line/requirement.md +17 -17
  105. package/docs/templates/product-line/test-plan.md +7 -7
  106. package/docs/templates/production-readiness-checklist.md +57 -57
  107. package/docs/templates/project-start-checklist.md +9 -9
  108. package/docs/templates/qa-report.md +48 -48
  109. package/docs/templates/sprint-contract.md +29 -29
  110. package/docs/templates/worker-dogfood-evidence.md +80 -80
  111. package/docs/templates/worker-dogfood-setup.md +68 -68
  112. package/package.json +1 -1
  113. package/scripts/kb-bootstrap-init-skeleton.sh +0 -0
  114. package/scripts/kb-graph-incremental-prepare.mjs +386 -386
  115. package/scripts/kb-graph-materialize.mjs +105 -105
  116. package/scripts/kb-graph-promote.mjs +164 -164
  117. package/scripts/kb-query.mjs +554 -554
  118. package/skills/ai-engineering-context/SKILL.md +48 -48
  119. package/skills/analyze-product-dependencies/SKILL.md +67 -67
  120. package/skills/analyze-product-dependencies/agents/openai.yaml +4 -4
  121. package/skills/analyze-product-dependencies/references/api-documentation-schema.md +30 -30
  122. package/skills/analyze-product-dependencies/references/dependency-analysis-schema.md +28 -28
  123. package/skills/analyze-product-dependencies/references/example.md +76 -76
  124. package/skills/analyze-product-dependencies/references/forward-test-cases.md +35 -35
  125. package/skills/analyze-product-dependencies/references/input-contract.md +11 -11
  126. package/skills/analyze-product-dependencies/references/scouting-rules.md +61 -61
  127. package/skills/analyze-product-dependencies/scripts/test-validators.mjs +267 -267
  128. package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +101 -101
  129. package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +142 -142
  130. package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +76 -76
  131. package/skills/analyze-product-dependencies/scripts/validation-helpers.mjs +146 -146
  132. package/skills/analyze-product-requirements/SKILL.md +90 -90
  133. package/skills/analyze-product-requirements/agents/openai.yaml +4 -4
  134. package/skills/analyze-product-requirements/references/acceptance-criteria.md +91 -91
  135. package/skills/analyze-product-requirements/references/clarification-and-knowledge.md +56 -56
  136. package/skills/analyze-product-requirements/references/example.md +86 -86
  137. package/skills/analyze-product-requirements/references/forward-test-cases.md +66 -66
  138. package/skills/analyze-product-requirements/references/product-analysis-schema.md +32 -32
  139. package/skills/analyze-product-requirements/references/product-requirement-schema.md +33 -33
  140. package/skills/analyze-product-requirements/references/requirement-clarification-schema.md +35 -35
  141. package/skills/analyze-product-requirements/scripts/test-validators.mjs +193 -193
  142. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +69 -69
  143. package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +97 -97
  144. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +98 -98
  145. package/skills/analyze-product-requirements/scripts/validation-helpers.mjs +156 -156
  146. package/skills/browser-tools/browser-content.js +103 -103
  147. package/skills/browser-tools/browser-cookies.js +35 -35
  148. package/skills/browser-tools/browser-eval.js +53 -53
  149. package/skills/browser-tools/browser-hn-scraper.js +108 -108
  150. package/skills/browser-tools/browser-nav.js +44 -44
  151. package/skills/browser-tools/browser-pick.js +162 -162
  152. package/skills/browser-tools/browser-screenshot.js +34 -34
  153. package/skills/browser-tools/browser-start.js +86 -86
  154. package/skills/browser-tools/package-lock.json +2556 -2556
  155. package/skills/browser-tools/package.json +19 -19
  156. package/skills/code-review-core/SKILL.md +20 -20
  157. package/skills/codebase-scout/SKILL.md +19 -19
  158. package/skills/grill-me/SKILL.md +10 -10
  159. package/skills/loop-agent/SKILL.md +5 -2
  160. package/skills/loop-agent/references/README.md +67 -67
  161. package/skills/loop-agent/references/command-reference.md +17 -15
  162. package/skills/loop-agent/references/docs-converge.md +126 -126
  163. package/skills/loop-agent/references/harness-policy.md +3 -4
  164. package/skills/loop-agent/references/hybrid-dag.md +1 -1
  165. package/skills/loop-agent/references/learned/README.md +21 -21
  166. package/skills/loop-agent/references/long-running-loop.md +57 -57
  167. package/skills/loop-agent/references/one-shot-runs.md +85 -85
  168. package/skills/loop-agent/references/pi-prompt.md +23 -23
  169. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
  170. package/skills/loop-agent/references/post-implementation-and-patterns.md +1 -1
  171. package/skills/loop-agent/references/source-and-plan-practice.md +3 -2
  172. package/skills/loop-agent/references/task-workflow.md +7 -5
  173. package/skills/playwright-cli/SKILL.md +420 -420
  174. package/skills/playwright-cli/references/element-attributes.md +23 -23
  175. package/skills/playwright-cli/references/playwright-tests.md +39 -39
  176. package/skills/playwright-cli/references/request-mocking.md +87 -87
  177. package/skills/playwright-cli/references/running-code.md +241 -241
  178. package/skills/playwright-cli/references/session-management.md +225 -225
  179. package/skills/playwright-cli/references/storage-state.md +275 -275
  180. package/skills/playwright-cli/references/test-generation.md +433 -433
  181. package/skills/playwright-cli/references/tracing.md +139 -139
  182. package/skills/playwright-cli/references/video-recording.md +143 -143
  183. package/skills/requesting-code-review/SKILL.md +101 -101
  184. package/skills/requesting-code-review/code-reviewer.md +168 -168
  185. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  186. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  187. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  188. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  189. package/skills/systematic-debugging/find-polluter.sh +63 -63
  190. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  191. package/skills/systematic-debugging/test-academic.md +14 -14
  192. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  193. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  194. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  195. package/skills/using-git-worktrees/SKILL.md +215 -215
  196. package/skills/verification-before-completion/SKILL.md +154 -154
  197. package/skills/webapp-testing/SKILL.md +19 -19
@@ -1,148 +1,148 @@
1
- /** Run step/command/artifact processing and task history rows. */
2
- import {
3
- STEP_LABELS,
4
- ARTIFACT_LABELS,
5
- STEP_ORDER,
6
- ARTIFACT_KEYS,
7
- } from "./constants.js";
8
- import { badge } from "./format.js";
9
- import { navigate } from "./router.js";
10
-
11
- export function stepDisplayLabel(label) {
12
- return STEP_LABELS[label] ?? label;
13
- }
14
-
15
- export function buildStepStates(events) {
16
- const states = new Map();
17
- for (const ev of events) {
18
- if (ev.type === "step.started") {
19
- states.set(ev.label, { status: "running", startedAt: ev.at });
20
- } else if (ev.type === "step.finished") {
21
- states.set(ev.label, {
22
- status: ev.status === "failed" ? "failed" : "succeeded",
23
- durationMs: ev.durationMs,
24
- });
25
- }
26
- }
27
-
28
- const ordered = [...STEP_ORDER];
29
- for (const label of states.keys()) {
30
- if (!ordered.includes(label)) ordered.push(label);
31
- }
32
-
33
- return ordered.map((label) => {
34
- const state = states.get(label);
35
- return {
36
- label,
37
- display: stepDisplayLabel(label),
38
- status: state?.status ?? "pending",
39
- durationMs: state?.durationMs,
40
- };
41
- });
42
- }
43
-
44
- export function stepMarker(status) {
45
- switch (status) {
46
- case "succeeded":
47
- return "✓";
48
- case "running":
49
- return "●";
50
- case "failed":
51
- return "✗";
52
- default:
53
- return "○";
54
- }
55
- }
56
-
57
- export function getCurrentCommand(events) {
58
- const active = new Map();
59
- for (const ev of events) {
60
- if (ev.type === "command.started") {
61
- active.set(ev.label, ev);
62
- } else if (ev.type === "command.finished") {
63
- active.delete(ev.label);
64
- }
65
- }
66
- let latest = null;
67
- for (const cmd of active.values()) {
68
- if (!latest || cmd.at > latest.at) latest = cmd;
69
- }
70
- if (latest?.at) {
71
- const elapsed = Date.now() - Date.parse(latest.at);
72
- latest = { ...latest, elapsedMs: Number.isFinite(elapsed) ? elapsed : 0 };
73
- }
74
- return latest;
75
- }
76
-
77
- export function getOutputTail(events, commandLabel) {
78
- if (!commandLabel) return "";
79
- const chunks = [];
80
- for (const ev of events) {
81
- if (
82
- ev.type === "command.output" &&
83
- ev.label === commandLabel &&
84
- ev.outputPreview
85
- ) {
86
- chunks.push(ev.outputPreview);
87
- }
88
- }
89
- return chunks.join("");
90
- }
91
-
92
- export function collectArtifacts(task, events) {
93
- const arts = new Map();
94
- const add = (label, artifactPath) => {
95
- if (artifactPath && !arts.has(label)) arts.set(label, artifactPath);
96
- };
97
-
98
- if (task?.artifactRefs) {
99
- for (const key of ARTIFACT_KEYS) {
100
- add(ARTIFACT_LABELS[key] ?? key, task.artifactRefs[key]);
101
- }
102
- }
103
-
104
- for (const ev of events) {
105
- if (!ev.artifactRefs) continue;
106
- for (const [key, artifactPath] of Object.entries(ev.artifactRefs)) {
107
- add(ARTIFACT_LABELS[key] ?? key, artifactPath);
108
- }
109
- }
110
-
111
- return arts;
112
- }
113
-
114
- export function findBatchRunIdForTask(snapshot, task) {
115
- if (!snapshot || !task) return null;
116
- const workerRunId = task.workerRunId;
117
- if (!workerRunId) return null;
118
- for (const batch of snapshot.batches ?? []) {
119
- for (const t of batch.tasks ?? []) {
120
- if (t.workerRunId === workerRunId) return batch.batchRunId;
121
- }
122
- }
123
- return null;
124
- }
125
-
126
- export function taskRunHistoryRow(run) {
127
- let runLink = run.workerRunId;
128
- if (run.workerRunId) {
129
- const a = document.createElement("a");
130
- a.href = `#/run/${encodeURIComponent(run.workerRunId)}`;
131
- a.textContent = run.workerRunId;
132
- a.addEventListener("click", (e) => {
133
- e.preventDefault();
134
- navigate(`#/run/${encodeURIComponent(run.workerRunId)}`);
135
- });
136
- runLink = a;
137
- }
138
- return {
139
- cells: [
140
- runLink,
141
- badge(run.status),
142
- run.recordedAt ?? run.finishedAt ?? "—",
143
- run.batchRunId ?? "—",
144
- run.retryOfWorkerRunId ?? "—",
145
- run.failureCategory ?? "—",
146
- ],
147
- };
148
- }
1
+ /** Run step/command/artifact processing and task history rows. */
2
+ import {
3
+ STEP_LABELS,
4
+ ARTIFACT_LABELS,
5
+ STEP_ORDER,
6
+ ARTIFACT_KEYS,
7
+ } from "./constants.js";
8
+ import { badge } from "./format.js";
9
+ import { navigate } from "./router.js";
10
+
11
+ export function stepDisplayLabel(label) {
12
+ return STEP_LABELS[label] ?? label;
13
+ }
14
+
15
+ export function buildStepStates(events) {
16
+ const states = new Map();
17
+ for (const ev of events) {
18
+ if (ev.type === "step.started") {
19
+ states.set(ev.label, { status: "running", startedAt: ev.at });
20
+ } else if (ev.type === "step.finished") {
21
+ states.set(ev.label, {
22
+ status: ev.status === "failed" ? "failed" : "succeeded",
23
+ durationMs: ev.durationMs,
24
+ });
25
+ }
26
+ }
27
+
28
+ const ordered = [...STEP_ORDER];
29
+ for (const label of states.keys()) {
30
+ if (!ordered.includes(label)) ordered.push(label);
31
+ }
32
+
33
+ return ordered.map((label) => {
34
+ const state = states.get(label);
35
+ return {
36
+ label,
37
+ display: stepDisplayLabel(label),
38
+ status: state?.status ?? "pending",
39
+ durationMs: state?.durationMs,
40
+ };
41
+ });
42
+ }
43
+
44
+ export function stepMarker(status) {
45
+ switch (status) {
46
+ case "succeeded":
47
+ return "✓";
48
+ case "running":
49
+ return "●";
50
+ case "failed":
51
+ return "✗";
52
+ default:
53
+ return "○";
54
+ }
55
+ }
56
+
57
+ export function getCurrentCommand(events) {
58
+ const active = new Map();
59
+ for (const ev of events) {
60
+ if (ev.type === "command.started") {
61
+ active.set(ev.label, ev);
62
+ } else if (ev.type === "command.finished") {
63
+ active.delete(ev.label);
64
+ }
65
+ }
66
+ let latest = null;
67
+ for (const cmd of active.values()) {
68
+ if (!latest || cmd.at > latest.at) latest = cmd;
69
+ }
70
+ if (latest?.at) {
71
+ const elapsed = Date.now() - Date.parse(latest.at);
72
+ latest = { ...latest, elapsedMs: Number.isFinite(elapsed) ? elapsed : 0 };
73
+ }
74
+ return latest;
75
+ }
76
+
77
+ export function getOutputTail(events, commandLabel) {
78
+ if (!commandLabel) return "";
79
+ const chunks = [];
80
+ for (const ev of events) {
81
+ if (
82
+ ev.type === "command.output" &&
83
+ ev.label === commandLabel &&
84
+ ev.outputPreview
85
+ ) {
86
+ chunks.push(ev.outputPreview);
87
+ }
88
+ }
89
+ return chunks.join("");
90
+ }
91
+
92
+ export function collectArtifacts(task, events) {
93
+ const arts = new Map();
94
+ const add = (label, artifactPath) => {
95
+ if (artifactPath && !arts.has(label)) arts.set(label, artifactPath);
96
+ };
97
+
98
+ if (task?.artifactRefs) {
99
+ for (const key of ARTIFACT_KEYS) {
100
+ add(ARTIFACT_LABELS[key] ?? key, task.artifactRefs[key]);
101
+ }
102
+ }
103
+
104
+ for (const ev of events) {
105
+ if (!ev.artifactRefs) continue;
106
+ for (const [key, artifactPath] of Object.entries(ev.artifactRefs)) {
107
+ add(ARTIFACT_LABELS[key] ?? key, artifactPath);
108
+ }
109
+ }
110
+
111
+ return arts;
112
+ }
113
+
114
+ export function findBatchRunIdForTask(snapshot, task) {
115
+ if (!snapshot || !task) return null;
116
+ const workerRunId = task.workerRunId;
117
+ if (!workerRunId) return null;
118
+ for (const batch of snapshot.batches ?? []) {
119
+ for (const t of batch.tasks ?? []) {
120
+ if (t.workerRunId === workerRunId) return batch.batchRunId;
121
+ }
122
+ }
123
+ return null;
124
+ }
125
+
126
+ export function taskRunHistoryRow(run) {
127
+ let runLink = run.workerRunId;
128
+ if (run.workerRunId) {
129
+ const a = document.createElement("a");
130
+ a.href = `#/run/${encodeURIComponent(run.workerRunId)}`;
131
+ a.textContent = run.workerRunId;
132
+ a.addEventListener("click", (e) => {
133
+ e.preventDefault();
134
+ navigate(`#/run/${encodeURIComponent(run.workerRunId)}`);
135
+ });
136
+ runLink = a;
137
+ }
138
+ return {
139
+ cells: [
140
+ runLink,
141
+ badge(run.status),
142
+ run.recordedAt ?? run.finishedAt ?? "—",
143
+ run.batchRunId ?? "—",
144
+ run.retryOfWorkerRunId ?? "—",
145
+ run.failureCategory ?? "—",
146
+ ],
147
+ };
148
+ }
@@ -53,6 +53,8 @@ export const uiState = {
53
53
  dagTimelineViewportState: null,
54
54
  dagNodeOutputViewportState: null,
55
55
  dagNodeInputViewportState: null,
56
+ /** Spec-evidence inspector content scroll (single active region snapshot). */
57
+ dagNodeSpecEvidenceViewportState: null,
56
58
  runOutputViewportState: null,
57
59
  /**
58
60
  * Spec-evidence file preview drill-down. null = list view; otherwise
@@ -67,6 +69,65 @@ export const uiState = {
67
69
  /** Per-dagRunId graph viewport restore map (stable Map instance). */
68
70
  export const dagGraphViewportStates = new Map();
69
71
 
72
+ /**
73
+ * Per-context inspector content scroll map.
74
+ * Key format: dag:<dagRunId>:<nodeId>:<tab>
75
+ */
76
+ export const dagInspectorViewportStates = new Map();
77
+
78
+ /** Build a stable inspector scroll region key (AC-005 context isolation). */
79
+ export function inspectorViewportRegionKey(dagRunId, nodeId, tab) {
80
+ return `dag:${dagRunId ?? ""}:${nodeId ?? ""}:${tab ?? "output"}`;
81
+ }
82
+
83
+ export function updateDagInspectorViewportState(
84
+ _previous,
85
+ regionKey,
86
+ scrollLeft,
87
+ scrollTop,
88
+ ) {
89
+ return {
90
+ regionKey,
91
+ scrollLeft: Math.max(0, Number(scrollLeft) || 0),
92
+ scrollTop: Math.max(0, Number(scrollTop) || 0),
93
+ };
94
+ }
95
+
96
+ /**
97
+ * Persist inspector scroll for a context. When `preserveIntent` is true and the
98
+ * incoming position is a zero clamp on short (loading) content while a non-zero
99
+ * intent already exists, keep the previous intent instead of overwriting to 0.
100
+ */
101
+ export function saveDagInspectorViewportState(
102
+ regionKey,
103
+ scrollLeft,
104
+ scrollTop,
105
+ options = {},
106
+ ) {
107
+ if (!regionKey) return null;
108
+ const left = Math.max(0, Number(scrollLeft) || 0);
109
+ const top = Math.max(0, Number(scrollTop) || 0);
110
+ if (options.preserveIntent) {
111
+ const existing = dagInspectorViewportStates.get(regionKey);
112
+ if (
113
+ existing &&
114
+ left === 0 &&
115
+ top === 0 &&
116
+ (existing.scrollLeft > 0 || existing.scrollTop > 0)
117
+ ) {
118
+ return existing;
119
+ }
120
+ }
121
+ const next = updateDagInspectorViewportState(null, regionKey, left, top);
122
+ dagInspectorViewportStates.set(regionKey, next);
123
+ return next;
124
+ }
125
+
126
+ export function getDagInspectorViewportState(regionKey) {
127
+ if (!regionKey) return null;
128
+ return dagInspectorViewportStates.get(regionKey) ?? null;
129
+ }
130
+
70
131
  /** Build a fresh session-event identity token and bump the global sequence. */
71
132
  export function makeSessionEventIdentity(dagRunId, nodeId) {
72
133
  uiState.sessionEventIdentitySeq += 1;
@@ -1522,6 +1522,14 @@ body.is-resizing-dag-graph {
1522
1522
  #dag-arrow path {
1523
1523
  fill: color-mix(in srgb, var(--hairline-strong) 80%, var(--muted));
1524
1524
  }
1525
+ .dag-edge-control {
1526
+ stroke: var(--orange);
1527
+ stroke-width: 2;
1528
+ stroke-dasharray: 6 4;
1529
+ }
1530
+ #dag-arrow-control path {
1531
+ fill: var(--orange);
1532
+ }
1525
1533
  .dag-graph-node {
1526
1534
  cursor: pointer;
1527
1535
  transition: opacity var(--transition-fast);