@kevinrabun/judges 3.49.0 → 3.51.0

package/dist/commands/exec-report.js

@@ -0,0 +1,272 @@
+/**
+ * Exec report — executive security dashboard.
+ * Generates non-technical HTML report with risk posture summary,
+ * recurring issue trends, severity distribution, and remediation guidance.
+ *
+ * All data local.
+ */
+import { existsSync, readFileSync, mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+// ─── Data loading ───────────────────────────────────────────────────────────
+function loadReportData(inputPath) {
+    const content = readFileSync(inputPath, "utf-8");
+    const data = JSON.parse(content);
+    // SARIF format
+    if (data.$schema?.includes("sarif") || data.runs) {
+        const findings = [];
+        for (const run of data.runs || []) {
+            for (const result of run.results || []) {
+                findings.push({
+                    ruleId: result.ruleId || "unknown",
+                    severity: result.level === "error" ? "high" : result.level === "warning" ? "medium" : "low",
+                    title: result.message?.text || result.ruleId || "Unknown",
+                    confidence: result.properties?.confidence,
+                });
+            }
+        }
+        return { findings };
+    }
+    // Judges tribunal output
+    if (data.findings) {
+        return {
+            findings: data.findings.map((f) => ({
+                ruleId: f.ruleId || "unknown",
+                severity: f.severity || "medium",
+                title: f.title || f.ruleId || "Unknown",
+                confidence: f.confidence,
+            })),
+        };
+    }
+    // Array
+    if (Array.isArray(data)) {
+        return {
+            findings: data.map((f) => ({
+                ruleId: f.ruleId || "unknown",
+                severity: f.severity || "medium",
+                title: f.title || "Unknown",
+                confidence: f.confidence,
+            })),
+        };
+    }
+    return { findings: [] };
+}
+// ─── Analysis ───────────────────────────────────────────────────────────────
+function getSeverityBreakdown(findings) {
+    return {
+        critical: findings.filter((f) => f.severity === "critical").length,
+        high: findings.filter((f) => f.severity === "high").length,
+        medium: findings.filter((f) => f.severity === "medium").length,
+        low: findings.filter((f) => f.severity === "low").length,
+        total: findings.length,
+    };
+}
+function getTopRecurring(findings, limit = 10) {
+    const counts = {};
+    for (const f of findings) {
+        if (!counts[f.ruleId])
+            counts[f.ruleId] = { count: 0, severity: f.severity };
+        counts[f.ruleId].count++;
+    }
+    return Object.entries(counts)
+        .map(([ruleId, v]) => ({ ruleId, count: v.count, severity: v.severity }))
+        .sort((a, b) => b.count - a.count)
+        .slice(0, limit);
+}
+function getRiskScore(breakdown) {
+    const raw = breakdown.critical * 10 + breakdown.high * 5 + breakdown.medium * 2 + breakdown.low * 1;
+    const maxReasonable = 100;
+    const score = Math.min(100, Math.round((raw / Math.max(maxReasonable, raw)) * 100));
+    const inverted = 100 - score; // higher = better
+    if (inverted >= 80)
+        return { score: inverted, label: "Low Risk", color: "#22c55e" };
+    if (inverted >= 60)
+        return { score: inverted, label: "Moderate Risk", color: "#eab308" };
+    if (inverted >= 40)
+        return { score: inverted, label: "Elevated Risk", color: "#f97316" };
+    return { score: inverted, label: "High Risk", color: "#ef4444" };
+}
+// ─── HTML generation ────────────────────────────────────────────────────────
+function generateHtml(data) {
+    const breakdown = getSeverityBreakdown(data.findings);
+    const topRecurring = getTopRecurring(data.findings);
+    const risk = getRiskScore(breakdown);
+    const ts = data.timestamp || new Date().toISOString();
+    const sevBarData = [
+        { label: "Critical", count: breakdown.critical, color: "#ef4444" },
+        { label: "High", count: breakdown.high, color: "#f97316" },
+        { label: "Medium", count: breakdown.medium, color: "#eab308" },
+        { label: "Low", count: breakdown.low, color: "#22c55e" },
+    ];
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Security Executive Report — Judges</title>
+<style>
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; background: #f8fafc; color: #1e293b; }
+  .container { max-width: 1000px; margin: 0 auto; padding: 2rem; }
+  .header { text-align: center; margin-bottom: 2rem; }
+  .header h1 { font-size: 1.8rem; color: #0f172a; }
+  .header .subtitle { color: #64748b; margin-top: 0.5rem; }
+  .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 1rem; margin: 1.5rem 0; }
+  .card { background: white; border-radius: 8px; padding: 1.5rem; box-shadow: 0 1px 3px rgba(0,0,0,0.1); }
+  .card h3 { font-size: 0.875rem; color: #64748b; text-transform: uppercase; letter-spacing: 0.05em; }
+  .card .value { font-size: 2rem; font-weight: 700; margin-top: 0.5rem; }
+  .risk-gauge { text-align: center; padding: 2rem; }
+  .risk-score { font-size: 3rem; font-weight: 800; }
+  .risk-label { font-size: 1.2rem; margin-top: 0.25rem; }
+  .bar-chart { margin: 1.5rem 0; }
+  .bar-row { display: flex; align-items: center; margin: 0.5rem 0; }
+  .bar-label { width: 80px; font-size: 0.875rem; color: #64748b; }
+  .bar { height: 28px; border-radius: 4px; display: flex; align-items: center; padding: 0 8px; color: white; font-weight: 600; font-size: 0.8rem; min-width: 30px; transition: width 0.3s; }
+  .table { width: 100%; border-collapse: collapse; margin-top: 1rem; }
+  .table th, .table td { padding: 0.75rem 1rem; text-align: left; border-bottom: 1px solid #e2e8f0; }
+  .table th { background: #f1f5f9; font-size: 0.75rem; text-transform: uppercase; color: #64748b; }
+  .badge { display: inline-block; padding: 2px 8px; border-radius: 12px; font-size: 0.75rem; font-weight: 600; color: white; }
+  .badge-critical { background: #ef4444; }
+  .badge-high { background: #f97316; }
+  .badge-medium { background: #eab308; color: #1e293b; }
+  .badge-low { background: #22c55e; }
+  .section { margin: 2rem 0; }
+  .section h2 { font-size: 1.2rem; color: #0f172a; margin-bottom: 1rem; padding-bottom: 0.5rem; border-bottom: 2px solid #e2e8f0; }
+  .footer { text-align: center; margin-top: 3rem; padding-top: 1rem; border-top: 1px solid #e2e8f0; color: #94a3b8; font-size: 0.8rem; }
+  @media print { body { background: white; } .container { max-width: 100%; } }
+</style>
+</head>
+<body>
+<div class="container">
+  <div class="header">
+    <h1>🔒 Security Executive Report</h1>
+    <div class="subtitle">Generated by Judges — ${new Date(ts).toLocaleDateString("en-US", { year: "numeric", month: "long", day: "numeric" })}</div>
+  </div>
+
+  <div class="grid">
+    <div class="card risk-gauge">
+      <h3>Risk Posture</h3>
+      <div class="risk-score" style="color: ${risk.color}">${risk.score}</div>
+      <div class="risk-label" style="color: ${risk.color}">${risk.label}</div>
+    </div>
+    <div class="card">
+      <h3>Total Findings</h3>
+      <div class="value">${breakdown.total}</div>
+    </div>
+    <div class="card">
+      <h3>Critical + High</h3>
+      <div class="value" style="color: #ef4444">${breakdown.critical + breakdown.high}</div>
+    </div>
+    <div class="card">
+      <h3>Actionable Items</h3>
+      <div class="value">${breakdown.critical + breakdown.high + breakdown.medium}</div>
+    </div>
+  </div>
+
+  <div class="section">
+    <h2>Severity Distribution</h2>
+    <div class="bar-chart">
+      ${sevBarData
+        .map((s) => {
+        const pct = breakdown.total > 0 ? Math.max(5, (s.count / breakdown.total) * 100) : 0;
+        return `<div class="bar-row">
+        <div class="bar-label">${s.label}</div>
+        <div class="bar" style="width: ${pct}%; background: ${s.color};">${s.count}</div>
+      </div>`;
+    })
+        .join("\n      ")}
+    </div>
+  </div>
+
+  <div class="section">
+    <h2>Top Recurring Issues</h2>
+    ${topRecurring.length > 0
+        ? `<table class="table">
+      <thead><tr><th>Rule</th><th>Count</th><th>Severity</th></tr></thead>
+      <tbody>
+        ${topRecurring.map((r) => `<tr><td>${escapeHtml(r.ruleId)}</td><td>${r.count}</td><td><span class="badge badge-${r.severity}">${r.severity}</span></td></tr>`).join("\n        ")}
+      </tbody>
+    </table>`
+        : "<p>No recurring issues found.</p>"}
+  </div>
+
+  <div class="section">
+    <h2>Recommendations</h2>
+    <ul style="padding-left: 1.5rem; line-height: 1.8;">
+      ${breakdown.critical > 0 ? "<li><strong>Immediate:</strong> Address " + breakdown.critical + " critical finding(s) — these represent active security risks.</li>" : ""}
+      ${breakdown.high > 0 ? "<li><strong>Short-term:</strong> Remediate " + breakdown.high + " high severity finding(s) within the next sprint.</li>" : ""}
+      ${breakdown.medium > 0 ? "<li><strong>Medium-term:</strong> Plan fixes for " + breakdown.medium + " medium severity issue(s) in the backlog.</li>" : ""}
+      <li><strong>Process:</strong> Establish a baseline and track trend over time with <code>judges trend</code>.</li>
+      <li><strong>Prevention:</strong> Integrate Judges into CI/CD to catch issues before merge.</li>
+    </ul>
+  </div>
+
+  <div class="footer">
+    Generated by Judges • ${ts} • All data processed locally
+  </div>
+</div>
+</body>
+</html>`;
+}
+function escapeHtml(str) {
+    return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runExecReport(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges exec-report — Generate executive security dashboard
+
+Usage:
+  judges exec-report <findings.json>
+  judges exec-report report.sarif.json --output dashboard.html
+
+Options:
+  --output <file>   Output HTML filename (default: exec-report.html)
+  --format json     JSON data output instead of HTML
+  --help, -h        Show this help
+
+Input accepts: Judges JSON, SARIF, or finding arrays.
+Output: Clean HTML report suitable for CISO/VP-level presentation.
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "html";
+    const outputName = argv.find((_a, i) => argv[i - 1] === "--output") || "exec-report.html";
+    const inputFile = argv.find((a) => !a.startsWith("--") && !argv[argv.indexOf(a) - 1]?.startsWith("--"));
+    if (!inputFile || !existsSync(inputFile)) {
+        console.error("  Please provide a valid findings file (JSON or SARIF)");
+        return;
+    }
+    let data;
+    try {
+        data = loadReportData(inputFile);
+    }
+    catch (err) {
+        console.error(`  Failed to parse findings: ${err instanceof Error ? err.message : String(err)}`);
+        return;
+    }
+    data.timestamp = new Date().toISOString();
+    if (format === "json") {
+        const breakdown = getSeverityBreakdown(data.findings);
+        const topRecurring = getTopRecurring(data.findings);
+        const risk = getRiskScore(breakdown);
+        console.log(JSON.stringify({ risk, breakdown, topRecurring, totalFindings: data.findings.length, timestamp: data.timestamp }, null, 2));
+        return;
+    }
+    // Generate HTML
+    const html = generateHtml(data);
+    const outDir = join(".", ".judges-reports");
+    if (!existsSync(outDir))
+        mkdirSync(outDir, { recursive: true });
+    const outPath = join(outDir, outputName);
+    writeFileSync(outPath, html);
+    const breakdown = getSeverityBreakdown(data.findings);
+    const risk = getRiskScore(breakdown);
+    console.log(`\n  Executive Report Generated`);
+    console.log(`  ──────────────────────────`);
+    console.log(`    Risk Score: ${risk.score}/100 (${risk.label})`);
+    console.log(`    Findings:  ${breakdown.total} (${breakdown.critical}C / ${breakdown.high}H / ${breakdown.medium}M / ${breakdown.low}L)`);
+    console.log(`    Output:    ${outPath}`);
+    console.log(`\n    Open in browser to view the dashboard.\n`);
+}
+//# sourceMappingURL=exec-report.js.map

package/dist/commands/exec-report.js.map

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

package/dist/commands/guided-tour.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Guided tour — interactive onboarding tutorial for new Judges users.
+ * Step-by-step walkthrough: first evaluation, understanding output,
+ * suppression/baseline workflows, building .judgesrc by example.
+ *
+ * All data local.
+ */
+export declare function runGuidedTour(argv: string[]): void;
+//# sourceMappingURL=guided-tour.d.ts.map

package/dist/commands/guided-tour.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guided-tour.d.ts","sourceRoot":"","sources":["../../src/commands/guided-tour.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsMH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAyHlD"}

package/dist/commands/guided-tour.js

@@ -0,0 +1,288 @@
+/**
+ * Guided tour — interactive onboarding tutorial for new Judges users.
+ * Step-by-step walkthrough: first evaluation, understanding output,
+ * suppression/baseline workflows, building .judgesrc by example.
+ *
+ * All data local.
+ */
+import { existsSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+// ─── Tour content ───────────────────────────────────────────────────────────
+const TOUR_TRACKS = [
+    {
+        id: "quickstart",
+        name: "Quick Start",
+        description: "Get your first code review in under 5 minutes",
+        steps: [
+            {
+                id: "install",
+                title: "Step 1: Installation",
+                description: "Install Judges globally or as a dev dependency.",
+                command: "npm install -g @kevinrabun/judges",
+                example: "# Or as a dev dependency:\nnpm install --save-dev @kevinrabun/judges",
+                tips: [
+                    "Use --save-dev for project-specific installations",
+                    "Global install lets you run 'judges' from anywhere",
+                ],
+            },
+            {
+                id: "first-review",
+                title: "Step 2: Run Your First Review",
+                description: "Point Judges at any source file to get an instant security review.",
+                command: "judges review src/app.ts",
+                example: "# Review an entire directory:\njudges review src/\n\n# Review with a specific preset:\njudges review src/ --preset strict",
+                tips: [
+                    "Start with a single file to learn the output format",
+                    "Use --preset lenient for fewer false positives initially",
+                ],
+            },
+            {
+                id: "understand-output",
+                title: "Step 3: Understanding the Output",
+                description: "Judges outputs findings with severity, confidence, and actionable recommendations.",
+                example: `Finding output explained:
+─────────────────────────
+  [HIGH] sql-injection-risk
+    Title: Potential SQL injection in query builder
+    Line: 42
+    Confidence: 0.92 (high tier)
+    Recommendation: Use parameterized queries instead of string concatenation
+
+  Fields:
+    severity   — critical / high / medium / low
+    confidence — 0.0–1.0 score (how certain the judge is)
+    ruleId     — unique identifier for the finding type
+    title      — human-readable description
+    recommendation — how to fix the issue`,
+                tips: [
+                    "High confidence + high severity = fix immediately",
+                    "Low confidence findings may be false positives — review carefully",
+                ],
+            },
+            {
+                id: "suppress",
+                title: "Step 4: Suppressing False Positives",
+                description: "Mark findings as acknowledged or false positives so they don't appear again.",
+                command: "judges baseline create --output .judges-baseline.json",
+                example: `# Create a baseline from current findings:
+judges baseline create --output .judges-baseline.json
+
+# Run review with baseline (only new findings shown):
+judges review src/ --baseline .judges-baseline.json
+
+# Suppress a specific rule:
+# Add to .judgesrc: { "disabledRules": ["rule-id-here"] }`,
+                tips: [
+                    "Baselines capture current state — only new issues surface",
+                    "Commit .judges-baseline.json to share with your team",
+                ],
+            },
+            {
+                id: "configure",
+                title: "Step 5: Create Your .judgesrc",
+                description: "Customize Judges behavior with a configuration file.",
+                example: `// .judgesrc (JSON format)
+{
+  "preset": "recommended",
+  "minSeverity": "medium",
+  "disabledRules": [],
+  "disabledJudges": [],
+  "ruleOverrides": {
+    "some-noisy-rule": { "severity": "low" }
+  }
+}`,
+                tips: [
+                    "Start with 'recommended' preset",
+                    "Use minSeverity to filter out low-priority findings",
+                    "Override specific rules without disabling them entirely",
+                ],
+            },
+        ],
+    },
+    {
+        id: "ci-integration",
+        name: "CI/CD Integration",
+        description: "Add Judges to your continuous integration pipeline",
+        steps: [
+            {
+                id: "github-actions",
+                title: "Step 1: GitHub Actions Setup",
+                description: "Add Judges as a review step in your GitHub Actions workflow.",
+                example: `# .github/workflows/judges.yml
+name: Judges Code Review
+on: [pull_request]
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm install -g @kevinrabun/judges
+      - run: judges review src/ --format sarif --output results.sarif
+      - uses: github/codeql-action/upload-sarif@v3
+        with:
+          sarif_file: results.sarif`,
+            },
+            {
+                id: "quality-gate",
+                title: "Step 2: Quality Gate",
+                description: "Block PRs that introduce critical or high-severity findings.",
+                command: "judges gate --max-critical 0 --max-high 3",
+                example: "# In CI:\njudges review src/ --format json | judges gate --max-critical 0 --max-high 3\n# Exit code 1 = gate failed, PR should not merge",
+                tips: ["Start lenient (allow some highs) and tighten over time", "Always block on critical findings"],
+            },
+            {
+                id: "diff-review",
+                title: "Step 3: Diff-Only Review",
+                description: "Review only changed files in a PR for faster feedback.",
+                command: "judges diff-review --base main",
+                tips: ["Diff review is much faster than full review", "Combine with baseline for minimal noise"],
+            },
+        ],
+    },
+    {
+        id: "team-adoption",
+        name: "Team Adoption",
+        description: "Roll out Judges across your development team",
+        steps: [
+            {
+                id: "shared-config",
+                title: "Step 1: Shared Configuration",
+                description: "Create a team-wide .judgesrc and commit it to your repository.",
+                example: `// Recommended team .judgesrc
+{
+  "preset": "recommended",
+  "minSeverity": "medium",
+  "disabledRules": []
+}`,
+                tips: ["Start with recommended preset for team consensus", "Document why rules are disabled"],
+            },
+            {
+                id: "baseline-workflow",
+                title: "Step 2: Baseline Workflow",
+                description: "Establish a baseline then only review new findings going forward.",
+                command: "judges baseline create --output .judges-baseline.json",
+                tips: ["Create baseline on main branch", "Each team member starts from the shared baseline"],
+            },
+            {
+                id: "metrics",
+                title: "Step 3: Track Metrics",
+                description: "Monitor your team's security posture over time.",
+                command: "judges trend --days 30",
+                tips: ["Track findings-per-PR to measure improvement", "Celebrate declining finding counts"],
+            },
+        ],
+    },
+];
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runGuidedTour(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges guided-tour — Interactive onboarding tutorials
+
+Usage:
+  judges guided-tour                      List available tour tracks
+  judges guided-tour quickstart           Start the quick start tour
+  judges guided-tour ci-integration       CI/CD integration guide
+  judges guided-tour team-adoption        Team rollout guide
+  judges guided-tour --init               Generate starter .judgesrc
+  judges guided-tour --all                Show all tour content
+
+Options:
+  --init          Generate a starter .judgesrc file
+  --all           Show all tracks at once
+  --format json   JSON output
+  --step <n>      Jump to specific step number
+  --help, -h      Show this help
+
+Available tracks: ${TOUR_TRACKS.map((t) => t.id).join(", ")}
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    // Generate starter config
+    if (argv.includes("--init")) {
+        const rcPath = join(".", ".judgesrc");
+        if (existsSync(rcPath)) {
+            console.log("  .judgesrc already exists — skipping");
+            return;
+        }
+        const config = {
+            preset: "recommended",
+            minSeverity: "medium",
+            disabledRules: [],
+            disabledJudges: [],
+            ruleOverrides: {},
+        };
+        writeFileSync(rcPath, JSON.stringify(config, null, 2) + "\n");
+        console.log("  ✅ Created .judgesrc with recommended defaults");
+        return;
+    }
+    const trackId = argv.find((a) => !a.startsWith("--") && !argv[argv.indexOf(a) - 1]?.startsWith("--"));
+    const stepNum = argv.find((_a, i) => argv[i - 1] === "--step");
+    const showAll = argv.includes("--all");
+    if (format === "json") {
+        const data = trackId
+            ? TOUR_TRACKS.find((t) => t.id === trackId) || TOUR_TRACKS
+            : showAll
+                ? TOUR_TRACKS
+                : TOUR_TRACKS.map(({ steps: _s, ...rest }) => rest);
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    // List tracks
+    if (!trackId && !showAll) {
+        console.log(`\n  📚 Judges Guided Tour\n  ──────────────────────────`);
+        for (const track of TOUR_TRACKS) {
+            console.log(`\n    ${track.name} (${track.id})`);
+            console.log(`      ${track.description}`);
+            console.log(`      Steps: ${track.steps.length}`);
+            console.log(`      Run: judges guided-tour ${track.id}`);
+        }
+        console.log(`\n    💡 Quick setup: judges guided-tour --init\n`);
+        return;
+    }
+    // Show track(s)
+    const tracks = showAll ? TOUR_TRACKS : [TOUR_TRACKS.find((t) => t.id === trackId)];
+    if (!tracks[0]) {
+        console.error(`  Unknown track: ${trackId}\n  Available: ${TOUR_TRACKS.map((t) => t.id).join(", ")}`);
+        return;
+    }
+    for (const track of tracks) {
+        console.log(`\n  ═══════════════════════════════════════`);
+        console.log(`  📚 ${track.name}`);
+        console.log(`  ${track.description}`);
+        console.log(`  ═══════════════════════════════════════`);
+        const steps = stepNum ? [track.steps[parseInt(stepNum) - 1]].filter(Boolean) : track.steps;
+        for (let i = 0; i < steps.length; i++) {
+            const step = steps[i];
+            const num = stepNum ? parseInt(stepNum) : i + 1;
+            console.log(`\n  ─── ${num}/${track.steps.length} ──────────────────────────`);
+            console.log(`  ${step.title}`);
+            console.log(`  ${step.description}`);
+            if (step.command) {
+                console.log(`\n    $ ${step.command}`);
+            }
+            if (step.example) {
+                console.log(`\n${step.example
+                    .split("\n")
+                    .map((l) => "    " + l)
+                    .join("\n")}`);
+            }
+            if (step.tips && step.tips.length > 0) {
+                console.log("");
+                for (const tip of step.tips) {
+                    console.log(`    💡 ${tip}`);
+                }
+            }
+        }
+        console.log("");
+    }
+    // Generate .judgesrc directory for tour progress
+    const tourDir = join(".", ".judges-tour");
+    if (!existsSync(tourDir))
+        mkdirSync(tourDir, { recursive: true });
+}
+//# sourceMappingURL=guided-tour.js.map

package/dist/commands/guided-tour.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guided-tour.js","sourceRoot":"","sources":["../../src/commands/guided-tour.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAoB5B,+EAA+E;AAE/E,MAAM,WAAW,GAAgB;IAC/B;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,+CAA+C;QAC5D,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,SAAS;gBACb,KAAK,EAAE,sBAAsB;gBAC7B,WAAW,EAAE,iDAAiD;gBAC9D,OAAO,EAAE,mCAAmC;gBAC5C,OAAO,EAAE,sEAAsE;gBAC/E,IAAI,EAAE;oBACJ,mDAAmD;oBACnD,oDAAoD;iBACrD;aACF;YACD;gBACE,EAAE,EAAE,cAAc;gBAClB,KAAK,EAAE,+BAA+B;gBACtC,WAAW,EAAE,oEAAoE;gBACjF,OAAO,EAAE,0BAA0B;gBACnC,OAAO,EACL,2HAA2H;gBAC7H,IAAI,EAAE;oBACJ,qDAAqD;oBACrD,0DAA0D;iBAC3D;aACF;YACD;gBACE,EAAE,EAAE,mBAAmB;gBACvB,KAAK,EAAE,kCAAkC;gBACzC,WAAW,EAAE,oFAAoF;gBACjG,OAAO,EAAE;;;;;;;;;;;;;0CAayB;gBAClC,IAAI,EAAE;oBACJ,mDAAmD;oBACnD,mEAAmE;iBACpE;aACF;YACD;gBACE,EAAE,EAAE,UAAU;gBACd,KAAK,EAAE,qCAAqC;gBAC5C,WAAW,EAAE,8EAA8E;gBAC3F,OAAO,EAAE,uDAAuD;gBAChE,OAAO,EAAE;;;;;;;0DAOyC;gBAClD,IAAI,EAAE;oBACJ,2DAA2D;oBAC3D,sDAAsD;iBACvD;aACF;YACD;gBACE,EAAE,EAAE,WAAW;gBACf,KAAK,EAAE,+BAA+B;gBACtC,WAAW,EAAE,sDAAsD;gBACnE,OAAO,EAAE;;;;;;;;;EASf;gBACM,IAAI,EAAE;oBACJ,iCAAiC;oBACjC,qDAAqD;oBACrD,yDAAyD;iBAC1D;aACF;SACF;KACF;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,oDAAoD;QACjE,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,gBAAgB;gBACpB,KAAK,EAAE,8BAA8B;gBACrC,WAAW,EAAE,8DAA8D;gBAC3E,OAAO,EAAE;;;;;;;;;;;;;;;oCAemB;aAC7B;YACD;gBACE,EAAE,EAAE,cAAc;gBAClB,KAAK,EAAE,sBAAsB;gBAC7B,WAAW,EAAE,8DAA8D;gBAC3E,OAAO,EAAE,2CAA2C;gBACpD,OAAO,EACL,0IAA0I;gBAC5I,IAAI,EAAE,CAAC,wDAAwD,EAAE,mCAAmC,CAAC;aACtG;YACD;gBACE,EAAE,EAAE,aAAa;gBACjB,KAAK,EAAE,0BAA0B;gBACjC,WAAW,EAAE,wDAAwD;gBACrE,OAAO,EAAE,gCAAgC;gBACzC,IAAI,EAAE,CAAC,6CAA6C,EAAE,yCAAyC,CAAC;aACjG;SACF;KACF;IACD;QACE,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,8CAA8C;QAC3D,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,eAAe;gBACnB,KAAK,EAAE,8BAA8B;gBACrC,WAAW,EAAE,gEAAgE;gBAC7E,OAAO,EAAE;;;;;EAKf;gBACM,IAAI,EAAE,CAAC,kDAAkD,EAAE,iCAAiC,CAAC;aAC9F;YACD;gBACE,EAAE,EAAE,mBAAmB;gBACvB,KAAK,EAAE,2BAA2B;gBAClC,WAAW,EAAE,mEAAmE;gBAChF,OAAO,EAAE,uDAAuD;gBAChE,IAAI,EAAE,CAAC,gCAAgC,EAAE,kDAAkD,CAAC;aAC7F;YACD;gBACE,EAAE,EAAE,SAAS;gBACb,KAAK,EAAE,uBAAuB;gBAC9B,WAAW,EAAE,iDAAiD;gBAC9D,OAAO,EAAE,wBAAwB;gBACjC,IAAI,EAAE,CAAC,8CAA8C,EAAE,oCAAoC,CAAC;aAC7F;SACF;KACF;CACF,CAAC;AAEF,+EAA+E;AAE/E,MAAM,UAAU,aAAa,CAAC,IAAc;IAC1C,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;oBAkBI,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;CAC1D,CAAC,CAAC;QACC,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAU,EAAE,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,UAAU,CAAC,IAAI,MAAM,CAAC;IAE1F,0BAA0B;IAC1B,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACtC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;YACrD,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG;YACb,MAAM,EAAE,aAAa;YACrB,WAAW,EAAE,QAAQ;YACrB,aAAa,EAAE,EAAE;YACjB,cAAc,EAAE,EAAE;YAClB,aAAa,EAAE,EAAE;SAClB,CAAC;QACF,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9G,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAU,EAAE,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEvC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,OAAO;YAClB,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,WAAW;YAC1D,CAAC,CAAC,OAAO;gBACP,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IAED,cAAc;IACd,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;QACvE,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,iCAAiC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IAED,gBAAgB;IAChB,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAE,CAAC,CAAC;IACpF,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,kBAAkB,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtG,OAAO;IACT,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QAEzD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;QAE3F,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,6BAA6B,CAAC,CAAC;YAC/E,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YAErC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACzC,CAAC;YAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,CACT,KAAK,IAAI,CAAC,OAAO;qBACd,KAAK,CAAC,IAAI,CAAC;qBACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;qBACtB,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;YACJ,CAAC;YAED,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAChB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC5B,OAAO,CAAC,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAED,iDAAiD;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACpE,CAAC"}

package/dist/commands/hallucination-score.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Hallucination score — assign a hallucination risk score (0–100)
+ * to AI-generated code based on detected patterns: generic naming,
+ * suspicious imports, implausible logic, unverified API usage.
+ *
+ * All analysis local.
+ */
+export declare function runHallucinationScore(argv: string[]): void;
+//# sourceMappingURL=hallucination-score.d.ts.map

package/dist/commands/hallucination-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hallucination-score.d.ts","sourceRoot":"","sources":["../../src/commands/hallucination-score.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8PH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAmG1D"}