npm - @x12i/memorix-service - Versions diffs - 3.0.0 → 3.0.1 - Mend

@x12i/memorix-service 3.0.0 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (26) hide show

package/README.md +71 -22
package/dist/app.d.ts.map +1 -1
package/dist/app.js +25 -1
package/dist/app.js.map +1 -1
package/dist/journey/collect.d.ts +53 -0
package/dist/journey/collect.d.ts.map +1 -0
package/dist/journey/collect.js +220 -0
package/dist/journey/collect.js.map +1 -0
package/dist/journey/coverage.d.ts +46 -0
package/dist/journey/coverage.d.ts.map +1 -0
package/dist/journey/coverage.js +103 -0
package/dist/journey/coverage.js.map +1 -0
package/dist/live.d.ts +18 -0
package/dist/live.d.ts.map +1 -0
package/dist/live.js +9 -0
package/dist/live.js.map +1 -0
package/dist/openapi/openapi.json +405 -1
package/dist/platform.d.ts.map +1 -1
package/dist/platform.js +7 -2
package/dist/platform.js.map +1 -1
package/dist/routes/data-journey.d.ts +4 -0
package/dist/routes/data-journey.d.ts.map +1 -0
package/dist/routes/data-journey.js +199 -0
package/dist/routes/data-journey.js.map +1 -0
package/openapi/openapi.json +405 -1
package/package.json +13 -11

package/README.md CHANGED Viewed

@@ -1,21 +1,19 @@
-# @x12i/memorix-service
+# `@x12i/memorix-service`
 Sole production **HTTP composition root** over accepted Memorix packages.
-## Scope
+Remote apps should **call** this service over HTTP — not reinvent wiring by installing every engine. Running the process (or a hosted deployment) is the product surface.
-Every `/api/*` request requires:
-- `x-memorix-org-id` — organization data universe
-- `x-memorix-agent-ids` — comma-separated agent ids (effective metadata)
-Singular `agentId` headers are rejected.
+## Install / run
-## Run
+```bash
+npm install @x12i/memorix-service@3.0.0   # composition library / CLI
+```
 Prefer the monorepo stack (service + Studio + ops-source):
 ```bash
+# from repo root
 node scripts/dev-stack.mjs
 ```
@@ -26,28 +24,79 @@ MEMORIX_SERVICE_MODE=prod MONGO_URI=mongodb://127.0.0.1:27017 npm run serve
 MEMORIX_SERVICE_MODE=dev npm run dev   # metadata in-memory; durable routes 503 without Mongo
 ```
-Default port: **5000** (`MEMORIX_SERVICE_PORT`, Memorix strip 5000–5099, even = API).
-OpenAPI: `GET /api/openapi.json` → http://127.0.0.1:5000/api/openapi.json
+| | |
+|--|--|
+| Default port | **5100** (`MEMORIX_SERVICE_PORT`) |
+| OpenAPI | `GET /api/openapi.json` |
-## Route families
+## Library exports
+When embedding the composition root in-process:
+```ts
+import {
+  createMemorixPlatform,
+  createMemorixServiceApp,
+  startMemorixServiceHttp,
+} from "@x12i/memorix-service";
+```
+## Scope headers
-`/api/metadata` · `/api/data` · `/api/relationships` · `/api/memory` · `/api/pipelines` · `/api/operations` · `/api/workflow` · `/api/intelligence`
+Every `/api/*` request requires:
+```http
+x-memorix-org-id: g12ops-demo
+x-memorix-agent-ids: ops
+```
+Singular `agentId` headers are rejected. `agentIds[]` selects **effective metadata**; `orgId` selects the **data** universe.
+### Minimal curl
-Metadata highlights:
+```bash
+curl -s http://127.0.0.1:5100/health
+curl -s http://127.0.0.1:5100/api/diagnostics/scope \
+  -H 'x-memorix-org-id: g12ops-demo' \
+  -H 'x-memorix-agent-ids: ops'
+```
-- `GET /api/metadata/kinds` — built-in kinds + effective custom kind-declarations
-- `GET /api/metadata/kinds/:kind` — items for a built-in or namespaced custom kind
-- Custom kinds are **store/resolve only** (engines do not interpret them)
+## Route families
+| Family | Role |
+|--------|------|
+| `/api/metadata` | Kinds, definitions, install/publish |
+| `/api/data` | Content get/list/write, compose, abstract |
+| `/api/relationships` | Query / discover / verify / rebuild (**no** ad-hoc link PUT) |
+| `/api/memory` | Pull, raw, sources, runs |
+| `/api/pipelines` | Definitions, start, runs, retry/resume |
+| `/api/operations` | Operational helpers |
+| `/api/workflow` | Workflow sibling content |
+| `/api/intelligence` | Profiles / proposals (never auto-install) |
+| `/api/data-journey` | Evidence cone + expected-vs-filled coverage |
+### Data journey (read-only)
+| Method | Path |
+|--------|------|
+| `GET` | `/api/data-journey/object-types` |
+| `GET` | `/api/data-journey/journeys` |
+| `POST` | `/api/data-journey/matrix/query` |
+| `POST` | `/api/data-journey/matrix/columns/query` |
+| `POST` | `/api/data-journey/matrix/cells/query` |
+| `GET` | `/api/data-journey/evidence/:evidenceRef` |
+| `GET` | `/api/data-journey/expected-slots` |
+| `POST` | `/api/data-journey/coverage` |
 ## Hard rules
 - Prod rejects missing Mongo and in-memory durable fallbacks
-- No ad-hoc relationship link mutation (`/api/relationships/links` → 405)
+- `/api/relationships/links` → **405** (no ad-hoc link mutation)
 - Intelligence never auto-installs/publishes
 - Only `credentialRef` may cross Memory APIs
-Ebooks: [Platform Overview](../new-ebooks/00-platform-overview/) · [Runtime Data Client](../new-ebooks/02-runtime-data-client/)
----
+## Docs
-**Ebooks:** [https://ebooks.memorix.x12i.com](https://ebooks.memorix.x12i.com) · in-repo [`../new-ebooks/`](../new-ebooks/)
+- [`documentation/http-api.md`](../documentation/http-api.md) · OpenAPI in-repo [`openapi/openapi.json`](./openapi/openapi.json)
+- Ebooks: [Platform Overview](../new-ebooks/00-platform-overview/) · [Services](../new-ebooks/07-services/) · [Runtime Data Client](../new-ebooks/02-runtime-data-client/)
+- Hub: [https://ebooks.memorix.x12i.com](https://ebooks.memorix.x12i.com)

package/dist/app.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAIA,OAAO,OAAO,EAAE,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;~~AAGxD~~,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;~~AAavB~~,MAAM,MAAM,8BAA8B,GAAG,YAAY,GAAG;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,8BAA8B,GACnC,OAAO,CAAC;IAAE,GAAG,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,CAAC,~~CAiD9D~~;AAED,MAAM,MAAM,0BAA0B,GAAG,8BAA8B,GAAG;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,0BAA0B;;;;;GAM7E"}
1	+ {"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAIA,OAAO,OAAO,EAAE,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAIxD,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAevB,MAAM,MAAM,8BAA8B,GAAG,YAAY,GAAG;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,8BAA8B,GACnC,OAAO,CAAC;IAAE,GAAG,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,CAAC,CAuE9D;AAED,MAAM,MAAM,0BAA0B,GAAG,8BAA8B,GAAG;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,0BAA0B;;;;;GAM7E"}

package/dist/app.js CHANGED Viewed

@@ -4,6 +4,7 @@ import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import Fastify from "fastify";
 import cors from "@fastify/cors";
+import { attachFastifyLiveView } from "@x12i/api-live-view/fastify";
 import { mapErrorToHttp, redactSecrets } from "./errors.js";
 import { createMemorixPlatform, } from "./platform.js";
 import { resolveScope } from "./request-scope.js";
@@ -15,6 +16,8 @@ import { registerPipelineRoutes } from "./routes/pipelines.js";
 import { registerOperationsRoutes } from "./routes/operations.js";
 import { registerWorkflowRoutes } from "./routes/workflow.js";
 import { registerIntelligenceRoutes } from "./routes/intelligence.js";
+import { registerDataJourneyRoutes } from "./routes/data-journey.js";
+import { memorixLiveRing } from "./live.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 export async function createMemorixServiceApp(opts) {
     const platform = opts.platform ?? (await createMemorixPlatform(opts));
@@ -27,6 +30,26 @@ export async function createMemorixServiceApp(opts) {
         req.correlationId = correlationId;
         reply.header("x-correlation-id", correlationId);
     });
+    const port = Number(process.env.MEMORIX_SERVICE_PORT ?? 5100);
+    await attachFastifyLiveView(app, {
+        ring: memorixLiveRing,
+        service: {
+            id: "@x12i/memorix-service",
+            title: "Memorix Service",
+            kind: "api",
+            port,
+            env: "MEMORIX_SERVICE_PORT",
+            origin: `http://127.0.0.1:${port}/`,
+            healthPath: "/health",
+            docsUrl: `http://127.0.0.1:${port}/api/openapi.json`,
+            description: "Sole HTTP composition root",
+        },
+        getHealth: async () => ({
+            ok: true,
+            service: "@x12i/memorix-service",
+            mode: platform.mode,
+        }),
+    });
     app.setErrorHandler((err, req, reply) => {
         const correlationId = req.correlationId ?? randomUUID();
         const mapped = mapErrorToHttp(err, correlationId);
@@ -55,11 +78,12 @@ export async function createMemorixServiceApp(opts) {
     await registerOperationsRoutes(app, platform);
     await registerWorkflowRoutes(app, platform);
     await registerIntelligenceRoutes(app, platform);
+    await registerDataJourneyRoutes(app, platform);
     return { app, platform };
 }
 export async function startMemorixServiceHttp(opts) {
     const { app, platform } = await createMemorixServiceApp(opts);
-    const port = opts.port ?? Number(process.env.MEMORIX_SERVICE_PORT ?? 5000);
+    const port = opts.port ?? Number(process.env.MEMORIX_SERVICE_PORT ?? 5100);
     const host = opts.host ?? "127.0.0.1";
     await app.listen({ port, host });
     return { app, platform, port, host };

package/dist/app.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,OAAiC,MAAM,SAAS,CAAC;AACxD,OAAO,IAAI,MAAM,eAAe,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,qBAAqB,GAGtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;~~AAEtE~~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~~IAEhD~~,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAAgC;IAC5E,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,IAAI,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC;IACtC,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACjC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC"}
1	+ {"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,OAAiC,MAAM,SAAS,CAAC;AACxD,OAAO,IAAI,MAAM,eAAe,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,qBAAqB,GAGtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAO1D,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAoC;IAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,MAAM,GAAG,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC;IACtD,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC5C,MAAM,aAAa,GACjB,CAAC,OAAO,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,QAAQ;YAClD,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;YAClC,UAAU,EAAE,CAAC;QACd,GAAkC,CAAC,aAAa,GAAG,aAAa,CAAC;QAClE,KAAK,CAAC,MAAM,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,IAAI,CAAC,CAAC;IAC9D,MAAM,qBAAqB,CAAC,GAAG,EAAE;QAC/B,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE;YACP,EAAE,EAAE,uBAAuB;YAC3B,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,KAAK;YACX,IAAI;YACJ,GAAG,EAAE,sBAAsB;YAC3B,MAAM,EAAE,oBAAoB,IAAI,GAAG;YACnC,UAAU,EAAE,SAAS;YACrB,OAAO,EAAE,oBAAoB,IAAI,mBAAmB;YACpD,WAAW,EAAE,4BAA4B;SAC1C;QACD,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACtB,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,uBAAuB;YAChC,IAAI,EAAE,QAAQ,CAAC,IAAI;SACpB,CAAC;KACH,CAAC,CAAC;IAEH,GAAG,CAAC,eAAe,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACtC,MAAM,aAAa,GAChB,GAAkC,CAAC,aAAa,IAAI,UAAU,EAAE,CAAC;QACpE,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAA6B,CAAC;QACjF,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC9B,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,uBAAuB;QAChC,IAAI,EAAE,QAAQ,CAAC,IAAI;KACpB,CAAC,CAAC,CAAC;IAEJ,GAAG,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACjD,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,wBAAwB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC9C,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,MAAM,sBAAsB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,kBAAkB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACxC,MAAM,0BAA0B,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAChD,MAAM,oBAAoB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,sBAAsB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,wBAAwB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,sBAAsB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,0BAA0B,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAChD,MAAM,yBAAyB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAE/C,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAAgC;IAC5E,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,IAAI,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC;IACtC,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACjC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACvC,CAAC"}

package/dist/journey/collect.d.ts ADDED Viewed

@@ -0,0 +1,53 @@
+import { type JourneyBasis, type JourneyObservation, type MatrixGranularity, type MatrixResponse, type PartialTruthReason } from "@x12i/memorix-data-journey";
+import type { MemorixPlatform } from "../platform.js";
+import type { MemorixScope } from "../scope.js";
+/**
+ * Collect journey observations for run and/or record basis.
+ * Prefers live ports; optional fixtureName loads golden observations (Studio demos / tests).
+ */
+export declare function collectJourneyObservations(platform: MemorixPlatform, scope: MemorixScope, input: {
+    objectType: string;
+    runId?: string;
+    recordId?: string;
+    fixtureName?: string;
+    includeCompose?: boolean;
+}): Promise<{
+    observations: JourneyObservation[];
+    partialReasons: PartialTruthReason[];
+    basis: JourneyBasis;
+}>;
+export declare function queryJourneyMatrix(platform: MemorixPlatform, scope: MemorixScope, body: {
+    objectType?: string;
+    basis?: {
+        kind?: string;
+        runId?: string;
+        recordId?: string;
+        fixtureName?: string;
+    };
+    granularity?: MatrixGranularity;
+    includeValues?: boolean;
+    includeSystem?: boolean;
+    includeRawProperties?: boolean;
+    expandPath?: string;
+    includeCompose?: boolean;
+}): Promise<MatrixResponse & {
+    observations?: JourneyObservation[];
+}>;
+export declare function resolveJourneyEvidence(observations: JourneyObservation[], evidenceRef: string, includeValues: boolean): {
+    origin: import("@x12i/memorix-data-journey").CellOrigin;
+    path: string;
+    valueKind?: import("@x12i/memorix-data-journey").CellValueKind;
+    visibility: import("@x12i/memorix-data-journey").CellVisibility;
+    contentType?: string;
+    recordId?: string;
+    revision?: number;
+    dataCategory?: string;
+    service?: string;
+    phase?: string;
+    runId?: string;
+    attemptId?: string;
+    artifactRef?: string;
+    mutationRef?: string;
+    persistedAtThisCheckpoint?: boolean;
+} | null;
+//# sourceMappingURL=collect.d.ts.map

package/dist/journey/collect.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/journey/collect.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA0ChD;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE;IACL,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GACA,OAAO,CAAC;IACT,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,cAAc,EAAE,kBAAkB,EAAE,CAAC;IACrC,KAAK,EAAE,YAAY,CAAC;CACrB,CAAC,CAyLD;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE;IACJ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GACA,OAAO,CAAC,cAAc,GAAG;IAAE,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAAC,CA6BnE;AAED,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,kBAAkB,EAAE,EAClC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,OAAO;;;;;;;;;;;;;;;;SASvB"}

package/dist/journey/collect.js ADDED Viewed

@@ -0,0 +1,220 @@
+import { attemptToObservations, composeToObservations, linkToDatabaseObservation, loadFixtureObservations, projectMatrix, queryEvidence, recordToDatabaseObservation, } from "@x12i/memorix-data-journey";
+import { ServiceError } from "../errors.js";
+function isDataRef(v) {
+    return (typeof v === "object" &&
+        v !== null &&
+        "artifactId" in v &&
+        typeof v.artifactId === "string");
+}
+async function resolveAttemptOutput(platform, scope, output) {
+    if (output === undefined)
+        return {};
+    if (!isDataRef(output))
+        return { resolved: output };
+    const artifactId = String(output.artifactId);
+    try {
+        const ledger = platform.pipelineLedgerFor(scope.orgId);
+        const art = await ledger.artifacts?.get(scope.orgId, artifactId);
+        if (art?.data !== undefined)
+            return { resolved: art.data };
+    }
+    catch {
+        /* fall through */
+    }
+    return {
+        partial: {
+            code: "missing-artifact",
+            message: `DataRef artifact ${artifactId} could not be resolved`,
+        },
+    };
+}
+/**
+ * Collect journey observations for run and/or record basis.
+ * Prefers live ports; optional fixtureName loads golden observations (Studio demos / tests).
+ */
+export async function collectJourneyObservations(platform, scope, input) {
+    if (input.fixtureName) {
+        const observations = loadFixtureObservations(input.fixtureName).filter((o) => o.objectType === input.objectType);
+        return {
+            observations,
+            partialReasons: [],
+            basis: {
+                kind: input.runId ? "run" : "record",
+                runId: input.runId ?? "run-proc-2",
+                recordId: input.recordId ?? "PROC-2",
+                resolvedAt: new Date().toISOString(),
+            },
+        };
+    }
+    const ports = platform.portsFor(scope);
+    const observations = [];
+    const partialReasons = [];
+    let seq = 10;
+    const now = new Date().toISOString();
+    let runId = input.runId;
+    if (!runId && input.recordId) {
+        // latest-run: pick most recent run that mentions this org
+        const runs = await ports.pipeline.listRuns({ limit: 50 });
+        runId = runs[0]?.runId;
+    }
+    if (runId) {
+        const attempts = await ports.pipeline.getStepAttempts(runId);
+        attempts.sort((a, b) => String(a.startedAt).localeCompare(String(b.startedAt)) ||
+            a.attemptNumber - b.attemptNumber);
+        for (const attempt of attempts) {
+            const { resolved, partial } = await resolveAttemptOutput(platform, scope, attempt.output);
+            if (partial)
+                partialReasons.push(partial);
+            const role = attempt.stepKind === "relationship-discover"
+                ? "relationship-candidate"
+                : attempt.stepKind === "compose"
+                    ? "composition"
+                    : attempt.stepKind === "map-normalize"
+                        ? "mapped"
+                        : attempt.stepKind;
+            const { observations: obs, partialReasons: pr } = attemptToObservations({
+                attemptId: attempt.attemptId,
+                runId: attempt.runId,
+                stepId: attempt.stepId,
+                stepKind: attempt.stepKind,
+                attemptNumber: attempt.attemptNumber,
+                status: attempt.status,
+                output: attempt.output,
+                mutationRefs: attempt.mutationRefs,
+                startedAt: attempt.startedAt,
+                finishedAt: attempt.finishedAt,
+                error: attempt.error,
+            }, {
+                objectType: input.objectType,
+                recordId: input.recordId,
+                sequence: seq,
+                resolvedOutput: resolved,
+                outputRole: role,
+                targetContentType: attempt.stepKind === "write-record" ? "snapshots" : undefined,
+                relationshipGroup: "link",
+            });
+            observations.push(...obs);
+            partialReasons.push(...pr);
+            seq += 10;
+        }
+    }
+    if (input.recordId) {
+        const composed = await ports.reader.composeSubject(scope, {
+            recordId: input.recordId,
+            objectType: input.objectType,
+        });
+        const contents = composed
+            .contents;
+        if (contents) {
+            for (const [ct, records] of Object.entries(contents)) {
+                const list = Array.isArray(records) ? records : [records];
+                for (const rec of list) {
+                    if (!rec || typeof rec !== "object")
+                        continue;
+                    observations.push(recordToDatabaseObservation(rec, {
+                        observationId: `db-${input.recordId}-${ct}-${seq}`,
+                        sequence: seq,
+                        occurredAt: now,
+                        phase: ct === "raw" ? "memory-raw" : `${ct}-stored`,
+                        runId,
+                        includeValues: false,
+                    }));
+                    seq += 1;
+                }
+            }
+        }
+        if (input.includeCompose !== false) {
+            observations.push(...composeToObservations({
+                recordId: input.recordId,
+                objectType: input.objectType,
+                contents: contents,
+            }, {
+                sequence: seq,
+                occurredAt: now,
+                objectType: input.objectType,
+                runId,
+            }));
+            seq += 10;
+        }
+        try {
+            const rels = await ports.reader.getRelationships(scope, input.recordId, {
+                include: true,
+            });
+            for (const item of rels.items ?? []) {
+                const link = item;
+                if (!link.relationshipId)
+                    continue;
+                observations.push(linkToDatabaseObservation({
+                    relationshipId: link.relationshipId,
+                    relationshipDefinitionId: link.relationshipDefinitionId ??
+                        link.definitionId ??
+                        "unknown",
+                    fromRecordId: link.fromRecordId ?? input.recordId,
+                    toRecordId: link.toRecordId ?? "",
+                }, {
+                    observationId: `rel-${link.relationshipId}`,
+                    objectType: input.objectType,
+                    recordId: input.recordId,
+                    sequence: seq++,
+                    occurredAt: now,
+                    group: "link",
+                    runId,
+                }));
+            }
+        }
+        catch {
+            /* relationships optional */
+        }
+    }
+    const basis = {
+        kind: runId ? (input.runId ? "run" : "latest-run") : "record",
+        runId,
+        recordId: input.recordId,
+        resolvedAt: now,
+    };
+    if (observations.length === 0) {
+        partialReasons.push({
+            code: "partial-run",
+            message: "no journey observations collected for the requested basis",
+        });
+    }
+    return { observations, partialReasons, basis };
+}
+export async function queryJourneyMatrix(platform, scope, body) {
+    if (!body.objectType) {
+        throw new ServiceError("VALIDATION", "objectType required", 400);
+    }
+    const collected = await collectJourneyObservations(platform, scope, {
+        objectType: body.objectType,
+        runId: body.basis?.runId,
+        recordId: body.basis?.recordId,
+        fixtureName: body.basis?.fixtureName,
+        includeCompose: body.includeCompose,
+    });
+    const matrix = 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,
+    });
+    return matrix;
+}
+export function resolveJourneyEvidence(observations, evidenceRef, includeValues) {
+    const detail = queryEvidence(observations, evidenceRef);
+    if (!detail)
+        return null;
+    if (!includeValues) {
+        const { value: _v, ...rest } = detail;
+        return rest;
+    }
+    return detail;
+}
+//# sourceMappingURL=collect.js.map

package/dist/journey/collect.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/journey/coverage.d.ts ADDED Viewed

@@ -0,0 +1,46 @@
+import { type JourneyBasis, type ViewDefinitionLike } from "@x12i/memorix-data-journey";
+import type { MemorixPlatform } from "../platform.js";
+import type { MemorixScope } from "../scope.js";
+/** Views from effective metadata (Catalox-backed install). */
+export declare function viewsFromEffectiveMetadata(platform: MemorixPlatform, scope: MemorixScope): ViewDefinitionLike[];
+export declare function queryJourneyCoverage(platform: MemorixPlatform, scope: MemorixScope, body: {
+    objectType?: string;
+    basis?: {
+        kind?: string;
+        runId?: string;
+        recordId?: string;
+        fixtureName?: string;
+    };
+    viewIds?: string[];
+    /** Inline descriptor snapshot (tests / fixture override). */
+    views?: ViewDefinitionLike[];
+    includeRawProperties?: boolean;
+    includeMatrix?: boolean;
+    granularity?: "root" | "content" | "property";
+}): Promise<{
+    matrix?: import("@x12i/memorix-data-journey").MatrixResponse | undefined;
+    scope: {
+        orgId: string;
+        agentIds: string[];
+    };
+    objectType: string;
+    basis: JourneyBasis;
+    truth: import("@x12i/memorix-data-journey").MatrixTruth;
+    expectedSlots: import("@x12i/memorix-data-journey").ExpectedSlot[];
+    coverage: import("@x12i/memorix-data-journey").ExpectedCoverage;
+}>;
+export declare function listExpectedSlots(platform: MemorixPlatform, scope: MemorixScope, opts: {
+    objectType: string;
+    viewIds?: string[];
+    fixtureName?: string;
+    views?: ViewDefinitionLike[];
+}): {
+    scope: {
+        orgId: string;
+        agentIds: string[];
+    };
+    objectType: string;
+    expectedSlots: import("@x12i/memorix-data-journey").ExpectedSlot[];
+    expectedPaths: string[];
+};
+//# sourceMappingURL=coverage.d.ts.map

package/dist/journey/coverage.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../../src/journey/coverage.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgBhD,8DAA8D;AAC9D,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,YAAY,GAClB,kBAAkB,EAAE,CAWtB;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE;IACJ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;CAC/C;;;;;;;;;;;GA6DF;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE;IACJ,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC9B;;;;;;;;EAsBF"}

package/dist/journey/coverage.js ADDED Viewed

@@ -0,0 +1,103 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { coverExpectedAgainstMatrix, expectedPathsFromViews, expectedSlotsFromViews, fixtureRoot, projectMatrix, } from "@x12i/memorix-data-journey";
+import { ServiceError } from "../errors.js";
+import { collectJourneyObservations } from "./collect.js";
+function loadFixtureViews(fixtureName) {
+    try {
+        const path = resolve(fixtureRoot(fixtureName), "inputs/views.json");
+        const doc = JSON.parse(readFileSync(path, "utf8"));
+        return doc.viewDefinitions ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+/** Views from effective metadata (Catalox-backed install). */
+export function viewsFromEffectiveMetadata(platform, scope) {
+    const effective = platform.metadata.resolveEffective(scope.agentIds);
+    return (effective.effective ?? [])
+        .filter((e) => e.kind === "views")
+        .map((e) => {
+        const d = (e.definition ?? {});
+        return {
+            ...d,
+            id: d.id ?? e.id,
+        };
+    });
+}
+export async function queryJourneyCoverage(platform, scope, body) {
+    if (!body.objectType) {
+        throw new ServiceError("VALIDATION", "objectType required", 400);
+    }
+    if (body.basis?.kind === "fixture" && !body.basis.fixtureName) {
+        body.basis.fixtureName = "procedures-proc-2";
+        body.basis.recordId = body.basis.recordId ?? "PROC-2";
+        body.basis.runId = body.basis.runId ?? "run-proc-2";
+    }
+    let views = body.views ?? [];
+    if (views.length === 0 && body.basis?.fixtureName) {
+        views = loadFixtureViews(body.basis.fixtureName);
+    }
+    if (views.length === 0) {
+        views = viewsFromEffectiveMetadata(platform, scope);
+    }
+    const slots = expectedSlotsFromViews(views, {
+        objectType: body.objectType,
+        viewIds: body.viewIds,
+    });
+    const expectedPaths = slots.map((s) => s.path);
+    const collected = await collectJourneyObservations(platform, scope, {
+        objectType: body.objectType,
+        runId: body.basis?.runId,
+        recordId: body.basis?.recordId,
+        fixtureName: body.basis?.fixtureName,
+    });
+    const basis = {
+        ...collected.basis,
+        kind: body.basis?.kind ??
+            collected.basis.kind,
+    };
+    const matrix = projectMatrix(collected.observations, {
+        objectType: body.objectType,
+        basis,
+        granularity: body.granularity ?? "property",
+        includeRawProperties: body.includeRawProperties ?? true,
+        includeValues: false,
+        scope: { orgId: scope.orgId, agentIds: scope.agentIds },
+        partialReasons: collected.partialReasons,
+    });
+    const coverage = coverExpectedAgainstMatrix(expectedPaths, matrix);
+    return {
+        scope: { orgId: scope.orgId, agentIds: scope.agentIds },
+        objectType: body.objectType,
+        basis: matrix.basis,
+        truth: matrix.truth,
+        expectedSlots: slots,
+        coverage,
+        ...(body.includeMatrix ? { matrix } : {}),
+    };
+}
+export function listExpectedSlots(platform, scope, opts) {
+    let views = opts.views ?? [];
+    if (views.length === 0 && opts.fixtureName) {
+        views = loadFixtureViews(opts.fixtureName);
+    }
+    if (views.length === 0) {
+        views = viewsFromEffectiveMetadata(platform, scope);
+    }
+    const slots = expectedSlotsFromViews(views, {
+        objectType: opts.objectType,
+        viewIds: opts.viewIds,
+    });
+    return {
+        scope: { orgId: scope.orgId, agentIds: scope.agentIds },
+        objectType: opts.objectType,
+        expectedSlots: slots,
+        expectedPaths: expectedPathsFromViews(views, {
+            objectType: opts.objectType,
+            viewIds: opts.viewIds,
+        }),
+    };
+}
+//# sourceMappingURL=coverage.js.map