@bastani/atomic 0.8.31-alpha.5 → 0.9.0-alpha.2

package/dist/builtin/workflows/src/tui/workflow-attach-pane-types.ts

@@ -0,0 +1,85 @@
+import type { ChatMessageRenderOptions, ReadonlyFooterDataProvider } from "@bastani/atomic";
+import type { EditorComponent, EditorTheme, TUI } from "@earendil-works/pi-tui";
+import type { Store } from "../shared/store.js";
+import type { StageUiBroker } from "../shared/stage-ui-broker.js";
+import type { GraphTheme } from "./graph-theme.js";
+import type { StageControlRegistry } from "../runs/foreground/stage-control-registry.js";
+
+export interface AttachUiStatusSurface {
+  setStatus?: (key: string, value: string | undefined) => void;
+}
+
+export interface WorkflowAttachPaneOpts {
+  store: Store;
+  graphTheme: GraphTheme;
+  runId: string | null;
+  /**
+   * Live stage-control registry. The pane resolves stage handles when
+   * the user attaches to a node. Defaults to the singleton registry.
+   */
+  stageControlRegistry?: StageControlRegistry;
+  /** Broker used to route stage-local custom UI such as ask_user_question into attached chats. */
+  stageUiBroker?: StageUiBroker;
+  /**
+   * Optional UI status surface. When present, attaching/detaching
+   * updates the `pi-workflows` status tag with `<workflow>/<stage>`.
+   */
+  uiStatus?: AttachUiStatusSurface;
+  /** Called when the user closes (Escape in graph mode). */
+  onClose: () => void;
+  /** Called when the user requests the host to hide the popup. */
+  onHide?: () => void;
+  /** Called when the user kills the active run (q in graph mode). */
+  onKill?: (runId: string) => void;
+  /** Called when the user resolves a HIL prompt via the graph view. */
+  onPromptResolve?: (runId: string, promptId: string, response: unknown) => void;
+  /** Live pi-tui host objects used by attached stage chat to reuse coding-agent editor UI. */
+  piTui?: TUI;
+  piTheme?: unknown;
+  piKeybindings?: unknown;
+  /** Host custom editor factory installed by extensions via ctx.ui.setEditorComponent(). */
+  piEditorFactory?: (tui: TUI, theme: EditorTheme, keybindings: unknown) => EditorComponent;
+  /** Parent chat rendering settings and extension renderers, inherited from the host UI. */
+  getChatRenderSettings?: () => Partial<Omit<ChatMessageRenderOptions, "ui" | "cwd">> | undefined;
+  /** Parent footer data provider, inherited so attached chats can render the core coding-agent footer. */
+  footerData?: ReadonlyFooterDataProvider;
+  /**
+   * Optional override: pre-select chat mode for a stage on construction.
+   * Used by `/workflow attach <runId> <stageId>` so the popup opens
+   * directly on the node's chat.
+   */
+  initialAttachStageId?: string;
+  /**
+   * Optional accessor returning the current terminal row count. Threaded
+   * into both `GraphView` and `StageChatView` so the overlay renders a
+   * frame that fills the full viewport instead of a fixed 32-row pane.
+   * Returns `undefined` when the host has not surfaced terminal
+   * dimensions; views fall back to their constant row budget.
+   */
+  getViewportRows?: () => number | undefined;
+  /**
+   * Render-tick callback supplied by the overlay host. Forwarded to the
+   * embedded `GraphView` so its 10 FPS animation tick (running-stage
+   * border pulse, duration counter) can request frames without a key
+   * press. The host gates the underlying `tui.requestRender` on overlay
+   * visibility so a hidden pane stays cheap.
+   */
+  requestRender?: () => void;
+  /**
+   * Host hook to re-assert overlay keyboard focus. Threaded into the attached
+   * stage chat so showing a broker custom UI (e.g. the readiness gate) refocuses
+   * the overlay and the UI is not left input-dead (#1120).
+   */
+  requestFocus?: () => void;
+  /**
+   * Host hook for terminal mouse reporting. Graph mode uses wheel input
+   * for canvas scrolling; stage-chat mode uses it for transcript history
+   * scrolling and drops non-wheel mouse bytes before they reach the editor.
+   */
+  setMouseScrollTracking?: (enabled: boolean) => void;
+  /** Optional clock injection for deterministic transition-quarantine tests. */
+  now?: () => number;
+}
+
+export type WorkflowAttachPaneMode = "graph" | "stage-chat";
+

package/dist/builtin/workflows/src/tui/workflow-attach-pane.ts

@@ -48,84 +48,7 @@ import { WORKFLOW_STATUS_KEY } from "./workflow-status.js";
  * cross-ref: @bastani/atomic docs/extensions.md
  * §Widgets, Status, and Footer (`ctx.ui.setStatus`).
  */
-export interface AttachUiStatusSurface {
-  setStatus?: (key: string, value: string | undefined) => void;
-}
-
-export interface WorkflowAttachPaneOpts {
-  store: Store;
-  graphTheme: GraphTheme;
-  runId: string | null;
-  /**
-   * Live stage-control registry. The pane resolves stage handles when
-   * the user attaches to a node. Defaults to the singleton registry.
-   */
-  stageControlRegistry?: StageControlRegistry;
-  /** Broker used to route stage-local custom UI such as ask_user_question into attached chats. */
-  stageUiBroker?: StageUiBroker;
-  /**
-   * Optional UI status surface. When present, attaching/detaching
-   * updates the `pi-workflows` status tag with `<workflow>/<stage>`.
-   */
-  uiStatus?: AttachUiStatusSurface;
-  /** Called when the user closes (Escape in graph mode). */
-  onClose: () => void;
-  /** Called when the user requests the host to hide the popup. */
-  onHide?: () => void;
-  /** Called when the user kills the active run (q in graph mode). */
-  onKill?: (runId: string) => void;
-  /** Called when the user resolves a HIL prompt via the graph view. */
-  onPromptResolve?: (runId: string, promptId: string, response: unknown) => void;
-  /** Live pi-tui host objects used by attached stage chat to reuse coding-agent editor UI. */
-  piTui?: TUI;
-  piTheme?: unknown;
-  piKeybindings?: unknown;
-  /** Host custom editor factory installed by extensions via ctx.ui.setEditorComponent(). */
-  piEditorFactory?: (tui: TUI, theme: EditorTheme, keybindings: unknown) => EditorComponent;
-  /** Parent chat rendering settings and extension renderers, inherited from the host UI. */
-  getChatRenderSettings?: () => Partial<Omit<ChatMessageRenderOptions, "ui" | "cwd">> | undefined;
-  /** Parent footer data provider, inherited so attached chats can render the core coding-agent footer. */
-  footerData?: ReadonlyFooterDataProvider;
-  /**
-   * Optional override: pre-select chat mode for a stage on construction.
-   * Used by `/workflow attach <runId> <stageId>` so the popup opens
-   * directly on the node's chat.
-   */
-  initialAttachStageId?: string;
-  /**
-   * Optional accessor returning the current terminal row count. Threaded
-   * into both `GraphView` and `StageChatView` so the overlay renders a
-   * frame that fills the full viewport instead of a fixed 32-row pane.
-   * Returns `undefined` when the host has not surfaced terminal
-   * dimensions; views fall back to their constant row budget.
-   */
-  getViewportRows?: () => number | undefined;
-  /**
-   * Render-tick callback supplied by the overlay host. Forwarded to the
-   * embedded `GraphView` so its 10 FPS animation tick (running-stage
-   * border pulse, duration counter) can request frames without a key
-   * press. The host gates the underlying `tui.requestRender` on overlay
-   * visibility so a hidden pane stays cheap.
-   */
-  requestRender?: () => void;
-  /**
-   * Host hook to re-assert overlay keyboard focus. Threaded into the attached
-   * stage chat so showing a broker custom UI (e.g. the readiness gate) refocuses
-   * the overlay and the UI is not left input-dead (#1120).
-   */
-  requestFocus?: () => void;
-  /**
-   * Host hook for terminal mouse reporting. Graph mode uses wheel input
-   * for canvas scrolling; stage-chat mode uses it for transcript history
-   * scrolling and drops non-wheel mouse bytes before they reach the editor.
-   */
-  setMouseScrollTracking?: (enabled: boolean) => void;
-  /** Optional clock injection for deterministic transition-quarantine tests. */
-  now?: () => number;
-}
-
-export type WorkflowAttachPaneMode = "graph" | "stage-chat";
-
+import type { AttachUiStatusSurface, WorkflowAttachPaneMode, WorkflowAttachPaneOpts } from "./workflow-attach-pane-types.js";
 const ENTER_TRANSITION_QUARANTINE_MS = 200;
 
 export class WorkflowAttachPane implements Component {
@@ -162,13 +85,9 @@ export class WorkflowAttachPane implements Component {
   private lastAttachedStageId: string | null = null;
   /** Time-boxed guard for Enter leaking into graph mode during connect/detach transitions. */
   private graphEnterQuarantineUntil = 0;
-  /** Time-boxed guard for Enter leaking from graph attach into an attached prompt. */
   private stagePromptEnterQuarantineUntil = 0;
-  /** Last awaiting-input identity observed for graph-mode transition quarantine. */
   private lastGraphAwaitingInputKey: string | null = null;
-  /** Last awaiting-input identity observed for attached-stage transition quarantine. */
   private lastStageAwaitingInputKey: string | null = null;
-
   constructor(opts: WorkflowAttachPaneOpts) {
     this.store = opts.store;
     this.theme = opts.graphTheme;
@@ -191,10 +110,8 @@ export class WorkflowAttachPane implements Component {
     this.getChatRenderSettings = opts.getChatRenderSettings;
     this.footerData = opts.footerData;
     this.now = opts.now ?? Date.now;
-
     this.unsubscribeStore = this.store.subscribe((snapshot) => this._handleStoreUpdate(snapshot));
     this.graphView = this._buildGraphView();
-
     if (opts.initialAttachStageId !== undefined && this.runId) {
       const target = this._resolveGraphStageTarget(this.runId, opts.initialAttachStageId);
       this._attachToStage(target.runId, target.stageId);
@@ -205,7 +122,6 @@ export class WorkflowAttachPane implements Component {
       this._syncMouseScrollTracking();
     }
   }
-
   private _buildGraphView(initialFocusedStageId?: string): GraphView {
     return new GraphView({
       mode: "overlay",
@@ -225,16 +141,12 @@ export class WorkflowAttachPane implements Component {
       initialFocusedStageId,
       getViewportRows: this.getViewportRows,
       piKeybindings: this.piKeybindings,
-      // Gate the host render tick on `graph` mode. While the chat view
-      // is attached, the GraphView is hidden behind the chat — firing
-      // pi-tui renders for a frame the user can't see is wasted work.
       requestRender: () => {
         if (this.mode !== "graph") return;
         this.hostRequestRender?.();
       },
     });
   }
-
   private _resolveRunId(): string | null {
     if (this.runId) return this.runId;
     const active = this.store.activeRunId();
@@ -244,19 +156,16 @@ export class WorkflowAttachPane implements Component {
     }
     return null;
   }
-
   private _workflowName(runId: string): string {
     const snap = this.store.snapshot();
     const run = snap.runs.find((r) => r.id === runId);
     return run?.name ?? "workflow";
   }
-
   private _stageName(runId: string, stageId: string): string {
     const snap = this.store.snapshot();
     const run = snap.runs.find((r) => r.id === runId);
     return run?.stages.find((s) => s.id === stageId)?.name ?? "stage";
   }
-
   private _attachToStage(
     runId: string,
     stageId: string,
@@ -310,7 +219,6 @@ export class WorkflowAttachPane implements Component {
     this._setAttachedStatus(runId, stageId);
     this._syncMouseScrollTracking();
   }
-
   private _detachFromStage(
     reason: StageChatDetachReason = "user",
     metadata: StageChatDetachMetadata = {},
@@ -321,9 +229,6 @@ export class WorkflowAttachPane implements Component {
     this.chatView?.dispose();
     this.chatView = null;
     this.attachedRunId = null;
-    // Rebuild graph view so the focused stage matches the node we
-    // were just attached to (mockup contract: cursor still on
-    // `review-a` after Ctrl+D detach).
     this.graphView.dispose();
     this.graphView = this._buildGraphView(this.lastAttachedStageId ?? undefined);
     this.mode = "graph";
@@ -337,7 +242,6 @@ export class WorkflowAttachPane implements Component {
     this._setBaseStatus();
     this._syncMouseScrollTracking();
   }
-
   retarget(runId: string | null, stageId?: string): void {
     if (this.chatView && this.attachedRunId && this.lastAttachedStageId) {
       this.store.recordStageAttached(this.attachedRunId, this.lastAttachedStageId, false);
@@ -353,18 +257,15 @@ export class WorkflowAttachPane implements Component {
     this.stagePromptEnterQuarantineUntil = 0;
     this.graphView = this._buildGraphView();
     this._syncAwaitingInputKeys(this.store.snapshot());
-
     if (stageId !== undefined && runId) {
       const target = this._resolveGraphStageTarget(runId, stageId);
       this._attachToStage(target.runId, target.stageId);
       return;
     }
-
     this._armGraphEnterQuarantineIfRunNeedsInput();
     this._setBaseStatus();
     this._syncMouseScrollTracking();
   }
-
   private _resolveGraphStageTarget(rootRunId: string, stageId: string): { runId: string; stageId: string } {
     const graph = expandWorkflowGraph(this.store.snapshot(), rootRunId);
     const match = graph.stages.find((stage) =>
@@ -376,7 +277,6 @@ export class WorkflowAttachPane implements Component {
       stageId: match.workflowGraphTarget.stageId,
     };
   }
-
   private _handleStoreUpdate(snapshot: StoreSnapshot): void {
     if (!this.visible) {
       this._syncAwaitingInputKeys(snapshot);
@@ -406,7 +306,6 @@ export class WorkflowAttachPane implements Component {
       this.lastGraphAwaitingInputKey = this._runAwaitingInputKey(snapshot, runId);
     }
   }
-
   private _syncAwaitingInputKeys(snapshot: StoreSnapshot): void {
     const runId = this._resolveRunId();
     this.lastGraphAwaitingInputKey = runId ? this._runAwaitingInputKey(snapshot, runId) : null;
@@ -414,18 +313,15 @@ export class WorkflowAttachPane implements Component {
       ? this._stageAwaitingInputKey(snapshot, this.attachedRunId, this.lastAttachedStageId)
       : null;
   }
-
   private _setBaseStatus(): void {
     const runId = this._resolveRunId();
     const name = runId ? `${WORKFLOW_STATUS_KEY}/${this._workflowName(runId)}` : WORKFLOW_STATUS_KEY;
     this.uiStatus?.setStatus?.(WORKFLOW_STATUS_KEY, name);
   }
-
   private _setAttachedStatus(runId: string, stageId: string): void {
     const value = `${WORKFLOW_STATUS_KEY}/${this._workflowName(runId)}/${this._stageName(runId, stageId)}`;
     this.uiStatus?.setStatus?.(WORKFLOW_STATUS_KEY, value);
   }
-
   setVisible(visible: boolean): void {
     this.visible = visible;
     if (this.mode === "stage-chat" && this.attachedRunId && this.lastAttachedStageId) {
@@ -437,18 +333,15 @@ export class WorkflowAttachPane implements Component {
     if (visible) this._setBaseStatus();
     else this.uiStatus?.setStatus?.(WORKFLOW_STATUS_KEY, undefined);
   }
-
   private _syncMouseScrollTracking(): void {
     this.setMouseScrollTracking?.(this.wantsMouseScrollTracking());
   }
-
   wantsMouseScrollTracking(): boolean {
     if (this.mode === "stage-chat" && this.chatView) {
       return this.chatView.wantsMouseScrollTracking();
     }
     return this.mode === "graph";
   }
-
   wantsFocusForAwaitingInput(snapshot: StoreSnapshot): boolean {
     if (!this.visible) return false;
     const runId = this._resolveRunId();
@@ -463,14 +356,12 @@ export class WorkflowAttachPane implements Component {
     const stage = attachedRun?.stages.find((candidate) => candidate.id === this.lastAttachedStageId);
     return stage?.attached === true && this._stageSnapshotNeedsInput(stage);
   }
-
   render(width: number): string[] {
     if (this.mode === "stage-chat" && this.chatView) {
       return this.chatView.render(width);
     }
     return this.graphView.render(width);
   }
-
   handleInput(data: string): boolean | void {
     if (!this.visible) return false;
     if (this.mode === "stage-chat" && this.chatView) {
@@ -480,7 +371,6 @@ export class WorkflowAttachPane implements Component {
     if (this._shouldQuarantineGraphEnter(data)) return true;
     return this.graphView.handleInput(data);
   }
-
   private _shouldQuarantineStagePromptEnter(data: string): boolean {
     if (this.stagePromptEnterQuarantineUntil <= 0) return false;
     if (!matchesKey(data, Key.enter)) {
@@ -503,7 +393,6 @@ export class WorkflowAttachPane implements Component {
     this.stagePromptEnterQuarantineUntil = 0;
     return false;
   }
-
   private _shouldQuarantineGraphEnter(data: string): boolean {
     if (this.graphEnterQuarantineUntil <= 0) return false;
     if (!matchesKey(data, Key.enter)) {
@@ -518,18 +407,15 @@ export class WorkflowAttachPane implements Component {
     this.graphEnterQuarantineUntil = 0;
     return false;
   }
-
   private _armGraphEnterQuarantineIfRunNeedsInput(): void {
     const runId = this._resolveRunId();
     this.graphEnterQuarantineUntil = runId && this._runNeedsInput(runId)
       ? this.now() + ENTER_TRANSITION_QUARANTINE_MS
       : 0;
   }
-
   private _runNeedsInput(runId: string): boolean {
     return this._runAwaitingInputKey(this.store.snapshot(), runId) !== null;
   }
-
   private _runAwaitingInputKey(snapshot: StoreSnapshot, runId: string): string | null {
     const run = snapshot.runs.find((candidate) => candidate.id === runId);
     if (!run) return null;
@@ -546,17 +432,14 @@ export class WorkflowAttachPane implements Component {
     keys.sort((a, b) => b.createdAt - a.createdAt);
     return keys[0]!.key;
   }
-
   private _stageNeedsInput(runId: string, stageId: string): boolean {
     return this._stageAwaitingInputKey(this.store.snapshot(), runId, stageId) !== null;
   }
-
   private _stageAwaitingInputKey(snapshot: StoreSnapshot, runId: string, stageId: string): string | null {
     const run = snapshot.runs.find((candidate) => candidate.id === runId);
     const stage = run?.stages.find((candidate) => candidate.id === stageId);
     return stage ? this._stageAwaitingInputKeyFromSnapshot(stage)?.key ?? null : null;
   }
-
   private _stageAwaitingInputKeyFromSnapshot(stage: StageSnapshot): { key: string; createdAt: number } | null {
     if (stage.pendingPrompt) {
       return { key: `stage-prompt:${stage.id}:${stage.pendingPrompt.id}`, createdAt: stage.pendingPrompt.createdAt };
@@ -572,16 +455,13 @@ export class WorkflowAttachPane implements Component {
     }
     return null;
   }
-
   private _isStageMarkedAttached(runId: string, stageId: string): boolean {
     return this._stageSnapshot(runId, stageId)?.attached === true;
   }
-
   private _stageSnapshot(runId: string, stageId: string): StageSnapshot | undefined {
     const run = this.store.snapshot().runs.find((candidate) => candidate.id === runId);
     return run?.stages.find((candidate) => candidate.id === stageId);
   }
-
   private _stageSnapshotNeedsInput(stage: Pick<StageSnapshot, "pendingPrompt" | "inputRequest" | "status">): boolean {
     return (
       stage.pendingPrompt !== undefined ||
@@ -589,12 +469,10 @@ export class WorkflowAttachPane implements Component {
       stage.status === "awaiting_input"
     );
   }
-
   invalidate(): void {
     if (this.mode === "stage-chat" && this.chatView) this.chatView.invalidate();
     else this.graphView.invalidate();
   }
-
   dispose(): void {
     this.unsubscribeStore?.();
     this.unsubscribeStore = null;
@@ -605,14 +483,8 @@ export class WorkflowAttachPane implements Component {
     this.chatView = null;
     this.graphView.dispose();
     this.setMouseScrollTracking?.(false);
-    // Clear the pi-workflows status tag so it doesn't follow the user
-    // back into chat. Without this, every subsequent message header
-    // keeps rendering `pi-workflows/<workflow>` (or `…/<stage>`) until
-    // the next attach replaces the slot.
     this.uiStatus?.setStatus?.(WORKFLOW_STATUS_KEY, undefined);
   }
-
-  // ---- Test seams ----
   get _mode(): WorkflowAttachPaneMode {
     return this.mode;
   }

package/dist/builtin/workflows/src/workflows/registry.ts

@@ -8,7 +8,7 @@
  *            pi-subagents src/agents/agents.ts (discover/parse)
  */
 
-import type { WorkflowDefinition } from "../shared/types.js";
+import type { WorkflowDefinition, WorkflowInputValues, WorkflowOutputValues } from "../shared/types.js";
 import { normalizeWorkflowName } from "./identity.js";
 
 export interface WorkflowRegistry {
@@ -17,7 +17,11 @@ export interface WorkflowRegistry {
    * Keyed by the definition's normalizedName; replaces any prior entry with
    * the same key.  Returns a NEW registry — this one is unchanged.
    */
-  register(definition: WorkflowDefinition): WorkflowRegistry;
+  register<
+    TInputs extends WorkflowInputValues,
+    TOutputs extends WorkflowOutputValues,
+    TRunInputs extends WorkflowInputValues = TInputs,
+  >(definition: WorkflowDefinition<TInputs, TOutputs, TRunInputs>): WorkflowRegistry;
   /**
    * Return a new registry with all definitions from another registry merged
    * in (other's entries win on collision).
@@ -52,7 +56,7 @@ function makeRegistry(store: Map<string, WorkflowDefinition>): WorkflowRegistry
   return {
     register(definition) {
       const next = new Map(store);
-      next.set(definition.normalizedName, definition);
+      next.set(definition.normalizedName, definition as never as WorkflowDefinition);
       return makeRegistry(next);
     },
 

package/dist/config-self-update.d.ts

@@ -0,0 +1,21 @@
+export interface SelfUpdateRuntime {
+    isBunBinary: boolean;
+    isBunRuntime: boolean;
+    moduleDir: string;
+    getPackageDir(): string;
+}
+export type InstallMethod = "bun-binary" | "npm" | "pnpm" | "yarn" | "bun" | "unknown";
+interface SelfUpdateCommandStep {
+    command: string;
+    args: string[];
+    display: string;
+}
+export interface SelfUpdateCommand extends SelfUpdateCommandStep {
+    steps?: SelfUpdateCommandStep[];
+}
+export declare function detectInstallMethodForRuntime(runtime: SelfUpdateRuntime): InstallMethod;
+export declare function getSelfUpdateCommandForRuntime(runtime: SelfUpdateRuntime, packageName: string, npmCommand?: string[], updatePackageName?: string): SelfUpdateCommand | undefined;
+export declare function getSelfUpdateUnavailableInstructionForRuntime(runtime: SelfUpdateRuntime, packageName: string, npmCommand?: string[], updatePackageName?: string): string;
+export declare function getUpdateInstructionForRuntime(runtime: SelfUpdateRuntime, packageName: string): string;
+export {};
+//# sourceMappingURL=config-self-update.d.ts.map

package/dist/config-self-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-self-update.d.ts","sourceRoot":"","sources":["../src/config-self-update.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,IAAI,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAEvF,UAAU,qBAAqB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC/D,KAAK,CAAC,EAAE,qBAAqB,EAAE,CAAC;CAChC;AAsBD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAwBvF;AA6ND,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,iBAAiB,SAAc,GAC7B,iBAAiB,GAAG,SAAS,CAO/B;AAED,wBAAgB,6CAA6C,CAC5D,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,iBAAiB,SAAc,GAC7B,MAAM,CAaR;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAOtG","sourcesContent":["import { accessSync, constants, existsSync, realpathSync } from \"fs\";\nimport { homedir } from \"os\";\nimport { basename, dirname, join, resolve, sep, win32 } from \"path\";\nimport { spawnProcessSync } from \"./utils/child-process.ts\";\n\nexport interface SelfUpdateRuntime {\n\tisBunBinary: boolean;\n\tisBunRuntime: boolean;\n\tmoduleDir: string;\n\tgetPackageDir(): string;\n}\n\nexport type InstallMethod = \"bun-binary\" | \"npm\" | \"pnpm\" | \"yarn\" | \"bun\" | \"unknown\";\n\ninterface SelfUpdateCommandStep {\n\tcommand: string;\n\targs: string[];\n\tdisplay: string;\n}\n\nexport interface SelfUpdateCommand extends SelfUpdateCommandStep {\n\tsteps?: SelfUpdateCommandStep[];\n}\n\nfunction makeSelfUpdateCommand(\n\tinstallStep: SelfUpdateCommandStep,\n\tuninstallStep?: SelfUpdateCommandStep,\n): SelfUpdateCommand {\n\tif (!uninstallStep) return installStep;\n\treturn {\n\t\t...installStep,\n\t\tdisplay: `${uninstallStep.display} && ${installStep.display}`,\n\t\tsteps: [uninstallStep, installStep],\n\t};\n}\n\nfunction makeSelfUpdateCommandStep(command: string, args: string[]): SelfUpdateCommandStep {\n\treturn {\n\t\tcommand,\n\t\targs,\n\t\tdisplay: [command, ...args].map((arg) => (/\\s/.test(arg) ? `\"${arg}\"` : arg)).join(\" \"),\n\t};\n}\n\nexport function detectInstallMethodForRuntime(runtime: SelfUpdateRuntime): InstallMethod {\n\tif (runtime.isBunBinary) {\n\t\treturn \"bun-binary\";\n\t}\n\n\tconst resolvedPath = `${runtime.moduleDir}\\0${process.execPath || \"\"}`.toLowerCase().replace(/\\\\/g, \"/\");\n\n\tif (resolvedPath.includes(\"/pnpm/\") || resolvedPath.includes(\"/.pnpm/\")) {\n\t\treturn \"pnpm\";\n\t}\n\tif (resolvedPath.includes(\"/yarn/\") || resolvedPath.includes(\"/.yarn/\")) {\n\t\treturn \"yarn\";\n\t}\n\tif (resolvedPath.includes(\"/install/global/node_modules/\")) {\n\t\treturn \"bun\";\n\t}\n\tif (resolvedPath.includes(\"/npm/\") || resolvedPath.includes(\"/node_modules/\")) {\n\t\treturn \"npm\";\n\t}\n\tif (runtime.isBunRuntime) {\n\t\treturn \"bun\";\n\t}\n\n\treturn \"unknown\";\n}\n\nfunction getInferredNpmInstall(runtime: SelfUpdateRuntime): { root: string; prefix: string } | undefined {\n\tconst packageDir = runtime.getPackageDir();\n\tconst path = process.platform === \"win32\" || packageDir.includes(\"\\\\\") ? win32 : { basename, dirname };\n\tconst parent = path.dirname(packageDir);\n\tlet root: string | undefined;\n\tif (path.basename(parent).startsWith(\"@\") && path.basename(path.dirname(parent)) === \"node_modules\") {\n\t\troot = path.dirname(parent);\n\t} else if (path.basename(parent) === \"node_modules\") {\n\t\troot = parent;\n\t}\n\tif (!root) return undefined;\n\tconst rootParent = path.dirname(root);\n\tif (path.basename(rootParent) === \"lib\") return { root, prefix: path.dirname(rootParent) };\n\t// Windows global npm prefixes use `<prefix>\\\\node_modules`, which is\n\t// indistinguishable from local project installs by path shape alone. Do not\n\t// infer unsupported Windows custom prefixes without `npm root -g` evidence.\n\treturn undefined;\n}\n\nfunction getSelfUpdateCommandForMethod(\n\truntime: SelfUpdateRuntime,\n\tmethod: InstallMethod,\n\tinstalledPackageName: string,\n\tupdatePackageName = installedPackageName,\n\tnpmCommand?: string[],\n): SelfUpdateCommand | undefined {\n\tswitch (method) {\n\t\tcase \"bun-binary\":\n\t\t\treturn undefined;\n\t\tcase \"pnpm\": {\n\t\t\tconst match = readCommandOutput(\"pnpm\", [\"root\", \"-g\"])\n\t\t\t\t? undefined\n\t\t\t\t: /^(.*[\\\\/]global[\\\\/][^\\\\/]+)[\\\\/]\\.pnpm[\\\\/]/.exec(runtime.getPackageDir());\n\t\t\tconst binDirArgs = match\n\t\t\t\t? [`--config.global-bin-dir=${process.env.PNPM_HOME || dirname(dirname(match[1]))}`]\n\t\t\t\t: [];\n\t\t\treturn makeSelfUpdateCommand(\n\t\t\t\tmakeSelfUpdateCommandStep(\"pnpm\", [\n\t\t\t\t\t\"install\",\n\t\t\t\t\t\"-g\",\n\t\t\t\t\t\"--ignore-scripts\",\n\t\t\t\t\t\"--config.minimumReleaseAge=0\",\n\t\t\t\t\t...binDirArgs,\n\t\t\t\t\tupdatePackageName,\n\t\t\t\t]),\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(\"pnpm\", [\"remove\", \"-g\", ...binDirArgs, installedPackageName]),\n\t\t\t);\n\t\t}\n\t\tcase \"yarn\":\n\t\t\treturn makeSelfUpdateCommand(\n\t\t\t\tmakeSelfUpdateCommandStep(\"yarn\", [\"global\", \"add\", \"--ignore-scripts\", updatePackageName]),\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(\"yarn\", [\"global\", \"remove\", installedPackageName]),\n\t\t\t);\n\t\tcase \"bun\":\n\t\t\treturn makeSelfUpdateCommand(\n\t\t\t\tmakeSelfUpdateCommandStep(\"bun\", [\n\t\t\t\t\t\"install\",\n\t\t\t\t\t\"-g\",\n\t\t\t\t\t\"--ignore-scripts\",\n\t\t\t\t\t\"--minimum-release-age=0\",\n\t\t\t\t\tupdatePackageName,\n\t\t\t\t]),\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(\"bun\", [\"uninstall\", \"-g\", installedPackageName]),\n\t\t\t);\n\t\tcase \"npm\": {\n\t\t\tconst [command = \"npm\", ...npmArgs] = npmCommand ?? [];\n\t\t\tconst inferred = npmCommand?.length ? undefined : getInferredNpmInstall(runtime);\n\t\t\tconst prefixArgs = [...npmArgs, ...(inferred ? [\"--prefix\", inferred.prefix] : [])];\n\t\t\tconst installStep = makeSelfUpdateCommandStep(command, [\n\t\t\t\t...prefixArgs,\n\t\t\t\t\"install\",\n\t\t\t\t\"-g\",\n\t\t\t\t\"--ignore-scripts\",\n\t\t\t\t\"--min-release-age=0\",\n\t\t\t\tupdatePackageName,\n\t\t\t]);\n\t\t\tconst uninstallStep =\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(command, [...prefixArgs, \"uninstall\", \"-g\", installedPackageName]);\n\t\t\treturn makeSelfUpdateCommand(installStep, uninstallStep);\n\t\t}\n\t\tcase \"unknown\":\n\t\t\treturn undefined;\n\t}\n}\n\nfunction readCommandOutput(\n\tcommand: string,\n\targs: string[],\n\toptions: { requireSuccess?: boolean } = {},\n): string | undefined {\n\tconst result = spawnProcessSync(command, args, {\n\t\tencoding: \"utf-8\",\n\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t});\n\tif (result.status === 0) return result.stdout.trim() || undefined;\n\tif (options.requireSuccess) {\n\t\tconst reason = result.error?.message || result.stderr.trim() || `exit code ${result.status ?? \"unknown\"}`;\n\t\tthrow new Error(`Failed to run ${[command, ...args].join(\" \")}: ${reason}`);\n\t}\n\treturn undefined;\n}\n\nfunction getGlobalPackageRoots(runtime: SelfUpdateRuntime, method: InstallMethod, _packageName: string, npmCommand?: string[]): string[] {\n\tswitch (method) {\n\t\tcase \"npm\": {\n\t\t\tconst configured = !!npmCommand?.length;\n\t\t\tconst [command = \"npm\", ...npmArgs] = npmCommand ?? [];\n\t\t\tif (configured && command === \"bun\") {\n\t\t\t\tconst bunBin = readCommandOutput(command, [...npmArgs, \"pm\", \"bin\", \"-g\"], {\n\t\t\t\t\trequireSuccess: true,\n\t\t\t\t});\n\t\t\t\tconst roots = [join(homedir(), \".bun\", \"install\", \"global\", \"node_modules\")];\n\t\t\t\tif (bunBin) {\n\t\t\t\t\troots.push(join(dirname(bunBin), \"install\", \"global\", \"node_modules\"));\n\t\t\t\t}\n\t\t\t\treturn roots;\n\t\t\t}\n\t\t\tconst root = readCommandOutput(command, [...npmArgs, \"root\", \"-g\"], {\n\t\t\t\trequireSuccess: configured,\n\t\t\t});\n\t\t\tconst inferred = configured ? undefined : getInferredNpmInstall(runtime);\n\t\t\treturn [root, inferred?.root].filter((x): x is string => !!x);\n\t\t}\n\t\tcase \"pnpm\": {\n\t\t\tconst root = readCommandOutput(\"pnpm\", [\"root\", \"-g\"]);\n\t\t\tif (root) return [root, dirname(root)];\n\t\t\tconst match = /^(.*[\\\\/]global[\\\\/][^\\\\/]+)[\\\\/]\\.pnpm[\\\\/]/.exec(runtime.getPackageDir());\n\t\t\treturn match ? [match[1]] : [];\n\t\t}\n\t\tcase \"yarn\": {\n\t\t\tconst dir = readCommandOutput(\"yarn\", [\"global\", \"dir\"]);\n\t\t\treturn dir ? [dir, join(dir, \"node_modules\")] : [];\n\t\t}\n\t\tcase \"bun\": {\n\t\t\tconst bunBin = readCommandOutput(\"bun\", [\"pm\", \"bin\", \"-g\"]);\n\t\t\tconst roots = [join(homedir(), \".bun\", \"install\", \"global\", \"node_modules\")];\n\t\t\tif (bunBin) {\n\t\t\t\troots.push(join(dirname(bunBin), \"install\", \"global\", \"node_modules\"));\n\t\t\t}\n\t\t\treturn roots;\n\t\t}\n\t\tcase \"bun-binary\":\n\t\tcase \"unknown\":\n\t\t\treturn [];\n\t}\n}\n\nfunction normalizeExistingPathForComparison(path: string, resolveSymlinks: boolean): string | undefined {\n\tconst resolvedPath = resolve(path);\n\tif (!existsSync(resolvedPath)) {\n\t\treturn undefined;\n\t}\n\tlet normalizedPath = resolvedPath;\n\tif (resolveSymlinks) {\n\t\ttry {\n\t\t\tnormalizedPath = realpathSync(resolvedPath);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\tif (process.platform === \"win32\") {\n\t\tnormalizedPath = normalizedPath.toLowerCase();\n\t}\n\treturn normalizedPath;\n}\n\nfunction getPathComparisonCandidates(path: string): string[] {\n\treturn Array.from(\n\t\tnew Set(\n\t\t\t[normalizeExistingPathForComparison(path, false), normalizeExistingPathForComparison(path, true)].filter(\n\t\t\t\t(candidate): candidate is string => !!candidate,\n\t\t\t),\n\t\t),\n\t);\n}\n\nfunction getEntrypointPackageDir(): string | undefined {\n\tconst entrypoint = process.argv[1];\n\tif (!entrypoint) return undefined;\n\tlet dir = dirname(entrypoint);\n\twhile (dir !== dirname(dir)) {\n\t\tif (existsSync(join(dir, \"package.json\"))) {\n\t\t\treturn dir;\n\t\t}\n\t\tdir = dirname(dir);\n\t}\n\treturn undefined;\n}\n\nfunction isSelfUpdatePathWritable(runtime: SelfUpdateRuntime): boolean {\n\tconst packageDir = runtime.getPackageDir();\n\ttry {\n\t\taccessSync(packageDir, constants.W_OK);\n\t\taccessSync(dirname(packageDir), constants.W_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction isManagedByGlobalPackageManager(runtime: SelfUpdateRuntime, method: InstallMethod, packageName: string, npmCommand?: string[]): boolean {\n\tconst packageDirs = [runtime.getPackageDir(), getEntrypointPackageDir()].filter((dir): dir is string => !!dir);\n\tconst packageDirCandidates = packageDirs.flatMap((dir) => getPathComparisonCandidates(dir));\n\treturn getGlobalPackageRoots(runtime, method, packageName, npmCommand).some((root) => {\n\t\treturn getPathComparisonCandidates(root).some((normalizedRoot) => {\n\t\t\tconst rootPrefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;\n\t\t\treturn packageDirCandidates.some((packageDir) => packageDir.startsWith(rootPrefix));\n\t\t});\n\t});\n}\n\nexport function getSelfUpdateCommandForRuntime(\n\truntime: SelfUpdateRuntime,\n\tpackageName: string,\n\tnpmCommand?: string[],\n\tupdatePackageName = packageName,\n): SelfUpdateCommand | undefined {\n\tconst method = detectInstallMethodForRuntime(runtime);\n\tconst command = getSelfUpdateCommandForMethod(runtime, method, packageName, updatePackageName, npmCommand);\n\tif (!command || !isManagedByGlobalPackageManager(runtime, method, packageName, npmCommand) || !isSelfUpdatePathWritable(runtime)) {\n\t\treturn undefined;\n\t}\n\treturn command;\n}\n\nexport function getSelfUpdateUnavailableInstructionForRuntime(\n\truntime: SelfUpdateRuntime,\n\tpackageName: string,\n\tnpmCommand?: string[],\n\tupdatePackageName = packageName,\n): string {\n\tconst method = detectInstallMethodForRuntime(runtime);\n\tif (method === \"bun-binary\") {\n\t\treturn `Download from: https://github.com/earendil-works/pi-mono/releases/latest`;\n\t}\n\tconst command = getSelfUpdateCommandForMethod(runtime, method, packageName, updatePackageName, npmCommand);\n\tif (command) {\n\t\tif (isManagedByGlobalPackageManager(runtime, method, packageName, npmCommand) && !isSelfUpdatePathWritable(runtime)) {\n\t\t\treturn `This installation is managed by a global ${method} install, but the install path is not writable. Update it yourself with: ${command.display}`;\n\t\t}\n\t\treturn `This installation is not managed by a global ${method} install. Update it with the package manager, wrapper, or source checkout that provides it.`;\n\t}\n\treturn `Update ${updatePackageName} using the package manager, wrapper, or source checkout that provides this installation.`;\n}\n\nexport function getUpdateInstructionForRuntime(runtime: SelfUpdateRuntime, packageName: string): string {\n\tconst method = detectInstallMethodForRuntime(runtime);\n\tconst command = getSelfUpdateCommandForMethod(runtime, method, packageName);\n\tif (command) {\n\t\treturn `Run: ${command.display}`;\n\t}\n\treturn getSelfUpdateUnavailableInstructionForRuntime(runtime, packageName);\n}\n\n"]}