@tea-agent/loop-agent 0.12.0 → 0.13.0-beta.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 (284) hide show
  1. package/AGENTS.md +155 -153
  2. package/CHANGELOG.md +338 -265
  3. package/README.md +345 -298
  4. package/bin/agent-worker.js +22 -22
  5. package/bin/loop-agent.js +21 -21
  6. package/dist/application/dag/generate-task-dag.js +28 -28
  7. package/dist/application/evaluation/candidate-hash.js +75 -0
  8. package/dist/application/evaluation/candidate.js +52 -0
  9. package/dist/application/evaluation/replay.js +289 -0
  10. package/dist/application/evaluation/types.js +130 -0
  11. package/dist/cli/command-definitions.js +27 -7
  12. package/dist/cli/program.js +8 -4
  13. package/dist/commands/cursor-prompt.js +6 -6
  14. package/dist/commands/eval.js +235 -0
  15. package/dist/commands/init.js +544 -506
  16. package/dist/commands/knowledge.js +129 -31
  17. package/dist/commands/loop-benchmark.js +11 -11
  18. package/dist/commands/pi-reuse-benchmark.js +16 -16
  19. package/dist/executors/pi-sdk-executor.js +38 -24
  20. package/dist/executors/shell-executor.js +34 -2
  21. package/dist/executors/shell-presets.js +20 -0
  22. package/dist/executors/shell-verification.js +7 -0
  23. package/dist/governance/manifest-types.js +4 -0
  24. package/dist/infrastructure/evaluation/candidate-store.js +435 -0
  25. package/dist/infrastructure/evaluation/store.js +40 -0
  26. package/dist/sidecars/cursor-prompt/executor.js +1 -1
  27. package/dist/task/config-types.js +28 -1
  28. package/dist/task/runtime.js +27 -27
  29. package/dist/worker/cli.js +96 -1
  30. package/dist/worker/delivery/package.js +3 -3
  31. package/dist/worker/feature/decision-loader.js +37 -6
  32. package/dist/worker/feature/next-action.js +10 -2
  33. package/dist/worker/feature/ready-plan-projection.js +81 -0
  34. package/dist/worker/feature/reducer.js +2 -1
  35. package/dist/worker/feature/review.js +19 -2
  36. package/dist/worker/feature/run.js +27 -2
  37. package/dist/worker/follow-up/approve.js +5 -2
  38. package/dist/worker/follow-up/factory.js +1 -1
  39. package/dist/worker/observability/read-model.js +246 -41
  40. package/dist/worker/observe/routes.js +173 -15
  41. package/dist/worker/observe/spec-evidence.js +281 -0
  42. package/dist/worker/observe/static/api.js +46 -27
  43. package/dist/worker/observe/static/app.js +150 -150
  44. package/dist/worker/observe/static/constants.js +148 -148
  45. package/dist/worker/observe/static/copy.js +67 -67
  46. package/dist/worker/observe/static/dag-helpers.js +172 -172
  47. package/dist/worker/observe/static/dag-layout.d.ts +31 -31
  48. package/dist/worker/observe/static/dag-layout.js +83 -83
  49. package/dist/worker/observe/static/dag-model.js +72 -72
  50. package/dist/worker/observe/static/dom.js +61 -61
  51. package/dist/worker/observe/static/format-pool.js +67 -67
  52. package/dist/worker/observe/static/format.js +292 -292
  53. package/dist/worker/observe/static/index.html +308 -308
  54. package/dist/worker/observe/static/kpi.js +94 -94
  55. package/dist/worker/observe/static/relations.js +133 -128
  56. package/dist/worker/observe/static/router.js +93 -85
  57. package/dist/worker/observe/static/run-processing.js +148 -148
  58. package/dist/worker/observe/static/shell-chrome.js +68 -68
  59. package/dist/worker/observe/static/state.js +253 -253
  60. package/dist/worker/observe/static/styles.css +1902 -1890
  61. package/dist/worker/observe/static/views/batch.js +227 -226
  62. package/dist/worker/observe/static/views/dag-graph.js +172 -172
  63. package/dist/worker/observe/static/views/dag-inspector.js +607 -477
  64. package/dist/worker/observe/static/views/dag.js +362 -362
  65. package/dist/worker/observe/static/views/dashboard.js +445 -442
  66. package/dist/worker/observe/static/views/failures.js +143 -143
  67. package/dist/worker/observe/static/views/feature.js +492 -453
  68. package/dist/worker/observe/static/views/pool.js +350 -347
  69. package/dist/worker/observe/static/views/run.js +453 -453
  70. package/dist/worker/observe/static/views/session-timeline.js +205 -205
  71. package/dist/worker/observe/static/views/shell.js +7 -7
  72. package/dist/worker/observe/static/views/task.js +314 -260
  73. package/dist/worker/observe/static/views/timeline.js +163 -163
  74. package/dist/worker/pool/doctor.js +165 -0
  75. package/dist/worker/pool/migrate-state.js +303 -0
  76. package/dist/worker/pool/run-store.js +205 -17
  77. package/dist/worker/pool/types.js +17 -1
  78. package/dist/worker/pool/validation.js +100 -15
  79. package/dist/worker/report/morning-report.js +12 -2
  80. package/dist/worker/runner/run-ready.js +41 -26
  81. package/dist/worker/task-graph/ready-planner.js +136 -0
  82. package/dist/workflows/dag/backend-test-analysis-contract.js +120 -0
  83. package/dist/workflows/dag/canvas-observer.js +275 -275
  84. package/dist/workflows/dag/convergence/controller.js +16 -8
  85. package/dist/workflows/dag/dynamic-runtime/map.js +90 -2
  86. package/dist/workflows/dag/failure-routing.js +12 -1
  87. package/dist/workflows/dag/init-hybrid.js +2404 -360
  88. package/dist/workflows/dag/node-execution.js +9 -0
  89. package/dist/workflows/dag/prompt.js +9 -0
  90. package/dist/workflows/dag/report.js +35 -1
  91. package/dist/workflows/dag/runner.js +28 -2
  92. package/dist/workflows/dag/task-demand-routing.js +383 -0
  93. package/dist/workflows/dag/types.js +51 -13
  94. package/dist/workflows/dag/upstream-artifacts.js +1 -0
  95. package/dist/workflows/dag/validate.js +59 -1
  96. package/docs/README.md +106 -104
  97. package/docs/agent-dag-recovery-playbook.md +195 -184
  98. package/docs/agent-dag-runner.md +67 -67
  99. package/docs/architecture/README.md +26 -26
  100. package/docs/architecture/dag-execution.md +140 -140
  101. package/docs/architecture/evolution.md +54 -53
  102. package/docs/architecture/facts-and-state.md +71 -58
  103. package/docs/architecture/runtime-boundaries.md +191 -191
  104. package/docs/architecture/system-overview.md +93 -93
  105. package/docs/architecture/worker-and-feature.md +85 -81
  106. package/docs/cursor-prompt-sidecar.md +36 -36
  107. package/docs/decisions/README.md +18 -15
  108. package/docs/design/README.md +167 -77
  109. package/docs/development-principles.md +73 -73
  110. package/docs/exec-plans/README.md +6 -6
  111. package/docs/exec-plans/active/README.md +15 -9
  112. package/docs/exec-plans/completed/README.md +85 -73
  113. package/docs/feature-workflow.md +389 -261
  114. package/docs/harness-methodology-debugging.md +153 -153
  115. package/docs/harness-methodology-tdd.md +130 -130
  116. package/docs/harness-methodology-verification.md +27 -27
  117. package/docs/init-surface.manifest.json +289 -280
  118. package/docs/loop-agent-harness.md +142 -130
  119. package/docs/production-readiness.md +96 -96
  120. package/docs/progress/README.md +64 -54
  121. package/docs/reports/README.md +117 -94
  122. package/docs/skills/README.md +7 -7
  123. package/docs/skills/vetted-skill-registry.md +29 -27
  124. package/docs/templates/adr.md +60 -60
  125. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  126. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  127. package/docs/templates/agent-dag-decision-gate-dogfood-report.md +117 -117
  128. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  129. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  130. package/docs/templates/agent-dag-report.schema.json +473 -473
  131. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  132. package/docs/templates/agent-dag.base.json +190 -190
  133. package/docs/templates/agent-dag.final-verification.json +185 -185
  134. package/docs/templates/agent-dag.schema.json +411 -383
  135. package/docs/templates/agent-dag.supervised-implementation.json +501 -501
  136. package/docs/templates/backend-test-analysis.schema.json +44 -0
  137. package/docs/templates/backend-test-dag.generate-pytest.prompt.md +202 -139
  138. package/docs/templates/backend-test-dag.json +311 -276
  139. package/docs/templates/backend-test-dag.retrospect.prompt.md +125 -125
  140. package/docs/templates/backend-test-dag.review-cases.prompt.md +81 -81
  141. package/docs/templates/exec-plan.md +64 -64
  142. package/docs/templates/feature-spec.md +53 -53
  143. package/docs/templates/frontend-design-contract.md +42 -33
  144. package/docs/templates/frontend-task-constraints.md +35 -25
  145. package/docs/templates/frontend-task-requirement.md +70 -61
  146. package/docs/templates/frontend-test-dag.generate-cases.prompt.md +5 -0
  147. package/docs/templates/frontend-test-dag.json +23 -0
  148. package/docs/templates/frontend-test-dag.retrieve-context.prompt.md +3 -0
  149. package/docs/templates/frontend-test-dag.retrospect.prompt.md +3 -0
  150. package/docs/templates/frontend-test-dag.review-cases.prompt.md +3 -0
  151. package/docs/templates/frontend-test-dag.review-execution.prompt.md +3 -0
  152. package/docs/templates/harness.schema.json +221 -221
  153. package/docs/templates/hybrid-dag.json +188 -188
  154. package/docs/templates/init-evolution-review.md +35 -35
  155. package/docs/templates/interactive-ui-round2-experiment.md +66 -66
  156. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -0
  157. package/docs/templates/knowledge-sync-dag.json +178 -0
  158. package/docs/templates/knowledge-sync-draft.schema.json +71 -0
  159. package/docs/templates/product-line/AGENTS.md +8 -8
  160. package/docs/templates/product-line/README.md +9 -9
  161. package/docs/templates/product-line/acceptance.yaml +14 -14
  162. package/docs/templates/product-line/closeout.yaml +9 -9
  163. package/docs/templates/product-line/design.md +13 -13
  164. package/docs/templates/product-line/links.md +10 -10
  165. package/docs/templates/product-line/requirement.md +17 -17
  166. package/docs/templates/product-line/task-graph.yaml +15 -15
  167. package/docs/templates/product-line/task.yaml +64 -64
  168. package/docs/templates/product-line/test-plan.md +7 -7
  169. package/docs/templates/production-readiness-checklist.md +57 -57
  170. package/docs/templates/progress-log.md +17 -17
  171. package/docs/templates/project-start-checklist.md +9 -9
  172. package/docs/templates/qa-report.md +48 -48
  173. package/docs/templates/sprint-contract.md +29 -29
  174. package/docs/templates/worker-dogfood-evidence.md +80 -80
  175. package/docs/templates/worker-dogfood-setup.md +68 -68
  176. package/docs/verification-matrix.md +70 -66
  177. package/examples/decision-gate-agent-dag.json +177 -177
  178. package/examples/example-dag.json +46 -46
  179. package/examples/hybrid-loop-agent-dag.json +189 -189
  180. package/harness.json +66 -66
  181. package/package.json +88 -46
  182. package/scripts/check-product-line-docs.sh +29 -29
  183. package/scripts/check-task-pool-root.sh +32 -32
  184. package/scripts/kb-bootstrap-init-skeleton.sh +240 -0
  185. package/scripts/kb-graph-incremental-prepare.mjs +386 -0
  186. package/scripts/kb-graph-incremental-prepare.sh +5 -0
  187. package/scripts/kb-graph-materialize.mjs +105 -0
  188. package/scripts/kb-graph-materialize.sh +4 -0
  189. package/scripts/kb-graph-promote.mjs +164 -0
  190. package/scripts/kb-graph-promote.sh +4 -0
  191. package/scripts/kb-query.mjs +554 -0
  192. package/scripts/kb-query.sh +5 -0
  193. package/skills/agent-worker/SKILL.md +39 -37
  194. package/skills/agent-worker/references/agent-worker-operator.md +60 -43
  195. package/skills/ai-engineering-context/SKILL.md +48 -48
  196. package/skills/analyze-product-dependencies/SKILL.md +67 -0
  197. package/skills/analyze-product-dependencies/agents/openai.yaml +4 -0
  198. package/skills/analyze-product-dependencies/references/api-documentation-schema.md +30 -0
  199. package/skills/analyze-product-dependencies/references/dependency-analysis-schema.md +28 -0
  200. package/skills/analyze-product-dependencies/references/example.md +76 -0
  201. package/skills/analyze-product-dependencies/references/forward-test-cases.md +35 -0
  202. package/skills/analyze-product-dependencies/references/input-contract.md +11 -0
  203. package/skills/analyze-product-dependencies/references/scouting-rules.md +61 -0
  204. package/skills/analyze-product-dependencies/scripts/test-validators.mjs +267 -0
  205. package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +101 -0
  206. package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +142 -0
  207. package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +76 -0
  208. package/skills/analyze-product-dependencies/scripts/validation-helpers.mjs +146 -0
  209. package/skills/analyze-product-requirements/SKILL.md +90 -0
  210. package/skills/analyze-product-requirements/agents/openai.yaml +4 -0
  211. package/skills/analyze-product-requirements/references/acceptance-criteria.md +91 -0
  212. package/skills/analyze-product-requirements/references/clarification-and-knowledge.md +56 -0
  213. package/skills/analyze-product-requirements/references/example.md +86 -0
  214. package/skills/analyze-product-requirements/references/forward-test-cases.md +66 -0
  215. package/skills/analyze-product-requirements/references/product-analysis-schema.md +32 -0
  216. package/skills/analyze-product-requirements/references/product-requirement-schema.md +33 -0
  217. package/skills/analyze-product-requirements/references/requirement-clarification-schema.md +35 -0
  218. package/skills/analyze-product-requirements/scripts/test-validators.mjs +193 -0
  219. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +69 -0
  220. package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +97 -0
  221. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +98 -0
  222. package/skills/analyze-product-requirements/scripts/validation-helpers.mjs +156 -0
  223. package/skills/code-review-core/SKILL.md +20 -20
  224. package/skills/codebase-scout/SKILL.md +19 -19
  225. package/skills/frontend-design-review/SKILL.md +66 -59
  226. package/skills/frontend-design-review/references/review-checklist.md +58 -37
  227. package/skills/frontend-implementation/SKILL.md +47 -51
  228. package/skills/frontend-implementation/references/code-standards.md +32 -34
  229. package/skills/frontend-implementation/references/design-spec.md +46 -46
  230. package/skills/frontend-implementation/references/node-contracts.md +76 -32
  231. package/skills/frontend-review/SKILL.md +59 -53
  232. package/skills/frontend-review/references/review-findings.md +47 -42
  233. package/skills/frontend-verification/SKILL.md +53 -40
  234. package/skills/frontend-verification/references/verification-checklist.md +68 -56
  235. package/skills/grill-me/SKILL.md +10 -10
  236. package/skills/grill-with-docs/SKILL.md +88 -88
  237. package/skills/grill-with-docs/adr-format.md +47 -47
  238. package/skills/grill-with-docs/context-format.md +60 -60
  239. package/skills/init-capability-evolution/SKILL.md +70 -70
  240. package/skills/loop-agent/SKILL.md +151 -151
  241. package/skills/loop-agent/references/README.md +67 -67
  242. package/skills/loop-agent/references/command-reference.md +505 -452
  243. package/skills/loop-agent/references/docs-converge.md +126 -126
  244. package/skills/loop-agent/references/harness-policy.md +263 -263
  245. package/skills/loop-agent/references/hybrid-dag.md +238 -233
  246. package/skills/loop-agent/references/learned/README.md +21 -21
  247. package/skills/loop-agent/references/long-running-loop.md +57 -57
  248. package/skills/loop-agent/references/model-routing.md +36 -36
  249. package/skills/loop-agent/references/multi-worktree.md +54 -54
  250. package/skills/loop-agent/references/one-shot-runs.md +85 -85
  251. package/skills/loop-agent/references/orchestrator-and-interventions.md +169 -169
  252. package/skills/loop-agent/references/pi-prompt.md +23 -23
  253. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
  254. package/skills/loop-agent/references/post-implementation-and-patterns.md +44 -44
  255. package/skills/loop-agent/references/task-workflow.md +89 -89
  256. package/skills/loop-agent/references/verification-and-failure-handling.md +139 -139
  257. package/skills/playwright-cli/SKILL.md +420 -0
  258. package/skills/playwright-cli/references/element-attributes.md +23 -0
  259. package/skills/playwright-cli/references/playwright-tests.md +39 -0
  260. package/skills/playwright-cli/references/request-mocking.md +87 -0
  261. package/skills/playwright-cli/references/running-code.md +241 -0
  262. package/skills/playwright-cli/references/session-management.md +225 -0
  263. package/skills/playwright-cli/references/storage-state.md +275 -0
  264. package/skills/playwright-cli/references/test-generation.md +433 -0
  265. package/skills/playwright-cli/references/tracing.md +139 -0
  266. package/skills/playwright-cli/references/video-recording.md +143 -0
  267. package/skills/playwright-cli-case-generator/SKILL.md +74 -0
  268. package/skills/requesting-code-review/SKILL.md +101 -101
  269. package/skills/requesting-code-review/code-reviewer.md +168 -168
  270. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  271. package/skills/systematic-debugging/SKILL.md +296 -296
  272. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  273. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  274. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  275. package/skills/systematic-debugging/find-polluter.sh +63 -63
  276. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  277. package/skills/systematic-debugging/test-academic.md +14 -14
  278. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  279. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  280. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  281. package/skills/test-driven-development/SKILL.md +20 -20
  282. package/skills/using-git-worktrees/SKILL.md +215 -215
  283. package/skills/verification-before-completion/SKILL.md +154 -154
  284. package/skills/webapp-testing/SKILL.md +19 -19
@@ -1,83 +1,83 @@
1
- const DEFAULTS = {
2
- nodeWidth: 216,
3
- nodeHeight: 92,
4
- rankGap: 104,
5
- nodeGap: 28,
6
- padding: 32,
7
- };
8
-
9
- export function layoutDag(nodes = [], edges = [], ranks = [], options = {}) {
10
- const config = { ...DEFAULTS, ...options };
11
- const nodeIds = [...new Set(nodes.map((node) => node.nodeId).filter(Boolean))].sort();
12
- if (nodeIds.length === 0) return { width: 320, height: 160, nodes: [], edges: [] };
13
- const known = new Set(nodeIds);
14
- const validEdges = edges
15
- .filter((edge) => known.has(edge.from) && known.has(edge.to) && edge.from !== edge.to)
16
- .sort((a, b) => a.from.localeCompare(b.from) || a.to.localeCompare(b.to));
17
- const layers = normalizeLayers(nodeIds, validEdges, ranks);
18
- const positioned = [];
19
- for (let rank = 0; rank < layers.length; rank++) {
20
- const ids = layers[rank];
21
- for (let index = 0; index < ids.length; index++) {
22
- positioned.push({
23
- nodeId: ids[index], rank, index,
24
- x: config.padding + rank * (config.nodeWidth + config.rankGap),
25
- y: config.padding + index * (config.nodeHeight + config.nodeGap),
26
- width: config.nodeWidth, height: config.nodeHeight,
27
- });
28
- }
29
- }
30
- const byId = new Map(positioned.map((node) => [node.nodeId, node]));
31
- const routed = validEdges.map((edge) => {
32
- const from = byId.get(edge.from);
33
- const to = byId.get(edge.to);
34
- const x1 = from.x + from.width;
35
- const y1 = from.y + from.height / 2;
36
- const x2 = to.x;
37
- const y2 = to.y + to.height / 2;
38
- const bend = Math.max(36, (x2 - x1) / 2);
39
- return { ...edge, path: `M ${x1} ${y1} C ${x1 + bend} ${y1}, ${x2 - bend} ${y2}, ${x2} ${y2}` };
40
- });
41
- const maxRows = Math.max(...layers.map((layer) => layer.length), 1);
42
- return {
43
- width: config.padding * 2 + layers.length * config.nodeWidth + (layers.length - 1) * config.rankGap,
44
- height: config.padding * 2 + maxRows * config.nodeHeight + (maxRows - 1) * config.nodeGap,
45
- nodes: positioned,
46
- edges: routed,
47
- };
48
- }
49
-
50
- function normalizeLayers(nodeIds, edges, ranks) {
51
- const known = new Set(nodeIds);
52
- const seen = new Set();
53
- const layers = [];
54
- if (Array.isArray(ranks)) {
55
- for (const rank of ranks) {
56
- if (!Array.isArray(rank)) continue;
57
- const ids = [...new Set(rank.filter((id) => known.has(id) && !seen.has(id)))].sort();
58
- ids.forEach((id) => seen.add(id));
59
- if (ids.length > 0) layers.push(ids);
60
- }
61
- }
62
- if (layers.length === 0 && edges.length > 0) {
63
- const level = new Map(nodeIds.map((id) => [id, 0]));
64
- for (let pass = 0; pass < nodeIds.length; pass++) {
65
- let changed = false;
66
- for (const edge of edges) {
67
- const next = Math.min(nodeIds.length - 1, level.get(edge.from) + 1);
68
- if (next > level.get(edge.to)) { level.set(edge.to, next); changed = true; }
69
- }
70
- if (!changed) break;
71
- }
72
- for (const id of nodeIds) {
73
- const rank = level.get(id);
74
- (layers[rank] ??= []).push(id);
75
- seen.add(id);
76
- }
77
- for (const layer of layers) layer?.sort();
78
- }
79
- for (const id of nodeIds) {
80
- if (!seen.has(id)) (layers[0] ??= []).push(id);
81
- }
82
- return layers.filter(Boolean);
83
- }
1
+ const DEFAULTS = {
2
+ nodeWidth: 216,
3
+ nodeHeight: 92,
4
+ rankGap: 104,
5
+ nodeGap: 28,
6
+ padding: 32,
7
+ };
8
+
9
+ export function layoutDag(nodes = [], edges = [], ranks = [], options = {}) {
10
+ const config = { ...DEFAULTS, ...options };
11
+ const nodeIds = [...new Set(nodes.map((node) => node.nodeId).filter(Boolean))].sort();
12
+ if (nodeIds.length === 0) return { width: 320, height: 160, nodes: [], edges: [] };
13
+ const known = new Set(nodeIds);
14
+ const validEdges = edges
15
+ .filter((edge) => known.has(edge.from) && known.has(edge.to) && edge.from !== edge.to)
16
+ .sort((a, b) => a.from.localeCompare(b.from) || a.to.localeCompare(b.to));
17
+ const layers = normalizeLayers(nodeIds, validEdges, ranks);
18
+ const positioned = [];
19
+ for (let rank = 0; rank < layers.length; rank++) {
20
+ const ids = layers[rank];
21
+ for (let index = 0; index < ids.length; index++) {
22
+ positioned.push({
23
+ nodeId: ids[index], rank, index,
24
+ x: config.padding + rank * (config.nodeWidth + config.rankGap),
25
+ y: config.padding + index * (config.nodeHeight + config.nodeGap),
26
+ width: config.nodeWidth, height: config.nodeHeight,
27
+ });
28
+ }
29
+ }
30
+ const byId = new Map(positioned.map((node) => [node.nodeId, node]));
31
+ const routed = validEdges.map((edge) => {
32
+ const from = byId.get(edge.from);
33
+ const to = byId.get(edge.to);
34
+ const x1 = from.x + from.width;
35
+ const y1 = from.y + from.height / 2;
36
+ const x2 = to.x;
37
+ const y2 = to.y + to.height / 2;
38
+ const bend = Math.max(36, (x2 - x1) / 2);
39
+ return { ...edge, path: `M ${x1} ${y1} C ${x1 + bend} ${y1}, ${x2 - bend} ${y2}, ${x2} ${y2}` };
40
+ });
41
+ const maxRows = Math.max(...layers.map((layer) => layer.length), 1);
42
+ return {
43
+ width: config.padding * 2 + layers.length * config.nodeWidth + (layers.length - 1) * config.rankGap,
44
+ height: config.padding * 2 + maxRows * config.nodeHeight + (maxRows - 1) * config.nodeGap,
45
+ nodes: positioned,
46
+ edges: routed,
47
+ };
48
+ }
49
+
50
+ function normalizeLayers(nodeIds, edges, ranks) {
51
+ const known = new Set(nodeIds);
52
+ const seen = new Set();
53
+ const layers = [];
54
+ if (Array.isArray(ranks)) {
55
+ for (const rank of ranks) {
56
+ if (!Array.isArray(rank)) continue;
57
+ const ids = [...new Set(rank.filter((id) => known.has(id) && !seen.has(id)))].sort();
58
+ ids.forEach((id) => seen.add(id));
59
+ if (ids.length > 0) layers.push(ids);
60
+ }
61
+ }
62
+ if (layers.length === 0 && edges.length > 0) {
63
+ const level = new Map(nodeIds.map((id) => [id, 0]));
64
+ for (let pass = 0; pass < nodeIds.length; pass++) {
65
+ let changed = false;
66
+ for (const edge of edges) {
67
+ const next = Math.min(nodeIds.length - 1, level.get(edge.from) + 1);
68
+ if (next > level.get(edge.to)) { level.set(edge.to, next); changed = true; }
69
+ }
70
+ if (!changed) break;
71
+ }
72
+ for (const id of nodeIds) {
73
+ const rank = level.get(id);
74
+ (layers[rank] ??= []).push(id);
75
+ seen.add(id);
76
+ }
77
+ for (const layer of layers) layer?.sort();
78
+ }
79
+ for (const id of nodeIds) {
80
+ if (!seen.has(id)) (layers[0] ??= []).push(id);
81
+ }
82
+ return layers.filter(Boolean);
83
+ }
@@ -1,72 +1,72 @@
1
- /** DAG / dashboard pure model helpers (Observe UI R5). */
2
-
3
- const TERMINAL_DAG_EFFECTIVE_STATUSES = new Set([
4
- "finished",
5
- "failed",
6
- "superseded",
7
- "abandoned",
8
- ]);
9
-
10
- const TERMINAL_RUN_STATUSES = new Set([
11
- "finished",
12
- "completed",
13
- "succeeded",
14
- "failed",
15
- "partial_failed",
16
- "error",
17
- "cancelled",
18
- ]);
19
-
20
- export function dagMetaVisibility(dag) {
21
- const terminal =
22
- (dag?.lifecycle ?? "").toLowerCase() === "completed" ||
23
- TERMINAL_DAG_EFFECTIVE_STATUSES.has(dag?.effectiveStatus);
24
- return {
25
- showExecutorStatus: !terminal,
26
- showConsistencyWarning: dag?.stateConsistent === false,
27
- showResume: dag?.recoveryEligibility?.canResume === true,
28
- showReconcile: dag?.recoveryEligibility?.canReconcile === true,
29
- };
30
- }
31
-
32
- function isNodeActive(status) {
33
- if (!status) return false;
34
- const s = status.toLowerCase();
35
- return (
36
- s === "running" || s === "started" || s === "pending" || s === "queued"
37
- );
38
- }
39
-
40
- export function isDagRunActive(dag) {
41
- if (
42
- ["running", "running-quiet", "remote-unknown", "pending"].includes(
43
- dag.effectiveStatus,
44
- )
45
- )
46
- return true;
47
- if (dag.effectiveStatus && dag.effectiveStatus !== "unknown") return false;
48
- const status = (dag.status ?? "").toLowerCase();
49
- if ((dag.lifecycle ?? "").toLowerCase() === "paused") return false;
50
- if (["orphaned", "stale"].includes((dag.liveness ?? "").toLowerCase()))
51
- return false;
52
- if (TERMINAL_RUN_STATUSES.has(status)) return false;
53
- if (["running", "pending", "started"].includes(status)) return true;
54
- return (dag.nodes ?? []).some((n) => isNodeActive(n.status));
55
- }
56
-
57
- const DASHBOARD_FEATURE_STATUSES = new Set(["running", "needs_action"]);
58
-
59
- export function dashboardVisibleFeatures(features) {
60
- return (features ?? []).filter((feature) =>
61
- DASHBOARD_FEATURE_STATUSES.has(feature?.status),
62
- );
63
- }
64
-
65
- export function findDagForRun(snapshot, _workerRunId, task) {
66
- const dagRuns = snapshot?.dagRuns ?? [];
67
- if (task?.dagRunId) {
68
- const byTask = dagRuns.find((d) => d.dagRunId === task.dagRunId);
69
- if (byTask) return byTask;
70
- }
71
- return undefined;
72
- }
1
+ /** DAG / dashboard pure model helpers (Observe UI R5). */
2
+
3
+ const TERMINAL_DAG_EFFECTIVE_STATUSES = new Set([
4
+ "finished",
5
+ "failed",
6
+ "superseded",
7
+ "abandoned",
8
+ ]);
9
+
10
+ const TERMINAL_RUN_STATUSES = new Set([
11
+ "finished",
12
+ "completed",
13
+ "succeeded",
14
+ "failed",
15
+ "partial_failed",
16
+ "error",
17
+ "cancelled",
18
+ ]);
19
+
20
+ export function dagMetaVisibility(dag) {
21
+ const terminal =
22
+ (dag?.lifecycle ?? "").toLowerCase() === "completed" ||
23
+ TERMINAL_DAG_EFFECTIVE_STATUSES.has(dag?.effectiveStatus);
24
+ return {
25
+ showExecutorStatus: !terminal,
26
+ showConsistencyWarning: dag?.stateConsistent === false,
27
+ showResume: dag?.recoveryEligibility?.canResume === true,
28
+ showReconcile: dag?.recoveryEligibility?.canReconcile === true,
29
+ };
30
+ }
31
+
32
+ function isNodeActive(status) {
33
+ if (!status) return false;
34
+ const s = status.toLowerCase();
35
+ return (
36
+ s === "running" || s === "started" || s === "pending" || s === "queued"
37
+ );
38
+ }
39
+
40
+ export function isDagRunActive(dag) {
41
+ if (
42
+ ["running", "running-quiet", "remote-unknown", "pending"].includes(
43
+ dag.effectiveStatus,
44
+ )
45
+ )
46
+ return true;
47
+ if (dag.effectiveStatus && dag.effectiveStatus !== "unknown") return false;
48
+ const status = (dag.status ?? "").toLowerCase();
49
+ if ((dag.lifecycle ?? "").toLowerCase() === "paused") return false;
50
+ if (["orphaned", "stale"].includes((dag.liveness ?? "").toLowerCase()))
51
+ return false;
52
+ if (TERMINAL_RUN_STATUSES.has(status)) return false;
53
+ if (["running", "pending", "started"].includes(status)) return true;
54
+ return (dag.nodes ?? []).some((n) => isNodeActive(n.status));
55
+ }
56
+
57
+ const DASHBOARD_FEATURE_STATUSES = new Set(["running", "needs_action"]);
58
+
59
+ export function dashboardVisibleFeatures(features) {
60
+ return (features ?? []).filter((feature) =>
61
+ DASHBOARD_FEATURE_STATUSES.has(feature?.status),
62
+ );
63
+ }
64
+
65
+ export function findDagForRun(snapshot, _workerRunId, task) {
66
+ const dagRuns = snapshot?.dagRuns ?? [];
67
+ if (task?.dagRunId) {
68
+ const byTask = dagRuns.find((d) => d.dagRunId === task.dagRunId);
69
+ if (byTask) return byTask;
70
+ }
71
+ return undefined;
72
+ }
@@ -1,61 +1,61 @@
1
- /** DOM helpers (Observe UI R5). */
2
-
3
- export function clearNode(node) {
4
- while (node.firstChild) node.removeChild(node.firstChild);
5
- }
6
-
7
- export function el(tag, className, text) {
8
- const node = document.createElement(tag);
9
- if (className) node.className = className;
10
- if (text !== undefined) node.textContent = text;
11
- return node;
12
- }
13
-
14
- export function metaGrid(entries) {
15
- const dl = el("dl", "meta-grid");
16
- for (const [label, value] of entries) {
17
- const item = document.createElement("div");
18
- item.className = "meta-item";
19
- const dt = document.createElement("dt");
20
- dt.textContent = label;
21
- const dd = document.createElement("dd");
22
- if (value instanceof Node) dd.appendChild(value);
23
- else dd.textContent = value ?? "—";
24
- item.appendChild(dt);
25
- item.appendChild(dd);
26
- dl.appendChild(item);
27
- }
28
- return dl;
29
- }
30
-
31
- export function buildTable(headers, rows) {
32
- const table = document.createElement("table");
33
- const thead = document.createElement("thead");
34
- const headRow = document.createElement("tr");
35
- for (const h of headers) {
36
- const th = document.createElement("th");
37
- th.textContent = h;
38
- headRow.appendChild(th);
39
- }
40
- thead.appendChild(headRow);
41
- table.appendChild(thead);
42
-
43
- const tbody = document.createElement("tbody");
44
- for (const row of rows) {
45
- const tr = document.createElement("tr");
46
- if (row.className) tr.className = row.className;
47
- if (row.onClick) {
48
- tr.classList.add("clickable");
49
- tr.addEventListener("click", row.onClick);
50
- }
51
- for (const cell of row.cells) {
52
- const td = document.createElement("td");
53
- if (cell instanceof Node) td.appendChild(cell);
54
- else td.textContent = cell ?? "—";
55
- tr.appendChild(td);
56
- }
57
- tbody.appendChild(tr);
58
- }
59
- table.appendChild(tbody);
60
- return table;
61
- }
1
+ /** DOM helpers (Observe UI R5). */
2
+
3
+ export function clearNode(node) {
4
+ while (node.firstChild) node.removeChild(node.firstChild);
5
+ }
6
+
7
+ export function el(tag, className, text) {
8
+ const node = document.createElement(tag);
9
+ if (className) node.className = className;
10
+ if (text !== undefined) node.textContent = text;
11
+ return node;
12
+ }
13
+
14
+ export function metaGrid(entries) {
15
+ const dl = el("dl", "meta-grid");
16
+ for (const [label, value] of entries) {
17
+ const item = document.createElement("div");
18
+ item.className = "meta-item";
19
+ const dt = document.createElement("dt");
20
+ dt.textContent = label;
21
+ const dd = document.createElement("dd");
22
+ if (value instanceof Node) dd.appendChild(value);
23
+ else dd.textContent = value ?? "—";
24
+ item.appendChild(dt);
25
+ item.appendChild(dd);
26
+ dl.appendChild(item);
27
+ }
28
+ return dl;
29
+ }
30
+
31
+ export function buildTable(headers, rows) {
32
+ const table = document.createElement("table");
33
+ const thead = document.createElement("thead");
34
+ const headRow = document.createElement("tr");
35
+ for (const h of headers) {
36
+ const th = document.createElement("th");
37
+ th.textContent = h;
38
+ headRow.appendChild(th);
39
+ }
40
+ thead.appendChild(headRow);
41
+ table.appendChild(thead);
42
+
43
+ const tbody = document.createElement("tbody");
44
+ for (const row of rows) {
45
+ const tr = document.createElement("tr");
46
+ if (row.className) tr.className = row.className;
47
+ if (row.onClick) {
48
+ tr.classList.add("clickable");
49
+ tr.addEventListener("click", row.onClick);
50
+ }
51
+ for (const cell of row.cells) {
52
+ const td = document.createElement("td");
53
+ if (cell instanceof Node) td.appendChild(cell);
54
+ else td.textContent = cell ?? "—";
55
+ tr.appendChild(td);
56
+ }
57
+ tbody.appendChild(tr);
58
+ }
59
+ table.appendChild(tbody);
60
+ return table;
61
+ }
@@ -1,67 +1,67 @@
1
- /** Pool task sorting and status filter buckets (Observe UI R5). */
2
-
3
- export function sortPoolTasks(tasks) {
4
- const list = Array.isArray(tasks) ? [...tasks] : [];
5
- const active = new Set(["running", "pending", "blocked", "stale", "unknown"]);
6
- const rank = (status) => {
7
- const key = (status ?? "unknown").toLowerCase();
8
- if (key === "running") return 0;
9
- if (key === "pending" || key === "queued") return 1;
10
- if (key === "blocked") return 2;
11
- if (key === "stale") return 3;
12
- if (active.has(key)) return 4;
13
- return 10;
14
- };
15
- const timeKey = (task) =>
16
- task.updatedAt || task.finishedAt || task.startedAt || "";
17
- list.sort((a, b) => {
18
- const ra = rank(a.status);
19
- const rb = rank(b.status);
20
- if (ra !== rb) return ra - rb;
21
- if (ra >= 10) {
22
- const tb = timeKey(b).localeCompare(timeKey(a));
23
- if (tb !== 0) return tb;
24
- }
25
- return String(a.taskId ?? "").localeCompare(String(b.taskId ?? ""));
26
- });
27
- return list;
28
- }
29
-
30
- /**
31
- * Match task status against a hash filter token (same buckets as KPI counts).
32
- * pending ⊇ queued; succeeded ⊇ reused|done; blocked ⊇ stale.
33
- */
34
- export function matchesPoolStatusFilter(taskStatus, filter) {
35
- const st = (taskStatus ?? "").toLowerCase();
36
- const f = (filter ?? "").toLowerCase();
37
- if (!f) return true;
38
- if (f === "pending") return st === "pending" || st === "queued";
39
- if (f === "succeeded")
40
- return st === "succeeded" || st === "reused" || st === "done";
41
- if (f === "blocked") return st === "blocked" || st === "stale";
42
- if (f === "failed") return st === "failed" || st === "error";
43
- if (f === "running") return st === "running";
44
- return st === f;
45
- }
46
-
47
- export function poolStatusCounts(tasks) {
48
- const counts = {
49
- running: 0,
50
- pending: 0,
51
- blocked: 0,
52
- failed: 0,
53
- succeeded: 0,
54
- other: 0,
55
- };
56
- for (const task of tasks) {
57
- const key = (task.status ?? "unknown").toLowerCase();
58
- if (key === "running") counts.running += 1;
59
- else if (key === "pending" || key === "queued") counts.pending += 1;
60
- else if (key === "blocked" || key === "stale") counts.blocked += 1;
61
- else if (key === "failed" || key === "error") counts.failed += 1;
62
- else if (key === "succeeded" || key === "reused" || key === "done")
63
- counts.succeeded += 1;
64
- else counts.other += 1;
65
- }
66
- return counts;
67
- }
1
+ /** Pool task sorting and status filter buckets (Observe UI R5). */
2
+
3
+ export function sortPoolTasks(tasks) {
4
+ const list = Array.isArray(tasks) ? [...tasks] : [];
5
+ const active = new Set(["running", "pending", "blocked", "stale", "unknown"]);
6
+ const rank = (status) => {
7
+ const key = (status ?? "unknown").toLowerCase();
8
+ if (key === "running") return 0;
9
+ if (key === "pending" || key === "queued") return 1;
10
+ if (key === "blocked") return 2;
11
+ if (key === "stale") return 3;
12
+ if (active.has(key)) return 4;
13
+ return 10;
14
+ };
15
+ const timeKey = (task) =>
16
+ task.updatedAt || task.finishedAt || task.startedAt || "";
17
+ list.sort((a, b) => {
18
+ const ra = rank(a.status);
19
+ const rb = rank(b.status);
20
+ if (ra !== rb) return ra - rb;
21
+ if (ra >= 10) {
22
+ const tb = timeKey(b).localeCompare(timeKey(a));
23
+ if (tb !== 0) return tb;
24
+ }
25
+ return String(a.taskId ?? "").localeCompare(String(b.taskId ?? ""));
26
+ });
27
+ return list;
28
+ }
29
+
30
+ /**
31
+ * Match task status against a hash filter token (same buckets as KPI counts).
32
+ * pending ⊇ queued; succeeded ⊇ reused|done; blocked ⊇ stale.
33
+ */
34
+ export function matchesPoolStatusFilter(taskStatus, filter) {
35
+ const st = (taskStatus ?? "").toLowerCase();
36
+ const f = (filter ?? "").toLowerCase();
37
+ if (!f) return true;
38
+ if (f === "pending") return st === "pending" || st === "queued";
39
+ if (f === "succeeded")
40
+ return st === "succeeded" || st === "reused" || st === "done";
41
+ if (f === "blocked") return st === "blocked" || st === "stale";
42
+ if (f === "failed") return st === "failed" || st === "error";
43
+ if (f === "running") return st === "running";
44
+ return st === f;
45
+ }
46
+
47
+ export function poolStatusCounts(tasks) {
48
+ const counts = {
49
+ running: 0,
50
+ pending: 0,
51
+ blocked: 0,
52
+ failed: 0,
53
+ succeeded: 0,
54
+ other: 0,
55
+ };
56
+ for (const task of tasks) {
57
+ const key = (task.status ?? "unknown").toLowerCase();
58
+ if (key === "running") counts.running += 1;
59
+ else if (key === "pending" || key === "queued") counts.pending += 1;
60
+ else if (key === "blocked" || key === "stale") counts.blocked += 1;
61
+ else if (key === "failed" || key === "error") counts.failed += 1;
62
+ else if (key === "succeeded" || key === "reused" || key === "done")
63
+ counts.succeeded += 1;
64
+ else counts.other += 1;
65
+ }
66
+ return counts;
67
+ }