@oh-my-pi/pi-coding-agent 15.11.6 → 15.11.8

package/dist/types/modes/components/status-line/component.d.ts

@@ -1,6 +1,6 @@
 import { type Component } from "@oh-my-pi/pi-tui";
 import type { AgentSession } from "../../../session/agent-session";
-import type { EffectiveStatusLineSettings, StatusLineSettings } from "./types";
+import type { CollabStatus, EffectiveStatusLineSettings, StatusLineSettings } from "./types";
 export declare class StatusLineComponent implements Component {
     #private;
     private readonly session;
@@ -9,6 +9,8 @@ export declare class StatusLineComponent implements Component {
     getEffectiveSettingsForTest(): EffectiveStatusLineSettings;
     setAutoCompactEnabled(enabled: boolean): void;
     setSubagentCount(count: number): void;
+    /** Active subagent count as currently displayed (collab state mirroring). */
+    get subagentCount(): number;
     setSessionStartTime(time: number): void;
     setPlanModeStatus(status: {
         enabled: boolean;
@@ -21,6 +23,7 @@ export declare class StatusLineComponent implements Component {
         enabled: boolean;
         paused: boolean;
     } | undefined): void;
+    setCollabStatus(status: CollabStatus | null): void;
     setHookStatus(key: string, text: string | undefined): void;
     watchBranch(onBranchChange: () => void): void;
     dispose(): void;

package/dist/types/modes/components/status-line/types.d.ts

@@ -1,6 +1,14 @@
+import type { CollabSessionState } from "../../../collab/protocol";
 import type { StatusLinePreset, StatusLineSegmentId, StatusLineSeparatorStyle } from "../../../config/settings-schema";
 import type { AgentSession } from "../../../session/agent-session";
 export type { StatusLinePreset, StatusLineSegmentId, StatusLineSeparatorStyle };
+/** Collab session indicator + (guest-only) host-state override for segments. */
+export interface CollabStatus {
+    role: "host" | "guest";
+    participantCount: number;
+    /** Guest only: host footer snapshot that overrides locally computed values. */
+    stateOverride?: CollabSessionState | null;
+}
 export interface StatusLineSegmentOptions {
     model?: {
         showThinkingLevel?: boolean;
@@ -50,6 +58,7 @@ export interface SegmentContext {
         enabled: boolean;
         paused: boolean;
     } | null;
+    collab: CollabStatus | null;
     usageStats: {
         input: number;
         output: number;

package/dist/types/modes/components/tool-execution.d.ts

@@ -74,15 +74,19 @@ export declare class ToolExecutionComponent extends Container {
     isTranscriptBlockFinalized(): boolean;
     /**
      * Whether this still-live block's settled rows may enter native scrollback
-     * (see `FinalizableBlock.isTranscriptBlockCommitStable`). A pending
-     * collapsed preview is provisional: the tail-window streaming views
-     * (edit/bash/eval caps) are re-anchored top-first by the result render, so
-     * promoting their visually static head — e.g. an edit preview idling on
-     * its last frame while the apply + LSP pass runs — would strand a stale
-     * copy of the call box above the final block the moment the result lands.
-     * Expanded pending blocks stream top-anchored append-shaped content whose
-     * rows the result render preserves byte-stable (the over-tall write/eval
-     * scrollback contract), so they stay commit-eligible. Displaceable waiting
+     * (see `FinalizableBlock.isTranscriptBlockCommitStable`). Classification is
+     * per renderer (`ToolRenderer.provisionalPendingPreview`): tail-window
+     * streaming views (edit's streamed-diff tail, bash/ssh command caps, eval
+     * cells) are re-anchored top-first by the result render, so promoting
+     * their visually static head — e.g. an edit preview idling on its last
+     * frame while the apply + LSP pass runs — would strand a stale copy of
+     * the call box above the final block the moment the result lands. Every
+     * other pending preview streams top-anchored append-shaped rows the
+     * result render preserves (a task call's context/assignment markdown, a
+     * write's content), so it stays commit-eligible — a call taller than the
+     * viewport scrolls into native history mid-stream instead of reading as
+     * cut off until the result. Expanded blocks always stream top-anchored
+     * (the over-tall write/eval scrollback contract). Displaceable waiting
      * polls are removed wholesale by the next poll and must never commit.
      */
     isTranscriptBlockCommitStable(): boolean;

package/dist/types/modes/interactive-mode.d.ts

@@ -3,6 +3,8 @@ import type { CompactionOutcome } from "@oh-my-pi/pi-agent-core/compaction";
 import type { AssistantMessage, ImageContent, Message, UsageReport } from "@oh-my-pi/pi-ai";
 import type { Component, EditorTheme } from "@oh-my-pi/pi-tui";
 import { Container, Loader, Spacer, Text, TUI } from "@oh-my-pi/pi-tui";
+import type { CollabGuestLink } from "../collab/guest";
+import type { CollabHost } from "../collab/host";
 import { KeybindingsManager } from "../config/keybindings";
 import { Settings } from "../config/settings";
 import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
@@ -25,6 +27,7 @@ import type { HookSelectorComponent, HookSelectorSlider } from "./components/hoo
 import { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
 import { TranscriptContainer } from "./components/transcript-container";
+import { EventController } from "./controllers/event-controller";
 import { type LoopLimitRuntime } from "./loop-limit";
 import { OAuthManualInputManager } from "./oauth-manual-input";
 import type { ObservableSession } from "./session-observer-registry";
@@ -119,8 +122,12 @@ export declare class InteractiveMode implements InteractiveModeContext {
     fileSlashCommands: Set<string>;
     skillCommands: Map<string, string>;
     oauthManualInput: OAuthManualInputManager;
+    collabHost?: CollabHost;
+    collabGuest?: CollabGuestLink;
     readonly lspServers: LspStartupServerInfo[] | undefined;
     mcpManager?: MCPManager;
+    get eventController(): EventController;
+    get eventBus(): EventBus | undefined;
     constructor(session: AgentSession, version: string, changelogMarkdown?: string | undefined, setToolUIContext?: (uiContext: ExtensionUIContext, hasUI: boolean) => void, lspServers?: LspStartupServerInfo[] | undefined, mcpManager?: MCPManager, eventBus?: EventBus, titleSystemPrompt?: string);
     playWelcomeIntro(): void;
     init(options?: InteractiveModeInitOptions): Promise<void>;

package/dist/types/modes/setup-wizard/scenes/sign-in.d.ts

@@ -1,3 +1,4 @@
+import { type SgrMouseEvent } from "@oh-my-pi/pi-tui";
 import type { SetupSceneHost, SetupTab } from "./types";
 /**
  * "Sign in" panel: lets the user authenticate one or more model providers via
@@ -15,5 +16,7 @@ export declare class SignInTab implements SetupTab {
     dispose(): void;
     invalidate(): void;
     handleInput(data: string): void;
+    /** Forward mouse to the provider selector; pointer is inert during an active login or code prompt. */
+    routeMouse(event: SgrMouseEvent, line: number, col: number): void;
     render(width: number): readonly string[];
 }

package/dist/types/modes/setup-wizard/scenes/types.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from "@oh-my-pi/pi-tui";
+import type { Component, SgrMouseEvent } from "@oh-my-pi/pi-tui";
 import type { InteractiveModeContext } from "../../types";
 export type SetupSceneResult = "done" | "skipped";
 export interface SetupSceneHost {
@@ -14,6 +14,13 @@ export interface SetupSceneController extends Component {
     onMount?(): void | Promise<void>;
     onUnmount?(): void;
     dispose?(): void;
+    /**
+     * Route an SGR mouse report (tracking is on while the wizard holds the
+     * alternate screen). `line`/`col` are 0-based within this controller's
+     * last rendered output. When absent, the wizard falls back to synthesizing
+     * arrow keys from wheel notches.
+     */
+    routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
 }
 /**
  * A single panel inside a tabbed setup scene. The host scene owns the tab bar
@@ -32,6 +39,8 @@ export interface SetupTab {
     invalidate(): void;
     /** Called when the tab becomes active (including initial mount). */
     onActivate?(): void;
+    /** Mouse routing at tab-local coordinates; see {@link SetupSceneController.routeMouse}. */
+    routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
     dispose(): void;
 }
 export interface SetupScene {

package/dist/types/modes/setup-wizard/scenes/web-search.d.ts

@@ -1,3 +1,4 @@
+import { type SgrMouseEvent } from "@oh-my-pi/pi-tui";
 import type { SetupSceneHost, SetupTab } from "./types";
 /**
  * "Web search" panel: picks the provider the web_search tool should prefer and
@@ -14,6 +15,8 @@ export declare class WebSearchTab implements SetupTab {
     constructor(host: SetupSceneHost);
     onActivate(): void;
     handleInput(data: string): void;
+    /** Wheel moves the highlight; hover lights the row under the pointer; click confirms it. */
+    routeMouse(event: SgrMouseEvent, line: number, _col: number): void;
     invalidate(): void;
     dispose(): void;
     render(width: number): readonly string[];

package/dist/types/modes/types.d.ts

@@ -2,6 +2,8 @@ import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
 import type { CompactionOutcome } from "@oh-my-pi/pi-agent-core/compaction";
 import type { AssistantMessage, ImageContent, Message, UsageReport } from "@oh-my-pi/pi-ai";
 import type { Component, Container, EditorTheme, Loader, Spacer, Text, TUI } from "@oh-my-pi/pi-tui";
+import type { CollabGuestLink } from "../collab/guest";
+import type { CollabHost } from "../collab/host";
 import type { KeybindingsManager } from "../config/keybindings";
 import type { Settings } from "../config/settings";
 import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionUISelectItem, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
@@ -13,6 +15,7 @@ import type { HistoryStorage } from "../session/history-storage";
 import type { SessionContext, SessionManager } from "../session/session-manager";
 import type { ShakeMode } from "../session/shake-types";
 import type { LspStartupServerInfo } from "../tools";
+import type { EventBus } from "../utils/event-bus";
 import type { AssistantMessageComponent } from "./components/assistant-message";
 import type { BashExecutionComponent } from "./components/bash-execution";
 import type { CustomEditor } from "./components/custom-editor";
@@ -23,6 +26,7 @@ import type { HookSelectorComponent, HookSelectorOptions } from "./components/ho
 import type { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
 import type { TranscriptContainer } from "./components/transcript-container";
+import type { EventController } from "./controllers/event-controller";
 import type { LoopLimitRuntime } from "./loop-limit";
 import type { OAuthManualInputManager } from "./oauth-manual-input";
 import type { Theme } from "./theme/theme";
@@ -84,6 +88,10 @@ export interface InteractiveModeContext {
     mcpManager?: MCPManager;
     lspServers?: LspStartupServerInfo[];
     titleSystemPrompt?: string;
+    collabHost?: CollabHost;
+    collabGuest?: CollabGuestLink;
+    eventController: EventController;
+    eventBus?: EventBus;
     isInitialized: boolean;
     isBashMode: boolean;
     toolOutputExpanded: boolean;

package/dist/types/session/agent-session.d.ts

@@ -385,6 +385,9 @@ export declare class AgentSession {
      */
     subscribe(listener: AgentSessionEventListener): () => void;
     subscribeCommandMetadataChanged(listener: CommandMetadataChangedListener): () => void;
+    /** True once dispose() has begun; deferred background work (e.g. the deferred
+     *  MCP discovery task in sdk.ts) must not touch the session past this point. */
+    get isDisposed(): boolean;
     /**
      * Synchronously mark the session as disposing so new work is rejected
      * immediately: Python/eval starts throw, queued asides are dropped, and the
@@ -443,6 +446,14 @@ export declare class AgentSession {
      */
     getAllToolNames(): string[];
     isMCPDiscoveryEnabled(): boolean;
+    /**
+     * Flip MCP discovery on after deferred discovery learns the real tool count.
+     * UI sessions resolve `tools.discoveryMode: "auto"` before MCP servers
+     * connect, so a large MCP toolset discovered later must be able to upgrade
+     * the session from the force-activate path to the discovery path. One-way:
+     * discovery is never downgraded mid-session.
+     */
+    enableMCPDiscovery(): void;
     getSelectedMCPToolNames(): string[];
     activateDiscoveredMCPTools(toolNames: string[]): Promise<string[]>;
     isToolDiscoveryEnabled(): boolean;

package/dist/types/session/session-manager.d.ts

@@ -309,6 +309,12 @@ export declare class SessionManager {
     private sessionDir;
     private readonly persist;
     private readonly storage;
+    /**
+     * Collab replication tap: invoked for every appended entry with the
+     * in-memory (pre-blob-externalization) entry, so inline images survive.
+     * Failures are swallowed — a broadcast error must never break persistence.
+     */
+    onEntryAppended?: (entry: SessionEntry) => void;
     private constructor();
     /** Puts a binary blob into the blob store and returns the blob reference */
     putBlob(data: Buffer, options?: BlobPutOptions): Promise<BlobPutResult>;
@@ -434,6 +440,21 @@ export declare class SessionManager {
      */
     setSessionName(name: string, source?: "auto" | "user"): Promise<boolean>;
     _persist(entry: SessionEntry): void;
+    /**
+     * Append a foreign (host-authored) entry verbatim, preserving its
+     * `id`/`parentId` — no id minting. Used by collab guests to mirror the
+     * host session into the local replica file.
+     */
+    ingestReplicatedEntry(entry: SessionEntry): void;
+    /**
+     * Snapshot the session for collab replication: the live header plus a deep
+     * copy of every entry (the host mutates entries in place on
+     * truncation/rewrite paths, so guests must not share references).
+     */
+    snapshotForReplication(): {
+        header: SessionHeader;
+        entries: SessionEntry[];
+    };
     /** Append a message as child of current leaf, then advance leaf. Returns entry id.
      * Does not allow writing CompactionSummaryMessage and BranchSummaryMessage directly.
      * Reason: we want these to be top-level entries in the session, not message session entries,

package/dist/types/session/snapcompact-inline.d.ts

@@ -19,17 +19,21 @@ export type SnapcompactSystemPromptMode = "none" | "agents-md" | "all";
 export interface SnapcompactInlineOptions {
     renderSystemPrompt: SnapcompactSystemPromptMode;
     renderToolResults: boolean;
+    /** Frame variant override; `"auto"`/omitted picks the provider's eval winner. */
+    shape?: snapcompact.ShapeVariantName | "auto";
 }
 /** Tool-result swap candidate, in context order. */
 export interface InlineToolResultCandidate {
-    /** toolCallId — stable identity for render caching and application. */
+    /** Stable identifier for rendering cache key and applying the swap. */
     id: string;
-    /** Token count of the joined text blocks (0 when empty or image-carrying). */
+    /** Token count of the joined text blocks (0 for empty or image-carrying). */
     textTokens: number;
-    /** Frames needed to render the text (0 = empty or below the token floor). */
+    /** Frames needed to render the text (0 = empty, below floor, image-carrying, or error). */
     frames: number;
     /** Already carries an image (screenshot etc.) — never re-imaged. */
     hasImage: boolean;
+    /** Error tool results must stay text-only for provider API validation. */
+    isError?: boolean;
 }
 export interface InlineSystemPromptCandidate {
     textTokens: number;
@@ -71,6 +75,7 @@ export interface InlineMessageView {
     role: string;
     toolCallId?: string;
     content?: unknown;
+    isError?: boolean;
 }
 export interface SnapcompactSavingsEstimate {
     /** Frames only ship on models that accept image input. */

package/dist/types/slash-commands/builtin-registry.d.ts

@@ -1,3 +1,4 @@
+import type { AutocompleteItem } from "@oh-my-pi/pi-tui";
 import type { BuiltinSlashCommand, ParsedSlashCommand, SlashCommandResult, SlashCommandRuntime, SlashCommandSpec, TuiSlashCommandRuntime } from "./types";
 export type { BuiltinSlashCommand, SubcommandDef } from "./types";
 /** TUI-specific runtime accepted by `executeBuiltinSlashCommand`. */
@@ -5,6 +6,14 @@ export type BuiltinSlashCommandRuntime = TuiSlashCommandRuntime;
 export declare const BUILTIN_SLASH_COMMAND_RESERVED_NAMES: ReadonlySet<string>;
 /** Builtin command metadata used for slash-command autocomplete and help text. */
 export declare const BUILTIN_SLASH_COMMAND_DEFS: ReadonlyArray<BuiltinSlashCommand>;
+/**
+ * Materialized builtin slash commands with completion functions derived from
+ * declarative subcommand/hint definitions.
+ */
+export declare const BUILTIN_SLASH_COMMANDS: ReadonlyArray<BuiltinSlashCommand & {
+    getArgumentCompletions?: (prefix: string) => AutocompleteItem[] | null;
+    getInlineHint?: (argumentText: string) => string | null;
+}>;
 /**
  * Unified registry exposed for cross-mode tooling. Each spec carries at least
  * one of `handle` / `handleTui`. The TUI dispatcher prefers `handleTui`; the

package/dist/types/tools/bash.d.ts

@@ -124,6 +124,7 @@ export declare function createShellRenderer<TArgs>(config: ShellRendererConfig<T
     }, uiTheme: Theme, args?: TArgs): Component;
     mergeCallAndResult: boolean;
     inline: boolean;
+    provisionalPendingPreview: boolean;
 };
 export declare const bashToolRenderer: {
     renderCall(args: BashRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component;
@@ -139,5 +140,6 @@ export declare const bashToolRenderer: {
     }, uiTheme: Theme, args?: BashRenderArgs | undefined): Component;
     mergeCallAndResult: boolean;
     inline: boolean;
+    provisionalPendingPreview: boolean;
 };
 export {};

package/dist/types/tools/eval-render.d.ts

@@ -48,5 +48,6 @@ export declare const evalToolRenderer: {
     }, uiTheme: Theme, _args?: EvalRenderArgs): Component;
     mergeCallAndResult: boolean;
     inline: boolean;
+    provisionalPendingPreview: boolean;
 };
 export {};

package/dist/types/tools/renderers.d.ts

@@ -21,5 +21,18 @@ export type ToolRenderer = {
     mergeCallAndResult?: boolean;
     /** Render without background box, inline in the response flow */
     inline?: boolean;
+    /**
+     * Collapsed pending preview is provisional — a tail-window or otherwise
+     * re-anchored view the result render replaces wholesale (an edit's
+     * streamed-diff tail, bash/ssh command caps, eval cells whose outputs
+     * interleave under each cell). Its rows must never commit to native
+     * scrollback mid-run; see
+     * `ToolExecutionComponent.isTranscriptBlockCommitStable`. Absent = the
+     * pending preview streams top-anchored append-shaped rows the result
+     * render preserves (task context/assignment, write content), which stay
+     * commit-eligible so a call taller than the viewport scrolls into history
+     * instead of reading as cut off.
+     */
+    provisionalPendingPreview?: boolean;
 };
 export declare const toolRenderers: Record<string, ToolRenderer>;

package/dist/types/tools/ssh.d.ts

@@ -65,5 +65,6 @@ export declare const sshToolRenderer: {
         renderContext?: SshRenderContext;
     }, uiTheme: Theme, args?: SshRenderArgs): Component;
     mergeCallAndResult: boolean;
+    provisionalPendingPreview: boolean;
 };
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "15.11.6",
+	"version": "15.11.8",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -41,22 +41,24 @@
 		"format-prompts": "bun scripts/format-prompts.ts",
 		"generate-docs-index": "bun scripts/generate-docs-index.ts",
 		"prepack": "bun scripts/generate-docs-index.ts && bun scripts/bundle-dist.ts",
-		"generate-template": "bun scripts/generate-template.ts"
+		"generate-template": "bun scripts/generate-template.ts",
+		"bench:guard": "bun scripts/bench-guard.ts"
 	},
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.22.1",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "15.11.6",
-		"@oh-my-pi/omp-stats": "15.11.6",
-		"@oh-my-pi/pi-agent-core": "15.11.6",
-		"@oh-my-pi/pi-ai": "15.11.6",
-		"@oh-my-pi/pi-catalog": "15.11.6",
-		"@oh-my-pi/pi-mnemopi": "15.11.6",
-		"@oh-my-pi/pi-natives": "15.11.6",
-		"@oh-my-pi/pi-tui": "15.11.6",
-		"@oh-my-pi/pi-utils": "15.11.6",
-		"@oh-my-pi/snapcompact": "15.11.6",
+		"@oh-my-pi/hashline": "15.11.8",
+		"@oh-my-pi/omp-stats": "15.11.8",
+		"@oh-my-pi/pi-agent-core": "15.11.8",
+		"@oh-my-pi/pi-ai": "15.11.8",
+		"@oh-my-pi/pi-catalog": "15.11.8",
+		"@oh-my-pi/pi-mnemopi": "15.11.8",
+		"@oh-my-pi/pi-natives": "15.11.8",
+		"@oh-my-pi/pi-tui": "15.11.8",
+		"@oh-my-pi/pi-utils": "15.11.8",
+		"@oh-my-pi/pi-wire": "15.11.8",
+		"@oh-my-pi/snapcompact": "15.11.8",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",

package/scripts/bench-guard.ts

@@ -0,0 +1,71 @@
+#!/usr/bin/env bun
+/**
+ * Boot-time regression guard (Phase A1 of the boot/TUI perf work).
+ *
+ * Re-runs the `PI_TIMING=x` cold-boot benchmark under hyperfine and fails when
+ * the median regresses past `baseline * THRESHOLD`. `PI_TIMING=x` runs the full
+ * pre-paint chain in `runRootCommand` and then `process.exit(0)`, so the
+ * never-exiting interactive launch becomes a terminating, benchmarkable boot.
+ *
+ * Boot wall-clock is MACHINE-RELATIVE: a baseline captured on one machine is
+ * meaningless on another (and on CI). This is a LOCAL guard — regenerate the
+ * baseline on the machine you measure on, then compare on that same machine.
+ * It is intentionally NOT wired into CI for that reason.
+ *
+ *   bun scripts/bench-guard.ts --update   # capture/refresh the baseline
+ *   bun scripts/bench-guard.ts            # measure + compare; exit 1 on regression
+ *
+ * Requires `hyperfine` on PATH.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+const THRESHOLD = 1.05; // 5% regression budget
+const BASELINE_PATH = path.join(import.meta.dir, "..", "bench", "boot-baseline.json");
+const BENCH_COMMAND = "PI_TIMING=x bun src/cli.ts";
+const cwd = path.join(import.meta.dir, "..");
+
+function medianOf(hyperfineJson: string): number {
+	const parsed = JSON.parse(hyperfineJson) as { results: Array<{ mean: number; median?: number }> };
+	const result = parsed.results[0];
+	if (!result) throw new Error("hyperfine produced no result");
+	return result.median ?? result.mean;
+}
+
+async function measure(): Promise<{ seconds: number; raw: string }> {
+	const tmp = path.join(import.meta.dir, "..", "bench", `.boot-run-${Date.now()}.json`);
+	const proc = Bun.spawn(["hyperfine", "--warmup", "3", "--min-runs", "10", "--export-json", tmp, BENCH_COMMAND], {
+		cwd,
+		stdout: "inherit",
+		stderr: "inherit",
+	});
+	const code = await proc.exited;
+	if (code !== 0) throw new Error(`hyperfine exited ${code}`);
+	const raw = await Bun.file(tmp).text();
+	fs.rmSync(tmp, { force: true });
+	return { seconds: medianOf(raw), raw };
+}
+
+const update = process.argv.includes("--update");
+const { seconds, raw } = await measure();
+
+if (update) {
+	fs.mkdirSync(path.dirname(BASELINE_PATH), { recursive: true });
+	await Bun.write(BASELINE_PATH, raw);
+	console.log(`Baseline updated: ${(seconds * 1000).toFixed(0)}ms median -> ${BASELINE_PATH}`);
+	process.exit(0);
+}
+
+if (!fs.existsSync(BASELINE_PATH)) {
+	console.error("No baseline found. Run `bun scripts/bench-guard.ts --update` on this machine first.");
+	process.exit(2);
+}
+
+const baseline = medianOf(await Bun.file(BASELINE_PATH).text());
+const ratio = seconds / baseline;
+const verdict = ratio > THRESHOLD ? "REGRESSION" : "ok";
+console.log(
+	`boot median: ${(seconds * 1000).toFixed(0)}ms vs baseline ${(baseline * 1000).toFixed(0)}ms ` +
+		`(${((ratio - 1) * 100).toFixed(1)}%, budget ${((THRESHOLD - 1) * 100).toFixed(0)}%) -> ${verdict}`,
+);
+process.exit(ratio > THRESHOLD ? 1 : 0);

package/src/cli/args.ts

@@ -32,6 +32,8 @@ export interface Args {
 	sessionDir?: string;
 	providerSessionId?: string;
 	fork?: string;
+	/** Collab link to join at startup (set by the `join` subcommand; no CLI flag). */
+	join?: string;
 	models?: string[];
 	tools?: string[];
 	noTools?: boolean;