@thoughtflow/core 0.1.2

package/dist/libs/task-flow/pipeline/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PipelineBuilder = exports.PipelineRunner = void 0;
+__exportStar(require("./pipeline.types"), exports);
+var pipeline_runner_class_1 = require("./pipeline-runner.class");
+Object.defineProperty(exports, "PipelineRunner", { enumerable: true, get: function () { return pipeline_runner_class_1.PipelineRunner; } });
+var pipeline_builder_class_1 = require("./pipeline-builder.class");
+Object.defineProperty(exports, "PipelineBuilder", { enumerable: true, get: function () { return pipeline_builder_class_1.PipelineBuilder; } });
+__exportStar(require("./stages"), exports);
+//# sourceMappingURL=index.js.map

package/dist/libs/task-flow/pipeline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/libs/task-flow/pipeline/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,iEAAyD;AAAhD,uHAAA,cAAc,OAAA;AACvB,mEAA2D;AAAlD,yHAAA,eAAe,OAAA;AACxB,2CAAyB"}

package/dist/libs/task-flow/pipeline/pipeline-builder.class.d.ts

@@ -0,0 +1,57 @@
+import type { PipelineDefinition, StageHandler } from "./pipeline.types";
+/**
+ * Fluent builder for pipelines.
+ *
+ * ```ts
+ * const pipeline = Pipeline.create("deploy-task", "Deploy a kanban task")
+ *   .stage("git-worktree", "Prepare worktree", { baseBranch: "main" })
+ *   .stage("docker-env",   "Start dev containers")
+ *   .stage("task-flow",    "Run task flow loop", { strictness: "balanced" })
+ *   .stage("verify",       "Verify acceptance criteria")
+ *   .stage("commit-push",  "Commit & rebase & push", { commitStyle: "conventional" })
+ *   .stage("kanban-update","Update kanban board")
+ *   .rollbackOnFailure()
+ *   .build();
+ * ```
+ */
+export declare class PipelineBuilder {
+    private readonly id;
+    private readonly name;
+    private stages;
+    private storeInit;
+    private doRollback;
+    private constructor();
+    static create(id: string, name: string): PipelineBuilder;
+    /**
+     * Append a stage by registered factory type.
+     *
+     * @param type  Factory key (e.g. "git-worktree", "docker-env").
+     * @param name  Human-readable label shown in logs.
+     * @param args  Optional arguments forwarded to the factory.
+     */
+    stage(type: string, name: string, args?: Record<string, unknown>): this;
+    /**
+     * Append a pre-built stage instance (no factory needed).
+     */
+    addStage(stageInstance: StageHandler): this;
+    /**
+     * Seed initial values into the shared store.
+     */
+    withStore(values: Record<string, unknown>): this;
+    /**
+     * Enable reverse-order rollback when a stage fails.
+     */
+    rollbackOnFailure(): this;
+    /**
+     * Produce the pipeline definition (for use with `PipelineRunner.run`).
+     */
+    build(): PipelineDefinition;
+    /**
+     * Produce an array of pre-built stage instances (for `PipelineRunner.runStages`).
+     * Only returns instances added via `addStage`. Factory-based stages
+     * are resolved by the runner at execution time.
+     */
+    getInstances(): Map<string, StageHandler>;
+    private _instances;
+}
+//# sourceMappingURL=pipeline-builder.class.d.ts.map

package/dist/libs/task-flow/pipeline/pipeline-builder.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-builder.class.d.ts","sourceRoot":"","sources":["../../../../src/libs/task-flow/pipeline/pipeline-builder.class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAmB,MAAM,kBAAkB,CAAC;AAE1F;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAe;IAMxB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI;IANvB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO;IAKP,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe;IAIxD;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAUvE;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,YAAY,GAAG,IAAI;IAO3C;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAKhD;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAKzB;;OAEG;IACH,KAAK,IAAI,kBAAkB;IAU3B;;;;OAIG;IACH,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAKzC,OAAO,CAAC,UAAU,CAAmC;CACtD"}

package/dist/libs/task-flow/pipeline/pipeline-builder.class.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PipelineBuilder = void 0;
+/**
+ * Fluent builder for pipelines.
+ *
+ * ```ts
+ * const pipeline = Pipeline.create("deploy-task", "Deploy a kanban task")
+ *   .stage("git-worktree", "Prepare worktree", { baseBranch: "main" })
+ *   .stage("docker-env",   "Start dev containers")
+ *   .stage("task-flow",    "Run task flow loop", { strictness: "balanced" })
+ *   .stage("verify",       "Verify acceptance criteria")
+ *   .stage("commit-push",  "Commit & rebase & push", { commitStyle: "conventional" })
+ *   .stage("kanban-update","Update kanban board")
+ *   .rollbackOnFailure()
+ *   .build();
+ * ```
+ */
+class PipelineBuilder {
+    id;
+    name;
+    stages = [];
+    storeInit = {};
+    doRollback = false;
+    constructor(id, name) {
+        this.id = id;
+        this.name = name;
+    }
+    static create(id, name) {
+        return new PipelineBuilder(id, name);
+    }
+    /**
+     * Append a stage by registered factory type.
+     *
+     * @param type  Factory key (e.g. "git-worktree", "docker-env").
+     * @param name  Human-readable label shown in logs.
+     * @param args  Optional arguments forwarded to the factory.
+     */
+    stage(type, name, args) {
+        this.stages.push({
+            id: `${this.id}/${type}-${this.stages.length}`,
+            name,
+            type,
+            args,
+        });
+        return this;
+    }
+    /**
+     * Append a pre-built stage instance (no factory needed).
+     */
+    addStage(stageInstance) {
+        this.stages.push({ id: stageInstance.id, name: stageInstance.name });
+        // Stash the instance so build() can return it.
+        this._instances.set(stageInstance.id, stageInstance);
+        return this;
+    }
+    /**
+     * Seed initial values into the shared store.
+     */
+    withStore(values) {
+        Object.assign(this.storeInit, values);
+        return this;
+    }
+    /**
+     * Enable reverse-order rollback when a stage fails.
+     */
+    rollbackOnFailure() {
+        this.doRollback = true;
+        return this;
+    }
+    /**
+     * Produce the pipeline definition (for use with `PipelineRunner.run`).
+     */
+    build() {
+        return {
+            id: this.id,
+            name: this.name,
+            stages: [...this.stages],
+            initialStore: Object.keys(this.storeInit).length ? { ...this.storeInit } : undefined,
+            rollbackOnFailure: this.doRollback || undefined,
+        };
+    }
+    /**
+     * Produce an array of pre-built stage instances (for `PipelineRunner.runStages`).
+     * Only returns instances added via `addStage`. Factory-based stages
+     * are resolved by the runner at execution time.
+     */
+    getInstances() {
+        return new Map(this._instances);
+    }
+    // internal
+    _instances = new Map();
+}
+exports.PipelineBuilder = PipelineBuilder;
+//# sourceMappingURL=pipeline-builder.class.js.map

package/dist/libs/task-flow/pipeline/pipeline-builder.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-builder.class.js","sourceRoot":"","sources":["../../../../src/libs/task-flow/pipeline/pipeline-builder.class.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAa,eAAe;IAMP;IACA;IANX,MAAM,GAAsB,EAAE,CAAC;IAC/B,SAAS,GAA4B,EAAE,CAAC;IACxC,UAAU,GAAG,KAAK,CAAC;IAE3B,YACmB,EAAU,EACV,IAAY;QADZ,OAAE,GAAF,EAAE,CAAQ;QACV,SAAI,GAAJ,IAAI,CAAQ;IAC5B,CAAC;IAEJ,MAAM,CAAC,MAAM,CAAC,EAAU,EAAE,IAAY;QACpC,OAAO,IAAI,eAAe,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAY,EAAE,IAAY,EAAE,IAA8B;QAC9D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;YAC9C,IAAI;YACJ,IAAI;YACJ,IAAI;SACL,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,aAA2B;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,aAAa,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;QACrE,+CAA+C;QAC/C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAA+B;QACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;YACxB,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;YACpF,iBAAiB,EAAE,IAAI,CAAC,UAAU,IAAI,SAAS;SAChD,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,YAAY;QACV,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAED,WAAW;IACH,UAAU,GAAG,IAAI,GAAG,EAAwB,CAAC;CACtD;AAjFD,0CAiFC"}

package/dist/libs/task-flow/pipeline/pipeline-runner.class.d.ts

@@ -0,0 +1,45 @@
+import type { PipelineDefinition, PipelineEventHandler, PipelineRunResult, StageHandler, StageFactory } from "./pipeline.types";
+/**
+ * Executes a pipeline — an ordered chain of stages where each stage's
+ * output feeds into the next stage's input.
+ *
+ * ```ts
+ * const runner = new PipelineRunner();
+ * runner.registerFactory("git-worktree", gitWorktreeStageFactory);
+ * runner.registerFactory("docker-env",   dockerEnvStageFactory);
+ *
+ * const result = await runner.run(pipelineDefinition, initialInput);
+ * ```
+ */
+export declare class PipelineRunner {
+    private factories;
+    private listeners;
+    registerFactory(type: string, factory: StageFactory): this;
+    on(handler: PipelineEventHandler): this;
+    off(handler: PipelineEventHandler): this;
+    /**
+     * Run a pipeline definition with the given initial input.
+     *
+     * @param definition  Declarative pipeline (stages are descriptors).
+     * @param input       Initial input fed into the first stage.
+     * @param options     Optional overrides (abort controller, task ID).
+     */
+    run(definition: PipelineDefinition, input: unknown, options?: {
+        abortController?: AbortController;
+        taskId?: string;
+    }): Promise<PipelineRunResult>;
+    /**
+     * Run a pipeline from pre-built stage instances (skip factory resolution).
+     */
+    runStages(id: string, name: string, stages: StageHandler[], input: unknown, options?: {
+        abortController?: AbortController;
+        taskId?: string;
+        initialStore?: Record<string, unknown>;
+        rollbackOnFailure?: boolean;
+    }): Promise<PipelineRunResult>;
+    private buildStages;
+    private finish;
+    private record;
+    private emit;
+}
+//# sourceMappingURL=pipeline-runner.class.d.ts.map

package/dist/libs/task-flow/pipeline/pipeline-runner.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-runner.class.d.ts","sourceRoot":"","sources":["../../../../src/libs/task-flow/pipeline/pipeline-runner.class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAElB,oBAAoB,EAEpB,iBAAiB,EACjB,YAAY,EAGZ,YAAY,EAEb,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,SAAS,CAA8B;IAI/C,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAO1D,EAAE,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAKvC,GAAG,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAOxC;;;;;;OAMG;IACG,GAAG,CACP,UAAU,EAAE,kBAAkB,EAC9B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,eAAe,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/D,OAAO,CAAC,iBAAiB,CAAC;IAmI7B;;OAEG;IACG,SAAS,CACb,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,YAAY,EAAE,EACtB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;QACR,eAAe,CAAC,EAAE,eAAe,CAAC;QAClC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACvC,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,GACA,OAAO,CAAC,iBAAiB,CAAC;IAsB7B,OAAO,CAAC,WAAW;YAkBL,MAAM;IA8CpB,OAAO,CAAC,MAAM;IAgBd,OAAO,CAAC,IAAI;CAab"}

package/dist/libs/task-flow/pipeline/pipeline-runner.class.js

@@ -0,0 +1,256 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PipelineRunner = void 0;
+/**
+ * Executes a pipeline — an ordered chain of stages where each stage's
+ * output feeds into the next stage's input.
+ *
+ * ```ts
+ * const runner = new PipelineRunner();
+ * runner.registerFactory("git-worktree", gitWorktreeStageFactory);
+ * runner.registerFactory("docker-env",   dockerEnvStageFactory);
+ *
+ * const result = await runner.run(pipelineDefinition, initialInput);
+ * ```
+ */
+class PipelineRunner {
+    factories = new Map();
+    listeners = [];
+    // ── Factory registry ────────────────────────────────────────────────────
+    registerFactory(type, factory) {
+        this.factories.set(type, factory);
+        return this;
+    }
+    // ── Event listeners ─────────────────────────────────────────────────────
+    on(handler) {
+        this.listeners.push(handler);
+        return this;
+    }
+    off(handler) {
+        this.listeners = this.listeners.filter((h) => h !== handler);
+        return this;
+    }
+    // ── Run ─────────────────────────────────────────────────────────────────
+    /**
+     * Run a pipeline definition with the given initial input.
+     *
+     * @param definition  Declarative pipeline (stages are descriptors).
+     * @param input       Initial input fed into the first stage.
+     * @param options     Optional overrides (abort controller, task ID).
+     */
+    async run(definition, input, options) {
+        const ac = options?.abortController ?? new AbortController();
+        const runStart = Date.now();
+        const meta = {
+            runId: crypto.randomUUID(),
+            pipelineId: definition.id,
+            startedAt: new Date().toISOString(),
+            taskId: options?.taskId,
+        };
+        // Shared store initialised from definition + overrides.
+        const store = new Map(Object.entries(definition.initialStore ?? {}));
+        const records = [];
+        const completedStages = [];
+        this.emit({ type: "pipeline:start", runId: meta.runId, timestamp: meta.startedAt });
+        // Materialise stages from descriptors.
+        const stages = this.buildStages(definition);
+        let current = input;
+        for (const stage of stages) {
+            if (ac.signal.aborted) {
+                records.push(this.record(stage, "skipped"));
+                continue;
+            }
+            const ctx = {
+                store,
+                signal: ac.signal,
+                log: (msg) => this.emit({
+                    type: "stage:log",
+                    runId: meta.runId,
+                    stageId: stage.id,
+                    stageName: stage.name,
+                    message: msg,
+                    timestamp: new Date().toISOString(),
+                }),
+                meta,
+            };
+            // ── shouldSkip? ──────────────────────────────────────────────────
+            if (stage.shouldSkip) {
+                const skip = await stage.shouldSkip(current, ctx);
+                if (skip) {
+                    records.push(this.record(stage, "skipped"));
+                    this.emit({
+                        type: "stage:skip",
+                        runId: meta.runId,
+                        stageId: stage.id,
+                        stageName: stage.name,
+                        timestamp: new Date().toISOString(),
+                    });
+                    continue;
+                }
+            }
+            // ── validate ─────────────────────────────────────────────────────
+            if (stage.validate) {
+                try {
+                    await stage.validate(current, ctx);
+                }
+                catch (err) {
+                    const rec = this.record(stage, "failed", err);
+                    records.push(rec);
+                    return this.finish(meta, records, current, runStart, definition, completedStages, err);
+                }
+            }
+            // ── execute ──────────────────────────────────────────────────────
+            const stageStart = Date.now();
+            this.emit({
+                type: "stage:start",
+                runId: meta.runId,
+                stageId: stage.id,
+                stageName: stage.name,
+                timestamp: new Date().toISOString(),
+            });
+            try {
+                const output = await stage.execute(current, ctx);
+                const duration = Date.now() - stageStart;
+                records.push(this.record(stage, "completed", undefined, duration));
+                this.emit({
+                    type: "stage:complete",
+                    runId: meta.runId,
+                    stageId: stage.id,
+                    stageName: stage.name,
+                    timestamp: new Date().toISOString(),
+                    data: { durationMs: duration },
+                });
+                completedStages.push(stage);
+                current = output;
+            }
+            catch (err) {
+                const duration = Date.now() - stageStart;
+                records.push(this.record(stage, "failed", err, duration));
+                this.emit({
+                    type: "stage:fail",
+                    runId: meta.runId,
+                    stageId: stage.id,
+                    stageName: stage.name,
+                    message: String(err),
+                    timestamp: new Date().toISOString(),
+                });
+                return this.finish(meta, records, current, runStart, definition, completedStages, err);
+            }
+        }
+        // All stages completed.
+        const durationMs = Date.now() - runStart;
+        this.emit({
+            type: "pipeline:complete",
+            runId: meta.runId,
+            timestamp: new Date().toISOString(),
+            data: { durationMs },
+        });
+        return {
+            meta,
+            status: "completed",
+            stages: records,
+            output: current,
+            durationMs,
+        };
+    }
+    /**
+     * Run a pipeline from pre-built stage instances (skip factory resolution).
+     */
+    async runStages(id, name, stages, input, options) {
+        // Wrap into a definition-like call so we reuse all logic.
+        const def = {
+            id,
+            name,
+            stages: stages.map((s) => ({ id: s.id, name: s.name })),
+            initialStore: options?.initialStore,
+            rollbackOnFailure: options?.rollbackOnFailure,
+        };
+        // Patch buildStages to return provided stages directly.
+        const origBuild = this.buildStages.bind(this);
+        this.buildStages = () => stages;
+        try {
+            return await this.run(def, input, options);
+        }
+        finally {
+            this.buildStages = origBuild;
+        }
+    }
+    // ── Internals ───────────────────────────────────────────────────────────
+    buildStages(definition) {
+        return definition.stages.map((desc) => {
+            if (!desc.type) {
+                throw new Error(`Stage "${desc.id}" has no 'type' and was not provided as a pre-built stage.`);
+            }
+            const factory = this.factories.get(desc.type);
+            if (!factory) {
+                throw new Error(`No factory registered for stage type "${desc.type}". ` +
+                    `Available: [${[...this.factories.keys()].join(", ")}]`);
+            }
+            return factory(desc);
+        });
+    }
+    async finish(meta, records, lastOutput, runStart, definition, completedStages, error) {
+        // Rollback completed stages in reverse order if configured.
+        if (definition.rollbackOnFailure) {
+            for (const stage of [...completedStages].reverse()) {
+                if (stage.rollback) {
+                    try {
+                        await stage.rollback({
+                            store: new Map(),
+                            signal: new AbortController().signal,
+                            log: () => { },
+                            meta,
+                        });
+                    }
+                    catch {
+                        // Rollback errors are swallowed — best-effort.
+                    }
+                }
+            }
+        }
+        const durationMs = Date.now() - runStart;
+        this.emit({
+            type: "pipeline:fail",
+            runId: meta.runId,
+            message: String(error),
+            timestamp: new Date().toISOString(),
+            data: { durationMs },
+        });
+        return {
+            meta,
+            status: "failed",
+            stages: records,
+            output: lastOutput,
+            durationMs,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+    record(stage, status, error, durationMs) {
+        const rec = {
+            stageId: stage.id,
+            stageName: stage.name,
+            status,
+        };
+        if (durationMs != null)
+            rec.durationMs = durationMs;
+        if (error)
+            rec.error = error instanceof Error ? error.message : String(error);
+        return rec;
+    }
+    emit(event) {
+        const full = {
+            ...event,
+            timestamp: event.timestamp ?? new Date().toISOString(),
+        };
+        for (const handler of this.listeners) {
+            try {
+                handler(full);
+            }
+            catch {
+                // Listener errors don't break the pipeline.
+            }
+        }
+    }
+}
+exports.PipelineRunner = PipelineRunner;
+//# sourceMappingURL=pipeline-runner.class.js.map

package/dist/libs/task-flow/pipeline/pipeline-runner.class.js.map

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

package/dist/libs/task-flow/pipeline/pipeline.types.d.ts

@@ -0,0 +1,113 @@
+export type StageStatus = "pending" | "running" | "completed" | "failed" | "skipped";
+/**
+ * Shared key-value store accessible by every stage.
+ * Use it for cross-stage data (connection maps, worktree paths, etc.)
+ */
+export type PipelineStore = Map<string, unknown>;
+/**
+ * Context passed into every stage at runtime.
+ */
+export interface StageContext {
+    /** Shared mutable store — lives for the entire pipeline run. */
+    store: PipelineStore;
+    /** Abort signal — stages should respect cancellation. */
+    signal: AbortSignal;
+    /** Emit a human-readable status line (logged / shown in UI). */
+    log: (message: string) => void;
+    /** Pipeline-level metadata (task ID, run ID, timestamps). */
+    meta: PipelineRunMeta;
+}
+/**
+ * A single composable pipeline stage.
+ *
+ * Implement `execute` to do the work.  Optionally implement:
+ *   - `shouldSkip` — return `true` to skip this stage entirely
+ *   - `rollback`   — undo side-effects on failure
+ *   - `validate`   — pre-flight check before `execute`
+ */
+export interface StageHandler<TIn = unknown, TOut = unknown> {
+    /** Unique identifier for this stage instance. */
+    id: string;
+    /** Short human-readable label (shown in logs / UI). */
+    name: string;
+    /** Do the work. */
+    execute(input: TIn, ctx: StageContext): Promise<TOut>;
+    /** Return true to skip this stage (input is forwarded as output). */
+    shouldSkip?(input: TIn, ctx: StageContext): Promise<boolean> | boolean;
+    /** Pre-flight validation. Throw to abort *before* execute runs. */
+    validate?(input: TIn, ctx: StageContext): Promise<void> | void;
+    /** Undo side-effects. Called when a *later* stage fails (if configured). */
+    rollback?(ctx: StageContext): Promise<void> | void;
+}
+/**
+ * Lightweight stage definition that can be built into a StageHandler.
+ * This is the DSL layer — users write these, builder converts to stages.
+ */
+export interface StageDescriptor<TIn = unknown, TOut = unknown> {
+    id: string;
+    name: string;
+    /** Stage factory — args come from the pipeline definition. */
+    args?: Record<string, unknown>;
+    /** When provided, the stage is created by the registered factory. */
+    type?: string;
+}
+export interface PipelineDefinition {
+    /** Unique pipeline identifier. */
+    id: string;
+    /** Human-readable name. */
+    name: string;
+    /** Ordered list of stage descriptors. */
+    stages: StageDescriptor[];
+    /** Initial values to seed into the store. */
+    initialStore?: Record<string, unknown>;
+    /** If true, run rollbacks on failure in reverse stage order. */
+    rollbackOnFailure?: boolean;
+}
+export interface PipelineRunMeta {
+    /** Unique run identifier. */
+    runId: string;
+    /** Pipeline definition ID. */
+    pipelineId: string;
+    /** ISO timestamp when the run started. */
+    startedAt: string;
+    /** Optional external task / ticket ID. */
+    taskId?: string;
+}
+export interface StageRunRecord {
+    stageId: string;
+    stageName: string;
+    status: StageStatus;
+    startedAt?: string;
+    completedAt?: string;
+    durationMs?: number;
+    error?: string;
+    /** Serializable summary of stage output (for logging / UI). */
+    outputSummary?: string;
+}
+export interface PipelineRunResult {
+    meta: PipelineRunMeta;
+    status: "completed" | "failed" | "aborted";
+    stages: StageRunRecord[];
+    /** Final output of the last successfully completed stage. */
+    output: unknown;
+    /** Total duration in ms. */
+    durationMs: number;
+    error?: string;
+}
+export type PipelineEventType = "pipeline:start" | "pipeline:complete" | "pipeline:fail" | "stage:start" | "stage:complete" | "stage:skip" | "stage:fail" | "stage:log";
+export interface PipelineEvent {
+    type: PipelineEventType;
+    runId: string;
+    stageId?: string;
+    stageName?: string;
+    message?: string;
+    timestamp: string;
+    data?: Record<string, unknown>;
+}
+export type PipelineEventHandler = (event: PipelineEvent) => void;
+/**
+ * A factory that creates a StageHandler from a descriptor's args.
+ * Register factories for reusable stage types ("git-worktree", "docker-env", etc.).
+ */
+export type StageFactory<TIn = unknown, TOut = unknown> = (descriptor: StageDescriptor<TIn, TOut>) => StageHandler<TIn, TOut>;
+//# sourceMappingURL=pipeline.types.d.ts.map

package/dist/libs/task-flow/pipeline/pipeline.types.d.ts.map

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

package/dist/libs/task-flow/pipeline/pipeline.types.js

@@ -0,0 +1,13 @@
+"use strict";
+// ── Pipeline core types ─────────────────────────────────────────────────────
+//
+// A pipeline is a linear chain of stages.  Each stage receives typed input,
+// can read/write a shared store, and produces typed output that becomes the
+// next stage's input.
+//
+//   [(input, store) → StageA → (output)] → [(input, store) → StageB → (output)] → …
+//
+// Stages are plain objects that satisfy StageHandler<In,Out>.
+// The runner executes them sequentially, handles errors, and emits events.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=pipeline.types.js.map

package/dist/libs/task-flow/pipeline/pipeline.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.types.js","sourceRoot":"","sources":["../../../../src/libs/task-flow/pipeline/pipeline.types.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,sBAAsB;AACtB,EAAE;AACF,oFAAoF;AACpF,EAAE;AACF,8DAA8D;AAC9D,2EAA2E"}