@vibecodeqa/cli 0.11.0 → 0.12.1

package/README.md

@@ -25,6 +25,9 @@ npx @vibecodeqa/cli
 # Fast mode (skip test execution)
 npx @vibecodeqa/cli --skip-tests
 
+# Watch mode (re-scan on file changes)
+npx @vibecodeqa/cli --watch
+
 # CI mode (exit code 1 if score < 60)
 npx @vibecodeqa/cli --ci
 
@@ -36,8 +39,9 @@ npx @vibecodeqa/cli /path/to/project
 ```
 
 Output goes to `.vibe-check/`:
-- `report.html` — navigable dashboard (open in browser)
+- `report.html` — navigable multi-page dashboard (open in browser)
 - `report.json` — machine-readable results
+- `history/` — last 30 reports for trend tracking
 
 ## Checks
 
@@ -113,12 +117,18 @@ Each check produces a score from 0-100. The composite score is a weighted averag
 
 ## Report features
 
+The report is a multi-page navigable dashboard:
+
+- **10 pages**: Overview, Foundations, Quality, Testing, Architecture, Security, LLM Readiness, Issues, File Map, Heatmap
+- **Top nav + sidebar** — navigate by category and check
 - **Radar chart** — 6-axis view of category scores
-- **Architecture diagram** — SVG showing module relationships and import edges
-- **Trend comparison** — score delta vs. previous run
-- **File heatmap** — top files by issue count across all checks
-- **GitHub links** — click any file:line to open in GitHub
-- **Info panels** — each check explains what it measures, why it matters, and how to fix issues
+- **Architecture SVG diagram** — modules grouped by directory, import edges, node size by fan-in
+- **Code heatmap** — colored bars showing issue density per file
+- **Trend comparison** — score delta vs. previous run (reads previous report.json)
+- **File map** — top files by issue count across all checks
+- **GitHub links** — click any file:line to open in GitHub (auto-detected from git remote)
+- **Actionable prompts** — 📋 button on every issue copies a fix prompt for Claude/Codex
+- **Info panels** — each check has What/Risk/Fix explanations with research citations
 - **Priority badges** — critical/high/medium/low on each check
 
 ## Trend tracking
@@ -133,6 +143,7 @@ vcqa reads the previous `.vibe-check/report.json` on each run and shows:
 | Flag | Description |
 |------|-------------|
 | `--skip-tests` | Skip test execution and coverage (fast mode) |
+| `--watch` | Re-scan automatically on file changes |
 | `--ci` | Exit code 1 if composite score < 60 |
 | `--json` | Output JSON to stdout (no HTML, no browser) |
 

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /** vibe-check — code health scanner for the AI coding era. */
-import { existsSync, mkdirSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { detectRepoUrl, detectStack } from "./detect.js";
 import { generateHTML } from "./report/html.js";
@@ -22,7 +22,8 @@ import { runTypeSafety } from "./runners/type-safety.js";
 import { computeScore } from "./score.js";
 import { computeTrend, formatTrend } from "./trend.js";
 import { gradeFromScore } from "./types.js";
-const VERSION = "0.11.0";
+const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
+const VERSION = pkg.version;
 const args = process.argv.slice(2);
 const flags = new Set(args.filter((a) => a.startsWith("--")));
 const cwd = resolve(args.find((a) => !a.startsWith("--")) || ".");

package/dist/report/html.js

@@ -140,8 +140,9 @@ export function generateHTML(report) {
             for (const [file, issues] of byFile) {
                 issuesHtml += `<div class="fg"><div class="fn">${fl(file)} <span class="fc">${issues.length}</span></div>`;
                 for (const iss of issues) {
-                    const prompt = `Fix this issue in ${file}${iss.line ? ":" + iss.line : ""}\\n${iss.severity}: ${iss.message}${iss.rule ? " (" + iss.rule + ")" : ""}\\nCheck: ${c.name}`;
-                    issuesHtml += `<div class="ir ${iss.severity}"><span class="is">${iss.severity[0].toUpperCase()}</span>${iss.line ? `<span class="il">${iss.line}</span>` : ""}<span class="im">${e(iss.message)}</span>${iss.rule ? `<span class="iru">${e(iss.rule)}</span>` : ""}<button class="cp-btn" onclick="navigator.clipboard.writeText('${prompt.replace(/'/g, "\\'")}');this.textContent='✓';setTimeout(()=>this.textContent='📋',1000)" title="Copy fix prompt">📋</button></div>`;
+                    const promptText = `Fix this issue in ${e(file)}${iss.line ? ":" + iss.line : ""}\n${iss.severity}: ${e(iss.message)}${iss.rule ? " (" + e(iss.rule) + ")" : ""}\nCheck: ${e(c.name)}`;
+                    const safePrompt = promptText.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/\n/g, "\\n");
+                    issuesHtml += `<div class="ir ${iss.severity}"><span class="is">${iss.severity[0].toUpperCase()}</span>${iss.line ? `<span class="il">${iss.line}</span>` : ""}<span class="im">${e(iss.message)}</span>${iss.rule ? `<span class="iru">${e(iss.rule)}</span>` : ""}<button class="cp-btn" onclick="navigator.clipboard.writeText('${safePrompt}');this.textContent='✓';setTimeout(()=>this.textContent='📋',1000)" title="Copy fix prompt">📋</button></div>`;
                 }
                 issuesHtml += `</div>`;
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecodeqa/cli",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "Code health scanner for the AI coding era. 15 checks, zero config, full report.",
   "type": "module",
   "bin": {

package/dist/runners/coverage.d.ts

@@ -1,3 +0,0 @@
-/** Coverage runner — runs tests with coverage and parses the summary. */
-import type { CheckResult, StackInfo } from "../types.js";
-export declare function runCoverage(cwd: string, stack: StackInfo): CheckResult;

package/dist/runners/coverage.js

@@ -1,65 +0,0 @@
-/** Coverage runner — runs tests with coverage and parses the summary. */
-import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-import { gradeFromScore } from "../types.js";
-import { run } from "./exec.js";
-export function runCoverage(cwd, stack) {
-    const start = Date.now();
-    if (stack.testRunner === "none") {
-        return {
-            name: "coverage",
-            score: 0,
-            grade: "F",
-            details: { skipped: true, reason: "no test runner" },
-            issues: [],
-            duration: Date.now() - start,
-        };
-    }
-    // Run tests with coverage
-    const cmd = stack.testRunner === "vitest"
-        ? "npx vitest run --coverage 2>/dev/null || true"
-        : "npx jest --coverage --coverageReporters=json-summary 2>/dev/null || true";
-    run(cmd, cwd, 120_000);
-    // Look for coverage summary
-    const searchPaths = [
-        "coverage/coverage-summary.json",
-        "test-results/coverage/coverage-summary.json",
-    ];
-    let summary = null;
-    for (const p of searchPaths) {
-        const full = join(cwd, p);
-        if (existsSync(full)) {
-            try {
-                summary = JSON.parse(readFileSync(full, "utf-8"));
-                break;
-            }
-            catch {
-                /* parse failed */
-            }
-        }
-    }
-    if (!summary?.total) {
-        return {
-            name: "coverage",
-            score: 0,
-            grade: "F",
-            details: { skipped: true, reason: "no coverage data generated" },
-            issues: [],
-            duration: Date.now() - start,
-        };
-    }
-    const stmts = summary.total.statements?.pct || 0;
-    const lines = summary.total.lines?.pct || 0;
-    const branches = summary.total.branches?.pct || 0;
-    const functions = summary.total.functions?.pct || 0;
-    // Score is the average of all four metrics
-    const score = Math.round((stmts + lines + branches + functions) / 4);
-    return {
-        name: "coverage",
-        score,
-        grade: gradeFromScore(score),
-        details: { statements: stmts, lines, branches, functions },
-        issues: [],
-        duration: Date.now() - start,
-    };
-}

package/dist/runners/tests.d.ts

@@ -1,3 +0,0 @@
-/** Test runner — auto-detects vitest or jest. */
-import type { CheckResult, StackInfo } from "../types.js";
-export declare function runTests(cwd: string, stack: StackInfo): CheckResult;

package/dist/runners/tests.js

@@ -1,54 +0,0 @@
-/** Test runner — auto-detects vitest or jest. */
-import { gradeFromScore } from "../types.js";
-import { run } from "./exec.js";
-export function runTests(cwd, stack) {
-    const start = Date.now();
-    if (stack.testRunner === "none") {
-        return {
-            name: "tests",
-            score: 0,
-            grade: "F",
-            details: { skipped: true, reason: "no test runner" },
-            issues: [],
-            duration: Date.now() - start,
-        };
-    }
-    const cmd = stack.testRunner === "vitest"
-        ? "npx vitest run --reporter=json 2>/dev/null || true"
-        : "npx jest --json 2>/dev/null || true";
-    const { stdout } = run(cmd, cwd, 120_000);
-    // Extract JSON from output (vitest may print other stuff before the JSON)
-    let data = null;
-    try {
-        // Find the JSON object in stdout
-        const jsonStart = stdout.indexOf("{");
-        if (jsonStart >= 0) {
-            data = JSON.parse(stdout.slice(jsonStart));
-        }
-    }
-    catch {
-        /* parse failed */
-    }
-    if (!data) {
-        return {
-            name: "tests",
-            score: 0,
-            grade: "F",
-            details: { error: "could not parse test output" },
-            issues: [],
-            duration: Date.now() - start,
-        };
-    }
-    const passed = data.numPassedTests || 0;
-    const failed = data.numFailedTests || 0;
-    const total = data.numTotalTests || 0;
-    const score = total === 0 ? 0 : Math.round((passed / total) * 100);
-    return {
-        name: "tests",
-        score,
-        grade: gradeFromScore(score),
-        details: { passed, failed, total, runner: stack.testRunner },
-        issues: [],
-        duration: Date.now() - start,
-    };
-}