@exellix/exellix-matrix-read 1.0.1

package/README.md

@@ -0,0 +1,87 @@
+# `@exellix/exellix-matrix-read`
+
+**Read-only execution-matrix data tier** — programmatic and HTTP access to entity+graph job history, status counts, and execution output. Independent of `@exellix/exellix-jobs` (the worker).
+
+Use this when Studio, BFF, or analytics need answers like:
+
+- For **entity type X** and **graph Y**, how many matrix rows are processed / failed / waiting?
+- What **jobId**, **timestamps**, and **inference** ran for each graph slot?
+- Memorix entity statistics **joined** with matrix rows for one namespace.
+
+## Boundaries
+
+| Package | Role |
+|---------|------|
+| **`@exellix/exellix-matrix-read`** | Read tier + optional read HTTP |
+| **`@exellix/exellix-jobs`** | Claim, execute, operator control (pause, PATCH) |
+| **`@exellix/exellix-runtime`** | Row shapes, orchestration, low-level read helpers |
+| **`@x12i/xmemory-store`** | Matrix + Memorix persistence factories |
+
+No `mongodb` / `@x12i/xronox-store` in this package’s dependencies.
+
+## Programmatic API
+
+```ts
+import { openMatrixReadTier } from '@exellix/exellix-matrix-read';
+
+const tier = await openMatrixReadTier({
+  mongoUri: process.env.MONGO_URI,
+});
+
+// Counts by slot status for one graph (optional inputGroupByPath for per-entity buckets)
+const dashboard = await tier.graphDashboard({
+  matrixCatalogId: 'my-matrix',
+  graphId: 'my-graph',
+  inputGroupByPath: 'entityKind',
+});
+
+// Per-row graph slots: status, jobId, inference
+const overview = await tier.multiGraphOverview({ matrixCatalogId: 'my-matrix' });
+
+// waiting / in-progress / processed / failed / skipped
+const join = await tier.sourceJoinView({
+  matrixCatalogId: 'my-matrix',
+  graphId: 'my-graph',
+});
+
+await tier.close();
+```
+
+### Entity facet (Memorix + matrix)
+
+Pass `memorixTier` from `@x12i/xmemory-store` (`createXmemoryDataTier`) when opening the tier, or set `MATRIX_READ_MEMORIX_ENABLED=true` for `read:serve`.
+
+```ts
+const tier = await openMatrixReadTier({
+  mongoUri: process.env.MONGO_URI,
+  memorixTier: createXmemoryDataTier(),
+});
+
+const facet = await tier.entityFacet({
+  entityType: 'widget',
+  namespace: 'tenant-a',
+  matrixCatalogId: 'my-matrix',
+  graphId: 'my-graph',
+});
+```
+
+## Read HTTP server
+
+```bash
+MONGO_URI=... npm run read:serve
+```
+
+Default port **8090**, prefix **`/v1`**.
+
+| Method | Path | Purpose |
+|--------|------|---------|
+| GET | `/health` | Liveness |
+| GET | `/matrices/:catalogId/graphs/:graphId/dashboard` | Status counts (+ optional `inputGroupByPath`) |
+| GET | `/matrices/:catalogId/graphs/:graphId/navigator` | Paginated rows + histogram |
+| GET | `/matrices/:catalogId/graphs/:graphId/join-view` | Pipeline buckets |
+| GET | `/matrices/:catalogId/overview` | Multi-graph slot view per row |
+| GET | `/entities/:entityType/facet?namespace=` | Memorix + matrix facet |
+
+## Relation to the worker
+
+Both packages open the **same matrix persistence** (operational + config DBs). The worker **writes** rows while claiming; this package **reads** them. Deploy separately: worker replicas for execution, read tier for dashboards (can scale read replicas independently).

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { loadMatrixReadEnv } from './env.js';
+import { startMatrixReadHttp } from './http/server.js';
+import { createMemorixRuntimeTier } from '@exellix/exellix-runtime';
+import { openMatrixReadTier } from './tier.js';
+async function loadDotenvIfAvailable() {
+    const registerPath = '@x12i/env/register';
+    await import(registerPath).catch(() => undefined);
+}
+async function cmdServe() {
+    await loadDotenvIfAvailable();
+    const tier = await openMatrixReadTier({
+        memorixTier: await resolveOptionalMemorixTier(),
+    });
+    const env = loadMatrixReadEnv();
+    const http = await startMatrixReadHttp({ tier, env });
+    console.error(`@exellix/exellix-matrix-read listening on port ${env.port} (prefix ${env.httpPrefix})`);
+    const shutdown = async () => {
+        await http.close();
+        await tier.close();
+    };
+    for (const ev of ['SIGINT', 'SIGTERM']) {
+        process.on(ev, () => {
+            void shutdown().then(() => process.exit(0));
+        });
+    }
+}
+async function resolveOptionalMemorixTier() {
+    if (process.env.MATRIX_READ_MEMORIX_ENABLED !== 'true') {
+        return undefined;
+    }
+    const mongoUri = process.env.MONGO_URI?.trim();
+    if (!mongoUri) {
+        console.error('@exellix/exellix-matrix-read: MATRIX_READ_MEMORIX_ENABLED but MONGO_URI is unset');
+        return undefined;
+    }
+    return createMemorixRuntimeTier({ mongoUri });
+}
+async function main() {
+    const cmd = process.argv[2] ?? 'help';
+    if (cmd === 'serve') {
+        await cmdServe();
+        return;
+    }
+    if (cmd === 'help' || cmd === '-h' || cmd === '--help') {
+        console.log(`@exellix/exellix-matrix-read
+
+Commands:
+  serve   Start read-only HTTP API (no worker bootstrap required).
+
+Environment:
+  MONGO_URI                    Matrix persistence (required for serve).
+  execution_db / config_db     DB names (default exellix-runtime / exellix).
+  PORT                         HTTP port (default 8090).
+  MATRIX_READ_HTTP_PREFIX      Route prefix (default /v1).
+  MATRIX_READ_MEMORIX_ENABLED  When true, wire createMemorixRuntimeTier for /entities/.../facet.
+`);
+        return;
+    }
+    throw new Error(`Unknown command: ${cmd}`);
+}
+main().catch((e) => {
+    console.error(e);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAA2B,MAAM,0BAA0B,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,KAAK,UAAU,qBAAqB;IAClC,MAAM,YAAY,GAAG,oBAAoB,CAAC;IAC1C,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AACpD,CAAC;AAED,KAAK,UAAU,QAAQ;IACrB,MAAM,qBAAqB,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC;QACpC,WAAW,EAAE,MAAM,0BAA0B,EAAE;KAChD,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,KAAK,CAAC,kDAAkD,GAAG,CAAC,IAAI,YAAY,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC;IAEvG,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC,CAAC;IACF,KAAK,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;QAChD,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE;YAClB,KAAK,QAAQ,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,KAAK,UAAU,0BAA0B;IACvC,IAAI,OAAO,CAAC,GAAG,CAAC,2BAA2B,KAAK,MAAM,EAAE,CAAC;QACvD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;IAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,kFAAkF,CAAC,CAAC;QAClG,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,wBAAwB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IACtC,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACpB,MAAM,QAAQ,EAAE,CAAC;QACjB,OAAO;IACT,CAAC;IACD,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;CAWf,CAAC,CAAC;QACC,OAAO;IACT,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/collections.d.ts

@@ -0,0 +1,19 @@
+import { createExecutionMatrixRuntime } from '@exellix/exellix-runtime';
+export type MatrixPersistenceCollection = Parameters<typeof createExecutionMatrixRuntime>[0];
+export type MatrixPersistenceHandles = {
+    rows: MatrixPersistenceCollection;
+    failures: MatrixPersistenceCollection;
+    snapshots?: MatrixPersistenceCollection;
+    matrices: MatrixPersistenceCollection;
+    graphs: MatrixPersistenceCollection;
+    init?: () => Promise<void>;
+    close: () => Promise<void>;
+};
+export type OpenMatrixPersistenceOptions = {
+    mongoUri?: string;
+    executionDb?: string;
+    configDb?: string;
+    fallbackToRuntimeFactories?: boolean;
+    [key: string]: unknown;
+};
+//# sourceMappingURL=collections.d.ts.map

package/dist/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAExE,MAAM,MAAM,2BAA2B,GAAG,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7F,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,2BAA2B,CAAC;IAClC,QAAQ,EAAE,2BAA2B,CAAC;IACtC,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC,QAAQ,EAAE,2BAA2B,CAAC;IACtC,MAAM,EAAE,2BAA2B,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC"}

package/dist/collections.js

@@ -0,0 +1,2 @@
+import { createExecutionMatrixRuntime } from '@exellix/exellix-runtime';
+//# sourceMappingURL=collections.js.map

package/dist/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,8 @@
+export type MatrixReadEnv = {
+    port: number;
+    httpPrefix: string;
+    executionDb: string;
+    configDb: string;
+};
+export declare function loadMatrixReadEnv(env?: NodeJS.ProcessEnv): MatrixReadEnv;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAUF,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,aAAa,CAOrF"}

package/dist/env.js

@@ -0,0 +1,16 @@
+function parseIntEnv(value, fallback) {
+    if (value === undefined || value === '') {
+        return fallback;
+    }
+    const n = Number.parseInt(value, 10);
+    return Number.isFinite(n) ? n : fallback;
+}
+export function loadMatrixReadEnv(env = process.env) {
+    return {
+        port: parseIntEnv(env.PORT, 8090),
+        httpPrefix: (env.MATRIX_READ_HTTP_PREFIX ?? env.JOBS_HTTP_PREFIX ?? '/v1').replace(/\/$/, '') || '/v1',
+        executionDb: env.execution_db?.trim() || 'exellix-runtime',
+        configDb: env.config_db?.trim() || 'exellix',
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAOA,SAAS,WAAW,CAAC,KAAyB,EAAE,QAAgB;IAC9D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACxC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACpE,OAAO;QACL,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC;QACjC,UAAU,EAAE,CAAC,GAAG,CAAC,uBAAuB,IAAI,GAAG,CAAC,gBAAgB,IAAI,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK;QACtG,WAAW,EAAE,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,iBAAiB;QAC1D,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,SAAS;KAC7C,CAAC;AACJ,CAAC"}

package/dist/http/server.d.ts

@@ -0,0 +1,10 @@
+import { type FastifyInstance } from 'fastify';
+import type { MatrixReadEnv } from '../env.js';
+import type { MatrixReadTier } from '../tier.js';
+export type StartMatrixReadHttpOptions = {
+    tier: MatrixReadTier;
+    env?: MatrixReadEnv;
+    host?: string;
+};
+export declare function startMatrixReadHttp(opts: StartMatrixReadHttpOptions): Promise<FastifyInstance>;
+//# sourceMappingURL=server.d.ts.map

package/dist/http/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/http/server.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,KAAK,eAAe,EAAuB,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAmBjD,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,cAAc,CAAC;IACrB,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,eAAe,CAAC,CA0FpG"}

package/dist/http/server.js

@@ -0,0 +1,90 @@
+import Fastify, {} from 'fastify';
+import { loadMatrixReadEnv } from '../env.js';
+function readQueryParam(req, key) {
+    if (typeof req.query !== 'object' || !req.query || !(key in req.query)) {
+        return undefined;
+    }
+    const value = req.query[key];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function readQueryInt(req, key) {
+    const raw = readQueryParam(req, key);
+    if (raw === undefined) {
+        return undefined;
+    }
+    const n = Number.parseInt(raw, 10);
+    return Number.isFinite(n) ? n : undefined;
+}
+export async function startMatrixReadHttp(opts) {
+    const env = opts.env ?? loadMatrixReadEnv();
+    const fastify = Fastify({ logger: true });
+    await fastify.register(async (app) => {
+        app.get('/health', async () => ({ ok: true, service: '@exellix/exellix-matrix-read', timestamp: new Date().toISOString() }));
+        app.get('/matrices/:catalogId/graphs/:graphId/dashboard', async (req) => {
+            const matrixRunId = readQueryParam(req, 'matrixRunId');
+            const inputGroupByPath = readQueryParam(req, 'inputGroupByPath');
+            const aggregateRowScanCap = readQueryInt(req, 'aggregateRowScanCap');
+            return opts.tier.graphDashboard({
+                matrixCatalogId: req.params.catalogId,
+                graphId: req.params.graphId,
+                ...(matrixRunId !== undefined ? { matrixRunId } : {}),
+                ...(inputGroupByPath !== undefined ? { inputGroupByPath } : {}),
+                ...(aggregateRowScanCap !== undefined ? { aggregateRowScanCap } : {}),
+            });
+        });
+        app.get('/matrices/:catalogId/graphs/:graphId/navigator', async (req) => {
+            const matrixRunId = readQueryParam(req, 'matrixRunId');
+            const limit = readQueryInt(req, 'limit');
+            const skip = readQueryInt(req, 'skip');
+            const includeFailureCount = readQueryParam(req, 'includeFailureCount') === 'true';
+            return opts.tier.navigatorPage({
+                matrixCatalogId: req.params.catalogId,
+                graphId: req.params.graphId,
+                ...(matrixRunId !== undefined ? { matrixRunId } : {}),
+                ...(limit !== undefined ? { limit } : {}),
+                ...(skip !== undefined ? { skip } : {}),
+                includeFailureCount,
+            });
+        });
+        app.get('/matrices/:catalogId/graphs/:graphId/join-view', async (req) => {
+            const matrixRunId = readQueryParam(req, 'matrixRunId');
+            const limit = readQueryInt(req, 'limit');
+            return opts.tier.sourceJoinView({
+                matrixCatalogId: req.params.catalogId,
+                graphId: req.params.graphId,
+                ...(matrixRunId !== undefined ? { matrixRunId } : {}),
+                ...(limit !== undefined ? { limit } : {}),
+            });
+        });
+        app.get('/matrices/:catalogId/overview', async (req) => {
+            const matrixRunId = readQueryParam(req, 'matrixRunId');
+            const limit = readQueryInt(req, 'limit');
+            const skip = readQueryInt(req, 'skip');
+            return opts.tier.multiGraphOverview({
+                matrixCatalogId: req.params.catalogId,
+                ...(matrixRunId !== undefined ? { matrixRunId } : {}),
+                ...(limit !== undefined ? { limit } : {}),
+                ...(skip !== undefined ? { skip } : {}),
+            });
+        });
+        app.get('/entities/:entityType/facet', async (req) => {
+            const namespace = readQueryParam(req, 'namespace');
+            if (!namespace) {
+                throw new Error('Query parameter namespace is required');
+            }
+            const matrixCatalogId = readQueryParam(req, 'matrixCatalogId');
+            const matrixRunId = readQueryParam(req, 'matrixRunId');
+            const graphId = readQueryParam(req, 'graphId');
+            return opts.tier.entityFacet({
+                entityType: req.params.entityType,
+                namespace,
+                ...(matrixCatalogId !== undefined ? { matrixCatalogId } : {}),
+                ...(matrixRunId !== undefined ? { matrixRunId } : {}),
+                ...(graphId !== undefined ? { graphId } : {}),
+            });
+        });
+    }, { prefix: env.httpPrefix });
+    await fastify.listen({ port: env.port, host: opts.host ?? '0.0.0.0' });
+    return fastify;
+}
+//# sourceMappingURL=server.js.map

package/dist/http/server.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type { MatrixPersistenceCollection, MatrixPersistenceHandles, OpenMatrixPersistenceOptions } from './collections.js';
+export { loadMatrixReadEnv, type MatrixReadEnv } from './env.js';
+export { resolveMatrixPersistenceOptionsFromEnv } from './persistence-env.js';
+export { createInMemoryMatrixPersistence, openMatrixPersistence, } from './open-persistence.js';
+export { openMatrixPersistenceFromRuntimeFactories } from './runtime-matrix-tier.js';
+export { openMatrixPersistenceFromXmemoryStore } from './xmemory-matrix-tier.js';
+export { createMatrixReadTier, openMatrixReadTier, type CreateMatrixReadTierOptions, type MatrixReadTier, type OpenMatrixReadTierOptions, } from './tier.js';
+export { startMatrixReadHttp, type StartMatrixReadHttpOptions } from './http/server.js';
+export type { ExecutionMatrixMultiGraphRowView, FetchExecutionMatrixMultiGraphOverviewQuery, FetchGraphOperationalDashboardSliceQuery, FetchMemorixMatrixEntityFacetQuery, FetchSourceJoinViewQuery, GraphOperationalDashboardSlice, MemorixMatrixEntityFacetResult, NavigatorPage, SourceJoinView, } from '@exellix/exellix-runtime';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAC5H,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,sCAAsC,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EACL,+BAA+B,EAC/B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yCAAyC,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,qCAAqC,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,2BAA2B,EAChC,KAAK,cAAc,EACnB,KAAK,yBAAyB,GAC/B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAGxF,YAAY,EACV,gCAAgC,EAChC,2CAA2C,EAC3C,wCAAwC,EACxC,kCAAkC,EAClC,wBAAwB,EACxB,8BAA8B,EAC9B,8BAA8B,EAC9B,aAAa,EACb,cAAc,GACf,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { loadMatrixReadEnv } from './env.js';
+export { resolveMatrixPersistenceOptionsFromEnv } from './persistence-env.js';
+export { createInMemoryMatrixPersistence, openMatrixPersistence, } from './open-persistence.js';
+export { openMatrixPersistenceFromRuntimeFactories } from './runtime-matrix-tier.js';
+export { openMatrixPersistenceFromXmemoryStore } from './xmemory-matrix-tier.js';
+export { createMatrixReadTier, openMatrixReadTier, } from './tier.js';
+export { startMatrixReadHttp } from './http/server.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAsB,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,sCAAsC,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EACL,+BAA+B,EAC/B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,yCAAyC,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,qCAAqC,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GAInB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,mBAAmB,EAAmC,MAAM,kBAAkB,CAAC"}

package/dist/open-persistence.d.ts

@@ -0,0 +1,4 @@
+import type { MatrixPersistenceHandles, OpenMatrixPersistenceOptions } from './collections.js';
+export declare function openMatrixPersistence(options?: OpenMatrixPersistenceOptions): Promise<MatrixPersistenceHandles>;
+export declare function createInMemoryMatrixPersistence(): Promise<MatrixPersistenceHandles>;
+//# sourceMappingURL=open-persistence.d.ts.map

package/dist/open-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-persistence.d.ts","sourceRoot":"","sources":["../src/open-persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAa/F,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,wBAAwB,CAAC,CAenC;AAED,wBAAsB,+BAA+B,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAezF"}

package/dist/open-persistence.js

@@ -0,0 +1,41 @@
+import { resolveMatrixPersistenceOptionsFromEnv } from './persistence-env.js';
+import { openMatrixPersistenceFromRuntimeFactories } from './runtime-matrix-tier.js';
+import { openMatrixPersistenceFromXmemoryStore } from './xmemory-matrix-tier.js';
+function isMatrixDataTierFactoryUnavailable(err) {
+    return (err instanceof Error &&
+        err.message.includes('createExellixMatrixDataTier') &&
+        (err.message.includes('not exported') || err.message.includes('not available')));
+}
+export async function openMatrixPersistence(options = {}) {
+    const resolved = resolveMatrixPersistenceOptionsFromEnv(options);
+    const fallback = resolved.fallbackToRuntimeFactories !== false;
+    try {
+        return await openMatrixPersistenceFromXmemoryStore(resolved);
+    }
+    catch (err) {
+        if (!fallback) {
+            throw err;
+        }
+        if (!isMatrixDataTierFactoryUnavailable(err)) {
+            throw err;
+        }
+        return openMatrixPersistenceFromRuntimeFactories(resolved);
+    }
+}
+export async function createInMemoryMatrixPersistence() {
+    const { MemoryMatrixCollection } = await import('@exellix/exellix-runtime');
+    const rows = new MemoryMatrixCollection('rowId').asCollection();
+    const failures = new MemoryMatrixCollection('failureId').asCollection();
+    const snapshots = new MemoryMatrixCollection('snapshotId').asCollection();
+    const matrices = new MemoryMatrixCollection('matrixCatalogId').asCollection();
+    const graphs = new MemoryMatrixCollection('graphId').asCollection();
+    return {
+        rows,
+        failures,
+        snapshots,
+        matrices,
+        graphs,
+        close: async () => undefined,
+    };
+}
+//# sourceMappingURL=open-persistence.js.map

package/dist/open-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-persistence.js","sourceRoot":"","sources":["../src/open-persistence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sCAAsC,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,yCAAyC,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,qCAAqC,EAAE,MAAM,0BAA0B,CAAC;AAEjF,SAAS,kCAAkC,CAAC,GAAY;IACtD,OAAO,CACL,GAAG,YAAY,KAAK;QACpB,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QACnD,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAChF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,UAAwC,EAAE;IAE1C,MAAM,QAAQ,GAAG,sCAAsC,CAAC,OAAO,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,QAAQ,CAAC,0BAA0B,KAAK,KAAK,CAAC;IAE/D,IAAI,CAAC;QACH,OAAO,MAAM,qCAAqC,CAAC,QAAQ,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,IAAI,CAAC,kCAAkC,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7C,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,yCAAyC,CAAC,QAAQ,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B;IACnD,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,IAAI,sBAAsB,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,CAAC;IAChE,MAAM,QAAQ,GAAG,IAAI,sBAAsB,CAAC,WAAW,CAAC,CAAC,YAAY,EAAE,CAAC;IACxE,MAAM,SAAS,GAAG,IAAI,sBAAsB,CAAC,YAAY,CAAC,CAAC,YAAY,EAAE,CAAC;IAC1E,MAAM,QAAQ,GAAG,IAAI,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,YAAY,EAAE,CAAC;IAC9E,MAAM,MAAM,GAAG,IAAI,sBAAsB,CAAC,SAAS,CAAC,CAAC,YAAY,EAAE,CAAC;IACpE,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,SAAS;QACT,QAAQ;QACR,MAAM;QACN,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;KAC7B,CAAC;AACJ,CAAC"}

package/dist/persistence-env.d.ts

@@ -0,0 +1,4 @@
+import type { OpenMatrixPersistenceOptions } from './collections.js';
+import { type MatrixReadEnv } from './env.js';
+export declare function resolveMatrixPersistenceOptionsFromEnv(overrides?: OpenMatrixPersistenceOptions, env?: MatrixReadEnv): OpenMatrixPersistenceOptions;
+//# sourceMappingURL=persistence-env.d.ts.map

package/dist/persistence-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence-env.d.ts","sourceRoot":"","sources":["../src/persistence-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAEjE,wBAAgB,sCAAsC,CACpD,SAAS,GAAE,4BAAiC,EAC5C,GAAG,GAAE,aAAmC,GACvC,4BAA4B,CAQ9B"}

package/dist/persistence-env.js

@@ -0,0 +1,11 @@
+import { loadMatrixReadEnv } from './env.js';
+export function resolveMatrixPersistenceOptionsFromEnv(overrides = {}, env = loadMatrixReadEnv()) {
+    const mongoUri = overrides.mongoUri ?? (process.env.MONGO_URI?.trim() || undefined);
+    return {
+        ...overrides,
+        ...(mongoUri !== undefined ? { mongoUri } : {}),
+        executionDb: overrides.executionDb ?? env.executionDb,
+        configDb: overrides.configDb ?? env.configDb,
+    };
+}
+//# sourceMappingURL=persistence-env.js.map

package/dist/persistence-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence-env.js","sourceRoot":"","sources":["../src/persistence-env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAsB,MAAM,UAAU,CAAC;AAEjE,MAAM,UAAU,sCAAsC,CACpD,YAA0C,EAAE,EAC5C,MAAqB,iBAAiB,EAAE;IAExC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC,CAAC;IACpF,OAAO;QACL,GAAG,SAAS;QACZ,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW;QACrD,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ;KAC7C,CAAC;AACJ,CAAC"}

package/dist/runtime-matrix-tier.d.ts

@@ -0,0 +1,3 @@
+import type { MatrixPersistenceHandles, OpenMatrixPersistenceOptions } from './collections.js';
+export declare function openMatrixPersistenceFromRuntimeFactories(options?: OpenMatrixPersistenceOptions): Promise<MatrixPersistenceHandles>;
+//# sourceMappingURL=runtime-matrix-tier.d.ts.map

package/dist/runtime-matrix-tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-matrix-tier.d.ts","sourceRoot":"","sources":["../src/runtime-matrix-tier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAK/F,wBAAsB,yCAAyC,CAC7D,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,wBAAwB,CAAC,CAiDnC"}

package/dist/runtime-matrix-tier.js

@@ -0,0 +1,39 @@
+import { resolveMatrixPersistenceOptionsFromEnv } from './persistence-env.js';
+export async function openMatrixPersistenceFromRuntimeFactories(options = {}) {
+    const resolved = resolveMatrixPersistenceOptionsFromEnv(options);
+    const mongoUri = resolved.mongoUri ?? process.env.MONGO_URI?.trim();
+    if (!mongoUri) {
+        throw new Error('@exellix/exellix-matrix-read: MONGO_URI is required to open matrix persistence.');
+    }
+    const runtime = (await import('@exellix/exellix-runtime'));
+    const xronox = (await import('@exellix/exellix-runtime/internal/xronox-matrix'));
+    const { createExecutionMatrixRuntimeFromXronox, createExellixConfigStoreFromXronox } = xronox;
+    const { executionMatrixRowsCollectionDef, executionMatrixFailuresCollectionDef, executionMatrixSnapshotsCollectionDef, exellixMatrixConfigsCollectionDef, exellixGraphConfigsCollectionDef, } = runtime;
+    const exec = await createExecutionMatrixRuntimeFromXronox({
+        mongoUri,
+        mongoDb: resolved.executionDb,
+        serializeClaims: true,
+    });
+    const cfg = await createExellixConfigStoreFromXronox({
+        mongoUri,
+        mongoDb: resolved.configDb,
+    });
+    const rows = exec.store.collection(executionMatrixRowsCollectionDef().name);
+    const failures = exec.store.collection(executionMatrixFailuresCollectionDef().name);
+    const snapshots = exec.store.collection(executionMatrixSnapshotsCollectionDef().name);
+    const matrices = cfg.store.collection(exellixMatrixConfigsCollectionDef().name);
+    const graphs = cfg.store.collection(exellixGraphConfigsCollectionDef().name);
+    let closed = false;
+    const close = async () => {
+        if (closed) {
+            return;
+        }
+        closed = true;
+        await exec.store.close().catch(() => undefined);
+        await cfg.store.close().catch(() => undefined);
+        await exec.closeMongoDriverPassThrough?.().catch(() => undefined);
+        await cfg.closeMongoDriverPassThrough?.().catch(() => undefined);
+    };
+    return { rows, failures, snapshots, matrices, graphs, close };
+}
+//# sourceMappingURL=runtime-matrix-tier.js.map

package/dist/runtime-matrix-tier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-matrix-tier.js","sourceRoot":"","sources":["../src/runtime-matrix-tier.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sCAAsC,EAAE,MAAM,sBAAsB,CAAC;AAI9E,MAAM,CAAC,KAAK,UAAU,yCAAyC,CAC7D,UAAwC,EAAE;IAE1C,MAAM,QAAQ,GAAG,sCAAsC,CAAC,OAAO,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;IACpE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;IACrG,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAA8C,CAAC;IACxG,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAC1B,iDAAiD,CAClD,CAA+B,CAAC;IACjC,MAAM,EAAE,sCAAsC,EAAE,kCAAkC,EAAE,GAAG,MAAM,CAAC;IAC9F,MAAM,EACJ,gCAAgC,EAChC,oCAAoC,EACpC,qCAAqC,EACrC,iCAAiC,EACjC,gCAAgC,GACjC,GAAG,OAAO,CAAC;IAEZ,MAAM,IAAI,GAAG,MAAM,sCAAsC,CAAC;QACxD,QAAQ;QACR,OAAO,EAAE,QAAQ,CAAC,WAAW;QAC7B,eAAe,EAAE,IAAI;KACtB,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,MAAM,kCAAkC,CAAC;QACnD,QAAQ;QACR,OAAO,EAAE,QAAQ,CAAC,QAAQ;KAC3B,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,gCAAgC,EAAE,CAAC,IAAI,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,oCAAoC,EAAE,CAAC,IAAI,CAAC,CAAC;IACpF,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,qCAAqC,EAAE,CAAC,IAAI,CAAC,CAAC;IACtF,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,iCAAiC,EAAE,CAAC,IAAI,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,gCAAgC,EAAE,CAAC,IAAI,CAAC,CAAC;IAE7E,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;QACtC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QACD,MAAM,GAAG,IAAI,CAAC;QACd,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,IAAI,CAAC,2BAA2B,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAClE,MAAM,GAAG,CAAC,2BAA2B,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAChE,CAAC"}

package/dist/tier.d.ts

@@ -0,0 +1,44 @@
+import { type ExecutionMatrixMultiGraphRowView, type ExecutionMatrixRuntime, type ExellixConfigStore, type FetchExecutionMatrixMultiGraphOverviewQuery, type FetchGraphOperationalDashboardSliceQuery, type FetchMemorixMatrixEntityFacetQuery, type FetchSourceJoinViewQuery, type GraphOperationalDashboardSlice, type ListMatrixRowsOptions, type MatrixSourceResolver, type MemorixMatrixEntityFacetResult, type NavigatorPage, type SourceJoinView, type MemorixRuntimeTier } from '@exellix/exellix-runtime';
+import type { MatrixPersistenceHandles, OpenMatrixPersistenceOptions } from './collections.js';
+export type CreateMatrixReadTierOptions = {
+    persistence: MatrixPersistenceHandles;
+    /** Optional Memorix tier for {@link MatrixReadTier.entityFacet}. */
+    memorixTier?: MemorixRuntimeTier;
+};
+export type OpenMatrixReadTierOptions = OpenMatrixPersistenceOptions & {
+    memorixTier?: MemorixRuntimeTier;
+};
+export type MatrixReadTier = {
+    readonly runtime: ExecutionMatrixRuntime;
+    readonly configStore: ExellixConfigStore;
+    readonly memorixTier?: MemorixRuntimeTier;
+    /**
+     * Per-graph operational dashboard: row counts by slot status, optional grouping on row `input`
+     * (e.g. entity kind). Answers “how many jobs in which state for this graph”.
+     */
+    graphDashboard: (query: FetchGraphOperationalDashboardSliceQuery) => Promise<GraphOperationalDashboardSlice>;
+    /** Paginated matrix rows with optional per-graph status histogram. */
+    navigatorPage: (query: ListMatrixRowsOptions & {
+        graphId?: string;
+        includeFailureCount?: boolean;
+    }) => Promise<NavigatorPage>;
+    /**
+     * Waiting / in-progress / processed / failed / skipped for one graph within a matrix scope.
+     */
+    sourceJoinView: (query: FetchSourceJoinViewQuery, opts?: {
+        sourceResolver?: MatrixSourceResolver;
+    }) => Promise<SourceJoinView>;
+    /**
+     * Per materialized row: all graph slots with status, jobId, timestamps, and inference output.
+     */
+    multiGraphOverview: (query: FetchExecutionMatrixMultiGraphOverviewQuery) => Promise<ExecutionMatrixMultiGraphRowView[]>;
+    /**
+     * Entity-type facet: Memorix tier statistics plus matching matrix rows / snapshots.
+     * Requires {@link memorixTier} on the tier instance.
+     */
+    entityFacet: (query: FetchMemorixMatrixEntityFacetQuery) => Promise<MemorixMatrixEntityFacetResult>;
+    close: () => Promise<void>;
+};
+export declare function createMatrixReadTier(options: CreateMatrixReadTierOptions): Promise<MatrixReadTier>;
+export declare function openMatrixReadTier(options?: OpenMatrixReadTierOptions): Promise<MatrixReadTier>;
+//# sourceMappingURL=tier.d.ts.map

package/dist/tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier.d.ts","sourceRoot":"","sources":["../src/tier.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,gCAAgC,EACrC,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,2CAA2C,EAChD,KAAK,wCAAwC,EAC7C,KAAK,kCAAkC,EACvC,KAAK,wBAAwB,EAC7B,KAAK,8BAA8B,EACnC,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,8BAA8B,EACnC,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAG/F,MAAM,MAAM,2BAA2B,GAAG;IACxC,WAAW,EAAE,wBAAwB,CAAC;IACtC,oEAAoE;IACpE,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,4BAA4B,GAAG;IACrE,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C;;;OAGG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,wCAAwC,KAAK,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC7G,sEAAsE;IACtE,aAAa,EAAE,CACb,KAAK,EAAE,qBAAqB,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAAE,KAC/E,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5B;;OAEG;IACH,cAAc,EAAE,CACd,KAAK,EAAE,wBAAwB,EAC/B,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,oBAAoB,CAAA;KAAE,KAC7C,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B;;OAEG;IACH,kBAAkB,EAAE,CAClB,KAAK,EAAE,2CAA2C,KAC/C,OAAO,CAAC,gCAAgC,EAAE,CAAC,CAAC;IACjD;;;OAGG;IACH,WAAW,EAAE,CAAC,KAAK,EAAE,kCAAkC,KAAK,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACpG,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,cAAc,CAAC,CAuCxG;AAED,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,cAAc,CAAC,CAIzG"}

package/dist/tier.js

@@ -0,0 +1,40 @@
+import { createExecutionMatrixRuntime, createExellixConfigStore, fetchExecutionMatrixMultiGraphOverview, fetchExecutionMatrixNavigatorPage, fetchGraphOperationalDashboardSlice, fetchMemorixMatrixEntityFacet, fetchSourceJoinView, } from '@exellix/exellix-runtime';
+import { openMatrixPersistence } from './open-persistence.js';
+export async function createMatrixReadTier(options) {
+    await options.persistence.init?.();
+    const runtime = createExecutionMatrixRuntime(options.persistence.rows, options.persistence.failures, {
+        snapshots: options.persistence.snapshots,
+        serializeClaims: true,
+    });
+    const configStore = createExellixConfigStore({
+        matrices: options.persistence.matrices,
+        graphs: options.persistence.graphs,
+    });
+    const memorixTier = options.memorixTier;
+    return {
+        runtime,
+        configStore,
+        memorixTier,
+        graphDashboard: (query) => fetchGraphOperationalDashboardSlice({
+            runtime,
+            loadGraphConfig: (graphId) => configStore.graphs.get(graphId),
+        }, query),
+        navigatorPage: (query) => fetchExecutionMatrixNavigatorPage(runtime, query),
+        sourceJoinView: (query, opts) => fetchSourceJoinView({ runtime, sourceResolver: opts?.sourceResolver }, query),
+        multiGraphOverview: (query) => fetchExecutionMatrixMultiGraphOverview(runtime, query),
+        entityFacet: (query) => {
+            if (!memorixTier) {
+                throw new Error('@exellix/exellix-matrix-read: entityFacet requires memorixTier — pass memorixTier when opening the read tier ' +
+                    '(e.g. createMemorixRuntimeTier() from @exellix/exellix-runtime).');
+            }
+            return fetchMemorixMatrixEntityFacet({ tier: memorixTier, runtime }, query);
+        },
+        close: () => options.persistence.close(),
+    };
+}
+export async function openMatrixReadTier(options = {}) {
+    const { memorixTier, ...persistenceOptions } = options;
+    const persistence = await openMatrixPersistence(persistenceOptions);
+    return createMatrixReadTier({ persistence, memorixTier });
+}
+//# sourceMappingURL=tier.js.map

package/dist/tier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier.js","sourceRoot":"","sources":["../src/tier.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,sCAAsC,EACtC,iCAAiC,EACjC,mCAAmC,EACnC,6BAA6B,EAC7B,mBAAmB,GAepB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AA8C9D,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAoC;IAC7E,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,4BAA4B,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE;QACnG,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,SAAS;QACxC,eAAe,EAAE,IAAI;KACtB,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,wBAAwB,CAAC;QAC3C,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ;QACtC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,MAAM;KACnC,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAExC,OAAO;QACL,OAAO;QACP,WAAW;QACX,WAAW;QACX,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE,CACxB,mCAAmC,CACjC;YACE,OAAO;YACP,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;SAC9D,EACD,KAAK,CACN;QACH,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,iCAAiC,CAAC,OAAO,EAAE,KAAK,CAAC;QAC3E,cAAc,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAC9B,mBAAmB,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,KAAK,CAAC;QAC/E,kBAAkB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,sCAAsC,CAAC,OAAO,EAAE,KAAK,CAAC;QACrF,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE;YACrB,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,+GAA+G;oBAC7G,kEAAkE,CACrE,CAAC;YACJ,CAAC;YACD,OAAO,6BAA6B,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;QAC9E,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAAqC,EAAE;IAC9E,MAAM,EAAE,WAAW,EAAE,GAAG,kBAAkB,EAAE,GAAG,OAAO,CAAC;IACvD,MAAM,WAAW,GAAG,MAAM,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;IACpE,OAAO,oBAAoB,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/xmemory-matrix-tier.d.ts

@@ -0,0 +1,6 @@
+import type { MatrixPersistenceHandles, OpenMatrixPersistenceOptions } from './collections.js';
+/**
+ * Resolves {@link createExellixMatrixDataTier} from `@exellix/exellix-matrix-persister` or `@x12i/xmemory-store`.
+ */
+export declare function openMatrixPersistenceFromXmemoryStore(options: OpenMatrixPersistenceOptions): Promise<MatrixPersistenceHandles>;
+//# sourceMappingURL=xmemory-matrix-tier.d.ts.map

package/dist/xmemory-matrix-tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmemory-matrix-tier.d.ts","sourceRoot":"","sources":["../src/xmemory-matrix-tier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AA4B/F;;GAEG;AACH,wBAAsB,qCAAqC,CACzD,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,wBAAwB,CAAC,CAqBnC"}

package/dist/xmemory-matrix-tier.js

@@ -0,0 +1,45 @@
+const FACTORY = 'createExellixMatrixDataTier';
+const FACTORY_PACKAGES = ['@exellix/exellix-matrix-persister', '@x12i/xmemory-store'];
+async function loadMatrixDataTierFactory() {
+    const errors = [];
+    for (const pkg of FACTORY_PACKAGES) {
+        try {
+            const mod = (await import(pkg));
+            const factory = mod[FACTORY];
+            if (typeof factory === 'function') {
+                return factory;
+            }
+            errors.push(`${pkg}: "${FACTORY}" is not exported`);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            errors.push(`${pkg}: ${message}`);
+        }
+    }
+    throw new Error(`@exellix/exellix-matrix-read: "${FACTORY}" is not exported from @exellix/exellix-matrix-persister or @x12i/xmemory-store. ` +
+        `Tried:\n${errors.map((e) => `  - ${e}`).join('\n')}`);
+}
+/**
+ * Resolves {@link createExellixMatrixDataTier} from `@exellix/exellix-matrix-persister` or `@x12i/xmemory-store`.
+ */
+export async function openMatrixPersistenceFromXmemoryStore(options) {
+    const factory = await loadMatrixDataTierFactory();
+    const tier = await factory(options);
+    const t = tier;
+    const { rows, failures, matrices, graphs, close } = t;
+    if (!rows || !failures || !matrices || !graphs || typeof close !== 'function') {
+        throw new Error(`@exellix/exellix-matrix-read: "${FACTORY}" returned an object missing rows, failures, matrices, graphs, or close().`);
+    }
+    if (t.init) {
+        await t.init();
+    }
+    return {
+        rows,
+        failures,
+        snapshots: t.snapshots,
+        matrices,
+        graphs,
+        close: () => Promise.resolve(close.call(tier)),
+    };
+}
+//# sourceMappingURL=xmemory-matrix-tier.js.map

package/dist/xmemory-matrix-tier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmemory-matrix-tier.js","sourceRoot":"","sources":["../src/xmemory-matrix-tier.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAG,6BAA6B,CAAC;AAC9C,MAAM,gBAAgB,GAAG,CAAC,mCAAmC,EAAE,qBAAqB,CAAU,CAAC;AAE/F,KAAK,UAAU,yBAAyB;IAGtC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,CAA4B,CAAC;YAC3D,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;YAC7B,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,OAAO,OAAsE,CAAC;YAChF,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,OAAO,mBAAmB,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,OAAO,EAAE,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CACb,kCAAkC,OAAO,mFAAmF;QAC1H,WAAW,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qCAAqC,CACzD,OAAqC;IAErC,MAAM,OAAO,GAAG,MAAM,yBAAyB,EAAE,CAAC;IAClD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,CAAC,GAAG,IAA0E,CAAC;IACrF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IACtD,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CACb,kCAAkC,OAAO,4EAA4E,CACtH,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QACX,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;IACD,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,QAAQ;QACR,MAAM;QACN,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAC/C,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@exellix/exellix-matrix-read",
+  "version": "1.0.1",
+  "description": "Read-only execution-matrix data tier: entity+graph job history, status counts, and dashboard queries over @exellix/exellix-runtime.",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js"
+    }
+  },
+  "bin": {
+    "exellix-matrix-read": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "docs"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "node -e \"import('node:fs').then(fs=>fs.promises.rm('dist',{recursive:true,force:true}))\"",
+    "prepack": "npm run build",
+    "read:serve": "node dist/cli.js serve",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "@exellix/exellix-matrix-persister": "^1.0.1",
+    "@exellix/exellix-runtime": "^5.1.8",
+    "@x12i/xmemory-store": "^2.9.0"
+  },
+  "peerDependenciesMeta": {
+    "@exellix/exellix-matrix-persister": {
+      "optional": true
+    },
+    "@x12i/xmemory-store": {
+      "optional": true
+    },
+    "@x12i/env": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "fastify": "^5.8.5"
+  },
+  "devDependencies": {
+    "@exellix/exellix-runtime": "^5.1.8",
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2",
+    "vitest": "^3.0.0"
+  },
+  "keywords": [
+    "exellix",
+    "execution-matrix",
+    "read-tier",
+    "dashboard"
+  ],
+  "license": "exellix-license"
+}