@kevinrabun/judges 3.62.0 → 3.64.0

package/dist/commands/review-summary.js

@@ -0,0 +1,175 @@
+/**
+ * Review-summary — Generate PR-ready review summaries with key metrics.
+ */
+import { readFileSync } from "fs";
+// ─── Metrics extraction ─────────────────────────────────────────────────────
+function extractMetrics(verdict) {
+    const findings = verdict.findings || [];
+    const severityCounts = { critical: 0, high: 0, medium: 0, low: 0 };
+    const ruleCounts = new Map();
+    for (const f of findings) {
+        const sev = f.severity || "low";
+        severityCounts[sev] = (severityCounts[sev] || 0) + 1;
+        const rid = f.ruleId || "unknown";
+        ruleCounts.set(rid, (ruleCounts.get(rid) || 0) + 1);
+    }
+    const topRules = [...ruleCounts.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 5)
+        .map(([ruleId, count]) => ({ ruleId, count }));
+    return {
+        totalFindings: findings.length,
+        criticalCount: severityCounts["critical"],
+        highCount: severityCounts["high"],
+        mediumCount: severityCounts["medium"],
+        lowCount: severityCounts["low"],
+        judgeCount: verdict.evaluations?.length || 0,
+        overallScore: verdict.overallScore ?? 0,
+        overallVerdict: verdict.overallVerdict || "unknown",
+        topRules,
+    };
+}
+// ─── Formatters ─────────────────────────────────────────────────────────────
+function severityEmoji(count, level) {
+    if (count === 0)
+        return `✅ 0 ${level}`;
+    if (level === "critical")
+        return `🔴 ${count} ${level}`;
+    if (level === "high")
+        return `🟠 ${count} ${level}`;
+    if (level === "medium")
+        return `🟡 ${count} ${level}`;
+    return `🔵 ${count} ${level}`;
+}
+function verdictEmoji(verdict) {
+    const map = {
+        pass: "✅ PASS",
+        fail: "❌ FAIL",
+        warning: "⚠️ WARNING",
+    };
+    return map[verdict] || verdict.toUpperCase();
+}
+function formatMarkdown(metrics) {
+    const lines = [];
+    lines.push(`## Judges Review Summary`);
+    lines.push(``);
+    lines.push(`**Verdict:** ${verdictEmoji(metrics.overallVerdict)} | **Score:** ${metrics.overallScore}/100 | **Judges:** ${metrics.judgeCount}`);
+    lines.push(``);
+    lines.push(`| Severity | Count |`);
+    lines.push(`|----------|-------|`);
+    lines.push(`| ${severityEmoji(metrics.criticalCount, "critical")} | ${metrics.criticalCount} |`);
+    lines.push(`| ${severityEmoji(metrics.highCount, "high")} | ${metrics.highCount} |`);
+    lines.push(`| ${severityEmoji(metrics.mediumCount, "medium")} | ${metrics.mediumCount} |`);
+    lines.push(`| ${severityEmoji(metrics.lowCount, "low")} | ${metrics.lowCount} |`);
+    lines.push(`| **Total** | **${metrics.totalFindings}** |`);
+    if (metrics.topRules.length > 0) {
+        lines.push(``);
+        lines.push(`**Top Rules:**`);
+        for (const r of metrics.topRules) {
+            lines.push(`- \`${r.ruleId}\` (${r.count})`);
+        }
+    }
+    lines.push(``);
+    lines.push(`---`);
+    lines.push(`*Generated by [Judges Panel](https://github.com/KevinRabun/judges)*`);
+    return lines.join("\n");
+}
+function formatSlack(metrics) {
+    const lines = [];
+    lines.push(`*Judges Review Summary*`);
+    lines.push(`Verdict: ${verdictEmoji(metrics.overallVerdict)} | Score: ${metrics.overallScore}/100 | Judges: ${metrics.judgeCount}`);
+    lines.push(``);
+    lines.push(`${severityEmoji(metrics.criticalCount, "critical")} | ${severityEmoji(metrics.highCount, "high")} | ${severityEmoji(metrics.mediumCount, "medium")} | ${severityEmoji(metrics.lowCount, "low")}`);
+    lines.push(`Total: ${metrics.totalFindings} findings`);
+    if (metrics.topRules.length > 0) {
+        lines.push(``);
+        lines.push(`Top rules: ${metrics.topRules.map((r) => `${r.ruleId} (${r.count})`).join(", ")}`);
+    }
+    return lines.join("\n");
+}
+function formatOneLiner(metrics) {
+    return `${verdictEmoji(metrics.overallVerdict)} Score: ${metrics.overallScore}/100 | ${metrics.totalFindings} findings (${metrics.criticalCount}C/${metrics.highCount}H/${metrics.mediumCount}M/${metrics.lowCount}L) | ${metrics.judgeCount} judges`;
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runReviewSummary(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges review-summary — Generate PR-ready review summary
+
+Usage:
+  judges review-summary --input verdict.json
+  judges review-summary --input verdict.json --style markdown
+  judges review-summary --input verdict.json --style slack
+  judges review-summary --format json
+
+Options:
+  --input <file>       JSON file with TribunalVerdict (required)
+  --style <type>       Output style: text, markdown, slack, oneliner (default: text)
+  --format json        Raw JSON metrics output
+  --help, -h           Show this help
+
+Styles:
+  text                 Plain text summary (default)
+  markdown             GitHub PR description format
+  slack                Slack message format
+  oneliner             Single-line summary
+
+Generates a concise, copy-pasteable review summary suitable for
+PR descriptions, Slack messages, or CI logs.
+`);
+        return;
+    }
+    const inputPath = argv.find((_a, i) => argv[i - 1] === "--input");
+    const style = argv.find((_a, i) => argv[i - 1] === "--style") || "text";
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    if (!inputPath) {
+        console.error("Error: --input is required. Provide a JSON verdict file.");
+        process.exitCode = 1;
+        return;
+    }
+    let verdict;
+    try {
+        const raw = readFileSync(inputPath, "utf-8");
+        verdict = JSON.parse(raw);
+    }
+    catch {
+        console.error(`Error: Cannot read or parse ${inputPath}`);
+        process.exitCode = 1;
+        return;
+    }
+    const metrics = extractMetrics(verdict);
+    if (format === "json") {
+        console.log(JSON.stringify(metrics, null, 2));
+        return;
+    }
+    switch (style) {
+        case "markdown":
+            console.log(formatMarkdown(metrics));
+            break;
+        case "slack":
+            console.log(formatSlack(metrics));
+            break;
+        case "oneliner":
+            console.log(formatOneLiner(metrics));
+            break;
+        default:
+            console.log(`\n  Review Summary\n  ─────────────────────────────`);
+            console.log(`    Verdict: ${verdictEmoji(metrics.overallVerdict)}`);
+            console.log(`    Score: ${metrics.overallScore}/100`);
+            console.log(`    Judges: ${metrics.judgeCount}`);
+            console.log(`    Total findings: ${metrics.totalFindings}`);
+            console.log(`      ${severityEmoji(metrics.criticalCount, "critical")}`);
+            console.log(`      ${severityEmoji(metrics.highCount, "high")}`);
+            console.log(`      ${severityEmoji(metrics.mediumCount, "medium")}`);
+            console.log(`      ${severityEmoji(metrics.lowCount, "low")}`);
+            if (metrics.topRules.length > 0) {
+                console.log(`\n    Top Rules:`);
+                for (const r of metrics.topRules) {
+                    console.log(`      ${r.ruleId} (${r.count})`);
+                }
+            }
+            console.log();
+            break;
+    }
+}
+//# sourceMappingURL=review-summary.js.map

package/dist/commands/review-summary.js.map

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

package/dist/commands/review-template.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Review-template — Reusable review templates for common workflows.
+ */
+export declare function runReviewTemplate(argv: string[]): void;
+//# sourceMappingURL=review-template.d.ts.map

package/dist/commands/review-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-template.d.ts","sourceRoot":"","sources":["../../src/commands/review-template.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqHH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAqItD"}

package/dist/commands/review-template.js

@@ -0,0 +1,213 @@
+/**
+ * Review-template — Reusable review templates for common workflows.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from "fs";
+import { join, dirname } from "path";
+// ─── Built-in templates ────────────────────────────────────────────────────
+const BUILTIN_TEMPLATES = [
+    {
+        id: "security-audit",
+        name: "Security Audit",
+        description: "Deep security review focusing on OWASP Top 10 and CWE patterns",
+        judges: ["data-security", "cybersecurity", "authentication", "input-guard"],
+        preset: "security-only",
+        minSeverity: "medium",
+        focusRules: [],
+        excludeRules: [],
+        outputFormat: "sarif",
+        failOnFindings: true,
+        tags: ["security", "compliance"],
+    },
+    {
+        id: "pr-review",
+        name: "PR Review",
+        description: "Standard pull request review for code quality and correctness",
+        judges: [],
+        preset: "recommended",
+        minSeverity: "low",
+        focusRules: [],
+        excludeRules: [],
+        outputFormat: "text",
+        failOnFindings: false,
+        tags: ["pr", "quality"],
+    },
+    {
+        id: "pre-deploy",
+        name: "Pre-Deploy Check",
+        description: "Critical checks before deployment — security and reliability only",
+        judges: ["data-security", "cybersecurity", "reliability", "error-handling"],
+        preset: "strict",
+        minSeverity: "high",
+        focusRules: [],
+        excludeRules: [],
+        outputFormat: "json",
+        failOnFindings: true,
+        tags: ["deploy", "ci"],
+    },
+    {
+        id: "ai-code-review",
+        name: "AI Code Review",
+        description: "Specialized review for AI-generated code patterns",
+        judges: [],
+        preset: "strict",
+        minSeverity: "low",
+        focusRules: [],
+        excludeRules: [],
+        outputFormat: "text",
+        failOnFindings: false,
+        tags: ["ai", "generated"],
+    },
+    {
+        id: "quick-scan",
+        name: "Quick Scan",
+        description: "Fast scan for critical issues only",
+        judges: ["data-security", "cybersecurity"],
+        preset: "lenient",
+        minSeverity: "critical",
+        focusRules: [],
+        excludeRules: [],
+        outputFormat: "text",
+        failOnFindings: false,
+        tags: ["quick", "critical"],
+    },
+];
+// ─── Template storage ──────────────────────────────────────────────────────
+const TEMPLATE_DIR = join(".judges", "templates");
+function loadCustomTemplates() {
+    if (!existsSync(TEMPLATE_DIR))
+        return [];
+    const files = readdirSync(TEMPLATE_DIR);
+    const templates = [];
+    for (const f of files) {
+        if (!f.endsWith(".json"))
+            continue;
+        try {
+            const t = JSON.parse(readFileSync(join(TEMPLATE_DIR, f), "utf-8"));
+            templates.push(t);
+        }
+        catch {
+            // Skip invalid files
+        }
+    }
+    return templates;
+}
+function getAllTemplates() {
+    return [...BUILTIN_TEMPLATES, ...loadCustomTemplates()];
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runReviewTemplate(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges review-template — Reusable review templates
+
+Usage:
+  judges review-template list                      List all templates
+  judges review-template show --id security-audit  Show template details
+  judges review-template create --id my-template   Create custom template
+  judges review-template export --id my-template   Export template to JSON
+  judges review-template --format json             JSON output
+
+Subcommands:
+  list                 List built-in and custom templates
+  show                 Show template details
+  create               Create a new custom template
+  export               Export template to stdout
+
+Options:
+  --id <id>            Template ID (required for show/create/export)
+  --name <name>        Template display name (for create)
+  --desc <text>        Template description (for create)
+  --preset <name>      Preset to use (for create)
+  --format json        JSON output
+  --help, -h           Show this help
+
+Built-in templates: security-audit, pr-review, pre-deploy, ai-code-review, quick-scan.
+Custom templates are stored in .judges/templates/.
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const templateId = argv.find((_a, i) => argv[i - 1] === "--id");
+    const subcommand = argv.find((a) => ["list", "show", "create", "export"].includes(a)) || "list";
+    const allTemplates = getAllTemplates();
+    if (subcommand === "list") {
+        if (format === "json") {
+            console.log(JSON.stringify({
+                templates: allTemplates.map((t) => ({ id: t.id, name: t.name, description: t.description, tags: t.tags })),
+            }, null, 2));
+            return;
+        }
+        console.log(`\n  Review Templates (${allTemplates.length})\n  ─────────────────────────────`);
+        for (const t of allTemplates) {
+            const tags = t.tags.length > 0 ? ` [${t.tags.join(", ")}]` : "";
+            console.log(`    📋 ${t.id} — ${t.name}${tags}`);
+            console.log(`       ${t.description}`);
+        }
+        console.log();
+        return;
+    }
+    if (!templateId) {
+        console.error("Error: --id is required.");
+        process.exitCode = 1;
+        return;
+    }
+    if (subcommand === "create") {
+        const existing = allTemplates.find((t) => t.id === templateId);
+        if (existing) {
+            console.error(`Error: Template '${templateId}' already exists.`);
+            process.exitCode = 1;
+            return;
+        }
+        const name = argv.find((_a, i) => argv[i - 1] === "--name") || templateId;
+        const desc = argv.find((_a, i) => argv[i - 1] === "--desc") || "Custom review template";
+        const preset = argv.find((_a, i) => argv[i - 1] === "--preset") || "recommended";
+        const template = {
+            id: templateId,
+            name,
+            description: desc,
+            judges: [],
+            preset,
+            minSeverity: "low",
+            focusRules: [],
+            excludeRules: [],
+            outputFormat: "text",
+            failOnFindings: false,
+            tags: ["custom"],
+        };
+        const filePath = join(TEMPLATE_DIR, `${templateId}.json`);
+        mkdirSync(dirname(filePath), { recursive: true });
+        writeFileSync(filePath, JSON.stringify(template, null, 2), "utf-8");
+        console.log(`Created template '${templateId}' in ${filePath}.`);
+        return;
+    }
+    const template = allTemplates.find((t) => t.id === templateId);
+    if (!template) {
+        console.error(`Error: Template '${templateId}' not found.`);
+        process.exitCode = 1;
+        return;
+    }
+    if (subcommand === "export") {
+        console.log(JSON.stringify(template, null, 2));
+        return;
+    }
+    // Show
+    if (format === "json") {
+        console.log(JSON.stringify(template, null, 2));
+        return;
+    }
+    console.log(`\n  Template: ${template.name}\n  ─────────────────────────────`);
+    console.log(`    ID: ${template.id}`);
+    console.log(`    Description: ${template.description}`);
+    console.log(`    Preset: ${template.preset}`);
+    console.log(`    Min severity: ${template.minSeverity}`);
+    console.log(`    Output format: ${template.outputFormat}`);
+    console.log(`    Fail on findings: ${template.failOnFindings}`);
+    if (template.judges.length > 0) {
+        console.log(`    Judges: ${template.judges.join(", ")}`);
+    }
+    if (template.tags.length > 0) {
+        console.log(`    Tags: ${template.tags.join(", ")}`);
+    }
+    console.log();
+}
+//# sourceMappingURL=review-template.js.map

package/dist/commands/review-template.js.map

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

package/dist/commands/rule-test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Rule-test — Test custom rules against sample code before deployment.
+ */
+export declare function runRuleTest(argv: string[]): void;
+//# sourceMappingURL=rule-test.d.ts.map

package/dist/commands/rule-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-test.d.ts","sourceRoot":"","sources":["../../src/commands/rule-test.ts"],"names":[],"mappings":"AAAA;;GAEG;AA6HH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAsIhD"}

package/dist/commands/rule-test.js

@@ -0,0 +1,216 @@
+/**
+ * Rule-test — Test custom rules against sample code before deployment.
+ */
+import { readFileSync, existsSync, readdirSync, statSync } from "fs";
+import { join, extname } from "path";
+// ─── Rule loading ───────────────────────────────────────────────────────────
+function loadRules(rulesPath) {
+    const raw = readFileSync(rulesPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    const rules = Array.isArray(parsed) ? parsed : parsed.rules || [];
+    return rules;
+}
+// ─── File collection ────────────────────────────────────────────────────────
+function collectFiles(dirPath) {
+    const results = [];
+    if (!existsSync(dirPath))
+        return results;
+    const entries = readdirSync(dirPath);
+    for (const entry of entries) {
+        const fullPath = join(dirPath, entry);
+        try {
+            const st = statSync(fullPath);
+            if (st.isDirectory()) {
+                results.push(...collectFiles(fullPath));
+            }
+            else {
+                results.push(fullPath);
+            }
+        }
+        catch {
+            // skip inaccessible entries
+        }
+    }
+    return results;
+}
+// ─── Language matching ──────────────────────────────────────────────────────
+const EXT_TO_LANG = {
+    ".ts": "typescript",
+    ".tsx": "typescript",
+    ".js": "javascript",
+    ".jsx": "javascript",
+    ".py": "python",
+    ".go": "go",
+    ".rs": "rust",
+    ".java": "java",
+    ".cs": "csharp",
+    ".cpp": "cpp",
+    ".c": "c",
+    ".rb": "ruby",
+    ".php": "php",
+};
+function matchesLanguage(filePath, languages) {
+    if (!languages || languages.length === 0)
+        return true;
+    const ext = extname(filePath).toLowerCase();
+    const lang = EXT_TO_LANG[ext] || ext.slice(1);
+    return languages.includes(lang);
+}
+// ─── Rule testing ───────────────────────────────────────────────────────────
+function testRule(rule, files) {
+    const results = [];
+    let regex;
+    try {
+        regex = new RegExp(rule.pattern, "gi");
+    }
+    catch {
+        console.error(`  ❌ Rule '${rule.id}' has invalid regex: ${rule.pattern}`);
+        return results;
+    }
+    for (const file of files) {
+        if (!matchesLanguage(file, rule.languages))
+            continue;
+        let content;
+        try {
+            content = readFileSync(file, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        const lines = content.split("\n");
+        const matches = [];
+        for (let i = 0; i < lines.length; i++) {
+            regex.lastIndex = 0;
+            if (regex.test(lines[i])) {
+                matches.push({ line: i + 1, content: lines[i].trim().slice(0, 120) });
+            }
+        }
+        results.push({
+            ruleId: rule.id,
+            file,
+            matches,
+            matched: matches.length > 0,
+        });
+    }
+    return results;
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runRuleTest(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges rule-test — Test custom rules against sample code
+
+Usage:
+  judges rule-test --rules custom-rules.json --fixtures tests/fixtures
+  judges rule-test --rules custom-rules.json --file sample.ts
+  judges rule-test --rules custom-rules.json --fixtures src --format json
+
+Options:
+  --rules <file>       JSON file with custom rules (required)
+  --fixtures <dir>     Directory with test fixture files
+  --file <path>        Test against a single file
+  --rule <id>          Test only a specific rule by ID
+  --format json        JSON output
+  --help, -h           Show this help
+
+Validates custom rules against real code before deployment. Ensures
+patterns match expected findings and catch the intended issues.
+`);
+        return;
+    }
+    const rulesPath = argv.find((_a, i) => argv[i - 1] === "--rules");
+    const fixturesDir = argv.find((_a, i) => argv[i - 1] === "--fixtures");
+    const singleFile = argv.find((_a, i) => argv[i - 1] === "--file");
+    const ruleFilter = argv.find((_a, i) => argv[i - 1] === "--rule");
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    if (!rulesPath) {
+        console.error("Error: --rules is required. Provide a custom rules JSON file.");
+        process.exitCode = 1;
+        return;
+    }
+    if (!existsSync(rulesPath)) {
+        console.error(`Error: Rules file not found: ${rulesPath}`);
+        process.exitCode = 1;
+        return;
+    }
+    let rules;
+    try {
+        rules = loadRules(rulesPath);
+    }
+    catch {
+        console.error(`Error: Cannot parse rules file: ${rulesPath}`);
+        process.exitCode = 1;
+        return;
+    }
+    if (ruleFilter) {
+        rules = rules.filter((r) => r.id === ruleFilter);
+        if (rules.length === 0) {
+            console.error(`Error: Rule '${ruleFilter}' not found in ${rulesPath}`);
+            process.exitCode = 1;
+            return;
+        }
+    }
+    // Gather target files
+    let files;
+    if (singleFile) {
+        if (!existsSync(singleFile)) {
+            console.error(`Error: File not found: ${singleFile}`);
+            process.exitCode = 1;
+            return;
+        }
+        files = [singleFile];
+    }
+    else if (fixturesDir) {
+        files = collectFiles(fixturesDir);
+    }
+    else {
+        console.error("Error: Either --fixtures or --file is required.");
+        process.exitCode = 1;
+        return;
+    }
+    if (files.length === 0) {
+        console.log("No files found to test against.");
+        return;
+    }
+    // Run tests
+    const allResults = [];
+    for (const rule of rules) {
+        allResults.push(...testRule(rule, files));
+    }
+    const matchedResults = allResults.filter((r) => r.matched);
+    const rulesWithMatches = new Set(matchedResults.map((r) => r.ruleId));
+    if (format === "json") {
+        console.log(JSON.stringify({
+            rulesCount: rules.length,
+            filesCount: files.length,
+            matchedRules: rulesWithMatches.size,
+            totalMatches: matchedResults.reduce((s, r) => s + r.matches.length, 0),
+            results: matchedResults.map((r) => ({
+                ruleId: r.ruleId,
+                file: r.file,
+                matchCount: r.matches.length,
+                matches: r.matches,
+            })),
+        }, null, 2));
+        return;
+    }
+    console.log(`\n  Rule Test Results\n  ─────────────────────────────`);
+    console.log(`    Rules tested: ${rules.length}`);
+    console.log(`    Files scanned: ${files.length}`);
+    console.log(`    Rules with matches: ${rulesWithMatches.size}\n`);
+    for (const rule of rules) {
+        const ruleResults = matchedResults.filter((r) => r.ruleId === rule.id);
+        const totalMatches = ruleResults.reduce((s, r) => s + r.matches.length, 0);
+        const icon = totalMatches > 0 ? "✅" : "⬜";
+        console.log(`    ${icon} ${rule.id} — ${totalMatches} match(es) across ${ruleResults.length} file(s)`);
+        console.log(`       Pattern: ${rule.pattern}`);
+        console.log(`       Severity: ${rule.severity}`);
+        for (const rr of ruleResults.slice(0, 3)) {
+            for (const m of rr.matches.slice(0, 3)) {
+                console.log(`         L${m.line}: ${m.content}`);
+            }
+        }
+        console.log();
+    }
+}
+//# sourceMappingURL=rule-test.js.map