@alevental/cccp 0.1.0

package/dist/db.js

@@ -0,0 +1,358 @@
+import initSqlJs from "sql.js";
+import { readFileSync, writeFileSync, renameSync, existsSync, mkdirSync, } from "node:fs";
+import { resolve, join, dirname } from "node:path";
+import { randomUUID } from "node:crypto";
+// ---------------------------------------------------------------------------
+// sql.js initialization (async, once)
+// ---------------------------------------------------------------------------
+let SQL = null;
+async function getSql() {
+    if (!SQL) {
+        SQL = await initSqlJs();
+    }
+    return SQL;
+}
+// ---------------------------------------------------------------------------
+// Database path
+// ---------------------------------------------------------------------------
+export function dbPath(projectDir) {
+    return resolve(projectDir, ".cccp", "cccp.db");
+}
+// ---------------------------------------------------------------------------
+// CccpDatabase
+// ---------------------------------------------------------------------------
+export class CccpDatabase {
+    db;
+    filePath;
+    constructor(db, filePath) {
+        this.db = db;
+        this.filePath = filePath;
+    }
+    /**
+     * Open or create a database. If the file exists, load it. Otherwise create
+     * a new empty DB with the schema.
+     */
+    static async open(projectDir) {
+        const sql = await getSql();
+        const fp = dbPath(projectDir);
+        const dir = dirname(fp);
+        mkdirSync(dir, { recursive: true });
+        let db;
+        if (existsSync(fp)) {
+            const buffer = readFileSync(fp);
+            db = new sql.Database(buffer);
+        }
+        else {
+            db = new sql.Database();
+        }
+        const instance = new CccpDatabase(db, fp);
+        instance.migrate();
+        return instance;
+    }
+    /**
+     * Open a read-only copy of the database (for standalone dashboard / MCP server).
+     * Re-reads the file from disk each time — safe for cross-process access.
+     */
+    static async openReadOnly(projectDir) {
+        const sql = await getSql();
+        const fp = dbPath(projectDir);
+        if (!existsSync(fp)) {
+            // No DB yet — return an empty one (no writes will be flushed)
+            const db = new sql.Database();
+            const instance = new CccpDatabase(db, fp);
+            instance.migrate();
+            return instance;
+        }
+        const buffer = readFileSync(fp);
+        const db = new sql.Database(buffer);
+        return new CccpDatabase(db, fp);
+    }
+    // -------------------------------------------------------------------------
+    // Schema migration
+    // -------------------------------------------------------------------------
+    migrate() {
+        const version = this.pragma("user_version");
+        if (version < 1) {
+            this.db.run(`
+        CREATE TABLE IF NOT EXISTS runs (
+          run_id           TEXT PRIMARY KEY,
+          pipeline         TEXT NOT NULL,
+          project          TEXT NOT NULL,
+          pipeline_file    TEXT NOT NULL,
+          artifact_dir     TEXT NOT NULL,
+          project_dir      TEXT,
+          started_at       TEXT NOT NULL,
+          completed_at     TEXT,
+          status           TEXT NOT NULL DEFAULT 'running',
+          stages_json      TEXT NOT NULL,
+          stage_order_json TEXT NOT NULL,
+          gate_json        TEXT,
+          updated_at       TEXT NOT NULL
+        )
+      `);
+            this.db.run(`CREATE INDEX IF NOT EXISTS idx_runs_status ON runs(status)`);
+            this.db.run(`CREATE INDEX IF NOT EXISTS idx_runs_artifact_dir ON runs(artifact_dir)`);
+            this.db.run(`
+        CREATE TABLE IF NOT EXISTS events (
+          id          INTEGER PRIMARY KEY AUTOINCREMENT,
+          run_id      TEXT NOT NULL,
+          timestamp   TEXT NOT NULL,
+          event_type  TEXT NOT NULL,
+          stage_name  TEXT,
+          data_json   TEXT,
+          created_at  TEXT NOT NULL DEFAULT (datetime('now'))
+        )
+      `);
+            this.db.run(`CREATE INDEX IF NOT EXISTS idx_events_run ON events(run_id, id)`);
+            this.db.run(`
+        CREATE TABLE IF NOT EXISTS checkpoints (
+          run_id      TEXT NOT NULL,
+          stage_name  TEXT NOT NULL,
+          key         TEXT NOT NULL,
+          value       TEXT NOT NULL,
+          created_at  TEXT NOT NULL DEFAULT (datetime('now')),
+          PRIMARY KEY (run_id, stage_name, key)
+        )
+      `);
+            this.db.run(`PRAGMA user_version = 1`);
+        }
+    }
+    pragma(name) {
+        const result = this.db.exec(`PRAGMA ${name}`);
+        if (result.length > 0 && result[0].values.length > 0) {
+            return result[0].values[0][0];
+        }
+        return 0;
+    }
+    // -------------------------------------------------------------------------
+    // Runs — CRUD
+    // -------------------------------------------------------------------------
+    insertRun(state, artifactDir) {
+        this.db.run(`INSERT INTO runs (run_id, pipeline, project, pipeline_file, artifact_dir, project_dir, started_at, completed_at, status, stages_json, stage_order_json, gate_json, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            state.runId,
+            state.pipeline,
+            state.project,
+            state.pipelineFile,
+            artifactDir,
+            state.projectDir ?? null,
+            state.startedAt,
+            state.completedAt ?? null,
+            state.status,
+            JSON.stringify(state.stages),
+            JSON.stringify(state.stageOrder),
+            state.gate ? JSON.stringify(state.gate) : null,
+            new Date().toISOString(),
+        ]);
+    }
+    updateRun(state, artifactDir) {
+        this.db.run(`UPDATE runs SET
+        status = ?, completed_at = ?, stages_json = ?, stage_order_json = ?,
+        gate_json = ?, updated_at = ?
+       WHERE run_id = ?`, [
+            state.status,
+            state.completedAt ?? null,
+            JSON.stringify(state.stages),
+            JSON.stringify(state.stageOrder),
+            state.gate ? JSON.stringify(state.gate) : null,
+            new Date().toISOString(),
+            state.runId,
+        ]);
+    }
+    /**
+     * Insert or update — tries update first, inserts if no row exists.
+     */
+    upsertRun(state, artifactDir) {
+        const existing = this.getRun(state.runId);
+        if (existing) {
+            this.updateRun(state, artifactDir);
+        }
+        else {
+            this.insertRun(state, artifactDir);
+        }
+    }
+    getRun(runId) {
+        const results = this.db.exec(`SELECT * FROM runs WHERE run_id = ?`, [runId]);
+        if (results.length === 0 || results[0].values.length === 0)
+            return null;
+        return this.rowToState(results[0].columns, results[0].values[0]);
+    }
+    /**
+     * @deprecated Use getRun(runId) instead.
+     */
+    getRunByArtifactDir(artifactDir) {
+        const results = this.db.exec(`SELECT * FROM runs WHERE artifact_dir = ? ORDER BY started_at DESC LIMIT 1`, [artifactDir]);
+        if (results.length === 0 || results[0].values.length === 0)
+            return null;
+        return this.rowToState(results[0].columns, results[0].values[0]);
+    }
+    /**
+     * Find a run by ID prefix. Returns null if zero or multiple matches.
+     */
+    getRunByIdPrefix(prefix) {
+        const results = this.db.exec(`SELECT * FROM runs WHERE run_id LIKE ? || '%'`, [prefix]);
+        if (results.length === 0 || results[0].values.length !== 1)
+            return null;
+        return this.rowToState(results[0].columns, results[0].values[0]);
+    }
+    listRuns() {
+        return this.findRuns();
+    }
+    /**
+     * Find runs matching optional filters. All filters are AND-combined.
+     * Results sorted running-first, then by start time descending.
+     */
+    findRuns(filter) {
+        const conditions = [];
+        const params = [];
+        if (filter?.project) {
+            conditions.push("project = ?");
+            params.push(filter.project);
+        }
+        if (filter?.pipeline) {
+            conditions.push("pipeline = ?");
+            params.push(filter.pipeline);
+        }
+        if (filter?.status) {
+            conditions.push("status = ?");
+            params.push(filter.status);
+        }
+        if (filter?.artifactDir) {
+            conditions.push("artifact_dir = ?");
+            params.push(filter.artifactDir);
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+        const results = this.db.exec(`SELECT * FROM runs ${where} ORDER BY
+        CASE WHEN status = 'running' THEN 0 ELSE 1 END,
+        started_at DESC`, params);
+        if (results.length === 0)
+            return [];
+        return results[0].values.map((row) => {
+            const state = this.rowToState(results[0].columns, row);
+            return { artifactDir: state.artifactDir, state };
+        });
+    }
+    rowToState(columns, row) {
+        const col = (name) => row[columns.indexOf(name)];
+        return {
+            runId: col("run_id"),
+            pipeline: col("pipeline"),
+            project: col("project"),
+            pipelineFile: col("pipeline_file"),
+            startedAt: col("started_at"),
+            completedAt: col("completed_at") || undefined,
+            status: col("status"),
+            stages: JSON.parse(col("stages_json")),
+            stageOrder: JSON.parse(col("stage_order_json")),
+            gate: col("gate_json")
+                ? JSON.parse(col("gate_json"))
+                : undefined,
+            artifactDir: col("artifact_dir"),
+            projectDir: col("project_dir") || undefined,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Events — append-only audit log
+    // -------------------------------------------------------------------------
+    appendEvent(runId, eventType, stageName, data) {
+        this.db.run(`INSERT INTO events (run_id, timestamp, event_type, stage_name, data_json)
+       VALUES (?, ?, ?, ?, ?)`, [
+            runId,
+            new Date().toISOString(),
+            eventType,
+            stageName ?? null,
+            data ? JSON.stringify(data) : null,
+        ]);
+    }
+    getEvents(runId, sinceId) {
+        const sql = sinceId != null
+            ? `SELECT * FROM events WHERE run_id = ? AND id > ? ORDER BY id`
+            : `SELECT * FROM events WHERE run_id = ? ORDER BY id`;
+        const params = sinceId != null ? [runId, sinceId] : [runId];
+        const results = this.db.exec(sql, params);
+        if (results.length === 0)
+            return [];
+        const cols = results[0].columns;
+        return results[0].values.map((row) => ({
+            id: row[cols.indexOf("id")],
+            runId: row[cols.indexOf("run_id")],
+            timestamp: row[cols.indexOf("timestamp")],
+            eventType: row[cols.indexOf("event_type")],
+            stageName: row[cols.indexOf("stage_name")] || undefined,
+            data: row[cols.indexOf("data_json")]
+                ? JSON.parse(row[cols.indexOf("data_json")])
+                : undefined,
+        }));
+    }
+    // -------------------------------------------------------------------------
+    // Checkpoints — cached stage outputs
+    // -------------------------------------------------------------------------
+    setCheckpoint(runId, stageName, key, value) {
+        this.db.run(`INSERT OR REPLACE INTO checkpoints (run_id, stage_name, key, value, created_at)
+       VALUES (?, ?, ?, ?, datetime('now'))`, [runId, stageName, key, value]);
+    }
+    getCheckpoint(runId, stageName, key) {
+        const results = this.db.exec(`SELECT value FROM checkpoints WHERE run_id = ? AND stage_name = ? AND key = ?`, [runId, stageName, key]);
+        if (results.length === 0 || results[0].values.length === 0)
+            return null;
+        return results[0].values[0][0];
+    }
+    // -------------------------------------------------------------------------
+    // Persistence — flush to disk
+    // -------------------------------------------------------------------------
+    /**
+     * Atomically write the database to disk (write to .tmp then rename).
+     */
+    flush() {
+        const data = this.db.export();
+        const buffer = Buffer.from(data);
+        const dir = dirname(this.filePath);
+        mkdirSync(dir, { recursive: true });
+        const tmp = join(dir, `.cccp-db-${randomUUID()}.tmp`);
+        writeFileSync(tmp, buffer);
+        renameSync(tmp, this.filePath);
+    }
+    /**
+     * Reload the database from disk (for read-only consumers in separate processes).
+     */
+    reload() {
+        if (!existsSync(this.filePath))
+            return;
+        const buffer = readFileSync(this.filePath);
+        const sql = SQL;
+        this.db.close();
+        this.db = new sql.Database(buffer);
+    }
+    close() {
+        this.db.close();
+    }
+}
+// ---------------------------------------------------------------------------
+// Singleton cache
+// ---------------------------------------------------------------------------
+const instances = new Map();
+/**
+ * Get or create a CccpDatabase for the given project directory.
+ * Caches the instance for reuse within the same process.
+ */
+export async function openDatabase(projectDir) {
+    const key = resolve(projectDir);
+    let db = instances.get(key);
+    if (!db) {
+        db = await CccpDatabase.open(projectDir);
+        instances.set(key, db);
+    }
+    return db;
+}
+/**
+ * Close and remove a cached database instance.
+ */
+export function closeDatabase(projectDir) {
+    const key = resolve(projectDir);
+    const db = instances.get(key);
+    if (db) {
+        db.close();
+        instances.delete(key);
+    }
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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

package/dist/dispatcher.d.ts

@@ -0,0 +1,9 @@
+import { type DispatchOptions } from "./agent.js";
+import type { AgentResult } from "./types.js";
+export type { DispatchOptions } from "./agent.js";
+export interface AgentDispatcher {
+    dispatch(opts: DispatchOptions): Promise<AgentResult>;
+}
+export declare class DefaultAgentDispatcher implements AgentDispatcher {
+    dispatch(opts: DispatchOptions): Promise<AgentResult>;
+}

package/dist/dispatcher.js

@@ -0,0 +1,7 @@
+import { dispatchAgent } from "./agent.js";
+export class DefaultAgentDispatcher {
+    async dispatch(opts) {
+        return dispatchAgent(opts);
+    }
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAwB,MAAM,YAAY,CAAC;AASjE,MAAM,OAAO,sBAAsB;IACjC,KAAK,CAAC,QAAQ,CAAC,IAAqB;QAClC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,16 @@
+/** Agent process crashed (non-zero exit code, distinct from evaluation FAIL). */
+export declare class AgentCrashError extends Error {
+    readonly agent: string;
+    readonly exitCode: number;
+    constructor(agent: string, exitCode: number);
+}
+/** Agent was expected to produce an output file but didn't. */
+export declare class MissingOutputError extends Error {
+    readonly agent: string;
+    readonly expectedPath: string;
+    constructor(agent: string, expectedPath: string);
+}
+/** Pipeline YAML or config validation error. */
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}

package/dist/errors.js

@@ -0,0 +1,30 @@
+/** Agent process crashed (non-zero exit code, distinct from evaluation FAIL). */
+export class AgentCrashError extends Error {
+    agent;
+    exitCode;
+    constructor(agent, exitCode) {
+        super(`Agent "${agent}" crashed with exit code ${exitCode}`);
+        this.agent = agent;
+        this.exitCode = exitCode;
+        this.name = "AgentCrashError";
+    }
+}
+/** Agent was expected to produce an output file but didn't. */
+export class MissingOutputError extends Error {
+    agent;
+    expectedPath;
+    constructor(agent, expectedPath) {
+        super(`Agent "${agent}" did not produce expected output: ${expectedPath}`);
+        this.agent = agent;
+        this.expectedPath = expectedPath;
+        this.name = "MissingOutputError";
+    }
+}
+/** Pipeline YAML or config validation error. */
+export class ValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ValidationError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAEtB;IACA;IAFlB,YACkB,KAAa,EACb,QAAgB;QAEhC,KAAK,CAAC,UAAU,KAAK,4BAA4B,QAAQ,EAAE,CAAC,CAAC;QAH7C,UAAK,GAAL,KAAK,CAAQ;QACb,aAAQ,GAAR,QAAQ,CAAQ;QAGhC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,+DAA+D;AAC/D,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAEzB;IACA;IAFlB,YACkB,KAAa,EACb,YAAoB;QAEpC,KAAK,CACH,UAAU,KAAK,sCAAsC,YAAY,EAAE,CACpE,CAAC;QALc,UAAK,GAAL,KAAK,CAAQ;QACb,iBAAY,GAAZ,YAAY,CAAQ;QAKpC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,gDAAgD;AAChD,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/evaluator.d.ts

@@ -0,0 +1,23 @@
+export type EvaluationOutcome = "pass" | "fail" | "parse_error";
+export interface EvaluationResult {
+    outcome: EvaluationOutcome;
+    /** Raw text of the Overall line, if found. */
+    rawLine?: string;
+    /** Full evaluation file content (for logging/debugging). */
+    content?: string;
+    /** Error message when outcome is parse_error. */
+    error?: string;
+}
+/**
+ * Parse an evaluation file and extract the Overall PASS/FAIL verdict.
+ *
+ * Returns:
+ * - `pass` if `### Overall: PASS` is found
+ * - `fail` if `### Overall: FAIL` is found
+ * - `parse_error` if the file can't be read or the Overall line is missing/malformed
+ */
+export declare function parseEvaluation(evaluationPath: string): Promise<EvaluationResult>;
+/**
+ * Parse evaluation content directly (useful for testing without filesystem).
+ */
+export declare function parseEvaluationContent(content: string): EvaluationResult;

package/dist/evaluator.js

@@ -0,0 +1,49 @@
+import { readFile } from "node:fs/promises";
+// ---------------------------------------------------------------------------
+// Regex — matches the exact format from the evaluation template
+// ---------------------------------------------------------------------------
+const OVERALL_RE = /^###\s+Overall:\s*(PASS|FAIL)\s*$/m;
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse an evaluation file and extract the Overall PASS/FAIL verdict.
+ *
+ * Returns:
+ * - `pass` if `### Overall: PASS` is found
+ * - `fail` if `### Overall: FAIL` is found
+ * - `parse_error` if the file can't be read or the Overall line is missing/malformed
+ */
+export async function parseEvaluation(evaluationPath) {
+    let content;
+    try {
+        content = await readFile(evaluationPath, "utf-8");
+    }
+    catch (err) {
+        return {
+            outcome: "parse_error",
+            error: `Cannot read evaluation file: ${evaluationPath}`,
+        };
+    }
+    return parseEvaluationContent(content);
+}
+/**
+ * Parse evaluation content directly (useful for testing without filesystem).
+ */
+export function parseEvaluationContent(content) {
+    const match = OVERALL_RE.exec(content);
+    if (!match) {
+        return {
+            outcome: "parse_error",
+            content,
+            error: 'Evaluation file does not contain a valid "### Overall: PASS" or "### Overall: FAIL" line',
+        };
+    }
+    const verdict = match[1].toLowerCase();
+    return {
+        outcome: verdict,
+        rawLine: match[0].trimEnd(),
+        content,
+    };
+}
+//# sourceMappingURL=evaluator.js.map

package/dist/evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../src/evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAkB5C,8EAA8E;AAC9E,gEAAgE;AAChE,8EAA8E;AAE9E,MAAM,UAAU,GAAG,oCAAoC,CAAC;AAExD,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,cAAsB;IAEtB,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,gCAAgC,cAAc,EAAE;SACxD,CAAC;IACJ,CAAC;IAED,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,OAAO,EAAE,aAAa;YACtB,OAAO;YACP,KAAK,EACH,0FAA0F;SAC7F,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAqB,CAAC;IAE1D,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE;QAC3B,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/gate/auto-approve.d.ts

@@ -0,0 +1,9 @@
+import type { GateInfo } from "../types.js";
+import type { GateResponse, GateStrategy } from "./gate-strategy.js";
+/**
+ * Gate strategy that automatically approves all gates.
+ * Used in headless/CI mode where no human is available.
+ */
+export declare class AutoApproveStrategy implements GateStrategy {
+    waitForGate(gate: GateInfo): Promise<GateResponse>;
+}

package/dist/gate/auto-approve.js

@@ -0,0 +1,11 @@
+/**
+ * Gate strategy that automatically approves all gates.
+ * Used in headless/CI mode where no human is available.
+ */
+export class AutoApproveStrategy {
+    async waitForGate(gate) {
+        console.log(`    ⏭ Auto-approving gate: ${gate.stageName}`);
+        return { approved: true };
+    }
+}
+//# sourceMappingURL=auto-approve.js.map

package/dist/gate/auto-approve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-approve.js","sourceRoot":"","sources":["../../src/gate/auto-approve.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAC9B,KAAK,CAAC,WAAW,CAAC,IAAc;QAC9B,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC5D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/gate/gate-strategy.d.ts

@@ -0,0 +1,22 @@
+import type { GateInfo } from "../types.js";
+export interface GateResponse {
+    approved: boolean;
+    feedback?: string;
+}
+/**
+ * A gate strategy determines how human gates are presented and how responses
+ * are collected. Implementations:
+ * - `McpGateStrategy`: Writes gate_pending to state.json, waits for external
+ *   response (via MCP server or direct state file edit).
+ * - `AutoApproveStrategy`: Immediately approves all gates (headless mode).
+ */
+export interface GateStrategy {
+    /**
+     * Wait for a human gate response.
+     * The strategy is responsible for:
+     * 1. Signaling that a gate is pending (e.g., writing to state.json)
+     * 2. Waiting for a response
+     * 3. Returning the response
+     */
+    waitForGate(gate: GateInfo): Promise<GateResponse>;
+}

package/dist/gate/gate-strategy.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gate-strategy.js.map

package/dist/gate/gate-strategy.js.map

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

package/dist/gate/gate-watcher.d.ts

@@ -0,0 +1,15 @@
+import type { GateInfo } from "../types.js";
+import type { GateResponse, GateStrategy } from "./gate-strategy.js";
+/**
+ * Gate strategy that writes `gate_pending` to state.json and polls for
+ * a response. The response comes from either:
+ * - The MCP server (pipeline_gate_respond tool)
+ * - Direct edit of state.json
+ */
+export declare class FilesystemGateStrategy implements GateStrategy {
+    private runId;
+    private projectDir?;
+    private quiet?;
+    constructor(runId: string, projectDir?: string | undefined, quiet?: boolean | undefined);
+    waitForGate(gate: GateInfo): Promise<GateResponse>;
+}