@exellix/exellix-runtime 3.5.1

package/dist/dev/matrix-read-dashboard-smoke.d.ts.map

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

package/dist/dev/matrix-read-dashboard-smoke.js

@@ -0,0 +1,12 @@
+/**
+ * Dev smoke entry — delegates to `exellix-runtime matrix-read` CLI.
+ * Env (required): MONGO_URI, MATRIX_CATALOG_ID, GRAPH_ID
+ */
+import { runMatrixReadCommand } from '../cli/commands/matrix-read.js';
+import { loadCliEnv } from '../cli/env.js';
+loadCliEnv();
+void runMatrixReadCommand([]).catch((e) => {
+    console.error(e instanceof Error ? e.stack ?? e.message : e);
+    process.exit(1);
+});
+//# sourceMappingURL=matrix-read-dashboard-smoke.js.map

package/dist/dev/matrix-read-dashboard-smoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix-read-dashboard-smoke.js","sourceRoot":"","sources":["../../src/dev/matrix-read-dashboard-smoke.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,UAAU,EAAE,CAAC;AACb,KAAK,oBAAoB,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;IACjD,OAAO,CAAC,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/dev/runtime-real-dev-server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-real-dev-server.d.ts.map

package/dist/dev/runtime-real-dev-server.d.ts.map

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

package/dist/dev/runtime-real-dev-server.js

@@ -0,0 +1,90 @@
+/**
+ * Tiny local HTTP server exposing **`GET /api/runtime-real/health`** for Studio / operator smoke checks.
+ * Does not load Catalox or graph JSON — uses {@link buildExellixRuntimeRealLivenessPayload} and optional
+ * {@link runExellixRuntimeConnectivityProbe}.
+ *
+ * Usage: `npm start` (runs **`tsc`** first) or `npm run runtime-real:serve` after a build.
+ * Set **`MONGO_URI`** (and roles / DB names) for **`?probe=dependencies`**.
+ */
+import http from 'node:http';
+import { URL } from 'node:url';
+import { createExellixConfigStoreFromXronox, createExecutionMatrixRuntimeFromXronox } from '../execution-matrix/factory.js';
+import { EXELLIX_RUNTIME_REAL_HEALTH_PATH, buildExellixRuntimeRealLivenessPayload, runExellixRuntimeConnectivityProbe, } from '../execution-matrix/runtime-connectivity-health.js';
+const PORT = Number(process.env.PORT || 8765) || 8765;
+function sendJson(res, status, body) {
+    res.writeHead(status, {
+        'content-type': 'application/json; charset=utf-8',
+        'cache-control': 'no-store',
+    });
+    res.end(JSON.stringify(body));
+}
+async function handleHealth(url) {
+    const probe = url.searchParams.get('probe');
+    if (probe !== 'dependencies' || !process.env.MONGO_URI?.trim()) {
+        return buildExellixRuntimeRealLivenessPayload();
+    }
+    const exec = await createExecutionMatrixRuntimeFromXronox({});
+    const cfg = await createExellixConfigStoreFromXronox({});
+    try {
+        return await runExellixRuntimeConnectivityProbe({
+            executionStore: exec.store,
+            executionMongoUri: process.env.MONGO_URI,
+            configStore: cfg.store,
+            configMongoUri: process.env.MONGO_URI,
+            includeXmemoryEnv: url.searchParams.get('xmemory') === '1',
+            includeActivixSchedulerProbe: url.searchParams.get('activix') === '1',
+        });
+    }
+    finally {
+        await exec.store.close().catch(() => undefined);
+        await cfg.store.close().catch(() => undefined);
+        await exec.closeMongoDriverPassThrough?.().catch(() => undefined);
+        await cfg.closeMongoDriverPassThrough?.().catch(() => undefined);
+    }
+}
+const server = http.createServer((req, res) => {
+    void (async () => {
+        try {
+            const host = req.headers.host ?? `localhost:${PORT}`;
+            const url = new URL(req.url || '/', `http://${host}`);
+            if (req.method === 'GET' && (url.pathname === EXELLIX_RUNTIME_REAL_HEALTH_PATH || url.pathname === '/health')) {
+                const body = await handleHealth(url);
+                sendJson(res, 200, body);
+                return;
+            }
+            if (req.method === 'GET' && url.pathname === '/') {
+                res.writeHead(200, { 'content-type': 'text/plain; charset=utf-8' });
+                res.end([
+                    'Exellix runtime — local dev server',
+                    '',
+                    `GET ${EXELLIX_RUNTIME_REAL_HEALTH_PATH}  (liveness JSON; no Mongo required)`,
+                    `GET ${EXELLIX_RUNTIME_REAL_HEALTH_PATH}?probe=dependencies  (needs MONGO_URI; optional &xmemory=1 &activix=1)`,
+                    '',
+                    `Listening on http://localhost:${PORT}`,
+                ].join('\n'));
+                return;
+            }
+            sendJson(res, 404, { error: 'not_found', path: url.pathname });
+        }
+        catch (e) {
+            sendJson(res, 500, {
+                ok: false,
+                error: e instanceof Error ? e.message : String(e),
+            });
+        }
+    })();
+});
+server.on('error', (err) => {
+    if (err.code === 'EADDRINUSE') {
+        console.error(`[exellix-runtime] Port ${PORT} is already in use. Stop the other process (e.g. an earlier dev server) or pick another port: PORT=8766 npm start`);
+    }
+    else {
+        console.error(`[exellix-runtime] listen: ${err.message}`);
+    }
+    process.exit(1);
+});
+server.listen(PORT, () => {
+    console.log(`http://localhost:${PORT}/`);
+    console.log(`http://localhost:${PORT}${EXELLIX_RUNTIME_REAL_HEALTH_PATH}`);
+});
+//# sourceMappingURL=runtime-real-dev-server.js.map

package/dist/dev/runtime-real-dev-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-real-dev-server.js","sourceRoot":"","sources":["../../src/dev/runtime-real-dev-server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,kCAAkC,EAAE,sCAAsC,EAAE,MAAM,gCAAgC,CAAC;AAC5H,OAAO,EACL,gCAAgC,EAChC,sCAAsC,EACtC,kCAAkC,GACnC,MAAM,oDAAoD,CAAC;AAE5D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;AAEtD,SAAS,QAAQ,CAAC,GAAwB,EAAE,MAAc,EAAE,IAAa;IACvE,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE;QACpB,cAAc,EAAE,iCAAiC;QACjD,eAAe,EAAE,UAAU;KAC5B,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,GAAQ;IAClC,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,KAAK,KAAK,cAAc,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;QAC/D,OAAO,sCAAsC,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,sCAAsC,CAAC,EAAE,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,MAAM,kCAAkC,CAAC,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,OAAO,MAAM,kCAAkC,CAAC;YAC9C,cAAc,EAAE,IAAI,CAAC,KAAK;YAC1B,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS;YACxC,WAAW,EAAE,GAAG,CAAC,KAAK;YACtB,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS;YACrC,iBAAiB,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,GAAG;YAC1D,4BAA4B,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,GAAG;SACtE,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,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;AACH,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IAC5C,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,aAAa,IAAI,EAAE,CAAC;YACrD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC;YAEtD,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,gCAAgC,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,EAAE,CAAC;gBAC9G,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;gBACrC,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;gBACzB,OAAO;YACT,CAAC;YAED,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,QAAQ,KAAK,GAAG,EAAE,CAAC;gBACjD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,2BAA2B,EAAE,CAAC,CAAC;gBACpE,GAAG,CAAC,GAAG,CACL;oBACE,oCAAoC;oBACpC,EAAE;oBACF,OAAO,gCAAgC,sCAAsC;oBAC7E,OAAO,gCAAgC,wEAAwE;oBAC/G,EAAE;oBACF,iCAAiC,IAAI,EAAE;iBACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;gBACF,OAAO;YACT,CAAC;YAED,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;gBACjB,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;aAClD,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;IAChD,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CACX,0BAA0B,IAAI,mHAAmH,CAClJ,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,6BAA6B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IACvB,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,GAAG,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,GAAG,gCAAgC,EAAE,CAAC,CAAC;AAC7E,CAAC,CAAC,CAAC"}

package/dist/execution-matrix/catalox-loader.d.ts

@@ -0,0 +1,55 @@
+import type { ExecutionMatrixCatalogPayload, ExecutionMatrixGraphCatalogRecord } from './contracts.js';
+export declare class ExecutionMatrixCatalogValidationError extends Error {
+    readonly issues: string[];
+    constructor(message: string, issues: string[]);
+}
+/**
+ * Detect execution-matrix catalog items before Catalox first-class `catalogType` exists.
+ */
+export declare function isExecutionMatrixCatalogMetadata(metadata: Record<string, unknown> | undefined): boolean;
+/**
+ * Detect graph catalog native items (e.g. catalog `exellix-graphs` rows).
+ */
+export declare function isGraphCatalogMetadata(metadata: Record<string, unknown> | undefined): boolean;
+/**
+ * Validate Catalox native catalog item `data` for a graph row under the graphs catalog.
+ */
+export declare function parseGraphCatalogPayload(data: unknown): ExecutionMatrixGraphCatalogRecord;
+/**
+ * Load graph definition from a Catalox {@link UnifiedCatalogItem}-shaped record (`data` + optional `metadata`).
+ */
+export declare function graphCatalogPayloadFromCatalogItem(item: {
+    data?: unknown;
+    metadata?: Record<string, unknown>;
+}): ExecutionMatrixGraphCatalogRecord;
+/**
+ * Result of {@link parseExecutionMatrixCatalogPayloadWithWarnings} containing both the validated
+ * payload and any advisory warnings (e.g. unusual `pollWhenEmptySeconds` values).
+ */
+export type ParseExecutionMatrixCatalogPayloadResult = {
+    payload: ExecutionMatrixCatalogPayload;
+    warnings: string[];
+};
+/**
+ * Validate Catalox native catalog item `data` for an execution-matrix template row.
+ *
+ * Supports the legacy minimal payload (`input` + `graphs`) and the extended configuration
+ * shape (`dataSource` + `executionMode` + `eligibility`). New blocks are optional but, when
+ * present, are validated strictly. Use {@link parseExecutionMatrixCatalogPayloadWithWarnings}
+ * to also surface advisory warnings (e.g. unusual poll intervals).
+ */
+export declare function parseExecutionMatrixCatalogPayload(data: unknown): ExecutionMatrixCatalogPayload;
+/**
+ * Variant of {@link parseExecutionMatrixCatalogPayload} that returns warnings alongside the
+ * payload. Validation errors still throw; warnings never block persistence and are surfaced
+ * by the configuration store and the run loop for visibility.
+ */
+export declare function parseExecutionMatrixCatalogPayloadWithWarnings(data: unknown): ParseExecutionMatrixCatalogPayloadResult;
+/**
+ * Load matrix definition from a Catalox {@link UnifiedCatalogItem}-shaped record (`data` + optional `metadata`).
+ */
+export declare function executionMatrixPayloadFromCatalogItem(item: {
+    data?: unknown;
+    metadata?: Record<string, unknown>;
+}): ExecutionMatrixCatalogPayload;
+//# sourceMappingURL=catalox-loader.d.ts.map

package/dist/execution-matrix/catalox-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalox-loader.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/catalox-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,6BAA6B,EAC7B,iCAAiC,EAIlC,MAAM,gBAAgB,CAAC;AAIxB,qBAAa,qCAAsC,SAAQ,KAAK;aAG5C,MAAM,EAAE,MAAM,EAAE;gBADhC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EAAE;CAKnC;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,OAAO,CAKvG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,OAAO,CAK7F;AAqED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,iCAAiC,CAmBzF;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,EAAE;IACvD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,iCAAiC,CAOpC;AAED;;;GAGG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,OAAO,EAAE,6BAA6B,CAAC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,OAAO,GAAG,6BAA6B,CAE/F;AAED;;;;GAIG;AACH,wBAAgB,8CAA8C,CAC5D,IAAI,EAAE,OAAO,GACZ,wCAAwC,CAuC1C;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CAAC,IAAI,EAAE;IAC1D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,6BAA6B,CAOhC"}

package/dist/execution-matrix/catalox-loader.js

@@ -0,0 +1,199 @@
+import { EXECUTION_MATRIX_CATALOG_TYPE, GRAPH_CATALOG_METADATA_TYPE, } from './contracts.js';
+import { parseDataSource, parseEligibility } from './data-source.js';
+import { parseExecutionMode } from './execution-mode.js';
+export class ExecutionMatrixCatalogValidationError extends Error {
+    issues;
+    constructor(message, issues) {
+        super(message);
+        this.issues = issues;
+        this.name = 'ExecutionMatrixCatalogValidationError';
+    }
+}
+/**
+ * Detect execution-matrix catalog items before Catalox first-class `catalogType` exists.
+ */
+export function isExecutionMatrixCatalogMetadata(metadata) {
+    if (!metadata)
+        return false;
+    if (metadata.catalogType === EXECUTION_MATRIX_CATALOG_TYPE)
+        return true;
+    if (metadata.kind === EXECUTION_MATRIX_CATALOG_TYPE)
+        return true;
+    return false;
+}
+/**
+ * Detect graph catalog native items (e.g. catalog `exellix-graphs` rows).
+ */
+export function isGraphCatalogMetadata(metadata) {
+    if (!metadata)
+        return false;
+    if (metadata.catalogType === GRAPH_CATALOG_METADATA_TYPE)
+        return true;
+    if (metadata.kind === GRAPH_CATALOG_METADATA_TYPE)
+        return true;
+    return false;
+}
+function isPlainObject(v) {
+    return v !== null && typeof v === 'object' && !Array.isArray(v);
+}
+function validateGraphIdList(graphs) {
+    if (!Array.isArray(graphs) || graphs.length === 0) {
+        throw new ExecutionMatrixCatalogValidationError('Invalid matrix payload', ['graphs must be a non-empty array']);
+    }
+    const out = [];
+    graphs.forEach((g, i) => {
+        if (typeof g !== 'string' || !g.trim()) {
+            throw new ExecutionMatrixCatalogValidationError('Invalid matrix payload', [`graphs[${i}] must be a non-empty string`]);
+        }
+        out.push(g.trim());
+    });
+    return out;
+}
+function validateGraphCondition(raw, index) {
+    if (!isPlainObject(raw)) {
+        throw new ExecutionMatrixCatalogValidationError('Invalid graph payload', [`execution.conditions[${index}] must be an object`]);
+    }
+    const conditionId = raw.conditionId;
+    if (typeof conditionId !== 'string' || !conditionId.trim()) {
+        throw new ExecutionMatrixCatalogValidationError('Invalid graph payload', [`execution.conditions[${index}].conditionId is required`]);
+    }
+    const condition = raw.condition;
+    if (!isPlainObject(condition)) {
+        throw new ExecutionMatrixCatalogValidationError('Invalid graph payload', [`execution.conditions[${index}].condition must be an object`]);
+    }
+    return { conditionId: conditionId.trim(), condition };
+}
+function validateGraphExecutionPolicy(raw) {
+    if (!isPlainObject(raw)) {
+        throw new ExecutionMatrixCatalogValidationError('Invalid graph payload', ['execution must be an object']);
+    }
+    const priority = raw.priority;
+    if (typeof priority !== 'number' || !Number.isFinite(priority)) {
+        throw new ExecutionMatrixCatalogValidationError('Invalid graph payload', ['execution.priority must be a finite number']);
+    }
+    const conditionsRaw = raw.conditions;
+    let conditions;
+    if (conditionsRaw !== undefined) {
+        if (!Array.isArray(conditionsRaw)) {
+            throw new ExecutionMatrixCatalogValidationError('Invalid graph payload', ['execution.conditions must be an array when set']);
+        }
+        conditions = conditionsRaw.map((c, i) => validateGraphCondition(c, i));
+    }
+    const conditionRelations = raw.conditionRelations;
+    if (conditionRelations !== undefined && typeof conditionRelations !== 'string') {
+        throw new ExecutionMatrixCatalogValidationError('Invalid graph payload', ['execution.conditionRelations must be a string when set']);
+    }
+    return {
+        priority,
+        ...(conditions ? { conditions } : {}),
+        ...(typeof conditionRelations === 'string' ? { conditionRelations } : {}),
+    };
+}
+function validateMappedInputEntry(raw, index) {
+    if (!isPlainObject(raw)) {
+        throw new ExecutionMatrixCatalogValidationError('Invalid graph payload', [`mappedInput[${index}] must be an object`]);
+    }
+    return raw;
+}
+/**
+ * Validate Catalox native catalog item `data` for a graph row under the graphs catalog.
+ */
+export function parseGraphCatalogPayload(data) {
+    if (!isPlainObject(data)) {
+        throw new ExecutionMatrixCatalogValidationError('Invalid graph payload', ['root must be an object']);
+    }
+    const graphId = data.graphId;
+    if (typeof graphId !== 'string' || !graphId.trim()) {
+        throw new ExecutionMatrixCatalogValidationError('Invalid graph payload', ['graphId is required']);
+    }
+    const mappedInputRaw = data.mappedInput;
+    if (!Array.isArray(mappedInputRaw)) {
+        throw new ExecutionMatrixCatalogValidationError('Invalid graph payload', ['mappedInput must be an array']);
+    }
+    const mappedInput = mappedInputRaw.map((m, i) => validateMappedInputEntry(m, i));
+    const execution = validateGraphExecutionPolicy(data.execution);
+    return {
+        graphId: graphId.trim(),
+        mappedInput,
+        execution,
+    };
+}
+/**
+ * Load graph definition from a Catalox {@link UnifiedCatalogItem}-shaped record (`data` + optional `metadata`).
+ */
+export function graphCatalogPayloadFromCatalogItem(item) {
+    if (!isGraphCatalogMetadata(item.metadata)) {
+        throw new ExecutionMatrixCatalogValidationError('Not a graph catalog item', [
+            `metadata.catalogType (or kind) must be "${GRAPH_CATALOG_METADATA_TYPE}"`,
+        ]);
+    }
+    return parseGraphCatalogPayload(item.data);
+}
+/**
+ * Validate Catalox native catalog item `data` for an execution-matrix template row.
+ *
+ * Supports the legacy minimal payload (`input` + `graphs`) and the extended configuration
+ * shape (`dataSource` + `executionMode` + `eligibility`). New blocks are optional but, when
+ * present, are validated strictly. Use {@link parseExecutionMatrixCatalogPayloadWithWarnings}
+ * to also surface advisory warnings (e.g. unusual poll intervals).
+ */
+export function parseExecutionMatrixCatalogPayload(data) {
+    return parseExecutionMatrixCatalogPayloadWithWarnings(data).payload;
+}
+/**
+ * Variant of {@link parseExecutionMatrixCatalogPayload} that returns warnings alongside the
+ * payload. Validation errors still throw; warnings never block persistence and are surfaced
+ * by the configuration store and the run loop for visibility.
+ */
+export function parseExecutionMatrixCatalogPayloadWithWarnings(data) {
+    if (!isPlainObject(data)) {
+        throw new ExecutionMatrixCatalogValidationError('Invalid matrix payload', ['root must be an object']);
+    }
+    const input = data.input;
+    if (!isPlainObject(input)) {
+        throw new ExecutionMatrixCatalogValidationError('Invalid matrix payload', ['input must be an object']);
+    }
+    const graphs = validateGraphIdList(data.graphs);
+    const issues = [];
+    const warnings = [];
+    const payload = { input, graphs };
+    if (data.dataSource !== undefined) {
+        try {
+            const result = parseDataSource(data.dataSource, issues);
+            payload.dataSource = result.dataSource;
+            warnings.push(...result.warnings);
+        }
+        catch {
+            throw new ExecutionMatrixCatalogValidationError('Invalid matrix payload', issues);
+        }
+    }
+    if (data.executionMode !== undefined) {
+        try {
+            payload.executionMode = parseExecutionMode(data.executionMode, issues);
+        }
+        catch {
+            throw new ExecutionMatrixCatalogValidationError('Invalid matrix payload', issues);
+        }
+    }
+    if (data.eligibility !== undefined) {
+        try {
+            payload.eligibility = parseEligibility(data.eligibility, issues);
+        }
+        catch {
+            throw new ExecutionMatrixCatalogValidationError('Invalid matrix payload', issues);
+        }
+    }
+    return { payload, warnings };
+}
+/**
+ * Load matrix definition from a Catalox {@link UnifiedCatalogItem}-shaped record (`data` + optional `metadata`).
+ */
+export function executionMatrixPayloadFromCatalogItem(item) {
+    if (!isExecutionMatrixCatalogMetadata(item.metadata)) {
+        throw new ExecutionMatrixCatalogValidationError('Not an execution-matrix catalog item', [
+            `metadata.catalogType (or kind) must be "${EXECUTION_MATRIX_CATALOG_TYPE}"`,
+        ]);
+    }
+    return parseExecutionMatrixCatalogPayload(item.data);
+}
+//# sourceMappingURL=catalox-loader.js.map

package/dist/execution-matrix/catalox-loader.js.map

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

package/dist/execution-matrix/catalox-matrix-host.d.ts

@@ -0,0 +1,20 @@
+import type { ExecutionMatrixCatalogPayload, ExecutionMatrixGraphCatalogRecord } from './contracts.js';
+/**
+ * Minimal Catalox native-item shape: `data` + `metadata` after fetch.
+ * Fetching from Firestore/Catalox APIs remains a host concern; this helper only validates and pairs records.
+ */
+export type CataloxNativeItemLike = {
+    data?: unknown;
+    metadata?: Record<string, unknown>;
+};
+/**
+ * From one matrix template item and a map of graph catalog items keyed by `graphId`, produce validated
+ * `payload` + `graphRecords` suitable for {@link materializeExecutionMatrixRuntimeRows}.
+ *
+ * @throws ExecutionMatrixCatalogValidationError from the underlying loaders when metadata or `data` is invalid.
+ */
+export declare function buildMatrixMaterializeContext(matrixItem: CataloxNativeItemLike, graphItemsByGraphId: ReadonlyMap<string, CataloxNativeItemLike>): {
+    payload: ExecutionMatrixCatalogPayload;
+    graphRecords: ExecutionMatrixGraphCatalogRecord[];
+};
+//# sourceMappingURL=catalox-matrix-host.d.ts.map

package/dist/execution-matrix/catalox-matrix-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalox-matrix-host.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/catalox-matrix-host.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,6BAA6B,EAAE,iCAAiC,EAAE,MAAM,gBAAgB,CAAC;AAEvG;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,qBAAqB,EACjC,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAC9D;IACD,OAAO,EAAE,6BAA6B,CAAC;IACvC,YAAY,EAAE,iCAAiC,EAAE,CAAC;CACnD,CAYA"}

package/dist/execution-matrix/catalox-matrix-host.js

@@ -0,0 +1,19 @@
+import { executionMatrixPayloadFromCatalogItem, graphCatalogPayloadFromCatalogItem } from './catalox-loader.js';
+/**
+ * From one matrix template item and a map of graph catalog items keyed by `graphId`, produce validated
+ * `payload` + `graphRecords` suitable for {@link materializeExecutionMatrixRuntimeRows}.
+ *
+ * @throws ExecutionMatrixCatalogValidationError from the underlying loaders when metadata or `data` is invalid.
+ */
+export function buildMatrixMaterializeContext(matrixItem, graphItemsByGraphId) {
+    const payload = executionMatrixPayloadFromCatalogItem(matrixItem);
+    const graphRecords = payload.graphs.map((graphId) => {
+        const graphItem = graphItemsByGraphId.get(graphId);
+        if (!graphItem) {
+            throw new Error(`buildMatrixMaterializeContext: missing graph catalog item for graphId ${JSON.stringify(graphId)}`);
+        }
+        return graphCatalogPayloadFromCatalogItem(graphItem);
+    });
+    return { payload, graphRecords };
+}
+//# sourceMappingURL=catalox-matrix-host.js.map

package/dist/execution-matrix/catalox-matrix-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalox-matrix-host.js","sourceRoot":"","sources":["../../src/execution-matrix/catalox-matrix-host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qCAAqC,EAAE,kCAAkC,EAAE,MAAM,qBAAqB,CAAC;AAYhH;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC3C,UAAiC,EACjC,mBAA+D;IAK/D,MAAM,OAAO,GAAG,qCAAqC,CAAC,UAAU,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAClD,MAAM,SAAS,GAAG,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,yEAAyE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CACnG,CAAC;QACJ,CAAC;QACD,OAAO,kCAAkC,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AACnC,CAAC"}

package/dist/execution-matrix/collections.d.ts

@@ -0,0 +1,16 @@
+import type { CollectionDefinition } from '@x12i/xronox-store';
+export declare function executionMatrixRowsCollectionDef(): CollectionDefinition;
+export declare function executionMatrixFailuresCollectionDef(): CollectionDefinition;
+export declare function executionMatrixSnapshotsCollectionDef(): CollectionDefinition;
+export declare function exellixMatrixConfigsCollectionDef(): CollectionDefinition;
+export declare function exellixGraphConfigsCollectionDef(): CollectionDefinition;
+/**
+ * Operational (runtime) collection set — lives in the `exellix-runtime` database.
+ * Includes rows, failures, and the new snapshot side-channel.
+ */
+export declare function executionMatrixStoreCollectionDefs(): CollectionDefinition[];
+/**
+ * Configuration collection set — lives in the separate `exellix` database.
+ */
+export declare function exellixConfigStoreCollectionDefs(): CollectionDefinition[];
+//# sourceMappingURL=collections.d.ts.map

package/dist/execution-matrix/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/collections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAa,MAAM,oBAAoB,CAAC;AAwC1E,wBAAgB,gCAAgC,IAAI,oBAAoB,CAMvE;AAED,wBAAgB,oCAAoC,IAAI,oBAAoB,CAM3E;AAED,wBAAgB,qCAAqC,IAAI,oBAAoB,CAM5E;AAED,wBAAgB,iCAAiC,IAAI,oBAAoB,CAMxE;AAED,wBAAgB,gCAAgC,IAAI,oBAAoB,CAMvE;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,IAAI,oBAAoB,EAAE,CAM3E;AAED;;GAEG;AACH,wBAAgB,gCAAgC,IAAI,oBAAoB,EAAE,CAEzE"}

package/dist/execution-matrix/collections.js

@@ -0,0 +1,75 @@
+import { EXECUTION_MATRIX_FAILURES_COLLECTION, EXECUTION_MATRIX_ROWS_COLLECTION, EXECUTION_MATRIX_SNAPSHOTS_COLLECTION, EXELLIX_GRAPH_CONFIGS_COLLECTION, EXELLIX_MATRIX_CONFIGS_COLLECTION, GRAPH_CONFIG_PK, MATRIX_CONFIG_PK, MATRIX_FAILURE_PK, MATRIX_ROW_PK, MATRIX_SNAPSHOT_PK, } from './constants.js';
+const rowIndexes = [
+    { keys: { matrixCatalogId: 1, matrixRunId: 1, updatedAt: 1 } },
+    { keys: { matrixCatalogId: 1, matrixItemId: 1 } },
+    { keys: { matrixRunId: 1 } },
+];
+const failureIndexes = [
+    { keys: { matrixCatalogId: 1, graphId: 1, createdAt: -1 } },
+    { keys: { matrixRowId: 1, graphId: 1 } },
+];
+const snapshotIndexes = [
+    { keys: { matrixCatalogId: 1, createdAt: -1 } },
+    { keys: { matrixCatalogId: 1, matrixRunId: 1, createdAt: -1 } },
+    { keys: { sourceQueryHash: 1 } },
+];
+const matrixConfigIndexes = [
+    { keys: { tags: 1 } },
+    { keys: { updatedAt: -1 } },
+];
+const graphConfigIndexes = [
+    { keys: { updatedAt: -1 } },
+];
+export function executionMatrixRowsCollectionDef() {
+    return {
+        name: EXECUTION_MATRIX_ROWS_COLLECTION,
+        primaryKey: MATRIX_ROW_PK,
+        indexes: rowIndexes,
+    };
+}
+export function executionMatrixFailuresCollectionDef() {
+    return {
+        name: EXECUTION_MATRIX_FAILURES_COLLECTION,
+        primaryKey: MATRIX_FAILURE_PK,
+        indexes: failureIndexes,
+    };
+}
+export function executionMatrixSnapshotsCollectionDef() {
+    return {
+        name: EXECUTION_MATRIX_SNAPSHOTS_COLLECTION,
+        primaryKey: MATRIX_SNAPSHOT_PK,
+        indexes: snapshotIndexes,
+    };
+}
+export function exellixMatrixConfigsCollectionDef() {
+    return {
+        name: EXELLIX_MATRIX_CONFIGS_COLLECTION,
+        primaryKey: MATRIX_CONFIG_PK,
+        indexes: matrixConfigIndexes,
+    };
+}
+export function exellixGraphConfigsCollectionDef() {
+    return {
+        name: EXELLIX_GRAPH_CONFIGS_COLLECTION,
+        primaryKey: GRAPH_CONFIG_PK,
+        indexes: graphConfigIndexes,
+    };
+}
+/**
+ * Operational (runtime) collection set — lives in the `exellix-runtime` database.
+ * Includes rows, failures, and the new snapshot side-channel.
+ */
+export function executionMatrixStoreCollectionDefs() {
+    return [
+        executionMatrixRowsCollectionDef(),
+        executionMatrixFailuresCollectionDef(),
+        executionMatrixSnapshotsCollectionDef(),
+    ];
+}
+/**
+ * Configuration collection set — lives in the separate `exellix` database.
+ */
+export function exellixConfigStoreCollectionDefs() {
+    return [exellixMatrixConfigsCollectionDef(), exellixGraphConfigsCollectionDef()];
+}
+//# sourceMappingURL=collections.js.map

package/dist/execution-matrix/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/execution-matrix/collections.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oCAAoC,EACpC,gCAAgC,EAChC,qCAAqC,EACrC,gCAAgC,EAChC,iCAAiC,EACjC,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,MAAM,UAAU,GAAgB;IAC9B,EAAE,IAAI,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE;IAC9D,EAAE,IAAI,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,EAAE;IACjD,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE;CAC7B,CAAC;AAEF,MAAM,cAAc,GAAgB;IAClC,EAAE,IAAI,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;IAC3D,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE;CACzC,CAAC;AAEF,MAAM,eAAe,GAAgB;IACnC,EAAE,IAAI,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;IAC/C,EAAE,IAAI,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;IAC/D,EAAE,IAAI,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,EAAE;CACjC,CAAC;AAEF,MAAM,mBAAmB,GAAgB;IACvC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE;IACrB,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;CAC5B,CAAC;AAEF,MAAM,kBAAkB,GAAgB;IACtC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;CAC5B,CAAC;AAEF,MAAM,UAAU,gCAAgC;IAC9C,OAAO;QACL,IAAI,EAAE,gCAAgC;QACtC,UAAU,EAAE,aAAa;QACzB,OAAO,EAAE,UAAU;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC;IAClD,OAAO;QACL,IAAI,EAAE,oCAAoC;QAC1C,UAAU,EAAE,iBAAiB;QAC7B,OAAO,EAAE,cAAc;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC;IACnD,OAAO;QACL,IAAI,EAAE,qCAAqC;QAC3C,UAAU,EAAE,kBAAkB;QAC9B,OAAO,EAAE,eAAe;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,OAAO;QACL,IAAI,EAAE,iCAAiC;QACvC,UAAU,EAAE,gBAAgB;QAC5B,OAAO,EAAE,mBAAmB;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC;IAC9C,OAAO;QACL,IAAI,EAAE,gCAAgC;QACtC,UAAU,EAAE,eAAe;QAC3B,OAAO,EAAE,kBAAkB;KAC5B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kCAAkC;IAChD,OAAO;QACL,gCAAgC,EAAE;QAClC,oCAAoC,EAAE;QACtC,qCAAqC,EAAE;KACxC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC;IAC9C,OAAO,CAAC,iCAAiC,EAAE,EAAE,gCAAgC,EAAE,CAAC,CAAC;AACnF,CAAC"}