@wrongstack/core 0.281.1 → 0.282.0

package/dist/{session-event-bridge-vA2fLV58.d.ts → session-event-bridge-Bkp7ORfc.d.ts}

@@ -46,12 +46,12 @@ interface SessionEventBridge {
     allows(type: SessionEvent['type']): boolean;
 }
 /** Core events that are always written regardless of auditLevel. */
-declare const CORE_RECONSTRUCT_EVENTS: Set<"error" | "tool_use" | "tool_result" | "session_start" | "session_resumed" | "user_input" | "llm_request" | "llm_response" | "compaction" | "session_end" | "mode_changed" | "task_created" | "task_updated" | "task_completed" | "task_failed" | "agent_spawned" | "agent_stopped" | "agent_error" | "spec_parsed" | "spec_analyzed" | "skill_activated" | "skill_deactivated" | "tool_call_start" | "tool_call_end" | "tool_progress" | "message_truncated" | "provider_retry" | "provider_error" | "checkpoint" | "file_snapshot" | "rewound" | "in_flight_start" | "in_flight_end" | "side_effect">;
+declare const CORE_RECONSTRUCT_EVENTS: Set<"tool_use" | "tool_result" | "error" | "session_start" | "session_resumed" | "user_input" | "llm_request" | "llm_response" | "compaction" | "session_end" | "mode_changed" | "task_created" | "task_updated" | "task_completed" | "task_failed" | "agent_spawned" | "agent_stopped" | "agent_error" | "spec_parsed" | "spec_analyzed" | "skill_activated" | "skill_deactivated" | "tool_call_start" | "tool_call_end" | "tool_progress" | "message_truncated" | "provider_retry" | "provider_error" | "checkpoint" | "file_snapshot" | "rewound" | "in_flight_start" | "in_flight_end" | "side_effect">;
 /**
  * Events that are considered "standard" audit detail.
  * These are lightweight and high-value for forensics.
  */
-declare const STANDARD_AUDIT_EVENTS: Set<"error" | "tool_use" | "tool_result" | "session_start" | "session_resumed" | "user_input" | "llm_request" | "llm_response" | "compaction" | "session_end" | "mode_changed" | "task_created" | "task_updated" | "task_completed" | "task_failed" | "agent_spawned" | "agent_stopped" | "agent_error" | "spec_parsed" | "spec_analyzed" | "skill_activated" | "skill_deactivated" | "tool_call_start" | "tool_call_end" | "tool_progress" | "message_truncated" | "provider_retry" | "provider_error" | "checkpoint" | "file_snapshot" | "rewound" | "in_flight_start" | "in_flight_end" | "side_effect">;
+declare const STANDARD_AUDIT_EVENTS: Set<"tool_use" | "tool_result" | "error" | "session_start" | "session_resumed" | "user_input" | "llm_request" | "llm_response" | "compaction" | "session_end" | "mode_changed" | "task_created" | "task_updated" | "task_completed" | "task_failed" | "agent_spawned" | "agent_stopped" | "agent_error" | "spec_parsed" | "spec_analyzed" | "skill_activated" | "skill_deactivated" | "tool_call_start" | "tool_call_end" | "tool_progress" | "message_truncated" | "provider_retry" | "provider_error" | "checkpoint" | "file_snapshot" | "rewound" | "in_flight_start" | "in_flight_end" | "side_effect">;
 /**
  * Create a safe, audit-level-aware bridge around a SessionWriter.
  *

package/dist/skills/index.d.ts

@@ -1,5 +1,89 @@
 import { b as SkillEntry, S as SkillLoader } from '../skill-DHniprNl.js';
 
+/**
+ * Skill registry adapter contract.
+ *
+ * A registry is a searchable catalog of skills that resolves to a concrete
+ * install target (a GitHub `user/repo[@ref]`). Two adapters ship out of the
+ * box:
+ *
+ *   - `githubDirectAdapter`  — no search; `user/repo` is typed directly. This
+ *                              is the original pre-registry install path.
+ *   - `skillsShAdapter`     — searches the skills.sh marketplace
+ *                              (https://skills.sh/api/skills), which indexes
+ *                              34k+ skills from 2.8k+ repos and computes a
+ *                              per-skill security score (0–100).
+ *
+ * The adapter layer keeps the installer registry-agnostic: it asks each
+ * adapter to resolve a `<adapterId>:<registryId>` ref to a `user/repo@ref`
+ * and reuses the existing GitHub tarball path. New registries (an internal
+ * company hub, ags, …) are added by implementing this interface and passing
+ * them to the `SkillInstaller`.
+ */
+/**
+ * One hit from a registry search. Fields are optional where the underlying
+ * registry doesn't guarantee them — every adapter normalizes to this shape.
+ */
+interface RegistrySkillSummary {
+    /** Registry-native id (used as `<adapterId>:<id>` in `/skill-install`). */
+    id: string;
+    /** Skill name (kebab-case, as it will appear once installed). */
+    name: string;
+    /** Short description / trigger line. */
+    description: string;
+    /** Author / owner (often the GitHub owner). */
+    author?: string | undefined;
+    /** Install count, if the registry reports it. */
+    installs?: number | undefined;
+    /** Star count, if the registry reports it. */
+    stars?: number | undefined;
+    /**
+     * Security score 0–100 (skills.sh computes this; ags uses the same scale).
+     * Lower = riskier. Below 30 the install command prompts for confirmation.
+     */
+    securityScore?: number | undefined;
+    /** ISO timestamp of the skill's last update, if known. */
+    updatedAt?: string | undefined;
+    /**
+     * The `user/repo[@ref]` the installer passes to `downloadGitHubTarball`.
+     * Always present for real registry hits — it's the whole point of resolving.
+     */
+    installRef: string;
+}
+interface RegistrySearchOptions {
+    /** 1-indexed page (default 1). */
+    page?: number | undefined;
+    /** Page size (default 20; registries may cap this). */
+    pageSize?: number | undefined;
+}
+interface RegistrySearchResult {
+    /** Which adapter produced these results. */
+    adapterId: string;
+    results: RegistrySkillSummary[];
+    /** True when the registry indicates more pages exist. */
+    hasMore?: boolean | undefined;
+}
+/**
+ * A searchable skill catalog that resolves to a GitHub install target.
+ *
+ * `search` is optional in spirit (the github-direct adapter doesn't search),
+ * but the interface requires it so callers can fan out uniformly — adapters
+ * that can't search simply return `[]`.
+ */
+interface SkillRegistryAdapter {
+    /** Stable id used in `<adapterId>:<registryId>` refs (e.g. `'skills.sh'`). */
+    readonly id: string;
+    /** Human label for UI (e.g. `'skills.sh'`). */
+    readonly displayName: string;
+    /** Search the catalog. Return `[]` if the adapter doesn't support search. */
+    search(query: string, opts?: RegistrySearchOptions): Promise<RegistrySearchResult>;
+    /**
+     * Resolve a registry-native id to a `user/repo[@ref]` install ref. Should
+     * validate the id shape and throw on an id this adapter can't resolve.
+     */
+    resolveInstallRef(registryId: string): string;
+}
+
 /**
  * Well-known foreign coding-agent skill directories. All follow the
  * agentskills.io `SKILL.md` format, so the same loader reads them — this just
@@ -264,90 +348,6 @@ declare class SkillManifestStore {
     invalidateCache(): void;
 }
 
-/**
- * Skill registry adapter contract.
- *
- * A registry is a searchable catalog of skills that resolves to a concrete
- * install target (a GitHub `user/repo[@ref]`). Two adapters ship out of the
- * box:
- *
- *   - `githubDirectAdapter`  — no search; `user/repo` is typed directly. This
- *                              is the original pre-registry install path.
- *   - `skillsShAdapter`     — searches the skills.sh marketplace
- *                              (https://skills.sh/api/skills), which indexes
- *                              34k+ skills from 2.8k+ repos and computes a
- *                              per-skill security score (0–100).
- *
- * The adapter layer keeps the installer registry-agnostic: it asks each
- * adapter to resolve a `<adapterId>:<registryId>` ref to a `user/repo@ref`
- * and reuses the existing GitHub tarball path. New registries (an internal
- * company hub, ags, …) are added by implementing this interface and passing
- * them to the `SkillInstaller`.
- */
-/**
- * One hit from a registry search. Fields are optional where the underlying
- * registry doesn't guarantee them — every adapter normalizes to this shape.
- */
-interface RegistrySkillSummary {
-    /** Registry-native id (used as `<adapterId>:<id>` in `/skill-install`). */
-    id: string;
-    /** Skill name (kebab-case, as it will appear once installed). */
-    name: string;
-    /** Short description / trigger line. */
-    description: string;
-    /** Author / owner (often the GitHub owner). */
-    author?: string | undefined;
-    /** Install count, if the registry reports it. */
-    installs?: number | undefined;
-    /** Star count, if the registry reports it. */
-    stars?: number | undefined;
-    /**
-     * Security score 0–100 (skills.sh computes this; ags uses the same scale).
-     * Lower = riskier. Below 30 the install command prompts for confirmation.
-     */
-    securityScore?: number | undefined;
-    /** ISO timestamp of the skill's last update, if known. */
-    updatedAt?: string | undefined;
-    /**
-     * The `user/repo[@ref]` the installer passes to `downloadGitHubTarball`.
-     * Always present for real registry hits — it's the whole point of resolving.
-     */
-    installRef: string;
-}
-interface RegistrySearchOptions {
-    /** 1-indexed page (default 1). */
-    page?: number | undefined;
-    /** Page size (default 20; registries may cap this). */
-    pageSize?: number | undefined;
-}
-interface RegistrySearchResult {
-    /** Which adapter produced these results. */
-    adapterId: string;
-    results: RegistrySkillSummary[];
-    /** True when the registry indicates more pages exist. */
-    hasMore?: boolean | undefined;
-}
-/**
- * A searchable skill catalog that resolves to a GitHub install target.
- *
- * `search` is optional in spirit (the github-direct adapter doesn't search),
- * but the interface requires it so callers can fan out uniformly — adapters
- * that can't search simply return `[]`.
- */
-interface SkillRegistryAdapter {
-    /** Stable id used in `<adapterId>:<registryId>` refs (e.g. `'skills.sh'`). */
-    readonly id: string;
-    /** Human label for UI (e.g. `'skills.sh'`). */
-    readonly displayName: string;
-    /** Search the catalog. Return `[]` if the adapter doesn't support search. */
-    search(query: string, opts?: RegistrySearchOptions): Promise<RegistrySearchResult>;
-    /**
-     * Resolve a registry-native id to a `user/repo[@ref]` install ref. Should
-     * validate the id shape and throw on an id this adapter can't resolve.
-     */
-    resolveInstallRef(registryId: string): string;
-}
-
 /**
  * GitHub-direct registry adapter.
  *

package/dist/storage/index.d.ts

@@ -1,28 +1,186 @@
-import { M as MemoryBackend, j as FileMemoryBackendOptions } from '../todos-checkpoint-B1QVkoa8.js';
-export { A as AbandonedSession, a as AttachmentStoreOptions, C as ConfigLoaderOptions, b as ConfigMigration, c as ConfigMigrationError, d as ConfigSource, D as DEFAULT_CONFIG_MIGRATIONS, e as DefaultAttachmentStore, f as DefaultConfigLoader, g as DefaultConfigStore, h as DefaultMemoryStore, i as DefaultSessionStore, F as FileMemoryBackend, k as MemoryStoreOptions, l as MigrationContext, m as MigrationResult, P as PersistedQueueItem, n as PlanFile, o as PlanItem, p as PlanTemplate, Q as QueueStore, R as RecoveryLock, q as RecoveryLockOptions, S as SessionAnalyzer, r as SessionStoreOptions, T as TodosCheckpointFile, s as addPlanItem, t as attachPlanCheckpoint, u as attachTodosCheckpoint, v as clearPlan, w as deriveTodosFromPlanItem, x as emptyPlan, y as formatPlan, z as formatPlanTemplates, B as getPlanTemplate, E as listPlanTemplates, G as loadPlan, H as loadTodosCheckpoint, I as mutatePlan, J as parseEntries, K as removePlanItem, L as runConfigMigrations, N as savePlan, O as saveTodosCheckpoint, U as setPlanItemStatus } from '../todos-checkpoint-B1QVkoa8.js';
-import { M as MemoryScope, b as MemoryEntry, c as MemoryStore, E as EventBus } from '../events-C5hLU0AT.js';
-import { i as AgentExtension, k as AfterRunHook } from '../index-C1E-_71T.js';
-import { P as Provider, c as Request, e as Response, S as SessionEvent, D as CompletedWorkEvidence } from '../tool-LVSLiE1s.js';
-import { P as ProviderConfig, a2 as SyncCategory, j as SyncConfig } from '../config-CN-vdDEI.js';
+import { M as MemoryBackend, j as FileMemoryBackendOptions } from '../todos-checkpoint-addCdQ9f.js';
+export { A as AbandonedSession, a as AttachmentStoreOptions, C as ConfigLoaderOptions, b as ConfigMigration, c as ConfigMigrationError, d as ConfigSource, D as DEFAULT_CONFIG_MIGRATIONS, e as DefaultAttachmentStore, f as DefaultConfigLoader, g as DefaultConfigStore, h as DefaultMemoryStore, i as DefaultSessionStore, F as FileMemoryBackend, k as MemoryStoreOptions, l as MigrationContext, m as MigrationResult, P as PersistedQueueItem, n as PlanFile, o as PlanItem, p as PlanTemplate, Q as QueueStore, R as RecoveryLock, q as RecoveryLockOptions, S as SessionAnalyzer, r as SessionStoreOptions, T as TodosCheckpointFile, s as addPlanItem, t as attachPlanCheckpoint, u as attachTodosCheckpoint, v as clearPlan, w as deriveTodosFromPlanItem, x as emptyPlan, y as formatPlan, z as formatPlanTemplates, B as getPlanTemplate, E as listPlanTemplates, G as loadPlan, H as loadTodosCheckpoint, I as mutatePlan, J as parseEntries, K as removePlanItem, L as runConfigMigrations, N as savePlan, O as saveTodosCheckpoint, U as setPlanItemStatus } from '../todos-checkpoint-addCdQ9f.js';
+import { E as EventBus, M as MemoryScope, b as MemoryEntry, c as MemoryStore } from '../events-CovDylaH.js';
+import { i as AgentExtension, k as AfterRunHook } from '../index-D5HB7WkV.js';
+import { c as Request, e as Response, P as Provider, S as SessionEvent, D as CompletedWorkEvidence } from '../tool-LVSLiE1s.js';
+import { P as ProviderConfig, a2 as SyncCategory, j as SyncConfig } from '../config-BCAEJicb.js';
 import { S as SecretVault } from '../secret-vault-BAKpgFw_.js';
 export { D as DefaultSessionReader, f as DefaultSessionReaderOptions, S as SessionReader } from '../session-reader-B-Fi9L6I.js';
 import { b as SessionRegistry, A as AgentEntry } from '../session-registry-Dvg7i_IA.js';
 export { a as AgentLiveStatus, S as SessionLiveStatus, c as SessionRegistryEntry, g as getSessionRegistry, h as hasSessionRegistry } from '../session-registry-Dvg7i_IA.js';
 import { S as SessionRewinder, C as CheckpointInfo, a as RewindResultExtended } from '../session-rewinder-C9HnMkhP.js';
 import { T as TaskItem } from '../task-format-vGOIftmK.js';
-export { a as DirectorStateCheckpoint, D as DirectorStateSnapshot, b as DirectorSubagentState, c as DirectorTaskState, l as loadDirectorState } from '../director-state-BfeCUbmk.js';
-export { G as GoalFile, J as JournalEntry, M as MAX_JOURNAL_ENTRIES, a as MAX_PROGRESS_HISTORY, P as ProgressSnapshot, b as appendJournal, e as emptyGoal, f as formatGoal, g as goalFilePath, l as loadGoal, p as parseProgressFromText, r as recordProgress, s as saveGoal, c as setProgress, d as summarizeUsage } from '../goal-store-BLGZq16t.js';
+export { a as DirectorStateCheckpoint, D as DirectorStateSnapshot, b as DirectorSubagentState, c as DirectorTaskState, l as loadDirectorState } from '../director-state-B_GPa78Q.js';
+export { G as GoalFile, J as JournalEntry, M as MAX_JOURNAL_ENTRIES, a as MAX_PROGRESS_HISTORY, P as ProgressSnapshot, b as appendJournal, e as emptyGoal, f as formatGoal, g as goalFilePath, l as loadGoal, p as parseProgressFromText, r as recordProgress, s as saveGoal, c as setProgress, d as summarizeUsage } from '../goal-store-CBd749M4.js';
 import { a as PromptEntry } from '../prompt-DLd35n4Q.js';
 import { W as WstackPaths } from '../wstack-paths-C3K40Qst.js';
 import { S as SecretScrubber } from '../secret-scrubber-3MHDDAtm.js';
-export { A as AuditLevel, C as CORE_RECONSTRUCT_EVENTS, a as STANDARD_AUDIT_EVENTS, S as SessionEventBridge, b as SessionEventBridgeOptions, c as SessionSamplingOptions, T as ToolProgressSamplingOptions, d as createSessionEventBridge, r as resolveAuditLevel, e as resolveSessionLoggingConfig } from '../session-event-bridge-vA2fLV58.js';
+export { A as AuditLevel, C as CORE_RECONSTRUCT_EVENTS, a as STANDARD_AUDIT_EVENTS, S as SessionEventBridge, b as SessionEventBridgeOptions, c as SessionSamplingOptions, T as ToolProgressSamplingOptions, d as createSessionEventBridge, r as resolveAuditLevel, e as resolveSessionLoggingConfig } from '../session-event-bridge-Bkp7ORfc.js';
 import '../permission-B6YAtNFz.js';
 import '../logger-B63L5bTg.js';
-import '../pipeline-E7_jqGyV.js';
+import '../pipeline-DM-CPTUs.js';
 import '../mailbox-types-BGZWrYTJ.js';
 import '../observability-D-HZN_mF.js';
 import '../task-graph-u1q9Jkyk.js';
 
+interface PromptStore {
+    list(): Promise<PromptEntry[]>;
+    get(id: string): Promise<PromptEntry | null>;
+    save(entry: PromptEntry): Promise<void>;
+    delete(id: string): Promise<boolean>;
+    find(query: string): Promise<PromptEntry[]>;
+}
+/** sha256 of a prompt's content — used for builtin/synced integrity checks. */
+declare function promptChecksum(content: string): string;
+/**
+ * Upgrade any persisted prompt record (v1 or v2) to a fully-populated v2
+ * `PromptEntry`. Pure — does not touch disk. v1 records (only
+ * `id/title/content/tags/createdAt/updatedAt`) get sensible defaults:
+ * slug from title, empty description, `uncategorized` category, `user` source.
+ */
+declare function migratePromptEntry(raw: unknown): PromptEntry | null;
+/**
+ * DefaultPromptStore — file-per-prompt JSON in a single directory (the global
+ * `~/.wrongstack/prompts` by default, or a layer dir the loader passes in).
+ * Reads tolerate legacy v1 files via `migratePromptEntry`; writes always emit
+ * the current v2 schema.
+ */
+declare class DefaultPromptStore implements PromptStore {
+    private readonly dir;
+    constructor(pathsOrDir: WstackPaths | string);
+    list(): Promise<PromptEntry[]>;
+    get(id: string): Promise<PromptEntry | null>;
+    save(entry: PromptEntry): Promise<void>;
+    delete(id: string): Promise<boolean>;
+    find(query: string): Promise<PromptEntry[]>;
+    /** Create a new v2 entry and return it. Does NOT persist — call save() afterwards. */
+    createNew(title: string, content: string, tags?: string[], extra?: Partial<Omit<PromptEntry, 'id' | 'title' | 'content' | 'tags' | 'createdAt' | 'updatedAt'>>): PromptEntry;
+}
+
+interface PromptUsage {
+    count: number;
+    lastUsedAt: string;
+}
+/**
+ * Tracks how often each prompt is inserted, keyed by slug, in a single JSON
+ * file (`~/.wrongstack/prompt-usage.json`). Kept SEPARATE from the prompt
+ * entries so usage can be recorded for read-only builtin prompts without
+ * copy-on-writing them into the user layer. Surfaces "recent / most-used"
+ * views and a gentle search-ranking boost.
+ */
+declare class PromptUsageStore {
+    private readonly file;
+    constructor(file: string);
+    load(): Promise<Record<string, PromptUsage>>;
+    record(slug: string, at?: string): Promise<PromptUsage>;
+    get(slug: string): Promise<PromptUsage | undefined>;
+    /** Slugs ordered by most-recently-used (then by count), capped at `limit`. */
+    recent(limit?: number): Promise<{
+        slug: string;
+        usage: PromptUsage;
+    }[]>;
+    /** Slugs ordered by usage count (then recency), capped at `limit`. */
+    top(limit?: number): Promise<{
+        slug: string;
+        usage: PromptUsage;
+    }[]>;
+}
+
+/**
+ * ReplayLogStore — sidecar store for deterministic-replay support
+ * (idea #2 from IDEAS.md). One JSONL file per session, recording
+ * every provider request/response pair so the same agent loop can
+ * be re-run later with frozen API responses.
+ *
+ * Why a sidecar (not the session JSONL)?
+ *
+ *   Same reason as `AnnotationsStore` — the session log is
+ *   event-sourced and append-only; a provider request payload can be
+ *   tens of kilobytes (especially with long conversation history),
+ *   and we want replay to be opt-in (recorded only when the user
+ *   runs with `--replay` or a future equivalent). Mixing it into
+ *   the event log would inflate every read for replay-irrelevant
+ *   paths.
+ *
+ * File layout: `sessionScopedPath(dir, sessionId, '.replay.jsonl')`,
+ * one entry per line.
+ * Each entry: `{ hash, ts, request, response }`. The `hash` is
+ * computed via `hashRequest` so lookups are O(1) by hash.
+ *
+ * Concurrency: per-session write queue (same pattern as
+ * `AnnotationsStore`). Reads are lock-free; the write chain makes
+ * the append + rehash sequence atomic.
+ */
+interface ReplayEntry {
+    hash: string;
+    ts: string;
+    request: Request;
+    response: Response;
+}
+interface ReplayLogStoreOptions {
+    /** Root sessions directory used with `sessionScopedPath(..., '.replay.jsonl')`. */
+    dir: string;
+    /**
+     * Cap on the number of entries per session. When a `record` would
+     * push the file beyond this, the oldest entries are evicted (LRU
+     * by insertion order). Set to `Infinity` to disable rotation.
+     * Defaults to 1000 — a single LLM call averages ~5KB serialized
+     * (messages + tools + response), so 1000 entries is ~5MB per
+     * session which is a reasonable upper bound.
+     */
+    maxEntries?: number | undefined;
+    events?: EventBus;
+    traceId?: string;
+}
+declare class ReplayLogStore {
+    private readonly dir;
+    private readonly events;
+    private readonly traceId;
+    private readonly writeChains;
+    /** Per-session hash → on-disk location, with lazy entry hydration. */
+    private readonly cache;
+    /** Per-session entry count on disk, to detect when compaction is needed. */
+    private readonly diskCount;
+    private readonly maxEntries;
+    constructor(opts: ReplayLogStoreOptions);
+    /**
+     * Record a request/response pair. Idempotent on hash: a second
+     * `record` for the same hash is a no-op (the existing entry wins).
+     * Returns the hash.
+     */
+    record(input: {
+        sessionId: string;
+        request: Request;
+        response: Response;
+    }): Promise<string>;
+    /**
+     * Look up an entry by hash. Returns `null` when the request has
+     * not been recorded for this session. O(1) after the first call
+     * per session (in-memory cache).
+     */
+    lookup(sessionId: string, hash: string): Promise<ReplayEntry | null>;
+    /** All recorded entries for a session, in insertion order. */
+    load(sessionId: string): Promise<ReplayEntry[]>;
+    /**
+     * List every session id that has a replay log in the store dir.
+     * Returns an array of `{ sessionId, entryCount, path }` sorted
+     * by sessionId for stable output. Used by `wstack replay --list`.
+     */
+    list(): Promise<Array<{
+        sessionId: string;
+        entryCount: number;
+        path: string;
+    }>>;
+    private filePath;
+    private countEntries;
+    private parseReplayLine;
+    private readAll;
+    private writeAll;
+    private ensureCache;
+    private hydrateEntry;
+    private enqueue;
+}
+
 /**
  * @deprecated Legacy helper kept for callers that still need filename-safe
  * labels. New session ids are opaque and do not include model/provider names.
@@ -344,101 +502,6 @@ declare class AnnotationsStore {
     private enqueue;
 }
 
-/**
- * ReplayLogStore — sidecar store for deterministic-replay support
- * (idea #2 from IDEAS.md). One JSONL file per session, recording
- * every provider request/response pair so the same agent loop can
- * be re-run later with frozen API responses.
- *
- * Why a sidecar (not the session JSONL)?
- *
- *   Same reason as `AnnotationsStore` — the session log is
- *   event-sourced and append-only; a provider request payload can be
- *   tens of kilobytes (especially with long conversation history),
- *   and we want replay to be opt-in (recorded only when the user
- *   runs with `--replay` or a future equivalent). Mixing it into
- *   the event log would inflate every read for replay-irrelevant
- *   paths.
- *
- * File layout: `sessionScopedPath(dir, sessionId, '.replay.jsonl')`,
- * one entry per line.
- * Each entry: `{ hash, ts, request, response }`. The `hash` is
- * computed via `hashRequest` so lookups are O(1) by hash.
- *
- * Concurrency: per-session write queue (same pattern as
- * `AnnotationsStore`). Reads are lock-free; the write chain makes
- * the append + rehash sequence atomic.
- */
-interface ReplayEntry {
-    hash: string;
-    ts: string;
-    request: Request;
-    response: Response;
-}
-interface ReplayLogStoreOptions {
-    /** Root sessions directory used with `sessionScopedPath(..., '.replay.jsonl')`. */
-    dir: string;
-    /**
-     * Cap on the number of entries per session. When a `record` would
-     * push the file beyond this, the oldest entries are evicted (LRU
-     * by insertion order). Set to `Infinity` to disable rotation.
-     * Defaults to 1000 — a single LLM call averages ~5KB serialized
-     * (messages + tools + response), so 1000 entries is ~5MB per
-     * session which is a reasonable upper bound.
-     */
-    maxEntries?: number | undefined;
-    events?: EventBus;
-    traceId?: string;
-}
-declare class ReplayLogStore {
-    private readonly dir;
-    private readonly events;
-    private readonly traceId;
-    private readonly writeChains;
-    /** Per-session hash → on-disk location, with lazy entry hydration. */
-    private readonly cache;
-    /** Per-session entry count on disk, to detect when compaction is needed. */
-    private readonly diskCount;
-    private readonly maxEntries;
-    constructor(opts: ReplayLogStoreOptions);
-    /**
-     * Record a request/response pair. Idempotent on hash: a second
-     * `record` for the same hash is a no-op (the existing entry wins).
-     * Returns the hash.
-     */
-    record(input: {
-        sessionId: string;
-        request: Request;
-        response: Response;
-    }): Promise<string>;
-    /**
-     * Look up an entry by hash. Returns `null` when the request has
-     * not been recorded for this session. O(1) after the first call
-     * per session (in-memory cache).
-     */
-    lookup(sessionId: string, hash: string): Promise<ReplayEntry | null>;
-    /** All recorded entries for a session, in insertion order. */
-    load(sessionId: string): Promise<ReplayEntry[]>;
-    /**
-     * List every session id that has a replay log in the store dir.
-     * Returns an array of `{ sessionId, entryCount, path }` sorted
-     * by sessionId for stable output. Used by `wstack replay --list`.
-     */
-    list(): Promise<Array<{
-        sessionId: string;
-        entryCount: number;
-        path: string;
-    }>>;
-    private filePath;
-    private countEntries;
-    private parseReplayLine;
-    private readAll;
-    private writeAll;
-    private ensureCache;
-    private hydrateEntry;
-    private enqueue;
-}
-
 /**
  * Idea #1 from IDEAS.md — Stateful Session Recovery.
  *
@@ -830,69 +893,6 @@ declare function saveTasks(filePath: string, tasks: TaskFile, events?: EventBus,
  */
 declare function mutateTasks(filePath: string, sessionId: string, fn: (file: TaskFile) => TaskFile | Promise<TaskFile>, events?: EventBus, traceId?: string): Promise<TaskFile>;
 
-interface PromptStore {
-    list(): Promise<PromptEntry[]>;
-    get(id: string): Promise<PromptEntry | null>;
-    save(entry: PromptEntry): Promise<void>;
-    delete(id: string): Promise<boolean>;
-    find(query: string): Promise<PromptEntry[]>;
-}
-/** sha256 of a prompt's content — used for builtin/synced integrity checks. */
-declare function promptChecksum(content: string): string;
-/**
- * Upgrade any persisted prompt record (v1 or v2) to a fully-populated v2
- * `PromptEntry`. Pure — does not touch disk. v1 records (only
- * `id/title/content/tags/createdAt/updatedAt`) get sensible defaults:
- * slug from title, empty description, `uncategorized` category, `user` source.
- */
-declare function migratePromptEntry(raw: unknown): PromptEntry | null;
-/**
- * DefaultPromptStore — file-per-prompt JSON in a single directory (the global
- * `~/.wrongstack/prompts` by default, or a layer dir the loader passes in).
- * Reads tolerate legacy v1 files via `migratePromptEntry`; writes always emit
- * the current v2 schema.
- */
-declare class DefaultPromptStore implements PromptStore {
-    private readonly dir;
-    constructor(pathsOrDir: WstackPaths | string);
-    list(): Promise<PromptEntry[]>;
-    get(id: string): Promise<PromptEntry | null>;
-    save(entry: PromptEntry): Promise<void>;
-    delete(id: string): Promise<boolean>;
-    find(query: string): Promise<PromptEntry[]>;
-    /** Create a new v2 entry and return it. Does NOT persist — call save() afterwards. */
-    createNew(title: string, content: string, tags?: string[], extra?: Partial<Omit<PromptEntry, 'id' | 'title' | 'content' | 'tags' | 'createdAt' | 'updatedAt'>>): PromptEntry;
-}
-
-interface PromptUsage {
-    count: number;
-    lastUsedAt: string;
-}
-/**
- * Tracks how often each prompt is inserted, keyed by slug, in a single JSON
- * file (`~/.wrongstack/prompt-usage.json`). Kept SEPARATE from the prompt
- * entries so usage can be recorded for read-only builtin prompts without
- * copy-on-writing them into the user layer. Surfaces "recent / most-used"
- * views and a gentle search-ranking boost.
- */
-declare class PromptUsageStore {
-    private readonly file;
-    constructor(file: string);
-    load(): Promise<Record<string, PromptUsage>>;
-    record(slug: string, at?: string): Promise<PromptUsage>;
-    get(slug: string): Promise<PromptUsage | undefined>;
-    /** Slugs ordered by most-recently-used (then by count), capped at `limit`. */
-    recent(limit?: number): Promise<{
-        slug: string;
-        usage: PromptUsage;
-    }[]>;
-    /** Slugs ordered by usage count (then recency), capped at `limit`. */
-    top(limit?: number): Promise<{
-        slug: string;
-        usage: PromptUsage;
-    }[]>;
-}
-
 declare const INPUT_HISTORY_DEFAULT_MAX = 100;
 /**
  * Per-project TUI prompt input history.

package/dist/storage/index.js

@@ -8820,9 +8820,24 @@ var DirectorStateCheckpoint = class {
   recordTaskStatus(taskId, patch) {
     this.snapshot = {
       ...this.snapshot,
-      tasks: this.snapshot.tasks.map(
-        (t) => t.taskId === taskId ? { ...t, ...patch } : t
-      )
+      tasks: this.snapshot.tasks.map((t) => t.taskId === taskId ? { ...t, ...patch } : t)
+    };
+    this.bumpUpdatedAt();
+    this.schedule();
+  }
+  recordTaskWorktree(taskId, worktree) {
+    const exists = this.snapshot.tasks.some((t) => t.taskId === taskId);
+    this.snapshot = {
+      ...this.snapshot,
+      tasks: exists ? this.snapshot.tasks.map((t) => t.taskId === taskId ? { ...t, worktree } : t) : [
+        ...this.snapshot.tasks,
+        {
+          taskId,
+          subagentId: worktree.subagentId,
+          status: "running",
+          worktree
+        }
+      ]
     };
     this.bumpUpdatedAt();
     this.schedule();
@@ -8865,10 +8880,7 @@ var DirectorStateCheckpoint = class {
         mode: 384
       });
     } catch (err) {
-      console.warn(
-        "[director-state] checkpoint write failed:",
-        toErrorMessage(err)
-      );
+      console.warn("[director-state] checkpoint write failed:", toErrorMessage(err));
     } finally {
       this.writing = false;
       if (this.rewriteRequested) {