@x12i/memorix-descriptors 0.1.0

package/README.md

@@ -0,0 +1,96 @@
+# @x12i/memorix-descriptors
+
+Write-side control plane for Memorix entity, list, and item descriptors — plus content types, collections, relations, and completion mappings — stored in Catalox and consumed by `@x12i/memorix-retrieval`.
+
+## Overview
+
+| Concern | Package |
+|--------|---------|
+| Load descriptors, compose lists/items, graph, inventory | `@x12i/memorix-retrieval` |
+| Create/update/delete descriptors and mappings in Catalox | `@x12i/memorix-descriptors` |
+
+This package validates referential integrity across entity ↔ list ↔ item ↔ relation ↔ content type ↔ mapping, supports dry-run on all mutations, and stays compatible with the `catalox-seeds/inputs/` workflow from retrieval.
+
+## Install
+
+```bash
+npm install @x12i/memorix-descriptors @x12i/catalox @x12i/memorix-retrieval @x12i/xronox
+```
+
+## Bootstrap
+
+```typescript
+import { bindCataloxContext, createCataloxFromEnv } from "@x12i/catalox/firebase";
+import { createMemorixDescriptorAdmin, resolveMemorixAppId } from "@x12i/memorix-descriptors";
+
+const { catalox } = createCataloxFromEnv();
+const bound = bindCataloxContext(catalox, {
+  appId: resolveMemorixAppId(),
+  actor: { type: "service", id: "memorix-descriptors" },
+  superAdmin: true,
+});
+
+const admin = createMemorixDescriptorAdmin({ catalox: bound });
+```
+
+Or from environment (includes optional Xronox for inventory):
+
+```typescript
+import { createMemorixDescriptorAdminFromEnv } from "@x12i/memorix-descriptors";
+
+const admin = await createMemorixDescriptorAdminFromEnv();
+```
+
+## Register an entity (atomic default list + item)
+
+```typescript
+const result = await admin.registerEntityDescriptor({
+  entityName: "impact-stories",
+  target: "knowledge",
+  collectionPrefix: "impact-stories",
+  canonicalContentType: {
+    key: "narratives",
+    postfix: "narratives",
+    collection: "impact-stories-narratives",
+  },
+  identity: { idField: "knowledgeId" },
+}, { dryRun: true });
+
+console.log(result.cataloxWrites, result.integrity);
+```
+
+## CLI
+
+```bash
+npx memorix-descriptors validate
+npx memorix-descriptors reconcile
+npx memorix-descriptors graph --format mermaid
+npx memorix-descriptors entity register --file ./new-entity.json --dry-run
+npx memorix-descriptors seed export ./catalox-seeds/inputs
+npx memorix-descriptors seed import ./catalox-seeds/inputs --dry-run
+```
+
+## Catalox catalogs
+
+| Catalog id | Purpose |
+|-----------|---------|
+| `memorix-entity-descriptors` | Entity schema root |
+| `memorix-list-descriptors` | Tabular views |
+| `memorix-item-descriptors` | Record detail layouts |
+| `memorix-completion-mappings` | Source → Memorix payload maps |
+
+## Implementation phases
+
+- **Phase 1 (current):** bootstrap, validation, entity/content/property CRUD, seeds, dry-run
+- **Phase 2:** list/item/relation hardening, cascade rules
+- **Phase 3:** mapping catalog + Mongo reconcile
+- **Phase 4:** knowledge target contract bump across ecosystem
+- **Phase 5:** rename/migrate, audit log, CI seed validation
+
+## Related packages
+
+- `@x12i/memorix-retrieval` — read/composition layer
+- `@x12i/catalox` — descriptor storage
+- `@x12i/memorix-completion` — payload document writes
+
+See `docs/MEMORIX-CATALOX-CONTRACTS.md` and `docs/MEMORIX-DATABASE-CONVENTIONS.md` for canonical contracts.

package/dist/admin/create-admin.d.ts

@@ -0,0 +1,74 @@
+import type { XronoxLike } from "@x12i/memorix-retrieval";
+import type { CataloxBoundClient } from "../catalox/client.js";
+import type { ContentTypeInput, DescriptorMutationOptions, MemorixCompletionMapping, PropertyInput, RegisterEntityDescriptorInput } from "../types/index.js";
+import { registerEntityDescriptor, removeEntityDescriptor, updateEntityDescriptor } from "../mutations/entity.js";
+import { addContentType, ensureCollection, planCollectionRename, removeContentType, resolveCollection, updateContentType } from "../mutations/content-type.js";
+import { addProperty, removeProperty, updateProperty } from "../mutations/property.js";
+import { createListDescriptor, removeListDescriptor, setEntityDefaultList, updateListDescriptor } from "../mutations/list.js";
+import { createItemDescriptor, removeItemDescriptor, setEntityDefaultItem, updateItemDescriptor } from "../mutations/item.js";
+import { addRelation, removeRelation, updateRelation, type RelationInput } from "../mutations/relation.js";
+import { registerMapping, removeMapping, updateMapping } from "../mutations/mapping.js";
+import { applyDescriptorSeedManifest, importDescriptorSeedInputs, type DescriptorSeedManifest } from "../seeds/index.js";
+import { reconcileDescriptorsWithMongo } from "../reconcile/index.js";
+export type CreateMemorixDescriptorAdminOptions = {
+    catalox: CataloxBoundClient;
+    xronox?: XronoxLike;
+    appId?: string;
+    processEnv?: NodeJS.ProcessEnv;
+};
+export type MemorixDescriptorAdmin = {
+    readonly appId: string;
+    readonly catalox: CataloxBoundClient;
+    validateMemorixDescriptors(): Promise<import("../types/index.js").DescriptorIntegrityReport>;
+    getDescriptorGraph(): Promise<import("../integrity/graph.js").DescriptorGraph>;
+    getDescriptorGraphMermaid(): Promise<string>;
+    registerEntityDescriptor(input: RegisterEntityDescriptorInput, options?: DescriptorMutationOptions): ReturnType<typeof registerEntityDescriptor>;
+    updateEntityDescriptor(entityName: string, patch: Partial<Record<string, unknown>>, options?: DescriptorMutationOptions): ReturnType<typeof updateEntityDescriptor>;
+    removeEntityDescriptor(entityName: string, options?: DescriptorMutationOptions): ReturnType<typeof removeEntityDescriptor>;
+    addContentType(entityName: string, input: ContentTypeInput, options?: DescriptorMutationOptions): ReturnType<typeof addContentType>;
+    updateContentType(entityName: string, key: string, patch: Partial<ContentTypeInput>, options?: DescriptorMutationOptions): ReturnType<typeof updateContentType>;
+    removeContentType(entityName: string, key: string, options?: DescriptorMutationOptions): ReturnType<typeof removeContentType>;
+    resolveCollection(entityName: string, contentTypeKey: string): ReturnType<typeof resolveCollection>;
+    ensureCollection(entityName: string, contentTypeKey: string, options?: DescriptorMutationOptions): ReturnType<typeof ensureCollection>;
+    planCollectionRename(entityName: string, contentTypeKey: string, newCollectionName: string): Promise<ReturnType<typeof planCollectionRename>>;
+    addProperty(entityName: string, key: string, property: PropertyInput, options?: DescriptorMutationOptions & {
+        addToDefaultList?: boolean;
+        addToDefaultItem?: boolean;
+    }): ReturnType<typeof addProperty>;
+    updateProperty(entityName: string, key: string, patch: Partial<PropertyInput>, options?: DescriptorMutationOptions): ReturnType<typeof updateProperty>;
+    removeProperty(entityName: string, key: string, options?: DescriptorMutationOptions): ReturnType<typeof removeProperty>;
+    createListDescriptor(input: Record<string, unknown>, options?: DescriptorMutationOptions): ReturnType<typeof createListDescriptor>;
+    updateListDescriptor(id: string, patch: Record<string, unknown>, options?: DescriptorMutationOptions): ReturnType<typeof updateListDescriptor>;
+    removeListDescriptor(id: string, options?: DescriptorMutationOptions): ReturnType<typeof removeListDescriptor>;
+    setEntityDefaultList(entityName: string, listDescriptorId: string, options?: DescriptorMutationOptions): ReturnType<typeof setEntityDefaultList>;
+    createItemDescriptor(input: Record<string, unknown>, options?: DescriptorMutationOptions): ReturnType<typeof createItemDescriptor>;
+    updateItemDescriptor(id: string, patch: Record<string, unknown>, options?: DescriptorMutationOptions): ReturnType<typeof updateItemDescriptor>;
+    removeItemDescriptor(id: string, options?: DescriptorMutationOptions): ReturnType<typeof removeItemDescriptor>;
+    setEntityDefaultItem(entityName: string, itemDescriptorId: string, options?: DescriptorMutationOptions): ReturnType<typeof setEntityDefaultItem>;
+    addRelation(sourceEntity: string, relationKey: string, descriptor: RelationInput, options?: DescriptorMutationOptions): ReturnType<typeof addRelation>;
+    updateRelation(sourceEntity: string, relationKey: string, patch: Partial<RelationInput>, options?: DescriptorMutationOptions): ReturnType<typeof updateRelation>;
+    removeRelation(sourceEntity: string, relationKey: string, options?: DescriptorMutationOptions): ReturnType<typeof removeRelation>;
+    registerMapping(input: MemorixCompletionMapping, options?: DescriptorMutationOptions): ReturnType<typeof registerMapping>;
+    updateMapping(id: string, patch: Partial<MemorixCompletionMapping>, options?: DescriptorMutationOptions): ReturnType<typeof updateMapping>;
+    removeMapping(id: string, options?: DescriptorMutationOptions): ReturnType<typeof removeMapping>;
+    buildDescriptorSeedManifest(scope?: import("../types/index.js").MemorixSeedScope): Promise<DescriptorSeedManifest>;
+    exportDescriptorSeedInputs(dir: string, scope?: import("../types/index.js").MemorixSeedScope): Promise<void>;
+    importDescriptorSeedInputs(dir: string, options?: {
+        dryRun?: boolean;
+        scope?: import("../types/index.js").MemorixSeedScope;
+    }): ReturnType<typeof importDescriptorSeedInputs>;
+    applyDescriptorSeedManifest(manifest: DescriptorSeedManifest, options?: {
+        dryRun?: boolean;
+        force?: boolean;
+    }): ReturnType<typeof applyDescriptorSeedManifest>;
+    reconcileDescriptorsWithMongo(): ReturnType<typeof reconcileDescriptorsWithMongo>;
+    loadSnapshot(): Promise<import("../types/index.js").DescriptorSnapshot>;
+};
+export declare function createMemorixDescriptorAdmin(options: CreateMemorixDescriptorAdminOptions): MemorixDescriptorAdmin;
+export type CreateMemorixDescriptorAdminFromEnvOptions = {
+    appId?: string;
+    processEnv?: NodeJS.ProcessEnv;
+    xronox?: XronoxLike;
+};
+export declare function createMemorixDescriptorAdminFromEnv(options?: CreateMemorixDescriptorAdminFromEnvOptions): Promise<MemorixDescriptorAdmin>;
+//# sourceMappingURL=create-admin.d.ts.map

package/dist/admin/create-admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-admin.d.ts","sourceRoot":"","sources":["../../src/admin/create-admin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,KAAK,EACV,gBAAgB,EAChB,yBAAyB,EACzB,wBAAwB,EACxB,aAAa,EACb,6BAA6B,EAC9B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,WAAW,EACX,cAAc,EACd,cAAc,EACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,WAAW,EACX,cAAc,EACd,cAAc,EACd,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,EACd,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,2BAA2B,EAG3B,0BAA0B,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAGtE,MAAM,MAAM,mCAAmC,GAAG;IAChD,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IAErC,0BAA0B,IAAI,OAAO,CAAC,OAAO,mBAAmB,EAAE,yBAAyB,CAAC,CAAC;IAC7F,kBAAkB,IAAI,OAAO,CAAC,OAAO,uBAAuB,EAAE,eAAe,CAAC,CAAC;IAC/E,yBAAyB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7C,wBAAwB,CACtB,KAAK,EAAE,6BAA6B,EACpC,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;IAC/C,sBAAsB,CACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACvC,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;IAC7C,sBAAsB,CACpB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;IAE7C,cAAc,CACZ,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IACrC,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAChC,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IACxC,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IACxC,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IACpG,gBAAgB,CACd,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IACvC,oBAAoB,CAClB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;IAEpD,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,yBAAyB,GAAG;QACpC,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,GACA,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IAClC,cAAc,CACZ,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,EAC7B,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IACrC,cAAc,CACZ,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAErC,oBAAoB,CAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC3C,oBAAoB,CAClB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC3C,oBAAoB,CAClB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC3C,oBAAoB,CAClB,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAE3C,oBAAoB,CAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC3C,oBAAoB,CAClB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC3C,oBAAoB,CAClB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAC3C,oBAAoB,CAClB,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAE3C,WAAW,CACT,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,aAAa,EACzB,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IAClC,cAAc,CACZ,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,EAC7B,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IACrC,cAAc,CACZ,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAErC,eAAe,CACb,KAAK,EAAE,wBAAwB,EAC/B,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;IACtC,aAAa,CACX,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,wBAAwB,CAAC,EACxC,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IACpC,aAAa,CACX,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,yBAAyB,GAClC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;IAEpC,2BAA2B,CAAC,KAAK,CAAC,EAAE,OAAO,mBAAmB,EAAE,gBAAgB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnH,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,mBAAmB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7G,0BAA0B,CACxB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,mBAAmB,EAAE,gBAAgB,CAAA;KAAE,GACnF,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;IACjD,2BAA2B,CACzB,QAAQ,EAAE,sBAAsB,EAChC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAC9C,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;IAElD,6BAA6B,IAAI,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC;IAClF,YAAY,IAAI,OAAO,CAAC,OAAO,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;CACzE,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mCAAmC,GAC3C,sBAAsB,CAsGxB;AAED,MAAM,MAAM,0CAA0C,GAAG;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,wBAAsB,mCAAmC,CACvD,OAAO,GAAE,0CAA+C,GACvD,OAAO,CAAC,sBAAsB,CAAC,CA2BjC"}

package/dist/admin/create-admin.js

@@ -0,0 +1,102 @@
+import { resolveMemorixAppId } from "../catalog/ids.js";
+import { loadDescriptorSnapshot } from "../store/snapshot.js";
+import { registerEntityDescriptor, removeEntityDescriptor, updateEntityDescriptor, } from "../mutations/entity.js";
+import { addContentType, ensureCollection, planCollectionRename, removeContentType, resolveCollection, updateContentType, } from "../mutations/content-type.js";
+import { addProperty, removeProperty, updateProperty, } from "../mutations/property.js";
+import { createListDescriptor, removeListDescriptor, setEntityDefaultList, updateListDescriptor, } from "../mutations/list.js";
+import { createItemDescriptor, removeItemDescriptor, setEntityDefaultItem, updateItemDescriptor, } from "../mutations/item.js";
+import { addRelation, removeRelation, updateRelation, } from "../mutations/relation.js";
+import { registerMapping, removeMapping, updateMapping, } from "../mutations/mapping.js";
+import { validateMemorixDescriptors } from "../integrity/validate.js";
+import { buildDescriptorGraph, descriptorGraphToMermaid } from "../integrity/graph.js";
+import { applyDescriptorSeedManifest, buildDescriptorSeedManifest, exportDescriptorSeedInputsFromCatalox, importDescriptorSeedInputs, } from "../seeds/index.js";
+import { reconcileDescriptorsWithMongo } from "../reconcile/index.js";
+import { validateMemorixEntityDescriptor } from "../validation/descriptor-validation.js";
+export function createMemorixDescriptorAdmin(options) {
+    const processEnv = options.processEnv ?? process.env;
+    const appId = resolveMemorixAppId({ appId: options.appId }, processEnv);
+    const catalox = options.catalox;
+    const loadSnapshot = () => loadDescriptorSnapshot(catalox);
+    const ctx = {
+        catalox,
+        xronox: options.xronox,
+        env: processEnv,
+        loadSnapshot,
+    };
+    return {
+        appId,
+        catalox,
+        loadSnapshot,
+        validateMemorixDescriptors: () => validateMemorixDescriptors(loadSnapshot),
+        getDescriptorGraph: async () => buildDescriptorGraph(await loadSnapshot()),
+        getDescriptorGraphMermaid: async () => descriptorGraphToMermaid(buildDescriptorGraph(await loadSnapshot())),
+        registerEntityDescriptor: (input, mutationOptions) => registerEntityDescriptor(ctx, input, mutationOptions),
+        updateEntityDescriptor: (entityName, patch, mutationOptions) => updateEntityDescriptor(ctx, entityName, patch, mutationOptions),
+        removeEntityDescriptor: (entityName, mutationOptions) => removeEntityDescriptor(ctx, entityName, mutationOptions),
+        addContentType: (entityName, input, mutationOptions) => addContentType(ctx, entityName, input, mutationOptions),
+        updateContentType: (entityName, key, patch, mutationOptions) => updateContentType(ctx, entityName, key, patch, mutationOptions),
+        removeContentType: (entityName, key, mutationOptions) => removeContentType(ctx, entityName, key, mutationOptions),
+        resolveCollection: (entityName, contentTypeKey) => resolveCollection(ctx, entityName, contentTypeKey),
+        ensureCollection: (entityName, contentTypeKey, mutationOptions) => ensureCollection(ctx, entityName, contentTypeKey, mutationOptions),
+        planCollectionRename: (entityName, contentTypeKey, newCollectionName) => {
+            return loadSnapshot().then((snapshot) => {
+                const entityRaw = snapshot.entityDescriptors[entityName];
+                if (!entityRaw) {
+                    throw new Error(`Entity "${entityName}" not found`);
+                }
+                const entity = validateMemorixEntityDescriptor(entityRaw);
+                return planCollectionRename(entity, contentTypeKey, newCollectionName, processEnv);
+            });
+        },
+        addProperty: (entityName, key, property, mutationOptions) => addProperty(ctx, entityName, key, property, mutationOptions),
+        updateProperty: (entityName, key, patch, mutationOptions) => updateProperty(ctx, entityName, key, patch, mutationOptions),
+        removeProperty: (entityName, key, mutationOptions) => removeProperty(ctx, entityName, key, mutationOptions),
+        createListDescriptor: (input, mutationOptions) => createListDescriptor(ctx, input, mutationOptions),
+        updateListDescriptor: (id, patch, mutationOptions) => updateListDescriptor(ctx, id, patch, mutationOptions),
+        removeListDescriptor: (id, mutationOptions) => removeListDescriptor(ctx, id, mutationOptions),
+        setEntityDefaultList: (entityName, listDescriptorId, mutationOptions) => setEntityDefaultList(ctx, entityName, listDescriptorId, mutationOptions),
+        createItemDescriptor: (input, mutationOptions) => createItemDescriptor(ctx, input, mutationOptions),
+        updateItemDescriptor: (id, patch, mutationOptions) => updateItemDescriptor(ctx, id, patch, mutationOptions),
+        removeItemDescriptor: (id, mutationOptions) => removeItemDescriptor(ctx, id, mutationOptions),
+        setEntityDefaultItem: (entityName, itemDescriptorId, mutationOptions) => setEntityDefaultItem(ctx, entityName, itemDescriptorId, mutationOptions),
+        addRelation: (sourceEntity, relationKey, descriptor, mutationOptions) => addRelation(ctx, sourceEntity, relationKey, descriptor, mutationOptions),
+        updateRelation: (sourceEntity, relationKey, patch, mutationOptions) => updateRelation(ctx, sourceEntity, relationKey, patch, mutationOptions),
+        removeRelation: (sourceEntity, relationKey, mutationOptions) => removeRelation(ctx, sourceEntity, relationKey, mutationOptions),
+        registerMapping: (input, mutationOptions) => registerMapping(ctx, input, mutationOptions),
+        updateMapping: (id, patch, mutationOptions) => updateMapping(ctx, id, patch, mutationOptions),
+        removeMapping: (id, mutationOptions) => removeMapping(ctx, id, mutationOptions),
+        buildDescriptorSeedManifest: async (scope) => buildDescriptorSeedManifest(await loadSnapshot(), scope),
+        exportDescriptorSeedInputs: (dir, scope) => exportDescriptorSeedInputsFromCatalox(catalox, dir, scope),
+        importDescriptorSeedInputs: (dir, importOptions) => importDescriptorSeedInputs(catalox, dir, importOptions),
+        applyDescriptorSeedManifest: (manifest, applyOptions) => applyDescriptorSeedManifest(catalox, manifest, applyOptions),
+        reconcileDescriptorsWithMongo: () => reconcileDescriptorsWithMongo({ catalox, appId, processEnv }),
+    };
+}
+export async function createMemorixDescriptorAdminFromEnv(options = {}) {
+    const { createCataloxFromEnv } = await import("@x12i/catalox/firebase");
+    const processEnv = options.processEnv ?? process.env;
+    const appId = resolveMemorixAppId({ appId: options.appId }, processEnv);
+    const { catalox } = createCataloxFromEnv();
+    const bound = catalox.withContext({
+        appId,
+        actor: { type: "service", id: "memorix-descriptors" },
+        superAdmin: true,
+    });
+    let xronox = options.xronox;
+    if (!xronox) {
+        try {
+            const { createMemorixXronoxFromEnv } = await import("@x12i/memorix-retrieval");
+            xronox = await createMemorixXronoxFromEnv({ processEnv });
+        }
+        catch {
+            xronox = undefined;
+        }
+    }
+    return createMemorixDescriptorAdmin({
+        catalox: bound,
+        xronox,
+        appId,
+        processEnv,
+    });
+}
+//# sourceMappingURL=create-admin.js.map

package/dist/admin/create-admin.js.map

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

package/dist/catalog/ids.d.ts

@@ -0,0 +1,12 @@
+export declare const MEMORIX_APP_ID = "memorix";
+export declare const MEMORIX_ENTITY_DESCRIPTORS_CATALOG = "memorix-entity-descriptors";
+export declare const MEMORIX_LIST_DESCRIPTORS_CATALOG = "memorix-list-descriptors";
+export declare const MEMORIX_ITEM_DESCRIPTORS_CATALOG = "memorix-item-descriptors";
+export declare const MEMORIX_COMPLETION_MAPPINGS_CATALOG = "memorix-completion-mappings";
+export declare const MEMORIX_DESCRIPTOR_CATALOG_IDS: readonly ["memorix-entity-descriptors", "memorix-list-descriptors", "memorix-item-descriptors", "memorix-completion-mappings"];
+export declare function resolveMemorixAppId(options?: {
+    appId?: string;
+}, processEnv?: NodeJS.ProcessEnv): string;
+export declare function defaultIdFieldForTarget(target: import("../types/index.js").MemorixTarget): import("../types/index.js").MemorixIdField;
+export declare function allowedIdFieldsForTarget(target: import("../types/index.js").MemorixTarget): import("../types/index.js").MemorixIdField[];
+//# sourceMappingURL=ids.d.ts.map

package/dist/catalog/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/catalog/ids.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC,eAAO,MAAM,kCAAkC,+BAA+B,CAAC;AAC/E,eAAO,MAAM,gCAAgC,6BAA6B,CAAC;AAC3E,eAAO,MAAM,gCAAgC,6BAA6B,CAAC;AAC3E,eAAO,MAAM,mCAAmC,gCAAgC,CAAC;AAEjF,eAAO,MAAM,8BAA8B,gIAKjC,CAAC;AAEX,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5B,UAAU,GAAE,MAAM,CAAC,UAAwB,GAC1C,MAAM,CAOR;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,mBAAmB,EAAE,aAAa,GAChD,OAAO,mBAAmB,EAAE,cAAc,CAI5C;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,OAAO,mBAAmB,EAAE,aAAa,GAChD,OAAO,mBAAmB,EAAE,cAAc,EAAE,CAI9C"}

package/dist/catalog/ids.js

@@ -0,0 +1,32 @@
+export const MEMORIX_APP_ID = "memorix";
+export const MEMORIX_ENTITY_DESCRIPTORS_CATALOG = "memorix-entity-descriptors";
+export const MEMORIX_LIST_DESCRIPTORS_CATALOG = "memorix-list-descriptors";
+export const MEMORIX_ITEM_DESCRIPTORS_CATALOG = "memorix-item-descriptors";
+export const MEMORIX_COMPLETION_MAPPINGS_CATALOG = "memorix-completion-mappings";
+export const MEMORIX_DESCRIPTOR_CATALOG_IDS = [
+    MEMORIX_ENTITY_DESCRIPTORS_CATALOG,
+    MEMORIX_LIST_DESCRIPTORS_CATALOG,
+    MEMORIX_ITEM_DESCRIPTORS_CATALOG,
+    MEMORIX_COMPLETION_MAPPINGS_CATALOG,
+];
+export function resolveMemorixAppId(options, processEnv = process.env) {
+    return (options?.appId?.trim() ||
+        processEnv.CATALOX_APP_ID?.trim() ||
+        processEnv.MEMORIX_APP_ID?.trim() ||
+        MEMORIX_APP_ID);
+}
+export function defaultIdFieldForTarget(target) {
+    if (target === "event")
+        return "eventId";
+    if (target === "knowledge")
+        return "knowledgeId";
+    return "entityId";
+}
+export function allowedIdFieldsForTarget(target) {
+    if (target === "entity")
+        return ["entityId", "eventId"];
+    if (target === "event")
+        return ["eventId", "entityId"];
+    return ["knowledgeId"];
+}
+//# sourceMappingURL=ids.js.map

package/dist/catalog/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/catalog/ids.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AAExC,MAAM,CAAC,MAAM,kCAAkC,GAAG,4BAA4B,CAAC;AAC/E,MAAM,CAAC,MAAM,gCAAgC,GAAG,0BAA0B,CAAC;AAC3E,MAAM,CAAC,MAAM,gCAAgC,GAAG,0BAA0B,CAAC;AAC3E,MAAM,CAAC,MAAM,mCAAmC,GAAG,6BAA6B,CAAC;AAEjF,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,kCAAkC;IAClC,gCAAgC;IAChC,gCAAgC;IAChC,mCAAmC;CAC3B,CAAC;AAEX,MAAM,UAAU,mBAAmB,CACjC,OAA4B,EAC5B,aAAgC,OAAO,CAAC,GAAG;IAE3C,OAAO,CACL,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE;QACtB,UAAU,CAAC,cAAc,EAAE,IAAI,EAAE;QACjC,UAAU,CAAC,cAAc,EAAE,IAAI,EAAE;QACjC,cAAc,CACf,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,MAAiD;IAEjD,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,aAAa,CAAC;IACjD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAAiD;IAEjD,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACxD,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACvD,OAAO,CAAC,aAAa,CAAC,CAAC;AACzB,CAAC"}

package/dist/catalox/client.d.ts

@@ -0,0 +1,19 @@
+import type { CataloxBound } from "@x12i/catalox";
+import type { MemorixSeedScope } from "../types/index.js";
+export type CataloxBoundClient = CataloxBound;
+export type CatalogItemRecord = {
+    id: string;
+    data: Record<string, unknown>;
+};
+export declare function mergeScopeIntoData(data: Record<string, unknown>, scope?: MemorixSeedScope): Record<string, unknown>;
+export declare function listAllCatalogItems(catalox: CataloxBoundClient, catalogId: string): Promise<CatalogItemRecord[]>;
+export declare function getCatalogItemData(catalox: CataloxBoundClient, catalogId: string, itemId: string): Promise<Record<string, unknown> | null>;
+export declare function upsertCatalogItem(catalox: CataloxBoundClient, catalogId: string, data: Record<string, unknown>, scope?: MemorixSeedScope): Promise<void>;
+export declare function deleteCatalogItem(catalox: CataloxBoundClient, catalogId: string, itemId: string): Promise<void>;
+export declare const CATALOG_BY_KIND: {
+    readonly entity: "memorix-entity-descriptors";
+    readonly list: "memorix-list-descriptors";
+    readonly item: "memorix-item-descriptors";
+    readonly mapping: "memorix-completion-mappings";
+};
+//# sourceMappingURL=client.d.ts.map

package/dist/catalox/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/catalox/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQ1D,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAE9C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,CAAC,EAAE,gBAAgB,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA0B9B;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAMzC;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,CAAC,EAAE,gBAAgB,GACvB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC"}

package/dist/catalox/client.js

@@ -0,0 +1,51 @@
+import { MEMORIX_COMPLETION_MAPPINGS_CATALOG, MEMORIX_ENTITY_DESCRIPTORS_CATALOG, MEMORIX_ITEM_DESCRIPTORS_CATALOG, MEMORIX_LIST_DESCRIPTORS_CATALOG, } from "../catalog/ids.js";
+export function mergeScopeIntoData(data, scope) {
+    if (!scope)
+        return data;
+    return { ...data, scope };
+}
+export async function listAllCatalogItems(catalox, catalogId) {
+    const items = [];
+    let offset = 0;
+    const limit = 200;
+    for (;;) {
+        const page = await catalox.listCatalogItems(catalogId, { limit, offset });
+        if (page.listOutcome === "mapping_blocked") {
+            break;
+        }
+        for (const item of page.items) {
+            items.push({
+                id: String(item.itemId),
+                data: (item.data ?? {}),
+            });
+        }
+        if (!page.nextCursor && page.items.length < limit) {
+            break;
+        }
+        offset += page.items.length;
+        if (page.items.length === 0) {
+            break;
+        }
+    }
+    return items;
+}
+export async function getCatalogItemData(catalox, catalogId, itemId) {
+    const result = await catalox.getCatalogItem(catalogId, itemId);
+    if (result.outcome === "not_found" || result.outcome === "mapping_blocked") {
+        return null;
+    }
+    return (result.item.data ?? {});
+}
+export async function upsertCatalogItem(catalox, catalogId, data, scope) {
+    await catalox.upsertNativeCatalogItem(catalogId, mergeScopeIntoData(data, scope));
+}
+export async function deleteCatalogItem(catalox, catalogId, itemId) {
+    await catalox.deleteNativeCatalogItem(catalogId, itemId);
+}
+export const CATALOG_BY_KIND = {
+    entity: MEMORIX_ENTITY_DESCRIPTORS_CATALOG,
+    list: MEMORIX_LIST_DESCRIPTORS_CATALOG,
+    item: MEMORIX_ITEM_DESCRIPTORS_CATALOG,
+    mapping: MEMORIX_COMPLETION_MAPPINGS_CATALOG,
+};
+//# sourceMappingURL=client.js.map

package/dist/catalox/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/catalox/client.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mCAAmC,EACnC,kCAAkC,EAClC,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,mBAAmB,CAAC;AAS3B,MAAM,UAAU,kBAAkB,CAChC,IAA6B,EAC7B,KAAwB;IAExB,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAA2B,EAC3B,SAAiB;IAEjB,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,KAAK,GAAG,GAAG,CAAC;IAElB,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1E,IAAI,IAAI,CAAC,WAAW,KAAK,iBAAiB,EAAE,CAAC;YAC3C,MAAM;QACR,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;gBACvB,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAA4B;aACnD,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAClD,MAAM;QACR,CAAC;QACD,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAA2B,EAC3B,SAAiB,EACjB,MAAc;IAEd,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC/D,IAAI,MAAM,CAAC,OAAO,KAAK,WAAW,IAAI,MAAM,CAAC,OAAO,KAAK,iBAAiB,EAAE,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAA2B,EAC3B,SAAiB,EACjB,IAA6B,EAC7B,KAAwB;IAExB,MAAM,OAAO,CAAC,uBAAuB,CACnC,SAAS,EACT,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAChC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAA2B,EAC3B,SAAiB,EACjB,MAAc;IAEd,MAAM,OAAO,CAAC,uBAAuB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,kCAAkC;IAC1C,IAAI,EAAE,gCAAgC;IACtC,IAAI,EAAE,gCAAgC;IACtC,OAAO,EAAE,mCAAmC;CACpC,CAAC"}

package/dist/cli/index.d.ts

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

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

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

package/dist/cli/index.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+import { readFile } from "node:fs/promises";
+import { createMemorixDescriptorAdminFromEnv, descriptorGraphToMermaid, } from "../index.js";
+async function main() {
+    const [command, ...args] = process.argv.slice(2);
+    if (!command || command === "--help" || command === "-h") {
+        printHelp();
+        return;
+    }
+    const admin = await createMemorixDescriptorAdminFromEnv();
+    const dryRun = args.includes("--dry-run");
+    const formatIdx = args.indexOf("--format");
+    const format = formatIdx >= 0 ? args[formatIdx + 1] : undefined;
+    switch (command) {
+        case "validate": {
+            const report = await admin.validateMemorixDescriptors();
+            console.log(JSON.stringify(report, null, 2));
+            process.exitCode = report.valid ? 0 : 1;
+            break;
+        }
+        case "reconcile": {
+            const result = await admin.reconcileDescriptorsWithMongo();
+            console.log(JSON.stringify(result, null, 2));
+            break;
+        }
+        case "graph": {
+            const graph = await admin.getDescriptorGraph();
+            if (format === "mermaid") {
+                console.log(descriptorGraphToMermaid(graph));
+            }
+            else {
+                console.log(JSON.stringify(graph, null, 2));
+            }
+            break;
+        }
+        case "entity": {
+            await handleEntityCommand(admin, args, dryRun);
+            break;
+        }
+        case "content-type": {
+            await handleContentTypeCommand(admin, args, dryRun);
+            break;
+        }
+        case "list": {
+            await handleListCommand(admin, args, dryRun);
+            break;
+        }
+        case "item": {
+            await handleItemCommand(admin, args, dryRun);
+            break;
+        }
+        case "mapping": {
+            await handleMappingCommand(admin, args, dryRun);
+            break;
+        }
+        case "seed": {
+            await handleSeedCommand(admin, args, dryRun);
+            break;
+        }
+        default:
+            console.error(`Unknown command: ${command}`);
+            printHelp();
+            process.exitCode = 1;
+    }
+}
+async function handleEntityCommand(admin, args, dryRun) {
+    const [sub, ...rest] = args;
+    if (sub === "register") {
+        const file = readFlag(rest, "--file");
+        if (!file)
+            throw new Error("entity register requires --file");
+        const input = JSON.parse(await readFile(file, "utf8"));
+        const result = await admin.registerEntityDescriptor(input, { dryRun });
+        console.log(JSON.stringify(result, null, 2));
+        process.exitCode = result.ok ? 0 : 1;
+        return;
+    }
+    throw new Error(`Unknown entity subcommand: ${sub ?? "(none)"}`);
+}
+async function handleContentTypeCommand(admin, args, dryRun) {
+    const [sub, entityName, key, ...rest] = args;
+    if (sub === "add") {
+        const postfix = readFlag(rest, "--postfix") ?? key;
+        const result = await admin.addContentType(entityName, { key, postfix }, { dryRun });
+        console.log(JSON.stringify(result, null, 2));
+        process.exitCode = result.ok ? 0 : 1;
+        return;
+    }
+    throw new Error(`Unknown content-type subcommand: ${sub ?? "(none)"}`);
+}
+async function handleListCommand(admin, args, dryRun) {
+    const [sub, ...rest] = args;
+    if (sub === "create") {
+        const file = readFlag(rest, "--file");
+        if (!file)
+            throw new Error("list create requires --file");
+        const input = JSON.parse(await readFile(file, "utf8"));
+        const result = await admin.createListDescriptor(input, { dryRun });
+        console.log(JSON.stringify(result, null, 2));
+        process.exitCode = result.ok ? 0 : 1;
+        return;
+    }
+    if (sub === "update") {
+        const [id, ...tail] = rest;
+        const file = readFlag(tail, "--file");
+        if (!id || !file)
+            throw new Error("list update requires <id> --file");
+        const patch = JSON.parse(await readFile(file, "utf8"));
+        const result = await admin.updateListDescriptor(id, patch, { dryRun });
+        console.log(JSON.stringify(result, null, 2));
+        process.exitCode = result.ok ? 0 : 1;
+        return;
+    }
+    throw new Error(`Unknown list subcommand: ${sub ?? "(none)"}`);
+}
+async function handleItemCommand(admin, args, dryRun) {
+    const [sub, ...rest] = args;
+    if (sub === "update") {
+        const [id, ...tail] = rest;
+        const file = readFlag(tail, "--file");
+        if (!id || !file)
+            throw new Error("item update requires <id> --file");
+        const patch = JSON.parse(await readFile(file, "utf8"));
+        const result = await admin.updateItemDescriptor(id, patch, { dryRun });
+        console.log(JSON.stringify(result, null, 2));
+        process.exitCode = result.ok ? 0 : 1;
+        return;
+    }
+    throw new Error(`Unknown item subcommand: ${sub ?? "(none)"}`);
+}
+async function handleMappingCommand(admin, args, dryRun) {
+    const [sub, ...rest] = args;
+    if (sub === "register") {
+        const file = readFlag(rest, "--file");
+        if (!file)
+            throw new Error("mapping register requires --file");
+        const input = JSON.parse(await readFile(file, "utf8"));
+        const result = await admin.registerMapping(input, { dryRun });
+        console.log(JSON.stringify(result, null, 2));
+        process.exitCode = result.ok ? 0 : 1;
+        return;
+    }
+    throw new Error(`Unknown mapping subcommand: ${sub ?? "(none)"}`);
+}
+async function handleSeedCommand(admin, args, dryRun) {
+    const [sub, dir] = args;
+    if (sub === "export") {
+        if (!dir)
+            throw new Error("seed export requires <dir>");
+        await admin.exportDescriptorSeedInputs(dir);
+        console.log(JSON.stringify({ ok: true, dir }, null, 2));
+        return;
+    }
+    if (sub === "import") {
+        if (!dir)
+            throw new Error("seed import requires <dir>");
+        const result = await admin.importDescriptorSeedInputs(dir, { dryRun });
+        console.log(JSON.stringify(result, null, 2));
+        process.exitCode = result.ok ? 0 : 1;
+        return;
+    }
+    throw new Error(`Unknown seed subcommand: ${sub ?? "(none)"}`);
+}
+function readFlag(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx < 0)
+        return undefined;
+    return args[idx + 1];
+}
+function printHelp() {
+    console.log(`memorix-descriptors — Memorix descriptor management in Catalox
+
+Usage:
+  memorix-descriptors validate
+  memorix-descriptors reconcile
+  memorix-descriptors graph [--format mermaid]
+  memorix-descriptors entity register --file ./new-entity.json [--dry-run]
+  memorix-descriptors content-type add <entity> <key> --postfix <postfix> [--dry-run]
+  memorix-descriptors list create --file ./list.json [--dry-run]
+  memorix-descriptors list update <id> --file ./patch.json [--dry-run]
+  memorix-descriptors item update <id> --file ./patch.json [--dry-run]
+  memorix-descriptors mapping register --file ./mapping.json [--dry-run]
+  memorix-descriptors seed export ./catalox-seeds/inputs
+  memorix-descriptors seed import ./catalox-seeds/inputs [--dry-run]
+`);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map