@alevental/cccp 0.1.0

package/dist/gate/gate-watcher.js

@@ -0,0 +1,64 @@
+import { loadState } from "../state.js";
+import { notifyGateRequired } from "../tui/cmux.js";
+// ---------------------------------------------------------------------------
+// Filesystem-polling gate strategy
+// ---------------------------------------------------------------------------
+const POLL_INTERVAL_MS = 2000;
+/**
+ * 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 class FilesystemGateStrategy {
+    runId;
+    projectDir;
+    quiet;
+    constructor(runId, projectDir, quiet) {
+        this.runId = runId;
+        this.projectDir = projectDir;
+        this.quiet = quiet;
+    }
+    async waitForGate(gate) {
+        await notifyGateRequired(gate.stageName);
+        if (!this.quiet) {
+            console.log(`    ⏸ Waiting for gate approval: ${gate.stageName}`);
+            if (gate.prompt)
+                console.log(`      ${gate.prompt}`);
+        }
+        return new Promise((resolve) => {
+            const interval = setInterval(async () => {
+                try {
+                    const state = await loadState(this.runId, this.projectDir, true);
+                    if (!state?.gate)
+                        return;
+                    if (state.gate.stageName !== gate.stageName)
+                        return;
+                    if (state.gate.status === "approved") {
+                        clearInterval(interval);
+                        if (!this.quiet)
+                            console.log(`    ✓ Gate approved`);
+                        resolve({
+                            approved: true,
+                            feedback: state.gate.feedback,
+                        });
+                    }
+                    else if (state.gate.status === "rejected") {
+                        clearInterval(interval);
+                        if (!this.quiet) {
+                            console.log(`    ✗ Gate rejected${state.gate.feedback ? `: ${state.gate.feedback}` : ""}`);
+                        }
+                        resolve({
+                            approved: false,
+                            feedback: state.gate.feedback,
+                        });
+                    }
+                }
+                catch {
+                    // State file may be mid-write — ignore and retry.
+                }
+            }, POLL_INTERVAL_MS);
+        });
+    }
+}
+//# sourceMappingURL=gate-watcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gate-watcher.js","sourceRoot":"","sources":["../../src/gate/gate-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,8EAA8E;AAC9E,mCAAmC;AACnC,8EAA8E;AAE9E,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IAEvB;IACA;IACA;IAHV,YACU,KAAa,EACb,UAAmB,EACnB,KAAe;QAFf,UAAK,GAAL,KAAK,CAAQ;QACb,eAAU,GAAV,UAAU,CAAS;QACnB,UAAK,GAAL,KAAK,CAAU;IACtB,CAAC;IAEJ,KAAK,CAAC,WAAW,CAAC,IAAc;QAC9B,MAAM,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEzC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,oCAAoC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YAClE,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,EAAE;YAC3C,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;gBACtC,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;oBACjE,IAAI,CAAC,KAAK,EAAE,IAAI;wBAAE,OAAO;oBAEzB,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS;wBAAE,OAAO;oBAEpD,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;wBACrC,aAAa,CAAC,QAAQ,CAAC,CAAC;wBACxB,IAAI,CAAC,IAAI,CAAC,KAAK;4BAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;wBACpD,OAAO,CAAC;4BACN,QAAQ,EAAE,IAAI;4BACd,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;yBAC9B,CAAC,CAAC;oBACL,CAAC;yBAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;wBAC5C,aAAa,CAAC,QAAQ,CAAC,CAAC;wBACxB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;4BAChB,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBAC7F,CAAC;wBACD,OAAO,CAAC;4BACN,QAAQ,EAAE,KAAK;4BACf,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;yBAC9B,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,kDAAkD;gBACpD,CAAC;YACH,CAAC,EAAE,gBAAgB,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/logger.d.ts

@@ -0,0 +1,24 @@
+/** Minimal logger interface used throughout the pipeline runner. */
+export interface Logger {
+    log(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+}
+/** Default logger that forwards everything to the console. */
+export declare class ConsoleLogger implements Logger {
+    log(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+}
+/** Logger that suppresses log/warn but still emits errors (for TUI mode). */
+export declare class QuietLogger implements Logger {
+    log(): void;
+    error(...args: unknown[]): void;
+    warn(): void;
+}
+/** Completely silent logger — useful for tests. */
+export declare class SilentLogger implements Logger {
+    log(): void;
+    error(): void;
+    warn(): void;
+}

package/dist/logger.js

@@ -0,0 +1,22 @@
+// ---------------------------------------------------------------------------
+// Logger abstraction — decouples pipeline output from console
+// ---------------------------------------------------------------------------
+/** Default logger that forwards everything to the console. */
+export class ConsoleLogger {
+    log(...args) { console.log(...args); }
+    error(...args) { console.error(...args); }
+    warn(...args) { console.warn(...args); }
+}
+/** Logger that suppresses log/warn but still emits errors (for TUI mode). */
+export class QuietLogger {
+    log() { }
+    error(...args) { console.error(...args); }
+    warn() { }
+}
+/** Completely silent logger — useful for tests. */
+export class SilentLogger {
+    log() { }
+    error() { }
+    warn() { }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8DAA8D;AAC9D,8EAA8E;AAS9E,8DAA8D;AAC9D,MAAM,OAAO,aAAa;IACxB,GAAG,CAAC,GAAG,IAAe,IAAU,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACvD,KAAK,CAAC,GAAG,IAAe,IAAU,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,CAAC,GAAG,IAAe,IAAU,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;CAC1D;AAED,6EAA6E;AAC7E,MAAM,OAAO,WAAW;IACtB,GAAG,KAAU,CAAC;IACd,KAAK,CAAC,GAAG,IAAe,IAAU,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,KAAU,CAAC;CAChB;AAED,mDAAmD;AACnD,MAAM,OAAO,YAAY;IACvB,GAAG,KAAU,CAAC;IACd,KAAK,KAAU,CAAC;IAChB,IAAI,KAAU,CAAC;CAChB"}

package/dist/mcp/gate-notifier.d.ts

@@ -0,0 +1,26 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface GateNotifierOptions {
+    server: McpServer;
+    projectDir: string;
+    pollIntervalMs?: number;
+}
+/**
+ * Watches for pending human gates across all pipeline runs and sends
+ * MCP elicitation requests to the connected Claude Code session.
+ *
+ * Lifecycle: call `start()` after the MCP server connects, `stop()` on shutdown.
+ */
+export declare class GateNotifier {
+    private opts;
+    private seenGates;
+    private elicitationSupported;
+    private intervalId;
+    private pendingElicitation;
+    constructor(opts: GateNotifierOptions);
+    start(): void;
+    stop(): void;
+    private poll;
+    private elicitGateApproval;
+    private writeGateResponse;
+    private gateKey;
+}

package/dist/mcp/gate-notifier.js

@@ -0,0 +1,161 @@
+import { openDatabase } from "../db.js";
+import { discoverRuns, loadState, saveState } from "../state.js";
+// ---------------------------------------------------------------------------
+// Gate notifier — polls for pending gates and elicits approval via MCP
+// ---------------------------------------------------------------------------
+const DEFAULT_POLL_MS = 2000;
+/**
+ * Watches for pending human gates across all pipeline runs and sends
+ * MCP elicitation requests to the connected Claude Code session.
+ *
+ * Lifecycle: call `start()` after the MCP server connects, `stop()` on shutdown.
+ */
+export class GateNotifier {
+    opts;
+    seenGates = new Set();
+    elicitationSupported = true;
+    intervalId = null;
+    pendingElicitation = null;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    start() {
+        if (this.intervalId)
+            return;
+        const ms = this.opts.pollIntervalMs ?? DEFAULT_POLL_MS;
+        this.intervalId = setInterval(() => void this.poll(), ms);
+    }
+    stop() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Poll loop
+    // -------------------------------------------------------------------------
+    async poll() {
+        if (!this.elicitationSupported)
+            return;
+        if (this.pendingElicitation)
+            return; // one at a time
+        try {
+            const db = await openDatabase(this.opts.projectDir);
+            db.reload();
+            const runs = await discoverRuns(this.opts.projectDir);
+            // Clean up seen gates for runs that no longer have a pending gate.
+            for (const key of this.seenGates) {
+                const [runId] = key.split(":");
+                const run = runs.find((r) => r.state.runId === runId);
+                if (!run || run.state.gate?.status !== "pending") {
+                    this.seenGates.delete(key);
+                }
+            }
+            // Find new pending gates.
+            for (const run of runs) {
+                const gate = run.state.gate;
+                if (!gate || gate.status !== "pending")
+                    continue;
+                const key = this.gateKey(run.state.runId, gate.stageName);
+                if (this.seenGates.has(key))
+                    continue;
+                // Mark as seen immediately to avoid duplicate elicitations.
+                this.seenGates.add(key);
+                this.pendingElicitation = this.elicitGateApproval(run);
+                // Only process one gate per poll cycle.
+                return;
+            }
+        }
+        catch {
+            // DB may be mid-write or unavailable — ignore and retry next cycle.
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Elicitation
+    // -------------------------------------------------------------------------
+    async elicitGateApproval(run) {
+        const gate = run.state.gate;
+        const runShort = run.state.runId.slice(0, 8);
+        try {
+            // Elicit approval from the user — this blocks until they respond.
+            let result;
+            try {
+                result = await this.opts.server.server.elicitInput({
+                    message: [
+                        `Pipeline gate requires approval (run ${runShort}).`,
+                        "",
+                        `Stage: ${gate.stageName}`,
+                        gate.prompt ? `\n${gate.prompt}` : "",
+                    ]
+                        .filter(Boolean)
+                        .join("\n"),
+                    requestedSchema: {
+                        type: "object",
+                        properties: {
+                            decision: {
+                                type: "string",
+                                title: "Decision",
+                                description: "Approve or reject this gate",
+                                enum: ["approve", "reject"],
+                                default: "approve",
+                            },
+                            feedback: {
+                                type: "string",
+                                title: "Feedback",
+                                description: "Optional feedback (passed to generator on rejection)",
+                            },
+                        },
+                        required: ["decision"],
+                    },
+                });
+            }
+            catch {
+                // Elicitation not supported by this client — disable for the session.
+                this.elicitationSupported = false;
+                return;
+            }
+            // Handle the elicitation result.
+            if (result.action === "cancel") {
+                // User dismissed — remove from seen so it can be re-prompted.
+                this.seenGates.delete(this.gateKey(run.state.runId, gate.stageName));
+                return;
+            }
+            if (result.action === "decline") {
+                // User explicitly declined — write rejection.
+                await this.writeGateResponse(run, false);
+                return;
+            }
+            // action === "accept" — check the form content.
+            const decision = result.content?.decision;
+            const feedback = result.content?.feedback;
+            const approved = decision !== "reject";
+            await this.writeGateResponse(run, approved, feedback);
+        }
+        catch {
+            // DB write error — transient, don't disable elicitation.
+            // Remove from seen so it can be retried on the next poll cycle.
+            this.seenGates.delete(this.gateKey(run.state.runId, gate.stageName));
+        }
+        finally {
+            this.pendingElicitation = null;
+        }
+    }
+    async writeGateResponse(run, approved, feedback) {
+        // Reload state to ensure we have the latest (gate may have been resolved externally).
+        const freshState = await loadState(run.state.runId, this.opts.projectDir, true);
+        if (!freshState?.gate || freshState.gate.status !== "pending") {
+            return; // Gate already resolved — discard.
+        }
+        freshState.gate.status = approved ? "approved" : "rejected";
+        freshState.gate.feedback = feedback;
+        freshState.gate.respondedAt = new Date().toISOString();
+        await saveState(freshState);
+    }
+    // -------------------------------------------------------------------------
+    // Helpers
+    // -------------------------------------------------------------------------
+    gateKey(runId, stageName) {
+        return `${runId}:${stageName}`;
+    }
+}
+//# sourceMappingURL=gate-notifier.js.map

package/dist/mcp/gate-notifier.js.map

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

package/dist/mcp/mcp-config.d.ts

@@ -0,0 +1,25 @@
+import type { McpProfile, McpServer, ProjectConfig } from "../config.js";
+import type { TempFileTracker } from "../temp-tracker.js";
+export interface McpConfigJson {
+    mcpServers: Record<string, {
+        command: string;
+        args?: string[];
+        env?: Record<string, string>;
+    }>;
+}
+/**
+ * Resolve a named MCP profile from the project config, following `extends` chains.
+ * Returns the merged set of MCP servers.
+ */
+export declare function resolveProfile(profileName: string, profiles: Record<string, McpProfile>, visited?: Set<string>): Record<string, McpServer>;
+/**
+ * Build the MCP config JSON object for a given profile.
+ */
+export declare function buildMcpConfig(profileName: string, config: ProjectConfig): McpConfigJson;
+/**
+ * Write an MCP config JSON file to a temp location and return the path.
+ * Returns `undefined` if no profile is specified and no default exists.
+ * If a {@link TempFileTracker} is provided the path is registered for
+ * automatic cleanup.
+ */
+export declare function writeMcpConfigFile(profileName: string | undefined, config: ProjectConfig, tracker?: TempFileTracker): Promise<string | undefined>;

package/dist/mcp/mcp-config.js

@@ -0,0 +1,80 @@
+import { writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+// ---------------------------------------------------------------------------
+// Profile resolution with inheritance
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a named MCP profile from the project config, following `extends` chains.
+ * Returns the merged set of MCP servers.
+ */
+export function resolveProfile(profileName, profiles, visited = new Set()) {
+    if (visited.has(profileName)) {
+        throw new Error(`Circular MCP profile inheritance: ${[...visited, profileName].join(" → ")}`);
+    }
+    visited.add(profileName);
+    const profile = profiles[profileName];
+    if (!profile) {
+        throw new Error(`MCP profile "${profileName}" not found. Available: ${Object.keys(profiles).join(", ")}`);
+    }
+    // Start with parent servers if extending.
+    let servers = {};
+    if (profile.extends) {
+        servers = resolveProfile(profile.extends, profiles, visited);
+    }
+    // Merge this profile's servers (child overrides parent on name collision).
+    if (profile.servers) {
+        servers = { ...servers, ...profile.servers };
+    }
+    return servers;
+}
+// ---------------------------------------------------------------------------
+// Config file generation
+// ---------------------------------------------------------------------------
+/**
+ * Build the MCP config JSON object for a given profile.
+ */
+export function buildMcpConfig(profileName, config) {
+    const profiles = config.mcp_profiles ?? {};
+    const servers = resolveProfile(profileName, profiles);
+    const mcpServers = {};
+    for (const [name, server] of Object.entries(servers)) {
+        mcpServers[name] = {
+            command: server.command,
+            ...(server.args?.length ? { args: server.args } : {}),
+            ...(server.env && Object.keys(server.env).length > 0
+                ? { env: server.env }
+                : {}),
+        };
+    }
+    return { mcpServers };
+}
+/**
+ * Write an MCP config JSON file to a temp location and return the path.
+ * Returns `undefined` if no profile is specified and no default exists.
+ * If a {@link TempFileTracker} is provided the path is registered for
+ * automatic cleanup.
+ */
+export async function writeMcpConfigFile(profileName, config, tracker) {
+    const name = profileName ?? config.default_mcp_profile;
+    if (!name)
+        return undefined;
+    if (!config.mcp_profiles || !config.mcp_profiles[name]) {
+        // Profile referenced but not defined — only warn if explicitly requested.
+        if (profileName) {
+            throw new Error(`MCP profile "${profileName}" not found in project config`);
+        }
+        return undefined;
+    }
+    const mcpConfig = buildMcpConfig(name, config);
+    // Don't write a file if there are no servers.
+    if (Object.keys(mcpConfig.mcpServers).length === 0) {
+        return undefined;
+    }
+    const filePath = join(tmpdir(), `cccp-mcp-${randomUUID()}.json`);
+    await writeFile(filePath, JSON.stringify(mcpConfig, null, 2), "utf-8");
+    tracker?.track(filePath);
+    return filePath;
+}
+//# sourceMappingURL=mcp-config.js.map

package/dist/mcp/mcp-config.js.map

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

package/dist/mcp/mcp-server.d.ts

@@ -0,0 +1 @@
+export declare function startMcpServer(): Promise<void>;