@kevinrabun/judges-cli 3.124.0

package/dist/commands/review-multi-repo-sync.js

@@ -0,0 +1,115 @@
+/**
+ * Review-multi-repo-sync — Synchronize review configs across multiple repositories.
+ */
+import { readFileSync, writeFileSync, existsSync } from "fs";
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function simpleHash(content) {
+    let hash = 0;
+    for (let i = 0; i < content.length; i++) {
+        const ch = content.charCodeAt(i);
+        hash = ((hash << 5) - hash + ch) | 0;
+    }
+    return Math.abs(hash).toString(16).padStart(8, "0");
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runReviewMultiRepoSync(argv) {
+    const storeIdx = argv.indexOf("--store");
+    const storePath = storeIdx >= 0 ? argv[storeIdx + 1] : ".judges-multi-repo.json";
+    const formatIdx = argv.indexOf("--format");
+    const format = formatIdx >= 0 ? argv[formatIdx + 1] : "table";
+    const addIdx = argv.indexOf("--add");
+    const addPath = addIdx >= 0 ? argv[addIdx + 1] : "";
+    const checkMode = argv.includes("--check");
+    const initMode = argv.includes("--init");
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges review-multi-repo-sync — Sync review configs across repos
+
+Usage:
+  judges review-multi-repo-sync [--store <path>] [--format table|json]
+  judges review-multi-repo-sync --init [--store <path>]
+  judges review-multi-repo-sync --add <repo-path> [--store <path>]
+  judges review-multi-repo-sync --check [--store <path>]
+
+Options:
+  --store <path>     Multi-repo store file (default: .judges-multi-repo.json)
+  --init             Create default multi-repo store
+  --add <path>       Add a repository by path
+  --check            Check config drift across repos
+  --format <fmt>     Output format: table (default), json
+  --help, -h         Show this help
+`);
+        return;
+    }
+    if (initMode) {
+        const defaultStore = {
+            repos: [],
+            sourceConfig: ".judgesrc",
+            lastUpdated: new Date().toISOString(),
+        };
+        writeFileSync(storePath, JSON.stringify(defaultStore, null, 2));
+        console.log(`Created multi-repo store: ${storePath}`);
+        return;
+    }
+    if (!existsSync(storePath)) {
+        console.log(`No multi-repo store found at: ${storePath}`);
+        console.log("Run with --init to create one.");
+        return;
+    }
+    const store = JSON.parse(readFileSync(storePath, "utf-8"));
+    if (addPath) {
+        const configFile = addPath.replace(/\/$/, "") + "/" + store.sourceConfig;
+        const hash = existsSync(configFile) ? simpleHash(readFileSync(configFile, "utf-8")) : "none";
+        const name = addPath.split("/").pop() ?? addPath;
+        store.repos.push({
+            name,
+            path: addPath,
+            configHash: hash,
+            lastSynced: new Date().toISOString(),
+            status: "unknown",
+        });
+        store.lastUpdated = new Date().toISOString();
+        writeFileSync(storePath, JSON.stringify(store, null, 2));
+        console.log(`Added repository: ${name} (${addPath})`);
+        return;
+    }
+    if (checkMode) {
+        let driftCount = 0;
+        const sourceHash = store.repos.length > 0 ? store.repos[0].configHash : "";
+        for (const repo of store.repos) {
+            const configFile = repo.path.replace(/\/$/, "") + "/" + store.sourceConfig;
+            if (existsSync(configFile)) {
+                const currentHash = simpleHash(readFileSync(configFile, "utf-8"));
+                repo.configHash = currentHash;
+                repo.status = currentHash === sourceHash ? "synced" : "drift";
+            }
+            else {
+                repo.status = "drift";
+            }
+            if (repo.status === "drift")
+                driftCount++;
+        }
+        store.lastUpdated = new Date().toISOString();
+        writeFileSync(storePath, JSON.stringify(store, null, 2));
+        console.log(`Checked ${store.repos.length} repos. Drift detected in ${driftCount}.`);
+        return;
+    }
+    if (format === "json") {
+        console.log(JSON.stringify(store, null, 2));
+        return;
+    }
+    console.log("\nMulti-Repo Sync Status");
+    console.log("═".repeat(70));
+    if (store.repos.length === 0) {
+        console.log("  No repositories registered. Use --add <path> to add one.");
+    }
+    else {
+        console.log(`  ${"Name".padEnd(20)} ${"Status".padEnd(10)} ${"Hash".padEnd(12)} Last Synced`);
+        console.log("  " + "─".repeat(65));
+        for (const repo of store.repos) {
+            console.log(`  ${repo.name.padEnd(20)} ${repo.status.padEnd(10)} ${repo.configHash.padEnd(12)} ${repo.lastSynced.slice(0, 10)}`);
+        }
+    }
+    console.log(`\n  Source config: ${store.sourceConfig}`);
+    console.log("═".repeat(70));
+}

package/dist/commands/review-multi-repo.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Review-multi-repo — Review across multiple repositories.
+ */
+export declare function runReviewMultiRepo(argv: string[]): void;

package/dist/commands/review-multi-repo.js

@@ -0,0 +1,145 @@
+/**
+ * Review-multi-repo — Review across multiple repositories.
+ */
+import { existsSync } from "fs";
+import { execSync } from "child_process";
+import { basename } from "path";
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runReviewMultiRepo(argv) {
+    const sub = argv[0];
+    if (!sub || sub === "--help" || sub === "-h") {
+        console.log(`
+judges review-multi-repo — Review across multiple repositories
+
+Usage:
+  judges review-multi-repo scan   --repos <dir1,dir2,...> [options]
+  judges review-multi-repo status --repos <dir1,dir2,...>
+  judges review-multi-repo summary --repos <dir1,dir2,...> [--format json]
+
+Subcommands:
+  scan       Run reviews across specified repositories
+  status     Show review status per repository
+  summary    Aggregate summary across repositories
+
+Options:
+  --repos <list>     Comma-separated repository directories (required)
+  --extensions <ext> File extensions to review (default: .ts,.js,.py)
+  --format json      JSON output
+  --help, -h         Show this help
+`);
+        return;
+    }
+    const args = argv.slice(1);
+    const reposStr = args.find((_a, i) => args[i - 1] === "--repos");
+    if (!reposStr) {
+        console.error("Error: --repos required");
+        process.exitCode = 1;
+        return;
+    }
+    const repos = reposStr
+        .split(",")
+        .map((r) => r.trim())
+        .filter(Boolean);
+    const format = args.find((_a, i) => args[i - 1] === "--format") || "text";
+    if (sub === "scan") {
+        const exts = args.find((_a, i) => args[i - 1] === "--extensions") || ".ts,.js,.py";
+        const extList = exts.split(",").map((e) => e.trim());
+        console.log(`\nMulti-Repo Scan:`);
+        console.log("═".repeat(65));
+        for (const repo of repos) {
+            if (!existsSync(repo)) {
+                console.log(`  ✗ ${repo} — not found`);
+                continue;
+            }
+            const name = basename(repo);
+            let fileCount;
+            try {
+                const files = execSync(`git -C "${repo}" ls-files`, { encoding: "utf-8" }).split("\n").filter(Boolean);
+                fileCount = files.filter((f) => extList.some((ext) => f.endsWith(ext))).length;
+            }
+            catch {
+                console.log(`  ✗ ${name} — not a git repository`);
+                continue;
+            }
+            // Check for .judges directory
+            const hasConfig = existsSync(`${repo}/.judges`) || existsSync(`${repo}/.judgesrc`);
+            const configStatus = hasConfig ? "configured" : "unconfigured";
+            console.log(`  ✓ ${name.padEnd(25)} ${String(fileCount).padStart(5)} files  [${configStatus}]`);
+        }
+        console.log("═".repeat(65));
+    }
+    else if (sub === "status") {
+        const statuses = [];
+        for (const repo of repos) {
+            const name = basename(repo);
+            if (!existsSync(repo)) {
+                statuses.push({ name, path: repo, exists: false, hasConfig: false, lastCommit: "", branch: "" });
+                continue;
+            }
+            const hasConfig = existsSync(`${repo}/.judges`) || existsSync(`${repo}/.judgesrc`);
+            let lastCommit = "";
+            let branch = "";
+            try {
+                lastCommit = execSync(`git -C "${repo}" log -1 --format=%ci`, { encoding: "utf-8" }).trim().slice(0, 10);
+                branch = execSync(`git -C "${repo}" rev-parse --abbrev-ref HEAD`, { encoding: "utf-8" }).trim();
+            }
+            catch {
+                /* not a git repo */
+            }
+            statuses.push({ name, path: repo, exists: true, hasConfig, lastCommit, branch });
+        }
+        if (format === "json") {
+            console.log(JSON.stringify(statuses, null, 2));
+            return;
+        }
+        console.log(`\nMulti-Repo Status:`);
+        console.log("═".repeat(70));
+        for (const s of statuses) {
+            if (!s.exists) {
+                console.log(`  ✗ ${s.name.padEnd(22)} NOT FOUND`);
+            }
+            else {
+                const cfg = s.hasConfig ? "✓" : "✗";
+                console.log(`  ✓ ${s.name.padEnd(22)} ${s.branch.padEnd(12)} last: ${s.lastCommit}  config: ${cfg}`);
+            }
+        }
+        console.log("═".repeat(70));
+    }
+    else if (sub === "summary") {
+        let totalFiles = 0;
+        let configuredCount = 0;
+        const repoSummaries = [];
+        for (const repo of repos) {
+            if (!existsSync(repo))
+                continue;
+            const name = basename(repo);
+            const hasConfig = existsSync(`${repo}/.judges`) || existsSync(`${repo}/.judgesrc`);
+            if (hasConfig)
+                configuredCount++;
+            let fileCount = 0;
+            try {
+                const files = execSync(`git -C "${repo}" ls-files`, { encoding: "utf-8" }).split("\n").filter(Boolean);
+                fileCount = files.length;
+            }
+            catch {
+                /* skip */
+            }
+            totalFiles += fileCount;
+            repoSummaries.push({ name, files: fileCount, configured: hasConfig });
+        }
+        if (format === "json") {
+            console.log(JSON.stringify({ repos: repoSummaries.length, configured: configuredCount, totalFiles }, null, 2));
+            return;
+        }
+        console.log(`\nMulti-Repo Summary:`);
+        console.log("═".repeat(55));
+        console.log(`  Repositories: ${repoSummaries.length}`);
+        console.log(`  Configured:   ${configuredCount}`);
+        console.log(`  Total files:  ${totalFiles}`);
+        console.log("═".repeat(55));
+    }
+    else {
+        console.error(`Unknown subcommand: ${sub}. Use --help for usage.`);
+        process.exitCode = 1;
+    }
+}

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

@@ -0,0 +1,4 @@
+/**
+ * Review-note — Attach notes to reviews.
+ */
+export declare function runReviewNote(argv: string[]): void;

package/dist/commands/review-note.js

@@ -0,0 +1,104 @@
+/**
+ * Review-note — Attach notes to reviews.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { dirname } from "path";
+// ─── Storage ────────────────────────────────────────────────────────────────
+const NOTE_FILE = ".judges/review-notes.json";
+function loadStore() {
+    if (!existsSync(NOTE_FILE))
+        return { version: "1.0.0", notes: [] };
+    try {
+        return JSON.parse(readFileSync(NOTE_FILE, "utf-8"));
+    }
+    catch {
+        return { version: "1.0.0", notes: [] };
+    }
+}
+function saveStore(store) {
+    mkdirSync(dirname(NOTE_FILE), { recursive: true });
+    writeFileSync(NOTE_FILE, JSON.stringify(store, null, 2), "utf-8");
+}
+function generateId() {
+    return `note-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runReviewNote(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges review-note — Attach notes to reviews
+
+Usage:
+  judges review-note add --review <id> --text "Needs follow-up"
+  judges review-note list
+  judges review-note list --review <id>
+  judges review-note remove --id <id>
+  judges review-note clear
+
+Subcommands:
+  add                   Add a note to a review
+  list                  List all notes (or for a specific review)
+  remove                Remove a note by ID
+  clear                 Clear all notes
+
+Options:
+  --review <id>         Review identifier
+  --text <text>         Note content
+  --author <name>       Note author
+  --format json         JSON output
+  --help, -h            Show this help
+
+Notes stored in .judges/review-notes.json.
+`);
+        return;
+    }
+    const subcommand = argv.find((a) => ["add", "list", "remove", "clear"].includes(a));
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const store = loadStore();
+    if (subcommand === "add") {
+        const reviewId = argv.find((_a, i) => argv[i - 1] === "--review") || "";
+        const text = argv.find((_a, i) => argv[i - 1] === "--text") || "";
+        const author = argv.find((_a, i) => argv[i - 1] === "--author") || "";
+        if (!text) {
+            console.log("Specify --text for the note content.");
+            return;
+        }
+        const note = { id: generateId(), reviewId, text, author, createdAt: new Date().toISOString() };
+        store.notes.push(note);
+        saveStore(store);
+        console.log(`Note added (${note.id}) to review ${reviewId || "(general)"}.`);
+        return;
+    }
+    if (subcommand === "remove") {
+        const id = argv.find((_a, i) => argv[i - 1] === "--id") || "";
+        const before = store.notes.length;
+        store.notes = store.notes.filter((n) => n.id !== id);
+        saveStore(store);
+        console.log(before > store.notes.length ? `Removed ${id}.` : `${id} not found.`);
+        return;
+    }
+    if (subcommand === "clear") {
+        saveStore({ version: "1.0.0", notes: [] });
+        console.log("All notes cleared.");
+        return;
+    }
+    // Default: list
+    const reviewFilter = argv.find((_a, i) => argv[i - 1] === "--review") || "";
+    const notes = reviewFilter ? store.notes.filter((n) => n.reviewId === reviewFilter) : store.notes;
+    if (notes.length === 0) {
+        console.log("No notes found.");
+        return;
+    }
+    if (format === "json") {
+        console.log(JSON.stringify(notes, null, 2));
+        return;
+    }
+    console.log(`\nReview Notes (${notes.length}):`);
+    console.log("─".repeat(60));
+    for (const n of notes) {
+        const authorTag = n.author ? ` by ${n.author}` : "";
+        console.log(`  ${n.id}  ${n.createdAt.slice(0, 10)}${authorTag}  review=${n.reviewId || "(general)"}`);
+        console.log(`    "${n.text}"`);
+    }
+    console.log("─".repeat(60));
+}

package/dist/commands/review-notification-config.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Review-notification-config — Configure notification preferences for review results.
+ */
+export declare function runReviewNotificationConfig(argv: string[]): void;

package/dist/commands/review-notification-config.js

@@ -0,0 +1,122 @@
+/**
+ * Review-notification-config — Configure notification preferences for review results.
+ */
+import { readFileSync, writeFileSync, existsSync } from "fs";
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runReviewNotificationConfig(argv) {
+    const fileIdx = argv.indexOf("--file");
+    const enableIdx = argv.indexOf("--enable");
+    const disableIdx = argv.indexOf("--disable");
+    const severityIdx = argv.indexOf("--severity");
+    const digestIdx = argv.indexOf("--digest");
+    const formatIdx = argv.indexOf("--format");
+    const configPath = fileIdx >= 0 ? argv[fileIdx + 1] : ".judges-notifications.json";
+    const format = formatIdx >= 0 ? argv[formatIdx + 1] : "table";
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges review-notification-config — Configure notification preferences
+
+Usage:
+  judges review-notification-config [--file <config>] [--enable <channel>]
+                                    [--disable <channel>] [--severity <level>]
+                                    [--digest daily|weekly] [--format table|json]
+
+Options:
+  --file <path>        Config file (default: .judges-notifications.json)
+  --enable <channel>   Enable: console, file, slack, email
+  --disable <channel>  Disable a channel
+  --severity <level>   Set min severity for notifications
+  --digest <freq>      Enable digest: daily, weekly
+  --format <fmt>       Output format: table (default), json
+  --help, -h           Show this help
+`);
+        return;
+    }
+    // Load or init config
+    let config;
+    if (existsSync(configPath)) {
+        config = JSON.parse(readFileSync(configPath, "utf-8"));
+    }
+    else {
+        config = {
+            channels: [
+                { type: "console", enabled: true, minSeverity: "medium" },
+                { type: "file", enabled: false, minSeverity: "low" },
+                { type: "slack", enabled: false, minSeverity: "high" },
+                { type: "email", enabled: false, minSeverity: "critical" },
+            ],
+            digest: false,
+            digestFrequency: "daily",
+        };
+    }
+    let changed = false;
+    // Enable channel
+    if (enableIdx >= 0) {
+        const channel = argv[enableIdx + 1];
+        const ch = config.channels.find((c) => c.type === channel);
+        if (ch) {
+            ch.enabled = true;
+            changed = true;
+            console.log(`Enabled ${channel} notifications.`);
+        }
+        else {
+            config.channels.push({ type: channel, enabled: true, minSeverity: "medium" });
+            changed = true;
+            console.log(`Added and enabled ${channel} notifications.`);
+        }
+    }
+    // Disable channel
+    if (disableIdx >= 0) {
+        const channel = argv[disableIdx + 1];
+        const ch = config.channels.find((c) => c.type === channel);
+        if (ch) {
+            ch.enabled = false;
+            changed = true;
+            console.log(`Disabled ${channel} notifications.`);
+        }
+        else {
+            console.error(`Channel not found: ${channel}`);
+        }
+    }
+    // Set severity
+    if (severityIdx >= 0) {
+        const sev = argv[severityIdx + 1];
+        for (const ch of config.channels) {
+            if (ch.enabled) {
+                ch.minSeverity = sev;
+            }
+        }
+        changed = true;
+        console.log(`Set min severity to ${sev} for enabled channels.`);
+    }
+    // Digest
+    if (digestIdx >= 0) {
+        const freq = argv[digestIdx + 1];
+        config.digest = true;
+        config.digestFrequency = freq;
+        changed = true;
+        console.log(`Enabled ${freq} digest.`);
+    }
+    if (changed) {
+        writeFileSync(configPath, JSON.stringify(config, null, 2));
+        console.log(`Config saved to ${configPath}`);
+        return;
+    }
+    // Display current config
+    if (format === "json") {
+        console.log(JSON.stringify(config, null, 2));
+        return;
+    }
+    console.log(`\nNotification Configuration`);
+    console.log("═".repeat(55));
+    console.log(`  Digest: ${config.digest ? `enabled (${config.digestFrequency})` : "disabled"}`);
+    console.log(`\n  Channels:`);
+    for (const ch of config.channels) {
+        const status = ch.enabled ? "ON " : "OFF";
+        console.log(`    [${status}] ${ch.type.padEnd(10)} min: ${ch.minSeverity}`);
+    }
+    if (config.quietHours) {
+        console.log(`\n  Quiet Hours: ${config.quietHours.start} – ${config.quietHours.end}`);
+    }
+    console.log("═".repeat(55));
+}

package/dist/commands/review-notification-digest.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Review-notification-digest — Generate notification digests for review activity.
+ */
+export declare function runReviewNotificationDigest(argv: string[]): void;

package/dist/commands/review-notification-digest.js

@@ -0,0 +1,64 @@
+/**
+ * Review-notification-digest — Generate notification digests for review activity.
+ */
+import { readFileSync, existsSync } from "fs";
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runReviewNotificationDigest(argv) {
+    const storeIdx = argv.indexOf("--store");
+    const storePath = storeIdx >= 0 ? argv[storeIdx + 1] : ".judges-notifications.json";
+    const formatIdx = argv.indexOf("--format");
+    const format = formatIdx >= 0 ? argv[formatIdx + 1] : "table";
+    const unreadOnly = argv.includes("--unread");
+    const lastN = argv.indexOf("--last");
+    const lastCount = lastN >= 0 ? parseInt(argv[lastN + 1], 10) : 0;
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges review-notification-digest — Generate notification digests
+
+Usage:
+  judges review-notification-digest [--store <path>] [--unread] [--last <n>] [--format table|json]
+
+Options:
+  --store <path>     Notification store (default: .judges-notifications.json)
+  --unread           Show only unread notifications
+  --last <n>         Show only the last N notifications
+  --format <fmt>     Output format: table (default), json
+  --help, -h         Show this help
+`);
+        return;
+    }
+    if (!existsSync(storePath)) {
+        console.log(`No notification store found at: ${storePath}`);
+        console.log("Notifications are generated automatically during reviews.");
+        return;
+    }
+    const store = JSON.parse(readFileSync(storePath, "utf-8"));
+    let notifications = store.notifications;
+    if (unreadOnly) {
+        notifications = notifications.filter((n) => !n.read);
+    }
+    if (lastCount > 0) {
+        notifications = notifications.slice(-lastCount);
+    }
+    if (format === "json") {
+        console.log(JSON.stringify(notifications, null, 2));
+        return;
+    }
+    console.log(`\nNotification Digest (${notifications.length})`);
+    console.log("═".repeat(80));
+    if (notifications.length === 0) {
+        console.log("  No notifications to display.");
+    }
+    else {
+        console.log(`  ${"ID".padEnd(10)} ${"Type".padEnd(10)} ${"Severity".padEnd(10)} ${"Read".padEnd(6)} ${"Date".padEnd(14)} Message`);
+        console.log("  " + "─".repeat(75));
+        for (const n of notifications) {
+            const readIcon = n.read ? "Yes" : "No";
+            const msg = n.message.length > 25 ? n.message.slice(0, 22) + "..." : n.message;
+            console.log(`  ${n.id.padEnd(10)} ${n.type.padEnd(10)} ${n.severity.padEnd(10)} ${readIcon.padEnd(6)} ${n.timestamp.slice(0, 10).padEnd(14)} ${msg}`);
+        }
+    }
+    const unread = store.notifications.filter((n) => !n.read).length;
+    console.log(`\n  Total: ${store.notifications.length} | Unread: ${unread}`);
+    console.log("═".repeat(80));
+}

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

@@ -0,0 +1,4 @@
+/**
+ * Review-notification — Configure and display review notification settings.
+ */
+export declare function runReviewNotification(argv: string[]): void;