@x12i/memorix-package-seed 1.0.0

package/README.md

@@ -0,0 +1,114 @@
+# `@x12i/memorix-package-seed`
+
+Package-owned Catalox seeding with mandatory agent identity, multi-agent replication, platform-core bootstrap, validated plane writers, and an atomic once-only ledger.
+
+## Catalox database routing
+
+Seeding does **not** use `MEMORIX_AGENT_ID` / `MEMORIX_CATALOX_DB` for the destination database. The pack declares `identity.agentId` + `targetAgentIds`, and each destination is opened as:
+
+```ts
+import { getMemorixMetadataDatabaseName } from "@x12i/memorix-db-router";
+
+const dbName = getMemorixMetadataDatabaseName(agentId); // `<agentId>-memorix-catalox`
+```
+
+Shared env requirements: `MONGO_URI` and Memorix app id (`MEMORIX_APP_ID` / descriptors resolution).
+
+## Install
+
+```bash
+npm install @x12i/memorix-package-seed
+```
+
+## Pack layout
+
+```text
+my-pack/
+  package-seed.json
+  package-seed.manifest.json
+  pipeline-services.json          # optional
+  abstraction-map.json            # optional
+  pipeline-steps.json             # optional
+  pipeline-definitions.json       # optional
+  pipeline-templates.json         # optional
+  inventory-agents.json           # optional
+  artifacts/                      # authoring-only (e.g. entra mappings)
+```
+
+Staging packs live under [`.operational/package-seed-packs/`](../.operational/package-seed-packs/README.md) (MOVE-OUT vs STAY documented there).
+
+## API
+
+```ts
+import {
+  createPackageSeeder,
+  attachPlatformCoreBootstrap,
+  ensureSeeded,
+  loadManifestFromDir,
+  runPackageSeedOnStart,
+} from "@x12i/memorix-package-seed";
+
+const seeder = createPackageSeeder(
+  attachPlatformCoreBootstrap({
+    seedsDir: new URL("./seeds", import.meta.url).pathname,
+    mode: "strict", // strict | upgrade | force
+  }),
+);
+
+try {
+  const result = await seeder.ensureSeeded();
+  // result.outcome: applied | skipped | conflict | failed
+} finally {
+  await seeder.close();
+}
+```
+
+Startup helper (trusted package config only — never wire to arbitrary HTTP input):
+
+```bash
+PACKAGE_SEED_ON_START=1 PACKAGE_SEED_MODE=strict PACKAGE_SEED_STRICT=1
+```
+
+```ts
+await runPackageSeedOnStart({ seedsDir: "./seeds" });
+```
+
+### Modes
+
+| Mode | Behavior |
+|------|----------|
+| `strict` (default) | same contentHash → skip; different → conflict |
+| `upgrade` | re-apply when `seedRevision` changes; revision-not-bumped → conflict |
+| `force` | always re-apply (ops) |
+
+### Platform core
+
+Before integration packs, `ensurePlatformCoreSeeded(targetAgentId)` applies `@x12i/memorix-platform-core-seed` into that agent’s Catalox DB (`PACKAGE_SEED_PLATFORM_CORE_DIR` or `.operational/package-seed-packs/_platform-core`).
+
+### Ledger + lease
+
+- Ledger catalog: `memorix-package-seed-ledger` (Catalox native items)
+- Atomic leases: Mongo collection `memorix-package-seed-leases` with fencing/heartbeat
+- `resetLedger` removes ledger/lease state only (never seeded catalog data); requires `PACKAGE_SEED_ALLOW_RESET=1`, `yes: true`, actor, reason
+
+## CLI
+
+```bash
+npx memorix-package-seed validate --dir ./seeds
+npx memorix-package-seed apply --dir ./seeds --mode strict
+npx memorix-package-seed status --dir ./seeds
+PACKAGE_SEED_ALLOW_RESET=1 npx memorix-package-seed reset-ledger \
+  --dir ./seeds --target agent-firewall-topology --actor ops --reason migrate --yes
+```
+
+Exit codes: `0` ok/skipped, `1` failed, `2` validation/conflict, `3` status-not-found.
+
+## Security boundary
+
+Seed roots and identities are **trusted deployment configuration**. Do not expose an HTTP endpoint that accepts arbitrary package/agent/file input.
+
+## Related
+
+- `@x12i/memorix-db-router` — database name routing
+- `@x12i/memorix-pipeline-services` / `@x12i/memorix-pipeline-orchestrator` — typed plane writers
+- `.operational/package-seed-packs/` — exported MOVE-OUT packs

package/dist/agent-merge.d.ts

@@ -0,0 +1,17 @@
+export declare function collectItemAgents(item: unknown): string[];
+/**
+ * Ensures every declared item agent is in targetAgentIds, then merges primary
+ * agentId into agents / scope.agents without dropping additional scopes.
+ * Set injectAgents:false for inventory-agents plane items ({id,label} defs).
+ */
+export declare function mergePrimaryAgent(item: unknown, primaryAgentId: string, options: {
+    targetAgentIds: string[];
+    allowAdditionalAgents: boolean;
+    injectAgents?: boolean;
+}): unknown;
+export declare function mergePlaneItems(items: unknown[], primaryAgentId: string, options: {
+    targetAgentIds: string[];
+    allowAdditionalAgents: boolean;
+    injectAgents?: boolean;
+}): unknown[];
+//# sourceMappingURL=agent-merge.d.ts.map

package/dist/agent-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-merge.d.ts","sourceRoot":"","sources":["../src/agent-merge.ts"],"names":[],"mappings":"AAOA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAczD;AAaD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE;IACP,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GACA,OAAO,CAsDT;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EAAE,EAChB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE;IACP,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GACA,OAAO,EAAE,CAEX"}

package/dist/agent-merge.js

@@ -0,0 +1,94 @@
+import { MemorixPackageSeedError } from "./errors.js";
+import { uniqueSorted } from "./identity.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function collectItemAgents(item) {
+    if (!isRecord(item))
+        return [];
+    const agents = [];
+    if (Array.isArray(item.agents)) {
+        for (const a of item.agents) {
+            if (typeof a === "string" && a.trim())
+                agents.push(a.trim());
+        }
+    }
+    if (isRecord(item.scope) && Array.isArray(item.scope.agents)) {
+        for (const a of item.scope.agents) {
+            if (typeof a === "string" && a.trim())
+                agents.push(a.trim());
+        }
+    }
+    return uniqueSorted(agents);
+}
+function isInventoryPolicyDocument(item) {
+    if (item.id === "memorix-ui-agents")
+        return true;
+    if (Array.isArray(item.agents) &&
+        item.agents.some((a) => isRecord(a) && typeof a.id === "string")) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Ensures every declared item agent is in targetAgentIds, then merges primary
+ * agentId into agents / scope.agents without dropping additional scopes.
+ * Set injectAgents:false for inventory-agents plane items ({id,label} defs).
+ */
+export function mergePrimaryAgent(item, primaryAgentId, options) {
+    if (!isRecord(item))
+        return item;
+    if (isInventoryPolicyDocument(item) || options.injectAgents === false) {
+        const nestedIds = Array.isArray(item.agents)
+            ? item.agents
+                .filter((a) => isRecord(a))
+                .map((a) => (typeof a.id === "string" ? a.id.trim() : ""))
+                .filter(Boolean)
+            : [];
+        const declaredId = typeof item.id === "string" &&
+            item.id.trim() &&
+            item.id !== "memorix-ui-agents"
+            ? [item.id.trim()]
+            : [];
+        const ids = uniqueSorted([...nestedIds, ...declaredId]);
+        const foreign = ids.filter((a) => !options.targetAgentIds.includes(a));
+        if (foreign.length > 0) {
+            throw new MemorixPackageSeedError({
+                code: "AGENT_SCOPE_MISMATCH",
+                message: `Item agents ${JSON.stringify(foreign)} are outside targetAgentIds ${JSON.stringify(options.targetAgentIds)}`,
+                field: "agents",
+                value: foreign,
+            });
+        }
+        return item;
+    }
+    const next = { ...item };
+    const existing = collectItemAgents(item);
+    const foreign = existing.filter((a) => !options.targetAgentIds.includes(a));
+    if (foreign.length > 0) {
+        throw new MemorixPackageSeedError({
+            code: "AGENT_SCOPE_MISMATCH",
+            message: `Item agents ${JSON.stringify(foreign)} are outside targetAgentIds ${JSON.stringify(options.targetAgentIds)}`,
+            field: "agents",
+            value: foreign,
+        });
+    }
+    const merged = uniqueSorted([...existing, primaryAgentId]);
+    next.agents = merged;
+    if (isRecord(next.scope)) {
+        next.scope = {
+            ...next.scope,
+            agents: uniqueSorted([
+                ...(Array.isArray(next.scope.agents)
+                    ? next.scope.agents.filter((a) => typeof a === "string")
+                    : []),
+                primaryAgentId,
+            ]),
+        };
+    }
+    return next;
+}
+export function mergePlaneItems(items, primaryAgentId, options) {
+    return items.map((item) => mergePrimaryAgent(item, primaryAgentId, options));
+}
+//# sourceMappingURL=agent-merge.js.map

package/dist/agent-merge.js.map

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

package/dist/catalox.d.ts

@@ -0,0 +1,21 @@
+import type { CataloxBound } from "@x12i/catalox";
+import type { Db } from "mongodb";
+export type OpenPackageSeedCataloxResult = {
+    catalox: CataloxBound;
+    mongoDb: Db;
+    mongoStore: {
+        close: () => Promise<void>;
+        db: Db;
+    };
+    databaseName: string;
+    appId: string;
+    close: () => Promise<void>;
+};
+export declare function openPackageSeedCatalox(options: {
+    agentId: string;
+    processEnv?: NodeJS.ProcessEnv;
+    mongoUri?: string;
+    appId?: string;
+}): Promise<OpenPackageSeedCataloxResult>;
+export declare function ensurePackageSeedCatalogs(catalox: CataloxBound): Promise<void>;
+//# sourceMappingURL=catalox.d.ts.map

package/dist/catalox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalox.d.ts","sourceRoot":"","sources":["../src/catalox.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAKlC,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,EAAE,CAAC;IACZ,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,EAAE,EAAE,EAAE,CAAA;KAAE,CAAC;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,4BAA4B,CAAC,CA4BxC;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/catalox.js

@@ -0,0 +1,37 @@
+import { getMemorixMetadataDatabaseName } from "@x12i/memorix-db-router";
+import { createMemorixCataloxFromEnv, resolveMemorixAppId, } from "@x12i/memorix-descriptors";
+import { MEMORIX_PACKAGE_SEED_LEDGER_CATALOG, } from "./constants.js";
+export async function openPackageSeedCatalox(options) {
+    const processEnv = options.processEnv ?? process.env;
+    const databaseName = getMemorixMetadataDatabaseName(options.agentId);
+    const appId = resolveMemorixAppId({ appId: options.appId }, processEnv);
+    const { catalox, mongoStore } = await createMemorixCataloxFromEnv({
+        processEnv,
+        dbName: databaseName,
+        mongoUri: options.mongoUri,
+    });
+    const bound = catalox.withContext({
+        appId,
+        actor: { type: "service", id: `package-seed:${options.agentId}` },
+        superAdmin: true,
+    });
+    const close = async () => {
+        await mongoStore.close();
+    };
+    return {
+        catalox: bound,
+        mongoDb: mongoStore.db,
+        mongoStore,
+        databaseName,
+        appId,
+        close,
+    };
+}
+export async function ensurePackageSeedCatalogs(catalox) {
+    await catalox.ensureCatalog({
+        catalogId: MEMORIX_PACKAGE_SEED_LEDGER_CATALOG,
+        name: "Memorix package seed ledger",
+        status: "active",
+    });
+}
+//# sourceMappingURL=catalox.js.map

package/dist/catalox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalox.js","sourceRoot":"","sources":["../src/catalox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,mCAAmC,GACpC,MAAM,gBAAgB,CAAC;AAWxB,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAK5C;IACC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC;IACrD,MAAM,YAAY,GAAG,8BAA8B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,mBAAmB,CAC/B,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,EACxB,UAAU,CACX,CAAC;IACF,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,2BAA2B,CAAC;QAChE,UAAU;QACV,MAAM,EAAE,YAAY;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC;QAChC,KAAK;QACL,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,gBAAgB,OAAO,CAAC,OAAO,EAAE,EAAE;QACjE,UAAU,EAAE,IAAI;KACjB,CAAiB,CAAC;IACnB,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;QACvB,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC,CAAC;IACF,OAAO;QACL,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,UAAU,CAAC,EAAE;QACtB,UAAU;QACV,YAAY;QACZ,KAAK;QACL,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAqB;IAErB,MAAM,OAAO,CAAC,aAAa,CAAC;QAC1B,SAAS,EAAE,mCAAmC;QAC9C,IAAI,EAAE,6BAA6B;QACnC,MAAM,EAAE,QAAQ;KACjB,CAAC,CAAC;AACL,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { MemorixPackageSeedError } from "./errors.js";
+import { createPackageSeeder, ensureSeeded } from "./ensure-seeded.js";
+import { loadManifestFromDir } from "./manifest.js";
+import { attachPlatformCoreBootstrap } from "./platform-core.js";
+function printHelp() {
+    console.log(`memorix-package-seed <command> [options]
+
+Commands:
+  validate --dir <seedDir> [--agent <agentId>]
+  apply    --dir <seedDir> [--agent <agentId>] [--mode strict|upgrade|force]
+  status   --dir <seedDir> [--agent <agentId>]
+  reset-ledger --dir <seedDir> --target <agentId> --actor <who> --reason <why> --yes
+
+Exit codes:
+  0 applied/skipped/status-found/valid
+  1 failed
+  2 validation/conflict
+  3 status-not-found
+`);
+}
+function argValue(args, name) {
+    const idx = args.indexOf(name);
+    if (idx === -1)
+        return undefined;
+    return args[idx + 1];
+}
+function hasFlag(args, name) {
+    return args.includes(name);
+}
+function parseMode(raw) {
+    if (!raw || raw === "strict")
+        return "strict";
+    if (raw === "upgrade" || raw === "force")
+        return raw;
+    throw new MemorixPackageSeedError({
+        code: "INVALID_MANIFEST",
+        message: `Invalid --mode ${raw}`,
+        field: "mode",
+    });
+}
+async function main(argv) {
+    const [cmd, ...args] = argv;
+    if (!cmd || cmd === "--help" || cmd === "-h" || cmd === "help") {
+        printHelp();
+        return 0;
+    }
+    const dir = argValue(args, "--dir");
+    if (!dir) {
+        console.error("Missing --dir <seedDir>");
+        return 2;
+    }
+    const seedsDir = resolve(dir);
+    const agent = argValue(args, "--agent");
+    try {
+        if (cmd === "validate") {
+            const loaded = loadManifestFromDir(seedsDir, { cliAgentId: agent });
+            console.log(JSON.stringify({
+                ok: true,
+                packageId: loaded.identity.packageId,
+                agentId: loaded.identity.agentId,
+                targetAgentIds: loaded.identity.targetAgentIds,
+                seedRevision: loaded.manifest.seedRevision,
+                payloadHash: loaded.payloadHash,
+                contentHash: loaded.contentHash,
+                planes: loaded.planes.map((p) => ({
+                    kind: p.kind,
+                    catalogId: p.catalogId,
+                    itemCount: p.items.length,
+                    source: p.source,
+                })),
+                artifacts: loaded.artifactPaths,
+            }, null, 2));
+            return 0;
+        }
+        if (cmd === "apply") {
+            const mode = parseMode(argValue(args, "--mode"));
+            // Assert --agent identity up front.
+            loadManifestFromDir(seedsDir, { cliAgentId: agent });
+            const result = await ensureSeeded(attachPlatformCoreBootstrap({
+                seedsDir,
+                mode,
+                actor: "cli",
+            }));
+            console.log(JSON.stringify(result, null, 2));
+            if (result.outcome === "failed")
+                return 1;
+            if (result.outcome === "conflict")
+                return 2;
+            return 0;
+        }
+        if (cmd === "status") {
+            const loaded = loadManifestFromDir(seedsDir, { cliAgentId: agent });
+            const seeder = createPackageSeeder({ seedsDir });
+            try {
+                const status = await seeder.status(loaded.identity.packageId, agent);
+                console.log(JSON.stringify(status, null, 2));
+                const found = status.targets.some((t) => t.ledger);
+                return found ? 0 : 3;
+            }
+            finally {
+                await seeder.close();
+            }
+        }
+        if (cmd === "reset-ledger") {
+            const target = argValue(args, "--target");
+            const actor = argValue(args, "--actor");
+            const reason = argValue(args, "--reason");
+            const yes = hasFlag(args, "--yes");
+            if (!target || !actor || !reason) {
+                console.error("reset-ledger requires --target --actor --reason --yes");
+                return 2;
+            }
+            const loaded = loadManifestFromDir(seedsDir, { cliAgentId: agent });
+            const seeder = createPackageSeeder({ seedsDir });
+            try {
+                await seeder.resetLedger({
+                    packageId: loaded.identity.packageId,
+                    targetAgentId: target,
+                    actor,
+                    reason,
+                    yes,
+                });
+                console.log(JSON.stringify({ ok: true, packageId: loaded.identity.packageId, target }, null, 2));
+                return 0;
+            }
+            finally {
+                await seeder.close();
+            }
+        }
+        console.error(`Unknown command: ${cmd}`);
+        printHelp();
+        return 2;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const code = error instanceof MemorixPackageSeedError ? error.code : "APPLY_FAILED";
+        console.error(JSON.stringify({ ok: false, code, message }, null, 2));
+        if (error instanceof MemorixPackageSeedError &&
+            (code === "IDENTITY_MISMATCH" ||
+                code === "INVALID_MANIFEST" ||
+                code === "INVALID_PATH" ||
+                code === "INVALID_PLANE" ||
+                code === "UNKNOWN_PLANE_KIND" ||
+                code === "SECRET_DETECTED" ||
+                code === "AGENT_SCOPE_MISMATCH" ||
+                code === "REVISION_NOT_BUMPED" ||
+                code === "MISSING_CUSTOM_WRITER" ||
+                code === "RESET_NOT_ALLOWED" ||
+                code === "MISSING_IDENTITY" ||
+                code === "INVALID_IDENTITY" ||
+                code === "PAYLOAD_TOO_LARGE")) {
+            return 2;
+        }
+        return 1;
+    }
+}
+const exitCode = await main(process.argv.slice(2));
+process.exit(exitCode);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,13 @@
+export declare const MEMORIX_PACKAGE_SEED_LEDGER_CATALOG: "memorix-package-seed-ledger";
+export declare const MEMORIX_PACKAGE_SEED_LEASES_COLLECTION: "memorix-package-seed-leases";
+export declare const PLATFORM_CORE_PACKAGE_ID: "@x12i/memorix-platform-core-seed";
+export declare const MAX_PLANE_FILE_BYTES: number;
+export declare const MAX_PACK_BYTES: number;
+export declare const MAX_PLANES = 100;
+export declare const MAX_TOTAL_ITEMS = 100000;
+export declare const DEFAULT_LEASE_TTL_MS = 30000;
+export declare const DEFAULT_LEASE_WAIT_MS = 60000;
+export declare const DEFAULT_LEASE_POLL_MS = 250;
+export declare const NATIVE_CATALOG_ALLOWLIST: readonly ["memorix-integration-abstraction-maps", "memorix-security-unified-objects", "memorix-security-relationship-types", "memorix-cross-domain-unification", "memorix-object-type-descriptors", "lists", "memorix-item-descriptors", "memorix-graph-descriptors", "memorix-inventory-policies", "memorix-write-descriptors", "memorix-workflow-field-schemas"];
+export declare const BUILTIN_PLANE_KINDS: readonly ["pipeline-services", "pipeline-worker-bases", "integration-abstraction-map", "pipeline-steps", "pipeline-definitions", "pipeline-templates", "inventory-agents", "native-catalog-items", "object-types", "skills-metadata", "custom"];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mCAAmC,EAC9C,6BAAsC,CAAC;AAEzC,eAAO,MAAM,sCAAsC,EACjD,6BAAsC,CAAC;AAEzC,eAAO,MAAM,wBAAwB,EACnC,kCAA2C,CAAC;AAE9C,eAAO,MAAM,oBAAoB,QAAmB,CAAC;AACrD,eAAO,MAAM,cAAc,QAAmB,CAAC;AAC/C,eAAO,MAAM,UAAU,MAAM,CAAC;AAC9B,eAAO,MAAM,eAAe,SAAU,CAAC;AAEvC,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAC3C,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAC5C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,eAAO,MAAM,wBAAwB,oWAY3B,CAAC;AAEX,eAAO,MAAM,mBAAmB,iPAYtB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,37 @@
+export const MEMORIX_PACKAGE_SEED_LEDGER_CATALOG = "memorix-package-seed-ledger";
+export const MEMORIX_PACKAGE_SEED_LEASES_COLLECTION = "memorix-package-seed-leases";
+export const PLATFORM_CORE_PACKAGE_ID = "@x12i/memorix-platform-core-seed";
+export const MAX_PLANE_FILE_BYTES = 10 * 1024 * 1024;
+export const MAX_PACK_BYTES = 50 * 1024 * 1024;
+export const MAX_PLANES = 100;
+export const MAX_TOTAL_ITEMS = 100_000;
+export const DEFAULT_LEASE_TTL_MS = 30_000;
+export const DEFAULT_LEASE_WAIT_MS = 60_000;
+export const DEFAULT_LEASE_POLL_MS = 250;
+export const NATIVE_CATALOG_ALLOWLIST = [
+    "memorix-integration-abstraction-maps",
+    "memorix-security-unified-objects",
+    "memorix-security-relationship-types",
+    "memorix-cross-domain-unification",
+    "memorix-object-type-descriptors",
+    "lists",
+    "memorix-item-descriptors",
+    "memorix-graph-descriptors",
+    "memorix-inventory-policies",
+    "memorix-write-descriptors",
+    "memorix-workflow-field-schemas",
+];
+export const BUILTIN_PLANE_KINDS = [
+    "pipeline-services",
+    "pipeline-worker-bases",
+    "integration-abstraction-map",
+    "pipeline-steps",
+    "pipeline-definitions",
+    "pipeline-templates",
+    "inventory-agents",
+    "native-catalog-items",
+    "object-types",
+    "skills-metadata",
+    "custom",
+];
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mCAAmC,GAC9C,6BAAsC,CAAC;AAEzC,MAAM,CAAC,MAAM,sCAAsC,GACjD,6BAAsC,CAAC;AAEzC,MAAM,CAAC,MAAM,wBAAwB,GACnC,kCAA2C,CAAC;AAE9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACrD,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAC/C,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC;AAC9B,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,sCAAsC;IACtC,kCAAkC;IAClC,qCAAqC;IACrC,kCAAkC;IAClC,iCAAiC;IACjC,OAAO;IACP,0BAA0B;IAC1B,2BAA2B;IAC3B,4BAA4B;IAC5B,2BAA2B;IAC3B,gCAAgC;CACxB,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,mBAAmB;IACnB,uBAAuB;IACvB,6BAA6B;IAC7B,gBAAgB;IAChB,sBAAsB;IACtB,oBAAoB;IACpB,kBAAkB;IAClB,sBAAsB;IACtB,cAAc;IACd,iBAAiB;IACjB,QAAQ;CACA,CAAC"}

package/dist/ensure-seeded.d.ts

@@ -0,0 +1,36 @@
+import type { EnsureSeededResult, MemorixPackageSeedMode, PackageSeedIdentity, PackageSeedLedgerItem } from "./types.js";
+export type EnsureSeededOptions = {
+    identity?: PackageSeedIdentity;
+    seedsDir: string;
+    mode?: MemorixPackageSeedMode;
+    processEnv?: NodeJS.ProcessEnv;
+    mongoUri?: string;
+    appId?: string;
+    actor?: string;
+    /** When set, apply only these destinations (e.g. platform-core bootstrap). */
+    applyTargetAgentIds?: string[];
+    skipPlatformCore?: boolean;
+    ensurePlatformCore?: (targetAgentId: string) => Promise<EnsureSeededResult | null>;
+};
+export type PackageSeeder = {
+    ensureSeeded: (options?: Partial<EnsureSeededOptions>) => Promise<EnsureSeededResult>;
+    status: (packageId?: string, targetAgentId?: string) => Promise<{
+        targets: Array<{
+            targetAgentId: string;
+            databaseName: string;
+            ledger: PackageSeedLedgerItem | null;
+        }>;
+    }>;
+    resetLedger: (options: {
+        packageId: string;
+        targetAgentId: string;
+        actor: string;
+        reason: string;
+        yes: boolean;
+    }) => Promise<void>;
+    close: () => Promise<void>;
+    [Symbol.asyncDispose]: () => Promise<void>;
+};
+export declare function ensureSeeded(options: EnsureSeededOptions): Promise<EnsureSeededResult>;
+export declare function createPackageSeeder(defaults: EnsureSeededOptions): PackageSeeder;
+//# sourceMappingURL=ensure-seeded.d.ts.map

package/dist/ensure-seeded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-seeded.d.ts","sourceRoot":"","sources":["../src/ensure-seeded.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,kBAAkB,EAElB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EAGtB,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,CACnB,aAAa,EAAE,MAAM,KAClB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,YAAY,EAAE,CACZ,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,KACnC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACjC,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;QAC9D,OAAO,EAAE,KAAK,CAAC;YACb,aAAa,EAAE,MAAM,CAAC;YACtB,YAAY,EAAE,MAAM,CAAC;YACrB,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAC;SACtC,CAAC,CAAC;KACJ,CAAC,CAAC;IACH,WAAW,EAAE,CAAC,OAAO,EAAE;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,OAAO,CAAC;KACd,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C,CAAC;AAiRF,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA0C7B;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,mBAAmB,GAC5B,aAAa,CAqGf"}