@kevinrabun/judges 3.53.0 → 3.54.0

package/dist/commands/context-inject.js

@@ -0,0 +1,212 @@
+/**
+ * Context inject — feed project-specific context (architecture docs,
+ * API contracts, coding standards) into evaluation for higher-precision
+ * findings.
+ *
+ * Parses context files and maintains a local context cache for judges.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from "fs";
+import { join, basename } from "path";
+// ─── Storage ────────────────────────────────────────────────────────────────
+const CONTEXT_DIR = ".judges-context";
+function ensureDir() {
+    if (!existsSync(CONTEXT_DIR))
+        mkdirSync(CONTEXT_DIR, { recursive: true });
+}
+function loadProfile() {
+    const file = join(CONTEXT_DIR, "profile.json");
+    if (!existsSync(file))
+        return null;
+    try {
+        return JSON.parse(readFileSync(file, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function saveProfile(profile) {
+    ensureDir();
+    writeFileSync(join(CONTEXT_DIR, "profile.json"), JSON.stringify(profile, null, 2));
+}
+// ─── Context Extraction ────────────────────────────────────────────────────
+const RULE_PATTERNS = [
+    { regex: /(?:must|should|always|never|require|mandatory)\s+(.{10,80})/i, category: "requirement" },
+    { regex: /(?:do not|don't|avoid|prohibit|forbid)\s+(.{10,80})/i, category: "prohibition" },
+    { regex: /(?:all|every)\s+(?:api|endpoint|route|handler)\s+(?:must|should)\s+(.{10,80})/i, category: "api-standard" },
+    {
+        regex: /(?:database|db|data)\s+(?:access|query|operation)\s+(?:must|should)\s+(.{10,80})/i,
+        category: "data-access",
+    },
+    {
+        regex: /(?:error|exception)\s+(?:handling|management)\s+(?:must|should)\s+(.{10,80})/i,
+        category: "error-handling",
+    },
+    { regex: /(?:auth|authentication|authorization)\s+(.{10,80})/i, category: "auth" },
+    { regex: /(?:naming|convention|style)\s+(?:must|should|:)\s*(.{10,80})/i, category: "naming" },
+    { regex: /(?:test|testing)\s+(?:must|should|require)\s+(.{10,80})/i, category: "testing" },
+    { regex: /(?:log|logging)\s+(?:must|should|require)\s+(.{10,80})/i, category: "logging" },
+    { regex: /(?:security|secure)\s+(?:must|should|require)\s+(.{10,80})/i, category: "security" },
+];
+function extractRules(content, source) {
+    const rules = [];
+    const lines = content.split("\n");
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        for (const pattern of RULE_PATTERNS) {
+            const match = pattern.regex.exec(trimmed);
+            if (match) {
+                rules.push({ source: basename(source), category: pattern.category, rule: trimmed.substring(0, 120) });
+                break;
+            }
+        }
+    }
+    return rules;
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runContextInject(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges context-inject — Feed project context into evaluation
+
+Usage:
+  judges context-inject --add docs/architecture.md
+  judges context-inject --add docs/coding-standards.md
+  judges context-inject --show
+  judges context-inject --scan docs/
+  judges context-inject --clear
+
+Options:
+  --add <file>          Add a context file (Markdown/YAML/text)
+  --scan <dir>          Scan directory for context documents
+  --show                Show current context profile
+  --clear               Clear all context
+  --format json         JSON output
+  --help, -h            Show this help
+
+Context files are parsed for rules, standards, and conventions that
+judges use to calibrate findings for your specific project.
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const isAdd = argv.includes("--add");
+    const _isShow = argv.includes("--show");
+    const isScan = argv.includes("--scan");
+    const isClear = argv.includes("--clear");
+    if (isClear) {
+        saveProfile({
+            name: "default",
+            sources: [],
+            rules: [],
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        });
+        console.log("  ✅ Context cleared");
+        return;
+    }
+    if (isAdd) {
+        const fileIdx = argv.indexOf("--add") + 1;
+        const file = argv[fileIdx] || "";
+        if (!file || !existsSync(file)) {
+            console.error(`  File not found: ${file}`);
+            return;
+        }
+        const content = readFileSync(file, "utf-8");
+        const newRules = extractRules(content, file);
+        const profile = loadProfile() || {
+            name: "default",
+            sources: [],
+            rules: [],
+            createdAt: new Date().toISOString(),
+            updatedAt: "",
+        };
+        if (!profile.sources.includes(file))
+            profile.sources.push(file);
+        profile.rules.push(...newRules);
+        profile.updatedAt = new Date().toISOString();
+        saveProfile(profile);
+        console.log(`  ✅ Added ${file} — extracted ${newRules.length} rule(s)`);
+        if (newRules.length > 0) {
+            for (const r of newRules.slice(0, 5)) {
+                console.log(`    [${r.category}] ${r.rule}`);
+            }
+            if (newRules.length > 5)
+                console.log(`    ... and ${newRules.length - 5} more`);
+        }
+        return;
+    }
+    if (isScan) {
+        const dirIdx = argv.indexOf("--scan") + 1;
+        const dir = argv[dirIdx] || "docs";
+        if (!existsSync(dir)) {
+            console.error(`  Directory not found: ${dir}`);
+            return;
+        }
+        const DOC_EXTS = new Set([".md", ".txt", ".yaml", ".yml", ".rst"]);
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            entries = [];
+        }
+        const docFiles = entries.filter((e) => DOC_EXTS.has(join(".", e).includes(".") ? "." + e.split(".").pop() : ""));
+        const profile = loadProfile() || {
+            name: "default",
+            sources: [],
+            rules: [],
+            createdAt: new Date().toISOString(),
+            updatedAt: "",
+        };
+        let totalNew = 0;
+        for (const f of docFiles) {
+            const fullPath = join(dir, f);
+            try {
+                const content = readFileSync(fullPath, "utf-8");
+                const rules = extractRules(content, fullPath);
+                if (!profile.sources.includes(fullPath))
+                    profile.sources.push(fullPath);
+                profile.rules.push(...rules);
+                totalNew += rules.length;
+            }
+            catch {
+                /* skip */
+            }
+        }
+        profile.updatedAt = new Date().toISOString();
+        saveProfile(profile);
+        console.log(`  ✅ Scanned ${docFiles.length} doc(s) in ${dir} — extracted ${totalNew} rule(s)`);
+        return;
+    }
+    // Default: show profile
+    const profile = loadProfile();
+    if (!profile || profile.rules.length === 0) {
+        console.log("  No context loaded. Use --add <file> or --scan <dir> to inject context.");
+        return;
+    }
+    if (format === "json") {
+        console.log(JSON.stringify(profile, null, 2));
+    }
+    else {
+        console.log(`\n  Context Profile — ${profile.rules.length} rule(s) from ${profile.sources.length} source(s)\n  ──────────────────────────`);
+        const byCategory = new Map();
+        for (const r of profile.rules) {
+            const list = byCategory.get(r.category) || [];
+            list.push(r);
+            byCategory.set(r.category, list);
+        }
+        for (const [cat, rules] of byCategory) {
+            console.log(`\n    📋 ${cat} (${rules.length}):`);
+            for (const r of rules.slice(0, 5)) {
+                console.log(`        ${r.rule}`);
+            }
+            if (rules.length > 5)
+                console.log(`        ... and ${rules.length - 5} more`);
+        }
+        console.log(`\n    Sources: ${profile.sources.join(", ")}`);
+        console.log(`    Last updated: ${profile.updatedAt}\n`);
+    }
+}
+//# sourceMappingURL=context-inject.js.map

package/dist/commands/context-inject.js.map

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

package/dist/commands/finding-contest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Finding contest — gamified challenge mode where developers compete
+ * to fix the most findings in a codebase within a time window.
+ *
+ * Results stored locally in `.judges-contests/`.
+ */
+export declare function runFindingContest(argv: string[]): void;
+//# sourceMappingURL=finding-contest.d.ts.map

package/dist/commands/finding-contest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-contest.d.ts","sourceRoot":"","sources":["../../src/commands/finding-contest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyEH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAuKtD"}

package/dist/commands/finding-contest.js

@@ -0,0 +1,193 @@
+/**
+ * Finding contest — gamified challenge mode where developers compete
+ * to fix the most findings in a codebase within a time window.
+ *
+ * Results stored locally in `.judges-contests/`.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+// ─── Storage ────────────────────────────────────────────────────────────────
+const DATA_DIR = ".judges-contests";
+function ensureDir() {
+    if (!existsSync(DATA_DIR))
+        mkdirSync(DATA_DIR, { recursive: true });
+}
+function loadContest(id) {
+    const file = join(DATA_DIR, `${id}.json`);
+    if (!existsSync(file))
+        return null;
+    try {
+        return JSON.parse(readFileSync(file, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function saveContest(contest) {
+    ensureDir();
+    writeFileSync(join(DATA_DIR, `${contest.id}.json`), JSON.stringify(contest, null, 2));
+}
+function getActiveContest() {
+    ensureDir();
+    const indexFile = join(DATA_DIR, "active.json");
+    if (!existsSync(indexFile))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(indexFile, "utf-8"));
+        return loadContest(data.id);
+    }
+    catch {
+        return null;
+    }
+}
+function setActiveContest(id) {
+    ensureDir();
+    const indexFile = join(DATA_DIR, "active.json");
+    if (id)
+        writeFileSync(indexFile, JSON.stringify({ id }));
+    else if (existsSync(indexFile))
+        writeFileSync(indexFile, "{}");
+}
+// ─── Scoring ────────────────────────────────────────────────────────────────
+const SEVERITY_POINTS = { critical: 10, high: 5, medium: 3, low: 1 };
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runFindingContest(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges finding-contest — Gamified fix challenge
+
+Usage:
+  judges finding-contest --start --duration 60 --findings 25
+  judges finding-contest --fix --participant "alice" --rule SEC-001 --severity high
+  judges finding-contest --leaderboard
+  judges finding-contest --end
+
+Options:
+  --start               Start a new contest
+  --duration <min>      Contest duration in minutes (default: 60)
+  --findings <n>        Initial finding count (default: 20)
+  --fix                 Record a fix
+  --participant <name>  Participant name
+  --rule <id>           Rule ID that was fixed
+  --severity <level>    Severity of the fixed finding
+  --leaderboard         Show current leaderboard
+  --end                 End active contest and show final results
+  --format json         JSON output
+  --help, -h            Show this help
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const isStart = argv.includes("--start");
+    const isFix = argv.includes("--fix");
+    const isLeaderboard = argv.includes("--leaderboard");
+    const isEnd = argv.includes("--end");
+    if (isStart) {
+        const duration = parseInt(argv.find((_a, i) => argv[i - 1] === "--duration") || "60");
+        const findings = parseInt(argv.find((_a, i) => argv[i - 1] === "--findings") || "20");
+        const now = new Date();
+        const contest = {
+            id: `contest-${Date.now()}`,
+            durationMinutes: duration,
+            startedAt: now.toISOString(),
+            endsAt: new Date(now.getTime() + duration * 60000).toISOString(),
+            status: "active",
+            initialFindings: findings,
+            entries: [],
+        };
+        saveContest(contest);
+        setActiveContest(contest.id);
+        console.log(`\n  🏁 Contest Started!`);
+        console.log(`  ──────────────────────────`);
+        console.log(`    ID: ${contest.id}`);
+        console.log(`    Duration: ${duration} minutes`);
+        console.log(`    Findings to fix: ${findings}`);
+        console.log(`    Ends at: ${contest.endsAt}`);
+        console.log(`\n    Use: judges finding-contest --fix --participant "name" --rule RULE-ID --severity level\n`);
+        return;
+    }
+    if (isFix) {
+        const contest = getActiveContest();
+        if (!contest || contest.status !== "active") {
+            console.error("  No active contest. Use --start to begin one.");
+            return;
+        }
+        // Check if contest has expired
+        if (new Date() > new Date(contest.endsAt)) {
+            contest.status = "completed";
+            saveContest(contest);
+            setActiveContest(null);
+            console.log("  ⏰ Contest has ended! Use --leaderboard to see results.");
+            return;
+        }
+        const participant = argv.find((_a, i) => argv[i - 1] === "--participant") || "";
+        const ruleId = argv.find((_a, i) => argv[i - 1] === "--rule") || "unknown";
+        const severity = argv.find((_a, i) => argv[i - 1] === "--severity") || "medium";
+        if (!participant) {
+            console.error("  --participant is required");
+            return;
+        }
+        let entry = contest.entries.find((e) => e.participant === participant);
+        if (!entry) {
+            entry = { participant, fixCount: 0, sevPoints: 0, startedAt: new Date().toISOString(), fixes: [] };
+            contest.entries.push(entry);
+        }
+        const points = SEVERITY_POINTS[severity] || 3;
+        entry.fixCount++;
+        entry.sevPoints += points;
+        entry.fixes.push({ ruleId, severity, fixedAt: new Date().toISOString() });
+        saveContest(contest);
+        console.log(`  ✅ ${participant} fixed ${ruleId} [${severity}] — +${points} points (total: ${entry.sevPoints})`);
+        return;
+    }
+    if (isLeaderboard || isEnd) {
+        const contest = getActiveContest() ||
+            (() => {
+                // Try to find latest completed contest
+                ensureDir();
+                return null;
+            })();
+        if (!contest) {
+            console.error("  No contest found. Use --start to begin one.");
+            return;
+        }
+        if (isEnd && contest.status === "active") {
+            contest.status = "completed";
+            saveContest(contest);
+            setActiveContest(null);
+        }
+        const sorted = [...contest.entries].sort((a, b) => b.sevPoints - a.sevPoints);
+        const totalFixed = sorted.reduce((s, e) => s + e.fixCount, 0);
+        if (format === "json") {
+            console.log(JSON.stringify({
+                contest: { id: contest.id, status: contest.status, duration: contest.durationMinutes },
+                leaderboard: sorted,
+                totalFixed,
+                timestamp: new Date().toISOString(),
+            }, null, 2));
+        }
+        else {
+            const statusIcon = contest.status === "active" ? "🟢 ACTIVE" : "🏁 COMPLETED";
+            console.log(`\n  Finding Contest ${statusIcon}\n  ──────────────────────────`);
+            console.log(`  ID: ${contest.id} | Duration: ${contest.durationMinutes}m | Findings: ${contest.initialFindings} → ${contest.initialFindings - totalFixed}\n`);
+            if (sorted.length === 0) {
+                console.log("    No fixes recorded yet!");
+            }
+            else {
+                for (let i = 0; i < sorted.length; i++) {
+                    const e = sorted[i];
+                    const medal = i === 0 ? "🥇" : i === 1 ? "🥈" : i === 2 ? "🥉" : "  ";
+                    console.log(`    ${medal} ${e.participant.padEnd(20)} ${String(e.sevPoints).padStart(5)} pts | ${e.fixCount} fixes`);
+                }
+            }
+            if (contest.status === "active") {
+                const remaining = Math.max(0, Math.floor((new Date(contest.endsAt).getTime() - Date.now()) / 60000));
+                console.log(`\n    ⏱️ ${remaining} minutes remaining`);
+            }
+            console.log("");
+        }
+        return;
+    }
+    console.log("  Use --start, --fix, --leaderboard, or --end. See --help for details.");
+}
+//# sourceMappingURL=finding-contest.js.map

package/dist/commands/finding-contest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-contest.js","sourceRoot":"","sources":["../../src/commands/finding-contest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAsB5B,+EAA+E;AAE/E,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAEpC,SAAS,SAAS;IAChB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,WAAW,CAAC,EAAU;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,OAAgB;IACnC,SAAS,EAAE,CAAC;IACZ,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,gBAAgB;IACvB,SAAS,EAAE,CAAC;IACZ,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,OAAO,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAiB;IACzC,SAAS,EAAE,CAAC;IACZ,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAChD,IAAI,EAAE;QAAE,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;SACpD,IAAI,UAAU,CAAC,SAAS,CAAC;QAAE,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,+EAA+E;AAE/E,MAAM,eAAe,GAA2B,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;AAE7F,+EAA+E;AAE/E,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;CAqBf,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;IAC1F,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAErC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAU,EAAE,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,YAAY,CAAC,IAAI,IAAI,CAAC,CAAC;QACtG,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAU,EAAE,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,YAAY,CAAC,IAAI,IAAI,CAAC,CAAC;QAEtG,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAY;YACvB,EAAE,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,EAAE;YAC3B,eAAe,EAAE,QAAQ;YACzB,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;YAC5B,MAAM,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,QAAQ,GAAG,KAAK,CAAC,CAAC,WAAW,EAAE;YAChE,MAAM,EAAE,QAAQ;YAChB,eAAe,EAAE,QAAQ;YACzB,OAAO,EAAE,EAAE;SACZ,CAAC;QAEF,WAAW,CAAC,OAAO,CAAC,CAAC;QACrB,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAE7B,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,iBAAiB,QAAQ,UAAU,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,gGAAgG,CAAC,CAAC;QAC9G,OAAO;IACT,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QAED,+BAA+B;QAC/B,IAAI,IAAI,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC;YAC7B,WAAW,CAAC,OAAO,CAAC,CAAC;YACrB,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAU,EAAE,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,eAAe,CAAC,IAAI,EAAE,CAAC;QAChG,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAU,EAAE,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,QAAQ,CAAC,IAAI,SAAS,CAAC;QAC3F,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAU,EAAE,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,YAAY,CAAC,IAAI,QAAQ,CAAC;QAEhG,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,IAAI,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;QACvE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACnG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9C,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjB,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC;QAC1B,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAE1E,WAAW,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,OAAO,WAAW,UAAU,MAAM,KAAK,QAAQ,QAAQ,MAAM,mBAAmB,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;QAChH,OAAO;IACT,CAAC;IAED,IAAI,aAAa,IAAI,KAAK,EAAE,CAAC;QAC3B,MAAM,OAAO,GACX,gBAAgB,EAAE;YAClB,CAAC,GAAG,EAAE;gBACJ,uCAAuC;gBACvC,SAAS,EAAE,CAAC;gBACZ,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,EAAE,CAAC;QAEP,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;YAC/D,OAAO;QACT,CAAC;QAED,IAAI,KAAK,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACzC,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC;YAC7B,WAAW,CAAC,OAAO,CAAC,CAAC;YACrB,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;QAC9E,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAE9D,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;gBACE,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,eAAe,EAAE;gBACtF,WAAW,EAAE,MAAM;gBACnB,UAAU;gBACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC;YAC9E,OAAO,CAAC,GAAG,CAAC,uBAAuB,UAAU,gCAAgC,CAAC,CAAC;YAC/E,OAAO,CAAC,GAAG,CACT,SAAS,OAAO,CAAC,EAAE,gBAAgB,OAAO,CAAC,eAAe,iBAAiB,OAAO,CAAC,eAAe,MAAM,OAAO,CAAC,eAAe,GAAG,UAAU,IAAI,CACjJ,CAAC;YAEF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACvC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;oBACpB,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;oBACtE,OAAO,CAAC,GAAG,CACT,OAAO,KAAK,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,QAAQ,QAAQ,CACxG,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAChC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;gBACrG,OAAO,CAAC,GAAG,CAAC,YAAY,SAAS,oBAAoB,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QACD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;AACxF,CAAC"}

package/dist/commands/habit-tracker.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Habit tracker — track recurring finding patterns per developer or
+ * AI model and surface personalized improvement suggestions.
+ *
+ * Data stored locally in `.judges-habits/`.
+ */
+export declare function runHabitTracker(argv: string[]): void;
+//# sourceMappingURL=habit-tracker.d.ts.map

package/dist/commands/habit-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"habit-tracker.d.ts","sourceRoot":"","sources":["../../src/commands/habit-tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsGH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAoIpD"}

package/dist/commands/habit-tracker.js

@@ -0,0 +1,195 @@
+/**
+ * Habit tracker — track recurring finding patterns per developer or
+ * AI model and surface personalized improvement suggestions.
+ *
+ * Data stored locally in `.judges-habits/`.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+// ─── Storage ────────────────────────────────────────────────────────────────
+const DATA_DIR = ".judges-habits";
+function ensureDir() {
+    if (!existsSync(DATA_DIR))
+        mkdirSync(DATA_DIR, { recursive: true });
+}
+function loadProfile(author) {
+    const file = join(DATA_DIR, `${author}.json`);
+    if (!existsSync(file))
+        return null;
+    try {
+        return JSON.parse(readFileSync(file, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function saveProfile(profile) {
+    ensureDir();
+    writeFileSync(join(DATA_DIR, `${profile.author}.json`), JSON.stringify(profile, null, 2));
+}
+// ─── Learning Resources ────────────────────────────────────────────────────
+const CATEGORY_RESOURCES = {
+    "sql-injection": [
+        "Use parameterized queries",
+        "Review OWASP SQL Injection Prevention Cheat Sheet",
+        "Enable SQL linting in CI",
+    ],
+    xss: [
+        "Sanitize all user input before rendering",
+        "Use Content Security Policy headers",
+        "Review OWASP XSS Prevention Cheat Sheet",
+    ],
+    "hardcoded-secret": [
+        "Use environment variables for secrets",
+        "Set up a secrets manager",
+        "Add secret scanning to pre-commit hooks",
+    ],
+    "empty-catch": [
+        "Always log or re-throw caught exceptions",
+        "Use error monitoring (Sentry, etc.)",
+        "Define error handling strategy per module",
+    ],
+    "missing-auth": [
+        "Apply auth middleware to all routes",
+        "Review OWASP Authentication Cheat Sheet",
+        "Implement role-based access control",
+    ],
+    "insecure-crypto": [
+        "Use crypto.randomUUID() for tokens",
+        "Use bcrypt/scrypt for password hashing",
+        "Never use MD5 or SHA1 for security",
+    ],
+    "error-handling": [
+        "Define a consistent error hierarchy",
+        "Use Result types or Either monads",
+        "Log errors with correlation IDs",
+    ],
+    performance: ["Profile before optimizing", "Use pagination for list endpoints", "Cache frequently accessed data"],
+    "code-quality": [
+        "Follow single responsibility principle",
+        "Reduce cyclomatic complexity",
+        "Write meaningful test names",
+    ],
+    documentation: ["Keep JSDoc in sync with code", "Document public API contracts", "Add examples to complex functions"],
+};
+function getResources(category) {
+    const key = Object.keys(CATEGORY_RESOURCES).find((k) => category.toLowerCase().includes(k));
+    return key
+        ? CATEGORY_RESOURCES[key]
+        : ["Review team coding standards", "Add targeted linting rules", "Consider pair programming for this area"];
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runHabitTracker(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges habit-tracker — Track recurring finding patterns
+
+Usage:
+  judges habit-tracker --record --author "alice" --category "sql-injection"
+  judges habit-tracker --record --author "copilot" --category "empty-catch" --count 3
+  judges habit-tracker --show --author "alice"
+  judges habit-tracker --digest --author "alice"
+
+Options:
+  --record              Record finding occurrence
+  --author <name>       Developer or AI model name
+  --category <name>     Finding category (e.g., sql-injection, xss, empty-catch)
+  --count <n>           Number of occurrences (default: 1)
+  --show                Show author's habit profile
+  --digest              Show improvement digest with resources
+  --format json         JSON output
+  --help, -h            Show this help
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const isRecord = argv.includes("--record");
+    const isDigest = argv.includes("--digest");
+    const authorName = argv.find((_a, i) => argv[i - 1] === "--author") || "";
+    const category = argv.find((_a, i) => argv[i - 1] === "--category") || "";
+    const count = parseInt(argv.find((_a, i) => argv[i - 1] === "--count") || "1");
+    if (!authorName) {
+        console.error("  --author is required");
+        return;
+    }
+    if (isRecord) {
+        if (!category) {
+            console.error("  --category is required for --record");
+            return;
+        }
+        const profile = loadProfile(authorName) || {
+            author: authorName,
+            entries: [],
+            totalFindings: 0,
+            topCategory: "",
+            lastUpdated: "",
+        };
+        let entry = profile.entries.find((e) => e.category === category);
+        if (!entry) {
+            entry = { category, count: 0, lastSeen: "", trend: "stable", resources: getResources(category) };
+            profile.entries.push(entry);
+        }
+        const prevCount = entry.count;
+        entry.count += count;
+        entry.lastSeen = new Date().toISOString();
+        entry.trend = entry.count > prevCount * 1.5 ? "rising" : entry.count < prevCount * 0.7 ? "declining" : "stable";
+        profile.totalFindings += count;
+        profile.topCategory = profile.entries.sort((a, b) => b.count - a.count)[0]?.category || "";
+        profile.lastUpdated = new Date().toISOString();
+        saveProfile(profile);
+        console.log(`  ✅ Recorded ${count}x ${category} for ${authorName} (total: ${entry.count})`);
+        return;
+    }
+    if (isDigest) {
+        const profile = loadProfile(authorName);
+        if (!profile || profile.entries.length === 0) {
+            console.log(`  No data for ${authorName}. Use --record to add findings.`);
+            return;
+        }
+        const sorted = [...profile.entries].sort((a, b) => b.count - a.count);
+        const top3 = sorted.slice(0, 3);
+        if (format === "json") {
+            console.log(JSON.stringify({
+                author: authorName,
+                digest: top3,
+                totalFindings: profile.totalFindings,
+                timestamp: new Date().toISOString(),
+            }, null, 2));
+        }
+        else {
+            console.log(`\n  Weekly Improvement Digest for ${authorName}\n  ──────────────────────────`);
+            console.log(`  Total findings: ${profile.totalFindings} across ${profile.entries.length} categories\n`);
+            for (const entry of top3) {
+                const trendIcon = entry.trend === "rising" ? "📈" : entry.trend === "declining" ? "📉" : "➡️";
+                console.log(`    ${trendIcon} ${entry.category} — ${entry.count} occurrences (${entry.trend})`);
+                console.log("        Suggested improvements:");
+                for (const r of entry.resources) {
+                    console.log(`          • ${r}`);
+                }
+                console.log("");
+            }
+        }
+        return;
+    }
+    // Default: show profile
+    const profile = loadProfile(authorName);
+    if (!profile || profile.entries.length === 0) {
+        console.log(`  No data for ${authorName}. Use --record to add findings.`);
+        return;
+    }
+    if (format === "json") {
+        console.log(JSON.stringify(profile, null, 2));
+    }
+    else {
+        console.log(`\n  Habit Profile: ${authorName}\n  ──────────────────────────`);
+        console.log(`  Total: ${profile.totalFindings} | Categories: ${profile.entries.length} | Top: ${profile.topCategory}\n`);
+        const sorted = [...profile.entries].sort((a, b) => b.count - a.count);
+        for (const entry of sorted) {
+            const bar = "█".repeat(Math.min(20, Math.floor((entry.count / Math.max(1, profile.totalFindings)) * 40)));
+            const trendIcon = entry.trend === "rising" ? "↑" : entry.trend === "declining" ? "↓" : "→";
+            console.log(`    ${entry.category.padEnd(25)} ${String(entry.count).padStart(4)} ${bar} ${trendIcon}`);
+        }
+        console.log("");
+    }
+}
+//# sourceMappingURL=habit-tracker.js.map