@sema-agent/core 1.279.0

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

@@ -0,0 +1,269 @@
+import assert from "node:assert";
+import { computeEntryRev } from "./frontmatter.js";
+function entry(id, scope, slug, body, fm = {}) {
+    const e = { id, scope, slug, frontmatter: { ...fm }, body, rev: "" };
+    e.rev = computeEntryRev(e);
+    return e;
+}
+export async function memoryBackendContract(hooks) {
+    const cases = [];
+    const defer = (name, fn) => cases.push([name, fn]);
+    defer("add → listHeaders/getByIds visible; header carries name/description/type + positive size", async () => {
+        const b = await hooks.make();
+        const e = entry("id-alpha-001", "s1", "alpha", "the alpha body", { name: "Alpha", description: "first", type: "project" });
+        const rep = await b.applyPatches([{ op: "add", id: e.id, entry: e }]);
+        assert.deepStrictEqual(rep.conflicts, []);
+        assert.deepStrictEqual(rep.applied, [{ op: "add", id: "id-alpha-001", slug: "alpha" }]);
+        const headers = await b.listHeaders(["s1"]);
+        assert.strictEqual(headers.length, 1);
+        assert.strictEqual(headers[0].id, "id-alpha-001");
+        assert.strictEqual(headers[0].name, "Alpha");
+        assert.strictEqual(headers[0].description, "first");
+        assert.strictEqual(headers[0].type, "project");
+        assert.ok(headers[0].sizeBytes > 0, "sizeBytes must be positive");
+        assert.strictEqual(headers[0].rev, e.rev);
+        const got = await b.getByIds(["id-alpha-001"]);
+        assert.strictEqual(got.length, 1);
+        assert.strictEqual(got[0].body.replace(/\s+$/, ""), "the alpha body");
+    });
+    defer("listHeaders excludes other scopes; empty scopes → empty", async () => {
+        const b = await hooks.make();
+        await b.applyPatches([
+            { op: "add", id: "id-scope1-01", entry: entry("id-scope1-01", "s1", "one", "b1") },
+            { op: "add", id: "id-scope2-01", entry: entry("id-scope2-01", "s2", "two", "b2") },
+        ]);
+        assert.deepStrictEqual((await b.listHeaders(["s1"])).map((h) => h.id), ["id-scope1-01"]);
+        assert.strictEqual((await b.listHeaders([])).length, 0);
+        assert.strictEqual((await b.listHeaders(["nope"])).length, 0);
+    });
+    defer("getByIds silently skips unknown ids", async () => {
+        const b = await hooks.make();
+        await b.applyPatches([{ op: "add", id: "id-known-01", entry: entry("id-known-01", "s1", "known", "kb") }]);
+        const got = await b.getByIds(["id-known-01", "id-ghost-404"]);
+        assert.deepStrictEqual(got.map((e2) => e2.id), ["id-known-01"]);
+    });
+    defer("update with the CURRENT baseRev wins and advances rev", async () => {
+        const b = await hooks.make();
+        const v1 = entry("id-update-01", "s1", "note", "v1");
+        await b.applyPatches([{ op: "add", id: v1.id, entry: v1 }]);
+        const v2 = entry("id-update-01", "s1", "note", "v2");
+        const rep = await b.applyPatches([{ op: "update", id: "id-update-01", entry: v2, baseRev: v1.rev }]);
+        assert.deepStrictEqual(rep.conflicts, []);
+        assert.deepStrictEqual(rep.applied, [{ op: "update", id: "id-update-01", slug: "note" }]);
+        const got = await b.getByIds(["id-update-01"]);
+        assert.strictEqual(got[0].body.replace(/\s+$/, ""), "v2");
+        assert.strictEqual(got[0].rev, v2.rev);
+        assert.notStrictEqual(got[0].rev, v1.rev);
+    });
+    defer("update with a STALE baseRev is a reported conflict (never thrown, never blind-written)", async () => {
+        const b = await hooks.make();
+        const v1 = entry("id-cas-0001", "s1", "note", "v1");
+        await b.applyPatches([{ op: "add", id: v1.id, entry: v1 }]);
+        const v2 = entry("id-cas-0001", "s1", "note", "v2");
+        await b.applyPatches([{ op: "update", id: "id-cas-0001", entry: v2, baseRev: v1.rev }]);
+        const v3 = entry("id-cas-0001", "s1", "note", "v3-from-a-stale-reader");
+        const rep = await b.applyPatches([{ op: "update", id: "id-cas-0001", entry: v3, baseRev: v1.rev }]);
+        assert.strictEqual(rep.applied.length, 0);
+        assert.strictEqual(rep.conflicts.length, 1);
+        assert.strictEqual(rep.conflicts[0].id, "id-cas-0001");
+        assert.strictEqual(rep.conflicts[0].baseRev, v1.rev);
+        assert.strictEqual(rep.conflicts[0].currentRev, v2.rev);
+        const got = await b.getByIds(["id-cas-0001"]);
+        assert.strictEqual(got[0].body.replace(/\s+$/, ""), "v2", "the CAS winner's content must survive");
+    });
+    defer("delete removes the entry; unknown-id update/delete are conflicts", async () => {
+        const b = await hooks.make();
+        const e = entry("id-del-0001", "s1", "gone", "bye");
+        await b.applyPatches([{ op: "add", id: e.id, entry: e }]);
+        const rep = await b.applyPatches([{ op: "delete", id: "id-del-0001", baseRev: e.rev }]);
+        assert.deepStrictEqual(rep.applied, [{ op: "delete", id: "id-del-0001", slug: "gone" }]);
+        assert.strictEqual((await b.getByIds(["id-del-0001"])).length, 0);
+        const rep2 = await b.applyPatches([
+            { op: "update", id: "id-del-0001", entry: entry("id-del-0001", "s1", "gone", "zombie") },
+            { op: "delete", id: "id-never-404" },
+        ]);
+        assert.strictEqual(rep2.applied.length, 0);
+        assert.strictEqual(rep2.conflicts.length, 2);
+    });
+    defer("at most ONE non-delete op per id per batch — the later one conflicts", async () => {
+        const b = await hooks.make();
+        const a1 = entry("id-dup-0001", "s1", "one", "first");
+        const a2 = entry("id-dup-0001", "s1", "two", "second");
+        const rep = await b.applyPatches([
+            { op: "add", id: "id-dup-0001", entry: a1 },
+            { op: "add", id: "id-dup-0001", entry: a2 },
+        ]);
+        assert.strictEqual(rep.applied.length, 1);
+        assert.strictEqual(rep.conflicts.length, 1);
+        assert.match(rep.conflicts[0].reason, /duplicate id in batch/);
+    });
+    defer("add slug collision with a DIFFERENT id gets a deterministic -n suffix", async () => {
+        const b = await hooks.make();
+        await b.applyPatches([{ op: "add", id: "id-slugA-01", entry: entry("id-slugA-01", "s1", "taken", "a") }]);
+        const rep = await b.applyPatches([{ op: "add", id: "id-slugB-01", entry: entry("id-slugB-01", "s1", "taken", "b") }]);
+        assert.deepStrictEqual(rep.applied, [{ op: "add", id: "id-slugB-01", slug: "taken-2" }]);
+    });
+    defer("search: lexical floor — distance ∈ [0,2] ascending, zero-overlap excluded, limit honored", async () => {
+        const b = await hooks.make();
+        await b.applyPatches([
+            { op: "add", id: "id-hit-0001", entry: entry("id-hit-0001", "s1", "hit", "alpha beta gamma", { name: "alpha beta" }) },
+            { op: "add", id: "id-hit-0002", entry: entry("id-hit-0002", "s1", "half", "alpha zzz qqq") },
+            { op: "add", id: "id-miss-001", entry: entry("id-miss-001", "s1", "miss", "totally unrelated words") },
+        ]);
+        const hits = await b.search("alpha beta", ["s1"]);
+        assert.ok(hits.length >= 2, "both overlapping entries hit");
+        assert.strictEqual(hits[0].id, "id-hit-0001", "closest first");
+        assert.ok(!hits.some((h) => h.id === "id-miss-001"), "zero-overlap excluded");
+        for (const h of hits)
+            assert.ok(h.score >= 0 && h.score <= 2, `score in [0,2], got ${h.score}`);
+        for (let i = 1; i < hits.length; i++)
+            assert.ok(hits[i - 1].score <= hits[i].score, "ascending");
+        assert.strictEqual((await b.search("alpha beta", ["s1"], { limit: 1 })).length, 1);
+        assert.strictEqual((await b.search("", ["s1"])).length, 0, "empty query → empty");
+    });
+    defer("update MAY move an entry across scopes (old scope loses it, new scope gains it)", async () => {
+        const b = await hooks.make();
+        const v1 = entry("id-move-001", "s1", "mover", "in s1");
+        await b.applyPatches([{ op: "add", id: v1.id, entry: v1 }]);
+        const v2 = entry("id-move-001", "s2", "mover", "now in s2");
+        const rep = await b.applyPatches([{ op: "update", id: "id-move-001", entry: v2, baseRev: v1.rev }]);
+        assert.strictEqual(rep.conflicts.length, 0);
+        assert.strictEqual((await b.listHeaders(["s1"])).length, 0, "old scope must lose the entry");
+        assert.deepStrictEqual((await b.listHeaders(["s2"])).map((h) => h.id), ["id-move-001"]);
+    });
+    defer("same-scope re-add of an existing id is the idempotent overwrite (zero-copy re-write parity)", async () => {
+        const b = await hooks.make();
+        const v1 = entry("id-readd-01", "s1", "note", "first");
+        await b.applyPatches([{ op: "add", id: v1.id, entry: v1 }]);
+        const v2 = entry("id-readd-01", "s1", "note", "second");
+        const rep = await b.applyPatches([{ op: "add", id: v2.id, entry: v2 }]);
+        assert.deepStrictEqual(rep.applied, [{ op: "add", id: "id-readd-01", slug: "note" }]);
+        assert.strictEqual((await b.listHeaders(["s1"])).length, 1, "still ONE entry — overwrite, not duplicate");
+        assert.strictEqual((await b.getByIds(["id-readd-01"]))[0].body.replace(/\s+$/, ""), "second");
+    });
+    defer("cross-scope re-add of an existing id is REFUSED (an add never relocates; MOVE = update)", async () => {
+        const b = await hooks.make();
+        const v1 = entry("id-xadd-001", "s1", "home", "original");
+        await b.applyPatches([{ op: "add", id: v1.id, entry: v1 }]);
+        const v2 = entry("id-xadd-001", "s2", "away", "smuggled copy");
+        const rep = await b.applyPatches([{ op: "add", id: v2.id, entry: v2 }]);
+        assert.strictEqual(rep.applied.length, 0, "a cross-scope add applies nothing");
+        assert.strictEqual(rep.conflicts.length, 1);
+        assert.strictEqual(rep.conflicts[0].id, "id-xadd-001");
+        assert.match(rep.conflicts[0].reason, /cross-scope add refused/);
+        assert.deepStrictEqual((await b.listHeaders(["s1"])).map((h) => h.id), ["id-xadd-001"], "the entry stays home");
+        assert.strictEqual((await b.listHeaders(["s2"])).length, 0, "no second projection in the target scope");
+        assert.strictEqual((await b.getByIds(["id-xadd-001"])).length, 1, "one id ⇒ one row, everywhere");
+    });
+    defer("add guard:'absent' — idempotent onto same rev, REPORTED conflict onto a different rev (never blind-overwrites)", async () => {
+        const b = await hooks.make();
+        const v1 = entry("id-guard-01", "s1", "note", "first");
+        await b.applyPatches([{ op: "add", id: v1.id, entry: v1 }]);
+        const same = entry("id-guard-01", "s1", "note", "first");
+        const repSame = await b.applyPatches([{ op: "add", id: same.id, entry: same, guard: "absent" }]);
+        assert.deepStrictEqual(repSame.conflicts, [], "guarded re-add at the SAME rev is idempotent, not a conflict");
+        assert.deepStrictEqual(repSame.applied, [{ op: "add", id: "id-guard-01", slug: "note" }]);
+        const diff = entry("id-guard-01", "s1", "note", "an intruding different body");
+        const repDiff = await b.applyPatches([{ op: "add", id: diff.id, entry: diff, guard: "absent" }]);
+        assert.strictEqual(repDiff.applied.length, 0, "guarded add onto a different rev applies nothing");
+        assert.strictEqual(repDiff.conflicts.length, 1);
+        assert.strictEqual(repDiff.conflicts[0].id, "id-guard-01");
+        assert.match(repDiff.conflicts[0].reason, /add_guard_absent_conflict/);
+        assert.strictEqual(repDiff.conflicts[0].currentRev, v1.rev, "the current rev is reported for the §3 ladder");
+        assert.strictEqual((await b.getByIds(["id-guard-01"]))[0].body.replace(/\s+$/, ""), "first", "the existing content must NOT be overwritten");
+        const fresh = entry("id-guard-02", "s1", "fresh", "brand new");
+        const repFresh = await b.applyPatches([{ op: "add", id: fresh.id, entry: fresh, guard: "absent" }]);
+        assert.deepStrictEqual(repFresh.conflicts, []);
+        assert.deepStrictEqual(repFresh.applied, [{ op: "add", id: "id-guard-02", slug: "fresh" }]);
+    });
+    defer("getByIds with duplicate ids returns each entry once; search limit:0 and fractional limit<1 → empty", async () => {
+        const b = await hooks.make();
+        await b.applyPatches([{ op: "add", id: "id-once-001", entry: entry("id-once-001", "s1", "once", "alpha body") }]);
+        assert.deepStrictEqual((await b.getByIds(["id-once-001", "id-once-001"])).map((e2) => e2.id), ["id-once-001"]);
+        assert.deepStrictEqual(await b.search("alpha", ["s1"], { limit: 0 }), []);
+        assert.deepStrictEqual(await b.search("alpha", ["s1"], { limit: 0.5 }), []);
+    });
+    defer("a patch whose entry.id differs from patch.id is refused as malformed (both ops)", async () => {
+        const b = await hooks.make();
+        const good = entry("id-good-001", "s1", "good", "gb");
+        await b.applyPatches([{ op: "add", id: good.id, entry: good }]);
+        const impostor = entry("id-impostor1", "s1", "good", "impostor");
+        const rep = await b.applyPatches([
+            { op: "add", id: "id-other-001", entry: impostor },
+            { op: "update", id: "id-good-001", entry: entry("id-impostor2", "s1", "good", "x"), baseRev: good.rev },
+        ]);
+        assert.strictEqual(rep.applied.length, 0);
+        assert.strictEqual(rep.conflicts.length, 2);
+        for (const c of rep.conflicts)
+            assert.match(c.reason, /malformed patch refused/);
+        assert.strictEqual((await b.getByIds(["id-good-001"]))[0].body.replace(/\s+$/, ""), "gb", "nothing was written");
+    });
+    defer("search: tied scores order deterministically by id (no arrival-order accident)", async () => {
+        const b = await hooks.make();
+        await b.applyPatches([
+            { op: "add", id: "id-tie-b-01", entry: entry("id-tie-b-01", "s1", "tie-b", "same words here") },
+            { op: "add", id: "id-tie-a-01", entry: entry("id-tie-a-01", "s1", "tie-a", "same words here") },
+        ]);
+        const hits = await b.search("same words", ["s1"]);
+        assert.deepStrictEqual(hits.map((h) => h.id), ["id-tie-a-01", "id-tie-b-01"]);
+    });
+    defer("consolidation cursor round-trips per scope; unset → undefined", async () => {
+        const b = await hooks.make();
+        assert.strictEqual(await b.getConsolidationCursor("s1"), undefined);
+        await b.setConsolidationCursor("s1", "c-1");
+        await b.setConsolidationCursor("s2", "c-other");
+        assert.strictEqual(await b.getConsolidationCursor("s1"), "c-1");
+        await b.setConsolidationCursor("s1", "c-2");
+        assert.strictEqual(await b.getConsolidationCursor("s1"), "c-2");
+        assert.strictEqual(await b.getConsolidationCursor("s2"), "c-other");
+    });
+    if (!hooks.makeSibling) {
+        const reason = hooks.skipCrossInstanceCas?.trim();
+        if (reason) {
+            defer(`cross-instance CAS: SKIPPED (declared) — ${reason}`, async () => { });
+        }
+        else {
+            defer("cross-instance CAS: MISSING makeSibling (the baseRev moat axis was not exercised)", async () => {
+                throw new Error("memoryBackendContract: no `makeSibling` hook and no `skipCrossInstanceCas` reason — " +
+                    "provide `makeSibling` (required for authoritative-backend certification, design/142 §6.1(a)), " +
+                    "or declare `skipCrossInstanceCas: \"<why this store has no shared-storage second instance>\"` for a loud skip.");
+            });
+        }
+    }
+    if (hooks.makeSibling) {
+        defer("cross-instance CAS: a second instance over the SAME storage sees committed revs (one wins, one conflicts)", async () => {
+            const a = await hooks.make();
+            const bSib = await hooks.makeSibling(a);
+            const v1 = entry("id-xinst-01", "s1", "shared", "v1");
+            await a.applyPatches([{ op: "add", id: v1.id, entry: v1 }]);
+            const v2 = entry("id-xinst-01", "s1", "shared", "v2-by-a");
+            const repA = await a.applyPatches([{ op: "update", id: "id-xinst-01", entry: v2, baseRev: v1.rev }]);
+            assert.strictEqual(repA.conflicts.length, 0);
+            const v2b = entry("id-xinst-01", "s1", "shared", "v2-by-b");
+            const repB = await bSib.applyPatches([{ op: "update", id: "id-xinst-01", entry: v2b, baseRev: v1.rev }]);
+            assert.strictEqual(repB.applied.length, 0);
+            assert.strictEqual(repB.conflicts.length, 1);
+            assert.strictEqual(repB.conflicts[0].currentRev, v2.rev);
+        });
+    }
+    const run = hooks.runAssertion ?? (async (_name, fn) => fn());
+    for (const [name, fn] of cases)
+        await run(name, fn);
+}
+export async function assertMemoryBackendSearchEquivalence(a, b) {
+    const fixture = [
+        entry("id-eq-0001", "s1", "notes-alpha", "alpha beta gamma delta", { name: "Alpha notes", description: "about alpha" }),
+        entry("id-eq-0002", "s1", "notes-beta", "beta epsilon zeta", { name: "Beta notes" }),
+        entry("id-eq-0003", "s1", "unrelated", "completely different content here"),
+    ];
+    for (const backend of [a, b]) {
+        const rep = await backend.applyPatches(fixture.map((e) => ({ op: "add", id: e.id, entry: e })));
+        assert.strictEqual(rep.conflicts.length, 0);
+    }
+    for (const q of ["alpha beta", "epsilon", "different content", "beta"]) {
+        const pa = (await a.search(q, ["s1"])).map((h) => ({ id: h.id, slug: h.slug, score: h.score }));
+        const pb = (await b.search(q, ["s1"])).map((h) => ({ id: h.id, slug: h.slug, score: h.score }));
+        assert.deepStrictEqual(pa, pb, `search("${q}") diverged between backends`);
+    }
+}
+//# sourceMappingURL=memory-backend-contract.js.map

package/dist/core/memory-engine/memory-backend-contract.js.map

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

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

@@ -0,0 +1,8 @@
+import type { MemoryBackend, PatchReport } from "./types.js";
+export interface MigrateScopeReport {
+    moved: number;
+    conflicts: PatchReport["conflicts"];
+    cursorMoved: boolean;
+}
+export declare function migrateScope(backend: MemoryBackend, fromScope: string, toScope: string): Promise<MigrateScopeReport>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/core/memory-engine/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/core/memory-engine/migrate.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IAEjC,KAAK,EAAE,MAAM,CAAC;IAEd,SAAS,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IAEpC,WAAW,EAAE,OAAO,CAAC;CACtB;AAQD,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmB1H"}

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

@@ -0,0 +1,23 @@
+import { computeEntryRev } from "./frontmatter.js";
+export async function migrateScope(backend, fromScope, toScope) {
+    if (fromScope === toScope)
+        throw new Error("migrateScope: fromScope and toScope are identical");
+    const headers = await backend.listHeaders([fromScope]);
+    const entries = await backend.getByIds(headers.map((h) => h.id));
+    const patches = entries
+        .filter((e) => e.scope === fromScope)
+        .map((e) => {
+        const moved = { ...e, scope: toScope };
+        moved.rev = computeEntryRev(moved);
+        return { op: "update", id: e.id, entry: moved, baseRev: e.rev };
+    });
+    const report = patches.length > 0 ? await backend.applyPatches(patches) : { applied: [], conflicts: [] };
+    let cursorMoved = false;
+    const cursor = await backend.getConsolidationCursor(fromScope);
+    if (cursor !== undefined) {
+        await backend.setConsolidationCursor(toScope, cursor);
+        cursorMoved = true;
+    }
+    return { moved: report.applied.length, conflicts: report.conflicts, cursorMoved };
+}
+//# sourceMappingURL=migrate.js.map

package/dist/core/memory-engine/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/core/memory-engine/migrate.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAkBnD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAsB,EAAE,SAAiB,EAAE,OAAe;IAC3F,IAAI,SAAS,KAAK,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IAChG,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,OAAO;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC;SACpC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,KAAK,GAAG,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QACvC,KAAK,CAAC,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO,EAAE,EAAE,EAAE,QAAiB,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;IAC3E,CAAC,CAAC,CAAC;IACL,MAAM,MAAM,GAAgB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACtH,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAC/D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,OAAO,CAAC,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtD,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC;AACpF,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { ScanFinding } from "./types.js";
+export declare const MEMORY_FILENAME_SEGMENT_RE: RegExp;
+export declare function scanMemoryFileName(relPath: string): ScanFinding | undefined;
+export declare function scanMemoryWrite(text: string, opts?: {
+    maxBytes?: number;
+}): ScanFinding[];
+export declare function scanRemediation(code: ScanFinding["code"]): string;
+//# sourceMappingURL=scan.d.ts.map

package/dist/core/memory-engine/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/core/memory-engine/scan.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,eAAO,MAAM,0BAA0B,QAAsB,CAAC;AAO9D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAW3E;AAOD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,WAAW,EAAE,CAwB7F;AAGD,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAWjE"}

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

@@ -0,0 +1,49 @@
+import { detectSecret, MEMORY_WRAPPER_TAGS } from "../memory.js";
+import { defuseFenceMarkers, sanitizeUntrustedText } from "../untrusted-text.js";
+export const MEMORY_FILENAME_SEGMENT_RE = /^[A-Za-z0-9._-]+$/;
+export function scanMemoryFileName(relPath) {
+    for (const segment of relPath.split("/")) {
+        if (segment === "")
+            continue;
+        if (!MEMORY_FILENAME_SEGMENT_RE.test(segment)) {
+            return {
+                code: "filename",
+                reason: `file name contains characters outside the memory whitelist (allowed: letters, digits, ".", "_", "-" per path segment)`,
+            };
+        }
+    }
+    return undefined;
+}
+export function scanMemoryWrite(text, opts = {}) {
+    const findings = [];
+    if (opts.maxBytes !== undefined) {
+        const size = Buffer.byteLength(text, "utf8");
+        if (size > opts.maxBytes) {
+            findings.push({ code: "too_large", reason: `${size} bytes — over the ${opts.maxBytes}-byte cap; split or trim it (rejected, NOT truncated)` });
+        }
+    }
+    const secretLabel = detectSecret(text);
+    if (secretLabel !== null) {
+        findings.push({ code: "secret", reason: `detected ${secretLabel}` });
+    }
+    if (sanitizeUntrustedText(text, [...MEMORY_WRAPPER_TAGS]) !== text) {
+        findings.push({ code: "injection", reason: "contains a framing break-out tag (<system-reminder>/<user_memory> family)" });
+    }
+    else if (/^[ \t]*(?:<{3,}|>{3,})/m.test(text) && defuseFenceMarkers(text) !== text) {
+        findings.push({ code: "injection", reason: "contains an untrusted-fence sentinel at line start (a run of 3+ '<' or '>')" });
+    }
+    return findings;
+}
+export function scanRemediation(code) {
+    switch (code) {
+        case "secret":
+            return "Remove the secret value — store a POINTER to where it lives (env var name, vault path) instead of the value itself.";
+        case "injection":
+            return "Remove the markup: memory files must not contain <system-reminder>/<user_memory> tags or runs of 3+ '<'/'>' (they would forge the injection framing when this memory is loaded).";
+        case "filename":
+            return 'Rename the file using only letters, digits, ".", "_" and "-" in each path segment.';
+        case "too_large":
+            return "Split the content into smaller topic files, or trim it.";
+    }
+}
+//# sourceMappingURL=scan.js.map

package/dist/core/memory-engine/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../../src/core/memory-engine/scan.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAIjF,MAAM,CAAC,MAAM,0BAA0B,GAAG,mBAAmB,CAAC;AAO9D,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,IAAI,OAAO,KAAK,EAAE;YAAE,SAAS;QAC7B,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9C,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,uHAAuH;aAChI,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAOD,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,OAA8B,EAAE;IAC5E,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7C,IAAI,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,qBAAqB,IAAI,CAAC,QAAQ,uDAAuD,EAAE,CAAC,CAAC;QACjJ,CAAC;IACH,CAAC;IACD,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,WAAW,EAAE,EAAE,CAAC,CAAC;IACvE,CAAC;IAGD,IAAI,qBAAqB,CAAC,IAAI,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,2EAA2E,EAAE,CAAC,CAAC;IAC5H,CAAC;SAAM,IAAI,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAKrF,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,6EAA6E,EAAE,CAAC,CAAC;IAC9H,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAGD,MAAM,UAAU,eAAe,CAAC,IAAyB;IACvD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,qHAAqH,CAAC;QAC/H,KAAK,WAAW;YACd,OAAO,kLAAkL,CAAC;QAC5L,KAAK,UAAU;YACb,OAAO,oFAAoF,CAAC;QAC9F,KAAK,WAAW;YACd,OAAO,yDAAyD,CAAC;IACrE,CAAC;AACH,CAAC"}

package/dist/core/memory-engine/scope-contract.d.ts

@@ -0,0 +1,44 @@
+export declare const SCOPE_SEGMENT_MAX_ENCODED = 64;
+export declare function encodeScopeSegment(raw: string): string;
+export declare function decodeScopeSegment(encoded: string): string;
+export type ParsedScopeKey = {
+    kind: "user";
+    principal: string;
+} | {
+    kind: "org";
+    tenant: string;
+} | {
+    kind: "proj";
+    tenant: string;
+    projectId: string;
+} | {
+    kind: "userproj";
+    principal: string;
+    projectId: string;
+} | {
+    kind: "legacy";
+    raw: string;
+};
+export declare function formatUserScope(principal: string): string;
+export declare function formatOrgScope(tenant: string): string;
+export declare function formatProjScope(tenant: string, projectId: string): string;
+export declare function formatUserProjScope(principal: string, projectId: string): string;
+export declare function parseScopeKey(key: string): ParsedScopeKey;
+export declare function isPersonalScope(parsed: ParsedScopeKey): boolean;
+export declare function isCentralAuthorityScope(parsed: ParsedScopeKey): boolean;
+export declare function assertScopeContractPlacement(args: {
+    parsedScopes: readonly ParsedScopeKey[];
+    memoryDir: string;
+    repoRoot: string | undefined;
+}): void;
+export declare const PROJECT_MARKER_PATH = ".sema/project";
+export declare const PROJECT_ID_REGEX: RegExp;
+export declare function formatProjectMarker(projectId: string): string;
+export declare function parseProjectMarker(body: string): {
+    projectId: string;
+} | null;
+export declare function resolveProjectId(rootDir: string): {
+    projectId: string;
+    markerDir: string;
+} | null;
+//# sourceMappingURL=scope-contract.d.ts.map

package/dist/core/memory-engine/scope-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-contract.d.ts","sourceRoot":"","sources":["../../../src/core/memory-engine/scope-contract.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAW5C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmBtD;AA0BD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA4B1D;AAMD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAE1D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AACD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAErD;AACD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzE;AACD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEhF;AAWD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAuBzD;AAGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAE/D;AAMD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAEvE;AASD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,YAAY,EAAE,SAAS,cAAc,EAAE,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,GAAG,IAAI,CAiBP;AAQD,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAKnD,eAAO,MAAM,gBAAgB,QAAoE,CAAC;AAIlG,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG7D;AAQD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAoB7E;AAuBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA4BjG"}