@x12i/memorix-retrieval 1.5.1 → 1.6.2

package/docs/fr/xronox-fr-memorix-env-preset.md

@@ -0,0 +1,69 @@
+# Feature request — Memorix deployment preset / env aliases (`@x12i/xronox`)
+
+**Date:** 2026-05-22  
+**Status:** **Open**  
+**Requested by:** `@x12i/memorix-retrieval`, Memorix Explorer smoke scripts  
+**Target package:** `@x12i/xronox`  
+**Priority:** P1 (ergonomics — not blocking inventory if roles + DB vars are set explicitly)
+
+---
+
+## Summary
+
+Memorix documents **`MEMORIX_ENTITIES_DB`** and **`MEMORIX_EVENTS_DB`**. Xronox zero-config resolves databases via **`MONGO_OPERATIONAL_DB`**, **`MONGO_LOGS_DB`**, and role maps (`memorix_entities`, `memorix_events`). Deployments must duplicate env vars today.
+
+This FR aligns Xronox zero-config with Memorix conventions so smoke and Explorer work with **`MONGO_URI` + `MEMORIX_*_DB` only**.
+
+---
+
+## Product requirement
+
+When resolving Mongo database names for roles:
+
+| Xronox role | Memorix target | Fallback chain should include |
+|-------------|----------------|------------------------------|
+| `memorix_entities` / `memory.entities` / `operational` | `entity` | `MEMORIX_ENTITIES_DB` → `memorix-entities` |
+| `memorix_events` / `memory.events` / `logs` | `event` | `MEMORIX_EVENTS_DB` → `memorix-events` |
+
+---
+
+## Proposed options (pick one or both)
+
+### Option A — Env aliases in role resolution
+
+In `resolveDatabaseNameFromRole` / `MONGO_ROLE_MAP` fallback chains:
+
+```
+memorix_entities.database ← MEMORIX_ENTITIES_DB ← MONGO_OPERATIONAL_DB ← MONGO_DB
+memorix_events.database   ← MEMORIX_EVENTS_DB   ← MONGO_LOGS_DB       ← MONGO_DB
+```
+
+### Option B — Zero-config preset
+
+```ts
+await xronox.init({ engine: "nxMongo", preset: "memorix", zeroConfig: true });
+```
+
+Preset registers role map defaults and env aliases above. Document in Xronox README + `.env.example`.
+
+---
+
+## Acceptance criteria
+
+- [ ] `npm run smoke:retrieval` in memorix-retrieval succeeds with only `MONGO_URI`, `MEMORIX_ENTITIES_DB`, `MEMORIX_EVENTS_DB`, Catalox creds
+- [ ] No requirement to set `MONGO_OPERATIONAL_DB` / `MONGO_LOGS_DB` for Memorix deployments
+- [ ] Existing non-Memorix zero-config behavior unchanged when preset not used
+
+---
+
+## Retrieval integration (after ship)
+
+- Optionally simplify `createMemorixXronoxFromEnv` to pass `preset: "memorix"`.
+- Update [MEMORIX-DATABASE-CONVENTIONS.md](../MEMORIX-DATABASE-CONVENTIONS.md) with single env table.
+
+---
+
+## Non-goals
+
+- Catalox or descriptor env (stays in `@x12i/catalox`)
+- Changing Memorix collection naming (retrieval + Catalox)

package/docs/fr/xronox-fr-per-role-selftest.md

@@ -0,0 +1,60 @@
+# Feature request — per-role `selfTest` detail (`@x12i/xronox`)
+
+**Date:** 2026-05-22  
+**Status:** **Open**  
+**Requested by:** `@x12i/memorix-retrieval` (`getMemorixRetrievalHealth`)  
+**Target package:** `@x12i/xronox`  
+**Priority:** P2 (health UX — not blocking lists or inventory)
+
+---
+
+## Summary
+
+Memorix runs **two** Mongo databases (entity + event). Health checks should report connectivity **per role**, not a single anonymous ping. Retrieval already passes `selfTestRoles: ["memorix_entities", "memorix_events"]` to the adapter when Xronox supports it.
+
+---
+
+## Product requirement
+
+Extend `selfTest` result so hosts can show which Memorix store failed:
+
+```ts
+type SelfTestResult = {
+  passed: boolean;
+  roles?: Array<{
+    role: string;
+    db: string;
+    ok: boolean;
+    latencyMs?: number;
+    error?: string;
+  }>;
+};
+```
+
+```ts
+await xronox.selfTest({
+  testConnectivity: true,
+  selfTestRoles: ["memorix_entities", "memorix_events"],
+});
+```
+
+---
+
+## Acceptance criteria
+
+- [ ] Each role resolves DB name and attempts connectivity (e.g. listCollections or count on a lightweight op)
+- [ ] `passed: false` if any requested role fails
+- [ ] Works with Memorix env vars when [memorix-env-preset FR](./xronox-fr-memorix-env-preset.md) is also applied (or explicit DB vars)
+
+---
+
+## Retrieval integration (after ship)
+
+- `getMemorixRetrievalHealth` surfaces per-role results in response (optional field)
+- Remove direct Mongo ping fallback from health when Xronox reports both roles
+
+---
+
+## Non-goals
+
+- Descriptor / Catalox health (retrieval discovers Catalox separately)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/memorix-retrieval",
-  "version": "1.5.1",
+  "version": "1.6.2",
   "description": "Descriptor-driven Memorix retrieval layer for lists, items, and content objects",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,7 +32,7 @@
   "dependencies": {
     "@x12i/catalox": "^5.0.0",
     "@x12i/helpers": "^1.7.0",
-    "@x12i/xronox": "^3.8.0"
+    "@x12i/xronox": "^3.9.0"
   },
   "devDependencies": {
     "@types/node": "^20.14.0",