@x12i/memorix-descriptors 0.1.0

package/dist/reconcile/index.d.ts

@@ -0,0 +1,29 @@
+import { type MemorixCollectionInventoryResult, type MemorixRetrievalClient } from "@x12i/memorix-retrieval";
+import type { CataloxBoundClient } from "../catalox/client.js";
+import type { MemorixTarget } from "../types/index.js";
+export type ReconcileSuggestion = {
+    kind: "create-descriptor-for-orphan";
+    collection: string;
+    target: MemorixTarget;
+} | {
+    kind: "ensure-collection";
+    entityName: string;
+    contentType: string;
+} | {
+    kind: "empty-declared-collection";
+    entityName: string;
+    contentType: string;
+};
+export type ReconcileDescriptorsResult = {
+    inventory: MemorixCollectionInventoryResult;
+    suggestions: ReconcileSuggestion[];
+};
+export type ReconcileDescriptorsOptions = {
+    catalox: CataloxBoundClient;
+    appId: string;
+    processEnv?: NodeJS.ProcessEnv;
+    autoRegisterOrphans?: boolean;
+};
+export declare function reconcileDescriptorsWithMongo(options: ReconcileDescriptorsOptions): Promise<ReconcileDescriptorsResult>;
+export type { MemorixRetrievalClient };
+//# sourceMappingURL=index.d.ts.map

package/dist/reconcile/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reconcile/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,gCAAgC,EACrC,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,KAAK,EAAsB,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAI3E,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,8BAA8B,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GACnF;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,2BAA2B,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,gCAAgC,CAAC;IAC5C,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAcrC;AAmDD,YAAY,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/reconcile/index.js

@@ -0,0 +1,58 @@
+import { buildMemorixCollectionInventory, createCataloxAdapterFromBound, createMemorixRetrieval, } from "@x12i/memorix-retrieval";
+import { loadDescriptorSnapshot } from "../store/snapshot.js";
+import { validateMemorixEntityDescriptor } from "../validation/descriptor-validation.js";
+import { resolveCollectionForEntity } from "../collections/resolve.js";
+export async function reconcileDescriptorsWithMongo(options) {
+    const env = options.processEnv ?? process.env;
+    const cataloxAdapter = createCataloxAdapterFromBound(options.catalox);
+    const client = createMemorixRetrieval({
+        appId: options.appId,
+        catalox: cataloxAdapter,
+        processEnv: env,
+    });
+    const snapshot = await loadDescriptorSnapshot(options.catalox);
+    const inventory = await buildMemorixCollectionInventory(client);
+    const suggestions = buildReconcileSuggestions(snapshot, inventory, env);
+    return { inventory, suggestions };
+}
+function buildReconcileSuggestions(snapshot, inventory, env) {
+    const suggestions = [];
+    const declared = new Set();
+    for (const [entityName, raw] of Object.entries(snapshot.entityDescriptors)) {
+        const entity = validateMemorixEntityDescriptor(raw);
+        const target = (entity.target ?? "entity");
+        for (const [contentTypeKey] of Object.entries(entity.contentTypes)) {
+            const collection = resolveCollectionForEntity(entity, contentTypeKey, env);
+            declared.add(`${target}:${collection}`);
+            const match = inventory.entries.find((entry) => entry.collection === collection && entry.target === target);
+            if (!match) {
+                suggestions.push({
+                    kind: "ensure-collection",
+                    entityName,
+                    contentType: contentTypeKey,
+                });
+            }
+            else if (match.documentCount === 0) {
+                suggestions.push({
+                    kind: "empty-declared-collection",
+                    entityName,
+                    contentType: contentTypeKey,
+                });
+            }
+        }
+    }
+    for (const entry of inventory.entries) {
+        if (entry.matchStatus !== "orphan")
+            continue;
+        const key = `${entry.target}:${entry.collection}`;
+        if (!declared.has(key)) {
+            suggestions.push({
+                kind: "create-descriptor-for-orphan",
+                collection: entry.collection,
+                target: entry.target,
+            });
+        }
+    }
+    return suggestions;
+}
+//# sourceMappingURL=index.js.map

package/dist/reconcile/index.js.map

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

package/dist/seeds/index.d.ts

@@ -0,0 +1,33 @@
+import { type MemorixRetrievalSeedManifest, type MemorixSeedScope } from "@x12i/memorix-retrieval";
+import type { CataloxBoundClient } from "../catalox/client.js";
+import type { DescriptorSnapshot } from "../types/index.js";
+import { validateDescriptorSnapshot } from "../integrity/validate.js";
+export declare function resolveMemorixDescriptorsPackageRoot(): string;
+export type DescriptorSeedManifest = MemorixRetrievalSeedManifest & {
+    items: MemorixRetrievalSeedManifest["items"];
+};
+export type ExportDescriptorSeedInputsOptions = {
+    snapshot?: DescriptorSnapshot;
+    scope?: MemorixSeedScope;
+};
+export declare function buildDescriptorSeedManifest(snapshot: DescriptorSnapshot, scope?: MemorixSeedScope): Promise<DescriptorSeedManifest>;
+export declare function exportDescriptorSeedInputs(dir: string, options?: ExportDescriptorSeedInputsOptions): Promise<void>;
+export type ImportDescriptorSeedInputsOptions = {
+    dryRun?: boolean;
+    scope?: MemorixSeedScope;
+};
+export declare function importDescriptorSeedInputs(catalox: CataloxBoundClient, dir: string, options?: ImportDescriptorSeedInputsOptions): Promise<{
+    ok: boolean;
+    itemCount: number;
+    integrity: ReturnType<typeof validateDescriptorSnapshot>;
+}>;
+export declare function applyDescriptorSeedManifest(catalox: CataloxBoundClient, manifest: DescriptorSeedManifest, options?: {
+    dryRun?: boolean;
+    force?: boolean;
+}): Promise<{
+    ok: boolean;
+    itemCount: number;
+    integrity: ReturnType<typeof validateDescriptorSnapshot>;
+}>;
+export declare function exportDescriptorSeedInputsFromCatalox(catalox: CataloxBoundClient, dir: string, scope?: MemorixSeedScope): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/seeds/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seeds/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAI/D,OAAO,KAAK,EAAE,kBAAkB,EAA4B,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAItE,wBAAgB,oCAAoC,IAAI,MAAM,CAE7D;AAED,MAAM,MAAM,sBAAsB,GAAG,4BAA4B,GAAG;IAClE,KAAK,EAAE,4BAA4B,CAAC,OAAO,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,CAAC,EAAE,gBAAgB,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAyCjC;AAED,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAiCf;AAMD,MAAM,MAAM,iCAAiC,GAAG;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,kBAAkB,EAC3B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAA;CAAE,CAAC,CAkBvG;AAiDD,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,sBAAsB,EAChC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAClD,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAA;CAAE,CAAC,CAiCvG;AASD,wBAAsB,qCAAqC,CACzD,OAAO,EAAE,kBAAkB,EAC3B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,gBAAgB,GACvB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/seeds/index.js

@@ -0,0 +1,186 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { buildMemorixRetrievalSeedManifest, mergeSeedItemScopeIntoUpsertData, } from "@x12i/memorix-retrieval";
+import { CATALOG_BY_KIND, upsertCatalogItem } from "../catalox/client.js";
+import { MEMORIX_COMPLETION_MAPPINGS_CATALOG } from "../catalog/ids.js";
+import { loadDescriptorSnapshot, stripScopeFromData } from "../store/snapshot.js";
+import { validateDescriptorSnapshot } from "../integrity/validate.js";
+const moduleDir = dirname(fileURLToPath(import.meta.url));
+export function resolveMemorixDescriptorsPackageRoot() {
+    return join(moduleDir, "..", "..");
+}
+export async function buildDescriptorSeedManifest(snapshot, scope) {
+    const readJson = async (relativePath) => {
+        const id = relativePath.split("/").pop()?.replace(/\.json$/i, "") ?? relativePath;
+        if (relativePath.startsWith("entity-descriptors/")) {
+            return stripScopeFromData(snapshot.entityDescriptors[id] ?? {});
+        }
+        if (relativePath.startsWith("list-descriptors/")) {
+            return stripScopeFromData(snapshot.listDescriptors[id] ?? {});
+        }
+        if (relativePath.startsWith("item-descriptors/")) {
+            return stripScopeFromData(snapshot.itemDescriptors[id] ?? {});
+        }
+        if (relativePath.startsWith("mapping-descriptors/")) {
+            return stripScopeFromData((snapshot.completionMappings[id] ?? {}));
+        }
+        throw new Error(`Unknown seed input path: ${relativePath}`);
+    };
+    const base = await buildMemorixRetrievalSeedManifest({ readJson, scope });
+    const mappingItems = Object.values(snapshot.completionMappings).map((mapping) => ({
+        catalogId: MEMORIX_COMPLETION_MAPPINGS_CATALOG,
+        scope: scope ?? { domains: [], agents: [] },
+        data: mapping,
+    }));
+    return {
+        ...base,
+        catalogs: [
+            ...base.catalogs,
+            {
+                catalogId: MEMORIX_COMPLETION_MAPPINGS_CATALOG,
+                name: "Memorix completion mappings",
+                catalogType: "memorix",
+                sourceMode: "native",
+                native: { itemIdField: "id", titleField: "name" },
+            },
+        ],
+        items: [...base.items, ...mappingItems],
+    };
+}
+export async function exportDescriptorSeedInputs(dir, options = {}) {
+    const snapshot = options.snapshot;
+    if (!snapshot) {
+        throw new Error("exportDescriptorSeedInputs requires a descriptor snapshot");
+    }
+    await mkdir(join(dir, "entity-descriptors"), { recursive: true });
+    await mkdir(join(dir, "list-descriptors"), { recursive: true });
+    await mkdir(join(dir, "item-descriptors"), { recursive: true });
+    await mkdir(join(dir, "mapping-descriptors"), { recursive: true });
+    for (const [id, data] of Object.entries(snapshot.entityDescriptors)) {
+        await writeJson(join(dir, "entity-descriptors", `${id}.json`), stripScopeFromData(data));
+    }
+    for (const [id, data] of Object.entries(snapshot.listDescriptors)) {
+        await writeJson(join(dir, "list-descriptors", `${id}.json`), stripScopeFromData(data));
+    }
+    for (const [id, data] of Object.entries(snapshot.itemDescriptors)) {
+        await writeJson(join(dir, "item-descriptors", `${id}.json`), stripScopeFromData(data));
+    }
+    for (const [id, data] of Object.entries(snapshot.completionMappings)) {
+        await writeJson(join(dir, "mapping-descriptors", `${id}.json`), stripScopeFromData(data));
+    }
+    const manifest = await buildDescriptorSeedManifest(snapshot, options.scope);
+    await writeJson(join(dir, "manifest.json"), {
+        presetVersion: manifest.presetVersion,
+        id: manifest.id,
+        itemCount: manifest.items.length,
+        catalogs: manifest.catalogs.map((c) => c.catalogId),
+    });
+}
+async function writeJson(path, value) {
+    await writeFile(path, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+export async function importDescriptorSeedInputs(catalox, dir, options = {}) {
+    const readJson = async (relativePath) => {
+        const raw = await readFile(join(dir, relativePath), "utf8");
+        return JSON.parse(raw);
+    };
+    let scope = options.scope;
+    if (!scope) {
+        try {
+            const raw = await readFile(join(dir, "scope.json"), "utf8");
+            scope = JSON.parse(raw);
+        }
+        catch {
+            scope = { domains: ["network", "vulnerabilities"], agents: ["neo"] };
+        }
+    }
+    const manifest = await buildDescriptorSeedManifestFromDir(dir, scope, readJson);
+    return applyDescriptorSeedManifest(catalox, manifest, options);
+}
+async function buildDescriptorSeedManifestFromDir(dir, scope, readJson) {
+    const entityFiles = await listJsonFiles(join(dir, "entity-descriptors"));
+    const listFiles = await listJsonFiles(join(dir, "list-descriptors"));
+    const itemFiles = await listJsonFiles(join(dir, "item-descriptors"));
+    const mappingFiles = await listJsonFiles(join(dir, "mapping-descriptors"));
+    const snapshot = {
+        entityDescriptors: {},
+        listDescriptors: {},
+        itemDescriptors: {},
+        completionMappings: {},
+    };
+    for (const file of entityFiles) {
+        const data = await readJson(`entity-descriptors/${file}`);
+        snapshot.entityDescriptors[String(data.id)] = data;
+    }
+    for (const file of listFiles) {
+        const data = await readJson(`list-descriptors/${file}`);
+        snapshot.listDescriptors[String(data.id)] = data;
+    }
+    for (const file of itemFiles) {
+        const data = await readJson(`item-descriptors/${file}`);
+        snapshot.itemDescriptors[String(data.id)] = data;
+    }
+    for (const file of mappingFiles) {
+        const data = await readJson(`mapping-descriptors/${file}`);
+        snapshot.completionMappings[String(data.id)] = data;
+    }
+    return buildDescriptorSeedManifest(snapshot, scope);
+}
+async function listJsonFiles(dir) {
+    try {
+        const { readdir } = await import("node:fs/promises");
+        const entries = await readdir(dir);
+        return entries.filter((name) => name.endsWith(".json"));
+    }
+    catch {
+        return [];
+    }
+}
+export async function applyDescriptorSeedManifest(catalox, manifest, options = {}) {
+    const snapshot = {
+        entityDescriptors: {},
+        listDescriptors: {},
+        itemDescriptors: {},
+        completionMappings: {},
+    };
+    for (const item of manifest.items) {
+        const data = mergeSeedItemScopeIntoUpsertData(item.data, item.scope);
+        const id = String(data.id ?? "");
+        if (item.catalogId.includes("entity"))
+            snapshot.entityDescriptors[id] = data;
+        else if (item.catalogId.includes("list"))
+            snapshot.listDescriptors[id] = data;
+        else if (item.catalogId.includes("item"))
+            snapshot.itemDescriptors[id] = data;
+        else
+            snapshot.completionMappings[id] = data;
+    }
+    const integrity = validateDescriptorSnapshot(snapshot);
+    if (!integrity.valid && !options.force) {
+        return { ok: false, itemCount: manifest.items.length, integrity };
+    }
+    if (options.dryRun) {
+        return { ok: integrity.valid, itemCount: manifest.items.length, integrity };
+    }
+    for (const item of manifest.items) {
+        const data = mergeSeedItemScopeIntoUpsertData(item.data, item.scope);
+        const catalog = catalogFromId(item.catalogId);
+        await upsertCatalogItem(catalox, catalog, data, item.scope);
+    }
+    return { ok: true, itemCount: manifest.items.length, integrity };
+}
+function catalogFromId(catalogId) {
+    if (catalogId.includes("entity"))
+        return CATALOG_BY_KIND.entity;
+    if (catalogId.includes("list"))
+        return CATALOG_BY_KIND.list;
+    if (catalogId.includes("item"))
+        return CATALOG_BY_KIND.item;
+    return CATALOG_BY_KIND.mapping;
+}
+export async function exportDescriptorSeedInputsFromCatalox(catalox, dir, scope) {
+    const snapshot = await loadDescriptorSnapshot(catalox);
+    await exportDescriptorSeedInputs(dir, { snapshot, scope });
+}
+//# sourceMappingURL=index.js.map

package/dist/seeds/index.js.map

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

package/dist/store/snapshot.d.ts

@@ -0,0 +1,6 @@
+import type { CataloxBoundClient } from "../catalox/client.js";
+import type { DescriptorSnapshot, MemorixSeedScope } from "../types/index.js";
+export declare function loadDescriptorSnapshot(catalox: CataloxBoundClient): Promise<DescriptorSnapshot>;
+export declare function extractScopeFromData(data: Record<string, unknown>): MemorixSeedScope | undefined;
+export declare function stripScopeFromData(data: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/store/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/store/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAK/D,OAAO,KAAK,EACV,kBAAkB,EAElB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAG3B,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAoC7B;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,gBAAgB,GAAG,SAAS,CAW9B;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzB"}

package/dist/store/snapshot.js

@@ -0,0 +1,49 @@
+import { CATALOG_BY_KIND, listAllCatalogItems, } from "../catalox/client.js";
+import { parseDescriptorData } from "../validation/descriptor-validation.js";
+export async function loadDescriptorSnapshot(catalox) {
+    const [entityItems, listItems, itemItems, mappingItems] = await Promise.all([
+        listAllCatalogItems(catalox, CATALOG_BY_KIND.entity),
+        listAllCatalogItems(catalox, CATALOG_BY_KIND.list),
+        listAllCatalogItems(catalox, CATALOG_BY_KIND.item),
+        listAllCatalogItems(catalox, CATALOG_BY_KIND.mapping),
+    ]);
+    const entityDescriptors = {};
+    for (const item of entityItems) {
+        entityDescriptors[item.id] = parseDescriptorData(item.data);
+    }
+    const listDescriptors = {};
+    for (const item of listItems) {
+        listDescriptors[item.id] = parseDescriptorData(item.data);
+    }
+    const itemDescriptors = {};
+    for (const item of itemItems) {
+        itemDescriptors[item.id] = parseDescriptorData(item.data);
+    }
+    const completionMappings = {};
+    for (const item of mappingItems) {
+        completionMappings[item.id] = parseDescriptorData(item.data);
+    }
+    return {
+        entityDescriptors,
+        listDescriptors,
+        itemDescriptors,
+        completionMappings,
+    };
+}
+export function extractScopeFromData(data) {
+    const scope = data.scope;
+    if (!scope || typeof scope !== "object" || Array.isArray(scope)) {
+        return undefined;
+    }
+    const domains = scope.domains;
+    const agents = scope.agents;
+    if (!Array.isArray(domains) || !Array.isArray(agents)) {
+        return undefined;
+    }
+    return { domains, agents };
+}
+export function stripScopeFromData(data) {
+    const { scope: _scope, ...rest } = data;
+    return rest;
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/store/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/store/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAE7E,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAA2B;IAE3B,MAAM,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1E,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC;QACpD,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC;QAClD,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC;QAClD,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC;KACtD,CAAC,CAAC;IAEH,MAAM,iBAAiB,GAA4C,EAAE,CAAC;IACtE,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,eAAe,GAA0C,EAAE,CAAC;IAClE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,eAAe,GAA0C,EAAE,CAAC;IAClE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,kBAAkB,GAA6C,EAAE,CAAC;IACxE,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAC/C,IAAI,CAAC,IAAI,CAC6B,CAAC;IAC3C,CAAC;IAED,OAAO;QACL,iBAAiB;QACjB,eAAe;QACf,eAAe;QACf,kBAAkB;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAA6B;IAE7B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAI,KAA0B,CAAC,OAAO,CAAC;IACpD,MAAM,MAAM,GAAI,KAA0B,CAAC,MAAM,CAAC;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAA6B;IAE7B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tests/validation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.test.d.ts.map

package/dist/tests/validation.test.d.ts.map

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

package/dist/tests/validation.test.js

@@ -0,0 +1,114 @@
+import { describe, expect, it } from "vitest";
+import { defaultItemDescriptorId, defaultListDescriptorId, isKebabCase, singularizeEntityName, validateMemorixEntityDescriptor, validateMemorixEntityListDescriptor, validateMemorixItemDescriptor, } from "../validation/descriptor-validation.js";
+import { validateDescriptorSnapshot } from "../integrity/validate.js";
+import { buildDescriptorGraph } from "../integrity/graph.js";
+const sampleSnapshot = () => ({
+    entityDescriptors: {
+        assets: {
+            id: "assets",
+            entityName: "assets",
+            target: "entity",
+            defaultListDescriptorId: "assets-main-list",
+            defaultItemDescriptorId: "asset-detail-item",
+            collectionPrefix: "assets",
+            identity: {
+                allowedIdFields: ["entityId", "eventId"],
+                requiredExactlyOne: true,
+                defaultIdField: "entityId",
+            },
+            defaults: {
+                canonicalContentType: "snapshots",
+                dataRoot: "data",
+                effectiveDatePath: "capturedAt",
+                fallbackEffectiveDatePaths: [],
+            },
+            contentTypes: {
+                snapshots: {
+                    postfix: "snapshots",
+                    collection: "assets-snapshots",
+                    isCanonical: true,
+                },
+            },
+            properties: {
+                ipAddress: {
+                    label: "IP Address",
+                    source: { contentType: "snapshots", path: "data.ip_address" },
+                    humanReadable: true,
+                },
+            },
+        },
+    },
+    listDescriptors: {
+        "assets-main-list": {
+            id: "assets-main-list",
+            entity: "assets",
+            leadingContentType: "snapshots",
+            pagination: { enabled: true, defaultLimit: 50, maxLimit: 200 },
+            fields: ["ipAddress"],
+        },
+    },
+    itemDescriptors: {
+        "asset-detail-item": {
+            id: "asset-detail-item",
+            entity: "assets",
+            identity: { idField: "entityId" },
+            contentTypes: [{ contentType: "snapshots", required: true }],
+            sections: [{ id: "summary", title: "Summary", fields: ["ipAddress"] }],
+        },
+    },
+    completionMappings: {},
+});
+describe("descriptor validation helpers", () => {
+    it("validates kebab-case entity names", () => {
+        expect(isKebabCase("impact-stories")).toBe(true);
+        expect(isKebabCase("ImpactStories")).toBe(false);
+    });
+    it("derives default descriptor ids", () => {
+        expect(defaultListDescriptorId("vulnerabilities")).toBe("vulnerabilities-main-list");
+        expect(defaultItemDescriptorId("vulnerabilities")).toBe("vulnerability-detail-item");
+        expect(defaultItemDescriptorId("impact-stories")).toBe("impact-story-detail-item");
+        expect(singularizeEntityName("variabilities-groups")).toBe("variabilities-group");
+    });
+    it("validates a minimal entity graph snapshot", () => {
+        const snapshot = sampleSnapshot();
+        validateMemorixEntityDescriptor(snapshot.entityDescriptors.assets);
+        validateMemorixEntityListDescriptor(snapshot.listDescriptors["assets-main-list"]);
+        validateMemorixItemDescriptor(snapshot.itemDescriptors["asset-detail-item"]);
+        const report = validateDescriptorSnapshot(snapshot);
+        expect(report.valid).toBe(true);
+        expect(report.counts.entityDescriptors).toBe(1);
+    });
+    it("builds a descriptor graph", () => {
+        const graph = buildDescriptorGraph(sampleSnapshot());
+        expect(graph.nodes.some((n) => n.id === "assets" && n.kind === "entity")).toBe(true);
+        expect(graph.edges.some((e) => e.kind === "default-list")).toBe(true);
+    });
+});
+describe("register entity plan", () => {
+    it("projects entity + default list/item writes", async () => {
+        const { registerEntityDescriptor } = await import("../mutations/entity.js");
+        const snapshot = sampleSnapshot();
+        snapshot.entityDescriptors = {};
+        snapshot.listDescriptors = {};
+        snapshot.itemDescriptors = {};
+        const result = await registerEntityDescriptor({
+            catalox: {},
+            env: process.env,
+            loadSnapshot: async () => snapshot,
+        }, {
+            entityName: "impact-stories",
+            target: "knowledge",
+            collectionPrefix: "impact-stories",
+            canonicalContentType: {
+                key: "narratives",
+                postfix: "narratives",
+                collection: "impact-stories-narratives",
+            },
+            identity: { idField: "knowledgeId" },
+        }, { dryRun: true });
+        expect(result.ok).toBe(true);
+        expect(result.cataloxWrites).toHaveLength(3);
+        expect(result.data?.entityName).toBe("impact-stories");
+    });
+});
+//# sourceMappingURL=validation.test.js.map

package/dist/tests/validation.test.js.map

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