@thoughtflow/core 0.1.2

package/dist/libs/task-flow/pipeline/stages/commit-push.stage.d.ts

@@ -0,0 +1,39 @@
+import type { StageHandler, StageContext, StageFactory } from "../pipeline.types";
+import type { GitFlowConfig, PushOptions } from "../../git/git.types";
+export interface CommitPushStageInput {
+    /** Commit subject — what changed. */
+    subject: string;
+    /** Optional longer body. */
+    body?: string;
+    /** Commit type (feat, fix, chore…). */
+    type?: string;
+    /** Scope for conventional commits. */
+    scope?: string;
+    /** Kanban task ID injected into the message. */
+    taskId?: string;
+    /** Working directory override (default: read from store). */
+    cwd?: string;
+    /** Push options. */
+    push?: PushOptions;
+    /** If true, rebase onto baseBranch before pushing. */
+    rebase?: boolean;
+    /** Branch to rebase onto (default: "main"). */
+    rebaseBranch?: string;
+}
+export interface CommitPushStageOutput {
+    commitSha: string;
+    pushed: boolean;
+    rebased: boolean;
+}
+export declare class CommitPushStage implements StageHandler<CommitPushStageInput, CommitPushStageOutput> {
+    readonly id: string;
+    readonly name: string;
+    private readonly git;
+    constructor(id: string, name: string, config: GitFlowConfig);
+    shouldSkip(input: CommitPushStageInput, ctx: StageContext): Promise<boolean>;
+    execute(input: CommitPushStageInput, ctx: StageContext): Promise<CommitPushStageOutput>;
+    /** Low-level git exec (for rebase etc. not covered by GitCommitPush). */
+    private gitExec;
+}
+export declare function createCommitPushFactory(config: GitFlowConfig): StageFactory<CommitPushStageInput, CommitPushStageOutput>;
+//# sourceMappingURL=commit-push.stage.d.ts.map

package/dist/libs/task-flow/pipeline/stages/commit-push.stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-push.stage.d.ts","sourceRoot":"","sources":["../../../../../src/libs/task-flow/pipeline/stages/commit-push.stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAElF,OAAO,KAAK,EAAiB,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKrF,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,sDAAsD;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAID,qBAAa,eACX,YAAW,YAAY,CAAC,oBAAoB,EAAE,qBAAqB,CAAC;IAEpE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;gBAExB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa;IAMrD,UAAU,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAW5E,OAAO,CACX,KAAK,EAAE,oBAAoB,EAC3B,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,qBAAqB,CAAC;IAuDjC,yEAAyE;YAC3D,OAAO;CAOtB;AAID,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,aAAa,GACpB,YAAY,CAAC,oBAAoB,EAAE,qBAAqB,CAAC,CAE3D"}

package/dist/libs/task-flow/pipeline/stages/commit-push.stage.js

@@ -0,0 +1,120 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommitPushStage = void 0;
+exports.createCommitPushFactory = createCommitPushFactory;
+const git_commit_push_class_1 = require("../../git/git-commit-push.class");
+const git_worktree_stage_1 = require("./git-worktree.stage");
+// ── Stage implementation ────────────────────────────────────────────────────
+class CommitPushStage {
+    id;
+    name;
+    git;
+    constructor(id, name, config) {
+        this.id = id;
+        this.name = name;
+        this.git = new git_commit_push_class_1.GitCommitPush(config);
+    }
+    async shouldSkip(input, ctx) {
+        const cwd = input.cwd ?? ctx.store.get(git_worktree_stage_1.WORKTREE_CWD_KEY);
+        if (!cwd)
+            return false;
+        const hasChanges = await this.git.hasChanges(cwd);
+        if (!hasChanges) {
+            ctx.log("No changes to commit — skipping.");
+            return true;
+        }
+        return false;
+    }
+    async execute(input, ctx) {
+        const cwd = input.cwd ?? ctx.store.get(git_worktree_stage_1.WORKTREE_CWD_KEY);
+        if (!cwd) {
+            throw new Error("CommitPushStage: no cwd provided and no worktree:cwd in store. " +
+                "Place a git-worktree stage before this one, or pass cwd explicitly.");
+        }
+        // Stage all changes.
+        ctx.log("Staging all changes…");
+        await this.git.stageAll(cwd);
+        // Commit.
+        const commitOpts = {
+            subject: input.subject,
+            body: input.body,
+            type: input.type,
+            scope: input.scope,
+            taskId: input.taskId,
+        };
+        ctx.log(`Committing: ${this.git.formatCommitMessage(commitOpts)}`);
+        const sha = await this.git.commit(cwd, commitOpts);
+        let rebased = false;
+        let pushed = false;
+        // Optional rebase before push.
+        if (input.rebase) {
+            const target = input.rebaseBranch ?? "main";
+            ctx.log(`Rebasing onto ${target}…`);
+            await this.gitExec(cwd, ["rebase", target]);
+            rebased = true;
+        }
+        // Push.
+        ctx.log("Pushing…");
+        try {
+            await this.git.push(cwd, {
+                ...input.push,
+                setUpstream: input.push?.setUpstream ?? true,
+            });
+            pushed = true;
+        }
+        catch (err) {
+            // Push failure is non-fatal if there's no remote.
+            ctx.log(`Push skipped or failed: ${err}`);
+        }
+        ctx.store.set("commit:sha", sha);
+        ctx.store.set("commit:pushed", pushed);
+        return { commitSha: sha, pushed, rebased };
+    }
+    /** Low-level git exec (for rebase etc. not covered by GitCommitPush). */
+    async gitExec(cwd, args) {
+        const { execFile } = await Promise.resolve().then(() => __importStar(require("node:child_process")));
+        const { promisify } = await Promise.resolve().then(() => __importStar(require("node:util")));
+        const exec = promisify(execFile);
+        const { stdout } = await exec("git", args, { cwd, timeout: 120_000 });
+        return stdout;
+    }
+}
+exports.CommitPushStage = CommitPushStage;
+// ── Factory ─────────────────────────────────────────────────────────────────
+function createCommitPushFactory(config) {
+    return (desc) => new CommitPushStage(desc.id, desc.name, config);
+}
+//# sourceMappingURL=commit-push.stage.js.map

package/dist/libs/task-flow/pipeline/stages/commit-push.stage.js.map

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

package/dist/libs/task-flow/pipeline/stages/docker-env.stage.d.ts

@@ -0,0 +1,56 @@
+import type { StageHandler, StageContext, StageFactory } from "../pipeline.types";
+/** Connection map: service name → "host:port". */
+export declare const INFRA_CONNECTIONS_KEY = "infra:connections";
+/** Env vars derived from connections (INFRA_POSTGRES_5432, etc.). */
+export declare const INFRA_ENV_KEY = "infra:env";
+export interface DockerEnvConfig {
+    /** Path to docker-compose file (relative to project root, or absolute). */
+    composeFile: string;
+    /** Services to start (default: all). */
+    services?: string[];
+    /** Project name for docker compose (--project-name). */
+    projectName?: string;
+    /** Max time in ms to wait for healthy status (default: 60 000). */
+    healthTimeoutMs?: number;
+    /** Use podman compose instead of docker compose. */
+    usePodman?: boolean;
+    /** Additional environment variables for compose. */
+    env?: Record<string, string>;
+}
+export interface ServiceStatus {
+    name: string;
+    state: "running" | "stopped" | "unhealthy" | "not-found";
+    ports: string[];
+    health?: string;
+}
+export interface DockerEnvStageInput {
+    /** Override compose file at runtime. */
+    composeFile?: string;
+    /** Override services to start. */
+    services?: string[];
+}
+export interface DockerEnvStageOutput {
+    services: ServiceStatus[];
+    connectionMap: Record<string, string>;
+    env: Record<string, string>;
+}
+export declare class DockerEnvStage implements StageHandler<DockerEnvStageInput, DockerEnvStageOutput> {
+    private readonly config;
+    readonly id: string;
+    readonly name: string;
+    private started;
+    constructor(id: string, name: string, config: DockerEnvConfig);
+    validate(): Promise<void>;
+    execute(input: DockerEnvStageInput, ctx: StageContext): Promise<DockerEnvStageOutput>;
+    rollback(ctx: StageContext): Promise<void>;
+    private composeCmd;
+    private baseArgs;
+    private compose;
+    private inspectServices;
+    private mapState;
+    private parsePorts;
+    private buildConnectionMap;
+    private buildEnvVars;
+}
+export declare function createDockerEnvFactory(config: DockerEnvConfig): StageFactory<DockerEnvStageInput, DockerEnvStageOutput>;
+//# sourceMappingURL=docker-env.stage.d.ts.map

package/dist/libs/task-flow/pipeline/stages/docker-env.stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-env.stage.d.ts","sourceRoot":"","sources":["../../../../../src/libs/task-flow/pipeline/stages/docker-env.stage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMlF,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AACzD,qEAAqE;AACrE,eAAO,MAAM,aAAa,cAAc,CAAC;AAIzC,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;IACzD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAID,qBAAa,cACX,YAAW,YAAY,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;IAShE,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,OAAO,CAAS;gBAGtB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACK,MAAM,EAAE,eAAe;IAMpC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAWzB,OAAO,CACX,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,oBAAoB,CAAC;IA+B1B,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAahD,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,QAAQ;YAQF,OAAO;YAoBP,eAAe;IAiC7B,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,YAAY;CAUrB;AAID,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,GACtB,YAAY,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,CASzD"}

package/dist/libs/task-flow/pipeline/stages/docker-env.stage.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DockerEnvStage = exports.INFRA_ENV_KEY = exports.INFRA_CONNECTIONS_KEY = void 0;
+exports.createDockerEnvFactory = createDockerEnvFactory;
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const exec = (0, node_util_1.promisify)(node_child_process_1.execFile);
+// ── Store keys ──────────────────────────────────────────────────────────────
+/** Connection map: service name → "host:port". */
+exports.INFRA_CONNECTIONS_KEY = "infra:connections";
+/** Env vars derived from connections (INFRA_POSTGRES_5432, etc.). */
+exports.INFRA_ENV_KEY = "infra:env";
+// ── Stage implementation ────────────────────────────────────────────────────
+class DockerEnvStage {
+    config;
+    id;
+    name;
+    started = false;
+    constructor(id, name, config) {
+        this.config = config;
+        this.id = id;
+        this.name = name;
+    }
+    async validate() {
+        const cmd = this.composeCmd();
+        try {
+            await exec(cmd[0], [...cmd.slice(1), "version"], { timeout: 10_000 });
+        }
+        catch {
+            throw new Error(`${cmd.join(" ")} is not available. Install Docker/Podman Compose.`);
+        }
+    }
+    async execute(input, ctx) {
+        const composeFile = input.composeFile ?? this.config.composeFile;
+        const services = input.services ?? this.config.services ?? [];
+        const timeout = this.config.healthTimeoutMs ?? 60_000;
+        // ── Start services ──────────────────────────────────────────────────
+        ctx.log(`Starting compose services from ${composeFile}…`);
+        const upArgs = this.baseArgs(composeFile).concat("up", "-d", "--wait");
+        if (services.length)
+            upArgs.push(...services);
+        await this.compose(upArgs, ctx, timeout);
+        this.started = true;
+        // ── Inspect status ──────────────────────────────────────────────────
+        ctx.log("Inspecting service status…");
+        const statuses = await this.inspectServices(composeFile, services);
+        // ── Build connection map ────────────────────────────────────────────
+        const connectionMap = this.buildConnectionMap(statuses);
+        const env = this.buildEnvVars(connectionMap);
+        ctx.store.set(exports.INFRA_CONNECTIONS_KEY, connectionMap);
+        ctx.store.set(exports.INFRA_ENV_KEY, env);
+        ctx.log(`Services ready: ${statuses.filter((s) => s.state === "running").map((s) => s.name).join(", ")}`);
+        return { services: statuses, connectionMap, env };
+    }
+    async rollback(ctx) {
+        if (!this.started)
+            return;
+        ctx.log("Stopping compose services…");
+        try {
+            const downArgs = this.baseArgs(this.config.composeFile).concat("down");
+            await this.compose(downArgs, ctx, 30_000);
+        }
+        catch {
+            // Best-effort.
+        }
+    }
+    // ── Internals ───────────────────────────────────────────────────────────
+    composeCmd() {
+        return this.config.usePodman
+            ? ["podman", "compose"]
+            : ["docker", "compose"];
+    }
+    baseArgs(composeFile) {
+        const args = [...this.composeCmd(), "-f", composeFile];
+        if (this.config.projectName) {
+            args.push("--project-name", this.config.projectName);
+        }
+        return args;
+    }
+    async compose(args, ctx, timeout) {
+        const [cmd, ...rest] = args;
+        const env = { ...process.env, ...this.config.env };
+        try {
+            const { stdout, stderr } = await exec(cmd, rest, {
+                env,
+                timeout,
+                maxBuffer: 10 * 1024 * 1024,
+            });
+            if (stderr)
+                ctx.log(stderr.trim());
+            return stdout;
+        }
+        catch (err) {
+            throw new Error(`Compose command failed: ${err.stderr ?? err.message}`);
+        }
+    }
+    async inspectServices(composeFile, filterServices) {
+        const psArgs = this.baseArgs(composeFile).concat("ps", "--format", "json");
+        const [cmd, ...rest] = psArgs;
+        const { stdout } = await exec(cmd, rest, { timeout: 15_000 });
+        const results = [];
+        // docker compose ps --format json outputs one JSON object per line.
+        for (const line of stdout.trim().split("\n")) {
+            if (!line.trim())
+                continue;
+            try {
+                const obj = JSON.parse(line);
+                const name = obj.Service ?? obj.Name ?? "unknown";
+                if (filterServices.length && !filterServices.includes(name))
+                    continue;
+                results.push({
+                    name,
+                    state: this.mapState(obj.State),
+                    ports: this.parsePorts(obj.Ports ?? obj.Publishers ?? ""),
+                    health: obj.Health ?? obj.Status,
+                });
+            }
+            catch {
+                // Skip unparseable lines.
+            }
+        }
+        return results;
+    }
+    mapState(raw) {
+        const s = (raw ?? "").toLowerCase();
+        if (s.includes("running") || s.includes("up"))
+            return "running";
+        if (s.includes("unhealthy"))
+            return "unhealthy";
+        if (s.includes("exit") || s.includes("stop"))
+            return "stopped";
+        return "not-found";
+    }
+    parsePorts(raw) {
+        if (Array.isArray(raw)) {
+            return raw.map((p) => `${p.PublishedPort ?? p.published_port}:${p.TargetPort ?? p.target_port}`);
+        }
+        if (typeof raw === "string" && raw.length) {
+            return raw.split(",").map((p) => p.trim());
+        }
+        return [];
+    }
+    buildConnectionMap(services) {
+        const map = {};
+        for (const svc of services) {
+            if (svc.state !== "running")
+                continue;
+            for (const port of svc.ports) {
+                const [host, container] = port.split(":");
+                if (host && container) {
+                    // key: service_containerPort e.g. "postgres_5432"
+                    map[`${svc.name}_${container}`] = `localhost:${host}`;
+                }
+            }
+        }
+        return map;
+    }
+    buildEnvVars(connectionMap) {
+        const env = {};
+        for (const [key, value] of Object.entries(connectionMap)) {
+            // INFRA_POSTGRES_5432=localhost:5432
+            env[`INFRA_${key.toUpperCase()}`] = value;
+        }
+        return env;
+    }
+}
+exports.DockerEnvStage = DockerEnvStage;
+// ── Factory ─────────────────────────────────────────────────────────────────
+function createDockerEnvFactory(config) {
+    return (desc) => {
+        // Merge descriptor args into config.
+        const merged = {
+            ...config,
+            ...desc.args,
+        };
+        return new DockerEnvStage(desc.id, desc.name, merged);
+    };
+}
+//# sourceMappingURL=docker-env.stage.js.map

package/dist/libs/task-flow/pipeline/stages/docker-env.stage.js.map

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

package/dist/libs/task-flow/pipeline/stages/fn.stage.d.ts

@@ -0,0 +1,29 @@
+import type { StageHandler, StageContext } from "../pipeline.types";
+/**
+ * A lightweight stage wrapping a plain async function.
+ *
+ * Use for one-off stages that don't need a full class:
+ *
+ * ```ts
+ * const verify = new FnStage("verify", "Verify acceptance", async (input, ctx) => {
+ *   // run tests, compare with biz-plan, etc.
+ *   return { passed: true };
+ * });
+ * ```
+ */
+export declare class FnStage<TIn = unknown, TOut = unknown> implements StageHandler<TIn, TOut> {
+    private readonly fn;
+    private readonly opts?;
+    readonly id: string;
+    readonly name: string;
+    constructor(id: string, name: string, fn: (input: TIn, ctx: StageContext) => Promise<TOut>, opts?: {
+        shouldSkip?: (input: TIn, ctx: StageContext) => Promise<boolean> | boolean;
+        validate?: (input: TIn, ctx: StageContext) => Promise<void> | void;
+        rollback?: (ctx: StageContext) => Promise<void> | void;
+    } | undefined);
+    execute(input: TIn, ctx: StageContext): Promise<TOut>;
+    shouldSkip(input: TIn, ctx: StageContext): Promise<boolean> | boolean;
+    validate(input: TIn, ctx: StageContext): Promise<void> | void;
+    rollback(ctx: StageContext): Promise<void> | void;
+}
+//# sourceMappingURL=fn.stage.d.ts.map

package/dist/libs/task-flow/pipeline/stages/fn.stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fn.stage.d.ts","sourceRoot":"","sources":["../../../../../src/libs/task-flow/pipeline/stages/fn.stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEpE;;;;;;;;;;;GAWG;AACH,qBAAa,OAAO,CAAC,GAAG,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,CAChD,YAAW,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC;IAQhC,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IAPxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGpB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACK,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,EACpD,IAAI,CAAC,EAAE;QACtB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;QAC3E,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACnE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;KACxD,YAAA;IAMH,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO;IAIrE,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI7D,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAGlD"}

package/dist/libs/task-flow/pipeline/stages/fn.stage.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FnStage = void 0;
+/**
+ * A lightweight stage wrapping a plain async function.
+ *
+ * Use for one-off stages that don't need a full class:
+ *
+ * ```ts
+ * const verify = new FnStage("verify", "Verify acceptance", async (input, ctx) => {
+ *   // run tests, compare with biz-plan, etc.
+ *   return { passed: true };
+ * });
+ * ```
+ */
+class FnStage {
+    fn;
+    opts;
+    id;
+    name;
+    constructor(id, name, fn, opts) {
+        this.fn = fn;
+        this.opts = opts;
+        this.id = id;
+        this.name = name;
+    }
+    execute(input, ctx) {
+        return this.fn(input, ctx);
+    }
+    shouldSkip(input, ctx) {
+        return this.opts?.shouldSkip?.(input, ctx) ?? false;
+    }
+    validate(input, ctx) {
+        return this.opts?.validate?.(input, ctx);
+    }
+    rollback(ctx) {
+        return this.opts?.rollback?.(ctx);
+    }
+}
+exports.FnStage = FnStage;
+//# sourceMappingURL=fn.stage.js.map

package/dist/libs/task-flow/pipeline/stages/fn.stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fn.stage.js","sourceRoot":"","sources":["../../../../../src/libs/task-flow/pipeline/stages/fn.stage.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;GAWG;AACH,MAAa,OAAO;IASC;IACA;IAPV,EAAE,CAAS;IACX,IAAI,CAAS;IAEtB,YACE,EAAU,EACV,IAAY,EACK,EAAoD,EACpD,IAIhB;QALgB,OAAE,GAAF,EAAE,CAAkD;QACpD,SAAI,GAAJ,IAAI,CAIpB;QAED,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,OAAO,CAAC,KAAU,EAAE,GAAiB;QACnC,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,UAAU,CAAC,KAAU,EAAE,GAAiB;QACtC,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,KAAK,CAAC;IACtD,CAAC;IAED,QAAQ,CAAC,KAAU,EAAE,GAAiB;QACpC,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED,QAAQ,CAAC,GAAiB;QACxB,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;CACF;AAnCD,0BAmCC"}

package/dist/libs/task-flow/pipeline/stages/git-worktree.stage.d.ts

@@ -0,0 +1,34 @@
+import type { StageHandler, StageContext, StageFactory } from "../pipeline.types";
+import type { GitFlowConfig, WorktreeInfo } from "../../git/git.types";
+/** Store key where the created WorktreeInfo is placed. */
+export declare const WORKTREE_INFO_KEY = "worktree:info";
+/** Store key for the worktree working directory path. */
+export declare const WORKTREE_CWD_KEY = "worktree:cwd";
+export interface GitWorktreeStageInput {
+    /** Kanban task / ticket ID. */
+    taskId: string;
+    /** Short slug for branch naming (e.g. "add-login-page"). */
+    slug: string;
+    /** Branch to create worktree from (default: current branch). */
+    baseBranch?: string;
+}
+export type GitWorktreeStageOutput = WorktreeInfo;
+export declare class GitWorktreeStage implements StageHandler<GitWorktreeStageInput, GitWorktreeStageOutput> {
+    readonly id: string;
+    readonly name: string;
+    private readonly manager;
+    private worktreeInfo?;
+    constructor(id: string, name: string, config: GitFlowConfig);
+    validate(input: GitWorktreeStageInput): Promise<void>;
+    execute(input: GitWorktreeStageInput, ctx: StageContext): Promise<GitWorktreeStageOutput>;
+    rollback(ctx: StageContext): Promise<void>;
+}
+/**
+ * Create a factory for git-worktree stages.
+ *
+ * ```ts
+ * runner.registerFactory("git-worktree", createGitWorktreeFactory(gitConfig));
+ * ```
+ */
+export declare function createGitWorktreeFactory(config: GitFlowConfig): StageFactory<GitWorktreeStageInput, GitWorktreeStageOutput>;
+//# sourceMappingURL=git-worktree.stage.d.ts.map

package/dist/libs/task-flow/pipeline/stages/git-worktree.stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-worktree.stage.d.ts","sourceRoot":"","sources":["../../../../../src/libs/task-flow/pipeline/stages/git-worktree.stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAElF,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIvE,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AACjD,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAI/C,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,sBAAsB,GAAG,YAAY,CAAC;AAIlD,qBAAa,gBACX,YAAW,YAAY,CAAC,qBAAqB,EAAE,sBAAsB,CAAC;IAEtE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,YAAY,CAAC,CAAe;gBAExB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa;IAMrD,QAAQ,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD,OAAO,CACX,KAAK,EAAE,qBAAqB,EAC5B,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,sBAAsB,CAAC;IAkB5B,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAYjD;AAID;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,aAAa,GACpB,YAAY,CAAC,qBAAqB,EAAE,sBAAsB,CAAC,CAE7D"}

package/dist/libs/task-flow/pipeline/stages/git-worktree.stage.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitWorktreeStage = exports.WORKTREE_CWD_KEY = exports.WORKTREE_INFO_KEY = void 0;
+exports.createGitWorktreeFactory = createGitWorktreeFactory;
+const git_worktree_class_1 = require("../../git/git-worktree.class");
+// ── Store keys ──────────────────────────────────────────────────────────────
+/** Store key where the created WorktreeInfo is placed. */
+exports.WORKTREE_INFO_KEY = "worktree:info";
+/** Store key for the worktree working directory path. */
+exports.WORKTREE_CWD_KEY = "worktree:cwd";
+// ── Stage implementation ────────────────────────────────────────────────────
+class GitWorktreeStage {
+    id;
+    name;
+    manager;
+    worktreeInfo;
+    constructor(id, name, config) {
+        this.id = id;
+        this.name = name;
+        this.manager = new git_worktree_class_1.GitWorktreeManager(config);
+    }
+    async validate(input) {
+        const isRepo = await this.manager.isGitRepo();
+        if (!isRepo) {
+            throw new Error(`repoRoot is not a git repository`);
+        }
+    }
+    async execute(input, ctx) {
+        ctx.log(`Creating worktree for task ${input.taskId} (${input.slug})`);
+        const info = await this.manager.createForTask(input.taskId, input.slug, input.baseBranch);
+        this.worktreeInfo = info;
+        // Publish to store so downstream stages can find the working directory.
+        ctx.store.set(exports.WORKTREE_INFO_KEY, info);
+        ctx.store.set(exports.WORKTREE_CWD_KEY, info.path);
+        ctx.log(`Worktree ready at ${info.path} (branch: ${info.branch})`);
+        return info;
+    }
+    async rollback(ctx) {
+        if (!this.worktreeInfo)
+            return;
+        ctx.log(`Rolling back worktree ${this.worktreeInfo.path}`);
+        try {
+            await this.manager.remove(this.worktreeInfo.path, {
+                deleteBranch: true,
+                force: true,
+            });
+        }
+        catch {
+            // Best-effort cleanup.
+        }
+    }
+}
+exports.GitWorktreeStage = GitWorktreeStage;
+// ── Factory ─────────────────────────────────────────────────────────────────
+/**
+ * Create a factory for git-worktree stages.
+ *
+ * ```ts
+ * runner.registerFactory("git-worktree", createGitWorktreeFactory(gitConfig));
+ * ```
+ */
+function createGitWorktreeFactory(config) {
+    return (desc) => new GitWorktreeStage(desc.id, desc.name, config);
+}
+//# sourceMappingURL=git-worktree.stage.js.map

package/dist/libs/task-flow/pipeline/stages/git-worktree.stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-worktree.stage.js","sourceRoot":"","sources":["../../../../../src/libs/task-flow/pipeline/stages/git-worktree.stage.ts"],"names":[],"mappings":";;;AA2FA,4DAIC;AA9FD,qEAAkE;AAGlE,+EAA+E;AAE/E,0DAA0D;AAC7C,QAAA,iBAAiB,GAAG,eAAe,CAAC;AACjD,yDAAyD;AAC5C,QAAA,gBAAgB,GAAG,cAAc,CAAC;AAe/C,+EAA+E;AAE/E,MAAa,gBAAgB;IAGlB,EAAE,CAAS;IACX,IAAI,CAAS;IACL,OAAO,CAAqB;IACrC,YAAY,CAAgB;IAEpC,YAAY,EAAU,EAAE,IAAY,EAAE,MAAqB;QACzD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,IAAI,uCAAkB,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAA4B;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CACX,KAA4B,EAC5B,GAAiB;QAEjB,GAAG,CAAC,GAAG,CAAC,8BAA8B,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACtE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAC3C,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,UAAU,CACjB,CAAC;QAEF,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAEzB,wEAAwE;QACxE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAiB,EAAE,IAAI,CAAC,CAAC;QACvC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,wBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3C,GAAG,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,IAAI,aAAa,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAiB;QAC9B,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO;QAC/B,GAAG,CAAC,GAAG,CAAC,yBAAyB,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE;gBAChD,YAAY,EAAE,IAAI;gBAClB,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;CACF;AAtDD,4CAsDC;AAED,+EAA+E;AAE/E;;;;;;GAMG;AACH,SAAgB,wBAAwB,CACtC,MAAqB;IAErB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC"}

package/dist/libs/task-flow/pipeline/stages/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./git-worktree.stage";
+export * from "./commit-push.stage";
+export * from "./docker-env.stage";
+export * from "./fn.stage";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/libs/task-flow/pipeline/stages/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}