@x12i/memorix-package-seed 1.0.0

package/dist/ensure-seeded.js

@@ -0,0 +1,335 @@
+import { getMemorixMetadataDatabaseName } from "@x12i/memorix-db-router";
+import { ensurePackageSeedCatalogs, openPackageSeedCatalox, } from "./catalox.js";
+import { PLATFORM_CORE_PACKAGE_ID } from "./constants.js";
+import { MemorixPackageSeedError } from "./errors.js";
+import { ledgerItemId } from "./hash.js";
+import { buildLedgerItem, deleteLedgerItem, readLedgerItem, writeLedgerItem, } from "./ledger.js";
+import { acquireSeedLease } from "./lease.js";
+import { loadManifestFromDir } from "./manifest.js";
+import { resolvePlaneWriter } from "./writers/registry.js";
+function aggregateOutcome(targets) {
+    if (targets.some((t) => t.outcome === "failed"))
+        return "failed";
+    if (targets.some((t) => t.outcome === "conflict"))
+        return "conflict";
+    if (targets.some((t) => t.outcome === "applied"))
+        return "applied";
+    return "skipped";
+}
+async function applyPlanes(loaded, ctx) {
+    const reports = [];
+    for (const plane of loaded.planes) {
+        await ctx.checkFence();
+        const writer = resolvePlaneWriter(plane.kind, plane.catalogId);
+        const result = await writer(ctx, plane.items, {
+            ...plane.options,
+            catalogId: plane.catalogId,
+        });
+        reports.push({
+            kind: plane.kind,
+            catalogId: plane.catalogId,
+            itemCount: result.itemCount,
+            upserted: result.upserted,
+            skipped: result.skipped,
+        });
+    }
+    return reports;
+}
+async function applyToTarget(loaded, targetAgentId, options) {
+    const databaseName = getMemorixMetadataDatabaseName(targetAgentId);
+    let closeOwned = null;
+    try {
+        if (!options.skipPlatformCore && options.ensurePlatformCore) {
+            const core = await options.ensurePlatformCore(targetAgentId);
+            if (core &&
+                (core.outcome === "failed" || core.outcome === "conflict")) {
+                throw new MemorixPackageSeedError({
+                    code: "CORE_BOOTSTRAP_FAILED",
+                    message: `Platform core bootstrap ${core.outcome} for ${targetAgentId}`,
+                    field: "platform-core",
+                    value: core.outcome,
+                });
+            }
+        }
+        const opened = await openPackageSeedCatalox({
+            agentId: targetAgentId,
+            processEnv: options.processEnv,
+            mongoUri: options.mongoUri,
+            appId: options.appId,
+        });
+        closeOwned = opened.close;
+        await ensurePackageSeedCatalogs(opened.catalox);
+        const leaseKey = ledgerItemId(loaded.identity.packageId, targetAgentId);
+        const lease = await acquireSeedLease(opened.mongoDb, leaseKey);
+        try {
+            const existing = await readLedgerItem(opened.catalox, loaded.identity.packageId, targetAgentId);
+            if (options.mode === "strict" &&
+                existing?.status === "applied" &&
+                existing.contentHash === loaded.contentHash) {
+                return {
+                    targetAgentId,
+                    databaseName,
+                    outcome: "skipped",
+                    reasonCode: "SAME_CONTENT_HASH",
+                    message: "Ledger contentHash matches; zero-write skip",
+                    planes: existing.planes,
+                };
+            }
+            if (options.mode === "strict" &&
+                existing?.status === "applied" &&
+                existing.contentHash !== loaded.contentHash) {
+                return {
+                    targetAgentId,
+                    databaseName,
+                    outcome: "conflict",
+                    reasonCode: existing.seedRevision === loaded.manifest.seedRevision
+                        ? "REVISION_NOT_BUMPED"
+                        : "CONTENT_HASH_MISMATCH",
+                    message: existing.seedRevision === loaded.manifest.seedRevision
+                        ? "Payload changed but seedRevision was not bumped"
+                        : "Applied seed content differs; use upgrade or force",
+                };
+            }
+            if (options.mode === "upgrade" &&
+                existing?.status === "applied" &&
+                existing.contentHash === loaded.contentHash) {
+                return {
+                    targetAgentId,
+                    databaseName,
+                    outcome: "skipped",
+                    reasonCode: "SAME_CONTENT_HASH",
+                    message: "Ledger contentHash matches; zero-write skip",
+                    planes: existing.planes,
+                };
+            }
+            if (options.mode === "upgrade" &&
+                existing?.status === "applied" &&
+                existing.seedRevision === loaded.manifest.seedRevision &&
+                existing.payloadHash !== loaded.payloadHash) {
+                return {
+                    targetAgentId,
+                    databaseName,
+                    outcome: "conflict",
+                    reasonCode: "REVISION_NOT_BUMPED",
+                    message: "Payload changed but seedRevision was not bumped",
+                };
+            }
+            if (options.mode === "upgrade" &&
+                existing?.status === "applied" &&
+                existing.seedRevision === loaded.manifest.seedRevision &&
+                existing.contentHash !== loaded.contentHash) {
+                return {
+                    targetAgentId,
+                    databaseName,
+                    outcome: "conflict",
+                    reasonCode: "REVISION_NOT_BUMPED",
+                    message: "upgrade requires a changed seedRevision",
+                };
+            }
+            const attempts = (existing?.attempts ?? 0) + 1;
+            await writeLedgerItem(opened.catalox, buildLedgerItem({
+                packageId: loaded.identity.packageId,
+                primaryAgentId: loaded.identity.agentId,
+                targetAgentId,
+                packageVersion: loaded.identity.packageVersion,
+                seedRevision: loaded.manifest.seedRevision,
+                payloadHash: loaded.payloadHash,
+                contentHash: loaded.contentHash,
+                status: "applying",
+                attempts,
+                appliedBy: options.actor,
+            }));
+            const planes = await applyPlanes(loaded, {
+                catalox: opened.catalox,
+                mongoDb: opened.mongoDb,
+                targetAgentId,
+                primaryAgentId: loaded.identity.agentId,
+                packageId: loaded.identity.packageId,
+                packageVersion: loaded.identity.packageVersion,
+                seedRevision: loaded.manifest.seedRevision,
+                mode: options.mode,
+                processEnv: options.processEnv,
+                appId: opened.appId,
+                abortSignal: lease.abortSignal,
+                checkFence: lease.checkFence,
+            });
+            await writeLedgerItem(opened.catalox, buildLedgerItem({
+                packageId: loaded.identity.packageId,
+                primaryAgentId: loaded.identity.agentId,
+                targetAgentId,
+                packageVersion: loaded.identity.packageVersion,
+                seedRevision: loaded.manifest.seedRevision,
+                payloadHash: loaded.payloadHash,
+                contentHash: loaded.contentHash,
+                status: "applied",
+                attempts,
+                appliedBy: options.actor,
+                planes,
+            }));
+            return {
+                targetAgentId,
+                databaseName,
+                outcome: "applied",
+                reasonCode: options.mode === "force" ? "FORCE_APPLIED" : "APPLIED",
+                planes,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const code = error instanceof MemorixPackageSeedError ? error.code : "APPLY_FAILED";
+            try {
+                const prior = await readLedgerItem(opened.catalox, loaded.identity.packageId, targetAgentId);
+                await writeLedgerItem(opened.catalox, buildLedgerItem({
+                    packageId: loaded.identity.packageId,
+                    primaryAgentId: loaded.identity.agentId,
+                    targetAgentId,
+                    packageVersion: loaded.identity.packageVersion,
+                    seedRevision: loaded.manifest.seedRevision,
+                    payloadHash: loaded.payloadHash,
+                    contentHash: loaded.contentHash,
+                    status: "failed",
+                    attempts: (prior?.attempts ?? 0) + 1,
+                    appliedBy: options.actor,
+                    lastError: { message, at: new Date().toISOString(), code },
+                }));
+            }
+            catch {
+                /* best effort */
+            }
+            return {
+                targetAgentId,
+                databaseName,
+                outcome: "failed",
+                reasonCode: code,
+                message,
+            };
+        }
+        finally {
+            await lease.release().catch(() => undefined);
+        }
+    }
+    finally {
+        if (closeOwned)
+            await closeOwned().catch(() => undefined);
+    }
+}
+export async function ensureSeeded(options) {
+    const processEnv = options.processEnv ?? process.env;
+    const mode = options.mode ?? "strict";
+    const actor = options.actor ?? "package-seed";
+    const loaded = loadManifestFromDir(options.seedsDir, {
+        identity: options.identity,
+    });
+    if (loaded.identity.packageId === PLATFORM_CORE_PACKAGE_ID &&
+        !options.skipPlatformCore) {
+        // core pack itself must not recurse
+        options = { ...options, skipPlatformCore: true };
+    }
+    const destinationIds = options.applyTargetAgentIds?.length
+        ? options.applyTargetAgentIds
+        : loaded.identity.targetAgentIds;
+    const targets = [];
+    for (const targetAgentId of destinationIds) {
+        targets.push(await applyToTarget(loaded, targetAgentId, {
+            ...options,
+            mode,
+            processEnv,
+            actor,
+        }));
+    }
+    return {
+        outcome: aggregateOutcome(targets),
+        packageId: loaded.identity.packageId,
+        primaryAgentId: loaded.identity.agentId,
+        contentHash: loaded.contentHash,
+        payloadHash: loaded.payloadHash,
+        seedRevision: loaded.manifest.seedRevision,
+        targets,
+    };
+}
+export function createPackageSeeder(defaults) {
+    let closed = false;
+    const ensure = async (override = {}) => {
+        if (closed) {
+            throw new MemorixPackageSeedError({
+                code: "APPLY_FAILED",
+                message: "Package seeder has been closed",
+            });
+        }
+        return ensureSeeded({ ...defaults, ...override });
+    };
+    const status = async (packageId, targetAgentId) => {
+        const loaded = loadManifestFromDir(defaults.seedsDir, {
+            identity: defaults.identity,
+        });
+        const pkg = packageId ?? loaded.identity.packageId;
+        const targets = targetAgentId
+            ? [targetAgentId]
+            : loaded.identity.targetAgentIds;
+        const out = [];
+        for (const id of targets) {
+            const opened = await openPackageSeedCatalox({
+                agentId: id,
+                processEnv: defaults.processEnv,
+                mongoUri: defaults.mongoUri,
+                appId: defaults.appId,
+            });
+            try {
+                await ensurePackageSeedCatalogs(opened.catalox);
+                out.push({
+                    targetAgentId: id,
+                    databaseName: opened.databaseName,
+                    ledger: await readLedgerItem(opened.catalox, pkg, id),
+                });
+            }
+            finally {
+                await opened.close();
+            }
+        }
+        return { targets: out };
+    };
+    const resetLedger = async (options) => {
+        const env = defaults.processEnv ?? process.env;
+        if (env.PACKAGE_SEED_ALLOW_RESET !== "1" || !options.yes) {
+            throw new MemorixPackageSeedError({
+                code: "RESET_NOT_ALLOWED",
+                message: "resetLedger requires PACKAGE_SEED_ALLOW_RESET=1 and yes: true",
+            });
+        }
+        if (!options.actor?.trim() || !options.reason?.trim()) {
+            throw new MemorixPackageSeedError({
+                code: "RESET_NOT_ALLOWED",
+                message: "resetLedger requires actor and reason",
+            });
+        }
+        const opened = await openPackageSeedCatalox({
+            agentId: options.targetAgentId,
+            processEnv: env,
+            mongoUri: defaults.mongoUri,
+            appId: defaults.appId,
+        });
+        try {
+            await ensurePackageSeedCatalogs(opened.catalox);
+            await deleteLedgerItem(opened.catalox, options.packageId, options.targetAgentId);
+            await opened.mongoDb
+                .collection("memorix-package-seed-leases")
+                .deleteOne({
+                _id: ledgerItemId(options.packageId, options.targetAgentId),
+            });
+        }
+        finally {
+            await opened.close();
+        }
+    };
+    const close = async () => {
+        closed = true;
+    };
+    return {
+        ensureSeeded: ensure,
+        status,
+        resetLedger,
+        close,
+        [Symbol.asyncDispose]: close,
+    };
+}
+//# sourceMappingURL=ensure-seeded.js.map

package/dist/ensure-seeded.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,13 @@
+import type { MemorixPackageSeedErrorCode } from "./types.js";
+export declare class MemorixPackageSeedError extends Error {
+    readonly code: MemorixPackageSeedErrorCode;
+    readonly field?: string;
+    readonly value?: unknown;
+    constructor(options: {
+        code: MemorixPackageSeedErrorCode;
+        message: string;
+        field?: string;
+        value?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAE9D,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,OAAO,EAAE;QACnB,IAAI,EAAE,2BAA2B,CAAC;QAClC,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAOF"}

package/dist/errors.js

@@ -0,0 +1,13 @@
+export class MemorixPackageSeedError extends Error {
+    code;
+    field;
+    value;
+    constructor(options) {
+        super(options.message);
+        this.name = "MemorixPackageSeedError";
+        this.code = options.code;
+        this.field = options.field;
+        this.value = options.value;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,IAAI,CAA8B;IAClC,KAAK,CAAU;IACf,KAAK,CAAW;IAEzB,YAAY,OAKX;QACC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;CACF"}

package/dist/hash.d.ts

@@ -0,0 +1,6 @@
+export declare function canonicalize(value: unknown): unknown;
+export declare function canonicalJson(value: unknown): string;
+export declare function sha256Hex(value: string | Buffer): string;
+export declare function hashCanonical(value: unknown): string;
+export declare function ledgerItemId(packageId: string, targetAgentId: string): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASpD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAI7E"}

package/dist/hash.js

@@ -0,0 +1,27 @@
+import { createHash } from "node:crypto";
+export function canonicalize(value) {
+    if (value === null || typeof value !== "object")
+        return value;
+    if (Array.isArray(value))
+        return value.map((item) => canonicalize(item));
+    const obj = value;
+    const out = {};
+    for (const key of Object.keys(obj).sort()) {
+        out[key] = canonicalize(obj[key]);
+    }
+    return out;
+}
+export function canonicalJson(value) {
+    return JSON.stringify(canonicalize(value));
+}
+export function sha256Hex(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+export function hashCanonical(value) {
+    return sha256Hex(canonicalJson(value));
+}
+export function ledgerItemId(packageId, targetAgentId) {
+    const enc = (s) => Buffer.from(s, "utf8").toString("base64url");
+    return `seed:v1:${enc(packageId)}:${enc(targetAgentId)}`;
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IACzE,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1C,GAAG,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAsB;IAC9C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,aAAqB;IACnE,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CACxB,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,WAAW,GAAG,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;AAC3D,CAAC"}

package/dist/identity.d.ts

@@ -0,0 +1,8 @@
+import type { PackageSeedIdentity } from "./types.js";
+export declare function uniqueSorted(values: string[]): string[];
+export declare function assertAgentId(agentId: string, field?: string): void;
+export declare function normalizeIdentity(identity: PackageSeedIdentity): Required<PackageSeedIdentity> & {
+    targetAgentIds: string[];
+};
+export declare function assertIdentitiesMatch(a: PackageSeedIdentity, b: PackageSeedIdentity, field: string): void;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEvD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,IAAI,CActE;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,mBAAmB,GAC5B,QAAQ,CAAC,mBAAmB,CAAC,GAAG;IAAE,cAAc,EAAE,MAAM,EAAE,CAAA;CAAE,CA2B9D;AAED,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,mBAAmB,EACtB,CAAC,EAAE,mBAAmB,EACtB,KAAK,EAAE,MAAM,GACZ,IAAI,CAcN"}

package/dist/identity.js

@@ -0,0 +1,60 @@
+import { getMemorixMetadataDatabaseName } from "@x12i/memorix-db-router";
+import { MemorixPackageSeedError } from "./errors.js";
+export function uniqueSorted(values) {
+    return [...new Set(values.map((v) => v.trim()).filter(Boolean))].sort();
+}
+export function assertAgentId(agentId, field = "agentId") {
+    try {
+        getMemorixMetadataDatabaseName(agentId);
+    }
+    catch (error) {
+        throw new MemorixPackageSeedError({
+            code: "INVALID_IDENTITY",
+            message: error instanceof Error
+                ? `Invalid ${field}: ${error.message}`
+                : `Invalid ${field}`,
+            field,
+            value: agentId,
+        });
+    }
+}
+export function normalizeIdentity(identity) {
+    if (!identity || typeof identity !== "object") {
+        throw new MemorixPackageSeedError({
+            code: "MISSING_IDENTITY",
+            message: "Package seed identity is required",
+        });
+    }
+    const packageId = identity.packageId?.trim();
+    const packageVersion = identity.packageVersion?.trim();
+    const agentId = identity.agentId?.trim();
+    if (!packageId || !packageVersion || !agentId) {
+        throw new MemorixPackageSeedError({
+            code: "MISSING_IDENTITY",
+            message: "identity.packageId, identity.packageVersion, and identity.agentId are required",
+        });
+    }
+    assertAgentId(agentId, "agentId");
+    const targetAgentIds = uniqueSorted(identity.targetAgentIds?.length ? identity.targetAgentIds : [agentId]);
+    if (!targetAgentIds.includes(agentId)) {
+        targetAgentIds.push(agentId);
+        targetAgentIds.sort();
+    }
+    for (const id of targetAgentIds)
+        assertAgentId(id, "targetAgentIds");
+    return { packageId, packageVersion, agentId, targetAgentIds };
+}
+export function assertIdentitiesMatch(a, b, field) {
+    const na = normalizeIdentity(a);
+    const nb = normalizeIdentity(b);
+    if (na.packageId !== nb.packageId ||
+        na.agentId !== nb.agentId ||
+        JSON.stringify(na.targetAgentIds) !== JSON.stringify(nb.targetAgentIds)) {
+        throw new MemorixPackageSeedError({
+            code: "IDENTITY_MISMATCH",
+            message: `Identity mismatch for ${field}`,
+            field,
+        });
+    }
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import { attachPlatformCoreBootstrap, ensurePlatformCoreSeeded, resolveDefaultPlatformCoreSeedsDir, setPlatformCoreSeedsDir } from "./platform-core.js";
+import { createPackageSeeder, ensureSeeded, type EnsureSeededOptions, type PackageSeeder } from "./ensure-seeded.js";
+import { ensurePackageSeedCatalogs, openPackageSeedCatalox } from "./catalox.js";
+import { loadManifestFromDir, loadPackageSeedJson, loadIdentityFromPackageJson } from "./manifest.js";
+import { registerCustomPlaneWriter, listBuiltinPlaneKinds } from "./writers/registry.js";
+import { MemorixPackageSeedError } from "./errors.js";
+import { PLATFORM_CORE_PACKAGE_ID, MEMORIX_PACKAGE_SEED_LEDGER_CATALOG, MEMORIX_PACKAGE_SEED_LEASES_COLLECTION, BUILTIN_PLANE_KINDS, NATIVE_CATALOG_ALLOWLIST } from "./constants.js";
+import { hashCanonical, ledgerItemId, canonicalize } from "./hash.js";
+import { normalizeIdentity, assertAgentId } from "./identity.js";
+export type { EnsureSeededResult, LoadedPackageSeed, MemorixPackageSeedMode, MemorixPackageSeedOutcome, PackageSeedIdentity, PackageSeedManifest, PackageSeedLedgerItem, PlaneWriteReport, TargetApplyReport, PlaneWriter, SeedApplyContext, } from "./types.js";
+export { MemorixPackageSeedError, createPackageSeeder, ensureSeeded, ensurePackageSeedCatalogs, openPackageSeedCatalox, loadManifestFromDir, loadPackageSeedJson, loadIdentityFromPackageJson, registerCustomPlaneWriter, listBuiltinPlaneKinds, ensurePlatformCoreSeeded, setPlatformCoreSeedsDir, resolveDefaultPlatformCoreSeedsDir, attachPlatformCoreBootstrap, PLATFORM_CORE_PACKAGE_ID, MEMORIX_PACKAGE_SEED_LEDGER_CATALOG, MEMORIX_PACKAGE_SEED_LEASES_COLLECTION, BUILTIN_PLANE_KINDS, NATIVE_CATALOG_ALLOWLIST, hashCanonical, ledgerItemId, canonicalize, normalizeIdentity, assertAgentId, };
+export type { EnsureSeededOptions, PackageSeeder };
+/** Startup helper for trusted package configuration only. */
+export declare function runPackageSeedOnStart(options: {
+    seedsDir: string;
+    identity?: import("./types.js").PackageSeedIdentity;
+    processEnv?: NodeJS.ProcessEnv;
+    mongoUri?: string;
+    appId?: string;
+}): Promise<import("./types.js").EnsureSeededResult | null>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,kCAAkC,EAClC,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EACL,wBAAwB,EACxB,mCAAmC,EACnC,sCAAsC,EACtC,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEjE,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,kCAAkC,EAClC,2BAA2B,EAC3B,wBAAwB,EACxB,mCAAmC,EACnC,sCAAsC,EACtC,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,aAAa,GACd,CAAC;AAEF,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,CAAC;AAEnD,6DAA6D;AAC7D,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,YAAY,EAAE,mBAAmB,CAAC;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAC,CAmC1D"}

package/dist/index.js

@@ -0,0 +1,45 @@
+import { attachPlatformCoreBootstrap, ensurePlatformCoreSeeded, resolveDefaultPlatformCoreSeedsDir, setPlatformCoreSeedsDir, } from "./platform-core.js";
+import { createPackageSeeder, ensureSeeded, } from "./ensure-seeded.js";
+import { ensurePackageSeedCatalogs, openPackageSeedCatalox, } from "./catalox.js";
+import { loadManifestFromDir, loadPackageSeedJson, loadIdentityFromPackageJson, } from "./manifest.js";
+import { registerCustomPlaneWriter, listBuiltinPlaneKinds } from "./writers/registry.js";
+import { MemorixPackageSeedError } from "./errors.js";
+import { PLATFORM_CORE_PACKAGE_ID, MEMORIX_PACKAGE_SEED_LEDGER_CATALOG, MEMORIX_PACKAGE_SEED_LEASES_COLLECTION, BUILTIN_PLANE_KINDS, NATIVE_CATALOG_ALLOWLIST, } from "./constants.js";
+import { hashCanonical, ledgerItemId, canonicalize } from "./hash.js";
+import { normalizeIdentity, assertAgentId } from "./identity.js";
+export { MemorixPackageSeedError, createPackageSeeder, ensureSeeded, ensurePackageSeedCatalogs, openPackageSeedCatalox, loadManifestFromDir, loadPackageSeedJson, loadIdentityFromPackageJson, registerCustomPlaneWriter, listBuiltinPlaneKinds, ensurePlatformCoreSeeded, setPlatformCoreSeedsDir, resolveDefaultPlatformCoreSeedsDir, attachPlatformCoreBootstrap, PLATFORM_CORE_PACKAGE_ID, MEMORIX_PACKAGE_SEED_LEDGER_CATALOG, MEMORIX_PACKAGE_SEED_LEASES_COLLECTION, BUILTIN_PLANE_KINDS, NATIVE_CATALOG_ALLOWLIST, hashCanonical, ledgerItemId, canonicalize, normalizeIdentity, assertAgentId, };
+/** Startup helper for trusted package configuration only. */
+export async function runPackageSeedOnStart(options) {
+    const env = options.processEnv ?? process.env;
+    if (env.PACKAGE_SEED_ON_START !== "1")
+        return null;
+    const modeRaw = (env.PACKAGE_SEED_MODE ?? "strict").trim();
+    const mode = modeRaw === "upgrade" || modeRaw === "force" || modeRaw === "strict"
+        ? modeRaw
+        : "strict";
+    const strict = env.PACKAGE_SEED_STRICT !== "0";
+    const seeder = createPackageSeeder(attachPlatformCoreBootstrap({
+        seedsDir: options.seedsDir,
+        identity: options.identity,
+        mode,
+        processEnv: env,
+        mongoUri: options.mongoUri,
+        appId: options.appId,
+    }));
+    try {
+        const result = await seeder.ensureSeeded();
+        if (strict &&
+            (result.outcome === "failed" || result.outcome === "conflict")) {
+            throw new MemorixPackageSeedError({
+                code: "APPLY_FAILED",
+                message: `Package seed on start ${result.outcome}`,
+                value: result.outcome,
+            });
+        }
+        return result;
+    }
+    finally {
+        await seeder.close();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,kCAAkC,EAClC,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,YAAY,GAGb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EACL,wBAAwB,EACxB,mCAAmC,EACnC,sCAAsC,EACtC,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAgBjE,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC3B,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,kCAAkC,EAClC,2BAA2B,EAC3B,wBAAwB,EACxB,mCAAmC,EACnC,sCAAsC,EACtC,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,aAAa,GACd,CAAC;AAIF,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAM3C;IACC,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IAC9C,IAAI,GAAG,CAAC,qBAAqB,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,iBAAiB,IAAI,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,MAAM,IAAI,GACR,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,QAAQ;QAClE,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,QAAQ,CAAC;IACf,MAAM,MAAM,GAAG,GAAG,CAAC,mBAAmB,KAAK,GAAG,CAAC;IAC/C,MAAM,MAAM,GAAG,mBAAmB,CAChC,2BAA2B,CAAC;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI;QACJ,UAAU,EAAE,GAAG;QACf,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CACH,CAAC;IACF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;QAC3C,IACE,MAAM;YACN,CAAC,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,UAAU,CAAC,EAC9D,CAAC;YACD,MAAM,IAAI,uBAAuB,CAAC;gBAChC,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,yBAAyB,MAAM,CAAC,OAAO,EAAE;gBAClD,KAAK,EAAE,MAAM,CAAC,OAAO;aACtB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/lease.d.ts

@@ -0,0 +1,17 @@
+import type { Db } from "mongodb";
+export type SeedLease = {
+    key: string;
+    owner: string;
+    fence: number;
+    release: () => Promise<void>;
+    heartbeat: () => Promise<boolean>;
+    checkFence: () => Promise<void>;
+    abortSignal: AbortSignal;
+    stop: () => void;
+};
+export declare function acquireSeedLease(db: Db, key: string, options?: {
+    ttlMs?: number;
+    waitMs?: number;
+    pollMs?: number;
+}): Promise<SeedLease>;
+//# sourceMappingURL=lease.d.ts.map

package/dist/lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease.d.ts","sourceRoot":"","sources":["../src/lease.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AASlC,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AASF,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,EAAE,EACN,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GACL,OAAO,CAAC,SAAS,CAAC,CA6HpB"}