@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,292 +1,317 @@
1
- /** Format helpers for Observe UI (R5). */
2
- import {
3
- STATUS_LABELS,
4
- DAG_EFFECTIVE_STATUS_LABELS,
5
- LIVENESS_LABELS,
6
- } from "./constants.js";
7
- import { el } from "./dom.js";
8
-
9
- export function parseMarkdownBlocks(markdown) {
10
- const lines = String(markdown ?? "")
11
- .replace(/\r\n?/g, "\n")
12
- .split("\n");
13
- const blocks = [];
14
- let paragraph = [];
15
- let list = null;
16
- let code = null;
17
-
18
- const flushParagraph = () => {
19
- const text = paragraph.join(" ").trim();
20
- if (text) blocks.push({ type: "paragraph", text });
21
- paragraph = [];
22
- };
23
- const flushList = () => {
24
- if (list?.items.length) blocks.push(list);
25
- list = null;
26
- };
27
-
28
- for (let index = 0; index < lines.length; index += 1) {
29
- const line = lines[index] ?? "";
30
- if (code) {
31
- if (/^```\s*$/.test(line)) {
32
- blocks.push({
33
- type: "code",
34
- language: code.language,
35
- text: code.lines.join("\n"),
36
- });
37
- code = null;
38
- } else {
39
- code.lines.push(line);
40
- }
41
- continue;
42
- }
43
-
44
- const fence = line.match(/^```([^\s]*)\s*$/);
45
- if (fence) {
46
- flushParagraph();
47
- flushList();
48
- code = { language: fence[1] ?? "", lines: [] };
49
- continue;
50
- }
51
- if (!line.trim()) {
52
- flushParagraph();
53
- flushList();
54
- continue;
55
- }
56
- const heading = line.match(/^(#{1,4})\s+(.+)$/);
57
- if (heading) {
58
- flushParagraph();
59
- flushList();
60
- blocks.push({
61
- type: "heading",
62
- level: heading[1].length,
63
- text: heading[2].trim(),
64
- });
65
- continue;
66
- }
67
- if (/^\s{0,3}([-*_])(?:\s*\1){2,}\s*$/.test(line)) {
68
- flushParagraph();
69
- flushList();
70
- blocks.push({ type: "rule" });
71
- continue;
72
- }
73
- if (line.startsWith(">")) {
74
- flushParagraph();
75
- flushList();
76
- blocks.push({ type: "quote", text: line.replace(/^>\s?/, "") });
77
- continue;
78
- }
79
- const unordered = line.match(/^[-*+]\s+(.+)$/);
80
- const ordered = line.match(/^\d+[.)]\s+(.+)$/);
81
- if (unordered || ordered) {
82
- flushParagraph();
83
- const orderedList = Boolean(ordered);
84
- if (!list || list.ordered !== orderedList) {
85
- flushList();
86
- list = { type: "list", ordered: orderedList, items: [] };
87
- }
88
- list.items.push((ordered?.[1] ?? unordered?.[1] ?? "").trim());
89
- continue;
90
- }
91
- if (
92
- line.includes("|") &&
93
- /^\s*\|?\s*:?-{3,}:?\s*(?:\|\s*:?-{3,}:?\s*)+\|?\s*$/.test(
94
- lines[index + 1] ?? "",
95
- )
96
- ) {
97
- flushParagraph();
98
- flushList();
99
- const parseCells = (row) =>
100
- row
101
- .trim()
102
- .replace(/^\||\|$/g, "")
103
- .split("|")
104
- .map((cell) => cell.trim());
105
- const headers = parseCells(line);
106
- const rows = [];
107
- index += 2;
108
- while (index < lines.length && lines[index].includes("|")) {
109
- rows.push(parseCells(lines[index]));
110
- index += 1;
111
- }
112
- index -= 1;
113
- blocks.push({ type: "table", headers, rows });
114
- continue;
115
- }
116
- flushList();
117
- paragraph.push(line.trim());
118
- }
119
- if (code)
120
- blocks.push({
121
- type: "code",
122
- language: code.language,
123
- text: code.lines.join("\n"),
124
- });
125
- flushParagraph();
126
- flushList();
127
- return blocks;
128
- }
129
-
130
- export function markdownLinkHref(value) {
131
- const href = typeof value === "string" ? value.trim() : "";
132
- if (!href) return null;
133
- if (href.startsWith("#") || href.startsWith("/")) return href;
134
- try {
135
- const parsed = new URL(
136
- href,
137
- typeof location === "undefined" ? "http://localhost" : location.href,
138
- );
139
- return ["http:", "https:", "mailto:"].includes(parsed.protocol)
140
- ? href
141
- : null;
142
- } catch {
143
- return null;
144
- }
145
- }
146
-
147
- export function statusLabel(status) {
148
- if (!status) return STATUS_LABELS.unknown;
149
- const key = status.toLowerCase().replace(/-/g, "_");
150
- if (STATUS_LABELS[key]) return STATUS_LABELS[key];
151
- if (status === "FINISHED") return STATUS_LABELS.finished_upper;
152
- if (status === "ERROR") return STATUS_LABELS.error_upper;
153
- if (status === "SKIPPED") return STATUS_LABELS.skipped_upper;
154
- return status;
155
- }
156
-
157
- export function statusSymbol(status) {
158
- const key = (status ?? "unknown").toLowerCase();
159
- if (["finished", "completed", "succeeded", "done"].includes(key)) return "✓";
160
- if (["failed", "error"].includes(key)) return "✕";
161
- if (key === "skipped") return "↷";
162
- if (["running", "started"].includes(key)) return "●";
163
- if (["pending", "queued", "blocked"].includes(key)) return "○";
164
- return "◇";
165
- }
166
-
167
- export function badgeClass(status) {
168
- if (!status) return "unknown";
169
- const key = status.toLowerCase().replace(/_/g, "-");
170
- if (
171
- ["finished", "completed", "succeeded", "done", "superseded"].includes(key)
172
- ) {
173
- return "succeeded";
174
- }
175
- if (["error", "failed", "interrupted"].includes(key)) return "failed";
176
- if (key === "partial-failed") return "partial-failed";
177
- if (key === "skipped" || key === "abandoned") return "skipped";
178
- if (key === "running" || key === "started" || key === "running-quiet")
179
- return "running";
180
- if (key === "paused") return "blocked";
181
- if (key === "remote-unknown") return "unknown";
182
- return key;
183
- }
184
-
185
- export function badge(status) {
186
- const label = statusLabel(status);
187
- const cls = badgeClass(status);
188
- return el("span", `badge badge-${cls}`, label);
189
- }
190
-
191
- export function formatTs(value) {
192
- if (!value) return "";
193
- const d = new Date(value);
194
- if (Number.isNaN(d.getTime())) return value;
195
- return d.toLocaleString("zh-CN", { hour12: false });
196
- }
197
-
198
- export function formatMs(ms) {
199
- if (ms === undefined || ms === null) return "—";
200
- if (ms < 1000) return `${ms}ms`;
201
- if (ms >= 60_000) {
202
- const totalSeconds = Math.floor(ms / 1000);
203
- return `${Math.floor(totalSeconds / 60)}min ${totalSeconds % 60}s`;
204
- }
205
- return `${(ms / 1000).toFixed(1)}s`;
206
- }
207
-
208
- export function dagStatusBadge(status) {
209
- const value = status ?? "unknown";
210
- return el(
211
- "span",
212
- `badge badge-${badgeClass(value)}`,
213
- DAG_EFFECTIVE_STATUS_LABELS[value] ?? statusLabel(value),
214
- );
215
- }
216
-
217
- export function formatDuration(ms) {
218
- if (ms === undefined || ms === null || Number.isNaN(ms)) return "—";
219
- if (ms < 0) ms = 0;
220
- const totalSec = Math.floor(ms / 1000);
221
- const hours = Math.floor(totalSec / 3600);
222
- const minutes = Math.floor((totalSec % 3600) / 60);
223
- const seconds = totalSec % 60;
224
- if (hours > 0) return `${hours}小时 ${minutes}分 ${seconds}秒`;
225
- if (minutes > 0) return `${minutes}分 ${seconds}秒`;
226
- return `${seconds}秒`;
227
- }
228
-
229
- export function formatAgo(iso, nowMs) {
230
- if (!iso) return "—";
231
- const ts = Date.parse(iso);
232
- if (Number.isNaN(ts)) return "—";
233
- const base = nowMs ?? Date.now();
234
- const deltaSec = Math.max(0, Math.floor((base - ts) / 1000));
235
- if (deltaSec < 10) return "刚刚";
236
- if (deltaSec < 60) return `${deltaSec} 秒前`;
237
- if (deltaSec < 3600) return `${Math.floor(deltaSec / 60)} 分钟前`;
238
- if (deltaSec < 86400) return `${Math.floor(deltaSec / 3600)} 小时前`;
239
- return `${Math.floor(deltaSec / 86400)} 天前`;
240
- }
241
-
242
- export function livenessBadge(liveness) {
243
- if (!liveness) return null;
244
- return el(
245
- "span",
246
- `badge liveness-${liveness}`,
247
- LIVENESS_LABELS[liveness] ?? liveness,
248
- );
249
- }
250
-
251
- export function summaryText(summary) {
252
- if (!summary) return "—";
253
- let text = `总计 ${summary.total} · 成功 ${summary.succeeded} · 失败 ${summary.failed} · 复用历史结果 ${summary.reused}`;
254
- if (summary.recordErrors !== undefined) {
255
- text += ` · 记录错误 ${summary.recordErrors}`;
256
- }
257
- if (summary.runErrors !== undefined) {
258
- text += ` · 运行错误 ${summary.runErrors}`;
259
- }
260
- return text;
261
- }
262
-
263
- /** Derived duration from wall-clock facts only (not persisted). */
264
- export function derivedDurationMs(startedAt, finishedAt) {
265
- if (!startedAt || !finishedAt) return undefined;
266
- const start = Date.parse(startedAt);
267
- const end = Date.parse(finishedAt);
268
- if (!Number.isFinite(start) || !Number.isFinite(end) || end < start)
269
- return undefined;
270
- return end - start;
271
- }
272
-
273
- export function displayDurationMs(fact) {
274
- return (
275
- derivedDurationMs(fact?.startedAt, fact?.finishedAt) ?? fact?.durationMs
276
- );
277
- }
278
-
279
- export function truncateText(text, maxLen) {
280
- if (!text) return "—";
281
- const normalized = String(text).replace(/\s+/g, " ").trim();
282
- if (normalized.length <= maxLen) return normalized;
283
- return `${normalized.slice(0, maxLen)}…`;
284
- }
285
-
286
- export function repoBaseName(repoRoot) {
287
- if (!repoRoot) return "未绑定仓库";
288
- const trimmed = String(repoRoot).replace(/[\\/]+$/, "");
289
- const parts = trimmed.split(/[\\/]/);
290
- return parts[parts.length - 1] || trimmed || "未绑定仓库";
291
- }
292
-
1
+ /** Format helpers for Observe UI (R5). */
2
+ import {
3
+ STATUS_LABELS,
4
+ DAG_EFFECTIVE_STATUS_LABELS,
5
+ LIVENESS_LABELS,
6
+ } from "./constants.js";
7
+ import { el } from "./dom.js";
8
+
9
+ export function parseMarkdownBlocks(markdown) {
10
+ const lines = String(markdown ?? "")
11
+ .replace(/\r\n?/g, "\n")
12
+ .split("\n");
13
+ const blocks = [];
14
+ let paragraph = [];
15
+ let list = null;
16
+ let code = null;
17
+
18
+ const flushParagraph = () => {
19
+ if (paragraph.length === 0) return;
20
+ // Preserve Markdown hard breaks (trailing " " or "\") as \n segments.
21
+ // Soft-wrapped lines still join with a space.
22
+ let text = "";
23
+ let prevHardBreak = false;
24
+ for (let i = 0; i < paragraph.length; i += 1) {
25
+ const raw = paragraph[i] ?? "";
26
+ const hardBreak = / {2}$/.test(raw) || /\\$/.test(raw);
27
+ const cleaned = raw.replace(/(?: {2}|\\)$/, "").trim();
28
+ if (!cleaned && !hardBreak) continue;
29
+ if (i === 0 || text === "") text = cleaned;
30
+ else if (prevHardBreak) text += `\n${cleaned}`;
31
+ else text += ` ${cleaned}`;
32
+ prevHardBreak = hardBreak;
33
+ }
34
+ text = text.trim();
35
+ if (text) blocks.push({ type: "paragraph", text });
36
+ paragraph = [];
37
+ };
38
+ const flushList = () => {
39
+ if (list?.items.length) blocks.push(list);
40
+ list = null;
41
+ };
42
+
43
+ for (let index = 0; index < lines.length; index += 1) {
44
+ const line = lines[index] ?? "";
45
+ if (code) {
46
+ if (/^```\s*$/.test(line)) {
47
+ blocks.push({
48
+ type: "code",
49
+ language: code.language,
50
+ text: code.lines.join("\n"),
51
+ });
52
+ code = null;
53
+ } else {
54
+ code.lines.push(line);
55
+ }
56
+ continue;
57
+ }
58
+
59
+ const fence = line.match(/^```([^\s]*)\s*$/);
60
+ if (fence) {
61
+ flushParagraph();
62
+ flushList();
63
+ code = { language: fence[1] ?? "", lines: [] };
64
+ continue;
65
+ }
66
+ if (!line.trim()) {
67
+ flushParagraph();
68
+ flushList();
69
+ continue;
70
+ }
71
+ const heading = line.match(/^(#{1,4})\s+(.+)$/);
72
+ if (heading) {
73
+ flushParagraph();
74
+ flushList();
75
+ blocks.push({
76
+ type: "heading",
77
+ level: heading[1].length,
78
+ text: heading[2].trim(),
79
+ });
80
+ continue;
81
+ }
82
+ if (/^\s{0,3}([-*_])(?:\s*\1){2,}\s*$/.test(line)) {
83
+ flushParagraph();
84
+ flushList();
85
+ blocks.push({ type: "rule" });
86
+ continue;
87
+ }
88
+ if (line.startsWith(">")) {
89
+ flushParagraph();
90
+ flushList();
91
+ blocks.push({ type: "quote", text: line.replace(/^>\s?/, "") });
92
+ continue;
93
+ }
94
+ const unordered = line.match(/^[-*+]\s+(.+)$/);
95
+ const ordered = line.match(/^\d+[.)]\s+(.+)$/);
96
+ if (unordered || ordered) {
97
+ flushParagraph();
98
+ const orderedList = Boolean(ordered);
99
+ if (!list || list.ordered !== orderedList) {
100
+ flushList();
101
+ list = { type: "list", ordered: orderedList, items: [] };
102
+ }
103
+ list.items.push((ordered?.[1] ?? unordered?.[1] ?? "").trim());
104
+ continue;
105
+ }
106
+ if (
107
+ line.includes("|") &&
108
+ /^\s*\|?\s*:?-{3,}:?\s*(?:\|\s*:?-{3,}:?\s*)+\|?\s*$/.test(
109
+ lines[index + 1] ?? "",
110
+ )
111
+ ) {
112
+ flushParagraph();
113
+ flushList();
114
+ const parseCells = (row) =>
115
+ row
116
+ .trim()
117
+ .replace(/^\||\|$/g, "")
118
+ .split("|")
119
+ .map((cell) => cell.trim());
120
+ const headers = parseCells(line);
121
+ const rows = [];
122
+ index += 2;
123
+ while (index < lines.length && lines[index].includes("|")) {
124
+ rows.push(parseCells(lines[index]));
125
+ index += 1;
126
+ }
127
+ index -= 1;
128
+ blocks.push({ type: "table", headers, rows });
129
+ continue;
130
+ }
131
+ flushList();
132
+ // Keep trailing hard-break markers; trim only leading indent.
133
+ paragraph.push(line.replace(/^\s+/, ""));
134
+ }
135
+ if (code)
136
+ blocks.push({
137
+ type: "code",
138
+ language: code.language,
139
+ text: code.lines.join("\n"),
140
+ });
141
+ flushParagraph();
142
+ flushList();
143
+ return blocks;
144
+ }
145
+
146
+ export function markdownLinkHref(value) {
147
+ const href = typeof value === "string" ? value.trim() : "";
148
+ if (!href) return null;
149
+ if (href.startsWith("#") || href.startsWith("/")) return href;
150
+ try {
151
+ const parsed = new URL(
152
+ href,
153
+ typeof location === "undefined" ? "http://localhost" : location.href,
154
+ );
155
+ return ["http:", "https:", "mailto:"].includes(parsed.protocol)
156
+ ? href
157
+ : null;
158
+ } catch {
159
+ return null;
160
+ }
161
+ }
162
+
163
+ export function statusLabel(status) {
164
+ if (!status) return STATUS_LABELS.unknown;
165
+ const key = status.toLowerCase().replace(/-/g, "_");
166
+ if (STATUS_LABELS[key]) return STATUS_LABELS[key];
167
+ if (status === "FINISHED") return STATUS_LABELS.finished_upper;
168
+ if (status === "ERROR") return STATUS_LABELS.error_upper;
169
+ if (status === "SKIPPED") return STATUS_LABELS.skipped_upper;
170
+ return status;
171
+ }
172
+
173
+ export function statusSymbol(status) {
174
+ const key = (status ?? "unknown").toLowerCase();
175
+ if (["finished", "completed", "succeeded", "done"].includes(key)) return "";
176
+ if (["failed", "error"].includes(key)) return "";
177
+ if (key === "skipped") return "";
178
+ if (["running", "started"].includes(key)) return "";
179
+ if (["pending", "queued", "blocked"].includes(key)) return "";
180
+ return "";
181
+ }
182
+
183
+ export function badgeClass(status) {
184
+ if (!status) return "unknown";
185
+ const key = status.toLowerCase().replace(/_/g, "-");
186
+ if (
187
+ ["finished", "completed", "succeeded", "done", "superseded"].includes(key)
188
+ ) {
189
+ return "succeeded";
190
+ }
191
+ if (["error", "failed", "interrupted"].includes(key)) return "failed";
192
+ if (key === "partial-failed") return "partial-failed";
193
+ if (key === "skipped" || key === "abandoned") return "skipped";
194
+ if (key === "running" || key === "started" || key === "running-quiet")
195
+ return "running";
196
+ if (key === "paused") return "blocked";
197
+ if (key === "remote-unknown") return "unknown";
198
+ return key;
199
+ }
200
+
201
+ export function badge(status) {
202
+ const label = statusLabel(status);
203
+ const cls = badgeClass(status);
204
+ return el("span", `badge badge-${cls}`, label);
205
+ }
206
+
207
+ export function formatTs(value) {
208
+ if (!value) return "—";
209
+ const d = new Date(value);
210
+ if (Number.isNaN(d.getTime())) return value;
211
+ return d.toLocaleString("zh-CN", { hour12: false });
212
+ }
213
+
214
+ export function formatMs(ms) {
215
+ if (ms === undefined || ms === null) return "—";
216
+ if (ms < 1000) return `${ms}ms`;
217
+ if (ms >= 60_000) {
218
+ const totalSeconds = Math.floor(ms / 1000);
219
+ return `${Math.floor(totalSeconds / 60)}min ${totalSeconds % 60}s`;
220
+ }
221
+ return `${(ms / 1000).toFixed(1)}s`;
222
+ }
223
+
224
+ export function dagStatusBadge(status) {
225
+ const value = status ?? "unknown";
226
+ return el(
227
+ "span",
228
+ `badge badge-${badgeClass(value)}`,
229
+ DAG_EFFECTIVE_STATUS_LABELS[value] ?? statusLabel(value),
230
+ );
231
+ }
232
+
233
+ export function formatDuration(ms) {
234
+ if (ms === undefined || ms === null || Number.isNaN(ms)) return "—";
235
+ if (ms < 0) ms = 0;
236
+ const totalSec = Math.floor(ms / 1000);
237
+ const hours = Math.floor(totalSec / 3600);
238
+ const minutes = Math.floor((totalSec % 3600) / 60);
239
+ const seconds = totalSec % 60;
240
+ if (hours > 0) return `${hours}小时 ${minutes}分 ${seconds}秒`;
241
+ if (minutes > 0) return `${minutes}分 ${seconds}秒`;
242
+ return `${seconds}秒`;
243
+ }
244
+
245
+ export function formatAgo(iso, nowMs) {
246
+ if (!iso) return "—";
247
+ const ts = Date.parse(iso);
248
+ if (Number.isNaN(ts)) return "—";
249
+ const base = nowMs ?? Date.now();
250
+ const deltaSec = Math.max(0, Math.floor((base - ts) / 1000));
251
+ if (deltaSec < 10) return "刚刚";
252
+ if (deltaSec < 60) return `${deltaSec} 秒前`;
253
+ if (deltaSec < 3600) return `${Math.floor(deltaSec / 60)} 分钟前`;
254
+ if (deltaSec < 86400) return `${Math.floor(deltaSec / 3600)} 小时前`;
255
+ return `${Math.floor(deltaSec / 86400)} 天前`;
256
+ }
257
+
258
+ export function livenessBadge(liveness) {
259
+ if (!liveness) return null;
260
+ return el(
261
+ "span",
262
+ `badge liveness-${liveness}`,
263
+ LIVENESS_LABELS[liveness] ?? liveness,
264
+ );
265
+ }
266
+
267
+ export function summaryText(summary) {
268
+ if (!summary) return "—";
269
+ let text = `总计 ${summary.total} · 成功 ${summary.succeeded} · 失败 ${summary.failed} · 复用历史结果 ${summary.reused}`;
270
+ if (summary.recordErrors !== undefined) {
271
+ text += ` · 记录错误 ${summary.recordErrors}`;
272
+ }
273
+ if (summary.runErrors !== undefined) {
274
+ text += ` · 运行错误 ${summary.runErrors}`;
275
+ }
276
+ return text;
277
+ }
278
+
279
+ /** Derived duration from wall-clock facts only (not persisted). */
280
+ export function derivedDurationMs(startedAt, finishedAt) {
281
+ if (!startedAt || !finishedAt) return undefined;
282
+ const start = Date.parse(startedAt);
283
+ const end = Date.parse(finishedAt);
284
+ if (!Number.isFinite(start) || !Number.isFinite(end) || end < start)
285
+ return undefined;
286
+ return end - start;
287
+ }
288
+
289
+ export function displayDurationMs(fact) {
290
+ return (
291
+ derivedDurationMs(fact?.startedAt, fact?.finishedAt) ?? fact?.durationMs
292
+ );
293
+ }
294
+
295
+ export function truncateText(text, maxLen) {
296
+ if (!text) return "—";
297
+ const normalized = String(text).replace(/\s+/g, " ").trim();
298
+ if (normalized.length <= maxLen) return normalized;
299
+ return `${normalized.slice(0, maxLen)}…`;
300
+ }
301
+
302
+ export function repoBaseName(repoRoot) {
303
+ if (!repoRoot) return "未绑定仓库";
304
+ const trimmed = String(repoRoot).replace(/[\\/]+$/, "");
305
+ const parts = trimmed.split(/[\\/]/);
306
+ return parts[parts.length - 1] || trimmed || "未绑定仓库";
307
+ }
308
+
309
+ /** Compact path for header display; full path stays in title/tooltip. */
310
+ export function formatRepoPathDisplay(repoRoot) {
311
+ if (!repoRoot) return "路径未知";
312
+ return String(repoRoot)
313
+ .replace(/\\/g, "/")
314
+ .replace(/^\/Users\/[^/]+/, "~")
315
+ .replace(/^\/home\/[^/]+/, "~");
316
+ }
317
+