@tea-agent/loop-agent 0.13.0 → 0.14.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 (270) hide show
  1. package/AGENTS.md +157 -157
  2. package/CHANGELOG.md +73 -301
  3. package/README.md +338 -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/docs/README.md +105 -104
  50. package/docs/agent-dag-recovery-playbook.md +195 -195
  51. package/docs/agent-dag-runner.md +67 -67
  52. package/docs/architecture/README.md +26 -26
  53. package/docs/architecture/dag-execution.md +140 -140
  54. package/docs/architecture/evolution.md +54 -54
  55. package/docs/architecture/facts-and-state.md +71 -71
  56. package/docs/architecture/runtime-boundaries.md +191 -191
  57. package/docs/architecture/system-overview.md +93 -93
  58. package/docs/architecture/worker-and-feature.md +85 -85
  59. package/docs/cursor-prompt-sidecar.md +36 -36
  60. package/docs/decisions/README.md +18 -18
  61. package/docs/design/README.md +167 -167
  62. package/docs/development-principles.md +73 -73
  63. package/docs/exec-plans/README.md +6 -6
  64. package/docs/exec-plans/active/README.md +2 -1
  65. package/docs/exec-plans/completed/README.md +105 -104
  66. package/docs/feature-workflow.md +414 -414
  67. package/docs/harness-methodology-debugging.md +153 -153
  68. package/docs/harness-methodology-tdd.md +130 -130
  69. package/docs/harness-methodology-verification.md +27 -27
  70. package/docs/init-surface.manifest.json +307 -307
  71. package/docs/loop-agent-harness.md +142 -142
  72. package/docs/production-readiness.md +96 -96
  73. package/docs/progress/README.md +59 -58
  74. package/docs/reports/README.md +123 -119
  75. package/docs/skills/README.md +7 -7
  76. package/docs/skills/vetted-skill-registry.md +29 -29
  77. package/docs/templates/adr.md +60 -60
  78. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  79. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  80. package/docs/templates/agent-dag-decision-gate-dogfood-report.md +117 -117
  81. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  82. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  83. package/docs/templates/agent-dag-report.schema.json +473 -473
  84. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  85. package/docs/templates/agent-dag.base.json +190 -190
  86. package/docs/templates/agent-dag.final-verification.json +185 -185
  87. package/docs/templates/agent-dag.schema.json +411 -411
  88. package/docs/templates/agent-dag.supervised-implementation.json +620 -620
  89. package/docs/templates/backend-test-analysis.schema.json +44 -44
  90. package/docs/templates/backend-test-case-manifest.schema.json +190 -190
  91. package/docs/templates/backend-test-dag.classify.prompt.md +75 -75
  92. package/docs/templates/backend-test-dag.generate-pytest.prompt.md +204 -204
  93. package/docs/templates/backend-test-dag.json +559 -559
  94. package/docs/templates/backend-test-dag.retrospect.prompt.md +139 -139
  95. package/docs/templates/backend-test-dag.review-cases.prompt.md +83 -83
  96. package/docs/templates/backend-test-execution.schema.json +133 -133
  97. package/docs/templates/backend-test-result.schema.json +99 -99
  98. package/docs/templates/exec-plan.md +64 -64
  99. package/docs/templates/feature-spec.md +53 -53
  100. package/docs/templates/frontend-design-contract.md +42 -42
  101. package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md +17 -17
  102. package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md +16 -16
  103. package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md +16 -16
  104. package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md +16 -16
  105. package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md +16 -16
  106. package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md +16 -16
  107. package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md +21 -21
  108. package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md +29 -29
  109. package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md +28 -28
  110. package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md +28 -28
  111. package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md +29 -29
  112. package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md +27 -27
  113. package/docs/templates/frontend-eval/fixtures/functional/06-ssr-server-client-boundary.md +28 -28
  114. package/docs/templates/frontend-eval/fixtures/functional/07-shared-public-component-api.md +28 -28
  115. package/docs/templates/frontend-eval/fixtures/functional/08-pure-local-no-remote.md +27 -27
  116. package/docs/templates/frontend-eval/metrics.md +138 -138
  117. package/docs/templates/frontend-eval/smoke-targets.md +53 -53
  118. package/docs/templates/frontend-implementation-contract.schema.json +27 -27
  119. package/docs/templates/frontend-task-constraints.md +35 -35
  120. package/docs/templates/frontend-task-requirement.md +70 -70
  121. package/docs/templates/frontend-test-dag.generate-cases.prompt.md +5 -5
  122. package/docs/templates/frontend-test-dag.json +23 -23
  123. package/docs/templates/frontend-test-dag.retrieve-context.prompt.md +3 -3
  124. package/docs/templates/frontend-test-dag.retrospect.prompt.md +3 -3
  125. package/docs/templates/frontend-test-dag.review-cases.prompt.md +3 -3
  126. package/docs/templates/frontend-test-dag.review-execution.prompt.md +3 -3
  127. package/docs/templates/harness.schema.json +221 -221
  128. package/docs/templates/hybrid-dag.json +188 -188
  129. package/docs/templates/init-evolution-review.md +35 -35
  130. package/docs/templates/interactive-ui-round2-experiment.md +66 -66
  131. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -118
  132. package/docs/templates/knowledge-sync-dag.json +178 -178
  133. package/docs/templates/knowledge-sync-draft.schema.json +71 -71
  134. package/docs/templates/product-line/AGENTS.md +8 -8
  135. package/docs/templates/product-line/README.md +9 -9
  136. package/docs/templates/product-line/acceptance.yaml +14 -14
  137. package/docs/templates/product-line/closeout.yaml +9 -9
  138. package/docs/templates/product-line/design.md +13 -13
  139. package/docs/templates/product-line/links.md +10 -10
  140. package/docs/templates/product-line/requirement.md +17 -17
  141. package/docs/templates/product-line/task-graph.yaml +15 -15
  142. package/docs/templates/product-line/task.yaml +64 -64
  143. package/docs/templates/product-line/test-plan.md +7 -7
  144. package/docs/templates/production-readiness-checklist.md +57 -57
  145. package/docs/templates/progress-log.md +17 -17
  146. package/docs/templates/project-start-checklist.md +9 -9
  147. package/docs/templates/qa-report.md +48 -48
  148. package/docs/templates/sprint-contract.md +29 -29
  149. package/docs/templates/worker-dogfood-evidence.md +80 -80
  150. package/docs/templates/worker-dogfood-setup.md +68 -68
  151. package/docs/verification-matrix.md +70 -70
  152. package/examples/decision-gate-agent-dag.json +173 -173
  153. package/examples/example-dag.json +46 -46
  154. package/examples/hybrid-loop-agent-dag.json +188 -188
  155. package/harness.json +66 -66
  156. package/package.json +88 -52
  157. package/scripts/check-product-line-docs.sh +29 -29
  158. package/scripts/check-task-pool-root.sh +32 -32
  159. package/scripts/kb-bootstrap-init-skeleton.sh +240 -240
  160. package/scripts/kb-graph-incremental-prepare.mjs +386 -386
  161. package/scripts/kb-graph-incremental-prepare.sh +5 -5
  162. package/scripts/kb-graph-materialize.mjs +105 -105
  163. package/scripts/kb-graph-materialize.sh +4 -4
  164. package/scripts/kb-graph-promote.mjs +164 -164
  165. package/scripts/kb-graph-promote.sh +4 -4
  166. package/scripts/kb-query.mjs +554 -554
  167. package/scripts/kb-query.sh +5 -5
  168. package/skills/agent-worker/SKILL.md +39 -39
  169. package/skills/agent-worker/references/agent-worker-operator.md +60 -60
  170. package/skills/ai-engineering-context/SKILL.md +48 -48
  171. package/skills/analyze-product-dependencies/SKILL.md +67 -67
  172. package/skills/analyze-product-dependencies/agents/openai.yaml +4 -4
  173. package/skills/analyze-product-dependencies/references/api-documentation-schema.md +30 -30
  174. package/skills/analyze-product-dependencies/references/dependency-analysis-schema.md +28 -28
  175. package/skills/analyze-product-dependencies/references/example.md +76 -76
  176. package/skills/analyze-product-dependencies/references/forward-test-cases.md +35 -35
  177. package/skills/analyze-product-dependencies/references/input-contract.md +11 -11
  178. package/skills/analyze-product-dependencies/references/scouting-rules.md +61 -61
  179. package/skills/analyze-product-dependencies/scripts/test-validators.mjs +267 -267
  180. package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +101 -101
  181. package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +142 -142
  182. package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +76 -76
  183. package/skills/analyze-product-dependencies/scripts/validation-helpers.mjs +146 -146
  184. package/skills/analyze-product-requirements/SKILL.md +90 -90
  185. package/skills/analyze-product-requirements/agents/openai.yaml +4 -4
  186. package/skills/analyze-product-requirements/references/acceptance-criteria.md +91 -91
  187. package/skills/analyze-product-requirements/references/clarification-and-knowledge.md +56 -56
  188. package/skills/analyze-product-requirements/references/example.md +86 -86
  189. package/skills/analyze-product-requirements/references/forward-test-cases.md +66 -66
  190. package/skills/analyze-product-requirements/references/product-analysis-schema.md +32 -32
  191. package/skills/analyze-product-requirements/references/product-requirement-schema.md +33 -33
  192. package/skills/analyze-product-requirements/references/requirement-clarification-schema.md +35 -35
  193. package/skills/analyze-product-requirements/scripts/test-validators.mjs +193 -193
  194. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +69 -69
  195. package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +97 -97
  196. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +98 -98
  197. package/skills/analyze-product-requirements/scripts/validation-helpers.mjs +156 -156
  198. package/skills/browser-tools/SKILL.md +196 -196
  199. package/skills/browser-tools/browser-content.js +103 -103
  200. package/skills/browser-tools/browser-cookies.js +35 -35
  201. package/skills/browser-tools/browser-eval.js +53 -53
  202. package/skills/browser-tools/browser-hn-scraper.js +108 -108
  203. package/skills/browser-tools/browser-nav.js +44 -44
  204. package/skills/browser-tools/browser-pick.js +162 -162
  205. package/skills/browser-tools/browser-screenshot.js +34 -34
  206. package/skills/browser-tools/browser-start.js +86 -86
  207. package/skills/browser-tools/package-lock.json +2556 -2556
  208. package/skills/browser-tools/package.json +19 -19
  209. package/skills/code-review-core/SKILL.md +20 -20
  210. package/skills/codebase-scout/SKILL.md +19 -19
  211. package/skills/frontend-design-review/SKILL.md +66 -66
  212. package/skills/frontend-design-review/references/review-checklist.md +58 -58
  213. package/skills/frontend-implementation/SKILL.md +49 -49
  214. package/skills/frontend-implementation/references/code-standards.md +32 -32
  215. package/skills/frontend-implementation/references/design-spec.md +46 -46
  216. package/skills/frontend-implementation/references/node-contracts.md +27 -27
  217. package/skills/frontend-review/SKILL.md +59 -59
  218. package/skills/frontend-review/references/review-findings.md +47 -47
  219. package/skills/frontend-verification/SKILL.md +53 -53
  220. package/skills/frontend-verification/references/verification-checklist.md +68 -68
  221. package/skills/grill-me/SKILL.md +10 -10
  222. package/skills/grill-with-docs/SKILL.md +88 -88
  223. package/skills/grill-with-docs/adr-format.md +47 -47
  224. package/skills/grill-with-docs/context-format.md +60 -60
  225. package/skills/init-capability-evolution/SKILL.md +70 -70
  226. package/skills/loop-agent/SKILL.md +151 -151
  227. package/skills/loop-agent/references/README.md +67 -67
  228. package/skills/loop-agent/references/command-reference.md +527 -527
  229. package/skills/loop-agent/references/docs-converge.md +126 -126
  230. package/skills/loop-agent/references/harness-policy.md +263 -263
  231. package/skills/loop-agent/references/hybrid-dag.md +243 -243
  232. package/skills/loop-agent/references/learned/README.md +21 -21
  233. package/skills/loop-agent/references/long-running-loop.md +57 -57
  234. package/skills/loop-agent/references/model-routing.md +36 -36
  235. package/skills/loop-agent/references/multi-worktree.md +54 -54
  236. package/skills/loop-agent/references/one-shot-runs.md +85 -85
  237. package/skills/loop-agent/references/orchestrator-and-interventions.md +169 -169
  238. package/skills/loop-agent/references/pi-prompt.md +23 -23
  239. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
  240. package/skills/loop-agent/references/post-implementation-and-patterns.md +44 -44
  241. package/skills/loop-agent/references/task-workflow.md +89 -89
  242. package/skills/loop-agent/references/verification-and-failure-handling.md +141 -141
  243. package/skills/playwright-cli/SKILL.md +420 -420
  244. package/skills/playwright-cli/references/element-attributes.md +23 -23
  245. package/skills/playwright-cli/references/playwright-tests.md +39 -39
  246. package/skills/playwright-cli/references/request-mocking.md +87 -87
  247. package/skills/playwright-cli/references/running-code.md +241 -241
  248. package/skills/playwright-cli/references/session-management.md +225 -225
  249. package/skills/playwright-cli/references/storage-state.md +275 -275
  250. package/skills/playwright-cli/references/test-generation.md +433 -433
  251. package/skills/playwright-cli/references/tracing.md +139 -139
  252. package/skills/playwright-cli/references/video-recording.md +143 -143
  253. package/skills/playwright-cli-case-generator/SKILL.md +74 -74
  254. package/skills/requesting-code-review/SKILL.md +101 -101
  255. package/skills/requesting-code-review/code-reviewer.md +168 -168
  256. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  257. package/skills/systematic-debugging/SKILL.md +296 -296
  258. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  259. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  260. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  261. package/skills/systematic-debugging/find-polluter.sh +63 -63
  262. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  263. package/skills/systematic-debugging/test-academic.md +14 -14
  264. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  265. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  266. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  267. package/skills/test-driven-development/SKILL.md +20 -20
  268. package/skills/using-git-worktrees/SKILL.md +215 -215
  269. package/skills/verification-before-completion/SKILL.md +154 -154
  270. package/skills/webapp-testing/SKILL.md +19 -19
@@ -1,94 +1,100 @@
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 { formatRepoPathDisplay, repoBaseName } from "./format.js";
5
+ import { navigate } from "./router.js";
6
+
7
+ export function failuresInboxLink(count) {
8
+ const wrap = el("span", "kpi-value-with-link");
9
+ wrap.appendChild(el("span", "kpi-value-num", String(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 iconWrap = el("span", "repo-banner-icon");
63
+ const icon = el("i", "ri-git-repository-line");
64
+ icon.setAttribute("aria-hidden", "true");
65
+ iconWrap.appendChild(icon);
66
+ repoEl.appendChild(iconWrap);
67
+ const text = el("div", "repo-banner-text");
68
+ text.appendChild(el("span", "repo-banner-name", repoBaseName(repoRoot)));
69
+ const pathLine = el(
70
+ "span",
71
+ "repo-banner-path",
72
+ formatRepoPathDisplay(repoRoot),
73
+ );
74
+ pathLine.title = repoRoot || "路径未知";
75
+ text.appendChild(pathLine);
76
+ repoEl.appendChild(text);
77
+ }
78
+
79
+ export function renderProjectionFault(error) {
80
+ const banner = el("div", "projection-fault");
81
+ banner.setAttribute("role", "alert");
82
+ const icon = el("i", "ri-error-warning-line");
83
+ icon.setAttribute("aria-hidden", "true");
84
+ banner.appendChild(icon);
85
+ const body = el("div", "projection-fault-body");
86
+ body.appendChild(
87
+ el("p", "projection-fault-title", "指标暂不可用:数据投影失败。"),
88
+ );
89
+ body.appendChild(
90
+ el(
91
+ "p",
92
+ "projection-fault-message",
93
+ error.message ?? "投影失败 (projection failed)",
94
+ ),
95
+ );
96
+ if (error.at)
97
+ body.appendChild(el("p", "projection-fault-at", `发生时间:${error.at}`));
98
+ banner.appendChild(body);
99
+ return banner;
100
+ }
@@ -0,0 +1,124 @@
1
+ /** Shared safe Markdown → DOM rendering for Observe UI. */
2
+ import { el } from "./dom.js";
3
+ import { parseMarkdownBlocks, markdownLinkHref } from "./format.js";
4
+
5
+ export function appendInlineMarkdown(target, text) {
6
+ const tokenPattern = /(`[^`]*`|\*\*[^*]+\*\*|\*[^*]+\*|\[[^\]]+\]\([^)]+\))/g;
7
+ let cursor = 0;
8
+ for (const match of text.matchAll(tokenPattern)) {
9
+ const index = match.index ?? 0;
10
+ if (index > cursor)
11
+ target.appendChild(document.createTextNode(text.slice(cursor, index)));
12
+ const token = match[0];
13
+ if (token.startsWith("`")) {
14
+ target.appendChild(el("code", null, token.slice(1, -1)));
15
+ } else if (token.startsWith("**")) {
16
+ const strong = document.createElement("strong");
17
+ strong.textContent = token.slice(2, -2);
18
+ target.appendChild(strong);
19
+ } else if (token.startsWith("*")) {
20
+ const emphasis = document.createElement("em");
21
+ emphasis.textContent = token.slice(1, -1);
22
+ target.appendChild(emphasis);
23
+ } else {
24
+ const link = token.match(/^\[([^\]]+)\]\((.+)\)$/);
25
+ const href = markdownLinkHref(link?.[2]);
26
+ if (link && href) {
27
+ const anchor = document.createElement("a");
28
+ anchor.href = href;
29
+ anchor.target = "_blank";
30
+ anchor.rel = "noopener noreferrer";
31
+ anchor.textContent = link[1];
32
+ target.appendChild(anchor);
33
+ } else {
34
+ target.appendChild(document.createTextNode(token));
35
+ }
36
+ }
37
+ cursor = index + token.length;
38
+ }
39
+ if (cursor < text.length)
40
+ target.appendChild(document.createTextNode(text.slice(cursor)));
41
+ }
42
+
43
+ /** Render paragraph text, honoring \n hard breaks as <br>. */
44
+ export function appendParagraphMarkdown(target, text) {
45
+ const segments = String(text ?? "").split("\n");
46
+ for (let i = 0; i < segments.length; i += 1) {
47
+ if (i > 0) target.appendChild(document.createElement("br"));
48
+ appendInlineMarkdown(target, segments[i]);
49
+ }
50
+ }
51
+
52
+ export function renderMarkdown(content) {
53
+ const article = el("article", "markdown-output");
54
+ for (const block of parseMarkdownBlocks(content)) {
55
+ switch (block.type) {
56
+ case "heading": {
57
+ const heading = document.createElement(`h${block.level}`);
58
+ appendInlineMarkdown(heading, block.text);
59
+ article.appendChild(heading);
60
+ break;
61
+ }
62
+ case "paragraph": {
63
+ const paragraph = document.createElement("p");
64
+ appendParagraphMarkdown(paragraph, block.text);
65
+ article.appendChild(paragraph);
66
+ break;
67
+ }
68
+ case "quote": {
69
+ const quote = document.createElement("blockquote");
70
+ appendParagraphMarkdown(quote, block.text);
71
+ article.appendChild(quote);
72
+ break;
73
+ }
74
+ case "list": {
75
+ const list = document.createElement(block.ordered ? "ol" : "ul");
76
+ for (const item of block.items) {
77
+ const listItem = document.createElement("li");
78
+ appendInlineMarkdown(listItem, item);
79
+ list.appendChild(listItem);
80
+ }
81
+ article.appendChild(list);
82
+ break;
83
+ }
84
+ case "code": {
85
+ const pre = document.createElement("pre");
86
+ const code = document.createElement("code");
87
+ if (block.language) code.dataset.language = block.language;
88
+ code.textContent = block.text;
89
+ pre.appendChild(code);
90
+ article.appendChild(pre);
91
+ break;
92
+ }
93
+ case "table": {
94
+ const table = document.createElement("table");
95
+ const head = document.createElement("thead");
96
+ const headRow = document.createElement("tr");
97
+ for (const value of block.headers) {
98
+ const cell = document.createElement("th");
99
+ appendInlineMarkdown(cell, value);
100
+ headRow.appendChild(cell);
101
+ }
102
+ head.appendChild(headRow);
103
+ table.appendChild(head);
104
+ const body = document.createElement("tbody");
105
+ for (const row of block.rows) {
106
+ const tableRow = document.createElement("tr");
107
+ for (const value of row) {
108
+ const cell = document.createElement("td");
109
+ appendInlineMarkdown(cell, value);
110
+ tableRow.appendChild(cell);
111
+ }
112
+ body.appendChild(tableRow);
113
+ }
114
+ table.appendChild(body);
115
+ article.appendChild(table);
116
+ break;
117
+ }
118
+ case "rule":
119
+ article.appendChild(document.createElement("hr"));
120
+ break;
121
+ }
122
+ }
123
+ return article;
124
+ }
@@ -1,133 +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, 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
+ /** 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
+ }