@exellix/exellix-runtime 3.5.1

package/dist/execution-matrix/xronox-matrix-factory.js

@@ -0,0 +1,77 @@
+/**
+ * **Internal** — Mongo + `@x12i/xronox-store` wiring for execution-matrix operational DB and config DB.
+ *
+ * Hosts should use **`createExellixMatrixDataTier`** from the package root, not this module.
+ * This file remains for advanced callers and the **`./internal/xronox-matrix`** export subpath.
+ *
+ * @packageDocumentation
+ */
+import { XronoxStore } from '@x12i/xronox-store';
+import { exellixConfigStoreCollectionDefs, exellixGraphConfigsCollectionDef, exellixMatrixConfigsCollectionDef, executionMatrixFailuresCollectionDef, executionMatrixRowsCollectionDef, executionMatrixSnapshotsCollectionDef, executionMatrixStoreCollectionDefs, } from './collections.js';
+import { createExecutionMatrixRuntime } from './runtime-store.js';
+import { createExellixConfigStore } from './config-store.js';
+import { createXronoxMongoDriverPassThrough } from './xronox-store-native-driver-hooks.js';
+export async function createExecutionMatrixRuntimeFromXronox(options) {
+    const mongoUri = options.mongoUri ?? process.env.MONGO_URI;
+    const mongoDb = options.mongoDb ?? process.env.execution_db ?? 'exellix-runtime';
+    const mongoRole = options.mongoRole ?? process.env.MONGO_ROLE ?? 'execution';
+    if (!mongoUri || !String(mongoUri).trim()) {
+        throw new Error('createExecutionMatrixRuntimeFromXronox: mongoUri missing — set MONGO_URI (ERC / env) or pass options.mongoUri');
+    }
+    const passThrough = options.mongoDriverPassThrough !== false;
+    const hooks = passThrough ? createXronoxMongoDriverPassThrough(String(mongoUri).trim(), String(mongoDb)) : undefined;
+    const store = new XronoxStore({
+        mongoUri,
+        mongoDb,
+        mongoRole,
+        collections: executionMatrixStoreCollectionDefs(),
+        ...(hooks
+            ? { mongoDriverCount: hooks.mongoDriverCount, mongoDriverReadMany: hooks.mongoDriverReadMany }
+            : {}),
+    });
+    await store.init();
+    const rows = store.collection(executionMatrixRowsCollectionDef().name);
+    const failures = store.collection(executionMatrixFailuresCollectionDef().name);
+    const snapshots = store.collection(executionMatrixSnapshotsCollectionDef().name);
+    const runtime = createExecutionMatrixRuntime(rows, failures, {
+        ...(options.serializeClaims !== undefined ? { serializeClaims: options.serializeClaims } : {}),
+        snapshots,
+    });
+    return {
+        store,
+        runtime,
+        ...(hooks ? { closeMongoDriverPassThrough: hooks.close } : {}),
+    };
+}
+export async function createExellixConfigStoreFromXronox(options) {
+    const mongoUri = options.mongoUri ?? process.env.MONGO_URI;
+    const mongoDb = options.mongoDb ?? process.env.config_db ?? 'exellix';
+    const mongoRole = options.mongoRole ?? process.env.CONFIG_MONGO_ROLE ?? process.env.MONGO_ROLE ?? 'config';
+    if (!mongoUri || !String(mongoUri).trim()) {
+        throw new Error('createExellixConfigStoreFromXronox: mongoUri missing — set MONGO_URI (ERC / env) or pass options.mongoUri');
+    }
+    const passThrough = options.mongoDriverPassThrough !== false;
+    const hooks = passThrough ? createXronoxMongoDriverPassThrough(String(mongoUri).trim(), String(mongoDb)) : undefined;
+    const store = new XronoxStore({
+        mongoUri,
+        mongoDb,
+        mongoRole,
+        collections: exellixConfigStoreCollectionDefs(),
+        ...(hooks
+            ? { mongoDriverCount: hooks.mongoDriverCount, mongoDriverReadMany: hooks.mongoDriverReadMany }
+            : {}),
+    });
+    await store.init();
+    const matrices = store.collection(exellixMatrixConfigsCollectionDef().name);
+    const graphs = store.collection(exellixGraphConfigsCollectionDef().name);
+    const configStore = createExellixConfigStore({
+        matrices,
+        graphs,
+    });
+    return {
+        store,
+        configStore,
+        ...(hooks ? { closeMongoDriverPassThrough: hooks.close } : {}),
+    };
+}
+//# sourceMappingURL=xronox-matrix-factory.js.map

package/dist/execution-matrix/xronox-matrix-factory.js.map

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

package/dist/execution-matrix/xronox-store-native-driver-hooks.d.ts

@@ -0,0 +1,15 @@
+import type { XronoxStoreOptions } from '@x12i/xronox-store';
+export type XronoxNativeDriverHooks = {
+    mongoDriverReadMany: NonNullable<XronoxStoreOptions['mongoDriverReadMany']>;
+    mongoDriverCount: NonNullable<XronoxStoreOptions['mongoDriverCount']>;
+    /**
+     * Idempotent close for the auxiliary client used only for these hooks (independent of {@link XronoxStore.close}).
+     */
+    close: () => Promise<void>;
+};
+/**
+ * Builds **`mongoDriverReadMany`** / **`mongoDriverCount`** for {@link XronoxStore} using the official
+ * **`mongodb`** driver against **`mongoUri`** / **`mongoDb`** (a second pool alongside `@x12i/xronox`).
+ */
+export declare function createXronoxMongoDriverPassThrough(mongoUri: string, mongoDb: string): XronoxNativeDriverHooks;
+//# sourceMappingURL=xronox-store-native-driver-hooks.d.ts.map

package/dist/execution-matrix/xronox-store-native-driver-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xronox-store-native-driver-hooks.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/xronox-store-native-driver-hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,MAAM,uBAAuB,GAAG;IACpC,mBAAmB,EAAE,WAAW,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC5E,gBAAgB,EAAE,WAAW,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACtE;;OAEG;IACH,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,uBAAuB,CAuC7G"}

package/dist/execution-matrix/xronox-store-native-driver-hooks.js

@@ -0,0 +1,41 @@
+import { MongoClient } from 'mongodb';
+/**
+ * Builds **`mongoDriverReadMany`** / **`mongoDriverCount`** for {@link XronoxStore} using the official
+ * **`mongodb`** driver against **`mongoUri`** / **`mongoDb`** (a second pool alongside `@x12i/xronox`).
+ */
+export function createXronoxMongoDriverPassThrough(mongoUri, mongoDb) {
+    const client = new MongoClient(mongoUri);
+    let connectPromise;
+    async function ensureClient() {
+        if (!connectPromise)
+            connectPromise = client.connect().then(() => undefined);
+        await connectPromise;
+    }
+    const mongoDriverReadMany = async ({ collectionName, filter, limit, sort, }) => {
+        await ensureClient();
+        const coll = client.db(mongoDb).collection(collectionName);
+        let cursor = coll.find(filter);
+        if (sort && Object.keys(sort).length > 0)
+            cursor = cursor.sort(sort);
+        if (limit != null && limit > 0)
+            cursor = cursor.limit(limit);
+        return (await cursor.toArray());
+    };
+    const mongoDriverCount = async ({ collectionName, filter }) => {
+        await ensureClient();
+        return client.db(mongoDb).collection(collectionName).countDocuments(filter);
+    };
+    return {
+        mongoDriverReadMany,
+        mongoDriverCount,
+        close: async () => {
+            try {
+                await client.close();
+            }
+            finally {
+                connectPromise = undefined;
+            }
+        },
+    };
+}
+//# sourceMappingURL=xronox-store-native-driver-hooks.js.map

package/dist/execution-matrix/xronox-store-native-driver-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xronox-store-native-driver-hooks.js","sourceRoot":"","sources":["../../src/execution-matrix/xronox-store-native-driver-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA8B,MAAM,SAAS,CAAC;AAYlE;;;GAGG;AACH,MAAM,UAAU,kCAAkC,CAAC,QAAgB,EAAE,OAAe;IAClF,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,cAAyC,CAAC;IAE9C,KAAK,UAAU,YAAY;QACzB,IAAI,CAAC,cAAc;YAAE,cAAc,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC7E,MAAM,cAAc,CAAC;IACvB,CAAC;IAED,MAAM,mBAAmB,GAAmD,KAAK,EAAE,EACjF,cAAc,EACd,MAAM,EACN,KAAK,EACL,IAAI,GACL,EAAE,EAAE;QACH,MAAM,YAAY,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QAC3D,IAAI,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAA0B,CAAC,CAAC;QACnD,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7D,OAAO,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,CAA8B,CAAC;IAC/D,CAAC,CAAC;IAEF,MAAM,gBAAgB,GAAgD,KAAK,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE;QACzG,MAAM,YAAY,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,cAAc,CAAC,MAA0B,CAAC,CAAC;IAClG,CAAC,CAAC;IAEF,OAAO;QACL,mBAAmB;QACnB,gBAAgB;QAChB,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;oBAAS,CAAC;gBACT,cAAc,GAAG,SAAS,CAAC;YAC7B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/test-fixtures/exellix-test-matrix-ids.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Fixed catalog ids for **local smoke / verify only** — never use in production BFF or Studio.
+ *
+ * Seeded by `npm run test:matrix:seed` into config DB (`exellix` by default).
+ */
+export declare const EXELLIX_TEST_MATRIX_CATALOG_ID: "__exellix_test_matrix_smoke__";
+export declare const EXELLIX_TEST_GRAPH_ID: "__exellix_test_graph_smoke__";
+export declare const EXELLIX_TEST_MATRIX_ITEM_ID: "__exellix_test_matrix_smoke__";
+export declare const EXELLIX_TEST_MATRIX_RUN_ID: "__exellix_test_run_smoke__";
+export declare const EXELLIX_TEST_MATRIX_IDS: {
+    readonly matrixCatalogId: "__exellix_test_matrix_smoke__";
+    readonly graphId: "__exellix_test_graph_smoke__";
+    readonly matrixItemId: "__exellix_test_matrix_smoke__";
+    readonly matrixRunId: "__exellix_test_run_smoke__";
+};
+//# sourceMappingURL=exellix-test-matrix-ids.d.ts.map

package/dist/test-fixtures/exellix-test-matrix-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exellix-test-matrix-ids.d.ts","sourceRoot":"","sources":["../../src/test-fixtures/exellix-test-matrix-ids.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,EAAG,+BAAwC,CAAC;AACvF,eAAO,MAAM,qBAAqB,EAAG,8BAAuC,CAAC;AAC7E,eAAO,MAAM,2BAA2B,EAAG,+BAAwC,CAAC;AACpF,eAAO,MAAM,0BAA0B,EAAG,4BAAqC,CAAC;AAEhF,eAAO,MAAM,uBAAuB;;;;;CAK1B,CAAC"}

package/dist/test-fixtures/exellix-test-matrix-ids.js

@@ -0,0 +1,16 @@
+/**
+ * Fixed catalog ids for **local smoke / verify only** — never use in production BFF or Studio.
+ *
+ * Seeded by `npm run test:matrix:seed` into config DB (`exellix` by default).
+ */
+export const EXELLIX_TEST_MATRIX_CATALOG_ID = '__exellix_test_matrix_smoke__';
+export const EXELLIX_TEST_GRAPH_ID = '__exellix_test_graph_smoke__';
+export const EXELLIX_TEST_MATRIX_ITEM_ID = '__exellix_test_matrix_smoke__';
+export const EXELLIX_TEST_MATRIX_RUN_ID = '__exellix_test_run_smoke__';
+export const EXELLIX_TEST_MATRIX_IDS = {
+    matrixCatalogId: EXELLIX_TEST_MATRIX_CATALOG_ID,
+    graphId: EXELLIX_TEST_GRAPH_ID,
+    matrixItemId: EXELLIX_TEST_MATRIX_ITEM_ID,
+    matrixRunId: EXELLIX_TEST_MATRIX_RUN_ID,
+};
+//# sourceMappingURL=exellix-test-matrix-ids.js.map

package/dist/test-fixtures/exellix-test-matrix-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exellix-test-matrix-ids.js","sourceRoot":"","sources":["../../src/test-fixtures/exellix-test-matrix-ids.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,+BAAwC,CAAC;AACvF,MAAM,CAAC,MAAM,qBAAqB,GAAG,8BAAuC,CAAC;AAC7E,MAAM,CAAC,MAAM,2BAA2B,GAAG,+BAAwC,CAAC;AACpF,MAAM,CAAC,MAAM,0BAA0B,GAAG,4BAAqC,CAAC;AAEhF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,eAAe,EAAE,8BAA8B;IAC/C,OAAO,EAAE,qBAAqB;IAC9B,YAAY,EAAE,2BAA2B;IACzC,WAAW,EAAE,0BAA0B;CAC/B,CAAC"}

package/dist/test-fixtures/seed-exellix-test-matrix-config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Idempotent seed of test-only matrix + graph config (and optional smoke runtime row).
+ * Repo-local — not exported from `@exellix/exellix-runtime` package root.
+ */
+import { type MatrixClientBundle } from '../client-toolbox/bundle.js';
+export type EnsureExellixTestMatrixConfigSeededOptions = {
+    bundle?: MatrixClientBundle;
+    /** Insert one runtime row when none exist for {@link EXELLIX_TEST_MATRIX_RUN_ID}. Default `true`. */
+    materializeSmokeRow?: boolean;
+    mongoUri?: string;
+    executionDb?: string;
+    configDb?: string;
+    /** Optional progress callback (CLI seed script). */
+    onProgress?: (step: string) => void;
+};
+export type EnsureExellixTestMatrixConfigSeededResult = {
+    matrixCatalogId: string;
+    graphId: string;
+    matrixRunId: string;
+    graphVersion: number;
+    matrixVersion: number;
+    materializedRowCount: number;
+    createdGraph: boolean;
+};
+export declare function ensureExellixTestMatrixConfigSeeded(options?: EnsureExellixTestMatrixConfigSeededOptions): Promise<EnsureExellixTestMatrixConfigSeededResult>;
+//# sourceMappingURL=seed-exellix-test-matrix-config.d.ts.map

package/dist/test-fixtures/seed-exellix-test-matrix-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-exellix-test-matrix-config.d.ts","sourceRoot":"","sources":["../../src/test-fixtures/seed-exellix-test-matrix-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAU9F,MAAM,MAAM,0CAA0C,GAAG;IACvD,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,qGAAqG;IACrG,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,yCAAyC,GAAG;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,wBAAsB,mCAAmC,CACvD,OAAO,GAAE,0CAA+C,GACvD,OAAO,CAAC,yCAAyC,CAAC,CA8EpD"}

package/dist/test-fixtures/seed-exellix-test-matrix-config.js

@@ -0,0 +1,82 @@
+/**
+ * Idempotent seed of test-only matrix + graph config (and optional smoke runtime row).
+ * Repo-local — not exported from `@exellix/exellix-runtime` package root.
+ */
+import { openMatrixClientBundle } from '../client-toolbox/bundle.js';
+import { ensureExecutionMatrixConfigForGraph, publishGraphForMatrixRun } from '../client-toolbox/matrix-config.js';
+import { materializeAndInsertMatrixRows } from '../client-toolbox/matrix-materialize.js';
+import { EXELLIX_TEST_GRAPH_ID, EXELLIX_TEST_MATRIX_CATALOG_ID, EXELLIX_TEST_MATRIX_ITEM_ID, EXELLIX_TEST_MATRIX_RUN_ID, } from './exellix-test-matrix-ids.js';
+export async function ensureExellixTestMatrixConfigSeeded(options = {}) {
+    const progress = options.onProgress ?? (() => undefined);
+    const materializeSmokeRow = options.materializeSmokeRow !== false;
+    progress('opening matrix Mongo bundle (execution + config DB) …');
+    const ownedBundle = options.bundle ??
+        (await openMatrixClientBundle({
+            ...(options.mongoUri ? { mongoUri: options.mongoUri } : {}),
+            ...(options.executionDb ? { executionDb: options.executionDb } : {}),
+            ...(options.configDb ? { configDb: options.configDb } : {}),
+        }));
+    const closeBundle = options.bundle === undefined;
+    progress('bundle open');
+    try {
+        const { configStore, runtime } = ownedBundle;
+        progress(`graph + matrix config: ${EXELLIX_TEST_GRAPH_ID} / ${EXELLIX_TEST_MATRIX_CATALOG_ID}`);
+        const bootstrap = await ensureExecutionMatrixConfigForGraph(configStore, {
+            graphId: EXELLIX_TEST_GRAPH_ID,
+            matrixCatalogId: EXELLIX_TEST_MATRIX_CATALOG_ID,
+            graphDefaults: {
+                mappedInput: [{ sourceId: 'exellix_test_smoke_source', tag: 'smoke-fixture' }],
+            },
+            matrixDefaults: {
+                input: { fixture: 'exellix-test-smoke' },
+                dataSource: { kind: 'event', subKind: 'api' },
+            },
+            publishOperational: true,
+        });
+        const createdGraph = bootstrap.graphConfigCreated;
+        const matrixRec = bootstrap.matrixRecord;
+        progress('patch operational Published / Running');
+        const published = await publishGraphForMatrixRun(configStore, {
+            graphId: EXELLIX_TEST_GRAPH_ID,
+            publicationStatus: 'Published',
+            operationalState: 'Running',
+        });
+        let materializedRowCount = 0;
+        if (materializeSmokeRow) {
+            progress(`runtime rows for run ${EXELLIX_TEST_MATRIX_RUN_ID}`);
+            const existing = await runtime.listRecords({
+                matrixCatalogId: EXELLIX_TEST_MATRIX_CATALOG_ID,
+                matrixRunId: EXELLIX_TEST_MATRIX_RUN_ID,
+                limit: 1,
+            });
+            if (existing.length === 0) {
+                const inserted = await materializeAndInsertMatrixRows({ runtime, configStore }, {
+                    matrixCatalogId: EXELLIX_TEST_MATRIX_CATALOG_ID,
+                    matrixItemId: EXELLIX_TEST_MATRIX_ITEM_ID,
+                    matrixRunId: EXELLIX_TEST_MATRIX_RUN_ID,
+                    graphId: EXELLIX_TEST_GRAPH_ID,
+                    inputRows: [{ sourceId: 'exellix_test_smoke_source', fixture: true }],
+                });
+                materializedRowCount = inserted.rowCount;
+            }
+            else {
+                materializedRowCount = existing.length;
+            }
+        }
+        return {
+            matrixCatalogId: EXELLIX_TEST_MATRIX_CATALOG_ID,
+            graphId: EXELLIX_TEST_GRAPH_ID,
+            matrixRunId: EXELLIX_TEST_MATRIX_RUN_ID,
+            graphVersion: published.version,
+            matrixVersion: matrixRec.version,
+            materializedRowCount,
+            createdGraph,
+        };
+    }
+    finally {
+        if (closeBundle) {
+            await ownedBundle.close().catch(() => undefined);
+        }
+    }
+}
+//# sourceMappingURL=seed-exellix-test-matrix-config.js.map

package/dist/test-fixtures/seed-exellix-test-matrix-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-exellix-test-matrix-config.js","sourceRoot":"","sources":["../../src/test-fixtures/seed-exellix-test-matrix-config.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@exellix/exellix-runtime",
+  "version": "3.5.1",
+  "description": "Execution matrix runtime: Catalox-shaped catalogs, Mongo matrix row lifecycle, claims, and orchestration hooks that inject @exellix/graph-engine executeGraph.",
+  "type": "module",
+  "main": "./dist/execution-matrix/index.js",
+  "types": "./dist/execution-matrix/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/execution-matrix/index.d.ts",
+      "import": "./dist/execution-matrix/index.js"
+    },
+    "./execution-matrix": {
+      "types": "./dist/execution-matrix/index.d.ts",
+      "import": "./dist/execution-matrix/index.js"
+    },
+    "./internal/xronox-matrix": {
+      "types": "./dist/execution-matrix/xronox-matrix-factory.d.ts",
+      "import": "./dist/execution-matrix/xronox-matrix-factory.js"
+    }
+  },
+  "bin": {
+    "exellix-runtime": "./dist/cli/exellix-runtime-cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "cli": "npm run build && node dist/cli/exellix-runtime-cli.js",
+    "matrix:link": "npm run build && node dist/cli/exellix-runtime-cli.js matrix-link",
+    "matrix:read": "npm run build && node dist/cli/exellix-runtime-cli.js matrix-read",
+    "test:matrix:seed": "node scripts/seed-test-matrix.mjs",
+    "test:matrix:seed:build": "npm run build && npm run test:matrix:seed",
+    "matrix-read:smoke": "npm run test:smoke",
+    "test:smoke": "npm run test:matrix:seed:build && node dist/cli/exellix-runtime-cli.js matrix-read",
+    "catalox:inventory": "npm run build && node dist/cli/exellix-runtime-cli.js catalox-inventory",
+    "use-case:create-exellix-graphs-catalog": "node use-cases/create-exellix-graphs-catalog.mjs",
+    "test": "npm run test:unit",
+    "test:unit": "vitest run --exclude \"test/**/*.live*.spec.ts\"",
+    "test:live": "vitest run test/execution-matrix/execution-matrix.live.spec.ts test/execution-matrix/execution-matrix.live.xmemory.spec.ts test/execution-matrix/client-toolbox.live.spec.ts",
+    "test:watch": "vitest",
+    "verify": "node scripts/verify-suite.mjs",
+    "verify:ci": "node scripts/verify-suite.mjs --build --unit",
+    "verify:all": "node scripts/verify-suite.mjs --all"
+  },
+  "dependencies": {
+    "@exellix/graph-engine": "^6.0.0",
+    "@x12i/catalox": "^5.1.1",
+    "@x12i/env": "^4.0.1",
+    "@x12i/logxer": "^4.3.6",
+    "@x12i/memorix-descriptors": "^1.6.0",
+    "@x12i/memorix-retrieval": "^1.10.0",
+    "@x12i/memorix-writer": "^1.0.0",
+    "@x12i/xronox-store": "^1.9.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "mongodb": "^6.21.0",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}