@x12i/memorix-format 2.3.2 → 3.0.0

package/README.md

@@ -1,21 +1,13 @@
 # @x12i/memorix-format
 
-Memorix record format package.
+Canonical **memorix-record/2** validation, migration, and CLI for Memorix.
 
-| Era | API | Status |
-|---|---|---|
-| **memorix-record/2** | `validateMemorixRecordV2`, `migratePresentToV2`, CLI `validate-v2` / `migrate-to-v2` | **Gate G2 SoT** for new platform work |
-| Present | `validateMemorixRecord`, CLI `validate` / `migrate` | Migration source; writer default until `MEMORIX_RECORD_FORMAT=v2` |
+| API | Status |
+|---|---|
+| `validateMemorixRecordV2`, CLI `validate-v2` / `migrate-to-v2` | **Current** SoT for platform work |
+| Present-envelope helpers | Migration/compat only |
 
-Present envelope helpers still come from [`@x12i/memorix-base-format`](https://www.npmjs.com/package/@x12i/memorix-base-format) (temporary; folding into this package per Phase 0 deletion ledger).
-
-**Object types belong in agent metadata / Catalox, not here.**
-
-Docs:
-
-- [docs/memorix-record-v2.md](./docs/memorix-record-v2.md) — V2 contract
-- [docs/memorix-format.md](./docs/memorix-format.md) — present + pointers
-- Golden V2 examples: [examples/v2/](./examples/v2/)
+Object types belong in **agent metadata**, not in this package.
 
 ## Install
 
@@ -54,12 +46,15 @@ npx memorix-format migrate-to-v2 ./present.json \
   --object-type=work-items --content-type=snapshots --data-category=entity
 ```
 
-## Present envelope (migration)
+## Docs
 
-Still documented for existing data. Open buckets: `analytics`, `enrichment`, `insights`, `associated*` (copied payloads — **rejected on V2**).
+- [docs/memorix-record-v2.md](./docs/memorix-record-v2.md)
+- Ebook: [Format for Dummies](../new-ebooks/01-format-for-dummies/)
 
-## Writer flag
+**Exports:** `.` · `./validate` · `./profiles` · `./types` · `./v2`
 
-```bash
-MEMORIX_RECORD_FORMAT=v2
-```
+V2 rejects copied related-record payloads. Authoritative navigation is four-field relationship links (see `@x12i/memorix-relationships`).
+
+---
+
+**Ebooks:** [https://ebooks.memorix.x12i.com](https://ebooks.memorix.x12i.com) · in-repo [`../new-ebooks/`](../new-ebooks/)

package/dist/associated.d.ts

@@ -1,9 +1,9 @@
 /**
  * Memorix product open-bucket helpers — conventions from meta/*.json.
- * Base envelope rules live in @x12i/memorix-base-format.
+ * Base envelope rules live in ./base.
  */
 export declare const LEGACY_ASSOCIATED_NAMES: Set<string>;
-export declare const KNOWN_OPEN_BUCKETS: Record<string, import("@x12i/memorix-base-format").OpenBucketDecl>;
+export declare const KNOWN_OPEN_BUCKETS: Record<string, import("./types.js").OpenBucketDecl>;
 export declare const DEFAULT_TOP_ASSOCIATED_ITEMS: number;
 export declare function isAssociatedPropertyName(name: string): boolean;
 export declare function isLegacyAssociatedPropertyName(name: string): boolean;

package/dist/associated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"associated.d.ts","sourceRoot":"","sources":["../src/associated.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,eAAO,MAAM,uBAAuB,aAAsC,CAAC;AAE3E,eAAO,MAAM,kBAAkB,oEAA6B,CAAC;AAE7D,eAAO,MAAM,4BAA4B,QAAoC,CAAC;AAE9E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExE;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,MAAM,MAAM,2BAA2B,GACnC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1F;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAmBtF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAElF"}
+{"version":3,"file":"associated.d.ts","sourceRoot":"","sources":["../src/associated.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,eAAO,MAAM,uBAAuB,aAAsC,CAAC;AAE3E,eAAO,MAAM,kBAAkB,qDAA6B,CAAC;AAE7D,eAAO,MAAM,4BAA4B,QAAoC,CAAC;AAE9E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExE;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,MAAM,MAAM,2BAA2B,GACnC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1F;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAmBtF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAElF"}

package/dist/associated.js

@@ -1,6 +1,6 @@
 /**
  * Memorix product open-bucket helpers — conventions from meta/*.json.
- * Base envelope rules live in @x12i/memorix-base-format.
+ * Base envelope rules live in ./base.
  */
 import { loadAssociatedConventionsMeta, knownOpenBucketsFromMeta, } from "./load-meta.js";
 const associatedMeta = loadAssociatedConventionsMeta();

package/dist/base/classify.d.ts

@@ -0,0 +1,6 @@
+import type { RootCategory } from "./types.js";
+/** Classify a root key into the four base categories (ENV-2). */
+export declare function classifyRootKey(key: string): RootCategory;
+export declare function isSystemRootKey(key: string): boolean;
+export declare function isOpenBucketKey(key: string): boolean;
+//# sourceMappingURL=classify.d.ts.map

package/dist/base/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/base/classify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAKzD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/base/classify.js

@@ -0,0 +1,18 @@
+import { CORE_ROOT_KEYS, IDENTITY_ROOT_KEYS, SYSTEM_KEY_PREFIX } from "./constants.js";
+/** Classify a root key into the four base categories (ENV-2). */
+export function classifyRootKey(key) {
+    if (IDENTITY_ROOT_KEYS.has(key))
+        return "identity";
+    if (CORE_ROOT_KEYS.has(key))
+        return "core";
+    if (key.startsWith(SYSTEM_KEY_PREFIX))
+        return "system";
+    return "open";
+}
+export function isSystemRootKey(key) {
+    return key.startsWith(SYSTEM_KEY_PREFIX);
+}
+export function isOpenBucketKey(key) {
+    return classifyRootKey(key) === "open";
+}
+//# sourceMappingURL=classify.js.map

package/dist/base/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/base/classify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGvF,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAK,kBAAkC,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IACpE,IAAK,cAA8B,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IAC5D,IAAI,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAAE,OAAO,QAAQ,CAAC;IACvD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,eAAe,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC;AACzC,CAAC"}

package/dist/base/compat/legacy-roots.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Compat-only lists of pre-clean envelope roots.
+ * NOT format law — used by migrators and optional writer guards.
+ */
+export declare const LEGACY_ROOT_KEYS: readonly ["identity", "lifecycle", "sourceFacts", "index"];
+/** Root _-keys that belong under `_system` in the present envelope. */
+export declare const LEGACY_SYSTEM_ROOT_KEYS: readonly ["_graphRuns", "_jobTypeRuns"];
+export type LegacyRootKey = (typeof LEGACY_ROOT_KEYS)[number];
+export type LegacySystemRootKey = (typeof LEGACY_SYSTEM_ROOT_KEYS)[number];
+export declare function isLegacyRootKey(key: string): boolean;
+export declare function isLegacySystemRootKey(key: string): boolean;
+/**
+ * Emit validation issues for legacy roots present on a record.
+ * Used when `allowLegacyEnvelope` / writer guard / migrator pre-checks need them.
+ */
+export declare function collectLegacyRootIssues(keys: string[], options?: {
+    asWarning?: boolean;
+}): Array<{
+    path: string;
+    code: string;
+    message: string;
+    severity: "error" | "warning";
+}>;
+//# sourceMappingURL=legacy-roots.d.ts.map

package/dist/base/compat/legacy-roots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-roots.d.ts","sourceRoot":"","sources":["../../../src/base/compat/legacy-roots.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,4DAKnB,CAAC;AAEX,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,yCAA0C,CAAC;AAE/E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9D,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACpC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,CAAC,CA2BvF"}

package/dist/base/compat/legacy-roots.js

@@ -0,0 +1,50 @@
+/**
+ * Compat-only lists of pre-clean envelope roots.
+ * NOT format law — used by migrators and optional writer guards.
+ */
+export const LEGACY_ROOT_KEYS = [
+    "identity",
+    "lifecycle",
+    "sourceFacts",
+    "index",
+];
+/** Root _-keys that belong under `_system` in the present envelope. */
+export const LEGACY_SYSTEM_ROOT_KEYS = ["_graphRuns", "_jobTypeRuns"];
+export function isLegacyRootKey(key) {
+    return LEGACY_ROOT_KEYS.includes(key);
+}
+export function isLegacySystemRootKey(key) {
+    return LEGACY_SYSTEM_ROOT_KEYS.includes(key);
+}
+/**
+ * Emit validation issues for legacy roots present on a record.
+ * Used when `allowLegacyEnvelope` / writer guard / migrator pre-checks need them.
+ */
+export function collectLegacyRootIssues(keys, options = {}) {
+    const severity = options.asWarning ? "warning" : "error";
+    const issues = [];
+    for (const key of keys) {
+        if (isLegacyRootKey(key)) {
+            issues.push({
+                path: key,
+                code: "COMPAT-legacy-root",
+                message: options.asWarning
+                    ? `${key} is a legacy root field`
+                    : `${key} MUST NOT be written (legacy root; migrate first)`,
+                severity,
+            });
+        }
+        if (isLegacySystemRootKey(key)) {
+            issues.push({
+                path: key,
+                code: "COMPAT-legacy-system-root",
+                message: options.asWarning
+                    ? `${key} belongs under _system`
+                    : `${key} MUST NOT be a root key; use _system.${key}`,
+                severity,
+            });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=legacy-roots.js.map

package/dist/base/compat/legacy-roots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-roots.js","sourceRoot":"","sources":["../../../src/base/compat/legacy-roots.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU;IACV,WAAW;IACX,aAAa;IACb,OAAO;CACC,CAAC;AAEX,uEAAuE;AACvE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,YAAY,EAAE,cAAc,CAAU,CAAC;AAK/E,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAQ,gBAAsC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,OAAQ,uBAA6C,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAc,EACd,UAAmC,EAAE;IAErC,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IACzD,MAAM,MAAM,GACV,EAAE,CAAC;IACL,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,GAAG;gBACT,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,OAAO,CAAC,SAAS;oBACxB,CAAC,CAAC,GAAG,GAAG,yBAAyB;oBACjC,CAAC,CAAC,GAAG,GAAG,mDAAmD;gBAC7D,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;QACD,IAAI,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,GAAG;gBACT,IAAI,EAAE,2BAA2B;gBACjC,OAAO,EAAE,OAAO,CAAC,SAAS;oBACxB,CAAC,CAAC,GAAG,GAAG,wBAAwB;oBAChC,CAAC,CAAC,GAAG,GAAG,wCAAwC,GAAG,EAAE;gBACvD,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/base/concept.d.ts

@@ -0,0 +1,21 @@
+import type { JsonObject, MemorixExtIdentifier } from "./types.js";
+/** Build deterministic external key string from an ext-identifier object. */
+export declare function buildExtIdentifierKey(identifier: Record<string, unknown>): string | null;
+/** @deprecated Use buildExtIdentifierKey */
+export declare const buildIdentityString: typeof buildExtIdentifierKey;
+export declare function buildExtIdentifier(kind: string, value: string, extra?: Record<string, string>): MemorixExtIdentifier;
+/** @deprecated Use buildExtIdentifier */
+export declare function buildConceptIdentifier(kind: string, value: string, extra?: Record<string, string>): MemorixExtIdentifier;
+export declare function readRecordId(record: JsonObject): string;
+export declare function readConceptExtIdentifier(record: JsonObject): {
+    kind: string;
+    value: string;
+    key?: string;
+} | null;
+/** @deprecated Use readConceptExtIdentifier */
+export declare function readConceptIdentifier(record: JsonObject): {
+    kind: string;
+    value: string;
+} | null;
+export declare function readConceptTitle(record: JsonObject): string | undefined;
+//# sourceMappingURL=concept.d.ts.map

package/dist/base/concept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept.d.ts","sourceRoot":"","sources":["../../src/base/concept.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAMnE,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAoBxF;AAED,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,8BAAwB,CAAC;AAEzD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACjC,oBAAoB,CAStB;AAED,yCAAyC;AACzC,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACjC,oBAAoB,CAEtB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAQvD;AASD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,UAAU,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAatD;AAED,+CAA+C;AAC/C,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGxC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAIvE"}

package/dist/base/concept.js

@@ -0,0 +1,87 @@
+import { isPlainObject, stringifyId } from "./utils.js";
+const KEY_FIELD = "key";
+const LEGACY_KEY_FIELD = "identifierKey";
+/** Build deterministic external key string from an ext-identifier object. */
+export function buildExtIdentifierKey(identifier) {
+    const kind = stringifyId(identifier.kind);
+    if (!kind)
+        return null;
+    if (identifier[kind] != null) {
+        const extras = Object.keys(identifier)
+            .filter((k) => k !== "kind" && k !== KEY_FIELD && k !== LEGACY_KEY_FIELD && k !== kind)
+            .sort()
+            .map((k) => String(identifier[k]));
+        if (extras.length === 0)
+            return `${kind}:${String(identifier[kind])}`;
+        return [kind, String(identifier[kind]), ...extras].join(":");
+    }
+    const parts = Object.keys(identifier)
+        .filter((k) => k !== "kind" && k !== KEY_FIELD && k !== LEGACY_KEY_FIELD)
+        .sort()
+        .map((k) => String(identifier[k]));
+    if (parts.length === 0)
+        return null;
+    return [kind, ...parts].join(":");
+}
+/** @deprecated Use buildExtIdentifierKey */
+export const buildIdentityString = buildExtIdentifierKey;
+export function buildExtIdentifier(kind, value, extra = {}) {
+    const identifier = {
+        kind,
+        [kind]: value,
+        ...extra,
+        key: "",
+    };
+    identifier.key = buildExtIdentifierKey(identifier) ?? `${kind}:${value}`;
+    return identifier;
+}
+/** @deprecated Use buildExtIdentifier */
+export function buildConceptIdentifier(kind, value, extra = {}) {
+    return buildExtIdentifier(kind, value, extra);
+}
+export function readRecordId(record) {
+    const root = stringifyId(record.recordId);
+    if (root)
+        return root;
+    const identity = record.identity;
+    if (isPlainObject(identity)) {
+        return stringifyId(identity.recordId) ?? stringifyId(identity.targetId) ?? "";
+    }
+    return stringifyId(record._id) ?? "";
+}
+function readExtIdentifierObject(concept) {
+    if (isPlainObject(concept._extIdentifier))
+        return concept._extIdentifier;
+    // Compat read during migration / transitional tooling
+    if (isPlainObject(concept.identifier))
+        return concept.identifier;
+    return null;
+}
+export function readConceptExtIdentifier(record) {
+    const concept = record.concept;
+    if (!isPlainObject(concept))
+        return null;
+    const identifier = readExtIdentifierObject(concept);
+    if (!identifier)
+        return null;
+    const kind = stringifyId(identifier.kind);
+    if (!kind)
+        return null;
+    const key = stringifyId(identifier.key) ?? stringifyId(identifier.identifierKey) ?? undefined;
+    if (identifier[kind] != null) {
+        return { kind, value: String(identifier[kind]), key };
+    }
+    return key ? { kind, value: key, key } : null;
+}
+/** @deprecated Use readConceptExtIdentifier */
+export function readConceptIdentifier(record) {
+    const ext = readConceptExtIdentifier(record);
+    return ext ? { kind: ext.kind, value: ext.value } : null;
+}
+export function readConceptTitle(record) {
+    const concept = record.concept;
+    if (!isPlainObject(concept))
+        return undefined;
+    return stringifyId(concept.title) ?? undefined;
+}
+//# sourceMappingURL=concept.js.map

package/dist/base/concept.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept.js","sourceRoot":"","sources":["../../src/base/concept.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,SAAS,GAAG,KAAK,CAAC;AACxB,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAEzC,6EAA6E;AAC7E,MAAM,UAAU,qBAAqB,CAAC,UAAmC;IACvE,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;aACnC,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,gBAAgB,IAAI,CAAC,KAAK,IAAI,CAC1E;aACA,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACtE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;SAClC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,gBAAgB,CAAC;SACxE,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,4CAA4C;AAC5C,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,KAAa,EACb,QAAgC,EAAE;IAElC,MAAM,UAAU,GAAyB;QACvC,IAAI;QACJ,CAAC,IAAI,CAAC,EAAE,KAAK;QACb,GAAG,KAAK;QACR,GAAG,EAAE,EAAE;KACR,CAAC;IACF,UAAU,CAAC,GAAG,GAAG,qBAAqB,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;IACzE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,KAAa,EACb,QAAgC,EAAE;IAElC,OAAO,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAkB;IAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChF,CAAC;IACD,OAAO,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAmB;IAClD,IAAI,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC;QAAE,OAAO,OAAO,CAAC,cAAc,CAAC;IACzE,sDAAsD;IACtD,IAAI,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,OAAO,OAAO,CAAC,UAAU,CAAC;IACjE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAAkB;IAElB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,UAAU,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,GAAG,GACP,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,SAAS,CAAC;IACpF,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,qBAAqB,CACnC,MAAkB;IAElB,MAAM,GAAG,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,OAAO,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;AACjD,CAAC"}

package/dist/base/constants.d.ts

@@ -0,0 +1,18 @@
+export declare const RECORD_ID_FIELD: "recordId";
+export declare const CONCEPT_FIELD: "concept";
+export declare const DATA_FIELD: "data";
+export declare const SYSTEM_FIELD: "_system";
+/** Fixed identity + core roots — from meta/envelope.json. */
+export declare const IDENTITY_ROOT_KEYS: Set<string>;
+export declare const CORE_ROOT_KEYS: Set<string>;
+/**
+ * Compat re-export of legacy root names (NOT from envelope law).
+ * Prefer importing from `compat/legacy-roots`.
+ */
+export declare const LEGACY_ROOT_KEYS: Set<string>;
+export declare const OPEN_BUCKET_KINDS: readonly ("rollup" | "sourced" | "interpretive" | "linked-payloads" | "custom")[];
+export declare const SYSTEM_KEY_PREFIX: string;
+export declare const BASE_ENVELOPE_META_VERSION: string;
+export declare const MEMORIX_RECORD_STATE_VALUES: readonly ("active" | "archived" | "superseded")[];
+export declare const DEFAULT_RECORD_STATE: "active" | "archived" | "superseded";
+//# sourceMappingURL=constants.d.ts.map

package/dist/base/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/base/constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe,EAAG,UAAmB,CAAC;AACnD,eAAO,MAAM,aAAa,EAAG,SAAkB,CAAC;AAChD,eAAO,MAAM,UAAU,EAAG,MAAe,CAAC;AAC1C,eAAO,MAAM,YAAY,EAAG,SAAkB,CAAC;AAE/C,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,aAA6C,CAAC;AAC7E,eAAO,MAAM,cAAc,aAAyC,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,aAA2C,CAAC;AAEzE,eAAO,MAAM,iBAAiB,EAA+B,SAAS,CAClE,QAAQ,GACR,SAAS,GACT,cAAc,GACd,iBAAiB,GACjB,QAAQ,CACX,EAAE,CAAC;AAEJ,eAAO,MAAM,iBAAiB,QAA2C,CAAC;AAC1E,eAAO,MAAM,0BAA0B,QAAmB,CAAC;AAE3D,eAAO,MAAM,2BAA2B,EAA0C,SAAS,CACvF,QAAQ,GACR,UAAU,GACV,YAAY,CACf,EAAE,CAAC;AACJ,eAAO,MAAM,oBAAoB,EAC7B,QAAQ,GACR,UAAU,GACV,YAAY,CAAC"}

package/dist/base/constants.js

@@ -0,0 +1,21 @@
+import { loadBaseEnvelopeMeta } from "./load-meta.js";
+import { LEGACY_ROOT_KEYS as COMPAT_LEGACY_ROOT_KEYS } from "./compat/legacy-roots.js";
+const envelope = loadBaseEnvelopeMeta();
+export const RECORD_ID_FIELD = "recordId";
+export const CONCEPT_FIELD = "concept";
+export const DATA_FIELD = "data";
+export const SYSTEM_FIELD = "_system";
+/** Fixed identity + core roots — from meta/envelope.json. */
+export const IDENTITY_ROOT_KEYS = new Set(envelope.categories.identity.keys);
+export const CORE_ROOT_KEYS = new Set(envelope.categories.core.keys);
+/**
+ * Compat re-export of legacy root names (NOT from envelope law).
+ * Prefer importing from `compat/legacy-roots`.
+ */
+export const LEGACY_ROOT_KEYS = new Set(COMPAT_LEGACY_ROOT_KEYS);
+export const OPEN_BUCKET_KINDS = envelope.openBucketKinds;
+export const SYSTEM_KEY_PREFIX = envelope.categories.underscore.keyPrefix;
+export const BASE_ENVELOPE_META_VERSION = envelope.version;
+export const MEMORIX_RECORD_STATE_VALUES = envelope.underscoreBlock.state.enum;
+export const DEFAULT_RECORD_STATE = envelope.underscoreBlock.state.default;
+//# sourceMappingURL=constants.js.map

package/dist/base/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/base/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,gBAAgB,IAAI,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEvF,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;AAExC,MAAM,CAAC,MAAM,eAAe,GAAG,UAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,aAAa,GAAG,SAAkB,CAAC;AAChD,MAAM,CAAC,MAAM,UAAU,GAAG,MAAe,CAAC;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAG,SAAkB,CAAC;AAE/C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAErE;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAS,uBAAuB,CAAC,CAAC;AAEzE,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,eAMvC,CAAC;AAEJ,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC;AAC1E,MAAM,CAAC,MAAM,0BAA0B,GAAG,QAAQ,CAAC,OAAO,CAAC;AAE3D,MAAM,CAAC,MAAM,2BAA2B,GAAG,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,IAIvE,CAAC;AACJ,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,OAGnD,CAAC"}

package/dist/base/index.d.ts

@@ -0,0 +1,13 @@
+export type { ContentTypeMeta, JsonObject, MemorixBaseRecord, MemorixConcept, MemorixConceptIdentifier, MemorixExtIdentifier, MemorixLifecycleEvent, MemorixRecordState, MemorixSystemBlock, OpenBucketDecl, OpenBucketKind, RecordInspection, RootCategory, ValidateBaseOptions, ValidateBaseResult, ValidationIssue, ValidationSeverity, } from "./types.js";
+export { MEMORIX_RECORD_STATES } from "./types.js";
+export { BASE_ENVELOPE_META_VERSION, CONCEPT_FIELD, CORE_ROOT_KEYS, DATA_FIELD, DEFAULT_RECORD_STATE, IDENTITY_ROOT_KEYS, LEGACY_ROOT_KEYS, MEMORIX_RECORD_STATE_VALUES, OPEN_BUCKET_KINDS, RECORD_ID_FIELD, SYSTEM_FIELD, SYSTEM_KEY_PREFIX, } from "./constants.js";
+export { classifyRootKey, isOpenBucketKey, isSystemRootKey } from "./classify.js";
+export { buildConceptIdentifier, buildExtIdentifier, buildExtIdentifierKey, buildIdentityString, readConceptExtIdentifier, readConceptIdentifier, readConceptTitle, readRecordId, } from "./concept.js";
+export { collectLegacyRootIssues, isLegacyRootKey, isLegacySystemRootKey, LEGACY_ROOT_KEYS as COMPAT_LEGACY_ROOT_KEYS, LEGACY_SYSTEM_ROOT_KEYS, } from "./compat/legacy-roots.js";
+export { parseContentTypeMeta } from "./meta.js";
+export { loadBaseEnvelopeMeta, clearBaseEnvelopeMetaCache, } from "./load-meta.js";
+export type { BaseEnvelopeMeta } from "./load-meta.js";
+export { inspectMemorixBaseRecord } from "./inspect.js";
+export { parseRecordsJson, validateMemorixBaseRecord, validateMemorixBaseRecords, } from "./validate.js";
+export { isPlainObject, stringifyId } from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":"AAAA,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,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EACL,0BAA0B,EAC1B,aAAa,EACb,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,2BAA2B,EAC3B,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,gBAAgB,IAAI,uBAAuB,EAC3C,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/base/index.js

@@ -0,0 +1,11 @@
+export { MEMORIX_RECORD_STATES } from "./types.js";
+export { BASE_ENVELOPE_META_VERSION, CONCEPT_FIELD, CORE_ROOT_KEYS, DATA_FIELD, DEFAULT_RECORD_STATE, IDENTITY_ROOT_KEYS, LEGACY_ROOT_KEYS, MEMORIX_RECORD_STATE_VALUES, OPEN_BUCKET_KINDS, RECORD_ID_FIELD, SYSTEM_FIELD, SYSTEM_KEY_PREFIX, } from "./constants.js";
+export { classifyRootKey, isOpenBucketKey, isSystemRootKey } from "./classify.js";
+export { buildConceptIdentifier, buildExtIdentifier, buildExtIdentifierKey, buildIdentityString, readConceptExtIdentifier, readConceptIdentifier, readConceptTitle, readRecordId, } from "./concept.js";
+export { collectLegacyRootIssues, isLegacyRootKey, isLegacySystemRootKey, LEGACY_ROOT_KEYS as COMPAT_LEGACY_ROOT_KEYS, LEGACY_SYSTEM_ROOT_KEYS, } from "./compat/legacy-roots.js";
+export { parseContentTypeMeta } from "./meta.js";
+export { loadBaseEnvelopeMeta, clearBaseEnvelopeMetaCache, } from "./load-meta.js";
+export { inspectMemorixBaseRecord } from "./inspect.js";
+export { parseRecordsJson, validateMemorixBaseRecord, validateMemorixBaseRecords, } from "./validate.js";
+export { isPlainObject, stringifyId } from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/base/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/base/index.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EACL,0BAA0B,EAC1B,aAAa,EACb,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,2BAA2B,EAC3B,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,gBAAgB,IAAI,uBAAuB,EAC3C,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/base/inspect.d.ts

@@ -0,0 +1,3 @@
+import type { RecordInspection } from "./types.js";
+export declare function inspectMemorixBaseRecord(input: unknown): RecordInspection;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/base/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/base/inspect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAc,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG/D,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAqCzE"}

package/dist/base/inspect.js

@@ -0,0 +1,41 @@
+import { classifyRootKey } from "./classify.js";
+import { isLegacyRootKey, isLegacySystemRootKey } from "./compat/legacy-roots.js";
+import { readConceptExtIdentifier, readConceptTitle, readRecordId } from "./concept.js";
+import { isPlainObject } from "./utils.js";
+export function inspectMemorixBaseRecord(input) {
+    const empty = {
+        categories: { identity: [], core: [], system: [], open: [] },
+        legacyRoots: [],
+    };
+    if (!isPlainObject(input))
+        return empty;
+    const record = input;
+    const categories = {
+        identity: [],
+        core: [],
+        system: [],
+        open: [],
+    };
+    const legacyRoots = [];
+    for (const key of Object.keys(record)) {
+        if (isLegacyRootKey(key) || isLegacySystemRootKey(key)) {
+            legacyRoots.push(key);
+        }
+        const cat = classifyRootKey(key);
+        categories[cat].push(key);
+    }
+    const conceptId = readConceptExtIdentifier(record);
+    return {
+        recordId: readRecordId(record) || undefined,
+        conceptTitle: readConceptTitle(record),
+        conceptKind: conceptId?.kind,
+        categories: {
+            identity: categories.identity.sort(),
+            core: categories.core.sort(),
+            system: categories.system.sort(),
+            open: categories.open.sort(),
+        },
+        legacyRoots: legacyRoots.sort(),
+    };
+}
+//# sourceMappingURL=inspect.js.map

package/dist/base/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/base/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAExF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,MAAM,KAAK,GAAqB;QAC9B,UAAU,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QAC5D,WAAW,EAAE,EAAE;KAChB,CAAC;IACF,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,MAAM,MAAM,GAAe,KAAK,CAAC;IACjC,MAAM,UAAU,GAAG;QACjB,QAAQ,EAAE,EAAc;QACxB,IAAI,EAAE,EAAc;QACpB,MAAM,EAAE,EAAc;QACtB,IAAI,EAAE,EAAc;KACrB,CAAC;IACF,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QACD,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACjC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,SAAS,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACnD,OAAO;QACL,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,SAAS;QAC3C,YAAY,EAAE,gBAAgB,CAAC,MAAM,CAAC;QACtC,WAAW,EAAE,SAAS,EAAE,IAAI;QAC5B,UAAU,EAAE;YACV,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE;YACpC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;YAC5B,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE;YAChC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;SAC7B;QACD,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE;KAChC,CAAC;AACJ,CAAC"}

package/dist/base/load-meta.d.ts

@@ -0,0 +1,61 @@
+export type BaseEnvelopeMeta = {
+    version: string;
+    categories: {
+        identity: {
+            keys: string[];
+            required: boolean;
+            description?: string;
+        };
+        core: {
+            keys: string[];
+            required: boolean;
+            description?: string;
+        };
+        underscore: {
+            keyPrefix: string;
+            wellKnown: string[];
+            description?: string;
+        };
+        open: {
+            description: string;
+        };
+    };
+    concept: {
+        requiredFields: string[];
+        extIdentifier: {
+            path: string;
+            requiredFields: string[];
+            forbiddenFields: string[];
+            rules?: string[];
+            description?: string;
+        };
+        forbiddenFields: string[];
+        otherKeys?: {
+            description: string;
+        };
+    };
+    underscoreBlock: {
+        allowUnderscoreKeys: boolean;
+        state: {
+            path: string;
+            enum: string[];
+            default: string;
+            description?: string;
+        };
+        lifecycle: {
+            path: string;
+            shape?: string;
+            omitIfEmpty: boolean;
+        };
+        wellKnownSystemPaths: string[];
+    };
+    openBucketKinds: string[];
+    defaults: {
+        unknownOpenBuckets: "reject" | "allow" | "warn";
+        emptyBuckets: "reject" | "omit-required";
+    };
+};
+export declare function loadBaseEnvelopeMeta(): BaseEnvelopeMeta;
+/** Reset cache (tests). */
+export declare function clearBaseEnvelopeMetaCache(): void;
+//# sourceMappingURL=load-meta.d.ts.map

package/dist/base/load-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-meta.d.ts","sourceRoot":"","sources":["../../src/base/load-meta.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QACV,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACtE,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAClE,UAAU,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,EAAE,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7E,IAAI,EAAE;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/B,CAAC;IACF,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,aAAa,EAAE;YACb,IAAI,EAAE,MAAM,CAAC;YACb,cAAc,EAAE,MAAM,EAAE,CAAC;YACzB,eAAe,EAAE,MAAM,EAAE,CAAC;YAC1B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;YACjB,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;QACF,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,SAAS,CAAC,EAAE;YAAE,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;KACrC,CAAC;IACF,eAAe,EAAE;QACf,mBAAmB,EAAE,OAAO,CAAC;QAC7B,KAAK,EAAE;YACL,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,EAAE,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;YAChB,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;QACF,SAAS,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,OAAO,CAAA;SAAE,CAAC;QAClE,oBAAoB,EAAE,MAAM,EAAE,CAAC;KAChC,CAAC;IACF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE;QACR,kBAAkB,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;QAChD,YAAY,EAAE,QAAQ,GAAG,eAAe,CAAC;KAC1C,CAAC;CACH,CAAC;AA0BF,wBAAgB,oBAAoB,IAAI,gBAAgB,CAKvD;AAED,2BAA2B;AAC3B,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}

package/dist/base/load-meta.js

@@ -0,0 +1,45 @@
+/**
+ * Load base envelope meta from packaged JSON.
+ */
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+let cached;
+function resolveEnvelopePath() {
+    // From src/base or dist/base → package root meta/
+    const candidates = [
+        join(__dirname, "..", "..", "meta", "envelope.json"),
+        join(__dirname, "..", "meta", "envelope.json"),
+    ];
+    for (const p of candidates) {
+        try {
+            readFileSync(p);
+            return p;
+        }
+        catch {
+            /* try next */
+        }
+    }
+    try {
+        const pkgJson = require.resolve("@x12i/memorix-format/package.json");
+        return join(dirname(pkgJson), "meta", "envelope.json");
+    }
+    catch {
+        return candidates[0];
+    }
+}
+export function loadBaseEnvelopeMeta() {
+    if (cached)
+        return cached;
+    const raw = JSON.parse(readFileSync(resolveEnvelopePath(), "utf8"));
+    cached = raw;
+    return raw;
+}
+/** Reset cache (tests). */
+export function clearBaseEnvelopeMetaCache() {
+    cached = undefined;
+}
+//# sourceMappingURL=load-meta.js.map

package/dist/base/load-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-meta.js","sourceRoot":"","sources":["../../src/base/load-meta.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAwC/C,IAAI,MAAoC,CAAC;AAEzC,SAAS,mBAAmB;IAC1B,kDAAkD;IAClD,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC;QACpD,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC;KAC/C,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,YAAY,CAAC,CAAC,CAAC,CAAC;YAChB,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,UAAU,CAAC,CAAC,CAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,mBAAmB,EAAE,EAAE,MAAM,CAAC,CAAqB,CAAC;IACxF,MAAM,GAAG,GAAG,CAAC;IACb,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,0BAA0B;IACxC,MAAM,GAAG,SAAS,CAAC;AACrB,CAAC"}

package/dist/base/meta.d.ts

@@ -0,0 +1,8 @@
+import type { ContentTypeMeta, ValidationIssue } from "./types.js";
+/** Parse and validate a ContentTypeMeta document. */
+export declare function parseContentTypeMeta(input: unknown): {
+    ok: boolean;
+    meta?: ContentTypeMeta;
+    issues: ValidationIssue[];
+};
+//# sourceMappingURL=meta.d.ts.map

package/dist/base/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/base/meta.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAkC,eAAe,EAAE,MAAM,YAAY,CAAC;AAgBnG,qDAAqD;AACrD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IACpD,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B,CAuFA"}