@seanhogg/builderforce-memory 2026.9.34 → 2026.10.2

package/dist/storage/nodeFileAdapter.js

@@ -0,0 +1,275 @@
+/**
+ * storage/nodeFileAdapter.ts – Durable Node.js implementation of the storage
+ * port, backed by a single atomically-replaced JSON document.
+ *
+ * This is the VSIX extension-host / MCP adapter the offline-memory scope (M01)
+ * requires: real durable storage on Node WITHOUT an in-memory IndexedDB shim.
+ * fake-indexeddb evaporates with the process; this adapter fsyncs a temp file
+ * and atomically renames it over the database file, so a crash mid-write leaves
+ * either the old or the new document — never a torn one.
+ *
+ * Transaction semantics (M02/M05):
+ *   - All transactions are serialized through one promise queue, so concurrent
+ *     writers in this process interleave at transaction granularity.
+ *   - A read-write transaction holds an exclusive `<file>.lock` (see
+ *     `fileLock.ts`: atomic create, stale-lock reclamation by PID liveness,
+ *     bounded wait) across refresh + mutate + persist, so two processes can
+ *     never both build on the same stale document and lose a write.
+ *   - Under that lock, the file is re-read when another process changed it
+ *     (mtime/size freshness), so cross-process writers build on each other's
+ *     commits instead of blindly overwriting.
+ *   - If the persist fails, the in-memory document is rolled back to the
+ *     pre-transaction snapshot and the transaction rejects — no partial commits.
+ *
+ * Cross-process consistency: a polling watcher (default 1s, injectable)
+ * republishes foreign changes to subscribers, the Node analogue of the IDB
+ * adapter's BroadcastChannel.
+ *
+ * Node builtins are loaded indirectly (via a non-static import) so a browser
+ * bundle of this package never statically pulls in `node:fs`.
+ */
+import { FileLock } from './fileLock.js';
+import { FileTransaction, emptyDocument } from './fileTransaction.js';
+import { MemoryStorageError, } from './types.js';
+/** Load a module without a static specifier, so bundlers skip Node builtins. */
+function dynamicImport(m) {
+    // eslint-disable-next-line @typescript-eslint/no-implied-eval, no-new-func
+    return new Function('m', 'return import(m)')(m);
+}
+export class NodeFileStorageAdapter {
+    _filePath;
+    kind = 'node-file';
+    _fs;
+    _path;
+    _contextId;
+    _doc;
+    _stamp = null;
+    /** Transaction queue tail — all transacts serialize through this. */
+    _queue = Promise.resolve();
+    _watchTimer = null;
+    _listeners = new Set();
+    _watchIntervalMs;
+    _lock;
+    constructor(_filePath, fs, path, opts) {
+        this._filePath = _filePath;
+        this._fs = fs;
+        this._path = path;
+        this._contextId = opts.contextId ?? `node-${Math.random().toString(36).slice(2)}-${Date.now().toString(36)}`;
+        this._watchIntervalMs = opts.watchIntervalMs ?? 1000;
+        this._lock = new FileLock(fs, `${_filePath}.lock`, opts.lock);
+        this._doc = this._loadFromDisk();
+    }
+    /**
+     * Opens (creating if necessary) the durable file at `filePath`. Async only
+     * because Node builtins load indirectly; the document itself is read
+     * synchronously before this resolves.
+     */
+    static async open(filePath, opts = {}) {
+        const fs = (opts.fs ?? (await dynamicImport('node:fs')));
+        const path = (opts.path ?? (await dynamicImport('node:path')));
+        return new NodeFileStorageAdapter(filePath, fs, path, opts);
+    }
+    /** Identity of this context, stamped onto change notes and opIds. */
+    get contextId() {
+        return this._contextId;
+    }
+    /** The durable file backing this adapter. */
+    get filePath() {
+        return this._filePath;
+    }
+    // ── Boot / crash recovery ─────────────────────────────────────────────────
+    /**
+     * Reads the document from disk. Recovery order on a corrupt main file
+     * (killed mid-rename is impossible, but a torn fsync on exotic filesystems
+     * is not): try `<file>.tmp` (the last fully-fsynced candidate), then give up
+     * with the corrupt file preserved at `<file>.corrupt` for forensics rather
+     * than silently starting empty.
+     */
+    _loadFromDisk() {
+        const fs = this._fs;
+        const dir = this._path.dirname(this._filePath);
+        if (dir && !fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        const parsed = this._readDocument(this._filePath);
+        if (parsed)
+            return parsed;
+        if (fs.existsSync(this._filePath)) {
+            const tmp = this._readDocument(`${this._filePath}.tmp`);
+            if (tmp)
+                return tmp;
+            try {
+                fs.copyFileSync(this._filePath, `${this._filePath}.corrupt`);
+                fs.unlinkSync(this._filePath);
+            }
+            catch { /* best-effort forensics */ }
+        }
+        return emptyDocument();
+    }
+    _readDocument(path) {
+        const fs = this._fs;
+        if (!fs.existsSync(path))
+            return null;
+        let raw;
+        try {
+            raw = JSON.parse(fs.readFileSync(path, 'utf8'));
+        }
+        catch {
+            return null;
+        }
+        if (!raw || typeof raw !== 'object')
+            return null;
+        const doc = raw;
+        if (doc.formatVersion !== 1 || !Array.isArray(doc.facts))
+            return null;
+        const full = {
+            formatVersion: 1,
+            facts: doc.facts,
+            tombstones: Array.isArray(doc.tombstones) ? doc.tombstones : [],
+            journal: Array.isArray(doc.journal) ? doc.journal : [],
+            meta: doc.meta?.key === 'counters'
+                ? doc.meta
+                : { key: 'counters', seq: 0, revision: 0, opSeq: 0 },
+        };
+        try {
+            const st = fs.statSync(path);
+            this._stamp = { mtimeMs: st.mtimeMs, size: st.size };
+        }
+        catch { /* stamp stays null; next write re-checks */ }
+        return full;
+    }
+    /** Re-reads the document when another process rewrote the file. */
+    _refreshIfChanged() {
+        const fs = this._fs;
+        if (!fs.existsSync(this._filePath)) {
+            // Deleted underneath us: an empty document is the truth now.
+            if (this._stamp) {
+                this._stamp = null;
+                this._doc = emptyDocument();
+            }
+            return;
+        }
+        let st;
+        try {
+            st = fs.statSync(this._filePath);
+        }
+        catch {
+            return;
+        }
+        if (this._stamp && st.mtimeMs === this._stamp.mtimeMs && st.size === this._stamp.size)
+            return;
+        const doc = this._readDocument(this._filePath);
+        if (doc)
+            this._doc = doc;
+    }
+    /**
+     * Atomic durable write: fsync the full document to `<file>.tmp`, then rename
+     * over the live file. A crash leaves the old file intact; the tmp file is
+     * the recovery source on next boot.
+     */
+    _persist() {
+        const fs = this._fs;
+        const text = JSON.stringify(this._doc);
+        const tmp = `${this._filePath}.tmp`;
+        const fd = fs.openSync(tmp, 'w');
+        try {
+            fs.writeFileSync(fd, text);
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        fs.renameSync(tmp, this._filePath);
+        try {
+            const st = fs.statSync(this._filePath);
+            this._stamp = { mtimeMs: st.mtimeMs, size: st.size };
+        }
+        catch { /* re-stamped on next change check */ }
+    }
+    // ── Port ──────────────────────────────────────────────────────────────────
+    /**
+     * Serialized unit of work. Read-write transactions take the cross-process
+     * lock, refresh from disk (so we build on other processes' commits), run
+     * `fn` against the live document, then persist atomically before
+     * releasing. Any failure rolls the in-memory document back to the
+     * pre-transaction snapshot — no partial commits, in memory or on disk.
+     */
+    transact(_stores, mode, fn) {
+        const run = this._queue.then(() => mode === 'readwrite'
+            ? this._lock.run(() => this._readWrite(fn))
+            : Promise.resolve(fn(new FileTransaction(this._doc))));
+        // Keep the queue alive across rejections.
+        this._queue = run.catch(() => undefined);
+        return run;
+    }
+    async _readWrite(fn) {
+        this._refreshIfChanged();
+        const snapshot = JSON.stringify(this._doc);
+        let result;
+        try {
+            result = await fn(new FileTransaction(this._doc));
+        }
+        catch (err) {
+            // A unit of work that threw leaves nothing behind, in memory either.
+            this._doc = JSON.parse(snapshot);
+            throw err;
+        }
+        try {
+            this._persist();
+        }
+        catch (err) {
+            // Roll back: the caller must not observe a committed-looking state
+            // that never reached disk.
+            this._doc = JSON.parse(snapshot);
+            throw new MemoryStorageError('STORAGE_ABORTED', `Failed to durably persist "${this._filePath}": ${err instanceof Error ? err.message : String(err)}`, err);
+        }
+        return result;
+    }
+    // ── Cross-process consistency seam (M05) ──────────────────────────────────
+    publish(note) {
+        // Co-process subscribers get the note synchronously (subscribers filter
+        // their own origin); foreign processes learn via the watcher.
+        for (const l of this._listeners)
+            l(note);
+    }
+    subscribe(listener) {
+        this._listeners.add(listener);
+        if (this._watchIntervalMs > 0 && !this._watchTimer) {
+            let lastRevision = this._doc.meta.revision;
+            const timer = setInterval(() => {
+                const before = this._doc.meta.revision;
+                this._refreshIfChanged();
+                if (this._doc.meta.revision !== before && this._doc.meta.revision !== lastRevision) {
+                    lastRevision = this._doc.meta.revision;
+                    const note = {
+                        kind: 'facts-changed',
+                        revision: this._doc.meta.revision,
+                        origin: 'foreign',
+                    };
+                    for (const l of this._listeners)
+                        l(note);
+                }
+                else {
+                    lastRevision = this._doc.meta.revision;
+                }
+            }, this._watchIntervalMs);
+            const maybeUnref = timer;
+            if (typeof maybeUnref.unref === 'function')
+                maybeUnref.unref();
+            this._watchTimer = timer;
+        }
+        return () => {
+            this._listeners.delete(listener);
+            if (this._listeners.size === 0 && this._watchTimer) {
+                clearInterval(this._watchTimer);
+                this._watchTimer = null;
+            }
+        };
+    }
+    close() {
+        if (this._watchTimer) {
+            clearInterval(this._watchTimer);
+            this._watchTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=nodeFileAdapter.js.map

package/dist/storage/nodeFileAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeFileAdapter.js","sourceRoot":"","sources":["../../src/storage/nodeFileAdapter.ts"],"names":[],"mappings":"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"}

package/dist/storage/syncJournal.d.ts

@@ -0,0 +1,19 @@
+/**
+ * storage/syncJournal.ts – The sync-acknowledgement half of the journal (M04/M06).
+ *
+ * The journal holds only operations still owed to a sync target: entries are
+ * written unsynced (and only when sync is enabled — see `factMutations.journal`)
+ * and are DELETED once acknowledged, so the journal stays bounded by the
+ * outstanding work instead of growing with every write ever made.
+ */
+import type { FactStoragePort, JournalEntry } from './types.js';
+/** Journal entries not yet acknowledged by sync — the pending operation set. */
+export declare function pendingOps(storage: FactStoragePort): Promise<JournalEntry[]>;
+/**
+ * Acknowledges synced operations: their journal entries are pruned, and the
+ * facts/tombstones they produced clear `pendingSync`, making cap eviction
+ * eligible again. Rows already marked synced (written by older versions,
+ * which journaled every write even without sync) are pruned too.
+ */
+export declare function markSynced(storage: FactStoragePort, opIds: string[]): Promise<void>;
+//# sourceMappingURL=syncJournal.d.ts.map

package/dist/storage/syncJournal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncJournal.d.ts","sourceRoot":"","sources":["../../src/storage/syncJournal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAqC,MAAM,YAAY,CAAC;AAEnG,gFAAgF;AAChF,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAKlF;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBzF"}

package/dist/storage/syncJournal.js

@@ -0,0 +1,46 @@
+/**
+ * storage/syncJournal.ts – The sync-acknowledgement half of the journal (M04/M06).
+ *
+ * The journal holds only operations still owed to a sync target: entries are
+ * written unsynced (and only when sync is enabled — see `factMutations.journal`)
+ * and are DELETED once acknowledged, so the journal stays bounded by the
+ * outstanding work instead of growing with every write ever made.
+ */
+/** Journal entries not yet acknowledged by sync — the pending operation set. */
+export async function pendingOps(storage) {
+    return storage.transact(['journal'], 'readonly', async (tx) => {
+        const all = await tx.getAll('journal');
+        return all.filter((j) => !j.synced);
+    });
+}
+/**
+ * Acknowledges synced operations: their journal entries are pruned, and the
+ * facts/tombstones they produced clear `pendingSync`, making cap eviction
+ * eligible again. Rows already marked synced (written by older versions,
+ * which journaled every write even without sync) are pruned too.
+ */
+export async function markSynced(storage, opIds) {
+    if (opIds.length === 0)
+        return;
+    const acked = new Set(opIds);
+    await storage.transact(['journal', 'facts', 'tombstones'], 'readwrite', async (tx) => {
+        const journal = await tx.getAll('journal');
+        for (const entry of journal) {
+            if (entry.synced || acked.has(entry.opId))
+                await tx.delete('journal', entry.opId);
+        }
+        const facts = await tx.getAll('facts');
+        for (const record of facts) {
+            if (acked.has(record.opId) && record.pendingSync) {
+                await tx.put('facts', { ...record, pendingSync: false });
+            }
+        }
+        const tombstones = await tx.getAll('tombstones');
+        for (const tomb of tombstones) {
+            if (acked.has(tomb.opId) && tomb.pendingSync) {
+                await tx.put('tombstones', { ...tomb, pendingSync: false });
+            }
+        }
+    });
+}
+//# sourceMappingURL=syncJournal.js.map

package/dist/storage/syncJournal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncJournal.js","sourceRoot":"","sources":["../../src/storage/syncJournal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAwB;IACrD,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;QAC1D,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,MAAM,CAAe,SAAS,CAAC,CAAC;QACrD,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAwB,EAAE,KAAe;IACtE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC/B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;QACjF,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,MAAM,CAAe,SAAS,CAAC,CAAC;QACzD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACtF,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,MAAM,CAAmB,OAAO,CAAC,CAAC;QACzD,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBAC/C,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7D,CAAC;QACL,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,MAAM,CAAkB,YAAY,CAAC,CAAC;QAClE,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC3C,MAAM,EAAE,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;YAChE,CAAC;QACL,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/storage/types.d.ts

@@ -0,0 +1,207 @@
+/**
+ * storage/types.ts – Narrow storage/transaction ports for durable memory.
+ *
+ * This module is the seam the offline-memory scope (M01–M05) requires:
+ *   - MemoryStore no longer owns IndexedDB directly; it speaks to a
+ *     {@link FactStoragePort} with REAL transaction semantics (a write resolves
+ *     only after the transaction commits, and rejects on abort — M02).
+ *   - Facts carry explicit scope partitions (account/tenant/project/repository/
+ *     chat — or the explicit unbound scope for personal, never-connected
+ *     memory), durable revisions, operation identity and provenance (M03/M04).
+ *   - Deletes write tombstones, and every mutation appends to a sync journal in
+ *     the SAME transaction as the fact change, so a crash can never acknowledge
+ *     a fact whose journal entry was lost (M02/M04).
+ *
+ * Two durable adapters implement the port:
+ *   - `IdbStorageAdapter`       (browser / VSIX webview — IndexedDB)
+ *   - `NodeFileStorageAdapter`  (VSIX extension host / MCP — atomic JSON file)
+ * An in-memory IndexedDB shim (fake-indexeddb) is a TEST double, never a
+ * durability claim.
+ */
+import { SSMError } from '../errors/SSMError.js';
+/** Explicit ownership partition for a fact. All fields optional; absent = unbound. */
+export interface MemoryScope {
+    account?: string;
+    tenant?: string;
+    project?: string;
+    repository?: string;
+    chat?: string;
+}
+/** The explicit "no account, never connected" partition — NOT the absence of a scope. */
+export declare const UNBOUND_SCOPE: MemoryScope;
+/**
+ * Canonical partition string for a scope. The unbound scope partitions to the
+ * empty string, so legacy records (written before scopes existed) land in the
+ * unbound partition and stay readable. Two scopes that differ in any field are
+ * different partitions — callers can never widen a recall by omitting a field
+ * unless they genuinely target the unbound partition.
+ */
+export declare function scopePartitionKey(scope: MemoryScope | undefined): string;
+/**
+ * Physical record id for a (scope, key) pair. Unbound-scope ids are the bare
+ * key — byte-identical to pre-scope records, so existing databases migrate
+ * without rewriting keys.
+ */
+export declare function scopedRecordId(scope: MemoryScope | undefined, key: string): string;
+/** Where a fact came from. Survives export/import so source time is never rewritten. */
+export interface FactProvenance {
+    /** Origin surface/agent, e.g. 'vscode', 'mcp', 'web', 'cognition'. */
+    source?: string;
+    /** Snapshot/store this record was imported from. */
+    importedFrom?: string;
+    /** The timestamp the source store recorded; preserved across import (M06). */
+    originalTimestamp?: number;
+}
+export type StorageStoreName = 'facts' | 'tombstones' | 'journal' | 'meta';
+/**
+ * Secondary index on {@link StoredFactRecord.key}. Key lookup uses this (or the
+ * primary key) — never a full scan — when the adapter has built it.
+ */
+export declare const FACT_KEY_INDEX = "byKey";
+/**
+ * Secondary multi-entry index on {@link StoredFactRecord.tags}. Tag lookup uses
+ * this when present and falls back to a scan only when the index is missing.
+ */
+export declare const FACT_TAG_INDEX = "byTag";
+/**
+ * The durable fact record. Extends the legacy MemoryEntry shape with identity,
+ * revision and sync state. `pendingSync` is only ever true when the owning
+ * store was created with sync enabled — without a sync target there is nothing
+ * to be pending FOR, and eviction must behave exactly as before (M06).
+ */
+export interface StoredFactRecord {
+    /** Physical primary key: {@link scopedRecordId}. */
+    id: string;
+    /** Caller-facing key within the scope. */
+    key: string;
+    /** Ownership partition. */
+    scope: MemoryScope;
+    content: string;
+    /** Wall-clock write time (source time; preserved by import). */
+    timestamp: number;
+    /** Durable monotonic tiebreaker for same-millisecond writes. */
+    seq: number;
+    /** Durable revision: the store generation that last wrote this record. */
+    revision: number;
+    /** Durable identity of the operation that produced this record. */
+    opId: string;
+    ttlMs?: number;
+    type?: 'text' | 'json' | 'number' | 'boolean';
+    tags?: string[];
+    importance?: number;
+    provenance?: FactProvenance;
+    /** True until a sync acknowledgement clears it; such facts are NEVER evicted by caps. */
+    pendingSync: boolean;
+}
+/** A durable deletion marker. Deletes propagate through sync; tombstones prevent resurrection. */
+export interface TombstoneRecord {
+    id: string;
+    key: string;
+    scope: MemoryScope;
+    deletedAt: number;
+    /** Store generation of the delete; always greater than the fact's last revision. */
+    revision: number;
+    opId: string;
+    pendingSync: boolean;
+}
+export type JournalOpKind = 'remember' | 'forget';
+/** One durable operation in the sync journal — written atomically with its fact change. */
+export interface JournalEntry {
+    opId: string;
+    kind: JournalOpKind;
+    id: string;
+    key: string;
+    scope: MemoryScope;
+    /** Store generation after this op committed. */
+    revision: number;
+    /** The revision the writer based its write on (CAS); undefined = blind write. */
+    baseRevision?: number;
+    timestamp: number;
+    synced: boolean;
+}
+/** Counters kept durably in the meta store. */
+export interface MetaCounters {
+    key: 'counters';
+    /** Durable write sequence (replaces the process-local `_writeSeq`). */
+    seq: number;
+    /** Durable store generation, bumped by every committed write transaction. */
+    revision: number;
+    /** Durable operation counter; opIds are `${contextId}:${opSeq}`. */
+    opSeq: number;
+}
+/**
+ * The minimal surface a transaction offers. Adapters MUST keep the underlying
+ * transaction alive across the awaited operations (request-chained awaits only)
+ * and MUST NOT resolve {@link FactStoragePort.transact} before commit.
+ */
+export interface StorageTransaction {
+    get<T>(store: StorageStoreName, id: string): Promise<T | undefined>;
+    getAll<T>(store: StorageStoreName): Promise<T[]>;
+    put(store: StorageStoreName, value: unknown): Promise<void>;
+    delete(store: StorageStoreName, id: string): Promise<void>;
+    /**
+     * Lookup via a named index. `undefined` means this store has no such index
+     * (legacy schema, or an adapter that has not built it) — the caller MUST
+     * fall back to a primary-key get or a scan. An empty array means the index
+     * exists and matched nothing; do not scan in that case.
+     */
+    getByIndex?<T>(store: StorageStoreName, indexName: string, query: string): Promise<T[] | undefined>;
+}
+/** A change notice for cross-context invalidation (M05). */
+export interface ConsistencyNote {
+    kind: 'facts-changed';
+    /** Scope partition that changed; undefined = whole database. */
+    scope?: MemoryScope;
+    /** Durable generation after the change. */
+    revision: number;
+    /** Identity of the committing context; a context ignores its own notes. */
+    origin: string;
+}
+/**
+ * The narrow durable-storage port. One transaction = one unit of work:
+ * fact mutation + provenance + tombstone/event + journal commit together or
+ * not at all.
+ */
+export interface FactStoragePort {
+    /** Which durable backend this is (for honest capability reporting). */
+    readonly kind: 'indexedDB' | 'node-file';
+    /**
+     * Runs `fn` inside one real transaction over the named stores. Resolves with
+     * `fn`'s result ONLY after the transaction has committed durably; rejects if
+     * the transaction aborts, `fn` throws, or the persist fails. A rejected
+     * transact leaves NO partial writes behind.
+     */
+    transact<T>(stores: StorageStoreName[], mode: 'readonly' | 'readwrite', fn: (tx: StorageTransaction) => Promise<T> | T): Promise<T>;
+    /**
+     * Publishes a change notice to other contexts sharing this storage, when the
+     * adapter supports cross-context notification. Optional.
+     */
+    publish?(note: ConsistencyNote): void;
+    /**
+     * Subscribes to change notices from OTHER contexts (tabs, extension windows,
+     * MCP processes) sharing this storage. Returns an unsubscribe function.
+     * Optional: an adapter without it simply offers no cross-context seam.
+     */
+    subscribe?(listener: (note: ConsistencyNote) => void): () => void;
+    close?(): void | Promise<void>;
+}
+/** Detailed error codes surfaced by the storage layer (`MemoryStorageError.storageCode`). */
+export type StorageErrorCode = 
+/** The durable backend is unavailable or faulted. */
+'STORAGE_UNAVAILABLE'
+/** A compare-and-set write found a newer revision than its base. */
+ | 'STORAGE_CONFLICT'
+/** A transaction aborted; no partial writes were committed. */
+ | 'STORAGE_ABORTED';
+/**
+ * A storage-layer failure. It IS an {@link SSMError} whose `code` is the public
+ * contract (`MEMORY_UNAVAILABLE` / `MEMORY_CONFLICT`); `storageCode` keeps the
+ * detailed storage code for callers that need it.
+ */
+export declare class MemoryStorageError extends SSMError {
+    readonly storageCode: StorageErrorCode;
+    constructor(storageCode: StorageErrorCode, message: string, cause?: unknown);
+}
+/** Type guard for conflict errors so callers can reconcile instead of blindly retrying. */
+export declare function isStorageConflict(err: unknown): err is MemoryStorageError;
+//# sourceMappingURL=types.d.ts.map

package/dist/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"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"}