@x12i/memorix-format 3.0.3 → 3.0.6

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"
+  }
+}

package/meta/inventory/managed-descriptors.json

@@ -1,78 +1,78 @@
-{
-  "$schemaNote": "INVENTORY ONLY — derived from managed Catalox entity descriptors (memorix-retrieval/catalox-seeds). Not format law. Not agent packs. Used to keep format meta aligned with live managed objects. Regenerate when descriptors change.",
-  "version": "2.1.0",
-  "source": "memorix-retrieval/catalox-seeds/inputs/entity-descriptors/*.json",
-  "scannedAt": "2026-07-21",
-  "alsoScanned": [
-    {
-      "source": "ebooks/memorix-seed/entity-descriptors/*.json",
-      "note": "Demo domain — same CT/open-bucket conventions; no new format vocabulary"
-    }
-  ],
-  "managedObjectTypes": [
-    "assets",
-    "content-documents",
-    "knowledge-playbooks",
-    "subnets",
-    "topology-zones",
-    "vulnerabilities",
-    "vulnerabilities-groups"
-  ],
-  "contentTypesObserved": [
-    "analysis",
-    "chunks",
-    "decisions",
-    "discovery",
-    "extrated",
-    "legacy",
-    "narrative-steps",
-    "narratives",
-    "scoped",
-    "snapshots",
-    "workflow"
-  ],
-  "contentTypeNotes": [
-    {
-      "contentType": "decisions",
-      "note": "Some descriptors use collection postfix 'decision' (singular) while the contentTypes key is 'decisions'"
-    },
-    {
-      "contentType": "extrated",
-      "note": "Spelling as managed in content-documents descriptor (key/postfix/collection)"
-    }
-  ],
-  "associatedPropertiesObserved": [
-    "associatedAssetsSnapshots",
-    "associatedSubnetsAnalysis",
-    "associatedSubnetsDiscovery",
-    "associatedSubnetsSnapshots",
-    "associatedTopVulnerabilitiesAnalysis",
-    "associatedTopology",
-    "associatedTopologyZonesAnalysis",
-    "associatedTopologyZonesSnapshots",
-    "associatedVulnerabilitiesAnalysis",
-    "associatedVulnerabilitiesDecisions",
-    "associatedVulnerabilitiesDiscovery",
-    "associatedVulnerabilitiesGroupsAnalysis",
-    "associatedVulnerabilitiesGroupsDiscovery",
-    "associatedVulnerabilitiesGroupsEnrichment",
-    "associatedVulnerabilitiesGroupsSnapshots"
-  ],
-  "customRootPropertiesObserved": [
-    {
-      "name": "possiblePaths",
-      "kind": "custom",
-      "shape": "object",
-      "objectTypes": ["subnets"],
-      "note": "Declared on subnets descriptors as managed rootProperty — open bucket, not base-reserved and not a product-known open bucket"
-    }
-  ],
-  "platformOpenBucketsObservedInProductDocs": ["analytics", "enrichment", "insights"],
-  "alignmentChecks": {
-    "allContentTypesCoveredInContentTypesJson": true,
-    "platformOpenBucketsPresentInOpenBucketsJson": ["analytics", "enrichment", "insights"],
-    "associatedNamesFollowPrefixConvention": true,
-    "noObjectTypesInFormatLawJson": true,
-    "conceptRecipesOnEntityDescriptors": true
-  }
-}
+{
+  "$schemaNote": "INVENTORY ONLY — derived from managed Catalox entity descriptors (memorix-retrieval/catalox-seeds). Not format law. Not agent packs. Used to keep format meta aligned with live managed objects. Regenerate when descriptors change.",
+  "version": "2.1.0",
+  "source": "memorix-retrieval/catalox-seeds/inputs/entity-descriptors/*.json",
+  "scannedAt": "2026-07-21",
+  "alsoScanned": [
+    {
+      "source": "ebooks/memorix-seed/entity-descriptors/*.json",
+      "note": "Demo domain — same CT/open-bucket conventions; no new format vocabulary"
+    }
+  ],
+  "managedObjectTypes": [
+    "assets",
+    "content-documents",
+    "knowledge-playbooks",
+    "subnets",
+    "topology-zones",
+    "vulnerabilities",
+    "vulnerabilities-groups"
+  ],
+  "contentTypesObserved": [
+    "analysis",
+    "chunks",
+    "decisions",
+    "discovery",
+    "extrated",
+    "legacy",
+    "narrative-steps",
+    "narratives",
+    "scoped",
+    "snapshots",
+    "workflow"
+  ],
+  "contentTypeNotes": [
+    {
+      "contentType": "decisions",
+      "note": "Some descriptors use collection postfix 'decision' (singular) while the contentTypes key is 'decisions'"
+    },
+    {
+      "contentType": "extrated",
+      "note": "Spelling as managed in content-documents descriptor (key/postfix/collection)"
+    }
+  ],
+  "associatedPropertiesObserved": [
+    "associatedAssetsSnapshots",
+    "associatedSubnetsAnalysis",
+    "associatedSubnetsDiscovery",
+    "associatedSubnetsSnapshots",
+    "associatedTopVulnerabilitiesAnalysis",
+    "associatedTopology",
+    "associatedTopologyZonesAnalysis",
+    "associatedTopologyZonesSnapshots",
+    "associatedVulnerabilitiesAnalysis",
+    "associatedVulnerabilitiesDecisions",
+    "associatedVulnerabilitiesDiscovery",
+    "associatedVulnerabilitiesGroupsAnalysis",
+    "associatedVulnerabilitiesGroupsDiscovery",
+    "associatedVulnerabilitiesGroupsEnrichment",
+    "associatedVulnerabilitiesGroupsSnapshots"
+  ],
+  "customRootPropertiesObserved": [
+    {
+      "name": "possiblePaths",
+      "kind": "custom",
+      "shape": "object",
+      "objectTypes": ["subnets"],
+      "note": "Declared on subnets descriptors as managed rootProperty — open bucket, not base-reserved and not a product-known open bucket"
+    }
+  ],
+  "platformOpenBucketsObservedInProductDocs": ["analytics", "enrichment", "insights"],
+  "alignmentChecks": {
+    "allContentTypesCoveredInContentTypesJson": true,
+    "platformOpenBucketsPresentInOpenBucketsJson": ["analytics", "enrichment", "insights"],
+    "associatedNamesFollowPrefixConvention": true,
+    "noObjectTypesInFormatLawJson": true,
+    "conceptRecipesOnEntityDescriptors": true
+  }
+}

package/meta/open-buckets.json

@@ -1,24 +1,24 @@
-{
-  "$schemaNote": "Memorix product open buckets — content-type level, no objectType. Kind meanings for snapshots.",
-  "version": "2.1.0",
-  "openBuckets": {
-    "analytics": {
-      "kind": "rollup",
-      "shape": "object",
-      "title": "Analytics",
-      "description": "Numeric rollups about linked lists"
-    },
-    "enrichment": {
-      "kind": "sourced",
-      "shape": "object",
-      "title": "Enrichment",
-      "description": "External / prior-system sourced values as received"
-    },
-    "insights": {
-      "kind": "interpretive",
-      "shape": "object",
-      "title": "Insights",
-      "description": "Interpreted judgments, scores, recommendations"
-    }
-  }
-}
+{
+  "$schemaNote": "Memorix product open buckets — content-type level, no objectType. Kind meanings for snapshots.",
+  "version": "2.1.0",
+  "openBuckets": {
+    "analytics": {
+      "kind": "rollup",
+      "shape": "object",
+      "title": "Analytics",
+      "description": "Numeric rollups about linked lists"
+    },
+    "enrichment": {
+      "kind": "sourced",
+      "shape": "object",
+      "title": "Enrichment",
+      "description": "External / prior-system sourced values as received"
+    },
+    "insights": {
+      "kind": "interpretive",
+      "shape": "object",
+      "title": "Insights",
+      "description": "Interpreted judgments, scores, recommendations"
+    }
+  }
+}

package/package.json

@@ -1,77 +1,77 @@
-{
-  "name": "@x12i/memorix-format",
-  "version": "3.0.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",
-  "bin": {
-    "memorix-format": "dist/cli.js"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./validate": {
-      "types": "./dist/validate.d.ts",
-      "import": "./dist/validate.js"
-    },
-    "./profiles": {
-      "types": "./dist/profiles.d.ts",
-      "import": "./dist/profiles.js"
-    },
-    "./types": {
-      "types": "./dist/types.d.ts",
-      "import": "./dist/types.js"
-    },
-    "./v2": {
-      "types": "./dist/v2/index.d.ts",
-      "import": "./dist/v2/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "docs",
-    "examples",
-    "meta",
-    "README.md",
-    "CHANGELOG.md"
-  ],
-  "sideEffects": false,
-  "scripts": {
-    "prebuild": "rm -rf dist",
-    "build": "tsc -p tsconfig.build.json",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "prepack": "npm run build",
-    "prepublishOnly": "npm run build && npm test"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.14.0",
-    "typescript": "^5.6.0",
-    "vitest": "^2.1.0"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+ssh://git@github.com/x12i/memorix-mono-repo.git",
-    "directory": "memorix-format"
-  },
-  "keywords": [
-    "memorix",
-    "format",
-    "memorix-record/2",
-    "validator",
-    "profile",
-    "exellix"
-  ],
-  "license": "exellix-license"
-}
+{
+  "name": "@x12i/memorix-format",
+  "version": "3.0.6",
+  "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",
+  "bin": {
+    "memorix-format": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./validate": {
+      "types": "./dist/validate.d.ts",
+      "import": "./dist/validate.js"
+    },
+    "./profiles": {
+      "types": "./dist/profiles.d.ts",
+      "import": "./dist/profiles.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./v2": {
+      "types": "./dist/v2/index.d.ts",
+      "import": "./dist/v2/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "docs",
+    "examples",
+    "meta",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "prebuild": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/x12i/memorix-mono-repo.git",
+    "directory": "memorix-format"
+  },
+  "keywords": [
+    "memorix",
+    "format",
+    "memorix-record/2",
+    "validator",
+    "profile",
+    "exellix"
+  ],
+  "license": "exellix-license"
+}