@wrongstack/core 0.287.0 → 0.291.0

package/dist/utils/message-invariants.d.ts

@@ -9,6 +9,15 @@ export interface MessageRepairResult {
     messages: Message[];
     report: MessageRepairReport;
 }
+/**
+ * Whether message content carries anything that must survive in conversation
+ * state and session replay.
+ *
+ * Empty text blocks are common when a stream is interrupted before producing
+ * output. Tool calls, images, tool results, and signed thinking blocks remain
+ * meaningful even when they do not contain visible assistant text.
+ */
+export declare function hasMeaningfulContent(content: Message['content']): boolean;
 /**
  * Repair provider-level tool-call adjacency invariants.
  *

package/dist/utils/message-invariants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-invariants.d.ts","sourceRoot":"","sources":["../../src/utils/message-invariants.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAyD/E"}
+{"version":3,"file":"message-invariants.d.ts","sourceRoot":"","sources":["../../src/utils/message-invariants.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAUzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAyD/E"}

package/dist/utils/safe-json.d.ts

@@ -7,7 +7,7 @@ export declare function safeParse<T = unknown>(input: string, maxBytes?: number)
 export declare function safeStringify(value: unknown, pretty?: boolean): string;
 /**
  * Attempt to parse JSON5-style input and return a valid JSON string.
- * Handles trailing commas, single-line comments, and unquoted keys
+ * Handles trailing commas, line/block comments, and unquoted keys
  * that are common in provider output.
  *
  * Returns the sanitized string if it parses successfully as JSON,

package/dist/utils/safe-json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"safe-json.d.ts","sourceRoot":"","sources":["../../src/utils/safe-json.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,eAAe,CAAC,CAAC,CAAC,CAY9F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,UAAQ,GAAG,MAAM,CAoBpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0B3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYxD"}
+{"version":3,"file":"safe-json.d.ts","sourceRoot":"","sources":["../../src/utils/safe-json.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,eAAe,CAAC,CAAC,CAAC,CAY9F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,UAAQ,GAAG,MAAM,CAoBpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuB3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYxD"}

package/dist/utils/term.d.ts

@@ -130,4 +130,283 @@ export declare function writeOut(s: string, stream?: NodeJS.WriteStream): boolea
  * swap the destination for the entire process in one place.
  */
 export declare function writeErr(s: string, stream?: NodeJS.WriteStream): boolean;
+/**
+ * Color depth the terminal can render.
+ *
+ *   0 = no color (dumb, redirected, `TERM=dumb`)
+ *   1 = 16 colors  (basic ANSI)
+ *   2 = 256 colors (ANSI 256 + bright variants)
+ *   3 = 16.7M / 24-bit truecolor
+ */
+export type ColorDepth = 0 | 1 | 2 | 3;
+/**
+ * Mouse tracking protocol the terminal speaks.
+ *
+ *   'none' — no mouse reporting
+ *   'x10'  — basic button press/release, capped at 223 columns
+ *   'urxvt'— URXVT extension, supports >223 cols
+ *   'sgr'  — SGR extended mode, modern standard, no column cap
+ */
+export type MouseProtocol = 'none' | 'x10' | 'urxvt' | 'sgr';
+/**
+ * A snapshot of the terminal's capabilities and identity, computed once at
+ * startup. Call {@link detectTerminal} once and pass the result through your
+ * app — never re-detect mid-session.
+ *
+ * Query once → adapt once. Re-querying on every render is wrong because
+ * `$TERM` is static for the process lifetime and stdout.isTTY can only go
+ * from true→false (never the reverse), so a mid-session change means the
+ * process was started in a terminal and then something went wrong.
+ */
+export interface TerminalCapability {
+    /** True when both stdin and stdout are attached to a terminal. */
+    isRealTTY: boolean;
+    /**
+     * Whether the terminal speaks color.
+     *
+     * Uses the industry-standard precedence:
+     *   `FORCE_COLOR=0`  → 0 (disabled)
+     *   `FORCE_COLOR`    → 3 (force truecolor)
+     *   `NO_COLOR=…`     → 0 (opted out)
+     *   `COLORTERM=truecolor|24bit` → 3
+     *   `TERM=…truecolor|24bit`    → 3 (some emulators advertise it)
+     *   `TERM=…256color`           → 2
+     *   fallback                      → 1
+     *
+     * Note: `TERM=dumb` always produces 0 even if `COLORTERM=truecolor` is set —
+     * `dumb` terminals are non-interactive by definition.
+     */
+    colorDepth: ColorDepth;
+    /**
+     * Whether `stdout` can be written to. Determined once at startup from
+     * `stdout?.isTTY ?? false`. Even when `isRealTTY` is true, `stdout` may be
+     * writable=false (e.g. the terminal was closed mid-session).
+     */
+    stdoutWritable: boolean;
+    /**
+     * Best mouse protocol the terminal speaks. Progressive enhancement:
+     * attempt SGR first, fall back to URXVT, then X10, then 'none'.
+     *
+     * The caller (typically the App component) decides whether to enable
+     * tracking at all — this only reports what the terminal CAN understand.
+     */
+    mouseProtocol: MouseProtocol;
+    /**
+     * Whether the terminal title can be set via OSC 0 / OSC 2.
+     * True when stdout is a TTY and `$TERM` is not `dumb`.
+     */
+    canSetTitle: boolean;
+    /**
+     * Whether the terminal understands the tmux DCS passthrough prefix.
+     * Detected by seeing `$TERM=tmux*`. When true, escape sequences should be
+     * wrapped: `\x1bPtmux;\x1b${seq}\x1b\\`.
+     */
+    isTmux: boolean;
+    /**
+     * Whether the terminal is on Windows using the legacy conhost backend
+     * (cmd.exe, PowerShell non-ConPTY) rather than ConPTY (Windows Terminal,
+     * VS Code Integrated Terminal). Used to apply Windows-specific raw-mode
+     * handoff logic.
+     *
+     * Detected by: platform === 'win32' AND `!process.stdout.getColorDepth?.()`
+     * (ConPTY exposes color depth; conhost does not). Also false on non-Windows.
+     */
+    isWindowsConhost: boolean;
+}
+/**
+ * Detect the terminal's capabilities and identity at startup.
+ *
+ * Call once, early in process boot, before any event-loop async has had a
+ * chance to corrupt the read of `process.stdout.isTTY`. Store the result and
+ * pass it through the app — do NOT call this on every render.
+ *
+ * All `env` lookups default gracefully to safe values when the env var is
+ * absent or empty, so the return value is deterministic regardless of what
+ * the host's environment looks like.
+ */
+export declare function detectTerminal(opts?: {
+    stdin?: NodeJS.ReadStream | null;
+    stdout?: NodeJS.WriteStream | null;
+    env?: typeof process.env;
+}): TerminalCapability;
+/**
+ * Lifecycle owner for the TTY stdin raw-mode state machine.
+ *
+ * Raw mode is the most dangerous primitive in TUI code. Getting it wrong leaves
+ * the user's terminal in a broken state (line-buffered, no echo) that requires
+ * closing and reopening the terminal to recover. This class enforces a strict
+ * acquire → hold → release lifecycle:
+ *
+ *   - `acquire()` may be called only once (idempotent — subsequent calls no-op).
+ *   - `release()` restores the previous mode exactly once.
+ *   - `release()` is called automatically on process `exit` and `beforeExit`.
+ *   - Any signal handler (SIGINT, SIGTERM, SIGHUP) that calls `release()` clears
+ *     its own registration so double-signals don't double-restore.
+ *
+ * Use this instead of calling `setRawMode()` directly at every call site. The
+ * single instance lives at module scope in `run-tui.ts`; components that need
+ * to signal "TUI is shutting down" call `terminalLifecycle.requestExit()` rather
+ * than calling `release()` directly.
+ */
+export declare class TerminalLifecycle {
+    private _active;
+    /**
+     * The stdin stream we took raw mode on. Set by `acquire()`; undefined before
+     * first call. Used by `release()` and by the ConPTY race-closer in
+     * `acquire()`.
+     */
+    private _stdin;
+    /**
+     * The `isRaw` snapshot captured before the first `acquire()` call, so
+     * `release()` restores to the pre-TUI state rather than blindly disabling
+     * raw mode. Null when `acquire()` has never been called.
+     */
+    private _wasRaw;
+    /**
+     * Request the process to exit. Set the flag, trigger any registered
+     * `onRequestExit` callback (typically Ink's `unmount()`), and arm a
+     * deadline timer.  When the timer fires the process is hard-exited.
+     *
+     * Safe to call multiple times: subsequent calls no-op after the first.
+     */
+    requestExit: (exitCode?: number) => void;
+    /**
+     * Callback invoked when `requestExit` is called. Registered by the Ink
+     * mount point so unmount() runs before the deadline timer fires.
+     */
+    onRequestExit: (() => void | Promise<void>) | null;
+    constructor();
+    /** True while raw mode is held. */
+    get active(): boolean;
+    /**
+     * Acquire raw mode on `stdin`. Idempotent — calling twice is safe; only the
+     * first call has any effect.
+     *
+     * On Windows ConPTY, calls `setRawMode` twice: once immediately, then again
+     * after the next event-loop tick. This closes the ConPTY race where
+     * `readline`'s cleanup (registered before this class is constructed) can
+     * restore the original cooked mode after we set raw mode but before Ink's
+     * render loop takes over the stdin fd. The double-call ensures the last
+     * writer wins.
+     *
+     * @param stdin - The stdin stream (defaults to `process.stdin`).
+     * @returns `true` if raw mode was acquired; `false` if stdin is not a TTY
+     *          or already shut down.
+     */
+    acquire(stdin?: NodeJS.ReadStream): boolean;
+    /**
+     * Release raw mode and restore the terminal to the state it was in before
+     * `acquire()` was called. Idempotent — subsequent calls are no-ops.
+     *
+     * Call this on: SIGINT, SIGTERM, SIGHUP, SIGBREAK, and `process.exit`.
+     *
+     * ⚠ **Windows caveat**: `setRawMode(false)` on ConPTY restores the original
+     * console mode captured when the process started — not the mode captured by
+     * `acquire()`. On ConPTY, the original mode was already raw (ConPTY starts
+     * raw), so this call is typically a no-op on Windows Terminal. On conhost.exe
+     * it may restore cooked mode, which is correct for that backend.
+     */
+    release(): void;
+    /**
+     * Synchronously reset all terminal state written by the TUI layer:
+     * raw mode, SGR attributes, cursor visibility, and mouse tracking.
+     *
+     * Intended for the final `process.on('exit')` handler where async is
+     * impossible. Uses `\x1b[0m` (SGR reset), `\x1b[?25h` (cursor show),
+     * and `\x1b[?9l` (mouse off) — all safe to emit even if the terminal does
+     * not understand them (unknown CSI sequences are silently ignored).
+     *
+     * Safe to call multiple times from multiple exit paths because each write
+     * is a constant-time synchronous stream write.
+     *
+     * @param stdout - Stream to reset (defaults to `process.stdout`).
+     */
+    reset(stdout?: NodeJS.WriteStream): void;
+}
+/**
+ * Result of emitting an escape sequence. Distinguishes the three distinct
+ * failure modes so callers can degrade gracefully.
+ */
+export interface EscapeEmitResult {
+    /** `true` when the sequence was written to the stream. */
+    ok: boolean;
+    /**
+     * Human-readable reason when `ok` is `false`. One of:
+     *   `'not_a_tty'`   — stdout is not a terminal (pipe / redirect / CI)
+     *   `'unwritable'`  — stdout.write is missing or threw
+     *   `'empty'`       — `sequence` was the empty string
+     */
+    reason: 'not_a_tty' | 'unwritable' | 'empty';
+}
+/**
+ * A terminal escape sequence with its optional string terminator.
+ *
+ * OSC (title, color palette) sequences MUST be terminated with `BEL (\x07)`
+ * or `ST (\x1b\\)` or the terminal stays in command mode and corrupts
+ * subsequent output. CSI sequences (colors, cursor movement) are
+ * self-terminating and do not need a terminator byte.
+ */
+export interface EscapeSequence {
+    /** The raw sequence, e.g. `\x1b[38;2;255;0;0m`. */
+    raw: string;
+    /**
+     * Optional terminator byte required by OSC/DCS families.
+     * `undefined` for CSI sequences; `\x07` (BEL) for OSC; `\x1b\\` (ST) for DCS.
+     */
+    terminator?: string;
+}
+/**
+ * Shared OSC/DCS terminator bytes.
+ *
+ * BEL (`\x07`) is understood by iTerm2, Konsole, mintty, foot, and
+ * Windows Terminal. ST (`\x1b\\`) is the strict DEC standard equivalent.
+ * Prefer BEL for compatibility; fall back to ST if the terminal's response
+ * to BEL is observed to be garbled.
+ */
+export declare const ESCAPE_TERMINATOR: Readonly<{
+    BEL: "\u0007";
+    ST: "\u001B\\";
+}>;
+/**
+ * Emit a terminal escape sequence safely.
+ *
+ * Rules enforced:
+ *   1. Empty string → returns `ok: false, reason: 'empty'`, no write.
+ *   2. Not a TTY    → returns `ok: false, reason: 'not_a_tty'`, no write.
+ *   3. Stream write throws → returns `ok: false, reason: 'unwritable'`.
+ *   4. OSC/DCS sequences MUST have a terminator byte (guarded assertion).
+ *      A missing terminator on an OSC sequence corrupts output on terminals
+ *      that don't understand the sequence — this function refuses to emit it.
+ *
+ * @param sequence - The sequence to emit. CSI sequences need no terminator.
+ *                   OSC/DCS sequences must carry `terminator: '\x07'` or `'\x1b\\'`.
+ * @param stdout   - Stream to write to (defaults to `process.stdout`).
+ * @returns Result indicating success or the specific failure mode.
+ */
+export declare function safeEmit(sequence: EscapeSequence | string, stdout?: NodeJS.WriteStream): EscapeEmitResult;
+/**
+ * Build an OSC 0 / OSC 2 (window/tab title) sequence with a safe terminator.
+ *
+ * The terminator defaults to `BEL (\x07)` for broad terminal compatibility.
+ * Use `terminator: ESCAPE_TERMINATOR.ST` for stricter terminals that interpret
+ * BEL as a beep.
+ *
+ * @param title   - The title string. Embedded BEL bytes are stripped.
+ * @param terminator - Defaults to `ESCAPE_TERMINATOR.BEL`.
+ */
+export declare function buildTitleSequence(title: string, terminator?: string): EscapeSequence;
+/**
+ * Build an SGR (Select Graphic Rendition) color/style sequence.
+ *
+ * @param codes - SGR parameter list, e.g. `[31]` (red foreground),
+ *                `[1;32]` (bold green), `[38;2;255;128;0]` (truecolor orange).
+ */
+export declare function buildSgrSequence(...codes: number[]): EscapeSequence;
+/**
+ * Emit a title sequence.  Convenience wrapper around `safeEmit` + `buildTitleSequence`.
+ *
+ * @param title - The title string.
+ * @param stdout - Target stream.
+ */
+export declare function setTitle(title: string, stdout?: NodeJS.WriteStream): boolean;
 //# sourceMappingURL=term.d.ts.map

package/dist/utils/term.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"term.d.ts","sourceRoot":"","sources":["../../src/utils/term.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,8EAA8E;AAC9E,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAM5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACtB,EAAE,EAAE,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,EAClD,MAAM,GAAE,MAAM,CAAC,WAA4B,GAC1C,MAAM,IAAI,CAYZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAK3E;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,OAAO,IAAI,IAAI,CAAC;IAChB,oEAAoE;IACpE,MAAM,IAAI,IAAI,CAAC;CAChB;AAID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAEtE;AAsCD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CACtB,CAAC,EAAE,MAAM,EACT,MAAM,GAAE,MAAM,CAAC,WAA4B,GAC1C,OAAO,CAET;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CACtB,CAAC,EAAE,MAAM,EACT,MAAM,GAAE,MAAM,CAAC,WAA4B,GAC1C,OAAO,CAET"}
+{"version":3,"file":"term.d.ts","sourceRoot":"","sources":["../../src/utils/term.ts"],"names":[],"mappings":"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"}

package/dist/utils/tool-wire-compact.d.ts

@@ -23,6 +23,15 @@ export interface CompactWireToolDefinition {
  * largest repeated cost in provider tool declarations.
  */
 export declare function compactToolDefinitionForWire(tool: ToolWireDefinitionLike, opts?: CompactToolDefinitionForWireOptions): CompactWireToolDefinition;
+/**
+ * Tool inputs are always JSON objects, but dynamically supplied MCP/plugin
+ * schemas sometimes express that object as a top-level oneOf/anyOf/allOf.
+ * Anthropic-family endpoints reject those combinators at the input_schema
+ * root (including when reached through an OpenAI-compatible gateway such as
+ * OmniRoute). Keep nested combinators intact and flatten only the root.
+ * Runtime validation still uses the tool's original schema.
+ */
+export declare function normalizeTopLevelToolSchema(schema: Record<string, unknown>): Record<string, unknown>;
 export declare function compactSchemaDescriptions(schema: unknown, maxDescriptionChars?: number): Record<string, unknown>;
 export declare function compactDescription(text: string, maxChars: number): string;
 export declare function findSemanticBoundary(text: string, limit: number): number;

package/dist/utils/tool-wire-compact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-wire-compact.d.ts","sourceRoot":"","sources":["../../src/utils/tool-wire-compact.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,mCAAmC;IAClD,yCAAyC;IACzC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,uDAAuD;IACvD,yBAAyB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAOD;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,sBAAsB,EAC5B,IAAI,GAAE,mCAAwC,GAC7C,yBAAyB,CAwB3B;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,mBAAmB,SAA+B,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzB;AAmBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CASzE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAaxE"}
+{"version":3,"file":"tool-wire-compact.d.ts","sourceRoot":"","sources":["../../src/utils/tool-wire-compact.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,mCAAmC;IAClD,yCAAyC;IACzC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,uDAAuD;IACvD,yBAAyB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAOD;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,sBAAsB,EAC5B,IAAI,GAAE,mCAAwC,GAC7C,yBAAyB,CA0B3B;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyCzB;AAQD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,EACf,mBAAmB,SAA+B,GACjD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzB;AAmBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CASzE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAaxE"}

package/dist/utils/wstack-paths.d.ts

@@ -21,8 +21,18 @@ export interface WstackPaths {
      * without rewriting callers.
      */
     configDir: string;
-    /** ~/.wrongstack/config.json */
+    /** ~/.wrongstack/config.json — bootstrap config (activeProfile + version). */
     globalConfig: string;
+    /**
+     * ~/.wrongstack/profiles — directory containing per-profile configs.
+     * Each profile has its own subdirectory with a config.json.
+     */
+    profilesDir: string;
+    /**
+     * Resolve the config path for a named profile.
+     * Returns ~/.wrongstack/profiles/<name>/config.json.
+     */
+    profileConfig: (name: string) => string;
     /** ~/.wrongstack/.key — 32 random bytes, mode 0600, AES-GCM key for the secret vault. */
     secretsKey: string;
     /** ~/.wrongstack/memory.md — user-global memory. */
@@ -100,7 +110,7 @@ export interface WstackPaths {
     projectSddSession: string;
     /** ~/.wrongstack/projects/<hash>/plan.json — plan persistence */
     projectPlan: string;
-    /** ~/.wrongstack/projects/<hash>/autophase — AutoPhase phase-graph JSON files */
+    /** ~/.wrongstack/projects/<hash>/autophase — Goal phase-graph JSON files (dir name kept for backward compat) */
     projectAutophase: string;
     /** ~/.wrongstack/projects/<hash>/sdd-boards — live SDD board snapshots + JSONL event logs */
     projectSddBoards: string;

package/dist/utils/wstack-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wstack-paths.d.ts","sourceRoot":"","sources":["../../src/utils/wstack-paths.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wstack-paths.d.ts","sourceRoot":"","sources":["../../src/utils/wstack-paths.ts"],"names":[],"mappings":"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"}

package/dist/worktree/worktree-manager.d.ts

@@ -10,7 +10,7 @@ export type WorktreeStatus = 'allocating' | 'active' | 'committing' | 'merging'
 export interface WorktreeHandle {
     /** Stable id (== slug). Used as the event `handleId`. */
     id: string;
-    /** Caller-supplied owner (a phase id in AutoPhase). */
+    /** Caller-supplied owner (a phase id in Goal). */
     ownerId: string;
     /** Human label for the owner (phase name). */
     ownerLabel: string;

package/dist/worktree/worktree-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worktree-manager.d.ts","sourceRoot":"","sources":["../../src/worktree/worktree-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"worktree-manager.d.ts","sourceRoot":"","sources":["../../src/worktree/worktree-manager.ts"],"names":[],"mappings":"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"}

package/instructions/agents/ios.md

@@ -0,0 +1,113 @@
+You are the iOS assistant. Your job is Apple-platform app development:
+design and ship Swift code that compiles against the latest Apple SDKs,
+runs correctly on iOS/iPadOS/tvOS/watchOS/visionOS/macOS, and meets
+App Store and privacy requirements.
+
+Anchor toolchain (baseline, verified against Apple's Xcode 26 release
+notes — consult your installed Xcode for exact patch versions such as
+26.6 / Swift 6.3 / 26.5 SDKs):
+- Xcode 26 with Swift 6.2 and the iOS 26, iPadOS 26, tvOS 26, watchOS 26,
+  macOS Tahoe 26, and visionOS 26 SDKs as the major line this persona
+  is written against.
+- Requires a Mac running macOS Sequoia 15.6 or later.
+- Swift 6.2's "Approachable Concurrency" changes default isolation
+  rather than weakening safety: top-level code runs on the main actor
+  by default, `async` functions inherit the caller's isolation unless
+  explicitly marked `@concurrent`, and most `Sendable` annotations can
+  be inferred. Compile-time data-race safety is preserved. Use it when
+  the new defaults fit your design; don't assume it in code that must
+  build with Swift 6.0/6.1 toolchains.
+
+Talking to Xcode (use the current major-line versions of these tools;
+consult `xcodebuild -version` and `xcrun --find` to confirm what's
+installed before pinning specific CLI flags):
+- `xcodebuild` for build / test / archive / clean / `-showBuildSettings`
+  / `-list` / scheme + destination selection; prefer `-resultBundlePath`
+  for machine-readable results and pair with `xcrun xcresulttool get ...
+  --legacy` or the modern JSON API for CI parsing
+- `xcrun simctl` for the Simulator: `list`, `boot`, `shutdown`, `install`,
+  `launch`, `terminate`, `io`, `screenshot`, `log`, `privacy`, `push`,
+  `erase`; run on every supported OS for the project's deployment target
+- `xcrun devicectl` for physical-device management (modern replacement
+  for `ios-deploy`): `list devices`, `device process launch`, `device
+  process terminate`, log streaming, and on-device debugging attach
+- `xcrun xctrace` / `xcrun instruments` for profiling (Time Profiler,
+  Allocations, Leaks, SwiftUI template, Animation Hitches); prefer
+  `xctrace record --template ...` for CI-friendly `.trace` bundles
+- `xcrun preview` and Xcode Previews for SwiftUI iteration; treat
+  previews as a development tool, not a substitute for unit/UI tests
+- `xcrun notarytool` and `xcrun stapler` for `Developer ID` /
+  `notary-service` workflows when distributing outside the App Store
+- Swift Package Manager (`swift build`, `swift test`, `swift package`)
+  for packages and mixed Xcode+SPM projects; keep `Package.swift` tools
+  version aligned with the project's Swift compiler version
+- Readability wrappers (`xcbeautify`, `xcpretty`) when you need
+  human-friendly CI logs; never let them hide build failures — always
+  inspect the underlying `xcodebuild` exit code
+- Pin a single source of truth for toolchain versions: a `.xcode-version`
+  file (Xcode 26+) or `bundler`-style lockfile; document the minimum
+  Xcode and macOS required to build in the README, not in prose that
+  can drift out of sync with the toolchain
+
+Scope:
+- Build Swift features across UIKit, SwiftUI, AppKit, and platform
+  frameworks (Foundation, SwiftData, Core Data, Combine, AVFoundation,
+  CoreLocation, MapKit, WidgetKit, ActivityKit, StoreKit, etc.)
+- Wire persistence, networking, concurrency, and platform integrations
+  (push, Sign in with Apple, in-app purchase, App Intents, Share/Activity)
+- Implement accessibility, localization, and privacy-correct behaviors
+  by default — not as a later polish pass
+- Handle deployment targets, capability entitlements, and App Store /
+  TestFlight submission requirements
+
+Input format you accept:
+{ "task": "view | feature | persistence | integration | build | ship",
+  "platform": "ios | ipados | tvos | watchos | visionos | macos",
+  "minDeploymentTarget": "<e.g. iOS 17.0>",
+  "framework": "swiftui | uikit | appkit | mixed",
+  "feature": "<what to build or change>" }
+
+Output: Markdown iOS report:
+- ## Implementation (types/Views/ViewModels + responsibilities)
+- ## Platform/SDK notes (deployment target, entitlements, capabilities)
+- ## Concurrency/State (isolation, actor boundaries, observation model)
+- ## Privacy/Accessibility (purpose strings, ATT, VoiceOver, Dynamic Type)
+- ## Verification (build with Xcode 26, tests run on simulator/device)
+
+Working rules:
+- Default to Swift 6 language mode with strict concurrency; isolate
+  mutable shared state in actors, never in globals
+- Use `async`/`await` and structured concurrency (TaskGroup,
+  AsyncSequence); cancel long-running work and propagate cancellation
+- Prefer SwiftUI's `@Observable` macro on focused reference-type view
+  models; reach for plain structs only when observation and identity
+  are not needed, and fall back to `ObservableObject` only when
+  targeting pre-iOS-17 deployment
+- Keep View bodies pure and side-effect-free; do I/O in the model layer
+  or in explicit `.task` / `.onChange` modifiers
+- Match the deployment target honestly — don't call iOS 26 APIs on an
+  iOS 17 target; use `if #available(iOS 26, *)` or `@available`
+  attributes for newer features
+- Use SwiftData for new persistence unless the project is on Core Data;
+  `@Model` types are reference-type classes — design them for controlled
+  mutation, stable identity, and explicit relationship semantics, and
+  isolate the `ModelContainer`/`ModelContext` per actor or per scene
+- Write tests with Swift Testing (`@Test`, parameterized tests, traits)
+  alongside existing XCTest; do not mix assertion styles in one file
+- Accessibility is not optional: provide VoiceOver labels, support
+  Dynamic Type (avoid fixed font sizes), honor Reduce Motion and
+  Increase Contrast, and verify focus order on real devices
+- Privacy: declare Info.plist purpose strings for every sensitive API,
+  respect App Tracking Transparency, ship a Privacy Manifest
+  (`PrivacyInfo.xcprivacy`), and minimize on-device data collection
+- For App Intents, App Shortcuts, and widgets, follow the
+  process-isolated extension model and avoid sharing state via globals
+- Don't disable concurrency warnings to make code compile — fix the
+  isolation. Under Swift 6.2's Approachable Concurrency, prefer the
+  inferred defaults (main-actor top-level code, caller-context `async`)
+  and reach for explicit `@concurrent` only for work that genuinely
+  needs to run off the current isolation. Safety checks stay on;
+  "Approachable" means less annotation, not looser guarantees
+- Build with Xcode 26 and run the test suite on a real simulator
+  before claiming a change is done; a green `xcodebuild` is the
+  minimum bar, not the goal

package/instructions/agents/search.md

@@ -17,7 +17,7 @@ Output: Markdown result set:
 - ## Not Found (terms searched with zero hits, so the caller can rephrase)
 
 Working rules:
-- Read-only; rely on grep/glob/search, never edit
+- Read-only; prefer live `codebase-search` before broad grep/glob/tree exploration. If it reports no index, tell the caller to run `codebase-index`, then use the best read-only fallback; never edit or build the index yourself
 - Always rank by relevance and explain the ranking in one clause
 - Distinguish definition sites from usage sites explicitly
 - Report search terms that returned nothing so the caller can refine