va-agent-protocol 0.1.0

package/dist/adapter/codex-adapter.js

@@ -0,0 +1,409 @@
+/**
+ * CodexAdapter — wraps OpenAI Codex CLI as a protocol-compliant agent.
+ *
+ * This is a REAL adapter (not simulated). It spawns actual `codex` processes
+ * and collects real evidence from their execution.
+ *
+ * Key design:
+ * - `dispatch()` → spawns `codex exec --full-auto` as a child process
+ * - `poll()` → checks process exit status, reads stdout/stderr as progress
+ * - `cancel()` → sends SIGTERM to the process
+ * - Quality gates run after codex completes (typecheck, codex review)
+ */
+import { spawn } from "node:child_process";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import path from "node:path";
+import { generateCorrelationId } from "../types/index.js";
+import { consoleLogger } from "../utils/logger.js";
+import { BaseAdapter } from "./agent-adapter.js";
+const execFileAsync = promisify(execFile);
+export class CodexAdapter extends BaseAdapter {
+    id;
+    workingDirectory;
+    codexPath;
+    model;
+    taskTimeoutMs;
+    qualityGates;
+    enableCodexReview;
+    log;
+    codexExecutions = new Map();
+    constructor(options) {
+        super();
+        this.workingDirectory = options.workingDirectory;
+        this.id = `codex:${path.basename(options.workingDirectory)}`;
+        this.codexPath = options.codexPath ?? "codex";
+        this.model = options.model;
+        this.taskTimeoutMs = options.taskTimeoutMs ?? 120_000;
+        this.qualityGates = options.qualityGates ?? ["npx tsc --noEmit"];
+        this.enableCodexReview = options.enableCodexReview ?? true;
+        this.log = options.logger ?? consoleLogger;
+    }
+    capabilities() {
+        return {
+            agentId: this.id,
+            name: "Codex CLI",
+            version: "0.1.0",
+            capabilities: [
+                "code-generation",
+                "code-review",
+                "testing",
+                "refactoring",
+            ],
+            modelRequirement: "frontier",
+            interface: {
+                type: "cli",
+                command: this.codexPath,
+                workingDirectory: this.workingDirectory,
+            },
+            constraints: {
+                maxConcurrent: 1, // Codex works best sequentially
+                requiresNetwork: true,
+                maxRetries: 2,
+            },
+        };
+    }
+    async dispatch(task) {
+        const correlationId = generateCorrelationId();
+        try {
+            // Build the prompt from task objective + constraints + pitfalls
+            const prompt = this.buildPrompt(task);
+            // Build codex args
+            const args = ["exec"];
+            if (this.model) {
+                args.push("--model", this.model);
+            }
+            args.push("--full-auto");
+            args.push("--cd", this.workingDirectory);
+            args.push(prompt);
+            this.log.info(`[codex-adapter] Spawning: ${this.codexPath} ${args.slice(0, 3).join(" ")} ...`);
+            const proc = spawn(this.codexPath, args, {
+                cwd: this.workingDirectory,
+                stdio: ["ignore", "pipe", "pipe"],
+                env: { ...process.env },
+            });
+            const execution = {
+                taskId: task.id,
+                process: proc,
+                stdout: "",
+                stderr: "",
+                exitCode: null,
+                exited: false,
+                startedAt: Date.now(),
+                gatesRun: false,
+            };
+            proc.stdout?.on("data", (data) => {
+                execution.stdout += data.toString();
+            });
+            proc.stderr?.on("data", (data) => {
+                execution.stderr += data.toString();
+            });
+            proc.on("close", (code) => {
+                execution.exitCode = code;
+                execution.exited = true;
+            });
+            proc.on("error", (err) => {
+                execution.error = err.message;
+                execution.exited = true;
+                execution.exitCode = 1;
+            });
+            this.codexExecutions.set(correlationId, execution);
+            this.setExecution(correlationId, task.id, "running");
+            return { correlationId, accepted: true };
+        }
+        catch (err) {
+            return {
+                correlationId,
+                accepted: false,
+                reason: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    async poll(correlationId) {
+        const execution = this.codexExecutions.get(correlationId);
+        if (!execution) {
+            return {
+                correlationId,
+                state: "failed",
+                evidence: {
+                    taskId: "unknown",
+                    status: "failed",
+                    failureDetail: {
+                        failureType: "unknown",
+                        attempted: "poll",
+                        hypothesis: `No execution found for correlation ${correlationId}`,
+                    },
+                },
+            };
+        }
+        // Check timeout
+        const elapsed = Date.now() - execution.startedAt;
+        if (!execution.exited && elapsed > this.taskTimeoutMs) {
+            execution.process.kill("SIGTERM");
+            this.codexExecutions.delete(correlationId);
+            return {
+                correlationId,
+                state: "failed",
+                evidence: {
+                    taskId: execution.taskId,
+                    status: "failed",
+                    failureDetail: {
+                        failureType: "timeout",
+                        attempted: `Codex execution exceeded ${this.taskTimeoutMs}ms`,
+                        hypothesis: "Task too complex or codex hung.",
+                    },
+                },
+            };
+        }
+        // Still running
+        if (!execution.exited) {
+            // Extract last meaningful line from stdout as summary
+            const lines = execution.stdout.trim().split("\n").filter(Boolean);
+            const lastLine = lines[lines.length - 1] ?? "Working...";
+            return {
+                correlationId,
+                state: "running",
+                progress: {
+                    taskId: execution.taskId,
+                    phase: "codex-exec",
+                    summary: lastLine.slice(0, 200),
+                    completionEstimate: Math.min(0.9, elapsed / this.taskTimeoutMs),
+                    logs: [
+                        {
+                            timestamp: new Date().toISOString(),
+                            level: "info",
+                            message: `Codex running (${Math.round(elapsed / 1000)}s elapsed, ${execution.stdout.length} bytes output)`,
+                        },
+                    ],
+                    data: {
+                        stdoutLength: execution.stdout.length,
+                        stderrLength: execution.stderr.length,
+                        elapsedMs: elapsed,
+                    },
+                },
+            };
+        }
+        // Process exited — run quality gates if not already done
+        if (!execution.gatesRun) {
+            execution.gatesRun = true;
+            if (execution.exitCode !== 0) {
+                // Codex itself failed
+                this.codexExecutions.delete(correlationId);
+                return {
+                    correlationId,
+                    state: "failed",
+                    progress: {
+                        taskId: execution.taskId,
+                        phase: "codex-failed",
+                        summary: `Codex exited with code ${execution.exitCode}`,
+                        completionEstimate: 1.0,
+                    },
+                    evidence: {
+                        taskId: execution.taskId,
+                        status: "failed",
+                        failureDetail: {
+                            failureType: "crash",
+                            attempted: "codex exec",
+                            hypothesis: this.extractFailureHypothesis(execution),
+                        },
+                    },
+                };
+            }
+            // Codex succeeded — run quality gates
+            const gateResults = await this.runQualityGates();
+            execution.gateResults = gateResults;
+        }
+        // Return final result based on gate results
+        const allPassed = execution.gateResults?.every((g) => g.passed) ?? false;
+        this.codexExecutions.delete(correlationId);
+        if (allPassed) {
+            return {
+                correlationId,
+                state: "completed",
+                progress: {
+                    taskId: execution.taskId,
+                    phase: "completed",
+                    summary: "All quality gates passed.",
+                    completionEstimate: 1.0,
+                },
+                evidence: {
+                    taskId: execution.taskId,
+                    status: "completed",
+                    gateResults: execution.gateResults,
+                    artifacts: [
+                        {
+                            type: "log",
+                            description: `Codex output (${execution.stdout.length} bytes)`,
+                        },
+                    ],
+                    verification: `Codex exec completed successfully. ${execution.gateResults?.length ?? 0} quality gates passed.`,
+                },
+            };
+        }
+        else {
+            const failedGate = execution.gateResults?.find((g) => !g.passed);
+            return {
+                correlationId,
+                state: "failed",
+                progress: {
+                    taskId: execution.taskId,
+                    phase: "gate-failed",
+                    summary: `Quality gate failed: ${failedGate?.gate}`,
+                    completionEstimate: 1.0,
+                },
+                evidence: {
+                    taskId: execution.taskId,
+                    status: "failed",
+                    gateResults: execution.gateResults,
+                    failureDetail: {
+                        failureType: "gate",
+                        attempted: `Codex completed but gate "${failedGate?.gate}" failed`,
+                        hypothesis: failedGate?.output?.slice(0, 500) ?? "Gate check failed",
+                    },
+                },
+            };
+        }
+    }
+    async cancel(correlationId) {
+        const execution = this.codexExecutions.get(correlationId);
+        if (execution && !execution.exited) {
+            execution.process.kill("SIGTERM");
+        }
+        this.codexExecutions.delete(correlationId);
+        this.setExecution(correlationId, execution?.taskId ?? "unknown", "cancelled");
+    }
+    async dispose() {
+        // Kill all running processes
+        for (const [, execution] of this.codexExecutions) {
+            if (!execution.exited) {
+                execution.process.kill("SIGTERM");
+            }
+        }
+        this.codexExecutions.clear();
+        await super.dispose();
+    }
+    // ─── Private helpers ─────────────────────────────────────────────────────
+    buildPrompt(task) {
+        const parts = [];
+        parts.push(`Objective: ${task.objective}`);
+        if (task.constraints?.length) {
+            parts.push(`\nConstraints:\n${task.constraints.map((c) => `- ${c}`).join("\n")}`);
+        }
+        if (task.acceptanceCriteria?.length) {
+            parts.push(`\nAcceptance Criteria:\n${task.acceptanceCriteria.map((c) => `- ${c}`).join("\n")}`);
+        }
+        // Inject pitfall context from previous failures
+        if (task.context?.pitfalls?.length) {
+            parts.push("\nPrevious Failures (avoid these mistakes):");
+            for (const pitfall of task.context.pitfalls) {
+                parts.push(`- [${pitfall.failureType}] ${pitfall.hypothesis}`);
+                if (pitfall.missingContext) {
+                    parts.push(`  Missing context: ${pitfall.missingContext}`);
+                }
+            }
+        }
+        // Inject resolved inputs
+        if (task.inputs) {
+            const inputEntries = Object.entries(task.inputs).filter(([, v]) => typeof v !== "object" || !("fromTask" in v));
+            if (inputEntries.length > 0) {
+                parts.push("\nInputs:");
+                for (const [key, value] of inputEntries) {
+                    parts.push(`- ${key}: ${JSON.stringify(value)}`);
+                }
+            }
+        }
+        return parts.join("\n");
+    }
+    async runQualityGates() {
+        const results = [];
+        // Run configured quality gates
+        for (const gate of this.qualityGates) {
+            const startTime = Date.now();
+            try {
+                const { stdout, stderr } = await execFileAsync("sh", ["-c", gate], {
+                    cwd: this.workingDirectory,
+                    timeout: 60_000,
+                });
+                results.push({
+                    gate: this.gateNameFromCommand(gate),
+                    type: "command",
+                    command: gate,
+                    exitCode: 0,
+                    passed: true,
+                    output: (stdout + stderr).slice(0, 2000),
+                    durationMs: Date.now() - startTime,
+                });
+            }
+            catch (err) {
+                const execErr = err;
+                results.push({
+                    gate: this.gateNameFromCommand(gate),
+                    type: "command",
+                    command: gate,
+                    exitCode: execErr.code ?? 1,
+                    passed: false,
+                    output: ((execErr.stdout ?? "") + (execErr.stderr ?? "")).slice(0, 2000),
+                    durationMs: Date.now() - startTime,
+                });
+                break; // Stop on first failure
+            }
+        }
+        // Run codex review if enabled and no gates failed yet
+        if (this.enableCodexReview && results.every((r) => r.passed)) {
+            const startTime = Date.now();
+            try {
+                const { stdout, stderr } = await execFileAsync(this.codexPath, ["review", "--uncommitted"], {
+                    cwd: this.workingDirectory,
+                    timeout: 120_000,
+                });
+                const output = (stdout + stderr).slice(0, 2000);
+                const hasCritical = /CRITICAL/i.test(output);
+                results.push({
+                    gate: "codex-review",
+                    type: "command",
+                    command: `${this.codexPath} review --uncommitted`,
+                    exitCode: 0,
+                    passed: !hasCritical,
+                    output,
+                    durationMs: Date.now() - startTime,
+                });
+            }
+            catch (err) {
+                const execErr = err;
+                results.push({
+                    gate: "codex-review",
+                    type: "command",
+                    command: `${this.codexPath} review --uncommitted`,
+                    exitCode: execErr.code ?? 1,
+                    passed: false,
+                    output: ((execErr.stdout ?? "") + (execErr.stderr ?? "")).slice(0, 2000),
+                    durationMs: Date.now() - startTime,
+                });
+            }
+        }
+        return results;
+    }
+    gateNameFromCommand(command) {
+        // Extract a readable name from the command
+        if (command.includes("tsc"))
+            return "typecheck";
+        if (command.includes("test"))
+            return "unit-tests";
+        if (command.includes("lint"))
+            return "lint";
+        return command.split(" ").pop() ?? command;
+    }
+    extractFailureHypothesis(execution) {
+        // Try to extract useful error info from stderr/stdout
+        const combined = (execution.stderr + "\n" + execution.stdout).trim();
+        const lines = combined.split("\n").filter(Boolean);
+        // Look for error-like lines
+        const errorLines = lines.filter((l) => /error|fail|exception|fatal/i.test(l));
+        if (errorLines.length > 0) {
+            return errorLines.slice(0, 3).join("; ");
+        }
+        // Fallback: last few lines
+        return lines.slice(-3).join("; ") || "Codex process exited with non-zero code";
+    }
+}
+//# sourceMappingURL=codex-adapter.js.map

package/dist/adapter/codex-adapter.js.map

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

package/dist/adapter/va-auto-pilot-adapter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * VaAutoPilotAdapter — wraps va-auto-pilot's sprint-board.mjs CLI
+ * as a protocol-compliant agent.
+ *
+ * Key design: we call va-auto-pilot via child_process, NOT via library import.
+ * This preserves the "convention-based" contract. Any tool that exposes the
+ * same CLI interface can be adapted with the same pattern.
+ */
+import type { AgentCapability, TaskUnit, GateResult } from "../types/index.js";
+import type { Logger } from "../utils/logger.js";
+import type { DispatchResult, PollResult } from "./agent-adapter.js";
+import { BaseAdapter } from "./agent-adapter.js";
+export interface VaAutoPilotAdapterOptions {
+    /** Absolute path to the project using va-auto-pilot. */
+    projectRoot: string;
+    /** Path to sprint-board.mjs. Defaults to <projectRoot>/scripts/sprint-board.mjs */
+    sprintBoardPath?: string;
+    /** Quality gate command. Defaults to 'npm run check:all' */
+    qualityGateCommand?: string;
+    /** Logger instance. Defaults to console-based logger. */
+    logger?: Logger;
+}
+/**
+ * Maps between va-auto-pilot's sprint-board CLI and the universal protocol.
+ *
+ * Execution flow:
+ * 1. dispatch() → sprint-board add + update "In Progress" → spawns worker
+ * 2. poll() → reads sprint-state.json via sprint-board next --json
+ * 3. cancel() → sprint-board update "Failed"
+ */
+export declare class VaAutoPilotAdapter extends BaseAdapter {
+    readonly id: string;
+    private readonly projectRoot;
+    private readonly sprintBoardPath;
+    private readonly qualityGateCommand;
+    private readonly log;
+    private runningProcesses;
+    constructor(options: VaAutoPilotAdapterOptions);
+    capabilities(): AgentCapability;
+    dispatch(task: TaskUnit): Promise<DispatchResult>;
+    poll(correlationId: string): Promise<PollResult>;
+    cancel(correlationId: string): Promise<void>;
+    /**
+     * Run quality gates and return structured results.
+     */
+    runQualityGates(): Promise<GateResult[]>;
+    private runSprintBoard;
+    private buildEvidence;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=va-auto-pilot-adapter.d.ts.map

package/dist/adapter/va-auto-pilot-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"va-auto-pilot-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/va-auto-pilot-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EAER,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIjD,MAAM,WAAW,yBAAyB;IACxC,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuBD;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAuC;gBAEnD,OAAO,EAAE,yBAAyB;IAY9C,YAAY,IAAI,eAAe;IA2BzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC;IAkDjD,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAuFhD,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBlD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YA6ChC,cAAc;IAS5B,OAAO,CAAC,aAAa;IAuBN,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAIxC"}