@x12i/memorix-format 2.0.0 → 2.2.0

package/dist/migrate.js

@@ -0,0 +1,159 @@
+/**
+ * Transform pre-clean / transitional envelopes to present Memorix format.
+ */
+import { buildExtIdentifierKey, DEFAULT_RECORD_STATE, isPlainObject, stringifyId, } from "@x12i/memorix-base-format";
+const DROP_ROOTS = new Set([
+    "identity",
+    "lifecycle",
+    "sourceFacts",
+    "index",
+    "entityId",
+    "eventId",
+    "knowledgeId",
+    "displayName",
+    "question",
+    "answer",
+    "metadata",
+    "graphRunId",
+    "lastJobRunId",
+]);
+function asObject(v) {
+    return isPlainObject(v) ? { ...v } : {};
+}
+function mapLifecycleStatusToState(status) {
+    const s = stringifyId(status)?.toLowerCase();
+    if (!s)
+        return undefined;
+    if (s === "active")
+        return "active";
+    if (s === "archived" || s === "archive" || s === "inactive")
+        return "archived";
+    if (s === "superseded" || s === "replaced" || s === "stale")
+        return "superseded";
+    return undefined;
+}
+function buildLifecycleEvents(legacy) {
+    const lifecycle = asObject(legacy.lifecycle);
+    const createdAt = stringifyId(lifecycle.createdAt);
+    const modifiedAt = stringifyId(lifecycle.modifiedAt) ?? stringifyId(lifecycle.capturedAt);
+    const events = [];
+    if (createdAt && modifiedAt && createdAt !== modifiedAt) {
+        events.push({ process: "created", processedAt: createdAt });
+        events.push({ process: "modified", processedAt: modifiedAt });
+    }
+    else if (createdAt || modifiedAt) {
+        events.push({ process: "enriched", processedAt: (createdAt ?? modifiedAt) });
+    }
+    return events.length > 0 ? events : undefined;
+}
+function migrateExtIdentifier(concept) {
+    if (isPlainObject(concept._extIdentifier)) {
+        const ext = { ...concept._extIdentifier };
+        if (!stringifyId(ext.key) && stringifyId(ext.identifierKey)) {
+            ext.key = String(ext.identifierKey);
+        }
+        delete ext.identifierKey;
+        if (!stringifyId(ext.key)) {
+            const built = buildExtIdentifierKey(ext);
+            if (built)
+                ext.key = built;
+        }
+        return ext;
+    }
+    const identifier = asObject(concept.identifier);
+    if (Object.keys(identifier).length === 0) {
+        return { kind: "recordId", recordId: "unknown", key: "recordId:unknown" };
+    }
+    const ext = { ...identifier };
+    if (stringifyId(ext.identifierKey) && !stringifyId(ext.key)) {
+        ext.key = String(ext.identifierKey);
+    }
+    delete ext.identifierKey;
+    const built = buildExtIdentifierKey(ext);
+    if (built)
+        ext.key = built;
+    return ext;
+}
+function migrateConcept(legacy) {
+    const concept = asObject(legacy.concept);
+    const title = stringifyId(concept.title) ??
+        stringifyId(concept.name) ??
+        stringifyId(legacy.displayName) ??
+        stringifyId(legacy.question) ??
+        "untitled";
+    const out = {
+        _extIdentifier: migrateExtIdentifier(concept),
+        title,
+    };
+    for (const [k, v] of Object.entries(concept)) {
+        if (k === "identifier" || k === "_extIdentifier" || k === "title" || k === "name")
+            continue;
+        if (k.startsWith("_"))
+            continue;
+        out[k] = v;
+    }
+    return out;
+}
+function migrateSystem(legacy) {
+    const system = asObject(legacy._system);
+    const rootLifecycle = asObject(legacy.lifecycle);
+    if (legacy._graphRuns !== undefined)
+        system._graphRuns = legacy._graphRuns;
+    if (legacy._jobTypeRuns !== undefined)
+        system._jobTypeRuns = legacy._jobTypeRuns;
+    const events = buildLifecycleEvents(legacy);
+    if (events)
+        system.lifecycle = events;
+    else if (Array.isArray(system.lifecycle) && system.lifecycle.length === 0) {
+        delete system.lifecycle;
+    }
+    if (system.state === undefined) {
+        const mapped = mapLifecycleStatusToState(rootLifecycle.status);
+        system.state = mapped ?? DEFAULT_RECORD_STATE;
+    }
+    return system;
+}
+/**
+ * Map a legacy / transitional record to the present envelope.
+ * Safe to re-run on already-clean records (fills `_system.state` if missing).
+ */
+export function migrateMemorixRecord(input, _options = {}) {
+    if (!isPlainObject(input)) {
+        throw new Error("migrateMemorixRecord: input must be a plain object");
+    }
+    const legacy = input;
+    const identity = asObject(legacy.identity);
+    const out = {};
+    if (legacy._id !== undefined)
+        out._id = legacy._id;
+    const recordId = stringifyId(legacy.recordId) ??
+        stringifyId(identity.recordId) ??
+        stringifyId(identity.targetId) ??
+        stringifyId(legacy.entityId) ??
+        stringifyId(legacy.eventId) ??
+        stringifyId(legacy.knowledgeId);
+    if (recordId)
+        out.recordId = recordId;
+    out.concept = migrateConcept(legacy);
+    out.data = isPlainObject(legacy.data) ? { ...legacy.data } : {};
+    for (const [key, value] of Object.entries(legacy)) {
+        if (key === "_id" ||
+            key === "recordId" ||
+            key === "concept" ||
+            key === "data" ||
+            key === "_system" ||
+            key === "_graphRuns" ||
+            key === "_jobTypeRuns" ||
+            DROP_ROOTS.has(key)) {
+            continue;
+        }
+        // Open buckets + associated* + custom roots
+        out[key] = value;
+    }
+    out._system = migrateSystem(legacy);
+    return out;
+}
+export function migrateMemorixRecords(records, options = {}) {
+    return records.map((r) => migrateMemorixRecord(r, options));
+}
+//# sourceMappingURL=migrate.js.map

package/dist/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,WAAW,GAGZ,MAAM,2BAA2B,CAAC;AAEnC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,UAAU;IACV,WAAW;IACX,aAAa;IACb,OAAO;IACP,UAAU;IACV,SAAS;IACT,aAAa;IACb,aAAa;IACb,UAAU;IACV,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,cAAc;CACf,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,yBAAyB,CAAC,MAAe;IAChD,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7C,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACpC,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAC/E,IAAI,CAAC,KAAK,YAAY,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,YAAY,CAAC;IACjF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,oBAAoB,CAC3B,MAAkB;IAElB,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC1F,MAAM,MAAM,GAAoD,EAAE,CAAC;IACnE,IAAI,SAAS,IAAI,UAAU,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QACxD,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;IAChE,CAAC;SAAM,IAAI,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,SAAS,IAAI,UAAU,CAAE,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAChD,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAmB;IAC/C,IAAI,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;QAC1C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YAC5D,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,GAAG,CAAC,aAAa,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,KAAK;gBAAE,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC;QAC7B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,kBAAkB,EAAE,CAAC;IAC5E,CAAC;IAED,MAAM,GAAG,GAAe,EAAE,GAAG,UAAU,EAAE,CAAC;IAC1C,IAAI,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC,aAAa,CAAC;IACzB,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,KAAK;QAAE,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC;IAC3B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CAAC,MAAkB;IACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,KAAK,GACT,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;QAC1B,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;QACzB,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC;QAC/B,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC5B,UAAU,CAAC;IAEb,MAAM,GAAG,GAAe;QACtB,cAAc,EAAE,oBAAoB,CAAC,OAAO,CAAC;QAC7C,KAAK;KACN,CAAC;IAEF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,KAAK,YAAY,IAAI,CAAC,KAAK,gBAAgB,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,MAAM;YAAE,SAAS;QAC5F,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAChC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,MAAkB;IACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAEjD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;QAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IAC3E,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS;QAAE,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAEjF,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,MAAM;QAAE,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC;SACjC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1E,OAAO,MAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,yBAAyB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/D,MAAM,CAAC,KAAK,GAAG,MAAM,IAAI,oBAAoB,CAAC;IAChD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAMD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAc,EACd,WAAiC,EAAE;IAEnC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC;IACrB,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE3C,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS;QAAE,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IAEnD,MAAM,QAAQ,GACZ,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC5B,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC9B,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC9B,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC5B,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC;QAC3B,WAAW,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAClC,IAAI,QAAQ;QAAE,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAEtC,GAAG,CAAC,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACrC,GAAG,CAAC,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEhE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IACE,GAAG,KAAK,KAAK;YACb,GAAG,KAAK,UAAU;YAClB,GAAG,KAAK,SAAS;YACjB,GAAG,KAAK,MAAM;YACd,GAAG,KAAK,SAAS;YACjB,GAAG,KAAK,YAAY;YACpB,GAAG,KAAK,cAAc;YACtB,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EACnB,CAAC;YACD,SAAS;QACX,CAAC;QACD,4CAA4C;QAC5C,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnB,CAAC;IAED,GAAG,CAAC,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAAkB,EAClB,UAAgC,EAAE;IAElC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/profiles.d.ts

@@ -1,12 +1,15 @@
 import type { ContentTypeMeta } from "@x12i/memorix-base-format";
-/** Minimal content type — identity + data only (no declared open buckets). */
-export declare function minimalContentTypeMeta(objectType: string, contentType: string): ContentTypeMeta;
+export type MemorixProfileName = "snapshots" | "minimal";
 /**
- * Snapshot-style Memorix profile: known open buckets + allow extra association keys.
- * Association property names are still open buckets to base; profile validates shapes in validate.ts.
+ * Snapshot content-type conventions from meta/content-type-profiles.json + open-buckets.json.
+ * `objectType` is supplied by the caller (descriptor / catalog / write context).
  */
 export declare function snapshotsContentTypeMeta(objectType: string): ContentTypeMeta;
-export type MemorixProfileName = "snapshots" | "minimal";
-export declare function resolveMemorixProfile(name: MemorixProfileName, objectType?: string): ContentTypeMeta;
+/** Minimal content type — identity + data only. */
+export declare function minimalContentTypeMeta(objectType: string, contentType: string): ContentTypeMeta;
+/**
+ * Resolve profile by name, or by content-type vocabulary (meta/content-types.json).
+ */
+export declare function resolveMemorixProfile(name: MemorixProfileName | string, objectType?: string): ContentTypeMeta;
 export declare const BUILTIN_PROFILES: MemorixProfileName[];
 //# sourceMappingURL=profiles.d.ts.map

package/dist/profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../src/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,8EAA8E;AAC9E,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,eAAe,CAQjB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CA6B5E;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,SAAS,CAAC;AAEzD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,kBAAkB,EACxB,UAAU,SAAY,GACrB,eAAe,CAGjB;AAED,eAAO,MAAM,gBAAgB,EAAE,kBAAkB,EAA6B,CAAC"}
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../src/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAOjE,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,SAAS,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAW5E;AAED,mDAAmD;AACnD,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,eAAe,CASjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,kBAAkB,GAAG,MAAM,EACjC,UAAU,SAAY,GACrB,eAAe,CAWjB;AAED,eAAO,MAAM,gBAAgB,EAAE,kBAAkB,EAA6B,CAAC"}

package/dist/profiles.js

@@ -1,52 +1,47 @@
-import { KNOWN_OPEN_BUCKETS } from "./associated.js";
-/** Minimal content type — identity + data only (no declared open buckets). */
+import { knownOpenBucketsFromMeta, loadContentTypeProfilesMeta, loadContentTypesMeta, } from "./load-meta.js";
+/**
+ * Snapshot content-type conventions from meta/content-type-profiles.json + open-buckets.json.
+ * `objectType` is supplied by the caller (descriptor / catalog / write context).
+ */
+export function snapshotsContentTypeMeta(objectType) {
+    const profiles = loadContentTypeProfilesMeta().profiles.snapshots;
+    const openBuckets = knownOpenBucketsFromMeta();
+    return {
+        objectType,
+        contentType: profiles?.contentType ?? "snapshots",
+        collectionPostfix: profiles?.collectionPostfix ?? "snapshots",
+        openBuckets,
+        policy: profiles?.policy ?? { unknownOpenBuckets: "allow", emptyBuckets: "reject" },
+        read: profiles?.read ?? { missingOptionalIsNa: true },
+    };
+}
+/** Minimal content type — identity + data only. */
 export function minimalContentTypeMeta(objectType, contentType) {
+    const profiles = loadContentTypeProfilesMeta().profiles.minimal;
     return {
         objectType,
         contentType,
         collectionPostfix: contentType,
-        policy: { unknownOpenBuckets: "warn", emptyBuckets: "reject" },
-        read: { missingOptionalIsNa: true },
+        policy: profiles?.policy ?? { unknownOpenBuckets: "warn", emptyBuckets: "reject" },
+        read: profiles?.read ?? { missingOptionalIsNa: true },
     };
 }
 /**
- * Snapshot-style Memorix profile: known open buckets + allow extra association keys.
- * Association property names are still open buckets to base; profile validates shapes in validate.ts.
+ * Resolve profile by name, or by content-type vocabulary (meta/content-types.json).
  */
-export function snapshotsContentTypeMeta(objectType) {
-    return {
-        objectType,
-        contentType: "snapshots",
-        collectionPostfix: "snapshots",
-        openBuckets: {
-            analytics: {
-                ...KNOWN_OPEN_BUCKETS.analytics,
-                title: "Analytics",
-                description: "Numeric rollups about linked lists",
-            },
-            enrichment: {
-                ...KNOWN_OPEN_BUCKETS.enrichment,
-                title: "Enrichment",
-                description: "External / prior-system sourced values",
-            },
-            insights: {
-                ...KNOWN_OPEN_BUCKETS.insights,
-                title: "Insights",
-                description: "Interpreted judgments and recommendations",
-            },
-        },
-        policy: {
-            // Allow associated* and other custom open buckets without listing every name
-            unknownOpenBuckets: "allow",
-            emptyBuckets: "reject",
-        },
-        read: { missingOptionalIsNa: true },
-    };
-}
 export function resolveMemorixProfile(name, objectType = "generic") {
     if (name === "snapshots")
         return snapshotsContentTypeMeta(objectType);
-    return minimalContentTypeMeta(objectType, name === "minimal" ? "events" : name);
+    if (name === "minimal")
+        return minimalContentTypeMeta(objectType, "events");
+    const ctMeta = loadContentTypesMeta().contentTypes[name];
+    if (ctMeta?.profile === "snapshots")
+        return snapshotsContentTypeMeta(objectType);
+    if (ctMeta?.profile === "workflow") {
+        // Workflow uses a separate document format; treat as minimal for envelope checks.
+        return minimalContentTypeMeta(objectType, "workflow");
+    }
+    return minimalContentTypeMeta(objectType, name);
 }
 export const BUILTIN_PROFILES = ["snapshots", "minimal"];
 //# sourceMappingURL=profiles.js.map

package/dist/profiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../src/profiles.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,8EAA8E;AAC9E,MAAM,UAAU,sBAAsB,CACpC,UAAkB,EAClB,WAAmB;IAEnB,OAAO;QACL,UAAU;QACV,WAAW;QACX,iBAAiB,EAAE,WAAW;QAC9B,MAAM,EAAE,EAAE,kBAAkB,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE;QAC9D,IAAI,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE;KACpC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAAkB;IACzD,OAAO;QACL,UAAU;QACV,WAAW,EAAE,WAAW;QACxB,iBAAiB,EAAE,WAAW;QAC9B,WAAW,EAAE;YACX,SAAS,EAAE;gBACT,GAAG,kBAAkB,CAAC,SAAS;gBAC/B,KAAK,EAAE,WAAW;gBAClB,WAAW,EAAE,oCAAoC;aAClD;YACD,UAAU,EAAE;gBACV,GAAG,kBAAkB,CAAC,UAAU;gBAChC,KAAK,EAAE,YAAY;gBACnB,WAAW,EAAE,wCAAwC;aACtD;YACD,QAAQ,EAAE;gBACR,GAAG,kBAAkB,CAAC,QAAQ;gBAC9B,KAAK,EAAE,UAAU;gBACjB,WAAW,EAAE,2CAA2C;aACzD;SACF;QACD,MAAM,EAAE;YACN,6EAA6E;YAC7E,kBAAkB,EAAE,OAAO;YAC3B,YAAY,EAAE,QAAQ;SACvB;QACD,IAAI,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE;KACpC,CAAC;AACJ,CAAC;AAID,MAAM,UAAU,qBAAqB,CACnC,IAAwB,EACxB,UAAU,GAAG,SAAS;IAEtB,IAAI,IAAI,KAAK,WAAW;QAAE,OAAO,wBAAwB,CAAC,UAAU,CAAC,CAAC;IACtE,OAAO,sBAAsB,CAAC,UAAU,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAyB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC"}
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../src/profiles.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAIxB;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAAkB;IACzD,MAAM,QAAQ,GAAG,2BAA2B,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;IAClE,MAAM,WAAW,GAAG,wBAAwB,EAAE,CAAC;IAC/C,OAAO;QACL,UAAU;QACV,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,WAAW;QACjD,iBAAiB,EAAE,QAAQ,EAAE,iBAAiB,IAAI,WAAW;QAC7D,WAAW;QACX,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE;QACnF,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE;KACtD,CAAC;AACJ,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,sBAAsB,CACpC,UAAkB,EAClB,WAAmB;IAEnB,MAAM,QAAQ,GAAG,2BAA2B,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;IAChE,OAAO;QACL,UAAU;QACV,WAAW;QACX,iBAAiB,EAAE,WAAW;QAC9B,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE;QAClF,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE;KACtD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAiC,EACjC,UAAU,GAAG,SAAS;IAEtB,IAAI,IAAI,KAAK,WAAW;QAAE,OAAO,wBAAwB,CAAC,UAAU,CAAC,CAAC;IACtE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,sBAAsB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE5E,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,MAAM,EAAE,OAAO,KAAK,WAAW;QAAE,OAAO,wBAAwB,CAAC,UAAU,CAAC,CAAC;IACjF,IAAI,MAAM,EAAE,OAAO,KAAK,UAAU,EAAE,CAAC;QACnC,kFAAkF;QAClF,OAAO,sBAAsB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,sBAAsB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAyB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC"}

package/dist/types.d.ts

@@ -1,5 +1,6 @@
 /** Re-export base types plus Memorix profile options. */
-export type { ContentTypeMeta, JsonObject, MemorixBaseRecord, MemorixConcept, MemorixConceptIdentifier, MemorixLifecycleEvent, MemorixSystemBlock, OpenBucketDecl, OpenBucketKind, RecordInspection, RootCategory, ValidateBaseOptions, ValidateBaseResult, ValidationIssue, ValidationSeverity, } from "@x12i/memorix-base-format";
+export type { ContentTypeMeta, JsonObject, MemorixBaseRecord, MemorixConcept, MemorixConceptIdentifier, MemorixExtIdentifier, MemorixLifecycleEvent, MemorixRecordState, MemorixSystemBlock, OpenBucketDecl, OpenBucketKind, RecordInspection, RootCategory, ValidateBaseOptions, ValidateBaseResult, ValidationIssue, ValidationSeverity, } from "@x12i/memorix-base-format";
+export { MEMORIX_RECORD_STATES } from "@x12i/memorix-base-format";
 import type { MemorixBaseRecord } from "@x12i/memorix-base-format";
 /** Alias for MemorixBaseRecord (compatibility with 1.x). */
 export type MemorixRecord = MemorixBaseRecord;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,YAAY,EACV,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE9C,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,YAAY,EACV,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE9C,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types.js

@@ -1,2 +1,2 @@
-export {};
+export { MEMORIX_RECORD_STATES } from "@x12i/memorix-base-format";
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAExB,MAAM,2BAA2B,CAAC;AAKnC,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE/E,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,GAAG;IACzD,gDAAgD;IAChD,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAeF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,sBAA2B,GACnC,kBAAkB,CA0EpB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAAE,EAClB,OAAO,GAAE,sBAA2B,GACnC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAGhD"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EAExB,MAAM,2BAA2B,CAAC;AAMnC,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE/E,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,GAAG;IACzD,gDAAgD;IAChD,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAeF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,sBAA2B,GACnC,kBAAkB,CA0EpB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAAE,EAClB,OAAO,GAAE,sBAA2B,GACnC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAGhD"}

package/dist/validate.js

@@ -1,5 +1,5 @@
 import { validateMemorixBaseRecord, } from "@x12i/memorix-base-format";
-import { isAssociatedPropertyName, isLegacyAssociatedPropertyName, } from "./associated.js";
+import { isAssociatedPropertyName, isLegacyAssociatedPropertyName, KNOWN_OPEN_BUCKETS, } from "./associated.js";
 import { resolveMemorixProfile } from "./profiles.js";
 function issue(path, code, message, severity = "error") {
     return { path, code, message, severity };
@@ -52,7 +52,7 @@ export function validateMemorixRecord(input, options = {}) {
         }
     }
     if (!isSnapshot) {
-        for (const bucket of ["analytics", "enrichment", "insights"]) {
+        for (const bucket of Object.keys(KNOWN_OPEN_BUCKETS)) {
             if (input[bucket] !== undefined) {
                 issues.push(issue(bucket, "SCOPE-2", `${bucket} SHOULD be omitted on non-snapshot content types unless opted in`));
             }

package/dist/validate.js.map

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

package/docs/memorix-format-requirements.md

@@ -49,4 +49,6 @@ These names are **Memorix declarations**, not base-reserved keys. Base classifie
 
 **TOOL-3.** `validateMemorixRecord` = `validateMemorixBaseRecord` + profile/ASSOC/SCOPE.
 
+**TOOL-4.** `migrateMemorixRecord` / CLI `migrate` transforms legacy/transitional envelopes to the present format and SHOULD validate the result.
+
 Built-in profiles: `snapshots`, `minimal` (`--profile=`).

package/docs/memorix-format.md

@@ -1,14 +1,15 @@
 # Memorix Record Format
 
-> **Package split (2.0):** Core envelope → [`@x12i/memorix-base-format`](https://www.npmjs.com/package/@x12i/memorix-base-format).  
+> **Package split:** Core envelope → [`@x12i/memorix-base-format`](https://www.npmjs.com/package/@x12i/memorix-base-format).  
 > Product open buckets / associations → this package (`@x12i/memorix-format`).  
-> Requirements: [memorix-format-requirements.md](./memorix-format-requirements.md).
+> Requirements: [memorix-format-requirements.md](./memorix-format-requirements.md).  
+> Migrate legacy records: `npx memorix-format migrate ./records/`.
 
 ## Purpose
 
 A Memorix record is a structured memory object: a stable envelope around domain payload, with clear separation between business data, derived analytics, external enrichment, AI insights, and cross-entity references.
 
-The clean format removes the legacy 2.0 `identity` block, root-level `lifecycle`, `sourceFacts`, and redundant `concept.name`. Every field belongs in exactly one place.
+**Present envelope:** `recordId`, `concept` (`title` + `_extIdentifier`), `data`, optional open buckets (`analytics`, `enrichment`, `insights`, `associated*`, …), and `_…` machine roots (`_system.state`, `_system.lifecycle`, …). Open-bucket **names** are not closed — base does not reserve product names.
 
 ---
 
@@ -17,39 +18,34 @@ The clean format removes the legacy 2.0 `identity` block, root-level `lifecycle`
 ```ts
 type MemorixRecord = {
   _id?: string;              // MongoDB document id (storage only)
-  recordId: string;          // stable logical record id
-  concept: MemorixConcept;
-  data: JsonObject;           // required — see data bucket rules
+  recordId: string;          // join plumbing across content types (same subject)
+  concept: {
+    _extIdentifier: { kind: string; key: string; [kindValue: string]: string };
+    title: string;
+    // other human/LLM-readable fields allowed
+  };
+  data: JsonObject;           // required — native facts
 
   analytics?: JsonObject;
   enrichment?: JsonObject;
   insights?: JsonObject;
-  associatedData?: JsonObject[];
-  associatedDiscovery?: JsonObject[];
-  associatedAnalysis?: JsonObject[];
-  associatedSiblings?: JsonObject[];
-  associatedChildren?: JsonObject[];
-  // associated<CustomName>?: JsonObject[];
-
-  _system?: MemorixSystemBlock;
+  // associated…?: JsonObject[];
+
+  _system?: {
+    state?: "active" | "archived" | "superseded";
+    lifecycle?: Array<{ process: string; processedAt: string }>;
+    // …
+  };
 };
 ```
 
-Associated properties use the reserved `associated` prefix. **Legacy** names (`associatedData`, `associatedDiscovery`, …) remain on existing data. **v2** names follow `associated<ObjectType><ContentType>` — see [memorix-pipeline/docs/association-format.md](../memorix-pipeline/docs/association-format.md).
+Associated properties use the reserved `associated` prefix. **Legacy** short names (`associatedData`, …) may still appear. Prefer `associated<ObjectType><ContentType>` — see [association-format.md](./association-format.md).
 
-The root holds only `_id`, `recordId`, `concept`, the data buckets, associated properties, and `_system`. No other top-level keys.
+Human/LLM readers SHOULD omit root `_…` and `concept._extIdentifier` by default; keep `recordId` for joins.
 
-### Removed from 2.0
-
-| Legacy field | Fate |
-|---|---|
-| `identity` (`target`, `targetId`, `objectType`, `contentType`, `version`) | Dropped; `recordId` is root-level |
-| Root `lifecycle` (`createdAt`, `modifiedAt`, `capturedAt`, `status`) | Replaced by `_system.lifecycle` event array |
-| `sourceFacts` | Promoted into `data` or `associatedData` |
-| `concept.name` | Dropped; use `concept.identifier` + `concept.title` |
-| Root `_graphRuns` / `_jobTypeRuns` | Moved to `_system` |
+### Migrate tooling (not format law)
 
-`objectType` is implied by collection name. `contentType` and `version` were constant across all records and are not carried forward.
+Use `memorix-format migrate` to convert older envelopes (`identity`, root `lifecycle`, `concept.identifier`, root `_graphRuns`, …) into the present shape. Do not encode past roots in envelope meta.
 
 ---
 

package/examples/valid-snapshot.json

@@ -1,10 +1,10 @@
 {
   "recordId": "69d216ed358778e93215787e",
   "concept": {
-    "identifier": {
+    "_extIdentifier": {
       "kind": "pluginId",
       "pluginId": "142594",
-      "identifierKey": "pluginId:142594"
+      "key": "pluginId:142594"
     },
     "title": "Oracle WebLogic Server RCE (CVE-2020-14882)"
   },
@@ -22,6 +22,7 @@
     "exploitability": { "level": "HIGH", "confidence": 0.92 }
   },
   "_system": {
+    "state": "active",
     "lifecycle": [
       { "process": "enriched", "processedAt": "2026-04-05T08:01:15.511Z" }
     ]

package/meta/associated-conventions.json

@@ -0,0 +1,59 @@
+{
+  "$schemaNote": "Associated* naming conventions + legacy short names. No objectType bindings.",
+  "version": "2.1.0",
+  "prefix": "associated",
+  "defaultTopMaxItems": 5,
+  "legacyNames": [
+    "associatedData",
+    "associatedDiscovery",
+    "associatedAnalysis",
+    "associatedSiblings",
+    "associatedChildren",
+    "associatedAssets",
+    "associatedSubnets"
+  ],
+  "namingForms": [
+    {
+      "form": "content",
+      "pattern": "associated[Top?]<ObjectType><ContentType>",
+      "kind": "linked-payloads",
+      "shape": "array-of-objects"
+    },
+    {
+      "form": "enrichment",
+      "pattern": "associated[Top?]<ObjectType>Enrichment",
+      "kind": "linked-payloads",
+      "shape": "array-of-objects"
+    },
+    {
+      "form": "snapshotsRootProperty",
+      "pattern": "associated[Top?]<ObjectType>Snapshots<RootProperty>",
+      "kind": "linked-payloads",
+      "shape": "array-of-objects"
+    },
+    {
+      "form": "concepts",
+      "pattern": "associated[Top?]<ObjectType>Concepts",
+      "kind": "linked-payloads",
+      "shape": "array-of-objects"
+    },
+    {
+      "form": "recordIds",
+      "pattern": "associated[Top?]<ObjectType>RecordIds",
+      "kind": "linked-payloads",
+      "shape": "array-of-objects"
+    },
+    {
+      "form": "customDomain",
+      "pattern": "associated<CustomName>",
+      "kind": "linked-payloads",
+      "shape": "array-of-objects",
+      "examples": ["associatedTopology", "associatedCompliance"]
+    }
+  ],
+  "rules": {
+    "ASSOC-2": "when present MUST be an array",
+    "ASSOC-3": "MUST be omitted when empty — never []",
+    "ASSOC-6": "resolution MUST be snapshot-first (match *-snapshots, then content by recordId)"
+  }
+}

package/meta/content-type-profiles.json

@@ -0,0 +1,27 @@
+{
+  "$schemaNote": "Content-type profiles (policies). objectType is filled by the caller — never hardcoded here.",
+  "version": "2.1.0",
+  "profiles": {
+    "snapshots": {
+      "contentType": "snapshots",
+      "collectionPostfix": "snapshots",
+      "openBucketsRef": "open-buckets.json",
+      "policy": {
+        "unknownOpenBuckets": "allow",
+        "emptyBuckets": "reject"
+      },
+      "read": {
+        "missingOptionalIsNa": true
+      }
+    },
+    "minimal": {
+      "policy": {
+        "unknownOpenBuckets": "warn",
+        "emptyBuckets": "reject"
+      },
+      "read": {
+        "missingOptionalIsNa": true
+      }
+    }
+  }
+}

package/meta/content-types.json

@@ -0,0 +1,68 @@
+{
+  "$schemaNote": "Content-type vocabulary used by Memorix. Not object types. Aligned with managed Catalox entity descriptors + product vocabulary.",
+  "version": "2.1.0",
+  "canonicalContentType": "snapshots",
+  "contentTypes": {
+    "snapshots": {
+      "profile": "snapshots",
+      "description": "Full readable object view — may carry known open buckets and associated*"
+    },
+    "discovery": {
+      "profile": "minimal",
+      "description": "Discovery / Q&A style content"
+    },
+    "analysis": {
+      "profile": "minimal",
+      "description": "Analysis content"
+    },
+    "decisions": {
+      "profile": "minimal",
+      "description": "Decision content",
+      "collectionPostfixVariants": ["decision", "decisions"]
+    },
+    "scoped": {
+      "profile": "minimal",
+      "description": "Scoped slice"
+    },
+    "legacy": {
+      "profile": "minimal",
+      "description": "Quarantined / legacy slice"
+    },
+    "narratives": {
+      "profile": "minimal",
+      "description": "Narrative records"
+    },
+    "narrative-steps": {
+      "profile": "minimal",
+      "description": "Narrative step records"
+    },
+    "workflow": {
+      "profile": "workflow",
+      "description": "Product workflow overlay (memorix-workflow/1) — not the snapshot envelope"
+    },
+    "extrated": {
+      "profile": "minimal",
+      "description": "Extracted document content (managed key spelling as in Catalox descriptors)"
+    },
+    "chunks": {
+      "profile": "minimal",
+      "description": "Document chunks"
+    },
+    "ai-processing": {
+      "profile": "minimal",
+      "description": "Product vocabulary — optional CT"
+    },
+    "context": {
+      "profile": "minimal",
+      "description": "Product vocabulary — optional CT"
+    },
+    "suggested-plans": {
+      "profile": "minimal",
+      "description": "Product vocabulary — optional CT"
+    },
+    "suggested-actions": {
+      "profile": "minimal",
+      "description": "Product vocabulary — optional CT"
+    }
+  }
+}