@x12i/memorix-format 3.0.3 → 3.0.4

package/CHANGELOG.md

@@ -1,65 +1,65 @@
-## 3.0.3
-
-- Add `nexum` content-type vocabulary for write-record mode nexum records.
-
-## 3.0.2
-
-- Docs: README install pins + stack/live/core-service references.
-
-## 3.0.1
-
-- Patch release: README/port-map alignment, live-view wiring where applicable.
-
-# Changelog
-
-## 2.3.3
-
-- Gate G4: authoritative relationship storage = central per-category collections (Candidate C).
-- Option A root `associated*` lightweight refs remain **format-valid**; they are **not** the selected authoritative storage model.
-- Sibling `relationships` content remains format-valid; not selected as authoritative storage.
-
-## 2.3.2
-
-- Lightweight relationship refs **require** `relationshipDefinitionId` + `recordId` (`relationshipId` optional/derivable).
-- Thin Gate G2 in-memory Mongo-style roundtrip + composition characterization.
-- DEL-ASSOC-COPIED wording: reject copied payloads only (Option A remains valid).
-
-## 2.3.1
-
-- Gate G2 corrections: `migratePresentToV2` returns `{ v2, extractedRelationships, warnings }` — never silently drops resolvable association `recordId`s.
-- Option A associated*: lightweight refs allowed; copied payload rejected (`V2-ASSOC-COPIED`). Physical storage still pending G4.
-- Revision helpers: `applySuccessfulMutation`, `checkExpectedRevision`, `nextRevision`.
-- Negative format + discriminator-default tests; migration semantics doc.
-
-## 2.3.0
-
-- **memorix-record/2**: `validateMemorixRecordV2`, `migratePresentToV2`, CLI `validate-v2` / `migrate-to-v2` / `profiles-v2`.
-- Golden examples under `examples/v2/`; docs: `docs/memorix-record-v2.md`.
-- Present envelope remains default for existing writer/pipeline; opt in with `MEMORIX_RECORD_FORMAT=v2`.
-- `@x12i/memorix-base-format` remains a dependency for present validation; scheduled to become a temporary re-export then delete (Phase 0 deletion ledger).
-
-## 2.2.3
-
-- Docs hygiene: drop identity-era appendix and ebook correction notes; association doc is a thin present-tense stub pointing at `meta/associated-conventions.json` + pipeline ops docs.
-
-## 2.2.0
-
-- Depends on `@x12i/memorix-base-format@^1.2.0` (`concept._extIdentifier`, `_system.state`).
-- `migrate` / `migrateMemorixRecord`: transform legacy/transitional envelopes → present format and validate.
-- Re-exports `buildExtIdentifier`, `readConceptExtIdentifier`, record-state helpers.
-
-## 2.1.0
-
-- Meta-metadata in packaged `meta/` JSON; inventory under `meta/inventory/`.
-- Profiles / known buckets / SCOPE load from those files.
-
-## 2.0.0
-
-Breaking relative to 1.0.0:
-
-- Depends on `@x12i/memorix-base-format` for the fixed skeleton.
-- Product rules live only in this package as profiles / layered checks.
-
-## 1.0.0
-
-Initial release (monolithic validator).
+## 3.0.3
+
+- Add `nexum` content-type vocabulary for write-record mode nexum records.
+
+## 3.0.2
+
+- Docs: README install pins + stack/live/core-service references.
+
+## 3.0.1
+
+- Patch release: README/port-map alignment, live-view wiring where applicable.
+
+# Changelog
+
+## 2.3.3
+
+- Gate G4: authoritative relationship storage = central per-category collections (Candidate C).
+- Option A root `associated*` lightweight refs remain **format-valid**; they are **not** the selected authoritative storage model.
+- Sibling `relationships` content remains format-valid; not selected as authoritative storage.
+
+## 2.3.2
+
+- Lightweight relationship refs **require** `relationshipDefinitionId` + `recordId` (`relationshipId` optional/derivable).
+- Thin Gate G2 in-memory Mongo-style roundtrip + composition characterization.
+- DEL-ASSOC-COPIED wording: reject copied payloads only (Option A remains valid).
+
+## 2.3.1
+
+- Gate G2 corrections: `migratePresentToV2` returns `{ v2, extractedRelationships, warnings }` — never silently drops resolvable association `recordId`s.
+- Option A associated*: lightweight refs allowed; copied payload rejected (`V2-ASSOC-COPIED`). Physical storage still pending G4.
+- Revision helpers: `applySuccessfulMutation`, `checkExpectedRevision`, `nextRevision`.
+- Negative format + discriminator-default tests; migration semantics doc.
+
+## 2.3.0
+
+- **memorix-record/2**: `validateMemorixRecordV2`, `migratePresentToV2`, CLI `validate-v2` / `migrate-to-v2` / `profiles-v2`.
+- Golden examples under `examples/v2/`; docs: `docs/memorix-record-v2.md`.
+- Present envelope remains default for existing writer/pipeline; opt in with `MEMORIX_RECORD_FORMAT=v2`.
+- `@x12i/memorix-base-format` remains a dependency for present validation; scheduled to become a temporary re-export then delete (Phase 0 deletion ledger).
+
+## 2.2.3
+
+- Docs hygiene: drop identity-era appendix and ebook correction notes; association doc is a thin present-tense stub pointing at `meta/associated-conventions.json` + pipeline ops docs.
+
+## 2.2.0
+
+- Depends on `@x12i/memorix-base-format@^1.2.0` (`concept._extIdentifier`, `_system.state`).
+- `migrate` / `migrateMemorixRecord`: transform legacy/transitional envelopes → present format and validate.
+- Re-exports `buildExtIdentifier`, `readConceptExtIdentifier`, record-state helpers.
+
+## 2.1.0
+
+- Meta-metadata in packaged `meta/` JSON; inventory under `meta/inventory/`.
+- Profiles / known buckets / SCOPE load from those files.
+
+## 2.0.0
+
+Breaking relative to 1.0.0:
+
+- Depends on `@x12i/memorix-base-format` for the fixed skeleton.
+- Product rules live only in this package as profiles / layered checks.
+
+## 1.0.0
+
+Initial release (monolithic validator).

package/README.md

@@ -1,78 +1,78 @@
-# `@x12i/memorix-format`
-
-Canonical **memorix-record/2** validation, migration, and CLI for Memorix.
-
-Object / content **types** belong in agent metadata — this package is the **envelope** SoT (shape of every stored subject content document), not product vocabulary.
-
-## Install
-
-```bash
-npm install @x12i/memorix-format@3.0.2
-```
-
-| Audience | Use this package? |
-|----------|-------------------|
-| Remote app | Optional — validate offline / in CI |
-| Platform / writers / pipelines | **Yes** |
-
-## API status
-
-| API | Status |
-|-----|--------|
-| `validateMemorixRecordV2`, CLI `validate-v2` / `migrate-to-v2` | **Current** SoT for platform work |
-| Present-envelope helpers | Migration / compat only |
-
-**Exports:** `.` · `./validate` · `./profiles` · `./types` · `./v2`
-
-## Quick V2 example
-
-```json
-{
-  "format": "memorix-record/2",
-  "recordId": "wi-100",
-  "revision": 3,
-  "objectType": "work-items",
-  "contentType": "snapshots",
-  "dataCategory": "entity",
-  "concept": {
-    "title": "Prepare quarterly operations review",
-    "identifiers": {
-      "primary": { "kind": "workItemId", "value": "WI-100", "issuer": "opx-source" }
-    }
-  },
-  "data": { "status": "in-progress", "priority": "normal" },
-  "_system": {
-    "state": "active",
-    "createdAt": "2026-01-10T10:00:00.000Z",
-    "modifiedAt": "2026-01-15T12:00:00.000Z"
-  }
-}
-```
-
-```bash
-npx memorix-format validate-v2 examples/v2
-npx memorix-format migrate-to-v2 ./present.json \
-  --object-type=work-items --content-type=snapshots --data-category=entity
-```
-
-```ts
-import { validateMemorixRecordV2 } from "@x12i/memorix-format/v2";
-
-const result = validateMemorixRecordV2(doc);
-if (!result.ok) throw new Error(result.errors.join("; "));
-```
-
-## Hard rules (format)
-
-- V2 rejects **copied** related-record payloads in the document.
-- Authoritative navigation between subjects is **four-field relationship links** (`@x12i/memorix-relationships`), not embedded `associated*`.
-
-## Docs
-
-- [`docs/memorix-record-v2.md`](./docs/memorix-record-v2.md) · [`meta/`](./meta/)
-- Ebook: [Format for Dummies](../memorix-docs/01-format-for-dummies/)
-- Hub: [https://docs.memorix.x12i.com](https://docs.memorix.x12i.com)
-
-```bash
-npm test
-```
+# `@x12i/memorix-format`
+
+Canonical **memorix-record/2** validation, migration, and CLI for Memorix.
+
+Object / content **types** belong in agent metadata — this package is the **envelope** SoT (shape of every stored subject content document), not product vocabulary.
+
+## Install
+
+```bash
+npm install @x12i/memorix-format@3.0.2
+```
+
+| Audience | Use this package? |
+|----------|-------------------|
+| Remote app | Optional — validate offline / in CI |
+| Platform / writers / pipelines | **Yes** |
+
+## API status
+
+| API | Status |
+|-----|--------|
+| `validateMemorixRecordV2`, CLI `validate-v2` / `migrate-to-v2` | **Current** SoT for platform work |
+| Present-envelope helpers | Migration / compat only |
+
+**Exports:** `.` · `./validate` · `./profiles` · `./types` · `./v2`
+
+## Quick V2 example
+
+```json
+{
+  "format": "memorix-record/2",
+  "recordId": "wi-100",
+  "revision": 3,
+  "objectType": "work-items",
+  "contentType": "snapshots",
+  "dataCategory": "entity",
+  "concept": {
+    "title": "Prepare quarterly operations review",
+    "identifiers": {
+      "primary": { "kind": "workItemId", "value": "WI-100", "issuer": "opx-source" }
+    }
+  },
+  "data": { "status": "in-progress", "priority": "normal" },
+  "_system": {
+    "state": "active",
+    "createdAt": "2026-01-10T10:00:00.000Z",
+    "modifiedAt": "2026-01-15T12:00:00.000Z"
+  }
+}
+```
+
+```bash
+npx memorix-format validate-v2 examples/v2
+npx memorix-format migrate-to-v2 ./present.json \
+  --object-type=work-items --content-type=snapshots --data-category=entity
+```
+
+```ts
+import { validateMemorixRecordV2 } from "@x12i/memorix-format/v2";
+
+const result = validateMemorixRecordV2(doc);
+if (!result.ok) throw new Error(result.errors.join("; "));
+```
+
+## Hard rules (format)
+
+- V2 rejects **copied** related-record payloads in the document.
+- Authoritative navigation between subjects is **four-field relationship links** (`@x12i/memorix-relationships`), not embedded `associated*`.
+
+## Docs
+
+- [`docs/memorix-record-v2.md`](./docs/memorix-record-v2.md) · [`meta/`](./meta/)
+- Ebook: [Format for Dummies](../memorix-docs/01-format-for-dummies/)
+- Hub: [https://docs.memorix.x12i.com](https://docs.memorix.x12i.com)
+
+```bash
+npm test
+```

package/dist/base/concept.d.ts

@@ -6,6 +6,10 @@ 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;
+/**
+ * Subject identity. Mongo `_id` is never used — it is a storage key, not recordId.
+ * Legacy `identity.recordId` / `identity.targetId` remain for present-format inspect only.
+ */
 export declare function readRecordId(record: JsonObject): string;
 export declare function readConceptExtIdentifier(record: JsonObject): {
     kind: string;

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

@@ -1 +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"}
+{"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;;;GAGG;AACH,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

@@ -39,6 +39,10 @@ export function buildExtIdentifier(kind, value, extra = {}) {
 export function buildConceptIdentifier(kind, value, extra = {}) {
     return buildExtIdentifier(kind, value, extra);
 }
+/**
+ * Subject identity. Mongo `_id` is never used — it is a storage key, not recordId.
+ * Legacy `identity.recordId` / `identity.targetId` remain for present-format inspect only.
+ */
 export function readRecordId(record) {
     const root = stringifyId(record.recordId);
     if (root)
@@ -47,7 +51,7 @@ export function readRecordId(record) {
     if (isPlainObject(identity)) {
         return stringifyId(identity.recordId) ?? stringifyId(identity.targetId) ?? "";
     }
-    return stringifyId(record._id) ?? "";
+    return "";
 }
 function readExtIdentifierObject(concept) {
     if (isPlainObject(concept._extIdentifier))

package/dist/base/concept.js.map

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

package/dist/cli.js

@@ -28,42 +28,42 @@ function docsDir() {
     return candidates[0];
 }
 function printHelp() {
-    console.log(`memorix-format <command> [options]
-
-Memorix format package.
-
-Present envelope (legacy product path):
-  validate [path|-]     Validate present format (base + profiles)
-  migrate  [path|-]     Transform legacy → present format
-
-memorix-record/2 (Gate G2 SoT for new platform work):
-  validate-v2 [path|-]  Validate memorix-record/2
-  migrate-to-v2 [path|-]
-                        Present/legacy → memorix-record/2
-                        Requires: --object-type --content-type --data-category
-
-Other:
-  inspect  [path|-]     Summarize root categories (via base)
-  docs [name]           List or print packaged docs
-  profiles              List built-in present profiles
-  profiles-v2           List V2 content-type profiles
-  version
-  help
-
-Options:
-  --profile=<name>         Present: ${BUILTIN_PROFILES.join(" | ")}
-  --object-type=<name>     Object type
-  --content-type=<ct>      Content type
-  --data-category=<cat>    V2 migrate: entity | event | knowledge
-  --meta=<file>            Custom ContentTypeMeta JSON (present validate)
-  --allow-legacy           Warn on legacy roots (compat)
-  --reject-legacy          Fail on legacy roots
-  --out=<dir|file>         migrate / migrate-to-v2 output
-  --in-place               Overwrite input files
-  --revision=<n>           migrate-to-v2 default revision (default 1)
-  --issuer=<id>            migrate-to-v2 default identifier issuer
-  --strict
-  --json
+    console.log(`memorix-format <command> [options]
+
+Memorix format package.
+
+Present envelope (legacy product path):
+  validate [path|-]     Validate present format (base + profiles)
+  migrate  [path|-]     Transform legacy → present format
+
+memorix-record/2 (Gate G2 SoT for new platform work):
+  validate-v2 [path|-]  Validate memorix-record/2
+  migrate-to-v2 [path|-]
+                        Present/legacy → memorix-record/2
+                        Requires: --object-type --content-type --data-category
+
+Other:
+  inspect  [path|-]     Summarize root categories (via base)
+  docs [name]           List or print packaged docs
+  profiles              List built-in present profiles
+  profiles-v2           List V2 content-type profiles
+  version
+  help
+
+Options:
+  --profile=<name>         Present: ${BUILTIN_PROFILES.join(" | ")}
+  --object-type=<name>     Object type
+  --content-type=<ct>      Content type
+  --data-category=<cat>    V2 migrate: entity | event | knowledge
+  --meta=<file>            Custom ContentTypeMeta JSON (present validate)
+  --allow-legacy           Warn on legacy roots (compat)
+  --reject-legacy          Fail on legacy roots
+  --out=<dir|file>         migrate / migrate-to-v2 output
+  --in-place               Overwrite input files
+  --revision=<n>           migrate-to-v2 default revision (default 1)
+  --issuer=<id>            migrate-to-v2 default identifier issuer
+  --strict
+  --json
 `);
 }
 function readFlag(args, name) {

package/dist/v2/identity.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Collision-safe source-ID adoption for memorix-record/2.
+ * Bare provider values are never subject identity.
+ */
+export declare const EXPLICIT_RECORD_ID_KIND = "recordId";
+export type AdoptedIdentifier = {
+    kind: string;
+    value: string;
+    issuer?: string;
+};
+/** `{issuer}/{kind}/{value}` — two sources emitting the same value stay distinct. */
+export declare function adoptedRecordId(identifier: AdoptedIdentifier): string;
+/**
+ * True when a source identifier is being used as the org-wide subject id.
+ * `kind: "recordId"` with value equal to recordId is explicit identity, not adoption.
+ */
+export declare function isCollisionUnsafeAdoption(recordId: string, primary: AdoptedIdentifier | undefined | null): boolean;
+export declare function issuerRequired(primary: AdoptedIdentifier | undefined | null): boolean;
+//# sourceMappingURL=identity.d.ts.map

package/dist/v2/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/v2/identity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAElD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM,CAWrE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,GAC5C,OAAO,CAOT;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAGrF"}

package/dist/v2/identity.js

@@ -0,0 +1,39 @@
+/**
+ * Collision-safe source-ID adoption for memorix-record/2.
+ * Bare provider values are never subject identity.
+ */
+export const EXPLICIT_RECORD_ID_KIND = "recordId";
+/** `{issuer}/{kind}/{value}` — two sources emitting the same value stay distinct. */
+export function adoptedRecordId(identifier) {
+    const issuer = identifier.issuer?.trim();
+    const kind = identifier.kind.trim();
+    const value = identifier.value.trim();
+    if (!issuer) {
+        throw new Error("adoptedRecordId requires issuer");
+    }
+    if (!kind || !value) {
+        throw new Error("adoptedRecordId requires kind and value");
+    }
+    return `${issuer}/${kind}/${value}`;
+}
+/**
+ * True when a source identifier is being used as the org-wide subject id.
+ * `kind: "recordId"` with value equal to recordId is explicit identity, not adoption.
+ */
+export function isCollisionUnsafeAdoption(recordId, primary) {
+    if (!primary)
+        return false;
+    const kind = typeof primary.kind === "string" ? primary.kind.trim() : "";
+    const value = typeof primary.value === "string" ? primary.value.trim() : "";
+    if (!kind || !value)
+        return false;
+    if (kind === EXPLICIT_RECORD_ID_KIND)
+        return false;
+    return recordId.trim() === value;
+}
+export function issuerRequired(primary) {
+    if (!primary)
+        return true;
+    return primary.kind?.trim() !== EXPLICIT_RECORD_ID_KIND;
+}
+//# sourceMappingURL=identity.js.map

package/dist/v2/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/v2/identity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAQlD,qFAAqF;AACrF,MAAM,UAAU,eAAe,CAAC,UAA6B;IAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,GAAG,MAAM,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAAgB,EAChB,OAA6C;IAE7C,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,MAAM,IAAI,GAAG,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,MAAM,KAAK,GAAG,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5E,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,IAAI,KAAK,uBAAuB;QAAE,OAAO,KAAK,CAAC;IACnD,OAAO,QAAQ,CAAC,IAAI,EAAE,KAAK,KAAK,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAA6C;IAC1E,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,uBAAuB,CAAC;AAC1D,CAAC"}

package/dist/v2/index.d.ts

@@ -2,6 +2,7 @@ export type { ContentDiscriminator, ContentTypeProfileV2, MemorixConceptV2, Memo
 export { MEMORIX_RECORD_FORMAT_V2 } from "./types.js";
 export { BUILTIN_CONTENT_PROFILES, DATA_CATEGORIES, RECORD_STATES, V2_FIXED_ROOTS, V2_SNAPSHOT_BUCKETS, resolveContentProfile, } from "./profiles.js";
 export { validateMemorixRecordV2, validateMemorixRecordsV2 } from "./validate.js";
+export { EXPLICIT_RECORD_ID_KIND, adoptedRecordId, isCollisionUnsafeAdoption, issuerRequired, type AdoptedIdentifier, } from "./identity.js";
 export { migratePresentToV2, migratePresentToV2Record, migratePresentRecordsToV2, type MigratePresentToV2Options, type MigratePresentToV2Result, type ExtractedRelationship, } from "./migrate-present.js";
 export { applySuccessfulMutation, checkExpectedRevision, nextRevision, type RevisionCheckResult, } from "./revision.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v2/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,YAAY,EACZ,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v2/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,yBAAyB,EACzB,cAAc,EACd,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,YAAY,EACZ,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC"}

package/dist/v2/index.js

@@ -1,6 +1,7 @@
 export { MEMORIX_RECORD_FORMAT_V2 } from "./types.js";
 export { BUILTIN_CONTENT_PROFILES, DATA_CATEGORIES, RECORD_STATES, V2_FIXED_ROOTS, V2_SNAPSHOT_BUCKETS, resolveContentProfile, } from "./profiles.js";
 export { validateMemorixRecordV2, validateMemorixRecordsV2 } from "./validate.js";
+export { EXPLICIT_RECORD_ID_KIND, adoptedRecordId, isCollisionUnsafeAdoption, issuerRequired, } from "./identity.js";
 export { migratePresentToV2, migratePresentToV2Record, migratePresentRecordsToV2, } from "./migrate-present.js";
 export { applySuccessfulMutation, checkExpectedRevision, nextRevision, } from "./revision.js";
 //# sourceMappingURL=index.js.map

package/dist/v2/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v2/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,GAI1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,YAAY,GAEb,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v2/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,yBAAyB,EACzB,cAAc,GAEf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,yBAAyB,GAI1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,YAAY,GAEb,MAAM,eAAe,CAAC"}

package/docs/association-format.md

@@ -1,47 +1,47 @@
-# Association format
-
-Associated content is stored as **root-level open buckets** on snapshot records using the reserved `associated` prefix.
-
-**Normative naming / forms:** packaged [`meta/associated-conventions.json`](../meta/associated-conventions.json).  
-**Operational detail** (presets, apply, enrichment orchestration): [`memorix-pipeline/docs/association-format.md`](../../memorix-pipeline/docs/association-format.md) and [running-associations.md](../../memorix-pipeline/docs/running-associations.md).
-
-This package validates association **shape** (ASSOC rules in [memorix-format-requirements.md](./memorix-format-requirements.md)); it does not invent object-type names.
-
----
-
-## Core rule
-
-Association is always **snapshot-first**:
-
-1. Start from the source object’s snapshot.
-2. Match a target **snapshot** (`*-snapshots`).
-3. Use the matched snapshot’s `recordId` to fetch non-snapshot content (`discovery`, `analysis`, `decisions`, …).
-4. Copy flat content into an `associated…` array on the source snapshot.
-
-Never join a source snapshot directly to a non-snapshot collection by business keys.
-
----
-
-## Naming
-
-| Form | Pattern | Example (abstract) |
-|---|---|---|
-| Legacy short names | `associatedData`, `associatedDiscovery`, … | still present on older records |
-| v2 content | `associated<ObjectType><ContentType>` | `associatedItemGroupsAnalysis` |
-| Ranked top | `associatedTop<ObjectType><ContentType>` | `associatedTopItemsAnalysis` |
-| Enrichment copy | `associated<ObjectType>Enrichment` | `associatedItemGroupsEnrichment` |
-
-Object-type segments come from Catalox descriptors — not from this format package.
-
----
-
-## Payload rules
-
-- Associated properties are **arrays of plain objects** (linked payloads), never full envelopes.
-- On **memorix-record/2**, root `associated*` may hold **lightweight refs only** (Option A — format-valid): `relationshipDefinitionId` + `recordId`, optional `relationshipId`. Copied related business payload is rejected.
-- **Authoritative relationship storage (Gate G4)** is centralized per-category collections (Candidate C), not Option A roots or sibling `relationships` content. See `@x12i/memorix-relationship-store` (archived decision: `.tmp/housekeeping-2026-07-23/docs/re-factoring-and-opx-agent/RELATIONSHIP-STORAGE-DECISION.md`).
-
-- **Omit** the property when empty — never write `[]`.
-- Prefer traceability in optional item-level `_system.association` (v2) rather than wrapping envelopes.
-
-See requirements **ASSOC-*** and the pipeline association doc for matching / payload forms.
+# Association format
+
+Associated content is stored as **root-level open buckets** on snapshot records using the reserved `associated` prefix.
+
+**Normative naming / forms:** packaged [`meta/associated-conventions.json`](../meta/associated-conventions.json).  
+**Operational detail** (presets, apply, enrichment orchestration): [`memorix-pipeline/docs/association-format.md`](../../memorix-pipeline/docs/association-format.md) and [running-associations.md](../../memorix-pipeline/docs/running-associations.md).
+
+This package validates association **shape** (ASSOC rules in [memorix-format-requirements.md](./memorix-format-requirements.md)); it does not invent object-type names.
+
+---
+
+## Core rule
+
+Association is always **snapshot-first**:
+
+1. Start from the source object’s snapshot.
+2. Match a target **snapshot** (`*-snapshots`).
+3. Use the matched snapshot’s `recordId` to fetch non-snapshot content (`discovery`, `analysis`, `decisions`, …).
+4. Copy flat content into an `associated…` array on the source snapshot.
+
+Never join a source snapshot directly to a non-snapshot collection by business keys.
+
+---
+
+## Naming
+
+| Form | Pattern | Example (abstract) |
+|---|---|---|
+| Legacy short names | `associatedData`, `associatedDiscovery`, … | still present on older records |
+| v2 content | `associated<ObjectType><ContentType>` | `associatedItemGroupsAnalysis` |
+| Ranked top | `associatedTop<ObjectType><ContentType>` | `associatedTopItemsAnalysis` |
+| Enrichment copy | `associated<ObjectType>Enrichment` | `associatedItemGroupsEnrichment` |
+
+Object-type segments come from Catalox descriptors — not from this format package.
+
+---
+
+## Payload rules
+
+- Associated properties are **arrays of plain objects** (linked payloads), never full envelopes.
+- On **memorix-record/2**, root `associated*` may hold **lightweight refs only** (Option A — format-valid): `relationshipDefinitionId` + `recordId`, optional `relationshipId`. Copied related business payload is rejected.
+- **Authoritative relationship storage (Gate G4)** is centralized per-category collections (Candidate C), not Option A roots or sibling `relationships` content. See `@x12i/memorix-relationship-store` (archived decision: `.tmp/housekeeping-2026-07-23/docs/re-factoring-and-opx-agent/RELATIONSHIP-STORAGE-DECISION.md`).
+
+- **Omit** the property when empty — never write `[]`.
+- Prefer traceability in optional item-level `_system.association` (v2) rather than wrapping envelopes.
+
+See requirements **ASSOC-*** and the pipeline association doc for matching / payload forms.