pi-crew 0.1.51 → 0.2.1

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 (240) hide show
  1. package/CHANGELOG.md +56 -1
  2. package/README.md +176 -781
  3. package/agents/analyst.md +11 -11
  4. package/agents/critic.md +11 -11
  5. package/agents/executor.md +11 -11
  6. package/agents/explorer.md +11 -11
  7. package/agents/planner.md +11 -11
  8. package/agents/reviewer.md +11 -11
  9. package/agents/security-reviewer.md +11 -11
  10. package/agents/test-engineer.md +11 -11
  11. package/agents/verifier.md +70 -11
  12. package/agents/writer.md +11 -11
  13. package/docs/actions-reference.md +595 -0
  14. package/docs/commands-reference.md +347 -0
  15. package/docs/runtime-flow.md +148 -148
  16. package/index.ts +6 -6
  17. package/package.json +99 -99
  18. package/skills/async-worker-recovery/SKILL.md +42 -42
  19. package/skills/context-artifact-hygiene/SKILL.md +52 -52
  20. package/skills/delegation-patterns/SKILL.md +54 -54
  21. package/skills/mailbox-interactive/SKILL.md +40 -40
  22. package/skills/model-routing-context/SKILL.md +39 -39
  23. package/skills/multi-perspective-review/SKILL.md +58 -58
  24. package/skills/observability-reliability/SKILL.md +41 -41
  25. package/skills/orchestration/SKILL.md +157 -157
  26. package/skills/ownership-session-security/SKILL.md +41 -41
  27. package/skills/pi-extension-lifecycle/SKILL.md +39 -39
  28. package/skills/requirements-to-task-packet/SKILL.md +63 -63
  29. package/skills/resource-discovery-config/SKILL.md +41 -41
  30. package/skills/runtime-state-reader/SKILL.md +44 -44
  31. package/skills/secure-agent-orchestration-review/SKILL.md +45 -45
  32. package/skills/state-mutation-locking/SKILL.md +42 -42
  33. package/skills/systematic-debugging/SKILL.md +67 -67
  34. package/skills/ui-render-performance/SKILL.md +39 -39
  35. package/skills/verification-before-done/SKILL.md +57 -57
  36. package/skills/worktree-isolation/SKILL.md +39 -39
  37. package/src/adapters/claude-adapter.ts +25 -0
  38. package/src/adapters/codex-adapter.ts +21 -0
  39. package/src/adapters/cursor-adapter.ts +17 -0
  40. package/src/adapters/export-util.ts +137 -0
  41. package/src/adapters/index.ts +15 -0
  42. package/src/adapters/registry.ts +18 -0
  43. package/src/adapters/types.ts +23 -0
  44. package/src/agents/agent-config.ts +2 -0
  45. package/src/agents/agent-search.ts +98 -98
  46. package/src/agents/discover-agents.ts +2 -1
  47. package/src/config/config.ts +13 -1
  48. package/src/config/drift-detector.ts +211 -0
  49. package/src/config/markers.ts +327 -0
  50. package/src/config/resilient-parser.ts +108 -0
  51. package/src/config/suggestions.ts +74 -0
  52. package/src/extension/cross-extension-rpc.ts +103 -94
  53. package/src/extension/project-init.ts +21 -1
  54. package/src/extension/register.ts +45 -14
  55. package/src/extension/registration/commands.ts +77 -8
  56. package/src/extension/registration/subagent-tools.ts +10 -1
  57. package/src/extension/registration/team-tool.ts +10 -1
  58. package/src/extension/registration/viewers.ts +48 -34
  59. package/src/extension/run-bundle-schema.ts +89 -89
  60. package/src/extension/run-import.ts +25 -1
  61. package/src/extension/run-index.ts +5 -1
  62. package/src/extension/run-maintenance.ts +142 -68
  63. package/src/extension/team-manager-command.ts +10 -1
  64. package/src/extension/team-tool/api.ts +441 -441
  65. package/src/extension/team-tool/doctor.ts +28 -3
  66. package/src/extension/team-tool/handle-settings.ts +195 -188
  67. package/src/extension/team-tool/inspect.ts +41 -41
  68. package/src/extension/team-tool/intent-policy.ts +42 -42
  69. package/src/extension/team-tool/lifecycle-actions.ts +27 -8
  70. package/src/extension/team-tool/plan.ts +19 -19
  71. package/src/extension/team-tool/run.ts +12 -1
  72. package/src/extension/team-tool.ts +332 -322
  73. package/src/i18n.ts +184 -184
  74. package/src/observability/exporters/otlp-exporter.ts +92 -77
  75. package/src/prompt/prompt-runtime.ts +72 -72
  76. package/src/runtime/agent-memory.ts +72 -72
  77. package/src/runtime/agent-observability.ts +114 -114
  78. package/src/runtime/async-marker.ts +26 -26
  79. package/src/runtime/attention-events.ts +28 -28
  80. package/src/runtime/auto-resume.ts +100 -0
  81. package/src/runtime/background-runner.ts +11 -1
  82. package/src/runtime/cancellation-token.ts +89 -89
  83. package/src/runtime/cancellation.ts +61 -61
  84. package/src/runtime/capability-inventory.ts +116 -116
  85. package/src/runtime/child-pi.ts +7 -2
  86. package/src/runtime/compaction-summary.ts +271 -0
  87. package/src/runtime/completion-guard.ts +190 -190
  88. package/src/runtime/crash-recovery.ts +33 -1
  89. package/src/runtime/delta-conflict.ts +360 -0
  90. package/src/runtime/direct-run.ts +35 -35
  91. package/src/runtime/foreground-control.ts +82 -82
  92. package/src/runtime/green-contract.ts +46 -46
  93. package/src/runtime/group-join.ts +106 -106
  94. package/src/runtime/heartbeat-gradient.ts +28 -28
  95. package/src/runtime/heartbeat-watcher.ts +124 -124
  96. package/src/runtime/iteration-hooks.ts +264 -0
  97. package/src/runtime/live-agent-control.ts +88 -88
  98. package/src/runtime/live-control-realtime.ts +36 -36
  99. package/src/runtime/live-extension-bridge.ts +150 -150
  100. package/src/runtime/live-irc.ts +92 -92
  101. package/src/runtime/live-session-health.ts +100 -100
  102. package/src/runtime/loop-gates.ts +129 -0
  103. package/src/runtime/metric-parser.ts +40 -0
  104. package/src/runtime/notebook-helpers.ts +90 -90
  105. package/src/runtime/orphan-sentinel.ts +7 -7
  106. package/src/runtime/parallel-research.ts +44 -44
  107. package/src/runtime/phase-progress.ts +217 -0
  108. package/src/runtime/pi-args.ts +38 -11
  109. package/src/runtime/pi-json-output.ts +111 -111
  110. package/src/runtime/pi-spawn.ts +57 -7
  111. package/src/runtime/policy-engine.ts +79 -79
  112. package/src/runtime/post-checks.ts +122 -0
  113. package/src/runtime/progress-event-coalescer.ts +43 -43
  114. package/src/runtime/prose-compressor.ts +164 -164
  115. package/src/runtime/recovery-recipes.ts +74 -74
  116. package/src/runtime/result-extractor.ts +121 -121
  117. package/src/runtime/role-permission.ts +39 -39
  118. package/src/runtime/sensitive-paths.ts +2 -2
  119. package/src/runtime/session-resources.ts +25 -25
  120. package/src/runtime/session-snapshot.ts +59 -59
  121. package/src/runtime/session-usage.ts +79 -79
  122. package/src/runtime/sidechain-output.ts +29 -29
  123. package/src/runtime/stream-preview.ts +177 -177
  124. package/src/runtime/supervisor-contact.ts +59 -59
  125. package/src/runtime/task-display.ts +38 -38
  126. package/src/runtime/task-graph.ts +207 -0
  127. package/src/runtime/task-quality.ts +207 -0
  128. package/src/runtime/task-runner/capabilities.ts +78 -78
  129. package/src/runtime/task-runner/live-executor.ts +7 -1
  130. package/src/runtime/task-runner/progress.ts +119 -119
  131. package/src/runtime/task-runner/prompt-pipeline.ts +64 -64
  132. package/src/runtime/task-runner/result-utils.ts +14 -14
  133. package/src/runtime/task-runner/run-projection.ts +103 -103
  134. package/src/runtime/task-runner/state-helpers.ts +22 -22
  135. package/src/runtime/team-runner.ts +117 -7
  136. package/src/runtime/worker-heartbeat.ts +21 -21
  137. package/src/runtime/worker-startup.ts +57 -57
  138. package/src/runtime/workflow-state.ts +187 -0
  139. package/src/runtime/workspace-tree.ts +298 -298
  140. package/src/schema/config-schema.ts +11 -0
  141. package/src/schema/validation-types.ts +148 -0
  142. package/src/skills/skill-templates.ts +374 -0
  143. package/src/state/active-run-registry.ts +35 -11
  144. package/src/state/atomic-write.ts +33 -26
  145. package/src/state/contracts.ts +1 -0
  146. package/src/state/event-reconstructor.ts +217 -0
  147. package/src/state/locks.ts +2 -13
  148. package/src/state/mailbox.ts +4 -3
  149. package/src/state/state-store.ts +16 -6
  150. package/src/state/task-claims.ts +44 -44
  151. package/src/state/types.ts +9 -0
  152. package/src/state/usage.ts +29 -29
  153. package/src/subagents/async-entry.ts +1 -1
  154. package/src/subagents/index.ts +3 -3
  155. package/src/subagents/live/control.ts +1 -1
  156. package/src/subagents/live/manager.ts +1 -1
  157. package/src/subagents/live/realtime.ts +1 -1
  158. package/src/subagents/live/session-runtime.ts +1 -1
  159. package/src/subagents/manager.ts +1 -1
  160. package/src/subagents/spawn.ts +1 -1
  161. package/src/teams/team-serializer.ts +38 -38
  162. package/src/types/diff.d.ts +18 -18
  163. package/src/ui/crew-footer.ts +101 -101
  164. package/src/ui/crew-select-list.ts +111 -111
  165. package/src/ui/crew-widget.ts +5 -2
  166. package/src/ui/dashboard-panes/cancellation-pane.ts +42 -42
  167. package/src/ui/dashboard-panes/capability-pane.ts +59 -59
  168. package/src/ui/dashboard-panes/mailbox-pane.ts +35 -35
  169. package/src/ui/dashboard-panes/metrics-pane.ts +34 -34
  170. package/src/ui/dashboard-panes/progress-pane.ts +11 -0
  171. package/src/ui/dynamic-border.ts +25 -25
  172. package/src/ui/layout-primitives.ts +106 -106
  173. package/src/ui/loaders.ts +158 -158
  174. package/src/ui/render-coalescer.ts +51 -51
  175. package/src/ui/render-diff.ts +119 -119
  176. package/src/ui/render-scheduler.ts +143 -143
  177. package/src/ui/run-action-dispatcher.ts +10 -1
  178. package/src/ui/spinner.ts +17 -17
  179. package/src/ui/status-colors.ts +58 -58
  180. package/src/ui/syntax-highlight.ts +116 -116
  181. package/src/ui/transcript-entries.ts +258 -258
  182. package/src/utils/completion-dedupe.ts +63 -63
  183. package/src/utils/frontmatter.ts +68 -68
  184. package/src/utils/git.ts +262 -262
  185. package/src/utils/ids.ts +17 -17
  186. package/src/utils/incremental-reader.ts +104 -104
  187. package/src/utils/names.ts +27 -27
  188. package/src/utils/redaction.ts +44 -44
  189. package/src/utils/safe-paths.ts +47 -47
  190. package/src/utils/scan-cache.ts +136 -136
  191. package/src/utils/sleep.ts +40 -26
  192. package/src/utils/task-name-generator.ts +337 -337
  193. package/src/workflows/validate-workflow.ts +40 -40
  194. package/src/worktree/branch-freshness.ts +45 -45
  195. package/teams/default.team.md +12 -12
  196. package/teams/fast-fix.team.md +11 -11
  197. package/teams/implementation.team.md +18 -18
  198. package/teams/parallel-research.team.md +14 -14
  199. package/teams/research.team.md +11 -11
  200. package/teams/review.team.md +12 -12
  201. package/workflows/default.workflow.md +30 -29
  202. package/workflows/fast-fix.workflow.md +23 -22
  203. package/workflows/implementation.workflow.md +43 -43
  204. package/workflows/parallel-research.workflow.md +46 -46
  205. package/workflows/research.workflow.md +22 -22
  206. package/workflows/review.workflow.md +30 -30
  207. package/docs/refactor-tasks-phase3.md +0 -394
  208. package/docs/refactor-tasks-phase4.md +0 -564
  209. package/docs/refactor-tasks-phase5.md +0 -402
  210. package/docs/refactor-tasks-phase6.md +0 -662
  211. package/docs/refactor-tasks.md +0 -1484
  212. package/docs/research/AGENT-EXECUTION-ARCHITECTURE.md +0 -261
  213. package/docs/research/AGENT-LIFECYCLE-COMPARISON.md +0 -111
  214. package/docs/research/AUDIT_OH_MY_PI.md +0 -261
  215. package/docs/research/AUDIT_PI_CREW.md +0 -457
  216. package/docs/research/CAVEMAN-DEEP-RESEARCH.md +0 -281
  217. package/docs/research/COMPARISON_OH_MY_PI_VS_PI_CREW.md +0 -264
  218. package/docs/research/DEEP-RESEARCH-PI-POWERBAR.md +0 -343
  219. package/docs/research/DEEP_RESEARCH_SUBAGENT_ARCHITECTURE.md +0 -480
  220. package/docs/research/GAP_CLOSURE_IMPLEMENTATION_PLAN.md +0 -354
  221. package/docs/research/IMPLEMENTATION_PLAN.md +0 -385
  222. package/docs/research/LIVE-SESSION-PRODUCTION-READY-PLAN.md +0 -502
  223. package/docs/research/OH-MY-PI-DEEP-RESEARCH-v14.7.6.md +0 -266
  224. package/docs/research/REMAINING-GAPS-PLAN.md +0 -363
  225. package/docs/research/SESSION-SUMMARY-2026-05-08.md +0 -146
  226. package/docs/research/UI-RESPONSIVENESS-AUDIT.md +0 -173
  227. package/docs/research-awesome-agent-skills-distillation.md +0 -100
  228. package/docs/research-extension-examples.md +0 -297
  229. package/docs/research-extension-system.md +0 -324
  230. package/docs/research-oh-my-pi-distillation.md +0 -369
  231. package/docs/research-optimization-plan.md +0 -548
  232. package/docs/research-phase10-distillation.md +0 -199
  233. package/docs/research-phase11-distillation.md +0 -201
  234. package/docs/research-phase8-operator-experience-plan.md +0 -819
  235. package/docs/research-phase9-observability-reliability-plan.md +0 -1190
  236. package/docs/research-pi-coding-agent.md +0 -357
  237. package/docs/research-source-pi-crew-reference.md +0 -174
  238. package/docs/research-ui-optimization-plan.md +0 -480
  239. package/docs/source-runtime-refactor-map.md +0 -107
  240. package/src/utils/atomic-write.ts +0 -33
@@ -1,60 +1,60 @@
1
- import { buildCapabilityInventory } from "../../runtime/capability-inventory.ts";
2
- import type { PiTeamsConfig } from "../../config/config.ts";
3
- import type { CapabilityItem } from "../../runtime/capability-inventory.ts";
4
-
5
- export interface CapabilityPaneOptions {
6
- config?: PiTeamsConfig;
7
- filter?: string;
8
- }
9
-
10
- function kindIcon(kind: string): string {
11
- switch (kind) {
12
- case "team": return "👥";
13
- case "workflow": return "📋";
14
- case "agent": return "🤖";
15
- case "skill": return "🔧";
16
- case "tool": return "🛠";
17
- case "runtime": return "⚙";
18
- default: return "•";
19
- }
20
- }
21
-
22
- function stateLabel(state: string): string {
23
- switch (state) {
24
- case "active": return "";
25
- case "disabled": return " [DISABLED]";
26
- case "shadowed": return " [SHADOWED]";
27
- case "missing": return " [MISSING]";
28
- default: return "";
29
- }
30
- }
31
-
32
- export function renderCapabilityPane(cwd: string, opts: CapabilityPaneOptions = {}): string[] {
33
- const inventory = buildCapabilityInventory(cwd, opts.config);
34
- const filtered = opts.filter
35
- ? inventory.filter((item) => item.kind.includes(opts.filter!.toLowerCase()) || item.name.toLowerCase().includes(opts.filter!.toLowerCase()) || item.id.toLowerCase().includes(opts.filter!.toLowerCase()))
36
- : inventory;
37
-
38
- if (filtered.length === 0) return ["Capability pane: no items found"];
39
-
40
- const byKind = new Map<string, CapabilityItem[]>();
41
- for (const item of filtered) {
42
- const group = byKind.get(item.kind) ?? [];
43
- group.push(item);
44
- byKind.set(item.kind, group);
45
- }
46
-
47
- const lines = [`Capability pane: ${filtered.length} item(s) (filter: ${opts.filter ?? "none"})`];
48
- for (const [kind, items] of byKind) {
49
- lines.push(` ${kindIcon(kind)} ${kind} (${items.length}):`);
50
- for (const item of items.slice(0, 10)) {
51
- const icon = item.state === "active" ? "✓" : "✗";
52
- lines.push(` ${icon} ${item.name}${stateLabel(item.state)} [${item.source}]`);
53
- }
54
- if (items.length > 10) lines.push(` ... and ${items.length - 10} more`);
55
- }
56
-
57
- const disabled = filtered.filter((i) => i.state === "disabled").length;
58
- if (disabled > 0) lines.push(` Disabled: ${disabled}`);
59
- return lines;
1
+ import { buildCapabilityInventory } from "../../runtime/capability-inventory.ts";
2
+ import type { PiTeamsConfig } from "../../config/config.ts";
3
+ import type { CapabilityItem } from "../../runtime/capability-inventory.ts";
4
+
5
+ export interface CapabilityPaneOptions {
6
+ config?: PiTeamsConfig;
7
+ filter?: string;
8
+ }
9
+
10
+ function kindIcon(kind: string): string {
11
+ switch (kind) {
12
+ case "team": return "👥";
13
+ case "workflow": return "📋";
14
+ case "agent": return "🤖";
15
+ case "skill": return "🔧";
16
+ case "tool": return "🛠";
17
+ case "runtime": return "⚙";
18
+ default: return "•";
19
+ }
20
+ }
21
+
22
+ function stateLabel(state: string): string {
23
+ switch (state) {
24
+ case "active": return "";
25
+ case "disabled": return " [DISABLED]";
26
+ case "shadowed": return " [SHADOWED]";
27
+ case "missing": return " [MISSING]";
28
+ default: return "";
29
+ }
30
+ }
31
+
32
+ export function renderCapabilityPane(cwd: string, opts: CapabilityPaneOptions = {}): string[] {
33
+ const inventory = buildCapabilityInventory(cwd, opts.config);
34
+ const filtered = opts.filter
35
+ ? inventory.filter((item) => item.kind.includes(opts.filter!.toLowerCase()) || item.name.toLowerCase().includes(opts.filter!.toLowerCase()) || item.id.toLowerCase().includes(opts.filter!.toLowerCase()))
36
+ : inventory;
37
+
38
+ if (filtered.length === 0) return ["Capability pane: no items found"];
39
+
40
+ const byKind = new Map<string, CapabilityItem[]>();
41
+ for (const item of filtered) {
42
+ const group = byKind.get(item.kind) ?? [];
43
+ group.push(item);
44
+ byKind.set(item.kind, group);
45
+ }
46
+
47
+ const lines = [`Capability pane: ${filtered.length} item(s) (filter: ${opts.filter ?? "none"})`];
48
+ for (const [kind, items] of byKind) {
49
+ lines.push(` ${kindIcon(kind)} ${kind} (${items.length}):`);
50
+ for (const item of items.slice(0, 10)) {
51
+ const icon = item.state === "active" ? "✓" : "✗";
52
+ lines.push(` ${icon} ${item.name}${stateLabel(item.state)} [${item.source}]`);
53
+ }
54
+ if (items.length > 10) lines.push(` ... and ${items.length - 10} more`);
55
+ }
56
+
57
+ const disabled = filtered.filter((i) => i.state === "disabled").length;
58
+ if (disabled > 0) lines.push(` Disabled: ${disabled}`);
59
+ return lines;
60
60
  }
@@ -1,35 +1,35 @@
1
- import type { RunUiSnapshot } from "../snapshot-types.ts";
2
-
3
- export function renderMailboxPane(snapshot: RunUiSnapshot | undefined): string[] {
4
- if (!snapshot) return ["Mailbox pane: snapshot unavailable"];
5
- const mailbox = snapshot.mailbox;
6
- const approx = mailbox.approximate ? " · approximate (tail)" : "";
7
- const lines: string[] = [
8
- `Mailbox pane: inbox unread=${mailbox.inboxUnread} · outbox pending=${mailbox.outboxPending} · attention=${mailbox.needsAttention}${approx}`,
9
- ];
10
- // Kind-separated breakdown
11
- const kindParts: string[] = [];
12
- const steer = mailbox.steerUnread ?? 0;
13
- const followUp = mailbox.followUpUnread ?? 0;
14
- const response = mailbox.responseUnread ?? 0;
15
- const message = mailbox.messageUnread ?? 0;
16
- if (steer > 0) kindParts.push(`steer=${steer}`);
17
- if (followUp > 0) kindParts.push(`follow-up=${followUp}`);
18
- if (response > 0) kindParts.push(`response=${response}`);
19
- if (message > 0) kindParts.push(`message=${message}`);
20
- if (kindParts.length > 0) {
21
- lines.push(` Breakdown: ${kindParts.join(" · ")}`);
22
- if (steer > 0) {
23
- lines.push(" ⚠ Urgent: steering messages require immediate attention.");
24
- }
25
- if (followUp > 0) {
26
- lines.push(` 📋 ${followUp} follow-up(s) pending review.`);
27
- }
28
- }
29
- if (mailbox.needsAttention > 0) {
30
- lines.push("Needs attention: press Enter for detail · A ack · N nudge · C compose · X ack all.");
31
- } else {
32
- lines.push("No mailbox items need attention. Press Enter for detail or C compose.");
33
- }
34
- return lines;
35
- }
1
+ import type { RunUiSnapshot } from "../snapshot-types.ts";
2
+
3
+ export function renderMailboxPane(snapshot: RunUiSnapshot | undefined): string[] {
4
+ if (!snapshot) return ["Mailbox pane: snapshot unavailable"];
5
+ const mailbox = snapshot.mailbox;
6
+ const approx = mailbox.approximate ? " · approximate (tail)" : "";
7
+ const lines: string[] = [
8
+ `Mailbox pane: inbox unread=${mailbox.inboxUnread} · outbox pending=${mailbox.outboxPending} · attention=${mailbox.needsAttention}${approx}`,
9
+ ];
10
+ // Kind-separated breakdown
11
+ const kindParts: string[] = [];
12
+ const steer = mailbox.steerUnread ?? 0;
13
+ const followUp = mailbox.followUpUnread ?? 0;
14
+ const response = mailbox.responseUnread ?? 0;
15
+ const message = mailbox.messageUnread ?? 0;
16
+ if (steer > 0) kindParts.push(`steer=${steer}`);
17
+ if (followUp > 0) kindParts.push(`follow-up=${followUp}`);
18
+ if (response > 0) kindParts.push(`response=${response}`);
19
+ if (message > 0) kindParts.push(`message=${message}`);
20
+ if (kindParts.length > 0) {
21
+ lines.push(` Breakdown: ${kindParts.join(" · ")}`);
22
+ if (steer > 0) {
23
+ lines.push(" ⚠ Urgent: steering messages require immediate attention.");
24
+ }
25
+ if (followUp > 0) {
26
+ lines.push(` 📋 ${followUp} follow-up(s) pending review.`);
27
+ }
28
+ }
29
+ if (mailbox.needsAttention > 0) {
30
+ lines.push("Needs attention: press Enter for detail · A ack · N nudge · C compose · X ack all.");
31
+ } else {
32
+ lines.push("No mailbox items need attention. Press Enter for detail or C compose.");
33
+ }
34
+ return lines;
35
+ }
@@ -1,34 +1,34 @@
1
- import type { MetricRegistry } from "../../observability/metric-registry.ts";
2
- import type { HistogramPoint, MetricLabels, MetricPoint } from "../../observability/metrics-primitives.ts";
3
- import type { RunUiSnapshot } from "../snapshot-types.ts";
4
-
5
- export interface MetricsPaneOptions {
6
- registry?: MetricRegistry;
7
- maxCounters?: number;
8
- }
9
-
10
- function labelsText(labels: MetricLabels): string {
11
- const entries = Object.entries(labels);
12
- return entries.length ? `{${entries.map(([key, value]) => `${key}=${value}`).join(",")}}` : "";
13
- }
14
-
15
- function isHistogramPoint(point: MetricPoint | HistogramPoint): point is HistogramPoint {
16
- return "quantiles" in point;
17
- }
18
-
19
- export function renderMetricsPane(_snapshot: RunUiSnapshot | undefined, opts: MetricsPaneOptions = {}): string[] {
20
- if (!opts.registry) return ["Metrics pane: registry unavailable"];
21
- const snapshots = opts.registry.snapshot();
22
- if (!snapshots.length) return ["Metrics pane: no metrics recorded"];
23
- const lines = ["Metrics pane: top metrics"];
24
- for (const snapshot of snapshots.slice(0, opts.maxCounters ?? 10)) {
25
- const first = snapshot.values[0];
26
- if (!first) {
27
- lines.push(`${snapshot.name}: empty`);
28
- continue;
29
- }
30
- if (isHistogramPoint(first)) lines.push(`${snapshot.name}${labelsText(first.labels)} count=${first.count} p95=${Number.isFinite(first.quantiles.p95) ? Math.round(first.quantiles.p95) : "n/a"}`);
31
- else lines.push(`${snapshot.name}${labelsText(first.labels)} ${first.value}`);
32
- }
33
- return lines;
34
- }
1
+ import type { MetricRegistry } from "../../observability/metric-registry.ts";
2
+ import type { HistogramPoint, MetricLabels, MetricPoint } from "../../observability/metrics-primitives.ts";
3
+ import type { RunUiSnapshot } from "../snapshot-types.ts";
4
+
5
+ export interface MetricsPaneOptions {
6
+ registry?: MetricRegistry;
7
+ maxCounters?: number;
8
+ }
9
+
10
+ function labelsText(labels: MetricLabels): string {
11
+ const entries = Object.entries(labels);
12
+ return entries.length ? `{${entries.map(([key, value]) => `${key}=${value}`).join(",")}}` : "";
13
+ }
14
+
15
+ function isHistogramPoint(point: MetricPoint | HistogramPoint): point is HistogramPoint {
16
+ return "quantiles" in point;
17
+ }
18
+
19
+ export function renderMetricsPane(_snapshot: RunUiSnapshot | undefined, opts: MetricsPaneOptions = {}): string[] {
20
+ if (!opts.registry) return ["Metrics pane: registry unavailable"];
21
+ const snapshots = opts.registry.snapshot();
22
+ if (!snapshots.length) return ["Metrics pane: no metrics recorded"];
23
+ const lines = ["Metrics pane: top metrics"];
24
+ for (const snapshot of snapshots.slice(0, opts.maxCounters ?? 10)) {
25
+ const first = snapshot.values[0];
26
+ if (!first) {
27
+ lines.push(`${snapshot.name}: empty`);
28
+ continue;
29
+ }
30
+ if (isHistogramPoint(first)) lines.push(`${snapshot.name}${labelsText(first.labels)} count=${first.count} p95=${Number.isFinite(first.quantiles.p95) ? Math.round(first.quantiles.p95) : "n/a"}`);
31
+ else lines.push(`${snapshot.name}${labelsText(first.labels)} ${first.value}`);
32
+ }
33
+ return lines;
34
+ }
@@ -1,4 +1,5 @@
1
1
  import type { RunUiSnapshot } from "../snapshot-types.ts";
2
+ import { computePhaseProgress, formatPhaseProgressLine } from "../../runtime/phase-progress.ts";
2
3
 
3
4
  export function renderProgressPane(snapshot: RunUiSnapshot | undefined): string[] {
4
5
  if (!snapshot) return ["Progress pane: snapshot unavailable"];
@@ -6,8 +7,18 @@ export function renderProgressPane(snapshot: RunUiSnapshot | undefined): string[
6
7
  const groupJoins = snapshot.groupJoins ?? [];
7
8
  const groupJoinLines = groupJoins.length ? groupJoins.map((item) => `group join ${item.partial ? "partial" : "completed"}: ${item.requestId} ack=${item.ack}`) : ["group joins: none"];
8
9
  const cancellationLine = snapshot.cancellationReason ? [`cancelled: reason=${snapshot.cancellationReason}`] : [];
10
+ const runProgress = computePhaseProgress(snapshot.tasks);
11
+ const phaseLines = runProgress.phases.length > 0
12
+ ? runProgress.phases.map((p) => {
13
+ const done = p.completed + p.failed;
14
+ const status = p.running > 0 ? "running" : p.queued > 0 ? "queued" : done >= p.total ? "done" : "waiting";
15
+ return ` Phase ${p.index + 1} ${p.phase}: ${p.percentage}% (${done}/${p.total}) [${status}]`;
16
+ })
17
+ : [];
18
+ const phaseHeader = phaseLines.length > 0 ? [formatPhaseProgressLine(runProgress), ...phaseLines] : [];
9
19
  return [
10
20
  `Progress pane: ${progress.completed}/${progress.total} completed · running=${progress.running} queued=${progress.queued} failed=${progress.failed}`,
21
+ ...phaseHeader,
11
22
  ...cancellationLine,
12
23
  ...groupJoinLines,
13
24
  ...snapshot.recentEvents.slice(-10).map((event) => {
@@ -1,25 +1,25 @@
1
- import type { CrewTheme } from "./theme-adapter.ts";
2
-
3
- export interface DynamicCrewBorderOptions {
4
- color?: (value: string) => string;
5
- char?: string;
6
- }
7
-
8
- export class DynamicCrewBorder {
9
- private readonly theme: CrewTheme;
10
- private readonly color?: (value: string) => string;
11
- private readonly char: string;
12
-
13
- constructor(theme: CrewTheme, options: DynamicCrewBorderOptions = {}) {
14
- this.theme = theme;
15
- this.color = options.color;
16
- this.char = options.char && options.char.length > 0 ? options.char : "─";
17
- }
18
-
19
- render(width: number): string[] {
20
- const line = this.char.repeat(Math.max(0, width));
21
- return [this.color ? this.color(line) : this.theme.fg("border", line)];
22
- }
23
-
24
- invalidate(): void {}
25
- }
1
+ import type { CrewTheme } from "./theme-adapter.ts";
2
+
3
+ export interface DynamicCrewBorderOptions {
4
+ color?: (value: string) => string;
5
+ char?: string;
6
+ }
7
+
8
+ export class DynamicCrewBorder {
9
+ private readonly theme: CrewTheme;
10
+ private readonly color?: (value: string) => string;
11
+ private readonly char: string;
12
+
13
+ constructor(theme: CrewTheme, options: DynamicCrewBorderOptions = {}) {
14
+ this.theme = theme;
15
+ this.color = options.color;
16
+ this.char = options.char && options.char.length > 0 ? options.char : "─";
17
+ }
18
+
19
+ render(width: number): string[] {
20
+ const line = this.char.repeat(Math.max(0, width));
21
+ return [this.color ? this.color(line) : this.theme.fg("border", line)];
22
+ }
23
+
24
+ invalidate(): void {}
25
+ }
@@ -1,106 +1,106 @@
1
- import { pad, wrapHard } from "../utils/visual.ts";
2
-
3
- export interface RenderableComponent {
4
- invalidate(): void;
5
- render(width: number): string[];
6
- }
7
-
8
- export class Container implements RenderableComponent {
9
- private children: RenderableComponent[] = [];
10
-
11
- addChild(child: RenderableComponent): void {
12
- this.children.push(child);
13
- }
14
-
15
- clear(): void {
16
- this.children = [];
17
- }
18
-
19
- invalidate(): void {
20
- for (const child of this.children) {
21
- child.invalidate();
22
- }
23
- }
24
-
25
- render(width: number): string[] {
26
- const lines: string[] = [];
27
- for (const child of this.children) {
28
- lines.push(...child.render(width));
29
- }
30
- return lines;
31
- }
32
- }
33
-
34
- export class Box extends Container {
35
- private readonly paddingX: number;
36
- private readonly paddingY: number;
37
-
38
- constructor(paddingX = 0, paddingY = 0) {
39
- super();
40
- this.paddingX = paddingX;
41
- this.paddingY = paddingY;
42
- }
43
-
44
- render(width: number): string[] {
45
- const innerWidth = Math.max(1, width - this.paddingX * 2);
46
- const rows = super.render(innerWidth);
47
- const paddedRows: string[] = [];
48
- const left = " ".repeat(this.paddingX);
49
- const right = " ".repeat(this.paddingX);
50
- for (const row of rows) {
51
- paddedRows.push(pad(`${left}${row}${right}`, width));
52
- }
53
- const emptyRow = pad("", width);
54
- if (this.paddingY <= 0) return paddedRows;
55
- if (this.paddingY > 0) {
56
- const topAndBottom = Array.from({ length: this.paddingY }, () => emptyRow);
57
- return [...topAndBottom, ...paddedRows, ...topAndBottom];
58
- }
59
- return paddedRows;
60
- }
61
- }
62
-
63
- export class Text implements RenderableComponent {
64
- private text: string;
65
- private cachedWidth = 0;
66
- private cachedResult: string[] = [];
67
-
68
- constructor(text = "") {
69
- this.text = text;
70
- }
71
-
72
- setText(text: string): void {
73
- if (text === this.text) return;
74
- this.text = text;
75
- this.invalidate();
76
- }
77
-
78
- invalidate(): void {
79
- this.cachedWidth = 0;
80
- this.cachedResult = [];
81
- }
82
-
83
- render(width: number): string[] {
84
- if (this.cachedWidth === width) return this.cachedResult;
85
- const wrapped = wrapHard(this.text, Math.max(1, width));
86
- const lines = wrapped.length ? wrapped : [""];
87
- this.cachedWidth = width;
88
- this.cachedResult = lines.map((line) => pad(line, width));
89
- return this.cachedResult;
90
- }
91
- }
92
-
93
- export class Spacer implements RenderableComponent {
94
- private readonly rows: number;
95
-
96
- constructor(rows = 0) {
97
- this.rows = rows;
98
- }
99
-
100
- render(width: number): string[] {
101
- if (this.rows <= 0) return [];
102
- return Array.from({ length: Math.max(0, this.rows) }, () => pad("", width));
103
- }
104
-
105
- invalidate(): void {}
106
- }
1
+ import { pad, wrapHard } from "../utils/visual.ts";
2
+
3
+ export interface RenderableComponent {
4
+ invalidate(): void;
5
+ render(width: number): string[];
6
+ }
7
+
8
+ export class Container implements RenderableComponent {
9
+ private children: RenderableComponent[] = [];
10
+
11
+ addChild(child: RenderableComponent): void {
12
+ this.children.push(child);
13
+ }
14
+
15
+ clear(): void {
16
+ this.children = [];
17
+ }
18
+
19
+ invalidate(): void {
20
+ for (const child of this.children) {
21
+ child.invalidate();
22
+ }
23
+ }
24
+
25
+ render(width: number): string[] {
26
+ const lines: string[] = [];
27
+ for (const child of this.children) {
28
+ lines.push(...child.render(width));
29
+ }
30
+ return lines;
31
+ }
32
+ }
33
+
34
+ export class Box extends Container {
35
+ private readonly paddingX: number;
36
+ private readonly paddingY: number;
37
+
38
+ constructor(paddingX = 0, paddingY = 0) {
39
+ super();
40
+ this.paddingX = paddingX;
41
+ this.paddingY = paddingY;
42
+ }
43
+
44
+ render(width: number): string[] {
45
+ const innerWidth = Math.max(1, width - this.paddingX * 2);
46
+ const rows = super.render(innerWidth);
47
+ const paddedRows: string[] = [];
48
+ const left = " ".repeat(this.paddingX);
49
+ const right = " ".repeat(this.paddingX);
50
+ for (const row of rows) {
51
+ paddedRows.push(pad(`${left}${row}${right}`, width));
52
+ }
53
+ const emptyRow = pad("", width);
54
+ if (this.paddingY <= 0) return paddedRows;
55
+ if (this.paddingY > 0) {
56
+ const topAndBottom = Array.from({ length: this.paddingY }, () => emptyRow);
57
+ return [...topAndBottom, ...paddedRows, ...topAndBottom];
58
+ }
59
+ return paddedRows;
60
+ }
61
+ }
62
+
63
+ export class Text implements RenderableComponent {
64
+ private text: string;
65
+ private cachedWidth = 0;
66
+ private cachedResult: string[] = [];
67
+
68
+ constructor(text = "") {
69
+ this.text = text;
70
+ }
71
+
72
+ setText(text: string): void {
73
+ if (text === this.text) return;
74
+ this.text = text;
75
+ this.invalidate();
76
+ }
77
+
78
+ invalidate(): void {
79
+ this.cachedWidth = 0;
80
+ this.cachedResult = [];
81
+ }
82
+
83
+ render(width: number): string[] {
84
+ if (this.cachedWidth === width) return this.cachedResult;
85
+ const wrapped = wrapHard(this.text, Math.max(1, width));
86
+ const lines = wrapped.length ? wrapped : [""];
87
+ this.cachedWidth = width;
88
+ this.cachedResult = lines.map((line) => pad(line, width));
89
+ return this.cachedResult;
90
+ }
91
+ }
92
+
93
+ export class Spacer implements RenderableComponent {
94
+ private readonly rows: number;
95
+
96
+ constructor(rows = 0) {
97
+ this.rows = rows;
98
+ }
99
+
100
+ render(width: number): string[] {
101
+ if (this.rows <= 0) return [];
102
+ return Array.from({ length: Math.max(0, this.rows) }, () => pad("", width));
103
+ }
104
+
105
+ invalidate(): void {}
106
+ }