@shareworker/code-review-mcp 0.1.0

package/dist/git.js

@@ -0,0 +1,111 @@
+import simpleGit from "simple-git";
+/**
+ * Open a simple-git instance for a repo path.
+ * Falls back to cwd when repo is empty.
+ */
+export function openRepo(repo) {
+    return simpleGit(repo || process.cwd());
+}
+/**
+ * Get the unified diff text for a ref.
+ * `ref` may be a range like "main..feature" or a single ref like "HEAD".
+ */
+export async function getDiff(repo, ref) {
+    const git = openRepo(repo);
+    return git.diff([ref]);
+}
+/**
+ * Get the unified diff text for a single file at a ref.
+ * Uses `git diff <ref> -- <path>` to scope to one file.
+ */
+export async function getDiffForFile(repo, ref, path) {
+    const git = openRepo(repo);
+    return git.diff([ref, "--", path]);
+}
+/**
+ * Get file-level diff metadata (insertions/deletions/binary) for a ref.
+ */
+export async function getDiffSummary(repo, ref) {
+    const git = openRepo(repo);
+    const summary = await git.diffSummary([ref]);
+    return summary.files.map((f) => ({
+        file: f.file,
+        insertions: "insertions" in f ? f.insertions : 0,
+        deletions: "deletions" in f ? f.deletions : 0,
+        binary: f.binary,
+    }));
+}
+/**
+ * Get the content of a file at a given ref (e.g. "HEAD", "main").
+ * For untracked files, pass ref="WORKTREE" to read from the working directory.
+ */
+export async function getFileContent(repo, ref, path) {
+    if (ref === "WORKTREE") {
+        const fs = await import("node:fs/promises");
+        const nodePath = await import("node:path");
+        const abs = nodePath.isAbsolute(path)
+            ? path
+            : nodePath.join(repo || process.cwd(), path);
+        return fs.readFile(abs, "utf8");
+    }
+    const git = openRepo(repo);
+    return git.show([`${ref}:${path}`]);
+}
+/**
+ * Get porcelain status for untracked file detection.
+ * Returns entries with status "untracked" for files git doesn't track.
+ */
+export async function getStatus(repo) {
+    const git = openRepo(repo);
+    const status = await git.status();
+    const entries = [];
+    for (const f of status.files) {
+        // status.files entries have `path` and `index`/`working_dir` status codes.
+        // Untracked files have working_dir == "?".
+        const isUntracked = f.working_dir === "?" || f.index === "?";
+        entries.push({
+            path: f.path,
+            status: isUntracked ? "untracked" : "modified",
+        });
+    }
+    return entries;
+}
+/**
+ * List untracked files (not yet `git add`-ed).
+ */
+export async function getUntrackedFiles(repo) {
+    const git = openRepo(repo);
+    const status = await git.status();
+    return status.not_added;
+}
+/**
+ * Synthesize a full-file-add diff for an untracked file,
+ * equivalent to `git diff --no-index /dev/null <file>`.
+ * Reads the file content and wraps it in a unified diff with all lines added.
+ */
+export async function synthesizeUntrackedDiff(repo, path) {
+    let content;
+    try {
+        content = await getFileContent(repo, "WORKTREE", path);
+    }
+    catch {
+        // File unreadable: return empty diff.
+        return "";
+    }
+    const lines = content.split("\n");
+    // Drop trailing empty line from the final newline.
+    if (lines.length > 0 && lines[lines.length - 1] === "") {
+        lines.pop();
+    }
+    const body = lines.map((l) => `+${l}`).join("\n");
+    const header = [
+        `diff --git a/${path} b/${path}`,
+        `new file mode 100644`,
+        `--- /dev/null`,
+        `+++ b/${path}`,
+        `@@ -0,0 +1,${lines.length} @@`,
+    ].join("\n");
+    const diff = lines.length > 0 ? `${header}\n${body}\n` : `${header}\n`;
+    return diff;
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,296 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { getDiff, getUntrackedFiles, synthesizeUntrackedDiff } from "./git.js";
+import { parseFileDiffs } from "./diff-parser.js";
+import { loadFilterConfig, filterFiles, isBinaryByExtension } from "./filter.js";
+import { bundleFiles } from "./bundler.js";
+import { matchRules } from "./rules.js";
+import { positionComment } from "./position.js";
+import { reflectComment } from "./reflect.js";
+/**
+ * Create and start the MCP server with 5 tools.
+ */
+async function main() {
+    const server = new Server({ name: "code-review-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
+    // --- Tool definitions ---
+    server.setRequestHandler(ListToolsRequestSchema, () => ({
+        tools: [
+            {
+                name: "get_review_targets",
+                description: "Determine which files need review from a git diff. Applies file filtering and returns a diff_ref to pass to downstream tools.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        mode: {
+                            type: "string",
+                            enum: ["workspace", "range", "commit"],
+                            description: "workspace: staged+unstaged+untracked; range: from..to; commit: commit^..commit",
+                        },
+                        from: { type: "string", description: "Required when mode=range" },
+                        to: { type: "string", description: "Required when mode=range" },
+                        commit: { type: "string", description: "Required when mode=commit" },
+                        repo: { type: "string", description: "Repo path, default: cwd" },
+                    },
+                    required: ["mode"],
+                },
+            },
+            {
+                name: "get_file_bundle",
+                description: "Group related files into review bundles (test/source pairs, i18n variants) with a 20000 char cap. Pass the diff_ref from get_review_targets.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        files: {
+                            type: "array",
+                            items: { type: "string" },
+                            description: "File paths from get_review_targets",
+                        },
+                        diff_ref: { type: "string", description: "Default HEAD; pass the diff_ref from get_review_targets" },
+                        repo: { type: "string", description: "Repo path, default: cwd" },
+                    },
+                    required: ["files"],
+                },
+            },
+            {
+                name: "match_rules",
+                description: "Return applicable review rules for a file path, merged into a prompt_section for the host LLM.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        path: { type: "string", description: "File path to match rules against" },
+                        repo: { type: "string", description: "Repo path, default: cwd" },
+                    },
+                    required: ["path"],
+                },
+            },
+            {
+                name: "position_comment",
+                description: "Locate a comment to precise line numbers. Text matching primary (hunk new-side → old-side → full file), hunk alignment fallback. Pass diff_ref from get_review_targets.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        path: { type: "string" },
+                        content: { type: "string", description: "Comment text" },
+                        existing_code: { type: "string", description: "Code snippet the comment references" },
+                        suggestion_code: { type: "string", description: "Suggested fix code" },
+                        hint_line: { type: "number", description: "Rough line number from host LLM" },
+                        diff_ref: { type: "string", description: "Default HEAD; pass from get_review_targets" },
+                        repo: { type: "string", description: "Repo path, default: cwd" },
+                    },
+                    required: ["path", "content"],
+                },
+            },
+            {
+                name: "reflect_comment",
+                description: "Deterministic validation of a positioned comment. Returns keep or drop. Does not call LLM. Three checks: line_in_hunk, existing_code_found, existing_code_in_diff.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        path: { type: "string" },
+                        content: { type: "string" },
+                        start_line: { type: "number", description: "From position_comment" },
+                        end_line: { type: "number", description: "From position_comment" },
+                        existing_code: { type: "string", description: "Code snippet the comment references" },
+                        diff_ref: { type: "string", description: "Default HEAD; pass from get_review_targets" },
+                        repo: { type: "string", description: "Repo path, default: cwd" },
+                    },
+                    required: ["path", "content", "start_line", "end_line"],
+                },
+            },
+        ],
+    }));
+    // --- Tool handlers ---
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const repo = args?.repo || process.cwd();
+        try {
+            switch (name) {
+                case "get_review_targets":
+                    return await handleGetReviewTargets(args, repo);
+                case "get_file_bundle":
+                    return await handleGetFileBundle(args, repo);
+                case "match_rules":
+                    return await handleMatchRules(args, repo);
+                case "position_comment":
+                    return await handlePositionComment(args, repo);
+                case "reflect_comment":
+                    return await handleReflectComment(args, repo);
+                default:
+                    return {
+                        content: [{ type: "text", text: `Unknown tool: ${name}` }],
+                        isError: true,
+                    };
+            }
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err?.message ?? err}` }],
+                isError: true,
+            };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+// --- Handler implementations ---
+async function handleGetReviewTargets(args, repo) {
+    const mode = args?.mode;
+    let diffRef;
+    let diffText;
+    if (mode === "workspace") {
+        diffRef = "HEAD";
+        diffText = await getDiff(repo, "HEAD");
+        // Add untracked files as synthesized full-file-add diffs.
+        const untracked = await getUntrackedFiles(repo);
+        for (const file of untracked) {
+            if (isBinaryByExtension(file))
+                continue;
+            const synth = await synthesizeUntrackedDiff(repo, file);
+            if (synth)
+                diffText += "\n" + synth;
+        }
+    }
+    else if (mode === "range") {
+        const from = args?.from;
+        const to = args?.to;
+        if (!from || !to)
+            throw new Error("mode=range requires 'from' and 'to'");
+        diffRef = `${from}..${to}`;
+        diffText = await getDiff(repo, diffRef);
+    }
+    else if (mode === "commit") {
+        const commit = args?.commit;
+        if (!commit)
+            throw new Error("mode=commit requires 'commit'");
+        diffRef = `${commit}^..${commit}`;
+        diffText = await getDiff(repo, diffRef);
+    }
+    else {
+        throw new Error(`Invalid mode: ${mode}. Use workspace, range, or commit.`);
+    }
+    // Parse diffs to get file list.
+    const fileDiffs = parseFileDiffs(diffText);
+    const allPaths = fileDiffs
+        .map((d) => d.newPath || d.oldPath)
+        .filter((p) => p && !p.includes("/dev/null"));
+    // Apply filtering.
+    const filterConfig = await loadFilterConfig(repo);
+    const { kept, filtered } = filterFiles(allPaths, filterConfig);
+    // Build result with per-file diff.
+    const files = kept.map((path) => {
+        const fd = fileDiffs.find((d) => (d.newPath || d.oldPath) === path);
+        const status = fd?.isNew ? "added" : fd?.isDeleted ? "deleted" : fd?.isRenamed ? "renamed" : "modified";
+        return {
+            path,
+            diff: fd?.diff ?? "",
+            additions: fd?.insertions ?? 0,
+            deletions: fd?.deletions ?? 0,
+            status,
+        };
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    diff_ref: diffRef,
+                    files,
+                    total_files: files.length,
+                    filtered_out: filtered,
+                }),
+            },
+        ],
+    };
+}
+async function handleGetFileBundle(args, repo) {
+    const files = args?.files ?? [];
+    const diffRef = args?.diff_ref ?? "HEAD";
+    const bundles = await bundleFiles(repo, files, diffRef);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    bundles: bundles.map((b) => ({
+                        id: b.id,
+                        files: b.files,
+                        total_chars: b.totalChars,
+                        bundle_reason: b.bundleReason,
+                    })),
+                    total_bundles: bundles.length,
+                }),
+            },
+        ],
+    };
+}
+async function handleMatchRules(args, repo) {
+    const path = args?.path;
+    const result = await matchRules(repo, path);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    path: result.path,
+                    matched_rules: result.matchedRules,
+                    prompt_section: result.promptSection,
+                    used_default: result.usedDefault,
+                }),
+            },
+        ],
+    };
+}
+async function handlePositionComment(args, repo) {
+    const result = await positionComment(repo, {
+        path: args?.path,
+        content: args?.content,
+        existingCode: args?.existing_code,
+        suggestionCode: args?.suggestion_code,
+        hintLine: args?.hint_line,
+        diffRef: args?.diff_ref,
+        repo,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    path: result.path,
+                    start_line: result.startLine,
+                    end_line: result.endLine,
+                    located_by: result.locatedBy,
+                }),
+            },
+        ],
+    };
+}
+async function handleReflectComment(args, repo) {
+    const result = await reflectComment(repo, {
+        path: args?.path,
+        content: args?.content,
+        startLine: args?.start_line,
+        endLine: args?.end_line,
+        existingCode: args?.existing_code,
+        diffRef: args?.diff_ref,
+        repo,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    verdict: result.verdict,
+                    reason: result.reason,
+                    checks: result.checks,
+                }),
+            },
+        ],
+    };
+}
+main().catch((err) => {
+    console.error("Fatal error starting server:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/position.d.ts

@@ -0,0 +1,14 @@
+import type { PositionInput, PositionResult } from "./types.js";
+/**
+ * Locate a comment to precise line numbers in the target file.
+ *
+ * Strategy (modeled after open-code-review's resolver.go):
+ * 1. Text matching (primary): extract code lines from existing_code/suggestion_code,
+ *    normalize, search for consecutive matches. Try hunk new-side first, then
+ *    old-side, then full file content.
+ * 2. Hunk alignment (fallback): if no code snippet but hint_line is provided,
+ *    use hunk line-number mapping to align.
+ * 3. Fallback: return 0, 0, "failed".
+ */
+export declare function positionComment(repo: string, input: PositionInput): Promise<PositionResult>;
+//# sourceMappingURL=position.d.ts.map

package/dist/position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../src/position.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAQ,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,cAAc,CAAC,CAqBzB"}

package/dist/position.js

@@ -0,0 +1,179 @@
+import { getDiffForFile, getFileContent } from "./git.js";
+import { parseFileDiffs, parseHunks, extractSideLines, matchConsecutive, splitAndNormalize, normalizeLine } from "./diff-parser.js";
+/**
+ * Locate a comment to precise line numbers in the target file.
+ *
+ * Strategy (modeled after open-code-review's resolver.go):
+ * 1. Text matching (primary): extract code lines from existing_code/suggestion_code,
+ *    normalize, search for consecutive matches. Try hunk new-side first, then
+ *    old-side, then full file content.
+ * 2. Hunk alignment (fallback): if no code snippet but hint_line is provided,
+ *    use hunk line-number mapping to align.
+ * 3. Fallback: return 0, 0, "failed".
+ */
+export async function positionComment(repo, input) {
+    const path = input.path.replace(/\\/g, "/");
+    const diffRef = input.diffRef ?? "HEAD";
+    // Gather code lines from existing_code or suggestion_code.
+    const codeSource = input.existingCode || input.suggestionCode || "";
+    const targetLines = splitAndNormalize(codeSource);
+    // If we have code lines, try text matching.
+    if (targetLines.length > 0) {
+        const result = await tryTextMatch(repo, path, diffRef, targetLines);
+        if (result)
+            return result;
+    }
+    // Fallback: hunk alignment with hint_line.
+    if (input.hintLine && input.hintLine > 0) {
+        const result = await tryHunkAlign(repo, path, diffRef, input.hintLine);
+        if (result)
+            return result;
+    }
+    return { path, startLine: 0, endLine: 0, locatedBy: "failed" };
+}
+/**
+ * Try text matching: hunk new-side → old-side → full file content.
+ */
+async function tryTextMatch(repo, path, diffRef, targetLines) {
+    let diffText;
+    try {
+        diffText = await getDiffForFile(repo, diffRef, path);
+    }
+    catch {
+        return null;
+    }
+    if (!diffText)
+        return null;
+    const fileDiffs = parseFileDiffs(diffText);
+    const fileDiff = fileDiffs[0];
+    if (!fileDiff)
+        return null;
+    // Try hunk new-side first (context + added → new-file line numbers).
+    for (const hunk of fileDiff.hunks) {
+        const newSide = extractSideLines(hunk, true);
+        const match = matchConsecutive(newSide, targetLines);
+        if (match) {
+            return { path, startLine: match.start, endLine: match.end, locatedBy: "text_match" };
+        }
+    }
+    // Try hunk old-side (context + deleted → old-file line numbers).
+    for (const hunk of fileDiff.hunks) {
+        const oldSide = extractSideLines(hunk, false);
+        const match = matchConsecutive(oldSide, targetLines);
+        if (match) {
+            return { path, startLine: match.start, endLine: match.end, locatedBy: "text_match" };
+        }
+    }
+    // Fallback: scan full file content.
+    const fileContent = await tryGetFileContent(repo, diffRef, path);
+    if (fileContent) {
+        const match = matchInFileContent(fileContent, targetLines);
+        if (match) {
+            return { path, startLine: match.start, endLine: match.end, locatedBy: "text_match" };
+        }
+    }
+    return null;
+}
+/**
+ * Try to get file content at a ref. Returns null on failure or empty result.
+ * Note: `git show <range>:<path>` returns empty string for range refs, so
+ * we treat empty as "not found" and fall back to worktree.
+ */
+async function tryGetFileContent(repo, ref, path) {
+    try {
+        const content = await getFileContent(repo, ref, path);
+        if (content && content.length > 0)
+            return content;
+    }
+    catch {
+        // fall through to worktree
+    }
+    try {
+        const content = await getFileContent(repo, "WORKTREE", path);
+        if (content && content.length > 0)
+            return content;
+    }
+    catch {
+        // fall through
+    }
+    return null;
+}
+/**
+ * Scan file content line-by-line for consecutive matches of normalized target lines.
+ * Blank lines are skipped so they don't break the sliding-window match.
+ * Mirrors open-code-review's resolveFromFileContent.
+ */
+function matchInFileContent(fileContent, targetLines) {
+    const fileLines = fileContent.split("\n");
+    const normalizedLines = [];
+    const lineNums = [];
+    for (let i = 0; i < fileLines.length; i++) {
+        const n = normalizeLine(fileLines[i]);
+        if (n === "")
+            continue;
+        normalizedLines.push(n);
+        lineNums.push(i + 1);
+    }
+    if (normalizedLines.length < targetLines.length)
+        return null;
+    for (let i = 0; i <= normalizedLines.length - targetLines.length; i++) {
+        let matched = true;
+        for (let j = 0; j < targetLines.length; j++) {
+            if (normalizedLines[i + j] !== targetLines[j]) {
+                matched = false;
+                break;
+            }
+        }
+        if (matched) {
+            return { start: lineNums[i], end: lineNums[i + targetLines.length - 1] };
+        }
+    }
+    return null;
+}
+/**
+ * Try hunk alignment: map hint_line to the closest hunk's line range.
+ * If hint_line falls within a hunk's new-side range, return it.
+ */
+async function tryHunkAlign(repo, path, diffRef, hintLine) {
+    let diffText;
+    try {
+        diffText = await getDiffForFile(repo, diffRef, path);
+    }
+    catch {
+        return null;
+    }
+    if (!diffText)
+        return null;
+    const hunks = parseHunks(diffText);
+    if (hunks.length === 0)
+        return null;
+    // Find the hunk whose new-side range contains hint_line.
+    for (const hunk of hunks) {
+        const newEnd = hunk.newStart + hunk.newCount - 1;
+        if (hintLine >= hunk.newStart && hintLine <= newEnd) {
+            return { path, startLine: hintLine, endLine: hintLine, locatedBy: "hunk_align" };
+        }
+    }
+    // If hint_line is before the first hunk, clamp to the first hunk's new start.
+    if (hintLine < hunks[0].newStart) {
+        return { path, startLine: hunks[0].newStart, endLine: hunks[0].newStart, locatedBy: "hunk_align" };
+    }
+    // If after the last hunk, clamp to the last hunk's new end.
+    const last = hunks[hunks.length - 1];
+    const lastEnd = last.newStart + last.newCount - 1;
+    if (hintLine > lastEnd) {
+        return { path, startLine: lastEnd, endLine: lastEnd, locatedBy: "hunk_align" };
+    }
+    // Between hunks — pick the closest.
+    let closest = hunks[0];
+    let minDist = Math.abs(hintLine - closest.newStart);
+    for (const hunk of hunks) {
+        const dist = Math.abs(hintLine - hunk.newStart);
+        if (dist < minDist) {
+            minDist = dist;
+            closest = hunk;
+        }
+    }
+    return { path, startLine: closest.newStart, endLine: closest.newStart, locatedBy: "hunk_align" };
+}
+//# sourceMappingURL=position.js.map

package/dist/position.js.map

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

package/dist/reflect.d.ts

@@ -0,0 +1,17 @@
+import type { ReflectInput, ReflectResult } from "./types.js";
+/**
+ * Deterministic validation of a positioned comment.
+ * Returns keep or drop. Does not call LLM.
+ *
+ * Three checks:
+ * 1. line_in_hunk: Are start_line/end_line within the diff hunk's changed line range?
+ * 2. existing_code_found: Does the existing_code snippet actually exist in the file?
+ *    (not applicable when existing_code is empty/undefined — passes by default)
+ * 3. existing_code_in_diff: Is at least one line of existing_code within the diff's changed lines?
+ *    (not applicable when existing_code is empty/undefined — passes by default)
+ *
+ * Verdict: any check fails → drop; all pass → keep.
+ * Semantic-level reflection is the host LLM's responsibility.
+ */
+export declare function reflectComment(repo: string, input: ReflectInput): Promise<ReflectResult>;
+//# sourceMappingURL=reflect.d.ts.map