@x12i/memorix-descriptors 1.22.0 → 1.32.0

package/docs/MEMORIX-CATALOX-CATALOG-MAP.md

@@ -110,8 +110,15 @@ Other Catalox roots in the same project (not in your screenshot): `apps`, `catal
 | 3 | `memorix-item-descriptors` | Descriptor | `memorix` | `native` | `id` | `title` | Yes (3 items) |
 | 4 | `memorix-completion-mappings` | Control plane | `generic`* | `native` | `id` | `name` | Catalog exists; list adapter error |
 | 5 | `memorix-inventory-policies` | System | `memorix` | `native` | `id` | `id` | Not registered |
+| 6 | `memorix-dashboard-analytics` | Analytics guides | `memorix` | `native` | `id` | `title` | Publish via `publish-dashboard-analytics-catalog.mjs` |
+| 7 | `memorix-analytics-rollups` | Rollup presets + registry | `memorix` | `native` | `id` | `title` | Publish via `publish-operational-metadata-catalogs.mjs` |
+| 8 | `memorix-associator-presets` | Association presets + manifest | `memorix` | `native` | `id` | `title` | same |
+| 9 | `memorix-associated-properties-registry` | Association registry | `memorix` | `native` | `id` | `title` | same |
+| 10 | `memorix-enrichment-playbooks` | Enrichment playbooks | `memorix` | `native` | `id` | `title` | same |
 
-\*Live registry shows `catalogType: "generic"` for completion mappings; seeds use `memorix`. Harmless for reads if items exist; align type on next `ensureCatalog` if desired.
+**Dashboard analytics:** Catalox holds the **spec/guide** (`memorix.dashboardAnalytics.v1`). Evaluation **results** live in knowledge DB collection `dashboard-analytics-results` — see `.operational/fr/2026-07-09-memorix-dashboard-analytics-persistence.md`.
+
+**Operational metadata (rollups / associator / playbooks):** Author in git (`.operational/…`, `memorix-associator/presets/`), publish with `publish-operational-metadata-catalogs.mjs`. Runtime prefers Catalox (`--from-catalog` for rollups). Generic guide: `.operational/metadata/` (ebook: `ebooks/metadata/`).
 
 **Why native + memorix type:** Catalox stores JSON documents as first-class items (not external DB mirrors). The `memorix` catalog type signals Memorix-specific validation and seed presets (`memorix-retrieval-descriptors`).
 

package/docs/MEMORIX-DATABASE-CONVENTIONS.md

@@ -103,6 +103,23 @@ MEMORIX_EVENTS_DB=memorix-neo-events
 
 **Record counts** for entities like `assets` come from the **snapshots** content type (`assets-snapshots` collection). See [EXPLORER-HOST-APIS.md](./EXPLORER-HOST-APIS.md#snapshot-record-counts-explorer-records).
 
+#### Ebook teaching plane (reserved)
+
+The prefix `ebooks-` on Memorix database names is **reserved** for the field-guide / simulator teaching plane. Customer deployments must not use it.
+
+| Role | Cyber (default) | Ebook (`MEMORIX_DEPLOYMENT_PROFILE=ebook`) |
+|------|-----------------|-------------------------------------------|
+| Entities | `memorix-entities` | `ebooks-memorix-entities` |
+| Events | `memorix-events` | `ebooks-memorix-events` |
+| Knowledge | `memorix-knowledge` | `ebooks-memorix-knowledge` |
+| Catalox | `memorix-catalox` | `ebooks-memorix-catalox` |
+| Operational | `memorix-operational` | `ebooks-memorix-operational` |
+| App id | `memorix` | `ebooks` |
+
+Set `MEMORIX_DEPLOYMENT_PROFILE=ebook` (or load `.env.ebook`). `applyMemorixDeploymentProfile` fills unset `MEMORIX_*_DB` / `MEMORIX_APP_ID` with the ebook defaults and clears `MEMORIX_SOURCE_DB` so cyber enrichment sources never bleed in. Same `MONGO_URI` cluster is fine — isolation is by database name.
+
+Agents **kitchen** and **nutrition** live inside `ebooks-memorix-catalox` (metadata scope filters). They do not remap Mongo databases.
+
 ### Source databases
 
 Source databases hold upstream data that Memorix tools use to **fill in or extend** entity/event `data` fields. They are never the write target for completion pipelines.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/memorix-descriptors",
-  "version": "1.22.0",
+  "version": "1.32.0",
   "description": "Manage Memorix entity, list, and item descriptors in Catalox",
   "type": "module",
   "main": "./dist/index.js",
@@ -67,7 +67,7 @@
   },
   "dependencies": {
     "@x12i/catalox": "^5.10.1",
-    "@x12i/helpers": "^2.0.0",
+    "@x12i/helpers": "^2.1.0",
     "mongodb": "^6.21.0"
   },
   "devDependencies": {