@sema-agent/core 7.15.0 → 7.16.0

package/dist/core/memory-engine/file-backend.d.ts

@@ -15,12 +15,12 @@ export interface ScannedEntryFile {
 }
 /**
  * Enumerate a scope dir's entry files (depth-capped, symlinks skipped, dotfiles/index/non-`.md`
- * ignored, `exclude` dirs — sibling scope homes under the root — skipped). Shared by the backend
- * and the engine's harvest scan so the two can never disagree on what counts as an entry file.
+ * ignored). Shared by the backend and the engine's harvest scan so the two can never disagree on
+ * what counts as an entry file. A scope dir is that scope's home and nothing else — no other
+ * scope's directory can lie under it, so there is nothing to exclude.
  */
 export declare function scanEntryFiles(dir: string, opts?: {
     maxDepth?: number;
-    exclude?: ReadonlySet<string>;
     /** Harvest gate hook: called for every path the scan SKIPS, with why (backend scans ignore it). */
     onSkip?: (path: string, kind: "symlink" | "depth" | "nonmd" | "dotfile" | "unreadable") => void;
 }): ScannedEntryFile[];
@@ -377,6 +377,8 @@ export declare class FileMemoryEngineBackend implements MemoryBackend {
     readonly controlPlaneRoot: string;
     /** Injected clock (opus 1.258 LOW: match the engine's `this.now` determinism discipline). */
     private readonly now;
+    /** The construction-time incident sink (partition adoption, layout adoption on the standalone faces). */
+    private readonly onIncident;
     /**
      * The COMMITTED-rev ledger (`revs.json`, id → row; design/186 schema v2). Zero-copy makes it
      * load-bearing for CAS: the entry files are the SAME files the session edits, so "read the current
@@ -448,6 +450,18 @@ export declare class FileMemoryEngineBackend implements MemoryBackend {
      *  loop, cleared before EXECUTE mutates the disk. Never caches `sync:true` reads. */
     private batchScan;
     constructor(dir: string, opts?: FileMemoryEngineBackendOptions);
+    /** The adoption under a held transaction lock (before the ledger migration, whose census derives
+     *  paths from the registry); the heartbeat refreshes the lock and re-proves it before every action. */
+    private adoptLayoutLocked;
+    /** The seat at the head of every lock-free public face: adopt under a NON-BLOCKING try-acquire. A live
+     *  holder stands this caller down (its locked faces, or the next mount, adopt); the read that follows
+     *  refuses fail-closed on a v1 registry rather than serving a layout it cannot describe. */
+    private ensureLayout;
+    /** The engine's mount seat: adopt under the transaction lock (`ownerCandidate` = the write scope; `onIncident` = this call's sink). */
+    adoptRootScopeLayout(opts?: {
+        ownerCandidate?: string | null;
+        onIncident?: MemoryPartitionIncidentSink;
+    }): Promise<void>;
     /** B3 fail-closed preflight (engine harvest duck-types this): force-reload every load-bearing
      *  sidecar from disk; throws {@link ControlPlaneCorruptError} when one is corrupt. Also completes
      *  any interrupted transaction (H4 recovery). */
@@ -690,8 +704,6 @@ export declare class FileMemoryEngineBackend implements MemoryBackend {
     /** Remove orphaned `.stage-*` files (a crash BEFORE the journal rename = clean rollback: nothing
      *  was committed, the staged tmps are litter). Dotfiles are invisible to entry scans regardless. */
     private sweepStagedFiles;
-    /** The names of sibling scope subdirs to exclude when scanning the ROOT scope's own nested content. */
-    private excludedSubdirNames;
     private scopeDir;
     /** B2/C-F9 — contain one inbound-gate REJECT, shared by the adopting read (`readScope` sync) and
      *  the adoption-restricted committed view (`readScopeCommitted`) so the two doors can never drift:

package/dist/core/memory-engine/file-backend.js

@@ -1,11 +1,12 @@
-import { existsSync, linkSync, lstatSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, openSync, fsyncSync, closeSync } from "node:fs";
+import { existsSync, linkSync, lstatSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, openSync, fsyncSync, closeSync, utimesSync } from "node:fs";
 import { createHash, randomUUID } from "node:crypto";
 import { dirname, join, relative } from "node:path";
 import { jaccardDistance, termSet } from "../memory-vector.js";
 import { MAX_MEMORY_BYTES } from "../memory.js";
 import { inlineUntrusted } from "../untrusted-text.js";
 import { ambiguousOriginRepresentation, committedDistilledOf, committedOriginOf, computeEntryRev, distilledEquals, entryFromFile, isValidEntryId, originEquals, parseEntryFile, serializeEntryFile } from "./frontmatter.js";
-import { ControlPlaneCorruptError, CURSORS_FILE, QUARANTINE_DIR, CHALLENGES_FILE, IMPORT_RECEIPTS_DIR, LINEAGE_FILE, SESSION_POLLUTION_DIR, appendChallengeEvents, atomicWriteFileSync, quarantineAndTombstone, captureAndClearLineageForEntries, claimRootScope, adoptCanonicalKeyedControlDir, deriveControlPlaneDir, ensureDirExists, enqueueMemoryAnnouncement, importLatchTxnId, importLineageCommitted, importSessionPollution, isContainedIn, lineageContributionsOfSession, listSessionPollution, readChallengeEvents, readLineageRecord, registerScope, registeredScopes, releaseImportLatch, resolveMemoryEngineRoot, scopeDirFor, scopeDirName, stageImportLatch, writeAllSync, } from "./layout.js";
+import { convertV1SidecarKeys } from "./delegation-settlement.js";
+import { ControlPlaneCorruptError, CURSORS_FILE, QUARANTINE_DIR, CHALLENGES_FILE, IMPORT_RECEIPTS_DIR, LINEAGE_FILE, SESSION_POLLUTION_DIR, appendChallengeEvents, atomicWriteFileSync, quarantineAndTombstone, captureAndClearLineageForEntries, adoptRootScopeLayout, adoptCanonicalKeyedControlDir, deriveControlPlaneDir, ensureDirExists, enqueueMemoryAnnouncement, importLatchTxnId, importLineageCommitted, importSessionPollution, isContainedIn, lineageContributionsOfSession, listSessionPollution, readChallengeEvents, readLineageRecord, registerScope, registeredScopes, releaseImportLatch, layoutNeedsAdoption, resolveMemoryEngineRoot, scopeDirFor, scopeDirName, scopeRegistryShape, stageImportLatch, writeAllSync, } from "./layout.js";
 import { screenInboundEntries } from "./data-plane.js";
 import { scanMemoryFileName, scanMemoryWrite } from "./scan.js";
 export const MEMORY_INDEX_FILENAME = "MEMORY.md";
@@ -43,8 +44,6 @@ export function scanEntryFiles(dir, opts = {}) {
                 continue;
             }
             if (st.isDirectory()) {
-                if (depth === 0 && opts.exclude?.has(name))
-                    continue;
                 if (depth + 1 <= maxDepth)
                     walk(p, depth + 1);
                 else
@@ -534,6 +533,7 @@ export class FileMemoryEngineBackend {
     directoryRoot;
     controlPlaneRoot;
     now;
+    onIncident;
     ledger;
     envelopeExtras;
     persistedSchemaVersion;
@@ -549,6 +549,7 @@ export class FileMemoryEngineBackend {
     batchScan;
     constructor(dir, opts = {}) {
         this.now = opts.now ?? Date.now;
+        this.onIncident = opts.onIncident;
         this.directoryRoot = dir;
         if (opts.controlDir === undefined)
             adoptCanonicalKeyedControlDir(resolveMemoryEngineRoot(), dir, opts.onIncident);
@@ -561,11 +562,60 @@ export class FileMemoryEngineBackend {
         }
         catch {
         }
-        if (this.persistedSchemaVersion === "v1" || (this.ledger !== undefined && hasUnboundRows(this.ledger)))
-            this.tryOpportunisticMigrate();
+        if (this.persistedSchemaVersion === "v1" || (this.ledger !== undefined && hasUnboundRows(this.ledger))) {
+            let layoutDerivesPaths = false;
+            try {
+                const shape = scopeRegistryShape(this.controlPlaneRoot);
+                layoutDerivesPaths = shape !== "v1" && shape !== "migrating";
+            }
+            catch {
+            }
+            if (layoutDerivesPaths)
+                this.tryOpportunisticMigrate();
+        }
+    }
+    adoptLayoutLocked(lockToken, ownerCandidate, onIncident) {
+        adoptRootScopeLayout(this.directoryRoot, this.controlPlaneRoot, {
+            ownerCandidate,
+            onIncident: onIncident ?? this.onIncident,
+            convertSidecars: convertV1SidecarKeys,
+            renew: () => {
+                const now = new Date();
+                utimesSync(this.txnLockDir(), now, now);
+                this.assertTxnLockOwnership(lockToken);
+            },
+        });
+    }
+    ensureLayout(ownerCandidate) {
+        if (!layoutNeedsAdoption(this.directoryRoot, this.controlPlaneRoot))
+            return;
+        const lock = this.tryAcquireTxnLockSync();
+        if (lock === undefined)
+            return;
+        try {
+            this.recoverJournal({ token: lock.token });
+            this.adoptLayoutLocked(lock.token, ownerCandidate);
+        }
+        finally {
+            lock.release();
+        }
+    }
+    async adoptRootScopeLayout(opts = {}) {
+        if (!layoutNeedsAdoption(this.directoryRoot, this.controlPlaneRoot))
+            return;
+        const lock = await this.acquireTxnLock();
+        try {
+            this.assertTxnLockOwnership(lock.token);
+            this.recoverJournal({ token: lock.token });
+            this.adoptLayoutLocked(lock.token, opts.ownerCandidate, opts.onIncident);
+        }
+        finally {
+            lock.release();
+        }
     }
     checkControlPlane() {
         this.recoverJournal({ unlocked: true });
+        this.ensureLayout();
         this.ledger = undefined;
         this.loadLedger();
         registeredScopes(this.controlPlaneRoot);
@@ -658,8 +708,6 @@ export class FileMemoryEngineBackend {
         const byId = new Map();
         for (const scope of Object.keys(registeredScopes(this.controlPlaneRoot))) {
             const dir = this.scopeDir(scope);
-            const isRoot = dir === this.directoryRoot;
-            const exclude = isRoot ? this.excludedSubdirNames(scope) : undefined;
             const walk = (d, depth) => {
                 let names;
                 try {
@@ -686,8 +734,6 @@ export class FileMemoryEngineBackend {
                     if (st.isSymbolicLink())
                         continue;
                     if (st.isDirectory()) {
-                        if (depth === 0 && exclude?.has(name))
-                            continue;
                         if (depth + 1 <= DEFAULT_MAX_ENTRY_DEPTH)
                             walk(p, depth + 1);
                         continue;
@@ -855,6 +901,7 @@ export class FileMemoryEngineBackend {
             return;
         try {
             this.recoverJournal({ token: lock.token });
+            this.adoptLayoutLocked(lock.token);
             this.migrateLockedIfNeeded(lock.token);
         }
         finally {
@@ -1482,15 +1529,6 @@ export class FileMemoryEngineBackend {
         };
         walk(this.directoryRoot, 0);
     }
-    excludedSubdirNames(forScope) {
-        const reg = registeredScopes(this.controlPlaneRoot);
-        const names = new Set();
-        for (const [scope, dirName] of Object.entries(reg)) {
-            if (scope !== forScope && dirName !== "")
-                names.add(dirName);
-        }
-        return names;
-    }
     scopeDir(scope) {
         return registerScope(this.directoryRoot, this.controlPlaneRoot, scope);
     }
@@ -1540,8 +1578,7 @@ export class FileMemoryEngineBackend {
         if (this.persistedSchemaVersion === "v1" || this.unboundRowsKnown)
             this.tryOpportunisticMigrate();
         const dir = this.scopeDir(scope);
-        const isRoot = dir === this.directoryRoot;
-        const files = scanEntryFiles(dir, { exclude: isRoot ? this.excludedSubdirNames(scope) : undefined });
+        const files = scanEntryFiles(dir);
         const entries = [];
         const rows = sync ? this.loadLedger() : undefined;
         const retrievalDeleted = !sync && files.length > 0 ? this.retrievalDeletedIds() : undefined;
@@ -1774,6 +1811,7 @@ export class FileMemoryEngineBackend {
             this.assertTxnLockOwnership(lock.token);
             this.ledger = undefined;
             this.recoverJournal({ token: lock.token });
+            this.adoptLayoutLocked(lock.token);
             this.migrateLockedIfNeeded(lock.token);
             return this.readScope(scope, true, false, lock.token);
         }
@@ -1786,9 +1824,11 @@ export class FileMemoryEngineBackend {
         }
     }
     listScopes() {
+        this.ensureLayout();
         return { supported: true, scopes: Object.keys(registeredScopes(this.controlPlaneRoot)).sort() };
     }
     async listHeaders(scopes) {
+        this.ensureLayout();
         return this.listHeadersFrom(scopes, (s) => this.readScopeAdopting(s));
     }
     async listHeadersFrom(scopes, read) {
@@ -1802,6 +1842,7 @@ export class FileMemoryEngineBackend {
         return out;
     }
     async getByIds(ids) {
+        this.ensureLayout();
         return this.getByIdsFrom(ids, (s) => this.readScopeAdopting(s));
     }
     async getByIdsFrom(ids, read) {
@@ -1820,9 +1861,9 @@ export class FileMemoryEngineBackend {
             throw new Error(`memory retrieval view is read-only — ${op} must go through the backend itself`);
         };
         return {
-            listHeaders: async (scopes) => this.listHeadersFrom(scopes, (s) => this.readScope(s, false)),
-            getByIds: async (ids) => this.getByIdsFrom(ids, (s) => this.readScope(s, false)),
-            search: async (query, scopes, opts) => this.searchFrom(query, scopes, opts, (s) => this.readScope(s, false)),
+            listHeaders: async (scopes) => (this.ensureLayout(), this.listHeadersFrom(scopes, (s) => this.readScope(s, false))),
+            getByIds: async (ids) => (this.ensureLayout(), this.getByIdsFrom(ids, (s) => this.readScope(s, false))),
+            search: async (query, scopes, opts) => (this.ensureLayout(), this.searchFrom(query, scopes, opts, (s) => this.readScope(s, false))),
             applyPatches: async () => refuse("applyPatches"),
             getConsolidationCursor: async (scope) => this.getConsolidationCursor(scope),
             setConsolidationCursor: async () => refuse("setConsolidationCursor"),
@@ -1841,9 +1882,7 @@ export class FileMemoryEngineBackend {
         if (this.persistedSchemaVersion === "v1" || this.unboundRowsKnown)
             this.tryOpportunisticMigrate();
         const dir = this.scopeDir(scope);
-        const isRoot = dir === this.directoryRoot;
         const files = scanEntryFiles(dir, {
-            exclude: isRoot ? this.excludedSubdirNames(scope) : undefined,
             onSkip: audit
                 ? (p, kind) => {
                     if (kind !== "unreadable")
@@ -1998,8 +2037,7 @@ export class FileMemoryEngineBackend {
     idProjectionElsewhere(id, excludeAbsPath) {
         for (const scope of Object.keys(registeredScopes(this.controlPlaneRoot))) {
             const dir = this.scopeDir(scope);
-            const isRoot = dir === this.directoryRoot;
-            for (const f of scanEntryFiles(dir, { exclude: isRoot ? this.excludedSubdirNames(scope) : undefined })) {
+            for (const f of scanEntryFiles(dir)) {
                 if (f.path === excludeAbsPath)
                     continue;
                 const text = readSafe(f.path);
@@ -2022,15 +2060,16 @@ export class FileMemoryEngineBackend {
             throw new Error(`memory adoption-restricted view is read-only — ${op} must go through the backend itself`);
         };
         return {
-            listHeaders: async (scopes) => this.listHeadersFrom(scopes, (s) => this.readScopeCommitted(s, audit)),
-            getByIds: async (ids) => this.getByIdsFrom(ids, (s) => this.readScopeCommitted(s, audit)),
-            search: async (query, scopes, o) => this.searchFrom(query, scopes, o, (s) => this.readScopeCommitted(s, audit)),
+            listHeaders: async (scopes) => (this.ensureLayout(), this.listHeadersFrom(scopes, (s) => this.readScopeCommitted(s, audit))),
+            getByIds: async (ids) => (this.ensureLayout(), this.getByIdsFrom(ids, (s) => this.readScopeCommitted(s, audit))),
+            search: async (query, scopes, o) => (this.ensureLayout(), this.searchFrom(query, scopes, o, (s) => this.readScopeCommitted(s, audit))),
             applyPatches: async () => refuse("applyPatches"),
             getConsolidationCursor: async (scope) => this.getConsolidationCursor(scope),
             setConsolidationCursor: async () => refuse("setConsolidationCursor"),
         };
     }
     auditRestrictedDivergence(scopes, opts) {
+        this.ensureLayout();
         for (const scope of scopes)
             this.readScopeCommitted(scope, true);
         const idlessBaseline = opts?.idlessWriteScope !== undefined && opts.idlessWriteScope === this.restrictedIdlessScope ? this.restrictedIdlessBaseline : undefined;
@@ -2044,9 +2083,7 @@ export class FileMemoryEngineBackend {
         let complete = true;
         for (const scope of Object.keys(registeredScopes(this.controlPlaneRoot))) {
             const dir = this.scopeDir(scope);
-            const isRoot = dir === this.directoryRoot;
             const files = scanEntryFiles(dir, {
-                exclude: isRoot ? this.excludedSubdirNames(scope) : undefined,
                 onSkip: (_p, kind) => {
                     if (kind === "unreadable")
                         complete = false;
@@ -2121,6 +2158,7 @@ export class FileMemoryEngineBackend {
         }
     }
     async search(query, scopes, opts) {
+        this.ensureLayout();
         return this.searchFrom(query, scopes, opts, (s) => this.readScopeAdopting(s));
     }
     async searchFrom(query, scopes, opts, read) {
@@ -2266,6 +2304,7 @@ export class FileMemoryEngineBackend {
         this.assertTxnLockOwnership(lockToken);
         this.ledger = undefined;
         this.recoverJournal({ token: lockToken });
+        this.adoptLayoutLocked(lockToken, patches.find((p) => p.op === "add" && p.entry !== undefined)?.entry?.scope);
         this.migrateLockedIfNeeded(lockToken);
         const rows = cloneRows(this.loadLedger());
         const report = { applied: [], conflicts: [] };
@@ -2442,7 +2481,6 @@ export class FileMemoryEngineBackend {
             if (existingAnywhere !== undefined && existingAnywhere.entry.slug !== entry.slug) {
                 ops.push({ kind: "delete", target: existingAnywhere.path });
             }
-            claimRootScope(this.controlPlaneRoot, entry.scope);
             const dir = this.scopeDir(entry.scope);
             let slug = entry.slug;
             let target = join(dir, `${slug}.md`);
@@ -2584,6 +2622,7 @@ export class FileMemoryEngineBackend {
             this.assertTxnLockOwnership(lock.token);
             this.ledger = undefined;
             this.recoverJournal({ token: lock.token });
+            this.adoptLayoutLocked(lock.token);
             this.migrateLockedIfNeeded(lock.token);
             const rows = cloneRows(this.loadLedger());
             const chain = this.readTransferChain(lock.token);
@@ -2924,6 +2963,7 @@ export class FileMemoryEngineBackend {
         return { state: "unavailable", reason: "shadowless-legacy" };
     }
     async committedSnapshotOf(id) {
+        this.ensureLayout();
         return this.auditStable((rows, final) => {
             const row = Object.prototype.hasOwnProperty.call(rows, id) ? rows[id] : undefined;
             if (row === undefined)
@@ -2951,6 +2991,7 @@ export class FileMemoryEngineBackend {
     }
     async committedSnapshotsOfScopes(scopes) {
         const want = new Set(scopes);
+        this.ensureLayout();
         try {
             return await this.auditStable((rows, final) => {
                 const out = { complete: true, rows: [], unbound: [] };
@@ -3278,6 +3319,7 @@ export class FileMemoryEngineBackend {
             this.assertTxnLockOwnership(lock.token);
             this.ledger = undefined;
             this.recoverJournal({ token: lock.token });
+            this.adoptLayoutLocked(lock.token);
             const rows = this.loadLedger();
             if (this.persistedSchemaVersion !== "v2") {
                 throw erasureCodedError("memory export refused: the committed-rev ledger is still schema v1 (pre-binding) — the store migrates itself at its next write/read entry or checkControlPlane; an export never triggers the migration", FileMemoryEngineBackend.EXPORT_INCOMPLETE);
@@ -3361,6 +3403,7 @@ export class FileMemoryEngineBackend {
             this.assertTxnLockOwnership(lock.token);
             this.ledger = undefined;
             this.recoverJournal({ token: lock.token });
+            this.adoptLayoutLocked(lock.token);
             const rows = this.loadLedger();
             if (this.persistedSchemaVersion !== "v2")
                 return { custody: [], unbound: [], complete: false, unsliceableCustody: 0, reason: "the committed-rev ledger is still schema v1 (migrate first)" };
@@ -3465,6 +3508,7 @@ export class FileMemoryEngineBackend {
             this.assertTxnLockOwnership(lock.token);
             this.ledger = undefined;
             this.recoverJournal({ token: lock.token });
+            this.adoptLayoutLocked(lock.token);
             this.migrateLockedIfNeeded(lock.token);
             const ctl = this.controlPlaneRoot;
             const txnId = importLatchTxnId(bundleHash);

package/dist/core/memory-engine/index.d.ts

@@ -4,7 +4,7 @@ export { MEMORY_EXPOSURE_BANNER, MEMORY_EXPOSURE_HANDLE_TAG, MEMORY_PROVENANCE_R
 export { scanMemoryWrite, scanMemoryFileName, scanRemediation, MEMORY_FILENAME_SEGMENT_RE } from "./scan.js";
 export { FileMemoryEngineBackend, scanEntryFiles, MEMORY_INDEX_FILENAME, DEFAULT_MAX_ENTRY_DEPTH, type ScannedEntryFile, type TransferEvidence, type CommittedBinding, type CommittedEntrySnapshot, type CommittedScopeSnapshots, type EntryCustodyReport, erasureSelectHash, type EraseMemoryEntriesInput, type ErasureSelect, type ErasedBinding, type MemoryErasureAttestation, type MemoryExportSnapshot, } from "./file-backend.js";
 export { computeBundleSectionHashes, computeMemoryBundleHash, memoryBundleInvalid, type MemoryExportBundle, type MemoryImportReport, type MemoryBundleImportPlan, type BundleChallengeRow, type BundleLineageRow, type BundlePollutedSession, } from "./export-bundle.js";
-export { ControlPlaneCorruptError, deriveControlPlaneDir, deriveRepoControlPlaneDir, deriveRepoKey, deriveRepoMemoryDir, deriveProjectMemoryDir, deriveProjectControlDir, recordProjectIdHint, lookupProjectIdHint, PROJECT_ID_HINTS_FILE, resolveMemoryEngineRoot, scopeDirFor, scopeDirName, claimRootScope, rootScopeOf, enqueueMemoryAnnouncement, drainMemoryAnnouncements, peekMemoryAnnouncements, bumpScanFuse, scanFuseCount, clearScanFuse, ANNOUNCEMENTS_FILE, MEMORY_ANNOUNCEMENTS_MAX, SCAN_FUSE_FILE, SCAN_FUSE_THRESHOLD, LINEAGE_FILE, CHALLENGES_FILE, CHALLENGED_HISTORY_FILE, CHALLENGE_LEDGER_MAX_EVENTS, rebuildStrictControlPlaneLedger, type ControlPlaneRebuildReceipt, type StrictControlPlaneLedger, type ChallengeAppendResult, type ChallengeAssignment, type ChallengeEvent, type ChallengedHistoryRow, type LineagePendingTxn, type LineagePromotion, SESSION_CAPTURE_OPTOUT_DIR, markSessionCaptureOptOut, readSessionCaptureOptOut, listSessionCaptureOptOut, fileSessionCaptureRecordStore, type SessionCaptureOptOutRecord, type SessionCaptureOptOutMarkOutcome, type SessionCaptureRecordStore, } from "./layout.js";
+export { ControlPlaneCorruptError, deriveControlPlaneDir, deriveRepoControlPlaneDir, deriveRepoKey, deriveRepoMemoryDir, deriveProjectMemoryDir, deriveProjectControlDir, recordProjectIdHint, lookupProjectIdHint, PROJECT_ID_HINTS_FILE, resolveMemoryEngineRoot, scopeDirFor, scopeDirName, scopeRegistryShape, layoutNeedsAdoption, adoptRootScopeLayout, v1MemoryPathKeyResolver, unresolvedProjectionDebts, scanFuseKey, type AdoptRootScopeLayoutOptions, type ScopeRegistryShape, enqueueMemoryAnnouncement, drainMemoryAnnouncements, peekMemoryAnnouncements, bumpScanFuse, scanFuseCount, clearScanFuse, ANNOUNCEMENTS_FILE, MEMORY_ANNOUNCEMENTS_MAX, SCAN_FUSE_FILE, SCAN_FUSE_THRESHOLD, LINEAGE_FILE, CHALLENGES_FILE, CHALLENGED_HISTORY_FILE, CHALLENGE_LEDGER_MAX_EVENTS, rebuildStrictControlPlaneLedger, type ControlPlaneRebuildReceipt, type StrictControlPlaneLedger, type ChallengeAppendResult, type ChallengeAssignment, type ChallengeEvent, type ChallengedHistoryRow, type LineagePendingTxn, type LineagePromotion, SESSION_CAPTURE_OPTOUT_DIR, markSessionCaptureOptOut, readSessionCaptureOptOut, listSessionCaptureOptOut, fileSessionCaptureRecordStore, type SessionCaptureOptOutRecord, type SessionCaptureOptOutMarkOutcome, type SessionCaptureRecordStore, } from "./layout.js";
 export { readV2HeaderHints, isInstructionEntry, type V2HeaderHints } from "./header-hints.js";
 export { parseEntryFile, serializeEntryFile, computeEntryRev, entryFromFile, committedOriginOf, originEquals, ambiguousOriginRepresentation, type ParsedEntryFile } from "./frontmatter.js";
 export { consolidationExposedFrontmatter } from "./frontmatter.js";
@@ -13,7 +13,7 @@ export { CONSOLIDATION_DEFAULTS, ConsolidationRefusedError, MEMORY_SEARCH_SUPERS
 export { DISTILLER_DEFAULT_MAX_INPUTS_PER_PRODUCT, LLM_DISTILLER_CONTRACT, LLM_DISTILLER_CONTRACT_DL2, LLM_DISTILLER_CONTRACT_DL3, LLM_DISTILLER_CONTRACTS, MEMORY_DISTILLER_CONTRACT_V1, contractGroupingDiff, driveConsolidationToFixpoint, isAliasModelId, llmPlanDistiller, mintExposurePartitionedPlan, mintLlmConsolidationPlan, MEMORY_DISTILLER_PURITY_CONTRACT_V1, detectCleanArmVerbatimLeak, type CleanArmLeakFinding, type CleanArmLeakVerdict, type MemoryDistillerPurityContract, openAiCompatChatSeat, parseJsonAnswer, planParseRepairs, sanitizeLlmGroups, scheduleUnderFuse, type ConsolidationDistillFn, type ConsolidationDriveCycleRow, type ConsolidationDriveEngine, type ConsolidationDriveResult, type ConsolidationFoldState, type DistillerCandidate, type DistillerChatAnswer, type DistillerChatFn, type DistillerChatRequest, type FuseSchedule, type LlmConsolidationPlan, type LlmConsolidationPlanArm, type LlmConsolidationPlanProduct, type LlmDistillerContract, type MintLlmConsolidationPlanResult, type PlanParseRepairs, type SanitizedLlmGroups, } from "./distiller.js";
 export { CONSOLIDATION_DRIVER_PLANS_DIR, CONSOLIDATION_DRIVER_RUNS_FILE, archiveDistillerPlan, readConsolidationDriverRun, runMemoryConsolidationDriver, type ConsolidationDriverEngine, type ConsolidationDriverRunRow, type ConsolidationRunReceipt, type RunMemoryConsolidationOptions, } from "./consolidation-driver.js";
 export type { OriginClearanceRow, OriginClearanceEvent, OriginClearanceShadow } from "./origin-clearance.js";
-export { MEMORY_ORIGIN_CAUSES } from "./types.js";
+export { MEMORY_ORIGIN_CAUSES, writableRootOf } from "./types.js";
 export type { MemoryBackend, MemoryEntry, MemoryEntryFrontmatter, MemoryEntryOrigin, MemoryOriginCause, MemoryScopeEnumeration, MemoryEntryDistilled, MemoryEntryDistilledInput, MemoryEntryHeader, ScoredMemoryEntry, NotePatch, PatchReport, MaterializedFile, MemorySessionHandle, HarvestReport, HarvestRejection, HarvestRejectionCode, MemoryAnnouncement, ScanFinding, } from "./types.js";
 export { memoryBackendContract, assertMemoryBackendSearchEquivalence, type MemoryBackendContractHooks, } from "./memory-backend-contract.js";
 export { SCOPE_SEGMENT_MAX_ENCODED, PROJECT_MARKER_PATH, encodeScopeSegment, decodeScopeSegment, parseScopeKey, formatUserScope, formatOrgScope, formatProjScope, formatUserProjScope, isPersonalScope, assertScopeContractPlacement, formatProjectMarker, parseProjectMarker, resolveProjectId, PROJECT_ID_REGEX, type ParsedScopeKey, } from "./scope-contract.js";

package/dist/core/memory-engine/index.js

@@ -4,7 +4,7 @@ export { MEMORY_EXPOSURE_BANNER, MEMORY_EXPOSURE_HANDLE_TAG, MEMORY_PROVENANCE_R
 export { scanMemoryWrite, scanMemoryFileName, scanRemediation, MEMORY_FILENAME_SEGMENT_RE } from "./scan.js";
 export { FileMemoryEngineBackend, scanEntryFiles, MEMORY_INDEX_FILENAME, DEFAULT_MAX_ENTRY_DEPTH, erasureSelectHash, } from "./file-backend.js";
 export { computeBundleSectionHashes, computeMemoryBundleHash, memoryBundleInvalid, } from "./export-bundle.js";
-export { ControlPlaneCorruptError, deriveControlPlaneDir, deriveRepoControlPlaneDir, deriveRepoKey, deriveRepoMemoryDir, deriveProjectMemoryDir, deriveProjectControlDir, recordProjectIdHint, lookupProjectIdHint, PROJECT_ID_HINTS_FILE, resolveMemoryEngineRoot, scopeDirFor, scopeDirName, claimRootScope, rootScopeOf, enqueueMemoryAnnouncement, drainMemoryAnnouncements, peekMemoryAnnouncements, bumpScanFuse, scanFuseCount, clearScanFuse, ANNOUNCEMENTS_FILE, MEMORY_ANNOUNCEMENTS_MAX, SCAN_FUSE_FILE, SCAN_FUSE_THRESHOLD, LINEAGE_FILE, CHALLENGES_FILE, CHALLENGED_HISTORY_FILE, CHALLENGE_LEDGER_MAX_EVENTS, rebuildStrictControlPlaneLedger, SESSION_CAPTURE_OPTOUT_DIR, markSessionCaptureOptOut, readSessionCaptureOptOut, listSessionCaptureOptOut, fileSessionCaptureRecordStore, } from "./layout.js";
+export { ControlPlaneCorruptError, deriveControlPlaneDir, deriveRepoControlPlaneDir, deriveRepoKey, deriveRepoMemoryDir, deriveProjectMemoryDir, deriveProjectControlDir, recordProjectIdHint, lookupProjectIdHint, PROJECT_ID_HINTS_FILE, resolveMemoryEngineRoot, scopeDirFor, scopeDirName, scopeRegistryShape, layoutNeedsAdoption, adoptRootScopeLayout, v1MemoryPathKeyResolver, unresolvedProjectionDebts, scanFuseKey, enqueueMemoryAnnouncement, drainMemoryAnnouncements, peekMemoryAnnouncements, bumpScanFuse, scanFuseCount, clearScanFuse, ANNOUNCEMENTS_FILE, MEMORY_ANNOUNCEMENTS_MAX, SCAN_FUSE_FILE, SCAN_FUSE_THRESHOLD, LINEAGE_FILE, CHALLENGES_FILE, CHALLENGED_HISTORY_FILE, CHALLENGE_LEDGER_MAX_EVENTS, rebuildStrictControlPlaneLedger, SESSION_CAPTURE_OPTOUT_DIR, markSessionCaptureOptOut, readSessionCaptureOptOut, listSessionCaptureOptOut, fileSessionCaptureRecordStore, } from "./layout.js";
 export { readV2HeaderHints, isInstructionEntry } from "./header-hints.js";
 export { parseEntryFile, serializeEntryFile, computeEntryRev, entryFromFile, committedOriginOf, originEquals, ambiguousOriginRepresentation } from "./frontmatter.js";
 export { consolidationExposedFrontmatter } from "./frontmatter.js";
@@ -12,7 +12,7 @@ export { committedDistilledOf, distilledEquals } from "./frontmatter.js";
 export { CONSOLIDATION_DEFAULTS, ConsolidationRefusedError, MEMORY_SEARCH_SUPERSEDED_TAG, consolidationTypeEligible, deriveSupersededSet, memorySupersededNote, readIntentCredentials, supersessionFuseCeiling, CONSOLIDATION_RUN_STOP_REASONS, } from "./consolidation.js";
 export { DISTILLER_DEFAULT_MAX_INPUTS_PER_PRODUCT, LLM_DISTILLER_CONTRACT, LLM_DISTILLER_CONTRACT_DL2, LLM_DISTILLER_CONTRACT_DL3, LLM_DISTILLER_CONTRACTS, MEMORY_DISTILLER_CONTRACT_V1, contractGroupingDiff, driveConsolidationToFixpoint, isAliasModelId, llmPlanDistiller, mintExposurePartitionedPlan, mintLlmConsolidationPlan, MEMORY_DISTILLER_PURITY_CONTRACT_V1, detectCleanArmVerbatimLeak, openAiCompatChatSeat, parseJsonAnswer, planParseRepairs, sanitizeLlmGroups, scheduleUnderFuse, } from "./distiller.js";
 export { CONSOLIDATION_DRIVER_PLANS_DIR, CONSOLIDATION_DRIVER_RUNS_FILE, archiveDistillerPlan, readConsolidationDriverRun, runMemoryConsolidationDriver, } from "./consolidation-driver.js";
-export { MEMORY_ORIGIN_CAUSES } from "./types.js";
+export { MEMORY_ORIGIN_CAUSES, writableRootOf } from "./types.js";
 export { memoryBackendContract, assertMemoryBackendSearchEquivalence, } from "./memory-backend-contract.js";
 export { SCOPE_SEGMENT_MAX_ENCODED, PROJECT_MARKER_PATH, encodeScopeSegment, decodeScopeSegment, parseScopeKey, formatUserScope, formatOrgScope, formatProjScope, formatUserProjScope, isPersonalScope, assertScopeContractPlacement, formatProjectMarker, parseProjectMarker, resolveProjectId, PROJECT_ID_REGEX, } from "./scope-contract.js";
 export { migrateScope } from "./migrate.js";