@seanhogg/builderforce-memory 2026.9.34 → 2026.10.2

package/dist/storage/factMutations.js

@@ -0,0 +1,73 @@
+/**
+ * storage/factMutations.ts – The write primitives every repository mutation
+ * shares, so the counter bump / tombstone / journal rules live in ONE place:
+ *
+ *   - {@link bumpOp}: next durable revision + operation id.
+ *   - {@link journal}: append a sync-journal entry — ONLY when sync is enabled.
+ *     Without a sync target there is nothing to acknowledge, so writing rows
+ *     already marked synced just grew the journal forever.
+ *   - {@link deleteWithTombstone}: delete a fact, tombstone it when sync is on,
+ *     journal the delete — one call for forget, clear and TTL purge.
+ *   - {@link clearTombstone}: a write resurrects a key (remember, import).
+ */
+export const COUNTERS_ID = 'counters';
+/** The stores a mutating unit of work spans. */
+export const WRITE_STORES = ['facts', 'tombstones', 'journal', 'meta'];
+export async function readCounters(tx) {
+    const existing = await tx.get('meta', COUNTERS_ID);
+    return existing ?? { key: COUNTERS_ID, seq: 0, revision: 0, opSeq: 0 };
+}
+export async function writeCounters(tx, counters) {
+    await tx.put('meta', { ...counters, key: COUNTERS_ID });
+}
+/** The next revision + operation identity after `counters`. */
+export function bumpOp(counters, ctx) {
+    const next = { ...counters, revision: counters.revision + 1, opSeq: counters.opSeq + 1 };
+    return { counters: next, opId: `${ctx.contextId}:${next.opSeq}` };
+}
+/** Appends an unsynced journal entry when sync is enabled; a no-op otherwise. */
+export async function journal(tx, ctx, entry) {
+    if (!ctx.syncEnabled)
+        return;
+    await tx.put('journal', { ...entry, synced: false });
+}
+/** Clears any tombstone for `id`; true when one existed (the write resurrected the key). */
+export async function clearTombstone(tx, id) {
+    const tombstone = await tx.get('tombstones', id);
+    if (tombstone)
+        await tx.delete('tombstones', id);
+    return !!tombstone;
+}
+/**
+ * Deletes one fact as a durable, propagating deletion: bump the counters,
+ * delete, tombstone (sync on), journal (sync on). Returns the bumped counters;
+ * the caller persists them once per transaction with {@link writeCounters}.
+ */
+export async function deleteWithTombstone(tx, ctx, record, counters, baseRevision) {
+    const { counters: next, opId } = bumpOp(counters, ctx);
+    const at = ctx.now();
+    await tx.delete('facts', record.id);
+    if (ctx.syncEnabled) {
+        await tx.put('tombstones', {
+            id: record.id,
+            key: record.key,
+            scope: record.scope,
+            deletedAt: at,
+            revision: next.revision,
+            opId,
+            pendingSync: true,
+        });
+    }
+    await journal(tx, ctx, {
+        opId,
+        kind: 'forget',
+        id: record.id,
+        key: record.key,
+        scope: record.scope,
+        revision: next.revision,
+        baseRevision,
+        timestamp: at,
+    });
+    return next;
+}
+//# sourceMappingURL=factMutations.js.map

package/dist/storage/factMutations.js.map

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

package/dist/storage/factQueries.d.ts

@@ -0,0 +1,16 @@
+/**
+ * storage/factQueries.ts – Read helpers shared by the repository and its
+ * retention policy: partition filtering and index lookups with the
+ * "missing index ⇒ fall back, empty hit ⇒ real miss" contract.
+ */
+import { type MemoryScope, type StorageTransaction, type StoredFactRecord } from './types.js';
+/** Every fact in exactly `scope`'s partition (never wider, never narrower). */
+export declare function factsInScope(tx: StorageTransaction, scope: MemoryScope | undefined): Promise<StoredFactRecord[]>;
+/**
+ * Index lookup. `undefined` means the named index is absent and the caller
+ * must fall back. An empty array is a real miss — do not scan after it.
+ * Multi-entry tag indexes can return the same record once per matching tag
+ * occurrence, so hits are de-duplicated by id.
+ */
+export declare function indexedFacts(tx: StorageTransaction, indexName: string, query: string): Promise<StoredFactRecord[] | undefined>;
+//# sourceMappingURL=factQueries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factQueries.d.ts","sourceRoot":"","sources":["../../src/storage/factQueries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjH,+EAA+E;AAC/E,wBAAsB,YAAY,CAAC,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAItH;AAaD;;;;;GAKG;AACH,wBAAsB,YAAY,CAC9B,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,EAAE,GAAG,SAAS,CAAC,CAIzC"}

package/dist/storage/factQueries.js

@@ -0,0 +1,36 @@
+/**
+ * storage/factQueries.ts – Read helpers shared by the repository and its
+ * retention policy: partition filtering and index lookups with the
+ * "missing index ⇒ fall back, empty hit ⇒ real miss" contract.
+ */
+import { scopePartitionKey } from './types.js';
+/** Every fact in exactly `scope`'s partition (never wider, never narrower). */
+export async function factsInScope(tx, scope) {
+    const partition = scopePartitionKey(scope);
+    const all = await tx.getAll('facts');
+    return all.filter((r) => scopePartitionKey(r.scope) === partition);
+}
+function dedupeById(records) {
+    const seen = new Set();
+    const out = [];
+    for (const record of records) {
+        if (seen.has(record.id))
+            continue;
+        seen.add(record.id);
+        out.push(record);
+    }
+    return out;
+}
+/**
+ * Index lookup. `undefined` means the named index is absent and the caller
+ * must fall back. An empty array is a real miss — do not scan after it.
+ * Multi-entry tag indexes can return the same record once per matching tag
+ * occurrence, so hits are de-duplicated by id.
+ */
+export async function indexedFacts(tx, indexName, query) {
+    if (!tx.getByIndex)
+        return undefined;
+    const hits = await tx.getByIndex('facts', indexName, query);
+    return hits === undefined ? undefined : dedupeById(hits);
+}
+//# sourceMappingURL=factQueries.js.map

package/dist/storage/factQueries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factQueries.js","sourceRoot":"","sources":["../../src/storage/factQueries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAoE,MAAM,YAAY,CAAC;AAEjH,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAsB,EAAE,KAA8B;IACrF,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,MAAM,CAAmB,OAAO,CAAC,CAAC;IACvD,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,UAAU,CAAC,OAA2B;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAuB,EAAE,CAAC;IACnC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAAE,SAAS;QAClC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,EAAsB,EACtB,SAAiB,EACjB,KAAa;IAEb,IAAI,CAAC,EAAE,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,UAAU,CAAmB,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9E,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAC7D,CAAC"}

package/dist/storage/factRetention.d.ts

@@ -0,0 +1,30 @@
+/**
+ * storage/factRetention.ts – Retention policy over the fact store (M06):
+ * local cap eviction and intentional TTL purge.
+ *
+ *   - Cap eviction is cache management: synced records only, no tombstone, no
+ *     journal. It counts in a READONLY transaction first and opens a read-write
+ *     one only when the scope is actually over the cap — on the file adapter
+ *     every read-write transaction rewrites and fsyncs the whole document, so
+ *     an under-cap `remember` must not pay for a second one.
+ *   - TTL purge is a deletion: each expiry goes through
+ *     {@link deleteWithTombstone} so it propagates when sync is enabled.
+ */
+import { type MutationContext } from './factMutations.js';
+import type { FactStoragePort, MemoryScope, StoredFactRecord } from './types.js';
+type IsExpired = (record: StoredFactRecord) => boolean;
+/**
+ * Removes the lowest-value SYNCED records in `scope` past `maxEntries`.
+ * Returns the evicted keys (empty when under the cap — no write happens).
+ */
+export declare function evictForCap(storage: FactStoragePort, scope: MemoryScope | undefined, maxEntries: number, isExpired: IsExpired): Promise<string[]>;
+/**
+ * Deletes every expired record in `scope` as a propagating deletion.
+ * Returns how many were purged and the store revision after the purge.
+ */
+export declare function purgeExpired(storage: FactStoragePort, ctx: MutationContext, scope: MemoryScope | undefined, isExpired: IsExpired): Promise<{
+    purged: number;
+    revision: number;
+}>;
+export {};
+//# sourceMappingURL=factRetention.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factRetention.d.ts","sourceRoot":"","sources":["../../src/storage/factRetention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAKH,KAAK,eAAe,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjF,KAAK,SAAS,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC;AAevD;;;GAGG;AACH,wBAAsB,WAAW,CAC7B,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,WAAW,GAAG,SAAS,EAC9B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,SAAS,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAC9B,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,WAAW,GAAG,SAAS,EAC9B,SAAS,EAAE,SAAS,GACrB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAS/C"}

package/dist/storage/factRetention.js

@@ -0,0 +1,65 @@
+/**
+ * storage/factRetention.ts – Retention policy over the fact store (M06):
+ * local cap eviction and intentional TTL purge.
+ *
+ *   - Cap eviction is cache management: synced records only, no tombstone, no
+ *     journal. It counts in a READONLY transaction first and opens a read-write
+ *     one only when the scope is actually over the cap — on the file adapter
+ *     every read-write transaction rewrites and fsyncs the whole document, so
+ *     an under-cap `remember` must not pay for a second one.
+ *   - TTL purge is a deletion: each expiry goes through
+ *     {@link deleteWithTombstone} so it propagates when sync is enabled.
+ */
+import { factsInScope } from './factQueries.js';
+import { WRITE_STORES, deleteWithTombstone, readCounters, writeCounters, } from './factMutations.js';
+/** Lowest value first: expired, then least important, then oldest. */
+function evictionOrder(isExpired) {
+    const rank = (e) => [isExpired(e) ? 0 : 1, e.importance ?? 0.5, e.timestamp, e.seq];
+    return (a, b) => {
+        const ra = rank(a), rb = rank(b);
+        for (let i = 0; i < ra.length; i++) {
+            if (ra[i] !== rb[i])
+                return ra[i] - rb[i];
+        }
+        return 0;
+    };
+}
+/**
+ * Removes the lowest-value SYNCED records in `scope` past `maxEntries`.
+ * Returns the evicted keys (empty when under the cap — no write happens).
+ */
+export async function evictForCap(storage, scope, maxEntries, isExpired) {
+    const count = await storage.transact(['facts'], 'readonly', async (tx) => (await factsInScope(tx, scope)).length);
+    if (count <= maxEntries)
+        return [];
+    return storage.transact(['facts'], 'readwrite', async (tx) => {
+        // Re-read inside the write: another writer may have changed the set.
+        const mine = await factsInScope(tx, scope);
+        if (mine.length <= maxEntries)
+            return [];
+        const victims = mine
+            .filter((r) => !r.pendingSync)
+            .sort(evictionOrder(isExpired))
+            .slice(0, Math.max(0, mine.length - maxEntries));
+        for (const v of victims)
+            await tx.delete('facts', v.id);
+        return victims.map((v) => v.key);
+    });
+}
+/**
+ * Deletes every expired record in `scope` as a propagating deletion.
+ * Returns how many were purged and the store revision after the purge.
+ */
+export async function purgeExpired(storage, ctx, scope, isExpired) {
+    return storage.transact(WRITE_STORES, 'readwrite', async (tx) => {
+        const expired = (await factsInScope(tx, scope)).filter(isExpired);
+        if (expired.length === 0)
+            return { purged: 0, revision: 0 };
+        let counters = await readCounters(tx);
+        for (const record of expired)
+            counters = await deleteWithTombstone(tx, ctx, record, counters);
+        await writeCounters(tx, counters);
+        return { purged: expired.length, revision: counters.revision };
+    });
+}
+//# sourceMappingURL=factRetention.js.map

package/dist/storage/factRetention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factRetention.js","sourceRoot":"","sources":["../../src/storage/factRetention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EACH,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,aAAa,GAEhB,MAAM,oBAAoB,CAAC;AAK5B,sEAAsE;AACtE,SAAS,aAAa,CAAC,SAAoB;IACvC,MAAM,IAAI,GAAG,CAAC,CAAmB,EAAoC,EAAE,CACnE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IACpE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACjC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAAE,OAAO,EAAE,CAAC,CAAC,CAAE,GAAG,EAAE,CAAC,CAAC,CAAE,CAAC;QAChD,CAAC;QACD,OAAO,CAAC,CAAC;IACb,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC7B,OAAwB,EACxB,KAA8B,EAC9B,UAAkB,EAClB,SAAoB;IAEpB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAClH,IAAI,KAAK,IAAI,UAAU;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;QACzD,qEAAqE;QACrE,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,MAAM,IAAI,UAAU;YAAE,OAAO,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI;aACf,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;aAC7B,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;aAC9B,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;QACrD,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,OAAwB,EACxB,GAAoB,EACpB,KAA8B,EAC9B,SAAoB;IAEpB,OAAO,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;QAC5D,MAAM,OAAO,GAAG,CAAC,MAAM,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC5D,IAAI,QAAQ,GAAG,MAAM,YAAY,CAAC,EAAE,CAAC,CAAC;QACtC,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,QAAQ,GAAG,MAAM,mBAAmB,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC9F,MAAM,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;IACnE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/storage/fileLock.d.ts

@@ -0,0 +1,56 @@
+/**
+ * storage/fileLock.ts – Cross-process exclusive lock for the node-file adapter.
+ *
+ * Two MCP / extension-host processes sharing one memory file each ran
+ * refresh → mutate → tmp+rename with nothing between them, so the later rename
+ * silently dropped the other's commit. A read-write transaction now holds an
+ * exclusive lock file for its whole refresh + mutate + persist:
+ *
+ *   - Acquire = `open(<file>.lock, 'wx')` (atomic create-if-absent), then write
+ *     our PID into it.
+ *   - A lock whose recorded PID is no longer alive is STALE and is reclaimed.
+ *     Staleness is decided by PID liveness, never by age: a slow but live
+ *     writer (a large fsync) must not have its lock stolen.
+ *   - Waiting is bounded: past `timeoutMs` the transaction rejects with
+ *     STORAGE_UNAVAILABLE naming the holder, instead of hanging forever.
+ */
+/** The subset of node:fs the lock needs. */
+export interface LockFs {
+    openSync(path: string, flags: string): number;
+    writeFileSync(fd: number, data: string): void;
+    closeSync(fd: number): void;
+    readFileSync(path: string, encoding: 'utf8'): string;
+    unlinkSync(path: string): void;
+}
+export interface FileLockOptions {
+    /** Give up waiting after this long (ms). Default 10 000. */
+    timeoutMs?: number;
+    /** Poll interval while the lock is held by a live process (ms). Default 20. */
+    retryMs?: number;
+    /** This process's PID. Default: `process.pid`. */
+    pid?: number;
+    /** PID liveness probe. Default: `process.kill(pid, 0)`. */
+    isAlive?: (pid: number) => boolean;
+    /** Injectable sleep (tests). */
+    sleep?: (ms: number) => Promise<void>;
+}
+/** `kill(pid, 0)`: ESRCH = gone; EPERM = alive under another user. */
+export declare function defaultIsAlive(pid: number): boolean;
+export declare class FileLock {
+    private readonly _fs;
+    readonly lockPath: string;
+    private readonly _timeoutMs;
+    private readonly _retryMs;
+    private readonly _pid;
+    private readonly _isAlive;
+    private readonly _sleep;
+    constructor(_fs: LockFs, lockPath: string, opts?: FileLockOptions);
+    /** Runs `fn` while holding the lock; always releases it. */
+    run<T>(fn: () => Promise<T> | T): Promise<T>;
+    private _tryCreate;
+    private _acquire;
+    /** Removes a dead holder's lock — only if it still names that holder. */
+    private _reclaim;
+    private _release;
+}
+//# sourceMappingURL=fileLock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fileLock.d.ts","sourceRoot":"","sources":["../../src/storage/fileLock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,4CAA4C;AAC5C,MAAM,WAAW,MAAM;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9C,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IACrD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC5B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,gCAAgC;IAChC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAeD,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASnD;AAeD,qBAAa,QAAQ;IAOL,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAU,QAAQ,CAAC,QAAQ,EAAE,MAAM;IANnE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;gBAE1B,GAAG,EAAE,MAAM,EAAW,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB;IAQ/F,4DAA4D;IACtD,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASlD,OAAO,CAAC,UAAU;YAgBJ,QAAQ;IAqBtB,yEAAyE;IACzE,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,QAAQ;CASnB"}

package/dist/storage/fileLock.js

@@ -0,0 +1,138 @@
+/**
+ * storage/fileLock.ts – Cross-process exclusive lock for the node-file adapter.
+ *
+ * Two MCP / extension-host processes sharing one memory file each ran
+ * refresh → mutate → tmp+rename with nothing between them, so the later rename
+ * silently dropped the other's commit. A read-write transaction now holds an
+ * exclusive lock file for its whole refresh + mutate + persist:
+ *
+ *   - Acquire = `open(<file>.lock, 'wx')` (atomic create-if-absent), then write
+ *     our PID into it.
+ *   - A lock whose recorded PID is no longer alive is STALE and is reclaimed.
+ *     Staleness is decided by PID liveness, never by age: a slow but live
+ *     writer (a large fsync) must not have its lock stolen.
+ *   - Waiting is bounded: past `timeoutMs` the transaction rejects with
+ *     STORAGE_UNAVAILABLE naming the holder, instead of hanging forever.
+ */
+import { MemoryStorageError } from './types.js';
+function nodeProcess() {
+    return globalThis.process;
+}
+function errorCode(err) {
+    return err?.code;
+}
+/** `kill(pid, 0)`: ESRCH = gone; EPERM = alive under another user. */
+export function defaultIsAlive(pid) {
+    const proc = nodeProcess();
+    if (!proc)
+        return true;
+    try {
+        proc.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return errorCode(err) === 'EPERM';
+    }
+}
+function readHolder(fs, lockPath) {
+    let text;
+    try {
+        text = fs.readFileSync(lockPath, 'utf8');
+    }
+    catch (err) {
+        // Released between our failed create and this read: retry the create.
+        if (errorCode(err) === 'ENOENT')
+            return undefined;
+        throw err;
+    }
+    const pid = Number.parseInt(text.trim(), 10);
+    return Number.isInteger(pid) && pid > 0 ? pid : undefined;
+}
+export class FileLock {
+    _fs;
+    lockPath;
+    _timeoutMs;
+    _retryMs;
+    _pid;
+    _isAlive;
+    _sleep;
+    constructor(_fs, lockPath, opts = {}) {
+        this._fs = _fs;
+        this.lockPath = lockPath;
+        this._timeoutMs = opts.timeoutMs ?? 10_000;
+        this._retryMs = opts.retryMs ?? 20;
+        this._pid = opts.pid ?? nodeProcess()?.pid ?? 0;
+        this._isAlive = opts.isAlive ?? defaultIsAlive;
+        this._sleep = opts.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    }
+    /** Runs `fn` while holding the lock; always releases it. */
+    async run(fn) {
+        await this._acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            this._release();
+        }
+    }
+    _tryCreate() {
+        let fd;
+        try {
+            fd = this._fs.openSync(this.lockPath, 'wx');
+        }
+        catch (err) {
+            if (errorCode(err) === 'EEXIST')
+                return false;
+            throw new MemoryStorageError('STORAGE_UNAVAILABLE', `Cannot create lock "${this.lockPath}": ${String(err)}`, err);
+        }
+        try {
+            this._fs.writeFileSync(fd, String(this._pid));
+        }
+        finally {
+            this._fs.closeSync(fd);
+        }
+        return true;
+    }
+    async _acquire() {
+        const deadline = Date.now() + this._timeoutMs;
+        let holder;
+        for (;;) {
+            if (this._tryCreate())
+                return;
+            holder = readHolder(this._fs, this.lockPath);
+            if (holder !== undefined && holder !== this._pid && !this._isAlive(holder)) {
+                this._reclaim(holder);
+                continue;
+            }
+            // A live holder, or a lock whose PID is not written yet: wait.
+            if (Date.now() >= deadline) {
+                throw new MemoryStorageError('STORAGE_UNAVAILABLE', `Timed out after ${this._timeoutMs}ms waiting for "${this.lockPath}" (held by pid ${holder ?? 'unknown'}).`);
+            }
+            await this._sleep(this._retryMs);
+        }
+    }
+    /** Removes a dead holder's lock — only if it still names that holder. */
+    _reclaim(deadPid) {
+        if (readHolder(this._fs, this.lockPath) !== deadPid)
+            return;
+        try {
+            this._fs.unlinkSync(this.lockPath);
+        }
+        catch (err) {
+            // Another waiter reclaimed it first; the next create decides.
+            if (errorCode(err) !== 'ENOENT')
+                throw err;
+        }
+    }
+    _release() {
+        try {
+            this._fs.unlinkSync(this.lockPath);
+        }
+        catch (err) {
+            if (errorCode(err) !== 'ENOENT') {
+                throw new MemoryStorageError('STORAGE_UNAVAILABLE', `Cannot release lock "${this.lockPath}": ${String(err)}`, err);
+            }
+        }
+    }
+}
+//# sourceMappingURL=fileLock.js.map

package/dist/storage/fileLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileLock.js","sourceRoot":"","sources":["../../src/storage/fileLock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA6BhD,SAAS,WAAW;IAChB,OAAQ,UAA4C,CAAC,OAAO,CAAC;AACjE,CAAC;AAED,SAAS,SAAS,CAAC,GAAY;IAC3B,OAAQ,GAAgC,EAAE,IAAI,CAAC;AACnD,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,GAAW;IACtC,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC;IACtC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,EAAU,EAAE,QAAgB;IAC5C,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACD,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,sEAAsE;QACtE,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAClD,MAAM,GAAG,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9D,CAAC;AAED,MAAM,OAAO,QAAQ;IAOY;IAAsB;IANlC,UAAU,CAAS;IACnB,QAAQ,CAAS;IACjB,IAAI,CAAS;IACb,QAAQ,CAA2B;IACnC,MAAM,CAAgC;IAEvD,YAA6B,GAAW,EAAW,QAAgB,EAAE,OAAwB,EAAE;QAAlE,QAAG,GAAH,GAAG,CAAQ;QAAW,aAAQ,GAAR,QAAQ,CAAQ;QAC/D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;QAC3C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI,WAAW,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,IAAI,cAAc,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,GAAG,CAAI,EAAwB;QACjC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtB,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,QAAQ,EAAE,CAAC;QACpB,CAAC;IACL,CAAC;IAEO,UAAU;QACd,IAAI,EAAU,CAAC;QACf,IAAI,CAAC;YACD,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAC9C,MAAM,IAAI,kBAAkB,CAAC,qBAAqB,EAAE,uBAAuB,IAAI,CAAC,QAAQ,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACtH,CAAC;QACD,IAAI,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAClD,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,QAAQ;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QAC9C,IAAI,MAA0B,CAAC;QAC/B,SAAS,CAAC;YACN,IAAI,IAAI,CAAC,UAAU,EAAE;gBAAE,OAAO;YAC9B,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACtB,SAAS;YACb,CAAC;YACD,+DAA+D;YAC/D,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;gBACzB,MAAM,IAAI,kBAAkB,CACxB,qBAAqB,EACrB,mBAAmB,IAAI,CAAC,UAAU,mBAAmB,IAAI,CAAC,QAAQ,kBAAkB,MAAM,IAAI,SAAS,IAAI,CAC9G,CAAC;YACN,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;IACL,CAAC;IAED,yEAAyE;IACjE,QAAQ,CAAC,OAAe;QAC5B,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,OAAO;YAAE,OAAO;QAC5D,IAAI,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,8DAA8D;YAC9D,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,QAAQ;gBAAE,MAAM,GAAG,CAAC;QAC/C,CAAC;IACL,CAAC;IAEO,QAAQ;QACZ,IAAI,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC9B,MAAM,IAAI,kBAAkB,CAAC,qBAAqB,EAAE,wBAAwB,IAAI,CAAC,QAAQ,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YACvH,CAAC;QACL,CAAC;IACL,CAAC;CACJ"}

package/dist/storage/fileTransaction.d.ts

@@ -0,0 +1,33 @@
+/**
+ * storage/fileTransaction.ts – The {@link StorageTransaction} the node-file
+ * adapter hands to a unit of work: direct reads/writes on the in-memory
+ * document, plus lazily rebuilt key/tag indexes over its facts.
+ */
+import { type JournalEntry, type MetaCounters, type StorageStoreName, type StorageTransaction, type StoredFactRecord, type TombstoneRecord } from './types.js';
+/** The on-disk document shape. Versioned so future migrations are explicit. */
+export interface NodeFileDocument {
+    formatVersion: 1;
+    facts: StoredFactRecord[];
+    tombstones: TombstoneRecord[];
+    journal: JournalEntry[];
+    meta: MetaCounters;
+}
+export declare function emptyDocument(): NodeFileDocument;
+export declare class FileTransaction implements StorageTransaction {
+    private readonly _doc;
+    /** Lazy key/tag indexes over the in-memory document. Rebuilt after mutations. */
+    private _indexDirty;
+    private readonly _byKey;
+    private readonly _byTag;
+    constructor(_doc: NodeFileDocument);
+    private _table;
+    /** The id field of a table store (`meta` is the singleton and never reaches here). */
+    private _idField;
+    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>;
+    getByIndex<T>(store: StorageStoreName, indexName: string, query: string): Promise<T[] | undefined>;
+    private _ensureFactIndexes;
+}
+//# sourceMappingURL=fileTransaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fileTransaction.d.ts","sourceRoot":"","sources":["../../src/storage/fileTransaction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGH,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACvB,MAAM,YAAY,CAAC;AAEpB,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC7B,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,IAAI,EAAE,YAAY,CAAC;CACtB;AAED,wBAAgB,aAAa,IAAI,gBAAgB,CAQhD;AAED,qBAAa,eAAgB,YAAW,kBAAkB;IAM1C,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,iFAAiF;IACjF,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;gBAEnC,IAAI,EAAE,gBAAgB;IAEnD,OAAO,CAAC,MAAM;IAId,sFAAsF;IACtF,OAAO,CAAC,QAAQ;IAMV,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAKnE,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAIhD,GAAG,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3D,MAAM,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1D,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IAUxG,OAAO,CAAC,kBAAkB;CAgB7B"}

package/dist/storage/fileTransaction.js

@@ -0,0 +1,108 @@
+/**
+ * storage/fileTransaction.ts – The {@link StorageTransaction} the node-file
+ * adapter hands to a unit of work: direct reads/writes on the in-memory
+ * document, plus lazily rebuilt key/tag indexes over its facts.
+ */
+import { FACT_KEY_INDEX, FACT_TAG_INDEX, } from './types.js';
+export function emptyDocument() {
+    return {
+        formatVersion: 1,
+        facts: [],
+        tombstones: [],
+        journal: [],
+        meta: { key: 'counters', seq: 0, revision: 0, opSeq: 0 },
+    };
+}
+export class FileTransaction {
+    _doc;
+    /** Lazy key/tag indexes over the in-memory document. Rebuilt after mutations. */
+    _indexDirty = true;
+    _byKey = new Map();
+    _byTag = new Map();
+    constructor(_doc) {
+        this._doc = _doc;
+    }
+    _table(store) {
+        return this._doc[store];
+    }
+    /** The id field of a table store (`meta` is the singleton and never reaches here). */
+    _idField(store) {
+        return store === 'journal' ? 'opId' : 'id';
+    }
+    // `meta` is ONE counters record on disk (`doc.meta`), not an array: the other stores
+    // are tables keyed by their id field, `meta` is a singleton keyed 'counters'.
+    async get(store, id) {
+        if (store === 'meta')
+            return (this._doc.meta?.key === id ? this._doc.meta : undefined);
+        const f = this._idField(store);
+        return this._table(store).find((r) => r[f] === id);
+    }
+    async getAll(store) {
+        if (store === 'meta')
+            return (this._doc.meta ? [this._doc.meta] : []);
+        return this._table(store).slice();
+    }
+    async put(store, value) {
+        if (store === 'meta') {
+            this._doc.meta = value;
+            return;
+        }
+        const f = this._idField(store);
+        const table = this._table(store);
+        const id = value[f];
+        const idx = table.findIndex((r) => r[f] === id);
+        if (idx >= 0)
+            table[idx] = value;
+        else
+            table.push(value);
+        if (store === 'facts')
+            this._indexDirty = true;
+    }
+    async delete(store, id) {
+        if (store === 'meta') {
+            if (this._doc.meta?.key === id)
+                this._doc.meta = emptyDocument().meta;
+            return;
+        }
+        const f = this._idField(store);
+        const table = this._table(store);
+        const idx = table.findIndex((r) => r[f] === id);
+        if (idx >= 0)
+            table.splice(idx, 1);
+        if (store === 'facts')
+            this._indexDirty = true;
+    }
+    async getByIndex(store, indexName, query) {
+        if (store !== 'facts')
+            return undefined;
+        if (indexName !== FACT_KEY_INDEX && indexName !== FACT_TAG_INDEX)
+            return undefined;
+        this._ensureFactIndexes();
+        const hits = indexName === FACT_KEY_INDEX
+            ? this._byKey.get(query)
+            : this._byTag.get(query);
+        return (hits ?? []).slice();
+    }
+    _ensureFactIndexes() {
+        if (!this._indexDirty)
+            return;
+        this._byKey.clear();
+        this._byTag.clear();
+        for (const fact of this._doc.facts) {
+            const keyHits = this._byKey.get(fact.key);
+            if (keyHits)
+                keyHits.push(fact);
+            else
+                this._byKey.set(fact.key, [fact]);
+            for (const tag of fact.tags ?? []) {
+                const tagHits = this._byTag.get(tag);
+                if (tagHits)
+                    tagHits.push(fact);
+                else
+                    this._byTag.set(tag, [fact]);
+            }
+        }
+        this._indexDirty = false;
+    }
+}
+//# sourceMappingURL=fileTransaction.js.map

package/dist/storage/fileTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileTransaction.js","sourceRoot":"","sources":["../../src/storage/fileTransaction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,cAAc,EACd,cAAc,GAOjB,MAAM,YAAY,CAAC;AAWpB,MAAM,UAAU,aAAa;IACzB,OAAO;QACH,aAAa,EAAE,CAAC;QAChB,KAAK,EAAE,EAAE;QACT,UAAU,EAAE,EAAE;QACd,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;KAC3D,CAAC;AACN,CAAC;AAED,MAAM,OAAO,eAAe;IAMK;IAL7B,iFAAiF;IACzE,WAAW,GAAG,IAAI,CAAC;IACV,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC/C,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEhE,YAA6B,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;IAAG,CAAC;IAE/C,MAAM,CAAC,KAAuB;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAmE,CAAC;IAC9F,CAAC;IAED,sFAAsF;IAC9E,QAAQ,CAAC,KAAwC;QACrD,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC;IAED,qFAAqF;IACrF,8EAA8E;IAC9E,KAAK,CAAC,GAAG,CAAI,KAAuB,EAAE,EAAU;QAC5C,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAkB,CAAC;QACxG,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAkB,CAAC;IACxE,CAAC;IACD,KAAK,CAAC,MAAM,CAAI,KAAuB;QACnC,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAmB,CAAC;QACxF,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAoB,CAAC;IACxD,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,KAAuB,EAAE,KAAc;QAC7C,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,KAAqB,CAAC;YACvC,OAAO;QACX,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,EAAE,GAAI,KAAgC,CAAC,CAAC,CAAE,CAAC;QACjD,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAChD,IAAI,GAAG,IAAI,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,GAAG,KAAc,CAAC;;YACrC,KAAK,CAAC,IAAI,CAAC,KAAc,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,OAAO;YAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IACnD,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,KAAuB,EAAE,EAAU;QAC5C,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YACnB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE;gBAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC,IAAI,CAAC;YACtE,OAAO;QACX,CAAC;QACD,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAChD,IAAI,GAAG,IAAI,CAAC;YAAE,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACnC,IAAI,KAAK,KAAK,OAAO;YAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,UAAU,CAAI,KAAuB,EAAE,SAAiB,EAAE,KAAa;QACzE,IAAI,KAAK,KAAK,OAAO;YAAE,OAAO,SAAS,CAAC;QACxC,IAAI,SAAS,KAAK,cAAc,IAAI,SAAS,KAAK,cAAc;YAAE,OAAO,SAAS,CAAC;QACnF,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,SAAS,KAAK,cAAc;YACrC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;YACxB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,EAAS,CAAC;IACvC,CAAC;IAEO,kBAAkB;QACtB,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO;QAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1C,IAAI,OAAO;gBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;gBAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YACvC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;gBAChC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACrC,IAAI,OAAO;oBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;oBAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YACtC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC7B,CAAC;CACJ"}