npm - @kevinrabun/judges - Versions diffs - 3.1.0 → 3.1.1 - Mend

@kevinrabun/judges 3.1.0 → 3.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/README.md CHANGED Viewed

@@ -9,12 +9,100 @@ An MCP (Model Context Protocol) server that provides a panel of **35 specialized
 [![CI](https://github.com/KevinRabun/judges/actions/workflows/ci.yml/badge.svg)](https://github.com/KevinRabun/judges/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@kevinrabun/judges)](https://www.npmjs.com/package/@kevinrabun/judges)
+[![npm downloads](https://img.shields.io/npm/dw/@kevinrabun/judges)](https://www.npmjs.com/package/@kevinrabun/judges)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Tests](https://img.shields.io/badge/tests-899-brightgreen)](https://github.com/KevinRabun/judges/actions)
+---
+## Why Judges?
+AI code generators (Copilot, Cursor, Claude, ChatGPT, etc.) write code fast — but they routinely produce **insecure defaults, missing auth, hardcoded secrets, and poor error handling**. Human reviewers catch some of this, but nobody reviews 35 dimensions consistently.
+| | ESLint / Biome | SonarQube | Semgrep / CodeQL | **Judges** |
+|---|---|---|---|---|
+| **Scope** | Style + some bugs | Bugs + code smells | Security patterns | **35 domains**: security, cost, compliance, a11y, API design, cloud, UX, … |
+| **AI-generated code focus** | No | No | Partial | **Purpose-built** for AI output failure modes |
+| **Setup** | Config per project | Server + scanner | Cloud or local | **One command**: `npx @kevinrabun/judges eval file.ts` |
+| **Auto-fix patches** | Some | No | No | **47 deterministic patches** — no LLM needed |
+| **Non-technical output** | No | Dashboard | No | **Plain-language findings** with What/Why/Next |
+| **MCP native** | No | No | No | **Yes** — works inside Copilot, Claude, Cursor |
+| **SARIF output** | No | Yes | Yes | **Yes** — upload to GitHub Code Scanning |
+| **Cost** | Free | $$$$ | Free/paid | **Free / MIT** |
+**Judges doesn't replace linters** — it covers the dimensions linters don't: authentication strategy, data sovereignty, cost patterns, accessibility, framework-specific anti-patterns, and architectural issues across multiple files.
 ---
 ## Quick Start
+### Try it now (no clone needed)
+```bash
+# Install globally
+npm install -g @kevinrabun/judges
+# Evaluate any file
+judges eval src/app.ts
+# Pipe from stdin
+cat api.py | judges eval --language python
+# Single judge
+judges eval --judge cybersecurity server.ts
+# SARIF output for CI
+judges eval --file app.ts --format sarif > results.sarif
+# List all 35 judges
+judges list
+```
+### Use in GitHub Actions
+Add Judges to your CI pipeline with zero configuration:
+```yaml
+# .github/workflows/judges.yml
+name: Judges Code Review
+on: [pull_request]
+jobs:
+  judges:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      security-events: write  # only if using upload-sarif
+    steps:
+      - uses: actions/checkout@v4
+      - uses: KevinRabun/judges@main
+        with:
+          path: src/api.ts        # file or directory
+          format: text             # text | json | sarif | markdown
+          upload-sarif: true       # upload to GitHub Code Scanning
+          fail-on-findings: true   # fail CI on critical/high findings
+```
+**Outputs** available for downstream steps: `verdict`, `score`, `findings`, `critical`, `high`, `sarif-file`.
+### Use with Docker (no Node.js required)
+```bash
+# Build the image
+docker build -t judges .
+# Evaluate a local file
+docker run --rm -v $(pwd):/code judges eval --file /code/app.ts
+# Pipe from stdin
+cat api.py | docker run --rm -i judges eval --language python
+# List judges
+docker run --rm judges list
+```
+### Or use as an MCP server
 ### 1. Install and Build
 ```bash

package/dist/api.d.ts CHANGED Viewed

@@ -19,6 +19,7 @@ export { LRUCache, contentHash } from "./cache.js";
 export { clearProjectCache } from "./evaluators/project.js";
 export { findingsToSarif, evaluationToSarif, verdictToSarif, validateSarifLog } from "./formatters/sarif.js";
 export type { SarifValidationError } from "./formatters/sarif.js";
+export { runCli } from "./cli.js";
 import type { EvaluationOptions } from "./evaluators/index.js";
 import type { JudgeEvaluation, TribunalVerdict } from "./types.js";
 /**

package/dist/api.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,YAAY,EACV,QAAQ,EACR,OAAO,EACP,OAAO,EACP,KAAK,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGpF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAIxE,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAGnG,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC7G,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;~~AAKlE~~,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAInE;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,eAAe,CAEzG;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,eAAe,CAMjB"}
1	+ {"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,YAAY,EACV,QAAQ,EACR,OAAO,EACP,OAAO,EACP,KAAK,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGpF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAIxE,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAGnG,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC7G,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAKlC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAInE;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,eAAe,CAEzG;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,eAAe,CAMjB"}

package/dist/api.js CHANGED Viewed

@@ -25,6 +25,8 @@ export { LRUCache, contentHash } from "./cache.js";
 export { clearProjectCache } from "./evaluators/project.js";
 // ─── Formatters ──────────────────────────────────────────────────────────────
 export { findingsToSarif, evaluationToSarif, verdictToSarif, validateSarifLog } from "./formatters/sarif.js";
+// ─── CLI ─────────────────────────────────────────────────────────────────────
+export { runCli } from "./cli.js";
 // ─── Convenience Aliases ─────────────────────────────────────────────────────
 import { evaluateWithTribunal, evaluateWithJudge } from "./evaluators/index.js";
 import { getJudge } from "./judges/index.js";

package/dist/api.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA+BH,gFAAgF;AAChF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEpF,gFAAgF;AAChF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEzD,gFAAgF;AAChF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAExE,gFAAgF;AAEhF,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,+EAA+E;AAC/E,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEnG,gFAAgF;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,gFAAgF;AAChF,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG7G,gFAAgF;AAEhF,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAGhF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAgB,EAAE,OAA2B;IACtF,OAAO,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,IAAY,EACZ,QAAgB,EAChB,OAA2B;IAE3B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CAAC,mBAAmB,OAAO,GAAG,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC"}
1	+ {"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA+BH,gFAAgF;AAChF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEpF,gFAAgF;AAChF,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEzD,gFAAgF;AAChF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAExE,gFAAgF;AAEhF,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,+EAA+E;AAC/E,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEnG,gFAAgF;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,gFAAgF;AAChF,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG7G,gFAAgF;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,gFAAgF;AAEhF,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAGhF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAgB,EAAE,OAA2B;IACtF,OAAO,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,IAAY,EACZ,QAAgB,EAChB,OAA2B;IAE3B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CAAC,mBAAmB,OAAO,GAAG,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC"}

package/dist/cli.d.ts ADDED Viewed

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * Judges Panel — CLI Evaluator
+ *
+ * Evaluate code directly from the command line without MCP setup.
+ *
+ * Usage:
+ *   judges eval --file src/app.ts                         # evaluate a file
+ *   judges eval --file src/app.ts --language python       # explicit language
+ *   judges eval --file src/app.ts --format sarif          # SARIF output
+ *   judges eval --file src/app.ts --judge cybersecurity   # single judge
+ *   cat src/app.ts | judges eval --language typescript    # stdin pipe
+ *   judges eval --help                                    # show help
+ */
+export declare function runCli(argv: string[]): void;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAgTH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAiD3C"}

package/dist/cli.js ADDED Viewed

@@ -0,0 +1,317 @@
+#!/usr/bin/env node
+/**
+ * Judges Panel — CLI Evaluator
+ *
+ * Evaluate code directly from the command line without MCP setup.
+ *
+ * Usage:
+ *   judges eval --file src/app.ts                         # evaluate a file
+ *   judges eval --file src/app.ts --language python       # explicit language
+ *   judges eval --file src/app.ts --format sarif          # SARIF output
+ *   judges eval --file src/app.ts --judge cybersecurity   # single judge
+ *   cat src/app.ts | judges eval --language typescript    # stdin pipe
+ *   judges eval --help                                    # show help
+ */
+import { readFileSync, existsSync } from "fs";
+import { resolve, extname } from "path";
+import { evaluateWithTribunal, evaluateWithJudge, formatVerdictAsMarkdown, formatEvaluationAsMarkdown, } from "./evaluators/index.js";
+import { getJudge, getJudgeSummaries } from "./judges/index.js";
+import { verdictToSarif } from "./formatters/sarif.js";
+// ─── Language Detection from Extension ──────────────────────────────────────
+const EXT_TO_LANG = {
+    ".ts": "typescript",
+    ".tsx": "typescript",
+    ".js": "javascript",
+    ".jsx": "javascript",
+    ".mjs": "javascript",
+    ".cjs": "javascript",
+    ".py": "python",
+    ".rs": "rust",
+    ".go": "go",
+    ".java": "java",
+    ".cs": "csharp",
+    ".rb": "ruby",
+    ".php": "php",
+    ".swift": "swift",
+    ".kt": "kotlin",
+    ".scala": "scala",
+    ".c": "c",
+    ".cpp": "cpp",
+    ".h": "c",
+    ".hpp": "cpp",
+    ".yaml": "yaml",
+    ".yml": "yaml",
+    ".json": "json",
+    ".tf": "terraform",
+    ".hcl": "terraform",
+    ".dockerfile": "dockerfile",
+    ".sh": "bash",
+    ".bash": "bash",
+};
+function detectLanguage(filePath) {
+    if (!filePath)
+        return undefined;
+    const base = filePath.toLowerCase();
+    if (base.endsWith("dockerfile") || base.includes("dockerfile."))
+        return "dockerfile";
+    const ext = extname(base);
+    return EXT_TO_LANG[ext];
+}
+function parseCliArgs(argv) {
+    const args = {
+        command: undefined,
+        file: undefined,
+        language: undefined,
+        format: "text",
+        judge: undefined,
+        help: false,
+    };
+    // First non-flag arg is the command
+    let i = 2; // skip node + script
+    if (i < argv.length && !argv[i].startsWith("-")) {
+        args.command = argv[i];
+        i++;
+    }
+    for (; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case "--file":
+            case "-f":
+                args.file = argv[++i];
+                break;
+            case "--language":
+            case "-l":
+                args.language = argv[++i];
+                break;
+            case "--format":
+            case "-o":
+                args.format = argv[++i];
+                break;
+            case "--judge":
+            case "-j":
+                args.judge = argv[++i];
+                break;
+            case "--help":
+            case "-h":
+                args.help = true;
+                break;
+            default:
+                // If it looks like a file path (not a flag), treat as --file
+                if (!arg.startsWith("-") && !args.file) {
+                    args.file = arg;
+                }
+                break;
+        }
+    }
+    return args;
+}
+// ─── Help Text ──────────────────────────────────────────────────────────────
+function printHelp() {
+    console.log(`
+Judges Panel — CLI Code Evaluator
+USAGE:
+  judges eval [options] [file]        Evaluate code with the full tribunal
+  judges eval --judge <id> [file]     Evaluate with a single judge
+  judges list                         List all available judges
+  judges --help                       Show this help
+OPTIONS:
+  --file, -f <path>       File to evaluate (or pass as positional arg)
+  --language, -l <lang>   Language override (auto-detected from extension)
+  --format, -o <fmt>      Output format: text (default), json, sarif, markdown
+  --judge, -j <id>        Run a single judge instead of the full tribunal
+  --help, -h              Show this help
+STDIN:
+  cat file.ts | judges eval --language typescript
+EXAMPLES:
+  judges eval src/app.ts
+  judges eval --file api.py --format sarif
+  judges eval --judge cybersecurity server.ts
+  judges eval --format json < main.go --language go
+  judges list
+SUPPORTED LANGUAGES:
+  typescript, javascript, python, rust, go, java, csharp,
+  ruby, php, swift, kotlin, scala, c, cpp, yaml, json,
+  terraform, dockerfile, bash
+`);
+}
+// ─── Read Code Input ────────────────────────────────────────────────────────
+function readCode(filePath) {
+    if (filePath) {
+        const resolved = resolve(filePath);
+        if (!existsSync(resolved)) {
+            console.error(`Error: File not found: ${resolved}`);
+            process.exit(1);
+        }
+        return { code: readFileSync(resolved, "utf-8"), resolvedPath: resolved };
+    }
+    // Try reading from stdin
+    if (!process.stdin.isTTY) {
+        try {
+            const code = readFileSync(0, "utf-8"); // fd 0 = stdin
+            return { code, resolvedPath: undefined };
+        }
+        catch {
+            console.error("Error: Could not read from stdin");
+            process.exit(1);
+        }
+    }
+    console.error("Error: No file specified and no stdin input detected.");
+    console.error("Usage: judges eval --file <path> or cat file | judges eval --language <lang>");
+    process.exit(1);
+}
+// ─── Format Output ──────────────────────────────────────────────────────────
+function formatTribunalOutput(verdict, format, filePath) {
+    switch (format) {
+        case "json":
+            return JSON.stringify(verdict, null, 2);
+        case "sarif":
+            return JSON.stringify(verdictToSarif(verdict, filePath), null, 2);
+        case "markdown":
+            return formatVerdictAsMarkdown(verdict);
+        case "text":
+        default:
+            return formatTextOutput(verdict);
+    }
+}
+function formatTextOutput(verdict) {
+    const lines = [];
+    const totalFindings = verdict.evaluations.reduce((s, e) => s + e.findings.length, 0);
+    lines.push("╔══════════════════════════════════════════════════════════════╗");
+    lines.push("║              Judges Panel — Evaluation Result               ║");
+    lines.push("╚══════════════════════════════════════════════════════════════╝");
+    lines.push("");
+    lines.push(`  Verdict  : ${verdict.overallVerdict.toUpperCase()}`);
+    lines.push(`  Score    : ${verdict.overallScore}/100`);
+    lines.push(`  Critical : ${verdict.criticalCount}`);
+    lines.push(`  High     : ${verdict.highCount}`);
+    lines.push(`  Findings : ${totalFindings}`);
+    lines.push(`  Judges   : ${verdict.evaluations.length}`);
+    lines.push("");
+    // Per-judge table
+    lines.push("  Per-Judge Breakdown:");
+    lines.push("  " + "─".repeat(60));
+    for (const evaluation of verdict.evaluations) {
+        const icon = evaluation.verdict === "pass" ? "✅" : evaluation.verdict === "warning" ? "⚠️ " : "❌";
+        const name = evaluation.judgeName.padEnd(28);
+        const score = String(evaluation.score).padStart(3);
+        const findings = String(evaluation.findings.length).padStart(2);
+        lines.push(`  ${icon} ${name} ${score}/100   ${findings} finding(s)`);
+    }
+    lines.push("");
+    // Top findings
+    const allFindings = verdict.evaluations.flatMap((e) => e.findings);
+    const critical = allFindings.filter((f) => f.severity === "critical" || f.severity === "high");
+    if (critical.length > 0) {
+        lines.push("  Critical & High Findings:");
+        lines.push("  " + "─".repeat(60));
+        for (const f of critical.slice(0, 20)) {
+            lines.push(`  [${f.severity.toUpperCase().padEnd(8)}] ${f.ruleId}: ${f.title}`);
+            if (f.lineNumbers && f.lineNumbers.length > 0) {
+                lines.push(`             Line ${f.lineNumbers[0]}: ${f.description.slice(0, 100)}`);
+            }
+        }
+        if (critical.length > 20) {
+            lines.push(`  ... and ${critical.length - 20} more critical/high findings`);
+        }
+        lines.push("");
+    }
+    // Exit guidance
+    if (verdict.overallVerdict === "fail") {
+        lines.push("  ⛔ FAIL — This code has issues that should be addressed before shipping.");
+    }
+    else if (verdict.overallVerdict === "warning") {
+        lines.push("  ⚠️  WARNING — Review findings above before proceeding.");
+    }
+    else {
+        lines.push("  ✅ PASS — No critical issues detected.");
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+function formatSingleJudgeTextOutput(evaluation) {
+    const lines = [];
+    lines.push("╔══════════════════════════════════════════════════════════════╗");
+    lines.push(`║  Judge: ${evaluation.judgeName.padEnd(49)}║`);
+    lines.push("╚══════════════════════════════════════════════════════════════╝");
+    lines.push("");
+    lines.push(`  Verdict  : ${evaluation.verdict.toUpperCase()}`);
+    lines.push(`  Score    : ${evaluation.score}/100`);
+    lines.push(`  Findings : ${evaluation.findings.length}`);
+    lines.push("");
+    for (const f of evaluation.findings) {
+        lines.push(`  [${f.severity.toUpperCase().padEnd(8)}] ${f.ruleId}: ${f.title}`);
+        if (f.lineNumbers && f.lineNumbers.length > 0) {
+            lines.push(`             Line ${f.lineNumbers[0]}: ${f.description.slice(0, 120)}`);
+        }
+        if (f.suggestedFix) {
+            lines.push(`             Fix: ${f.suggestedFix.slice(0, 120)}`);
+        }
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+// ─── List Judges ────────────────────────────────────────────────────────────
+function listJudges() {
+    const judges = getJudgeSummaries();
+    console.log("");
+    console.log("  Available Judges:");
+    console.log("  " + "─".repeat(60));
+    for (const j of judges) {
+        console.log(`  ${j.id.padEnd(30)} ${j.name}`);
+    }
+    console.log("");
+    console.log(`  Total: ${judges.length} judges`);
+    console.log("");
+}
+// ─── Main CLI Entry Point ───────────────────────────────────────────────────
+export function runCli(argv) {
+    const args = parseCliArgs(argv);
+    if (args.help || (!args.command && !args.file)) {
+        printHelp();
+        process.exit(0);
+    }
+    if (args.command === "list") {
+        listJudges();
+        process.exit(0);
+    }
+    if (args.command === "eval" || args.file) {
+        const { code, resolvedPath } = readCode(args.file);
+        const language = args.language || detectLanguage(args.file || resolvedPath) || "typescript";
+        if (args.judge) {
+            // Single judge mode
+            const judge = getJudge(args.judge);
+            if (!judge) {
+                console.error(`Error: Unknown judge "${args.judge}"`);
+                console.error("Run 'judges list' to see available judges.");
+                process.exit(1);
+            }
+            const evaluation = evaluateWithJudge(judge, code, language);
+            if (args.format === "json") {
+                console.log(JSON.stringify(evaluation, null, 2));
+            }
+            else if (args.format === "markdown") {
+                console.log(formatEvaluationAsMarkdown(evaluation));
+            }
+            else {
+                console.log(formatSingleJudgeTextOutput(evaluation));
+            }
+        }
+        else {
+            // Full tribunal mode
+            const verdict = evaluateWithTribunal(code, language);
+            console.log(formatTribunalOutput(verdict, args.format, resolvedPath || args.file));
+        }
+        // Set exit code based on verdict
+        process.exit(0);
+    }
+    // Unknown command
+    console.error(`Unknown command: ${args.command}`);
+    printHelp();
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/index.d.ts CHANGED Viewed

@@ -1,22 +1,20 @@
 #!/usr/bin/env node
 /**
- * Judges Panel — MCP Server
+ * Judges Panel — MCP Server + CLI
  *
- * An MCP server that provides a panel of specialized judges to evaluate
- * AI-generated code. Each tool returns both automated pattern-detection
- * findings AND the judge's deep-review criteria, enabling the calling LLM
- * to perform thorough contextual analysis beyond what static patterns catch.
+ * When invoked with a subcommand (eval, list, --help), runs as a CLI tool.
+ * Otherwise, starts as an MCP stdio server.
  *
- * Tools exposed:
- *   - get_judges:                 List all available judges
- *   - evaluate_v2:                Context/evidence-aware V2 evaluation
- *   - evaluate_app_builder_flow:  3-step workflow (review, translate, tasks)
- *   - evaluate_public_repo_report: Clone public repo and generate full report
- *   - evaluate_code:              Full panel review (all judges)
- *   - evaluate_code_single_judge: Review by a specific judge
- *   - evaluate_project:           Multi-file project analysis
- *   - evaluate_diff:              Changed-line-only diff analysis
- *   - analyze_dependencies:       Supply-chain manifest analysis
+ * CLI usage:
+ *   judges eval --file src/app.ts                   # evaluate a file
+ *   judges eval --file src/app.ts --format sarif     # SARIF output
+ *   judges eval --judge cybersecurity server.ts      # single judge
+ *   cat file.ts | judges eval --language typescript  # stdin pipe
+ *   judges list                                      # list all judges
+ *   judges --help                                    # show help
+ *
+ * MCP usage:
+ *   Add to your MCP config (VS Code, Claude Desktop, etc.)
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA~~;;;;;;;;;;;;;;;;;;GAkBG~~"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/index.js CHANGED Viewed

@@ -1,43 +1,51 @@
 #!/usr/bin/env node
 /**
- * Judges Panel — MCP Server
+ * Judges Panel — MCP Server + CLI
  *
- * An MCP server that provides a panel of specialized judges to evaluate
- * AI-generated code. Each tool returns both automated pattern-detection
- * findings AND the judge's deep-review criteria, enabling the calling LLM
- * to perform thorough contextual analysis beyond what static patterns catch.
+ * When invoked with a subcommand (eval, list, --help), runs as a CLI tool.
+ * Otherwise, starts as an MCP stdio server.
  *
- * Tools exposed:
- *   - get_judges:                 List all available judges
- *   - evaluate_v2:                Context/evidence-aware V2 evaluation
- *   - evaluate_app_builder_flow:  3-step workflow (review, translate, tasks)
- *   - evaluate_public_repo_report: Clone public repo and generate full report
- *   - evaluate_code:              Full panel review (all judges)
- *   - evaluate_code_single_judge: Review by a specific judge
- *   - evaluate_project:           Multi-file project analysis
- *   - evaluate_diff:              Changed-line-only diff analysis
- *   - analyze_dependencies:       Supply-chain manifest analysis
+ * CLI usage:
+ *   judges eval --file src/app.ts                   # evaluate a file
+ *   judges eval --file src/app.ts --format sarif     # SARIF output
+ *   judges eval --judge cybersecurity server.ts      # single judge
+ *   cat file.ts | judges eval --language typescript  # stdin pipe
+ *   judges list                                      # list all judges
+ *   judges --help                                    # show help
+ *
+ * MCP usage:
+ *   Add to your MCP config (VS Code, Claude Desktop, etc.)
  */
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { registerTools } from "./tools/register.js";
-import { registerPrompts } from "./tools/prompts.js";
-// ─── Create MCP Server ──────────────────────────────────────────────────────
-const server = new McpServer({
-    name: "judges",
-    version: "2.0.0",
-});
-// ─── Register Tools & Prompts ────────────────────────────────────────────────
-registerTools(server);
-registerPrompts(server);
-// ─── Start Server ────────────────────────────────────────────────────────────
-async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    console.error("Judges Panel MCP server running on stdio");
+// ─── CLI Detection ──────────────────────────────────────────────────────────
+// If the user passed a subcommand or flag, run as CLI instead of MCP server.
+const cliCommands = new Set(["eval", "list", "evaluate"]);
+const cliFlags = new Set(["--help", "-h", "--file", "-f", "--version", "-v"]);
+const firstArg = process.argv[2];
+if (firstArg && (cliCommands.has(firstArg) || cliFlags.has(firstArg))) {
+    // Dynamic import to avoid loading MCP SDK when running as CLI
+    import("./cli.js").then(({ runCli }) => runCli(process.argv));
+}
+else {
+    // ─── MCP Server Mode ────────────────────────────────────────────────────
+    import("@modelcontextprotocol/sdk/server/mcp.js")
+        .then(async ({ McpServer }) => {
+        const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+        const { registerTools } = await import("./tools/register.js");
+        const { registerPrompts } = await import("./tools/prompts.js");
+        const server = new McpServer({
+            name: "judges",
+            version: "3.1.1",
+        });
+        registerTools(server);
+        registerPrompts(server);
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error("Judges Panel MCP server running on stdio");
+    })
+        .catch((err) => {
+        console.error("Failed to start Judges Panel:", err);
+        process.exit(1);
+    });
 }
-main().catch((err) => {
-    console.error("Failed to start Judges Panel:", err);
-    process.exit(1);
-});
+export {};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA~~;;;;;;;;;;;;;;;;;;GAkBG~~;AAEH,OAAO,EAAE,~~SAAS~~,EAAE,MAAM,yCAAyC,CAAC;~~AACpE~~,~~OAAO~~,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;~~AAEjF~~,~~OAAO~~,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;~~AACpD~~,~~OAAO~~,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;~~AAErD,+EAA+E;AAE~~/E,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;~~IAC3B~~,IAAI,EAAE,QAAQ;~~IACd~~,OAAO,EAAE,OAAO;~~CACjB~~,CAAC,CAAC;~~AAEH~~,~~gFAAgF;AAEhF,~~aAAa,CAAC,MAAM,CAAC,CAAC;~~AACtB~~,eAAe,CAAC,MAAM,CAAC,CAAC;~~AAExB~~,~~gFAAgF;AAEhF,KAAK,UAAU,IAAI;IACjB,~~MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;~~IAC7C~~,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;~~IAChC~~,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;~~AAC5D~~,CAAC~~;AAED~~,~~IAAI,EAAE,~~CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;~~IACnB~~,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;~~IACpD~~,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;~~AAClB~~,CAAC,CAAC,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,+EAA+E;AAC/E,6EAA6E;AAE7E,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAC1D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;AAC9E,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEjC,IAAI,QAAQ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;IACtE,8DAA8D;IAC9D,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC;KAAM,CAAC;IACN,2EAA2E;IAE3E,MAAM,CAAC,yCAAyC,CAAC;SAC9C,IAAI,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QAC5B,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;QAC3F,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAC9D,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAE/D,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;YAC3B,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QAEH,aAAa,CAAC,MAAM,CAAC,CAAC;QACtB,eAAe,CAAC,MAAM,CAAC,CAAC;QAExB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC5D,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACb,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@kevinrabun/judges",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "35 specialized judges that evaluate AI-generated code for security, cost, and quality.",
   "mcpName": "io.github.KevinRabun/judges",
   "type": "module",

package/server.json CHANGED Viewed

@@ -7,12 +7,12 @@
     "url": "https://github.com/kevinrabun/judges",
     "source": "github"
   },
-  "version": "3.0.3",
+  "version": "3.1.1",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@kevinrabun/judges",
-      "version": "3.0.3",
+      "version": "3.1.1",
       "transport": {
         "type": "stdio"
       }