@wrongstack/core 0.313.0 → 0.316.1

package/dist/statusline/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Framework-free statusline chip contract.
+ *
+ * Single source of truth shared by the CLI persistence layer
+ * (`packages/cli/src/services/statusline-config.ts`, which writes the
+ * per-profile `statusline.json`) and the TUI renderer
+ * (`packages/tui/src/components/statusline-picker.tsx` +
+ * `status-line-registry.tsx`). Must stay free of React/Ink/Node imports so
+ * both packages can depend on it.
+ */
+/** All possible statusline chip keys (canonical set).
+ *
+ *  Stale keys still present in a saved `statusline.json` (including
+ *  long-removed phantoms like 'cpu', 'memory', 'time', 'sage') are silently
+ *  ignored by downstream consumers; the canonical key set is exactly the
+ *  union below. */
+export type StatuslineItem = 'state' | 'model' | 'tokens' | 'cache' | 'queue' | 'hint' | 'index' | 'breaker' | 'todos' | 'plan' | 'tasks' | 'fleet' | 'fleet_agents' | 'git' | 'elapsed' | 'context' | 'cost' | 'processes' | 'working_dir' | 'project' | 'yolo' | 'autonomy' | 'eternal_stage' | 'goal' | 'mode' | 'auto_proceed' | 'sessions' | 'tools' | 'theme' | 'token_saving' | 'brain' | 'mailbox' | 'enhance' | 'debug_stream' | 'next_steps' | 'memory_context' | 'side_effects' | 'version' | 'dropped_tools' | 'prompt_variant';
+/** Physical status bar line a chip renders on (1-based, detailed mode). */
+export type StatuslineLine = 1 | 2 | 3 | 4;
+/**
+ * Sparse per-chip line overrides (chip key → assigned line). Absent keys
+ * fall back to `DEFAULT_LINES`. Values outside 1–4 are invalid and must be
+ * clamped/dropped by the persistence layer before reaching the renderer.
+ */
+export type StatuslineLines = Partial<Record<StatuslineItem, StatuslineLine>>;
+/**
+ * Ordered list of statusline items — grouped by display line, then in
+ * RENDER order within each line so consumers iterate the statusline
+ * top-to-bottom, left-to-right. Within a line this order is also the
+ * overflow drop order (later entries drop first).
+ */
+export declare const STATUSLINE_ITEMS: StatuslineItem[];
+/**
+ * Default status bar line per chip. MUST mirror the actual rail composition
+ * in the TUI's rail builders — `statusline-navigation-order.test.ts` and the
+ * `status-bar-rail-order` suite pin the rendered order, and the CLI's
+ * `STATUSLINE_CONFIG_KEYS` must stay set-equal with `STATUSLINE_ITEMS`
+ * (drift-guarded in `packages/cli/tests`).
+ */
+export declare const DEFAULT_LINES: Record<StatuslineItem, StatuslineLine>;
+/** Total number of statusline chips in the contract. */
+export declare const STATUSLINE_FIELD_COUNT: number;
+//# sourceMappingURL=index.d.ts.map

package/dist/statusline/index.js

@@ -0,0 +1,102 @@
+// src/statusline/index.ts
+var STATUSLINE_ITEMS = [
+  // Line 1 — workspace & identity
+  "project",
+  "working_dir",
+  "git",
+  "model",
+  "mode",
+  "prompt_variant",
+  "theme",
+  "sessions",
+  "tools",
+  "version",
+  // Line 2 — run state, safety & vitals
+  "state",
+  "yolo",
+  "autonomy",
+  "eternal_stage",
+  "breaker",
+  "context",
+  "tokens",
+  "cost",
+  "cache",
+  "queue",
+  "processes",
+  "elapsed",
+  "token_saving",
+  "side_effects",
+  "hint",
+  // Line 3 — active work & countdowns
+  "goal",
+  "todos",
+  "plan",
+  "tasks",
+  "next_steps",
+  "auto_proceed",
+  "enhance",
+  "dropped_tools",
+  // Line 4 — fleet, connectivity & background services
+  "fleet",
+  "fleet_agents",
+  "mailbox",
+  "brain",
+  "debug_stream",
+  "memory_context",
+  "index"
+];
+var DEFAULT_LINES = {
+  // Line 1 — workspace & identity: static session header (rarely changes).
+  // theme/sessions/tools are the tail so overflow drops them first.
+  project: 1,
+  working_dir: 1,
+  git: 1,
+  model: 1,
+  mode: 1,
+  prompt_variant: 1,
+  theme: 1,
+  sessions: 1,
+  tools: 1,
+  version: 1,
+  // Line 2 — run state, safety & vitals: breaker leads the dynamic block
+  // (urgency), hint is last (ephemeral, first dropped on overflow).
+  state: 2,
+  yolo: 2,
+  autonomy: 2,
+  eternal_stage: 2,
+  breaker: 2,
+  context: 2,
+  tokens: 2,
+  cost: 2,
+  cache: 2,
+  queue: 2,
+  processes: 2,
+  elapsed: 2,
+  token_saving: 2,
+  side_effects: 2,
+  hint: 2,
+  // Line 3 — active work & countdowns (conditional)
+  goal: 3,
+  todos: 3,
+  plan: 3,
+  tasks: 3,
+  next_steps: 3,
+  auto_proceed: 3,
+  enhance: 3,
+  dropped_tools: 3,
+  // Line 4 — fleet, connectivity & background services (conditional)
+  fleet: 4,
+  fleet_agents: 4,
+  mailbox: 4,
+  brain: 4,
+  debug_stream: 4,
+  memory_context: 4,
+  index: 4
+};
+var STATUSLINE_FIELD_COUNT = STATUSLINE_ITEMS.length;
+export {
+  DEFAULT_LINES,
+  STATUSLINE_FIELD_COUNT,
+  STATUSLINE_ITEMS
+};
+//# sourceMappingURL=index.js.map

package/dist/storage/board-store-port.d.ts

@@ -22,11 +22,11 @@ export interface BoardStorePort {
     listBoards(projectRoot: string): Promise<KanbanBoardSummary[]>;
     getBoard(projectRoot: string, boardId: string): Promise<KanbanBoard | null>;
     removeBoard(projectRoot: string, boardId: string): Promise<boolean>;
-    addTask(projectRoot: string, boardId: string, input: CreateKanbanTaskInput, eventContext?: KanbanEventContext): Promise<{
+    addTask(projectRoot: string, boardId: string, input: CreateKanbanTaskInput, eventContext: KanbanEventContext): Promise<{
         board: KanbanBoard;
         task: KanbanTask;
     } | null>;
-    updateTask(projectRoot: string, boardId: string, taskId: string, input: UpdateKanbanTaskInput, eventContext?: KanbanEventContext): Promise<KanbanBoard | null>;
+    updateTask(projectRoot: string, boardId: string, taskId: string, input: UpdateKanbanTaskInput, eventContext: KanbanEventContext): Promise<KanbanBoard | null>;
 }
 /** Composition-root hook: register the real kanban-backed implementation. */
 export declare function setBoardStorePort(impl: BoardStorePort): void;

package/dist/storage/config-loader/in-project-policy.d.ts

@@ -1,4 +1,33 @@
+import type { Config } from '../../types/config.js';
 import type { PartialConfig } from './env-overrides.js';
+/**
+ * Every top-level `Config` field, as literals. Kept exhaustive by
+ * `ConfigFieldRegistryCoverage` below rather than by hand: this registry is
+ * what `assertInProjectAllowListComplete` iterates, so a field missing HERE
+ * is a field the allow/deny drift guard never looks at. That is not
+ * hypothetical — it is exactly how `fallbackMaxLastResortCandidates` slipped
+ * past (see its deny entry above), and five more had followed it in
+ * (`systemPrompt`, `themePreset`, `modelTiers`, `chronicle`,
+ * `fallbackGateSeconds`) before the compile gate was added.
+ */
+declare const KNOWN_CONFIG_TOP_LEVEL_KEY_LIST: readonly ['version', 'activeProfile', 'provider', 'model', 'apiKey', 'baseUrl', 'maxConcurrent', 'uiLocale', 'providers', 'models', 'modelMatrix', 'context', 'tools', 'mcpServers', 'fallbackModels', 'fallbackBridge', 'fallbackProfiles', 'fallbackProfile', 'favoriteModels', 'favoriteModelsOnly', 'modelAvailabilitySchedule', 'fallbackAuto', 'fallbackStickiness', 'fallbackMaxLastResortCandidates', 'hooks', 'plugins', 'pluginManager', 'log', 'features', 'Sage', 'skills', 'yolo', 'nextPrediction', 'cwd', 'autonomy', 'hints', 'debugStream', 'configScope', 'indexing', 'circuitBreaker', 'adaptiveConcurrency', 'launch', 'session', 'modelRuntime', 'hq', 'sync', 'cloudSync', 'extensions', 'acp', 'fleet', 'brain', 'git', 'themePreset', 'modelTiers', 'fallbackGateSeconds', 'chronicle', 'systemPrompt'];
+/** Compile-time `never` assertion; the TS error names the offending keys. */
+type AssertNever<T extends never> = T;
+/** `Config` fields the registry above forgot. Must be `never`. */
+type UnregisteredConfigField = Exclude<keyof Config, (typeof KNOWN_CONFIG_TOP_LEVEL_KEY_LIST)[number]>;
+/** Registry entries `Config` no longer has. Must be `never`. */
+type StaleRegistryField = Exclude<(typeof KNOWN_CONFIG_TOP_LEVEL_KEY_LIST)[number], keyof Config>;
+/**
+ * The gate that makes `assertInProjectAllowListComplete` trustworthy.
+ *
+ * That function is a runtime check, and a runtime check cannot see
+ * `keyof Config` — it can only iterate the registry it is handed. So the
+ * registry itself has to be verified at compile time, or "every Config field
+ * is classified" quietly degrades into "every field someone remembered to
+ * list is classified".
+ */
+export type ConfigFieldRegistryCoverage = AssertNever<UnregisteredConfigField> | AssertNever<StaleRegistryField>;
 export declare function assertInProjectAllowListComplete(): void;
 export declare function stripUnsafeInProjectFields(inProject: PartialConfig, sourcePath: string, warn?: (msg: string) => void): PartialConfig;
+export {};
 //# sourceMappingURL=in-project-policy.d.ts.map

package/dist/storage/config-loader.d.ts

@@ -1,9 +1,10 @@
 import type { Config, ConfigLoader, SyncConfig } from '../types/config.js';
 import type { ConfigLoaderOptions } from './config-loader/types.js';
-export { type ConfigDefaultRepair, type ConfigDefaultRepairReport, fillMissingDefaults, repairConfigDefaults, } from './config-loader/default-repair.js';
+export { fillMissingDefaults, repairConfigDefaults } from './config-loader/default-repair.js';
 export { CONFIG_BEHAVIOR_DEFAULTS } from './config-loader/defaults.js';
 export { assertInProjectAllowListComplete, stripUnsafeInProjectFields, } from './config-loader/in-project-policy.js';
-export type { ConfigLoaderOptions, ConfigSource, MemoizedConfigSource, } from './config-loader/types.js';
+export type { ConfigLoaderOptions, ConfigSource } from './config-loader/types.js';
+export type { ConfigDefaultRepair, ConfigDefaultRepairReport } from './config-loader/default-repair.js';
 export declare class DefaultConfigLoader implements ConfigLoader {
     private readonly paths;
     private readonly strict;

package/dist/storage/file-session-writer.d.ts

@@ -1,7 +1,7 @@
 import * as fsp from 'node:fs/promises';
-import type { EventBus } from './event-bus-port.js';
 import type { SecretScrubber } from '../types/secret-scrubber.js';
 import type { FileSnapshot, SessionEvent, SessionMetadata, SessionSummary, SessionWriter } from '../types/session.js';
+import type { EventBus } from './event-bus-port.js';
 import type { SessionCheckpointCas } from './session-checkpoint-cas.js';
 /**
  * Append-mode JSONL session writer with batched writes, write serialization,
@@ -14,7 +14,7 @@ import type { SessionCheckpointCas } from './session-checkpoint-cas.js';
 export declare class FileSessionWriter implements SessionWriter {
     readonly id: string;
     private handle;
-    private readonly startedAt;
+    readonly startedAt: string;
     private readonly meta;
     private readonly events?;
     private closed;
@@ -33,6 +33,7 @@ export declare class FileSessionWriter implements SessionWriter {
     private initPromise;
     private ensureInit;
     private readonly resumed;
+    private readonly lifecyclePreambleTs;
     private readonly secretScrubber?;
     private readonly checkpointCas?;
     /** Mutable slot for onAppend callback — constructor opts seed it, setOnAppend replaces it. */
@@ -180,6 +181,7 @@ export declare class FileSessionWriter implements SessionWriter {
      * of O(N) JSON.parse calls over the full file.
      */
     truncateToCheckpoint(targetPromptIndex: number, revertedFiles?: readonly string[]): Promise<number>;
+    private deleteRewoundSubagentTranscripts;
     clearSession(): Promise<void>;
     /**
      * Write an in-flight marker. The agent loop should call

package/dist/storage/goal-coordination.d.ts

@@ -16,7 +16,12 @@ export interface CoordinateGoalIterationOptions {
     goalPath: string;
     finalText: string;
     brain?: BrainArbiter | undefined;
-    sessionId?: string | undefined;
+    /**
+     * Session running this autonomy iteration. Required: closing a deliverable
+     * writes durable Kanban events, and those are attributed to the session that
+     * produced the `[DONE:]` marker.
+     */
+    sessionId: string;
     events?: EventBus | undefined;
     now?: (() => Date) | undefined;
 }

package/dist/storage/goal-kanban.d.ts

@@ -23,8 +23,11 @@ import type { GoalFile } from './goal-store.js';
  *   deliverable. The board id is stored on `goalFile.kanbanBoardId`.
  *
  * Returns the board id. Returns null when the project root is unavailable.
+ *
+ * `sessionId` is the session that set the goal: the deliverable tasks it seeds
+ * are durable board events, and they belong to that session.
  */
-export declare function createGoalKanbanBoard(projectRoot: string, goalFile: GoalFile): Promise<string | null>;
+export declare function createGoalKanbanBoard(projectRoot: string, goalFile: GoalFile, sessionId: string): Promise<string | null>;
 /**
  * Find a kanban board by id. Returns null when the board doesn't exist
  * (e.g. manually deleted). The caller should handle this gracefully.

package/dist/storage/index.d.ts

@@ -1,13 +1,18 @@
-export { type BoardStorePort, boardStore, setBoardStorePort, } from './board-store-port.js';
 export { type CatalogSessionRecord, type MaintenanceLease, type ResumeReservation, type SessionCatalogHealth, SessionCatalogProjectClient, type SessionCatalogProjectClientOptions, type SessionLeaseCredential, type SessionResumeClaim, } from '../session-catalog/index.js';
 export { getProjectSessionRegistry as getSessionRegistry, hasProjectSessionRegistry as hasSessionRegistry, ProjectSessionRegistry as SessionRegistry, } from '../session-catalog/registry.js';
+export { deriveSessionAgents, type SessionAgentRecord, type SessionAgentStatus, } from '../session-catalog/session-agents.js';
 export type { AgentEntry, AgentLiveStatus, SessionLiveStatus, SessionRegistryEntry, SessionWebUIEndpointHint, } from '../session-catalog/session-registry.js';
-/** @deprecated Test/migration adapter; production ownership uses SessionRegistry above. */
+/**
+ * @deprecated Test/migration adapter; production ownership uses SessionRegistry
+ * above. Remove once `packages/webui-server/tests/standalone-session-identity.test.ts`
+ * migrates to the canonical subpath import (tracked for the 0.320 major).
+ */
 export { SessionRegistry as LegacySessionRegistry } from '../session-catalog/session-registry.js';
 export type { SyncCategory, SyncConfig } from '../types/config.js';
 export type { DefaultSessionReaderOptions, SessionReader } from '../types/session-reader.js';
 export { type Annotation, AnnotationsStore, type AnnotationsStoreOptions, } from './annotations-store.js';
 export { type AttachmentStoreOptions, DefaultAttachmentStore, } from './attachment-store.js';
+export { type BoardStorePort, boardStore, setBoardStorePort, } from './board-store-port.js';
 export { applyNamespacePayload, buildNamespacePayloads, CLOUD_SYNC_CONTRACT, CLOUD_SYNC_NAMESPACES, CloudConfigSync, type CloudConfigSyncDeps, type CloudConfigSyncSettings, type CloudSyncPassSummary, LOCAL_ONLY_TOP_LEVEL, NAMESPACE_SCHEMA_VERSIONS, stripSecretMaterial, } from './cloud-config-sync.js';
 export { ALL_SYNC_CATEGORIES, CloudSync, type SyncResult, } from './cloud-sync.js';
 export { type CompletedWorkCheckpointFile, loadCompletedWorkCheckpoint, saveCompletedWorkCheckpoint, } from './completed-work-checkpoint.js';
@@ -21,7 +26,9 @@ export { appendJournal, emptyGoal, formatGoal, type GoalFile, goalFilePath, type
 export { INPUT_HISTORY_DEFAULT_MAX, InputHistoryStore, } from './input-history-store.js';
 export { FileMemoryBackend, type FileMemoryBackendOptions, type MemoryBackend, parseEntries, } from './memory-backend.js';
 export { type ConsolidationOp, type ConsolidatorSage, type MemoryConsolidatorOptions, SessionMemoryConsolidator, } from './memory-consolidator.js';
+export { type CuratorOperation, type CuratorSage, type CuratorSageCandidate, type CuratorSageRecord, SessionMemoryCurator, type SessionMemoryCuratorOptions, } from './memory-curator.js';
 export { GraphMemoryBackend, type GraphMemoryBackendOptions, } from './memory-graph-backend.js';
+export { cleanOrphanLocks, type OrphanLockCleanResult, } from './orphan-lock-cleaner.js';
 export { addPlanItem, attachPlanCheckpoint, clearPlan, deriveTodosFromPlanItem, emptyPlan, formatPlan, loadPlan, mutatePlan, type PlanFile, type PlanItem, removePlanItem, savePlan, setPlanItemStatus, } from './plan-store.js';
 export { formatPlanTemplates, getPlanTemplate, listPlanTemplates, type PlanTemplate, } from './plan-templates.js';
 export { DefaultPromptStore, migratePromptEntry, type PromptEntry, type PromptStore, promptChecksum, } from './prompt-store.js';
@@ -29,16 +36,17 @@ export { type PromptUsage, PromptUsageStore } from './prompt-usage-store.js';
 export { type ProviderConfigSnapshot, readProviderSnapshot, type WatchProviderConfigOptions, watchProviderConfig, } from './provider-config-watcher.js';
 export { type PersistedQueueItem, QUEUE_MAX_BYTES, QUEUE_MAX_ITEM_BYTES, QUEUE_MAX_ITEMS, QueueStore, retainPersistedQueueItems, } from './queue-store.js';
 export { type AbandonedSession, RecoveryLock, type RecoveryLockOptions, } from './recovery-lock.js';
-export { cleanOrphanLocks, type OrphanLockCleanResult, } from './orphan-lock-cleaner.js';
 export { type ReplayEntry, ReplayLogStore, type ReplayLogStoreOptions, } from './replay-log-store.js';
+export { stampAgentId, withAgentAttribution } from './session-agent-attribution.js';
 export { SessionAnalyzer } from './session-analyzer.js';
 export { type CheckpointGitResult, SessionCheckpointCas, type SessionCheckpointCasOptions, } from './session-checkpoint-cas.js';
+export { type DiagnoseSessionsOptions, diagnoseSessions, repairSessionSummaries, type SessionDiagnosis, type SessionDoctorReport, type SessionDoctorTotals, type SessionFinding, type SessionFindingCode, type SessionLifecycleBoundary, type SummaryRepairResult, } from './session-doctor.js';
 export { type AuditLevel, CORE_RECONSTRUCT_EVENTS, createSessionEventBridge, resolveAuditLevel, resolveSessionLoggingConfig, type SessionEventBridge, type SessionEventBridgeOptions, type SessionSamplingOptions, STANDARD_AUDIT_EVENTS, type ToolProgressSamplingOptions, } from './session-event-bridge.js';
 export { generateSessionId, sanitizeModel } from './session-id.js';
 export { resolveSessionId, type SessionIdResolution, sessionIdResolutionError, } from './session-id-resolver.js';
 export { scrubPersistedSessionData, scrubPersistedSessionEvent, scrubPersistedSessionSummary, } from './session-read-scrubber.js';
 export { DefaultSessionReader } from './session-reader.js';
-export { extractInterruptedTools, type InterruptedToolDetail, type RecoveryPlan, SessionRecovery, type StaleSession, } from './session-recovery.js';
+export { extractInterruptedTools, type InterruptedToolDetail, type RecoveryPlan, SessionRecovery, type StaleSession, type UnclosedSession, } from './session-recovery.js';
 export { type ApplyRewindOptions, type ApplyRewindResult, applyRewindToConversation, type RewindableConversation, } from './session-rewind-apply.js';
 export { DefaultSessionRewinder, type SessionRewinderOptions, } from './session-rewinder.js';
 export { DefaultSessionStore, type SessionStoreOptions, } from './session-store.js';