@tea-agent/loop-agent 0.11.0 → 0.13.0-alpha.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 (123) hide show
  1. package/CHANGELOG.md +74 -1
  2. package/README.md +33 -4
  3. package/dist/application/dag/generate-task-dag.js +45 -0
  4. package/dist/application/dag/run-dag.js +10 -0
  5. package/dist/application/dag/validate-dag.js +11 -0
  6. package/dist/cli/command-definitions.js +10 -3
  7. package/dist/commands/init.js +74 -7
  8. package/dist/commands/knowledge.js +129 -31
  9. package/dist/governance/manifest-types.js +3 -0
  10. package/dist/shared/package-metadata.js +135 -0
  11. package/dist/task/config-types.js +6 -1
  12. package/dist/worker/cli.js +99 -2
  13. package/dist/worker/delivery/package.js +3 -3
  14. package/dist/worker/feature/decision-loader.js +37 -6
  15. package/dist/worker/feature/next-action.js +10 -2
  16. package/dist/worker/feature/ready-plan-projection.js +81 -0
  17. package/dist/worker/feature/reducer.js +2 -1
  18. package/dist/worker/feature/review.js +19 -2
  19. package/dist/worker/feature/run.js +27 -2
  20. package/dist/worker/follow-up/approve.js +5 -2
  21. package/dist/worker/follow-up/factory.js +1 -1
  22. package/dist/worker/observability/event-history.js +216 -0
  23. package/dist/worker/observability/read-model.js +552 -118
  24. package/dist/worker/observe/paths.js +17 -0
  25. package/dist/worker/observe/routes.js +310 -23
  26. package/dist/worker/observe/server.js +59 -1
  27. package/dist/worker/observe/spec-evidence.js +281 -0
  28. package/dist/worker/observe/static/api.js +46 -0
  29. package/dist/worker/observe/static/app.js +120 -2598
  30. package/dist/worker/observe/static/constants.js +148 -0
  31. package/dist/worker/observe/static/copy.js +67 -0
  32. package/dist/worker/observe/static/dag-helpers.js +172 -0
  33. package/dist/worker/observe/static/dag-model.js +72 -0
  34. package/dist/worker/observe/static/dom.js +61 -0
  35. package/dist/worker/observe/static/format-pool.js +67 -0
  36. package/dist/worker/observe/static/format.js +292 -0
  37. package/dist/worker/observe/static/index.html +300 -82
  38. package/dist/worker/observe/static/kpi.js +94 -0
  39. package/dist/worker/observe/static/relations.js +133 -0
  40. package/dist/worker/observe/static/router.js +93 -0
  41. package/dist/worker/observe/static/run-processing.js +148 -0
  42. package/dist/worker/observe/static/shell-chrome.js +68 -0
  43. package/dist/worker/observe/static/state.js +253 -0
  44. package/dist/worker/observe/static/styles.css +1731 -495
  45. package/dist/worker/observe/static/views/batch.js +227 -0
  46. package/dist/worker/observe/static/views/dag-graph.js +172 -0
  47. package/dist/worker/observe/static/views/dag-inspector.js +596 -0
  48. package/dist/worker/observe/static/views/dag.js +362 -0
  49. package/dist/worker/observe/static/views/dashboard.js +445 -0
  50. package/dist/worker/observe/static/views/failures.js +143 -0
  51. package/dist/worker/observe/static/views/feature.js +492 -0
  52. package/dist/worker/observe/static/views/pool.js +350 -0
  53. package/dist/worker/observe/static/views/run.js +453 -0
  54. package/dist/worker/observe/static/views/session-timeline.js +205 -0
  55. package/dist/worker/observe/static/views/shell.js +7 -0
  56. package/dist/worker/observe/static/views/task.js +314 -0
  57. package/dist/worker/observe/static/views/timeline.js +163 -0
  58. package/dist/worker/pool/doctor.js +165 -0
  59. package/dist/worker/pool/migrate-state.js +303 -0
  60. package/dist/worker/pool/run-store.js +205 -17
  61. package/dist/worker/pool/types.js +17 -1
  62. package/dist/worker/pool/validation.js +100 -15
  63. package/dist/worker/report/morning-report.js +12 -2
  64. package/dist/worker/runner/run-ready.js +41 -26
  65. package/dist/worker/task-graph/ready-planner.js +136 -0
  66. package/dist/workflows/dag/controller-identity.js +104 -0
  67. package/dist/workflows/dag/convergence/controller.js +16 -8
  68. package/dist/workflows/dag/failure-routing.js +12 -1
  69. package/dist/workflows/dag/init-hybrid.js +1233 -11
  70. package/dist/workflows/dag/node-execution.js +123 -29
  71. package/dist/workflows/dag/repair-artifact.js +91 -0
  72. package/dist/workflows/dag/report.js +50 -0
  73. package/dist/workflows/dag/retry-policy.js +138 -0
  74. package/dist/workflows/dag/runner.js +32 -0
  75. package/dist/workflows/dag/runtime-contract.js +87 -0
  76. package/dist/workflows/dag/skill-snapshot.js +2 -0
  77. package/dist/workflows/dag/types.js +45 -1
  78. package/dist/workflows/dag/validate.js +68 -4
  79. package/docs/README.md +1 -1
  80. package/docs/agent-dag-recovery-playbook.md +9 -0
  81. package/docs/agent-dag-runner.md +26 -1
  82. package/docs/architecture/dag-execution.md +6 -0
  83. package/docs/architecture/evolution.md +7 -5
  84. package/docs/architecture/facts-and-state.md +15 -2
  85. package/docs/architecture/worker-and-feature.md +6 -2
  86. package/docs/decisions/README.md +3 -0
  87. package/docs/design/README.md +12 -3
  88. package/docs/exec-plans/active/README.md +2 -2
  89. package/docs/exec-plans/completed/README.md +12 -0
  90. package/docs/feature-workflow.md +108 -2
  91. package/docs/loop-agent-harness.md +15 -4
  92. package/docs/progress/README.md +22 -0
  93. package/docs/reports/README.md +14 -2
  94. package/docs/templates/agent-dag-report.schema.json +17 -0
  95. package/docs/templates/agent-dag.schema.json +69 -1
  96. package/docs/templates/agent-dag.supervised-implementation.json +8 -2
  97. package/docs/templates/backend-test-dag.generate-pytest.prompt.md +139 -0
  98. package/docs/templates/backend-test-dag.json +288 -0
  99. package/docs/templates/backend-test-dag.retrospect.prompt.md +125 -0
  100. package/docs/templates/backend-test-dag.review-cases.prompt.md +81 -0
  101. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -0
  102. package/docs/templates/knowledge-sync-dag.json +177 -0
  103. package/docs/templates/knowledge-sync-draft.schema.json +71 -0
  104. package/docs/verification-matrix.md +2 -1
  105. package/package.json +8 -2
  106. package/scripts/kb-bootstrap-init-skeleton.sh +239 -0
  107. package/scripts/kb-graph-incremental-prepare.mjs +372 -0
  108. package/scripts/kb-graph-incremental-prepare.sh +5 -0
  109. package/scripts/kb-graph-materialize.mjs +105 -0
  110. package/scripts/kb-graph-materialize.sh +4 -0
  111. package/scripts/kb-graph-promote.mjs +153 -0
  112. package/scripts/kb-graph-promote.sh +4 -0
  113. package/scripts/kb-query.mjs +554 -0
  114. package/scripts/kb-query.sh +5 -0
  115. package/skills/agent-worker/SKILL.md +3 -1
  116. package/skills/agent-worker/references/agent-worker-operator.md +18 -1
  117. package/skills/frontend-design-review/SKILL.md +26 -24
  118. package/skills/frontend-implementation/SKILL.md +29 -26
  119. package/skills/frontend-implementation/references/node-contracts.md +50 -19
  120. package/skills/frontend-review/SKILL.md +1 -1
  121. package/skills/loop-agent/references/command-reference.md +2 -0
  122. package/skills/loop-agent/references/hybrid-dag.md +22 -3
  123. package/skills/loop-agent/references/verification-and-failure-handling.md +6 -0
package/dist/worker/observe/static/index.html CHANGED
@@ -1,90 +1,308 @@
1
- <!DOCTYPE html>
1
+ <!doctype html>
2
2
  <html lang="zh-CN">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Loop Agent</title>
7
- <link rel="icon" href="data:,">
8
- <link rel="preconnect" href="https://cdn.jsdelivr.net">
9
- <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/remixicon@4.6.0/fonts/remixicon.css">
10
- <link rel="stylesheet" href="/styles.css">
11
- </head>
12
- <body data-shell="observe-console">
13
- <a class="skip-link" href="#main-content">跳到主内容</a>
14
- <div id="app">
15
- <header class="site-header">
16
- <a href="#/" class="logo" aria-label="Loop Agent 运行看板首页">
17
- <i class="ri-radar-line" aria-hidden="true"></i>
18
- <span>Loop Agent</span>
19
- </a>
20
- <nav class="top-nav" aria-label="主导航">
21
- <a href="#/" class="nav-link"><i class="ri-dashboard-3-line" aria-hidden="true"></i><span>总览</span></a>
22
- <a href="#/failures" class="nav-link"><i class="ri-alarm-warning-line" aria-hidden="true"></i><span>异常 Task</span></a>
23
- </nav>
24
- <div class="header-meta">
25
- <i class="ri-live-line" aria-hidden="true"></i>
26
- <span id="header-refresh" class="header-refresh" aria-live="polite"></span>
27
- </div>
28
- <nav id="breadcrumb" class="breadcrumb" aria-label="面包屑"></nav>
29
- </header>
30
-
31
- <main id="main-content" class="dashboard-main" tabindex="-1">
32
- <section data-view="dashboard" id="view-dashboard" class="view view-dashboard">
33
- <div class="view-heading">
34
- <p class="view-kicker">OBSERVE</p>
35
- <h2>运行总览</h2>
36
- <p>聚焦正在推进的 DAG、需要处理的风险与近期运行记录。</p>
37
- </div>
38
- <div id="dashboard-repo" class="repo-banner" aria-label="当前仓库"></div>
39
- <section id="dashboard-features" class="panel panel-features" aria-label="Feature 决策"></section>
40
- <section id="dashboard-kpi" class="panel panel-kpi" aria-label="运行摘要"></section>
41
- <div class="dashboard-workspace">
42
- <section id="dashboard-active-dags" class="panel panel-primary"></section>
43
- <aside id="dashboard-risk" class="panel panel-risk" aria-label="运行风险"></aside>
44
- </div>
45
- <div class="dashboard-secondary">
46
- <section id="dashboard-dags" class="panel"></section>
47
- <section id="dashboard-batches" class="panel"></section>
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
+ <title>Loop Agent</title>
7
+ <link rel="icon" href="data:," />
8
+ <link rel="preconnect" href="https://cdn.jsdelivr.net" />
9
+ <link
10
+ rel="stylesheet"
11
+ href="https://cdn.jsdelivr.net/npm/remixicon@4.6.0/fonts/remixicon.css"
12
+ />
13
+ <link rel="stylesheet" href="/styles.css" />
14
+ </head>
15
+ <body data-shell="observe-console">
16
+ <a class="skip-link" href="#main-content">跳到主内容</a>
17
+ <div id="app">
18
+ <header class="site-header">
19
+ <a href="#/" class="logo" aria-label="Loop Agent 运行看板首页">
20
+ <i class="ri-radar-line" aria-hidden="true"></i>
21
+ <span>Loop Agent</span>
22
+ </a>
23
+ <nav class="top-nav" aria-label="主导航">
24
+ <a href="#/" class="nav-link"
25
+ ><i class="ri-dashboard-3-line" aria-hidden="true"></i
26
+ ><span>总览</span></a
27
+ >
28
+ <a href="#/pool" class="nav-link"
29
+ ><i class="ri-database-2-line" aria-hidden="true"></i
30
+ ><span>资源池</span></a
31
+ >
32
+ <a href="#/failures" class="nav-link"
33
+ ><i class="ri-alarm-warning-line" aria-hidden="true"></i
34
+ ><span>异常 Task</span></a
35
+ >
36
+ </nav>
37
+ <div class="header-meta">
38
+ <i class="ri-live-line" aria-hidden="true"></i>
39
+ <span
40
+ id="header-refresh"
41
+ class="header-refresh"
42
+ aria-live="polite"
43
+ ></span>
48
44
  </div>
49
- </section>
45
+ <nav id="breadcrumb" class="breadcrumb" aria-label="面包屑"></nav>
46
+ </header>
47
+
48
+ <main id="main-content" class="dashboard-main" tabindex="-1">
49
+ <section
50
+ data-view="dashboard"
51
+ id="view-dashboard"
52
+ class="view view-dashboard"
53
+ >
54
+ <div class="view-heading">
55
+ <p class="view-kicker">OBSERVE</p>
56
+ <h2>运行总览</h2>
57
+ <p>聚焦正在推进的 DAG、需要处理的风险与近期运行记录。</p>
58
+ </div>
59
+ <div
60
+ id="dashboard-repo"
61
+ class="repo-banner"
62
+ aria-label="当前仓库"
63
+ ></div>
64
+ <section
65
+ id="dashboard-features"
66
+ class="panel panel-features"
67
+ aria-label="Feature 决策"
68
+ ></section>
69
+ <section
70
+ id="dashboard-kpi"
71
+ class="panel panel-kpi"
72
+ aria-label="运行摘要"
73
+ ></section>
74
+ <div class="dashboard-workspace">
75
+ <section
76
+ id="dashboard-active-dags"
77
+ class="panel panel-primary"
78
+ ></section>
79
+ <aside
80
+ id="dashboard-risk"
81
+ class="panel panel-risk"
82
+ aria-label="运行风险"
83
+ ></aside>
84
+ </div>
85
+ <div class="dashboard-secondary">
86
+ <section id="dashboard-dags" class="panel"></section>
87
+ <section id="dashboard-batches" class="panel"></section>
88
+ </div>
89
+ </section>
50
90
 
51
- <section data-view="batch" id="view-batch" class="view" hidden>
52
- <div class="view-heading"><p class="view-kicker">BATCH</p><h2>批次详情</h2></div>
53
- <section id="batch-meta" class="panel panel-meta"></section>
54
- <section id="batch-tasks" class="panel panel-table"></section>
55
- </section>
91
+ <section data-view="batch" id="view-batch" class="view" hidden>
92
+ <div class="view-heading">
93
+ <p class="view-kicker">BATCH</p>
94
+ <h2>批次详情</h2>
95
+ <p>首轮失败定位：摘要、Task 诊断字段与安全证据入口同屏可见。</p>
96
+ </div>
97
+ <section
98
+ id="batch-relations"
99
+ class="panel object-relations-panel"
100
+ aria-label="对象关联"
101
+ ></section>
102
+ <section id="batch-meta" class="panel panel-meta"></section>
103
+ <section
104
+ id="batch-timeline"
105
+ class="panel panel-timeline"
106
+ aria-label="批次事件时间线"
107
+ ></section>
108
+ <section id="batch-tasks" class="panel panel-table"></section>
109
+ <section
110
+ id="batch-evidence"
111
+ class="panel panel-artifacts"
112
+ aria-label="批次证据预览"
113
+ ></section>
114
+ </section>
56
115
 
57
- <section data-view="run" id="view-run" class="view" hidden>
58
- <div class="view-heading"><p class="view-kicker">WORKER RUN</p><h2>运行详情</h2></div>
59
- <section id="run-meta" class="panel panel-meta"></section>
60
- <section id="run-dag-progress" class="panel panel-progress"></section>
61
- <div class="run-detail-workspace">
62
- <aside id="run-steps" class="panel panel-rail"></aside>
63
- <div class="run-evidence">
64
- <section id="run-command" class="panel"></section>
65
- <section id="run-output" class="panel panel-output"></section>
116
+ <section data-view="run" id="view-run" class="view" hidden>
117
+ <div class="view-heading">
118
+ <p class="view-kicker">WORKER RUN</p>
119
+ <h2>运行详情</h2>
120
+ <p>主事实 · 执行过程 · 诊断证据</p>
66
121
  </div>
67
- <aside id="run-artifacts" class="panel panel-artifacts"></aside>
68
- </div>
69
- </section>
122
+ <section
123
+ id="run-relations"
124
+ class="panel object-relations-panel"
125
+ aria-label="对象关联"
126
+ ></section>
127
+ <section
128
+ id="run-facts"
129
+ class="panel panel-meta run-layer-facts"
130
+ aria-label="主事实"
131
+ >
132
+ <div id="run-meta"></div>
133
+ </section>
134
+ <section id="run-dag-progress" class="panel panel-progress"></section>
135
+ <section
136
+ id="run-process"
137
+ class="run-layer-process"
138
+ aria-label="执行过程"
139
+ >
140
+ <div class="run-detail-workspace">
141
+ <aside id="run-steps" class="panel panel-rail"></aside>
142
+ <div class="run-evidence">
143
+ <section id="run-command" class="panel"></section>
144
+ <section id="run-output" class="panel panel-output"></section>
145
+ </div>
146
+ </div>
147
+ </section>
148
+ <section
149
+ id="run-diagnosis"
150
+ class="run-layer-diagnosis"
151
+ aria-label="诊断证据"
152
+ >
153
+ <aside id="run-artifacts" class="panel panel-artifacts"></aside>
154
+ </section>
155
+ </section>
70
156
 
71
- <section data-view="dag" id="view-dag" class="view" hidden>
72
- <div class="view-heading"><p class="view-kicker">AGENT DAG</p><h2>DAG 详情</h2></div>
73
- <section id="dag-meta" class="panel panel-meta"></section>
74
- <div class="dag-detail-workspace">
75
- <section id="dag-ranks" class="panel panel-graph"></section>
76
- </div>
77
- <section id="dag-nodes" class="panel panel-table"></section>
78
- <aside id="dag-inspector" class="panel dag-inspector" aria-label="选中节点检查器" aria-hidden="true"></aside>
79
- </section>
157
+ <section data-view="dag" id="view-dag" class="view" hidden>
158
+ <div class="view-heading">
159
+ <p class="view-kicker">AGENT DAG</p>
160
+ <h2>DAG 详情</h2>
161
+ </div>
162
+ <section
163
+ id="dag-relations"
164
+ class="panel object-relations-panel"
165
+ aria-label="对象关联"
166
+ ></section>
167
+ <section id="dag-meta" class="panel panel-meta"></section>
168
+ <div class="dag-detail-workspace">
169
+ <section id="dag-ranks" class="panel panel-graph"></section>
170
+ </div>
171
+ <section id="dag-nodes" class="panel panel-table"></section>
172
+ <aside
173
+ id="dag-inspector"
174
+ class="panel dag-inspector"
175
+ aria-label="选中节点检查器"
176
+ aria-hidden="true"
177
+ ></aside>
178
+ </section>
179
+
180
+ <section data-view="failures" id="view-failures" class="view" hidden>
181
+ <div class="view-heading">
182
+ <p class="view-kicker">ATTENTION QUEUE</p>
183
+ <h2>异常 Task</h2>
184
+ <p>按运行状态和建议跟进项集中处理需要人工介入的 Task。</p>
185
+ </div>
186
+ <div id="failures-empty" class="panel empty-state" hidden>
187
+ 当前没有异常 Task
188
+ </div>
189
+ <section id="failures-list" class="panel panel-table"></section>
190
+ </section>
80
191
 
81
- <section data-view="failures" id="view-failures" class="view" hidden>
82
- <div class="view-heading"><p class="view-kicker">ATTENTION QUEUE</p><h2>异常 Task</h2><p>按运行状态和建议跟进项集中处理需要人工介入的 Task。</p></div>
83
- <div id="failures-empty" class="panel empty-state" hidden>当前没有异常 Task</div>
84
- <section id="failures-list" class="panel panel-table"></section>
85
- </section>
86
- </main>
87
- </div>
88
- <script type="module" src="/app.js"></script>
89
- </body>
192
+ <section data-view="pool" id="view-pool" class="view" hidden>
193
+ <div class="view-heading">
194
+ <p class="view-kicker">TASK POOL</p>
195
+ <h2>资源池总览</h2>
196
+ <p>
197
+ 盘点当前 Worker Task 状态分布与最新运行，无需翻查
198
+ .harness/task-pool/。
199
+ </p>
200
+ </div>
201
+ <section
202
+ id="pool-fault"
203
+ class="panel"
204
+ aria-label="投影告警"
205
+ ></section>
206
+ <section
207
+ id="pool-kpi"
208
+ class="panel panel-kpi"
209
+ aria-label="状态分布"
210
+ ></section>
211
+ <div id="pool-empty" class="panel empty-state" hidden></div>
212
+ <section
213
+ id="pool-tasks"
214
+ class="panel panel-table"
215
+ aria-label="当前 Task 列表"
216
+ ></section>
217
+ <section
218
+ id="pool-events"
219
+ class="panel panel-timeline"
220
+ aria-label="最近事件"
221
+ ></section>
222
+ <p class="panel muted advisory-note" id="pool-advisory">
223
+ 数据为本地 derived/advisory 投影，仅供运营参考，非权威写路径。
224
+ </p>
225
+ </section>
226
+
227
+ <section data-view="task" id="view-task" class="view" hidden>
228
+ <div class="view-heading">
229
+ <p class="view-kicker">WORKER TASK</p>
230
+ <h2 id="task-title">Task 详情</h2>
231
+ <p>查看当前事实、真实关联与有界运行历史。</p>
232
+ </div>
233
+ <section
234
+ id="task-relations"
235
+ class="panel object-relations-panel"
236
+ aria-label="对象关联"
237
+ ></section>
238
+ <section id="task-meta" class="panel panel-meta"></section>
239
+ <section
240
+ id="task-links"
241
+ class="panel"
242
+ aria-label="关联对象"
243
+ ></section>
244
+ <section
245
+ id="task-evidence"
246
+ class="panel panel-artifacts"
247
+ aria-label="失败证据"
248
+ ></section>
249
+ <section
250
+ id="task-runs"
251
+ class="panel panel-table"
252
+ aria-label="运行历史"
253
+ ></section>
254
+ </section>
255
+
256
+ <section data-view="feature" id="view-feature" class="view" hidden>
257
+ <div class="view-heading">
258
+ <p class="view-kicker">FEATURE</p>
259
+ <h2 id="feature-title">Feature 决策详情</h2>
260
+ <p>只读决策投影：阻塞、AC、风险、建议命令与已执行事实分区展示。</p>
261
+ </div>
262
+ <section
263
+ id="feature-relations"
264
+ class="panel object-relations-panel"
265
+ aria-label="对象关联"
266
+ ></section>
267
+ <section id="feature-meta" class="panel panel-meta"></section>
268
+ <section
269
+ id="feature-ac"
270
+ class="panel panel-table"
271
+ aria-label="验收覆盖"
272
+ ></section>
273
+ <section
274
+ id="feature-blocking"
275
+ class="panel"
276
+ aria-label="阻塞与风险"
277
+ ></section>
278
+ <section
279
+ id="feature-actions"
280
+ class="panel"
281
+ aria-label="建议命令"
282
+ ></section>
283
+ <section
284
+ id="feature-facts"
285
+ class="panel executed-facts"
286
+ aria-label="已执行事实"
287
+ ></section>
288
+ <section
289
+ id="feature-followups"
290
+ class="panel"
291
+ aria-label="待处理 follow-up"
292
+ ></section>
293
+ <section
294
+ id="feature-evidence"
295
+ class="panel panel-artifacts"
296
+ aria-label="证据"
297
+ ></section>
298
+ <section
299
+ id="feature-warnings"
300
+ class="panel"
301
+ aria-label="投影警告"
302
+ ></section>
303
+ </section>
304
+ </main>
305
+ </div>
306
+ <script type="module" src="/app.js"></script>
307
+ </body>
90
308
  </html>
package/dist/worker/observe/static/kpi.js ADDED
@@ -0,0 +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
+ }
package/dist/worker/observe/static/relations.js ADDED
@@ -0,0 +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
+ }