@exellix/exellix-runtime 3.5.1

package/dist/execution-matrix/graph-operational-lifecycle.js

@@ -0,0 +1,88 @@
+import { ExecutionMatrixCatalogValidationError } from './catalox-loader.js';
+import { DEFAULT_GRAPH_OPERATIONAL_STATE, DEFAULT_GRAPH_PUBLICATION_STATUS, GRAPH_OPERATIONAL_STATES, GRAPH_PUBLICATION_STATUSES, } from './contracts.js';
+export class GraphNotSchedulableError extends Error {
+    graphId;
+    publicationStatus;
+    operationalState;
+    constructor(message, graphId, publicationStatus, operationalState) {
+        super(message);
+        this.graphId = graphId;
+        this.publicationStatus = publicationStatus;
+        this.operationalState = operationalState;
+        this.name = 'GraphNotSchedulableError';
+    }
+}
+function isPublicationStatus(v) {
+    return typeof v === 'string' && GRAPH_PUBLICATION_STATUSES.includes(v);
+}
+function isOperationalState(v) {
+    return typeof v === 'string' && GRAPH_OPERATIONAL_STATES.includes(v);
+}
+/**
+ * Effective publication / operational values for a graph config row (fills legacy omissions).
+ */
+export function resolveGraphConfigOperationalView(record) {
+    const publicationStatus = record.publicationStatus ?? DEFAULT_GRAPH_PUBLICATION_STATUS;
+    const operationalState = record.operationalState ?? DEFAULT_GRAPH_OPERATIONAL_STATE;
+    return { publicationStatus, operationalState };
+}
+/**
+ * Throws when the graph must not be claimed or executed by workers (Draft/Archived, or NotOperational).
+ * {@link GraphOperationalState} `Ready` and `Running` are both schedulable when publication is `Published`.
+ */
+export function assertGraphSchedulable(record) {
+    const { publicationStatus, operationalState } = resolveGraphConfigOperationalView(record);
+    const gid = record.graphId;
+    if (publicationStatus !== 'Published') {
+        throw new GraphNotSchedulableError(`Graph '${gid}' is not schedulable: publicationStatus is '${publicationStatus}' (expected 'Published')`, gid, publicationStatus, operationalState);
+    }
+    if (operationalState !== 'Ready' && operationalState !== 'Running') {
+        throw new GraphNotSchedulableError(`Graph '${gid}' is not schedulable: operationalState is '${operationalState}' (expected 'Ready' or 'Running')`, gid, publicationStatus, operationalState);
+    }
+}
+/**
+ * Validates merged publication + operational fields before persist.
+ *
+ * @param prevEffective — previous effective view (after {@link resolveGraphConfigOperationalView}); omit on create.
+ */
+export function validateGraphOperationalFields(next, prevEffective) {
+    const issues = [];
+    if (!isPublicationStatus(next.publicationStatus)) {
+        issues.push(`invalid publicationStatus: ${JSON.stringify(next.publicationStatus)}`);
+    }
+    if (!isOperationalState(next.operationalState)) {
+        issues.push(`invalid operationalState: ${JSON.stringify(next.operationalState)}`);
+    }
+    if (issues.length) {
+        throw new ExecutionMatrixCatalogValidationError('Invalid graph operational fields', issues);
+    }
+    const pub = next.publicationStatus;
+    const op = next.operationalState;
+    if (pub === 'Draft' || pub === 'Archived') {
+        if (op !== 'NotOperational') {
+            issues.push(`publicationStatus '${pub}' requires operationalState 'NotOperational' (got '${op}')`);
+        }
+    }
+    if (op === 'Ready' || op === 'Running') {
+        if (pub !== 'Published') {
+            issues.push(`operationalState '${op}' requires publicationStatus 'Published' (got '${pub}')`);
+        }
+    }
+    if (prevEffective && prevEffective.publicationStatus === 'Archived' && pub === 'Published') {
+        issues.push('cannot transition publicationStatus from Archived to Published (set Draft first)');
+    }
+    if (issues.length) {
+        throw new ExecutionMatrixCatalogValidationError('Invalid graph operational combination', issues);
+    }
+}
+/**
+ * Merges partial write input with current record defaults and runs {@link validateGraphOperationalFields}.
+ */
+export function mergeAndValidateGraphOperationalUpdate(cur, patch) {
+    const prev = resolveGraphConfigOperationalView(cur);
+    const publicationStatus = patch.publicationStatus ?? prev.publicationStatus;
+    const operationalState = patch.operationalState ?? prev.operationalState;
+    validateGraphOperationalFields({ publicationStatus, operationalState }, prev);
+    return { publicationStatus, operationalState };
+}
+//# sourceMappingURL=graph-operational-lifecycle.js.map

package/dist/execution-matrix/graph-operational-lifecycle.js.map

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

package/dist/execution-matrix/graph-operational.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=graph-operational.spec.d.ts.map

package/dist/execution-matrix/graph-operational.spec.d.ts.map

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

package/dist/execution-matrix/graph-operational.spec.js

@@ -0,0 +1,203 @@
+import { describe, expect, it, vi } from 'vitest';
+import { ExecutionMatrixCatalogValidationError } from './catalox-loader.js';
+import { MATRIX_FAILURE_PK, MATRIX_ROW_PK } from './constants.js';
+import { createExellixConfigStore } from './config-store.js';
+import { assertSafeInputGroupByPath, fetchGraphOperationalDashboardSlice } from './graph-operational-aggregates.js';
+import { assertGraphSchedulable, GraphNotSchedulableError, validateGraphOperationalFields, } from './graph-operational-lifecycle.js';
+import { materializeExecutionMatrixRuntimeRows } from './materializer.js';
+import { MemoryMatrixCollection } from './memory-store.js';
+import { processMatrixGraphBatch, processNextMatrixClaim } from './orchestrator.js';
+import { createExecutionMatrixRuntime } from './runtime-store.js';
+const graphPayload = {
+    graphId: 'G1',
+    mappedInput: [{}],
+    execution: { priority: 1 },
+};
+const graphRecords = [graphPayload];
+const graphModel = {
+    id: 'G1',
+    response: { shape: { type: 'literal', value: {} } },
+    nodes: [],
+};
+describe('graph operational lifecycle', () => {
+    it('rejects Draft with Ready', () => {
+        expect(() => validateGraphOperationalFields({ publicationStatus: 'Draft', operationalState: 'Ready' })).toThrow(ExecutionMatrixCatalogValidationError);
+    });
+    it('accepts Published with Running', () => {
+        expect(() => validateGraphOperationalFields({ publicationStatus: 'Published', operationalState: 'Running' })).not.toThrow();
+    });
+    it('rejects Archived to Published transition', () => {
+        expect(() => validateGraphOperationalFields({ publicationStatus: 'Published', operationalState: 'NotOperational' }, { publicationStatus: 'Archived', operationalState: 'NotOperational' })).toThrow(ExecutionMatrixCatalogValidationError);
+    });
+    it('assertGraphSchedulable throws for Draft', () => {
+        expect(() => assertGraphSchedulable({
+            graphId: 'G1',
+            version: 1,
+            payload: graphPayload,
+            publicationStatus: 'Draft',
+            operationalState: 'NotOperational',
+            createdAt: 't',
+            updatedAt: 't',
+        })).toThrow(GraphNotSchedulableError);
+    });
+});
+describe('config store graph patchOperational', () => {
+    it('updates operationalState with concurrency', async () => {
+        const graphs = new MemoryMatrixCollection('graphId');
+        const matrices = new MemoryMatrixCollection('matrixCatalogId');
+        const store = createExellixConfigStore({ matrices: matrices.asCollection(), graphs: graphs.asCollection() });
+        await store.graphs.create({
+            graphId: 'G1',
+            payload: graphPayload,
+            publicationStatus: 'Published',
+            operationalState: 'NotOperational',
+        });
+        const v1 = await store.graphs.get('G1');
+        const v2 = await store.graphs.patchOperational({
+            graphId: 'G1',
+            expectedVersion: v1.version,
+            operationalState: 'Running',
+        });
+        expect(v2.operationalState).toBe('Running');
+        expect(v2.version).toBe(2);
+    });
+});
+describe('fetchGraphOperationalDashboardSlice', () => {
+    it('returns status histogram without group path', async () => {
+        const rows = new MemoryMatrixCollection(MATRIX_ROW_PK);
+        const fails = new MemoryMatrixCollection(MATRIX_FAILURE_PK);
+        const rt = createExecutionMatrixRuntime(rows.asCollection(), fails.asCollection(), { serializeClaims: true });
+        const [row] = materializeExecutionMatrixRuntimeRows({
+            matrixCatalogId: 'cat',
+            matrixItemId: 'item',
+            payload: { input: {}, graphs: ['G1'] },
+            graphRecords,
+            inputRows: [{}],
+        });
+        await rt.insertRuntimeRow(row);
+        const slice = await fetchGraphOperationalDashboardSlice({
+            runtime: rt,
+            loadGraphConfig: async () => ({
+                graphId: 'G1',
+                version: 3,
+                payload: graphPayload,
+                publicationStatus: 'Published',
+                operationalState: 'Running',
+                createdAt: 't',
+                updatedAt: 't',
+            }),
+        }, { matrixCatalogId: 'cat', graphId: 'G1' });
+        expect(slice.graphConfigFound).toBe(true);
+        expect(slice.publicationStatus).toBe('Published');
+        expect(slice.inputBuckets[0].key).toBe('_all');
+        expect(slice.inputBuckets[0].bySlotStatus['not-started']).toBe(1);
+        expect(slice.output.completedInferenceRows).toBe(0);
+    });
+    it('rejects unsafe inputGroupByPath', () => {
+        expect(() => assertSafeInputGroupByPath('a.$where')).toThrow(ExecutionMatrixCatalogValidationError);
+    });
+});
+describe('processNextMatrixClaim schedulability', () => {
+    it('throws when resolveGraphSchedulability returns Draft graph', async () => {
+        const rows = new MemoryMatrixCollection(MATRIX_ROW_PK);
+        const fails = new MemoryMatrixCollection(MATRIX_FAILURE_PK);
+        const rt = createExecutionMatrixRuntime(rows.asCollection(), fails.asCollection(), { serializeClaims: true });
+        const [row] = materializeExecutionMatrixRuntimeRows({
+            matrixCatalogId: 'cat',
+            matrixItemId: 'item',
+            payload: { input: {}, graphs: ['G1'] },
+            graphRecords,
+            inputRows: [{}],
+        });
+        await rt.insertRuntimeRow(row);
+        const executeGraph = vi.fn().mockResolvedValue({});
+        await expect(processNextMatrixClaim({
+            runtime: rt,
+            executeGraph,
+            graphModel,
+            resolveGraphSchedulability: async () => ({
+                graphId: 'G1',
+                version: 1,
+                payload: graphPayload,
+                publicationStatus: 'Draft',
+                operationalState: 'NotOperational',
+                createdAt: 't',
+                updatedAt: 't',
+            }),
+        }, { matrixCatalogId: 'cat', graphId: 'G1', jobId: 'j1' })).rejects.toThrow(GraphNotSchedulableError);
+        expect(executeGraph).not.toHaveBeenCalled();
+    });
+});
+describe('claimNextAcrossGraphs schedulability skip', () => {
+    it('skips non-schedulable graph id and claims the next', async () => {
+        const rows = new MemoryMatrixCollection(MATRIX_ROW_PK);
+        const fails = new MemoryMatrixCollection(MATRIX_FAILURE_PK);
+        const rt = createExecutionMatrixRuntime(rows.asCollection(), fails.asCollection(), { serializeClaims: true });
+        const g2 = { graphId: 'G2', mappedInput: [{}], execution: { priority: 2 } };
+        const [row] = materializeExecutionMatrixRuntimeRows({
+            matrixCatalogId: 'cat',
+            matrixItemId: 'item',
+            payload: { input: {}, graphs: ['G1', 'G2'] },
+            graphRecords: [graphPayload, g2],
+            inputRows: [{}],
+        });
+        await rt.insertRuntimeRow(row);
+        const executeGraph = vi.fn().mockResolvedValue({
+            status: 'completed',
+            jobId: 'm',
+            taskId: 't',
+            graphId: 'G2',
+            outputsByNodeId: {},
+            engineSnapshot: {},
+            finalOutput: {},
+        });
+        await processMatrixGraphBatch({
+            runtime: rt,
+            executeGraph,
+            resolveGraphModel: ({ graphId }) => ({ id: graphId, response: { shape: { type: 'literal', value: {} } }, nodes: [] }),
+            resolveGraphSchedulability: async (gid) => {
+                if (gid === 'G1') {
+                    return {
+                        graphId: 'G1',
+                        version: 1,
+                        payload: graphPayload,
+                        publicationStatus: 'Draft',
+                        operationalState: 'NotOperational',
+                        createdAt: 't',
+                        updatedAt: 't',
+                    };
+                }
+                return {
+                    graphId: 'G2',
+                    version: 1,
+                    payload: g2,
+                    publicationStatus: 'Published',
+                    operationalState: 'Running',
+                    createdAt: 't',
+                    updatedAt: 't',
+                };
+            },
+        }, { matrixCatalogId: 'cat', graphIds: ['G1', 'G2'], limit: 1 });
+        expect(executeGraph).toHaveBeenCalledTimes(1);
+        const call = executeGraph.mock.calls[0][0];
+        expect(call.model.id).toBe('G2');
+    });
+});
+describe('ExecutionMatrixRuntime.countRowsMatching', () => {
+    it('counts via MemoryMatrixCollection.countMatching', async () => {
+        const rows = new MemoryMatrixCollection(MATRIX_ROW_PK);
+        const fails = new MemoryMatrixCollection(MATRIX_FAILURE_PK);
+        const rt = createExecutionMatrixRuntime(rows.asCollection(), fails.asCollection(), { serializeClaims: true });
+        const [row] = materializeExecutionMatrixRuntimeRows({
+            matrixCatalogId: 'cat',
+            matrixItemId: 'item',
+            payload: { input: {}, graphs: ['G1'] },
+            graphRecords,
+            inputRows: [{}],
+        });
+        await rt.insertRuntimeRow(row);
+        const n = await rt.countRowsMatching({ matrixCatalogId: 'cat' });
+        expect(n).toBe(1);
+    });
+});
+//# sourceMappingURL=graph-operational.spec.js.map

package/dist/execution-matrix/graph-operational.spec.js.map

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

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

@@ -0,0 +1,73 @@
+export type { ExecuteGraphInput, ExecuteGraphResult, GraphExecutionRequest, GraphRuntimeObject, HostExecuteGraphRunOptions, } from '@exellix/graph-engine';
+/** Matrix → graph run wiring (same helpers as `@exellix/graph-engine` execution-matrix host module). */
+export { buildMatrixJobForGraphRun, buildStableMatrixJobId, createMatrixHostGraphExecutor, isExecuteGraphResultFailed, } from '@exellix/graph-engine';
+/** Tooling / tests: canonical MAIN `runTask` builder and strategy metadata extraction (`@exellix/ai-tasks` v7). */
+export { buildAiTasksRunTaskRequest, extractRunTaskStrategyOverrides, resolveJobTypeId, resolveTaskTypeId, runTaskResponseSucceeded, } from '@exellix/graph-engine';
+export type { BuildAiTasksRunTaskRequestArgs, ExellixGraphRunTaskRequest, ExellixGraphRunTaskResponse, } from '@exellix/graph-engine';
+/**
+ * Executable graph document model, root `response`, Layer 01 graph-entry metadata, and catalog-planning
+ * entry types. Same definitions as `@exellix/graph-engine` — see [docs/format](../../docs/format).
+ */
+export type { Graph, GraphModelObject, GraphAiModelConfig, GraphModelAliasConfig, GraphRuntimeNodeConfig, TaskNodeRuntimeObject, GraphDocumentMetadata, GraphEntryContract, GraphEntryExecutionInputSpec, GraphEntryInputKind, GraphEntryInputSpecBase, GraphEntryInputSpec, GraphEntryValueInputKind, GraphEntryValueInputSpec, GraphResponseDefinition, GraphResponseMissingBehavior, GraphResponseSelector, GraphResponseShape, GraphResponseContract, GraphNode, TaskNode, TaskNodePureMetadata, TaskNodeExecutionPipelineStep, TaskOutputValidation, FinalizerNode, FinalizerInputBinding, OutputSchema, AggregateFinalizerConfig, BundleFinalizerConfig, SelectFinalizerConfig, SynthesizeFinalizerConfig, UtilityExecutionPolicy, GraphExecutionDefaults, GraphExecutionMode, GraphOutputMode, Job, CatalogPlanningKind, CatalogRequestStatus, CatalogBinding, ScopedQuestionCatalogRequestEntry, DiscoveryDefinitionCatalogRequestEntry, DiscoveryDefinitionCatalogRequest, DiscoveryDefinitionPlanningFields, CatalogRequestEntry, } from '@exellix/graph-engine';
+export { getTaskConfiguration } from '@exellix/graph-engine';
+export type { TaskNodeTaskConfiguration } from '@exellix/graph-engine';
+/** Canonical graph JSON root checks and document-model merge — use before persist or CI. */
+export { mergeGraphDocumentModel, EXELLIX_GRAPH_MODEL_VARIABLE_KEY, assertCanonicalGraphDocument, getCanonicalGraphDocumentViolations, CANONICAL_GRAPH_TOP_LEVEL_KEYS, validateCatalogPlanning, isCatalogBinding, isCatalogRequestEntry, ExellixGraphError, ExellixGraphErrorCode, } from '@exellix/graph-engine';
+/** Layer-01 helpers and types — same behavior as `@exellix/graph-engine` execution-matrix host module. */
+export { validateExecutionSeedPaths, resolveGraphEntryFromGraph, createResolveGraphEntryFromLoader, } from '@exellix/graph-engine';
+export type { BuildExecutionSeedSources, BuildExecutionSeedResult } from '@exellix/graph-engine';
+/** Structured `conditions.dataFilters` evaluation — same exports as `@exellix/graph-engine` ≥ 5.3.8. */
+export { evaluateStructuredDataFilters, evaluateDataFilterPredicate, getStructuredDataFilterPathViolations, isStructuredDataFiltersV1, EXELLIX_STRUCTURED_DATA_FILTERS_V1, } from '@exellix/graph-engine';
+export type { EvaluateStructuredDataFiltersResult, EvaluateStructuredDataFiltersOptions, StructuredDataFiltersV1, ConditionsDataFilters, } from '@exellix/graph-engine';
+export * from './contracts.js';
+export * from './constants.js';
+export * from './status.js';
+export * from './collections.js';
+export * from './runtime-store.js';
+export { createExellixMatrixDataTier, resolveExellixMatrixDataTierOptions, type CreateExellixMatrixDataTierOptions, type ExellixMatrixDataTier, type ExellixMatrixDataTierProbe, type ExellixMatrixPersistenceCollection, type ResolvedExellixMatrixDataTierOptions, } from './matrix-data-tier.js';
+export { createMatrixReadTierFromDataTier, openMatrixReadTier, type MatrixReadTier, type OpenMatrixReadTierOptions, } from './matrix-read-tier.js';
+export * from './memory-store.js';
+export * from './catalox-loader.js';
+export * from './catalox-matrix-host.js';
+export * from './materializer.js';
+export * from './graph-entry-xmemory-load.js';
+export * from './orchestrator.js';
+export { createExecutionMatrixClaimPauseController, type ExecutionMatrixClaimPauseController, } from './execution-matrix-claim-pause.js';
+export * from './navigator.js';
+export { formatCataloxExecutionMatrixInventoryMarkdown, runCataloxExecutionMatrixInventory, } from '../catalox-inventory/catalox-execution-matrix-inventory.js';
+export { buildExtendedScopedDataEntityTypeFilter, collectScopedDataEntityTypeDiscovery, collectScopedDataEntityTypeKeys, DEFAULT_ENTITY_DISCOVERY_SCOPED_DATA_GROUP_PATHS, driverBackedMongoClientForXmemoryCli, entityTypeKeyFromCatalogItem, formatCataloxXmemoryEntityCountMarkdown, normalizeEntityReportCatalogIds, parseTierDiscoveryGroupPathsCsv, runCataloxXmemoryEntityCountReport, runScopedDataEntityTypeDiscoveryReport, SCOPED_DATA_TIER_ENTITY_DISCOVERY_CATALOG_ID, } from '../catalox-inventory/catalox-xmemory-entity-count-report.js';
+export type { CataloxXmemoryEntityCountReport, CataloxXmemoryEntityCountRow, CataloxXmemoryEntityMatrixSlice, CataloxXmemoryEntitySurfaceCounts, CollectScopedDataEntityTypeDiscoveryOptions, RunCataloxXmemoryEntityCountReportOptions, ScopedDataTierEntityTypeDiscovery, TierDiscoveryDiagnostics, } from '../catalox-inventory/catalox-xmemory-entity-count-report.js';
+export type { CataloxExecutionMatrixInventoryReport, CataloxInventoryGraphRow, CataloxInventoryItemIssue, CataloxInventoryMatrixRow, RunCataloxExecutionMatrixInventoryOptions, } from '../catalox-inventory/catalox-execution-matrix-inventory.js';
+export { buildExellixRuntimeRealLivenessPayload, EXELLIX_RUNTIME_REAL_HEALTH_PATH, readExellixRuntimeHealthPackageVersions, redactMongoUriForDiagnostics, runExellixRuntimeConnectivityProbe, } from './runtime-connectivity-health.js';
+export type { ExellixRuntimeConnectivityProbeOptions, ExellixRuntimeHealthConfigMongoLane, ExellixRuntimeHealthExecutionMongoLane, ExellixRuntimeHealthLaneBase, ExellixRuntimeHealthLanes, ExellixRuntimeHealthPackages, ExellixRuntimeHealthPayload, ExellixRuntimeHealthSchedulerLane, ExellixRuntimeHealthXmemoryLane, } from './runtime-connectivity-health.js';
+export * from './runtime-objects.js';
+export * from './matrix-logxer.js';
+export * from './matrix-activix.js';
+export * from './data-source.js';
+export * from './execution-mode.js';
+export * from './eligibility.js';
+export * from './records-eligibility.js';
+export * from './snapshot-runner.js';
+export * from './source-resolver.js';
+export * from './source-resolver-factories.js';
+export * from './matrix-execute-graph-adapter.js';
+export * from './run-loop.js';
+export * from './config-store.js';
+/** High-level host helpers: link graph → matrix, materialize rows, open Mongo bundle. */
+export * from '../client-toolbox/index.js';
+export * from './graph-operational-lifecycle.js';
+export * from './graph-operational-aggregates.js';
+export * from './xmemory-entity-collections.js';
+export * from './xmemory-op-tier.js';
+export * from './memorix-entity-type-helpers.js';
+export * from './memorix-matrix-entity-facet.js';
+export * from './memorix-inference-persister.js';
+export * from './memorix-runtime-tier.js';
+export { buildDatePresetMatches, buildEntityTypeStatisticsFacetPipeline, buildTierFetchMatch, clearTierFetchCaches, clearTierFilterCatalogCache, clearTierStatisticsCache, countScopedDataDocuments, createScoperMongoClient, DEFAULT_ENTITY_TYPE_PATHS, DEFAULT_ENTITY_TYPES_LIMIT, DEFAULT_ENTITY_TYPES_SKIP, ENTITY_TYPES_LIMIT_MAX, ENV_KEYS, getMemorixTierStatistics, getScoperStoreBindings, getTierFilterCatalog, getXmemoryTierStatistics, parseEntityTypeFacetRow, pickEntityContentTypeCount, resolveSurfaceDbCollection, stableScopeKey, TIER_DATE_PRESET_IDS, TIER_DATE_PRESET_METAS, TIER_FACET_DIMENSIONS, TIER_OBSERVED_FIELD_PATHS, TIER_STATS_MISSING_TYPE, typeBucketExpr, withEnrichmentFallback, } from './memorix-tier-statistics.js';
+export type { GetMemorixTierStatisticsOptions, MemorixTierStatistics, TierCatalogEntityType, TierCatalogFacet, TierFetchScope, TierFilterCatalog, TierFilterSurface, TierObservedField, TierSurfaceStatisticsSection, } from './memorix-tier-statistics.js';
+export type { CreateMemorixRuntimeTierOptions, CreateXmemoryDataTierOptions, MemorixMongoClient, MemorixRuntimeTier, MemorixRuntimeTierEnv, XmemoryDataTier, XmemoryMongoClient, } from './memorix-runtime-tier.js';
+export { createMemorixRuntimeTier, createXmemoryDataTier, resolveMemorixRuntimeTierEnv, resolveXmemoryStoreEnv, } from './memorix-runtime-tier.js';
+/** `@x12i/memorix-retrieval` — item/list reads and env helpers (prefer importing from here for one surface). */
+export { applyMemorixEnvBridgeToProcess, createMemorixRetrievalFromEnv, createMemorixRetrievalStackFromEnv, fetchMemorixItem, fetchMemorixList, resolveMemorixDbName, } from '@x12i/memorix-retrieval';
+export type { FetchMemorixItemRequest, FetchMemorixItemResponse, MemorixRetrievalClient, } from '@x12i/memorix-retrieval';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/execution-matrix/index.js

@@ -0,0 +1,57 @@
+/** Matrix → graph run wiring (same helpers as `@exellix/graph-engine` execution-matrix host module). */
+export { buildMatrixJobForGraphRun, buildStableMatrixJobId, createMatrixHostGraphExecutor, isExecuteGraphResultFailed, } from '@exellix/graph-engine';
+/** Tooling / tests: canonical MAIN `runTask` builder and strategy metadata extraction (`@exellix/ai-tasks` v7). */
+export { buildAiTasksRunTaskRequest, extractRunTaskStrategyOverrides, resolveJobTypeId, resolveTaskTypeId, runTaskResponseSucceeded, } from '@exellix/graph-engine';
+export { getTaskConfiguration } from '@exellix/graph-engine';
+/** Canonical graph JSON root checks and document-model merge — use before persist or CI. */
+export { mergeGraphDocumentModel, EXELLIX_GRAPH_MODEL_VARIABLE_KEY, assertCanonicalGraphDocument, getCanonicalGraphDocumentViolations, CANONICAL_GRAPH_TOP_LEVEL_KEYS, validateCatalogPlanning, isCatalogBinding, isCatalogRequestEntry, ExellixGraphError, ExellixGraphErrorCode, } from '@exellix/graph-engine';
+/** Layer-01 helpers and types — same behavior as `@exellix/graph-engine` execution-matrix host module. */
+export { validateExecutionSeedPaths, resolveGraphEntryFromGraph, createResolveGraphEntryFromLoader, } from '@exellix/graph-engine';
+/** Structured `conditions.dataFilters` evaluation — same exports as `@exellix/graph-engine` ≥ 5.3.8. */
+export { evaluateStructuredDataFilters, evaluateDataFilterPredicate, getStructuredDataFilterPathViolations, isStructuredDataFiltersV1, EXELLIX_STRUCTURED_DATA_FILTERS_V1, } from '@exellix/graph-engine';
+export * from './contracts.js';
+export * from './constants.js';
+export * from './status.js';
+export * from './collections.js';
+export * from './runtime-store.js';
+export { createExellixMatrixDataTier, resolveExellixMatrixDataTierOptions, } from './matrix-data-tier.js';
+export { createMatrixReadTierFromDataTier, openMatrixReadTier, } from './matrix-read-tier.js';
+export * from './memory-store.js';
+export * from './catalox-loader.js';
+export * from './catalox-matrix-host.js';
+export * from './materializer.js';
+export * from './graph-entry-xmemory-load.js';
+export * from './orchestrator.js';
+export { createExecutionMatrixClaimPauseController, } from './execution-matrix-claim-pause.js';
+export * from './navigator.js';
+export { formatCataloxExecutionMatrixInventoryMarkdown, runCataloxExecutionMatrixInventory, } from '../catalox-inventory/catalox-execution-matrix-inventory.js';
+export { buildExtendedScopedDataEntityTypeFilter, collectScopedDataEntityTypeDiscovery, collectScopedDataEntityTypeKeys, DEFAULT_ENTITY_DISCOVERY_SCOPED_DATA_GROUP_PATHS, driverBackedMongoClientForXmemoryCli, entityTypeKeyFromCatalogItem, formatCataloxXmemoryEntityCountMarkdown, normalizeEntityReportCatalogIds, parseTierDiscoveryGroupPathsCsv, runCataloxXmemoryEntityCountReport, runScopedDataEntityTypeDiscoveryReport, SCOPED_DATA_TIER_ENTITY_DISCOVERY_CATALOG_ID, } from '../catalox-inventory/catalox-xmemory-entity-count-report.js';
+export { buildExellixRuntimeRealLivenessPayload, EXELLIX_RUNTIME_REAL_HEALTH_PATH, readExellixRuntimeHealthPackageVersions, redactMongoUriForDiagnostics, runExellixRuntimeConnectivityProbe, } from './runtime-connectivity-health.js';
+export * from './runtime-objects.js';
+export * from './matrix-logxer.js';
+export * from './matrix-activix.js';
+export * from './data-source.js';
+export * from './execution-mode.js';
+export * from './eligibility.js';
+export * from './records-eligibility.js';
+export * from './snapshot-runner.js';
+export * from './source-resolver.js';
+export * from './source-resolver-factories.js';
+export * from './matrix-execute-graph-adapter.js';
+export * from './run-loop.js';
+export * from './config-store.js';
+/** High-level host helpers: link graph → matrix, materialize rows, open Mongo bundle. */
+export * from '../client-toolbox/index.js';
+export * from './graph-operational-lifecycle.js';
+export * from './graph-operational-aggregates.js';
+export * from './xmemory-entity-collections.js';
+export * from './xmemory-op-tier.js';
+export * from './memorix-entity-type-helpers.js';
+export * from './memorix-matrix-entity-facet.js';
+export * from './memorix-inference-persister.js';
+export * from './memorix-runtime-tier.js';
+export { buildDatePresetMatches, buildEntityTypeStatisticsFacetPipeline, buildTierFetchMatch, clearTierFetchCaches, clearTierFilterCatalogCache, clearTierStatisticsCache, countScopedDataDocuments, createScoperMongoClient, DEFAULT_ENTITY_TYPE_PATHS, DEFAULT_ENTITY_TYPES_LIMIT, DEFAULT_ENTITY_TYPES_SKIP, ENTITY_TYPES_LIMIT_MAX, ENV_KEYS, getMemorixTierStatistics, getScoperStoreBindings, getTierFilterCatalog, getXmemoryTierStatistics, parseEntityTypeFacetRow, pickEntityContentTypeCount, resolveSurfaceDbCollection, stableScopeKey, TIER_DATE_PRESET_IDS, TIER_DATE_PRESET_METAS, TIER_FACET_DIMENSIONS, TIER_OBSERVED_FIELD_PATHS, TIER_STATS_MISSING_TYPE, typeBucketExpr, withEnrichmentFallback, } from './memorix-tier-statistics.js';
+export { createMemorixRuntimeTier, createXmemoryDataTier, resolveMemorixRuntimeTierEnv, resolveXmemoryStoreEnv, } from './memorix-runtime-tier.js';
+/** `@x12i/memorix-retrieval` — item/list reads and env helpers (prefer importing from here for one surface). */
+export { applyMemorixEnvBridgeToProcess, createMemorixRetrievalFromEnv, createMemorixRetrievalStackFromEnv, fetchMemorixItem, fetchMemorixList, resolveMemorixDbName, } from '@x12i/memorix-retrieval';
+//# sourceMappingURL=index.js.map

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

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

package/dist/execution-matrix/live-tier-open.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Repo-local alias for {@link openMatrixClientBundle} (live tests, legacy imports).
+ * Prefer `openMatrixClientBundle` from `@exellix/exellix-runtime`.
+ */
+export { openMatrixClientBundle as openLiveMatrixFromDataTier, type MatrixClientBundle as LiveMatrixTierBundle, } from '../client-toolbox/bundle.js';
+//# sourceMappingURL=live-tier-open.d.ts.map

package/dist/execution-matrix/live-tier-open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-tier-open.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/live-tier-open.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,sBAAsB,IAAI,0BAA0B,EACpD,KAAK,kBAAkB,IAAI,oBAAoB,GAChD,MAAM,6BAA6B,CAAC"}

package/dist/execution-matrix/live-tier-open.js

@@ -0,0 +1,6 @@
+/**
+ * Repo-local alias for {@link openMatrixClientBundle} (live tests, legacy imports).
+ * Prefer `openMatrixClientBundle` from `@exellix/exellix-runtime`.
+ */
+export { openMatrixClientBundle as openLiveMatrixFromDataTier, } from '../client-toolbox/bundle.js';
+//# sourceMappingURL=live-tier-open.js.map

package/dist/execution-matrix/live-tier-open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-tier-open.js","sourceRoot":"","sources":["../../src/execution-matrix/live-tier-open.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,sBAAsB,IAAI,0BAA0B,GAErD,MAAM,6BAA6B,CAAC"}

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

@@ -0,0 +1,99 @@
+import { type GraphEntryContract } from '@exellix/graph-engine';
+import { type ExecutionMatrixCatalogPayload, type ExecutionMatrixGraphCatalogRecord, type ExecutionMatrixMappedInputEntry, type ExecutionMatrixSnapshotRecord } from './contracts.js';
+import type { ExecutionMatrixRuntimeRecord } from './contracts.js';
+/** Shallow-merge mapped input entries in array order (host-defined keys per entry). */
+export declare function mergeMappedInputEntries(entries: ExecutionMatrixMappedInputEntry[]): Record<string, unknown>;
+/**
+ * Order graph catalog records for a matrix: filter to `matrixGraphIds`, then sort by
+ * `execution.priority` ascending; ties break by first occurrence in `matrixGraphIds`.
+ */
+export declare function sortGraphRecordsForMatrix(matrixGraphIds: string[], graphRecords: ExecutionMatrixGraphCatalogRecord[]): ExecutionMatrixGraphCatalogRecord[];
+/**
+ * Build the graph-engine `execution` seed from `metadata.graphEntry.inputs` (value kinds only).
+ *
+ * Delegates to `@exellix/graph-engine` `buildExecutionSeedFromGraphEntry` so path handling matches
+ * Layer-01 (`GraphEntryValueInputSpec.path` under merged `execution`, flat `input.*` only — no `input.raw`).
+ * Matrix rows expose work-unit fields on {@link ExecutionMatrixRuntimeRecord.input}; at claim time the orchestrator
+ * sets `runtime.input = record.input` (canonical host slot). This helper optionally aligns `executionMemory` via
+ * `layers: [{ input: inputRow }]`. `kind: "execution"` specs are skipped — resolve prior runs in the host.
+ */
+export declare function buildExecutionSeedFromGraphEntry(graphEntry: GraphEntryContract | undefined, inputRow: Record<string, unknown>): Record<string, unknown>;
+export type MaterializeRowsInput = {
+    matrixCatalogId: string;
+    matrixItemId: string;
+    matrixRunId?: string;
+    payload: ExecutionMatrixCatalogPayload;
+    /**
+     * Graph definitions from the graphs catalog (e.g. `exellix-graphs`), one per id in `payload.graphs`.
+     */
+    graphRecords: ExecutionMatrixGraphCatalogRecord[];
+    /** One runtime row per entry (e.g. entities to run the matrix against). */
+    inputRows: Array<Record<string, unknown>>;
+    /**
+     * Optional tenant / partition / scope fields merged **onto each row `input`** after `payload.input` and the
+     * resolved row (same object should be passed to {@link resolveInputRowsWithResolver} for xmemory and to
+     * orchestration `runtimeScope` so `extraFilter` on claims matches, e.g. `{ "input.tenantId": "acme" }`).
+     */
+    runtimeScope?: Record<string, unknown>;
+};
+export declare function materializeExecutionMatrixRuntimeRows(input: MaterializeRowsInput): ExecutionMatrixRuntimeRecord[];
+/**
+ * Optional hook for resolving input rows from xmemory (scoper, things, scoped views).
+ * Implement in the product host; default stub returns an empty list.
+ * When {@link MaterializeRowsInput.runtimeScope} is used, pass the **same** object as `runtimeScope` here so
+ * xmemory queries are scoped consistently with materialized rows and claim `extraFilter`.
+ */
+export type XmemoryInputResolver = (selector: Record<string, unknown>, runtimeScope?: Record<string, unknown>) => Promise<Array<Record<string, unknown>>>;
+export declare function resolveInputRowsWithResolver(selector: Record<string, unknown>, resolver?: XmemoryInputResolver, runtimeScope?: Record<string, unknown>): Promise<Array<Record<string, unknown>>>;
+/**
+ * Split `inputRows` into chunks of `recordsPerRun`. When `recordsPerRun <= 1` the input is
+ * returned as a list of singletons (one chunk per row), preserving legacy semantics.
+ *
+ * `idExtractor` is used to lift a stable `sourceId` per record when present (e.g. xmemory id).
+ */
+export declare function chunkInputRowsForBatch<TRow extends Record<string, unknown>>(rows: ReadonlyArray<TRow>, recordsPerRun: number, idExtractor?: (row: TRow) => string | undefined): Array<{
+    records: TRow[];
+    sourceIds: string[];
+}>;
+export type MaterializeBatchedRowsInput = {
+    matrixCatalogId: string;
+    matrixItemId: string;
+    matrixRunId?: string;
+    payload: ExecutionMatrixCatalogPayload;
+    graphRecords: ExecutionMatrixGraphCatalogRecord[];
+    /** Source records to bundle into chunks. */
+    inputRows: Array<Record<string, unknown>>;
+    /** Bundle size; when omitted/<=1 falls back to one row per source record. */
+    recordsPerRun?: number;
+    /** Optional id extractor used when bundling. */
+    sourceIdOf?: (row: Record<string, unknown>) => string | undefined;
+    runtimeScope?: Record<string, unknown>;
+};
+/**
+ * Materialize runtime rows where each row carries `input.records: TRow[]` and `input.sourceIds: string[]`,
+ * the standardized shape produced by the `record` data-source kind with `recordsPerRun > 1`.
+ *
+ * When `recordsPerRun <= 1` this delegates to {@link materializeExecutionMatrixRuntimeRows} so callers
+ * always get one materializer entry point.
+ */
+export declare function materializeBatchedRecordRows(input: MaterializeBatchedRowsInput): ExecutionMatrixRuntimeRecord[];
+export type MaterializeFromSnapshotInput = {
+    matrixCatalogId: string;
+    matrixItemId: string;
+    matrixRunId?: string;
+    payload: ExecutionMatrixCatalogPayload;
+    graphRecords: ExecutionMatrixGraphCatalogRecord[];
+    snapshot: ExecutionMatrixSnapshotRecord;
+    /** `'one-row'` (default) emits a single row whose `input.snapshotId` references the snapshot.
+     *  `'expand'` requires `snapshot.payload` to be an array; emits one row per top-level entry. */
+    materialize?: 'one-row' | 'expand';
+    runtimeScope?: Record<string, unknown>;
+};
+/**
+ * Convert a persisted snapshot into runtime rows.
+ *
+ * Each emitted row stores `input.snapshotId` pointing back to the snapshot document so the graph
+ * can re-read the payload at execution time without re-running the transform.
+ */
+export declare function materializeFromSnapshot(input: MaterializeFromSnapshotInput): ExecutionMatrixRuntimeRecord[];
+//# sourceMappingURL=materializer.d.ts.map

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

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