@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,94 +1,94 @@
1
- /** KPI cards, repo banner, projection fault, artifact/inbox links. */
2
- import { UI_TEXT } from "./constants.js";
3
- import { clearNode, el } from "./dom.js";
4
- import { repoBaseName } from "./format.js";
5
- import { navigate } from "./router.js";
6
-
7
- export function failuresInboxLink(count) {
8
- const wrap = el("span");
9
- wrap.appendChild(document.createTextNode(`${count} `));
10
- const a = el("a", "inbox-link", `${UI_TEXT.failureInbox} →`);
11
- a.href = "#/failures";
12
- a.addEventListener("click", (e) => {
13
- e.preventDefault();
14
- navigate("/failures");
15
- });
16
- wrap.appendChild(a);
17
- return wrap;
18
- }
19
-
20
- export function artifactLink(label, refPath) {
21
- if (!refPath) return el("span", "muted", "—");
22
- const a = el("a", "artifact-link", label);
23
- a.href = `/api/artifacts?path=${encodeURIComponent(refPath)}&tail=200`;
24
- a.target = "_blank";
25
- return a;
26
- }
27
-
28
- let kpiHelpSeed = 0;
29
- export function kpiCard(label, value, extraClass, helpText) {
30
- const card = el("div", `kpi-card${extraClass ? ` ${extraClass}` : ""}`);
31
- card.appendChild(el("div", "kpi-label", label));
32
- const valueWrap = el("div", "kpi-value-row");
33
- const valueEl = el("div", "kpi-value");
34
- if (value instanceof Node) valueEl.appendChild(value);
35
- else valueEl.textContent = String(value);
36
- valueWrap.appendChild(valueEl);
37
- if (helpText) {
38
- kpiHelpSeed += 1;
39
- const tipId = `kpi-tip-${kpiHelpSeed}`;
40
- const helpBtn = el("button", "kpi-help");
41
- helpBtn.type = "button";
42
- helpBtn.setAttribute("aria-describedby", tipId);
43
- helpBtn.setAttribute("aria-label", `${label} 指标说明`);
44
- const icon = el("i", "ri-question-line");
45
- icon.setAttribute("aria-hidden", "true");
46
- helpBtn.appendChild(icon);
47
- const tip = el("span", "kpi-tip");
48
- tip.id = tipId;
49
- tip.setAttribute("role", "tooltip");
50
- tip.textContent = helpText;
51
- valueWrap.appendChild(helpBtn);
52
- valueWrap.appendChild(tip);
53
- }
54
- card.appendChild(valueWrap);
55
- return card;
56
- }
57
-
58
- export function renderRepoBanner(repoEl, snapshot) {
59
- if (!repoEl) return;
60
- clearNode(repoEl);
61
- const repoRoot = snapshot.repoRoot ?? "";
62
- const icon = el("i", "ri-git-repository-line");
63
- icon.setAttribute("aria-hidden", "true");
64
- repoEl.appendChild(icon);
65
- const text = el("div", "repo-banner-text");
66
- text.appendChild(el("span", "repo-banner-name", repoBaseName(repoRoot)));
67
- const pathLine = el("span", "repo-banner-path", repoRoot || "路径未知");
68
- pathLine.title = repoRoot || "";
69
- text.appendChild(pathLine);
70
- repoEl.appendChild(text);
71
- }
72
-
73
- export function renderProjectionFault(error) {
74
- const banner = el("div", "projection-fault");
75
- banner.setAttribute("role", "alert");
76
- const icon = el("i", "ri-error-warning-line");
77
- icon.setAttribute("aria-hidden", "true");
78
- banner.appendChild(icon);
79
- const body = el("div", "projection-fault-body");
80
- body.appendChild(
81
- el("p", "projection-fault-title", "指标暂不可用:数据投影失败。"),
82
- );
83
- body.appendChild(
84
- el(
85
- "p",
86
- "projection-fault-message",
87
- error.message ?? "投影失败 (projection failed)",
88
- ),
89
- );
90
- if (error.at)
91
- body.appendChild(el("p", "projection-fault-at", `发生时间:${error.at}`));
92
- banner.appendChild(body);
93
- return banner;
94
- }
1
+ /** KPI cards, repo banner, projection fault, artifact/inbox links. */
2
+ import { UI_TEXT } from "./constants.js";
3
+ import { clearNode, el } from "./dom.js";
4
+ import { repoBaseName } from "./format.js";
5
+ import { navigate } from "./router.js";
6
+
7
+ export function failuresInboxLink(count) {
8
+ const wrap = el("span");
9
+ wrap.appendChild(document.createTextNode(`${count} `));
10
+ const a = el("a", "inbox-link", `${UI_TEXT.failureInbox} →`);
11
+ a.href = "#/failures";
12
+ a.addEventListener("click", (e) => {
13
+ e.preventDefault();
14
+ navigate("/failures");
15
+ });
16
+ wrap.appendChild(a);
17
+ return wrap;
18
+ }
19
+
20
+ export function artifactLink(label, refPath) {
21
+ if (!refPath) return el("span", "muted", "—");
22
+ const a = el("a", "artifact-link", label);
23
+ a.href = `/api/artifacts?path=${encodeURIComponent(refPath)}&tail=200`;
24
+ a.target = "_blank";
25
+ return a;
26
+ }
27
+
28
+ let kpiHelpSeed = 0;
29
+ export function kpiCard(label, value, extraClass, helpText) {
30
+ const card = el("div", `kpi-card${extraClass ? ` ${extraClass}` : ""}`);
31
+ card.appendChild(el("div", "kpi-label", label));
32
+ const valueWrap = el("div", "kpi-value-row");
33
+ const valueEl = el("div", "kpi-value");
34
+ if (value instanceof Node) valueEl.appendChild(value);
35
+ else valueEl.textContent = String(value);
36
+ valueWrap.appendChild(valueEl);
37
+ if (helpText) {
38
+ kpiHelpSeed += 1;
39
+ const tipId = `kpi-tip-${kpiHelpSeed}`;
40
+ const helpBtn = el("button", "kpi-help");
41
+ helpBtn.type = "button";
42
+ helpBtn.setAttribute("aria-describedby", tipId);
43
+ helpBtn.setAttribute("aria-label", `${label} 指标说明`);
44
+ const icon = el("i", "ri-question-line");
45
+ icon.setAttribute("aria-hidden", "true");
46
+ helpBtn.appendChild(icon);
47
+ const tip = el("span", "kpi-tip");
48
+ tip.id = tipId;
49
+ tip.setAttribute("role", "tooltip");
50
+ tip.textContent = helpText;
51
+ valueWrap.appendChild(helpBtn);
52
+ valueWrap.appendChild(tip);
53
+ }
54
+ card.appendChild(valueWrap);
55
+ return card;
56
+ }
57
+
58
+ export function renderRepoBanner(repoEl, snapshot) {
59
+ if (!repoEl) return;
60
+ clearNode(repoEl);
61
+ const repoRoot = snapshot.repoRoot ?? "";
62
+ const icon = el("i", "ri-git-repository-line");
63
+ icon.setAttribute("aria-hidden", "true");
64
+ repoEl.appendChild(icon);
65
+ const text = el("div", "repo-banner-text");
66
+ text.appendChild(el("span", "repo-banner-name", repoBaseName(repoRoot)));
67
+ const pathLine = el("span", "repo-banner-path", repoRoot || "路径未知");
68
+ pathLine.title = repoRoot || "";
69
+ text.appendChild(pathLine);
70
+ repoEl.appendChild(text);
71
+ }
72
+
73
+ export function renderProjectionFault(error) {
74
+ const banner = el("div", "projection-fault");
75
+ banner.setAttribute("role", "alert");
76
+ const icon = el("i", "ri-error-warning-line");
77
+ icon.setAttribute("aria-hidden", "true");
78
+ banner.appendChild(icon);
79
+ const body = el("div", "projection-fault-body");
80
+ body.appendChild(
81
+ el("p", "projection-fault-title", "指标暂不可用:数据投影失败。"),
82
+ );
83
+ body.appendChild(
84
+ el(
85
+ "p",
86
+ "projection-fault-message",
87
+ error.message ?? "投影失败 (projection failed)",
88
+ ),
89
+ );
90
+ if (error.at)
91
+ body.appendChild(el("p", "projection-fault-at", `发生时间:${error.at}`));
92
+ banner.appendChild(body);
93
+ return banner;
94
+ }
@@ -1,128 +1,133 @@
1
- /** Object relation navigation (Observe UI R5). */
2
- import { el } from "./dom.js";
3
- import { navigate } from "./router.js";
4
-
5
- export function objectExistsInSnapshot(kind, id, snapshot) {
6
- if (!id) return false;
7
- if (kind === "feature") {
8
- return (snapshot?.features ?? []).some((f) => f.featureId === id);
9
- }
10
- if (kind === "task") {
11
- return (snapshot?.tasks ?? []).some((t) => t.taskId === id);
12
- }
13
- if (kind === "batch") {
14
- return (snapshot?.batches ?? []).some((b) => b.batchRunId === id);
15
- }
16
- if (kind === "run") {
17
- return (
18
- (snapshot?.tasks ?? []).some((t) => t.workerRunId === id) ||
19
- (snapshot?.batches ?? []).some((b) =>
20
- (b.tasks ?? []).some((t) => t.workerRunId === id),
21
- )
22
- );
23
- }
24
- if (kind === "dag") {
25
- return (snapshot?.dagRuns ?? []).some((d) => d.dagRunId === id);
26
- }
27
- return false;
28
- }
29
-
30
- export function objectRoutePath(kind, id) {
31
- if (kind === "feature") return `/feature/${encodeURIComponent(id)}`;
32
- if (kind === "task") return `/task/${encodeURIComponent(id)}`;
33
- if (kind === "batch") return `/batch/${encodeURIComponent(id)}`;
34
- if (kind === "run") return `/run/${encodeURIComponent(id)}`;
35
- if (kind === "dag") return `/dag/${encodeURIComponent(id)}`;
36
- return "/";
37
- }
38
-
39
- /** Hash-route link only when id is present and snapshot contains the object. */
40
- export function objectRouteLink(kind, id, snapshot) {
41
- if (!id) return el("span", "muted", "缺失");
42
- const exists = objectExistsInSnapshot(kind, id, snapshot);
43
- if (!exists) return el("span", "muted", id);
44
- const path = objectRoutePath(kind, id);
45
- const a = el("a", "object-link", id);
46
- a.href = `#${path}`;
47
- a.addEventListener("click", (e) => {
48
- e.preventDefault();
49
- e.stopPropagation();
50
- navigate(path);
51
- });
52
- return a;
53
- }
54
-
55
- export function findFeatureInSnapshot(snapshot, featureId) {
56
- if (!featureId) return undefined;
57
- return (snapshot?.features ?? []).find((f) => f.featureId === featureId);
58
- }
59
-
60
- export function featureLookupState(snapshot, featureId) {
61
- if (!snapshot) return { kind: "unavailable" };
62
- const feature = findFeatureInSnapshot(snapshot, featureId);
63
- return feature ? { kind: "found", feature } : { kind: "missing" };
64
- }
65
-
66
- export const RELATION_KIND_ORDER = ["feature", "task", "batch", "run", "dag"];
67
- export const RELATION_LABELS = {
68
- feature: "Feature",
69
- task: "Task",
70
- batch: "Batch",
71
- run: "Run",
72
- dag: "DAG",
73
- };
74
-
75
- /**
76
- * Build proven relation descriptors only (id present AND object in snapshot).
77
- * Never infers links from identifier naming.
78
- */
79
- export function buildObjectRelations(ids, snapshot) {
80
- const input = ids ?? {};
81
- const candidates = [
82
- { kind: "feature", id: input.featureId },
83
- { kind: "task", id: input.taskId },
84
- { kind: "batch", id: input.batchRunId },
85
- { kind: "run", id: input.workerRunId },
86
- { kind: "dag", id: input.dagRunId },
87
- ];
88
- const out = [];
89
- for (const kind of RELATION_KIND_ORDER) {
90
- const entry = candidates.find((c) => c.kind === kind);
91
- if (!entry?.id) continue;
92
- if (!objectExistsInSnapshot(kind, entry.id, snapshot)) continue;
93
- out.push({
94
- kind,
95
- id: entry.id,
96
- label: RELATION_LABELS[kind] ?? kind,
97
- href: `#${objectRoutePath(kind, entry.id)}`,
98
- path: objectRoutePath(kind, entry.id),
99
- });
100
- }
101
- return out;
102
- }
103
-
104
- export function renderObjectRelationBar(relations, snapshot) {
105
- const bar = el("div", "object-relation-bar");
106
- bar.setAttribute("aria-label", "对象关联");
107
- const list = Array.isArray(relations)
108
- ? relations
109
- : buildObjectRelations(relations, snapshot);
110
- if (list.length === 0) {
111
- bar.appendChild(el("span", "muted", "暂无已证明的对象关联"));
112
- return bar;
113
- }
114
- list.forEach((rel, i) => {
115
- if (i > 0) bar.appendChild(el("span", "object-relation-sep", "→"));
116
- const item = el("span", "object-relation-item");
117
- item.appendChild(el("span", "object-relation-label", rel.label));
118
- item.appendChild(document.createTextNode(" "));
119
- if (rel.href && rel.id) {
120
- item.appendChild(objectRouteLink(rel.kind, rel.id, snapshot));
121
- } else {
122
- item.appendChild(el("span", "muted", rel.id ?? "缺失"));
123
- }
124
- bar.appendChild(item);
125
- });
126
- return bar;
127
- }
128
-
1
+ /** Object relation navigation (Observe UI R5). */
2
+ import { el } from "./dom.js";
3
+ import { navigate } from "./router.js";
4
+
5
+ export function objectExistsInSnapshot(kind, id, snapshot, featureId) {
6
+ if (!id) return false;
7
+ if (kind === "feature") {
8
+ return (snapshot?.features ?? []).some((f) => f.featureId === id);
9
+ }
10
+ if (kind === "task") {
11
+ return (snapshot?.tasks ?? []).some(
12
+ (t) => t.taskId === id && (!featureId || t.featureId === featureId),
13
+ );
14
+ }
15
+ if (kind === "batch") {
16
+ return (snapshot?.batches ?? []).some((b) => b.batchRunId === id);
17
+ }
18
+ if (kind === "run") {
19
+ return (
20
+ (snapshot?.tasks ?? []).some((t) => t.workerRunId === id) ||
21
+ (snapshot?.batches ?? []).some((b) =>
22
+ (b.tasks ?? []).some((t) => t.workerRunId === id),
23
+ )
24
+ );
25
+ }
26
+ if (kind === "dag") {
27
+ return (snapshot?.dagRuns ?? []).some((d) => d.dagRunId === id);
28
+ }
29
+ return false;
30
+ }
31
+
32
+ export function objectRoutePath(kind, id, featureId) {
33
+ if (kind === "feature") return `/feature/${encodeURIComponent(id)}`;
34
+ if (kind === "task" && featureId) {
35
+ return `/feature/${encodeURIComponent(featureId)}/task/${encodeURIComponent(id)}`;
36
+ }
37
+ if (kind === "task") return `/task/${encodeURIComponent(id)}`;
38
+ if (kind === "batch") return `/batch/${encodeURIComponent(id)}`;
39
+ if (kind === "run") return `/run/${encodeURIComponent(id)}`;
40
+ if (kind === "dag") return `/dag/${encodeURIComponent(id)}`;
41
+ return "/";
42
+ }
43
+
44
+ /** Hash-route link only when id is present and snapshot contains the object. */
45
+ export function objectRouteLink(kind, id, snapshot, featureId) {
46
+ if (!id) return el("span", "muted", "缺失");
47
+ const exists = objectExistsInSnapshot(kind, id, snapshot, featureId);
48
+ if (!exists) return el("span", "muted", id);
49
+ const path = objectRoutePath(kind, id, featureId);
50
+ const a = el("a", "object-link", id);
51
+ a.href = `#${path}`;
52
+ a.addEventListener("click", (e) => {
53
+ e.preventDefault();
54
+ e.stopPropagation();
55
+ navigate(path);
56
+ });
57
+ return a;
58
+ }
59
+
60
+ export function findFeatureInSnapshot(snapshot, featureId) {
61
+ if (!featureId) return undefined;
62
+ return (snapshot?.features ?? []).find((f) => f.featureId === featureId);
63
+ }
64
+
65
+ export function featureLookupState(snapshot, featureId) {
66
+ if (!snapshot) return { kind: "unavailable" };
67
+ const feature = findFeatureInSnapshot(snapshot, featureId);
68
+ return feature ? { kind: "found", feature } : { kind: "missing" };
69
+ }
70
+
71
+ export const RELATION_KIND_ORDER = ["feature", "task", "batch", "run", "dag"];
72
+ export const RELATION_LABELS = {
73
+ feature: "Feature",
74
+ task: "Task",
75
+ batch: "Batch",
76
+ run: "Run",
77
+ dag: "DAG",
78
+ };
79
+
80
+ /**
81
+ * Build proven relation descriptors only (id present AND object in snapshot).
82
+ * Never infers links from identifier naming.
83
+ */
84
+ export function buildObjectRelations(ids, snapshot) {
85
+ const input = ids ?? {};
86
+ const candidates = [
87
+ { kind: "feature", id: input.featureId },
88
+ { kind: "task", id: input.taskId, featureId: input.featureId },
89
+ { kind: "batch", id: input.batchRunId },
90
+ { kind: "run", id: input.workerRunId },
91
+ { kind: "dag", id: input.dagRunId },
92
+ ];
93
+ const out = [];
94
+ for (const kind of RELATION_KIND_ORDER) {
95
+ const entry = candidates.find((c) => c.kind === kind);
96
+ if (!entry?.id) continue;
97
+ if (!objectExistsInSnapshot(kind, entry.id, snapshot, entry.featureId)) continue;
98
+ out.push({
99
+ kind,
100
+ id: entry.id,
101
+ label: RELATION_LABELS[kind] ?? kind,
102
+ featureId: entry.featureId,
103
+ href: `#${objectRoutePath(kind, entry.id, entry.featureId)}`,
104
+ path: objectRoutePath(kind, entry.id, entry.featureId),
105
+ });
106
+ }
107
+ return out;
108
+ }
109
+
110
+ export function renderObjectRelationBar(relations, snapshot) {
111
+ const bar = el("div", "object-relation-bar");
112
+ bar.setAttribute("aria-label", "对象关联");
113
+ const list = Array.isArray(relations)
114
+ ? relations
115
+ : buildObjectRelations(relations, snapshot);
116
+ if (list.length === 0) {
117
+ bar.appendChild(el("span", "muted", "暂无已证明的对象关联"));
118
+ return bar;
119
+ }
120
+ list.forEach((rel, i) => {
121
+ if (i > 0) bar.appendChild(el("span", "object-relation-sep", "→"));
122
+ const item = el("span", "object-relation-item");
123
+ item.appendChild(el("span", "object-relation-label", rel.label));
124
+ item.appendChild(document.createTextNode(" "));
125
+ if (rel.href && rel.id) {
126
+ item.appendChild(objectRouteLink(rel.kind, rel.id, snapshot, rel.featureId));
127
+ } else {
128
+ item.appendChild(el("span", "muted", rel.id ?? "缺失"));
129
+ }
130
+ bar.appendChild(item);
131
+ });
132
+ return bar;
133
+ }
@@ -1,85 +1,93 @@
1
- /** Hash routing for Observe UI (R5). */
2
-
3
- export function parseHashRoute(hashValue) {
4
- const hash = (hashValue.replace(/^#/, "") || "/").split("?")[0] || "/";
5
- const batchMatch = /^\/batch\/([^/]+)$/.exec(hash);
6
- if (batchMatch) {
7
- return { view: "batch", batchRunId: decodeURIComponent(batchMatch[1]) };
8
- }
9
- const runMatch = /^\/run\/([^/]+)$/.exec(hash);
10
- if (runMatch) {
11
- return { view: "run", workerRunId: decodeURIComponent(runMatch[1]) };
12
- }
13
- const dagMatch = /^\/dag\/([^/]+)$/.exec(hash);
14
- if (dagMatch) {
15
- return { view: "dag", dagRunId: decodeURIComponent(dagMatch[1]) };
16
- }
17
- const taskMatch = /^\/task\/([^/]+)$/.exec(hash);
18
- if (taskMatch) {
19
- return { view: "task", taskId: decodeURIComponent(taskMatch[1]) };
20
- }
21
- const featureMatch = /^\/feature\/([^/]+)$/.exec(hash);
22
- if (featureMatch) {
23
- return {
24
- view: "feature",
25
- featureId: decodeURIComponent(featureMatch[1]),
26
- };
27
- }
28
- if (hash === "/pool") {
29
- return { view: "pool" };
30
- }
31
- if (hash === "/failures") {
32
- return { view: "failures" };
33
- }
34
- if (hash === "/dags") {
35
- return { view: "dashboard", scrollTo: "dags" };
36
- }
37
- return { view: "dashboard" };
38
- }
39
-
40
- /** Active (non-terminal) statuses sort first; terminals by updatedAt desc. */
41
-
42
- export function parseRoute() {
43
- return parseHashRouteWithFilters(location.hash);
44
- }
45
-
46
- export function navigate(path) {
47
- location.hash = path.startsWith("#") ? path.slice(1) : path;
48
- }
49
-
50
- /**
51
- * Parse optional filter query after a hash path: #/pool?status=failed
52
- * Returns { filters: { status?, q? } } merged into route; unknown keys ignored.
53
- * Base parseHashRoute shape is preserved for all existing views.
54
- */
55
- export function parseHashFilters(hashValue) {
56
- const raw = String(hashValue ?? "").replace(/^#/, "");
57
- const qIndex = raw.indexOf("?");
58
- if (qIndex < 0) return {};
59
- const qs = raw.slice(qIndex + 1);
60
- const params = new URLSearchParams(qs);
61
- const filters = {};
62
- const status = params.get("status");
63
- const q = params.get("q");
64
- if (status) filters.status = status;
65
- if (q) filters.q = q;
66
- return filters;
67
- }
68
-
69
- export function parseHashRouteWithFilters(hashValue) {
70
- const raw = String(hashValue ?? "");
71
- const withoutQuery = raw.replace(/^#/, "").split("?")[0];
72
- const base = parseHashRoute("#" + (withoutQuery || "/"));
73
- const filters = parseHashFilters(raw);
74
- if (Object.keys(filters).length === 0) return base;
75
- return { ...base, filters };
76
- }
77
-
78
- export function buildHashPath(path, filters = {}) {
79
- const base = path.startsWith("#") ? path.slice(1) : path;
80
- const params = new URLSearchParams();
81
- if (filters.status) params.set("status", filters.status);
82
- if (filters.q) params.set("q", filters.q);
83
- const qs = params.toString();
84
- return qs ? `${base}?${qs}` : base;
85
- }
1
+ /** Hash routing for Observe UI (R5). */
2
+
3
+ export function parseHashRoute(hashValue) {
4
+ const hash = (hashValue.replace(/^#/, "") || "/").split("?")[0] || "/";
5
+ const batchMatch = /^\/batch\/([^/]+)$/.exec(hash);
6
+ if (batchMatch) {
7
+ return { view: "batch", batchRunId: decodeURIComponent(batchMatch[1]) };
8
+ }
9
+ const runMatch = /^\/run\/([^/]+)$/.exec(hash);
10
+ if (runMatch) {
11
+ return { view: "run", workerRunId: decodeURIComponent(runMatch[1]) };
12
+ }
13
+ const dagMatch = /^\/dag\/([^/]+)$/.exec(hash);
14
+ if (dagMatch) {
15
+ return { view: "dag", dagRunId: decodeURIComponent(dagMatch[1]) };
16
+ }
17
+ const featureTaskMatch = /^\/feature\/([^/]+)\/task\/([^/]+)$/.exec(hash);
18
+ if (featureTaskMatch) {
19
+ return {
20
+ view: "task",
21
+ featureId: decodeURIComponent(featureTaskMatch[1]),
22
+ taskId: decodeURIComponent(featureTaskMatch[2]),
23
+ };
24
+ }
25
+ const taskMatch = /^\/task\/([^/]+)$/.exec(hash);
26
+ if (taskMatch) {
27
+ return { view: "task", taskId: decodeURIComponent(taskMatch[1]) };
28
+ }
29
+ const featureMatch = /^\/feature\/([^/]+)$/.exec(hash);
30
+ if (featureMatch) {
31
+ return {
32
+ view: "feature",
33
+ featureId: decodeURIComponent(featureMatch[1]),
34
+ };
35
+ }
36
+ if (hash === "/pool") {
37
+ return { view: "pool" };
38
+ }
39
+ if (hash === "/failures") {
40
+ return { view: "failures" };
41
+ }
42
+ if (hash === "/dags") {
43
+ return { view: "dashboard", scrollTo: "dags" };
44
+ }
45
+ return { view: "dashboard" };
46
+ }
47
+
48
+ /** Active (non-terminal) statuses sort first; terminals by updatedAt desc. */
49
+
50
+ export function parseRoute() {
51
+ return parseHashRouteWithFilters(location.hash);
52
+ }
53
+
54
+ export function navigate(path) {
55
+ location.hash = path.startsWith("#") ? path.slice(1) : path;
56
+ }
57
+
58
+ /**
59
+ * Parse optional filter query after a hash path: #/pool?status=failed
60
+ * Returns { filters: { status?, q? } } merged into route; unknown keys ignored.
61
+ * Base parseHashRoute shape is preserved for all existing views.
62
+ */
63
+ export function parseHashFilters(hashValue) {
64
+ const raw = String(hashValue ?? "").replace(/^#/, "");
65
+ const qIndex = raw.indexOf("?");
66
+ if (qIndex < 0) return {};
67
+ const qs = raw.slice(qIndex + 1);
68
+ const params = new URLSearchParams(qs);
69
+ const filters = {};
70
+ const status = params.get("status");
71
+ const q = params.get("q");
72
+ if (status) filters.status = status;
73
+ if (q) filters.q = q;
74
+ return filters;
75
+ }
76
+
77
+ export function parseHashRouteWithFilters(hashValue) {
78
+ const raw = String(hashValue ?? "");
79
+ const withoutQuery = raw.replace(/^#/, "").split("?")[0];
80
+ const base = parseHashRoute("#" + (withoutQuery || "/"));
81
+ const filters = parseHashFilters(raw);
82
+ if (Object.keys(filters).length === 0) return base;
83
+ return { ...base, filters };
84
+ }
85
+
86
+ export function buildHashPath(path, filters = {}) {
87
+ const base = path.startsWith("#") ? path.slice(1) : path;
88
+ const params = new URLSearchParams();
89
+ if (filters.status) params.set("status", filters.status);
90
+ if (filters.q) params.set("q", filters.q);
91
+ const qs = params.toString();
92
+ return qs ? `${base}?${qs}` : base;
93
+ }