@wrongstack/core 0.302.2 → 0.305.0

package/dist/types/config/mcp-features.d.ts

@@ -281,10 +281,40 @@ export interface SageConfig {
          * many days. Undefined/0 disables purge (default).
          */
         purgeDeletedAfterDays?: number | undefined;
+        /**
+         * How deep periodic hygiene verifies anchors.
+         * - `existence` (default): file/path still exists (`fs.access` only).
+         * - `content`: also content-hash / symbol / command resolution.
+         * - `git`: content checks plus git blob hash comparison when available.
+         */
+        verifyDepth?: 'existence' | 'content' | 'git' | undefined;
     } | undefined;
     embeddings?: {
-        /** Optional future semantic layer. Disabled by default and never required. */
+        /**
+         * When true, retrieval re-ranks lexical candidates with the offline
+         * hashing embedding provider (hybrid). Default: false. Fail-open:
+         * lexical results are always available if embeddings fail.
+         */
         enabled?: boolean | undefined;
     } | undefined;
+    /**
+     * Opt-in automatic capture of durable tool outcomes into SAGE.
+     * Off by default — operators enable per-project when they want
+     * command success notes recorded without an explicit `remember` call.
+     */
+    capture?: {
+        /** Persist successful command/tool outcomes as `tool_outcome` memories. Default: false. */
+        toolOutcomes?: boolean | undefined;
+        /** Persist recurring error signatures as `error_pattern` memories. Default: false. */
+        errorPatterns?: boolean | undefined;
+    } | undefined;
+    /**
+     * Optional automated triage scheduling. When true, `setupSage` schedules a
+     * daily job (1h after boot, then every 24h): hygiene + bounded triage that
+     * files review proposals (never auto-deletes). Default: false.
+     */
+    triage?: {
+        dailyDryRun?: boolean | undefined;
+    } | undefined;
 }
 //# sourceMappingURL=mcp-features.d.ts.map

package/dist/types/config/root.d.ts

@@ -1,10 +1,11 @@
 import type { ConfiguredHook, HookEvent } from '../hooks.js';
-import type { AutonomyConfig, ChronicleConfig, IndexingConfig, LaunchConfig, SessionLoggingConfig, SyncConfig } from './autonomy.js';
 import type { AdaptiveConcurrencyConfig, CircuitBreakerRuntimeConfig, ContextConfig } from './context.js';
+import type { AutonomyConfig, ChronicleConfig, IndexingConfig, LaunchConfig, SessionLoggingConfig, SyncConfig } from './autonomy.js';
 import type { FeaturesConfig, LogConfig, MCPServerConfig, PluginConfig, PluginManagerConfig, SageConfig } from './mcp-features.js';
 import type { CustomModelDefinition, ModelMatrixEntry, ProviderConfig } from './providers.js';
 import type { CloudSyncConfig, HqClientConfig, ModelRuntimeConfig, SystemPromptConfig } from './runtime.js';
 import type { BrainConfig, FleetConfig, SkillsConfig } from './skills-fleet-brain.js';
+import type { ThemePresetId } from './ui.js';
 import type { ToolsConfig } from './tools.js';
 export interface GitBehaviorConfig {
     /**
@@ -40,6 +41,15 @@ export interface Config {
      * unset, surfaces fall back to their own browser/system detection.
      */
     uiLocale?: string | undefined;
+    /**
+     * TUI color theme preset — read by the TUI on boot to apply the matching
+     * palette, and written by the `/theme` slash command (CLI REPL and TUI) so
+     * the choice persists across restarts. Unconstrained string at the config
+     * layer: the TUI owns the canonical preset list and applies a fallback
+     * (`catppuccin`) when the stored value is unknown, so a forward-compat
+     * drift on the TUI side never breaks the config round-trip.
+     */
+    themePreset?: ThemePresetId | undefined;
     providers?: Record<string, ProviderConfig>;
     /**
      * Top-level custom models (maps modelId → definition). Merged with
@@ -134,6 +144,18 @@ export interface Config {
         primaryProbeInterval?: number | undefined;
         stickyFallbackTurns?: number | undefined;
     } | undefined;
+    /**
+     * Maximum number of candidates appended by the last-resort fallback sweep
+     * (`resolveAllConfigured`). When the smart default, bridge, and named/default
+     * profiles have all failed, every other configured provider is appended —
+     * this cap bounds the chain so a config with many providers does not produce
+     * a degenerate sequence of doomed requests during a systemic outage.
+     *
+     * Set to a higher value for rich multi-provider configs that want maximum
+     * diversity; set to 0 to disable the last-resort append entirely. The
+     * compiled-in default is exposed as `MAX_LAST_RESORT_CANDIDATES` (12).
+     */
+    fallbackMaxLastResortCandidates?: number | undefined;
     /**
      * Lifecycle command/HTTP hooks, keyed by event. Commands receive HookInput
      * JSON on stdin; HTTP hooks receive the same object as a POST body. A typed

package/dist/types/config/skills-fleet-brain.d.ts

@@ -128,6 +128,40 @@ export interface FleetConfig {
     } | undefined;
     /** Brain-gated fleet supervisor (rebalance/steer/spawn-helper). */
     supervisor?: FleetSupervisorConfig | undefined;
+    /** Roster-agent self-learning: capture → optimize → per-skill addenda. */
+    learning?: AgentLearningConfig | undefined;
+}
+/**
+ * Automatic optimization of roster-agent learning.
+ *
+ * Capture is always automatic. This section governs the *distillation* pass
+ * that turns captured directives into per-skill project addenda and a
+ * consolidated role document, then archives and resets the raw buffer.
+ */
+export interface AgentLearningConfig {
+    autoOptimize?: {
+        /** Run the distillation pass automatically. Default true. */
+        enabled?: boolean | undefined;
+        /** Raw buffer size (bytes) that makes a role eligible. Default 8192. */
+        thresholdBytes?: number | undefined;
+        /** Never optimize a buffer with fewer directives than this. Default 4. */
+        minEntries?: number | undefined;
+        /**
+         * Directives routed to a skill that has no addendum yet. Reaching this
+         * count makes a role eligible even below `thresholdBytes`. Default 3.
+         */
+        minPendingSkillDirectives?: number | undefined;
+        /** Minimum gap between automatic passes for one role. Default 6h. */
+        minIntervalMs?: number | undefined;
+        /** Quiet period after the last capture before a pass starts. Default 20s. */
+        debounceMs?: number | undefined;
+        /**
+         * Evaluate every role once when the fleet host starts, so roles that
+         * became eligible before this session are not stuck waiting for their
+         * next capture. Default true.
+         */
+        sweepOnStart?: boolean | undefined;
+    } | undefined;
 }
 /** Config surface for the brain-gated FleetSupervisor. */
 export interface FleetSupervisorConfig {

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

@@ -39,6 +39,28 @@ export interface ToolsConfig {
      * `/settings` ("Filesystem access").
      */
     restrictToProjectRoot?: boolean | undefined;
+    /**
+     * Require a ready, running **managed** Kanban card before any product
+     * mutation. Default: **false** — Kanban records work, it does not permit it,
+     * and that is the shipped contract the system prompt and the `kanban` tool
+     * description both state.
+     *
+     * Turning this on inverts that for this installation: a mutating tool
+     * (`write`, `edit`, `exec`, …) is refused until the run is bound to a card
+     * that is on a managed board, passes `evaluateContractGraphReadiness`, and
+     * sits in Running with a live assignment. Control tools (`kanban`, `todo`,
+     * `plan`, `task`) are always exempt so the agent can always record evidence
+     * or start the next card.
+     *
+     * Non-managed boards — session mirrors, SDD mirrors, plain imports — are
+     * skipped rather than blocked: they structurally cannot carry a lifecycle,
+     * so demanding one would deadlock every mutation with no reachable remedy.
+     * They still fall through to their path-scoped `boundary` policy.
+     *
+     * Independent of the two checks that are ALWAYS on regardless of this flag:
+     * the dispatch lease fence and the board/task filesystem `boundary`.
+     */
+    kanbanGovernance?: boolean | undefined;
     /**
      * Per-command policy for the `exec` tool's allowlist. The tool ships a
      * curated default allowlist of dev/build commands; this extends or trims it.

package/dist/types/config/ui.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared UI theme preset identifiers.
+ *
+ * Lives in core so the Config schema, the CLI `/theme` slash command, and
+ * the TUI runtime can all reference the same string union without
+ * importing the TUI package (which would invert the dependency direction).
+ *
+ * Keep in lockstep with `THEME_OPTIONS` in `packages/tui/src/theme.ts`.
+ * Adding a preset here is intentional — it also requires updating the TUI
+ * presets map AND the CLI `VALID_PRESETS` set in `tui-theme-adapter.ts`.
+ */
+export declare const THEME_PRESET_IDS: readonly ['catppuccin', 'tokyo-night', 'nord', 'cyberpunk', 'dracula', 'gruvbox-dark', 'solarized-dark', 'one-dark', 'monokai', 'rose-pine', 'kanagawa', 'ayu-dark', 'everforest', 'night-owl', 'synthwave'];
+export type ThemePresetId = (typeof THEME_PRESET_IDS)[number];
+//# sourceMappingURL=ui.d.ts.map

package/dist/types/config.d.ts

@@ -6,5 +6,6 @@ export * from './config/providers.js';
 export * from './config/mcp-features.js';
 export * from './config/autonomy.js';
 export * from './config/skills-fleet-brain.js';
+export * from './config/ui.js';
 export * from './config/root.js';
 //# sourceMappingURL=config.d.ts.map

package/dist/types/default-config.d.ts

@@ -14,6 +14,7 @@ export declare const DEFAULT_TOOLS_CONFIG: Readonly<{
     disabledTools: readonly string[];
     autoExtendLimit: true;
     restrictToProjectRoot: true;
+    kanbanGovernance: false;
     loopDetection: Readonly<{
         mode: 'steer-then-cut' | 'cut' | 'off';
         steerThreshold: number;

package/dist/types/index.d.ts

@@ -13,8 +13,8 @@ export { ProviderError, classifyProviderError, effectiveInputTokens, isContextOv
 export type { CacheTtl, Capabilities, JsonSchemaSpec, Provider, ProviderContextLimit, ProviderErrorBody, ProviderErrorKind, ReasoningConfig, ReasoningEffort, ReasoningRequest, Request, RequestCacheControl, Response, ResponseFormat, SafetySetting, StopReason, StreamEvent, Usage } from './provider.js';
 export { StreamHangError } from './provider.js';
 export type { ProviderRunner, RunProviderOptions } from './provider-runner.js';
-export { DEFAULT_TUI_THINKING_WORD, FLEET_CHAT_VERBOSITY_VALUES, MAX_TUI_THINKING_WORD_LENGTH, normalizeTokenSavingTier, normalizeTuiThinkingWord, resolveFleetChatVerbosity, resolveTokenSavingTier } from './config.js';
-export type { AdaptiveConcurrencyConfig, AutonomyConfig, BrainConfig, BrainCouncilConfig, BrainCouncilVoterConfig, BrainModelEntry, CircuitBreakerRuntimeConfig, ConcreteTokenSavingTier, Config, ConfigLoader, ConfigStore, ContextConfig, CouncilPersonaDefinition, CouncilToolConfig, CouncilToolProfileDefinition, CustomModelDefinition, ExecDangerConfig, ExecToolConfig, FeaturesConfig, FleetChatVerbosity, FleetConfig, FleetSupervisorConfig, GitBehaviorConfig, HqClientConfig, IndexingConfig, InputHistoryConfig, LaunchConfig, LaunchMenuChoice, LogConfig, LoopDetectionConfig, MCPHealthConfig, MCPHealthThresholds, MCPServerConfig, ModelMatrixEntry, ModelRuntimeCacheConfig, ModelRuntimeConfig, ModelRuntimeParametersConfig, ModelRuntimeReasoningConfig, NextStepsToolConfig, PluginConfig, PluginManagerConfig, ProviderApiKey, ProviderConfig, SageConfig, SessionLoggingConfig, SkillsConfig, SyncCategory, SyncConfig, TokenSavingTier, ToolDescriptionMode, ToolDescriptionModeConfig, ToolResultRenderMode, ToolResultRenderModeConfig, ToolsConfig } from './config.js';
+export { DEFAULT_TUI_THINKING_WORD, FLEET_CHAT_VERBOSITY_VALUES, MAX_TUI_THINKING_WORD_LENGTH, normalizeTokenSavingTier, normalizeTuiThinkingWord, resolveFleetChatVerbosity, resolveTokenSavingTier, THEME_PRESET_IDS } from './config.js';
+export type { AdaptiveConcurrencyConfig, AgentLearningConfig, AutonomyConfig, BrainConfig, BrainCouncilConfig, BrainCouncilVoterConfig, BrainModelEntry, CircuitBreakerRuntimeConfig, ConcreteTokenSavingTier, Config, ConfigLoader, ConfigStore, ContextConfig, CouncilPersonaDefinition, CouncilToolConfig, CouncilToolProfileDefinition, CustomModelDefinition, ExecDangerConfig, ExecToolConfig, FeaturesConfig, FleetChatVerbosity, FleetConfig, FleetSupervisorConfig, GitBehaviorConfig, HqClientConfig, IndexingConfig, InputHistoryConfig, LaunchConfig, LaunchMenuChoice, LogConfig, LoopDetectionConfig, MCPHealthConfig, MCPHealthThresholds, MCPServerConfig, ModelMatrixEntry, ModelRuntimeCacheConfig, ModelRuntimeConfig, ModelRuntimeParametersConfig, ModelRuntimeReasoningConfig, NextStepsToolConfig, PluginConfig, PluginManagerConfig, ProviderApiKey, ProviderConfig, SageConfig, SessionLoggingConfig, SkillsConfig, SyncCategory, SyncConfig, ThemePresetId, TokenSavingTier, ToolDescriptionMode, ToolDescriptionModeConfig, ToolResultRenderMode, ToolResultRenderModeConfig, ToolsConfig } from './config.js';
 export type { AnyHookOutcome, ConfiguredHook, HookEntry, HookEvent, HookFailurePolicy, HookInput, HookInvocationContext, HookMatcher, HookOutcome, HookRegistrationOptions, HttpHook, InProcessHook, PreToolUseOutcome, PreToolUseStage, ShellHook } from './hooks.js';
 export type { Compactor, CompactReport } from './compactor.js';
 export type { DirectoryPolicy, DirectoryRule, PermissionDecision, PermissionPolicy, PermissionTrace, PermissionTraceStep, TrustPolicy } from './permission.js';

package/dist/types/index.js

@@ -575,6 +575,25 @@ function normalizeTuiThinkingWord(value) {
   return word;
 }
 
+// src/types/config/ui.ts
+var THEME_PRESET_IDS = [
+  "catppuccin",
+  "tokyo-night",
+  "nord",
+  "cyberpunk",
+  "dracula",
+  "gruvbox-dark",
+  "solarized-dark",
+  "one-dark",
+  "monokai",
+  "rose-pine",
+  "kanagawa",
+  "ayu-dark",
+  "everforest",
+  "night-owl",
+  "synthwave"
+];
+
 // src/types/session-markers.ts
 var SESSION_MARKER_EVENT_TYPES = /* @__PURE__ */ new Set([
   "mode_changed",
@@ -715,6 +734,9 @@ var DEFAULT_TOOLS_CONFIG = Object.freeze({
   disabledTools: Object.freeze([]),
   autoExtendLimit: true,
   restrictToProjectRoot: true,
+  // Off by default: the board is a record of the work, not a permit for it.
+  // See ToolsConfig.kanbanGovernance for what turning it on costs and gates.
+  kanbanGovernance: false,
   loopDetection: Object.freeze({
     mode: "steer-then-cut",
     steerThreshold: 3,
@@ -1282,6 +1304,7 @@ export {
   SddError,
   SessionError,
   StreamHangError,
+  THEME_PRESET_IDS,
   ToolError,
   ToolErrorCategory,
   ToolValidationError,

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

@@ -168,6 +168,13 @@ export interface SubagentConfig {
      * bodies through `SkillLoader`; missing optional skills are skipped safely.
      */
     skillNames?: string[] | undefined;
+    /**
+     * Every skill this role may draw on, before per-project ranking. The catalog
+     * sets this to the full curated set while `skillNames` holds the default
+     * eager slice; the spawn path ranks the pool by project skill-affinity so a
+     * skill the project actually developed can displace an unused sibling.
+     */
+    skillPool?: string[] | undefined;
     /** Optional smart-dispatch metadata for dynamically created project roles. */
     dispatch?: {
         summary: string;

package/dist/types/session.d.ts

@@ -8,7 +8,15 @@ export interface SessionMetadata {
     provider?: string | undefined;
     startedAt: string;
     endedAt?: string | undefined;
-    /** Set when a session is closed with open tool calls — used to restore pending state on resume. */
+    /**
+     * Tool calls the previous run had issued but not resolved when it closed,
+     * as recorded on `session_end`.
+     *
+     * Diagnostic only. Resume does NOT restore pending state from this: it
+     * derives the same fact from the replayed conversation
+     * ({@link SessionData.pendingToolUseCount}), which also covers the crash
+     * case where no `session_end` was ever written. Nothing re-executes these.
+     */
     pendingToolUses?: string[] | undefined;
     /** Parent journal metadata when this session was created by fork(). */
     forkedFrom?: {

package/dist/types/task-graph.d.ts

@@ -31,6 +31,8 @@ export interface TaskEdge {
 export interface TaskGraph {
     id: string;
     specId: string;
+    /** Canonical spec scope. When present, execution must retain at least one task per id. */
+    requiredRequirementIds?: string[] | undefined;
     title: string;
     nodes: Map<string, TaskNode>;
     edges: TaskEdge[];

package/dist/types/tool-executor.d.ts

@@ -78,6 +78,8 @@ export interface ToolExecutorOptions {
      * to the result the model sees).
      */
     hookRunner?: import('../hooks/runner.js').HookRunner | undefined;
+    /** Hard-block product mutations outside a ready, running strict Kanban contract. */
+    requireKanbanGovernance?: boolean | undefined;
     /**
      * Per-tool on-screen result render mode map (`tools.resultRenderMode[name]`).
      * When set, the executor reads this map to decide whether the next

package/dist/utils/index.d.ts

@@ -31,6 +31,7 @@ export { isSafePathSegment, MAX_PATH_SEGMENT_LENGTH, resolveContainedPath, } fro
 export { getPerfProfile, indexParallelBatchSize, isFrugalPerf, type PerfProfile, SageCachePragmas, sqliteCachePragmas, tuiStreamFlushMs, useDaemonPerfDefaults, } from './perf-profile.js';
 export { isPidAlive } from './pid.js';
 export * from './project-identity.js';
+export { activateProjectStateGuard, type ProjectStateGuard, type ProjectStateGuardOptions, startProjectStateGuard, } from './project-state-guard.js';
 export { type ProjectWatchEvent, type ProjectWatchSubscription, watchProjectTree, } from './project-watch.js';
 export { capSubject, type CompileFail, type CompileResult, compileUserRegex, MAX_SUBJECT_LEN, } from './regex-guard.js';
 export * from './safe-json.js';