@exellix/exellix-runtime 3.5.1

package/dist/execution-matrix/graph-entry-xmemory-load.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Load Memorix entity payloads for graph Layer-01 materialization via **`@x12i/memorix-retrieval`**
+ * (`fetchMemorixItem`). Replaces legacy `@x12i/xmemory-scoper` / `xmemory-op` reads.
+ */
+import { type BuildExecutionSeedResult, type BuildExecutionSeedSources, type GraphEntryContract } from '@exellix/graph-engine';
+import { type FetchMemorixItemResponse, type MemorixRetrievalClient } from '@x12i/memorix-retrieval';
+/** Stable codes for BFF / CI (do not throw for expected misses). */
+export declare const GraphEntryXmemoryLoadCodes: {
+    readonly INVALID_INPUT: "INVALID_INPUT";
+    readonly MISSING_ENTITY_ID: "MISSING_ENTITY_ID";
+    readonly MISSING_ITEM_DESCRIPTOR_ID: "MISSING_ITEM_DESCRIPTOR_ID";
+    readonly MEMORIX_ITEM_NOT_FOUND: "MEMORIX_ITEM_NOT_FOUND";
+    readonly MEMORIX_ITEM_EMPTY: "MEMORIX_ITEM_EMPTY";
+    /** Legacy modes removed with xmemory-scoper. */
+    readonly LEGACY_MODE_REMOVED: "LEGACY_MODE_REMOVED";
+    readonly MISSING_ENTITY_ID_LEGACY: "MISSING_ENTITY_ID";
+    readonly MISSING_QUESTION_ID: "MISSING_QUESTION_ID";
+    readonly MISSING_QUESTION: "MISSING_QUESTION";
+    readonly MISSING_ABOUT: "MISSING_ABOUT";
+    readonly MISSING_EXTENDED_DEPS: "MISSING_EXTENDED_DEPS";
+    readonly MEMORIX_ENTITY_RESOLUTION_FAILED: "MEMORIX_ENTITY_RESOLUTION_FAILED";
+    readonly SCOPED_DATA_NOT_FOUND: "SCOPED_DATA_NOT_FOUND";
+    readonly SCOPED_DATA_AMBIGUOUS: "SCOPED_DATA_AMBIGUOUS";
+    readonly MISSING_SCOPED_DATA_KEY: "MISSING_SCOPED_DATA_KEY";
+    readonly MISSING_ENTITY_TYPE: "MISSING_ENTITY_TYPE";
+    readonly NARRATIVE_NOT_FOUND: "NARRATIVE_NOT_FOUND";
+};
+export type GraphEntryXmemoryLoadCode = (typeof GraphEntryXmemoryLoadCodes)[keyof typeof GraphEntryXmemoryLoadCodes];
+export type GraphEntryXmemoryLoadDeps = {
+    client: MemorixRetrievalClient;
+};
+/** Optional keys under `input.*` for the memorix merge layer (second layer after matrix row). */
+export type GraphEntryMemorixInputKeys = {
+    scopedDataInputKey?: string;
+    narrativeInputKey?: string;
+    snapshotInputKey?: string;
+    memorixItemInputKey?: string;
+};
+export type GraphEntryXmemoryLoadRequestMemorixItem = {
+    mode: 'memorix-item';
+    itemDescriptorId: string;
+    entityId: string;
+    eventId?: string;
+    knowledgeId?: string;
+} & GraphEntryMemorixInputKeys;
+/** @deprecated Use {@link GraphEntryXmemoryLoadRequestMemorixItem}. */
+export type GraphEntryXmemoryLoadRequestScopedData = {
+    mode: 'scoped-data-row';
+    entityId: string;
+    questionId: string;
+    memorixCatalogEntityName?: string;
+    xScopedDataCollection?: string;
+} & GraphEntryMemorixInputKeys;
+/** @deprecated Use {@link GraphEntryXmemoryLoadRequestMemorixItem}. */
+export type GraphEntryXmemoryLoadRequestScopedDataBySourceKey = {
+    mode: 'scoped-data-by-source-key';
+    entityType?: string;
+    memorixCatalogEntityName?: string;
+    sourceId?: string;
+    metaSourceId?: string;
+    documentId?: string;
+    xScopedDataCollection?: string;
+    onMultiple?: 'first' | 'error';
+    projection?: Record<string, unknown>;
+} & GraphEntryMemorixInputKeys;
+/** @deprecated Removed with xmemory-scoper. */
+export type GraphEntryXmemoryLoadRequestNarrative = {
+    mode: 'narrative';
+    question: string;
+    about: string;
+    namespace?: string;
+    useExtendedContext?: boolean;
+    includeLinked?: boolean;
+    includeTriageAdjacentThings?: boolean;
+    adjacentThingsMaxAgeMs?: number;
+} & GraphEntryMemorixInputKeys;
+/** @deprecated Removed with xmemory-scoper. */
+export type GraphEntryXmemoryLoadRequestSnapshot = {
+    mode: 'snapshot-scoped-data';
+    snapshotData: Record<string, unknown>;
+    snapshotCollection: string;
+    scopingMap: {
+        questionTitle: string;
+        [key: string]: unknown;
+    };
+    fieldMetaCache: Map<string, unknown>;
+    snapshotOptions?: Record<string, unknown>;
+} & GraphEntryMemorixInputKeys;
+export type GraphEntryXmemoryLoadRequest = GraphEntryXmemoryLoadRequestMemorixItem | GraphEntryXmemoryLoadRequestScopedData | GraphEntryXmemoryLoadRequestScopedDataBySourceKey | GraphEntryXmemoryLoadRequestNarrative | GraphEntryXmemoryLoadRequestSnapshot;
+export type GraphEntryXmemoryLoadSuccess = {
+    ok: true;
+    memorixItem?: FetchMemorixItemResponse;
+    scopedDataRow?: Record<string, unknown>;
+    seedSources: BuildExecutionSeedSources;
+    memorixResolution?: {
+        ok: boolean;
+        message?: string;
+    };
+    narrative?: unknown;
+    snapshot?: unknown;
+    lookupMatches?: unknown[];
+};
+export type GraphEntryXmemoryLoadFailure = {
+    ok: false;
+    code: GraphEntryXmemoryLoadCode;
+    message: string;
+    memorixResolution?: {
+        ok: boolean;
+        message?: string;
+    };
+    lookupMatches?: unknown[];
+};
+export type GraphEntryXmemoryLoadResult = GraphEntryXmemoryLoadSuccess | GraphEntryXmemoryLoadFailure;
+/** Flatten {@link FetchMemorixItemResponse} into a plain record for `runtime.input` / seed layers. */
+export declare function memorixItemToInputRecord(item: FetchMemorixItemResponse): Record<string, unknown>;
+/**
+ * Load a Memorix entity item for graph-entry seeding (`fetchMemorixItem`).
+ *
+ * **Supported:** `mode: 'memorix-item'` with `itemDescriptorId` + `entityId`.
+ *
+ * Legacy scoper modes (`scoped-data-row`, `scoped-data-by-source-key`, `narrative`, `snapshot-scoped-data`)
+ * return {@link GraphEntryXmemoryLoadCodes.LEGACY_MODE_REMOVED}.
+ */
+export declare function loadGraphEntryMemorixPayload(deps: GraphEntryXmemoryLoadDeps, request: GraphEntryXmemoryLoadRequest): Promise<GraphEntryXmemoryLoadResult>;
+/**
+ * Merge matrix row `input` with memorix {@link BuildExecutionSeedSources} using the same
+ * precedence rules as {@link buildExecutionSeedFromGraphEntry} (later layers override earlier).
+ */
+export declare function buildExecutionSeedWithMemorixLayer(graphEntry: GraphEntryContract | undefined, matrixInputRow: Record<string, unknown>, memorixSources: BuildExecutionSeedSources): BuildExecutionSeedResult;
+//# sourceMappingURL=graph-entry-xmemory-load.d.ts.map

package/dist/execution-matrix/graph-entry-xmemory-load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-entry-xmemory-load.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/graph-entry-xmemory-load.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC5B,MAAM,yBAAyB,CAAC;AAEjC,oEAAoE;AACpE,eAAO,MAAM,0BAA0B;;;;;;IAMrC,gDAAgD;;;;;;;;;;;;;CAaxC,CAAC;AAEX,MAAM,MAAM,yBAAyB,GACnC,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,OAAO,0BAA0B,CAAC,CAAC;AAE/E,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,sBAAsB,CAAC;CAChC,CAAC;AAEF,iGAAiG;AACjG,MAAM,MAAM,0BAA0B,GAAG;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,uCAAuC,GAAG;IACpD,IAAI,EAAE,cAAc,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,0BAA0B,CAAC;AAE/B,uEAAuE;AACvE,MAAM,MAAM,sCAAsC,GAAG;IACnD,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,GAAG,0BAA0B,CAAC;AAE/B,uEAAuE;AACvE,MAAM,MAAM,iDAAiD,GAAG;IAC9D,IAAI,EAAE,2BAA2B,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,GAAG,0BAA0B,CAAC;AAE/B,+CAA+C;AAC/C,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,GAAG,0BAA0B,CAAC;AAE/B,+CAA+C;AAC/C,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,EAAE,sBAAsB,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC9D,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C,GAAG,0BAA0B,CAAC;AAE/B,MAAM,MAAM,4BAA4B,GACpC,uCAAuC,GACvC,sCAAsC,GACtC,iDAAiD,GACjD,qCAAqC,GACrC,oCAAoC,CAAC;AAEzC,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,IAAI,CAAC;IACT,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,WAAW,EAAE,yBAAyB,CAAC;IACvC,iBAAiB,CAAC,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,4BAA4B,GAAG,4BAA4B,CAAC;AActG,sGAAsG;AACtG,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBhG;AAyBD;;;;;;;GAOG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,yBAAyB,EAC/B,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAgEtC;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,UAAU,EAAE,kBAAkB,GAAG,SAAS,EAC1C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,cAAc,EAAE,yBAAyB,GACxC,wBAAwB,CAS1B"}

package/dist/execution-matrix/graph-entry-xmemory-load.js

@@ -0,0 +1,146 @@
+/**
+ * Load Memorix entity payloads for graph Layer-01 materialization via **`@x12i/memorix-retrieval`**
+ * (`fetchMemorixItem`). Replaces legacy `@x12i/xmemory-scoper` / `xmemory-op` reads.
+ */
+import { buildExecutionSeedFromGraphEntry as engineBuildExecutionSeedFromGraphEntry, } from '@exellix/graph-engine';
+import { fetchMemorixItem, } from '@x12i/memorix-retrieval';
+/** Stable codes for BFF / CI (do not throw for expected misses). */
+export const GraphEntryXmemoryLoadCodes = {
+    INVALID_INPUT: 'INVALID_INPUT',
+    MISSING_ENTITY_ID: 'MISSING_ENTITY_ID',
+    MISSING_ITEM_DESCRIPTOR_ID: 'MISSING_ITEM_DESCRIPTOR_ID',
+    MEMORIX_ITEM_NOT_FOUND: 'MEMORIX_ITEM_NOT_FOUND',
+    MEMORIX_ITEM_EMPTY: 'MEMORIX_ITEM_EMPTY',
+    /** Legacy modes removed with xmemory-scoper. */
+    LEGACY_MODE_REMOVED: 'LEGACY_MODE_REMOVED',
+    MISSING_ENTITY_ID_LEGACY: 'MISSING_ENTITY_ID',
+    MISSING_QUESTION_ID: 'MISSING_QUESTION_ID',
+    MISSING_QUESTION: 'MISSING_QUESTION',
+    MISSING_ABOUT: 'MISSING_ABOUT',
+    MISSING_EXTENDED_DEPS: 'MISSING_EXTENDED_DEPS',
+    MEMORIX_ENTITY_RESOLUTION_FAILED: 'MEMORIX_ENTITY_RESOLUTION_FAILED',
+    SCOPED_DATA_NOT_FOUND: 'SCOPED_DATA_NOT_FOUND',
+    SCOPED_DATA_AMBIGUOUS: 'SCOPED_DATA_AMBIGUOUS',
+    MISSING_SCOPED_DATA_KEY: 'MISSING_SCOPED_DATA_KEY',
+    MISSING_ENTITY_TYPE: 'MISSING_ENTITY_TYPE',
+    NARRATIVE_NOT_FOUND: 'NARRATIVE_NOT_FOUND',
+};
+const LEGACY_MODE_MESSAGE = 'xmemory-scoper modes removed — use mode "memorix-item" with itemDescriptorId + entityId (fetchMemorixItem)';
+function nonEmptyString(value, label, code) {
+    if (typeof value === 'string' && value.trim())
+        return value.trim();
+    return { ok: false, code, message: `${label} is required` };
+}
+/** Flatten {@link FetchMemorixItemResponse} into a plain record for `runtime.input` / seed layers. */
+export function memorixItemToInputRecord(item) {
+    const out = {
+        entity: item.entity,
+        ...(item.entityId ? { entityId: item.entityId } : {}),
+        ...(item.eventId ? { eventId: item.eventId } : {}),
+        ...(item.knowledgeId ? { knowledgeId: item.knowledgeId } : {}),
+    };
+    for (const section of item.sections ?? []) {
+        for (const [key, field] of Object.entries(section.fields ?? {})) {
+            if (field && typeof field === 'object' && !Array.isArray(field) && 'value' in field) {
+                out[key] = field.value;
+            }
+            else {
+                out[key] = field;
+            }
+        }
+    }
+    return out;
+}
+function buildMemorixSeedLayer(request, parts) {
+    const input = {};
+    if (parts.memorixItem) {
+        const key = request.memorixItemInputKey ?? 'memorixItem';
+        input[key] = parts.memorixItem;
+        Object.assign(input, memorixItemToInputRecord(parts.memorixItem));
+    }
+    if (parts.scopedDataRow) {
+        const key = 'scopedDataInputKey' in request && request.scopedDataInputKey
+            ? request.scopedDataInputKey
+            : 'scopedDataRow';
+        input[key] = parts.scopedDataRow;
+    }
+    if (Object.keys(input).length === 0) {
+        return {};
+    }
+    return { layers: [{ input }] };
+}
+/**
+ * Load a Memorix entity item for graph-entry seeding (`fetchMemorixItem`).
+ *
+ * **Supported:** `mode: 'memorix-item'` with `itemDescriptorId` + `entityId`.
+ *
+ * Legacy scoper modes (`scoped-data-row`, `scoped-data-by-source-key`, `narrative`, `snapshot-scoped-data`)
+ * return {@link GraphEntryXmemoryLoadCodes.LEGACY_MODE_REMOVED}.
+ */
+export async function loadGraphEntryMemorixPayload(deps, request) {
+    if (request.mode !== 'memorix-item') {
+        return {
+            ok: false,
+            code: GraphEntryXmemoryLoadCodes.LEGACY_MODE_REMOVED,
+            message: `${LEGACY_MODE_MESSAGE} (requested mode: ${request.mode})`,
+        };
+    }
+    const entityId = nonEmptyString(request.entityId, 'entityId', GraphEntryXmemoryLoadCodes.MISSING_ENTITY_ID);
+    if (typeof entityId !== 'string')
+        return entityId;
+    const itemDescriptorId = nonEmptyString(request.itemDescriptorId, 'itemDescriptorId', GraphEntryXmemoryLoadCodes.MISSING_ITEM_DESCRIPTOR_ID);
+    if (typeof itemDescriptorId !== 'string')
+        return itemDescriptorId;
+    const item = await fetchMemorixItem(deps.client, {
+        itemDescriptorId,
+        entityId,
+        ...(request.eventId ? { eventId: request.eventId } : {}),
+        ...(request.knowledgeId ? { knowledgeId: request.knowledgeId } : {}),
+    });
+    const errorIssue = item.issues?.find((i) => i.severity === 'error');
+    if (errorIssue) {
+        return {
+            ok: false,
+            code: GraphEntryXmemoryLoadCodes.INVALID_INPUT,
+            message: errorIssue.message ?? 'Memorix item fetch failed',
+        };
+    }
+    if (!item.sections?.length) {
+        return {
+            ok: false,
+            code: GraphEntryXmemoryLoadCodes.MEMORIX_ITEM_EMPTY,
+            message: `No sections on Memorix item descriptor=${itemDescriptorId} entityId=${entityId}`,
+        };
+    }
+    const flat = memorixItemToInputRecord(item);
+    if (Object.keys(flat).length <= 1) {
+        return {
+            ok: false,
+            code: GraphEntryXmemoryLoadCodes.MEMORIX_ITEM_NOT_FOUND,
+            message: `Memorix item has no field values (descriptor=${itemDescriptorId}, entityId=${entityId})`,
+        };
+    }
+    const scopedDataRow = flat;
+    const seedSources = buildMemorixSeedLayer(request, { memorixItem: item, scopedDataRow });
+    return {
+        ok: true,
+        memorixItem: item,
+        scopedDataRow,
+        seedSources,
+    };
+}
+/**
+ * Merge matrix row `input` with memorix {@link BuildExecutionSeedSources} using the same
+ * precedence rules as {@link buildExecutionSeedFromGraphEntry} (later layers override earlier).
+ */
+export function buildExecutionSeedWithMemorixLayer(graphEntry, matrixInputRow, memorixSources) {
+    const baseLayers = [{ input: matrixInputRow }];
+    if (memorixSources.layers?.length) {
+        baseLayers.push(...memorixSources.layers);
+    }
+    return engineBuildExecutionSeedFromGraphEntry(graphEntry, {
+        layers: baseLayers,
+        valuesByPath: memorixSources.valuesByPath,
+    });
+}
+//# sourceMappingURL=graph-entry-xmemory-load.js.map

package/dist/execution-matrix/graph-entry-xmemory-load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-entry-xmemory-load.js","sourceRoot":"","sources":["../../src/execution-matrix/graph-entry-xmemory-load.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,gCAAgC,IAAI,sCAAsC,GAI3E,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,GAGjB,MAAM,yBAAyB,CAAC;AAEjC,oEAAoE;AACpE,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,aAAa,EAAE,eAAe;IAC9B,iBAAiB,EAAE,mBAAmB;IACtC,0BAA0B,EAAE,4BAA4B;IACxD,sBAAsB,EAAE,wBAAwB;IAChD,kBAAkB,EAAE,oBAAoB;IACxC,gDAAgD;IAChD,mBAAmB,EAAE,qBAAqB;IAC1C,wBAAwB,EAAE,mBAAmB;IAC7C,mBAAmB,EAAE,qBAAqB;IAC1C,gBAAgB,EAAE,kBAAkB;IACpC,aAAa,EAAE,eAAe;IAC9B,qBAAqB,EAAE,uBAAuB;IAC9C,gCAAgC,EAAE,kCAAkC;IACpE,qBAAqB,EAAE,uBAAuB;IAC9C,qBAAqB,EAAE,uBAAuB;IAC9C,uBAAuB,EAAE,yBAAyB;IAClD,mBAAmB,EAAE,qBAAqB;IAC1C,mBAAmB,EAAE,qBAAqB;CAClC,CAAC;AAiGX,MAAM,mBAAmB,GACvB,4GAA4G,CAAC;AAE/G,SAAS,cAAc,CACrB,KAAc,EACd,KAAa,EACb,IAA+B;IAE/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;IACnE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,cAAc,EAAE,CAAC;AAC9D,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,wBAAwB,CAAC,IAA8B;IACrE,MAAM,GAAG,GAA4B;QACnC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAC;IACF,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;YAChE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;gBACpF,GAAG,CAAC,GAAG,CAAC,GAAI,KAA4B,CAAC,KAAK,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,qBAAqB,CAC5B,OAAqC,EACrC,KAA0F;IAE1F,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,OAAO,CAAC,mBAAmB,IAAI,aAAa,CAAC;QACzD,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,wBAAwB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QACxB,MAAM,GAAG,GACP,oBAAoB,IAAI,OAAO,IAAI,OAAO,CAAC,kBAAkB;YAC3D,CAAC,CAAC,OAAO,CAAC,kBAAkB;YAC5B,CAAC,CAAC,eAAe,CAAC;QACtB,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC;IACnC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,IAA+B,EAC/B,OAAqC;IAErC,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACpC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,0BAA0B,CAAC,mBAAmB;YACpD,OAAO,EAAE,GAAG,mBAAmB,qBAAqB,OAAO,CAAC,IAAI,GAAG;SACpE,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAC7B,OAAO,CAAC,QAAQ,EAChB,UAAU,EACV,0BAA0B,CAAC,iBAAiB,CAC7C,CAAC;IACF,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAElD,MAAM,gBAAgB,GAAG,cAAc,CACrC,OAAO,CAAC,gBAAgB,EACxB,kBAAkB,EAClB,0BAA0B,CAAC,0BAA0B,CACtD,CAAC;IACF,IAAI,OAAO,gBAAgB,KAAK,QAAQ;QAAE,OAAO,gBAAgB,CAAC;IAElE,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE;QAC/C,gBAAgB;QAChB,QAAQ;QACR,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACpE,IAAI,UAAU,EAAE,CAAC;QACf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,0BAA0B,CAAC,aAAa;YAC9C,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,2BAA2B;SAC3D,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC3B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,0BAA0B,CAAC,kBAAkB;YACnD,OAAO,EAAE,0CAA0C,gBAAgB,aAAa,QAAQ,EAAE;SAC3F,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAClC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,0BAA0B,CAAC,sBAAsB;YACvD,OAAO,EAAE,gDAAgD,gBAAgB,cAAc,QAAQ,GAAG;SACnG,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC;IAC3B,MAAM,WAAW,GAAG,qBAAqB,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;IACzF,OAAO;QACL,EAAE,EAAE,IAAI;QACR,WAAW,EAAE,IAAI;QACjB,aAAa;QACb,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kCAAkC,CAChD,UAA0C,EAC1C,cAAuC,EACvC,cAAyC;IAEzC,MAAM,UAAU,GAAc,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;IAC1D,IAAI,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAClC,UAAU,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,sCAAsC,CAAC,UAAU,EAAE;QACxD,MAAM,EAAE,UAAU;QAClB,YAAY,EAAE,cAAc,CAAC,YAAY;KAC1C,CAAC,CAAC;AACL,CAAC"}

package/dist/execution-matrix/graph-entry-xmemory-load.spec.d.ts

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

package/dist/execution-matrix/graph-entry-xmemory-load.spec.d.ts.map

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

package/dist/execution-matrix/graph-entry-xmemory-load.spec.js

@@ -0,0 +1,66 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { fetchMemorixItem } from '@x12i/memorix-retrieval';
+import { GraphEntryXmemoryLoadCodes, loadGraphEntryMemorixPayload, memorixItemToInputRecord, } from './graph-entry-xmemory-load.js';
+vi.mock('@x12i/memorix-retrieval', async (importOriginal) => {
+    const actual = await importOriginal();
+    return { ...actual, fetchMemorixItem: vi.fn() };
+});
+const client = {};
+describe('loadGraphEntryMemorixPayload', () => {
+    beforeEach(() => {
+        vi.mocked(fetchMemorixItem).mockReset();
+    });
+    it('loads memorix-item via fetchMemorixItem', async () => {
+        vi.mocked(fetchMemorixItem).mockResolvedValue({
+            itemDescriptorId: 'desc-1',
+            entity: 'subnet',
+            entityId: 'ent-1',
+            sections: [
+                {
+                    id: 'main',
+                    title: 'Main',
+                    fields: {
+                        subnetId: { value: '10.0.0.0/24' },
+                        question: { value: 'Analyze' },
+                    },
+                },
+            ],
+        });
+        const r = await loadGraphEntryMemorixPayload({ client }, { mode: 'memorix-item', itemDescriptorId: 'desc-1', entityId: 'ent-1' });
+        expect(r.ok).toBe(true);
+        if (!r.ok)
+            return;
+        expect(r.scopedDataRow?.subnetId).toBe('10.0.0.0/24');
+        expect(fetchMemorixItem).toHaveBeenCalledWith(client, {
+            itemDescriptorId: 'desc-1',
+            entityId: 'ent-1',
+        });
+    });
+    it('rejects legacy scoped-data-row mode', async () => {
+        const r = await loadGraphEntryMemorixPayload({ client }, { mode: 'scoped-data-row', entityId: 'e', questionId: 'q' });
+        expect(r.ok).toBe(false);
+        if (r.ok)
+            return;
+        expect(r.code).toBe(GraphEntryXmemoryLoadCodes.LEGACY_MODE_REMOVED);
+    });
+    it('requires itemDescriptorId', async () => {
+        const r = await loadGraphEntryMemorixPayload({ client }, { mode: 'memorix-item', itemDescriptorId: '', entityId: 'e' });
+        expect(r.ok).toBe(false);
+        if (r.ok)
+            return;
+        expect(r.code).toBe(GraphEntryXmemoryLoadCodes.MISSING_ITEM_DESCRIPTOR_ID);
+    });
+});
+describe('memorixItemToInputRecord', () => {
+    it('unwraps field envelopes', () => {
+        const flat = memorixItemToInputRecord({
+            itemDescriptorId: 'd',
+            entity: 'subnet',
+            entityId: 'e1',
+            sections: [{ id: 's', title: 'S', fields: { subnetId: { value: '10.0.0.0/24' } } }],
+        });
+        expect(flat.subnetId).toBe('10.0.0.0/24');
+        expect(flat.entityId).toBe('e1');
+    });
+});
+//# sourceMappingURL=graph-entry-xmemory-load.spec.js.map

package/dist/execution-matrix/graph-entry-xmemory-load.spec.js.map

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

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

@@ -0,0 +1,47 @@
+import type { ExecutionMatrixStatusCounts, GraphConfigRecord, GraphOperationalState, GraphPublicationStatus } from './contracts.js';
+import type { ExecutionMatrixRuntime } from './runtime-store.js';
+/**
+ * Validates a dot-path under `input` for grouping (alphanumeric segments; no `$`).
+ */
+export declare function assertSafeInputGroupByPath(path: string): void;
+export type GraphOperationalDashboardOutputCountMode = 'inferenceRows';
+export type FetchGraphOperationalDashboardSliceQuery = {
+    matrixCatalogId: string;
+    matrixRunId?: string;
+    graphId: string;
+    extraFilter?: Record<string, unknown>;
+    /** Dot path under row `input` (e.g. `entityKind`). Omit for a single {@link ALL_BUCKET} bucket. */
+    inputGroupByPath?: string;
+    outputCountMode?: GraphOperationalDashboardOutputCountMode;
+    /** Max rows read when `inputGroupByPath` is set (default `10_000`). */
+    aggregateRowScanCap?: number;
+};
+export type GraphOperationalDashboardInputBucket = {
+    key: string;
+    totalRows: number;
+    bySlotStatus: ExecutionMatrixStatusCounts;
+};
+export type GraphOperationalDashboardSlice = {
+    graphId: string;
+    matrixCatalogId: string;
+    matrixRunId?: string;
+    graphConfigFound: boolean;
+    publicationStatus: GraphPublicationStatus;
+    operationalState: GraphOperationalState;
+    configVersion?: number;
+    inputBuckets: GraphOperationalDashboardInputBucket[];
+    output: {
+        completedInferenceRows: number;
+        failedSlotRows: number;
+    };
+};
+export type FetchGraphOperationalDashboardSliceDeps = {
+    runtime: ExecutionMatrixRuntime;
+    loadGraphConfig: (graphId: string) => Promise<GraphConfigRecord | null>;
+};
+/**
+ * Read-only dashboard slice: graph operational fields from config plus execution-matrix row counts
+ * for one `graphId` within a matrix scope. Uses {@link ExecutionMatrixRuntime.countRowsMatching} when available.
+ */
+export declare function fetchGraphOperationalDashboardSlice(deps: FetchGraphOperationalDashboardSliceDeps, query: FetchGraphOperationalDashboardSliceQuery): Promise<GraphOperationalDashboardSlice>;
+//# sourceMappingURL=graph-operational-aggregates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-operational-aggregates.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/graph-operational-aggregates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,2BAA2B,EAC3B,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAgBjE;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAa7D;AAkBD,MAAM,MAAM,wCAAwC,GAAG,eAAe,CAAC;AAEvE,MAAM,MAAM,wCAAwC,GAAG;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,wCAAwC,CAAC;IAC3D,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,2BAA2B,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,sBAAsB,CAAC;IAC1C,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,oCAAoC,EAAE,CAAC;IACrD,MAAM,EAAE;QACN,sBAAsB,EAAE,MAAM,CAAC;QAC/B,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,uCAAuC,GAAG;IACpD,OAAO,EAAE,sBAAsB,CAAC;IAChC,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACzE,CAAC;AAEF;;;GAGG;AACH,wBAAsB,mCAAmC,CACvD,IAAI,EAAE,uCAAuC,EAC7C,KAAK,EAAE,wCAAwC,GAC9C,OAAO,CAAC,8BAA8B,CAAC,CA6FzC"}

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

@@ -0,0 +1,137 @@
+import { ExecutionMatrixCatalogValidationError } from './catalox-loader.js';
+import { DEFAULT_GRAPH_OPERATIONAL_STATE, DEFAULT_GRAPH_PUBLICATION_STATUS, EXECUTION_MATRIX_STATUSES, } from './contracts.js';
+import { resolveGraphConfigOperationalView } from './graph-operational-lifecycle.js';
+import { buildMatrixRowReadFilter } from './runtime-store.js';
+import { normalizeExecutionMatrixStatus } from './status.js';
+const ALL_BUCKET = '_all';
+function emptyStatusCounts() {
+    return {
+        'not-started': 0,
+        'in-progress': 0,
+        completed: 0,
+        failed: 0,
+        skipped: 0,
+    };
+}
+/**
+ * Validates a dot-path under `input` for grouping (alphanumeric segments; no `$`).
+ */
+export function assertSafeInputGroupByPath(path) {
+    const trimmed = path.trim();
+    if (!trimmed) {
+        throw new ExecutionMatrixCatalogValidationError('Invalid inputGroupByPath', ['path must be non-empty']);
+    }
+    const parts = trimmed.split('.').filter(Boolean);
+    for (const p of parts) {
+        if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(p)) {
+            throw new ExecutionMatrixCatalogValidationError('Invalid inputGroupByPath', [
+                `segment ${JSON.stringify(p)} must match /^[a-zA-Z_][a-zA-Z0-9_]*$/`,
+            ]);
+        }
+    }
+}
+function inputGroupKey(input, path) {
+    const parts = path.split('.').filter(Boolean);
+    let cur = input;
+    for (const p of parts) {
+        if (cur === null || cur === undefined || typeof cur !== 'object')
+            return '_unknown';
+        cur = cur[p];
+    }
+    if (cur === undefined || cur === null)
+        return '_unknown';
+    if (typeof cur === 'string' || typeof cur === 'number' || typeof cur === 'boolean')
+        return String(cur);
+    return '_object';
+}
+function slotForGraph(row, graphId) {
+    return row.execution.find((s) => s.graphId === graphId);
+}
+/**
+ * Read-only dashboard slice: graph operational fields from config plus execution-matrix row counts
+ * for one `graphId` within a matrix scope. Uses {@link ExecutionMatrixRuntime.countRowsMatching} when available.
+ */
+export async function fetchGraphOperationalDashboardSlice(deps, query) {
+    const { matrixCatalogId, matrixRunId, graphId, extraFilter } = query;
+    const cap = query.aggregateRowScanCap ?? 10_000;
+    const cfg = await deps.loadGraphConfig(graphId);
+    const graphConfigFound = cfg !== null;
+    const eff = cfg
+        ? resolveGraphConfigOperationalView(cfg)
+        : {
+            publicationStatus: DEFAULT_GRAPH_PUBLICATION_STATUS,
+            operationalState: DEFAULT_GRAPH_OPERATIONAL_STATE,
+        };
+    const baseSlotFilter = buildMatrixRowReadFilter(matrixCatalogId, matrixRunId, graphId, undefined, extraFilter);
+    const failedSlotRows = await deps.runtime.countRowsMatching(buildMatrixRowReadFilter(matrixCatalogId, matrixRunId, graphId, 'failed', extraFilter));
+    const outputMode = query.outputCountMode ?? 'inferenceRows';
+    let completedInferenceRows = 0;
+    if (outputMode === 'inferenceRows') {
+        completedInferenceRows = await deps.runtime.countRowsMatching({
+            ...baseSlotFilter,
+            inferences: { $elemMatch: { graphId } },
+        });
+    }
+    if (query.inputGroupByPath !== undefined) {
+        assertSafeInputGroupByPath(query.inputGroupByPath);
+        const path = query.inputGroupByPath.trim();
+        const rows = (await deps.runtime.listRecords({
+            matrixCatalogId,
+            matrixRunId,
+            graphId,
+            limit: cap,
+            extraFilter,
+        }));
+        const buckets = new Map();
+        for (const row of rows) {
+            const key = inputGroupKey(row.input, path);
+            const slot = slotForGraph(row, graphId);
+            const st = (slot
+                ? normalizeExecutionMatrixStatus(slot.status)
+                : 'not-started');
+            if (!buckets.has(key)) {
+                buckets.set(key, { totalRows: 0, bySlotStatus: emptyStatusCounts() });
+            }
+            const b = buckets.get(key);
+            b.totalRows += 1;
+            if (st)
+                b.bySlotStatus[st] += 1;
+        }
+        const inputBuckets = [...buckets.entries()]
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([key, v]) => ({ key, totalRows: v.totalRows, bySlotStatus: v.bySlotStatus }));
+        return {
+            graphId,
+            matrixCatalogId,
+            ...(matrixRunId !== undefined ? { matrixRunId } : {}),
+            graphConfigFound,
+            publicationStatus: eff.publicationStatus,
+            operationalState: eff.operationalState,
+            ...(cfg ? { configVersion: cfg.version } : {}),
+            inputBuckets,
+            output: { completedInferenceRows, failedSlotRows },
+        };
+    }
+    const inputBuckets = [
+        {
+            key: ALL_BUCKET,
+            totalRows: await deps.runtime.countRowsMatching(baseSlotFilter),
+            bySlotStatus: emptyStatusCounts(),
+        },
+    ];
+    for (const st of EXECUTION_MATRIX_STATUSES) {
+        inputBuckets[0].bySlotStatus[st] = await deps.runtime.countRowsMatching(buildMatrixRowReadFilter(matrixCatalogId, matrixRunId, graphId, st, extraFilter));
+    }
+    return {
+        graphId,
+        matrixCatalogId,
+        ...(matrixRunId !== undefined ? { matrixRunId } : {}),
+        graphConfigFound,
+        publicationStatus: eff.publicationStatus,
+        operationalState: eff.operationalState,
+        ...(cfg ? { configVersion: cfg.version } : {}),
+        inputBuckets,
+        output: { completedInferenceRows, failedSlotRows },
+    };
+}
+//# sourceMappingURL=graph-operational-aggregates.js.map

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

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

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

@@ -0,0 +1,43 @@
+import type { GraphConfigRecord, GraphOperationalState, GraphPublicationStatus } from './contracts.js';
+export declare class GraphNotSchedulableError extends Error {
+    readonly graphId: string;
+    readonly publicationStatus: GraphPublicationStatus;
+    readonly operationalState: GraphOperationalState;
+    constructor(message: string, graphId: string, publicationStatus: GraphPublicationStatus, operationalState: GraphOperationalState);
+}
+/**
+ * Effective publication / operational values for a graph config row (fills legacy omissions).
+ */
+export declare function resolveGraphConfigOperationalView(record: GraphConfigRecord): {
+    publicationStatus: GraphPublicationStatus;
+    operationalState: GraphOperationalState;
+};
+/**
+ * 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 declare function assertGraphSchedulable(record: GraphConfigRecord): void;
+export type GraphOperationalWriteInput = {
+    publicationStatus?: GraphPublicationStatus;
+    operationalState?: GraphOperationalState;
+};
+/**
+ * Validates merged publication + operational fields before persist.
+ *
+ * @param prevEffective — previous effective view (after {@link resolveGraphConfigOperationalView}); omit on create.
+ */
+export declare function validateGraphOperationalFields(next: {
+    publicationStatus: GraphPublicationStatus;
+    operationalState: GraphOperationalState;
+}, prevEffective?: {
+    publicationStatus: GraphPublicationStatus;
+    operationalState: GraphOperationalState;
+}): void;
+/**
+ * Merges partial write input with current record defaults and runs {@link validateGraphOperationalFields}.
+ */
+export declare function mergeAndValidateGraphOperationalUpdate(cur: GraphConfigRecord, patch: GraphOperationalWriteInput): {
+    publicationStatus: GraphPublicationStatus;
+    operationalState: GraphOperationalState;
+};
+//# sourceMappingURL=graph-operational-lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-operational-lifecycle.d.ts","sourceRoot":"","sources":["../../src/execution-matrix/graph-operational-lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AAQxB,qBAAa,wBAAyB,SAAQ,KAAK;aAG/B,OAAO,EAAE,MAAM;aACf,iBAAiB,EAAE,sBAAsB;aACzC,gBAAgB,EAAE,qBAAqB;gBAHvD,OAAO,EAAE,MAAM,EACC,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,sBAAsB,EACzC,gBAAgB,EAAE,qBAAqB;CAK1D;AAUD;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,iBAAiB,GAAG;IAC5E,iBAAiB,EAAE,sBAAsB,CAAC;IAC1C,gBAAgB,EAAE,qBAAqB,CAAC;CACzC,CAIA;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAmBtE;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE;IAAE,iBAAiB,EAAE,sBAAsB,CAAC;IAAC,gBAAgB,EAAE,qBAAqB,CAAA;CAAE,EAC5F,aAAa,CAAC,EAAE;IAAE,iBAAiB,EAAE,sBAAsB,CAAC;IAAC,gBAAgB,EAAE,qBAAqB,CAAA;CAAE,GACrG,IAAI,CAiCN;AAED;;GAEG;AACH,wBAAgB,sCAAsC,CACpD,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,0BAA0B,GAChC;IAAE,iBAAiB,EAAE,sBAAsB,CAAC;IAAC,gBAAgB,EAAE,qBAAqB,CAAA;CAAE,CAMxF"}