@exellix/exellix-runtime 3.5.1

package/dist/catalox-inventory/catalox-execution-matrix-inventory-cli.js

@@ -0,0 +1,311 @@
+#!/usr/bin/env node
+/**
+ * CLI: read-only Catalox inventory for execution-matrix + graphs native items.
+ *
+ * **`createCataloxFromEnv`** (from `@x12i/catalox/firebase`) already reads the usual env vars — for example
+ * **`FIREBASE_PROJECT_ID`**, **`GOOGLE_SERVICE_ACCOUNT_BASE64`** or ADC, optional **`FIRESTORE_DATABASE_ID`** /
+ * **`CATALOX_MONGO_URI`**. It does **not** load a `.env` file by itself.
+ *
+ * This entrypoint calls **`initConfig`** with **`dotenvPath: '.env'`** first so a repo `.env` (e.g.
+ * **`FIREBASE_PROJECT_ID`** plus credentials) is on **`process.env`** before Catalox runs — same
+ * convenience Vitest gives live tests. If **`FIREBASE_PROJECT_ID`** is still unset after that, we copy
+ * from **`GOOGLE_CLOUD_PROJECT`** / **`GCLOUD_PROJECT`** or from **`project_id`** inside base64 SA JSON
+ * so `initializeApp` always gets a project id when one is inferable.
+ *
+ * **XMemory entity counts (catalog-driven):** **`--namespace`** + one or more native catalog ids
+ * (**`--entity-catalog-id`**, **`--entity-catalog-ids=a,b`**, **`CATALOX_ENTITY_CATALOG_IDS`**) and **`MONGO_URI`**.
+ * Optional **`--matrix-catalog-id`** / **`EXELLIX_ENTITY_REPORT_MATRIX_CATALOG_ID`** (+ optional run id) adds execution matrix row + snapshot counts.
+ *
+ * **Tier discovery (no Catalox entity catalog):** **`--entity-discovery=scoped-data-tier`** (or env **`XMEMORY_ENTITY_DISCOVERY=scoped-data-tier`**) with **`--namespace`** + **`MONGO_URI`** only — discovers distinct entity-type buckets from scoped data via **`getXmemoryTierStatistics`** (broader default **`groupByPaths.scoped_data`** than stock tier stats), then counts surfaces (+ optional matrix). Override paths with **`--entity-discovery-group-paths`** or **`XMEMORY_ENTITY_DISCOVERY_GROUP_PATHS`** (comma-separated Mongo paths, optional **`$`** prefix). No Firebase/Catalox required for this branch.
+ *
+ * Usage:
+ *   npm run catalox:inventory
+ *   npm run catalox:inventory -- --entity-discovery=scoped-data-tier --namespace=production --out=reports/all-entities.json
+ *   npm run catalox:inventory -- --entity-catalog-ids=cat-a,cat-b --namespace=production --matrix-catalog-id=exellix.execution-matrix.foo --out=reports/entities.json
+ *   npm run catalox:inventory -- --format=markdown --out=reports/catalox-inventory.md
+ */
+import { Buffer } from 'node:buffer';
+import { writeFileSync } from 'node:fs';
+import { deleteApp } from 'firebase-admin/app';
+import { MongoClient } from 'mongodb';
+import { initConfig } from '@x12i/env';
+import { createMemorixRuntimeTier } from '../execution-matrix/memorix-runtime-tier.js';
+import { createCataloxFromEnv } from '@x12i/catalox/firebase';
+import { openLiveMatrixFromDataTier } from '../execution-matrix/live-tier-open.js';
+import { formatCataloxExecutionMatrixInventoryMarkdown, runCataloxExecutionMatrixInventory, } from './catalox-execution-matrix-inventory.js';
+import { driverBackedMongoClientForXmemoryCli, formatCataloxXmemoryEntityCountMarkdown, normalizeEntityReportCatalogIds, parseTierDiscoveryGroupPathsCsv, runCataloxXmemoryEntityCountReport, runScopedDataEntityTypeDiscoveryReport, } from './catalox-xmemory-entity-count-report.js';
+let inventoryCliArgv = process.argv;
+function argValue(name) {
+    const prefix = `${name}=`;
+    const hit = inventoryCliArgv.find((a) => a === name || a.startsWith(prefix));
+    if (!hit)
+        return undefined;
+    if (hit === name) {
+        const i = inventoryCliArgv.indexOf(name);
+        return inventoryCliArgv[i + 1];
+    }
+    return hit.slice(prefix.length);
+}
+/** Collect every `--entity-catalog-id` value in argv (supports repeated flag). */
+function allArgValues(name) {
+    const out = [];
+    const eq = `${name}=`;
+    for (let i = 0; i < inventoryCliArgv.length; i++) {
+        const a = inventoryCliArgv[i];
+        if (a === name) {
+            const v = inventoryCliArgv[i + 1];
+            if (v !== undefined && !v.startsWith('-'))
+                out.push(v);
+        }
+        else if (a.startsWith(eq)) {
+            out.push(a.slice(eq.length));
+        }
+    }
+    return out;
+}
+function resolveEntityCatalogIds() {
+    const repeated = allArgValues('--entity-catalog-id');
+    const csv = (argValue('--entity-catalog-ids') ?? '')
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const fromEnv = (process.env.CATALOX_ENTITY_CATALOG_IDS ?? '')
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const single = (process.env.CATALOX_ENTITY_CATALOG_ID ?? '').trim();
+    return normalizeEntityReportCatalogIds([...(single ? [single] : []), ...repeated, ...csv, ...fromEnv]);
+}
+function isScopedDataTierDiscovery(raw) {
+    const v = raw.trim().toLowerCase().replace(/-/g, '_');
+    return v === 'scoped_data_tier' || v === 'tier' || v === 'scoped_data';
+}
+/** Align with {@link createCataloxFromEnv}: it only passes `projectId` when `FIREBASE_PROJECT_ID` is set. */
+function coerceFirebaseProjectIdFromEnv() {
+    if (String(process.env.FIREBASE_PROJECT_ID ?? '').trim())
+        return;
+    const fromGcp = String(process.env.GOOGLE_CLOUD_PROJECT ?? process.env.GCLOUD_PROJECT ?? '').trim();
+    if (fromGcp) {
+        process.env.FIREBASE_PROJECT_ID = fromGcp;
+        return;
+    }
+    const b64 = String(process.env.GOOGLE_SERVICE_ACCOUNT_BASE64 ?? '').trim();
+    if (!b64)
+        return;
+    try {
+        const json = JSON.parse(Buffer.from(b64, 'base64').toString('utf8'));
+        const pid = json !== null && typeof json === 'object' && 'project_id' in json && typeof json.project_id === 'string'
+            ? json.project_id.trim()
+            : '';
+        if (pid)
+            process.env.FIREBASE_PROJECT_ID = pid;
+    }
+    catch {
+        // Invalid base64/JSON: let createCataloxFromEnv surface the real error.
+    }
+}
+async function runTierDiscoveryEntityReport(args) {
+    const { format, out, mongoUri, namespace, reportMatrixCatalogId, reportMatrixRunId, executionDb, discoveryGroupByPathsScopedData, } = args;
+    const driver = new MongoClient(mongoUri);
+    await driver.connect();
+    let matrixBundle;
+    if (reportMatrixCatalogId) {
+        matrixBundle = await openLiveMatrixFromDataTier({ mongoUri, executionDb });
+    }
+    const tier = await createMemorixRuntimeTier({
+        mongoUri,
+        fallbackMongoClient: driverBackedMongoClientForXmemoryCli(driver),
+    });
+    try {
+        const report = await runScopedDataEntityTypeDiscoveryReport(tier, namespace, {
+            ...(matrixBundle
+                ? {
+                    matrix: {
+                        runtime: matrixBundle.runtime,
+                        matrixCatalogId: reportMatrixCatalogId,
+                        matrixRunId: reportMatrixRunId,
+                        mongoDb: executionDb,
+                    },
+                }
+                : {}),
+            ...(discoveryGroupByPathsScopedData?.length
+                ? { discoveryGroupByPathsScopedData: [...discoveryGroupByPathsScopedData] }
+                : {}),
+        });
+        const enriched = { ...report };
+        let body;
+        if (format === 'markdown' || format === 'md') {
+            body = formatCataloxXmemoryEntityCountMarkdown(report);
+        }
+        else {
+            body = `${JSON.stringify(enriched, null, 2)}\n`;
+        }
+        if (out) {
+            writeFileSync(out, body, 'utf8');
+            console.error(`Wrote ${out}`);
+        }
+        else {
+            process.stdout.write(body);
+        }
+    }
+    finally {
+        await tier.close();
+        if (matrixBundle) {
+            await matrixBundle.close();
+        }
+        await driver.close();
+    }
+}
+/** Run catalox inventory with optional forwarded argv (used by unified `exellix-runtime` CLI). */
+export async function runCataloxInventoryCli(forwardArgv) {
+    const prevArgv = inventoryCliArgv;
+    if (forwardArgv) {
+        inventoryCliArgv = forwardArgv;
+    }
+    try {
+        await runCataloxInventoryCliBody();
+    }
+    finally {
+        inventoryCliArgv = prevArgv;
+    }
+}
+async function runCataloxInventoryCliBody() {
+    initConfig({}, { dotenvPath: '.env', throwOnMissing: false });
+    const format = (argValue('--format') ?? 'json').toLowerCase();
+    const out = argValue('--out');
+    const namespace = (argValue('--namespace') ?? process.env.XMEMORY_ENTITY_REPORT_NAMESPACE ?? '').trim();
+    const mongoUri = (argValue('--mongo-uri') ?? process.env.MONGO_URI ?? '').trim();
+    const discoveryRaw = (argValue('--entity-discovery') ?? process.env.XMEMORY_ENTITY_DISCOVERY ?? '').trim();
+    const tierDiscovery = isScopedDataTierDiscovery(discoveryRaw);
+    if (discoveryRaw && !tierDiscovery) {
+        throw new Error(`catalox:inventory: unknown --entity-discovery="${discoveryRaw}" (supported: scoped-data-tier, tier, scoped-data)`);
+    }
+    if (tierDiscovery) {
+        if (!namespace) {
+            throw new Error('catalox:inventory: --entity-discovery=scoped-data-tier requires --namespace (or XMEMORY_ENTITY_REPORT_NAMESPACE)');
+        }
+        if (!mongoUri) {
+            throw new Error('catalox:inventory: tier discovery requires MONGO_URI (or --mongo-uri)');
+        }
+        const executionDb = (process.env.execution_db ?? 'exellix-runtime').trim();
+        const reportMatrixCatalogId = (argValue('--matrix-catalog-id') ??
+            process.env.EXELLIX_ENTITY_REPORT_MATRIX_CATALOG_ID ??
+            '').trim();
+        const reportMatrixRunId = (argValue('--matrix-run-id') ?? process.env.EXELLIX_ENTITY_REPORT_MATRIX_RUN_ID ?? '').trim() || undefined;
+        const discoveryPathsRaw = argValue('--entity-discovery-group-paths') ?? process.env.XMEMORY_ENTITY_DISCOVERY_GROUP_PATHS ?? '';
+        const discoveryGroupByPathsScopedData = parseTierDiscoveryGroupPathsCsv(discoveryPathsRaw);
+        await runTierDiscoveryEntityReport({
+            format,
+            out,
+            mongoUri,
+            namespace,
+            reportMatrixCatalogId,
+            reportMatrixRunId,
+            executionDb,
+            discoveryGroupByPathsScopedData,
+        });
+        return;
+    }
+    coerceFirebaseProjectIdFromEnv();
+    const catalogIds = resolveEntityCatalogIds();
+    const xmemoryEntityMode = Boolean(namespace && catalogIds.length > 0);
+    if (catalogIds.length > 0 && !namespace) {
+        throw new Error('catalox:inventory: --namespace (or XMEMORY_ENTITY_REPORT_NAMESPACE) is required with entity catalog id(s)');
+    }
+    if (namespace && catalogIds.length === 0 && !tierDiscovery) {
+        throw new Error('catalox:inventory: entity catalog id(s) required with --namespace: use --entity-catalog-id, --entity-catalog-ids, and/or CATALOX_ENTITY_CATALOG_IDS — or use --entity-discovery=scoped-data-tier');
+    }
+    const { catalox, app, credentialSource, databaseId } = createCataloxFromEnv();
+    try {
+        if (xmemoryEntityMode) {
+            if (!mongoUri) {
+                throw new Error('catalox:inventory: xmemory entity mode requires MONGO_URI (or --mongo-uri)');
+            }
+            const driver = new MongoClient(mongoUri);
+            await driver.connect();
+            const executionDb = (process.env.execution_db ?? 'exellix-runtime').trim();
+            const reportMatrixCatalogId = (argValue('--matrix-catalog-id') ??
+                process.env.EXELLIX_ENTITY_REPORT_MATRIX_CATALOG_ID ??
+                '').trim();
+            const reportMatrixRunId = (argValue('--matrix-run-id') ?? process.env.EXELLIX_ENTITY_REPORT_MATRIX_RUN_ID ?? '').trim() || undefined;
+            let matrixBundle;
+            if (reportMatrixCatalogId) {
+                matrixBundle = await openLiveMatrixFromDataTier({ mongoUri, executionDb });
+            }
+            const tier = await createMemorixRuntimeTier({
+                mongoUri,
+                fallbackMongoClient: driverBackedMongoClientForXmemoryCli(driver),
+            });
+            try {
+                const report = await runCataloxXmemoryEntityCountReport(catalox, tier, catalogIds, namespace, {
+                    ...(matrixBundle
+                        ? {
+                            matrix: {
+                                runtime: matrixBundle.runtime,
+                                matrixCatalogId: reportMatrixCatalogId,
+                                matrixRunId: reportMatrixRunId,
+                                mongoDb: executionDb,
+                            },
+                        }
+                        : {}),
+                });
+                const enriched = {
+                    ...report,
+                    firebase: { credentialSource, ...(databaseId ? { databaseId } : {}) },
+                };
+                let body;
+                if (format === 'markdown' || format === 'md') {
+                    body = formatCataloxXmemoryEntityCountMarkdown(report);
+                    body += `\n\n## Firebase\n\ncredentialSource: **${credentialSource}**${databaseId ? ` · databaseId: **${databaseId}**` : ''}\n`;
+                }
+                else {
+                    body = `${JSON.stringify(enriched, null, 2)}\n`;
+                }
+                if (out) {
+                    writeFileSync(out, body, 'utf8');
+                    console.error(`Wrote ${out}`);
+                }
+                else {
+                    process.stdout.write(body);
+                }
+            }
+            finally {
+                await tier.close();
+                if (matrixBundle) {
+                    await matrixBundle.close();
+                }
+                await driver.close();
+            }
+        }
+        else {
+            const report = await runCataloxExecutionMatrixInventory(catalox);
+            const enriched = {
+                ...report,
+                firebase: { credentialSource, ...(databaseId ? { databaseId } : {}) },
+            };
+            let body;
+            if (format === 'markdown' || format === 'md') {
+                body = formatCataloxExecutionMatrixInventoryMarkdown(report);
+                body += `\n\n## Firebase\n\ncredentialSource: **${credentialSource}**${databaseId ? ` · databaseId: **${databaseId}**` : ''}\n`;
+            }
+            else {
+                body = `${JSON.stringify(enriched, null, 2)}\n`;
+            }
+            if (out) {
+                writeFileSync(out, body, 'utf8');
+                console.error(`Wrote ${out}`);
+            }
+            else {
+                process.stdout.write(body);
+            }
+        }
+    }
+    finally {
+        await deleteApp(app);
+    }
+}
+void runCataloxInventoryCli().catch((e) => {
+    console.error(e instanceof Error ? e.stack ?? e.message : e);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=catalox-execution-matrix-inventory-cli.js.map

package/dist/catalox-inventory/catalox-execution-matrix-inventory-cli.js.map

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

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

@@ -0,0 +1,64 @@
+/**
+ * Read-only Catalox sweep: native catalogs → items → validate **execution-matrix** and **graphs**
+ * payloads and cross-check matrix **`graphs[]`** references against loaded graph definitions.
+ */
+import type { Catalox, CataloxContext, CatalogSummary } from '@x12i/catalox';
+export type CataloxInventoryItemIssue = {
+    kind: 'graph' | 'execution-matrix' | 'matrix-materialize';
+    message: string;
+    issues?: string[];
+};
+export type CataloxInventoryGraphRow = {
+    catalogId: string;
+    itemId: string;
+    ok: false;
+    issues: CataloxInventoryItemIssue[];
+};
+export type CataloxInventoryMatrixRow = {
+    catalogId: string;
+    itemId: string;
+    ok: boolean;
+    graphIds?: string[];
+    issues?: CataloxInventoryItemIssue[];
+    materializeOk?: boolean;
+    materializeError?: string;
+};
+export type CataloxExecutionMatrixInventoryReport = {
+    generatedAt: string;
+    context: CataloxContext;
+    catalogs: Array<{
+        catalogId: string;
+        label: string;
+        sourceMode: CatalogSummary['sourceMode'];
+        catalogType: string;
+        itemCount: number;
+        listOutcome?: string;
+        listError?: string;
+    }>;
+    summary: {
+        nativeCatalogs: number;
+        itemsListed: number;
+        graphItemsAttempted: number;
+        graphItemsOk: number;
+        graphValidationFailures: number;
+        matrixItemsAttempted: number;
+        matrixItemsOk: number;
+        matrixMaterializeOk: number;
+        matrixMaterializeFailures: number;
+        matrixPayloadFailures: number;
+    };
+    graphs: CataloxInventoryGraphRow[];
+    matrices: CataloxInventoryMatrixRow[];
+};
+export declare function formatCataloxExecutionMatrixInventoryMarkdown(report: CataloxExecutionMatrixInventoryReport): string;
+export type RunCataloxExecutionMatrixInventoryOptions = {
+    context?: CataloxContext;
+    pageSize?: number;
+};
+/**
+ * Lists all native catalogs (super-admin), pages native items, validates **graphs** / **execution-matrix**
+ * rows using this package’s loaders, then runs {@link buildMatrixMaterializeContext} for each matrix item
+ * against the union of successfully parsed graph definitions (keyed by **`graphId`**).
+ */
+export declare function runCataloxExecutionMatrixInventory(catalox: Catalox, options?: RunCataloxExecutionMatrixInventoryOptions): Promise<CataloxExecutionMatrixInventoryReport>;
+//# sourceMappingURL=catalox-execution-matrix-inventory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalox-execution-matrix-inventory.d.ts","sourceRoot":"","sources":["../../src/catalox-inventory/catalox-execution-matrix-inventory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAsB,MAAM,eAAe,CAAC;AAajG,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,OAAO,GAAG,kBAAkB,GAAG,oBAAoB,CAAC;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,yBAAyB,EAAE,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;QACzC,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,YAAY,EAAE,MAAM,CAAC;QACrB,uBAAuB,EAAE,MAAM,CAAC;QAChC,oBAAoB,EAAE,MAAM,CAAC;QAC7B,aAAa,EAAE,MAAM,CAAC;QACtB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,yBAAyB,EAAE,MAAM,CAAC;QAClC,qBAAqB,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC,QAAQ,EAAE,yBAAyB,EAAE,CAAC;CACvC,CAAC;AASF,wBAAgB,6CAA6C,CAAC,MAAM,EAAE,qCAAqC,GAAG,MAAM,CA2CnH;AAED,MAAM,MAAM,yCAAyC,GAAG;IACtD,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,yCAAyC,GAClD,OAAO,CAAC,qCAAqC,CAAC,CAyKhD"}

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

@@ -0,0 +1,226 @@
+import { buildMatrixMaterializeContext } from '../execution-matrix/catalox-matrix-host.js';
+import { ExecutionMatrixCatalogValidationError, executionMatrixPayloadFromCatalogItem, graphCatalogPayloadFromCatalogItem, isExecutionMatrixCatalogMetadata, isGraphCatalogMetadata, } from '../execution-matrix/catalox-loader.js';
+const DEFAULT_PAGE = 200;
+function itemToNativeLike(item) {
+    return {
+        data: item.data,
+        metadata: item.metadata,
+    };
+}
+export function formatCataloxExecutionMatrixInventoryMarkdown(report) {
+    const s = report.summary;
+    const lines = [
+        '# Catalox execution-matrix inventory',
+        '',
+        `- **Generated:** ${report.generatedAt}`,
+        `- **Native catalogs:** ${s.nativeCatalogs}`,
+        `- **Items listed:** ${s.itemsListed}`,
+        `- **Graph validation failures:** ${s.graphValidationFailures}`,
+        `- **Matrix payload failures:** ${s.matrixPayloadFailures}`,
+        `- **Matrix materialize failures:** ${s.matrixMaterializeFailures}`,
+        '',
+        '## Catalogs',
+        '',
+        '| catalogId | source | type | items |',
+        '|-----------|--------|------|------:|',
+    ];
+    for (const c of report.catalogs) {
+        lines.push(`| ${c.catalogId} | ${c.sourceMode} | ${c.catalogType} | ${c.itemCount} |`);
+    }
+    lines.push('', '## Graph validation failures', '');
+    const badG = report.graphs;
+    if (badG.length === 0)
+        lines.push('_(none)_');
+    else {
+        for (const r of badG) {
+            lines.push(`- **${r.catalogId}** / ${r.itemId}: ${r.issues?.map((i) => i.message).join('; ') ?? 'error'}`);
+        }
+    }
+    lines.push('', '## Matrix validation / materialize failures', '');
+    const badM = report.matrices.filter((r) => !r.ok || r.materializeOk === false);
+    if (badM.length === 0)
+        lines.push('_(none)_');
+    else {
+        for (const r of badM) {
+            const bits = [
+                !r.ok ? 'payload invalid' : null,
+                r.materializeOk === false ? `materialize: ${r.materializeError ?? '?'}` : null,
+            ]
+                .filter(Boolean)
+                .join(' · ');
+            lines.push(`- **${r.catalogId}** / ${r.itemId} (${(r.graphIds ?? []).join(', ') || '—'}): ${bits}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Lists all native catalogs (super-admin), pages native items, validates **graphs** / **execution-matrix**
+ * rows using this package’s loaders, then runs {@link buildMatrixMaterializeContext} for each matrix item
+ * against the union of successfully parsed graph definitions (keyed by **`graphId`**).
+ */
+export async function runCataloxExecutionMatrixInventory(catalox, options) {
+    const ctx = {
+        superAdmin: true,
+        userId: 'exellix-runtime-catalox-inventory',
+        actor: { type: 'system', id: '@exellix/exellix-runtime' },
+        ...options?.context,
+    };
+    const pageSize = Math.max(50, Math.min(options?.pageSize ?? DEFAULT_PAGE, 2000));
+    const catalogs = await catalox.listAllCatalogs(ctx, { includeDisabled: true, includeHidden: true });
+    const catalogRows = [];
+    const graphRows = [];
+    const matrixRows = [];
+    const graphItemsByGraphId = new Map();
+    const allMatrixItems = [];
+    let itemsListed = 0;
+    let graphItemsAttempted = 0;
+    let graphItemsOk = 0;
+    let matrixItemsAttempted = 0;
+    let matrixItemsOk = 0;
+    let matrixMaterializeOk = 0;
+    let nativeCatalogs = 0;
+    for (const cat of catalogs) {
+        if (cat.sourceMode !== 'native') {
+            catalogRows.push({
+                catalogId: cat.catalogId,
+                label: cat.label,
+                sourceMode: cat.sourceMode,
+                catalogType: cat.catalogType,
+                itemCount: 0,
+            });
+            continue;
+        }
+        nativeCatalogs += 1;
+        const items = [];
+        let offset = 0;
+        let listOutcome = 'ok';
+        let listError;
+        for (;;) {
+            try {
+                const page = await catalox.listCatalogItems(ctx, cat.catalogId, {
+                    limit: pageSize,
+                    offset,
+                    scope: { superAdmin: true },
+                });
+                listOutcome = page.listOutcome;
+                if (page.listOutcome !== 'ok') {
+                    listError = page.issues?.map((i) => `${i.severity ?? ''}:${JSON.stringify(i)}`).join('; ');
+                    break;
+                }
+                items.push(...page.items);
+                if (page.items.length < pageSize)
+                    break;
+                offset += page.items.length;
+            }
+            catch (e) {
+                listError = e instanceof Error ? e.message : String(e);
+                break;
+            }
+        }
+        itemsListed += items.length;
+        catalogRows.push({
+            catalogId: cat.catalogId,
+            label: cat.label,
+            sourceMode: cat.sourceMode,
+            catalogType: cat.catalogType,
+            itemCount: items.length,
+            listOutcome,
+            listError,
+        });
+        for (const item of items) {
+            const meta = item.metadata;
+            if (isGraphCatalogMetadata(meta)) {
+                graphItemsAttempted += 1;
+                try {
+                    const record = graphCatalogPayloadFromCatalogItem(itemToNativeLike(item));
+                    graphItemsOk += 1;
+                    graphItemsByGraphId.set(record.graphId, itemToNativeLike(item));
+                }
+                catch (e) {
+                    const issues = e instanceof ExecutionMatrixCatalogValidationError
+                        ? e.issues
+                        : undefined;
+                    graphRows.push({
+                        catalogId: cat.catalogId,
+                        itemId: item.itemId,
+                        ok: false,
+                        issues: [
+                            {
+                                kind: 'graph',
+                                message: e instanceof Error ? e.message : String(e),
+                                issues,
+                            },
+                        ],
+                    });
+                }
+            }
+            else if (isExecutionMatrixCatalogMetadata(meta)) {
+                allMatrixItems.push({ catalogId: cat.catalogId, item });
+            }
+        }
+    }
+    for (const { catalogId, item } of allMatrixItems) {
+        matrixItemsAttempted += 1;
+        let graphIds;
+        let ok = false;
+        let issues;
+        let materializeOk;
+        let materializeError;
+        try {
+            const payload = executionMatrixPayloadFromCatalogItem(itemToNativeLike(item));
+            graphIds = payload.graphs;
+            ok = true;
+            matrixItemsOk += 1;
+            try {
+                buildMatrixMaterializeContext(itemToNativeLike(item), graphItemsByGraphId);
+                materializeOk = true;
+                matrixMaterializeOk += 1;
+            }
+            catch (e) {
+                materializeOk = false;
+                materializeError = e instanceof Error ? e.message : String(e);
+            }
+        }
+        catch (e) {
+            const iss = e instanceof ExecutionMatrixCatalogValidationError
+                ? e.issues
+                : undefined;
+            issues = [
+                {
+                    kind: 'execution-matrix',
+                    message: e instanceof Error ? e.message : String(e),
+                    issues: iss,
+                },
+            ];
+        }
+        matrixRows.push({
+            catalogId,
+            itemId: item.itemId,
+            ok,
+            graphIds,
+            issues,
+            materializeOk,
+            materializeError,
+        });
+    }
+    return {
+        generatedAt: new Date().toISOString(),
+        context: ctx,
+        catalogs: catalogRows,
+        summary: {
+            nativeCatalogs,
+            itemsListed,
+            graphItemsAttempted,
+            graphItemsOk,
+            graphValidationFailures: graphRows.length,
+            matrixItemsAttempted,
+            matrixItemsOk,
+            matrixMaterializeOk,
+            matrixMaterializeFailures: matrixRows.filter((r) => r.ok && r.materializeOk === false).length,
+            matrixPayloadFailures: matrixRows.filter((r) => !r.ok).length,
+        },
+        graphs: graphRows,
+        matrices: matrixRows,
+    };
+}
+//# sourceMappingURL=catalox-execution-matrix-inventory.js.map

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

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