codeloop-mcp-server 0.1.0

package/dist/tools/visual_review.js

@@ -0,0 +1,142 @@
+import { reviewScreenshot } from "../diagnosis/vision_reviewer.js";
+import { diffAllScreenshots } from "../evidence/screenshot_diff.js";
+import { existsSync, readdirSync } from "fs";
+import { join, resolve } from "path";
+import { getArtifactsBaseDir, getRunDir, listRuns } from "../evidence/artifacts.js";
+function listPngFiles(dir) {
+    if (!existsSync(dir)) {
+        return [];
+    }
+    return readdirSync(dir).filter((f) => f.toLowerCase().endsWith(".png"));
+}
+export async function runVisualReview(input, config) {
+    const cwd = process.cwd();
+    const base = getArtifactsBaseDir(cwd);
+    let screenshotsDir;
+    let runDir;
+    if (input.screenshots_dir) {
+        screenshotsDir = resolve(cwd, input.screenshots_dir);
+    }
+    else {
+        const runId = input.run_id ?? listRuns(base)[0];
+        if (!runId) {
+            return {
+                issues: [
+                    {
+                        issue: "No screenshots available",
+                        severity: "low",
+                        confidence: 100,
+                        evidence: "Provide screenshots_dir or run_id, or run codeloop_verify to produce screenshots.",
+                        fix_hint: "Set screenshots_dir to a folder of PNGs or pass run_id from a verification run.",
+                    },
+                ],
+                visual_diff_score: 1,
+                layout_warnings: [],
+                accessibility_notes: [],
+                screenshots_taken: [],
+            };
+        }
+        runDir = getRunDir(runId, base);
+        screenshotsDir = join(runDir, "screenshots");
+    }
+    if (input.run_id && !runDir) {
+        runDir = getRunDir(input.run_id, base);
+    }
+    if (!screenshotsDir || !existsSync(screenshotsDir)) {
+        return {
+            issues: [
+                {
+                    issue: "Screenshots directory not found",
+                    severity: "low",
+                    confidence: 100,
+                    evidence: screenshotsDir ?? "(unset)",
+                    fix_hint: "Verify screenshots_dir or run_id points to an existing run with a screenshots folder.",
+                },
+            ],
+            visual_diff_score: 1,
+            layout_warnings: [],
+            accessibility_notes: [],
+            screenshots_taken: [],
+        };
+    }
+    const pngs = listPngFiles(screenshotsDir);
+    const screenshotsTaken = pngs.map((f) => join(screenshotsDir, f));
+    if (pngs.length === 0) {
+        return {
+            issues: [
+                {
+                    issue: "No PNG screenshots found",
+                    severity: "low",
+                    confidence: 100,
+                    evidence: screenshotsDir,
+                    fix_hint: "Add PNG screenshots to this directory or run verification to capture UI.",
+                },
+            ],
+            visual_diff_score: 1,
+            layout_warnings: [],
+            accessibility_notes: [],
+            screenshots_taken: [],
+        };
+    }
+    const issues = [];
+    const layoutWarnings = [];
+    let visualDiffScore = 1;
+    const baselineDir = input.baseline_dir
+        ? resolve(cwd, input.baseline_dir)
+        : runDir
+            ? join(runDir, "baselines")
+            : undefined;
+    if (baselineDir && existsSync(baselineDir)) {
+        const diffsDir = runDir
+            ? join(runDir, "diffs")
+            : join(screenshotsDir, "..", "diffs");
+        const summary = diffAllScreenshots(screenshotsDir, baselineDir, diffsDir);
+        const withBaseline = summary.results.filter((r) => r.baselineExists);
+        if (withBaseline.length > 0) {
+            const avgMatch = withBaseline.reduce((acc, r) => acc + (1 - r.diffScore), 0) /
+                withBaseline.length;
+            visualDiffScore = Math.max(0, Math.min(1, avgMatch));
+        }
+        for (const screen of summary.screensAboveThreshold) {
+            layoutWarnings.push(`Pixel diff above threshold for screen "${screen}"`);
+            const dr = summary.results.find((x) => x.screen === screen);
+            const diffScore = dr?.diffScore ?? 0;
+            issues.push({
+                issue: `Visual regression detected for "${screen}"`,
+                severity: "medium",
+                confidence: Math.round(Math.max(0, Math.min(100, (1 - diffScore) * 100))),
+                evidence: "Screenshot differs from baseline (pixel diff). See diffs output.",
+                fix_hint: "Review the diff image or update the baseline if the change is intentional.",
+            });
+        }
+    }
+    const uxPath = input.ux_checklist_path
+        ? resolve(cwd, input.ux_checklist_path)
+        : undefined;
+    let skipExtraVision = false;
+    for (const abs of screenshotsTaken) {
+        if (skipExtraVision) {
+            break;
+        }
+        const more = await reviewScreenshot({
+            imagePath: abs,
+            uxChecklistPath: uxPath,
+        }, config);
+        if (more.length === 1 &&
+            more[0].issue === "No vision model configured") {
+            issues.push(...more);
+            skipExtraVision = true;
+            continue;
+        }
+        issues.push(...more);
+    }
+    const accessibilityNotes = [];
+    return {
+        issues,
+        visual_diff_score: visualDiffScore,
+        layout_warnings: layoutWarnings,
+        accessibility_notes: accessibilityNotes,
+        screenshots_taken: screenshotsTaken,
+    };
+}
+//# sourceMappingURL=visual_review.js.map

package/dist/tools/visual_review.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "codeloop-mcp-server",
+  "version": "0.1.0",
+  "description": "CodeLoop MCP server - verification, self-repair, and recommendation layer for AI coding agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "codeloop-mcp-server": "./dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "cursor",
+    "claude-code",
+    "testing",
+    "verification",
+    "ai-coding"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "tsc --noEmit && eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "@codelooptech/shared": "0.1.0",
+    "@google/generative-ai": "^0.21.0",
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "openai": "^4.77.0",
+    "pixelmatch": "^7.1.0",
+    "pngjs": "^7.0.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/pngjs": "^6.0.5",
+    "typescript": "^5.8.0",
+    "vitest": "^3.1.0"
+  }
+}