@x12i/memorix-service 0.2.0 → 3.0.1

package/README.md

@@ -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

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

@@ -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

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

package/dist/journey/collect.d.ts

@@ -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

@@ -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

@@ -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

@@ -0,0 +1 @@
+{"version":3,"file":"collect.js","sourceRoot":"","sources":["../../src/journey/collect.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,2BAA2B,GAM5B,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,SAAS,SAAS,CAAC,CAAU;IAC3B,OAAO,CACL,OAAO,CAAC,KAAK,QAAQ;QACrB,CAAC,KAAK,IAAI;QACV,YAAY,IAAI,CAAC;QACjB,OAAQ,CAA8B,CAAC,UAAU,KAAK,QAAQ,CAC/D,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,QAAyB,EACzB,KAAmB,EACnB,MAAe;IAEf,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACpD,MAAM,UAAU,GAAG,MAAM,CAAE,MAAiC,CAAC,UAAU,CAAC,CAAC;IACzE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAOpD,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACjE,IAAI,GAAG,EAAE,IAAI,KAAK,SAAS;YAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;IACD,OAAO;QACL,OAAO,EAAE;YACP,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,oBAAoB,UAAU,wBAAwB;SAChE;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,QAAyB,EACzB,KAAmB,EACnB,KAMC;IAMD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,MAAM,YAAY,GAAG,uBAAuB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,MAAM,CACpE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,CACzC,CAAC;QACF,OAAO;YACL,YAAY;YACZ,cAAc,EAAE,EAAE;YAClB,KAAK,EAAE;gBACL,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ;gBACpC,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,YAAY;gBAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,QAAQ;gBACpC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACrC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,YAAY,GAAyB,EAAE,CAAC;IAC9C,MAAM,cAAc,GAAyB,EAAE,CAAC;IAChD,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,IAAI,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACxB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,0DAA0D;QAC1D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1D,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;IACzB,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC7D,QAAQ,CAAC,IAAI,CACX,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACtD,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CACpC,CAAC;QACF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,oBAAoB,CACtD,QAAQ,EACR,KAAK,EACL,OAAO,CAAC,MAAM,CACf,CAAC;YACF,IAAI,OAAO;gBAAE,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM,IAAI,GACR,OAAO,CAAC,QAAQ,KAAK,uBAAuB;gBAC1C,CAAC,CAAC,wBAAwB;gBAC1B,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS;oBAC9B,CAAC,CAAC,aAAa;oBACf,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,eAAe;wBACpC,CAAC,CAAC,QAAQ;wBACV,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC3B,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,EAAE,GAAG,qBAAqB,CACrE;gBACE,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,aAAa,EAAE,OAAO,CAAC,aAAa;gBACpC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,YAAY,EAAG,OAAwC,CAAC,YAAY;gBACpE,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,EACD;gBACE,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,QAAQ,EAAE,GAAG;gBACb,cAAc,EAAE,QAAQ;gBACxB,UAAU,EAAE,IAAI;gBAChB,iBAAiB,EACf,OAAO,CAAC,QAAQ,KAAK,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;gBAC/D,iBAAiB,EAAE,MAAM;aAC1B,CACF,CAAC;YACF,YAAY,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;YAC1B,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAC3B,GAAG,IAAI,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE;YACxD,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,CAAC,CAAC;QACH,MAAM,QAAQ,GAAI,QAAmD;aAClE,QAAQ,CAAC;QACZ,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACrD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC1D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACvB,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;wBAAE,SAAS;oBAC9C,YAAY,CAAC,IAAI,CACf,2BAA2B,CAAC,GAA8B,EAAE;wBAC1D,aAAa,EAAE,MAAM,KAAK,CAAC,QAAQ,IAAI,EAAE,IAAI,GAAG,EAAE;wBAClD,QAAQ,EAAE,GAAG;wBACb,UAAU,EAAE,GAAG;wBACf,KAAK,EAAE,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS;wBACnD,KAAK;wBACL,aAAa,EAAE,KAAK;qBACrB,CAAC,CACH,CAAC;oBACF,GAAG,IAAI,CAAC,CAAC;gBACX,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,cAAc,KAAK,KAAK,EAAE,CAAC;YACnC,YAAY,CAAC,IAAI,CACf,GAAG,qBAAqB,CACtB;gBACE,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,QAAQ,EAAE,QAAiB;aAC5B,EACD;gBACE,QAAQ,EAAE,GAAG;gBACb,UAAU,EAAE,GAAG;gBACf,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,KAAK;aACN,CACF,CACF,CAAC;YACF,GAAG,IAAI,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE;gBACtE,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YACH,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;gBACpC,MAAM,IAAI,GAAG,IAMZ,CAAC;gBACF,IAAI,CAAC,IAAI,CAAC,cAAc;oBAAE,SAAS;gBACnC,YAAY,CAAC,IAAI,CACf,yBAAyB,CACvB;oBACE,cAAc,EAAE,IAAI,CAAC,cAAc;oBACnC,wBAAwB,EACtB,IAAI,CAAC,wBAAwB;wBAC7B,IAAI,CAAC,YAAY;wBACjB,SAAS;oBACX,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,QAAQ;oBACjD,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;iBAClC,EACD;oBACE,aAAa,EAAE,OAAO,IAAI,CAAC,cAAc,EAAE;oBAC3C,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,QAAQ,EAAE,GAAG,EAAE;oBACf,UAAU,EAAE,GAAG;oBACf,KAAK,EAAE,MAAM;oBACb,KAAK;iBACN,CACF,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAiB;QAC1B,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ;QAC7D,KAAK;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,GAAG;KAChB,CAAC;IAEF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,cAAc,CAAC,IAAI,CAAC;YAClB,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,2DAA2D;SACrE,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAyB,EACzB,KAAmB,EACnB,IAcC;IAED,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,IAAI,YAAY,CAAC,YAAY,EAAE,qBAAqB,EAAE,GAAG,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,0BAA0B,CAAC,QAAQ,EAAE,KAAK,EAAE;QAClE,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK;QACxB,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ;QAC9B,WAAW,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW;QACpC,cAAc,EAAE,IAAI,CAAC,cAAc;KACpC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,YAAY,EAAE;QACnD,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE;YACL,GAAG,SAAS,CAAC,KAAK;YAClB,IAAI,EACD,IAAI,CAAC,KAAK,EAAE,IAA6B,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI;SACrE;QACD,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,MAAM;QACvC,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,KAAK;QAC1C,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,KAAK;QAC1C,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,IAAI,KAAK;QACxD,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;QACvD,cAAc,EAAE,SAAS,CAAC,cAAc;KACzC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,YAAkC,EAClC,WAAmB,EACnB,aAAsB;IAEtB,MAAM,MAAM,GAAG,aAAa,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/journey/coverage.d.ts

@@ -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

@@ -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

@@ -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