@wrongstack/cli 0.284.0 → 0.285.0

package/dist/preflight.d.ts

@@ -0,0 +1,58 @@
+import type { Config } from '@wrongstack/core';
+import type { UpdateInfo } from './update-check.js';
+export interface PreflightResult {
+    /** The (possibly refreshed) update info, after the 2-second
+     *  quick-check. Undefined if the check was aborted. */
+    updateInfo: UpdateInfo | undefined;
+    /** Whether `setDebugStreamEnabled(true)` was called. Callers
+     *  don't need this today, but exporting it makes the
+     *  orchestrator's effect explicit. */
+    debugStreamEnabled: boolean;
+}
+/**
+ * Default `NODE_ENV=production` when unset, so the React/Ink
+ * `react-reconciler.development.js` path (which ticks
+ * `performance.measure()` per render and leaks ~200 user-timing
+ * entries/sec into Node's global timeline) is never picked.
+ *
+ * Must run before the lazy `--tui` import evaluates ink/react.
+ * The marker flag lets `buildChildEnv()` strip the injected
+ * value from child processes \u2014 a leaked `NODE_ENV=production`
+ * would make `pnpm install` skip devDependencies and flip
+ * test-runner behavior.
+ */
+export declare function applyNodeEnvDefault(): void;
+/**
+ * Pin one stable shell for the session on Windows via `WRONGSTACK_SHELL`, so
+ * the bash tool's shell routing and the system-prompt Environment block agree
+ * on a single target the model can write syntax for. No-op on POSIX and when
+ * the user already set a valid `WRONGSTACK_SHELL`. Defaults Windows to
+ * PowerShell (pwsh 7+ when present); `WRONGSTACK_SHELL=cmd` opts back to cmd.exe.
+ *
+ * Like `applyNodeEnvDefault()`, this is idempotent — once the env var is set the
+ * second call (inside `runPreflight()`) is a no-op.
+ */
+export declare function applySessionShellDefault(): void;
+/**
+ * Best-effort `printUpdateNotice()` wrapper. The 2-second
+ * quick-check is a network call that must not block boot;
+ * callers get back the (possibly refreshed) `UpdateInfo`
+ * so version-aware UI can render without re-fetching.
+ */
+export declare function applyPrintUpdateNotice(initialUpdateInfo: UpdateInfo | undefined): Promise<UpdateInfo | undefined>;
+/**
+ * Seed the stream-debug singleton from persisted config so
+ * `WireAdapter` picks it up on construction. Runtime toggles
+ * (e.g. `/diag-stats stream-debug on`) update this singleton
+ * directly; the config file is the source of truth for
+ * restarts. The default debug-stream callback is intentionally
+ * left unset \u2014 see the module-level docstring for why.
+ */
+export declare function applyDebugStreamSeed(config: Config): Promise<void>;
+/**
+ * Apply every pre-boot side effect, in dependency order. Returns
+ * the (possibly refreshed) update info so the caller can write
+ * it back into the `BootContext` for downstream consumers.
+ */
+export declare function runPreflight(config: Config, initialUpdateInfo: UpdateInfo | undefined): Promise<PreflightResult>;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"AA+CA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,MAAM,WAAW,eAAe;IAC9B;2DACuD;IACvD,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IACnC;;0CAEsC;IACtC,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,iBAAiB,EAAE,UAAU,GAAG,SAAS,GACxC,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAEjC;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxE;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,UAAU,GAAG,SAAS,GACxC,OAAO,CAAC,eAAe,CAAC,CAS1B"}

package/dist/project-picker.d.ts

@@ -0,0 +1,56 @@
+import type { ProjectEntry } from './slash-commands/project-utils.js';
+export interface PickerItem {
+    key: string;
+    label: string;
+    subtitle?: string | undefined;
+    meta?: string | undefined;
+    kind: 'project' | 'action';
+}
+export interface PickerConfig {
+    title: string;
+    items: PickerItem[];
+    globalConfigPath?: string | undefined;
+}
+export interface PickerResult {
+    kind: 'project' | 'action';
+    key: string;
+    /** Resolved project entry (only set when kind === 'project') */
+    project?: ProjectEntry | undefined;
+    /** Action identifier: 'new-session', 'prev-sessions', 'quit' */
+    action?: 'new-session' | 'prev-sessions' | 'quit' | undefined;
+}
+/**
+ * Build the picker items from the projects manifest plus built-in actions.
+ */
+export declare function buildPickerItems(opts: {
+    globalConfigPath?: string | undefined;
+    currentProjectRoot?: string | undefined;
+}): Promise<PickerItem[]>;
+/**
+ * Filter items by a case-insensitive substring match against label and subtitle.
+ * Only project items are filtered; action items and dividers always appear.
+ *
+ * @public — exported for testing
+ */
+export declare function filterItems(allItems: PickerItem[], filter: string): PickerItem[];
+/**
+ * Compute the effective visible height accounting for the filter bar overhead.
+ *
+ * @public — exported for testing
+ */
+export declare function effectiveVisibleHeight(baseVisibleHeight: number, filter: string): number;
+/**
+ * Skip divider items at the given index, moving forward or backward.
+ * Returns the adjusted index, clamped to bounds.
+ *
+ * @public — exported for testing
+ */
+export declare function skipDivider(items: PickerItem[], idx: number, direction: -1 | 1): number;
+/**
+ * Run the interactive project picker. Returns the selection or undefined on cancel.
+ */
+export declare function runProjectPicker(opts: {
+    globalConfigPath?: string | undefined;
+    currentProjectRoot?: string | undefined;
+}): Promise<PickerResult | undefined>;
+//# sourceMappingURL=project-picker.d.ts.map

package/dist/project-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-picker.d.ts","sourceRoot":"","sources":["../src/project-picker.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAwBtE,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,OAAO,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACnC,gEAAgE;IAChE,MAAM,CAAC,EAAE,aAAa,GAAG,eAAe,GAAG,MAAM,GAAG,SAAS,CAAC;CAC/D;AA0BD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAmCxB;AAuGD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAchF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGxF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAMvF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAySpC"}

package/dist/provider-config-utils.d.ts

@@ -0,0 +1,58 @@
+import { expectDefined } from '@wrongstack/core';
+export { expectDefined };
+import type { ProviderApiKey, ProviderConfig, SecretVault } from '@wrongstack/core';
+/**
+ * Normalize a ProviderConfig to the canonical `apiKeys[]` form.
+ * Migrates the legacy single-key `apiKey` field on the fly so every
+ * consumer sees a uniform shape. Does NOT mutate the input.
+ */
+export declare function normalizeKeys(cfg: ProviderConfig): ProviderApiKey[];
+/**
+ * Write a normalized key list back into a ProviderConfig. Does NOT mirror
+ * the plaintext key to the legacy `apiKey` field — that would leak the
+ * secret on any accidental JSON.stringify of the config. Consumers that
+ * need the real key must call {@link resolveActiveApiKey}.
+ */
+export declare function writeKeysBack(cfg: ProviderConfig, keys: ProviderApiKey[]): void;
+/**
+ * Extract the active (decrypted) API key from a ProviderConfig.
+ *
+ * Resolution order:
+ *   1. `apiKeys[]` — pick the entry matching `activeKey`, or the first one
+ *   2. Legacy `apiKey` field — only for configs not yet migrated to multi-key
+ *
+ * This is the **preferred** way to read the API key. Never read `cfg.apiKey`
+ * directly in new code — after {@link writeKeysBack} it is cleared, and even
+ * when present on a freshly-loaded config it may contain a masked value.
+ */
+export declare function resolveActiveApiKey(cfg: ProviderConfig): string | undefined;
+/**
+ * Clear top-level provider/model defaults when provider mutations make them
+ * stale. This prevents a removed provider, deleted final key, or edited model
+ * allowlist from being accepted on the next boot and crashing provider setup.
+ */
+export declare function clearStaleProviderDefaults(config: Record<string, unknown>): void;
+/**
+ * Return the label of the active key, or the first key's label if no
+ * active is pinned. Returns `undefined` when there are no keys at all.
+ */
+export declare function activeLabel(cfg: ProviderConfig, keys: ProviderApiKey[]): string | undefined;
+/** Mask an API key for display: show first 4 + last 4 chars. */
+export declare function maskedKey(key: string): string;
+/** ISO-8601 timestamp for key `createdAt` fields. */
+export declare function nowIso(): string;
+/**
+ * Read the on-disk config file and return its `providers` map, fully
+ * decrypted. Returns `{}` on ENOENT or corrupt JSON (surfacing the error
+ * via the optional `warn` callback when provided).
+ */
+export declare function loadConfigProviders(configPath: string, vault: SecretVault, opts?: {
+    warn?: (msg: string) => void;
+}): Promise<Record<string, ProviderConfig>>;
+/**
+ * Load → mutate → encrypt → atomic-write. Operates on the FULL config file
+ * so non-provider keys are preserved. Refuses to overwrite a corrupt-but-
+ * existing config (the user may still have salvageable data).
+ */
+export declare function mutateConfigProviders(configPath: string, vault: SecretVault, mutator: (providers: Record<string, ProviderConfig>) => void): Promise<void>;
+//# sourceMappingURL=provider-config-utils.d.ts.map

package/dist/provider-config-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-config-utils.d.ts","sourceRoot":"","sources":["../src/provider-config-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAW,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,CAAC;AASzB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,cAAc,EAAE,CAQnE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,IAAI,CAgB/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAQ3E;AAqBD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAchF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,MAAM,GAAG,SAAS,CAG3F;AAED,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM7C;AAED,qDAAqD;AACrD,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAMD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,EAClB,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACtC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAoBzC;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,IAAI,GAC3D,OAAO,CAAC,IAAI,CAAC,CA0Cf"}

package/dist/provider-helpers.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Shared provider-config helpers used by the picker, main boot sequence,
+ * and subcommands. Keeps provider key detection and alias resolution in
+ * one place so the logic doesn't drift between call sites.
+ */
+import type { Config, ModelsRegistry, ProviderConfig, ResolvedProvider } from '@wrongstack/core';
+/** Return the provider's visible model ids.
+ *
+ * For most providers, `cfg.models` is a strict user allowlist. ChatGPT/OpenAI/Codex
+ * are catalog-backed by the curated providers.json overlay, so their saved config
+ * model list is treated as a cache/visibility hint: an empty list falls back to
+ * refreshed catalog models, and a non-empty list is augmented with catalog models
+ * so newly-added providers.json entries can be fetched again when needed. */
+export declare function visibleModelIds(providerId: string, config: Config, catalogModelIds: string[], cfg?: ProviderConfig | undefined): string[];
+/**
+ * Is this a keyless local gateway — a server on a loopback address that
+ * declares no API-key env vars (omniroute, LiteLLM/vLLM/LM Studio/Ollama
+ * running locally, …)? These need no credential, so they belong in the
+ * picker even though `hasApiKey` returns false for them. Accepts the
+ * minimal shape both call sites can supply.
+ */
+export declare function isKeylessLocalProvider(provider: {
+    apiBase?: string | undefined;
+    envVars?: string[] | undefined;
+}): boolean;
+/**
+ * Does this provider have an API key available — either in the
+ * environment (via one of its known env vars) or stored in config
+ * (encrypted or plaintext)? Used to filter the picker to providers
+ * the user can actually use right now.
+ */
+export declare function hasApiKey(provider: ResolvedProvider, config?: Config): boolean;
+/**
+ * Build the list of providers the user can switch to mid-session.
+ * Only includes providers that have an API key available (env var or
+ * stored config). Falls back to the full catalog when no keys are found.
+ *
+ * Models are inlined from the catalog (or from `cfg.models` for custom
+ * entries) so the picker can show a real selection.
+ */
+export declare function buildPickableProviders(modelsRegistry: ModelsRegistry, config: Config): Promise<Array<{
+    id: string;
+    family: string;
+    models: string[];
+}>>;
+/**
+ * Resolve a provider id that may be an alias. When the user has
+ * `providers[id].type` pointing at a different catalog entry, return
+ * the catalog id so downstream lookups still work. Returns the
+ * original id unchanged when it's a direct catalog match.
+ */
+export declare function resolveProviderAlias(providerId: string, config: Config): string;
+//# sourceMappingURL=provider-helpers.d.ts.map

package/dist/provider-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-helpers.d.ts","sourceRoot":"","sources":["../src/provider-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAuBjG;;;;;;6EAM6E;AAC7E,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,EAAE,EACzB,GAAG,CAAC,EAAE,cAAc,GAAG,SAAS,GAC/B,MAAM,EAAE,CAKV;AAoBD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE;IAC/C,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAChC,GAAG,OAAO,CAGV;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAO9E;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC,CA4ClE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAM/E"}

package/dist/renderer.d.ts

@@ -0,0 +1,76 @@
+import type { ContentBlock, Renderer, TextBlock, ToolResultRenderMode } from '@wrongstack/core';
+export interface TerminalRendererOptions {
+    out?: NodeJS.WriteStream | undefined;
+    err?: NodeJS.WriteStream | undefined;
+}
+export declare class TerminalRenderer implements Renderer {
+    private readonly out;
+    private readonly err;
+    private lineStart;
+    /**
+     * When true, every stdout-bound method is a no-op. This is the only
+     * safe state to be in while Ink owns the terminal (TUI mode):
+     * raw writes to stdout interleave with Ink's cursor math and cause
+     * the input + status bar to be reprinted as scrollback junk.
+     * Stderr-bound methods (writeInfo/Warning/Error) still flow — they
+     * go to a different stream Ink does not manage.
+     */
+    private silent;
+    /**
+     * Per-tool on-screen result render mode. Defaults to `'extend'` so
+     * existing callers without `setResultRenderMode` see full content.
+     * `setResultRenderMode(name, mode)` overrides the entry for `name`; the
+     * override is one-shot for that name (the default reasserts after the
+     * next write) so callers can set the mode right before each tool call
+     * without leaking state across unrelated tool calls.
+     */
+    private renderModes;
+    /** Mode applied when no entry is set for a given tool name. */
+    private static readonly DEFAULT_RENDER_MODE;
+    /** Lines kept per tool family in `extend` mode. */
+    private static readonly EXTEND_PREVIEW_LINES;
+    constructor(opts?: TerminalRendererOptions);
+    /**
+     * Toggle stdout suppression. Call `setSilent(true)` right before
+     * handing the terminal to Ink, and `setSilent(false)` after Ink
+     * exits. Idempotent.
+     */
+    setSilent(silent: boolean): void;
+    isSilent(): boolean;
+    setResultRenderMode(name: string, mode: ToolResultRenderMode): void;
+    private getRenderMode;
+    private clearRenderMode;
+    write(input: string | TextBlock): void;
+    writeLine(text?: string): void;
+    writeBlock(block: ContentBlock): void;
+    writeToolCall(name: string, input: unknown): void;
+    writeToolResult(name: string, content: unknown, isError: boolean): void;
+    writeDiff(diff: string): void;
+    writeWarning(text: string): void;
+    writeError(text: string): void;
+    writeInfo(text: string): void;
+    clear(): void;
+    /**
+     * Write a flashy agent completion banner for delegate tool results.
+     * Renders a box like:
+     * ┌─────────────────────────────────────┐
+     * │  ✓ [role] done in 4m 32s           │
+     * │    127 iterations · 341 tools        │
+     * │    Found 14 bugs across 6 files...   │
+     * └─────────────────────────────────────┘
+     */
+    writeAgentSummary(summary: string, ok: boolean): void;
+    /**
+     * Render subagent completion banners from a RunResult.
+     * Uses `delegateSummaries` when available (populated by delegate tool),
+     * otherwise falls back to scanning message history.
+     */
+    writeDelegateSummaries(result: {
+        delegateSummaries?: Array<{
+            summary: string | undefined;
+            ok: boolean;
+        }>;
+        messages?: Array<unknown> | undefined;
+    }): void;
+}
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAKhG,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC;CACtC;AAED,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,SAAS,CAAQ;IACzB;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAS;IACvB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW,CAA2C;IAC9D,+DAA+D;IAC/D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAkC;IAC7E,mDAAmD;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAM;IAElD,YAAY,IAAI,GAAE,uBAA4B,EAG7C;IAED;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAE/B;IAED,QAAQ,IAAI,OAAO,CAElB;IAED,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAGlE;IAED,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,eAAe;IAIvB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAOrC;IAED,SAAS,CAAC,IAAI,SAAK,GAAG,IAAI,CAMzB;IAED,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAWpC;IAED,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAOhD;IAED,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA0EtE;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAK5B;IAED,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE/B;IACD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7B;IACD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5B;IAED,KAAK,IAAI,IAAI,CAIZ;IAED;;;;;;;;OAQG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAwCpD;IAED;;;;OAIG;IACH,sBAAsB,CAAC,MAAM,EAAE;QAC7B,iBAAiB,CAAC,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;YAAC,EAAE,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACxE,QAAQ,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;KACvC,GAAG,IAAI,CAkCP;CACF"}

package/dist/repl.d.ts

@@ -0,0 +1,162 @@
+import type { Agent, AttachmentStore, SlashCommandRegistry, TokenCounter, TodoItem } from '@wrongstack/core';
+import { type VisionAdapters } from '@wrongstack/runtime';
+import type { ReadlineInputReader } from './input-reader.js';
+import type { TerminalRenderer } from './renderer.js';
+/**
+ * Extract canonical "<nextsteps>" suggestions from the agent's final output.
+ * Loose "Next steps" prose is intentionally ignored; `/next` requires the tagged block.
+ * Returns null when no suggestions are found.
+ *
+ * Gated on the live todo list: when the agent still has open todos
+ * (`pending` or `in_progress`), we suppress `<nextsteps>` entirely and clear
+ * the auto-suggestion store. Surfacing suggestions mid-task would race the
+ * todo loop — YOLO+auto could pick the top suggestion and pivot away from
+ * the unfinished work, and `/next 1` would replace the next todo with an
+ * arbitrary prompt. Finishing the todo list comes first; suggestions re-arm
+ * on the next turn once everything is `completed`.
+ */
+export declare function parseSuggestionsFromOutput(finalText: string, todos?: readonly TodoItem[] | null): string[] | null;
+/**
+ * Extract only the auto="true" items from next_steps output.
+ * Used by YOLO+auto autonomy mode.
+ */
+export declare function parseAutoSuggestionsFromOutput(finalText: string): string[] | null;
+export interface ReplOptions {
+    agent: Agent;
+    renderer: TerminalRenderer;
+    reader: ReadlineInputReader;
+    slashRegistry: SlashCommandRegistry;
+    attachments: AttachmentStore;
+    banner?: boolean | undefined;
+    tokenCounter?: TokenCounter | undefined;
+    visionAdapters?: VisionAdapters | undefined;
+    /** Autonomy mode state getter. */
+    getAutonomy?: (() => import('./slash-commands/autonomy.js').AutonomyMode) | undefined;
+    /** Set autonomy mode (used by SIGINT handler to flip back to 'off'). */
+    onAutonomy?: ((mode: import('./slash-commands/autonomy.js').AutonomyMode) => void) | undefined;
+    /**
+     * Whether next-task prediction is enabled. When true, the REPL runs a
+     * lightweight single-shot prediction after each completed turn and shows
+     * the likely next steps (display-only). Toggled via `/next`.
+     */
+    getNextPredict?: (() => boolean) | undefined;
+    /**
+     * Called after each agent turn with parsed "💡 Next steps" suggestions
+     * extracted from the final response text. The host stores these so
+     * `/next 1`, `/next 1 2 3` can select and execute them.
+     * Passed `null` when no suggestions were found in the output.
+     */
+    onSuggestionsParsed?: ((suggestions: string[] | null) => void) | undefined;
+    /**
+     * Read the current suggestion list. Used by the auto-proceed loop to
+     * check whether there are suggestions to feed when autonomy is 'auto'.
+     */
+    getSuggestions?: (() => string[]) | undefined;
+    /**
+     * Read the current auto suggestion list (items with auto="true" attribute).
+     * Used by YOLO+auto autonomy mode.
+     */
+    getAutoSuggestions?: (() => string[]) | undefined;
+    /**
+     * YOLO mode getter. When true, auto="true" suggestions trigger auto-proceed.
+     */
+    getYolo?: (() => boolean) | undefined;
+    /**
+     * Autonomy next prompt template. Used to construct the prompt when auto-submitting
+     * a next_steps item in YOLO+auto mode. Contains {{suggestion}} placeholder.
+     */
+    autonomyNextPrompt?: string | undefined;
+    /**
+     * Delay in milliseconds before auto-proceeding with the top suggestion
+     * when autonomy mode is 'auto'. Default 45 seconds.
+     */
+    autoProceedDelayMs?: number | undefined;
+    /**
+     * Maximum auto-proceed iterations before stopping to prevent infinite
+     * loops. Default 50. 0 means unlimited.
+     */
+    autoProceedMaxIterations?: number | undefined;
+    /**
+     * LLM validation gate called before starting the auto-proceed countdown.
+     * Receives the top suggestion and the last agent output text. Should
+     * return `true` if auto-proceeding is safe, `false` if user review is
+     * needed. The countdown only starts when this returns `true`.
+     */
+    onValidateAutoProceed?: ((suggestion: string, lastOutput: string) => Promise<boolean>) | undefined;
+    /**
+     * Access the eternal-autonomy engine. When autonomy mode is 'eternal'
+     * the REPL skips reading user input and instead drives engine
+     * iterations from this loop — so the engine and the REPL never compete
+     * for the shared Context. Returns null until /autonomy eternal primes it.
+     */
+    getEternalEngine?: (() => import('@wrongstack/core').EternalAutonomyEngine | null) | undefined;
+    /**
+     * Access the parallel-eternal engine. When autonomy mode is 'eternal-parallel'
+     * the REPL drives this engine instead of reading user input.
+     * Returns null until /autonomy parallel primes it.
+     */
+    getParallelEngine?: (() => import('@wrongstack/core').ParallelEternalEngine | null) | undefined;
+    /**
+     * Access the active SDD parallel run's control surface (or null). A running
+     * `/sdd parallel` blocks the prompt while it awaits completion, so this is the
+     * only mid-run stop path from the REPL — the SIGINT handler calls `stop()`.
+     */
+    getSddRun?: (() => import('@wrongstack/sdd').SddRunControl | null) | undefined;
+    /** Model-specific max context window (tokens). Used for the context bar in turn summaries. */
+    effectiveMaxContext?: number | undefined;
+    /** Live model-specific max context window. Prefer this over the startup snapshot when provided. */
+    getEffectiveMaxContext?: (() => number | undefined) | undefined;
+    /** Project / folder name shown in the banner. Usually `path.basename(projectRoot)`. */
+    projectName?: string | undefined;
+    /** Absolute project root — used to locate .wrongstack/goal.json for the goal banner. */
+    projectRoot?: string | undefined;
+    /** Full app config, used for HQ client publishing settings. */
+    appConfig?: import('@wrongstack/core').Config | undefined;
+    /** Live active session id for cross-surface client registration. */
+    getSessionId?: (() => string | undefined) | undefined;
+    /** Resolve current model vision support. Falls back to provider capability when omitted. */
+    supportsVision?: (() => boolean | Promise<boolean>) | undefined;
+    /** Skill loader for the skill generator wizard. */
+    skillLoader?: import('@wrongstack/core').SkillLoader | undefined;
+    /** Controller for the agents monitor overlay. */
+    agentsMonitorController?: {
+        visible: boolean;
+        setVisible: (visible: boolean) => void;
+    } | undefined;
+    /** Controller for fleet stream (subagent output to history). */
+    fleetStreamController?: {
+        enabled: boolean;
+        setEnabled: (enabled: boolean) => void;
+    } | undefined;
+    /**
+     * Shared controller for the `/interrupt` slash command. The REPL installs
+     * `abortLeader` here so the command can abort the active turn. Note: the REPL
+     * prompt is blocked during a run, so `/interrupt` is only dispatched at the
+     * prompt (where nothing is in flight) — Ctrl+C is the mid-run path.
+     */
+    interruptController?: {
+        abortLeader: () => boolean;
+    } | undefined;
+    /**
+     * Stop every running subagent. Wired to the director so the first Ctrl+C (and
+     * `/interrupt`) stops the fleet too, not just the leader. Returns the count
+     * stopped. Undefined when no fleet/director is active.
+     */
+    onInterruptFleet?: (() => number) | undefined;
+    /**
+     * Called after each agent.run() iteration completes so the host can
+     * report context pressure to the Director (for spawn pre-checks) or
+     * other systems that track token usage across the session.
+     */
+    onAgentIterationComplete?: ((estimatedTokens: number) => void) | undefined;
+    /**
+     * Called every second during the auto-proceed countdown with the
+     * remaining seconds until auto-proceed fires. Return true to abort
+     * the countdown and switch to manual mode.
+     */
+    onCountdownTick?: ((remainingSeconds: number) => boolean | void) | undefined;
+    /** Called when the REPL exits — use for cleanup such as removing event listeners. */
+    onDestroy?: (() => void) | undefined;
+}
+export declare function runRepl(opts: ReplOptions): Promise<number>;
+//# sourceMappingURL=repl.d.ts.map

package/dist/repl.d.ts.map

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

package/dist/services/project-facts.d.ts

@@ -0,0 +1,17 @@
+export interface ProjectFacts {
+    build?: string | undefined;
+    test?: string | undefined;
+    lint?: string | undefined;
+    run?: string | undefined;
+    hints: string[];
+    /** Top languages by source-file count, e.g. `['Python (142)', 'Shell (8)']`.
+     *  Only populated by the source-tree scan fallback (no manifest matched). */
+    languages?: string[] | undefined;
+    /** Likely entry-point files discovered by the scan (relative paths). */
+    entryPoints?: string[] | undefined;
+    /** Non-ignored top-level directories discovered by the scan. */
+    topDirs?: string[] | undefined;
+}
+export declare function detectProjectFacts(root: string): Promise<ProjectFacts>;
+export declare function renderAgentsTemplate(f: ProjectFacts): string;
+//# sourceMappingURL=project-facts.d.ts.map

package/dist/services/project-facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-facts.d.ts","sourceRoot":"","sources":["../../src/services/project-facts.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;iFAC6E;IAC7E,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACjC,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACnC,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAChC;AA0ND,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA+F5E;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAyF5D"}

package/dist/session-event-wiring.d.ts

@@ -0,0 +1,48 @@
+/**
+ * session-event-wiring — EventBus subscriptions for session audit logging,
+ * error tracking, and file-author recording. Also owns the
+ * SessionEventBridge and appendSessionEvent helper that gates on session
+ * identity so stale sessions don't pollute the current log.
+ *
+ * Extracted from cli-main.ts's monolithic main() to reduce cognitive load
+ * and enable focused testing.
+ */
+import type { SessionEventBridge } from '@wrongstack/core';
+export interface ErrorEntry {
+    ts: string;
+    phase: string;
+    code: string;
+    message: string;
+}
+export interface WireSessionEventsDeps {
+    evOn: (event: string, handler: (...args: any[]) => void) => void;
+    config: Record<string, unknown>;
+    context: Record<string, unknown>;
+    session: {
+        id: string;
+    };
+    sessionRef: {
+        current?: {
+            id: string;
+        } | undefined;
+    };
+    wpaths: {
+        globalRoot: string;
+        projectSlug: string;
+    };
+    projectRoot: string;
+    renderer?: {
+        writeInfo?: (msg: string) => void;
+    };
+    tuiOwnsScreen?: boolean;
+}
+export interface WireSessionEventsResult {
+    errorRing: ErrorEntry[];
+    sessionBridge: SessionEventBridge;
+    appendSessionEvent: (sessionId: string | undefined, event: Parameters<SessionEventBridge['append']>[0]) => void;
+}
+/** Wire SessionEventBridge, appendSessionEvent, error ring, and tool-lifecycle
+ *  session audit events. Returns the sessionBridge (for compaction / audit-level
+ *  changes) and the error ring array (for /diag). */
+export declare function wireSessionEvents(deps: WireSessionEventsDeps): WireSessionEventsResult;
+//# sourceMappingURL=session-event-wiring.d.ts.map

package/dist/session-event-wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-event-wiring.d.ts","sourceRoot":"","sources":["../src/session-event-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAI3D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IAEpC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,KAAK,IAAI,CAAC;IACjE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACxB,UAAU,EAAE;QAAE,OAAO,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS,CAAA;KAAE,CAAC;IACrD,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;IACjD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,aAAa,EAAE,kBAAkB,CAAC;IAClC,kBAAkB,EAAE,CAClB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAC/C,IAAI,CAAC;CACX;AAID;;qDAEqD;AACrD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,uBAAuB,CAmLtF"}

package/dist/session-stats.d.ts

@@ -0,0 +1,38 @@
+import type { EventBus, TokenCounter } from '@wrongstack/core';
+import type { TerminalRenderer } from './renderer.js';
+/**
+ * Accumulates per-session stats by listening to EventBus events. Designed
+ * to be created once in main(), live for the whole CLI invocation (single-shot
+ * or REPL), and produce the closing report when asked.
+ *
+ * Cost is intentionally not tracked here — TokenCounter is the authority.
+ */
+export declare class SessionStats {
+    private readonly tokenCounter;
+    private readonly startedAt;
+    private apiRequests;
+    private iterations;
+    private errors;
+    private readonly toolStats;
+    private readonly readPaths;
+    private readonly editedPaths;
+    private readonly writtenPaths;
+    private bytesWritten;
+    private bashCommands;
+    private fetches;
+    private readonly _handlers;
+    constructor(events: EventBus, tokenCounter: TokenCounter);
+    /** Remove all event listeners. Call this when the session ends. */
+    destroy(events: EventBus): void;
+    hasActivity(): boolean;
+    /**
+     * Build the report string. Returns null when there's no recorded
+     * activity yet — caller decides whether to emit a placeholder or stay
+     * silent. Splitting `format()` out of `render()` lets the TUI's slash
+     * dispatcher take the string and turn it into a history entry, while
+     * REPL keeps the old direct-write path.
+     */
+    format(): string | null;
+    render(renderer: TerminalRenderer): void;
+}
+//# sourceMappingURL=session-stats.d.ts.map

package/dist/session-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-stats.d.ts","sourceRoot":"","sources":["../src/session-stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAStD;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IAExC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,MAAM,CAAK;IAEnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAK;IAGpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+D;IAEzF,YAAY,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAmDvD;IAED,mEAAmE;IACnE,OAAO,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAM9B;IAED,WAAW,IAAI,OAAO,CAOrB;IAED;;;;;;OAMG;IACH,MAAM,IAAI,MAAM,GAAG,IAAI,CAoFtB;IAED,MAAM,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAIvC;CACF"}