pi-crew 0.1.51 → 0.2.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 (239) 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/doctor.ts +28 -3
  65. package/src/extension/team-tool/handle-settings.ts +195 -188
  66. package/src/extension/team-tool/inspect.ts +41 -41
  67. package/src/extension/team-tool/intent-policy.ts +42 -42
  68. package/src/extension/team-tool/lifecycle-actions.ts +27 -8
  69. package/src/extension/team-tool/plan.ts +19 -19
  70. package/src/extension/team-tool/run.ts +12 -1
  71. package/src/extension/team-tool.ts +11 -1
  72. package/src/i18n.ts +184 -184
  73. package/src/observability/exporters/otlp-exporter.ts +92 -77
  74. package/src/prompt/prompt-runtime.ts +72 -72
  75. package/src/runtime/agent-memory.ts +72 -72
  76. package/src/runtime/agent-observability.ts +114 -114
  77. package/src/runtime/async-marker.ts +26 -26
  78. package/src/runtime/attention-events.ts +28 -28
  79. package/src/runtime/auto-resume.ts +100 -0
  80. package/src/runtime/background-runner.ts +11 -1
  81. package/src/runtime/cancellation-token.ts +89 -89
  82. package/src/runtime/cancellation.ts +61 -61
  83. package/src/runtime/capability-inventory.ts +116 -116
  84. package/src/runtime/child-pi.ts +7 -2
  85. package/src/runtime/compaction-summary.ts +271 -0
  86. package/src/runtime/completion-guard.ts +190 -190
  87. package/src/runtime/crash-recovery.ts +33 -0
  88. package/src/runtime/delta-conflict.ts +360 -0
  89. package/src/runtime/direct-run.ts +35 -35
  90. package/src/runtime/foreground-control.ts +82 -82
  91. package/src/runtime/green-contract.ts +46 -46
  92. package/src/runtime/group-join.ts +106 -106
  93. package/src/runtime/heartbeat-gradient.ts +28 -28
  94. package/src/runtime/heartbeat-watcher.ts +124 -124
  95. package/src/runtime/iteration-hooks.ts +262 -0
  96. package/src/runtime/live-agent-control.ts +88 -88
  97. package/src/runtime/live-control-realtime.ts +36 -36
  98. package/src/runtime/live-extension-bridge.ts +150 -150
  99. package/src/runtime/live-irc.ts +92 -92
  100. package/src/runtime/live-session-health.ts +100 -100
  101. package/src/runtime/loop-gates.ts +129 -0
  102. package/src/runtime/metric-parser.ts +40 -0
  103. package/src/runtime/notebook-helpers.ts +90 -90
  104. package/src/runtime/orphan-sentinel.ts +7 -7
  105. package/src/runtime/parallel-research.ts +44 -44
  106. package/src/runtime/phase-progress.ts +217 -0
  107. package/src/runtime/pi-args.ts +38 -11
  108. package/src/runtime/pi-json-output.ts +111 -111
  109. package/src/runtime/pi-spawn.ts +57 -7
  110. package/src/runtime/policy-engine.ts +79 -79
  111. package/src/runtime/post-checks.ts +122 -0
  112. package/src/runtime/progress-event-coalescer.ts +43 -43
  113. package/src/runtime/prose-compressor.ts +164 -164
  114. package/src/runtime/recovery-recipes.ts +74 -74
  115. package/src/runtime/result-extractor.ts +121 -121
  116. package/src/runtime/role-permission.ts +39 -39
  117. package/src/runtime/sensitive-paths.ts +2 -2
  118. package/src/runtime/session-resources.ts +25 -25
  119. package/src/runtime/session-snapshot.ts +59 -59
  120. package/src/runtime/session-usage.ts +79 -79
  121. package/src/runtime/sidechain-output.ts +29 -29
  122. package/src/runtime/stream-preview.ts +177 -177
  123. package/src/runtime/supervisor-contact.ts +59 -59
  124. package/src/runtime/task-display.ts +38 -38
  125. package/src/runtime/task-graph.ts +207 -0
  126. package/src/runtime/task-quality.ts +207 -0
  127. package/src/runtime/task-runner/capabilities.ts +78 -78
  128. package/src/runtime/task-runner/live-executor.ts +7 -1
  129. package/src/runtime/task-runner/progress.ts +119 -119
  130. package/src/runtime/task-runner/prompt-pipeline.ts +64 -64
  131. package/src/runtime/task-runner/result-utils.ts +14 -14
  132. package/src/runtime/task-runner/run-projection.ts +103 -103
  133. package/src/runtime/task-runner/state-helpers.ts +22 -22
  134. package/src/runtime/team-runner.ts +117 -7
  135. package/src/runtime/worker-heartbeat.ts +21 -21
  136. package/src/runtime/worker-startup.ts +57 -57
  137. package/src/runtime/workflow-state.ts +187 -0
  138. package/src/runtime/workspace-tree.ts +298 -298
  139. package/src/schema/config-schema.ts +11 -0
  140. package/src/schema/validation-types.ts +148 -0
  141. package/src/skills/skill-templates.ts +374 -0
  142. package/src/state/active-run-registry.ts +35 -11
  143. package/src/state/atomic-write.ts +33 -26
  144. package/src/state/contracts.ts +1 -0
  145. package/src/state/event-reconstructor.ts +217 -0
  146. package/src/state/locks.ts +2 -13
  147. package/src/state/mailbox.ts +4 -3
  148. package/src/state/state-store.ts +32 -14
  149. package/src/state/task-claims.ts +44 -44
  150. package/src/state/types.ts +9 -0
  151. package/src/state/usage.ts +29 -29
  152. package/src/subagents/async-entry.ts +1 -1
  153. package/src/subagents/index.ts +3 -3
  154. package/src/subagents/live/control.ts +1 -1
  155. package/src/subagents/live/manager.ts +1 -1
  156. package/src/subagents/live/realtime.ts +1 -1
  157. package/src/subagents/live/session-runtime.ts +1 -1
  158. package/src/subagents/manager.ts +1 -1
  159. package/src/subagents/spawn.ts +1 -1
  160. package/src/teams/team-serializer.ts +38 -38
  161. package/src/types/diff.d.ts +18 -18
  162. package/src/ui/crew-footer.ts +101 -101
  163. package/src/ui/crew-select-list.ts +111 -111
  164. package/src/ui/crew-widget.ts +5 -2
  165. package/src/ui/dashboard-panes/cancellation-pane.ts +42 -42
  166. package/src/ui/dashboard-panes/capability-pane.ts +59 -59
  167. package/src/ui/dashboard-panes/mailbox-pane.ts +35 -35
  168. package/src/ui/dashboard-panes/metrics-pane.ts +34 -34
  169. package/src/ui/dashboard-panes/progress-pane.ts +11 -0
  170. package/src/ui/dynamic-border.ts +25 -25
  171. package/src/ui/layout-primitives.ts +106 -106
  172. package/src/ui/loaders.ts +158 -158
  173. package/src/ui/render-coalescer.ts +51 -51
  174. package/src/ui/render-diff.ts +119 -119
  175. package/src/ui/render-scheduler.ts +143 -143
  176. package/src/ui/run-action-dispatcher.ts +10 -1
  177. package/src/ui/spinner.ts +17 -17
  178. package/src/ui/status-colors.ts +58 -58
  179. package/src/ui/syntax-highlight.ts +116 -116
  180. package/src/ui/transcript-entries.ts +258 -258
  181. package/src/utils/completion-dedupe.ts +63 -63
  182. package/src/utils/frontmatter.ts +68 -68
  183. package/src/utils/git.ts +262 -262
  184. package/src/utils/ids.ts +17 -17
  185. package/src/utils/incremental-reader.ts +104 -104
  186. package/src/utils/names.ts +27 -27
  187. package/src/utils/redaction.ts +44 -44
  188. package/src/utils/safe-paths.ts +47 -47
  189. package/src/utils/scan-cache.ts +136 -136
  190. package/src/utils/sleep.ts +40 -26
  191. package/src/utils/task-name-generator.ts +337 -337
  192. package/src/workflows/validate-workflow.ts +40 -40
  193. package/src/worktree/branch-freshness.ts +45 -45
  194. package/teams/default.team.md +12 -12
  195. package/teams/fast-fix.team.md +11 -11
  196. package/teams/implementation.team.md +18 -18
  197. package/teams/parallel-research.team.md +14 -14
  198. package/teams/research.team.md +11 -11
  199. package/teams/review.team.md +12 -12
  200. package/workflows/default.workflow.md +30 -29
  201. package/workflows/fast-fix.workflow.md +23 -22
  202. package/workflows/implementation.workflow.md +43 -43
  203. package/workflows/parallel-research.workflow.md +46 -46
  204. package/workflows/research.workflow.md +22 -22
  205. package/workflows/review.workflow.md +30 -30
  206. package/docs/refactor-tasks-phase3.md +0 -394
  207. package/docs/refactor-tasks-phase4.md +0 -564
  208. package/docs/refactor-tasks-phase5.md +0 -402
  209. package/docs/refactor-tasks-phase6.md +0 -662
  210. package/docs/refactor-tasks.md +0 -1484
  211. package/docs/research/AGENT-EXECUTION-ARCHITECTURE.md +0 -261
  212. package/docs/research/AGENT-LIFECYCLE-COMPARISON.md +0 -111
  213. package/docs/research/AUDIT_OH_MY_PI.md +0 -261
  214. package/docs/research/AUDIT_PI_CREW.md +0 -457
  215. package/docs/research/CAVEMAN-DEEP-RESEARCH.md +0 -281
  216. package/docs/research/COMPARISON_OH_MY_PI_VS_PI_CREW.md +0 -264
  217. package/docs/research/DEEP-RESEARCH-PI-POWERBAR.md +0 -343
  218. package/docs/research/DEEP_RESEARCH_SUBAGENT_ARCHITECTURE.md +0 -480
  219. package/docs/research/GAP_CLOSURE_IMPLEMENTATION_PLAN.md +0 -354
  220. package/docs/research/IMPLEMENTATION_PLAN.md +0 -385
  221. package/docs/research/LIVE-SESSION-PRODUCTION-READY-PLAN.md +0 -502
  222. package/docs/research/OH-MY-PI-DEEP-RESEARCH-v14.7.6.md +0 -266
  223. package/docs/research/REMAINING-GAPS-PLAN.md +0 -363
  224. package/docs/research/SESSION-SUMMARY-2026-05-08.md +0 -146
  225. package/docs/research/UI-RESPONSIVENESS-AUDIT.md +0 -173
  226. package/docs/research-awesome-agent-skills-distillation.md +0 -100
  227. package/docs/research-extension-examples.md +0 -297
  228. package/docs/research-extension-system.md +0 -324
  229. package/docs/research-oh-my-pi-distillation.md +0 -369
  230. package/docs/research-optimization-plan.md +0 -548
  231. package/docs/research-phase10-distillation.md +0 -199
  232. package/docs/research-phase11-distillation.md +0 -201
  233. package/docs/research-phase8-operator-experience-plan.md +0 -819
  234. package/docs/research-phase9-observability-reliability-plan.md +0 -1190
  235. package/docs/research-pi-coding-agent.md +0 -357
  236. package/docs/research-source-pi-crew-reference.md +0 -174
  237. package/docs/research-ui-optimization-plan.md +0 -480
  238. package/docs/source-runtime-refactor-map.md +0 -107
  239. package/src/utils/atomic-write.ts +0 -33
package/src/ui/loaders.ts CHANGED
@@ -1,158 +1,158 @@
1
- import { pad, truncate } from "../utils/visual.ts";
2
- import type { CrewTheme } from "./theme-adapter.ts";
3
- import { asCrewTheme } from "./theme-adapter.ts";
4
- import { DynamicCrewBorder } from "./dynamic-border.ts";
5
-
6
- export interface BorderedLoaderOptions {
7
- message: string;
8
- cancellable?: boolean;
9
- frames?: string[];
10
- intervalMs?: number;
11
- minWidth?: number;
12
- onAbort?: () => void;
13
- }
14
-
15
- const DEFAULT_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
16
-
17
- export class CrewBorderedLoader {
18
- private readonly abortController = new AbortController();
19
- private readonly frameOptions: string[];
20
- private readonly intervalMs: number;
21
- private readonly minWidth: number;
22
- private readonly onAbort?: () => void;
23
- private theme: CrewTheme;
24
- private message: string;
25
- private lineCache = "";
26
- private width = 0;
27
- private startedAt = Date.now();
28
-
29
- constructor(_ui: unknown, themeLike: unknown, options: BorderedLoaderOptions) {
30
- const theme = asCrewTheme(themeLike);
31
- this.theme = theme;
32
- this.message = options.message;
33
- this.minWidth = Math.max(12, options.minWidth ?? 24);
34
- this.onAbort = options.onAbort;
35
- this.frameOptions = options.frames ?? DEFAULT_FRAMES;
36
- this.intervalMs = Math.max(40, options.intervalMs ?? 120);
37
- }
38
-
39
- private spinnerFrame(): string {
40
- if (this.frameOptions.length === 0) return "•";
41
- const elapsed = Date.now() - this.startedAt;
42
- const index = Math.floor(elapsed / this.intervalMs) % this.frameOptions.length;
43
- return this.frameOptions[Math.max(0, index)];
44
- }
45
-
46
- setMessage(message: string): void {
47
- this.message = message;
48
- }
49
-
50
- get signal(): AbortSignal {
51
- return this.abortController.signal;
52
- }
53
-
54
- handleInput(data: string): void {
55
- if (!this.onAbort || this.abortController.signal.aborted) return;
56
- if (data === "c" || data === "q" || data === "\u001b" || data === "\u0003") {
57
- this.abortController.abort();
58
- this.onAbort();
59
- }
60
- }
61
-
62
- render(width: number): string[] {
63
- if (width === this.width && this.lineCache) {
64
- return this.lineCache.split("\n");
65
- }
66
- const innerWidth = Math.max(this.minWidth - 4, 1);
67
- const contentWidth = Math.max(1, Math.min(width - 4, innerWidth));
68
- const frame = this.spinnerFrame();
69
- const loaderLine = ` ${frame} ${truncate(this.message, Math.max(1, contentWidth - 4))} `;
70
- const body = ` ${truncate(loaderLine, contentWidth - 2)} `;
71
- const inner = ` ${pad(body, contentWidth - 1)} `;
72
- const padWidth = Math.max(0, width - (contentWidth + 4));
73
- const leftRightPad = " ".repeat(Math.floor(padWidth / 2));
74
- const widthAwareInner = contentWidth + padWidth;
75
- const border = new DynamicCrewBorder(this.theme).render(widthAwareInner + 2)[0];
76
- const top = `${leftRightPad}${this.theme.fg("border", "┌")}${border}${this.theme.fg("border", "┐")}`;
77
- const line = `${leftRightPad}${this.theme.fg("border", "│")} ${truncate(inner, widthAwareInner)} ${this.theme.fg("border", "│")}`;
78
- const hint = `${leftRightPad}${this.theme.fg("border", "│")}${" ".repeat(widthAwareInner + 2)}${this.theme.fg("border", "│")}`;
79
- const bottom = `${leftRightPad}${this.theme.fg("border", "└")}${border}${this.theme.fg("border", "┘")}`;
80
- const lineWithHint = optionsHint(this.theme, this.message, widthAwareInner);
81
- this.width = width;
82
- const lines = [
83
- top,
84
- line,
85
- `${leftRightPad}│ ${pad(lineWithHint, widthAwareInner)} │`,
86
- hint,
87
- bottom,
88
- ];
89
- this.lineCache = lines.join("\n");
90
- return lines;
91
- }
92
-
93
- invalidate(): void {
94
- this.lineCache = "";
95
- this.width = 0;
96
- }
97
-
98
- dispose(): void {
99
- this.abortController.abort();
100
- }
101
- }
102
-
103
- export interface CountdownTimerOptions {
104
- timeoutMs: number;
105
- onTick: (seconds: number) => void;
106
- onExpire: () => void;
107
- }
108
-
109
- export class CountdownTimer {
110
- private readonly onExpire: () => void;
111
- private readonly onTick: (seconds: number) => void;
112
- private readonly startedAt: number;
113
- private readonly timeoutMs: number;
114
- private timer: ReturnType<typeof setTimeout> | undefined;
115
- private expired = false;
116
-
117
- constructor(options: CountdownTimerOptions) {
118
- this.timeoutMs = Math.max(0, options.timeoutMs);
119
- this.onTick = options.onTick;
120
- this.onExpire = options.onExpire;
121
- this.startedAt = Date.now();
122
- this.onTick(this.secondsLeft());
123
- if (this.timeoutMs === 0) {
124
- this.emitExpire();
125
- return;
126
- }
127
- this.timer = setInterval(() => {
128
- const seconds = this.secondsLeft();
129
- this.onTick(seconds);
130
- if (seconds <= 0) {
131
- this.emitExpire();
132
- }
133
- }, 1000);
134
- }
135
-
136
- private emitExpire(): void {
137
- if (this.expired) return;
138
- this.expired = true;
139
- this.dispose();
140
- this.onExpire();
141
- }
142
-
143
- private secondsLeft(): number {
144
- const remainingMs = this.startedAt + this.timeoutMs - Date.now();
145
- return Math.max(0, Math.ceil(remainingMs / 1000));
146
- }
147
-
148
- dispose(): void {
149
- if (this.timer === undefined) return;
150
- clearInterval(this.timer);
151
- this.timer = undefined;
152
- }
153
- }
154
-
155
- function optionsHint(theme: CrewTheme, message: string, width: number): string {
156
- if (!message) return "";
157
- return truncate(theme.fg("muted", message), width);
158
- }
1
+ import { pad, truncate } from "../utils/visual.ts";
2
+ import type { CrewTheme } from "./theme-adapter.ts";
3
+ import { asCrewTheme } from "./theme-adapter.ts";
4
+ import { DynamicCrewBorder } from "./dynamic-border.ts";
5
+
6
+ export interface BorderedLoaderOptions {
7
+ message: string;
8
+ cancellable?: boolean;
9
+ frames?: string[];
10
+ intervalMs?: number;
11
+ minWidth?: number;
12
+ onAbort?: () => void;
13
+ }
14
+
15
+ const DEFAULT_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
16
+
17
+ export class CrewBorderedLoader {
18
+ private readonly abortController = new AbortController();
19
+ private readonly frameOptions: string[];
20
+ private readonly intervalMs: number;
21
+ private readonly minWidth: number;
22
+ private readonly onAbort?: () => void;
23
+ private theme: CrewTheme;
24
+ private message: string;
25
+ private lineCache = "";
26
+ private width = 0;
27
+ private startedAt = Date.now();
28
+
29
+ constructor(_ui: unknown, themeLike: unknown, options: BorderedLoaderOptions) {
30
+ const theme = asCrewTheme(themeLike);
31
+ this.theme = theme;
32
+ this.message = options.message;
33
+ this.minWidth = Math.max(12, options.minWidth ?? 24);
34
+ this.onAbort = options.onAbort;
35
+ this.frameOptions = options.frames ?? DEFAULT_FRAMES;
36
+ this.intervalMs = Math.max(40, options.intervalMs ?? 120);
37
+ }
38
+
39
+ private spinnerFrame(): string {
40
+ if (this.frameOptions.length === 0) return "•";
41
+ const elapsed = Date.now() - this.startedAt;
42
+ const index = Math.floor(elapsed / this.intervalMs) % this.frameOptions.length;
43
+ return this.frameOptions[Math.max(0, index)];
44
+ }
45
+
46
+ setMessage(message: string): void {
47
+ this.message = message;
48
+ }
49
+
50
+ get signal(): AbortSignal {
51
+ return this.abortController.signal;
52
+ }
53
+
54
+ handleInput(data: string): void {
55
+ if (!this.onAbort || this.abortController.signal.aborted) return;
56
+ if (data === "c" || data === "q" || data === "\u001b" || data === "\u0003") {
57
+ this.abortController.abort();
58
+ this.onAbort();
59
+ }
60
+ }
61
+
62
+ render(width: number): string[] {
63
+ if (width === this.width && this.lineCache) {
64
+ return this.lineCache.split("\n");
65
+ }
66
+ const innerWidth = Math.max(this.minWidth - 4, 1);
67
+ const contentWidth = Math.max(1, Math.min(width - 4, innerWidth));
68
+ const frame = this.spinnerFrame();
69
+ const loaderLine = ` ${frame} ${truncate(this.message, Math.max(1, contentWidth - 4))} `;
70
+ const body = ` ${truncate(loaderLine, contentWidth - 2)} `;
71
+ const inner = ` ${pad(body, contentWidth - 1)} `;
72
+ const padWidth = Math.max(0, width - (contentWidth + 4));
73
+ const leftRightPad = " ".repeat(Math.floor(padWidth / 2));
74
+ const widthAwareInner = contentWidth + padWidth;
75
+ const border = new DynamicCrewBorder(this.theme).render(widthAwareInner + 2)[0];
76
+ const top = `${leftRightPad}${this.theme.fg("border", "┌")}${border}${this.theme.fg("border", "┐")}`;
77
+ const line = `${leftRightPad}${this.theme.fg("border", "│")} ${truncate(inner, widthAwareInner)} ${this.theme.fg("border", "│")}`;
78
+ const hint = `${leftRightPad}${this.theme.fg("border", "│")}${" ".repeat(widthAwareInner + 2)}${this.theme.fg("border", "│")}`;
79
+ const bottom = `${leftRightPad}${this.theme.fg("border", "└")}${border}${this.theme.fg("border", "┘")}`;
80
+ const lineWithHint = optionsHint(this.theme, this.message, widthAwareInner);
81
+ this.width = width;
82
+ const lines = [
83
+ top,
84
+ line,
85
+ `${leftRightPad}│ ${pad(lineWithHint, widthAwareInner)} │`,
86
+ hint,
87
+ bottom,
88
+ ];
89
+ this.lineCache = lines.join("\n");
90
+ return lines;
91
+ }
92
+
93
+ invalidate(): void {
94
+ this.lineCache = "";
95
+ this.width = 0;
96
+ }
97
+
98
+ dispose(): void {
99
+ this.abortController.abort();
100
+ }
101
+ }
102
+
103
+ export interface CountdownTimerOptions {
104
+ timeoutMs: number;
105
+ onTick: (seconds: number) => void;
106
+ onExpire: () => void;
107
+ }
108
+
109
+ export class CountdownTimer {
110
+ private readonly onExpire: () => void;
111
+ private readonly onTick: (seconds: number) => void;
112
+ private readonly startedAt: number;
113
+ private readonly timeoutMs: number;
114
+ private timer: ReturnType<typeof setTimeout> | undefined;
115
+ private expired = false;
116
+
117
+ constructor(options: CountdownTimerOptions) {
118
+ this.timeoutMs = Math.max(0, options.timeoutMs);
119
+ this.onTick = options.onTick;
120
+ this.onExpire = options.onExpire;
121
+ this.startedAt = Date.now();
122
+ this.onTick(this.secondsLeft());
123
+ if (this.timeoutMs === 0) {
124
+ this.emitExpire();
125
+ return;
126
+ }
127
+ this.timer = setInterval(() => {
128
+ const seconds = this.secondsLeft();
129
+ this.onTick(seconds);
130
+ if (seconds <= 0) {
131
+ this.emitExpire();
132
+ }
133
+ }, 1000);
134
+ }
135
+
136
+ private emitExpire(): void {
137
+ if (this.expired) return;
138
+ this.expired = true;
139
+ this.dispose();
140
+ this.onExpire();
141
+ }
142
+
143
+ private secondsLeft(): number {
144
+ const remainingMs = this.startedAt + this.timeoutMs - Date.now();
145
+ return Math.max(0, Math.ceil(remainingMs / 1000));
146
+ }
147
+
148
+ dispose(): void {
149
+ if (this.timer === undefined) return;
150
+ clearInterval(this.timer);
151
+ this.timer = undefined;
152
+ }
153
+ }
154
+
155
+ function optionsHint(theme: CrewTheme, message: string, width: number): string {
156
+ if (!message) return "";
157
+ return truncate(theme.fg("muted", message), width);
158
+ }
@@ -1,51 +1,51 @@
1
- /**
2
- * RenderCoalescer — batches multiple render requests into single render passes.
3
- * Prevents UI flicker when many events arrive in quick succession.
4
- * Inspired by oh-my-pi's PROGRESS_COALESCE_MS (150ms) pattern.
5
- */
6
- export class RenderCoalescer {
7
- #pending = false;
8
- #timerId: ReturnType<typeof setTimeout> | null = null;
9
- #callback: () => void;
10
- #intervalMs: number;
11
-
12
- constructor(callback: () => void, intervalMs = 32) {
13
- this.#callback = callback;
14
- this.#intervalMs = intervalMs;
15
- }
16
-
17
- /** Request a render. Will be coalesced with other requests within the interval. */
18
- request(): void {
19
- if (this.#pending) return;
20
- this.#pending = true;
21
- this.#timerId = setTimeout(() => {
22
- this.#pending = false;
23
- this.#timerId = null;
24
- this.#callback();
25
- }, this.#intervalMs);
26
- }
27
-
28
- /** Force an immediate render, bypassing coalescing. */
29
- flush(): void {
30
- if (this.#timerId !== null) {
31
- clearTimeout(this.#timerId);
32
- this.#timerId = null;
33
- }
34
- this.#pending = false;
35
- this.#callback();
36
- }
37
-
38
- /** Check if a render is pending. */
39
- get pending(): boolean {
40
- return this.#pending;
41
- }
42
-
43
- /** Clean up timers. Call when the coalescer is no longer needed. */
44
- dispose(): void {
45
- if (this.#timerId !== null) {
46
- clearTimeout(this.#timerId);
47
- this.#timerId = null;
48
- }
49
- this.#pending = false;
50
- }
51
- }
1
+ /**
2
+ * RenderCoalescer — batches multiple render requests into single render passes.
3
+ * Prevents UI flicker when many events arrive in quick succession.
4
+ * Inspired by oh-my-pi's PROGRESS_COALESCE_MS (150ms) pattern.
5
+ */
6
+ export class RenderCoalescer {
7
+ #pending = false;
8
+ #timerId: ReturnType<typeof setTimeout> | null = null;
9
+ #callback: () => void;
10
+ #intervalMs: number;
11
+
12
+ constructor(callback: () => void, intervalMs = 32) {
13
+ this.#callback = callback;
14
+ this.#intervalMs = intervalMs;
15
+ }
16
+
17
+ /** Request a render. Will be coalesced with other requests within the interval. */
18
+ request(): void {
19
+ if (this.#pending) return;
20
+ this.#pending = true;
21
+ this.#timerId = setTimeout(() => {
22
+ this.#pending = false;
23
+ this.#timerId = null;
24
+ this.#callback();
25
+ }, this.#intervalMs);
26
+ }
27
+
28
+ /** Force an immediate render, bypassing coalescing. */
29
+ flush(): void {
30
+ if (this.#timerId !== null) {
31
+ clearTimeout(this.#timerId);
32
+ this.#timerId = null;
33
+ }
34
+ this.#pending = false;
35
+ this.#callback();
36
+ }
37
+
38
+ /** Check if a render is pending. */
39
+ get pending(): boolean {
40
+ return this.#pending;
41
+ }
42
+
43
+ /** Clean up timers. Call when the coalescer is no longer needed. */
44
+ dispose(): void {
45
+ if (this.#timerId !== null) {
46
+ clearTimeout(this.#timerId);
47
+ this.#timerId = null;
48
+ }
49
+ this.#pending = false;
50
+ }
51
+ }
@@ -1,119 +1,119 @@
1
- import * as Diff from "diff";
2
- import type { CrewTheme } from "./theme-adapter.ts";
3
- import { asCrewTheme } from "./theme-adapter.ts";
4
-
5
- interface ParsedDiffLine {
6
- prefix: string;
7
- lineNum: string; content: string;
8
- }
9
-
10
- interface DiffLineContent {
11
- lineNum: string;
12
- content: string;
13
- }
14
-
15
- function parseDiffLine(line: string): ParsedDiffLine | null {
16
- const match = line.match(/^([+-\s])(\s*\d*)\s(.*)$/);
17
- if (!match) return null;
18
- return { prefix: match[1], lineNum: match[2], content: match[3] };
19
- }
20
-
21
- function replaceTabs(text: string): string {
22
- return text.replace(/\t/g, " ");
23
- }
24
-
25
- function renderIntraLineDiff(theme: CrewTheme, oldContent: string, newContent: string): { removedLine: string; addedLine: string } {
26
- const wordDiff = Diff.diffWords(oldContent, newContent);
27
- let removedLine = "";
28
- let addedLine = "";
29
- let isFirstRemoved = true;
30
- let isFirstAdded = true;
31
-
32
- for (const part of wordDiff) {
33
- if (part.removed) {
34
- let value = part.value;
35
- if (isFirstRemoved) {
36
- const leadingWs = value.match(/^(\s*)/)?.[1] ?? "";
37
- value = value.slice(leadingWs.length);
38
- removedLine += leadingWs;
39
- isFirstRemoved = false;
40
- }
41
- if (value) removedLine += theme.inverse?.(value) ?? value;
42
- } else if (part.added) {
43
- let value = part.value;
44
- if (isFirstAdded) {
45
- const leadingWs = value.match(/^(\s*)/)?.[1] ?? "";
46
- value = value.slice(leadingWs.length);
47
- addedLine += leadingWs;
48
- isFirstAdded = false;
49
- }
50
- if (value) addedLine += theme.inverse?.(value) ?? value;
51
- } else {
52
- removedLine += part.value;
53
- addedLine += part.value;
54
- }
55
- }
56
-
57
- return { removedLine, addedLine };
58
- }
59
-
60
- export interface RenderDiffOptions {
61
- filePath?: string;
62
- theme?: unknown;
63
- }
64
-
65
- export function renderDiff(diffText: string, options: RenderDiffOptions = {}): string {
66
- const theme = asCrewTheme(options.theme);
67
- const lines = diffText.split("\n");
68
- const result: string[] = [];
69
- let i = 0;
70
-
71
- while (i < lines.length) {
72
- const line = lines[i] ?? "";
73
- const parsed = parseDiffLine(line);
74
- if (!parsed) {
75
- result.push(theme.fg("toolDiffContext", line));
76
- i++;
77
- continue;
78
- }
79
-
80
- if (parsed.prefix === "-") {
81
- const removedLines: DiffLineContent[] = [];
82
- while (i < lines.length) {
83
- const nextParsed = parseDiffLine(lines[i] ?? "");
84
- if (!nextParsed || nextParsed.prefix !== "-") break;
85
- removedLines.push({ lineNum: nextParsed.lineNum, content: nextParsed.content });
86
- i++;
87
- }
88
-
89
- const addedLines: DiffLineContent[] = [];
90
- while (i < lines.length) {
91
- const nextParsed = parseDiffLine(lines[i] ?? "");
92
- if (!nextParsed || nextParsed.prefix !== "+") break;
93
- addedLines.push({ lineNum: nextParsed.lineNum, content: nextParsed.content });
94
- i++;
95
- }
96
-
97
- if (removedLines.length === 1 && addedLines.length === 1) {
98
- const { removedLine, addedLine } = renderIntraLineDiff(theme, replaceTabs(removedLines[0]!.content), replaceTabs(addedLines[0]!.content));
99
- result.push(theme.fg("toolDiffRemoved", `-${removedLines[0]!.lineNum} ${removedLine}`));
100
- result.push(theme.fg("toolDiffAdded", `+${addedLines[0]!.lineNum} ${addedLine}`));
101
- } else {
102
- for (const removed of removedLines) {
103
- result.push(theme.fg("toolDiffRemoved", `-${removed.lineNum} ${replaceTabs(removed.content)}`));
104
- }
105
- for (const added of addedLines) {
106
- result.push(theme.fg("toolDiffAdded", `+${added.lineNum} ${replaceTabs(added.content)}`));
107
- }
108
- }
109
- } else if (parsed.prefix === "+") {
110
- result.push(theme.fg("toolDiffAdded", `+${parsed.lineNum} ${replaceTabs(parsed.content)}`));
111
- i++;
112
- } else {
113
- result.push(theme.fg("toolDiffContext", ` ${parsed.lineNum} ${replaceTabs(parsed.content)}`));
114
- i++;
115
- }
116
- }
117
-
118
- return result.join("\n");
119
- }
1
+ import * as Diff from "diff";
2
+ import type { CrewTheme } from "./theme-adapter.ts";
3
+ import { asCrewTheme } from "./theme-adapter.ts";
4
+
5
+ interface ParsedDiffLine {
6
+ prefix: string;
7
+ lineNum: string; content: string;
8
+ }
9
+
10
+ interface DiffLineContent {
11
+ lineNum: string;
12
+ content: string;
13
+ }
14
+
15
+ function parseDiffLine(line: string): ParsedDiffLine | null {
16
+ const match = line.match(/^([+-\s])(\s*\d*)\s(.*)$/);
17
+ if (!match) return null;
18
+ return { prefix: match[1], lineNum: match[2], content: match[3] };
19
+ }
20
+
21
+ function replaceTabs(text: string): string {
22
+ return text.replace(/\t/g, " ");
23
+ }
24
+
25
+ function renderIntraLineDiff(theme: CrewTheme, oldContent: string, newContent: string): { removedLine: string; addedLine: string } {
26
+ const wordDiff = Diff.diffWords(oldContent, newContent);
27
+ let removedLine = "";
28
+ let addedLine = "";
29
+ let isFirstRemoved = true;
30
+ let isFirstAdded = true;
31
+
32
+ for (const part of wordDiff) {
33
+ if (part.removed) {
34
+ let value = part.value;
35
+ if (isFirstRemoved) {
36
+ const leadingWs = value.match(/^(\s*)/)?.[1] ?? "";
37
+ value = value.slice(leadingWs.length);
38
+ removedLine += leadingWs;
39
+ isFirstRemoved = false;
40
+ }
41
+ if (value) removedLine += theme.inverse?.(value) ?? value;
42
+ } else if (part.added) {
43
+ let value = part.value;
44
+ if (isFirstAdded) {
45
+ const leadingWs = value.match(/^(\s*)/)?.[1] ?? "";
46
+ value = value.slice(leadingWs.length);
47
+ addedLine += leadingWs;
48
+ isFirstAdded = false;
49
+ }
50
+ if (value) addedLine += theme.inverse?.(value) ?? value;
51
+ } else {
52
+ removedLine += part.value;
53
+ addedLine += part.value;
54
+ }
55
+ }
56
+
57
+ return { removedLine, addedLine };
58
+ }
59
+
60
+ export interface RenderDiffOptions {
61
+ filePath?: string;
62
+ theme?: unknown;
63
+ }
64
+
65
+ export function renderDiff(diffText: string, options: RenderDiffOptions = {}): string {
66
+ const theme = asCrewTheme(options.theme);
67
+ const lines = diffText.split("\n");
68
+ const result: string[] = [];
69
+ let i = 0;
70
+
71
+ while (i < lines.length) {
72
+ const line = lines[i] ?? "";
73
+ const parsed = parseDiffLine(line);
74
+ if (!parsed) {
75
+ result.push(theme.fg("toolDiffContext", line));
76
+ i++;
77
+ continue;
78
+ }
79
+
80
+ if (parsed.prefix === "-") {
81
+ const removedLines: DiffLineContent[] = [];
82
+ while (i < lines.length) {
83
+ const nextParsed = parseDiffLine(lines[i] ?? "");
84
+ if (!nextParsed || nextParsed.prefix !== "-") break;
85
+ removedLines.push({ lineNum: nextParsed.lineNum, content: nextParsed.content });
86
+ i++;
87
+ }
88
+
89
+ const addedLines: DiffLineContent[] = [];
90
+ while (i < lines.length) {
91
+ const nextParsed = parseDiffLine(lines[i] ?? "");
92
+ if (!nextParsed || nextParsed.prefix !== "+") break;
93
+ addedLines.push({ lineNum: nextParsed.lineNum, content: nextParsed.content });
94
+ i++;
95
+ }
96
+
97
+ if (removedLines.length === 1 && addedLines.length === 1) {
98
+ const { removedLine, addedLine } = renderIntraLineDiff(theme, replaceTabs(removedLines[0]!.content), replaceTabs(addedLines[0]!.content));
99
+ result.push(theme.fg("toolDiffRemoved", `-${removedLines[0]!.lineNum} ${removedLine}`));
100
+ result.push(theme.fg("toolDiffAdded", `+${addedLines[0]!.lineNum} ${addedLine}`));
101
+ } else {
102
+ for (const removed of removedLines) {
103
+ result.push(theme.fg("toolDiffRemoved", `-${removed.lineNum} ${replaceTabs(removed.content)}`));
104
+ }
105
+ for (const added of addedLines) {
106
+ result.push(theme.fg("toolDiffAdded", `+${added.lineNum} ${replaceTabs(added.content)}`));
107
+ }
108
+ }
109
+ } else if (parsed.prefix === "+") {
110
+ result.push(theme.fg("toolDiffAdded", `+${parsed.lineNum} ${replaceTabs(parsed.content)}`));
111
+ i++;
112
+ } else {
113
+ result.push(theme.fg("toolDiffContext", ` ${parsed.lineNum} ${replaceTabs(parsed.content)}`));
114
+ i++;
115
+ }
116
+ }
117
+
118
+ return result.join("\n");
119
+ }