@gate-forge/witness 0.0.0-stage → 0.8.0

package/dist/queue/bullmq.js

@@ -0,0 +1,210 @@
+/**
+ * BullMQ implementation of the witness queue channel: the engine reads
+ * the queue itself over one Redis
+ * connection, and produces its own deliveries so a task case grades
+ * state the ENGINE created, not state the suite claims.
+ *
+ * Everything the engine cannot normalize fails closed
+ * (`QueueObserverError`): an unrecognized job state, an unbounded
+ * field, an unbounded list. A partial read is a diagnostic, never a
+ * proof.
+ */
+import { randomUUID } from 'node:crypto';
+import { Queue } from 'bullmq';
+import { Redis } from 'ioredis';
+import { DEFAULT_QUEUE_LIST_LIMIT, MAX_QUEUE_FIELD_CHARS, MAX_QUEUE_LIST_LIMIT, QUEUE_JOB_STATES, } from '@gate-forge/core';
+import { QueueObserverError, boundedQueueField, } from './observer.js';
+/** BullMQ job states, mapped onto the normalized vocabulary. */
+const STATE_MAP = {
+    completed: 'completed',
+    failed: 'failed',
+    delayed: 'delayed',
+    active: 'active',
+    waiting: 'waiting',
+    'waiting-children': 'waiting',
+    prioritized: 'prioritized',
+    paused: 'paused',
+    'waiting-active': 'active',
+};
+/** The queue job payload key carrying the engine's delivery identity. */
+export const DELIVERY_ID_KEY = 'gateforgeDeliveryId';
+/** The queue job payload key carrying the engine's idempotency key. */
+export const IDEMPOTENCY_KEY_KEY = 'gateforgeIdempotencyKey';
+/**
+ * The BullMQ job types a bounded list read covers. A paused queue
+ * holds its jobs in BullMQ's paused list, which this read does not
+ * enumerate: a paused delivery is therefore invisible here. Every
+ * delivered job is read by id first, so a pause still shows up as a
+ * non-terminal state there.
+ */
+const LISTED_JOB_TYPES = [
+    'waiting',
+    'waiting-children',
+    'active',
+    'prioritized',
+    'delayed',
+    'completed',
+    'failed',
+];
+/** The BullMQ job name every engine-produced delivery carries. */
+export const BULLMQ_DELIVERY_JOB_NAME = 'gateforge-delivery';
+/**
+ * Normalizes one BullMQ state, failing closed on anything unknown.
+ *
+ * Args:
+ *   state: the state BullMQ reported.
+ *
+ * Returns:
+ *   QueueJobState: the normalized state.
+ *
+ * @throws QueueObserverError the state is not in the normalized vocabulary.
+ */
+function normalizeState(state) {
+    const mapped = STATE_MAP[state];
+    if (mapped === undefined) {
+        throw new QueueObserverError(`bullmq reported job state '${state}', which has no normalized meaning (fail closed)`);
+    }
+    return mapped;
+}
+/**
+ * Projects one BullMQ job into the bounded engine observation. Every
+ * field is read from the QUEUE, never from the producer's own report.
+ *
+ * Args:
+ *   job: the BullMQ job handle.
+ *   state: its normalized state.
+ *
+ * Returns:
+ *   QueueJobObservation: the bounded observation.
+ *
+ * @throws QueueObserverError a field is unbounded or the wrong type.
+ */
+function observeJob(job, state) {
+    const attemptsMade = job.attemptsMade;
+    const maxAttempts = typeof job.opts.attempts === 'number' && job.opts.attempts > 0 ? job.opts.attempts : null;
+    return {
+        jobId: boundedQueueField(job.id, 'jobId') ?? '',
+        deliveryId: boundedQueueField(job.data[DELIVERY_ID_KEY] ?? null, 'deliveryId'),
+        idempotencyKey: boundedQueueField(job.data[IDEMPOTENCY_KEY_KEY] ?? null, 'idempotencyKey'),
+        state,
+        attemptsMade: typeof attemptsMade === 'number' && Number.isInteger(attemptsMade) && attemptsMade >= 0
+            ? attemptsMade
+            : (() => {
+                throw new QueueObserverError(`bullmq job '${String(job.id)}' reported a non-integer attempt count (fail closed)`);
+            })(),
+        maxAttempts,
+        failedReason: boundedQueueField(job.failedReason, 'failedReason'),
+        processedAt: typeof job.processedOn === 'number' && Number.isInteger(job.processedOn) ? job.processedOn : null,
+    };
+}
+/**
+ * Opens the BullMQ channel over one connection. One `Queue` handle per
+ * declared queue; every handle is closed exactly once.
+ *
+ * Args:
+ *   config: the validated engine-owned configuration.
+ *   connection: host/port or URL connection material.
+ *
+ * Returns:
+ *   QueueChannel: the opened observer + deliverer.
+ */
+export function createBullmqChannel(config, connection) {
+    const clientsByName = new Map();
+    const queueByName = new Map();
+    const bindings = new Map();
+    for (const binding of config.queues) {
+        if (bindings.has(binding.taskResourceId)) {
+            throw new QueueObserverError(`task resource '${binding.taskResourceId}' is bound to more than one queue (fail closed)`);
+        }
+        bindings.set(binding.taskResourceId, binding.name);
+    }
+    const queueFor = (name) => {
+        const existing = queueByName.get(name);
+        if (existing !== undefined)
+            return existing;
+        // An explicit client instance: BullMQ's CJS dynamic require of
+        // ioredis does not resolve in this ESM package, and a constructed
+        // client is the documented ESM form.
+        // ioredis takes the URL as its first argument (a `{url}` option is
+        // ignored and silently falls back to localhost).
+        const client = 'url' in connection
+            ? new Redis(connection.url, { maxRetriesPerRequest: null })
+            : new Redis({ ...connection, maxRetriesPerRequest: null });
+        clientsByName.set(name, client);
+        const created = new Queue(name, { connection: client });
+        queueByName.set(name, created);
+        return created;
+    };
+    const close = async () => {
+        const handles = [...queueByName.values()];
+        const clients = [...clientsByName.values()];
+        queueByName.clear();
+        clientsByName.clear();
+        await Promise.all(handles.map((handle) => handle.close()));
+        await Promise.all(clients.map((client) => client.quit()));
+    };
+    const observer = {
+        kind: 'bullmq',
+        queueFor: (taskResourceId) => {
+            const queue = bindings.get(taskResourceId);
+            if (queue === undefined) {
+                throw new QueueObserverError(`task resource '${taskResourceId}' has no declared queue binding (fail closed)`);
+            }
+            return queue;
+        },
+        readJob: async (queue, jobId) => {
+            const job = await queueFor(queue).getJob(jobId);
+            if (job === undefined)
+                return null;
+            return observeJob(job, normalizeState(await job.getState()));
+        },
+        listJobs: async (queue, limit = DEFAULT_QUEUE_LIST_LIMIT) => {
+            if (!Number.isInteger(limit) || limit < 1 || limit > MAX_QUEUE_LIST_LIMIT) {
+                throw new QueueObserverError(`queue list limit ${String(limit)} is outside [1, ${String(MAX_QUEUE_LIST_LIMIT)}] (fail closed)`);
+            }
+            const jobs = await queueFor(queue).getJobs([...LISTED_JOB_TYPES], 0, limit, false);
+            if (jobs.length >= limit) {
+                // A full page may be exactly the queue's size, so the read is
+                // reported as incomplete rather than pretending it is exact.
+                return { jobs: [], complete: false, count: jobs.length };
+            }
+            const observed = [];
+            for (const job of jobs) {
+                observed.push(observeJob(job, normalizeState(await job.getState())));
+            }
+            return { jobs: observed, complete: true, count: observed.length };
+        },
+        close,
+    };
+    const deliverer = {
+        enqueue: async (request) => {
+            if (request.deliveryId.length === 0 || request.deliveryId.length > MAX_QUEUE_FIELD_CHARS) {
+                throw new QueueObserverError('the engine delivery identity is missing or over the bound (fail closed)');
+            }
+            if (request.idempotencyKey.length === 0 || request.idempotencyKey.length > MAX_QUEUE_FIELD_CHARS) {
+                throw new QueueObserverError('the engine idempotency key is missing or over the bound (fail closed)');
+            }
+            if (!Number.isInteger(request.maxAttempts) || request.maxAttempts < 1) {
+                throw new QueueObserverError('the declared attempt bound must be a positive integer (fail closed)');
+            }
+            // BullMQ forbids ':' in a custom job id, so the job id stays
+            // engine-generated and the owner's identity rides in the data.
+            const job = await queueFor(request.queue).add(BULLMQ_DELIVERY_JOB_NAME, {
+                ...request.payload,
+                [DELIVERY_ID_KEY]: request.deliveryId,
+                [IDEMPOTENCY_KEY_KEY]: request.idempotencyKey,
+            }, {
+                attempts: request.maxAttempts,
+                jobId: `gf-${randomUUID()}`,
+                // Retained so the engine can read a finished job back: a
+                // removed job would leave the case unprovable.
+                removeOnComplete: false,
+                removeOnFail: false,
+            });
+            return { jobId: String(job.id), deliveryId: request.deliveryId, idempotencyKey: request.idempotencyKey };
+        },
+        close,
+    };
+    return { observer, deliverer };
+}
+//# sourceMappingURL=bullmq.js.map

package/dist/queue/bullmq.js.map

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

package/dist/queue/observer.d.ts

@@ -0,0 +1,130 @@
+import { DEFAULT_QUEUE_LIST_LIMIT, DEFAULT_QUEUE_POLL_INTERVAL_MS, DEFAULT_QUEUE_TERMINAL_TIMEOUT_MS, MAX_QUEUE_FIELD_CHARS, MAX_QUEUE_LIST_LIMIT, QUEUE_OBSERVER_CONFIG_ENV, QUEUE_OBSERVER_ENV, type QueueBinding, type QueueJobObservation, type QueueJobState, type QueueObserverConfig } from '@gate-forge/core';
+/** One bounded list read: the jobs plus whether the read was complete. */
+export interface QueueJobList {
+    /** Observed jobs, in queue order. */
+    jobs: QueueJobObservation[];
+    /** False when the queue held more jobs than the bound (never proof). */
+    complete: boolean;
+    /** Engine-side count of jobs read. */
+    count: number;
+}
+/** Blocking queue-channel failure (always a diagnostic, never proof). */
+export declare class QueueObserverError extends Error {
+    constructor(message: string);
+}
+/** The engine's independent queue read. */
+export interface QueueStateObserver {
+    /** Implementation kind (`bullmq` or a module's declared name). */
+    readonly kind: string;
+    /** Resolves the approved queue name for a task resource id. */
+    queueFor(taskResourceId: string): string;
+    /** Reads one job by id; null when the queue has no such job. */
+    readJob(queue: string, jobId: string): Promise<QueueJobObservation | null>;
+    /** Reads a bounded slice of one queue. */
+    listJobs(queue: string, limit?: number): Promise<QueueJobList>;
+    /** Releases connections (idempotent; never flips a verdict). */
+    close(): Promise<void>;
+}
+/** One engine-produced delivery. */
+export interface QueueDeliveryRequest {
+    /** Approved queue name for the task resource. */
+    queue: string;
+    /** Engine-stamped delivery identity (groups the jobs of one delivery). */
+    deliveryId: string;
+    /** Engine-stamped idempotency key. */
+    idempotencyKey: string;
+    /** Bounded job payload. */
+    payload: Record<string, unknown>;
+    /** Declared attempt bound for the produced job. */
+    maxAttempts: number;
+}
+/** One produced delivery. */
+export interface QueueDeliveryReceipt {
+    /** Queue-native job id of the produced job. */
+    jobId: string;
+    /** The delivery identity the engine stamped. */
+    deliveryId: string;
+    /** The idempotency key the engine stamped. */
+    idempotencyKey: string;
+}
+/** The engine's queue WRITE side (the delivery it will later grade). */
+export interface QueueDeliverer {
+    /** Produces one delivery and returns its engine-observed receipt. */
+    enqueue(request: QueueDeliveryRequest): Promise<QueueDeliveryReceipt>;
+    /** Releases connections (idempotent; never flips a verdict). */
+    close(): Promise<void>;
+}
+/** Observer + deliverer over one configured queue backend. */
+export interface QueueChannel {
+    /** The independent read. */
+    readonly observer: QueueStateObserver;
+    /** The engine-produced delivery. */
+    readonly deliverer: QueueDeliverer;
+}
+/**
+ * Bounds one observed string field (fail closed, never a truncated hash
+ * of an over-long value).
+ *
+ * Args:
+ *   value: the observed value.
+ *   what: field name for the diagnostic.
+ *
+ * Returns:
+ *   string | null: the bounded string, or null when absent.
+ *
+ * @throws QueueObserverError the value is not a string or exceeds the bound.
+ */
+export declare function boundedQueueField(value: unknown, what: string): string | null;
+/**
+ * Resolves a declared URL from the witness process environment.
+ *
+ * Args:
+ *   config: the validated engine-owned configuration.
+ *   env: the witness process environment.
+ *
+ * Returns:
+ *   {host, port} | {url}: the connection material for the backend.
+ *
+ * @throws QueueObserverError the named environment variable is unset.
+ */
+export declare function resolveQueueConnection(config: QueueObserverConfig, env: NodeJS.ProcessEnv): {
+    host: string;
+    port: number;
+} | {
+    url: string;
+};
+/** The factory shape a custom queue-observer module must export. */
+export type QueueChannelFactory = (config: QueueObserverConfig) => Promise<QueueChannel> | QueueChannel;
+/**
+ * Opens the configured queue channel. Built-in `bullmq` first; any
+ * other value is a module path whose default export is a factory.
+ *
+ * Args:
+ *   config: the validated engine-owned configuration.
+ *   env: the witness process environment (URL connection form only).
+ *
+ * Returns:
+ *   Promise<QueueChannel>: the opened channel.
+ *
+ * @throws QueueObserverError on an unknown kind, an unloadable module,
+ *   or a module that does not return a conforming channel (fail closed).
+ */
+export declare function openQueueChannel(config: QueueObserverConfig, env?: NodeJS.ProcessEnv): Promise<QueueChannel>;
+/**
+ * Opens the channel named by the witness process environment, or null
+ * when no queue observer is configured (the fail-closed default: every
+ * `engine-task` case then blocks with a naming diagnostic).
+ *
+ * Args:
+ *   env: the witness process environment.
+ *
+ * Returns:
+ *   Promise<QueueChannel | null>: the configured channel, or null.
+ *
+ * @throws QueueObserverError the configuration is present but illegal.
+ */
+export declare function openConfiguredQueueChannel(env?: NodeJS.ProcessEnv): Promise<QueueChannel | null>;
+export { DEFAULT_QUEUE_LIST_LIMIT, DEFAULT_QUEUE_POLL_INTERVAL_MS, DEFAULT_QUEUE_TERMINAL_TIMEOUT_MS, MAX_QUEUE_FIELD_CHARS, MAX_QUEUE_LIST_LIMIT, QUEUE_OBSERVER_CONFIG_ENV, QUEUE_OBSERVER_ENV, type QueueBinding, type QueueJobObservation, type QueueJobState, type QueueObserverConfig, };
+/** The engine-owned queue-observer configuration. */
+export type QueueObserverSpec = QueueObserverConfig;
+//# sourceMappingURL=observer.d.ts.map

package/dist/queue/observer.d.ts.map

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

package/dist/queue/observer.js

@@ -0,0 +1,179 @@
+/**
+ * Witness-owned queue-state observer: the
+ * engine's INDEPENDENT trusted read of a background job's delivery
+ * state. A task contract is a claim about the queue, so the engine must
+ * read the queue itself — a suite-submitted "the job succeeded" is never
+ * proof, exactly like a suite-submitted HTTP status.
+ *
+ * The shape follows the DB/evidence adapters: a narrow read interface,
+ * one implementation per queue library, and a fail-closed rule for
+ * everything unexpected.
+ *
+ * - `readJob` reads ONE job by id (state, attempts, bounded fields);
+ * - `listJobs` reads a BOUNDED slice of one queue and reports whether
+ *   the read was exhaustive (a truncated list can never prove a set);
+ * - unknown states, over-bound fields, and over-bound lists raise
+ *   `QueueObserverError` — a blocking diagnostic, never a partial
+ *   observation;
+ * - `enqueue` is the engine's WRITE side: the engine produces the
+ *   delivery it will later grade, so a task case never grades the
+ *   suite's own enqueue.
+ *
+ * The channel is opened ONLY from the engine-owned configuration
+ * (`GATEFORGE_QUEUE_OBSERVER` + `GATEFORGE_QUEUE_OBSERVER_CONFIG` in the
+ * witness process, supplied by the supervisor from the repository's
+ * `queueObserver` block). With no configuration there is no channel and
+ */
+import { pathToFileURL } from 'node:url';
+import { DEFAULT_QUEUE_LIST_LIMIT, DEFAULT_QUEUE_POLL_INTERVAL_MS, DEFAULT_QUEUE_TERMINAL_TIMEOUT_MS, MAX_QUEUE_FIELD_CHARS, MAX_QUEUE_LIST_LIMIT, QUEUE_OBSERVER_CONFIG_ENV, QUEUE_OBSERVER_ENV, parseQueueObserverConfigJson, } from '@gate-forge/core';
+/** Blocking queue-channel failure (always a diagnostic, never proof). */
+export class QueueObserverError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'QueueObserverError';
+    }
+}
+/**
+ * Bounds one observed string field (fail closed, never a truncated hash
+ * of an over-long value).
+ *
+ * Args:
+ *   value: the observed value.
+ *   what: field name for the diagnostic.
+ *
+ * Returns:
+ *   string | null: the bounded string, or null when absent.
+ *
+ * @throws QueueObserverError the value is not a string or exceeds the bound.
+ */
+export function boundedQueueField(value, what) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value !== 'string') {
+        throw new QueueObserverError(`queue field '${what}' is not a string (fail closed)`);
+    }
+    if (value.length > MAX_QUEUE_FIELD_CHARS) {
+        throw new QueueObserverError(`queue field '${what}' exceeds the ${String(MAX_QUEUE_FIELD_CHARS)}-character bound (fail closed)`);
+    }
+    return value;
+}
+/**
+ * Resolves a declared URL from the witness process environment.
+ *
+ * Args:
+ *   config: the validated engine-owned configuration.
+ *   env: the witness process environment.
+ *
+ * Returns:
+ *   {host, port} | {url}: the connection material for the backend.
+ *
+ * @throws QueueObserverError the named environment variable is unset.
+ */
+export function resolveQueueConnection(config, env) {
+    if ('urlEnv' in config.connection) {
+        const url = env[config.connection.urlEnv];
+        if (typeof url !== 'string' || url.length === 0) {
+            throw new QueueObserverError(`queue observer connection env '${config.connection.urlEnv}' is unset in the witness process (fail closed)`);
+        }
+        return { url };
+    }
+    return { host: config.connection.host, port: config.connection.port };
+}
+/**
+ * Loads the built-in BullMQ channel on first use. `bullmq` and `ioredis`
+ * are optional peers: a repository that declares no BullMQ observer
+ * never installs or loads them, so the witness itself never needs them.
+ *
+ * Returns:
+ *   Promise<BullmqChannelModule>: the channel module.
+ *
+ * @throws QueueObserverError when the packages are not installed in the
+ *   project (fail closed, naming the install command).
+ */
+async function loadBullmqChannelModule() {
+    try {
+        // Dynamic on purpose: `bullmq`/`ioredis` are optional peers that a
+        // project without a BullMQ observer never installs; a static import
+        // would make loading the witness itself require them.
+        return await import('./bullmq.js');
+    }
+    catch (error) {
+        const missing = error instanceof Error &&
+            'code' in error &&
+            error.code === 'ERR_MODULE_NOT_FOUND' &&
+            /'(bullmq|ioredis)'/.test(error.message);
+        if (!missing)
+            throw error;
+        throw new QueueObserverError("queueObserver kind 'bullmq' needs the 'bullmq' and 'ioredis' packages in this project — " +
+            'install them next to the app (npm install --save-dev bullmq ioredis) (fail closed)');
+    }
+}
+/**
+ * Opens the configured queue channel. Built-in `bullmq` first; any
+ * other value is a module path whose default export is a factory.
+ *
+ * Args:
+ *   config: the validated engine-owned configuration.
+ *   env: the witness process environment (URL connection form only).
+ *
+ * Returns:
+ *   Promise<QueueChannel>: the opened channel.
+ *
+ * @throws QueueObserverError on an unknown kind, an unloadable module,
+ *   or a module that does not return a conforming channel (fail closed).
+ */
+export async function openQueueChannel(config, env = process.env) {
+    if (config.kind === 'bullmq') {
+        const { createBullmqChannel } = await loadBullmqChannelModule();
+        return createBullmqChannel(config, resolveQueueConnection(config, env));
+    }
+    // The module path is operator-supplied at run time, so no static
+    // import specifier exists at author time.
+    const module = (await import(pathToFileURL(config.kind).href));
+    if (typeof module.default !== 'function') {
+        throw new QueueObserverError(`queue observer module '${config.kind}' has no default-exported factory (fail closed)`);
+    }
+    const channel = await module.default(config);
+    if (channel === null ||
+        typeof channel !== 'object' ||
+        channel.observer === null ||
+        typeof channel.observer !== 'object' ||
+        typeof channel.observer.readJob !== 'function' ||
+        typeof channel.observer.listJobs !== 'function' ||
+        typeof channel.observer.queueFor !== 'function' ||
+        channel.deliverer === null ||
+        typeof channel.deliverer !== 'object' ||
+        typeof channel.deliverer.enqueue !== 'function') {
+        throw new QueueObserverError(`queue observer module '${config.kind}' did not return a conforming channel (fail closed)`);
+    }
+    return channel;
+}
+/**
+ * Opens the channel named by the witness process environment, or null
+ * when no queue observer is configured (the fail-closed default: every
+ * `engine-task` case then blocks with a naming diagnostic).
+ *
+ * Args:
+ *   env: the witness process environment.
+ *
+ * Returns:
+ *   Promise<QueueChannel | null>: the configured channel, or null.
+ *
+ * @throws QueueObserverError the configuration is present but illegal.
+ */
+export async function openConfiguredQueueChannel(env = process.env) {
+    const kind = env[QUEUE_OBSERVER_ENV];
+    const raw = env[QUEUE_OBSERVER_CONFIG_ENV];
+    if (kind === undefined || kind === '')
+        return null;
+    if (raw === undefined || raw === '') {
+        throw new QueueObserverError(`${QUEUE_OBSERVER_CONFIG_ENV} is required when a queue observer is named (fail closed)`);
+    }
+    const config = parseQueueObserverConfigJson(raw);
+    if (config.kind !== kind) {
+        throw new QueueObserverError(`${QUEUE_OBSERVER_ENV} ('${kind}') does not match the configured observer kind ('${config.kind}') (fail closed)`);
+    }
+    return openQueueChannel(config, env);
+}
+export { DEFAULT_QUEUE_LIST_LIMIT, DEFAULT_QUEUE_POLL_INTERVAL_MS, DEFAULT_QUEUE_TERMINAL_TIMEOUT_MS, MAX_QUEUE_FIELD_CHARS, MAX_QUEUE_LIST_LIMIT, QUEUE_OBSERVER_CONFIG_ENV, QUEUE_OBSERVER_ENV, };
+//# sourceMappingURL=observer.js.map

package/dist/queue/observer.js.map

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