@x12i/memorix-format 3.0.3 → 3.0.4

package/meta/associated-conventions.json

@@ -1,59 +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)"
-  }
-}
+{
+  "$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

@@ -1,27 +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
-      }
-    }
-  }
-}
+{
+  "$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

@@ -1,80 +1,80 @@
-{
-  "$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"
-    },
-    "knowx": {
-      "profile": "minimal",
-      "description": "Native KnowX knowledge facet — data.kind NODE|EDGE; provenance (docHash + SourceSpan) mandatory; epistemic.state ≠ extraction confidence"
-    },
-    "nexum": {
-      "profile": "minimal",
-      "description": "Nexum contribution / node / claim records (write-record mode nexum)"
-    },
-    "confirmations": {
-      "profile": "minimal",
-      "description": "Accept/reject decision sibling for reviewed claims (e.g. KnowX assertions)"
-    }
-  }
-}
+{
+  "$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"
+    },
+    "knowx": {
+      "profile": "minimal",
+      "description": "Native KnowX knowledge facet — data.kind NODE|EDGE; provenance (docHash + SourceSpan) mandatory; epistemic.state ≠ extraction confidence"
+    },
+    "nexum": {
+      "profile": "minimal",
+      "description": "Nexum contribution / node / claim records (write-record mode nexum)"
+    },
+    "confirmations": {
+      "profile": "minimal",
+      "description": "Accept/reject decision sibling for reviewed claims (e.g. KnowX assertions)"
+    }
+  }
+}

package/meta/envelope.json

@@ -1,104 +1,104 @@
-{
-  "$schemaNote": "Base Memorix envelope meta-metadata (present tense only). No domain object types. Source of truth for @x12i/memorix-format present base envelope.",
-  "version": "1.2.0",
-  "categories": {
-    "identity": {
-      "keys": [
-        "recordId",
-        "concept"
-      ],
-      "required": true,
-      "description": "Join and display identity \u2014 fixed names. recordId is join plumbing (not human/LLM content). concept is human/LLM-facing except nested _extIdentifier."
-    },
-    "core": {
-      "keys": [
-        "data"
-      ],
-      "required": true,
-      "description": "Native facts about this entity \u2014 fixed name"
-    },
-    "underscore": {
-      "keyPrefix": "_",
-      "wellKnown": [
-        "_id",
-        "_system"
-      ],
-      "description": "Machine-only roots. Any _-prefixed root is omitted by default for humans/LLMs."
-    },
-    "open": {
-      "description": "Any other top-level key \u2014 names not reserved by base"
-    }
-  },
-  "concept": {
-    "requiredFields": [
-      "_extIdentifier",
-      "title"
-    ],
-    "extIdentifier": {
-      "path": "concept._extIdentifier",
-      "description": "External machine join key. Nested _ means omitted from human/LLM projection of concept.",
-      "requiredFields": [
-        "kind",
-        "key"
-      ],
-      "rules": [
-        "kind must be a non-empty string",
-        "a same-named property must hold the identifier value when used for key construction",
-        "key is kind, then kind-value, then other scalar fields sorted, joined by :",
-        "how key and title are derived for a given object type is defined on the object-type descriptor, not in this envelope"
-      ],
-      "forbiddenFields": [
-        "name",
-        "identifierKey"
-      ]
-    },
-    "forbiddenFields": [
-      "name",
-      "identifier"
-    ],
-    "otherKeys": {
-      "description": "Additional concept keys (non-_ prefixed) are allowed when important and human/LLM readable"
-    }
-  },
-  "underscoreBlock": {
-    "allowUnderscoreKeys": true,
-    "state": {
-      "path": "_system.state",
-      "enum": [
-        "active",
-        "archived",
-        "superseded"
-      ],
-      "default": "active",
-      "description": "Which document among same-recordId siblings is live vs not"
-    },
-    "lifecycle": {
-      "path": "_system.lifecycle",
-      "shape": "array-of-events",
-      "omitIfEmpty": true
-    },
-    "wellKnownSystemPaths": [
-      "_system.state",
-      "_system.lifecycle",
-      "_system.timestamps",
-      "_system.provenance",
-      "_system._graphRuns",
-      "_system._jobTypeRuns",
-      "_system.memorix",
-      "_system.processing",
-      "_system.narratives",
-      "_system.quarantine"
-    ]
-  },
-  "openBucketKinds": [
-    "rollup",
-    "sourced",
-    "interpretive",
-    "linked-payloads",
-    "custom"
-  ],
-  "defaults": {
-    "unknownOpenBuckets": "allow",
-    "emptyBuckets": "reject"
-  }
-}
+{
+  "$schemaNote": "Base Memorix envelope meta-metadata (present tense only). No domain object types. Source of truth for @x12i/memorix-format present base envelope.",
+  "version": "1.2.0",
+  "categories": {
+    "identity": {
+      "keys": [
+        "recordId",
+        "concept"
+      ],
+      "required": true,
+      "description": "Join and display identity \u2014 fixed names. recordId is join plumbing (not human/LLM content). concept is human/LLM-facing except nested _extIdentifier."
+    },
+    "core": {
+      "keys": [
+        "data"
+      ],
+      "required": true,
+      "description": "Native facts about this entity \u2014 fixed name"
+    },
+    "underscore": {
+      "keyPrefix": "_",
+      "wellKnown": [
+        "_id",
+        "_system"
+      ],
+      "description": "Machine-only roots. Any _-prefixed root is omitted by default for humans/LLMs."
+    },
+    "open": {
+      "description": "Any other top-level key \u2014 names not reserved by base"
+    }
+  },
+  "concept": {
+    "requiredFields": [
+      "_extIdentifier",
+      "title"
+    ],
+    "extIdentifier": {
+      "path": "concept._extIdentifier",
+      "description": "External machine join key. Nested _ means omitted from human/LLM projection of concept.",
+      "requiredFields": [
+        "kind",
+        "key"
+      ],
+      "rules": [
+        "kind must be a non-empty string",
+        "a same-named property must hold the identifier value when used for key construction",
+        "key is kind, then kind-value, then other scalar fields sorted, joined by :",
+        "how key and title are derived for a given object type is defined on the object-type descriptor, not in this envelope"
+      ],
+      "forbiddenFields": [
+        "name",
+        "identifierKey"
+      ]
+    },
+    "forbiddenFields": [
+      "name",
+      "identifier"
+    ],
+    "otherKeys": {
+      "description": "Additional concept keys (non-_ prefixed) are allowed when important and human/LLM readable"
+    }
+  },
+  "underscoreBlock": {
+    "allowUnderscoreKeys": true,
+    "state": {
+      "path": "_system.state",
+      "enum": [
+        "active",
+        "archived",
+        "superseded"
+      ],
+      "default": "active",
+      "description": "Which document among same-recordId siblings is live vs not"
+    },
+    "lifecycle": {
+      "path": "_system.lifecycle",
+      "shape": "array-of-events",
+      "omitIfEmpty": true
+    },
+    "wellKnownSystemPaths": [
+      "_system.state",
+      "_system.lifecycle",
+      "_system.timestamps",
+      "_system.provenance",
+      "_system._graphRuns",
+      "_system._jobTypeRuns",
+      "_system.memorix",
+      "_system.processing",
+      "_system.narratives",
+      "_system.quarantine"
+    ]
+  },
+  "openBucketKinds": [
+    "rollup",
+    "sourced",
+    "interpretive",
+    "linked-payloads",
+    "custom"
+  ],
+  "defaults": {
+    "unknownOpenBuckets": "allow",
+    "emptyBuckets": "reject"
+  }
+}