patchwork-os 0.2.0-alpha.0

package/dist/claudeDriver.js

@@ -0,0 +1,459 @@
+import { spawn } from "node:child_process";
+import { writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+/**
+ * Map a ClaudeTaskOutput flat struct to the ClaudeTaskOutcome discriminated union.
+ *
+ * @param output     Flat output from ClaudeDriver.run().
+ * @param cancelReason  Optional cancelReason from the ClaudeTask record (set by
+ *                   the orchestrator after run() returns).  When provided,
+ *                   "timeout" and "startup_timeout" cancelKinds are reachable.
+ *                   Without it, aborted tasks default to cancelKind "user".
+ */
+export function toClaudeTaskOutcome(output, cancelReason) {
+    if (output.wasAborted) {
+        const cancelKind = output.startupTimedOut || cancelReason === "startup_timeout"
+            ? "startup_timeout"
+            : cancelReason === "timeout"
+                ? "timeout"
+                : "user";
+        return {
+            outcome: "aborted",
+            text: output.text,
+            cancelKind,
+            stderrTail: output.stderrTail,
+            durationMs: output.durationMs,
+        };
+    }
+    if (output.exitCode !== 0) {
+        return {
+            outcome: "error",
+            text: output.text,
+            exitCode: output.exitCode,
+            stderrTail: output.stderrTail,
+            durationMs: output.durationMs,
+        };
+    }
+    return {
+        outcome: "done",
+        text: output.text,
+        durationMs: output.durationMs,
+        startupMs: output.startupMs,
+    };
+}
+const OUTPUT_CAP = 50 * 1024; // 50KB
+export class SubprocessDriver {
+    binary;
+    antBinary;
+    log;
+    name = "subprocess";
+    settingsPath;
+    settingsContent;
+    constructor(binary, antBinary, log) {
+        this.binary = binary;
+        this.antBinary = antBinary;
+        this.log = log;
+        // Use a minimal settings file that disables hooks without using --bare.
+        // --bare sets CLAUDE_CODE_SIMPLE=1 which skips OAuth auth — incompatible with
+        // Claude Max and other OAuth-based auth. --settings with empty hooks achieves
+        // the same hook-suppression goal while preserving normal auth flows.
+        this.settingsPath = join(tmpdir(), `claude-ide-bridge-subprocess-settings-${process.pid}.json`);
+        this.settingsContent = JSON.stringify({
+            hooks: {},
+            permissions: {
+                // Deny destructive publishing/deployment commands in headless automation tasks.
+                // These should never be triggered automatically — only by explicit user intent.
+                deny: [
+                    // Publishing / release
+                    "Bash(npm publish*)",
+                    "Bash(npm version*)",
+                    "Bash(yarn publish*)",
+                    "Bash(pnpm publish*)",
+                    "Bash(npx semantic-release*)",
+                    "Bash(npx release-it*)",
+                    // Git remote / tagging
+                    "Bash(git push*)",
+                    "Bash(git tag*)",
+                    "Bash(gh release*)",
+                    // Destructive git operations
+                    "Bash(git reset --hard*)",
+                    "Bash(git clean -f*)",
+                    // Filesystem destruction
+                    "Bash(rm -rf *)",
+                    "Bash(rm -rf/*)",
+                    // Privilege escalation
+                    "Bash(sudo *)",
+                    "Bash(chmod 777*)",
+                    // Arbitrary code execution
+                    "Bash(eval *)",
+                    "Bash(curl *|*)",
+                    "Bash(wget *|*)",
+                    // Process termination
+                    "Bash(kill -9 *)",
+                    "Bash(pkill *)",
+                ],
+            },
+        });
+        this._writeSettings();
+    }
+    _writeSettings() {
+        try {
+            writeFileSync(this.settingsPath, this.settingsContent, "utf-8");
+        }
+        catch (err) {
+            this.log(`[SubprocessDriver] WARN: could not write settings file at ${this.settingsPath}: ${err instanceof Error ? err.message : String(err)} — subprocess hooks may fire`);
+        }
+    }
+    async run(input) {
+        const effectiveBinary = input.useAnt ? this.antBinary : this.binary;
+        // Re-write the settings file before each run — /tmp may be cleared by the OS
+        // on long-running servers (e.g. systemd-tmpfiles), causing --settings to point
+        // at a missing file and allowing hook loops to fire.
+        this._writeSettings();
+        const args = [
+            "-p",
+            input.prompt,
+            // Suppress .mcp.json auto-discovery — avoids MCP server init overhead and
+            // prevents the subprocess from connecting back to the bridge that spawned it.
+            "--strict-mcp-config",
+            // Disable hooks via settings file instead of --bare. --bare skips OAuth auth
+            // which breaks Claude Max accounts. Empty hooks: {} suppresses hook loops
+            // while preserving normal auth flows.
+            "--settings",
+            this.settingsPath,
+            // Stream JSONL events: each partial assistant chunk arrives immediately as
+            // it is generated, enabling real-time onChunk streaming and startup detection.
+            "--output-format",
+            "stream-json",
+            "--verbose",
+            "--include-partial-messages",
+            // Avoid writing session files to disk for headless automation tasks.
+            "--no-session-persistence",
+        ];
+        if (input.model)
+            args.push("--model", input.model);
+        if (input.effort)
+            args.push("--effort", input.effort);
+        if (input.systemPrompt)
+            args.push("--system-prompt", input.systemPrompt);
+        if (input.fallbackModel)
+            args.push("--fallback-model", input.fallbackModel);
+        if (input.maxBudgetUsd !== undefined)
+            args.push("--max-budget-usd", String(input.maxBudgetUsd));
+        // Always skip permissions: all bridge-spawned subprocesses run headless (stdin: 'ignore',
+        // detached: true) so permission prompts can never be answered interactively.
+        args.push("--dangerously-skip-permissions");
+        // workspace is set as cwd in spawn() — claude -p has no --workspace flag
+        for (const f of input.contextFiles ?? []) {
+            if (typeof f === "string" && f.length > 0 && !f.startsWith("-")) {
+                args.push("--add-dir", f);
+            }
+        }
+        // CRITICAL: strip vars that would cause the subprocess to attach to or authenticate
+        // as the parent Claude Code session, which causes hangs when cwd contains a .claude/ dir.
+        const env = { ...process.env };
+        // Strip all Claude Code and MCP session vars — any of these can cause the subprocess to
+        // attach to, re-authenticate against, or behave as a nested agent of the parent session.
+        for (const key of Object.keys(env)) {
+            if (key === "CLAUDECODE" ||
+                key.startsWith("CLAUDE_CODE_") ||
+                key.startsWith("MCP_")) {
+                delete env[key];
+            }
+        }
+        this.log(`[SubprocessDriver] spawning: ${effectiveBinary} -p <prompt> (workspace: ${input.workspace})`);
+        const child = spawn(effectiveBinary, args, {
+            cwd: input.workspace,
+            env,
+            signal: input.signal,
+            // stdin must be 'ignore' (not 'pipe') — claude -p may block waiting for stdin to close
+            // if it detects a pipe on fd 0 in certain environments.
+            stdio: ["ignore", "pipe", "pipe"],
+            // detached: true calls setsid() on POSIX, creating a new session with no controlling
+            // terminal. Without this, the subprocess inherits the parent's terminal and can open
+            // /dev/tty directly to display interactive prompts (session-selection, permission
+            // confirmations). Those prompts appear on the physical terminal but are invisible to
+            // remote HTTP sessions (claude.ai, Codex CLI etc.), causing the sub-agent to hang
+            // waiting for input that never arrives. Detaching prevents /dev/tty access entirely.
+            detached: true,
+        });
+        // JSONL output state
+        // -------------------------------------------------------------------
+        // With --output-format stream-json, claude emits one JSON object per line.
+        // lineBuf holds the incomplete last line across data events (chunk boundaries
+        // can split a JSON object mid-line).
+        let lineBuf = "";
+        // Accumulated text from assistant events — used as fallback for final text if
+        // the result event is missing (old binary, crash before result, etc.)
+        let accumulated = "";
+        // outputBytesSent tracks how many bytes have been forwarded to onChunk so we
+        // can apply OUTPUT_CAP without truncating the accumulated text used for analysis.
+        let outputBytesSent = 0;
+        // firstAssistantAt: set on the first assistant event; used to compute startupMs.
+        let firstAssistantAt;
+        // doneFromResult: set when a result event is received so the abort path can
+        // distinguish "abort fired just after completion" from a real mid-run abort.
+        let doneFromResult = false;
+        let resultText = "";
+        let resultIsError = false;
+        child.stdout.setEncoding("utf-8");
+        child.stdout.on("data", (chunk) => {
+            lineBuf += chunk;
+            const lines = lineBuf.split("\n");
+            // The last element is either empty (chunk ended with \n) or a partial line.
+            lineBuf = lines.pop() ?? "";
+            for (const line of lines) {
+                if (line.trim() === "")
+                    continue; // skip blank separator lines
+                let event;
+                try {
+                    event = JSON.parse(line);
+                }
+                catch {
+                    // Non-JSON line — treat as plain text (backward compat for old binaries
+                    // that don't support --output-format stream-json, or binary error output).
+                    const text = `${line}\n`;
+                    accumulated += text;
+                    if (outputBytesSent < OUTPUT_CAP) {
+                        const send = text.slice(0, OUTPUT_CAP - outputBytesSent);
+                        if (send.length > 0) {
+                            input.onChunk?.(send);
+                            outputBytesSent += send.length;
+                        }
+                    }
+                    continue;
+                }
+                if (event.type === "assistant") {
+                    if (firstAssistantAt === undefined)
+                        firstAssistantAt = Date.now();
+                    const content = event.message?.content;
+                    if (Array.isArray(content)) {
+                        // Concatenate all text blocks in this event before dispatching to onChunk
+                        // to avoid many tiny single-character calls on tool_use-heavy responses.
+                        const text = content
+                            .filter((b) => b.type === "text")
+                            .map((b) => b.text ?? "")
+                            .join("");
+                        if (text.length > 0) {
+                            accumulated += text;
+                            if (outputBytesSent < OUTPUT_CAP) {
+                                const send = text.slice(0, OUTPUT_CAP - outputBytesSent);
+                                if (send.length > 0) {
+                                    input.onChunk?.(send);
+                                    outputBytesSent += send.length;
+                                }
+                            }
+                        }
+                    }
+                }
+                else if (event.type === "result") {
+                    doneFromResult = true;
+                    resultIsError = event.is_error === true;
+                    // result.result is the canonical full response — prefer it over accumulated.
+                    resultText =
+                        typeof event.result === "string" ? event.result : accumulated;
+                }
+                // type === "system" → log session_id, no other action
+            }
+        });
+        let stderr = "";
+        child.stderr.setEncoding("utf-8");
+        child.stderr.on("data", (chunk) => {
+            // Apply the same cap to stderr to prevent unbounded memory growth
+            if (stderr.length < OUTPUT_CAP) {
+                stderr += chunk;
+                if (stderr.length > OUTPUT_CAP)
+                    stderr = stderr.slice(0, OUTPUT_CAP);
+            }
+        });
+        const start = Date.now();
+        const stderrTailOf = (s) => s.length > 0 ? scrubSecrets(s.slice(-2048)) : undefined;
+        const startupMsOf = () => firstAssistantAt !== undefined ? firstAssistantAt - start : undefined;
+        // Startup timeout: if no assistant event arrives within startupTimeoutMs,
+        // kill the child and set startupTimedOut so the orchestrator can surface
+        // cancelReason: "startup_timeout" rather than the generic "timeout".
+        let startupTimedOut = false;
+        const startupHandle = input.startupTimeoutMs
+            ? setTimeout(() => {
+                if (firstAssistantAt === undefined && !doneFromResult) {
+                    startupTimedOut = true;
+                    child.kill();
+                }
+            }, input.startupTimeoutMs)
+            : null;
+        let exitCode;
+        try {
+            exitCode = await new Promise((resolve, reject) => {
+                child.on("close", (code) => resolve(code ?? 0));
+                child.on("error", reject);
+            });
+        }
+        catch (err) {
+            if (startupHandle)
+                clearTimeout(startupHandle);
+            // If the result event was already received before the abort signal fired
+            // (task completed just as the timeout fired), treat as a normal success
+            // rather than returning wasAborted: true with partial output.
+            if (doneFromResult) {
+                return {
+                    text: resultText.slice(0, OUTPUT_CAP),
+                    exitCode: resultIsError ? 1 : 0,
+                    durationMs: Date.now() - start,
+                    stderrTail: stderrTailOf(stderr),
+                    startupMs: startupMsOf(),
+                };
+            }
+            const isAbort = (err instanceof Error && err.name === "AbortError") ||
+                input.signal.aborted;
+            if (isAbort) {
+                // Return rather than throw so the orchestrator can surface partial
+                // output, stderrTail, and wasAborted to callers (e.g. /tasks).
+                return {
+                    text: accumulated.slice(0, OUTPUT_CAP),
+                    exitCode: -1,
+                    durationMs: Date.now() - start,
+                    stderrTail: stderrTailOf(stderr),
+                    wasAborted: true,
+                    startupMs: startupMsOf(),
+                };
+            }
+            throw err;
+        }
+        if (startupHandle)
+            clearTimeout(startupHandle);
+        // Derive exit code from the result event when available — it is semantically
+        // authoritative. Fall back to the process exit code for crashes / old binaries.
+        const effectiveExitCode = doneFromResult
+            ? resultIsError
+                ? 1
+                : 0
+            : exitCode;
+        const finalText = doneFromResult ? resultText : accumulated;
+        // Startup timeout fired: child was killed before any assistant output arrived.
+        // Surface as a wasAborted result with a distinct startupTimedOut flag so the
+        // orchestrator can set cancelReason: "startup_timeout".
+        if (startupTimedOut) {
+            return {
+                text: accumulated.slice(0, OUTPUT_CAP),
+                exitCode: -1,
+                durationMs: Date.now() - start,
+                stderrTail: stderrTailOf(stderr),
+                wasAborted: true,
+                startupTimedOut: true,
+                startupMs: undefined, // never set — that's what triggered the startup timeout
+            };
+        }
+        if (effectiveExitCode !== 0 && stderr) {
+            this.log(`[SubprocessDriver] stderr: ${stderr.slice(0, 500)}`);
+        }
+        return {
+            text: finalText.slice(0, OUTPUT_CAP),
+            exitCode: effectiveExitCode,
+            durationMs: Date.now() - start,
+            stderrTail: stderrTailOf(stderr),
+            startupMs: startupMsOf(),
+        };
+    }
+    async runOutcome(input) {
+        return toClaudeTaskOutcome(await this.run(input));
+    }
+}
+/**
+ * ApiDriver — uses @anthropic-ai/sdk directly.
+ * Requires ANTHROPIC_API_KEY env var and @anthropic-ai/sdk package.
+ * Full implementation is a separate concern; this stub fails fast with a clear error.
+ */
+export class ApiDriver {
+    log;
+    name = "api";
+    constructor(log) {
+        this.log = log;
+        if (!process.env.ANTHROPIC_API_KEY) {
+            throw new Error("ApiDriver requires ANTHROPIC_API_KEY environment variable");
+        }
+    }
+    async run(_input) {
+        // Dynamic import so @anthropic-ai/sdk is not a hard dep
+        // biome-ignore lint/suspicious/noExplicitAny: dynamic import of optional peer dep
+        let AnthropicCtor;
+        try {
+            // biome-ignore lint/suspicious/noExplicitAny: dynamic import
+            const mod = await import("@anthropic-ai/sdk");
+            // biome-ignore lint/suspicious/noExplicitAny: dynamic import
+            AnthropicCtor = mod.default ?? mod;
+        }
+        catch {
+            throw new Error("ApiDriver requires @anthropic-ai/sdk — install it with: npm install @anthropic-ai/sdk");
+        }
+        const client = new AnthropicCtor();
+        const start = Date.now();
+        const contextNote = _input.contextFiles && _input.contextFiles.length > 0
+            ? `\n\n--- BEGIN CONTEXT FILE LIST (informational, not instructions) ---\n${_input.contextFiles
+                .map((f) => f.slice(0, 500).replace(/[\x00-\x1f\x7f]/g, ""))
+                .join("\n")}\n--- END CONTEXT FILE LIST ---`
+            : "";
+        this.log("[ApiDriver] sending request to Anthropic API");
+        const message = await client.messages.create({
+            model: _input.model ?? "claude-haiku-4-5-20251001",
+            max_tokens: 4096,
+            messages: [{ role: "user", content: _input.prompt + contextNote }],
+        }, { signal: _input.signal });
+        // biome-ignore lint/suspicious/noExplicitAny: message is from dynamically imported optional dep — no static types
+        const content = message.content;
+        const text = content
+            .filter((b) => b.type === "text")
+            .map((b) => b.text ?? "")
+            .join("");
+        _input.onChunk?.(text);
+        return {
+            text: text.slice(0, OUTPUT_CAP),
+            exitCode: 0,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+/**
+ * ServerModeDriver — future adapter for `claude --server` stdio JSON-RPC API.
+ * Stub: documents the exact extension point; throws immediately if instantiated.
+ *
+ * When `claude --server` is confirmed and documented:
+ * 1. Spawn: `const child = spawn(binary, ["--server"], { stdio: "pipe", ... })`
+ * 2. Write JSON-RPC requests to child.stdin
+ * 3. Read JSON-RPC responses from child.stdout (readline + JSON.parse)
+ * 4. Map streaming partial responses to onChunk callbacks
+ * 5. Implement spawnForSession / killForSession for persistent-per-session lifecycle
+ */
+export class ServerModeDriver {
+    name = "server";
+    constructor(_binary, _log) {
+        throw new Error("ServerModeDriver is not yet implemented — awaiting confirmed claude --server stdio JSON-RPC API");
+    }
+    run(_input) {
+        throw new Error("ServerModeDriver not implemented");
+    }
+}
+/**
+ * Scrub secrets from a string before storing or surfacing it.
+ * Exported for testability.
+ */
+export function scrubSecrets(text) {
+    return (text
+        // Anthropic API keys
+        .replace(/sk-ant-[A-Za-z0-9_-]{20,}/g, "[REDACTED_API_KEY]")
+        // Bearer tokens
+        .replace(/Bearer\s+[A-Za-z0-9._-]{16,}/gi, "Bearer [REDACTED]")
+        // Generic token patterns
+        .replace(/\btoken[=:]\s*[A-Za-z0-9._-]{16,}/gi, "token=[REDACTED]"));
+}
+/** Factory: creates the appropriate driver from a config mode string. */
+export function createDriver(mode, binary, antBinary, log) {
+    if (mode === "none")
+        return null;
+    if (mode === "subprocess")
+        return new SubprocessDriver(binary, antBinary, log);
+    if (mode === "api")
+        return new ApiDriver(log);
+    throw new Error(`Unknown driver mode: ${mode}`);
+}
+//# sourceMappingURL=claudeDriver.js.map

package/dist/claudeDriver.js.map

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

package/dist/claudeMdPatch.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Returns the sentinel comment that opens a versioned bridge block in CLAUDE.md.
+ * Format: <!-- claude-ide-bridge:start:VERSION -->
+ */
+export declare function bridgeBlockStartMarker(version: string): string;
+/** Sentinel comment that closes a versioned bridge block in CLAUDE.md. */
+export declare const BRIDGE_BLOCK_END = "<!-- claude-ide-bridge:end -->";
+/** Regex that matches ANY versioned bridge block (any version). */
+export declare const BRIDGE_BLOCK_RE: RegExp;
+/**
+ * Returns the version embedded in an existing versioned bridge block in
+ * CLAUDE.md content, or null if no block is present.
+ */
+export declare function extractClaudeMdBlockVersion(content: string): string | null;
+/**
+ * Patches CLAUDE.md with a versioned bridge block that init can detect and
+ * update on re-run.
+ *
+ * Logic:
+ *   - If a versioned block with the current version exists → "already-current"
+ *   - If a versioned block with a different version exists → replace it → "updated"
+ *   - If the unversioned marker exists but no versioned block → wrap it → "patched"
+ *   - If the import line exists standalone (no marker block) → "already-present"
+ *   - Otherwise → "no-section"
+ *
+ * All writes are atomic (write to .tmp with exclusive-create, backup original,
+ * rename into place).
+ */
+export declare function patchClaudeMdImport(targetPath: string, marker: string, importLine: string, version?: string): "patched" | "already-present" | "already-current" | "updated" | "no-section";