@kevinrabun/judges 3.50.0 → 3.52.0

package/dist/commands/chat-notify.js

@@ -0,0 +1,259 @@
+/**
+ * Chat-notify — publish findings to Slack, Teams, Discord, or custom
+ * webhooks with rich formatting and team mention routing.
+ *
+ * DataAdapter-friendly: webhook URLs come from local config,
+ * no data stored server-side.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+// ─── Config ─────────────────────────────────────────────────────────────────
+const CONFIG_DIR = ".judges-notify";
+const CONFIG_FILE = join(CONFIG_DIR, "webhooks.json");
+function ensureDir() {
+    if (!existsSync(CONFIG_DIR))
+        mkdirSync(CONFIG_DIR, { recursive: true });
+}
+function loadWebhooks() {
+    if (!existsSync(CONFIG_FILE))
+        return [];
+    try {
+        return JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
+    }
+    catch {
+        return [];
+    }
+}
+function saveWebhooks(webhooks) {
+    ensureDir();
+    writeFileSync(CONFIG_FILE, JSON.stringify(webhooks, null, 2));
+}
+// ─── Formatters ─────────────────────────────────────────────────────────────
+function formatSlack(payload) {
+    const color = payload.criticalCount > 0 ? "#e74c3c" : payload.score < 60 ? "#f39c12" : "#2ecc71";
+    return {
+        attachments: [
+            {
+                color,
+                title: `🔍 Judges Panel: ${payload.subject}`,
+                text: payload.body,
+                fields: [
+                    { title: "Score", value: `${payload.score}/100`, short: true },
+                    { title: "Findings", value: String(payload.findings), short: true },
+                    { title: "Critical", value: String(payload.criticalCount), short: true },
+                ],
+                footer: "Judges Panel",
+                ts: Math.floor(Date.now() / 1000),
+            },
+        ],
+    };
+}
+function formatTeams(payload) {
+    const color = payload.criticalCount > 0 ? "FF0000" : payload.score < 60 ? "FFC107" : "28A745";
+    return {
+        "@type": "MessageCard",
+        "@context": "http://schema.org/extensions",
+        themeColor: color,
+        summary: `Judges Panel: ${payload.subject}`,
+        sections: [
+            {
+                activityTitle: `🔍 ${payload.subject}`,
+                facts: [
+                    { name: "Score", value: `${payload.score}/100` },
+                    { name: "Findings", value: String(payload.findings) },
+                    { name: "Critical", value: String(payload.criticalCount) },
+                ],
+                text: payload.body,
+            },
+        ],
+    };
+}
+function formatDiscord(payload) {
+    const color = payload.criticalCount > 0 ? 0xe74c3c : payload.score < 60 ? 0xf39c12 : 0x2ecc71;
+    return {
+        embeds: [
+            {
+                title: `🔍 Judges Panel: ${payload.subject}`,
+                description: payload.body,
+                color,
+                fields: [
+                    { name: "Score", value: `${payload.score}/100`, inline: true },
+                    { name: "Findings", value: String(payload.findings), inline: true },
+                    { name: "Critical", value: String(payload.criticalCount), inline: true },
+                ],
+                timestamp: new Date().toISOString(),
+            },
+        ],
+    };
+}
+function formatPayload(webhook, payload) {
+    switch (webhook.type) {
+        case "slack":
+            return JSON.stringify(formatSlack(payload));
+        case "teams":
+            return JSON.stringify(formatTeams(payload));
+        case "discord":
+            return JSON.stringify(formatDiscord(payload));
+        default:
+            return JSON.stringify(payload);
+    }
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runChatNotify(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges chat-notify — Publish findings to chat platforms
+
+Usage:
+  judges chat-notify --add --name "team-slack" --type slack --url <webhook-url>
+  judges chat-notify --send --subject "PR #42" --score 65 --findings 5 --critical 1
+  judges chat-notify --send --file eval-output.json
+  judges chat-notify --list
+  judges chat-notify --preview --name "team-slack" --subject "test"
+  judges chat-notify --remove --name "team-slack"
+
+Options:
+  --add                 Add webhook configuration
+  --name <name>         Webhook name
+  --type <platform>     Platform: slack, teams, discord, custom
+  --url <webhook-url>   Webhook URL (stored locally in .judges-notify/)
+  --channel <name>      Channel name (for display)
+  --mention <user>      Mention on critical findings
+  --min-severity <sev>  Minimum severity to notify (default: medium)
+  --send                Send notification
+  --subject <text>      Notification subject
+  --score <n>           Score (0-100)
+  --findings <n>        Finding count
+  --critical <n>        Critical finding count
+  --file <path>         Import from evaluation output
+  --preview             Preview formatted message (no send)
+  --list                List configured webhooks
+  --remove              Remove webhook
+  --format json         JSON output
+  --help, -h            Show this help
+
+Platforms: Slack (attachments), Teams (MessageCard), Discord (embeds), Custom (raw JSON)
+Webhook URLs are stored locally — no data sent to Judges servers.
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const isAdd = argv.includes("--add");
+    const isSend = argv.includes("--send");
+    const isList = argv.includes("--list");
+    const isPreview = argv.includes("--preview");
+    const isRemove = argv.includes("--remove");
+    const name = argv.find((_a, i) => argv[i - 1] === "--name") || "";
+    const webhookType = (argv.find((_a, i) => argv[i - 1] === "--type") ||
+        "custom");
+    const url = argv.find((_a, i) => argv[i - 1] === "--url") || "";
+    const channel = argv.find((_a, i) => argv[i - 1] === "--channel") || "";
+    const mention = argv.find((_a, i) => argv[i - 1] === "--mention") || "";
+    const subject = argv.find((_a, i) => argv[i - 1] === "--subject") || "Judges Panel Evaluation";
+    const score = parseInt(argv.find((_a, i) => argv[i - 1] === "--score") || "0");
+    const findings = parseInt(argv.find((_a, i) => argv[i - 1] === "--findings") || "0");
+    const critical = parseInt(argv.find((_a, i) => argv[i - 1] === "--critical") || "0");
+    const fileArg = argv.find((_a, i) => argv[i - 1] === "--file");
+    if (isAdd) {
+        if (!name || !url) {
+            console.error("  --name and --url are required for --add");
+            return;
+        }
+        const webhooks = loadWebhooks();
+        if (webhooks.some((w) => w.name === name)) {
+            console.error(`  Webhook "${name}" already exists. Remove first.`);
+            return;
+        }
+        webhooks.push({ name, url, type: webhookType, channel, mentionOnCritical: mention || undefined });
+        saveWebhooks(webhooks);
+        console.log(`  ✅ Added ${webhookType} webhook "${name}"`);
+        return;
+    }
+    if (isRemove) {
+        if (!name) {
+            console.error("  --name is required");
+            return;
+        }
+        const webhooks = loadWebhooks().filter((w) => w.name !== name);
+        saveWebhooks(webhooks);
+        console.log(`  ✅ Removed webhook "${name}"`);
+        return;
+    }
+    if (isList) {
+        const webhooks = loadWebhooks();
+        if (format === "json") {
+            console.log(JSON.stringify(webhooks, null, 2));
+        }
+        else {
+            console.log(`\n  Configured Webhooks — ${webhooks.length}\n  ──────────────────────────`);
+            for (const w of webhooks) {
+                const masked = w.url.replace(/(.{20}).*(.{6})/, "$1***$2");
+                console.log(`    📡 ${w.name} (${w.type}) → ${masked}${w.channel ? ` #${w.channel}` : ""}`);
+            }
+            if (webhooks.length === 0)
+                console.log("    No webhooks configured. Use --add to add one.");
+            console.log("");
+        }
+        return;
+    }
+    if (isSend || isPreview) {
+        const webhooks = loadWebhooks();
+        const targets = name ? webhooks.filter((w) => w.name === name) : webhooks;
+        if (targets.length === 0) {
+            console.error("  No webhooks configured. Use --add first.");
+            return;
+        }
+        let payloadScore = score;
+        let payloadFindings = findings;
+        let payloadCritical = critical;
+        let body = `Score: ${score}/100 | ${findings} findings | ${critical} critical`;
+        if (fileArg && existsSync(fileArg)) {
+            try {
+                const data = JSON.parse(readFileSync(fileArg, "utf-8"));
+                payloadScore = data.overallScore || score;
+                payloadFindings = Array.isArray(data.findings) ? data.findings.length : findings;
+                payloadCritical = data.criticalCount || critical;
+                body = data.summary || body;
+            }
+            catch {
+                /* use manual values */
+            }
+        }
+        for (const webhook of targets) {
+            const payload = {
+                platform: webhook.type,
+                channel: webhook.channel || "",
+                subject,
+                body,
+                findings: payloadFindings,
+                criticalCount: payloadCritical,
+                score: payloadScore,
+            };
+            const formatted = formatPayload(webhook, payload);
+            if (isPreview) {
+                console.log(`\n  Preview for ${webhook.name} (${webhook.type}):\n`);
+                console.log(JSON.stringify(JSON.parse(formatted), null, 2));
+            }
+            else {
+                // In a real implementation, this would use fetch/https to POST
+                // Since we can't store/process data server-side, we output the curl command
+                console.log(`\n  📡 ${webhook.name} (${webhook.type}):`);
+                console.log(`     curl -X POST -H "Content-Type: application/json" -d '${formatted}' "${webhook.url}"`);
+                if (webhook.mentionOnCritical && payloadCritical > 0) {
+                    console.log(`     ⚠ Critical findings — mention ${webhook.mentionOnCritical}`);
+                }
+            }
+        }
+        console.log("");
+        return;
+    }
+    // Default: show status
+    const webhooks = loadWebhooks();
+    console.log(`\n  Chat Notify — ${webhooks.length} webhook(s) configured`);
+    if (webhooks.length > 0) {
+        for (const w of webhooks)
+            console.log(`    📡 ${w.name} (${w.type})`);
+    }
+    console.log("  Use --help for usage.\n");
+}
+//# sourceMappingURL=chat-notify.js.map

package/dist/commands/chat-notify.js.map

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

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

@@ -0,0 +1,9 @@
+/**
+ * Clarity score — measure code readability and self-documentation
+ * specifically for AI-generated code. Flags "correct but cryptic"
+ * patterns that need documentation investment.
+ *
+ * All analysis local.
+ */
+export declare function runClarityScore(argv: string[]): void;
+//# sourceMappingURL=clarity-score.d.ts.map

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

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

package/dist/commands/clarity-score.js

@@ -0,0 +1,261 @@
+/**
+ * Clarity score — measure code readability and self-documentation
+ * specifically for AI-generated code. Flags "correct but cryptic"
+ * patterns that need documentation investment.
+ *
+ * All analysis local.
+ */
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { join, extname } from "path";
+// ─── Analysers ──────────────────────────────────────────────────────────────
+function analyzeClarity(content) {
+    const lines = content.split("\n");
+    const nonEmpty = lines.filter((l) => l.trim().length > 0);
+    const metrics = [];
+    const suggestions = [];
+    // 1. Naming quality
+    const identifiers = content.match(/(?:const|let|var|function)\s+(\w+)/g) || [];
+    const shortNames = identifiers.filter((id) => {
+        const name = id.replace(/^(?:const|let|var|function)\s+/, "");
+        return name.length <= 2 && !["i", "j", "k", "x", "y", "id"].includes(name);
+    });
+    const namingScore = identifiers.length > 0 ? Math.max(0, 100 - (shortNames.length / identifiers.length) * 200) : 100;
+    metrics.push({ id: "naming", label: "Naming Quality", score: Math.round(namingScore), weight: 25 });
+    if (namingScore < 60)
+        suggestions.push("Use descriptive variable names — single-letter names reduce readability");
+    // 2. Comment coverage
+    const commentLines = lines.filter((l) => /^\s*(?:\/\/|\/?\*|#)/.test(l)).length;
+    const commentRatio = nonEmpty.length > 0 ? commentLines / nonEmpty.length : 0;
+    const commentScore = commentRatio >= 0.15 ? 100 : commentRatio >= 0.08 ? 70 : commentRatio >= 0.03 ? 40 : 10;
+    metrics.push({
+        id: "comments",
+        label: "Comment Coverage",
+        score: commentScore,
+        weight: 20,
+        detail: `${Math.round(commentRatio * 100)}% of lines`,
+    });
+    if (commentScore < 50)
+        suggestions.push("Add comments explaining the 'why' — not the 'what'");
+    // 3. Function length
+    const fnBodies = [];
+    let braceDepth = 0;
+    let fnStart = -1;
+    for (let i = 0; i < lines.length; i++) {
+        if (/\bfunction\b|=>\s*{/.test(lines[i]) && fnStart === -1)
+            fnStart = i;
+        braceDepth += (lines[i].match(/{/g) || []).length;
+        braceDepth -= (lines[i].match(/}/g) || []).length;
+        if (fnStart >= 0 && braceDepth <= 0) {
+            fnBodies.push(i - fnStart + 1);
+            fnStart = -1;
+        }
+    }
+    const avgFnLength = fnBodies.length > 0 ? fnBodies.reduce((a, b) => a + b, 0) / fnBodies.length : 0;
+    const fnLengthScore = avgFnLength <= 15 ? 100 : avgFnLength <= 30 ? 70 : avgFnLength <= 50 ? 40 : 10;
+    metrics.push({
+        id: "function-length",
+        label: "Function Length",
+        score: fnLengthScore,
+        weight: 15,
+        detail: `avg ${Math.round(avgFnLength)} lines`,
+    });
+    if (fnLengthScore < 50)
+        suggestions.push("Break long functions into smaller, focused functions");
+    // 4. Line complexity
+    const longLines = nonEmpty.filter((l) => l.length > 100).length;
+    const longLineRatio = nonEmpty.length > 0 ? longLines / nonEmpty.length : 0;
+    const lineComplexityScore = longLineRatio <= 0.05 ? 100 : longLineRatio <= 0.15 ? 70 : longLineRatio <= 0.3 ? 40 : 10;
+    metrics.push({
+        id: "line-length",
+        label: "Line Length",
+        score: lineComplexityScore,
+        weight: 10,
+        detail: `${longLines} lines > 100 chars`,
+    });
+    if (lineComplexityScore < 50)
+        suggestions.push("Break long lines for readability");
+    // 5. Nesting depth
+    let maxNesting = 0;
+    let currentNesting = 0;
+    for (const line of lines) {
+        currentNesting += (line.match(/{/g) || []).length;
+        maxNesting = Math.max(maxNesting, currentNesting);
+        currentNesting -= (line.match(/}/g) || []).length;
+    }
+    const nestingScore = maxNesting <= 3 ? 100 : maxNesting <= 5 ? 70 : maxNesting <= 7 ? 40 : 10;
+    metrics.push({
+        id: "nesting",
+        label: "Nesting Depth",
+        score: nestingScore,
+        weight: 15,
+        detail: `max ${maxNesting} levels`,
+    });
+    if (nestingScore < 50)
+        suggestions.push("Reduce nesting depth with early returns and guard clauses");
+    // 6. Magic numbers/strings
+    const magicNumbers = content.match(/(?<!\w)\d{3,}(?!\w)/g) || [];
+    const inlineStrings = content.match(/["'][^"']{20,}["']/g) || [];
+    const magicCount = magicNumbers.length + inlineStrings.length;
+    const magicScore = magicCount <= 2 ? 100 : magicCount <= 5 ? 70 : magicCount <= 10 ? 40 : 10;
+    metrics.push({
+        id: "magic-values",
+        label: "Named Constants",
+        score: magicScore,
+        weight: 10,
+        detail: `${magicCount} magic values`,
+    });
+    if (magicScore < 50)
+        suggestions.push("Extract magic numbers and long strings into named constants");
+    // 7. Consistent style
+    const semicolons = (content.match(/;\s*$/gm) || []).length;
+    const noSemicolons = nonEmpty.length - semicolons;
+    const semiRatio = nonEmpty.length > 0 ? Math.max(semicolons, noSemicolons) / nonEmpty.length : 1;
+    const styleScore = semiRatio >= 0.8 ? 100 : semiRatio >= 0.6 ? 60 : 30;
+    metrics.push({ id: "style-consistency", label: "Style Consistency", score: styleScore, weight: 5 });
+    if (styleScore < 60)
+        suggestions.push("Use consistent code style (semicolons, quotes, indentation)");
+    return { metrics, suggestions };
+}
+function computeOverallScore(metrics) {
+    const totalWeight = metrics.reduce((sum, m) => sum + m.weight, 0);
+    const weighted = metrics.reduce((sum, m) => sum + m.score * m.weight, 0);
+    return totalWeight > 0 ? Math.round(weighted / totalWeight) : 0;
+}
+function grade(score) {
+    if (score >= 90)
+        return "A";
+    if (score >= 80)
+        return "B";
+    if (score >= 70)
+        return "C";
+    if (score >= 60)
+        return "D";
+    return "F";
+}
+// ─── Scanner ────────────────────────────────────────────────────────────────
+const SKIP = new Set(["node_modules", ".git", "dist", "build", "coverage"]);
+const EXTS = new Set([".ts", ".js", ".py", ".java", ".cs", ".go", ".rb", ".php", ".rs"]);
+function collectFiles(dir) {
+    const result = [];
+    function walk(d) {
+        let entries;
+        try {
+            entries = readdirSync(d);
+        }
+        catch {
+            return;
+        }
+        for (const name of entries) {
+            if (SKIP.has(name) || name.startsWith("."))
+                continue;
+            const full = join(d, name);
+            try {
+                const sub = readdirSync(full);
+                void sub;
+                walk(full);
+            }
+            catch {
+                if (EXTS.has(extname(name).toLowerCase()))
+                    result.push(full);
+            }
+        }
+    }
+    walk(dir);
+    return result;
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runClarityScore(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges clarity-score — Measure code readability and self-documentation
+
+Usage:
+  judges clarity-score <file-or-dir>
+  judges clarity-score src/ --min-grade C
+
+Options:
+  --min-grade <A-F>   Only show files at or below this grade
+  --format json       JSON output
+  --help, -h          Show this help
+
+Metrics:
+  • Naming quality (descriptive vs. short names)
+  • Comment coverage (ratio of comment lines)
+  • Function length (average lines per function)
+  • Line length (lines exceeding 100 characters)
+  • Nesting depth (maximum brace depth)
+  • Named constants (magic numbers/strings)
+  • Style consistency (semicolon/formatting uniformity)
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const minGrade = argv.find((_a, i) => argv[i - 1] === "--min-grade");
+    const target = argv.find((a) => !a.startsWith("--") && !argv[argv.indexOf(a) - 1]?.startsWith("--")) || ".";
+    if (!existsSync(target)) {
+        console.error(`  Path not found: ${target}`);
+        return;
+    }
+    let files;
+    try {
+        readdirSync(target);
+        files = collectFiles(target);
+    }
+    catch {
+        files = [target];
+    }
+    const results = [];
+    for (const f of files) {
+        let content;
+        try {
+            content = readFileSync(f, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        const { metrics, suggestions } = analyzeClarity(content);
+        const overall = computeOverallScore(metrics);
+        results.push({ file: f, overallScore: overall, grade: grade(overall), metrics, suggestions });
+    }
+    let filtered = results;
+    if (minGrade) {
+        const gradeOrder = ["A", "B", "C", "D", "F"];
+        const minIdx = gradeOrder.indexOf(minGrade.toUpperCase());
+        if (minIdx >= 0)
+            filtered = results.filter((r) => gradeOrder.indexOf(r.grade) >= minIdx);
+    }
+    filtered.sort((a, b) => a.overallScore - b.overallScore);
+    if (format === "json") {
+        console.log(JSON.stringify({ files: filtered, scannedFiles: files.length, timestamp: new Date().toISOString() }, null, 2));
+    }
+    else {
+        const avgScore = results.length > 0 ? Math.round(results.reduce((s, r) => s + r.overallScore, 0) / results.length) : 0;
+        console.log(`\n  Clarity Score — ${files.length} files`);
+        console.log(`  Average: ${avgScore}/100 (${grade(avgScore)})\n  ──────────────────────────`);
+        if (filtered.length === 0) {
+            console.log(`    ✅ All files meet clarity threshold\n`);
+            return;
+        }
+        for (const r of filtered.slice(0, 20)) {
+            const icon = r.grade === "A" ? "🟢" : r.grade === "B" ? "🟢" : r.grade === "C" ? "🟡" : r.grade === "D" ? "🟠" : "🔴";
+            console.log(`\n    ${icon} ${r.file} — ${r.overallScore}/100 (${r.grade})`);
+            for (const m of r.metrics) {
+                const mIcon = m.score >= 70 ? "✓" : m.score >= 40 ? "~" : "✗";
+                console.log(`        ${mIcon} ${m.label.padEnd(20)} ${String(m.score).padEnd(4)} ${m.detail || ""}`);
+            }
+            if (r.suggestions.length > 0) {
+                console.log(`      Suggestions:`);
+                for (const s of r.suggestions)
+                    console.log(`        → ${s}`);
+            }
+        }
+        if (filtered.length > 20)
+            console.log(`    ... and ${filtered.length - 20} more files`);
+        // Grade distribution
+        const dist = { A: 0, B: 0, C: 0, D: 0, F: 0 };
+        for (const r of results)
+            dist[r.grade]++;
+        console.log(`\n    Distribution: A:${dist.A} B:${dist.B} C:${dist.C} D:${dist.D} F:${dist.F}\n`);
+    }
+}
+//# sourceMappingURL=clarity-score.js.map

package/dist/commands/clarity-score.js.map

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

package/dist/commands/design-audit.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Design audit — detect AI-generated code that breaks project
+ * conventions, introduces unnecessary abstractions, or creates
+ * architectural deviation from the baseline.
+ *
+ * All analysis local.
+ */
+export declare function runDesignAudit(argv: string[]): void;
+//# sourceMappingURL=design-audit.d.ts.map

package/dist/commands/design-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-audit.d.ts","sourceRoot":"","sources":["../../src/commands/design-audit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4PH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA6GnD"}