@wrongstack/cli 0.313.1 → 0.316.1

package/dist/mcp-serve.d.ts

@@ -14,7 +14,7 @@ import type { SubcommandDeps } from './subcommands/contracts.js';
  * "flag present but no list" as an error, never as "no whitelist".
  */
 export declare function parseToolsFlag(flags: Record<string, string | boolean>, positional?: readonly string[]): Set<string> | null;
-export interface SelectedMcpServeContent {
+interface SelectedMcpServeContent {
     resources: MCPServerResource[];
     prompts: MCPServerPrompt[];
 }
@@ -50,4 +50,5 @@ export declare function makeServeContext(cwd: string, projectRoot: string, signa
  */
 export declare function selectExposedTools(registry: ToolRegistry, ctx: Context, policy: PermissionPolicy, whitelist: Set<string> | null): Promise<Tool[]>;
 export declare function serveMcpStdio(deps: SubcommandDeps, positional?: readonly string[]): Promise<number>;
+export {};
 //# sourceMappingURL=mcp-serve.d.ts.map

package/dist/{modeldiag-H6DKWJ2N.js → modeldiag-4NYBRSFP.js}

@@ -1323,4 +1323,4 @@ var modeldiagCmd = async (args, deps) => {
 export {
   modeldiagCmd
 };
-//# sourceMappingURL=modeldiag-H6DKWJ2N.js.map
+//# sourceMappingURL=modeldiag-4NYBRSFP.js.map

package/dist/next-task-predictor.d.ts

@@ -13,7 +13,7 @@ import type { TodoItem } from '@wrongstack/core/agent';
 import type { CommitLLMProvider } from './services/commit-message.js';
 /** Provider shape required to predict — same structural contract as commit-llm. */
 export type PredictLLMProvider = CommitLLMProvider;
-export interface PredictionInput {
+interface PredictionInput {
     /** The user's request that kicked off the turn we just finished. */
     userRequest: string;
     /** The agent's final assistant text for the turn (its summary of what it did). */
@@ -21,7 +21,7 @@ export interface PredictionInput {
     /** The current live todo list, used as a strong signal for what's left. */
     todos: readonly TodoItem[];
 }
-export interface PredictOpts {
+interface PredictOpts {
     provider: PredictLLMProvider;
     model: string;
     /** Max predictions to return. Default 3. */
@@ -42,4 +42,5 @@ export declare function parsePredictions(raw: string, max?: number): string[];
  * never let prediction break the turn.
  */
 export declare function predictNextTasks(input: PredictionInput, opts: PredictOpts): Promise<string[]>;
+export {};
 //# sourceMappingURL=next-task-predictor.d.ts.map

package/dist/permission-prompt.d.ts

@@ -1,5 +1,5 @@
 import type { InputReader, Tool } from '@wrongstack/core/types';
-export type PromptDecision = 'yes' | 'no' | 'always' | 'deny';
+type PromptDecision = 'yes' | 'no' | 'always' | 'deny';
 /** Signature the Agent expects for confirming tool calls. */
 export type ConfirmAwaiter = (tool: Tool, input: unknown, toolUseId: string, suggestedPattern: string) => Promise<'yes' | 'no' | 'always' | 'deny'>;
 export declare function makePromptDelegate(reader: InputReader): (tool: Tool, input: unknown, suggestedPattern: string) => Promise<PromptDecision>;
@@ -8,4 +8,5 @@ export declare function makePromptDelegate(reader: InputReader): (tool: Tool, in
  * with the ConfirmAwaiter type signature expected by the Agent.
  */
 export declare function makeConfirmAwaiter(reader: InputReader): ConfirmAwaiter;
+export {};
 //# sourceMappingURL=permission-prompt.d.ts.map

package/dist/picker.d.ts

@@ -4,24 +4,6 @@ import type { TerminalRenderer } from './renderer.js';
 export { applyPickerKey, type ProviderPickerState } from './picker-key-state.js';
 export { filterModels, LIVE_PICKER_MAX_VISIBLE, renderLiveModelList, } from './picker-model-picker.js';
 export { codexPickerPreamble } from './picker-ui.js';
-/**
- * Filter providers by a free-text query: case-insensitive substring match
- * against the provider id OR display name. An empty/whitespace query returns
- * all providers (as a copy). Input order is preserved. Powers the live
- * type-to-filter provider picker.
- */
-/**
- * Append synthetic entries for the built-in local-server presets
- * (OmniRoute / Ollama / vLLM / LM Studio) that aren't already present in
- * the merged list. These are keyless loopback gateways, so they pass the
- * `isKeylessLocalProvider` filter and become immediately selectable even
- * on a fresh install with no config and no catalog entry — mirroring the
- * `wstack auth local` shortcut. An entry is skipped when an id-match
- * already exists (catalog or saved config), so a user's customized
- * provider always wins over the preset default. Mutates and returns
- * `merged` for call-site convenience. Pure aside from the push.
- */
-export declare function appendLocalPresetProviders(merged: ResolvedProvider[]): ResolvedProvider[];
 export declare function filterProviders(query: string, providers: ResolvedProvider[]): ResolvedProvider[];
 /**
  * Render the live type-to-filter provider view as one string: the query line,

package/dist/plugin-management.d.ts

@@ -2,16 +2,7 @@ import type { Config, PluginConfig, PluginManagerConfig } from '@wrongstack/core
 import { PLUGIN_AUDIT_ENTRIES, type PluginAuditEntry } from '@wrongstack/plugins/plugin-audit-catalog';
 export type { PluginAuditEntry };
 export { PLUGIN_AUDIT_ENTRIES };
-export declare const OFFICIAL_PLUGINS: readonly [{
-    readonly alias: 'telegram';
-    readonly specifier: '@wrongstack/telegram';
-    readonly description: 'Telegram bridge for prompts, notifications, and slash commands.';
-}, {
-    readonly alias: 'lsp';
-    readonly specifier: '@wrongstack/plug-lsp';
-    readonly description: 'Language Server Protocol tools for code intelligence.';
-}];
-export interface PluginManagementDeps {
+interface PluginManagementDeps {
     config: Config;
     configPath: string;
     /** Override `~/.wrongstack` for tests. Defaults to the real home dir. */
@@ -19,12 +10,12 @@ export interface PluginManagementDeps {
     /** Injectable package-manager runner for tests. */
     runPackageManager?: ((pm: string, args: readonly string[], cwd: string) => Promise<PackageManagerRunResult>) | undefined;
 }
-export interface PackageManagerRunResult {
+interface PackageManagerRunResult {
     code: number | null;
     stdout: string;
     stderr: string;
 }
-export interface PluginManagementResult {
+interface PluginManagementResult {
     code: number;
     level: 'output' | 'info' | 'error';
     message: string;
@@ -41,8 +32,6 @@ export interface PluginManagementResult {
     restartRequired?: boolean | undefined;
 }
 export declare function runPluginManagementCommand(args: string[], deps: PluginManagementDeps): Promise<PluginManagementResult>;
-export declare function resolvePluginSpecifier(input: string): string;
-export declare function renderOfficialPlugins(config?: Config): string;
 export declare function renderConfiguredPlugins(config: Config): string;
 export declare function renderPluginAuditReport(config: Config): string;
 //# sourceMappingURL=plugin-management.d.ts.map

package/dist/{plugin-usage-GCTYOZPH.js → plugin-usage-AP7SJCDA.js}

@@ -1,6 +1,6 @@
 import {
   runPluginManagementCommand
-} from "./chunk-H6C7SO5H.js";
+} from "./chunk-QC5I4VWZ.js";
 import {
   restoreFlags
 } from "./chunk-CSAPOCBP.js";
@@ -41,4 +41,4 @@ export {
   pluginCmd,
   usageCmd
 };
-//# sourceMappingURL=plugin-usage-GCTYOZPH.js.map
+//# sourceMappingURL=plugin-usage-AP7SJCDA.js.map

package/dist/{plugins-EEKHCMBE.js → plugins-HQ5FU2AM.js}

@@ -1,5 +1,4 @@
 import {
-  BUILTIN_PLUGIN_CONFIG_NAMES,
   BUILTIN_PLUGIN_FACTORIES,
   DEPRECATED_PLUGIN_NAMES,
   _resetDeprecatedWarningsForTests,
@@ -7,12 +6,11 @@ import {
   pluginNameFromSpec,
   setupPlugins,
   warnIfDeprecatedPluginName
-} from "./chunk-BZJ4MP32.js";
-import "./chunk-H6C7SO5H.js";
+} from "./chunk-GKHUHAIK.js";
+import "./chunk-QC5I4VWZ.js";
 import "./chunk-TYO2OVAD.js";
 import "./chunk-7OCVIDC7.js";
 export {
-  BUILTIN_PLUGIN_CONFIG_NAMES,
   BUILTIN_PLUGIN_FACTORIES,
   DEPRECATED_PLUGIN_NAMES,
   _resetDeprecatedWarningsForTests,
@@ -21,4 +19,4 @@ export {
   setupPlugins,
   warnIfDeprecatedPluginName
 };
-//# sourceMappingURL=plugins-EEKHCMBE.js.map
+//# sourceMappingURL=plugins-HQ5FU2AM.js.map

package/dist/preflight.d.ts

@@ -1,6 +1,6 @@
 import type { Config } from '@wrongstack/core/types';
 import type { UpdateInfo } from './update-check.js';
-export interface PreflightResult {
+interface PreflightResult {
     /** The (possibly refreshed) update info, after the 2-second
      *  quick-check. Undefined if the check was aborted. */
     updateInfo: UpdateInfo | undefined;
@@ -55,4 +55,5 @@ export declare function applyDebugStreamSeed(config: Config): Promise<void>;
  * it back into the `BootContext` for downstream consumers.
  */
 export declare function runPreflight(config: Config, initialUpdateInfo: UpdateInfo | undefined): Promise<PreflightResult>;
+export {};
 //# sourceMappingURL=preflight.d.ts.map

package/dist/{proxy-wiring-G26YGP7S.js → proxy-wiring-EQB5X5YH.js}

@@ -3,8 +3,8 @@ import {
   awaitFirstWrongProxyProbe,
   bootstrapWrongProxy,
   shutdownWrongProxy
-} from "./chunk-AOAIPYFB.js";
-import "./chunk-GWVLRUVH.js";
+} from "./chunk-SYIBTG3X.js";
+import "./chunk-G3IMKQRH.js";
 import "./chunk-7OCVIDC7.js";
 export {
   applyWrongProxyPrefs,
@@ -12,4 +12,4 @@ export {
   bootstrapWrongProxy,
   shutdownWrongProxy
 };
-//# sourceMappingURL=proxy-wiring-G26YGP7S.js.map
+//# sourceMappingURL=proxy-wiring-EQB5X5YH.js.map

package/dist/renderer.d.ts

@@ -1,5 +1,5 @@
 import type { ContentBlock, Renderer, TextBlock, ToolResultRenderMode } from '@wrongstack/core/types';
-export interface TerminalRendererOptions {
+interface TerminalRendererOptions {
     out?: NodeJS.WriteStream | undefined;
     err?: NodeJS.WriteStream | undefined;
 }
@@ -61,6 +61,22 @@ export declare class TerminalRenderer implements Renderer {
     writeWarning(text: string): void;
     writeError(text: string): void;
     writeInfo(text: string): void;
+    /**
+     * Write text to stderr verbatim: no glyph prefix, no markdown processing.
+     *
+     * Deliberately stricter than writeWarning/writeError/writeInfo, which emit
+     * *diagnostics* and are suppressed only when a TUI owns the terminal (so
+     * they survive silent mode). This method is for informational mirrors of
+     * stdout output, where the stdout copy already carries the full content —
+     * in silent mode the operator asked for machine-only output, so the mirror
+     * is dropped rather than leaked onto a quieter stream. It therefore honors
+     * the full {@link suppressStdout} gate.
+     *
+     * Used by `wstack mailbox serve` to route the human-readable startup banner
+     * away from stdout, keeping the mailbox_serve_started JSON line cleanly
+     * pipeable (`mailbox serve | jq`).
+     */
+    writeStderr(text: string): void;
     clear(): void;
     /**
      * Write a flashy agent completion banner for delegate tool results.
@@ -85,4 +101,5 @@ export declare class TerminalRenderer implements Renderer {
         messages?: Array<unknown> | undefined;
     }): void;
 }
+export {};
 //# sourceMappingURL=renderer.d.ts.map

package/dist/repl-client-registration.d.ts

@@ -1,7 +1,8 @@
 import type { ReplOptions } from './repl-options.js';
-export interface ReplClientRegistration {
+interface ReplClientRegistration {
     clientId: string;
     close(): void;
 }
 export declare function registerReplClient(opts: ReplOptions): ReplClientRegistration;
+export {};
 //# sourceMappingURL=repl-client-registration.d.ts.map

package/dist/repl.d.ts

@@ -1,5 +1,5 @@
 import type { ReplOptions } from './repl-options.js';
 export type { ReplOptions } from './repl-options.js';
-export { parseAutoSuggestionsFromOutput, parseSuggestionsFromOutput } from './repl-suggestions.js';
+export { parseSuggestionsFromOutput } from './repl-suggestions.js';
 export declare function runRepl(opts: ReplOptions): Promise<number>;
 //# sourceMappingURL=repl.d.ts.map

package/dist/{replay-XU6ZD7GM.js → replay-FJ2JBXUA.js}

@@ -31,4 +31,4 @@ function bindReplayToContainer(opts) {
 export {
   bindReplayToContainer
 };
-//# sourceMappingURL=replay-XU6ZD7GM.js.map
+//# sourceMappingURL=replay-FJ2JBXUA.js.map

package/dist/{sdd-runtime-GFZ3NJKS.js → sdd-runtime-FLKCSTYV.js}

@@ -1,4 +1,4 @@
-import "./chunk-WHOIR577.js";
+import "./chunk-ALE5KHCA.js";
 import {
   SDDState,
   advanceToNextTask,
@@ -10,7 +10,6 @@ import {
   getActiveSDDContext,
   getActiveSDDPhase,
   getCurrentExecutingContext,
-  getCurrentTask,
   getSessionState,
   getTaskGraphId,
   getTaskListText,
@@ -23,7 +22,7 @@ import {
   trySaveImplementationPlan,
   trySaveSpecFromAIOutput,
   trySaveTasksFromAIOutput
-} from "./chunk-DGXNL7OT.js";
+} from "./chunk-JHUJUIOH.js";
 import "./chunk-7OCVIDC7.js";
 export {
   SDDState,
@@ -36,7 +35,6 @@ export {
   getActiveSDDContext,
   getActiveSDDPhase,
   getCurrentExecutingContext,
-  getCurrentTask,
   getSessionState,
   getTaskGraphId,
   getTaskListText,
@@ -51,4 +49,4 @@ export {
   trySaveSpecFromAIOutput,
   trySaveTasksFromAIOutput
 };
-//# sourceMappingURL=sdd-runtime-GFZ3NJKS.js.map
+//# sourceMappingURL=sdd-runtime-FLKCSTYV.js.map

package/dist/services/commit-message.d.ts

@@ -29,7 +29,7 @@ export interface CommitLLMProvider {
         model: string;
     }>;
 }
-export interface CommitLLMOpts {
+interface CommitLLMOpts {
     provider: CommitLLMProvider;
     model: string;
 }
@@ -38,4 +38,5 @@ export interface CommitLLMOpts {
  * Falls back to heuristics on failure.
  */
 export declare function generateCommitMessageWithLLM(diff: string, opts: CommitLLMOpts): Promise<string>;
+export {};
 //# sourceMappingURL=commit-message.d.ts.map

package/dist/services/sdd/state.d.ts

@@ -1,7 +1,5 @@
 import type { Context } from '@wrongstack/core/agent';
 import { type AISpecBuilder, type AISpecPhase, SpecVersioning, type TaskStore, type TaskTracker } from '@wrongstack/sdd';
-/** Key used to store SDD session state in ctx.meta for session isolation. */
-export declare const SDD_META_KEY = "sdd.state";
 /** Single shared SDD session state for the process lifetime. */
 export declare class SDDState {
     private builder;

package/dist/services/sdd-runtime.d.ts

@@ -1,5 +1,5 @@
 export { findSpec, gatherProjectContext, getActiveBuilder, getActiveSDDContext, getActiveSDDPhase, } from './sdd/project-context.js';
 export { autoDetectTaskCompletion, isExplanatoryText, trySaveImplementationPlan, trySaveSpecFromAIOutput, } from './sdd/spec-detection.js';
 export { getSessionState, SDDState, sddState } from './sdd/state.js';
-export { advanceToNextTask, formatElapsed, getCurrentExecutingContext, getCurrentTask, getTaskGraphId, getTaskListText, getTaskProgress, getTaskTrackerExport as getTaskTracker, getTaskTrackerExport, markTaskCompleted, renderTaskListWithProgress, trySaveTasksFromAIOutput, } from './sdd/task-manager.js';
+export { advanceToNextTask, formatElapsed, getCurrentExecutingContext, getTaskGraphId, getTaskListText, getTaskProgress, getTaskTrackerExport as getTaskTracker, getTaskTrackerExport, markTaskCompleted, renderTaskListWithProgress, trySaveTasksFromAIOutput } from './sdd/task-manager.js';
 //# sourceMappingURL=sdd-runtime.d.ts.map

package/dist/services/statusline-config.d.ts

@@ -1,10 +1,33 @@
-export declare const STATUSLINE_CONFIG_KEYS: readonly ['state', 'model', 'context', 'tokens', 'cache', 'cost', 'queue', 'hint', 'index', 'breaker', 'yolo', 'autonomy', 'eternal_stage', 'elapsed', 'project', 'working_dir', 'goal', 'mode', 'auto_proceed', 'git', 'sessions', 'tools', 'token_saving', 'memory', 'cpu', 'side_effects', 'todos', 'plan', 'tasks', 'fleet', 'brain', 'debug_stream', 'enhance', 'next_steps', 'mailbox', 'fleet_agents', 'memory_context'];
+import type { StatuslineLines } from '@wrongstack/core/statusline';
+/** On-disk schema version. v1 was a flat boolean map; v2 nests it under
+ *  `chips` alongside the sparse per-chip `lines` assignment. */
+export declare const STATUSLINE_CONFIG_VERSION = 2;
+export declare const STATUSLINE_CONFIG_KEYS: readonly ['state', 'model', 'context', 'tokens', 'cache', 'cost', 'queue', 'hint', 'index', 'breaker', 'yolo', 'autonomy', 'eternal_stage', 'elapsed', 'project', 'working_dir', 'goal', 'mode', 'auto_proceed', 'git', 'sessions', 'tools', 'theme', 'token_saving', 'processes', 'version', 'dropped_tools', 'prompt_variant', 'side_effects', 'todos', 'plan', 'tasks', 'fleet', 'brain', 'debug_stream', 'enhance', 'next_steps', 'mailbox', 'fleet_agents', 'memory_context'];
 export type StatuslineConfigKey = (typeof STATUSLINE_CONFIG_KEYS)[number];
 export type StatuslineConfig = {
     [K in StatuslineConfigKey]?: boolean | undefined;
 };
+/**
+ * v2 statusline.json document: the chip on/off map plus the sparse
+ * per-chip line assignment (`StatuslineLines` from the framework-free core
+ * contract). Absent `lines` keys mean "render on the contract's default
+ * line" (`DEFAULT_LINES`).
+ */
+export interface StatuslineDocument {
+    version: typeof STATUSLINE_CONFIG_VERSION;
+    chips: StatuslineConfig;
+    lines: StatuslineLines;
+}
 export declare const DEFAULTS: StatuslineConfig;
-export declare function loadStatuslineConfig(): Promise<StatuslineConfig>;
-export declare function ensureStatuslineConfig(): Promise<StatuslineConfig>;
-export declare function saveStatuslineConfig(config: StatuslineConfig): Promise<void>;
+export declare function loadStatuslineConfig(): Promise<StatuslineDocument>;
+export declare function ensureStatuslineConfig(): Promise<StatuslineDocument>;
+export declare function saveStatuslineConfig(config: StatuslineDocument): Promise<void>;
+/** Load just the per-chip line assignment (defaults to {} when unassigned). */
+export declare function loadStatuslineLines(): Promise<StatuslineLines>;
+/**
+ * Persist a new line assignment while preserving the stored chip toggles.
+ * Values are re-normalized (unknown keys dropped, clamped) so a malformed
+ * caller cannot write garbage to disk.
+ */
+export declare function saveStatuslineLines(lines: StatuslineLines): Promise<void>;
 //# sourceMappingURL=statusline-config.d.ts.map

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

@@ -16,7 +16,7 @@ export interface ErrorEntry {
     code: string;
     message: string;
 }
-export interface WireSessionEventsDeps {
+interface WireSessionEventsDeps {
     evOn: (event: string, handler: (...args: any[]) => void) => void;
     /** Concrete bus is required for Chronicle lifecycle subscriptions. */
     events?: EventBus | undefined;
@@ -42,18 +42,16 @@ export interface WireSessionEventsDeps {
     };
     tuiOwnsScreen?: boolean;
 }
-export interface WireSessionEventsResult {
+interface WireSessionEventsResult {
     errorRing: ErrorEntry[];
     sessionBridge: SessionEventBridge;
     appendSessionEvent: (sessionId: string | undefined, event: Parameters<SessionEventBridge['append']>[0]) => void;
     chronicleJournal?: ChronicleEventSink | undefined;
     disposeChronicle: () => Promise<void>;
 }
-/** `0` disables auto-purge; positive values are floored at 7 days so a
- *  project-committed config cannot flush recent evidence. */
-export declare function resolveChronicleRetentionDays(config: Record<string, unknown>): number;
 /** 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;
+export {};
 //# sourceMappingURL=session-event-wiring.d.ts.map

package/dist/{sessions-config-7Q7QJBKJ.js → sessions-config-P2LK2L32.js}

@@ -243,6 +243,10 @@ var sessionsCmd = async (args, deps) => {
   if (sub === "fleet") {
     return sessionsFleetCmd(args.slice(1), deps);
   }
+  if (sub === "doctor") {
+    const { sessionsDoctorCmd } = await import("./sessions-doctor-EXHAZSSE.js");
+    return sessionsDoctorCmd(args.slice(1), deps);
+  }
   if (!deps.sessionStore) {
     deps.renderer.writeError("No session store available.");
     return 1;
@@ -415,4 +419,4 @@ export {
   configCmd,
   sessionsCmd
 };
-//# sourceMappingURL=sessions-config-7Q7QJBKJ.js.map
+//# sourceMappingURL=sessions-config-P2LK2L32.js.map

package/dist/sessions-doctor-EXHAZSSE.js

@@ -0,0 +1,146 @@
+import "./chunk-7OCVIDC7.js";
+
+// src/subcommands/handlers/sessions-doctor.ts
+import {
+  diagnoseSessions,
+  repairSessionSummaries
+} from "@wrongstack/core/storage";
+import { color, toErrorMessage } from "@wrongstack/core/utils";
+var ICON = { error: color.red("\u2717"), warn: color.amber("!"), info: color.dim("\xB7") };
+function fmtBytes(bytes) {
+  if (bytes >= 1e9) return `${(bytes / 1e9).toFixed(2)} GB`;
+  if (bytes >= 1e6) return `${(bytes / 1e6).toFixed(1)} MB`;
+  if (bytes >= 1e3) return `${Math.round(bytes / 1e3)} KB`;
+  return `${bytes} B`;
+}
+function notable(session) {
+  return session.findings.some((f) => f.severity !== "info");
+}
+function renderReport(report, limit) {
+  const lines = [
+    color.bold("Session doctor"),
+    `  scanned:   ${report.totals.sessions} session(s) in ${report.sessionsDir}`,
+    `  on disk:   ${fmtBytes(report.totals.bytes)}`
+  ];
+  if (report.totals.snapshotBytes > 0) {
+    const share = Math.round(
+      report.totals.snapshotBytes / Math.max(1, report.totals.bytes) * 100
+    );
+    lines.push(
+      `  snapshots: ${fmtBytes(report.totals.snapshotBytes)} (${share}%) \u2014 superseded conversation snapshots, reclaimed by pruning old sessions, never by rewriting them`
+    );
+  }
+  if (report.unreadable.length > 0) {
+    lines.push("", color.red(`Unreadable journals (${report.unreadable.length}):`));
+    for (const entry of report.unreadable.slice(0, limit)) {
+      lines.push(`  ${ICON.error} ${color.cyan(entry.id)} \u2014 ${entry.reason}`);
+    }
+  }
+  const counts = Object.entries(report.byCode).sort((a, b) => b[1] - a[1]);
+  if (counts.length > 0) {
+    lines.push("", color.bold("Findings"));
+    for (const [code, count] of counts) lines.push(`  ${count.toString().padStart(5)}  ${code}`);
+  }
+  const interesting = report.sessions.filter(notable);
+  if (interesting.length > 0) {
+    lines.push("", color.bold(`Sessions needing attention (${interesting.length})`));
+    for (const session of interesting.slice(0, limit)) {
+      lines.push(`  ${color.cyan(session.id)}  ${color.dim(fmtBytes(session.bytes))}`);
+      for (const finding of session.findings) {
+        if (finding.severity === "info") continue;
+        const fix = finding.fix ? color.dim(` \u2192 fixable: ${finding.fix}`) : "";
+        lines.push(`    ${ICON[finding.severity]} ${finding.detail}${fix}`);
+      }
+    }
+    if (interesting.length > limit) {
+      lines.push(color.dim(`  \u2026 ${interesting.length - limit} more (raise --limit to see them)`));
+    }
+  } else {
+    lines.push("", color.green("No session needs attention."));
+  }
+  return lines;
+}
+var sessionsDoctorCmd = async (args, deps) => {
+  const store = deps.sessionStore;
+  const sessionsDir = deps.paths.projectSessions;
+  const fix = args.includes("--fix") || deps.flags?.fix === true;
+  const asJson = args.includes("--json") || deps.flags?.json === true;
+  const rawLimit = deps.flags?.limit ?? (args.includes("--limit") ? args[args.indexOf("--limit") + 1] : void 0);
+  const parsedLimit = Number(rawLimit);
+  const limit = Number.isInteger(parsedLimit) && parsedLimit > 0 ? parsedLimit : 20;
+  let lastTick = 0;
+  const report = await diagnoseSessions({
+    sessionsDir,
+    onProgress: ({ scanned, total, id }) => {
+      if (asJson || !id) return;
+      const now = Date.now();
+      if (now - lastTick < 250) return;
+      lastTick = now;
+      deps.renderer.write(`\r  scanning ${scanned}/${total} \u2026 ${id.slice(0, 48)}\x1B[K`);
+    }
+  }).catch((error) => {
+    deps.renderer.writeError(`Session scan failed: ${toErrorMessage(error)}
+`);
+    return null;
+  });
+  if (!report) return 1;
+  if (!asJson) deps.renderer.write("\r\x1B[K");
+  if (!fix) {
+    if (asJson) {
+      deps.renderer.write(`${JSON.stringify(report, null, 2)}
+`);
+      return 0;
+    }
+    const lines2 = renderReport(report, limit);
+    const fixable = report.sessions.filter((s) => s.findings.some((f) => f.fix)).length;
+    if (fixable > 0) {
+      lines2.push(
+        "",
+        color.dim(`Run \`wstack sessions doctor --fix\` to repair ${fixable} of them.`)
+      );
+    }
+    deps.renderer.write(`${lines2.join("\n")}
+`);
+    return 0;
+  }
+  const repair = await repairSessionSummaries({
+    report,
+    onProgress: ({ repaired, total, id }) => {
+      if (asJson || !id) return;
+      deps.renderer.write(`\r  rebuilding summaries ${repaired}/${total} \u2026 ${id.slice(0, 48)}\x1B[K`);
+    }
+  });
+  if (!asJson) deps.renderer.write("\r\x1B[K");
+  let indexed = null;
+  if (store?.rebuildIndex) {
+    indexed = await store.rebuildIndex().catch((error) => {
+      deps.renderer.writeError(`Catalog rebuild failed: ${toErrorMessage(error)}
+`);
+      return null;
+    });
+  }
+  if (asJson) {
+    deps.renderer.write(`${JSON.stringify({ report, repair, indexed }, null, 2)}
+`);
+    return repair.failed.length > 0 ? 1 : 0;
+  }
+  const lines = renderReport(report, limit);
+  lines.push("", color.bold("Repairs"));
+  lines.push(`  ${color.green("\u2713")} rebuilt ${repair.repaired.length} summary sidecar(s)`);
+  if (indexed !== null) lines.push(`  ${color.green("\u2713")} re-indexed ${indexed} session(s)`);
+  for (const failure of repair.failed) {
+    lines.push(`  ${ICON.error} ${color.cyan(failure.id)} \u2014 ${failure.reason}`);
+  }
+  lines.push(
+    color.dim(
+      "  Journals were not modified. Snapshot bytes are reclaimed with `wstack sessions prune`."
+    )
+  );
+  deps.renderer.write(`${lines.join("\n")}
+`);
+  return repair.failed.length > 0 ? 1 : 0;
+};
+export {
+  sessionsDoctorCmd
+};
+//# sourceMappingURL=sessions-doctor-EXHAZSSE.js.map

package/dist/settings-menu.d.ts

@@ -3,7 +3,7 @@ import { type SecretVault } from '@wrongstack/core/types';
 /** Configuration and storage dependencies needed to persist a setting.
  *  This is safe to call from non-interactive surfaces such as the TUI,
  *  headless runs, and the arg-driven `/settings` slash command. */
-export interface PersistSettingDeps {
+interface PersistSettingDeps {
     configStore: ConfigStore;
     /** Path to the active profile config (~/.wrongstack/profiles/<name>/config.json). */
     profileConfigPath: string;
@@ -85,4 +85,5 @@ export declare function deriveFsAccessPair(input: {
     allowOutsideProjectRoot: boolean;
     restrictToProjectRoot: boolean;
 } | undefined;
+export {};
 //# sourceMappingURL=settings-menu.d.ts.map

package/dist/shutdown-cleanup.d.ts

@@ -19,7 +19,7 @@
  * — registry writes, unsubscribe, dispose, etc. The wrapper only handles the
  * process-exit handshake around it.
  */
-export interface ShutdownCleanup {
+interface ShutdownCleanup {
     /**
      * Async cleanup. Called exactly once across all signals. May throw — errors
      * are swallowed so a stuck cleanup can't wedge the exit path.
@@ -28,7 +28,7 @@ export interface ShutdownCleanup {
     /** Exit code to use on a clean shutdown (default 0). */
     exitCode?: number;
 }
-export interface ShutdownHandle {
+interface ShutdownHandle {
     /** Install SIGINT + SIGTERM + beforeExit listeners. Idempotent. */
     install: () => void;
     /** Uninstall listeners (for tests). */
@@ -41,4 +41,5 @@ export interface ShutdownHandle {
  * installs signal handlers that call it once and let the event loop drain.
  */
 export declare function createGracefulShutdown(cleanup: ShutdownCleanup): ShutdownHandle;
+export {};
 //# sourceMappingURL=shutdown-cleanup.d.ts.map

package/dist/{simpleui-dist-33VO3QHF.js → simpleui-dist-JKNRCRRK.js}

@@ -97,4 +97,4 @@ export {
   ensureSimpleUiDistDir,
   resolveSimpleUiDistDir
 };
-//# sourceMappingURL=simpleui-dist-33VO3QHF.js.map
+//# sourceMappingURL=simpleui-dist-JKNRCRRK.js.map

package/dist/simpleui-dist.d.ts

@@ -1,10 +1,10 @@
-export interface SimpleUiDistDeps {
+interface SimpleUiDistDeps {
     resolvePackageJson?: (id: string) => string;
     exists?: (file: string) => boolean;
 }
 /** Resolve the independent SimpleUI frontend and fail closed if it is unbuilt. */
 export declare function resolveSimpleUiDistDir(deps?: SimpleUiDistDeps): string;
-export interface EnsureSimpleUiDistDeps extends SimpleUiDistDeps {
+interface EnsureSimpleUiDistDeps extends SimpleUiDistDeps {
     /** Override the build command runner (tests). Receives the workspace root cwd. */
     runBuild?: (cwd: string) => void | Promise<void>;
     /** Override the workspace-root finder (tests). Receives the simpleui package dir. */
@@ -20,4 +20,5 @@ export interface EnsureSimpleUiDistDeps extends SimpleUiDistDeps {
  * printed to stderr so the user sees what happened.
  */
 export declare function ensureSimpleUiDistDir(deps?: EnsureSimpleUiDistDeps): Promise<string>;
+export {};
 //# sourceMappingURL=simpleui-dist.d.ts.map