@tea-agent/loop-agent 0.13.0 → 0.15.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 (272) hide show
  1. package/AGENTS.md +157 -157
  2. package/CHANGELOG.md +116 -305
  3. package/README.md +357 -334
  4. package/bin/agent-worker.js +22 -22
  5. package/bin/loop-agent.js +21 -21
  6. package/dist/commands/cursor-prompt.js +6 -6
  7. package/dist/commands/init.js +505 -505
  8. package/dist/commands/loop-benchmark.js +11 -11
  9. package/dist/commands/pi-reuse-benchmark.js +16 -16
  10. package/dist/executors/pi-event-serializer.js +33 -11
  11. package/dist/sidecars/cursor-prompt/executor.js +1 -1
  12. package/dist/task/runtime.js +27 -27
  13. package/dist/worker/observe/spec-evidence.js +19 -10
  14. package/dist/worker/observe/static/api.js +46 -46
  15. package/dist/worker/observe/static/app.js +151 -150
  16. package/dist/worker/observe/static/constants.js +156 -148
  17. package/dist/worker/observe/static/copy.js +67 -67
  18. package/dist/worker/observe/static/dag-helpers.js +201 -172
  19. package/dist/worker/observe/static/dag-layout.d.ts +31 -31
  20. package/dist/worker/observe/static/dag-layout.js +83 -83
  21. package/dist/worker/observe/static/dag-model.js +72 -72
  22. package/dist/worker/observe/static/dom.js +122 -122
  23. package/dist/worker/observe/static/format-pool.d.ts +71 -0
  24. package/dist/worker/observe/static/format-pool.js +134 -67
  25. package/dist/worker/observe/static/format.js +317 -292
  26. package/dist/worker/observe/static/index.html +350 -308
  27. package/dist/worker/observe/static/kpi.js +100 -94
  28. package/dist/worker/observe/static/markdown-render.js +124 -0
  29. package/dist/worker/observe/static/relations.js +133 -133
  30. package/dist/worker/observe/static/router.js +93 -93
  31. package/dist/worker/observe/static/run-processing.js +148 -148
  32. package/dist/worker/observe/static/shell-chrome.js +74 -68
  33. package/dist/worker/observe/static/state.js +273 -267
  34. package/dist/worker/observe/static/styles.css +2504 -1902
  35. package/dist/worker/observe/static/views/batch.js +227 -227
  36. package/dist/worker/observe/static/views/dag-graph.js +172 -172
  37. package/dist/worker/observe/static/views/dag-inspector.js +530 -627
  38. package/dist/worker/observe/static/views/dag.js +371 -371
  39. package/dist/worker/observe/static/views/dashboard.js +86 -100
  40. package/dist/worker/observe/static/views/failures.js +143 -143
  41. package/dist/worker/observe/static/views/feature.js +492 -492
  42. package/dist/worker/observe/static/views/pool.js +708 -350
  43. package/dist/worker/observe/static/views/run.js +453 -453
  44. package/dist/worker/observe/static/views/session-timeline.js +771 -219
  45. package/dist/worker/observe/static/views/shell.js +7 -7
  46. package/dist/worker/observe/static/views/task.js +314 -314
  47. package/dist/worker/observe/static/views/timeline.js +163 -163
  48. package/dist/workflows/dag/canvas-observer.js +275 -275
  49. package/dist/workflows/dag/init-hybrid.js +27 -11
  50. package/docs/README.md +106 -104
  51. package/docs/architecture/README.md +26 -26
  52. package/docs/architecture/dag-execution.md +140 -140
  53. package/docs/architecture/evolution.md +54 -54
  54. package/docs/architecture/facts-and-state.md +71 -71
  55. package/docs/architecture/runtime-boundaries.md +191 -191
  56. package/docs/architecture/system-overview.md +93 -93
  57. package/docs/architecture/worker-and-feature.md +85 -85
  58. package/docs/harness-methodology-debugging.md +153 -153
  59. package/docs/harness-methodology-tdd.md +130 -130
  60. package/docs/harness-methodology-verification.md +27 -27
  61. package/docs/init-surface.manifest.json +304 -307
  62. package/docs/skills/README.md +7 -7
  63. package/docs/skills/vetted-skill-registry.md +29 -29
  64. package/docs/templates/adr.md +60 -60
  65. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  66. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  67. package/docs/templates/agent-dag-decision-gate-dogfood-report.md +117 -117
  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/agent-dag.base.json +190 -190
  73. package/docs/templates/agent-dag.final-verification.json +185 -185
  74. package/docs/templates/agent-dag.schema.json +411 -411
  75. package/docs/templates/agent-dag.supervised-implementation.json +620 -620
  76. package/docs/templates/backend-test-analysis.schema.json +44 -44
  77. package/docs/templates/backend-test-case-manifest.schema.json +190 -190
  78. package/docs/templates/backend-test-dag.classify.prompt.md +75 -75
  79. package/docs/templates/backend-test-dag.generate-pytest.prompt.md +204 -204
  80. package/docs/templates/backend-test-dag.json +559 -559
  81. package/docs/templates/backend-test-dag.retrospect.prompt.md +139 -139
  82. package/docs/templates/backend-test-dag.review-cases.prompt.md +83 -83
  83. package/docs/templates/backend-test-execution.schema.json +133 -133
  84. package/docs/templates/backend-test-result.schema.json +99 -99
  85. package/docs/templates/branch-merge-report.md +0 -1
  86. package/docs/templates/exec-plan.md +64 -64
  87. package/docs/templates/feature-spec.md +53 -53
  88. package/docs/templates/frontend-design-contract.md +42 -42
  89. package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md +17 -17
  90. package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md +16 -16
  91. package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md +16 -16
  92. package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md +16 -16
  93. package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md +16 -16
  94. package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md +16 -16
  95. package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md +21 -21
  96. package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md +29 -29
  97. package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md +28 -28
  98. package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md +28 -28
  99. package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md +29 -29
  100. package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md +27 -27
  101. package/docs/templates/frontend-eval/fixtures/functional/06-ssr-server-client-boundary.md +28 -28
  102. package/docs/templates/frontend-eval/fixtures/functional/07-shared-public-component-api.md +28 -28
  103. package/docs/templates/frontend-eval/fixtures/functional/08-pure-local-no-remote.md +27 -27
  104. package/docs/templates/frontend-eval/metrics.md +138 -138
  105. package/docs/templates/frontend-eval/smoke-targets.md +53 -53
  106. package/docs/templates/frontend-implementation-contract.schema.json +27 -27
  107. package/docs/templates/frontend-task-constraints.md +35 -35
  108. package/docs/templates/frontend-task-requirement.md +70 -70
  109. package/docs/templates/frontend-test-dag.generate-cases.prompt.md +5 -5
  110. package/docs/templates/frontend-test-dag.json +23 -23
  111. package/docs/templates/frontend-test-dag.retrieve-context.prompt.md +3 -3
  112. package/docs/templates/frontend-test-dag.retrospect.prompt.md +3 -3
  113. package/docs/templates/frontend-test-dag.review-cases.prompt.md +3 -3
  114. package/docs/templates/frontend-test-dag.review-execution.prompt.md +3 -3
  115. package/docs/templates/harness.schema.json +221 -221
  116. package/docs/templates/hybrid-dag.json +188 -188
  117. package/docs/templates/init-evolution-review.md +35 -35
  118. package/docs/templates/interactive-ui-round2-experiment.md +66 -66
  119. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -118
  120. package/docs/templates/knowledge-sync-dag.json +178 -178
  121. package/docs/templates/knowledge-sync-draft.schema.json +71 -71
  122. package/docs/templates/product-line/AGENTS.md +8 -8
  123. package/docs/templates/product-line/README.md +9 -9
  124. package/docs/templates/product-line/acceptance.yaml +14 -14
  125. package/docs/templates/product-line/closeout.yaml +9 -9
  126. package/docs/templates/product-line/design.md +13 -13
  127. package/docs/templates/product-line/links.md +10 -10
  128. package/docs/templates/product-line/requirement.md +17 -17
  129. package/docs/templates/product-line/task-graph.yaml +15 -15
  130. package/docs/templates/product-line/task.yaml +64 -64
  131. package/docs/templates/product-line/test-plan.md +7 -7
  132. package/docs/templates/production-readiness-checklist.md +57 -57
  133. package/docs/templates/progress-log.md +17 -17
  134. package/docs/templates/project-start-checklist.md +9 -9
  135. package/docs/templates/qa-report.md +48 -48
  136. package/docs/templates/sprint-contract.md +29 -29
  137. package/docs/templates/worker-dogfood-evidence.md +80 -80
  138. package/docs/templates/worker-dogfood-setup.md +68 -68
  139. package/examples/decision-gate-agent-dag.json +173 -173
  140. package/examples/example-dag.json +46 -46
  141. package/examples/hybrid-loop-agent-dag.json +188 -188
  142. package/harness.json +66 -66
  143. package/package.json +78 -52
  144. package/scripts/kb-bootstrap-init-skeleton.sh +240 -240
  145. package/scripts/kb-graph-incremental-prepare.mjs +386 -386
  146. package/scripts/kb-graph-materialize.mjs +105 -105
  147. package/scripts/kb-graph-promote.mjs +164 -164
  148. package/scripts/kb-query.mjs +554 -554
  149. package/skills/agent-worker/SKILL.md +39 -39
  150. package/skills/agent-worker/references/agent-worker-operator.md +60 -60
  151. package/skills/ai-engineering-context/SKILL.md +48 -48
  152. package/skills/analyze-product-dependencies/SKILL.md +67 -67
  153. package/skills/analyze-product-dependencies/agents/openai.yaml +4 -4
  154. package/skills/analyze-product-dependencies/references/api-documentation-schema.md +30 -30
  155. package/skills/analyze-product-dependencies/references/dependency-analysis-schema.md +28 -28
  156. package/skills/analyze-product-dependencies/references/example.md +76 -76
  157. package/skills/analyze-product-dependencies/references/forward-test-cases.md +35 -35
  158. package/skills/analyze-product-dependencies/references/input-contract.md +11 -11
  159. package/skills/analyze-product-dependencies/references/scouting-rules.md +61 -61
  160. package/skills/analyze-product-dependencies/scripts/test-validators.mjs +267 -267
  161. package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +101 -101
  162. package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +142 -142
  163. package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +76 -76
  164. package/skills/analyze-product-dependencies/scripts/validation-helpers.mjs +146 -146
  165. package/skills/analyze-product-requirements/SKILL.md +90 -90
  166. package/skills/analyze-product-requirements/agents/openai.yaml +4 -4
  167. package/skills/analyze-product-requirements/references/acceptance-criteria.md +91 -91
  168. package/skills/analyze-product-requirements/references/clarification-and-knowledge.md +56 -56
  169. package/skills/analyze-product-requirements/references/example.md +86 -86
  170. package/skills/analyze-product-requirements/references/forward-test-cases.md +66 -66
  171. package/skills/analyze-product-requirements/references/product-analysis-schema.md +32 -32
  172. package/skills/analyze-product-requirements/references/product-requirement-schema.md +33 -33
  173. package/skills/analyze-product-requirements/references/requirement-clarification-schema.md +35 -35
  174. package/skills/analyze-product-requirements/scripts/test-validators.mjs +193 -193
  175. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +69 -69
  176. package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +97 -97
  177. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +98 -98
  178. package/skills/analyze-product-requirements/scripts/validation-helpers.mjs +156 -156
  179. package/skills/browser-tools/SKILL.md +196 -196
  180. package/skills/browser-tools/browser-content.js +103 -103
  181. package/skills/browser-tools/browser-cookies.js +35 -35
  182. package/skills/browser-tools/browser-eval.js +53 -53
  183. package/skills/browser-tools/browser-hn-scraper.js +108 -108
  184. package/skills/browser-tools/browser-nav.js +44 -44
  185. package/skills/browser-tools/browser-pick.js +162 -162
  186. package/skills/browser-tools/browser-screenshot.js +34 -34
  187. package/skills/browser-tools/browser-start.js +86 -86
  188. package/skills/browser-tools/package-lock.json +2556 -2556
  189. package/skills/browser-tools/package.json +19 -19
  190. package/skills/code-review-core/SKILL.md +20 -20
  191. package/skills/codebase-scout/SKILL.md +19 -19
  192. package/skills/frontend-design-review/SKILL.md +66 -66
  193. package/skills/frontend-design-review/references/review-checklist.md +40 -58
  194. package/skills/frontend-implementation/SKILL.md +49 -49
  195. package/skills/frontend-implementation/references/code-standards.md +32 -32
  196. package/skills/frontend-implementation/references/design-spec.md +46 -46
  197. package/skills/frontend-implementation/references/node-contracts.md +27 -27
  198. package/skills/frontend-review/SKILL.md +61 -59
  199. package/skills/frontend-review/references/review-findings.md +48 -47
  200. package/skills/frontend-verification/SKILL.md +55 -53
  201. package/skills/frontend-verification/references/verification-checklist.md +59 -68
  202. package/skills/grill-me/SKILL.md +10 -10
  203. package/skills/grill-with-docs/SKILL.md +88 -88
  204. package/skills/grill-with-docs/adr-format.md +47 -47
  205. package/skills/grill-with-docs/context-format.md +60 -60
  206. package/skills/init-capability-evolution/SKILL.md +70 -70
  207. package/skills/loop-agent/SKILL.md +151 -151
  208. package/skills/loop-agent/references/README.md +67 -67
  209. package/skills/loop-agent/references/command-reference.md +527 -527
  210. package/skills/loop-agent/references/docs-converge.md +126 -126
  211. package/skills/loop-agent/references/harness-policy.md +263 -263
  212. package/skills/loop-agent/references/hybrid-dag.md +243 -243
  213. package/skills/loop-agent/references/learned/README.md +21 -21
  214. package/skills/loop-agent/references/long-running-loop.md +57 -57
  215. package/skills/loop-agent/references/model-routing.md +36 -36
  216. package/skills/loop-agent/references/multi-worktree.md +54 -54
  217. package/skills/loop-agent/references/one-shot-runs.md +85 -85
  218. package/skills/loop-agent/references/orchestrator-and-interventions.md +169 -169
  219. package/skills/loop-agent/references/pi-prompt.md +23 -23
  220. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
  221. package/skills/loop-agent/references/post-implementation-and-patterns.md +44 -44
  222. package/skills/loop-agent/references/task-workflow.md +89 -89
  223. package/skills/loop-agent/references/verification-and-failure-handling.md +141 -141
  224. package/skills/playwright-cli/SKILL.md +420 -420
  225. package/skills/playwright-cli/references/element-attributes.md +23 -23
  226. package/skills/playwright-cli/references/playwright-tests.md +39 -39
  227. package/skills/playwright-cli/references/request-mocking.md +87 -87
  228. package/skills/playwright-cli/references/running-code.md +241 -241
  229. package/skills/playwright-cli/references/session-management.md +225 -225
  230. package/skills/playwright-cli/references/storage-state.md +275 -275
  231. package/skills/playwright-cli/references/test-generation.md +433 -433
  232. package/skills/playwright-cli/references/tracing.md +139 -139
  233. package/skills/playwright-cli/references/video-recording.md +143 -143
  234. package/skills/playwright-cli-case-generator/SKILL.md +74 -74
  235. package/skills/requesting-code-review/SKILL.md +101 -101
  236. package/skills/requesting-code-review/code-reviewer.md +168 -168
  237. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  238. package/skills/systematic-debugging/SKILL.md +296 -296
  239. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  240. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  241. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  242. package/skills/systematic-debugging/find-polluter.sh +63 -63
  243. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  244. package/skills/systematic-debugging/test-academic.md +14 -14
  245. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  246. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  247. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  248. package/skills/test-driven-development/SKILL.md +20 -20
  249. package/skills/using-git-worktrees/SKILL.md +215 -215
  250. package/skills/verification-before-completion/SKILL.md +154 -154
  251. package/skills/webapp-testing/SKILL.md +19 -19
  252. package/docs/agent-dag-recovery-playbook.md +0 -195
  253. package/docs/agent-dag-runner.md +0 -67
  254. package/docs/cursor-prompt-sidecar.md +0 -36
  255. package/docs/decisions/README.md +0 -18
  256. package/docs/design/README.md +0 -167
  257. package/docs/development-principles.md +0 -73
  258. package/docs/exec-plans/README.md +0 -6
  259. package/docs/exec-plans/active/README.md +0 -12
  260. package/docs/exec-plans/completed/README.md +0 -107
  261. package/docs/feature-workflow.md +0 -414
  262. package/docs/loop-agent-harness.md +0 -142
  263. package/docs/production-readiness.md +0 -96
  264. package/docs/progress/README.md +0 -80
  265. package/docs/reports/README.md +0 -159
  266. package/docs/verification-matrix.md +0 -70
  267. package/scripts/check-product-line-docs.sh +0 -29
  268. package/scripts/check-task-pool-root.sh +0 -32
  269. package/scripts/kb-graph-incremental-prepare.sh +0 -5
  270. package/scripts/kb-graph-materialize.sh +0 -4
  271. package/scripts/kb-graph-promote.sh +0 -4
  272. package/scripts/kb-query.sh +0 -5
@@ -1,7 +1,7 @@
1
- /**
2
- * Shell service locator removed in R5 boundary final (BND-02).
3
- * Views import focused modules directly (shell-chrome, kpi, dag-helpers, run-processing).
4
- * This file is retained only so historical bundle paths do not 404; do not reintroduce getShell.
5
- */
6
-
7
- export {};
1
+ /**
2
+ * Shell service locator removed in R5 boundary final (BND-02).
3
+ * Views import focused modules directly (shell-chrome, kpi, dag-helpers, run-processing).
4
+ * This file is retained only so historical bundle paths do not 404; do not reintroduce getShell.
5
+ */
6
+
7
+ export {};
@@ -1,314 +1,314 @@
1
- /** Observe UI view module (R5). */
2
- import {
3
- UI_TEXT,
4
- LIVENESS_LABELS,
5
- ARTIFACT_LABELS,
6
- ARTIFACT_KEYS,
7
- STEP_LABELS,
8
- STEP_ORDER,
9
- DAG_INSPECTOR_DEFAULT_WIDTH,
10
- DAG_INSPECTOR_MIN_WIDTH,
11
- DAG_INSPECTOR_MAX_WIDTH,
12
- DAG_INSPECTOR_RIGHT_OFFSET,
13
- DAG_INSPECTOR_VIEWPORT_MARGIN,
14
- DAG_INSPECTOR_KEYBOARD_STEP,
15
- TERMINAL_RUN_STATUSES,
16
- DAG_EFFECTIVE_STATUS_LABELS,
17
- STATUS_LABELS,
18
- } from "../constants.js";
19
- import { clearNode, el, metaGrid, buildTable } from "../dom.js";
20
- import {
21
- badge,
22
- badgeClass,
23
- statusLabel,
24
- formatTs,
25
- formatMs,
26
- formatDuration,
27
- formatAgo,
28
- dagStatusBadge,
29
- livenessBadge,
30
- displayDurationMs,
31
- derivedDurationMs,
32
- summaryText,
33
- truncateText,
34
- repoBaseName,
35
- parseMarkdownBlocks,
36
- markdownLinkHref,
37
- } from "../format.js";
38
- import { parseRoute, navigate, buildHashPath } from "../router.js";
39
- import {
40
- fetchJson,
41
- fetchJsonResult,
42
- artifactUrl,
43
- parseArtifactPreviewResponse,
44
- } from "../api.js";
45
- import {
46
- objectRouteLink,
47
- findFeatureInSnapshot,
48
- featureLookupState,
49
- buildObjectRelations,
50
- renderObjectRelationBar,
51
- } from "../relations.js";
52
- import { copyText, renderRecommendedCommand } from "../copy.js";
53
- import {
54
- isPageVisible,
55
- detailPollDelay,
56
- dashboardPollDelay,
57
- captureDagGraphViewportState,
58
- updateDagGraphViewportState,
59
- updateDagTimelineViewportState,
60
- renderViewState,
61
- mountViewState,
62
- } from "../state.js";
63
- import { uiState } from "../state.js";
64
- import { sortPoolTasks } from "../format-pool.js";
65
- import {
66
- dagMetaVisibility,
67
- isDagRunActive,
68
- dashboardVisibleFeatures,
69
- findDagForRun,
70
- } from "../dag-model.js";
71
- import { layoutDag } from "../dag-layout.js";
72
- import { showView, setBreadcrumb, updateHeaderRefresh, mountRelationBar } from "../shell-chrome.js";
73
- import { artifactLink } from "../kpi.js";
74
- import { findBatchRunIdForTask, taskRunHistoryRow } from "../run-processing.js";
75
-
76
- export async function renderTaskDetail(featureId, taskId) {
77
- if (taskId === undefined) {
78
- taskId = featureId;
79
- featureId = undefined;
80
- }
81
- const taskApi = featureId
82
- ? `/api/features/${encodeURIComponent(featureId)}/tasks/${encodeURIComponent(taskId)}`
83
- : `/api/tasks/${encodeURIComponent(taskId)}`;
84
- const displayLabel = featureId ? `${featureId}::${taskId}` : taskId;
85
- showView("task");
86
- setBreadcrumb([
87
- { label: UI_TEXT.dashboard, href: "#/" },
88
- { label: "资源池", href: "#/pool" },
89
- { label: displayLabel },
90
- ]);
91
-
92
- const titleEl = document.getElementById("task-title");
93
- const metaEl = document.getElementById("task-meta");
94
- const linksEl = document.getElementById("task-links");
95
- const evidenceEl = document.getElementById("task-evidence");
96
- const runsEl = document.getElementById("task-runs");
97
- if (!metaEl || !linksEl || !evidenceEl || !runsEl) return false;
98
- if (titleEl) titleEl.textContent = displayLabel;
99
- mountViewState(metaEl, "loading", "加载 Task…");
100
-
101
- const [taskResult, historyResult, snapshot] = await Promise.all([
102
- fetchJsonResult(taskApi),
103
- fetchJsonResult(`${taskApi}/runs?limit=20`),
104
- fetchJson("/api/snapshot"),
105
- ]);
106
- const task = taskResult.ok ? taskResult.body : null;
107
- const history = historyResult.ok ? historyResult.body : null;
108
- if (snapshot) {
109
- uiState.lastSnapshot = snapshot;
110
- updateHeaderRefresh(snapshot.generatedAt);
111
- }
112
-
113
- clearNode(metaEl);
114
- clearNode(linksEl);
115
- clearNode(evidenceEl);
116
- clearNode(runsEl);
117
-
118
- if (!task) {
119
- if (taskResult.status === 409) {
120
- const candidates = Array.isArray(taskResult.body?.candidates)
121
- ? taskResult.body.candidates
122
- : [];
123
- mountViewState(
124
- metaEl,
125
- "error",
126
- `Task 身份歧义:${taskId} 同时属于多个 Feature,请选择 Feature 作用域入口。`,
127
- );
128
- if (candidates.length > 0) {
129
- const list = el("div", "artifact-links");
130
- for (const c of candidates) {
131
- if (!c?.featureId || !c?.taskId) continue;
132
- const path = `/feature/${encodeURIComponent(c.featureId)}/task/${encodeURIComponent(c.taskId)}`;
133
- const a = el("a", "object-link", `${c.featureId}::${c.taskId}`);
134
- a.href = `#${path}`;
135
- a.addEventListener("click", (e) => {
136
- e.preventDefault();
137
- navigate(path);
138
- });
139
- list.appendChild(a);
140
- list.appendChild(document.createTextNode(" "));
141
- }
142
- metaEl.appendChild(list);
143
- }
144
- } else {
145
- mountViewState(metaEl, "error", `未找到 Task:${taskId}`);
146
- }
147
- mountRelationBar("task-relations", {}, snapshot);
148
- return false;
149
- }
150
-
151
- metaEl.appendChild(
152
- metaGrid([
153
- ["Task ID", task.taskId],
154
- ["状态", badge(task.status)],
155
- [
156
- "Feature",
157
- task.featureId
158
- ? objectRouteLink("feature", task.featureId, snapshot)
159
- : el("span", "muted", "—"),
160
- ],
161
- ["更新时间", task.updatedAt ?? task.finishedAt ?? task.startedAt ?? "—"],
162
- ["最新 worker run", task.workerRunId ?? "—"],
163
- ["失败分类", task.failureCategory ?? "—"],
164
- ["建议跟进", task.recommendedFollowUp ?? "—"],
165
- [
166
- "活性",
167
- task.liveness ? (LIVENESS_LABELS[task.liveness] ?? task.liveness) : "—",
168
- ],
169
- ]),
170
- );
171
-
172
- const batchRunId = findBatchRunIdForTask(snapshot, task);
173
- const dag = findDagForRun(snapshot, task.workerRunId, task);
174
- mountRelationBar(
175
- "task-relations",
176
- {
177
- featureId: task.featureId,
178
- taskId: task.taskId,
179
- batchRunId: batchRunId ?? undefined,
180
- workerRunId: task.workerRunId,
181
- dagRunId: dag?.dagRunId ?? task.dagRunId,
182
- },
183
- snapshot,
184
- );
185
- linksEl.appendChild(el("h3", "section-heading", "真实关联"));
186
- const linkList = el("div", "artifact-links");
187
- linkList.appendChild(objectRouteLink("run", task.workerRunId, snapshot));
188
- linkList.appendChild(document.createTextNode(" · "));
189
- linkList.appendChild(
190
- batchRunId
191
- ? objectRouteLink("batch", batchRunId, snapshot)
192
- : el("span", "muted", "batch 缺失"),
193
- );
194
- linkList.appendChild(document.createTextNode(" · "));
195
- linkList.appendChild(
196
- dag
197
- ? objectRouteLink("dag", dag.dagRunId, snapshot)
198
- : task.dagRunId
199
- ? el("span", "muted", task.dagRunId)
200
- : el("span", "muted", "DAG 缺失"),
201
- );
202
- if (task.featureId) {
203
- linkList.appendChild(document.createTextNode(" · "));
204
- linkList.appendChild(objectRouteLink("feature", task.featureId, snapshot));
205
- }
206
- linksEl.appendChild(linkList);
207
-
208
- evidenceEl.appendChild(el("h3", "section-heading", "失败证据"));
209
- const r = task.artifactRefs ?? {};
210
- const evidenceLinks = el("div", "artifact-links");
211
- evidenceLinks.appendChild(artifactLink("报告", r.reportMarkdown));
212
- evidenceLinks.appendChild(document.createTextNode(" "));
213
- evidenceLinks.appendChild(artifactLink("诊断", r.doctorMarkdown));
214
- evidenceLinks.appendChild(document.createTextNode(" "));
215
- evidenceLinks.appendChild(artifactLink("收尾方案", r.closeoutDraft));
216
- evidenceLinks.appendChild(document.createTextNode(" "));
217
- evidenceLinks.appendChild(artifactLink("run 记录", r.runRecordPath));
218
- if (
219
- !r.reportMarkdown &&
220
- !r.doctorMarkdown &&
221
- !r.closeoutDraft &&
222
- !r.runRecordPath
223
- ) {
224
- evidenceEl.appendChild(el("p", "empty", "暂无 allowlist 内的证据路径。"));
225
- } else {
226
- evidenceEl.appendChild(evidenceLinks);
227
- }
228
-
229
- runsEl.appendChild(el("h3", "section-heading", "运行历史"));
230
- const runs = history?.runs ?? [];
231
- if (runs.length === 0) {
232
- mountViewState(runsEl, "empty", "暂无 ledger 运行记录。");
233
- } else {
234
- const rows = runs.map(taskRunHistoryRow);
235
- runsEl.appendChild(
236
- buildTable(
237
- ["worker run", "状态", "时间", "batch", "retryOf", "失败分类"],
238
- rows,
239
- ),
240
- );
241
- if (history?.nextBefore) {
242
- const more = el("button", "link-button", "加载更早的运行");
243
- more.type = "button";
244
- more.addEventListener("click", () => {
245
- void loadOlderTaskRuns(featureId, taskId, history.nextBefore, runsEl);
246
- });
247
- runsEl.appendChild(more);
248
- }
249
- }
250
-
251
- const active = ["running", "pending", "blocked", "stale"].includes(
252
- (task.status ?? "").toLowerCase(),
253
- );
254
- return active;
255
- }
256
-
257
- export async function loadOlderTaskRuns(featureId, taskId, before, runsEl) {
258
- if (runsEl === undefined) {
259
- runsEl = before;
260
- before = taskId;
261
- taskId = featureId;
262
- featureId = undefined;
263
- }
264
- const taskApi = featureId
265
- ? `/api/features/${encodeURIComponent(featureId)}/tasks/${encodeURIComponent(taskId)}`
266
- : `/api/tasks/${encodeURIComponent(taskId)}`;
267
- const page = await fetchJson(
268
- `${taskApi}/runs?limit=20&before=${encodeURIComponent(before)}`,
269
- );
270
- if (!page?.runs?.length) return;
271
- const table = runsEl.querySelector("table");
272
- if (!table) return;
273
- const tbody = table.querySelector("tbody") || table;
274
- for (const run of page.runs) {
275
- const tr = document.createElement("tr");
276
- for (const cell of taskRunHistoryRow(run).cells) {
277
- const td = document.createElement("td");
278
- if (cell instanceof Node) td.appendChild(cell);
279
- else td.textContent = cell;
280
- tr.appendChild(td);
281
- }
282
- tbody.appendChild(tr);
283
- }
284
- const btn = runsEl.querySelector("button.link-button");
285
- if (btn) {
286
- if (page.nextBefore) {
287
- btn.onclick = () => {
288
- void loadOlderTaskRuns(featureId, taskId, page.nextBefore, runsEl);
289
- };
290
- } else {
291
- btn.remove();
292
- }
293
- }
294
- }
295
-
296
- export function startTaskPolling(featureId, taskId) {
297
- if (taskId === undefined) {
298
- taskId = featureId;
299
- featureId = undefined;
300
- }
301
- if (uiState.taskPollTimer) clearTimeout(uiState.taskPollTimer);
302
- const generation = ++uiState.pollingGeneration;
303
- const poll = async () => {
304
- const active = await renderTaskDetail(featureId, taskId);
305
- if (generation !== uiState.pollingGeneration || !active) return;
306
- const delay = detailPollDelay("running", isPageVisible());
307
- if (delay == null) return;
308
- uiState.taskPollTimer = setTimeout(() => {
309
- uiState.taskPollTimer = null;
310
- void poll();
311
- }, delay);
312
- };
313
- void poll();
314
- }
1
+ /** Observe UI view module (R5). */
2
+ import {
3
+ UI_TEXT,
4
+ LIVENESS_LABELS,
5
+ ARTIFACT_LABELS,
6
+ ARTIFACT_KEYS,
7
+ STEP_LABELS,
8
+ STEP_ORDER,
9
+ DAG_INSPECTOR_DEFAULT_WIDTH,
10
+ DAG_INSPECTOR_MIN_WIDTH,
11
+ DAG_INSPECTOR_MAX_WIDTH,
12
+ DAG_INSPECTOR_RIGHT_OFFSET,
13
+ DAG_INSPECTOR_VIEWPORT_MARGIN,
14
+ DAG_INSPECTOR_KEYBOARD_STEP,
15
+ TERMINAL_RUN_STATUSES,
16
+ DAG_EFFECTIVE_STATUS_LABELS,
17
+ STATUS_LABELS,
18
+ } from "../constants.js";
19
+ import { clearNode, el, metaGrid, buildTable } from "../dom.js";
20
+ import {
21
+ badge,
22
+ badgeClass,
23
+ statusLabel,
24
+ formatTs,
25
+ formatMs,
26
+ formatDuration,
27
+ formatAgo,
28
+ dagStatusBadge,
29
+ livenessBadge,
30
+ displayDurationMs,
31
+ derivedDurationMs,
32
+ summaryText,
33
+ truncateText,
34
+ repoBaseName,
35
+ parseMarkdownBlocks,
36
+ markdownLinkHref,
37
+ } from "../format.js";
38
+ import { parseRoute, navigate, buildHashPath } from "../router.js";
39
+ import {
40
+ fetchJson,
41
+ fetchJsonResult,
42
+ artifactUrl,
43
+ parseArtifactPreviewResponse,
44
+ } from "../api.js";
45
+ import {
46
+ objectRouteLink,
47
+ findFeatureInSnapshot,
48
+ featureLookupState,
49
+ buildObjectRelations,
50
+ renderObjectRelationBar,
51
+ } from "../relations.js";
52
+ import { copyText, renderRecommendedCommand } from "../copy.js";
53
+ import {
54
+ isPageVisible,
55
+ detailPollDelay,
56
+ dashboardPollDelay,
57
+ captureDagGraphViewportState,
58
+ updateDagGraphViewportState,
59
+ updateDagTimelineViewportState,
60
+ renderViewState,
61
+ mountViewState,
62
+ } from "../state.js";
63
+ import { uiState } from "../state.js";
64
+ import { sortPoolTasks } from "../format-pool.js";
65
+ import {
66
+ dagMetaVisibility,
67
+ isDagRunActive,
68
+ dashboardVisibleFeatures,
69
+ findDagForRun,
70
+ } from "../dag-model.js";
71
+ import { layoutDag } from "../dag-layout.js";
72
+ import { showView, setBreadcrumb, updateHeaderRefresh, mountRelationBar } from "../shell-chrome.js";
73
+ import { artifactLink } from "../kpi.js";
74
+ import { findBatchRunIdForTask, taskRunHistoryRow } from "../run-processing.js";
75
+
76
+ export async function renderTaskDetail(featureId, taskId) {
77
+ if (taskId === undefined) {
78
+ taskId = featureId;
79
+ featureId = undefined;
80
+ }
81
+ const taskApi = featureId
82
+ ? `/api/features/${encodeURIComponent(featureId)}/tasks/${encodeURIComponent(taskId)}`
83
+ : `/api/tasks/${encodeURIComponent(taskId)}`;
84
+ const displayLabel = featureId ? `${featureId}::${taskId}` : taskId;
85
+ showView("task");
86
+ setBreadcrumb([
87
+ { label: UI_TEXT.dashboard, href: "#/" },
88
+ { label: "资源池", href: "#/pool" },
89
+ { label: displayLabel },
90
+ ]);
91
+
92
+ const titleEl = document.getElementById("task-title");
93
+ const metaEl = document.getElementById("task-meta");
94
+ const linksEl = document.getElementById("task-links");
95
+ const evidenceEl = document.getElementById("task-evidence");
96
+ const runsEl = document.getElementById("task-runs");
97
+ if (!metaEl || !linksEl || !evidenceEl || !runsEl) return false;
98
+ if (titleEl) titleEl.textContent = displayLabel;
99
+ mountViewState(metaEl, "loading", "加载 Task…");
100
+
101
+ const [taskResult, historyResult, snapshot] = await Promise.all([
102
+ fetchJsonResult(taskApi),
103
+ fetchJsonResult(`${taskApi}/runs?limit=20`),
104
+ fetchJson("/api/snapshot"),
105
+ ]);
106
+ const task = taskResult.ok ? taskResult.body : null;
107
+ const history = historyResult.ok ? historyResult.body : null;
108
+ if (snapshot) {
109
+ uiState.lastSnapshot = snapshot;
110
+ updateHeaderRefresh(snapshot.generatedAt);
111
+ }
112
+
113
+ clearNode(metaEl);
114
+ clearNode(linksEl);
115
+ clearNode(evidenceEl);
116
+ clearNode(runsEl);
117
+
118
+ if (!task) {
119
+ if (taskResult.status === 409) {
120
+ const candidates = Array.isArray(taskResult.body?.candidates)
121
+ ? taskResult.body.candidates
122
+ : [];
123
+ mountViewState(
124
+ metaEl,
125
+ "error",
126
+ `Task 身份歧义:${taskId} 同时属于多个 Feature,请选择 Feature 作用域入口。`,
127
+ );
128
+ if (candidates.length > 0) {
129
+ const list = el("div", "artifact-links");
130
+ for (const c of candidates) {
131
+ if (!c?.featureId || !c?.taskId) continue;
132
+ const path = `/feature/${encodeURIComponent(c.featureId)}/task/${encodeURIComponent(c.taskId)}`;
133
+ const a = el("a", "object-link", `${c.featureId}::${c.taskId}`);
134
+ a.href = `#${path}`;
135
+ a.addEventListener("click", (e) => {
136
+ e.preventDefault();
137
+ navigate(path);
138
+ });
139
+ list.appendChild(a);
140
+ list.appendChild(document.createTextNode(" "));
141
+ }
142
+ metaEl.appendChild(list);
143
+ }
144
+ } else {
145
+ mountViewState(metaEl, "error", `未找到 Task:${taskId}`);
146
+ }
147
+ mountRelationBar("task-relations", {}, snapshot);
148
+ return false;
149
+ }
150
+
151
+ metaEl.appendChild(
152
+ metaGrid([
153
+ ["Task ID", task.taskId],
154
+ ["状态", badge(task.status)],
155
+ [
156
+ "Feature",
157
+ task.featureId
158
+ ? objectRouteLink("feature", task.featureId, snapshot)
159
+ : el("span", "muted", "—"),
160
+ ],
161
+ ["更新时间", task.updatedAt ?? task.finishedAt ?? task.startedAt ?? "—"],
162
+ ["最新 worker run", task.workerRunId ?? "—"],
163
+ ["失败分类", task.failureCategory ?? "—"],
164
+ ["建议跟进", task.recommendedFollowUp ?? "—"],
165
+ [
166
+ "活性",
167
+ task.liveness ? (LIVENESS_LABELS[task.liveness] ?? task.liveness) : "—",
168
+ ],
169
+ ]),
170
+ );
171
+
172
+ const batchRunId = findBatchRunIdForTask(snapshot, task);
173
+ const dag = findDagForRun(snapshot, task.workerRunId, task);
174
+ mountRelationBar(
175
+ "task-relations",
176
+ {
177
+ featureId: task.featureId,
178
+ taskId: task.taskId,
179
+ batchRunId: batchRunId ?? undefined,
180
+ workerRunId: task.workerRunId,
181
+ dagRunId: dag?.dagRunId ?? task.dagRunId,
182
+ },
183
+ snapshot,
184
+ );
185
+ linksEl.appendChild(el("h3", "section-heading", "真实关联"));
186
+ const linkList = el("div", "artifact-links");
187
+ linkList.appendChild(objectRouteLink("run", task.workerRunId, snapshot));
188
+ linkList.appendChild(document.createTextNode(" · "));
189
+ linkList.appendChild(
190
+ batchRunId
191
+ ? objectRouteLink("batch", batchRunId, snapshot)
192
+ : el("span", "muted", "batch 缺失"),
193
+ );
194
+ linkList.appendChild(document.createTextNode(" · "));
195
+ linkList.appendChild(
196
+ dag
197
+ ? objectRouteLink("dag", dag.dagRunId, snapshot)
198
+ : task.dagRunId
199
+ ? el("span", "muted", task.dagRunId)
200
+ : el("span", "muted", "DAG 缺失"),
201
+ );
202
+ if (task.featureId) {
203
+ linkList.appendChild(document.createTextNode(" · "));
204
+ linkList.appendChild(objectRouteLink("feature", task.featureId, snapshot));
205
+ }
206
+ linksEl.appendChild(linkList);
207
+
208
+ evidenceEl.appendChild(el("h3", "section-heading", "失败证据"));
209
+ const r = task.artifactRefs ?? {};
210
+ const evidenceLinks = el("div", "artifact-links");
211
+ evidenceLinks.appendChild(artifactLink("报告", r.reportMarkdown));
212
+ evidenceLinks.appendChild(document.createTextNode(" "));
213
+ evidenceLinks.appendChild(artifactLink("诊断", r.doctorMarkdown));
214
+ evidenceLinks.appendChild(document.createTextNode(" "));
215
+ evidenceLinks.appendChild(artifactLink("收尾方案", r.closeoutDraft));
216
+ evidenceLinks.appendChild(document.createTextNode(" "));
217
+ evidenceLinks.appendChild(artifactLink("run 记录", r.runRecordPath));
218
+ if (
219
+ !r.reportMarkdown &&
220
+ !r.doctorMarkdown &&
221
+ !r.closeoutDraft &&
222
+ !r.runRecordPath
223
+ ) {
224
+ evidenceEl.appendChild(el("p", "empty", "暂无 allowlist 内的证据路径。"));
225
+ } else {
226
+ evidenceEl.appendChild(evidenceLinks);
227
+ }
228
+
229
+ runsEl.appendChild(el("h3", "section-heading", "运行历史"));
230
+ const runs = history?.runs ?? [];
231
+ if (runs.length === 0) {
232
+ mountViewState(runsEl, "empty", "暂无 ledger 运行记录。");
233
+ } else {
234
+ const rows = runs.map(taskRunHistoryRow);
235
+ runsEl.appendChild(
236
+ buildTable(
237
+ ["worker run", "状态", "时间", "batch", "retryOf", "失败分类"],
238
+ rows,
239
+ ),
240
+ );
241
+ if (history?.nextBefore) {
242
+ const more = el("button", "link-button", "加载更早的运行");
243
+ more.type = "button";
244
+ more.addEventListener("click", () => {
245
+ void loadOlderTaskRuns(featureId, taskId, history.nextBefore, runsEl);
246
+ });
247
+ runsEl.appendChild(more);
248
+ }
249
+ }
250
+
251
+ const active = ["running", "pending", "blocked", "stale"].includes(
252
+ (task.status ?? "").toLowerCase(),
253
+ );
254
+ return active;
255
+ }
256
+
257
+ export async function loadOlderTaskRuns(featureId, taskId, before, runsEl) {
258
+ if (runsEl === undefined) {
259
+ runsEl = before;
260
+ before = taskId;
261
+ taskId = featureId;
262
+ featureId = undefined;
263
+ }
264
+ const taskApi = featureId
265
+ ? `/api/features/${encodeURIComponent(featureId)}/tasks/${encodeURIComponent(taskId)}`
266
+ : `/api/tasks/${encodeURIComponent(taskId)}`;
267
+ const page = await fetchJson(
268
+ `${taskApi}/runs?limit=20&before=${encodeURIComponent(before)}`,
269
+ );
270
+ if (!page?.runs?.length) return;
271
+ const table = runsEl.querySelector("table");
272
+ if (!table) return;
273
+ const tbody = table.querySelector("tbody") || table;
274
+ for (const run of page.runs) {
275
+ const tr = document.createElement("tr");
276
+ for (const cell of taskRunHistoryRow(run).cells) {
277
+ const td = document.createElement("td");
278
+ if (cell instanceof Node) td.appendChild(cell);
279
+ else td.textContent = cell;
280
+ tr.appendChild(td);
281
+ }
282
+ tbody.appendChild(tr);
283
+ }
284
+ const btn = runsEl.querySelector("button.link-button");
285
+ if (btn) {
286
+ if (page.nextBefore) {
287
+ btn.onclick = () => {
288
+ void loadOlderTaskRuns(featureId, taskId, page.nextBefore, runsEl);
289
+ };
290
+ } else {
291
+ btn.remove();
292
+ }
293
+ }
294
+ }
295
+
296
+ export function startTaskPolling(featureId, taskId) {
297
+ if (taskId === undefined) {
298
+ taskId = featureId;
299
+ featureId = undefined;
300
+ }
301
+ if (uiState.taskPollTimer) clearTimeout(uiState.taskPollTimer);
302
+ const generation = ++uiState.pollingGeneration;
303
+ const poll = async () => {
304
+ const active = await renderTaskDetail(featureId, taskId);
305
+ if (generation !== uiState.pollingGeneration || !active) return;
306
+ const delay = detailPollDelay("running", isPageVisible());
307
+ if (delay == null) return;
308
+ uiState.taskPollTimer = setTimeout(() => {
309
+ uiState.taskPollTimer = null;
310
+ void poll();
311
+ }, delay);
312
+ };
313
+ void poll();
314
+ }