@tea-agent/loop-agent 0.13.0-beta.0 → 0.13.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 (282) hide show
  1. package/AGENTS.md +157 -155
  2. package/CHANGELOG.md +301 -322
  3. package/README.md +335 -345
  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 +597 -528
  8. package/dist/commands/loop-benchmark.js +11 -11
  9. package/dist/commands/pi-reuse-benchmark.js +16 -16
  10. package/dist/executors/shell-executor.js +200 -21
  11. package/dist/infrastructure/evaluation/candidate-store.js +5 -1
  12. package/dist/sidecars/cursor-prompt/executor.js +1 -1
  13. package/dist/task/runtime.js +27 -27
  14. package/dist/worker/observe/static/api.js +46 -46
  15. package/dist/worker/observe/static/app.js +150 -150
  16. package/dist/worker/observe/static/constants.js +148 -148
  17. package/dist/worker/observe/static/copy.js +67 -67
  18. package/dist/worker/observe/static/dag-helpers.js +172 -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 +212 -53
  23. package/dist/worker/observe/static/format-pool.js +67 -67
  24. package/dist/worker/observe/static/format.js +292 -292
  25. package/dist/worker/observe/static/index.html +308 -308
  26. package/dist/worker/observe/static/kpi.js +94 -94
  27. package/dist/worker/observe/static/relations.js +133 -133
  28. package/dist/worker/observe/static/router.js +93 -93
  29. package/dist/worker/observe/static/run-processing.js +148 -148
  30. package/dist/worker/observe/static/shell-chrome.js +68 -68
  31. package/dist/worker/observe/static/state.js +267 -253
  32. package/dist/worker/observe/static/styles.css +1902 -1902
  33. package/dist/worker/observe/static/views/batch.js +227 -227
  34. package/dist/worker/observe/static/views/dag-graph.js +172 -172
  35. package/dist/worker/observe/static/views/dag-inspector.js +627 -607
  36. package/dist/worker/observe/static/views/dag.js +371 -362
  37. package/dist/worker/observe/static/views/dashboard.js +509 -252
  38. package/dist/worker/observe/static/views/failures.js +143 -143
  39. package/dist/worker/observe/static/views/feature.js +492 -492
  40. package/dist/worker/observe/static/views/pool.js +350 -350
  41. package/dist/worker/observe/static/views/run.js +453 -453
  42. package/dist/worker/observe/static/views/session-timeline.js +219 -205
  43. package/dist/worker/observe/static/views/shell.js +7 -7
  44. package/dist/worker/observe/static/views/task.js +314 -314
  45. package/dist/worker/observe/static/views/timeline.js +163 -163
  46. package/dist/workflows/dag/backend-test-case-manifest.js +503 -0
  47. package/dist/workflows/dag/backend-test-execution-contract.js +353 -0
  48. package/dist/workflows/dag/backend-test-result-contract.js +568 -0
  49. package/dist/workflows/dag/canvas-observer.js +275 -275
  50. package/dist/workflows/dag/decision-envelope.js +57 -2
  51. package/dist/workflows/dag/frontend-implementation-contract.js +240 -0
  52. package/dist/workflows/dag/frontend-project-capability.js +309 -0
  53. package/dist/workflows/dag/frontend-repair.js +341 -0
  54. package/dist/workflows/dag/frontend-risk.js +161 -0
  55. package/dist/workflows/dag/frontend-verification-trace.js +190 -0
  56. package/dist/workflows/dag/init-hybrid.js +1020 -125
  57. package/dist/workflows/dag/repair-artifact.js +43 -3
  58. package/dist/workflows/dag/skill-instructions.js +4 -2
  59. package/dist/workflows/dag/types.js +29 -8
  60. package/docs/README.md +105 -104
  61. package/docs/agent-dag-recovery-playbook.md +195 -195
  62. package/docs/agent-dag-runner.md +67 -67
  63. package/docs/architecture/README.md +26 -26
  64. package/docs/architecture/dag-execution.md +140 -140
  65. package/docs/architecture/evolution.md +54 -54
  66. package/docs/architecture/facts-and-state.md +71 -71
  67. package/docs/architecture/runtime-boundaries.md +191 -191
  68. package/docs/architecture/system-overview.md +93 -93
  69. package/docs/architecture/worker-and-feature.md +85 -85
  70. package/docs/cursor-prompt-sidecar.md +36 -36
  71. package/docs/decisions/README.md +18 -18
  72. package/docs/design/README.md +167 -167
  73. package/docs/development-principles.md +73 -73
  74. package/docs/exec-plans/README.md +6 -6
  75. package/docs/exec-plans/active/README.md +1 -4
  76. package/docs/exec-plans/completed/README.md +106 -84
  77. package/docs/feature-workflow.md +414 -389
  78. package/docs/harness-methodology-debugging.md +153 -153
  79. package/docs/harness-methodology-tdd.md +130 -130
  80. package/docs/harness-methodology-verification.md +27 -27
  81. package/docs/init-surface.manifest.json +307 -289
  82. package/docs/loop-agent-harness.md +142 -142
  83. package/docs/production-readiness.md +96 -96
  84. package/docs/progress/README.md +76 -60
  85. package/docs/reports/README.md +150 -108
  86. package/docs/skills/README.md +7 -7
  87. package/docs/skills/vetted-skill-registry.md +29 -29
  88. package/docs/templates/adr.md +60 -60
  89. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  90. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  91. package/docs/templates/agent-dag-decision-gate-dogfood-report.md +117 -117
  92. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  93. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  94. package/docs/templates/agent-dag-report.schema.json +473 -473
  95. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  96. package/docs/templates/agent-dag.base.json +190 -190
  97. package/docs/templates/agent-dag.final-verification.json +185 -185
  98. package/docs/templates/agent-dag.schema.json +411 -411
  99. package/docs/templates/agent-dag.supervised-implementation.json +620 -501
  100. package/docs/templates/backend-test-analysis.schema.json +44 -44
  101. package/docs/templates/backend-test-case-manifest.schema.json +190 -0
  102. package/docs/templates/backend-test-dag.classify.prompt.md +75 -0
  103. package/docs/templates/backend-test-dag.generate-pytest.prompt.md +204 -202
  104. package/docs/templates/backend-test-dag.json +559 -311
  105. package/docs/templates/backend-test-dag.retrospect.prompt.md +139 -125
  106. package/docs/templates/backend-test-dag.review-cases.prompt.md +83 -81
  107. package/docs/templates/backend-test-execution.schema.json +133 -0
  108. package/docs/templates/backend-test-result.schema.json +99 -0
  109. package/docs/templates/branch-merge-report.md +93 -0
  110. package/docs/templates/exec-plan.md +64 -64
  111. package/docs/templates/feature-spec.md +53 -53
  112. package/docs/templates/frontend-design-contract.md +42 -42
  113. package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md +17 -0
  114. package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md +16 -0
  115. package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md +16 -0
  116. package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md +16 -0
  117. package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md +16 -0
  118. package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md +16 -0
  119. package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md +21 -0
  120. package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md +29 -0
  121. package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md +28 -0
  122. package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md +28 -0
  123. package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md +29 -0
  124. package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md +27 -0
  125. package/docs/templates/frontend-eval/fixtures/functional/06-ssr-server-client-boundary.md +28 -0
  126. package/docs/templates/frontend-eval/fixtures/functional/07-shared-public-component-api.md +28 -0
  127. package/docs/templates/frontend-eval/fixtures/functional/08-pure-local-no-remote.md +27 -0
  128. package/docs/templates/frontend-eval/metrics.md +138 -0
  129. package/docs/templates/frontend-eval/smoke-targets.md +53 -0
  130. package/docs/templates/frontend-implementation-contract.schema.json +27 -0
  131. package/docs/templates/frontend-task-constraints.md +35 -35
  132. package/docs/templates/frontend-task-requirement.md +70 -70
  133. package/docs/templates/frontend-test-dag.generate-cases.prompt.md +5 -5
  134. package/docs/templates/frontend-test-dag.json +23 -23
  135. package/docs/templates/frontend-test-dag.retrieve-context.prompt.md +3 -3
  136. package/docs/templates/frontend-test-dag.retrospect.prompt.md +3 -3
  137. package/docs/templates/frontend-test-dag.review-cases.prompt.md +3 -3
  138. package/docs/templates/frontend-test-dag.review-execution.prompt.md +3 -3
  139. package/docs/templates/harness.schema.json +221 -221
  140. package/docs/templates/hybrid-dag.json +188 -188
  141. package/docs/templates/init-evolution-review.md +35 -35
  142. package/docs/templates/interactive-ui-round2-experiment.md +66 -66
  143. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -118
  144. package/docs/templates/knowledge-sync-dag.json +178 -178
  145. package/docs/templates/knowledge-sync-draft.schema.json +71 -71
  146. package/docs/templates/product-line/AGENTS.md +8 -8
  147. package/docs/templates/product-line/README.md +9 -9
  148. package/docs/templates/product-line/acceptance.yaml +14 -14
  149. package/docs/templates/product-line/closeout.yaml +9 -9
  150. package/docs/templates/product-line/design.md +13 -13
  151. package/docs/templates/product-line/links.md +10 -10
  152. package/docs/templates/product-line/requirement.md +17 -17
  153. package/docs/templates/product-line/task-graph.yaml +15 -15
  154. package/docs/templates/product-line/task.yaml +64 -64
  155. package/docs/templates/product-line/test-plan.md +7 -7
  156. package/docs/templates/production-readiness-checklist.md +57 -57
  157. package/docs/templates/progress-log.md +17 -17
  158. package/docs/templates/project-start-checklist.md +9 -9
  159. package/docs/templates/qa-report.md +48 -48
  160. package/docs/templates/sprint-contract.md +29 -29
  161. package/docs/templates/worker-dogfood-evidence.md +80 -80
  162. package/docs/templates/worker-dogfood-setup.md +68 -68
  163. package/docs/verification-matrix.md +70 -70
  164. package/examples/decision-gate-agent-dag.json +177 -177
  165. package/examples/example-dag.json +46 -46
  166. package/examples/hybrid-loop-agent-dag.json +189 -189
  167. package/harness.json +66 -66
  168. package/package.json +52 -88
  169. package/scripts/check-product-line-docs.sh +29 -29
  170. package/scripts/check-task-pool-root.sh +32 -32
  171. package/scripts/kb-bootstrap-init-skeleton.sh +240 -240
  172. package/scripts/kb-graph-incremental-prepare.mjs +386 -386
  173. package/scripts/kb-graph-incremental-prepare.sh +5 -5
  174. package/scripts/kb-graph-materialize.mjs +105 -105
  175. package/scripts/kb-graph-materialize.sh +4 -4
  176. package/scripts/kb-graph-promote.mjs +164 -164
  177. package/scripts/kb-graph-promote.sh +4 -4
  178. package/scripts/kb-query.mjs +554 -554
  179. package/scripts/kb-query.sh +5 -5
  180. package/skills/agent-worker/SKILL.md +39 -39
  181. package/skills/agent-worker/references/agent-worker-operator.md +60 -60
  182. package/skills/ai-engineering-context/SKILL.md +48 -48
  183. package/skills/analyze-product-dependencies/SKILL.md +67 -67
  184. package/skills/analyze-product-dependencies/agents/openai.yaml +4 -4
  185. package/skills/analyze-product-dependencies/references/api-documentation-schema.md +30 -30
  186. package/skills/analyze-product-dependencies/references/dependency-analysis-schema.md +28 -28
  187. package/skills/analyze-product-dependencies/references/example.md +76 -76
  188. package/skills/analyze-product-dependencies/references/forward-test-cases.md +35 -35
  189. package/skills/analyze-product-dependencies/references/input-contract.md +11 -11
  190. package/skills/analyze-product-dependencies/references/scouting-rules.md +61 -61
  191. package/skills/analyze-product-dependencies/scripts/test-validators.mjs +267 -267
  192. package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +101 -101
  193. package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +142 -142
  194. package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +76 -76
  195. package/skills/analyze-product-dependencies/scripts/validation-helpers.mjs +146 -146
  196. package/skills/analyze-product-requirements/SKILL.md +90 -90
  197. package/skills/analyze-product-requirements/agents/openai.yaml +4 -4
  198. package/skills/analyze-product-requirements/references/acceptance-criteria.md +91 -91
  199. package/skills/analyze-product-requirements/references/clarification-and-knowledge.md +56 -56
  200. package/skills/analyze-product-requirements/references/example.md +86 -86
  201. package/skills/analyze-product-requirements/references/forward-test-cases.md +66 -66
  202. package/skills/analyze-product-requirements/references/product-analysis-schema.md +32 -32
  203. package/skills/analyze-product-requirements/references/product-requirement-schema.md +33 -33
  204. package/skills/analyze-product-requirements/references/requirement-clarification-schema.md +35 -35
  205. package/skills/analyze-product-requirements/scripts/test-validators.mjs +193 -193
  206. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +69 -69
  207. package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +97 -97
  208. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +98 -98
  209. package/skills/analyze-product-requirements/scripts/validation-helpers.mjs +156 -156
  210. package/skills/browser-tools/SKILL.md +196 -0
  211. package/skills/browser-tools/browser-content.js +103 -0
  212. package/skills/browser-tools/browser-cookies.js +35 -0
  213. package/skills/browser-tools/browser-eval.js +53 -0
  214. package/skills/browser-tools/browser-hn-scraper.js +108 -0
  215. package/skills/browser-tools/browser-nav.js +44 -0
  216. package/skills/browser-tools/browser-pick.js +162 -0
  217. package/skills/browser-tools/browser-screenshot.js +34 -0
  218. package/skills/browser-tools/browser-start.js +86 -0
  219. package/skills/browser-tools/package-lock.json +2556 -0
  220. package/skills/browser-tools/package.json +19 -0
  221. package/skills/code-review-core/SKILL.md +20 -20
  222. package/skills/codebase-scout/SKILL.md +19 -19
  223. package/skills/frontend-design-review/SKILL.md +66 -66
  224. package/skills/frontend-design-review/references/review-checklist.md +58 -58
  225. package/skills/frontend-implementation/SKILL.md +49 -47
  226. package/skills/frontend-implementation/references/code-standards.md +32 -32
  227. package/skills/frontend-implementation/references/design-spec.md +46 -46
  228. package/skills/frontend-implementation/references/node-contracts.md +27 -76
  229. package/skills/frontend-review/SKILL.md +59 -59
  230. package/skills/frontend-review/references/review-findings.md +47 -47
  231. package/skills/frontend-verification/SKILL.md +53 -53
  232. package/skills/frontend-verification/references/verification-checklist.md +68 -68
  233. package/skills/grill-me/SKILL.md +10 -10
  234. package/skills/grill-with-docs/SKILL.md +88 -88
  235. package/skills/grill-with-docs/adr-format.md +47 -47
  236. package/skills/grill-with-docs/context-format.md +60 -60
  237. package/skills/init-capability-evolution/SKILL.md +70 -70
  238. package/skills/loop-agent/SKILL.md +151 -151
  239. package/skills/loop-agent/references/README.md +67 -67
  240. package/skills/loop-agent/references/command-reference.md +527 -505
  241. package/skills/loop-agent/references/docs-converge.md +126 -126
  242. package/skills/loop-agent/references/harness-policy.md +263 -263
  243. package/skills/loop-agent/references/hybrid-dag.md +243 -238
  244. package/skills/loop-agent/references/learned/README.md +21 -21
  245. package/skills/loop-agent/references/long-running-loop.md +57 -57
  246. package/skills/loop-agent/references/model-routing.md +36 -36
  247. package/skills/loop-agent/references/multi-worktree.md +54 -54
  248. package/skills/loop-agent/references/one-shot-runs.md +85 -85
  249. package/skills/loop-agent/references/orchestrator-and-interventions.md +169 -169
  250. package/skills/loop-agent/references/pi-prompt.md +23 -23
  251. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
  252. package/skills/loop-agent/references/post-implementation-and-patterns.md +44 -44
  253. package/skills/loop-agent/references/task-workflow.md +89 -89
  254. package/skills/loop-agent/references/verification-and-failure-handling.md +141 -139
  255. package/skills/playwright-cli/SKILL.md +420 -420
  256. package/skills/playwright-cli/references/element-attributes.md +23 -23
  257. package/skills/playwright-cli/references/playwright-tests.md +39 -39
  258. package/skills/playwright-cli/references/request-mocking.md +87 -87
  259. package/skills/playwright-cli/references/running-code.md +241 -241
  260. package/skills/playwright-cli/references/session-management.md +225 -225
  261. package/skills/playwright-cli/references/storage-state.md +275 -275
  262. package/skills/playwright-cli/references/test-generation.md +433 -433
  263. package/skills/playwright-cli/references/tracing.md +139 -139
  264. package/skills/playwright-cli/references/video-recording.md +143 -143
  265. package/skills/playwright-cli-case-generator/SKILL.md +74 -74
  266. package/skills/requesting-code-review/SKILL.md +101 -101
  267. package/skills/requesting-code-review/code-reviewer.md +168 -168
  268. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  269. package/skills/systematic-debugging/SKILL.md +296 -296
  270. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  271. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  272. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  273. package/skills/systematic-debugging/find-polluter.sh +63 -63
  274. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  275. package/skills/systematic-debugging/test-academic.md +14 -14
  276. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  277. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  278. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  279. package/skills/test-driven-development/SKILL.md +20 -20
  280. package/skills/using-git-worktrees/SKILL.md +215 -215
  281. package/skills/verification-before-completion/SKILL.md +154 -154
  282. package/skills/webapp-testing/SKILL.md +19 -19
@@ -1,350 +1,350 @@
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
- artifactUrl,
42
- parseArtifactPreviewResponse,
43
- } from "../api.js";
44
- import {
45
- objectRouteLink,
46
- findFeatureInSnapshot,
47
- featureLookupState,
48
- buildObjectRelations,
49
- renderObjectRelationBar,
50
- } from "../relations.js";
51
- import { copyText, renderRecommendedCommand } from "../copy.js";
52
- import {
53
- isPageVisible,
54
- detailPollDelay,
55
- dashboardPollDelay,
56
- captureDagGraphViewportState,
57
- updateDagGraphViewportState,
58
- updateDagTimelineViewportState,
59
- renderViewState,
60
- mountViewState,
61
- } from "../state.js";
62
- import { uiState } from "../state.js";
63
- import {
64
- sortPoolTasks,
65
- matchesPoolStatusFilter,
66
- poolStatusCounts,
67
- } from "../format-pool.js";
68
- import {
69
- dagMetaVisibility,
70
- isDagRunActive,
71
- dashboardVisibleFeatures,
72
- findDagForRun,
73
- } from "../dag-model.js";
74
- import { layoutDag } from "../dag-layout.js";
75
- import { showView, setBreadcrumb, updateHeaderRefresh } from "../shell-chrome.js";
76
- import { renderProjectionFault } from "../kpi.js";
77
- import { mountBoundedEventTimeline } from "./timeline.js";
78
-
79
- export async function renderPool() {
80
- showView("pool");
81
- setBreadcrumb([
82
- { label: UI_TEXT.dashboard, href: "#/" },
83
- { label: "资源池" },
84
- ]);
85
-
86
- const faultEl = document.getElementById("pool-fault");
87
- const kpiEl = document.getElementById("pool-kpi");
88
- const emptyEl = document.getElementById("pool-empty");
89
- const listEl = document.getElementById("pool-tasks");
90
- const eventsEl = document.getElementById("pool-events");
91
- if (!faultEl || !kpiEl || !emptyEl || !listEl) return;
92
-
93
- mountViewState(faultEl, "loading", "加载资源池…");
94
- clearNode(kpiEl);
95
- clearNode(listEl);
96
- clearNode(emptyEl);
97
- emptyEl.hidden = true;
98
-
99
- const snapshot = await fetchJson("/api/snapshot");
100
- if (!snapshot) {
101
- clearNode(kpiEl);
102
- clearNode(listEl);
103
- clearNode(emptyEl);
104
- emptyEl.hidden = true;
105
- if (eventsEl) clearNode(eventsEl);
106
- mountViewState(faultEl, "error", "无法加载 snapshot。");
107
- return;
108
- }
109
- uiState.lastSnapshot = snapshot;
110
- updateHeaderRefresh(snapshot.generatedAt);
111
-
112
- clearNode(faultEl);
113
- if (snapshot.projectionError) {
114
- mountViewState(faultEl, "degraded", "投影降级:状态分布可能不完整。", {
115
- detail: snapshot.projectionError.message ?? null,
116
- });
117
- faultEl.appendChild(
118
- renderProjectionFault(snapshot.projectionError),
119
- );
120
- }
121
- if ((snapshot.projectionWarnings ?? []).length > 0) {
122
- const warn = el("div", "projection-fault");
123
- const body = el("div", "projection-fault-body");
124
- body.appendChild(el("p", "projection-fault-title", "投影警告"));
125
- body.appendChild(
126
- el(
127
- "p",
128
- "projection-fault-message",
129
- snapshot.projectionWarnings.join(";"),
130
- ),
131
- );
132
- warn.appendChild(body);
133
- faultEl.appendChild(warn);
134
- }
135
- if (snapshot.generatedAt) {
136
- faultEl.appendChild(
137
- el(
138
- "p",
139
- "muted pool-updated-at",
140
- `投影更新时间:${formatTs(snapshot.generatedAt)}(derived/advisory)`,
141
- ),
142
- );
143
- }
144
-
145
- const allTasks = sortPoolTasks(snapshot.tasks ?? []);
146
- const routeFilters = parseRoute().filters ?? {};
147
- const statusFilter = (routeFilters.status ?? "").toLowerCase();
148
- const qFilter = (routeFilters.q ?? "").trim().toLowerCase();
149
- const tasks = allTasks.filter((task) => {
150
- if (statusFilter && !matchesPoolStatusFilter(task.status, statusFilter)) {
151
- return false;
152
- }
153
- if (qFilter) {
154
- const hay =
155
- `${task.taskId ?? ""} ${task.featureId ?? ""} ${task.workerRunId ?? ""} ${task.failureCategory ?? ""}`.toLowerCase();
156
- if (!hay.includes(qFilter)) return false;
157
- }
158
- return true;
159
- });
160
- const poolPresent = snapshot.taskPool?.present === true;
161
- const projectionFailed = Boolean(snapshot.projectionError);
162
-
163
- // Shareable hash filters (REQ-R5-04)
164
- if (listEl) {
165
- let filtersEl = document.getElementById("pool-filters");
166
- if (!filtersEl) {
167
- filtersEl = el("div", "pool-filters");
168
- filtersEl.id = "pool-filters";
169
- listEl.parentElement?.insertBefore(filtersEl, listEl);
170
- }
171
- clearNode(filtersEl);
172
- const statusLabelEl = el("label", null);
173
- statusLabelEl.appendChild(document.createTextNode("状态"));
174
- const statusSelect = document.createElement("select");
175
- statusSelect.setAttribute("aria-label", "按状态筛选 Task");
176
- for (const [value, label] of [
177
- ["", "全部"],
178
- ["running", "运行中"],
179
- ["pending", "等待/排队"],
180
- ["blocked", "阻塞/失联"],
181
- ["failed", "失败"],
182
- ["succeeded", "成功/复用"],
183
- ]) {
184
- const opt = document.createElement("option");
185
- opt.value = value;
186
- opt.textContent = label;
187
- if (value === statusFilter) opt.selected = true;
188
- statusSelect.appendChild(opt);
189
- }
190
- statusLabelEl.appendChild(statusSelect);
191
- const qLabel = el("label", null);
192
- qLabel.appendChild(document.createTextNode("搜索"));
193
- const qInput = document.createElement("input");
194
- qInput.type = "search";
195
- qInput.placeholder = "Task / Feature / run…";
196
- qInput.setAttribute("aria-label", "搜索 Task");
197
- qInput.value = routeFilters.q ?? "";
198
- qLabel.appendChild(qInput);
199
- statusSelect.addEventListener("change", () => {
200
- const next = buildHashPath("/pool", {
201
- status: statusSelect.value || undefined,
202
- q: qInput.value.trim() || undefined,
203
- });
204
- navigate(next);
205
- });
206
- qInput.addEventListener("change", () => {
207
- const next = buildHashPath("/pool", {
208
- status: statusSelect.value || undefined,
209
- q: qInput.value.trim() || undefined,
210
- });
211
- navigate(next);
212
- });
213
- filtersEl.appendChild(statusLabelEl);
214
- filtersEl.appendChild(qLabel);
215
- filtersEl.appendChild(
216
- el("span", "muted layer-raw", `显示 ${tasks.length}/${allTasks.length}`),
217
- );
218
- }
219
-
220
- clearNode(kpiEl);
221
- clearNode(listEl);
222
- emptyEl.hidden = true;
223
- clearNode(emptyEl);
224
-
225
- if (projectionFailed) {
226
- // Fault-first: do not render healthy-looking zero KPIs when projection is broken.
227
- kpiEl.appendChild(
228
- el(
229
- "p",
230
- "empty",
231
- "投影失败,状态分布与健康 KPI 不可用(避免将未知显示为健康 0)。",
232
- ),
233
- );
234
- if (eventsEl) {
235
- await mountBoundedEventTimeline(
236
- eventsEl,
237
- "/api/events",
238
- "最近事件",
239
- );
240
- }
241
- return;
242
- }
243
-
244
- if (!poolPresent && tasks.length === 0) {
245
- emptyEl.hidden = false;
246
- mountViewState(
247
- emptyEl,
248
- "empty",
249
- "当前仓库未使用 Task Pool(未发现 .harness/task-pool)。",
250
- );
251
- if (eventsEl) {
252
- await mountBoundedEventTimeline(
253
- eventsEl,
254
- "/api/events",
255
- "最近事件",
256
- );
257
- }
258
- return;
259
- }
260
-
261
- if (poolPresent && tasks.length === 0) {
262
- emptyEl.hidden = false;
263
- mountViewState(emptyEl, "empty", "Task Pool 已存在,但当前没有 Task。");
264
- }
265
-
266
- const counts = poolStatusCounts(tasks);
267
- const cards = el("div", "kpi-grid");
268
- for (const [label, value] of [
269
- ["运行中", counts.running],
270
- ["等待/排队", counts.pending],
271
- ["阻塞/失联", counts.blocked],
272
- ["失败", counts.failed],
273
- ["成功/复用", counts.succeeded],
274
- ["其他", counts.other],
275
- ["合计", tasks.length],
276
- ]) {
277
- const card = el("div", "kpi-card");
278
- card.appendChild(el("div", "kpi-value", String(value)));
279
- card.appendChild(el("div", "kpi-label", label));
280
- cards.appendChild(card);
281
- }
282
- kpiEl.appendChild(el("h3", "section-heading", "状态分布"));
283
- kpiEl.appendChild(cards);
284
-
285
- if (tasks.length > 0) {
286
- const rows = tasks.map((task) => {
287
- const taskLink = document.createElement("a");
288
- const taskPath = task.featureId
289
- ? `/feature/${encodeURIComponent(task.featureId)}/task/${encodeURIComponent(task.taskId)}`
290
- : `/task/${encodeURIComponent(task.taskId)}`;
291
- taskLink.href = `#${taskPath}`;
292
- taskLink.textContent = task.taskId;
293
- taskLink.addEventListener("click", (e) => {
294
- e.preventDefault();
295
- navigate(taskPath);
296
- });
297
-
298
- let runCell = "—";
299
- if (task.workerRunId) {
300
- const a = document.createElement("a");
301
- a.href = `#/run/${encodeURIComponent(task.workerRunId)}`;
302
- a.textContent = task.workerRunId;
303
- a.addEventListener("click", (e) => {
304
- e.preventDefault();
305
- navigate(`#/run/${encodeURIComponent(task.workerRunId)}`);
306
- });
307
- runCell = a;
308
- }
309
-
310
- return {
311
- cells: [
312
- taskLink,
313
- task.featureId ?? "—",
314
- badge(task.status),
315
- runCell,
316
- formatAgo(task.updatedAt || task.finishedAt || task.startedAt),
317
- task.failureCategory ?? "—",
318
- ],
319
- };
320
- });
321
- listEl.appendChild(
322
- buildTable(
323
- ["Task", "Feature", "状态", "最新 worker run", "更新时间", "失败分类"],
324
- rows,
325
- ),
326
- );
327
- }
328
-
329
- if (eventsEl) {
330
- await mountBoundedEventTimeline(
331
- eventsEl,
332
- "/api/events",
333
- "最近事件",
334
- );
335
- }
336
- }
337
-
338
- export function startPoolPolling() {
339
- if (uiState.poolTimer) clearTimeout(uiState.poolTimer);
340
- const generation = ++uiState.pollingGeneration;
341
- const poll = async () => {
342
- await renderPool();
343
- if (generation !== uiState.pollingGeneration) return;
344
- uiState.poolTimer = setTimeout(() => {
345
- uiState.poolTimer = null;
346
- void poll();
347
- }, dashboardPollDelay());
348
- };
349
- void poll();
350
- }
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
+ artifactUrl,
42
+ parseArtifactPreviewResponse,
43
+ } from "../api.js";
44
+ import {
45
+ objectRouteLink,
46
+ findFeatureInSnapshot,
47
+ featureLookupState,
48
+ buildObjectRelations,
49
+ renderObjectRelationBar,
50
+ } from "../relations.js";
51
+ import { copyText, renderRecommendedCommand } from "../copy.js";
52
+ import {
53
+ isPageVisible,
54
+ detailPollDelay,
55
+ dashboardPollDelay,
56
+ captureDagGraphViewportState,
57
+ updateDagGraphViewportState,
58
+ updateDagTimelineViewportState,
59
+ renderViewState,
60
+ mountViewState,
61
+ } from "../state.js";
62
+ import { uiState } from "../state.js";
63
+ import {
64
+ sortPoolTasks,
65
+ matchesPoolStatusFilter,
66
+ poolStatusCounts,
67
+ } from "../format-pool.js";
68
+ import {
69
+ dagMetaVisibility,
70
+ isDagRunActive,
71
+ dashboardVisibleFeatures,
72
+ findDagForRun,
73
+ } from "../dag-model.js";
74
+ import { layoutDag } from "../dag-layout.js";
75
+ import { showView, setBreadcrumb, updateHeaderRefresh } from "../shell-chrome.js";
76
+ import { renderProjectionFault } from "../kpi.js";
77
+ import { mountBoundedEventTimeline } from "./timeline.js";
78
+
79
+ export async function renderPool() {
80
+ showView("pool");
81
+ setBreadcrumb([
82
+ { label: UI_TEXT.dashboard, href: "#/" },
83
+ { label: "资源池" },
84
+ ]);
85
+
86
+ const faultEl = document.getElementById("pool-fault");
87
+ const kpiEl = document.getElementById("pool-kpi");
88
+ const emptyEl = document.getElementById("pool-empty");
89
+ const listEl = document.getElementById("pool-tasks");
90
+ const eventsEl = document.getElementById("pool-events");
91
+ if (!faultEl || !kpiEl || !emptyEl || !listEl) return;
92
+
93
+ mountViewState(faultEl, "loading", "加载资源池…");
94
+ clearNode(kpiEl);
95
+ clearNode(listEl);
96
+ clearNode(emptyEl);
97
+ emptyEl.hidden = true;
98
+
99
+ const snapshot = await fetchJson("/api/snapshot");
100
+ if (!snapshot) {
101
+ clearNode(kpiEl);
102
+ clearNode(listEl);
103
+ clearNode(emptyEl);
104
+ emptyEl.hidden = true;
105
+ if (eventsEl) clearNode(eventsEl);
106
+ mountViewState(faultEl, "error", "无法加载 snapshot。");
107
+ return;
108
+ }
109
+ uiState.lastSnapshot = snapshot;
110
+ updateHeaderRefresh(snapshot.generatedAt);
111
+
112
+ clearNode(faultEl);
113
+ if (snapshot.projectionError) {
114
+ mountViewState(faultEl, "degraded", "投影降级:状态分布可能不完整。", {
115
+ detail: snapshot.projectionError.message ?? null,
116
+ });
117
+ faultEl.appendChild(
118
+ renderProjectionFault(snapshot.projectionError),
119
+ );
120
+ }
121
+ if ((snapshot.projectionWarnings ?? []).length > 0) {
122
+ const warn = el("div", "projection-fault");
123
+ const body = el("div", "projection-fault-body");
124
+ body.appendChild(el("p", "projection-fault-title", "投影警告"));
125
+ body.appendChild(
126
+ el(
127
+ "p",
128
+ "projection-fault-message",
129
+ snapshot.projectionWarnings.join(";"),
130
+ ),
131
+ );
132
+ warn.appendChild(body);
133
+ faultEl.appendChild(warn);
134
+ }
135
+ if (snapshot.generatedAt) {
136
+ faultEl.appendChild(
137
+ el(
138
+ "p",
139
+ "muted pool-updated-at",
140
+ `投影更新时间:${formatTs(snapshot.generatedAt)}(derived/advisory)`,
141
+ ),
142
+ );
143
+ }
144
+
145
+ const allTasks = sortPoolTasks(snapshot.tasks ?? []);
146
+ const routeFilters = parseRoute().filters ?? {};
147
+ const statusFilter = (routeFilters.status ?? "").toLowerCase();
148
+ const qFilter = (routeFilters.q ?? "").trim().toLowerCase();
149
+ const tasks = allTasks.filter((task) => {
150
+ if (statusFilter && !matchesPoolStatusFilter(task.status, statusFilter)) {
151
+ return false;
152
+ }
153
+ if (qFilter) {
154
+ const hay =
155
+ `${task.taskId ?? ""} ${task.featureId ?? ""} ${task.workerRunId ?? ""} ${task.failureCategory ?? ""}`.toLowerCase();
156
+ if (!hay.includes(qFilter)) return false;
157
+ }
158
+ return true;
159
+ });
160
+ const poolPresent = snapshot.taskPool?.present === true;
161
+ const projectionFailed = Boolean(snapshot.projectionError);
162
+
163
+ // Shareable hash filters (REQ-R5-04)
164
+ if (listEl) {
165
+ let filtersEl = document.getElementById("pool-filters");
166
+ if (!filtersEl) {
167
+ filtersEl = el("div", "pool-filters");
168
+ filtersEl.id = "pool-filters";
169
+ listEl.parentElement?.insertBefore(filtersEl, listEl);
170
+ }
171
+ clearNode(filtersEl);
172
+ const statusLabelEl = el("label", null);
173
+ statusLabelEl.appendChild(document.createTextNode("状态"));
174
+ const statusSelect = document.createElement("select");
175
+ statusSelect.setAttribute("aria-label", "按状态筛选 Task");
176
+ for (const [value, label] of [
177
+ ["", "全部"],
178
+ ["running", "运行中"],
179
+ ["pending", "等待/排队"],
180
+ ["blocked", "阻塞/失联"],
181
+ ["failed", "失败"],
182
+ ["succeeded", "成功/复用"],
183
+ ]) {
184
+ const opt = document.createElement("option");
185
+ opt.value = value;
186
+ opt.textContent = label;
187
+ if (value === statusFilter) opt.selected = true;
188
+ statusSelect.appendChild(opt);
189
+ }
190
+ statusLabelEl.appendChild(statusSelect);
191
+ const qLabel = el("label", null);
192
+ qLabel.appendChild(document.createTextNode("搜索"));
193
+ const qInput = document.createElement("input");
194
+ qInput.type = "search";
195
+ qInput.placeholder = "Task / Feature / run…";
196
+ qInput.setAttribute("aria-label", "搜索 Task");
197
+ qInput.value = routeFilters.q ?? "";
198
+ qLabel.appendChild(qInput);
199
+ statusSelect.addEventListener("change", () => {
200
+ const next = buildHashPath("/pool", {
201
+ status: statusSelect.value || undefined,
202
+ q: qInput.value.trim() || undefined,
203
+ });
204
+ navigate(next);
205
+ });
206
+ qInput.addEventListener("change", () => {
207
+ const next = buildHashPath("/pool", {
208
+ status: statusSelect.value || undefined,
209
+ q: qInput.value.trim() || undefined,
210
+ });
211
+ navigate(next);
212
+ });
213
+ filtersEl.appendChild(statusLabelEl);
214
+ filtersEl.appendChild(qLabel);
215
+ filtersEl.appendChild(
216
+ el("span", "muted layer-raw", `显示 ${tasks.length}/${allTasks.length}`),
217
+ );
218
+ }
219
+
220
+ clearNode(kpiEl);
221
+ clearNode(listEl);
222
+ emptyEl.hidden = true;
223
+ clearNode(emptyEl);
224
+
225
+ if (projectionFailed) {
226
+ // Fault-first: do not render healthy-looking zero KPIs when projection is broken.
227
+ kpiEl.appendChild(
228
+ el(
229
+ "p",
230
+ "empty",
231
+ "投影失败,状态分布与健康 KPI 不可用(避免将未知显示为健康 0)。",
232
+ ),
233
+ );
234
+ if (eventsEl) {
235
+ await mountBoundedEventTimeline(
236
+ eventsEl,
237
+ "/api/events",
238
+ "最近事件",
239
+ );
240
+ }
241
+ return;
242
+ }
243
+
244
+ if (!poolPresent && tasks.length === 0) {
245
+ emptyEl.hidden = false;
246
+ mountViewState(
247
+ emptyEl,
248
+ "empty",
249
+ "当前仓库未使用 Task Pool(未发现 .harness/task-pool)。",
250
+ );
251
+ if (eventsEl) {
252
+ await mountBoundedEventTimeline(
253
+ eventsEl,
254
+ "/api/events",
255
+ "最近事件",
256
+ );
257
+ }
258
+ return;
259
+ }
260
+
261
+ if (poolPresent && tasks.length === 0) {
262
+ emptyEl.hidden = false;
263
+ mountViewState(emptyEl, "empty", "Task Pool 已存在,但当前没有 Task。");
264
+ }
265
+
266
+ const counts = poolStatusCounts(tasks);
267
+ const cards = el("div", "kpi-grid");
268
+ for (const [label, value] of [
269
+ ["运行中", counts.running],
270
+ ["等待/排队", counts.pending],
271
+ ["阻塞/失联", counts.blocked],
272
+ ["失败", counts.failed],
273
+ ["成功/复用", counts.succeeded],
274
+ ["其他", counts.other],
275
+ ["合计", tasks.length],
276
+ ]) {
277
+ const card = el("div", "kpi-card");
278
+ card.appendChild(el("div", "kpi-value", String(value)));
279
+ card.appendChild(el("div", "kpi-label", label));
280
+ cards.appendChild(card);
281
+ }
282
+ kpiEl.appendChild(el("h3", "section-heading", "状态分布"));
283
+ kpiEl.appendChild(cards);
284
+
285
+ if (tasks.length > 0) {
286
+ const rows = tasks.map((task) => {
287
+ const taskLink = document.createElement("a");
288
+ const taskPath = task.featureId
289
+ ? `/feature/${encodeURIComponent(task.featureId)}/task/${encodeURIComponent(task.taskId)}`
290
+ : `/task/${encodeURIComponent(task.taskId)}`;
291
+ taskLink.href = `#${taskPath}`;
292
+ taskLink.textContent = task.taskId;
293
+ taskLink.addEventListener("click", (e) => {
294
+ e.preventDefault();
295
+ navigate(taskPath);
296
+ });
297
+
298
+ let runCell = "—";
299
+ if (task.workerRunId) {
300
+ const a = document.createElement("a");
301
+ a.href = `#/run/${encodeURIComponent(task.workerRunId)}`;
302
+ a.textContent = task.workerRunId;
303
+ a.addEventListener("click", (e) => {
304
+ e.preventDefault();
305
+ navigate(`#/run/${encodeURIComponent(task.workerRunId)}`);
306
+ });
307
+ runCell = a;
308
+ }
309
+
310
+ return {
311
+ cells: [
312
+ taskLink,
313
+ task.featureId ?? "—",
314
+ badge(task.status),
315
+ runCell,
316
+ formatAgo(task.updatedAt || task.finishedAt || task.startedAt),
317
+ task.failureCategory ?? "—",
318
+ ],
319
+ };
320
+ });
321
+ listEl.appendChild(
322
+ buildTable(
323
+ ["Task", "Feature", "状态", "最新 worker run", "更新时间", "失败分类"],
324
+ rows,
325
+ ),
326
+ );
327
+ }
328
+
329
+ if (eventsEl) {
330
+ await mountBoundedEventTimeline(
331
+ eventsEl,
332
+ "/api/events",
333
+ "最近事件",
334
+ );
335
+ }
336
+ }
337
+
338
+ export function startPoolPolling() {
339
+ if (uiState.poolTimer) clearTimeout(uiState.poolTimer);
340
+ const generation = ++uiState.pollingGeneration;
341
+ const poll = async () => {
342
+ await renderPool();
343
+ if (generation !== uiState.pollingGeneration) return;
344
+ uiState.poolTimer = setTimeout(() => {
345
+ uiState.poolTimer = null;
346
+ void poll();
347
+ }, dashboardPollDelay());
348
+ };
349
+ void poll();
350
+ }