contextos-mcp 0.4.0

package/dist/mcp/tools.js

@@ -0,0 +1,393 @@
+/**
+ * MCP tool definitions and handlers for swarm-code.
+ *
+ * Tools:
+ *   - swarm_run:     Full orchestrated swarm execution (subprocess)
+ *   - swarm_thread:  Spawn a single coding agent thread in a worktree
+ *   - swarm_status:  Get current session status (threads, budget)
+ *   - swarm_merge:   Merge completed thread branches
+ *   - swarm_cancel:  Cancel running thread(s)
+ *   - swarm_cleanup: Destroy session and worktrees
+ */
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { z } from "zod";
+import { assertWithinRepository } from "../security/repository-boundary.js";
+import { redactSecrets } from "../security/secret-filter.js";
+import { cancelThreads, cleanupSession, getBudgetState, getSession, getThreads, mergeThreads, spawnThread, } from "./session.js";
+// ── Helpers ────────────────────────────────────────────────────────────────
+function _textResult(text) {
+    return { content: [{ type: "text", text: redactSecrets(text) }] };
+}
+function errorResult(text) {
+    return { content: [{ type: "text", text: redactSecrets(text) }], isError: true };
+}
+function jsonResult(data) {
+    return { content: [{ type: "text", text: redactSecrets(JSON.stringify(data, null, 2)) }] };
+}
+/** Track active subprocesses so they can be killed on shutdown. */
+const activeSubprocesses = new Set();
+/** Kill all tracked subprocesses. Called during server shutdown. */
+export function killActiveSubprocesses() {
+    for (const child of activeSubprocesses) {
+        try {
+            child.kill("SIGTERM");
+        }
+        catch {
+            /* already dead */
+        }
+    }
+    activeSubprocesses.clear();
+}
+// ── Tool Registration ──────────────────────────────────────────────────────
+export function registerTools(server, defaultDir) {
+    // Helper: resolve dir from tool args or default, validate existence
+    function resolveDir(dir) {
+        const resolved = dir || defaultDir;
+        if (!resolved)
+            return null;
+        const abs = resolve(resolved);
+        if (!existsSync(abs))
+            return null;
+        try {
+            if (defaultDir) {
+                const realDefault = assertWithinRepository(defaultDir, defaultDir);
+                return assertWithinRepository(abs, realDefault);
+            }
+            return assertWithinRepository(abs, abs);
+        }
+        catch {
+            return null;
+        }
+    }
+    // ── swarm_run ──────────────────────────────────────────────────────────
+    // Full swarm orchestration — runs the entire RLM loop as a subprocess.
+    // This is the high-level "do everything" tool.
+    server.registerTool("swarm_run", {
+        title: "Run Swarm",
+        description: "Run the full swarm orchestrator on a repository. Decomposes a task into " +
+            "parallel coding agent threads, executes them in isolated git worktrees, " +
+            "and merges results. Returns a JSON summary with success status, answer, " +
+            "thread stats, and cost breakdown.",
+        inputSchema: z.object({
+            dir: z.string().optional().describe("Path to the git repository (uses server default if not specified)"),
+            task: z.string().describe("The coding task to accomplish (e.g., 'add error handling to all API routes')"),
+            agent: z
+                .string()
+                .optional()
+                .describe("Agent backend: opencode (default), claude-code, codex, aider, direct-llm"),
+            model: z.string().optional().describe("Orchestrator model override (e.g., claude-sonnet-4-6, gpt-4o)"),
+            max_budget: z
+                .number()
+                .min(0)
+                .max(50)
+                .optional()
+                .describe("Maximum budget in USD (default: 5.00, hard cap: 50.00)"),
+            auto_route: z.boolean().optional().describe("Enable auto model/agent routing per thread (default: false)"),
+        }),
+    }, async (args) => {
+        const resolvedDir = resolveDir(args.dir);
+        if (!resolvedDir) {
+            if (!args.dir && !defaultDir)
+                return errorResult("'dir' is required — specify the repo path");
+            return errorResult(`Directory does not exist: ${resolve(args.dir || defaultDir || "")}`);
+        }
+        // Build CLI args
+        const cliArgs = ["--dir", resolvedDir, "--json", "--quiet"];
+        if (args.agent)
+            cliArgs.push("--agent", args.agent);
+        if (args.model)
+            cliArgs.push("--orchestrator", args.model);
+        if (args.max_budget != null)
+            cliArgs.push("--max-budget", String(args.max_budget));
+        if (args.auto_route)
+            cliArgs.push("--auto-route");
+        cliArgs.push(args.task);
+        // Run swarm as subprocess
+        try {
+            const result = await runSwarmSubprocess(cliArgs);
+            return jsonResult(result);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return errorResult(`Swarm execution failed: ${msg}`);
+        }
+    });
+    // ── swarm_thread ──────────────────────────────────────────────────────
+    // Spawn a single coding agent thread — the low-level building block.
+    // The calling agent (Claude Code, Cursor) can orchestrate multiple threads.
+    server.registerTool("swarm_thread", {
+        title: "Spawn Thread",
+        description: "Spawn a single coding agent in an isolated git worktree. The agent " +
+            "executes the task, and the result (files changed, diff, summary) is " +
+            "returned. Use this for fine-grained control — call multiple times for " +
+            "parallel work, then use swarm_merge to integrate.",
+        inputSchema: z.object({
+            dir: z.string().optional().describe("Path to the git repository (uses server default if not specified)"),
+            task: z.string().describe("Task for the coding agent (e.g., 'fix the auth bug in src/auth.ts')"),
+            files: z.array(z.string()).optional().describe("File paths to focus on (hints for the agent)"),
+            agent: z
+                .string()
+                .optional()
+                .describe("Agent backend: opencode (default), claude-code, codex, aider, direct-llm"),
+            model: z.string().optional().describe("Model override (e.g., anthropic/claude-sonnet-4-6)"),
+            context: z.string().optional().describe("Additional context to pass to the agent"),
+        }),
+    }, async (args) => {
+        const dir = args.dir || defaultDir;
+        if (!dir)
+            return errorResult("'dir' is required — specify the repo path");
+        try {
+            const session = await getSession(dir);
+            if (args.files) {
+                for (const file of args.files) {
+                    assertWithinRepository(resolve(session.dir, file), session.dir);
+                }
+            }
+            const result = await spawnThread(session, {
+                task: args.task,
+                files: args.files,
+                agent: args.agent,
+                model: args.model,
+                context: args.context,
+            });
+            return jsonResult({
+                success: result.success,
+                summary: result.summary,
+                files_changed: result.filesChanged,
+                diff_stats: result.diffStats,
+                duration_ms: result.durationMs,
+                cost_usd: result.estimatedCostUsd,
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return errorResult(`Thread failed: ${msg}`);
+        }
+    });
+    // ── swarm_status ──────────────────────────────────────────────────────
+    // Get status of all threads and budget for a session.
+    server.registerTool("swarm_status", {
+        title: "Session Status",
+        description: "Get the current status of a swarm session — all threads with their " +
+            "status (pending/running/completed/failed), budget spent, and cost breakdown.",
+        inputSchema: z.object({
+            dir: z.string().optional().describe("Path to the git repository (uses server default if not specified)"),
+        }),
+    }, async (args) => {
+        const dir = args.dir || defaultDir;
+        if (!dir)
+            return errorResult("'dir' is required — specify the repo path");
+        try {
+            const session = await getSession(dir);
+            const threads = getThreads(session);
+            const budget = getBudgetState(session);
+            const threadSummaries = threads.map((t) => ({
+                id: t.id,
+                task: t.config.task,
+                status: t.status,
+                phase: t.phase,
+                agent: t.config.agent.backend,
+                model: t.config.agent.model,
+                files_changed: t.result?.filesChanged || [],
+                duration_ms: t.completedAt && t.startedAt ? t.completedAt - t.startedAt : t.startedAt ? Date.now() - t.startedAt : 0,
+                cost_usd: t.result?.estimatedCostUsd ?? t.estimatedCostUsd,
+                error: t.error,
+            }));
+            return jsonResult({
+                dir: session.dir,
+                threads: threadSummaries,
+                counts: {
+                    total: threads.length,
+                    running: threads.filter((t) => t.status === "running").length,
+                    completed: threads.filter((t) => t.status === "completed").length,
+                    failed: threads.filter((t) => t.status === "failed").length,
+                    pending: threads.filter((t) => t.status === "pending").length,
+                },
+                budget: {
+                    spent_usd: budget.totalSpentUsd,
+                    limit_usd: budget.sessionLimitUsd,
+                    per_thread_limit_usd: budget.perThreadLimitUsd,
+                    tokens: budget.totalTokens,
+                },
+                session_age_ms: Date.now() - session.createdAt,
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return errorResult(`Status check failed: ${msg}`);
+        }
+    });
+    // ── swarm_merge ───────────────────────────────────────────────────────
+    // Merge completed thread branches back to main.
+    server.registerTool("swarm_merge", {
+        title: "Merge Threads",
+        description: "Merge all completed thread branches back into the main branch. " +
+            "Threads that are still running or failed are skipped. Returns " +
+            "per-branch merge results including any conflicts.",
+        inputSchema: z.object({
+            dir: z.string().optional().describe("Path to the git repository (uses server default if not specified)"),
+        }),
+    }, async (args) => {
+        const dir = args.dir || defaultDir;
+        if (!dir)
+            return errorResult("'dir' is required — specify the repo path");
+        try {
+            const session = await getSession(dir);
+            const results = await mergeThreads(session);
+            return jsonResult({
+                merged: results.length,
+                results: results.map((r) => ({
+                    branch: r.branch,
+                    success: r.success,
+                    message: r.message,
+                    conflicts: r.conflicts,
+                })),
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return errorResult(`Merge failed: ${msg}`);
+        }
+    });
+    // ── swarm_cancel ──────────────────────────────────────────────────────
+    // Cancel a specific thread or all threads.
+    server.registerTool("swarm_cancel", {
+        title: "Cancel Threads",
+        description: "Cancel running threads. Specify a thread_id to cancel a specific " +
+            "thread, or omit to cancel all running threads in the session.",
+        inputSchema: z.object({
+            dir: z.string().optional().describe("Path to the git repository (uses server default if not specified)"),
+            thread_id: z.string().optional().describe("Specific thread ID to cancel (omit to cancel all)"),
+        }),
+    }, async (args) => {
+        const dir = args.dir || defaultDir;
+        if (!dir)
+            return errorResult("'dir' is required — specify the repo path");
+        try {
+            const session = await getSession(dir);
+            const result = cancelThreads(session, args.thread_id);
+            return jsonResult(result);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return errorResult(`Cancel failed: ${msg}`);
+        }
+    });
+    // ── swarm_cleanup ─────────────────────────────────────────────────────
+    // Destroy a session — cancels threads, removes worktrees.
+    server.registerTool("swarm_cleanup", {
+        title: "Cleanup Session",
+        description: "Clean up a swarm session — cancels all running threads, removes " +
+            "worktrees, and frees resources. Call this when you're done with a " +
+            "directory to avoid leftover worktrees.",
+        inputSchema: z.object({
+            dir: z.string().optional().describe("Path to the git repository (uses server default if not specified)"),
+        }),
+    }, async (args) => {
+        const dir = args.dir || defaultDir;
+        if (!dir)
+            return errorResult("'dir' is required — specify the repo path");
+        try {
+            const message = await cleanupSession(dir);
+            return jsonResult({ cleaned_up: true, message });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return errorResult(`Cleanup failed: ${msg}`);
+        }
+    });
+}
+// ── Subprocess runner ──────────────────────────────────────────────────────
+/**
+ * Run swarm as a subprocess with --json --quiet flags.
+ * Tracks the child process so it can be killed on server shutdown.
+ */
+function runSwarmSubprocess(args) {
+    return new Promise((resolve, reject) => {
+        const { bin, binArgs } = findSwarmEntrypoint();
+        const child = execFile(bin, [...binArgs, ...args], {
+            encoding: "utf-8",
+            maxBuffer: 50 * 1024 * 1024,
+            timeout: 30 * 60 * 1000,
+            env: { ...process.env },
+        }, (err, stdout, stderr) => {
+            activeSubprocesses.delete(child);
+            if (err) {
+                // Try to parse JSON from stdout even on error
+                const parsed = tryParseSwarmJson(stdout);
+                if (parsed) {
+                    resolve(parsed);
+                    return;
+                }
+                reject(new Error(stderr || err.message));
+                return;
+            }
+            const parsed = tryParseSwarmJson(stdout);
+            if (parsed) {
+                resolve(parsed);
+            }
+            else {
+                reject(new Error(`Could not parse swarm output: ${stdout.slice(0, 500)}`));
+            }
+        });
+        activeSubprocesses.add(child);
+    });
+}
+/**
+ * Find the swarm entrypoint — prefers compiled dist/ over source.
+ * Returns the binary and args needed to run it.
+ */
+function findSwarmEntrypoint() {
+    const __dir = dirname(fileURLToPath(import.meta.url));
+    const root = join(__dir, "..", "..");
+    const distEntry = join(root, "dist", "main.js");
+    if (existsSync(distEntry)) {
+        return { bin: "node", binArgs: [distEntry] };
+    }
+    // Fallback: use npx tsx to run TypeScript source
+    const srcEntry = join(root, "src", "main.ts");
+    if (existsSync(srcEntry)) {
+        return { bin: "npx", binArgs: ["tsx", srcEntry] };
+    }
+    throw new Error("swarm-code entrypoint not found. Run 'npm run build' or install swarm-code globally.");
+}
+function tryParseSwarmJson(stdout) {
+    if (!stdout)
+        return null;
+    const trimmed = stdout.trim();
+    // Try single-line JSON (last line that starts with {)
+    const lines = trimmed.split("\n");
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i].trim();
+        if (line.startsWith("{")) {
+            try {
+                const parsed = JSON.parse(line);
+                if (typeof parsed === "object" && parsed !== null && "success" in parsed) {
+                    return parsed;
+                }
+            }
+            catch {
+                /* not JSON */
+            }
+        }
+    }
+    // Fallback: first { to last }
+    const firstBrace = trimmed.indexOf("{");
+    const lastBrace = trimmed.lastIndexOf("}");
+    if (firstBrace !== -1 && lastBrace > firstBrace) {
+        try {
+            const parsed = JSON.parse(trimmed.slice(firstBrace, lastBrace + 1));
+            if (typeof parsed === "object" && parsed !== null) {
+                return parsed;
+            }
+        }
+        catch {
+            /* give up */
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/orchestration/reviewer-gate.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Independent Reviewer Gate (Dual Verdict) & Final Combined Review.
+ *
+ * Implements Superpowers-inspired single-reviewer dual-verdict gate:
+ * - specCompliance: "PASS" | "FAIL"
+ * - codeQuality: "PASS" | "FAIL"
+ *
+ * Enforces Reviewer != Implementer policy and prevents self-approval.
+ */
+import type { ReviewVerdict, TaskBrief, VerificationVerdict } from "../core/types.js";
+export interface ReviewerGateOptions {
+    taskBrief: TaskBrief;
+    diff: string;
+    filesChanged: string[];
+    verificationVerdict: VerificationVerdict;
+    testOutput?: string;
+    implementerAgent?: string;
+    implementerModel?: string;
+    reviewerAgent?: string;
+    reviewerModel?: string;
+    workDir?: string;
+    repoRoot?: string;
+}
+export interface CombinedReviewOptions {
+    repoRoot: string;
+    baseSha: string;
+    stagingBranch: string;
+    taskSummaries?: string[];
+    reviewerAgent?: string;
+    reviewerModel?: string;
+}
+/**
+ * Determine a distinct reviewer backend to enforce Reviewer != Implementer.
+ */
+export declare function resolveReviewerAgent(implementerAgent?: string, requestedReviewer?: string): string;
+/**
+ * Evaluates an implementer's changes against the assigned TaskBrief.
+ */
+export declare function evaluateReviewerGate(options: ReviewerGateOptions): Promise<ReviewVerdict>;
+/**
+ * Task 2.5f: Final holistic review of combined staging changes before merge to main.
+ */
+export declare function reviewCombinedStaging(options: CombinedReviewOptions): Promise<ReviewVerdict>;