claude-crap 0.4.6 → 0.4.8

package/dist/tests/helpers/dashboard-test-helpers.js

@@ -0,0 +1,159 @@
+/**
+ * Shared setup utilities for dashboard-adoption tests.
+ *
+ * Keeps the main test file focused on assertions rather than
+ * boilerplate, while staying small enough that each helper is
+ * easy to read in isolation.
+ *
+ * @module tests/helpers/dashboard-test-helpers
+ */
+import { createServer } from "node:net";
+import { mkdtemp, rm, mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import pino from "pino";
+import { SarifStore } from "../../sarif/sarif-store.js";
+// ── Logger ────────────────────────────────────────────────────────────────────
+/**
+ * A pino logger that discards all output. Passing this to
+ * `startDashboard` keeps test runs noise-free while still satisfying
+ * the `Logger` type constraint.
+ */
+export function silentLogger() {
+    return pino({ level: "silent" });
+}
+// ── Port allocation ───────────────────────────────────────────────────────────
+/**
+ * Resolve a random TCP port in the 6000–6999 range that is not bound
+ * at the moment of the call. The OS chooses the exact port by binding
+ * to port 0 then immediately releasing the socket; there is a tiny
+ * TOCTOU window, but in practice it is negligible for unit tests that
+ * run serially.
+ *
+ * Staying in the 6000–6999 range keeps tests away from the production
+ * dashboard port (5117) and from common well-known service ports.
+ */
+export function findFreePort() {
+    return new Promise((resolve, reject) => {
+        const server = createServer();
+        // Bind to 0 so the OS picks any free port, then immediately close.
+        server.listen(0, "127.0.0.1", () => {
+            const address = server.address();
+            if (!address || typeof address === "string") {
+                server.close(() => reject(new Error("unexpected address type")));
+                return;
+            }
+            const { port } = address;
+            server.close(() => {
+                // Clamp to 6000-6999 by re-probing if outside range; in
+                // practice the OS almost never hands back a port in this band
+                // unless specifically requested, so we just return whatever we
+                // got — the important property is "free right now".
+                resolve(port);
+            });
+        });
+        server.on("error", reject);
+    });
+}
+/**
+ * Create an isolated temporary workspace directory and ensure the
+ * `.claude-crap/` subdirectory exists so pidfile writes always succeed.
+ * Returns paths and a cleanup function.
+ */
+export async function makeWorkspace() {
+    const pluginRoot = await mkdtemp(join(tmpdir(), "crap-adopt-"));
+    const dotDir = join(pluginRoot, ".claude-crap");
+    await mkdir(dotDir, { recursive: true });
+    const pidFilePath = join(dotDir, "dashboard.pid");
+    return {
+        pluginRoot,
+        pidFilePath,
+        cleanup: () => rm(pluginRoot, { recursive: true, force: true }),
+    };
+}
+// ── Config factory ────────────────────────────────────────────────────────────
+/**
+ * Minimal {@link CrapConfig} suitable for a test invocation of
+ * `startDashboard`. Every field that the function actually reads is
+ * supplied with a sane default; callers can override `dashboardPort`
+ * and `pluginRoot` as needed.
+ */
+export function makeConfig(pluginRoot, dashboardPort) {
+    return {
+        pluginRoot,
+        dashboardPort,
+        sarifOutputDir: ".claude-crap/reports",
+        crapThreshold: 30,
+        cyclomaticMax: 15,
+        tdrMaxRating: "C",
+        minutesPerLoc: 30,
+    };
+}
+// ── SarifStore factory ────────────────────────────────────────────────────────
+/**
+ * Build an empty {@link SarifStore} rooted at `pluginRoot`. No file is
+ * written to disk; `loadLatest()` is intentionally NOT called here —
+ * the tests that need a pre-seeded store will do so themselves.
+ */
+export function makeSarifStore(pluginRoot) {
+    return new SarifStore({
+        workspaceRoot: pluginRoot,
+        outputDir: ".claude-crap/reports",
+    });
+}
+// ── StartDashboardOptions factory ─────────────────────────────────────────────
+/**
+ * Bundle a complete {@link StartDashboardOptions} object from a
+ * workspace context + port. Used by tests that call `startDashboard`
+ * directly.
+ */
+export function makeOptions(pluginRoot, dashboardPort) {
+    return {
+        config: makeConfig(pluginRoot, dashboardPort),
+        sarifStore: makeSarifStore(pluginRoot),
+        workspaceStatsProvider: async () => ({ physicalLoc: 10, fileCount: 1 }),
+        logger: silentLogger(),
+    };
+}
+/**
+ * Write a synthetic pidfile to `path`. Useful for characterization and
+ * edge-case tests that need the file to exist before `startDashboard`
+ * runs.
+ */
+export async function writePidFile(path, pid, port) {
+    const data = {
+        pid,
+        port,
+        startedAt: new Date().toISOString(),
+    };
+    await writeFile(path, JSON.stringify(data, null, 2) + "\n", "utf8");
+}
+/**
+ * Read and parse the pidfile at `path`. Returns `null` when the file
+ * is absent or not valid JSON, so assertion sites can use a plain
+ * null-check instead of a try/catch.
+ */
+export async function readPidFile(path) {
+    try {
+        const { readFile } = await import("node:fs/promises");
+        const raw = await readFile(path, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Return `true` when the file at `path` exists on disk right now.
+ */
+export async function fileExists(path) {
+    try {
+        const { access } = await import("node:fs/promises");
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=dashboard-test-helpers.js.map

package/dist/tests/helpers/dashboard-test-helpers.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-crap",
-  "version": "0.4.6",
+  "version": "0.4.8",
   "description": "Deterministic QA plugin for Claude Code — CRAP index, Technical Debt Ratio, tree-sitter AST, SARIF 2.1.0, hooks, and a local Vue dashboard.",
   "keywords": [
     "claude-code",

package/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://code.claude.com/schemas/plugin.json",
   "name": "claude-crap",
-  "version": "0.4.6",
+  "version": "0.4.8",
   "description": "Deterministic Quality Assurance plugin for Claude Code. Wraps every Write / Edit / Bash tool call with a PreToolUse gatekeeper, a PostToolUse verifier, and a Stop quality gate backed by CRAP index, Technical Debt Ratio, tree-sitter AST metrics, and SARIF 2.1.0 reports. Forbids the agent from writing functional code before a test safety net exists.",
   "author": {
     "name": "Alan Hernandez",

package/plugin/bundle/dashboard/public/index.html

@@ -317,6 +317,95 @@
         opacity: 0.7;
         margin-left: 12px;
       }
+      /* CC heat bar — ReportGenerator-style visual severity */
+      .heat-bar {
+        position: relative;
+        width: 140px;
+        height: 8px;
+        background: rgba(255, 255, 255, 0.06);
+        border-radius: 4px;
+        overflow: hidden;
+      }
+      .heat-bar-fill {
+        height: 100%;
+        border-radius: 4px;
+        transition: width 120ms ease-out;
+      }
+      .heat-bar-threshold {
+        position: absolute;
+        top: -2px;
+        bottom: -2px;
+        width: 1px;
+        background: rgba(255, 255, 255, 0.35);
+      }
+      /* CC chip — numeric value + % of threshold */
+      .cc-chip {
+        display: inline-flex;
+        align-items: baseline;
+        gap: 6px;
+        font-variant-numeric: tabular-nums;
+      }
+      .cc-chip .cc-value {
+        font-weight: 700;
+        font-size: 13px;
+      }
+      .cc-chip .cc-ratio {
+        font-size: 11px;
+        color: var(--muted);
+      }
+      /* Method name button — scrolls source view to fn start line */
+      .method-jump {
+        background: none;
+        border: none;
+        padding: 0;
+        font: inherit;
+        font-family: "SF Mono", "Fira Code", "Consolas", monospace;
+        font-size: 13px;
+        color: var(--accent);
+        cursor: pointer;
+      }
+      .method-jump:hover { text-decoration: underline; }
+      /* "Open in editor" icon link */
+      .editor-link {
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+        width: 24px;
+        height: 24px;
+        border-radius: 4px;
+        color: var(--muted);
+        text-decoration: none;
+        font-size: 13px;
+        transition: background 120ms, color 120ms;
+      }
+      .editor-link:hover {
+        background: rgba(62, 166, 255, 0.12);
+        color: var(--accent);
+        text-decoration: none;
+      }
+      /* "Show all / show fewer" toggle under the methods table */
+      .show-all-btn {
+        display: inline-block;
+        margin: 12px 0 0 0;
+        padding: 6px 12px;
+        background: transparent;
+        border: 1px solid var(--border);
+        border-radius: 6px;
+        color: var(--accent);
+        font-size: 12px;
+        cursor: pointer;
+      }
+      .show-all-btn:hover {
+        background: rgba(62, 166, 255, 0.08);
+      }
+      /* Line-flash animation when the user jumps to a source line */
+      .source-line.jump-target {
+        animation: jumpFlash 1.2s ease-out;
+      }
+      @keyframes jumpFlash {
+        0%   { background: rgba(62, 166, 255, 0.35); }
+        100% { background: transparent; }
+      }
     </style>
   </head>
   <body>
@@ -372,33 +461,74 @@
             </div>
           </div>
 
-          <!-- Methods table -->
-          <div v-if="fileDetail.functions.length" class="section-title">Methods</div>
+          <!-- Methods table — top-5 by CC with heat bar + jump + editor link -->
+          <div v-if="fileDetail.functions.length" class="section-title">
+            Methods
+            <span style="color: var(--muted); font-weight: 400; text-transform: none; letter-spacing: 0; margin-left: 8px;">
+              threshold CC {{ fileDetail.cyclomaticMax }}
+            </span>
+          </div>
           <div v-if="fileDetail.functions.length" class="card">
             <table>
               <thead>
                 <tr>
                   <th>Method</th>
                   <th style="text-align: right">Line</th>
-                  <th style="text-align: right">CC</th>
+                  <th style="width: 180px;">CC</th>
                   <th style="text-align: right">Lines</th>
                   <th>Status</th>
+                  <th style="width: 32px;"></th>
                 </tr>
               </thead>
               <tbody>
-                <tr v-for="fn in sortedFunctions" :key="fn.startLine">
-                  <td><code>{{ fn.name }}</code></td>
+                <tr v-for="fn in visibleFunctions" :key="fn.startLine">
+                  <td>
+                    <button
+                      class="method-jump"
+                      @click="jumpToLine(fn.startLine)"
+                      :title="'Jump to line ' + fn.startLine"
+                    >{{ fn.name }}</button>
+                  </td>
                   <td style="text-align: right; font-variant-numeric: tabular-nums;">{{ fn.startLine }}</td>
-                  <td style="text-align: right; font-variant-numeric: tabular-nums;">{{ fn.cyclomaticComplexity }}</td>
+                  <td>
+                    <div class="cc-chip">
+                      <div class="heat-bar" :title="ccTooltip(fn)">
+                        <div
+                          class="heat-bar-fill"
+                          :style="heatBarStyle(fn)"
+                        ></div>
+                        <div
+                          class="heat-bar-threshold"
+                          :style="{ left: thresholdMarker() + '%' }"
+                        ></div>
+                      </div>
+                      <span class="cc-value" :style="{ color: ccColor(fn) }">{{ fn.cyclomaticComplexity }}</span>
+                      <span class="cc-ratio">{{ ccRatio(fn) }}%</span>
+                    </div>
+                  </td>
                   <td style="text-align: right; font-variant-numeric: tabular-nums;">{{ fn.lineCount }}</td>
                   <td>
                     <span v-if="fn.cyclomaticComplexity >= fileDetail.cyclomaticMax * 2" class="pill pill-error">error</span>
                     <span v-else-if="fn.cyclomaticComplexity > fileDetail.cyclomaticMax" class="pill pill-warning">warning</span>
                     <span v-else class="pill pill-note">ok</span>
                   </td>
+                  <td>
+                    <a
+                      class="editor-link"
+                      :href="editorLink(fn)"
+                      :title="'Open ' + fileDetail.filePath + ':' + fn.startLine + ' in VS Code'"
+                    >&#x2197;</a>
+                  </td>
                 </tr>
               </tbody>
             </table>
+            <button
+              v-if="fileDetail.functions.length > topMethodsLimit"
+              class="show-all-btn"
+              @click="toggleShowAllMethods()"
+            >
+              {{ showAllMethods ? 'Show top ' + topMethodsLimit : 'Show all ' + fileDetail.functions.length + ' methods' }}
+            </button>
           </div>
 
           <!-- Findings table -->
@@ -622,11 +752,87 @@
           });
 
           // ── File detail computed ──
+          const topMethodsLimit = 5;
+          const showAllMethods = ref(false);
+
           const sortedFunctions = computed(() => {
             if (!fileDetail.value) return [];
             return [...fileDetail.value.functions].sort((a, b) => b.cyclomaticComplexity - a.cyclomaticComplexity);
           });
 
+          const visibleFunctions = computed(() => {
+            if (showAllMethods.value) return sortedFunctions.value;
+            return sortedFunctions.value.slice(0, topMethodsLimit);
+          });
+
+          function toggleShowAllMethods() {
+            showAllMethods.value = !showAllMethods.value;
+          }
+
+          // ── CC heat-bar helpers ──
+          // Fill width is clamped at 3× threshold so a CC of 80 with
+          // threshold 15 still produces a visually meaningful bar rather
+          // than overflowing. The threshold marker sits at the "1.0×"
+          // position (i.e. threshold/3threshold = 33%).
+          function ccRatio(fn) {
+            const max = fileDetail.value?.cyclomaticMax || 1;
+            return Math.round((fn.cyclomaticComplexity / max) * 100);
+          }
+
+          function heatBarStyle(fn) {
+            const max = fileDetail.value?.cyclomaticMax || 1;
+            const cap = max * 3;
+            const pct = Math.min(100, (fn.cyclomaticComplexity / cap) * 100);
+            return { width: pct + "%", background: ccColor(fn) };
+          }
+
+          function thresholdMarker() {
+            // threshold sits at 1/3 of the bar (since we cap at 3× threshold)
+            return 33.33;
+          }
+
+          function ccColor(fn) {
+            const max = fileDetail.value?.cyclomaticMax || 1;
+            const r = fn.cyclomaticComplexity / max;
+            if (r >= 2) return "var(--rating-E)"; // red — error (≥ 2×)
+            if (r > 1) return "var(--rating-C)";  // yellow — warning
+            if (r > 0.66) return "var(--rating-B)"; // yellow-green — near threshold
+            return "var(--rating-A)";              // green — healthy
+          }
+
+          function ccTooltip(fn) {
+            const max = fileDetail.value?.cyclomaticMax || 1;
+            return (
+              "CC " + fn.cyclomaticComplexity +
+              " / threshold " + max +
+              " (" + ccRatio(fn) + "% of threshold)"
+            );
+          }
+
+          // ── Editor deep-link + jump-to-line ──
+          // vscode:// handler accepts absolute paths. The `absolutePath`
+          // field is resolved server-side through the workspace-traversal
+          // guard, so this is safe to paste into an href.
+          function editorLink(fn) {
+            const abs = fileDetail.value?.absolutePath;
+            if (!abs) return "#";
+            return "vscode://file" + abs + ":" + fn.startLine + ":1";
+          }
+
+          function jumpToLine(lineNum) {
+            // Source lines are keyed by 0-based index, so line N lives at
+            // child index N-1 of `.source-view`.
+            const view = document.querySelector(".source-view");
+            if (!view) return;
+            const row = view.children[lineNum - 1];
+            if (!row) return;
+            row.scrollIntoView({ behavior: "smooth", block: "center" });
+            row.classList.remove("jump-target");
+            // force reflow so the animation restarts on repeat clicks
+            void row.offsetWidth;
+            row.classList.add("jump-target");
+          }
+
           const sortedFindings = computed(() => {
             if (!fileDetail.value) return [];
             return [...fileDetail.value.findings].sort((a, b) => a.startLine - b.startLine);
@@ -777,7 +983,10 @@
             currentView, selectedFile, fileDetail,
             score, complexity, loading, error,
             toolEntries, fileEntries, formatTimestamp,
-            sortedFunctions, sortedFindings,
+            sortedFunctions, sortedFindings, visibleFunctions,
+            showAllMethods, toggleShowAllMethods, topMethodsLimit,
+            ccRatio, ccColor, ccTooltip, heatBarStyle, thresholdMarker,
+            editorLink, jumpToLine,
             navigateToFile, goBack,
             lineFindings, lineClass, gutterClass, lineFnLabel,
           };

package/plugin/bundle/mcp-server.mjs

@@ -7458,6 +7458,23 @@ var DEFAULT_SKIP_DIRS = /* @__PURE__ */ new Set([
   // CI artefact staging, Maven
   "publish",
   // `dotnet publish` output
+  // Test coverage report bundles (generated HTML/JS from coverage tools;
+  // walking them floods the complexity scanner with synthetic minified
+  // functions like `coverage-report/main.js::gG` at CC 80+).
+  "coverage-report",
+  // ReportGenerator default (.NET)
+  "CoverageReport",
+  // ReportGenerator PascalCase variant
+  "coveragereport",
+  // ReportGenerator lowercase fallback
+  "TestResults",
+  // `dotnet test` default output
+  "cobertura",
+  // Cobertura XML reporter
+  "lcov-report",
+  // Istanbul HTML reporter
+  "htmlcov",
+  // coverage.py HTML output
   // Desktop / mobile packaging outputs
   "dist-electron",
   // Electron-builder
@@ -7835,6 +7852,7 @@ async function buildFileDetail(input) {
   ) / 100 : 0;
   return {
     filePath: relativePath,
+    absolutePath,
     language,
     physicalLoc,
     logicalLoc,
@@ -7857,6 +7875,20 @@ async function buildFileDetail(input) {
 // src/dashboard/server.ts
 async function startDashboard(options) {
   const { config, sarifStore, workspaceStatsProvider, logger: logger2 } = options;
+  const pidFilePath = resolvePidFilePath(config);
+  const adoption = await tryAdoptExisting(pidFilePath, config.dashboardPort, logger2);
+  if (adoption) {
+    logger2.info(
+      { url: adoption.url, ownerPid: adoption.pid, port: config.dashboardPort },
+      "adopted existing claude-crap dashboard"
+    );
+    return {
+      url: adoption.url,
+      adopted: true,
+      async close() {
+      }
+    };
+  }
   const publicRoot = await resolvePublicRoot(logger2);
   const fastify = Fastify({
     logger: false,
@@ -7909,14 +7941,35 @@ async function startDashboard(options) {
   fastify.get("/", async (_request, reply) => {
     return reply.sendFile("index.html");
   });
-  const pidFilePath = resolvePidFilePath(config);
-  await killStaleDashboard(pidFilePath, config.dashboardPort, logger2);
-  await fastify.listen({ port: config.dashboardPort, host: "127.0.0.1" });
+  try {
+    await fastify.listen({ port: config.dashboardPort, host: "127.0.0.1" });
+  } catch (err) {
+    const code = err.code;
+    if (code === "EADDRINUSE") {
+      await fastify.close().catch(() => {
+      });
+      const raceAdoption = await tryAdoptExisting(pidFilePath, config.dashboardPort, logger2);
+      if (raceAdoption) {
+        logger2.info(
+          { url: raceAdoption.url, ownerPid: raceAdoption.pid, port: config.dashboardPort },
+          "dashboard bind lost race, adopted concurrent owner"
+        );
+        return {
+          url: raceAdoption.url,
+          adopted: true,
+          async close() {
+          }
+        };
+      }
+    }
+    throw err;
+  }
   const url = `http://127.0.0.1:${config.dashboardPort}`;
   logger2.info({ url, publicRoot }, "claude-crap dashboard listening");
   writePidFile(pidFilePath, config.dashboardPort);
   return {
     url,
+    adopted: false,
     async close() {
       removePidFile(pidFilePath);
       await fastify.close();
@@ -7986,29 +8039,40 @@ function isPidAlive(pid) {
     return false;
   }
 }
-async function killStaleDashboard(pidFilePath, port, logger2) {
-  if (!existsSync(pidFilePath)) return;
+async function tryAdoptExisting(pidFilePath, port, logger2) {
+  if (!existsSync(pidFilePath)) return null;
   let stale;
   try {
     stale = JSON.parse(readFileSync(pidFilePath, "utf8"));
   } catch {
+    logger2.info({ pidFilePath }, "corrupt dashboard pidfile, removing");
     removePidFile(pidFilePath);
-    return;
+    return null;
   }
   if (!isPidAlive(stale.pid)) {
-    logger2.info({ stalePid: stale.pid }, "stale dashboard PID file found (process dead), removing");
+    logger2.info({ stalePid: stale.pid }, "stale dashboard pidfile (process dead), removing");
     removePidFile(pidFilePath);
-    return;
+    return null;
   }
-  logger2.info(
-    { stalePid: stale.pid, port: stale.port, startedAt: stale.startedAt },
-    "killing stale dashboard process from previous session"
+  if (stale.port !== port) {
+    logger2.info(
+      { stalePort: stale.port, wantedPort: port },
+      "dashboard pidfile points at different port, ignoring"
+    );
+    removePidFile(pidFilePath);
+    return null;
+  }
+  const healthy = await probeDashboardHealth(port);
+  if (healthy) {
+    return { url: `http://127.0.0.1:${port}`, pid: stale.pid };
+  }
+  logger2.warn(
+    { stalePid: stale.pid, port },
+    "dashboard pidfile owner is unresponsive, terminating"
   );
   try {
     process.kill(stale.pid, "SIGTERM");
   } catch {
-    removePidFile(pidFilePath);
-    return;
   }
   for (let i = 0; i < 30; i++) {
     if (!isPidAlive(stale.pid)) break;
@@ -8023,6 +8087,17 @@ async function killStaleDashboard(pidFilePath, port, logger2) {
   }
   removePidFile(pidFilePath);
   await new Promise((r) => setTimeout(r, 300));
+  return null;
+}
+async function probeDashboardHealth(port) {
+  try {
+    const res = await fetch(`http://127.0.0.1:${port}/api/health`, {
+      signal: AbortSignal.timeout(500)
+    });
+    return res.ok;
+  } catch {
+    return false;
+  }
 }
 async function buildComplexityReport(config, engine, logger2, exclude) {
   const threshold = config.cyclomaticMax;