@x12i/memorix-format 2.2.3 → 2.3.3

package/meta/envelope.json

@@ -0,0 +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"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@x12i/memorix-format",
-  "version": "2.2.3",
-  "description": "Memorix product format on @x12i/memorix-base-format: open buckets, associations, SCOPE, migrate CLI.",
+  "version": "2.3.3",
+  "description": "Memorix format: present envelope + memorix-record/2 (Gate G2 SoT), validators, migrate CLIs.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -24,6 +24,10 @@
     "./types": {
       "types": "./dist/types.d.ts",
       "import": "./dist/types.js"
+    },
+    "./v2": {
+      "types": "./dist/v2/index.d.ts",
+      "import": "./dist/v2/index.js"
     }
   },
   "files": [
@@ -47,9 +51,6 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "dependencies": {
-    "@x12i/memorix-base-format": "^1.2.0"
-  },
   "devDependencies": {
     "@types/node": "^20.14.0",
     "typescript": "^5.6.0",
@@ -67,6 +68,7 @@
   "keywords": [
     "memorix",
     "format",
+    "memorix-record/2",
     "validator",
     "profile",
     "exellix"