@exellix/exellix-jobs 1.6.1

package/README.md

@@ -0,0 +1,103 @@
+# `@exellix/exellix-jobs`
+
+Execution-matrix **worker** package: supervised `runMatrixContinuously` loops, operator HTTP (`/health`, `/metrics`, graph PATCH), and Prometheus metrics — wired to **`@exellix/exellix-runtime` ≥ 3.1** and **matrix persistence via `createExellixMatrixDataTier`** (legacy xronox-factory fallback optional).
+
+Normative behavior is specified in [`docs/specs.md`](./docs/specs.md). [`docs/execution-matrix-worker-service.md`](./docs/execution-matrix-worker-service.md) is a short historical pointer. HTTP routes are cataloged in [`docs/openapi.yaml`](./docs/openapi.yaml). **Local issues (404 PATCH paths, tombstoned graphs, idle worker, …):** [`docs/troubleshooting.md`](./docs/troubleshooting.md).
+
+## Graph execution input (record placement)
+
+Peer contract for where the work-unit record goes on `executeGraph` and matrix runs: [`../exellix-runtime/docs/graph-execution-record-placement.md`](../exellix-runtime/docs/graph-execution-record-placement.md).
+
+This worker **does not** call `executeGraph` itself. It passes your host `executeGraph` into `@exellix/exellix-runtime`, which builds `{ model, runtime }` and sets **`runtime.input = record.input`** at claim time.
+
+| Phase | Where the record lives |
+|-------|-------------------------|
+| Materialize | `ExecutionMatrixRuntimeRecord.input` — flat field names (`subnetId`, `question`, …), not `input.raw` |
+| Execute | `runtime.input` on the graph-engine request (same blob as row `input`) |
+
+**Host responsibilities:** supply **`sourceResolver`** / **`inputRows`** so materialized row `input` uses **flat keys** matching `metadata.graphEntry.inputs` (requires **`@exellix/graph-engine` ≥ 5.16**). Wrap production executors with **`createMatrixExecuteGraphAdapter`** from runtime when adding `modelConfig` defaults (see [`examples/host-bootstrap.mjs`](./examples/host-bootstrap.mjs)).
+
+## Constraints
+
+- **No** direct `mongodb` or `@x12i/xronox-store` dependency in this package’s `package.json` or source imports.
+- Matrix collections are **xronox-shaped handles** from **`createExellixMatrixDataTier`** on `@exellix/exellix-runtime`, or via `openExellixMatrixPersistence()` / `openExellixMatrixPersistenceFromRuntimeFactories()` as a bridge.
+
+## Programmatic API
+
+```ts
+import { createExellixMatrixDataTier } from '@exellix/exellix-runtime';
+import {
+  createMatrixWorker,
+  startMatrixWorkerHttp,
+  loadJobsEnv,
+} from '@exellix/exellix-jobs';
+
+const env = loadJobsEnv();
+const tier = await createExellixMatrixDataTier({
+  mongoUri: process.env.MONGO_URI,
+  executionDb: env.executionDb,
+  configDb: env.configDb,
+});
+const persistence = {
+  rows: tier.rows,
+  failures: tier.failures,
+  snapshots: tier.snapshots,
+  matrices: tier.matrices,
+  graphs: tier.graphs,
+  close: () => tier.close(),
+  ...(tier.probe ? { probe: tier.probe } : {}),
+};
+
+const worker = await createMatrixWorker({
+  persistence,
+  matrixWorkerId: env.matrixWorkerId,
+  executeGraph: graphRuntime.executeGraph.bind(graphRuntime),
+  resolveGraphModel: async ({ graphId }) => { /* … */ },
+  sourceResolver,
+  graphSchedulabilityRequireConfig: env.graphSchedulabilityStrict,
+  maxConcurrentClaims: env.maxConcurrentClaims,
+});
+
+const ac = new AbortController();
+void worker.startSupervised(ac.signal);
+await startMatrixWorkerHttp({ worker, env: loadJobsEnv() });
+```
+
+## CLI
+
+`exellix-jobs serve` loads an application bootstrap module so graph-engine wiring stays in the host:
+
+- Set **`EXELLIX_JOBS_HOST_BOOTSTRAP`** to an absolute path of an ESM file whose **default export** is an `async function` returning `{ workerOptions }` (see `CreateMatrixWorkerOptions`).
+- See [`examples/host-bootstrap.mjs`](./examples/host-bootstrap.mjs) for **`createExellixMatrixDataTier`** + env wiring; set **`EXELLIX_JOBS_GRAPH_ENGINE_BOOTSTRAP`** for `executeGraph` / `resolveGraphModel`.
+
+```bash
+npm run jobs:serve
+```
+
+Operator routes use suffix paths — e.g. `PATCH /v1/graphs/{graphId}/operational`, not `PATCH /v1/graphs/{graphId}`. See [`docs/troubleshooting.md`](./docs/troubleshooting.md).
+
+Optional: install `@x12i/env` next to this package for `.env` loading via dynamic import in the CLI.
+
+## Environment
+
+See `docs/specs.md` §12. Implemented keys include:
+
+| Variable | Purpose |
+|----------|---------|
+| `PORT` | HTTP listen port |
+| `JOBS_HTTP_PREFIX` | Route prefix (default `/v1`) |
+| `MATRIX_WORKER_ID` | Identity in `/health` and `/workers/status` |
+| `execution_db` / `config_db` | Persistence DB names |
+| `EXELLIX_JOBS_MAX_CONCURRENT_CLAIMS` | Global parallelism |
+| `EXELLIX_JOBS_GRAPH_SCHEDULABILITY_STRICT` | Schedulability flag |
+| `EXELLIX_JOBS_HTTP_ENABLED` | Start HTTP server |
+| `EXELLIX_JOBS_API_KEY` | Mutating HTTP routes |
+| `EXELLIX_JOBS_ACTIVIX_SCHEDULER_PROBE` | Activix lane on dependency probe |
+
+## HA note
+
+Multiple replicas claiming the same matrix without coordination can double-execute; see `docs/specs.md` §15.
+
+## Read tier (entity + graph history)
+
+Job counts, slot status, and execution output for dashboards live in **`@exellix/exellix-matrix-read`** (sibling package) — not in this worker. Use it from BFF/Studio; keep this package for claim/execute only.

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { type CreateMatrixWorkerOptions } from './worker/matrix-worker.js';
+export type HostBootstrapResult = {
+    workerOptions: CreateMatrixWorkerOptions;
+};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAIA,OAAO,EAAsB,KAAK,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAG/F,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,EAAE,yBAAyB,CAAC;CAC1C,CAAC"}

package/dist/cli.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { loadJobsEnv } from './env.js';
+import { createMatrixWorker } from './worker/matrix-worker.js';
+import { startMatrixWorkerHttp } from './http/server.js';
+async function loadDotenvIfAvailable() {
+    const registerPath = '@x12i/env/register';
+    await import(registerPath).catch(() => undefined);
+}
+function defaultHostBootstrapPath() {
+    return join(dirname(fileURLToPath(import.meta.url)), '..', 'examples', 'host-bootstrap.mjs');
+}
+async function loadHostBootstrap() {
+    const p = process.env.EXELLIX_JOBS_HOST_BOOTSTRAP ?? defaultHostBootstrapPath();
+    if (!process.env.EXELLIX_JOBS_HOST_BOOTSTRAP) {
+        console.error(`@exellix/exellix-jobs: using default host bootstrap ${p}`);
+    }
+    const href = p.startsWith('file:') ? p : pathToFileURL(resolve(p)).href;
+    const mod = (await import(href));
+    if (typeof mod.default !== 'function') {
+        throw new Error('Host bootstrap module must default-export an async function.');
+    }
+    return mod.default;
+}
+function mergeWorkerOptionsFromEnv(options) {
+    const env = loadJobsEnv();
+    return {
+        ...options,
+        ...(options.matrixWorkerId === undefined && env.matrixWorkerId !== undefined
+            ? { matrixWorkerId: env.matrixWorkerId }
+            : {}),
+        ...(options.maxConcurrentClaims === undefined ? { maxConcurrentClaims: env.maxConcurrentClaims } : {}),
+        ...(options.graphSchedulabilityRequireConfig === undefined
+            ? { graphSchedulabilityRequireConfig: env.graphSchedulabilityStrict }
+            : {}),
+    };
+}
+async function cmdServe() {
+    await loadDotenvIfAvailable();
+    const factory = await loadHostBootstrap();
+    const { workerOptions } = await factory();
+    const worker = await createMatrixWorker(mergeWorkerOptionsFromEnv(workerOptions));
+    const env = loadJobsEnv();
+    const ac = new AbortController();
+    const { signal } = ac;
+    const supervised = worker.startSupervised(signal).catch((err) => {
+        console.error('supervisor failed', err);
+        process.exitCode = 1;
+    });
+    let http;
+    if (env.httpEnabled) {
+        http = await startMatrixWorkerHttp({ worker, env });
+        console.error(`@exellix/exellix-jobs listening on port ${env.port} (prefix ${env.httpPrefix})`);
+    }
+    const shutdown = async () => {
+        ac.abort();
+        await supervised;
+        await http?.close();
+        await worker.close();
+    };
+    for (const ev of ['SIGINT', 'SIGTERM']) {
+        process.on(ev, () => {
+            void shutdown().then(() => process.exit(0));
+        });
+    }
+}
+async function main() {
+    const cmd = process.argv[2] ?? 'help';
+    if (cmd === 'serve') {
+        await cmdServe();
+        return;
+    }
+    if (cmd === 'help' || cmd === '-h' || cmd === '--help') {
+        // eslint-disable-next-line no-console
+        console.log(`@exellix/exellix-jobs
+
+Commands:
+  serve   Start supervised matrix loops + operator HTTP (default bootstrap: examples/host-bootstrap.mjs).
+
+Environment (subset — see README and docs/specs.md §12):
+  EXELLIX_JOBS_HOST_BOOTSTRAP              ESM host module (defaults to examples/host-bootstrap.mjs).
+  EXELLIX_JOBS_GRAPH_ENGINE_BOOTSTRAP      Graph executor module (defaults to examples/graph-engine-stub.mjs).
+  PORT                                     HTTP listen port (default 8080).
+  JOBS_HTTP_PREFIX                         Base path prefix (default /v1).
+  EXELLIX_JOBS_API_KEY                     API key for mutating HTTP routes.
+  Mutating graph routes: PATCH /v1/graphs/:id/operational | /publication (see docs/troubleshooting.md).
+  MATRIX_WORKER_ID                         Worker identity in /health and /workers/status.
+  EXELLIX_JOBS_ACTIVIX_SCHEDULER_PROBE     When true, /health?probe=dependencies includes Activix lane.
+  execution_db / config_db                 DB names for persistence openers (default exellix-runtime / exellix).
+`);
+        return;
+    }
+    throw new Error(`Unknown command: ${cmd}`);
+}
+main().catch((e) => {
+    console.error(e);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/collections.d.ts

@@ -0,0 +1,28 @@
+import { createExecutionMatrixRuntime, type ExellixRuntimeConnectivityProbeOptions } from '@exellix/exellix-runtime';
+/** xronox-shaped collection handle expected by `@exellix/exellix-runtime` factories (sourced from XMemory tier, not imported from `@x12i/xronox-store` here). */
+export type MatrixPersistenceCollection = Parameters<typeof createExecutionMatrixRuntime>[0];
+export type ExellixMatrixPersistenceProbeHandles = Pick<ExellixRuntimeConnectivityProbeOptions, 'executionStore' | 'configStore' | 'executionMongoUri' | 'configMongoUri' | 'executionPingCollection' | 'configPingCollection'>;
+export type ExellixMatrixPersistenceHandles = {
+    rows: MatrixPersistenceCollection;
+    failures: MatrixPersistenceCollection;
+    snapshots?: MatrixPersistenceCollection;
+    matrices: MatrixPersistenceCollection;
+    graphs: MatrixPersistenceCollection;
+    /** Optional tier hook (e.g. pool warm-up). */
+    init?: () => Promise<void>;
+    close: () => Promise<void>;
+    /** Optional handles for `/health?probe=dependencies`. */
+    probe?: ExellixMatrixPersistenceProbeHandles;
+};
+export type OpenExellixMatrixPersistenceOptions = {
+    mongoUri?: string;
+    executionDb?: string;
+    configDb?: string;
+    /**
+     * When `createExellixMatrixDataTier` is missing from `@exellix/exellix-runtime` (peer before 3.1), fall back to
+     * legacy xronox factories on runtime (default `true` for {@link openExellixMatrixPersistence}).
+     */
+    fallbackToRuntimeFactories?: boolean;
+    [key: string]: unknown;
+};
+//# sourceMappingURL=collections.d.ts.map

package/dist/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,KAAK,sCAAsC,EAAE,MAAM,0BAA0B,CAAC;AAErH,iKAAiK;AACjK,MAAM,MAAM,2BAA2B,GAAG,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7F,MAAM,MAAM,oCAAoC,GAAG,IAAI,CACrD,sCAAsC,EACtC,gBAAgB,GAAG,aAAa,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,yBAAyB,GAAG,sBAAsB,CAC/H,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,2BAA2B,CAAC;IAClC,QAAQ,EAAE,2BAA2B,CAAC;IACtC,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC,QAAQ,EAAE,2BAA2B,CAAC;IACtC,MAAM,EAAE,2BAA2B,CAAC;IACpC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,yDAAyD;IACzD,KAAK,CAAC,EAAE,oCAAoC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC"}

package/dist/collections.js

@@ -0,0 +1,2 @@
+import { createExecutionMatrixRuntime } from '@exellix/exellix-runtime';
+//# sourceMappingURL=collections.js.map

package/dist/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAA+C,MAAM,0BAA0B,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,17 @@
+export type JobsEnv = {
+    port: number;
+    httpPrefix: string;
+    matrixWorkerId?: string;
+    maxConcurrentClaims: number;
+    graphSchedulabilityStrict: boolean;
+    httpEnabled: boolean;
+    apiKey?: string;
+    executionDb: string;
+    configDb: string;
+    activixSchedulerProbe: boolean;
+};
+/**
+ * Reads operator-oriented environment variables (see `docs/specs.md` §12).
+ */
+export declare function loadJobsEnv(env?: NodeJS.ProcessEnv): JobsEnv;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yBAAyB,EAAE,OAAO,CAAC;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,OAAO,CAAC;CAChC,CAAC;AAwBF;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAazE"}

package/dist/env.js

@@ -0,0 +1,38 @@
+function parseIntEnv(value, fallback) {
+    if (value === undefined || value === '') {
+        return fallback;
+    }
+    const n = Number.parseInt(value, 10);
+    return Number.isFinite(n) ? n : fallback;
+}
+function parseBoolEnv(value, fallback) {
+    if (value === undefined || value === '') {
+        return fallback;
+    }
+    const v = value.trim().toLowerCase();
+    if (['1', 'true', 'yes', 'on'].includes(v)) {
+        return true;
+    }
+    if (['0', 'false', 'no', 'off'].includes(v)) {
+        return false;
+    }
+    return fallback;
+}
+/**
+ * Reads operator-oriented environment variables (see `docs/specs.md` §12).
+ */
+export function loadJobsEnv(env = process.env) {
+    return {
+        port: parseIntEnv(env.PORT, 8080),
+        httpPrefix: (env.JOBS_HTTP_PREFIX ?? '/v1').replace(/\/$/, '') || '/v1',
+        matrixWorkerId: env.MATRIX_WORKER_ID?.trim() || undefined,
+        maxConcurrentClaims: Math.max(1, parseIntEnv(env.EXELLIX_JOBS_MAX_CONCURRENT_CLAIMS, 4)),
+        graphSchedulabilityStrict: parseBoolEnv(env.EXELLIX_JOBS_GRAPH_SCHEDULABILITY_STRICT, false),
+        httpEnabled: parseBoolEnv(env.EXELLIX_JOBS_HTTP_ENABLED, true),
+        apiKey: env.EXELLIX_JOBS_API_KEY?.trim() || undefined,
+        executionDb: env.execution_db?.trim() || 'exellix-runtime',
+        configDb: env.config_db?.trim() || 'exellix',
+        activixSchedulerProbe: parseBoolEnv(env.EXELLIX_JOBS_ACTIVIX_SCHEDULER_PROBE, false),
+    };
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAaA,SAAS,WAAW,CAAC,KAAyB,EAAE,QAAgB;IAC9D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACxC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC3C,CAAC;AAED,SAAS,YAAY,CAAC,KAAyB,EAAE,QAAiB;IAChE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACxC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC9D,OAAO;QACL,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC;QACjC,UAAU,EAAE,CAAC,GAAG,CAAC,gBAAgB,IAAI,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK;QACvE,cAAc,EAAE,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,SAAS;QACzD,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,kCAAkC,EAAE,CAAC,CAAC,CAAC;QACxF,yBAAyB,EAAE,YAAY,CAAC,GAAG,CAAC,wCAAwC,EAAE,KAAK,CAAC;QAC5F,WAAW,EAAE,YAAY,CAAC,GAAG,CAAC,yBAAyB,EAAE,IAAI,CAAC;QAC9D,MAAM,EAAE,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,IAAI,SAAS;QACrD,WAAW,EAAE,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,iBAAiB;QAC1D,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,SAAS;QAC5C,qBAAqB,EAAE,YAAY,CAAC,GAAG,CAAC,oCAAoC,EAAE,KAAK,CAAC;KACrF,CAAC;AACJ,CAAC"}

package/dist/http/health.d.ts

@@ -0,0 +1,10 @@
+import { buildExellixRuntimeRealLivenessPayload, type ExellixRuntimeConnectivityProbeOptions, type ExellixRuntimeHealthPayload } from '@exellix/exellix-runtime';
+import type { JobsEnv } from '../env.js';
+import type { MatrixWorker } from '../worker/matrix-worker.js';
+export type JobsLivenessPayload = ReturnType<typeof buildExellixRuntimeRealLivenessPayload> & {
+    matrixWorkerId?: string;
+};
+export declare function buildJobsLivenessPayload(env: JobsEnv): JobsLivenessPayload;
+export declare function buildJobsConnectivityProbeOptions(worker: MatrixWorker, env: JobsEnv): ExellixRuntimeConnectivityProbeOptions;
+export declare function runJobsConnectivityProbe(worker: MatrixWorker, env: JobsEnv): Promise<ExellixRuntimeHealthPayload>;
+//# sourceMappingURL=health.d.ts.map

package/dist/http/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/http/health.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sCAAsC,EAEtC,KAAK,sCAAsC,EAC3C,KAAK,2BAA2B,EACjC,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,sCAAsC,CAAC,GAAG;IAC5F,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,CAK1E;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,OAAO,GACX,sCAAsC,CAQxC;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,2BAA2B,CAAC,CAEtC"}

package/dist/http/health.js

@@ -0,0 +1,20 @@
+import { buildExellixRuntimeRealLivenessPayload, runExellixRuntimeConnectivityProbe, } from '@exellix/exellix-runtime';
+export function buildJobsLivenessPayload(env) {
+    return {
+        ...buildExellixRuntimeRealLivenessPayload(),
+        ...(env.matrixWorkerId !== undefined ? { matrixWorkerId: env.matrixWorkerId } : {}),
+    };
+}
+export function buildJobsConnectivityProbeOptions(worker, env) {
+    const probe = worker.connectivityProbe ?? {};
+    return {
+        ...probe,
+        includeXmemoryEnv: probe.includeXmemoryEnv ?? true,
+        ...(env.activixSchedulerProbe ? { includeActivixSchedulerProbe: true } : {}),
+        ...(env.matrixWorkerId !== undefined ? { workerIdentity: env.matrixWorkerId } : {}),
+    };
+}
+export async function runJobsConnectivityProbe(worker, env) {
+    return runExellixRuntimeConnectivityProbe(buildJobsConnectivityProbeOptions(worker, env));
+}
+//# sourceMappingURL=health.js.map

package/dist/http/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/http/health.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sCAAsC,EACtC,kCAAkC,GAGnC,MAAM,0BAA0B,CAAC;AAQlC,MAAM,UAAU,wBAAwB,CAAC,GAAY;IACnD,OAAO;QACL,GAAG,sCAAsC,EAAE;QAC3C,GAAG,CAAC,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,MAAoB,EACpB,GAAY;IAEZ,MAAM,KAAK,GAAG,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC;IAC7C,OAAO;QACL,GAAG,KAAK;QACR,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,IAAI,IAAI;QAClD,GAAG,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,4BAA4B,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAoB,EACpB,GAAY;IAEZ,OAAO,kCAAkC,CAAC,iCAAiC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AAC5F,CAAC"}

package/dist/http/server.d.ts

@@ -0,0 +1,10 @@
+import { type FastifyInstance } from 'fastify';
+import type { JobsEnv } from '../env.js';
+import type { MatrixWorker } from '../worker/matrix-worker.js';
+export type StartMatrixWorkerHttpOptions = {
+    worker: MatrixWorker;
+    env?: JobsEnv;
+    host?: string;
+};
+export declare function startMatrixWorkerHttp(opts: StartMatrixWorkerHttpOptions): Promise<FastifyInstance>;
+//# sourceMappingURL=server.d.ts.map

package/dist/http/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/http/server.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,KAAK,eAAe,EAA0C,MAAM,SAAS,CAAC;AAChG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AA6B/D,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,4BAA4B,GAAG,OAAO,CAAC,eAAe,CAAC,CAuExG"}

package/dist/http/server.js

@@ -0,0 +1,85 @@
+import Fastify, {} from 'fastify';
+import { loadJobsEnv } from '../env.js';
+import { listGraphSummaries } from '../worker/discovery.js';
+import { buildJobsLivenessPayload, runJobsConnectivityProbe } from './health.js';
+function assertMutationAuthorized(env, req, reply) {
+    if (!env.apiKey) {
+        void reply.code(501).send({
+            error: 'Mutations are disabled until EXELLIX_JOBS_API_KEY is configured (see docs/specs.md §10).',
+        });
+        return false;
+    }
+    const header = req.headers['x-exellix-jobs-api-key'];
+    const bearer = req.headers.authorization?.match(/^Bearer\s+(.+)$/i)?.[1];
+    const presented = (typeof header === 'string' ? header : undefined) ?? bearer;
+    if (presented !== env.apiKey) {
+        void reply.code(401).send({ error: 'Unauthorized' });
+        return false;
+    }
+    return true;
+}
+function readQueryParam(req, key) {
+    if (typeof req.query !== 'object' || !req.query || !(key in req.query)) {
+        return undefined;
+    }
+    const value = req.query[key];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+export async function startMatrixWorkerHttp(opts) {
+    const env = opts.env ?? loadJobsEnv();
+    const fastify = Fastify({ logger: true });
+    await fastify.register(async (app) => {
+        app.get('/health', async (req) => {
+            const probe = readQueryParam(req, 'probe');
+            if (probe === 'dependencies') {
+                return runJobsConnectivityProbe(opts.worker, env);
+            }
+            return buildJobsLivenessPayload(env);
+        });
+        app.get('/graphs', async () => listGraphSummaries(opts.worker.configStore));
+        app.get('/workers/status', async (req) => {
+            const matrixCatalogId = readQueryParam(req, 'matrixCatalogId');
+            return opts.worker.getStatus(matrixCatalogId ? { matrixCatalogId } : undefined);
+        });
+        app.get('/metrics', async (_req, reply) => {
+            reply.header('content-type', 'text/plain; version=0.0.4; charset=utf-8');
+            return opts.worker.metrics.registry.metrics();
+        });
+        const patchGraph = async (req, reply) => {
+            if (!assertMutationAuthorized(env, req, reply)) {
+                return;
+            }
+            const { graphId } = req.params;
+            const body = req.body;
+            if (body?.expectedVersion === undefined || typeof body.expectedVersion !== 'number') {
+                return reply.code(400).send({ error: 'expectedVersion (number) is required' });
+            }
+            const rec = await opts.worker.configStore.graphs.patchOperational({
+                graphId,
+                expectedVersion: body.expectedVersion,
+                ...(body.operationalState !== undefined ? { operationalState: body.operationalState } : {}),
+                ...(body.publicationStatus !== undefined ? { publicationStatus: body.publicationStatus } : {}),
+            });
+            return rec;
+        };
+        app.patch('/graphs/:graphId/operational', patchGraph);
+        app.patch('/graphs/:graphId/publication', patchGraph);
+        app.post('/workers/pause', async (req, reply) => {
+            if (!assertMutationAuthorized(env, req, reply)) {
+                return;
+            }
+            opts.worker.pauseController.pause();
+            return { paused: true };
+        });
+        app.post('/workers/resume', async (req, reply) => {
+            if (!assertMutationAuthorized(env, req, reply)) {
+                return;
+            }
+            opts.worker.pauseController.resume();
+            return { paused: false };
+        });
+    }, { prefix: env.httpPrefix });
+    await fastify.listen({ port: env.port, host: opts.host ?? '0.0.0.0' });
+    return fastify;
+}
+//# sourceMappingURL=server.js.map

package/dist/http/server.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { createMatrixWorker, type CreateMatrixWorkerOptions, type MatrixAssignment, type MatrixWorker, type MatrixWorkerStatus, discoverMatrixAssignments, listGraphSummaries, } from './worker/matrix-worker.js';
+export { runMatrixContinuouslyByCatalogIdWithMetrics } from './worker/continuous-loop.js';
+export type { RunMatrixContinuouslyByCatalogIdWithMetricsOptions } from './worker/continuous-loop.js';
+export { wrapMatrixGraphExecutor, type WrapMatrixGraphExecutorOptions } from './worker/wrap-execute-graph.js';
+export { startMatrixWorkerHttp, type StartMatrixWorkerHttpOptions } from './http/server.js';
+export { buildJobsLivenessPayload, runJobsConnectivityProbe } from './http/health.js';
+export { loadJobsEnv, type JobsEnv } from './env.js';
+export { createJobsMetrics, type JobsMetrics } from './metrics.js';
+export type { ExellixMatrixPersistenceHandles, ExellixMatrixPersistenceProbeHandles, MatrixPersistenceCollection, OpenExellixMatrixPersistenceOptions, } from './collections.js';
+export { openExellixMatrixPersistenceFromXmemoryStore } from './xmemory-matrix-tier.js';
+export { openExellixMatrixPersistenceFromRuntimeFactories } from './runtime-matrix-tier.js';
+export { openExellixMatrixPersistence } from './open-matrix-persistence.js';
+export { resolveMatrixPersistenceOptionsFromEnv } from './persistence-env.js';
+export { createInMemoryMatrixPersistence } from './memory-matrix-tier.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,2CAA2C,EAAE,MAAM,6BAA6B,CAAC;AAC1F,YAAY,EAAE,kDAAkD,EAAE,MAAM,6BAA6B,CAAC;AACtG,OAAO,EAAE,uBAAuB,EAAE,KAAK,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAC9G,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EACV,+BAA+B,EAC/B,oCAAoC,EACpC,2BAA2B,EAC3B,mCAAmC,GACpC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,4CAA4C,EAAE,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAE,gDAAgD,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,sCAAsC,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export { createMatrixWorker, discoverMatrixAssignments, listGraphSummaries, } from './worker/matrix-worker.js';
+export { runMatrixContinuouslyByCatalogIdWithMetrics } from './worker/continuous-loop.js';
+export { wrapMatrixGraphExecutor } from './worker/wrap-execute-graph.js';
+export { startMatrixWorkerHttp } from './http/server.js';
+export { buildJobsLivenessPayload, runJobsConnectivityProbe } from './http/health.js';
+export { loadJobsEnv } from './env.js';
+export { createJobsMetrics } from './metrics.js';
+export { openExellixMatrixPersistenceFromXmemoryStore } from './xmemory-matrix-tier.js';
+export { openExellixMatrixPersistenceFromRuntimeFactories } from './runtime-matrix-tier.js';
+export { openExellixMatrixPersistence } from './open-matrix-persistence.js';
+export { resolveMatrixPersistenceOptionsFromEnv } from './persistence-env.js';
+export { createInMemoryMatrixPersistence } from './memory-matrix-tier.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAKlB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,2CAA2C,EAAE,MAAM,6BAA6B,CAAC;AAE1F,OAAO,EAAE,uBAAuB,EAAuC,MAAM,gCAAgC,CAAC;AAC9G,OAAO,EAAE,qBAAqB,EAAqC,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,WAAW,EAAgB,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAoB,MAAM,cAAc,CAAC;AAOnE,OAAO,EAAE,4CAA4C,EAAE,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAE,gDAAgD,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,sCAAsC,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/memory-matrix-tier.d.ts

@@ -0,0 +1,6 @@
+import type { ExellixMatrixPersistenceHandles } from './collections.js';
+/**
+ * In-memory matrix persistence for unit tests and local smoke runs without Mongo.
+ */
+export declare function createInMemoryMatrixPersistence(): Promise<ExellixMatrixPersistenceHandles>;
+//# sourceMappingURL=memory-matrix-tier.d.ts.map

package/dist/memory-matrix-tier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-matrix-tier.d.ts","sourceRoot":"","sources":["../src/memory-matrix-tier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,kBAAkB,CAAC;AAExE;;GAEG;AACH,wBAAsB,+BAA+B,IAAI,OAAO,CAAC,+BAA+B,CAAC,CAsBhG"}

package/dist/memory-matrix-tier.js

@@ -0,0 +1,20 @@
+/**
+ * In-memory matrix persistence for unit tests and local smoke runs without Mongo.
+ */
+export async function createInMemoryMatrixPersistence() {
+    const { MemoryMatrixCollection, MATRIX_ROW_PK, MATRIX_FAILURE_PK, MATRIX_SNAPSHOT_PK, MATRIX_CONFIG_PK, GRAPH_CONFIG_PK, } = await import('@exellix/exellix-runtime');
+    const rows = new MemoryMatrixCollection(MATRIX_ROW_PK).asCollection();
+    const failures = new MemoryMatrixCollection(MATRIX_FAILURE_PK).asCollection();
+    const snapshots = new MemoryMatrixCollection(MATRIX_SNAPSHOT_PK).asCollection();
+    const matrices = new MemoryMatrixCollection(MATRIX_CONFIG_PK).asCollection();
+    const graphs = new MemoryMatrixCollection(GRAPH_CONFIG_PK).asCollection();
+    return {
+        rows,
+        failures,
+        snapshots,
+        matrices,
+        graphs,
+        close: async () => undefined,
+    };
+}
+//# sourceMappingURL=memory-matrix-tier.js.map

package/dist/memory-matrix-tier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-matrix-tier.js","sourceRoot":"","sources":["../src/memory-matrix-tier.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B;IACnD,MAAM,EACJ,sBAAsB,EACtB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,GAChB,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAI,sBAAsB,CAAC,aAAa,CAAC,CAAC,YAAY,EAAE,CAAC;IACtE,MAAM,QAAQ,GAAG,IAAI,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,YAAY,EAAE,CAAC;IAC9E,MAAM,SAAS,GAAG,IAAI,sBAAsB,CAAC,kBAAkB,CAAC,CAAC,YAAY,EAAE,CAAC;IAChF,MAAM,QAAQ,GAAG,IAAI,sBAAsB,CAAC,gBAAgB,CAAC,CAAC,YAAY,EAAE,CAAC;IAC7E,MAAM,MAAM,GAAG,IAAI,sBAAsB,CAAC,eAAe,CAAC,CAAC,YAAY,EAAE,CAAC;IAC1E,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,SAAS;QACT,QAAQ;QACR,MAAM;QACN,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;KAC7B,CAAC;AACJ,CAAC"}

package/dist/metrics.d.ts

@@ -0,0 +1,13 @@
+import { Counter, Histogram, Registry } from 'prom-client';
+export type JobsMetrics = {
+    registry: Registry;
+    matrixClaimsStartedTotal: Counter<string>;
+    matrixClaimsCompletedTotal: Counter<string>;
+    matrixClaimsFailedTotal: Counter<string>;
+    matrixRowsMaterializedTotal: Counter<string>;
+    matrixWorkerIdleSecondsTotal: Counter<string>;
+    matrixWorkerCyclesTotal: Counter<string>;
+    executeGraphDurationSeconds: Histogram<string>;
+};
+export declare function createJobsMetrics(registry?: Registry<"text/plain; version=0.0.4; charset=utf-8">): JobsMetrics;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,wBAAwB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,0BAA0B,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,uBAAuB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,2BAA2B,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,4BAA4B,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,uBAAuB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,2BAA2B,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CAChD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,QAAQ,uDAAiB,GAAG,WAAW,CAsDxE"}