@mantajs/core 0.1.6 → 0.2.0-beta.0

package/dist/workflows/manager.js

@@ -0,0 +1,450 @@
+// WorkflowManager — registers and executes imperative workflows.
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { MantaError } from '../errors/manta-error';
+import { CancelledError } from './progress-helper';
+import { RETRY_POLICY } from './types';
+import { isWorkflowYield } from './yield';
+export const workflowContextStorage = new AsyncLocalStorage();
+class MemoryStorage {
+    _store = new Map();
+    async save(transactionId, stepId, data) {
+        this._store.set(`${transactionId}:${stepId}`, data);
+    }
+    async list(transactionId) {
+        const results = [];
+        for (const [key, value] of this._store) {
+            if (key.startsWith(`${transactionId}:`)) {
+                results.push({ stepId: key.slice(transactionId.length + 1), data: value });
+            }
+        }
+        return results;
+    }
+    async delete(transactionId) {
+        for (const key of this._store.keys()) {
+            if (key.startsWith(`${transactionId}:`))
+                this._store.delete(key);
+        }
+    }
+}
+/**
+ * WorkflowManager — registers and runs imperative workflows.
+ * Steps access the workflow context via AsyncLocalStorage.
+ */
+export class WorkflowManager {
+    _workflows = new Map();
+    _logger = null;
+    _eventBus = null;
+    _locking = null;
+    _storage;
+    _store;
+    _progressChannel;
+    _queue;
+    _resumeEndpoint;
+    _stepBudgetMs;
+    _app;
+    /** Per-run AbortControllers. Keyed by transactionId / runId. */
+    _controllers = new Map();
+    constructor(app, options) {
+        this._app = app;
+        this._storage = options?.storage ?? new MemoryStorage();
+        this._store = options?.store;
+        this._progressChannel = options?.progressChannel;
+        this._queue = options?.queue;
+        this._resumeEndpoint = options?.resumeEndpoint;
+        this._stepBudgetMs = options?.stepBudgetMs;
+        this._logger = app.infra.logger ?? null;
+        this._eventBus = app.infra.eventBus ?? null;
+        this._locking = app.infra.locking ?? null;
+    }
+    // biome-ignore lint/suspicious/noExplicitAny: workflow definitions have varied type params
+    register(workflow) {
+        this._workflows.set(workflow.name, workflow);
+    }
+    async run(workflowId, options = {}) {
+        const workflow = this._workflows.get(workflowId);
+        if (!workflow)
+            throw new MantaError('UNKNOWN_MODULES', `Workflow "${workflowId}" not registered`);
+        const input = options.input ?? {};
+        const transactionId = options.transactionId ?? `tx_${crypto.randomUUID().replace(/-/g, '')}`;
+        const cleanup = options.cleanup ?? true;
+        if (this._locking) {
+            const acquired = await this._locking.acquire(`workflow:${transactionId}`, { expire: 60000 });
+            if (!acquired)
+                throw new MantaError('CONFLICT', `Workflow "${workflowId}" already running: ${transactionId}`);
+        }
+        // Set up the per-run AbortController (used by ctx.signal + cancel detection).
+        const controller = new AbortController();
+        this._controllers.set(transactionId, controller);
+        // Wire the eventbus-backed cancel channel (WORKFLOW_PROGRESS.md §10.3).
+        // When the framework route DELETE /_workflow/:id publishes `workflow:cancel`,
+        // the matching run aborts immediately — without waiting for the next step
+        // boundary check. Cleanup happens in the outer finally block below.
+        let cancelSubscriberId = null;
+        if (this._eventBus) {
+            cancelSubscriberId = `workflow-cancel:${transactionId}`;
+            this._eventBus.subscribe('workflow:cancel', (msg) => {
+                const data = msg.data;
+                if (data?.runId === transactionId && !controller.signal.aborted) {
+                    controller.abort('cancelled');
+                }
+            }, { subscriberId: cancelSubscriberId });
+        }
+        // Seed the durable run (best effort — store failures MUST NOT fail the workflow).
+        if (this._store) {
+            try {
+                await this._store.create({
+                    id: transactionId,
+                    command_name: workflowId,
+                    steps: [],
+                    input,
+                });
+            }
+            catch (err) {
+                this._logger?.warn(`[workflow:${workflowId}] store.create failed: ${err?.message ?? err}`);
+            }
+        }
+        try {
+            // Durable execution: retry up to RETRY_POLICY.maxAttempts before compensating
+            let lastError = null;
+            for (let attempt = 1; attempt <= RETRY_POLICY.maxAttempts; attempt++) {
+                try {
+                    const result = await this._execute(workflow, workflowId, input, transactionId, cleanup, attempt, controller);
+                    // Terminal: succeeded
+                    if (this._store) {
+                        try {
+                            await this._store.updateStatus(transactionId, 'succeeded', {
+                                output: result.result,
+                                completed_at: new Date(),
+                            });
+                        }
+                        catch (err) {
+                            this._logger?.warn(`[workflow:${workflowId}] store.updateStatus(succeeded) failed: ${err?.message ?? err}`);
+                        }
+                    }
+                    if (this._progressChannel) {
+                        this._progressChannel.clear(transactionId).catch(() => {
+                            /* clear is observability — swallow */
+                        });
+                    }
+                    return result;
+                }
+                catch (error) {
+                    // ctx.yield() is a non-error control flow — NEVER retry, NEVER
+                    // compensate. The step already persisted its resume_state via
+                    // createStep / runStep. We transition the run to 'paused' (pre-terminal)
+                    // and ask the queue port to schedule a continuation. The outer
+                    // finally releases the lock + cancel subscriber; no explicit
+                    // cleanup() call needed here.
+                    if (isWorkflowYield(error)) {
+                        if (this._store) {
+                            try {
+                                await this._store.updateStatus(transactionId, 'paused');
+                            }
+                            catch (err) {
+                                this._logger?.warn(`[workflow:${workflowId}] store.updateStatus(paused) failed: ${err?.message ?? err}`);
+                            }
+                        }
+                        // Ask the queue adapter to schedule a continuation. If no queue
+                        // is wired, the run stays paused until a manual
+                        // `manager.resume(runId)` is called (tests / CLI).
+                        if (this._queue && this._resumeEndpoint) {
+                            try {
+                                await this._queue.enqueue({
+                                    url: this._resumeEndpoint(transactionId),
+                                    payload: { runId: transactionId },
+                                    idempotencyKey: `resume:${transactionId}`,
+                                });
+                            }
+                            catch (err) {
+                                this._logger?.warn(`[workflow:${workflowId}] queue.enqueue(resume) failed: ${err?.message ?? err}`);
+                            }
+                        }
+                        return {
+                            transaction: { transactionId, state: 'invoking' },
+                            result: undefined,
+                        };
+                    }
+                    lastError = error;
+                    // Cancellation short-circuits retries.
+                    const isCancel = isCancelledError(error);
+                    if (isCancel)
+                        break;
+                    if (attempt < RETRY_POLICY.maxAttempts) {
+                        // Backoff delay before next attempt
+                        const delay = Math.min(RETRY_POLICY.initialIntervalMs * RETRY_POLICY.backoffMultiplier ** (attempt - 1), RETRY_POLICY.maxIntervalMs);
+                        this._logger?.info(`[workflow:${workflowId}] Retrying (${attempt + 1}/${RETRY_POLICY.maxAttempts}) in ${delay}ms`);
+                        await new Promise((resolve) => setTimeout(resolve, delay));
+                    }
+                }
+            }
+            // Terminal failure path
+            if (this._store && lastError) {
+                const cancelled = isCancelledError(lastError);
+                const terminalStatus = cancelled ? 'cancelled' : 'failed';
+                const fields = { completed_at: new Date() };
+                if (!cancelled) {
+                    fields.error = toWorkflowError(lastError);
+                }
+                try {
+                    await this._store.updateStatus(transactionId, terminalStatus, fields);
+                }
+                catch (err) {
+                    this._logger?.warn(`[workflow:${workflowId}] store.updateStatus(${terminalStatus}) failed: ${err?.message ?? err}`);
+                }
+            }
+            if (this._progressChannel) {
+                this._progressChannel.clear(transactionId).catch(() => {
+                    /* swallow */
+                });
+            }
+            throw lastError;
+        }
+        finally {
+            this._controllers.delete(transactionId);
+            if (cancelSubscriberId && this._eventBus) {
+                try {
+                    this._eventBus.unsubscribe(cancelSubscriberId);
+                }
+                catch {
+                    /* eventbus may be disposed — ignore */
+                }
+            }
+            if (this._locking) {
+                await this._locking.release(`workflow:${transactionId}`).catch((err) => {
+                    ;
+                    (this._logger ?? console).warn(`[WorkflowManager] Lock release failed: ${err?.message ?? err}`);
+                });
+            }
+        }
+    }
+    /**
+     * Resume a paused workflow run. Invoked by the HTTP handler for
+     * `POST /api/<ctx>/_workflow/:runId/resume` when the queue adapter
+     * delivers a continuation.
+     *
+     * Loads the run's original `command_name` and `input` from the store, then
+     * re-enters `run()` with the same `transactionId`. The normal resume
+     * machinery picks up:
+     *  - completed steps (from workflow_checkpoints) — skipped at zero cost
+     *  - paused steps (from workflow_runs.steps[].resume_state) — re-invoked
+     *    with ctx.resumeState populated
+     *
+     * Idempotent: safe to call multiple times — if the run is already terminal,
+     * returns early without re-executing.
+     */
+    async resume(runId) {
+        if (!this._store) {
+            throw new MantaError('UNEXPECTED_STATE', 'resume requires an IWorkflowStorePort');
+        }
+        const run = await this._store.get(runId);
+        if (!run) {
+            throw new MantaError('NOT_FOUND', `Workflow run "${runId}" not found`);
+        }
+        if (run.status === 'succeeded' || run.status === 'failed' || run.status === 'cancelled') {
+            this._logger?.info(`[workflow:${run.command_name}] resume(${runId}) skipped — already ${run.status}`);
+            return { transaction: { transactionId: runId, state: 'done' } };
+        }
+        // Re-enter the workflow with the same transactionId. checkpoints + resumeStates
+        // are loaded from the store inside _execute.
+        return this.run(run.command_name, {
+            transactionId: runId,
+            input: run.input ?? {},
+        });
+    }
+    /**
+     * Execute a single attempt. Throws on failure — the retry loop in run() handles retries.
+     * On the final attempt, compensates before re-throwing.
+     */
+    async _execute(workflow, workflowId, input, transactionId, cleanup, attempt, controller) {
+        const isFinalAttempt = attempt >= RETRY_POLICY.maxAttempts;
+        // Track execution start
+        if (this._storage.trackStart) {
+            await this._storage.trackStart(transactionId, workflowId, input).catch((err) => {
+                ;
+                (this._logger ?? console).warn(`[WorkflowManager] trackStart failed: ${err?.message ?? err}`);
+            });
+        }
+        // Load existing checkpoints (durable resume — completed steps skip in 0ms)
+        const checkpoints = new Map();
+        const existing = await this._storage.list(transactionId);
+        for (const cp of existing)
+            checkpoints.set(cp.stepId, cp.data);
+        if (checkpoints.size > 0) {
+            this._logger?.info(`[workflow:${workflowId}] Resuming (attempt ${attempt}): ${checkpoints.size} steps already completed`);
+        }
+        // Load resume states (for steps that ctx.yield()ed on a previous invocation).
+        // Empty on a fresh run; populated when the queue delivers a POST to the
+        // `/resume` endpoint and `manager.resume(runId)` re-enters _execute.
+        const resumeStates = new Map();
+        if (this._store) {
+            try {
+                const run = await this._store.get(transactionId);
+                if (run) {
+                    for (const step of run.steps ?? []) {
+                        if (step.status === 'paused' && step.resume_state !== undefined) {
+                            resumeStates.set(step.name, step.resume_state);
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                this._logger?.warn(`[workflow:${workflowId}] store.get(resumeStates) failed: ${err?.message ?? err}`);
+            }
+        }
+        // Event buffering
+        const eventGroupId = `wf:${transactionId}`;
+        // Create workflow context (accessible via AsyncLocalStorage)
+        const storage = this._storage;
+        const wfCtx = {
+            transactionId,
+            runId: transactionId,
+            checkpoints,
+            completedSteps: [],
+            stepCounter: new Map(),
+            eventGroupId,
+            bufferEvent: this._eventBus
+                ? (event) => {
+                    this._eventBus.emit(event, { groupId: eventGroupId }).catch((err) => {
+                        ;
+                        (this._logger ?? console).warn(`[WorkflowManager] Event buffer failed: ${err?.message ?? err}`);
+                    });
+                }
+                : undefined,
+            // Durable execution: persist each checkpoint immediately so retries can resume
+            saveCheckpoint: async (stepKey, output) => {
+                await storage.save(transactionId, stepKey, output);
+            },
+            store: this._store,
+            progressChannel: this._progressChannel,
+            stepName: undefined,
+            signal: controller.signal,
+            resumeStates: resumeStates.size > 0 ? resumeStates : undefined,
+            budgetMs: this._stepBudgetMs,
+        };
+        wfCtx.__abort = (reason) => {
+            if (!controller.signal.aborted)
+                controller.abort(reason);
+        };
+        // Build step context — pass wfCtx explicitly for bundler compatibility.
+        // Note: progress/forEach/signal on StepContext are injected by the step
+        // wrappers (createStep / runStep) via wfCtx, so we don't duplicate them here.
+        const stepCtx = { app: this._app, __wfCtx: wfCtx, signal: controller.signal };
+        // Execute within AsyncLocalStorage context
+        try {
+            const result = await workflowContextStorage.run(wfCtx, () => workflow.fn(input, stepCtx));
+            // Release buffered events
+            if (this._eventBus) {
+                await this._eventBus.releaseGroupedEvents(eventGroupId).catch(() => {
+                    this._logger?.warn(`[workflow:${workflowId}] Failed to release buffered events`);
+                });
+            }
+            // Track completion
+            if (this._storage.trackComplete) {
+                await this._storage.trackComplete(transactionId, result).catch((err) => {
+                    ;
+                    (this._logger ?? console).warn(`[WorkflowManager] trackComplete failed: ${err?.message ?? err}`);
+                });
+            }
+            if (cleanup) {
+                await this._storage.delete(transactionId).catch((err) => {
+                    ;
+                    (this._logger ?? console).warn(`[WorkflowManager] Checkpoint cleanup failed: ${err?.message ?? err}`);
+                });
+            }
+            return {
+                transaction: { transactionId, state: 'done' },
+                result: result,
+            };
+        }
+        catch (error) {
+            const cancelled = isCancelledError(error);
+            this._logger?.warn(`[workflow:${workflowId}] ${cancelled ? 'Cancelled' : 'Failed'} (attempt ${attempt}/${RETRY_POLICY.maxAttempts}): ${error.message}`);
+            // Track failure
+            if (this._storage.trackFailed) {
+                await this._storage.trackFailed(transactionId, error.message).catch((err) => {
+                    ;
+                    (this._logger ?? console).warn(`[WorkflowManager] trackFailed failed: ${err?.message ?? err}`);
+                });
+            }
+            if (this._eventBus) {
+                await this._eventBus.clearGroupedEvents(eventGroupId).catch((err) => {
+                    ;
+                    (this._logger ?? console).warn(`[WorkflowManager] Clear grouped events failed: ${err?.message ?? err}`);
+                });
+            }
+            if (isFinalAttempt || cancelled) {
+                // Terminal: compensate. On cancel we compensate immediately (no more retries).
+                await this._compensate(workflowId, wfCtx.completedSteps, stepCtx, transactionId);
+                if (cleanup) {
+                    await this._storage.delete(transactionId).catch((err) => {
+                        ;
+                        (this._logger ?? console).warn(`[WorkflowManager] Checkpoint cleanup failed: ${err?.message ?? err}`);
+                    });
+                }
+            }
+            // Non-final: checkpoints remain in storage for next attempt to resume from
+            throw error;
+        }
+    }
+    async _compensate(workflowId, completedSteps, ctx, transactionId) {
+        if (completedSteps.length === 0)
+            return;
+        this._logger?.warn(`[workflow:${workflowId}] Compensating ${completedSteps.length} steps`);
+        for (let i = completedSteps.length - 1; i >= 0; i--) {
+            const step = completedSteps[i];
+            if (!step.compensate)
+                continue;
+            try {
+                await step.compensate(step.output, ctx);
+                // Mark the compensated step in the durable store (best effort).
+                if (this._store) {
+                    try {
+                        await this._store.updateStep(transactionId, step.name, {
+                            status: 'compensated',
+                            completed_at: new Date(),
+                        });
+                    }
+                    catch (err) {
+                        this._logger?.warn(`[workflow:${workflowId}] store.updateStep(compensated, "${step.name}") failed: ${err?.message ?? err}`);
+                    }
+                }
+            }
+            catch (err) {
+                this._logger?.error(`[workflow:${workflowId}] Compensation failed "${step.name}": ${err.message}`);
+            }
+        }
+    }
+    _reset() {
+        this._workflows.clear();
+    }
+}
+// ─── helpers ────────────────────────────────────────────────────────────────
+function isCancelledError(err) {
+    if (err instanceof CancelledError)
+        return true;
+    if (err && typeof err === 'object') {
+        const e = err;
+        if (e.code === 'WORKFLOW_CANCELLED')
+            return true;
+        if (e.name === 'CancelledError')
+            return true;
+    }
+    return false;
+}
+function toWorkflowError(err) {
+    if (err instanceof MantaError) {
+        return {
+            message: err.message,
+            code: err.type,
+            stack: err.stack,
+        };
+    }
+    if (err instanceof Error) {
+        return {
+            message: err.message,
+            stack: err.stack,
+        };
+    }
+    return { message: String(err) };
+}
+//# sourceMappingURL=manager.js.map

package/dist/workflows/manager.js.map

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

package/dist/workflows/orphan-reaper.d.ts

@@ -0,0 +1,50 @@
+import type { ILoggerPort } from '../ports/logger';
+import type { JobResult } from '../ports/types';
+import type { IWorkflowStorePort } from '../ports/workflow-store';
+/** Default threshold — 5 minutes without a heartbeat = orphan. */
+export declare const DEFAULT_ORPHAN_THRESHOLD_MS: number;
+/** Default max orphans reaped per tick. */
+export declare const DEFAULT_ORPHAN_REAP_LIMIT = 50;
+/** Framework-owned job name. Prefixed with `__manta_` so it cannot collide with user jobs. */
+export declare const ORPHAN_REAPER_JOB_NAME = "__manta_workflow_orphan_reaper";
+/** Default schedule — every minute. */
+export declare const ORPHAN_REAPER_SCHEDULE = "*/1 * * * *";
+/** Stable error code written into workflow_runs.error when a run is reaped. */
+export declare const WORKFLOW_ORPHANED_CODE = "WORKFLOW_ORPHANED";
+export interface OrphanReaperOptions {
+    /** How long without a heartbeat before a run is considered orphaned. Defaults to 5 minutes. */
+    orphanThresholdMs?: number;
+    /** Max number of orphans reaped per tick. Defaults to 50. */
+    limit?: number;
+}
+export interface OrphanReaperResult extends JobResult {
+    status: 'success';
+    data: {
+        reaped: number;
+        total: number;
+    };
+    duration_ms: number;
+}
+/**
+ * Descriptor returned by `createOrphanReaperJob`. The bootstrap phase passes
+ * these fields straight into `IJobSchedulerPort.register(name, schedule, handler)`.
+ */
+export interface OrphanReaperJobDescriptor {
+    name: string;
+    schedule: string;
+    /** Closure over the store + logger — the scheduler calls this on each tick. */
+    handler: () => Promise<OrphanReaperResult>;
+}
+/**
+ * Build the orphan reaper job descriptor.
+ *
+ * The returned handler is a plain closure — it does NOT rely on `ctx.app`
+ * (the scheduler's `setApp()` is not wired from bootstrap today, so resolving
+ * via the app would be flaky). Instead it closes over the store + logger
+ * directly, mirroring the pattern used for user jobs in load-resources.ts.
+ */
+export declare function createOrphanReaperJob(deps: {
+    store: IWorkflowStorePort;
+    logger: ILoggerPort;
+}, options?: OrphanReaperOptions): OrphanReaperJobDescriptor;
+//# sourceMappingURL=orphan-reaper.d.ts.map

package/dist/workflows/orphan-reaper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-reaper.d.ts","sourceRoot":"","sources":["../../src/workflows/orphan-reaper.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,kEAAkE;AAClE,eAAO,MAAM,2BAA2B,QAAgB,CAAA;AAExD,2CAA2C;AAC3C,eAAO,MAAM,yBAAyB,KAAK,CAAA;AAE3C,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB,mCAAmC,CAAA;AAEtE,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,gBAAgB,CAAA;AAEnD,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,sBAAsB,CAAA;AAEzD,MAAM,WAAW,mBAAmB;IAClC,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,MAAM,EAAE,SAAS,CAAA;IACjB,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACvC,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAA;CAC3C;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,EACxD,OAAO,GAAE,mBAAwB,GAChC,yBAAyB,CAuC3B"}

package/dist/workflows/orphan-reaper.js

@@ -0,0 +1,69 @@
+// WP-F04 — Orphan reaper job.
+//
+// On serverless hosts (Vercel), a workflow that takes longer than the HTTP
+// invocation it started in has no way to continue running — the function is
+// killed when the handler returns. `workflow_runs.status` stays 'running'
+// forever unless something reaps it.
+//
+// This module produces a framework-owned job that the bootstrap registers
+// against IJobSchedulerPort when both the scheduler AND IWorkflowStorePort
+// are wired. The job scans for runs whose heartbeat_at is older than the
+// configured threshold and marks them failed. V1 does NOT resume the run —
+// it just flags the failure so the UI stops spinning. Resume is a separate,
+// larger feature (would need driver wake-up + re-entry into WorkflowManager).
+/** Default threshold — 5 minutes without a heartbeat = orphan. */
+export const DEFAULT_ORPHAN_THRESHOLD_MS = 5 * 60 * 1000;
+/** Default max orphans reaped per tick. */
+export const DEFAULT_ORPHAN_REAP_LIMIT = 50;
+/** Framework-owned job name. Prefixed with `__manta_` so it cannot collide with user jobs. */
+export const ORPHAN_REAPER_JOB_NAME = '__manta_workflow_orphan_reaper';
+/** Default schedule — every minute. */
+export const ORPHAN_REAPER_SCHEDULE = '*/1 * * * *';
+/** Stable error code written into workflow_runs.error when a run is reaped. */
+export const WORKFLOW_ORPHANED_CODE = 'WORKFLOW_ORPHANED';
+/**
+ * Build the orphan reaper job descriptor.
+ *
+ * The returned handler is a plain closure — it does NOT rely on `ctx.app`
+ * (the scheduler's `setApp()` is not wired from bootstrap today, so resolving
+ * via the app would be flaky). Instead it closes over the store + logger
+ * directly, mirroring the pattern used for user jobs in load-resources.ts.
+ */
+export function createOrphanReaperJob(deps, options = {}) {
+    const thresholdMs = options.orphanThresholdMs ?? DEFAULT_ORPHAN_THRESHOLD_MS;
+    const limit = options.limit ?? DEFAULT_ORPHAN_REAP_LIMIT;
+    const { store, logger } = deps;
+    return {
+        name: ORPHAN_REAPER_JOB_NAME,
+        schedule: ORPHAN_REAPER_SCHEDULE,
+        handler: async () => {
+            const startMs = Date.now();
+            const cutoff = new Date(startMs - thresholdMs);
+            const orphans = await store.listOrphans({ olderThan: cutoff, limit });
+            if (orphans.length === 0) {
+                return { status: 'success', data: { reaped: 0, total: 0 }, duration_ms: Date.now() - startMs };
+            }
+            let reaped = 0;
+            for (const orphan of orphans) {
+                try {
+                    await store.markOrphanFailed(orphan.id, {
+                        message: `Workflow orphaned — no heartbeat for ${Math.round(thresholdMs / 1000)}s`,
+                        code: WORKFLOW_ORPHANED_CODE,
+                    });
+                    reaped++;
+                }
+                catch (err) {
+                    // Never throw from the reaper. One bad orphan must not break the job.
+                    logger.warn(`Failed to mark orphan as failed (runId=${orphan.id})`, err);
+                }
+            }
+            logger.info(`Orphan reaper completed (reaped=${reaped}, total=${orphans.length})`);
+            return {
+                status: 'success',
+                data: { reaped, total: orphans.length },
+                duration_ms: Date.now() - startMs,
+            };
+        },
+    };
+}
+//# sourceMappingURL=orphan-reaper.js.map

package/dist/workflows/orphan-reaper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-reaper.js","sourceRoot":"","sources":["../../src/workflows/orphan-reaper.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,0EAA0E;AAC1E,qCAAqC;AACrC,EAAE;AACF,0EAA0E;AAC1E,2EAA2E;AAC3E,yEAAyE;AACzE,2EAA2E;AAC3E,4EAA4E;AAC5E,8EAA8E;AAM9E,kEAAkE;AAClE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAA;AAExD,2CAA2C;AAC3C,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAA;AAE3C,8FAA8F;AAC9F,MAAM,CAAC,MAAM,sBAAsB,GAAG,gCAAgC,CAAA;AAEtE,uCAAuC;AACvC,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAA;AAEnD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAA;AA0BzD;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAwD,EACxD,UAA+B,EAAE;IAEjC,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,IAAI,2BAA2B,CAAA;IAC5E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,yBAAyB,CAAA;IACxD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAE9B,OAAO;QACL,IAAI,EAAE,sBAAsB;QAC5B,QAAQ,EAAE,sBAAsB;QAChC,OAAO,EAAE,KAAK,IAAiC,EAAE;YAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YAC1B,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,CAAA;YAC9C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;YAErE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAA;YAChG,CAAC;YAED,IAAI,MAAM,GAAG,CAAC,CAAA;YACd,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACH,MAAM,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE;wBACtC,OAAO,EAAE,wCAAwC,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG;wBAClF,IAAI,EAAE,sBAAsB;qBAC7B,CAAC,CAAA;oBACF,MAAM,EAAE,CAAA;gBACV,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,sEAAsE;oBACtE,MAAM,CAAC,IAAI,CAAC,0CAA0C,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;gBAC1E,CAAC;YACH,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,mCAAmC,MAAM,WAAW,OAAO,CAAC,MAAM,GAAG,CAAC,CAAA;YAClF,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE;gBACvC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;aAClC,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/workflows/progress-helper.d.ts

@@ -0,0 +1,20 @@
+import { MantaError } from '../errors/manta-error';
+import type { WorkflowContext } from './types';
+/**
+ * CancelledError — thrown by step handlers (and by `ctx.forEach`) when the
+ * workflow's AbortSignal has fired. Caught by the engine to trigger the
+ * `cancelled` status path + compensation (WORKFLOW_PROGRESS.md §10.1 step 6).
+ */
+export declare class CancelledError extends MantaError {
+    constructor(message?: string);
+}
+/**
+ * Build a `ctx.progress` function bound to a specific workflow run.
+ * If no IProgressChannelPort is wired, the returned function is a no-op.
+ *
+ * The returned function:
+ * - Returns `undefined` synchronously (no await on the hot path).
+ * - Never throws — channel errors are swallowed (optionally logged).
+ */
+export declare function createProgress(wfCtx: WorkflowContext): (current: number, total: number | null, message?: string) => void;
+//# sourceMappingURL=progress-helper.d.ts.map

package/dist/workflows/progress-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-helper.d.ts","sourceRoot":"","sources":["../../src/workflows/progress-helper.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,UAAU;gBAChC,OAAO,SAAuB;CAI3C;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,GACrB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAgBnE"}