bilt-toolkit 1.0.0

package/README.md

@@ -0,0 +1,168 @@
+# 🏗️ BILT
+
+[![npm version](https://img.shields.io/badge/npm-v1.0.0-blue.svg)](https://www.npmjs.com/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)](<>)
+[![Coverage Status](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)](<>)
+
+> **Zero-configuration project health toolkit.** Catch secrets, fix environment variable issues, and keep your local repository clean before it ever reaches Git — with a safety net.
+
+---
+
+```
+   ____    _   _       _____
+  |  _ \  | | | |     |_   _|
+  | |_) | | | | |       | |
+  |  _ <  | | | |___    | |
+  | |_) | |_| |_____|   |_|
+  |____/
+```
+
+Bilt is a developer-focused utility designed to keep environment configurations healthy and prevent credentials leaks. It runs offline, requires zero configuration, and provides interactive, safe auto-fixing.
+
+---
+
+## 🚀 Quick Start
+
+Initialize Bilt on your current project in one command:
+
+```bash
+npx bilt init
+```
+
+This runs a full scan, hooks up a `.gitignore` guardrail, drafts template environment files, and prints a summary of your repository health.
+
+---
+
+## 📦 Terminal Health Report Example
+
+When you scan your project, Bilt prints a beautiful health report card:
+
+```
+╭──────────────────────────────────────────────────╮
+│                                                  │
+│   🏗️  BILT HEALTH REPORT                         │
+│                                                  │
+│   Score: 92/100              Grade: A            │
+│   ██████████████████████░░░  92%                 │
+│                                                  │
+│   ✓ Secrets: Clean                               │
+│   ⚠ Env vars: 2 missing in .env                  │
+│   ✓ .gitignore: OK                               │
+│   ✓ Framework: Next.js detected                  │
+│                                                  │
+╰──────────────────────────────────────────────────╯
+```
+
+---
+
+## 🛠️ CLI Commands & Options
+
+| Command           | Description                                                                                                                                                                                | Core Options                                                                                                        |
+| :---------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------ |
+| **`bilt init`**   | Zero-friction onboarding. Scans the project, creates a local backup snapshot, auto-fixes safe issues (like missing `.gitignore` files or environment templates), and prints a health card. | None                                                                                                                |
+| **`bilt scan`**   | Scans the working tree and git history for credential leaks, framework issues, and environment mismatches.                                                                                 | `--full-history` (scan all commits), `--json` (machine output), `--severity <level>` (filter), `--verbose`, `--fun` |
+| **`bilt fix`**    | Safely applies automated fixes. Can be run in interactive mode (prompts on every non-safe fix) or auto-pilot.                                                                              | `--safe` (apply safe fixes only), `--dry-run` (preview changes), `--verbose`, `--quiet`                             |
+| **`bilt undo`**   | Reverts the last set of changes made by `bilt fix`. Shows a colored line-by-line diff and requires confirmation before restoring.                                                          | None                                                                                                                |
+| **`bilt watch`**  | Runs a file-watching background daemon. Monitors your files as you edit and save them, instantly flagging secrets or env issues in real-time.                                              | `--quiet`, `--debounce <ms>` (default: 300ms)                                                                       |
+| **`bilt doctor`** | Displays a detailed, comprehensive health breakdown categorized by severity with explicit recommendations.                                                                                 | `--card` (outputs markdown summary), `--fun`                                                                        |
+
+---
+
+## ✨ Key Features & Differentiators
+
+### 1. Real-time Protection (File Watcher Daemon)
+
+Unlike traditional scanner hooks that only run during commits, Bilt has a file watcher daemon (`bilt watch`) that detects leaks **the moment you type or save a file**. If you accidentally paste a Stripe secret key into `config.js`, Bilt immediately triggers a terminal notification:
+
+> 🔴 Stripe API Key detected in `config.js` line 12 — want me to move it to `.env`?
+
+### 2. The Safety Undo Net
+
+Bilt is the only tool that cannot accidentally corrupt your codebase.
+
+- Before applying any change that edits files, modifies git history, or removes items, Bilt automatically takes a local file snapshot stored under `.bilt/snapshots/`.
+- Every irreversible fix requires typing `confirm` to proceed.
+- If something breaks, simply run **`bilt undo`** to view the diff and restore your files to their exact pre-fix state.
+
+### 3. Framework-Aware Intelligence
+
+Bilt automatically inspects your dependencies and configuration files to detect the framework you are using (Next.js, Vite, Create React App, Django, Rails, etc.).
+It understands which prefixes expose variables to the browser bundle (e.g. `NEXT_PUBLIC_`, `VITE_`, `REACT_APP_`). If a secret is placed inside a variable with one of these prefixes, it flags it as a **critical vulnerability** since it will be leaked to web browsers.
+
+### 4. Interactive Secret Rotation Assistance
+
+When a secret is found, Bilt maps the credential to its specific SaaS provider (Stripe, AWS, OpenAI, GitHub, Supabase, Twilio, SendGrid, etc.) and provides a direct, clickable deep-link to the exact rotation settings console so you can revoke the token immediately.
+
+### 5. False Positive Management
+
+If a credential check is a false positive (such as a public key meant for client-side use), you can tell Bilt to ignore the line.
+Add a comment containing `# gitleaks:allow` or `# bilt:allow` on the line itself, or on the line directly above it:
+
+```env
+# gitleaks:allow
+NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+```
+
+---
+
+## ⚙️ Configuration (`.biltrc.json`)
+
+Bilt is zero-config by default, but you can customize it by placing a `.biltrc.json` file in your project root:
+
+```json
+{
+  "ignore": ["tests/fixtures/**", "legacy-code/**"],
+  "entropyThreshold": 4.5,
+  "historyDepth": 15,
+  "severityOverrides": {
+    "env-mismatch": "warning",
+    "dockerfile-leak": "critical"
+  },
+  "customRules": [
+    {
+      "id": "my-custom-token",
+      "name": "Custom Organization Token",
+      "pattern": "org-token-[a-f0-9]{16}",
+      "severity": "critical"
+    }
+  ],
+  "funMode": true
+}
+```
+
+---
+
+## 🔌 Extensible Plugin System
+
+Bilt allows developers to write custom plugins to scan specialized files (e.g. Terraform configs, Dockerfiles).
+
+### Example Plugin Interface
+
+```typescript
+import type { PluginManifest, PluginContext } from "bilt";
+
+export const myPlugin: PluginManifest = {
+  name: "bilt-plugin-custom",
+  check: async (context: PluginContext) => {
+    // Scan files in context.projectDir
+    return {
+      findings: [
+        {
+          id: "custom-leak",
+          severity: "warning",
+          category: "plugin-finding",
+          message: "Custom pattern match found",
+          file: "config.json",
+        },
+      ],
+    };
+  },
+};
+```
+
+---
+
+## 📄 License
+
+MIT © [Samuel Yeshambel](https://github.com/Samuel-0228)

package/bin/bilt.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import("../dist/cli.js");

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+// ─── Bilt CLI Entry Point ────────────────────────────────────────────────────
+// Zero-configuration project health toolkit.
+import { Command } from "commander";
+import chalk from "chalk";
+import { createRequire } from "node:module";
+import { executeScan } from "./commands/scan.js";
+import { executeInit } from "./commands/init.js";
+import { executeFix } from "./commands/fix.js";
+import { executeUndo } from "./commands/undo.js";
+import { executeDoctor } from "./commands/doctor.js";
+import { executeWatch } from "./commands/watch.js";
+// ─── Version ─────────────────────────────────────────────────────────────────
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+// ─── Program Setup ───────────────────────────────────────────────────────────
+const program = new Command();
+program
+    .name("bilt")
+    .description("Zero-configuration project health toolkit. Catch secrets, fix env issues, and keep your repo clean.")
+    .version(pkg.version, "-v, --version")
+    .option("--no-color", "Disable colored output");
+// ─── bilt scan ───────────────────────────────────────────────────────────────
+program
+    .command("scan")
+    .description("Scan the project for secrets, env issues, and misconfigurations")
+    .argument("[dir]", "Project directory", ".")
+    .option("--full-history", "Scan all git history (not just recent commits)")
+    .option("--json", "Output results as JSON")
+    .option("--severity <level>", "Minimum severity to report (critical, warning, info)")
+    .option("--verbose", "Show detailed output with suggestions")
+    .option("--quiet", "Suppress all output except errors")
+    .option("--dry-run", "Show what would be scanned without scanning")
+    .option("--fun", "Enable fun mode with celebrations")
+    .action(async (dir, opts) => {
+    try {
+        const result = await executeScan(dir, {
+            fullHistory: opts.fullHistory,
+            json: opts.json,
+            severity: opts.severity,
+            verbose: opts.verbose,
+            quiet: opts.quiet,
+            dryRun: opts.dryRun,
+            fun: opts.fun,
+        });
+        // Exit code based on findings
+        const criticals = result.findings.filter((f) => f.severity === "critical").length;
+        if (criticals > 0) {
+            process.exitCode = 1;
+        }
+    }
+    catch (error) {
+        printError(error);
+        process.exitCode = 2;
+    }
+});
+// ─── bilt init ───────────────────────────────────────────────────────────────
+program
+    .command("init")
+    .description("Initialize Bilt — scan, auto-fix safe issues, and show health report")
+    .argument("[dir]", "Project directory", ".")
+    .action(async (dir) => {
+    try {
+        await executeInit(dir);
+    }
+    catch (error) {
+        printError(error);
+        process.exitCode = 2;
+    }
+});
+// ─── bilt fix ────────────────────────────────────────────────────────────────
+program
+    .command("fix")
+    .description("Fix issues found by scan — interactively or automatically")
+    .argument("[dir]", "Project directory", ".")
+    .option("--safe", "Auto-apply safe fixes only (no prompts)")
+    .option("--dry-run", "Preview fixes without applying")
+    .option("--verbose", "Show detailed output")
+    .option("--quiet", "Suppress non-essential output")
+    .action(async (dir, opts) => {
+    try {
+        await executeFix(dir, {
+            safe: opts.safe,
+            dryRun: opts.dryRun,
+            verbose: opts.verbose,
+            quiet: opts.quiet,
+        });
+    }
+    catch (error) {
+        printError(error);
+        process.exitCode = 2;
+    }
+});
+// ─── bilt undo ───────────────────────────────────────────────────────────────
+program
+    .command("undo")
+    .description("Undo the last set of changes made by bilt fix")
+    .argument("[dir]", "Project directory", ".")
+    .action(async (dir) => {
+    try {
+        await executeUndo(dir);
+    }
+    catch (error) {
+        printError(error);
+        process.exitCode = 2;
+    }
+});
+// ─── bilt watch ──────────────────────────────────────────────────────────────
+program
+    .command("watch")
+    .description("Watch the project for changes and scan in real-time")
+    .argument("[dir]", "Project directory", ".")
+    .option("--quiet", "Only show findings, no status messages")
+    .option("--debounce <ms>", "Debounce interval in milliseconds", "300")
+    .action(async (dir, opts) => {
+    try {
+        await executeWatch(dir, {
+            quiet: opts.quiet,
+            debounce: opts.debounce ? parseInt(opts.debounce, 10) : undefined,
+        });
+    }
+    catch (error) {
+        printError(error);
+        process.exitCode = 2;
+    }
+});
+// ─── bilt doctor ─────────────────────────────────────────────────────────────
+program
+    .command("doctor")
+    .description("Comprehensive health report with detailed breakdown")
+    .argument("[dir]", "Project directory", ".")
+    .option("--card", "Output a markdown health card to stdout")
+    .option("--fun", "Enable celebrations and streak counter")
+    .action(async (dir, opts) => {
+    try {
+        await executeDoctor(dir, {
+            card: opts.card,
+            fun: opts.fun,
+        });
+    }
+    catch (error) {
+        printError(error);
+        process.exitCode = 2;
+    }
+});
+// ─── Error Handler ───────────────────────────────────────────────────────────
+function printError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error("");
+    console.error(chalk.red.bold(`  ✗ Error: ${message}`));
+    if (error instanceof Error && error.stack) {
+        const stackLines = error.stack.split("\n").slice(1, 4);
+        for (const line of stackLines) {
+            console.error(chalk.dim(`  ${line.trim()}`));
+        }
+    }
+    console.error("");
+}
+// ─── Parse & Run ─────────────────────────────────────────────────────────────
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Execute the `bilt doctor` command.
+ *
+ * 1. Run full scan
+ * 2. Display comprehensive health report
+ * 3. If --card: output markdown summary
+ * 4. Show recommendations per category
+ */
+export declare function executeDoctor(projectDir: string, options?: {
+    card?: boolean;
+    fun?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9C,OAAO,CAAC,IAAI,CAAC,CAqKf"}

package/dist/commands/doctor.js

@@ -0,0 +1,194 @@
+// ─── Doctor Command ──────────────────────────────────────────────────────────
+// Comprehensive health report with detailed breakdown and recommendations.
+import path from "node:path";
+import chalk from "chalk";
+import boxen from "boxen";
+import { executeScan } from "./scan.js";
+import { formatHealthScore, severityIcon } from "../ui/format.js";
+/**
+ * Execute the `bilt doctor` command.
+ *
+ * 1. Run full scan
+ * 2. Display comprehensive health report
+ * 3. If --card: output markdown summary
+ * 4. Show recommendations per category
+ */
+export async function executeDoctor(projectDir, options = {}) {
+    const rootDir = path.resolve(projectDir);
+    // ── Run full scan ───────────────────────────────────────────────────
+    const result = await executeScan(rootDir, {
+        quiet: true,
+        fullHistory: true,
+    });
+    const { findings, healthScore, grade, scannedFiles, duration, framework } = result;
+    // ── Markdown card mode ──────────────────────────────────────────────
+    if (options.card) {
+        const md = generateMarkdownCard(result.healthScore, result.grade, findings, framework?.displayName);
+        console.log(md);
+        return;
+    }
+    // ── Header ──────────────────────────────────────────────────────────
+    console.log("");
+    const header = boxen(`\n${chalk.bold.cyan("  🏗️  BILT DOCTOR — Comprehensive Health Report")}\n`, {
+        padding: 0,
+        margin: { top: 0, bottom: 0, left: 1, right: 1 },
+        borderStyle: "round",
+        borderColor: "cyan",
+    });
+    console.log(header);
+    console.log("");
+    // ── Overall score ───────────────────────────────────────────────────
+    console.log(chalk.bold("  📊 Overall Health"));
+    console.log("");
+    console.log(`  ${formatHealthScore(healthScore, grade)}`);
+    console.log("");
+    console.log(chalk.dim(`  Scanned ${scannedFiles} files in ${duration}ms${framework ? ` • Framework: ${framework.displayName}` : ""}`));
+    console.log("");
+    // ── Fun mode ────────────────────────────────────────────────────────
+    if (options.fun) {
+        if (healthScore === 100) {
+            console.log(chalk.bold.green("  🎉🏆🎉 PERFECT SCORE! You absolute legend! 🎉🏆🎉"));
+            console.log("");
+        }
+        else if (healthScore >= 90) {
+            console.log(chalk.green("  🔥 So close to perfection — you got this!"));
+            console.log("");
+        }
+    }
+    // ── Category breakdown ──────────────────────────────────────────────
+    console.log(chalk.bold("  📋 Category Breakdown"));
+    console.log("");
+    const categories = [
+        { key: "secret-detected", label: "Secret Detection", icon: "🔐" },
+        { key: "env-missing", label: "Missing Env Vars", icon: "📦" },
+        { key: "env-unused", label: "Unused Env Vars", icon: "🗑️" },
+        { key: "env-mismatch", label: "Env Mismatches", icon: "🔀" },
+        { key: "env-exposed", label: "Client-Exposed Secrets", icon: "🌐" },
+        { key: "gitignore-missing", label: ".gitignore Coverage", icon: "📄" },
+        { key: "framework-warning", label: "Framework Warnings", icon: "⚙️" },
+        { key: "plugin-finding", label: "Plugin Findings", icon: "🔌" },
+    ];
+    for (const cat of categories) {
+        const catFindings = findings.filter((f) => f.category === cat.key);
+        if (catFindings.length === 0) {
+            console.log(chalk.green(`  ${cat.icon} ${cat.label}: ${chalk.bold("Clean")} ✓`));
+        }
+        else {
+            const critCount = catFindings.filter((f) => f.severity === "critical").length;
+            const warnCount = catFindings.filter((f) => f.severity === "warning").length;
+            const infoCount = catFindings.filter((f) => f.severity === "info").length;
+            const parts = [];
+            if (critCount > 0)
+                parts.push(chalk.red(`${critCount} critical`));
+            if (warnCount > 0)
+                parts.push(chalk.yellow(`${warnCount} warning`));
+            if (infoCount > 0)
+                parts.push(chalk.cyan(`${infoCount} info`));
+            console.log(`  ${cat.icon} ${cat.label}: ${parts.join(", ")} ${chalk.dim(`(${catFindings.length} total)`)}`);
+        }
+    }
+    console.log("");
+    // ── Detailed findings ───────────────────────────────────────────────
+    if (findings.length > 0) {
+        console.log(chalk.bold("  🔍 Detailed Findings"));
+        console.log("");
+        const order = ["critical", "warning", "info"];
+        for (const sev of order) {
+            const sevFindings = findings.filter((f) => f.severity === sev);
+            if (sevFindings.length === 0)
+                continue;
+            const icon = severityIcon(sev);
+            console.log(`  ${icon} ${chalk.bold(sev.charAt(0).toUpperCase() + sev.slice(1))}`);
+            for (const f of sevFindings) {
+                const loc = f.line ? `${f.file}:${f.line}` : f.file;
+                console.log(`     ${chalk.dim("›")} ${f.message}  ${chalk.dim(loc)}`);
+                if (f.suggestion) {
+                    console.log(chalk.dim(`       💡 ${f.suggestion}`));
+                }
+            }
+            console.log("");
+        }
+    }
+    // ── Recommendations ─────────────────────────────────────────────────
+    console.log(chalk.bold("  💡 Recommendations"));
+    console.log("");
+    const recommendations = generateRecommendations(findings);
+    if (recommendations.length === 0) {
+        console.log(chalk.green("  Everything looks great! No recommendations needed."));
+    }
+    else {
+        for (let i = 0; i < recommendations.length; i++) {
+            console.log(`  ${chalk.cyan(`${i + 1}.`)} ${recommendations[i]}`);
+        }
+    }
+    console.log("");
+    // ── Footer ──────────────────────────────────────────────────────────
+    const footer = boxen(chalk.dim(`\n  Run ${chalk.white("bilt fix --safe")} to auto-fix safe issues\n` +
+        `  Run ${chalk.white("bilt fix")} for interactive fix mode\n` +
+        `  Run ${chalk.white("bilt watch")} for real-time monitoring\n`), {
+        padding: 0,
+        margin: { top: 0, bottom: 0, left: 1, right: 1 },
+        borderStyle: "round",
+        borderColor: "gray",
+    });
+    console.log(footer);
+    console.log("");
+}
+// ─── Recommendation Generator ────────────────────────────────────────────────
+function generateRecommendations(findings) {
+    const recs = [];
+    const categories = new Set(findings.map((f) => f.category));
+    if (categories.has("secret-detected")) {
+        recs.push("Move hardcoded secrets to .env files and rotate compromised keys immediately.");
+    }
+    if (categories.has("gitignore-missing")) {
+        recs.push("Add .env file patterns to .gitignore to prevent accidental commits.");
+    }
+    if (categories.has("env-missing")) {
+        recs.push("Add missing environment variables or generate a .env.example for onboarding.");
+    }
+    if (categories.has("env-unused")) {
+        recs.push("Remove unused environment variables to keep your config clean.");
+    }
+    if (categories.has("env-mismatch")) {
+        recs.push("Sync environment files — ensure all environments have the same variables.");
+    }
+    if (categories.has("env-exposed")) {
+        recs.push("Review client-exposed env vars — only public keys should use framework-specific prefixes.");
+    }
+    if (categories.has("framework-warning")) {
+        recs.push("Review framework-specific configuration for potential security issues.");
+    }
+    if (categories.has("plugin-finding")) {
+        recs.push("Address plugin-specific findings — check Docker, Terraform, or other tool configurations.");
+    }
+    return recs;
+}
+// ─── Markdown Card Generator ─────────────────────────────────────────────────
+function generateMarkdownCard(score, grade, findings, frameworkName) {
+    const criticals = findings.filter((f) => f.severity === "critical").length;
+    const warnings = findings.filter((f) => f.severity === "warning").length;
+    const infos = findings.filter((f) => f.severity === "info").length;
+    const barWidth = 20;
+    const filled = Math.round((score / 100) * barWidth);
+    const empty = barWidth - filled;
+    const bar = "█".repeat(filled) + "░".repeat(empty);
+    let md = "# 🏗️ Bilt Health Report\n\n";
+    md += `**Score:** ${score}/100 — **${grade}**\n\n`;
+    md += "```\n";
+    md += `${bar} ${score}%\n`;
+    md += "```\n\n";
+    md += "## Summary\n\n";
+    md += `| Metric | Count |\n`;
+    md += `|--------|-------|\n`;
+    md += `| 🔴 Critical | ${criticals} |\n`;
+    md += `| 🟡 Warning | ${warnings} |\n`;
+    md += `| 🔵 Info | ${infos} |\n`;
+    if (frameworkName) {
+        md += `\n**Framework:** ${frameworkName}\n`;
+    }
+    md += "\n---\n";
+    md += "*Generated by [Bilt](https://github.com/bilt-cli/bilt)*\n";
+    return md;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/fix.d.ts

@@ -0,0 +1,12 @@
+import type { FixOptions } from "../types/index.js";
+/**
+ * Execute the `bilt fix` command.
+ *
+ * 1. Run scan to find issues
+ * 2. Generate fix actions
+ * 3. Apply fixes (auto for --safe, preview for --dry-run, interactive otherwise)
+ * 4. Create snapshot before applying
+ * 5. Report results
+ */
+export declare function executeFix(projectDir: string, options?: FixOptions): Promise<void>;
+//# sourceMappingURL=fix.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fix.d.ts","sourceRoot":"","sources":["../../src/commands/fix.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAA0B,MAAM,mBAAmB,CAAC;AAiB5E;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAoJf"}