@x12i/memorix-service 3.0.0 → 3.0.1

package/dist/routes/data-journey.js

@@ -0,0 +1,199 @@
+import { resolveScope } from "../request-scope.js";
+import { ServiceError } from "../errors.js";
+import { collectJourneyObservations, queryJourneyMatrix, resolveJourneyEvidence, } from "../journey/collect.js";
+import { listExpectedSlots, queryJourneyCoverage, } from "../journey/coverage.js";
+/** In-memory evidence cache keyed by opaque ref → observation set fingerprint (request-scoped via query). */
+const evidenceCache = new Map();
+function cacheKey(orgId, objectType, runId, recordId) {
+    return `${orgId}|${objectType}|${runId ?? ""}|${recordId ?? ""}`;
+}
+export async function registerDataJourneyRoutes(app, platform) {
+    app.get("/api/data-journey/object-types", async (req) => {
+        const scope = resolveScope(req);
+        const effective = platform.metadata.resolveEffective(scope.agentIds);
+        const objectTypes = (effective.effective ?? [])
+            .filter((e) => e.kind === "object-types")
+            .map((e) => {
+            const d = e.definition;
+            return {
+                objectType: d.objectType ?? d.id ?? e.id,
+                label: d.name ?? d.objectType ?? d.id ?? e.id,
+            };
+        });
+        // Dedup
+        const seen = new Set();
+        const list = objectTypes.filter((o) => {
+            const id = String(o.objectType);
+            if (seen.has(id))
+                return false;
+            seen.add(id);
+            return true;
+        });
+        return { scope, objectTypes: list };
+    });
+    app.get("/api/data-journey/journeys", async (req) => {
+        const scope = resolveScope(req);
+        const q = req.query;
+        if (!q.objectType) {
+            throw new ServiceError("VALIDATION", "objectType required", 400);
+        }
+        const ports = platform.portsFor(scope);
+        const runs = await ports.pipeline.listRuns({ limit: 50 });
+        return {
+            scope,
+            objectType: q.objectType,
+            recordId: q.recordId ?? null,
+            journeys: [
+                {
+                    kind: "latest-run",
+                    runId: runs[0]?.runId ?? null,
+                    label: "Latest pipeline run",
+                },
+                ...runs.slice(0, 20).map((r) => ({
+                    kind: "run",
+                    runId: r.runId,
+                    status: r.status,
+                    pipelineId: r.pipelineId,
+                    label: `Run ${r.runId}`,
+                })),
+                ...(q.recordId
+                    ? [
+                        {
+                            kind: "record",
+                            recordId: q.recordId,
+                            label: `Record ${q.recordId}`,
+                        },
+                    ]
+                    : []),
+                {
+                    kind: "fixture",
+                    fixtureName: "procedures-proc-2",
+                    objectType: "procedures",
+                    recordId: "PROC-2",
+                    label: "Golden fixture PROC-2 (procedures)",
+                },
+            ],
+        };
+    });
+    app.post("/api/data-journey/matrix/query", async (req) => {
+        const scope = resolveScope(req);
+        const body = (req.body ?? {});
+        if (body.basis?.kind === "fixture" && !body.basis.fixtureName) {
+            body.basis.fixtureName = "procedures-proc-2";
+            body.objectType = body.objectType ?? "procedures";
+            body.basis.recordId = body.basis.recordId ?? "PROC-2";
+        }
+        const collected = await collectJourneyObservations(platform, scope, {
+            objectType: body.objectType,
+            runId: body.basis?.runId,
+            recordId: body.basis?.recordId,
+            fixtureName: body.basis?.fixtureName,
+        });
+        const key = cacheKey(scope.orgId, body.objectType, body.basis?.runId ?? collected.basis.runId, body.basis?.recordId ?? collected.basis.recordId);
+        evidenceCache.set(key, {
+            observations: collected.observations,
+            expires: Date.now() + 5 * 60_000,
+        });
+        const { projectMatrix } = await import("@x12i/memorix-data-journey");
+        return projectMatrix(collected.observations, {
+            objectType: body.objectType,
+            basis: {
+                ...collected.basis,
+                kind: body.basis?.kind ??
+                    collected.basis.kind,
+            },
+            granularity: body.granularity ?? "root",
+            includeValues: body.includeValues ?? false,
+            includeSystem: body.includeSystem ?? false,
+            includeRawProperties: body.includeRawProperties ?? false,
+            expandPath: body.expandPath,
+            scope: { orgId: scope.orgId, agentIds: scope.agentIds },
+            partialReasons: collected.partialReasons,
+        });
+    });
+    app.post("/api/data-journey/matrix/columns/query", async (req) => {
+        const scope = resolveScope(req);
+        const body = (req.body ?? {});
+        if (body.basis?.kind === "fixture" && !body.basis.fixtureName) {
+            body.basis.fixtureName = "procedures-proc-2";
+            body.objectType = body.objectType ?? "procedures";
+        }
+        return queryJourneyMatrix(platform, scope, {
+            ...body,
+            granularity: "property",
+            expandPath: body.parentPath,
+        });
+    });
+    app.post("/api/data-journey/matrix/cells/query", async (req) => {
+        const scope = resolveScope(req);
+        const body = (req.body ?? {});
+        if (body.basis?.kind === "fixture" && !body.basis.fixtureName) {
+            body.basis.fixtureName = "procedures-proc-2";
+            body.objectType = body.objectType ?? "procedures";
+        }
+        const matrix = await queryJourneyMatrix(platform, scope, {
+            ...body,
+            granularity: "property",
+            includeRawProperties: body.includeRawProperties ?? true,
+        });
+        const rowSet = body.rowIds ? new Set(body.rowIds) : null;
+        const colSet = body.columnIds ? new Set(body.columnIds) : null;
+        const cells = matrix.cells.filter((c) => {
+            if (rowSet && !rowSet.has(c.rowId))
+                return false;
+            if (colSet && !colSet.has(c.columnId))
+                return false;
+            return true;
+        });
+        return { scope, cells, truth: matrix.truth };
+    });
+    app.get("/api/data-journey/evidence/:evidenceRef", async (req) => {
+        const scope = resolveScope(req);
+        const { evidenceRef } = req.params;
+        const q = req.query;
+        if (!q.objectType) {
+            throw new ServiceError("VALIDATION", "objectType query required", 400);
+        }
+        const key = cacheKey(scope.orgId, q.objectType, q.runId, q.recordId);
+        let cached = evidenceCache.get(key);
+        if (!cached || cached.expires < Date.now()) {
+            const collected = await collectJourneyObservations(platform, scope, {
+                objectType: q.objectType,
+                runId: q.runId,
+                recordId: q.recordId,
+                fixtureName: q.fixtureName,
+            });
+            cached = {
+                observations: collected.observations,
+                expires: Date.now() + 5 * 60_000,
+            };
+            evidenceCache.set(key, cached);
+        }
+        const decoded = decodeURIComponent(evidenceRef);
+        const detail = resolveJourneyEvidence(cached.observations, decoded, q.includeValues === "true");
+        if (!detail) {
+            throw new ServiceError("NOT_FOUND", "evidence not found", 404);
+        }
+        return { scope, evidence: detail };
+    });
+    app.get("/api/data-journey/expected-slots", async (req) => {
+        const scope = resolveScope(req);
+        const q = req.query;
+        if (!q.objectType) {
+            throw new ServiceError("VALIDATION", "objectType required", 400);
+        }
+        return listExpectedSlots(platform, scope, {
+            objectType: q.objectType,
+            viewIds: q.viewIds
+                ? q.viewIds.split(",").map((s) => s.trim()).filter(Boolean)
+                : undefined,
+            fixtureName: q.fixtureName,
+        });
+    });
+    app.post("/api/data-journey/coverage", async (req) => {
+        const scope = resolveScope(req);
+        const body = (req.body ?? {});
+        return queryJourneyCoverage(platform, scope, body);
+    });
+}
+//# sourceMappingURL=data-journey.js.map

package/dist/routes/data-journey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-journey.js","sourceRoot":"","sources":["../../src/routes/data-journey.ts"],"names":[],"mappings":"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"}

package/openapi/openapi.json

@@ -7,7 +7,7 @@
   },
   "servers": [
     {
-      "url": "http://127.0.0.1:5000"
+      "url": "http://127.0.0.1:5100"
     }
   ],
   "tags": [
@@ -37,6 +37,10 @@
     },
     {
       "name": "Intelligence"
+    },
+    {
+      "name": "DataJourney",
+      "description": "Evidence cone and expected-vs-filled coverage (read-only)"
     }
   ],
   "paths": {
@@ -5338,6 +5342,406 @@
           }
         }
       }
+    },
+    "/api/data-journey/object-types": {
+      "get": {
+        "tags": [
+          "DataJourney"
+        ],
+        "summary": "List object types for journey selector",
+        "parameters": [
+          {
+            "in": "header",
+            "name": "x-memorix-org-id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "x-memorix-agent-ids",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "objectTypes list"
+          }
+        }
+      }
+    },
+    "/api/data-journey/journeys": {
+      "get": {
+        "tags": [
+          "DataJourney"
+        ],
+        "summary": "List journey bases (runs, record, fixture)",
+        "parameters": [
+          {
+            "in": "header",
+            "name": "x-memorix-org-id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "x-memorix-agent-ids",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "objectType",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "recordId",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "journeys"
+          }
+        }
+      }
+    },
+    "/api/data-journey/matrix/query": {
+      "post": {
+        "tags": [
+          "DataJourney"
+        ],
+        "summary": "Project evidence cone matrix",
+        "parameters": [
+          {
+            "in": "header",
+            "name": "x-memorix-org-id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "x-memorix-agent-ids",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "objectType"
+                ],
+                "properties": {
+                  "objectType": {
+                    "type": "string"
+                  },
+                  "basis": {
+                    "type": "object"
+                  },
+                  "granularity": {
+                    "type": "string",
+                    "enum": [
+                      "root",
+                      "content",
+                      "property"
+                    ]
+                  },
+                  "includeValues": {
+                    "type": "boolean"
+                  },
+                  "includeRawProperties": {
+                    "type": "boolean"
+                  },
+                  "includeSystem": {
+                    "type": "boolean"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "MatrixResponse"
+          }
+        }
+      }
+    },
+    "/api/data-journey/matrix/columns/query": {
+      "post": {
+        "tags": [
+          "DataJourney"
+        ],
+        "summary": "Lazy column expansion",
+        "parameters": [
+          {
+            "in": "header",
+            "name": "x-memorix-org-id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "x-memorix-agent-ids",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "columns"
+          }
+        }
+      }
+    },
+    "/api/data-journey/matrix/cells/query": {
+      "post": {
+        "tags": [
+          "DataJourney"
+        ],
+        "summary": "Viewport cells",
+        "parameters": [
+          {
+            "in": "header",
+            "name": "x-memorix-org-id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "x-memorix-agent-ids",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "cells"
+          }
+        }
+      }
+    },
+    "/api/data-journey/expected-slots": {
+      "get": {
+        "tags": [
+          "DataJourney"
+        ],
+        "summary": "Descriptor-expected journey paths (views)",
+        "parameters": [
+          {
+            "in": "header",
+            "name": "x-memorix-org-id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "x-memorix-agent-ids",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "objectType",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "fixtureName",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "viewIds",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "expectedSlots"
+          }
+        }
+      }
+    },
+    "/api/data-journey/coverage": {
+      "post": {
+        "tags": [
+          "DataJourney"
+        ],
+        "summary": "Expected (views) vs filled (evidence)",
+        "parameters": [
+          {
+            "in": "header",
+            "name": "x-memorix-org-id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "x-memorix-agent-ids",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "objectType"
+                ],
+                "properties": {
+                  "objectType": {
+                    "type": "string"
+                  },
+                  "basis": {
+                    "type": "object"
+                  },
+                  "viewIds": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "includeMatrix": {
+                    "type": "boolean"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "coverage + optional matrix"
+          }
+        }
+      }
+    },
+    "/api/data-journey/evidence/{evidenceRef}": {
+      "get": {
+        "tags": [
+          "DataJourney"
+        ],
+        "summary": "Cell evidence detail",
+        "parameters": [
+          {
+            "in": "header",
+            "name": "x-memorix-org-id",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "x-memorix-agent-ids",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "path",
+            "name": "evidenceRef",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "objectType",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "includeValues",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "fixtureName",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "runId",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "recordId",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "evidence"
+          },
+          "404": {
+            "description": "not found"
+          }
+        }
+      }
     }
   },
   "components": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/memorix-service",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Memorix production service composition root — one versioned API over accepted packages (Phase 10 / G10).",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,16 +32,18 @@
   },
   "dependencies": {
     "@fastify/cors": "^10.0.1",
-    "@x12i/memorix-data": "^3.0.0",
-    "@x12i/memorix-format": "^3.0.0",
-    "@x12i/memorix-intelligence": "^3.0.0",
-    "@x12i/memorix-mapping": "^3.0.0",
-    "@x12i/memorix-memory": "^3.0.0",
-    "@x12i/memorix-metadata": "^3.0.0",
-    "@x12i/memorix-metadata-runtime": "^3.0.0",
-    "@x12i/memorix-pipeline": "^3.0.0",
-    "@x12i/memorix-relationship-store": "^3.0.0",
-    "@x12i/memorix-relationships": "^3.0.0",
+    "@x12i/memorix-data": "^3.0.1",
+    "@x12i/api-live-view": "^1.0.2",
+    "@x12i/memorix-data-journey": "^3.0.1",
+    "@x12i/memorix-format": "^3.0.1",
+    "@x12i/memorix-intelligence": "^3.0.1",
+    "@x12i/memorix-mapping": "^3.0.1",
+    "@x12i/memorix-memory": "^3.0.1",
+    "@x12i/memorix-metadata": "^3.0.1",
+    "@x12i/memorix-metadata-runtime": "^3.0.1",
+    "@x12i/memorix-pipeline": "^3.0.1",
+    "@x12i/memorix-relationship-store": "^3.0.1",
+    "@x12i/memorix-relationships": "^3.0.1",
     "fastify": "^5.1.0",
     "mongodb": "^6.21.0"
   },