@hardlydifficult/workflow-engine 1.0.5 → 1.0.7

package/README.md

@@ -104,3 +104,125 @@ await engine.transition("running", (draft) => {
   draft.result = computeResult();
 });
 ```
+
+---
+
+## Pipeline
+
+A higher-level abstraction that manages a linear sequence of steps, wrapping `WorkflowEngine` internally. Supports gates (pause for external input), retries with recovery, cancellation via `AbortSignal`, and automatic lifecycle logging.
+
+### Installation
+
+Requires `@hardlydifficult/logger` as a peer dependency:
+
+```bash
+npm install @hardlydifficult/workflow-engine @hardlydifficult/state-tracker @hardlydifficult/logger
+```
+
+### Usage
+
+```typescript
+import { Pipeline } from "@hardlydifficult/workflow-engine";
+import { createLogger } from "@hardlydifficult/logger";
+
+interface Data { prompt: string; plan?: string; approved?: boolean; result?: string; }
+
+const logger = createLogger("my-pipeline");
+
+const pipeline = new Pipeline<Data>({
+  key: "my-pipeline",
+  steps: [
+    { name: "create_plan", execute: async ({ data }) => {
+      const plan = await generatePlan(data.prompt);
+      return { plan };
+    }},
+    { name: "approve", gate: true, execute: async ({ data }) => {
+      await postForApproval(data.plan);
+      return {};
+    }},
+    { name: "implement", retries: 2, execute: async ({ data, signal }) => {
+      const result = await implement(data.plan!, signal);
+      return { result };
+    }, recover: async (error) => {
+      await fixIssue(error);
+      return {};
+    }},
+  ],
+  initialData: { prompt: "Build a feature" },
+  logger,
+  stateDirectory: "/var/data",
+  hooks: {
+    onStepComplete: (name) => console.log(`${name} done`),
+    onGateReached: (name) => console.log(`Waiting at ${name}`),
+  },
+});
+
+await pipeline.run();
+// Pipeline pauses at "approve" gate...
+
+// Later, on approval:
+await pipeline.resume({ approved: true });
+// Pipeline continues through "implement" and completes
+```
+
+### Step Types
+
+| Type | Definition | Behavior |
+|------|-----------|----------|
+| Regular | `{ name, execute }` | Runs immediately, merges returned data |
+| Gate | `{ name, gate: true, execute? }` | Runs optional execute, then pauses until `resume()` is called |
+| Retryable | `{ name, execute, retries, recover? }` | On failure, calls `recover()` then re-runs `execute`, up to N times |
+
+### `new Pipeline<TData>(options)`
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `key` | `string` | Unique persistence key |
+| `steps` | `StepDefinition<TData>[]` | Ordered list of step definitions |
+| `initialData` | `TData` | Initial accumulated data |
+| `logger` | `Logger` | Logger instance (all lifecycle events logged automatically) |
+| `stateDirectory` | `string?` | Persistence directory |
+| `autoSaveMs` | `number?` | Auto-save interval (default 5000) |
+| `hooks` | `PipelineHooks<TData>?` | Lifecycle hooks for external integrations |
+| `signal` | `AbortSignal?` | Abort signal for cancellation |
+
+### Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `status` | `string` | e.g. `"running:create_plan"`, `"gate:approve"`, `"completed"`, `"failed"` |
+| `data` | `Readonly<TData>` | Accumulated output data |
+| `steps` | `StepState[]` | Per-step runtime state |
+| `currentStep` | `string?` | Name of current step, or `undefined` if terminal |
+| `isTerminal` | `boolean` | Whether pipeline is in a terminal state |
+| `isWaitingAtGate` | `boolean` | Whether pipeline is paused at a gate |
+
+### Methods
+
+| Method | Description |
+|--------|-------------|
+| `run()` | Start or resume from crash. Loads persisted state, re-executes interrupted steps. |
+| `resume(data?)` | Continue past a gate, optionally merging partial data. |
+| `cancel()` | Transition to cancelled, abort signal fires. |
+| `on(listener)` | Subscribe to changes. Returns unsubscribe function. |
+| `toSnapshot()` | Return a read-only snapshot of `{ status, data, steps, isTerminal }`. |
+
+### Hooks
+
+All hooks are optional. Hook errors are swallowed to avoid breaking pipeline execution.
+
+| Hook | Arguments | When |
+|------|-----------|------|
+| `onStepStart` | `(name, data)` | Before a step executes |
+| `onStepComplete` | `(name, data)` | After a step succeeds |
+| `onStepFailed` | `(name, error, data)` | When a step fails (after all retries) |
+| `onGateReached` | `(name, data)` | When a gate step pauses |
+| `onComplete` | `(data)` | When all steps finish |
+| `onFailed` | `(name, error, data)` | When pipeline enters failed state |
+
+### Crash Recovery
+
+Pipeline state is persisted automatically. On restart, `run()` detects the interrupted state:
+- **Mid-step**: re-executes the step (steps should be idempotent)
+- **At gate**: stays at gate, waiting for `resume()`
+- **Terminal**: no-op

package/dist/Pipeline.d.ts

@@ -0,0 +1,69 @@
+import type { PipelineOptions, PipelineSnapshot, StepState } from "./pipelineTypes.js";
+/**
+ * A linear sequence of steps with automatic state management, persistence,
+ * and lifecycle logging.
+ *
+ * Wraps WorkflowEngine internally. Steps execute sequentially, each receiving
+ * accumulated data from prior steps. Gate steps pause until resume() is called.
+ * Retryable steps call an optional recovery function between attempts.
+ *
+ * Step execute functions should be idempotent — on crash recovery the
+ * interrupted step is re-executed.
+ */
+export declare class Pipeline<TData extends Record<string, unknown>> {
+    private readonly engine;
+    private readonly stepDefs;
+    private readonly hooks;
+    private readonly logger;
+    private abortController;
+    private gateResolver;
+    private gatePromise;
+    constructor(options: PipelineOptions<TData>);
+    /** Current pipeline status string (e.g. "running:step_name", "gate:step_name", "completed") */
+    get status(): string;
+    /** Accumulated output data (read-only) */
+    get data(): Readonly<TData>;
+    /** Per-step runtime states */
+    get steps(): readonly StepState[];
+    /** Name of the currently executing or waiting step, or undefined if terminal */
+    get currentStep(): string | undefined;
+    /** Whether the pipeline has reached a terminal state */
+    get isTerminal(): boolean;
+    /** Whether the pipeline is paused at a gate */
+    get isWaitingAtGate(): boolean;
+    /**
+     * Load persisted state and execute.
+     *
+     * - Fresh pipeline: executes from step 0
+     * - Interrupted mid-step: re-executes that step
+     * - Waiting at gate: stays at gate (call resume() to continue)
+     * - Terminal: no-op
+     */
+    run(): Promise<void>;
+    /**
+     * Resume from a gate step. Merges the provided partial data and
+     * continues execution from the next step.
+     *
+     * @throws If the pipeline is not currently at a gate
+     */
+    resume(data?: Partial<TData>): Promise<void>;
+    /**
+     * Cancel the pipeline. Transitions to "cancelled" status.
+     */
+    cancel(): Promise<void>;
+    /**
+     * Subscribe to engine change events. Returns an unsubscribe function.
+     */
+    on(listener: (event: {
+        status: string;
+        data: Readonly<TData>;
+    }) => void): () => void;
+    /**
+     * Return a read-only snapshot of the pipeline state.
+     */
+    toSnapshot(): PipelineSnapshot<TData>;
+    /** Assemble dependencies for step runner functions. */
+    private get runnerDeps();
+    private executeFrom;
+}
+//# sourceMappingURL=Pipeline.d.ts.map

package/dist/Pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pipeline.d.ts","sourceRoot":"","sources":["../src/Pipeline.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,eAAe,EACf,gBAAgB,EAEhB,SAAS,EACV,MAAM,oBAAoB,CAAC;AAS5B;;;;;;;;;;GAUG;AACH,qBAAa,QAAQ,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAA8B;gBAErC,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC;IAiE3C,+FAA+F;IAC/F,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,0CAA0C;IAC1C,IAAI,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,CAE1B;IAED,8BAA8B;IAC9B,IAAI,KAAK,IAAI,SAAS,SAAS,EAAE,CAEhC;IAED,gFAAgF;IAChF,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAKpC;IAED,wDAAwD;IACxD,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,+CAA+C;IAC/C,IAAI,eAAe,IAAI,OAAO,CAE7B;IAID;;;;;;;OAOG;IACG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB1B;;;;;OAKG;IACG,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA+ClD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB7B;;OAEG;IACH,EAAE,CACA,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;KAAE,KAAK,IAAI,GACnE,MAAM,IAAI;IAMb;;OAEG;IACH,UAAU,IAAI,gBAAgB,CAAC,KAAK,CAAC;IAWrC,uDAAuD;IACvD,OAAO,KAAK,UAAU,GAQrB;YAEa,WAAW;CAgC1B"}

package/dist/Pipeline.js

@@ -0,0 +1,259 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Pipeline = void 0;
+const buildTransitions_js_1 = require("./buildTransitions.js");
+const stepRunner_js_1 = require("./stepRunner.js");
+const WorkflowEngine_js_1 = require("./WorkflowEngine.js");
+/**
+ * A linear sequence of steps with automatic state management, persistence,
+ * and lifecycle logging.
+ *
+ * Wraps WorkflowEngine internally. Steps execute sequentially, each receiving
+ * accumulated data from prior steps. Gate steps pause until resume() is called.
+ * Retryable steps call an optional recovery function between attempts.
+ *
+ * Step execute functions should be idempotent — on crash recovery the
+ * interrupted step is re-executed.
+ */
+class Pipeline {
+    engine;
+    stepDefs;
+    hooks;
+    logger;
+    abortController;
+    gateResolver = null;
+    gatePromise = null;
+    constructor(options) {
+        const { steps, initialData, logger, hooks } = options;
+        if (steps.length === 0) {
+            throw new Error("Pipeline requires at least one step");
+        }
+        const names = new Set();
+        for (const step of steps) {
+            if (names.has(step.name)) {
+                throw new Error(`Duplicate step name: "${step.name}"`);
+            }
+            names.add(step.name);
+        }
+        this.stepDefs = steps;
+        this.hooks = hooks ?? {};
+        this.logger = logger;
+        // Wire external signal to internal abort controller
+        this.abortController = new AbortController();
+        if (options.signal) {
+            const externalSignal = options.signal;
+            if (externalSignal.aborted) {
+                this.abortController.abort();
+            }
+            else {
+                externalSignal.addEventListener("abort", () => {
+                    this.abortController.abort();
+                });
+            }
+        }
+        const transitions = (0, buildTransitions_js_1.buildTransitions)(steps);
+        const initialStatus = steps[0].gate === true
+            ? `gate:${steps[0].name}`
+            : `running:${steps[0].name}`;
+        logger.debug("Pipeline created", {
+            pipeline: options.key,
+            steps: steps.map((s) => s.name),
+            initialStatus,
+        });
+        this.engine = new WorkflowEngine_js_1.WorkflowEngine({
+            key: options.key,
+            initialStatus,
+            initialData: {
+                currentStepIndex: 0,
+                steps: steps.map((s) => ({
+                    name: s.name,
+                    status: "pending",
+                    attempts: 0,
+                })),
+                output: initialData,
+                createdAt: new Date().toISOString(),
+            },
+            transitions,
+            stateDirectory: options.stateDirectory,
+            autoSaveMs: options.autoSaveMs,
+        });
+    }
+    // ── Read-Only Accessors ──────────────────────────────────────────
+    /** Current pipeline status string (e.g. "running:step_name", "gate:step_name", "completed") */
+    get status() {
+        return this.engine.status;
+    }
+    /** Accumulated output data (read-only) */
+    get data() {
+        return this.engine.data.output;
+    }
+    /** Per-step runtime states */
+    get steps() {
+        return this.engine.data.steps;
+    }
+    /** Name of the currently executing or waiting step, or undefined if terminal */
+    get currentStep() {
+        if (this.engine.isTerminal) {
+            return undefined;
+        }
+        return this.stepDefs[this.engine.data.currentStepIndex]?.name;
+    }
+    /** Whether the pipeline has reached a terminal state */
+    get isTerminal() {
+        return this.engine.isTerminal;
+    }
+    /** Whether the pipeline is paused at a gate */
+    get isWaitingAtGate() {
+        return this.engine.status.startsWith("gate:");
+    }
+    // ── Lifecycle Methods ────────────────────────────────────────────
+    /**
+     * Load persisted state and execute.
+     *
+     * - Fresh pipeline: executes from step 0
+     * - Interrupted mid-step: re-executes that step
+     * - Waiting at gate: stays at gate (call resume() to continue)
+     * - Terminal: no-op
+     */
+    async run() {
+        await this.engine.load();
+        if (this.engine.isTerminal) {
+            return;
+        }
+        if (this.isWaitingAtGate) {
+            // Check if this is a fresh gate (not yet entered)
+            const currentIndex = this.engine.data.currentStepIndex;
+            const stepState = this.engine.data.steps[currentIndex];
+            if (stepState.status === "pending") {
+                // Fresh gate — enter it (run execute if present, fire hooks)
+                await (0, stepRunner_js_1.enterGate)(this.runnerDeps, currentIndex);
+            }
+            return;
+        }
+        await this.executeFrom(this.engine.data.currentStepIndex);
+    }
+    /**
+     * Resume from a gate step. Merges the provided partial data and
+     * continues execution from the next step.
+     *
+     * @throws If the pipeline is not currently at a gate
+     */
+    async resume(data) {
+        if (!this.isWaitingAtGate) {
+            throw new Error(`Cannot resume: pipeline is not at a gate (status: "${this.status}")`);
+        }
+        const index = this.engine.data.currentStepIndex;
+        const stepDef = this.stepDefs[index];
+        this.logger.info("Pipeline gate resumed", {
+            pipeline: this.engine.data.steps[0]?.name,
+            step: stepDef.name,
+            hasData: data !== undefined,
+        });
+        // Merge data and mark gate step completed
+        await this.engine.update((d) => {
+            if (data) {
+                Object.assign(d.output, data);
+            }
+            d.steps[index].status = "completed";
+            d.steps[index].completedAt = new Date().toISOString();
+            d.currentStepIndex = index + 1;
+        });
+        // Transition to next step's status
+        const nextStatus = (0, buildTransitions_js_1.statusForStep)(this.stepDefs, index + 1);
+        await this.engine.transition(nextStatus);
+        // Resolve any waiting gate promise (for in-process resumption)
+        const resolver = this.gateResolver;
+        this.gateResolver = null;
+        this.gatePromise = null;
+        resolver?.();
+        // Continue execution if not completed
+        if (nextStatus !== "completed") {
+            await this.executeFrom(index + 1);
+        }
+        else {
+            this.logger.info("Pipeline completed", {
+                pipeline: this.engine.data.steps[0]?.name,
+            });
+            (0, stepRunner_js_1.fireHook)(this.hooks, "onComplete", this.data);
+        }
+    }
+    /**
+     * Cancel the pipeline. Transitions to "cancelled" status.
+     */
+    async cancel() {
+        if (this.engine.isTerminal) {
+            return;
+        }
+        this.abortController.abort();
+        await this.engine.transition("cancelled");
+        this.logger.info("Pipeline cancelled", {
+            pipeline: this.engine.data.steps[0]?.name,
+            step: this.currentStep,
+        });
+        // Resolve any waiting gate promise to unblock
+        const resolver = this.gateResolver;
+        this.gateResolver = null;
+        this.gatePromise = null;
+        resolver?.();
+    }
+    /**
+     * Subscribe to engine change events. Returns an unsubscribe function.
+     */
+    on(listener) {
+        return this.engine.on((event) => {
+            listener({ status: event.status, data: event.data.output });
+        });
+    }
+    /**
+     * Return a read-only snapshot of the pipeline state.
+     */
+    toSnapshot() {
+        return {
+            status: this.status,
+            data: structuredClone(this.data),
+            steps: structuredClone(this.engine.data.steps),
+            isTerminal: this.isTerminal,
+        };
+    }
+    // ── Private ────────────────────────────────────────────────────────
+    /** Assemble dependencies for step runner functions. */
+    get runnerDeps() {
+        return {
+            engine: this.engine,
+            stepDefs: this.stepDefs,
+            hooks: this.hooks,
+            logger: this.logger,
+            signal: this.abortController.signal,
+        };
+    }
+    async executeFrom(startIndex) {
+        for (let i = startIndex; i < this.stepDefs.length; i++) {
+            // Check cancellation between steps
+            if (this.abortController.signal.aborted) {
+                if (!this.engine.isTerminal) {
+                    await this.engine.transition("cancelled");
+                }
+                return;
+            }
+            const stepDef = this.stepDefs[i];
+            // Gate step
+            if (stepDef.gate === true) {
+                await (0, stepRunner_js_1.enterGate)(this.runnerDeps, i);
+                return; // Execution pauses here — resume() continues
+            }
+            // Regular or retryable step
+            const succeeded = await (0, stepRunner_js_1.runStep)(this.runnerDeps, i);
+            if (!succeeded) {
+                return;
+            } // Failed — pipeline is in "failed" state
+        }
+        // All steps complete
+        await this.engine.transition("completed");
+        this.logger.info("Pipeline completed", {
+            pipeline: this.engine.data.steps[0]?.name,
+        });
+        (0, stepRunner_js_1.fireHook)(this.hooks, "onComplete", this.data);
+    }
+}
+exports.Pipeline = Pipeline;
+//# sourceMappingURL=Pipeline.js.map

package/dist/Pipeline.js.map

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

package/dist/buildTransitions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Pure functions for computing Pipeline transition maps from step definitions.
+ */
+import type { StepDefinition } from "./pipelineTypes.js";
+import type { TransitionMap } from "./types.js";
+/**
+ * Compute the status string for a step at the given index.
+ * Returns "completed" if the index is past the end.
+ */
+export declare function statusForStep<T>(steps: readonly StepDefinition<T>[], index: number): string;
+/** Build a TransitionMap from step definitions. */
+export declare function buildTransitions<T>(steps: readonly StepDefinition<T>[]): TransitionMap<string>;
+//# sourceMappingURL=buildTransitions.d.ts.map

package/dist/buildTransitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTransitions.d.ts","sourceRoot":"","sources":["../src/buildTransitions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,EACnC,KAAK,EAAE,MAAM,GACZ,MAAM,CAMR;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,KAAK,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,GAClC,aAAa,CAAC,MAAM,CAAC,CAqBvB"}

package/dist/buildTransitions.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Pure functions for computing Pipeline transition maps from step definitions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statusForStep = statusForStep;
+exports.buildTransitions = buildTransitions;
+/**
+ * Compute the status string for a step at the given index.
+ * Returns "completed" if the index is past the end.
+ */
+function statusForStep(steps, index) {
+    if (index >= steps.length) {
+        return "completed";
+    }
+    const step = steps[index];
+    return step.gate === true ? `gate:${step.name}` : `running:${step.name}`;
+}
+/** Build a TransitionMap from step definitions. */
+function buildTransitions(steps) {
+    const map = {};
+    for (let i = 0; i < steps.length; i++) {
+        const step = steps[i];
+        const isGate = step.gate === true;
+        const nextStatus = statusForStep(steps, i + 1);
+        if (isGate) {
+            map[`gate:${step.name}`] = [nextStatus, "failed", "cancelled"];
+        }
+        else {
+            map[`running:${step.name}`] = [nextStatus, "failed", "cancelled"];
+        }
+    }
+    // Terminal states
+    map.completed = [];
+    map.failed = [];
+    map.cancelled = [];
+    return map;
+}
+//# sourceMappingURL=buildTransitions.js.map

package/dist/buildTransitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildTransitions.js","sourceRoot":"","sources":["../src/buildTransitions.ts"],"names":[],"mappings":";AAAA;;GAEG;;AASH,sCASC;AAGD,4CAuBC;AAvCD;;;GAGG;AACH,SAAgB,aAAa,CAC3B,KAAmC,EACnC,KAAa;IAEb,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC;AAC3E,CAAC;AAED,mDAAmD;AACnD,SAAgB,gBAAgB,CAC9B,KAAmC;IAEnC,MAAM,GAAG,GAAsC,EAAE,CAAC;IAElD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;QAClC,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAE/C,IAAI,MAAM,EAAE,CAAC;YACX,GAAG,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,GAAG,CAAC,SAAS,GAAG,EAAE,CAAC;IACnB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;IAChB,GAAG,CAAC,SAAS,GAAG,EAAE,CAAC;IAEnB,OAAO,GAA4B,CAAC;AACtC,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { DataCursor } from "./DataCursor.js";
+export { Pipeline } from "./Pipeline.js";
 export { WorkflowEngine } from "./WorkflowEngine.js";
 export type { ChangeListener, WorkflowEngineOptions, WorkflowSnapshot, TransitionEvent, TransitionMap, DataUpdater, } from "./types.js";
+export type { PipelineHooks, PipelineOptions, PipelineSnapshot, RecoveryFn, StepContext, StepDefinition, StepExecutor, StepState, } from "./pipelineTypes.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,cAAc,EACd,YAAY,EACZ,SAAS,GACV,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkflowEngine = exports.DataCursor = void 0;
+exports.WorkflowEngine = exports.Pipeline = exports.DataCursor = void 0;
 var DataCursor_js_1 = require("./DataCursor.js");
 Object.defineProperty(exports, "DataCursor", { enumerable: true, get: function () { return DataCursor_js_1.DataCursor; } });
+var Pipeline_js_1 = require("./Pipeline.js");
+Object.defineProperty(exports, "Pipeline", { enumerable: true, get: function () { return Pipeline_js_1.Pipeline; } });
 var WorkflowEngine_js_1 = require("./WorkflowEngine.js");
 Object.defineProperty(exports, "WorkflowEngine", { enumerable: true, get: function () { return WorkflowEngine_js_1.WorkflowEngine; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iDAA6C;AAApC,2GAAA,UAAU,OAAA;AACnB,yDAAqD;AAA5C,mHAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iDAA6C;AAApC,2GAAA,UAAU,OAAA;AACnB,6CAAyC;AAAhC,uGAAA,QAAQ,OAAA;AACjB,yDAAqD;AAA5C,mHAAA,cAAc,OAAA"}

package/dist/pipelineTypes.d.ts

@@ -0,0 +1,110 @@
+import type { Logger } from "@hardlydifficult/logger";
+/**
+ * Step execution context passed to every step's execute function.
+ */
+export interface StepContext<TData> {
+    /** Accumulated data from all prior steps (read-only) */
+    readonly data: Readonly<TData>;
+    /** Abort signal — steps should check this and bail early */
+    readonly signal: AbortSignal;
+}
+/**
+ * The execute function for a step.
+ * Returns a partial data update to merge into accumulated data.
+ */
+export type StepExecutor<TData> = (ctx: StepContext<TData>) => Promise<Partial<TData>>;
+/**
+ * Recovery function invoked when a retryable step fails.
+ * Called between retries. Returns a partial data update
+ * that is merged before the step re-executes.
+ */
+export type RecoveryFn<TData> = (error: Error, ctx: StepContext<TData>) => Promise<Partial<TData>>;
+/**
+ * Step definition — one entry in the pipeline's step list.
+ *
+ * Three kinds:
+ *   - Regular step: has `execute`, runs immediately
+ *   - Gate step: has `gate: true`, pauses until `resume()` is called.
+ *     May also have `execute` which runs before pausing.
+ *   - Retryable step: has `execute` + `retries` (and optionally `recover`)
+ */
+export interface StepDefinition<TData> {
+    /** Unique step name — becomes part of the pipeline status (e.g. "running:create_plan") */
+    name: string;
+    /** Execute function. For gate steps, runs before pausing. */
+    execute?: StepExecutor<TData>;
+    /** If true, pipeline pauses after execute until resume() is called */
+    gate?: boolean;
+    /** Number of retry attempts on failure (default 0 = no retries) */
+    retries?: number;
+    /** Recovery function called between retries. Only meaningful if retries > 0. */
+    recover?: RecoveryFn<TData>;
+}
+/**
+ * Runtime state of a single step, persisted inside PipelineData.
+ */
+export interface StepState {
+    name: string;
+    status: "pending" | "running" | "completed" | "failed" | "gate_waiting";
+    startedAt?: string;
+    completedAt?: string;
+    error?: string;
+    attempts: number;
+}
+/**
+ * Internal persisted data shape for Pipeline.
+ * TData is the user's accumulated output data.
+ */
+export interface PipelineData<TData> {
+    /** Index of the current step (0-based) */
+    currentStepIndex: number;
+    /** Per-step runtime state */
+    steps: StepState[];
+    /** Accumulated output data from completed steps */
+    output: TData;
+    /** ISO timestamp of pipeline creation */
+    createdAt: string;
+}
+/**
+ * Lifecycle hooks — all optional.
+ * Hook errors are swallowed to avoid breaking pipeline execution.
+ */
+export interface PipelineHooks<TData> {
+    onStepStart?: (name: string, data: Readonly<TData>) => void;
+    onStepComplete?: (name: string, data: Readonly<TData>) => void;
+    onStepFailed?: (name: string, error: string, data: Readonly<TData>) => void;
+    onGateReached?: (name: string, data: Readonly<TData>) => void;
+    onComplete?: (data: Readonly<TData>) => void;
+    onFailed?: (name: string, error: string, data: Readonly<TData>) => void;
+}
+/**
+ * Options for creating a Pipeline.
+ */
+export interface PipelineOptions<TData> {
+    /** Unique key for persistence (passed to WorkflowEngine) */
+    key: string;
+    /** Ordered list of step definitions */
+    steps: readonly StepDefinition<TData>[];
+    /** Initial value for the accumulated output data */
+    initialData: TData;
+    /** Logger — all step lifecycle events are logged automatically */
+    logger: Logger;
+    /** Directory for state persistence */
+    stateDirectory?: string;
+    /** Auto-save interval in ms (default 5000) */
+    autoSaveMs?: number;
+    /** Lifecycle hooks for external integrations (Discord, dashboard, etc.) */
+    hooks?: PipelineHooks<TData>;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+}
+/**
+ * Read-only snapshot of the pipeline state.
+ */
+export interface PipelineSnapshot<TData> {
+    status: string;
+    data: Readonly<TData>;
+    steps: readonly StepState[];
+    isTerminal: boolean;
+}
+//# sourceMappingURL=pipelineTypes.d.ts.map

package/dist/pipelineTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelineTypes.d.ts","sourceRoot":"","sources":["../src/pipelineTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,KAAK;IAChC,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,KAAK,IAAI,CAChC,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,KACpB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAE7B;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,KAAK,IAAI,CAC9B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,KACpB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc,CAAC,KAAK;IACnC,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,OAAO,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAC9B,sEAAsE;IACtE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,OAAO,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,cAAc,CAAC;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,KAAK;IACjC,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,mDAAmD;IACnD,MAAM,EAAE,KAAK,CAAC;IACd,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK;IAClC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC5D,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC/D,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC5E,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC9D,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;CACzE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,KAAK;IACpC,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,KAAK,EAAE,SAAS,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;IACxC,oDAAoD;IACpD,WAAW,EAAE,KAAK,CAAC;IACnB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7B,oCAAoC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtB,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAC;CACrB"}

package/dist/pipelineTypes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=pipelineTypes.js.map

package/dist/pipelineTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelineTypes.js","sourceRoot":"","sources":["../src/pipelineTypes.ts"],"names":[],"mappings":""}

package/dist/stepRunner.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Step execution functions for Pipeline.
+ *
+ * Extracted from Pipeline to keep each module focused:
+ *   - runStep: retry loop, recovery, error handling
+ *   - enterGate: gate transitions, optional pre-execute
+ *   - fireHook: lifecycle hook dispatch with error swallowing
+ */
+import type { Logger } from "@hardlydifficult/logger";
+import type { PipelineData, PipelineHooks, StepDefinition } from "./pipelineTypes.js";
+import type { WorkflowEngine } from "./WorkflowEngine.js";
+/**
+ * Dependencies passed from Pipeline to step execution functions.
+ */
+export interface StepRunnerDeps<TData extends Record<string, unknown>> {
+    engine: WorkflowEngine<string, PipelineData<TData>>;
+    stepDefs: readonly StepDefinition<TData>[];
+    hooks: PipelineHooks<TData>;
+    logger: Logger;
+    signal: AbortSignal;
+}
+/** Fire a lifecycle hook, swallowing any errors. */
+export declare function fireHook<TData extends Record<string, unknown>, K extends keyof PipelineHooks<TData>>(hooks: PipelineHooks<TData>, name: K, ...args: Parameters<NonNullable<PipelineHooks<TData>[K]>>): void;
+/**
+ * Enter a gate step: transition to gate status, run optional execute, fire hooks.
+ * On execute failure, transitions pipeline to "failed".
+ */
+export declare function enterGate<TData extends Record<string, unknown>>(deps: StepRunnerDeps<TData>, index: number): Promise<void>;
+/**
+ * Execute a single step with retry logic.
+ * Returns true on success, false on failure (pipeline transitions to "failed").
+ */
+export declare function runStep<TData extends Record<string, unknown>>(deps: StepRunnerDeps<TData>, index: number): Promise<boolean>;
+//# sourceMappingURL=stepRunner.d.ts.map

package/dist/stepRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepRunner.d.ts","sourceRoot":"","sources":["../src/stepRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EAEb,cAAc,EACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACnE,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IACpD,QAAQ,EAAE,SAAS,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;IAC3C,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;CACrB;AAmBD,oDAAoD;AACpD,wBAAgB,QAAQ,CACtB,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,CAAC,SAAS,MAAM,aAAa,CAAC,KAAK,CAAC,EAEpC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,EAC3B,IAAI,EAAE,CAAC,EACP,GAAG,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACxD,IAAI,CAWN;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,EAC3B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAyDf;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,EAC3B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,OAAO,CAAC,CA+IlB"}

package/dist/stepRunner.js

@@ -0,0 +1,201 @@
+"use strict";
+/**
+ * Step execution functions for Pipeline.
+ *
+ * Extracted from Pipeline to keep each module focused:
+ *   - runStep: retry loop, recovery, error handling
+ *   - enterGate: gate transitions, optional pre-execute
+ *   - fireHook: lifecycle hook dispatch with error swallowing
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fireHook = fireHook;
+exports.enterGate = enterGate;
+exports.runStep = runStep;
+/** Build a StepContext for a step's execute function. */
+function createStepContext(deps) {
+    return {
+        data: deps.engine.data.output,
+        signal: deps.signal,
+    };
+}
+/** Pipeline key for log context (uses first step name as identifier). */
+function pipelineKey(deps) {
+    return deps.engine.data.steps[0]?.name;
+}
+/** Fire a lifecycle hook, swallowing any errors. */
+function fireHook(hooks, name, ...args) {
+    const fn = hooks[name];
+    if (!fn) {
+        return;
+    }
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- dynamic hook dispatch
+        fn(...args);
+    }
+    catch {
+        // Hooks must not break pipeline execution
+    }
+}
+/**
+ * Enter a gate step: transition to gate status, run optional execute, fire hooks.
+ * On execute failure, transitions pipeline to "failed".
+ */
+async function enterGate(deps, index) {
+    const stepDef = deps.stepDefs[index];
+    // Transition to gate status
+    const gateStatus = `gate:${stepDef.name}`;
+    if (deps.engine.status !== gateStatus) {
+        await deps.engine.transition(gateStatus, (d) => {
+            d.currentStepIndex = index;
+            d.steps[index].status = "gate_waiting";
+            d.steps[index].startedAt = new Date().toISOString();
+        });
+    }
+    // Run optional execute before pausing
+    if (stepDef.execute) {
+        try {
+            const ctx = createStepContext(deps);
+            const result = await stepDef.execute(ctx);
+            await deps.engine.update((d) => {
+                Object.assign(d.output, result);
+            });
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            deps.logger.error("Pipeline gate execute failed", {
+                pipeline: pipelineKey(deps),
+                step: stepDef.name,
+                error: error.message,
+            });
+            await deps.engine.update((d) => {
+                d.steps[index].status = "failed";
+                d.steps[index].completedAt = new Date().toISOString();
+                d.steps[index].error = error.message;
+            });
+            await deps.engine.transition("failed");
+            fireHook(deps.hooks, "onStepFailed", stepDef.name, error.message, deps.engine.data.output);
+            fireHook(deps.hooks, "onFailed", stepDef.name, error.message, deps.engine.data.output);
+            return;
+        }
+    }
+    deps.logger.info("Pipeline gate reached", {
+        pipeline: pipelineKey(deps),
+        step: stepDef.name,
+    });
+    fireHook(deps.hooks, "onGateReached", stepDef.name, deps.engine.data.output);
+}
+/**
+ * Execute a single step with retry logic.
+ * Returns true on success, false on failure (pipeline transitions to "failed").
+ */
+async function runStep(deps, index) {
+    const stepDef = deps.stepDefs[index];
+    const maxAttempts = (stepDef.retries ?? 0) + 1;
+    if (!stepDef.execute) {
+        throw new Error(`Step "${stepDef.name}" has no execute function and is not a gate`);
+    }
+    // Transition to running status
+    const runningStatus = `running:${stepDef.name}`;
+    if (deps.engine.status !== runningStatus) {
+        await deps.engine.transition(runningStatus, (d) => {
+            d.currentStepIndex = index;
+            d.steps[index].status = "running";
+            d.steps[index].startedAt = new Date().toISOString();
+        });
+    }
+    else {
+        // Crash recovery — already in running status, just update step state
+        await deps.engine.update((d) => {
+            d.steps[index].status = "running";
+            d.steps[index].startedAt ??= new Date().toISOString();
+        });
+    }
+    deps.logger.info("Pipeline step started", {
+        pipeline: pipelineKey(deps),
+        step: stepDef.name,
+    });
+    fireHook(deps.hooks, "onStepStart", stepDef.name, deps.engine.data.output);
+    const startMs = Date.now();
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            const ctx = createStepContext(deps);
+            const result = await stepDef.execute(ctx);
+            const durationMs = Date.now() - startMs;
+            // Success — merge result and mark completed
+            await deps.engine.update((d) => {
+                Object.assign(d.output, result);
+                d.steps[index].status = "completed";
+                d.steps[index].completedAt = new Date().toISOString();
+                d.steps[index].attempts = attempt;
+                d.steps[index].error = undefined;
+                d.currentStepIndex = index + 1;
+            });
+            deps.logger.info("Pipeline step completed", {
+                pipeline: pipelineKey(deps),
+                step: stepDef.name,
+                attempt,
+                durationMs,
+            });
+            fireHook(deps.hooks, "onStepComplete", stepDef.name, deps.engine.data.output);
+            return true;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            await deps.engine.update((d) => {
+                d.steps[index].attempts = attempt;
+                d.steps[index].error = error.message;
+            });
+            if (attempt < maxAttempts) {
+                deps.logger.warn("Pipeline step retry", {
+                    pipeline: pipelineKey(deps),
+                    step: stepDef.name,
+                    attempt,
+                    maxAttempts,
+                    error: error.message,
+                });
+                // Recovery before retry
+                if (stepDef.recover) {
+                    try {
+                        const ctx = createStepContext(deps);
+                        const recoveryResult = await stepDef.recover(error, ctx);
+                        await deps.engine.update((d) => {
+                            Object.assign(d.output, recoveryResult);
+                        });
+                    }
+                    catch (recoverErr) {
+                        const recoverError = recoverErr instanceof Error
+                            ? recoverErr
+                            : new Error(String(recoverErr));
+                        deps.logger.error("Pipeline recovery failed", {
+                            pipeline: pipelineKey(deps),
+                            step: stepDef.name,
+                            attempt,
+                            error: recoverError.message,
+                        });
+                        // Recovery failed — continue to next attempt anyway
+                    }
+                }
+                continue;
+            }
+            const durationMs = Date.now() - startMs;
+            // All attempts exhausted — fail
+            await deps.engine.update((d) => {
+                d.steps[index].status = "failed";
+                d.steps[index].completedAt = new Date().toISOString();
+            });
+            deps.logger.error("Pipeline step failed", {
+                pipeline: pipelineKey(deps),
+                step: stepDef.name,
+                attempt,
+                durationMs,
+                error: error.message,
+            });
+            fireHook(deps.hooks, "onStepFailed", stepDef.name, error.message, deps.engine.data.output);
+            await deps.engine.transition("failed");
+            fireHook(deps.hooks, "onFailed", stepDef.name, error.message, deps.engine.data.output);
+            return false;
+        }
+    }
+    return false; // unreachable, but satisfies TS
+}
+//# sourceMappingURL=stepRunner.js.map

package/dist/stepRunner.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardlydifficult/workflow-engine",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -18,11 +18,13 @@
     "@hardlydifficult/state-tracker": "file:../state-tracker"
   },
   "devDependencies": {
-    "@types/node": "20.19.31",
-    "typescript": "5.8.3",
-    "vitest": "1.6.1"
+    "@hardlydifficult/logger": "file:../logger",
+    "@types/node": "25.2.3",
+    "typescript": "5.9.3",
+    "vitest": "4.0.18"
   },
   "peerDependencies": {
+    "@hardlydifficult/logger": ">=1.0.0",
     "@hardlydifficult/state-tracker": ">=2.0.0"
   },
   "engines": {