@wrongstack/tui 1.0.17 → 1.0.24

package/dist/ink.d.ts

@@ -1,4 +1,4 @@
-import { Box as InkBox, type DOMElement, Text as InkText } from 'ink';
+import { type DOMElement, Box as InkBox, Text as InkText } from 'ink';
 import { type ComponentProps, type ForwardRefExoticComponent, type ReactElement, type RefAttributes } from 'react';
 type TextOwnProps = Omit<ComponentProps<typeof InkText>, 'color' | 'backgroundColor'> & {
     color?: string | undefined;
@@ -8,12 +8,12 @@ type BoxOwnProps = Omit<ComponentProps<typeof InkBox>, 'ref' | 'borderColor' | '
     borderColor?: string | undefined;
     backgroundColor?: string | undefined;
 };
-export { Static, measureElement, useAnimation, useApp, useInput, useStdin, useStdout, } from 'ink';
 export type { DOMElement, Key } from 'ink';
-/** Ink `Text` with `color`/`backgroundColor` remapped to the pastel palette. */
+export { measureElement, Static, useAnimation, useApp, useInput, useStdin, useStdout, } from 'ink';
+/** Ink `Text` with named colors resolved against the active theme. */
 export declare function Text({ color, backgroundColor, ...rest }: TextOwnProps): ReactElement;
 /**
- * Ink `Box` with `borderColor`/`backgroundColor` remapped to pastels. Forwards
+ * Ink `Box` with named border/background colors resolved against the theme. Forwards
  * `ref` so `measureElement` (used by the scrollable history) keeps working.
  */
 export declare const Box: ForwardRefExoticComponent<BoxOwnProps & RefAttributes<DOMElement>>;

package/dist/input-graphemes.d.ts

@@ -0,0 +1,4 @@
+export declare function inputGraphemes(value: string): Intl.Segments;
+export declare function previousGraphemeIndex(value: string, cursor: number): number;
+export declare function nextGraphemeIndex(value: string, cursor: number): number;
+//# sourceMappingURL=input-graphemes.d.ts.map

package/dist/input-key-router.d.ts

@@ -11,6 +11,8 @@ export interface InputKeyRouterHost {
     readonly prompt: string;
     readonly terminalColumns: number;
     readonly terminalRows: number;
+    /** Stable across renders; scopes the preferred vertical column to one input. */
+    readonly navigationOwner?: object | undefined;
     readonly nextSteps: {
         readonly timer: MutableCell<ReturnType<typeof setInterval> | undefined>;
         readonly suggestion: MutableCell<string | null>;

package/dist/input-tokens.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Inline chip token grammar, shared by the editable input for chip rendering
+ * and whole-token cursor deletion. Attachment shapes stay in sync with the
+ * AttachmentStore placeholder regex in @wrongstack/core:
+ *   - seq-keyed  `[pasted|image|file #N …]`  (a cosmetic suffix after the seq,
+ *     e.g. `, 123 lines`, is tolerated; legacy `[file #N]` is included)
+ *   - path-keyed `[file:<path>]`
+ * `[VIBE]` is a protocol chip: it renders and deletes as a token, but it is
+ * not an attachment and must stay in the prompt sent to the refiner/agent.
+ */
 /** Attachment placeholders only. Protocol tags must not be stripped as chips. */
 export declare const ATTACHMENT_TOKEN_SRC = "\\[(?:pasted|image|file) #\\d+[^\\]]*\\]|\\[file:[^\\]]+\\]";
 /** Protocol trigger rendered as a chip but kept in the prompt text. */

package/dist/input-validation/action-types.d.ts

@@ -1,4 +1,4 @@
 /** Known reducer action types — exact, compile-time checked allow-list. */
-export declare const ALLOWED_ACTION_TYPES: readonly ["addEntry", "archiveLoaded", "startArchiveLoad", "authBusy", "authCatalog", "authClose", "authConfirmEnd", "authConfirmStart", "authFormCancel", "authFormChange", "authFormStart", "authFilter", "authFlowDone", "authFlowLog", "authFlowStart", "authHint", "authMove", "authOpen", "authPromptChange", "authPromptEnd", "authPromptStart", "authProviders", "authView", "autonomyPickerClose", "autonomyPickerHint", "autonomyPickerMove", "autonomyPickerOpen", "brainBusy", "brainClose", "brainHint", "brainMove", "brainOpen", "brainPromptClear", "brainPromptSet", "brainRiskChange", "brainRowMove", "brainSetLog", "brainSettingsLoaded", "brainStatus", "brainView", "checkpointReceived", "clearConfirmClose", "clearConfirmOpen", "clearConfirmSetValue", "clearHistory", "clearInput", "clearInputHistory", "closeAllPanels", "collabBugFound", "collabEvalComplete", "sidebarScroll", "sidebarScrollSet", "sidebarScrollReset", "toggleSidebarFocus", "skillPickerClose", "skillPickerHint", "skillPickerMove", "skillPickerOpen", "resourceMenuClose", "resourceMenuConfirm", "resourceMenuFilter", "resourceMenuHint", "resourceMenuMove", "resourceMenuOpen", "collabPlanEmitted", "collabSessionDone", "collabSubagentSpawned", "compactHistory", "confirmClearAll", "confirmClose", "confirmResolved", "confirmOpen", "continueConfirmClose", "continueConfirmOpen", "bugHuntContinueClose", "bugHuntContinueOpen", "bugHuntRunningClose", "bugHuntRunningOpen", "copiedNotice", "coordinatorEvent", "countdownEnded", "countdownTick", "debugStreamStats", "debugStreamStatsClear", "dequeueFirst", "designPickerClose", "designPickerMove", "designPickerOpen", "designPickerStack", "enhanceBusy", "enhanceClose", "enhanceOpen", "enhanceSet", "enqueue", "escConfirmClose", "escConfirmOpen", "fallbackOverlayClose", "fallbackOverlayMove", "fallbackOverlayOpen", "inspectOverlayClose", "inspectOverlayOpen", "inspectOverlayScroll", "eternalStage", "exitConfirmClose", "exitConfirmOpen", "fKeyPickerClose", "fKeyPickerMove", "fKeyPickerOpen", "fleetBatch", "fleetBudgetExtended", "fleetBudgetWarning", "fleetConcurrency", "fleetCost", "fleetCtxPct", "fleetDelta", "fleetDone", "fleetMessage", "fleetRemove", "fleetSeed", "fleetSpawn", "fleetStart", "fleetTool", "fleetToolEnd", "fleetToolStart", "fleetUsage", "goalRunElapsed", "goalRunInit", "goalRunMonitorToggle", "goalRunPhaseUpdate", "goalRunReset", "goalRunRunningPhases", "goalRunTaskActive", "goalSummary", "helpClose", "helpFilter", "helpHint", "helpMove", "helpOpen", "hint", "historyDown", "historyPush", "historyUp", "interrupt", "leaderCtxPct", "leaderIterEnd", "leaderIterStart", "leaderToolEnd", "leaderToolStart", "mcpPickerBusy", "mcpPickerClose", "mcpPickerHint", "mcpPickerMove", "mcpPickerOpen", "mcpPickerSetItems", "modePickerClose", "modePickerHint", "modePickerMove", "modePickerOpen", "modelPickerBack", "modelPickerClose", "modelPickerEffort", "modelPickerHint", "modelPickerMove", "modelPickerOpen", "modelPickerPickProvider", "modelPickerSearch", "pickerClose", "pickerMove", "pickerOpen", "pickerSetMatches", "pluginPickerBusy", "pluginPickerClose", "pluginPickerHint", "pluginPickerMove", "pluginPickerOpen", "pluginPickerSetItems", "projectPickerClose", "projectPickerFilter", "projectPickerHint", "projectPickerMove", "projectPickerOpen", "promptPickerCategory", "promptPickerClose", "promptPickerMove", "promptPickerOpen", "queueClear", "queueDelete", "queueToggleRefine", "refineCountdownClose", "refineCountdownOpen", "refineFailureClose", "refineFailureOpen", "replaceHistory", "autoProceedRelease", "bashModeEnter", "bashModeExit", "resumeLoadStart", "resumeLoadTick", "resumeStreamChunk", "resumeLoadAbort", "resetContextChip", "resetInterrupts", "resumePickerBusy", "resumePickerClose", "resumePickerError", "resumePickerHint", "resumePickerMove", "resumePickerOpen", "rewindOverlayClose", "rewindOverlayMove", "rewindOverlayOpen", "sddBoardSnapshot", "sddBoardFocusNext", "sddBoardFocusPrev", "sendModePickerClose", "sendModePickerMove", "sendModePickerOpen", "sessionResumeConfirmClear", "sessionResumeConfirmSet", "sessionRewound", "sessionsPanelBusy", "sessionsPanelMove", "sessionsPanelSet", "setBuffer", "setFleetChat", "setHistoryScrolled", "setInputHistory", "setViewportRows", "settingsClose", "settingsFieldMove", "settingsFieldSet", "settingsFilterSet", "settingsHint", "settingsOpen", "settingsThinkingEditCancel", "settingsThinkingEditChange", "settingsThinkingEditCommit", "settingsThinkingEditStart", "settingsWrongProxyUrlEditCancel", "settingsWrongProxyUrlEditChange", "settingsWrongProxyUrlEditCommit", "settingsWrongProxyUrlEditStart", "settingsValueChange", "settingsValueSet", "shadowClose", "shadowHint", "shadowOpen", "shadowUpdate", "shellCommandWarningClose", "shellCommandWarningOpen", "slashConfirmClose", "slashConfirmOpen", "slashPickerClose", "slashPickerMove", "slashPickerOpen", "status", "statuslineChipExpire", "statuslineChipShow", "statuslineClose", "statuslineFieldMove", "statuslineFieldSet", "statuslineFilter", "statuslineHint", "statuslineMoveLine", "statuslineMoveOrder", "statuslineOpen", "statuslineResetLayout", "statuslineSetDensity", "statuslineSetLine", "statuslineToggle", "statuslineToggleLine", "statuslineVisibleChipsSync", "subagentModelsClose", "subagentModelsHint", "subagentModelsMove", "subagentModelsOpen", "subagentModelsUpdate", "steerConsume", "steerStart", "streamDelta", "streamReset", "themePickerClose", "themePickerHint", "themePickerMove", "themePickerOpen", "toggleAgentsMonitor", "toggleAuditPanel", "toggleContextPanel", "toggleConnectionsPanel", "toggleCoordinatorMonitor", "toggleCronMonitor", "toggleGoalKanbanPanel", "toggleGoalPanel", "toggleHelp", "toggleKanbanPanel", "toggleMonitor", "togglePlanPanel", "toggleProcessList", "toggleQueuePanel", "toggleSddBoardMonitor", "toggleSessionsPanel", "toggleTodosMonitor", "toggleWorktreeMonitor", "toolEnded", "toolStarted", "toolStreamAppend", "toolStreamClear", "toolResultViewSet", "topicCheckBusy", "toolsPickerBusy", "toolsPickerClose", "toolsPickerFilter", "toolsPickerHint", "toolsPickerMove", "toolsPickerOpen", "toolsPickerSetItems", "toolsPickerToggle", "worktreeRemove", "worktreeUpsert"];
+export declare const ALLOWED_ACTION_TYPES: readonly ["addEntry", "archiveLoaded", "startArchiveLoad", "authBusy", "authCatalog", "authClose", "authConfirmEnd", "authConfirmStart", "authFormCancel", "authFormChange", "authFormStart", "authFilter", "authFlowDone", "authFlowLog", "authFlowStart", "authHint", "authMove", "authOpen", "authPromptChange", "authPromptEnd", "authPromptStart", "authProviders", "authView", "autonomyPickerClose", "autonomyPickerHint", "autonomyPickerMove", "autonomyPickerOpen", "brainBusy", "brainClose", "brainHint", "brainMove", "brainOpen", "brainPromptClear", "brainPromptSet", "brainRiskChange", "brainRowMove", "brainSetLog", "brainSettingsLoaded", "brainStatus", "brainView", "checkpointReceived", "clearConfirmClose", "clearConfirmOpen", "clearConfirmSetValue", "clearHistory", "clearInput", "clearInputHistory", "closeAllPanels", "collabBugFound", "collabEvalComplete", "sidebarScroll", "sidebarScrollSet", "sidebarScrollReset", "toggleSidebarFocus", "skillMentionResults", "skillPickerClose", "skillPickerHint", "skillPickerMove", "skillPickerOpen", "resourceMenuClose", "resourceMenuConfirm", "resourceMenuFilter", "resourceMenuHint", "resourceMenuMove", "resourceMenuOpen", "collabPlanEmitted", "collabSessionDone", "collabSubagentSpawned", "compactHistory", "confirmClearAll", "confirmClose", "confirmResolved", "confirmOpen", "continueConfirmClose", "continueConfirmOpen", "bugHuntContinueClose", "bugHuntContinueOpen", "bugHuntRunningClose", "bugHuntRunningOpen", "copiedNotice", "coordinatorEvent", "countdownEnded", "countdownTick", "debugStreamStats", "debugStreamStatsClear", "dequeueFirst", "designPickerClose", "designPickerMove", "designPickerOpen", "designPickerStack", "enhanceBusy", "enhanceClose", "enhanceOpen", "enhanceSet", "enqueue", "escConfirmClose", "escConfirmOpen", "fallbackOverlayClose", "fallbackOverlayMove", "fallbackOverlayOpen", "inspectOverlayClose", "inspectOverlayOpen", "inspectOverlayScroll", "eternalStage", "exitConfirmClose", "exitConfirmOpen", "fKeyPickerClose", "fKeyPickerMove", "fKeyPickerOpen", "fleetBatch", "fleetBudgetExtended", "fleetBudgetWarning", "fleetConcurrency", "fleetCost", "fleetCtxPct", "fleetDelta", "fleetDone", "fleetMessage", "fleetRemove", "fleetSeed", "fleetSpawn", "fleetStart", "fleetTool", "fleetToolEnd", "fleetToolStart", "fleetUsage", "goalRunElapsed", "goalRunInit", "goalRunMonitorToggle", "goalRunPhaseUpdate", "goalRunReset", "goalRunRunningPhases", "goalRunTaskActive", "goalRunTaskAgent", "goalRunTaskCompleted", "goalSummary", "helpClose", "helpFilter", "helpHint", "helpMove", "helpOpen", "helpScrollDetail", "hint", "historyDown", "historyPush", "historyUp", "interrupt", "leaderCtxPct", "leaderIterEnd", "leaderIterStart", "leaderToolEnd", "leaderToolStart", "mcpPickerBusy", "mcpPickerClose", "mcpPickerHint", "mcpPickerMove", "mcpPickerOpen", "mcpPickerSetItems", "modePickerClose", "modePickerHint", "modePickerMove", "modePickerOpen", "modelPickerBack", "modelPickerClose", "modelPickerEffort", "modelPickerHint", "modelPickerMove", "modelPickerOpen", "modelPickerPickProvider", "modelPickerSearch", "pickerClose", "pickerMove", "pickerOpen", "pickerSetMatches", "pluginPickerBusy", "pluginPickerClose", "pluginPickerHint", "pluginPickerMove", "pluginPickerOpen", "pluginPickerSetItems", "projectPickerClose", "projectPickerFilter", "projectPickerHint", "projectPickerMove", "projectPickerOpen", "promptPickerCategory", "promptPickerClose", "promptPickerMove", "promptPickerOpen", "queueClear", "queueDelete", "queueToggleRefine", "refineCountdownClose", "refineCountdownOpen", "refineFailureClose", "refineFailureOpen", "replaceHistory", "autoProceedRelease", "bashModeEnter", "bashModeExit", "resumeLoadStart", "resumeLoadTick", "resumeStreamChunk", "resumeLoadAbort", "resetContextChip", "resetInterrupts", "resumePickerBusy", "resumePickerClose", "resumePickerError", "resumePickerHint", "resumePickerMove", "resumePickerOpen", "rewindOverlayClose", "rewindOverlayMove", "rewindOverlayOpen", "sddBoardSnapshot", "sddBoardFocusNext", "sddBoardFocusPrev", "sendModePickerClose", "sendModePickerMove", "sendModePickerOpen", "sessionResumeConfirmClear", "sessionResumeConfirmSet", "sessionRewound", "sessionsPanelBusy", "sessionsPanelMove", "sessionsPanelSet", "setBuffer", "setFleetChat", "setHistoryScrolled", "setInputHistory", "setViewportRows", "settingsClose", "settingsFieldMove", "settingsFieldSet", "settingsFilterSet", "settingsHint", "settingsOpen", "settingsThinkingEditCancel", "settingsThinkingEditChange", "settingsThinkingEditCommit", "settingsThinkingEditStart", "settingsWrongProxyUrlEditCancel", "settingsWrongProxyUrlEditChange", "settingsWrongProxyUrlEditCommit", "settingsWrongProxyUrlEditStart", "settingsValueChange", "settingsValueSet", "shadowClose", "shadowHint", "shadowOpen", "shadowUpdate", "shellCommandWarningClose", "shellCommandWarningOpen", "slashConfirmClose", "slashConfirmOpen", "slashPickerClose", "slashPickerMove", "slashPickerOpen", "status", "statuslineChipExpire", "statuslineChipShow", "statuslineClose", "statuslineFieldMove", "statuslineFieldSet", "statuslineFilter", "statuslineHint", "statuslineMoveLine", "statuslineMoveOrder", "statuslineOpen", "statuslineResetLayout", "statuslineSetDensity", "statuslineSetLine", "statuslineToggle", "statuslineToggleLine", "statuslineVisibleChipsSync", "subagentModelsClose", "subagentModelsHint", "subagentModelsMove", "subagentModelsOpen", "subagentModelsUpdate", "steerConsume", "steerStart", "streamDelta", "streamReset", "themePickerClose", "themePickerHint", "themePickerMove", "themePickerOpen", "toggleAgentsMonitor", "toggleAuditPanel", "toggleContextPanel", "toggleConnectionsPanel", "toggleCoordinatorMonitor", "toggleCronMonitor", "toggleGoalKanbanPanel", "toggleGoalPanel", "toggleHelp", "toggleKanbanPanel", "toggleMonitor", "togglePlanPanel", "toggleProcessList", "toggleQueuePanel", "toggleSddBoardMonitor", "toggleSessionsPanel", "toggleTodosMonitor", "toggleWorktreeMonitor", "toolEnded", "toolStarted", "toolStreamAppend", "toolStreamClear", "toolResultViewSet", "topicCheckBusy", "toolsPickerBusy", "toolsPickerClose", "toolsPickerFilter", "toolsPickerHint", "toolsPickerMove", "toolsPickerOpen", "toolsPickerSetItems", "toolsPickerToggle", "worktreeRemove", "worktreeUpsert"];
 export type AllowedActionType = (typeof ALLOWED_ACTION_TYPES)[number];
 //# sourceMappingURL=action-types.d.ts.map

package/dist/input-validation-coordination.d.ts

@@ -0,0 +1,9 @@
+import type { ValidationResult } from './input-validation/result.js';
+export declare function validateCoordinationAction(action: {
+    type: string;
+    [key: string]: unknown;
+}, payload: {
+    type: string;
+    [key: string]: unknown;
+}): ValidationResult<Record<string, unknown>>;
+//# sourceMappingURL=input-validation-coordination.d.ts.map

package/dist/kanban-arguments.d.ts

@@ -0,0 +1,48 @@
+import type { KanbanBoundaryAccess, KanbanBoundaryPolicy, KanbanBoundarySelectorKind } from '@wrongstack/kanban';
+export type ParsedKanbanArgs = {
+    kind: 'open';
+} | {
+    kind: 'help';
+} | {
+    kind: 'boards';
+} | {
+    kind: 'create';
+    title: string;
+} | {
+    kind: 'add';
+    title: string;
+    column: string | null;
+    description?: string | undefined;
+} | {
+    kind: 'use';
+    query: string;
+} | {
+    kind: 'health';
+} | {
+    kind: 'audit';
+    boardQuery: string;
+} | {
+    kind: 'boundary';
+    boardQuery: string;
+    action: 'show' | 'allow' | 'deny' | 'clear';
+    taskQuery?: string | undefined;
+    selectorKind?: KanbanBoundarySelectorKind | undefined;
+    access?: KanbanBoundaryAccess | undefined;
+    path?: string | undefined;
+    enforcement?: KanbanBoundaryPolicy['enforcement'] | undefined;
+    shellAccess?: KanbanBoundaryPolicy['shellAccess'] | undefined;
+};
+/**
+ * Parse the raw `args` string (everything after `/kanban`) into a tagged
+ * union. Exported so tests can exercise the grammar in isolation.
+ *
+ * Grammar (whitespace-separated; quoted titles supported for the `create`
+ * subcommand):
+ *
+ *   args       ::= ε | "help" | "boards" | "create" title
+ *                |  "add" title ("--" "column" columnId)?
+ *   title      ::= token+
+ *   columnId   ::= token
+ */
+export declare function parseKanbanArgs(raw: string): ParsedKanbanArgs;
+//# sourceMappingURL=kanban-arguments.d.ts.map

package/dist/kanban-audit.d.ts

@@ -26,7 +26,7 @@ export type KanbanAuditSeverity = 'error' | 'warning';
  * two implementations' code sets instead of trusting that both type unions
  * were edited together.
  */
-export declare const ALL_AUDIT_CODES: readonly ['abandoned-running-task', 'board-oversized', 'missing-assignee', 'missing-description', 'missing-due-date', 'missing-labels', 'missing-subtasks', 'missing-success-criteria', 'skipped-lifecycle-state', 'stale-review', 'stale-running-task'];
+export declare const ALL_AUDIT_CODES: readonly ['abandoned-running-task', 'board-oversized', 'missing-assignee', 'missing-description', 'missing-due-date', 'missing-labels', 'missing-subtasks', 'missing-success-criteria', 'parked-card', 'skipped-lifecycle-state', 'stale-review', 'stale-running-task'];
 export type KanbanAuditIssueCode = (typeof ALL_AUDIT_CODES)[number];
 export interface KanbanAuditIssue {
     id: string;

package/dist/kanban-command-types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Result of resolving the board that an `add` operation should target.
+ *
+ * `KanbanPanel` resolves the active board from the session tag
+ * (`session:<sessionId>`) and falls back to the most-recently-updated board.
+ * We mirror that exact precedence so a `/kanban add` issued while the panel
+ * is open lands on the same board the user is looking at.
+ */
+export interface KanbanAddTarget {
+    boardId: string;
+    boardTitle: string;
+    /** Column that the task will be placed in. Defaults to the first column. */
+    columnId: string;
+    /**
+     * Whether the board enforces the managed Kanban Agent lifecycle. Managed
+     * boards require new cards to be created in the Backlog column and with a
+     * description, so callers route the user accordingly.
+     */
+    managed: boolean;
+}
+export interface KanbanSlashDeps {
+    /**
+     * Absolute project root used by the kanban file store. Must match the
+     * value `KanbanPanel` reads from `agent.ctx.projectRoot` — using
+     * `agent.ctx.cwd` would diverge when the user launches the TUI from a
+     * subdirectory of the project.
+     */
+    projectRoot: string;
+    /**
+     * Session running the TUI. Used to prefer a `session:<id>`-tagged board, and
+     * to attribute every board event `/kanban` writes.
+     */
+    sessionId: string;
+    /**
+     * Panel-open bridge installed by `App`. Calling `onPanelOpen.current(...)`
+     * with `'toggleKanbanPanel'` opens the kanban panel — same mechanism the
+     * other slash commands use. When absent, slash command returns text-only.
+     */
+    onPanelOpen?: {
+        current: ((action: string) => boolean) | null;
+    } | undefined;
+    /**
+     * Optional hook that selects a specific board in the kanban panel. Used
+     * by `/kanban use <boardId|title|tag>` and the Goal → Kanban bridge.
+     * The callback receives a board id and returns true on success.
+     */
+    onBoardFocus?: {
+        current: ((boardId: string) => boolean) | null;
+    } | undefined;
+    /** Terminal width (cols) for help / boards table rendering. */
+    terminalWidth?: number | undefined;
+}
+//# sourceMappingURL=kanban-command-types.d.ts.map

package/dist/kanban-reports.d.ts

@@ -0,0 +1,42 @@
+import type { KanbanBoardSummary, KanbanQueueHealth } from '@wrongstack/kanban';
+import { type KanbanAuditSummary } from './kanban-audit.js';
+import type { KanbanSlashDeps } from './kanban-command-types.js';
+/**
+ * Render the kanban queue health report as a compact markdown block.
+ * Surfaces the same Sprint-2 fields the WebUI's `KanbanView` shows
+ * (dependencyBlocked, staleAssignments, failedRetryable, heartbeatDue)
+ * plus per-status counts and the last dispatch / last recovery stamps.
+ */
+export declare function renderHealthReport(health: KanbanQueueHealth): string;
+/**
+ * Render the Kanban Cleaner audit across the project. Mirrors the WebUI
+ * `KanbanCleanerAlert` vocabulary so a user running either surface gets
+ * the same findings.
+ *
+ * Two modes:
+ *   - `boardQuery` empty   → audit every board (per-board table).
+ *   - `boardQuery` present → audit the single matching board, or report
+ *     a clear "not found" error.
+ *
+ * Each board's row shows the issue counts (error · warning) and the
+ * top-3 issues, biasing toward error severity first.
+ */
+export declare function renderProjectAudit(deps: Pick<KanbanSlashDeps, 'projectRoot'>, boardQuery: string): Promise<string>;
+/**
+ * Render a board-row table from a list of audited boards. The output
+ * is a compact markdown block suitable for the slash composer.
+ *
+ * When `multi` is true (audit-all mode) each row is prefixed with the
+ * board title; in single-board mode the title appears once as a header.
+ */
+export declare function renderAuditReport(rows: ReadonlyArray<{
+    title: string;
+    summary: KanbanAuditSummary;
+    error?: string;
+}>, multi: boolean): string;
+/**
+ * Render a compact boards table. Width-aware so a 60-col terminal still gets
+ * useful output (column titles truncated, counts abbreviated).
+ */
+export declare function renderBoardsList(boards: readonly KanbanBoardSummary[], width?: number): string;
+//# sourceMappingURL=kanban-reports.d.ts.map

package/dist/kanban-slash.d.ts

@@ -19,107 +19,8 @@
  * is the text-first equivalent for when the panel is closed.
  */
 import type { SlashCommand } from '@wrongstack/core/types';
-import type { KanbanBoardSummary, KanbanBoundaryAccess, KanbanBoundaryPolicy, KanbanBoundarySelectorKind, KanbanQueueHealth } from '@wrongstack/kanban';
-import { type KanbanAuditSummary } from './kanban-audit.js';
-/**
- * Result of resolving the board that an `add` operation should target.
- *
- * `KanbanPanel` resolves the active board from the session tag
- * (`session:<sessionId>`) and falls back to the most-recently-updated board.
- * We mirror that exact precedence so a `/kanban add` issued while the panel
- * is open lands on the same board the user is looking at.
- */
-interface KanbanAddTarget {
-    boardId: string;
-    boardTitle: string;
-    /** Column that the task will be placed in. Defaults to the first column. */
-    columnId: string;
-    /**
-     * Whether the board enforces the managed Kanban Agent lifecycle. Managed
-     * boards require new cards to be created in the Backlog column and with a
-     * description, so callers route the user accordingly.
-     */
-    managed: boolean;
-}
-export interface KanbanSlashDeps {
-    /**
-     * Absolute project root used by the kanban file store. Must match the
-     * value `KanbanPanel` reads from `agent.ctx.projectRoot` — using
-     * `agent.ctx.cwd` would diverge when the user launches the TUI from a
-     * subdirectory of the project.
-     */
-    projectRoot: string;
-    /**
-     * Session running the TUI. Used to prefer a `session:<id>`-tagged board, and
-     * to attribute every board event `/kanban` writes.
-     */
-    sessionId: string;
-    /**
-     * Panel-open bridge installed by `App`. Calling `onPanelOpen.current(...)`
-     * with `'toggleKanbanPanel'` opens the kanban panel — same mechanism the
-     * other slash commands use. When absent, slash command returns text-only.
-     */
-    onPanelOpen?: {
-        current: ((action: string) => boolean) | null;
-    } | undefined;
-    /**
-     * Optional hook that selects a specific board in the kanban panel. Used
-     * by `/kanban use <boardId|title|tag>` and the Goal → Kanban bridge.
-     * The callback receives a board id and returns true on success.
-     */
-    onBoardFocus?: {
-        current: ((boardId: string) => boolean) | null;
-    } | undefined;
-    /** Terminal width (cols) for help / boards table rendering. */
-    terminalWidth?: number | undefined;
-}
+import type { KanbanAddTarget, KanbanSlashDeps } from './kanban-command-types.js';
 export declare function createKanbanSlashCommand(deps: KanbanSlashDeps): SlashCommand;
-type ParsedKanbanArgs = {
-    kind: 'open';
-} | {
-    kind: 'help';
-} | {
-    kind: 'boards';
-} | {
-    kind: 'create';
-    title: string;
-} | {
-    kind: 'add';
-    title: string;
-    column: string | null;
-    description?: string | undefined;
-} | {
-    kind: 'use';
-    query: string;
-} | {
-    kind: 'health';
-} | {
-    kind: 'audit';
-    boardQuery: string;
-} | {
-    kind: 'boundary';
-    boardQuery: string;
-    action: 'show' | 'allow' | 'deny' | 'clear';
-    taskQuery?: string | undefined;
-    selectorKind?: KanbanBoundarySelectorKind | undefined;
-    access?: KanbanBoundaryAccess | undefined;
-    path?: string | undefined;
-    enforcement?: KanbanBoundaryPolicy['enforcement'] | undefined;
-    shellAccess?: KanbanBoundaryPolicy['shellAccess'] | undefined;
-};
-/**
- * Parse the raw `args` string (everything after `/kanban`) into a tagged
- * union. Exported so tests can exercise the grammar in isolation.
- *
- * Grammar (whitespace-separated; quoted titles supported for the `create`
- * subcommand):
- *
- *   args       ::= ε | "help" | "boards" | "create" title
- *                |  "add" title ("--" "column" columnId)?
- *   title      ::= token+
- *   columnId   ::= token
- */
-export declare function parseKanbanArgs(raw: string): ParsedKanbanArgs;
 /**
  * Resolve the board that an `/kanban add` should target, matching the
  * precedence used by `KanbanPanel`:
@@ -133,29 +34,7 @@ export declare function parseKanbanArgs(raw: string): ParsedKanbanArgs;
  * Exported so tests can validate the precedence rules against fixture boards.
  */
 export declare function resolveAddTarget(deps: Pick<KanbanSlashDeps, 'projectRoot' | 'sessionId'>, column: string | null): Promise<KanbanAddTarget | null>;
-/**
- * Render the kanban queue health report as a compact markdown block.
- * Surfaces the same Sprint-2 fields the WebUI's `KanbanView` shows
- * (dependencyBlocked, staleAssignments, failedRetryable, heartbeatDue)
- * plus per-status counts and the last dispatch / last recovery stamps.
- */
-export declare function renderHealthReport(health: KanbanQueueHealth): string;
-/**
- * Render a board-row table from a list of audited boards. The output
- * is a compact markdown block suitable for the slash composer.
- *
- * When `multi` is true (audit-all mode) each row is prefixed with the
- * board title; in single-board mode the title appears once as a header.
- */
-export declare function renderAuditReport(rows: ReadonlyArray<{
-    title: string;
-    summary: KanbanAuditSummary;
-    error?: string;
-}>, multi: boolean): string;
-/**
- * Render a compact boards table. Width-aware so a 60-col terminal still gets
- * useful output (column titles truncated, counts abbreviated).
- */
-export declare function renderBoardsList(boards: readonly KanbanBoardSummary[], width?: number): string;
-export {};
+export { parseKanbanArgs } from './kanban-arguments.js';
+export type { KanbanSlashDeps } from './kanban-command-types.js';
+export { renderAuditReport, renderBoardsList, renderHealthReport } from './kanban-reports.js';
 //# sourceMappingURL=kanban-slash.d.ts.map

package/dist/key-routes/key-route-overlay.d.ts

@@ -7,8 +7,8 @@ import type { KeyRouteContext } from '../key-handler-context.js';
  * ride with this route as the panel family (no dedicated slice among the
  * approved route names).
  *
- * Orchestrator call order (pinned): routeModalOverlay → routeDoubleEsc →
- * routeEscClosePanels → routeChordPanels → routeFKeyPanels → routeSddBoard →
+ * Orchestrator call order (pinned): routeModalOverlay → picker routing →
+ * routeEscClosePanels → routeDoubleEsc → routeChordPanels → routeFKeyPanels → routeSddBoard →
  * routeSettingsOverlay → routePanelEscapeRouter.
  */
 /** Modal overlays with their own dedicated UI (confirmQueue, enhance,

package/dist/on-panel-open.d.ts

@@ -39,7 +39,7 @@ export interface PanelOpenDeps {
      * Async opener for the Shadow Agent panel (`/shadow`). Fetches shadow state
      * from the host, then dispatches shadowOpen.
      */
-    openShadowPanel?: (() => void | Promise<unknown>) | undefined;
+    openShadowPanel?: (() => void | boolean) | undefined;
     /**
      * Opener for the Help panel (`/help`). Builds entries from the slash
      * command registry and dispatches helpOpen with the populated list.

package/dist/picker-text-input.d.ts

@@ -0,0 +1,4 @@
+/** Single-line picker fields accept pasted Unicode but never terminal controls. */
+export declare function pickerInputText(input: string): string;
+export declare function pickerBackspace(value: string): string;
+//# sourceMappingURL=picker-text-input.d.ts.map

package/dist/reducers/composer.d.ts

@@ -1,6 +1,6 @@
 import type { Action } from '../app-action-type.js';
 import type { State } from '../app-state.js';
-declare const composerActionTypes: readonly ["brainPromptSet", "brainPromptClear", "pickerOpen", "pickerClose", "pickerSetMatches", "pickerMove", "toolStarted", "toolEnded", "toolStreamAppend", "toolStreamClear", "enqueue", "dequeueFirst", "queueClear", "queueDelete", "queueToggleRefine", "bashModeEnter", "bashModeExit", "slashPickerOpen", "slashPickerClose", "slashPickerMove", "historyPush", "historyUp", "historyDown", "setInputHistory", "clearInputHistory", "modelPickerOpen", "modelPickerClose", "modelPickerMove", "modelPickerPickProvider", "modelPickerBack", "modelPickerSearch", "modelPickerEffort", "modelPickerHint", "autonomyPickerOpen", "autonomyPickerClose", "autonomyPickerMove", "autonomyPickerHint", "themePickerOpen", "themePickerClose", "themePickerMove", "themePickerHint", "modePickerOpen", "modePickerClose", "modePickerMove", "modePickerHint", "skillPickerOpen", "skillPickerClose", "skillPickerMove", "skillPickerHint", "resourceMenuOpen", "resourceMenuClose", "resourceMenuMove", "resourceMenuHint", "resourceMenuFilter", "resourceMenuConfirm", "designPickerOpen", "designPickerClose", "designPickerMove", "designPickerStack", "promptPickerOpen", "promptPickerClose", "promptPickerMove", "promptPickerCategory", "resumePickerOpen", "resumePickerClose", "resumePickerMove", "resumePickerBusy", "resumePickerHint", "resumePickerError", "replaceHistory", "resumeLoadStart", "resumeLoadTick", "resumeStreamChunk", "resumeLoadAbort"];
+declare const composerActionTypes: readonly ["brainPromptSet", "brainPromptClear", "pickerOpen", "pickerClose", "pickerSetMatches", "pickerMove", "toolStarted", "toolEnded", "toolStreamAppend", "toolStreamClear", "enqueue", "dequeueFirst", "queueClear", "queueDelete", "queueToggleRefine", "bashModeEnter", "bashModeExit", "slashPickerOpen", "slashPickerClose", "slashPickerMove", "historyPush", "historyUp", "historyDown", "setInputHistory", "clearInputHistory", "modelPickerOpen", "modelPickerClose", "modelPickerMove", "modelPickerPickProvider", "modelPickerBack", "modelPickerSearch", "modelPickerEffort", "modelPickerHint", "autonomyPickerOpen", "autonomyPickerClose", "autonomyPickerMove", "autonomyPickerHint", "themePickerOpen", "themePickerClose", "themePickerMove", "themePickerHint", "modePickerOpen", "modePickerClose", "modePickerMove", "modePickerHint", "skillPickerOpen", "skillMentionResults", "skillPickerClose", "skillPickerMove", "skillPickerHint", "resourceMenuOpen", "resourceMenuClose", "resourceMenuMove", "resourceMenuHint", "resourceMenuFilter", "resourceMenuConfirm", "designPickerOpen", "designPickerClose", "designPickerMove", "designPickerStack", "promptPickerOpen", "promptPickerClose", "promptPickerMove", "promptPickerCategory", "resumePickerOpen", "resumePickerClose", "resumePickerMove", "resumePickerBusy", "resumePickerHint", "resumePickerError", "replaceHistory", "resumeLoadStart", "resumeLoadTick", "resumeStreamChunk", "resumeLoadAbort"];
 type ComposerAction = Extract<Action, {
     type: (typeof composerActionTypes)[number];
 }>;

package/dist/reducers/panel-pickers.d.ts

@@ -1,6 +1,6 @@
 import type { Action } from '../app-action-type.js';
 import type { State } from '../app-state.js';
-declare const panelPickerActionTypes: readonly ["statuslineOpen", "statuslineClose", "statuslineFieldMove", "statuslineFieldSet", "statuslineToggle", "statuslineSetLine", "statuslineMoveLine", "statuslineMoveOrder", "statuslineSetDensity", "statuslineToggleLine", "statuslineResetLayout", "statuslineFilter", "statuslineHint", "statuslineChipShow", "statuslineChipExpire", "statuslineVisibleChipsSync", "pluginPickerOpen", "pluginPickerClose", "pluginPickerMove", "pluginPickerSetItems", "pluginPickerBusy", "pluginPickerHint", "mcpPickerOpen", "mcpPickerClose", "mcpPickerMove", "mcpPickerSetItems", "mcpPickerBusy", "mcpPickerHint", "toolsPickerOpen", "toolsPickerClose", "toolsPickerMove", "toolsPickerSetItems", "toolsPickerToggle", "toolsPickerBusy", "toolsPickerHint", "toolsPickerFilter", "brainOpen", "brainClose", "brainMove", "brainRiskChange", "brainSetLog", "brainHint", "brainSettingsLoaded", "brainView", "brainRowMove", "brainBusy", "helpOpen", "helpClose", "helpMove", "helpFilter", "helpHint", "shadowOpen", "shadowClose", "shadowUpdate", "shadowHint", "subagentModelsOpen", "subagentModelsClose", "subagentModelsMove", "subagentModelsUpdate", "subagentModelsHint"];
+declare const panelPickerActionTypes: readonly ["statuslineOpen", "statuslineClose", "statuslineFieldMove", "statuslineFieldSet", "statuslineToggle", "statuslineSetLine", "statuslineMoveLine", "statuslineMoveOrder", "statuslineSetDensity", "statuslineToggleLine", "statuslineResetLayout", "statuslineFilter", "statuslineHint", "statuslineChipShow", "statuslineChipExpire", "statuslineVisibleChipsSync", "pluginPickerOpen", "pluginPickerClose", "pluginPickerMove", "pluginPickerSetItems", "pluginPickerBusy", "pluginPickerHint", "mcpPickerOpen", "mcpPickerClose", "mcpPickerMove", "mcpPickerSetItems", "mcpPickerBusy", "mcpPickerHint", "toolsPickerOpen", "toolsPickerClose", "toolsPickerMove", "toolsPickerSetItems", "toolsPickerToggle", "toolsPickerBusy", "toolsPickerHint", "toolsPickerFilter", "brainOpen", "brainClose", "brainMove", "brainRiskChange", "brainSetLog", "brainHint", "brainSettingsLoaded", "brainView", "brainRowMove", "brainBusy", "helpOpen", "helpClose", "helpScrollDetail", "helpMove", "helpFilter", "helpHint", "helpScrollDetail", "shadowOpen", "shadowClose", "shadowUpdate", "shadowHint", "subagentModelsOpen", "subagentModelsClose", "subagentModelsMove", "subagentModelsUpdate", "subagentModelsHint"];
 type PanelPickerAction = Extract<Action, {
     type: (typeof panelPickerActionTypes)[number];
 }>;

package/dist/reducers/workspace-panels.d.ts

@@ -10,7 +10,7 @@ import type { State } from '../app-state.js';
  * {@link computeMaxSidebarScroll}; see its doc for the layout budget.
  */
 export declare function estimateSidebarMaxScroll(state: State, viewportHeight?: number, effectiveSwarmOnSidebar?: boolean | undefined): number;
-declare const workspacePanelActionTypes: readonly ["toggleMonitor", "toggleAgentsMonitor", "toggleHelp", "toggleTodosMonitor", "toggleQueuePanel", "toggleProcessList", "toggleCronMonitor", "togglePlanPanel", "closeAllPanels", "toggleSidebarFocus", "sidebarScroll", "sidebarScrollSet", "sidebarScrollReset", "toggleKanbanPanel", "toggleGoalPanel", "toggleGoalKanbanPanel", "toggleContextPanel", "toggleConnectionsPanel", "checkpointReceived", "rewindOverlayOpen", "rewindOverlayClose", "rewindOverlayMove", "sessionRewound", "eternalStage", "goalSummary", "goalRunInit", "goalRunPhaseUpdate", "goalRunTaskActive", "goalRunRunningPhases", "goalRunElapsed", "goalRunMonitorToggle", "goalRunReset", "sddBoardSnapshot", "toggleSddBoardMonitor", "sddBoardFocusNext", "sddBoardFocusPrev", "worktreeUpsert", "worktreeRemove", "toggleWorktreeMonitor"];
+declare const workspacePanelActionTypes: readonly ["toggleMonitor", "toggleAgentsMonitor", "toggleHelp", "toggleTodosMonitor", "toggleQueuePanel", "toggleProcessList", "toggleCronMonitor", "togglePlanPanel", "closeAllPanels", "toggleSidebarFocus", "sidebarScroll", "sidebarScrollSet", "sidebarScrollReset", "toggleKanbanPanel", "toggleGoalPanel", "toggleGoalKanbanPanel", "toggleContextPanel", "toggleConnectionsPanel", "checkpointReceived", "rewindOverlayOpen", "rewindOverlayClose", "rewindOverlayMove", "sessionRewound", "eternalStage", "goalSummary", "goalRunInit", "goalRunPhaseUpdate", "goalRunTaskActive", "goalRunTaskAgent", "goalRunTaskCompleted", "goalRunRunningPhases", "goalRunElapsed", "goalRunMonitorToggle", "goalRunReset", "sddBoardSnapshot", "toggleSddBoardMonitor", "sddBoardFocusNext", "sddBoardFocusPrev", "worktreeUpsert", "worktreeRemove", "toggleWorktreeMonitor"];
 type WorkspacePanelAction = Extract<Action, {
     type: (typeof workspacePanelActionTypes)[number];
 }>;

package/dist/run-tui-options.d.ts

@@ -559,7 +559,7 @@ export interface RunTuiOptions {
         nextSteps?: string[] | undefined;
     } | null>) | undefined;
     getProjectPickerItems?: (() => Promise<import('./components/project-picker.js').ProjectPickerItem[]>) | undefined;
-    onProjectSelect?: ((key: string, kind: 'project' | 'action') => void) | undefined;
+    onProjectSelect?: ((key: string, kind: 'project' | 'action') => void | string | null | Promise<void | string | null>) | undefined;
     /**
      * Request the TUI to exit with a specific code. Used by the project picker
      * to trigger a clean exit before spawning a new wstack process in a different

package/dist/statusline-palette.d.ts

@@ -0,0 +1,4 @@
+import type { Theme } from './theme-types.js';
+/** Preserve the preset's five hues while keeping small status text at 4.5:1. */
+export declare function statuslineBackgrounds(palette: Theme): string[];
+//# sourceMappingURL=statusline-palette.d.ts.map

package/dist/theme-utils.d.ts

@@ -60,7 +60,7 @@ export declare function resolveSyntaxColor(role: SyntaxRole, palette: Theme): st
 export declare function resolveSyntaxPalette(palette: Theme): SyntaxPalette;
 export declare function softColorWithTheme(color: string | undefined, currentTheme: Theme): string | undefined;
 /**
- * Mix two hex colors in linear-light sRGB. `weight` is the fraction of
+ * Mix two hex colors in encoded sRGB. `weight` is the fraction of
  * `colorA` (0..1) — at 0 the result is `colorB`, at 1 it is `colorA`. Used
  * by the sidebar's card tints to derive per-card "raised" surfaces from
  * the theme's accent + surface tokens, so each panel feels color-coded

package/dist/ui-contracts.d.ts

@@ -142,6 +142,7 @@ export interface HelpEntry {
     category: string;
     aliases?: string[] | undefined;
     argsHint?: string | undefined;
+    help?: string | undefined;
 }
 export interface McpPickerItem {
     name: string;