claude-opencode-mcp 1.0.0

package/dist/util/git.d.ts

@@ -0,0 +1,54 @@
+export interface GitRunResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+    failed: boolean;
+    missing: boolean;
+}
+export declare function runGit(cwd: string, args: string[], options?: {
+    timeoutMs?: number;
+    maxBuffer?: number;
+}): Promise<GitRunResult>;
+export declare function isGitAvailable(): Promise<boolean>;
+export declare function isGitRepository(cwd: string): Promise<boolean>;
+export declare function findGitRoot(cwd: string): Promise<string | null>;
+export interface GitBaseline {
+    /** Commit the workspace was at when the session started (may be null for unborn HEAD). */
+    head: string | null;
+    /** Commit created by `git stash create` capturing dirty state (null when clean). */
+    stashRef: string | null;
+    /** Untracked files present at baseline time. */
+    untracked: string[];
+    /** Whether HEAD exists. */
+    unborn: boolean;
+    /** Whether the working tree had tracked changes at baseline time. */
+    dirty: boolean;
+}
+/** Capture a non-invasive baseline of the git working tree. */
+export declare function captureGitBaseline(cwd: string): Promise<GitBaseline | null>;
+export interface GitDiffResult {
+    patch: string;
+    files: Array<{
+        file: string;
+        additions: number;
+        deletions: number;
+        status: "modified" | "added" | "deleted" | "renamed" | "unknown";
+    }>;
+    truncated: boolean;
+    note?: string;
+}
+interface ParsedFile {
+    file: string;
+    additions: number;
+    deletions: number;
+    status: "modified" | "added" | "deleted" | "renamed" | "unknown";
+}
+export declare function parseUnifiedDiff(patch: string): ParsedFile[];
+export interface DiffOptions {
+    maxPatchChars?: number;
+    maxNewFiles?: number;
+}
+/** Compute the workspace diff between the recorded baseline and the current state. */
+export declare function diffSinceBaseline(cwd: string, baseline: GitBaseline, options?: DiffOptions): Promise<GitDiffResult>;
+export declare function currentHead(cwd: string): Promise<string | null>;
+export {};

package/dist/util/git.js

@@ -0,0 +1,202 @@
+import { execFile } from "node:child_process";
+import path from "node:path";
+import { BridgeError } from "../errors.js";
+const DEFAULT_TIMEOUT_MS = 20_000;
+const DEFAULT_MAX_BUFFER = 16 * 1024 * 1024;
+export async function runGit(cwd, args, options = {}) {
+    return new Promise((resolve) => {
+        execFile("git", args, {
+            cwd,
+            timeout: options.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+            maxBuffer: options.maxBuffer ?? DEFAULT_MAX_BUFFER,
+            windowsHide: true,
+            env: { ...process.env, GIT_OPTIONAL_LOCKS: "0", GIT_PAGER: "cat" },
+        }, (error, stdout, stderr) => {
+            const stdoutText = typeof stdout === "string" ? stdout : String(stdout ?? "");
+            const stderrText = typeof stderr === "string" ? stderr : String(stderr ?? "");
+            if (error) {
+                const errno = error.code;
+                const missing = errno === "ENOENT";
+                const code = typeof error.code === "number"
+                    ? (error.code ?? 1)
+                    : 1;
+                resolve({ code, stdout: stdoutText, stderr: stderrText, failed: true, missing });
+                return;
+            }
+            resolve({ code: 0, stdout: stdoutText, stderr: stderrText, failed: false, missing: false });
+        });
+    });
+}
+export async function isGitAvailable() {
+    const result = await runGit(process.cwd(), ["--version"], { timeoutMs: 5_000 });
+    return !result.missing && !result.failed;
+}
+export async function isGitRepository(cwd) {
+    const result = await runGit(cwd, ["rev-parse", "--is-inside-work-tree"], { timeoutMs: 5_000 });
+    return !result.failed && result.stdout.trim() === "true";
+}
+export async function findGitRoot(cwd) {
+    const result = await runGit(cwd, ["rev-parse", "--show-toplevel"], { timeoutMs: 5_000 });
+    if (result.failed)
+        return null;
+    const root = result.stdout.trim();
+    if (!root)
+        return null;
+    return path.resolve(root);
+}
+/** Capture a non-invasive baseline of the git working tree. */
+export async function captureGitBaseline(cwd) {
+    const inside = await isGitRepository(cwd);
+    if (!inside)
+        return null;
+    const headResult = await runGit(cwd, ["rev-parse", "HEAD"], { timeoutMs: 5_000 });
+    const head = headResult.failed ? null : headResult.stdout.trim() || null;
+    let stashRef = null;
+    const stashResult = await runGit(cwd, ["stash", "create"], { timeoutMs: 10_000 });
+    if (!stashResult.failed && stashResult.stdout.trim()) {
+        stashRef = stashResult.stdout.trim();
+    }
+    const untrackedResult = await runGit(cwd, ["ls-files", "--others", "--exclude-standard"], {
+        timeoutMs: 10_000,
+    });
+    const untracked = untrackedResult.failed
+        ? []
+        : untrackedResult.stdout
+            .split("\n")
+            .map((line) => line.trim())
+            .filter(Boolean);
+    return {
+        head,
+        stashRef,
+        untracked,
+        unborn: head === null,
+        dirty: stashRef !== null,
+    };
+}
+export function parseUnifiedDiff(patch) {
+    const files = [];
+    let current = null;
+    for (const line of patch.split("\n")) {
+        if (line.startsWith("diff --git ")) {
+            if (current)
+                files.push(current);
+            const parts = line.slice("diff --git ".length).trim().split(" ");
+            const bPath = parts.length >= 2 ? parts[parts.length - 1] : undefined;
+            const cleaned = bPath?.replace(/^b\//, "") ?? "unknown";
+            current = { file: cleaned, additions: 0, deletions: 0, status: "modified" };
+            continue;
+        }
+        if (!current)
+            continue;
+        if (line.startsWith("new file mode")) {
+            current.status = "added";
+            continue;
+        }
+        if (line.startsWith("deleted file mode")) {
+            current.status = "deleted";
+            continue;
+        }
+        if (line.startsWith("rename from ")) {
+            current.status = "renamed";
+            continue;
+        }
+        if (line.startsWith("rename to ")) {
+            current.file = line.slice("rename to ".length).trim();
+            continue;
+        }
+        if (line.startsWith("+++") || line.startsWith("---") || line.startsWith("@@"))
+            continue;
+        if (line.startsWith("+")) {
+            current.additions += 1;
+            continue;
+        }
+        if (line.startsWith("-")) {
+            current.deletions += 1;
+        }
+    }
+    if (current)
+        files.push(current);
+    return files;
+}
+async function newFilePatch(cwd, file) {
+    const result = await runGit(cwd, ["diff", "--no-color", "--no-ext-diff", "--no-index", "--", "/dev/null", file], {
+        timeoutMs: 15_000,
+    });
+    // `git diff --no-index` exits with code 1 when differences are found.
+    if (result.missing)
+        return "";
+    return result.stdout;
+}
+/** Compute the workspace diff between the recorded baseline and the current state. */
+export async function diffSinceBaseline(cwd, baseline, options = {}) {
+    const maxPatchChars = options.maxPatchChars ?? 60_000;
+    const maxNewFiles = options.maxNewFiles ?? 40;
+    const notes = [];
+    const chunks = [];
+    const ref = baseline.stashRef ?? baseline.head;
+    if (ref) {
+        const result = await runGit(cwd, ["diff", "--no-color", "--no-ext-diff", ref, "--"], {
+            timeoutMs: 20_000,
+        });
+        if (result.failed) {
+            throw new BridgeError("OPENCODE_ERROR", `git diff failed: ${result.stderr.trim() || "unknown error"}`);
+        }
+        if (result.stdout.trim())
+            chunks.push(result.stdout);
+    }
+    else if (baseline.unborn) {
+        const tracked = await runGit(cwd, ["ls-files", "--cached", "--others", "--exclude-standard"], {
+            timeoutMs: 15_000,
+        });
+        if (!tracked.failed) {
+            const files = tracked.stdout
+                .split("\n")
+                .map((line) => line.trim())
+                .filter(Boolean)
+                .slice(0, maxNewFiles);
+            for (const file of files) {
+                const patch = await newFilePatch(cwd, file);
+                if (patch.trim())
+                    chunks.push(patch);
+            }
+        }
+        notes.push("Repository has no commits yet; every tracked file is reported as added.");
+    }
+    const untrackedNow = await runGit(cwd, ["ls-files", "--others", "--exclude-standard"], {
+        timeoutMs: 10_000,
+    });
+    if (!untrackedNow.failed) {
+        const baselineSet = new Set(baseline.untracked);
+        const newFiles = untrackedNow.stdout
+            .split("\n")
+            .map((line) => line.trim())
+            .filter((line) => line && !baselineSet.has(line));
+        if (newFiles.length > maxNewFiles) {
+            notes.push(`Only the first ${maxNewFiles} new untracked files are shown.`);
+        }
+        for (const file of newFiles.slice(0, maxNewFiles)) {
+            const patch = await newFilePatch(cwd, file);
+            if (patch.trim())
+                chunks.push(patch);
+        }
+    }
+    let patch = chunks.join("\n");
+    let truncated = false;
+    if (patch.length > maxPatchChars) {
+        patch = `${patch.slice(0, maxPatchChars)}\n… [diff truncated at ${maxPatchChars} characters] …\n`;
+        truncated = true;
+    }
+    return {
+        patch,
+        files: parseUnifiedDiff(patch),
+        truncated,
+        ...(notes.length > 0 ? { note: notes.join(" ") } : {}),
+    };
+}
+export async function currentHead(cwd) {
+    const result = await runGit(cwd, ["rev-parse", "HEAD"], { timeoutMs: 5_000 });
+    if (result.failed)
+        return null;
+    return result.stdout.trim() || null;
+}
+//# sourceMappingURL=git.js.map

package/dist/util/git.js.map

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

package/dist/util/logger.d.ts

@@ -0,0 +1,21 @@
+export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
+export interface LogFields {
+    [key: string]: unknown;
+}
+export interface Logger {
+    readonly level: LogLevel;
+    debug(message: string, fields?: LogFields): void;
+    info(message: string, fields?: LogFields): void;
+    warn(message: string, fields?: LogFields): void;
+    error(message: string, fields?: LogFields): void;
+    child(bindings: LogFields): Logger;
+}
+export declare function parseLogLevel(value: string | undefined, fallback?: LogLevel): LogLevel;
+export interface CreateLoggerOptions {
+    level?: LogLevel;
+    file?: string | null;
+    bindings?: LogFields;
+}
+export declare function createLogger(options?: CreateLoggerOptions): Logger;
+export declare function defaultLogFile(): string;
+export declare function stateDirectory(): string;

package/dist/util/logger.js

@@ -0,0 +1,129 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const LEVELS = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+    silent: 100,
+};
+const MAX_LOG_BYTES = 5 * 1024 * 1024;
+export function parseLogLevel(value, fallback = "info") {
+    if (!value)
+        return fallback;
+    const normalized = value.trim().toLowerCase();
+    if (normalized in LEVELS)
+        return normalized;
+    return fallback;
+}
+const SENSITIVE_KEY_PATTERN = /(pass(word|phrase)?|secret|token|authorization|api[-_]?key|credential|private[-_]?key)/i;
+/** Never let credentials reach stderr or the log file, even by accident. */
+function redactValue(key, value) {
+    if (SENSITIVE_KEY_PATTERN.test(key))
+        return "[redacted]";
+    return value;
+}
+function formatFields(fields) {
+    if (!fields || Object.keys(fields).length === 0)
+        return "";
+    const parts = [];
+    for (const [key, rawValue] of Object.entries(fields)) {
+        if (rawValue === undefined)
+            continue;
+        const value = redactValue(key, rawValue);
+        let rendered;
+        if (typeof value === "string")
+            rendered = value;
+        else {
+            try {
+                rendered = JSON.stringify(value);
+            }
+            catch {
+                rendered = String(value);
+            }
+        }
+        if (rendered.length > 2000)
+            rendered = `${rendered.slice(0, 2000)}…`;
+        parts.push(`${key}=${rendered}`);
+    }
+    return parts.length > 0 ? ` ${parts.join(" ")}` : "";
+}
+class StderrLogger {
+    level;
+    bindings;
+    file;
+    constructor(level, bindings = {}, file = null) {
+        this.level = level;
+        this.bindings = bindings;
+        this.file = file;
+    }
+    child(bindings) {
+        return new StderrLogger(this.level, { ...this.bindings, ...bindings }, this.file);
+    }
+    write(level, message, fields) {
+        if (LEVELS[level] < LEVELS[this.level])
+            return;
+        const timestamp = new Date().toISOString();
+        const line = `[${timestamp}] [${level.toUpperCase()}] ${message}${formatFields({
+            ...this.bindings,
+            ...fields,
+        })}\n`;
+        try {
+            process.stderr.write(line);
+        }
+        catch {
+            // stderr can be closed during shutdown; ignore.
+        }
+        if (this.file)
+            this.writeFile(line);
+    }
+    writeFile(line) {
+        const file = this.file;
+        if (!file)
+            return;
+        try {
+            fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
+            try {
+                const stat = fs.statSync(file);
+                if (stat.size > MAX_LOG_BYTES) {
+                    fs.renameSync(file, `${file}.1`);
+                }
+            }
+            catch {
+                // file does not exist yet
+            }
+            // 0o600 on creation: logs contain workspace paths and agent output.
+            fs.appendFileSync(file, line, { mode: 0o600 });
+        }
+        catch {
+            // logging must never break the bridge
+        }
+    }
+    debug(message, fields) {
+        this.write("debug", message, fields);
+    }
+    info(message, fields) {
+        this.write("info", message, fields);
+    }
+    warn(message, fields) {
+        this.write("warn", message, fields);
+    }
+    error(message, fields) {
+        this.write("error", message, fields);
+    }
+}
+export function createLogger(options = {}) {
+    const level = options.level ?? parseLogLevel(process.env.CLAUDE_OPENCODE_LOG, "info");
+    return new StderrLogger(level, options.bindings ?? {}, options.file ?? null);
+}
+export function defaultLogFile() {
+    return path.join(stateDirectory(), "bridge.log");
+}
+export function stateDirectory() {
+    const override = process.env.CLAUDE_OPENCODE_STATE_DIR;
+    if (override?.trim())
+        return path.resolve(override);
+    return path.join(os.homedir(), ".local", "state", "claude-opencode-mcp");
+}
+//# sourceMappingURL=logger.js.map

package/dist/util/logger.js.map

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

package/dist/util/text.d.ts

@@ -0,0 +1,11 @@
+import type { Finding } from "../types/index.js";
+export declare function stripAnsi(text: string): string;
+export interface TruncateResult {
+    text: string;
+    truncated: boolean;
+}
+export declare function truncate(text: string, maxChars: number): TruncateResult;
+export declare function oneLine(text: string, maxChars?: number): string;
+export declare function extractFindings(text: string, maxFindings?: number): Finding[];
+export declare function summarizeText(text: string, maxChars: number): string;
+export declare function requestId(): string;

package/dist/util/text.js

@@ -0,0 +1,126 @@
+const ESCAPE = String.fromCharCode(27);
+const ANSI_PATTERN = new RegExp(`${ESCAPE}\\[[0-9;]*[A-Za-z]`, "g");
+export function stripAnsi(text) {
+    return text.replace(ANSI_PATTERN, "");
+}
+export function truncate(text, maxChars) {
+    if (maxChars <= 0 || text.length <= maxChars) {
+        return { text, truncated: false };
+    }
+    const head = Math.max(0, maxChars - 200);
+    const tail = Math.max(0, Math.min(120, Math.floor(maxChars / 20)));
+    const omitted = text.length - head - tail;
+    const marker = `\n\n… [truncated ${omitted} characters] …\n\n`;
+    return {
+        text: `${text.slice(0, head)}${marker}${tail > 0 ? text.slice(-tail) : ""}`,
+        truncated: true,
+    };
+}
+export function oneLine(text, maxChars = 300) {
+    const collapsed = text.replace(/\s+/g, " ").trim();
+    return collapsed.length > maxChars ? `${collapsed.slice(0, maxChars)}…` : collapsed;
+}
+const FINDINGS_HEADING = /^#{1,6}\s*(findings?|issues?|bugs?|risks?|problems?)\b.*$/im;
+const ANY_HEADING = /^#{1,6}\s+(.+?)\s*$/gm;
+function sectionsFromMarkdown(text) {
+    const sections = [];
+    const matches = [...text.matchAll(ANY_HEADING)];
+    for (let index = 0; index < matches.length; index += 1) {
+        const match = matches[index];
+        if (!match)
+            continue;
+        const title = (match[1] ?? "").trim();
+        const start = (match.index ?? 0) + match[0].length;
+        const next = matches[index + 1];
+        const end = next && next.index !== undefined ? next.index : text.length;
+        sections.push({ title, body: text.slice(start, end).trim() });
+    }
+    return sections;
+}
+export function extractFindings(text, maxFindings = 50) {
+    if (!text)
+        return [];
+    const sections = sectionsFromMarkdown(text);
+    const target = sections.find((section) => /^(findings?|issues?|bugs?|risks?|problems?)\b/i.test(section.title));
+    if (!target && !FINDINGS_HEADING.test(text))
+        return [];
+    const body = target ? target.body : "";
+    const findings = [];
+    for (const rawLine of body.split("\n")) {
+        const line = rawLine.trim();
+        if (!line)
+            continue;
+        const bullet = line.match(/^[-*+]\s+(.*)$/) ?? line.match(/^\d+[.)]\s+(.*)$/);
+        if (!bullet)
+            continue;
+        const item = (bullet[1] ?? "").trim();
+        if (!item)
+            continue;
+        let severity;
+        let rest = item;
+        const explicitSeverity = rest.match(/^\[(severity:\s*)?([a-z]+)\]\s*/i);
+        if (explicitSeverity) {
+            severity = explicitSeverity[2]?.toLowerCase();
+            rest = rest.slice(explicitSeverity[0].length);
+        }
+        else {
+            const prefix = rest.match(/^(critical|high|medium|low|info|warning|error)\s*[:—-]\s*/i);
+            if (prefix) {
+                severity = prefix[1]?.toLowerCase();
+                rest = rest.slice(prefix[0].length);
+            }
+        }
+        let file;
+        let lineNumber;
+        const locationMatches = [...rest.matchAll(/\(([^()]+)\)/g)];
+        const locationMatch = locationMatches[locationMatches.length - 1];
+        if (locationMatch && locationMatch.index !== undefined) {
+            const inner = locationMatch[1] ?? "";
+            const withLine = inner.match(/^([\w@./\\-]+?):(\d+)(?::\d+)?$/);
+            if (withLine) {
+                file = withLine[1]?.trim();
+                lineNumber = Number.parseInt(withLine[2] ?? "", 10);
+            }
+            else if (/^[\w@./\\-]+\.[A-Za-z0-9]+(?::\d+)?$/.test(inner.trim())) {
+                const bare = inner.trim().match(/^([\w@./\\-]+?)(?::(\d+))?$/);
+                file = bare?.[1]?.trim();
+                lineNumber = bare?.[2] ? Number.parseInt(bare[2], 10) : undefined;
+            }
+            if (file) {
+                rest =
+                    `${rest.slice(0, locationMatch.index)}${rest.slice(locationMatch.index + locationMatch[0].length)}`.trim();
+            }
+        }
+        const separator = rest.match(/^(.+?)\s+[—–-]\s+(.+)$/);
+        let title = rest;
+        let detail;
+        if (separator) {
+            title = separator[1]?.trim() ?? rest;
+            detail = separator[2]?.trim();
+        }
+        // Only bullets that carry a severity or a location are real findings;
+        // prose bullets such as "All good elsewhere" are left to the summary.
+        if (!severity && !file)
+            continue;
+        if (!title)
+            continue;
+        findings.push({
+            ...(severity ? { severity } : {}),
+            title: title.slice(0, 500),
+            ...(detail ? { detail: detail.slice(0, 2000) } : {}),
+            ...(file ? { file } : {}),
+            ...(lineNumber !== undefined && !Number.isNaN(lineNumber) ? { line: lineNumber } : {}),
+        });
+        if (findings.length >= maxFindings)
+            break;
+    }
+    return findings;
+}
+export function summarizeText(text, maxChars) {
+    const cleaned = stripAnsi(text).trim();
+    return truncate(cleaned, maxChars).text;
+}
+export function requestId() {
+    return `req_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+//# sourceMappingURL=text.js.map

package/dist/util/text.js.map

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

package/dist/workspace/context.d.ts

@@ -0,0 +1,12 @@
+import type { ProfileCapabilities } from "../security/policy.js";
+import type { AgentWorkspace } from "../types/index.js";
+export interface TaskContextInput {
+    workspace: AgentWorkspace;
+    task: string;
+    hints: string[];
+    capabilities: ProfileCapabilities;
+    agentName: string;
+    /** Compact context is used for follow-up messages inside an existing session. */
+    compact?: boolean;
+}
+export declare function buildTaskPrompt(input: TaskContextInput): string;

package/dist/workspace/context.js

@@ -0,0 +1,67 @@
+function permissionLines(capabilities) {
+    return [
+        `- file edits: ${capabilities.canEdit ? "allowed" : "denied"}`,
+        `- shell commands: ${capabilities.canRunBash ? "allowed" : "denied"}`,
+        `- read-only agent: ${capabilities.readOnly ? "yes" : "no"}`,
+    ].join("\n");
+}
+function instructionLines(capabilities) {
+    const lines = [
+        "- Work inside the specified workspace; do not read or write outside it.",
+        "- Inspect additional files and directories whenever that helps the task.",
+        "- Do not assume relevant code exists only under the supplied path hints.",
+        "- Your final message is consumed by an orchestrating agent: be concise, factual and specific.",
+    ];
+    if (!capabilities.canEdit) {
+        lines.push("- You are read-only: do not modify any file, even through shell commands.");
+    }
+    else {
+        lines.push("- Keep changes minimal and focused; run the relevant tests or checks when possible.");
+        lines.push("- Never run `git commit`, `git push`, or any other git command that rewrites history.");
+    }
+    if (capabilities.canRunBash && !capabilities.canEdit) {
+        lines.push("- Only run commands needed for inspection, building or testing; never write files.");
+    }
+    return lines.join("\n");
+}
+export function buildTaskPrompt(input) {
+    const { workspace, task, hints, capabilities, agentName } = input;
+    const hintLines = hints.length > 0
+        ? hints.map((hint) => `- ${hint}`).join("\n")
+        : "- none supplied; discover the relevant files yourself";
+    if (input.compact) {
+        return [
+            `Workspace: ${workspace.cwd}`,
+            workspace.gitRoot ? `Git root: ${workspace.gitRoot}` : null,
+            `Agent: ${agentName}`,
+            "",
+            "Task:",
+            task,
+            "",
+            "Constraints:",
+            permissionLines(capabilities),
+        ]
+            .filter((line) => line !== null)
+            .join("\n");
+    }
+    return [
+        "Workspace:",
+        workspace.cwd,
+        workspace.gitRoot ? `Git root: ${workspace.gitRoot}` : "Git root: (not a git repository)",
+        "",
+        `Agent: ${agentName}`,
+        "",
+        "Task:",
+        task,
+        "",
+        "Relevant paths (starting points only, not a boundary):",
+        hintLines,
+        "",
+        "Permissions:",
+        permissionLines(capabilities),
+        "",
+        "Instructions:",
+        instructionLines(capabilities),
+    ].join("\n");
+}
+//# sourceMappingURL=context.js.map