@x12i/memorix-service 0.0.0-bootstrap.0

package/dist/isolation.js

@@ -0,0 +1,175 @@
+/**
+ * Database isolation guard for G10/G11/G12 acceptance.
+ * Org patterns: g10ops*|g11ops*|g12ops* — never neo/fieldstone/prior orgs.
+ * Cleanup may only drop DBs recorded in this run's creation ledger.
+ */
+import { randomBytes } from "node:crypto";
+import { databaseNameFor } from "@x12i/memorix-data";
+export const G10_ORG_PREFIX = "g10ops";
+export const G11_ORG_PREFIX = "g11ops";
+export const G12_ORG_PREFIX = "g12ops";
+export const G10_ORG_PATTERN = /^g10ops[a-z0-9]+$/;
+export const G11_ORG_PATTERN = /^g11ops[a-z0-9]+$/;
+export const G12_ORG_PATTERN = /^g12ops[a-z0-9]+$/;
+export const ACCEPTANCE_ORG_PATTERN = /^g1[012]ops[a-z0-9]+$/;
+export const FORBIDDEN_ORG_SUBSTRINGS = ["neo", "fieldstone"];
+export class IsolationError extends Error {
+    code = "DB_ISOLATION_VIOLATION";
+    constructor(message) {
+        super(message);
+        this.name = "IsolationError";
+    }
+}
+export function assertSafeG10OrgId(orgId) {
+    assertSafeAcceptanceOrgId(orgId, "g10");
+}
+export function assertSafeG11OrgId(orgId) {
+    assertSafeAcceptanceOrgId(orgId, "g11");
+}
+export function assertSafeG12OrgId(orgId) {
+    assertSafeAcceptanceOrgId(orgId, "g12");
+}
+export function assertSafeAcceptanceOrgId(orgId, gate = "any") {
+    const pattern = gate === "g10"
+        ? G10_ORG_PATTERN
+        : gate === "g11"
+            ? G11_ORG_PATTERN
+            : gate === "g12"
+                ? G12_ORG_PATTERN
+                : ACCEPTANCE_ORG_PATTERN;
+    if (!pattern.test(orgId)) {
+        throw new IsolationError(`orgId must match ${pattern}: got ${JSON.stringify(orgId)}`);
+    }
+    const lower = orgId.toLowerCase();
+    for (const bad of FORBIDDEN_ORG_SUBSTRINGS) {
+        if (lower.includes(bad)) {
+            throw new IsolationError(`orgId must not contain forbidden token "${bad}"`);
+        }
+    }
+    if (orgId === "neo" || orgId === "fieldstone") {
+        throw new IsolationError(`forbidden orgId ${orgId}`);
+    }
+}
+export function generateG10OrgId(token) {
+    return generateAcceptanceOrgId("g10ops", token);
+}
+export function generateG11OrgId(token) {
+    return generateAcceptanceOrgId("g11ops", token);
+}
+export function generateG12OrgId(token) {
+    return generateAcceptanceOrgId("g12ops", token);
+}
+function generateAcceptanceOrgId(prefix, token) {
+    const t = (token ?? randomBytes(6).toString("hex")).toLowerCase().replace(/[^a-z0-9]/g, "");
+    const orgId = `${prefix}${t}`;
+    const gate = prefix === "g10ops" ? "g10" : prefix === "g11ops" ? "g11" : "g12";
+    assertSafeAcceptanceOrgId(orgId, gate);
+    return orgId;
+}
+export function allowedDatabasesForOrg(orgId) {
+    assertSafeAcceptanceOrgId(orgId);
+    return [
+        databaseNameFor(orgId, "entity"),
+        databaseNameFor(orgId, "event"),
+        databaseNameFor(orgId, "knowledge"),
+        databaseNameFor(orgId, "operational"),
+        `${orgId}_metadata`,
+    ];
+}
+/** Read-only list of DB names that already exist for this org prefix. */
+export async function preflightOrgDatabases(client, orgId) {
+    assertSafeAcceptanceOrgId(orgId);
+    const allowed = new Set(allowedDatabasesForOrg(orgId));
+    const admin = client.db().admin();
+    const { databases } = await admin.listDatabases();
+    const existing = databases
+        .map((d) => d.name)
+        .filter((name) => allowed.has(name) || name.startsWith(`${orgId}_`));
+    return { existing, conflict: existing.length > 0 };
+}
+export async function beginIsolationSession(client, opts) {
+    const max = opts?.maxAttempts ?? 8;
+    const prefix = opts?.prefix ?? "g10ops";
+    for (let i = 0; i < max; i++) {
+        const token = opts?.token && i === 0 ? opts.token : undefined;
+        const orgId = prefix === "g12ops"
+            ? generateG12OrgId(token)
+            : prefix === "g11ops"
+                ? generateG11OrgId(token)
+                : generateG10OrgId(token);
+        const { existing, conflict } = await preflightOrgDatabases(client, orgId);
+        if (conflict)
+            continue;
+        const allowed = allowedDatabasesForOrg(orgId);
+        return {
+            orgId,
+            agentIds: ["ops"],
+            allowedDatabaseNames: allowed,
+            createdDatabaseNames: [],
+            preflightExisting: existing,
+            isolatedMetadataDb: `${orgId}_metadata`,
+            zeroPreexistingMutated: true,
+        };
+    }
+    throw new IsolationError(`could not allocate unused ${prefix} orgId after retries`);
+}
+export async function beginG11IsolationSession(client, opts) {
+    return beginIsolationSession(client, { ...opts, prefix: "g11ops" });
+}
+export async function beginG12IsolationSession(client, opts) {
+    return beginIsolationSession(client, { ...opts, prefix: "g12ops" });
+}
+export function recordCreatedDatabase(session, dbName) {
+    assertSafeAcceptanceOrgId(session.orgId);
+    if (!session.allowedDatabaseNames.includes(dbName)) {
+        throw new IsolationError(`cannot create database outside ledger allow-list: ${dbName}`);
+    }
+    if (!session.createdDatabaseNames.includes(dbName)) {
+        session.createdDatabaseNames.push(dbName);
+    }
+}
+/** Drop only DBs recorded in this session's creation ledger (collections then empty DB if permitted). */
+export async function cleanupIsolationSession(client, session) {
+    assertSafeAcceptanceOrgId(session.orgId);
+    const dropped = [];
+    for (const name of session.createdDatabaseNames) {
+        if (!name.startsWith(session.orgId + "_")) {
+            throw new IsolationError(`refusing drop outside org prefix: ${name}`);
+        }
+        if (!session.allowedDatabaseNames.includes(name)) {
+            throw new IsolationError(`refusing drop not on allow-list: ${name}`);
+        }
+        const db = client.db(name);
+        const cols = await db.collections();
+        for (const col of cols) {
+            try {
+                await col.drop();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        try {
+            await db.dropDatabase();
+        }
+        catch {
+            // Some deployments deny dropDatabase; collection drops above still clear run data.
+        }
+        dropped.push(name);
+    }
+    return dropped;
+}
+export function isolationEvidence(session, extra) {
+    return {
+        orgId: session.orgId,
+        agentIds: session.agentIds,
+        allowedDatabaseNames: session.allowedDatabaseNames,
+        preflightExisting: session.preflightExisting,
+        createdDatabaseNames: session.createdDatabaseNames,
+        cleanupTargets: [...session.createdDatabaseNames],
+        isolatedMetadataDb: session.isolatedMetadataDb,
+        zeroPreexistingMutated: session.zeroPreexistingMutated,
+        ...extra,
+    };
+}
+//# sourceMappingURL=isolation.js.map

package/dist/isolation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isolation.js","sourceRoot":"","sources":["../src/isolation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AAC9D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,YAAY,CAAU,CAAC;AAoBvE,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,GAAG,wBAAwB,CAAC;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,yBAAyB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,yBAAyB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,yBAAyB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAa,EACb,OAAsC,KAAK;IAE3C,MAAM,OAAO,GACX,IAAI,KAAK,KAAK;QACZ,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,IAAI,KAAK,KAAK;YACd,CAAC,CAAC,eAAe;YACjB,CAAC,CAAC,IAAI,KAAK,KAAK;gBACd,CAAC,CAAC,eAAe;gBACjB,CAAC,CAAC,sBAAsB,CAAC;IACjC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,cAAc,CACtB,oBAAoB,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAC5D,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,wBAAwB,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,cAAc,CAAC,2CAA2C,GAAG,GAAG,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IACD,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;QAC9C,MAAM,IAAI,cAAc,CAAC,mBAAmB,KAAK,EAAE,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,uBAAuB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,uBAAuB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,uBAAuB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,uBAAuB,CAC9B,MAAsC,EACtC,KAAc;IAEd,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC5F,MAAM,KAAK,GAAG,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/E,yBAAyB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO;QACL,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC;QAChC,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC;QAC/B,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC;QACnC,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC;QACrC,GAAG,KAAK,WAAW;KACpB,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAmB,EACnB,KAAa;IAEb,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC;IAClC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,KAAK,CAAC,aAAa,EAAE,CAAC;IAClD,MAAM,QAAQ,GAAG,SAAS;SACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;IACvE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAmB,EACnB,IAIC;IAED,MAAM,GAAG,GAAG,IAAI,EAAE,WAAW,IAAI,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,QAAQ,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,MAAM,KAAK,GACT,MAAM,KAAK,QAAQ;YACjB,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC;YACzB,CAAC,CAAC,MAAM,KAAK,QAAQ;gBACnB,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC;gBACzB,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC1E,IAAI,QAAQ;YAAE,SAAS;QACvB,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO;YACL,KAAK;YACL,QAAQ,EAAE,CAAC,KAAK,CAAC;YACjB,oBAAoB,EAAE,OAAO;YAC7B,oBAAoB,EAAE,EAAE;YACxB,iBAAiB,EAAE,QAAQ;YAC3B,kBAAkB,EAAE,GAAG,KAAK,WAAW;YACvC,sBAAsB,EAAE,IAAI;SAC7B,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,cAAc,CAAC,6BAA6B,MAAM,sBAAsB,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAmB,EACnB,IAA+C;IAE/C,OAAO,qBAAqB,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAmB,EACnB,IAA+C;IAE/C,OAAO,qBAAqB,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAyB,EAAE,MAAc;IAC7E,yBAAyB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,cAAc,CAAC,qDAAqD,MAAM,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,yGAAyG;AACzG,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAmB,EACnB,OAAyB;IAEzB,yBAAyB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,cAAc,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,cAAc,CAAC,oCAAoC,IAAI,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC;QACpC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC;QACD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,YAAY,EAAE,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,mFAAmF;QACrF,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAyB,EAAE,KAA+B;IAC1F,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;QAClD,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;QAClD,cAAc,EAAE,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC;QACjD,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;QACtD,GAAG,KAAK;KACT,CAAC;AACJ,CAAC"}

package/dist/known-packs.d.ts

@@ -0,0 +1,5 @@
+import type { MetadataPack } from "@x12i/memorix-metadata";
+/** Load a known disk pack (ops) for explicit install — never auto-installs. */
+export declare function loadKnownMetadataPack(packId: string): MetadataPack;
+export declare function listKnownPackIds(): string[];
+//# sourceMappingURL=known-packs.d.ts.map

package/dist/known-packs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-packs.d.ts","sourceRoot":"","sources":["../src/known-packs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAU3D,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAkBlE;AAED,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C"}

package/dist/known-packs.js

@@ -0,0 +1,26 @@
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { ServiceError } from "./errors.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const REPO_ROOT = resolve(__dirname, "../..");
+const KNOWN_PACKS = {
+    ops: resolve(REPO_ROOT, "memorix-metadata/examples/ops/normalized/pack.json"),
+};
+/** Load a known disk pack (ops) for explicit install — never auto-installs. */
+export function loadKnownMetadataPack(packId) {
+    const path = KNOWN_PACKS[packId];
+    if (!path) {
+        throw new ServiceError("UNKNOWN_PACK", `unknown packId "${packId}"; known: ${Object.keys(KNOWN_PACKS).join(", ")}`, 400);
+    }
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (err) {
+        throw new ServiceError("PACK_LOAD_FAILED", `failed to load pack ${packId}: ${err instanceof Error ? err.message : String(err)}`, 500);
+    }
+}
+export function listKnownPackIds() {
+    return Object.keys(KNOWN_PACKS);
+}
+//# sourceMappingURL=known-packs.js.map

package/dist/known-packs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-packs.js","sourceRoot":"","sources":["../src/known-packs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAE9C,MAAM,WAAW,GAA2B;IAC1C,GAAG,EAAE,OAAO,CAAC,SAAS,EAAE,oDAAoD,CAAC;CAC9E,CAAC;AAEF,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,YAAY,CACpB,cAAc,EACd,mBAAmB,MAAM,aAAa,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC3E,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAiB,CAAC;IAChE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,YAAY,CACpB,kBAAkB,EAClB,uBAAuB,MAAM,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EACpF,GAAG,CACJ,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAClC,CAAC"}

package/dist/mongo-metadata-store.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Durable MetadataStore adapter for production.
+ * Implements the accepted @x12i/memorix-metadata-runtime store contract
+ * against Mongo — does not invent new metadata semantics.
+ *
+ * Mutations update an in-process snapshot and enqueue durable flush.
+ * Platform must await hydrate() before serving traffic and drain() on close.
+ */
+import type { Db } from "mongodb";
+import type { MetadataStore } from "@x12i/memorix-metadata-runtime";
+export type DurableMetadataStore = MetadataStore & {
+    hydrate(): Promise<void>;
+    drain(): Promise<void>;
+    readonly durable: true;
+};
+export declare function createMongoMetadataStore(db: Db): DurableMetadataStore;
+//# sourceMappingURL=mongo-metadata-store.d.ts.map

package/dist/mongo-metadata-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-metadata-store.d.ts","sourceRoot":"","sources":["../src/mongo-metadata-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,EAEV,aAAa,EAEd,MAAM,gCAAgC,CAAC;AAcxC,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IACjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;CACxB,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,EAAE,GAAG,oBAAoB,CAuFrE"}

package/dist/mongo-metadata-store.js

@@ -0,0 +1,81 @@
+import { createInMemoryMetadataStore } from "@x12i/memorix-metadata-runtime";
+const AGENTS = "memorix_metadata_agents";
+const LEDGER = "memorix_metadata_install_ledger";
+export function createMongoMetadataStore(db) {
+    const memory = createInMemoryMetadataStore();
+    let pendingFlush = Promise.resolve();
+    async function flush() {
+        const agentIds = memory.listAgentIds();
+        const bulkAgents = db.collection(AGENTS);
+        await bulkAgents.deleteMany({});
+        if (agentIds.length) {
+            await bulkAgents.insertMany(agentIds.map((agentId) => {
+                const pack = memory.getAgentPack(agentId);
+                return {
+                    _id: agentId,
+                    checksum: pack.checksum,
+                    definitions: pack.definitions,
+                };
+            }));
+        }
+        const ledger = memory.getLedger();
+        const bulkLedger = db.collection(LEDGER);
+        await bulkLedger.deleteMany({});
+        if (ledger.length) {
+            await bulkLedger.insertMany(ledger.map((e) => ({ ...e })));
+        }
+    }
+    function enqueueFlush() {
+        pendingFlush = pendingFlush.then(flush, flush);
+    }
+    const api = {
+        durable: true,
+        listAgentIds() {
+            return memory.listAgentIds();
+        },
+        getAgentPack(agentId) {
+            return memory.getAgentPack(agentId);
+        },
+        replaceAgentPack(agentId, checksum, definitions, installedAt) {
+            memory.replaceAgentPack(agentId, checksum, definitions, installedAt);
+            enqueueFlush();
+        },
+        getLedger() {
+            return memory.getLedger();
+        },
+        appendLedger(entry) {
+            memory.appendLedger(entry);
+            enqueueFlush();
+        },
+        clone() {
+            return memory.clone();
+        },
+        commitFrom(other) {
+            memory.commitFrom(other);
+            enqueueFlush();
+        },
+        async hydrate() {
+            const agentDocs = await db.collection(AGENTS).find({}).toArray();
+            const ledgerDocs = await db
+                .collection(LEDGER)
+                .find({})
+                .sort({ installedAt: 1 })
+                .toArray();
+            const scratch = createInMemoryMetadataStore();
+            for (const doc of agentDocs) {
+                scratch.replaceAgentPack(doc._id, doc.checksum, doc.definitions, new Date(0).toISOString());
+            }
+            for (const entry of ledgerDocs) {
+                const { _id: _omit, ...rest } = entry;
+                scratch.appendLedger(rest);
+            }
+            // commit without enqueue — hydrate is loading truth
+            memory.commitFrom(scratch);
+        },
+        async drain() {
+            await pendingFlush;
+        },
+    };
+    return api;
+}
+//# sourceMappingURL=mongo-metadata-store.js.map

package/dist/mongo-metadata-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-metadata-store.js","sourceRoot":"","sources":["../src/mongo-metadata-store.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE7E,MAAM,MAAM,GAAG,yBAAyB,CAAC;AACzC,MAAM,MAAM,GAAG,iCAAiC,CAAC;AAgBjD,MAAM,UAAU,wBAAwB,CAAC,EAAM;IAC7C,MAAM,MAAM,GAAG,2BAA2B,EAAE,CAAC;IAC7C,IAAI,YAAY,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEpD,KAAK,UAAU,KAAK;QAClB,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,EAAE,CAAC,UAAU,CAAW,MAAM,CAAC,CAAC;QACnD,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,UAAU,CAAC,UAAU,CACzB,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;gBACvB,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAE,CAAC;gBAC3C,OAAO;oBACL,GAAG,EAAE,OAAO;oBACZ,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,WAAW,EAAE,IAAI,CAAC,WAAW;iBAC9B,CAAC;YACJ,CAAC,CAAC,CACH,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QAClC,MAAM,UAAU,GAAG,EAAE,CAAC,UAAU,CAAY,MAAM,CAAC,CAAC;QACpD,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,SAAS,YAAY;QACnB,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,GAAG,GAAyB;QAChC,OAAO,EAAE,IAAI;QACb,YAAY;YACV,OAAO,MAAM,CAAC,YAAY,EAAE,CAAC;QAC/B,CAAC;QACD,YAAY,CAAC,OAAO;YAClB,OAAO,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW;YAC1D,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;YACrE,YAAY,EAAE,CAAC;QACjB,CAAC;QACD,SAAS;YACP,OAAO,MAAM,CAAC,SAAS,EAAE,CAAC;QAC5B,CAAC;QACD,YAAY,CAAC,KAAK;YAChB,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAC3B,YAAY,EAAE,CAAC;QACjB,CAAC;QACD,KAAK;YACH,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QACD,UAAU,CAAC,KAAK;YACd,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACzB,YAAY,EAAE,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,OAAO;YACX,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,UAAU,CAAW,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YAC3E,MAAM,UAAU,GAAG,MAAM,EAAE;iBACxB,UAAU,CAAY,MAAM,CAAC;iBAC7B,IAAI,CAAC,EAAE,CAAC;iBACR,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;iBACxB,OAAO,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,2BAA2B,EAAE,CAAC;YAC9C,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;gBAC5B,OAAO,CAAC,gBAAgB,CACtB,GAAG,CAAC,GAAG,EACP,GAAG,CAAC,QAAQ,EACZ,GAAG,CAAC,WAAW,EACf,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAC1B,CAAC;YACJ,CAAC;YACD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;gBAC/B,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;gBACtC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;YACD,oDAAoD;YACpD,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,YAAY,CAAC;QACrB,CAAC;KACF,CAAC;IAEF,OAAO,GAAG,CAAC;AACb,CAAC"}