pi-crew 0.1.45 → 0.1.46

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 (198) hide show
  1. package/README.md +5 -5
  2. package/agents/analyst.md +1 -1
  3. package/agents/critic.md +1 -1
  4. package/agents/executor.md +1 -1
  5. package/agents/explorer.md +1 -1
  6. package/agents/planner.md +1 -1
  7. package/agents/reviewer.md +1 -1
  8. package/agents/security-reviewer.md +1 -1
  9. package/agents/test-engineer.md +1 -1
  10. package/agents/verifier.md +1 -1
  11. package/agents/writer.md +1 -1
  12. package/docs/next-upgrade-roadmap.md +733 -0
  13. package/docs/refactor-tasks-phase3.md +394 -394
  14. package/docs/refactor-tasks-phase4.md +564 -564
  15. package/docs/refactor-tasks-phase5.md +402 -402
  16. package/docs/refactor-tasks-phase6.md +662 -662
  17. package/docs/research-awesome-agent-skills-distillation.md +100 -0
  18. package/docs/research-extension-examples.md +297 -297
  19. package/docs/research-extension-system.md +324 -324
  20. package/docs/research-oh-my-pi-distillation.md +322 -0
  21. package/docs/research-optimization-plan.md +548 -548
  22. package/docs/research-phase10-distillation.md +198 -198
  23. package/docs/research-phase11-distillation.md +201 -201
  24. package/docs/research-pi-coding-agent.md +357 -357
  25. package/docs/research-source-pi-crew-reference.md +174 -174
  26. package/docs/runtime-flow.md +148 -148
  27. package/docs/source-runtime-refactor-map.md +107 -83
  28. package/docs/usage.md +3 -3
  29. package/index.ts +6 -6
  30. package/install.mjs +52 -8
  31. package/package.json +1 -1
  32. package/schema.json +2 -1
  33. package/skills/async-worker-recovery/SKILL.md +42 -0
  34. package/skills/context-artifact-hygiene/SKILL.md +52 -0
  35. package/skills/delegation-patterns/SKILL.md +54 -0
  36. package/skills/mailbox-interactive/SKILL.md +40 -0
  37. package/skills/model-routing-context/SKILL.md +39 -0
  38. package/skills/multi-perspective-review/SKILL.md +58 -0
  39. package/skills/observability-reliability/SKILL.md +41 -0
  40. package/skills/ownership-session-security/SKILL.md +41 -0
  41. package/skills/pi-extension-lifecycle/SKILL.md +39 -0
  42. package/skills/requirements-to-task-packet/SKILL.md +63 -0
  43. package/skills/resource-discovery-config/SKILL.md +41 -0
  44. package/skills/runtime-state-reader/SKILL.md +44 -0
  45. package/skills/secure-agent-orchestration-review/SKILL.md +45 -0
  46. package/skills/state-mutation-locking/SKILL.md +42 -0
  47. package/skills/systematic-debugging/SKILL.md +67 -0
  48. package/skills/ui-render-performance/SKILL.md +39 -0
  49. package/skills/verification-before-done/SKILL.md +57 -0
  50. package/skills/worktree-isolation/SKILL.md +39 -0
  51. package/src/agents/agent-serializer.ts +34 -34
  52. package/src/agents/discover-agents.ts +12 -11
  53. package/src/config/config.ts +48 -24
  54. package/src/config/defaults.ts +14 -0
  55. package/src/extension/cross-extension-rpc.ts +82 -82
  56. package/src/extension/project-init.ts +62 -2
  57. package/src/extension/register.ts +11 -9
  58. package/src/extension/registration/commands.ts +32 -25
  59. package/src/extension/registration/compaction-guard.ts +125 -125
  60. package/src/extension/registration/subagent-helpers.ts +8 -0
  61. package/src/extension/registration/subagent-tools.ts +149 -148
  62. package/src/extension/registration/team-tool.ts +8 -6
  63. package/src/extension/run-bundle-schema.ts +89 -89
  64. package/src/extension/run-index.ts +13 -5
  65. package/src/extension/run-maintenance.ts +62 -43
  66. package/src/extension/team-tool/api.ts +25 -8
  67. package/src/extension/team-tool/cancel.ts +33 -4
  68. package/src/extension/team-tool/context.ts +5 -0
  69. package/src/extension/team-tool/handle-settings.ts +188 -188
  70. package/src/extension/team-tool/inspect.ts +41 -41
  71. package/src/extension/team-tool/lifecycle-actions.ts +91 -79
  72. package/src/extension/team-tool/plan.ts +19 -19
  73. package/src/extension/team-tool/respond.ts +37 -17
  74. package/src/extension/team-tool/run.ts +52 -10
  75. package/src/extension/team-tool/status.ts +12 -1
  76. package/src/extension/team-tool-types.ts +2 -0
  77. package/src/extension/team-tool.ts +32 -11
  78. package/src/i18n.ts +184 -184
  79. package/src/observability/event-to-metric.ts +8 -1
  80. package/src/observability/exporters/otlp-exporter.ts +77 -77
  81. package/src/prompt/prompt-runtime.ts +72 -72
  82. package/src/runtime/agent-control.ts +63 -63
  83. package/src/runtime/agent-memory.ts +72 -72
  84. package/src/runtime/agent-observability.ts +114 -114
  85. package/src/runtime/async-marker.ts +26 -26
  86. package/src/runtime/attention-events.ts +28 -28
  87. package/src/runtime/background-runner.ts +59 -53
  88. package/src/runtime/cancellation.ts +51 -0
  89. package/src/runtime/child-pi.ts +457 -444
  90. package/src/runtime/completion-guard.ts +190 -190
  91. package/src/runtime/crash-recovery.ts +1 -0
  92. package/src/runtime/crew-agent-records.ts +38 -6
  93. package/src/runtime/deadletter.ts +1 -0
  94. package/src/runtime/delivery-coordinator.ts +46 -25
  95. package/src/runtime/direct-run.ts +35 -35
  96. package/src/runtime/effectiveness.ts +76 -0
  97. package/src/runtime/foreground-control.ts +82 -82
  98. package/src/runtime/green-contract.ts +46 -46
  99. package/src/runtime/group-join.ts +106 -106
  100. package/src/runtime/heartbeat-gradient.ts +28 -28
  101. package/src/runtime/heartbeat-watcher.ts +124 -124
  102. package/src/runtime/live-agent-control.ts +88 -87
  103. package/src/runtime/live-agent-manager.ts +103 -85
  104. package/src/runtime/live-control-realtime.ts +36 -36
  105. package/src/runtime/live-session-runtime.ts +309 -305
  106. package/src/runtime/manifest-cache.ts +17 -2
  107. package/src/runtime/model-fallback.ts +6 -4
  108. package/src/runtime/parallel-research.ts +44 -44
  109. package/src/runtime/pi-args.ts +18 -3
  110. package/src/runtime/pi-json-output.ts +111 -111
  111. package/src/runtime/policy-engine.ts +79 -79
  112. package/src/runtime/process-status.ts +5 -1
  113. package/src/runtime/progress-event-coalescer.ts +43 -43
  114. package/src/runtime/recovery-recipes.ts +74 -74
  115. package/src/runtime/retry-executor.ts +81 -64
  116. package/src/runtime/role-permission.ts +39 -39
  117. package/src/runtime/runtime-resolver.ts +22 -6
  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/skill-instructions.ts +222 -0
  123. package/src/runtime/stale-reconciler.ts +4 -14
  124. package/src/runtime/subagent-manager.ts +3 -0
  125. package/src/runtime/supervisor-contact.ts +59 -59
  126. package/src/runtime/task-display.ts +38 -38
  127. package/src/runtime/task-output-context.ts +127 -127
  128. package/src/runtime/task-runner/capabilities.ts +78 -0
  129. package/src/runtime/task-runner/live-executor.ts +105 -101
  130. package/src/runtime/task-runner/progress.ts +119 -119
  131. package/src/runtime/task-runner/prompt-builder.ts +3 -1
  132. package/src/runtime/task-runner/prompt-pipeline.ts +64 -0
  133. package/src/runtime/task-runner/result-utils.ts +14 -14
  134. package/src/runtime/task-runner/state-helpers.ts +22 -22
  135. package/src/runtime/task-runner.ts +44 -5
  136. package/src/runtime/team-runner.ts +78 -15
  137. package/src/runtime/worker-heartbeat.ts +21 -21
  138. package/src/runtime/worker-startup.ts +57 -57
  139. package/src/schema/config-schema.ts +1 -0
  140. package/src/schema/team-tool-schema.ts +3 -3
  141. package/src/state/active-run-registry.ts +165 -0
  142. package/src/state/contracts.ts +1 -1
  143. package/src/state/mailbox.ts +44 -4
  144. package/src/state/state-store.ts +8 -1
  145. package/src/state/task-claims.ts +44 -44
  146. package/src/state/types.ts +44 -2
  147. package/src/state/usage.ts +29 -29
  148. package/src/subagents/async-entry.ts +1 -1
  149. package/src/subagents/index.ts +3 -3
  150. package/src/subagents/live/control.ts +1 -1
  151. package/src/subagents/live/manager.ts +1 -1
  152. package/src/subagents/live/realtime.ts +1 -1
  153. package/src/subagents/live/session-runtime.ts +1 -1
  154. package/src/subagents/manager.ts +1 -1
  155. package/src/subagents/spawn.ts +1 -1
  156. package/src/teams/team-config.ts +1 -0
  157. package/src/teams/team-serializer.ts +38 -38
  158. package/src/types/diff.d.ts +18 -18
  159. package/src/ui/crew-footer.ts +101 -101
  160. package/src/ui/crew-select-list.ts +111 -111
  161. package/src/ui/crew-widget.ts +4 -3
  162. package/src/ui/dashboard-panes/metrics-pane.ts +34 -34
  163. package/src/ui/dashboard-panes/progress-pane.ts +2 -0
  164. package/src/ui/dynamic-border.ts +25 -25
  165. package/src/ui/layout-primitives.ts +106 -106
  166. package/src/ui/loaders.ts +158 -158
  167. package/src/ui/render-diff.ts +119 -119
  168. package/src/ui/render-scheduler.ts +143 -143
  169. package/src/ui/run-snapshot-cache.ts +10 -2
  170. package/src/ui/snapshot-types.ts +2 -0
  171. package/src/ui/spinner.ts +17 -17
  172. package/src/ui/status-colors.ts +58 -58
  173. package/src/ui/syntax-highlight.ts +116 -116
  174. package/src/utils/atomic-write.ts +33 -33
  175. package/src/utils/completion-dedupe.ts +63 -63
  176. package/src/utils/frontmatter.ts +68 -68
  177. package/src/utils/git.ts +262 -262
  178. package/src/utils/ids.ts +12 -12
  179. package/src/utils/names.ts +27 -27
  180. package/src/utils/paths.ts +4 -2
  181. package/src/utils/redaction.ts +44 -44
  182. package/src/utils/safe-paths.ts +47 -47
  183. package/src/utils/sleep.ts +32 -32
  184. package/src/workflows/validate-workflow.ts +40 -40
  185. package/src/workflows/workflow-config.ts +1 -0
  186. package/src/worktree/branch-freshness.ts +45 -45
  187. package/teams/default.team.md +12 -12
  188. package/teams/fast-fix.team.md +11 -11
  189. package/teams/implementation.team.md +18 -18
  190. package/teams/parallel-research.team.md +14 -14
  191. package/teams/research.team.md +11 -11
  192. package/teams/review.team.md +12 -12
  193. package/workflows/default.workflow.md +29 -29
  194. package/workflows/fast-fix.workflow.md +22 -22
  195. package/workflows/implementation.workflow.md +38 -38
  196. package/workflows/parallel-research.workflow.md +46 -46
  197. package/workflows/research.workflow.md +22 -22
  198. package/workflows/review.workflow.md +30 -30
@@ -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
+ }
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
+ }