@kevinrabun/judges 3.38.0 → 3.41.0

package/dist/commands/governance.js

@@ -0,0 +1,203 @@
+/**
+ * `judges governance` — Multi-repo governance dashboard.
+ *
+ * Aggregates snapshot data from multiple repos into a unified governance view.
+ * Teams self-host their own snapshot files; this command reads them from a
+ * directory of exported snapshots (each repo pushes to a shared location).
+ *
+ * Usage:
+ *   judges governance --dir ./governance-data         # read snapshots from dir
+ *   judges governance --dir ./governance-data --html  # HTML dashboard output
+ *   judges governance --dir ./governance-data --json  # JSON output
+ */
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { resolve, basename } from "path";
+import { computeTrend, detectRegressions } from "./snapshot.js";
+// ─── Grade Calculation ──────────────────────────────────────────────────────
+function gradeFromTrend(trend) {
+    const t = trend.stats;
+    if (t.currentTotal === 0 && t.trend === "improving")
+        return "A";
+    if (t.currentTotal <= 3 && t.trend !== "regressing")
+        return "A";
+    if (t.currentTotal <= 10 && t.trend !== "regressing")
+        return "B";
+    if (t.currentTotal <= 20)
+        return "C";
+    if (t.currentTotal <= 50)
+        return "D";
+    return "F";
+}
+// ─── Snapshot Directory Loading ─────────────────────────────────────────────
+function loadSnapshotFiles(dir) {
+    const repos = new Map();
+    if (!existsSync(dir))
+        return repos;
+    const files = readdirSync(dir).filter((f) => f.endsWith(".json"));
+    for (const file of files) {
+        try {
+            const raw = readFileSync(resolve(dir, file), "utf-8");
+            const store = JSON.parse(raw);
+            if (store.version === 1 && Array.isArray(store.snapshots)) {
+                // Use filename (minus extension) as repo name
+                const repoName = basename(file, ".json").replace(/-snapshots$/, "");
+                repos.set(repoName, store);
+            }
+        }
+        catch {
+            // Skip invalid files
+        }
+    }
+    return repos;
+}
+// ─── Report Generation ──────────────────────────────────────────────────────
+export function buildGovernanceReport(dir) {
+    const stores = loadSnapshotFiles(dir);
+    const repos = [];
+    let totalFindings = 0;
+    const criticalRepos = [];
+    for (const [repoName, store] of stores) {
+        const trend = computeTrend(store);
+        const regressions = detectRegressions(store);
+        const grade = gradeFromTrend(trend);
+        repos.push({
+            repo: repoName,
+            trend,
+            regressions,
+            lastRun: trend.stats.lastRun,
+            grade,
+        });
+        totalFindings += trend.stats.currentTotal;
+        if (grade === "D" || grade === "F" || regressions.some((r) => r.severity === "error")) {
+            criticalRepos.push(repoName);
+        }
+    }
+    // Sort by grade (worst first) then by findings count
+    const gradeOrder = { F: 0, D: 1, C: 2, B: 3, A: 4 };
+    repos.sort((a, b) => (gradeOrder[a.grade] ?? 5) - (gradeOrder[b.grade] ?? 5) ||
+        b.trend.stats.currentTotal - a.trend.stats.currentTotal);
+    const overallHealth = criticalRepos.length === 0 ? "healthy" : criticalRepos.length <= repos.length * 0.3 ? "at-risk" : "critical";
+    return {
+        repos,
+        overallHealth,
+        totalFindings,
+        repoCount: repos.length,
+        criticalRepos,
+        generatedAt: new Date().toISOString(),
+    };
+}
+// ─── CLI Formatters ─────────────────────────────────────────────────────────
+function formatGovernanceText(report) {
+    const lines = [];
+    const healthIcon = report.overallHealth === "healthy" ? "✅" : report.overallHealth === "at-risk" ? "⚠️ " : "🔴";
+    lines.push("╔══════════════════════════════════════════════════════════════╗");
+    lines.push("║        Judges Panel — Governance Dashboard                  ║");
+    lines.push("╚══════════════════════════════════════════════════════════════╝");
+    lines.push("");
+    lines.push(`  Health    : ${healthIcon} ${report.overallHealth.toUpperCase()}`);
+    lines.push(`  Repos     : ${report.repoCount}`);
+    lines.push(`  Findings  : ${report.totalFindings} total across all repos`);
+    if (report.criticalRepos.length > 0) {
+        lines.push(`  Critical  : ${report.criticalRepos.join(", ")}`);
+    }
+    lines.push(`  Generated : ${report.generatedAt.slice(0, 10)}`);
+    lines.push("");
+    lines.push("  Repository Summary:");
+    lines.push("  " + "─".repeat(58));
+    lines.push(`  ${"Repository".padEnd(30)} Grade  Findings  Trend`);
+    lines.push("  " + "─".repeat(58));
+    for (const r of report.repos) {
+        const trendIcon = r.trend.stats.trend === "improving" ? "📉" : r.trend.stats.trend === "regressing" ? "📈" : "➡️ ";
+        const findings = String(r.trend.stats.currentTotal).padStart(6);
+        lines.push(`  ${r.repo.padEnd(30)} ${r.grade.padEnd(6)} ${findings}   ${trendIcon} ${r.trend.stats.trend}`);
+        if (r.regressions.length > 0) {
+            for (const alert of r.regressions.slice(0, 2)) {
+                const icon = alert.severity === "error" ? "🔴" : "🟡";
+                lines.push(`    ${icon} ${alert.message}`);
+            }
+        }
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+function formatGovernanceHtml(report) {
+    const healthColor = report.overallHealth === "healthy" ? "#16a34a" : report.overallHealth === "at-risk" ? "#ca8a04" : "#dc2626";
+    const gradeColor = { A: "#16a34a", B: "#65a30d", C: "#ca8a04", D: "#ea580c", F: "#dc2626" };
+    const rows = report.repos
+        .map((r) => `<tr>
+      <td>${esc(r.repo)}</td>
+      <td style="color:${gradeColor[r.grade] ?? "#666"};font-weight:700">${r.grade}</td>
+      <td>${r.trend.stats.currentTotal}</td>
+      <td>${r.trend.stats.trend}</td>
+      <td>${r.regressions.length}</td>
+      <td>${r.lastRun.slice(0, 10)}</td>
+    </tr>`)
+        .join("\n");
+    return `<!DOCTYPE html>
+<html lang="en"><head><meta charset="utf-8"><title>Judges Governance Dashboard</title>
+<style>
+  :root{--bg:#fff;--fg:#1a1a1a;--card:#f9fafb;--border:#e5e7eb;--muted:#6b7280}
+  @media(prefers-color-scheme:dark){:root{--bg:#0f172a;--fg:#e2e8f0;--card:#1e293b;--border:#334155;--muted:#94a3b8}}
+  *{margin:0;padding:0;box-sizing:border-box}
+  body{font-family:system-ui,sans-serif;background:var(--bg);color:var(--fg);padding:2rem}
+  h1{margin-bottom:1rem}
+  .badge{display:inline-block;padding:.25rem .75rem;border-radius:4px;font-weight:700}
+  table{width:100%;border-collapse:collapse;margin-top:1rem}
+  th,td{padding:.5rem .75rem;text-align:left;border-bottom:1px solid var(--border)}
+  th{font-size:.75rem;text-transform:uppercase;color:var(--muted)}
+</style></head><body>
+<h1>Judges Panel &mdash; Governance Dashboard</h1>
+<p><span class="badge" style="background:${healthColor};color:#fff">${esc(report.overallHealth.toUpperCase())}</span>
+${report.repoCount} repos, ${report.totalFindings} total findings</p>
+<table><thead><tr><th>Repository</th><th>Grade</th><th>Findings</th><th>Trend</th><th>Alerts</th><th>Last Run</th></tr></thead>
+<tbody>${rows}</tbody></table>
+<p style="margin-top:2rem;font-size:.75rem;color:var(--muted)">Generated ${report.generatedAt.slice(0, 10)} by Judges Panel</p>
+</body></html>`;
+}
+function esc(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+// ─── CLI Command ────────────────────────────────────────────────────────────
+export function runGovernance(argv) {
+    let dir = ".";
+    let format = "text";
+    for (let i = 3; i < argv.length; i++) {
+        switch (argv[i]) {
+            case "--dir":
+            case "-d":
+                dir = argv[++i] || ".";
+                break;
+            case "--html":
+                format = "html";
+                break;
+            case "--json":
+                format = "json";
+                break;
+            case "--format":
+                format = argv[++i] || "text";
+                break;
+        }
+    }
+    if (!existsSync(dir)) {
+        console.error(`Error: Directory not found: ${dir}`);
+        console.error("Usage: judges governance --dir ./governance-data");
+        process.exit(1);
+    }
+    const report = buildGovernanceReport(dir);
+    if (report.repoCount === 0) {
+        console.log("\n  No snapshot files found. Export repo snapshots as JSON files to the governance directory.");
+        console.log(`  Expected: ${resolve(dir)}/*.json\n`);
+        return;
+    }
+    switch (format) {
+        case "json":
+            console.log(JSON.stringify(report, null, 2));
+            break;
+        case "html":
+            console.log(formatGovernanceHtml(report));
+            break;
+        default:
+            console.log(formatGovernanceText(report));
+    }
+}
+//# sourceMappingURL=governance.js.map

package/dist/commands/governance.js.map

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

package/dist/commands/help.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `judges help [topic]` — contextual help and getting-started guides.
+ *
+ * Provides quick, actionable guidance for each major capability area.
+ * Run without arguments to see all available topics.
+ */
+export declare function runHelp(argv: string[]): void;
+//# sourceMappingURL=help.d.ts.map

package/dist/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgSH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAmB5C"}

package/dist/commands/help.js

@@ -0,0 +1,303 @@
+/**
+ * `judges help [topic]` — contextual help and getting-started guides.
+ *
+ * Provides quick, actionable guidance for each major capability area.
+ * Run without arguments to see all available topics.
+ */
+const TOPICS = {
+    "getting-started": {
+        title: "Getting Started",
+        summary: "First steps with Judges Panel",
+        body: `
+  Quick Start
+  ───────────
+  1. Evaluate a single file:
+       judges eval server.ts
+
+  2. Scan an entire directory:
+       judges eval src/
+
+  3. Generate a config file:
+       judges init
+
+  4. Use a preset for CI:
+       judges eval src/ --preset security
+
+  5. Auto-fix findings:
+       judges eval src/ --fix
+
+  Common Flags
+  ────────────
+    --format json|sarif|html|markdown   Output format
+    --fix                               Apply auto-fix patches
+    --baseline .judges-baseline.json    Suppress known findings
+    --incremental                       Cache results for unchanged files
+    --changed-only                      Only scan git-changed files
+    --quiet                             Suppress progress output
+    --explain                           Show CWE/OWASP context for findings
+`,
+    },
+    feedback: {
+        title: "Feedback & False Positive Reporting",
+        summary: "How to improve accuracy with feedback",
+        body: `
+  Providing Feedback
+  ──────────────────
+  Feedback trains Judges to reduce false positives over time.
+
+  CLI:
+    judges feedback add --rule SEC-001 --verdict fp --comment "Not exploitable"
+    judges feedback add --rule AUTH-003 --verdict tp
+    judges feedback list
+    judges feedback stats
+
+  VS Code:
+    Click the thumbs-up/down icons on any finding's code action menu.
+    Feedback is stored in .judges-feedback.json in your workspace.
+
+  Verdicts:
+    tp         True positive (real issue)
+    fp         False positive (not a real issue)
+    wontfix    Acknowledged but won't fix
+
+  Your feedback is stored locally and never sent externally.
+  Configure a DataAdapter in .judgesrc to share feedback with your team.
+`,
+    },
+    calibration: {
+        title: "Calibration & Confidence Tuning",
+        summary: "How to tune judge accuracy for your codebase",
+        body: `
+  Auto-Calibration
+  ────────────────
+    judges tune             Run auto-calibration on your feedback data
+    judges tune --dry-run   Preview what would change
+
+  Calibration Dashboard
+  ─────────────────────
+    judges calibration-dashboard          Open interactive HTML dashboard
+    judges calibration-dashboard --output report.html
+
+  How It Works
+  ────────────
+  Judges uses your feedback (tp/fp verdicts) to adjust confidence thresholds
+  per rule. Rules with many false positives get their confidence reduced;
+  rules with consistent true positives are boosted.
+
+  Team Sharing
+  ────────────
+  Calibration profiles are stored in .judges-calibration.json.
+  Commit this to your repo so team members benefit from shared tuning.
+`,
+    },
+    ci: {
+        title: "CI/CD Integration",
+        summary: "Setting up Judges in CI pipelines",
+        body: `
+  Generate CI Config
+  ──────────────────
+    judges ci-templates              Show all available templates
+    judges ci-templates --github     GitHub Actions workflow
+    judges ci-templates --gitlab     GitLab CI config
+    judges ci-templates --azure      Azure Pipelines config
+    judges ci-templates --bitbucket  Bitbucket Pipelines config
+
+  Recommended CI Setup
+  ────────────────────
+  1. Create a baseline to suppress existing findings:
+       judges baseline create --dir src/
+
+  2. Run incremental scans in PRs:
+       judges eval src/ --changed-only --fail-on-findings --format sarif
+
+  3. Upload SARIF to GitHub Code Scanning:
+       - uses: github/codeql-action/upload-sarif@v3
+         with:
+           sarif_file: judges-report.sarif.json
+
+  Environment Variables
+  ─────────────────────
+    JUDGES_CACHE_DIR    Custom cache directory (default: .judges-cache)
+    JUDGES_NO_COLOR     Disable colored output
+    JUDGES_CONFIG       Path to .judgesrc config file
+`,
+    },
+    presets: {
+        title: "Presets & Configuration",
+        summary: "Using and composing evaluation presets",
+        body: `
+  Available Presets
+  ────────────────
+    judges eval --preset security       Security-focused evaluation
+    judges eval --preset quality        Code quality focus
+    judges eval --preset compliance     Compliance & governance
+    judges eval --preset full           All judges enabled
+
+  List All Presets
+  ────────────────
+    judges config presets
+
+  Composing Presets
+  ────────────────
+  In .judgesrc, you can compose multiple presets:
+    {
+      "presets": ["security", "quality"],
+      "disabledRules": ["DOC-001"],
+      "minSeverity": "medium"
+    }
+
+  Custom Config (.judgesrc)
+  ────────────────────────
+    judges init                    Generate a starter .judgesrc
+    judges config validate         Validate your config
+    judges doctor                  Diagnose configuration issues
+`,
+    },
+    plugins: {
+        title: "Plugins & Custom Rules",
+        summary: "Extending Judges with custom rules and plugins",
+        body: `
+  Creating a Plugin
+  ─────────────────
+    judges scaffold-plugin my-rules    Generate a plugin template
+
+  Plugin Structure
+  ────────────────
+    my-rules/
+      package.json        # name, version, "judges-plugin" keyword
+      index.js            # exports { rules: [...] }
+
+  Installing Plugins
+  ──────────────────
+  Add to .judgesrc:
+    {
+      "plugins": ["@myorg/judges-plugin-custom"]
+    }
+
+  Community Patterns
+  ──────────────────
+    judges community-patterns          Browse community rule patterns
+
+  See docs/plugin-guide.md for the full authoring guide.
+`,
+    },
+    "data-adapter": {
+        title: "Data Adapters (Team Storage)",
+        summary: "Configure external storage for team-wide sharing",
+        body: `
+  What Are Data Adapters?
+  ──────────────────────
+  By default, Judges stores feedback, findings, and metrics as local JSON
+  files. Data Adapters let your team share this data via your own backend.
+
+  Judges never hosts or processes your data — you bring your own storage.
+
+  Configuration (.judgesrc)
+  ────────────────────────
+  Local filesystem (default):
+    {
+      "dataAdapter": { "type": "filesystem" }
+    }
+
+  HTTP backend (your own API):
+    {
+      "dataAdapter": {
+        "type": "http",
+        "url": "https://your-team-api.example.com/judges",
+        "headers": {
+          "Authorization": "Bearer \${JUDGES_API_TOKEN}"
+        }
+      }
+    }
+
+  Environment variables in header values are resolved automatically.
+  The HTTP adapter uses standard REST endpoints:
+    GET  /feedback       Load feedback store
+    PUT  /feedback       Save feedback store
+    GET  /findings       Load finding store
+    PUT  /findings       Save finding store
+`,
+    },
+    "security-ids": {
+        title: "CWE & OWASP Identifiers",
+        summary: "How findings map to CWE and OWASP standards",
+        body: `
+  Structured Security IDs
+  ──────────────────────
+  Every finding is automatically enriched with CWE and OWASP identifiers
+  based on its rule prefix and specific rule ID.
+
+  Examples:
+    SEC-001  →  CWE-89 (SQL Injection), OWASP A03:2021
+    AUTH-001 →  CWE-798 (Hard-coded Credentials), OWASP A07:2021
+    XSS-*    →  CWE-79 (Cross-site Scripting), OWASP A03:2021
+    SSRF-*   →  CWE-918 (Server-Side Request Forgery), OWASP A10:2021
+
+  These IDs appear in:
+    - SARIF output (as rule tags)
+    - JSON output (cweIds / owaspIds fields)
+    - The --explain flag output
+    - VS Code extension hover details
+
+  Use --format sarif for tool integration with GitHub Code Scanning,
+  SonarQube, Snyk, and other platforms that consume CWE/OWASP data.
+`,
+    },
+    metrics: {
+        title: "Metrics & ROI Tracking",
+        summary: "Measuring the value Judges provides",
+        body: `
+  Quick Metrics
+  ─────────────
+    judges metrics                    Summary to stdout
+    judges metrics --format json      Machine-readable output
+    judges metrics --since 30d        Last 30 days only
+
+  Visual Dashboard
+  ────────────────
+    judges metrics-dashboard                  Generate HTML dashboard
+    judges metrics-dashboard --output dash.html
+
+  What's Tracked
+  ─────────────
+    - Findings detected / fixed / open / false-positive
+    - Auto-fix adoption rate
+    - Estimated time saved (conservative industry averages)
+    - Trend direction (improving / stable / degrading)
+    - Fix rates by severity
+
+  All metrics are computed from local data. Configure a DataAdapter
+  to aggregate metrics across your team (see: judges help data-adapter).
+`,
+    },
+};
+// ─── Runner ─────────────────────────────────────────────────────────────────
+export function runHelp(argv) {
+    const topic = argv.find((a, i) => i > 2 && !a.startsWith("-"))?.toLowerCase();
+    if (!topic) {
+        printTopicList();
+        return;
+    }
+    const entry = TOPICS[topic];
+    if (!entry) {
+        console.error(`  Unknown help topic: "${topic}"\n`);
+        printTopicList();
+        process.exit(1);
+    }
+    console.log("");
+    console.log(`  ${entry.title}`);
+    console.log(`  ${"─".repeat(entry.title.length)}`);
+    console.log(entry.body);
+}
+function printTopicList() {
+    console.log("");
+    console.log("  Judges Panel — Help Topics");
+    console.log("  ──────────────────────────");
+    console.log("");
+    const maxKey = Math.max(...Object.keys(TOPICS).map((k) => k.length));
+    for (const [key, { summary }] of Object.entries(TOPICS)) {
+        console.log(`    judges help ${key.padEnd(maxKey)}   ${summary}`);
+    }
+    console.log("");
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

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

package/dist/commands/hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/commands/hook.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuDH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAa5C"}
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/commands/hook.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoDH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAa5C"}

package/dist/commands/hook.js

@@ -12,29 +12,26 @@ const HOOK_MARKER = "# judges-panel-hook";
 function generateHookScript() {
     return `#!/usr/bin/env sh
 ${HOOK_MARKER}
-# Judges Panel pre-commit hook — automatically evaluate staged files.
+# Judges Panel pre-commit hook — evaluate staged files in a single pass.
 
-STAGED=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\\.(ts|tsx|js|jsx|py|go|rs|java|cs|cpp|cc|cxx)$')
-if [ -n "$STAGED" ]; then
+# Check if judges is available
+if ! command -v judges >/dev/null 2>&1; then
+  echo "  ⚠️  judges not found — skipping pre-commit review"
+  exit 0
+fi
+
+# Single-pass evaluation of all staged files
+judges eval . --staged-only --summary --fail-on-findings
+EXIT_CODE=$?
+
+if [ "$EXIT_CODE" -ne 0 ]; then
   echo ""
-  echo "  Judges Panel — checking staged files..."
+  echo "  ⛔ Judges found critical issues. Commit blocked."
+  echo "  Run 'judges eval . --staged-only' to see details."
+  echo "  Run 'judges fix <file> --apply' to auto-fix."
+  echo "  Use 'git commit --no-verify' to bypass."
   echo ""
-  FAILED=0
-  for f in $STAGED; do
-    judges eval "$f" --summary --fail-on-findings 2>/dev/null
-    if [ $? -ne 0 ]; then
-      FAILED=1
-    fi
-  done
-  if [ "$FAILED" -ne 0 ]; then
-    echo ""
-    echo "  ⛔ Judges found critical issues. Commit blocked."
-    echo "  Run 'judges eval <file>' to see details."
-    echo "  Run 'judges fix <file> --apply' to auto-fix."
-    echo "  Use 'git commit --no-verify' to bypass."
-    echo ""
-    exit 1
-  fi
+  exit 1
 fi
 `;
 }

package/dist/commands/hook.js.map

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

package/dist/commands/interactive-fix.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `judges fix --interactive` — Interactive fix mode.
+ *
+ * Presents each auto-fixable finding one by one, letting the developer
+ * accept, skip, or view the diff before applying each patch.
+ * Reduces trust barrier by giving full control over what gets changed.
+ *
+ * Usage:
+ *   judges fix src/app.ts --interactive       # Interactive per-finding review
+ *   judges fix src/app.ts -I                  # Short form
+ */
+import type { Finding } from "../types.js";
+export interface InteractiveFixResult {
+    accepted: number;
+    skipped: number;
+    total: number;
+}
+/**
+ * Run interactive fix mode — present each fixable finding and let the user
+ * accept or skip it before applying.
+ */
+export declare function runInteractiveFix(filePath: string, findings: Finding[]): Promise<InteractiveFixResult>;
+//# sourceMappingURL=interactive-fix.d.ts.map

package/dist/commands/interactive-fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-fix.d.ts","sourceRoot":"","sources":["../../src/commands/interactive-fix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAKlD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAkDD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA4F5G"}