commit-cop 1.0.1 → 1.1.1

package/dist/index.js

@@ -1,30 +1,41 @@
 #!/usr/bin/env node
+import { CLI_NAME, PRODUCT_NAME, TAGLINE } from "./brand.js";
 import { Command } from "commander";
-import { getStagedFiles } from "./git.js";
-import { runChecks } from "./scanner.js";
-import { printReport } from "./reporter.js";
+import { runWipFix } from "./fix/runFix.js";
+import { installHook, uninstallHook } from "./hook.js";
+import { runScan } from "./runScan.js";
 const program = new Command();
 program
-    .name("commit-cop")
-    .description("Pre-commit safety checker for staged files")
+    .name(CLI_NAME)
+    .description(`${PRODUCT_NAME} — ${TAGLINE}`);
+program
+    .command("scan", { isDefault: true })
+    .description("Scan staged files for risky commits")
     .option("--strict", "Treat warnings as errors")
+    .option("--allow-console-log", "Skip console.log warnings (for projects that keep console.log on purpose)")
     .action(async (options) => {
-    const stagedFiles = getStagedFiles();
-    if (stagedFiles.length === 0) {
-        console.log("No staged files found.");
-        return;
-    }
-    const findings = await runChecks({
-        stagedFiles,
-        strict: Boolean(options.strict),
-    });
-    printReport(findings, stagedFiles.length);
-    const hasErrors = findings.some((finding) => finding.severity === "error");
-    const hasWarnings = findings.some((finding) => finding.severity === "warning");
-    if (hasErrors || (options.strict && hasWarnings)) {
-        process.exit(1);
-    }
-    process.exit(0);
+    const exitCode = await runScan(Boolean(options.strict), Boolean(options.allowConsoleLog));
+    process.exit(exitCode);
+});
+program
+    .command("wip-fix")
+    .description("Apply common repo fixes matching commit-cop checks (.gitignore, debug code, unstaging, etc.)")
+    .option("--fix-console-log", "Also remove standalone console.log lines from staged files (debugger lines are always removed)")
+    .action((options) => {
+    runWipFix({ fixConsoleLog: Boolean(options.fixConsoleLog) });
+});
+program
+    .command("install")
+    .description("Install a Git pre-commit hook that runs Commit Cop on every commit")
+    .option("--strict", "Treat warnings as errors in the hook")
+    .action((options) => {
+    installHook(Boolean(options.strict));
+});
+program
+    .command("uninstall")
+    .description("Remove the Commit Cop pre-commit hook")
+    .action(() => {
+    uninstallHook();
 });
 program.parse();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,4CAA4C,CAAC;KACzD,MAAM,CAAC,UAAU,EAAE,0BAA0B,CAAC;KAC9C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC;QAC/B,WAAW;QACX,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;KAChC,CAAC,CAAC;IAEH,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAE1C,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAC/B,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAC5C,CAAC;IAEF,IAAI,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC,EAAE,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,GAAG,YAAY,MAAM,OAAO,EAAE,CAAC,CAAC;AAE/C,OAAO;KACJ,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KACpC,WAAW,CAAC,qCAAqC,CAAC;KAClD,MAAM,CAAC,UAAU,EAAE,0BAA0B,CAAC;KAC9C,MAAM,CACL,qBAAqB,EACrB,2EAA2E,CAC5E;KACA,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EACvB,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CACjC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CACV,8FAA8F,CAC/F;KACA,MAAM,CACL,mBAAmB,EACnB,gGAAgG,CACjG;KACA,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;IAClB,SAAS,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AAC/D,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,oEAAoE,CAAC;KACjF,MAAM,CAAC,UAAU,EAAE,sCAAsC,CAAC;KAC1D,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;IAClB,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,WAAW,CAAC;KACpB,WAAW,CAAC,uCAAuC,CAAC;KACpD,MAAM,CAAC,GAAG,EAAE;IACX,aAAa,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/reporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,QA+BpE"}
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,YAAY,CAAC;AAyDpD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,MAAM,QA4BpE"}

package/dist/reporter.js

@@ -1,38 +1,68 @@
+import { PRODUCT_NAME } from "./brand.js";
 import chalk from "chalk";
-export function printReport(findings, scannedCount) {
-    console.log(chalk.bold("\nCommitClean Report\n"));
-    console.log(`Scanned ${scannedCount} staged file(s).\n`);
-    const errors = findings.filter((f) => f.severity === "error");
-    const warnings = findings.filter((f) => f.severity === "warning");
-    console.log(chalk.red(`Errors: ${errors.length}`));
-    console.log(chalk.yellow(`Warnings: ${warnings.length}`));
+const WIDTH = 52;
+function line(char = "─") {
+    return chalk.dim(char.repeat(WIDTH));
+}
+function printHeader(title) {
+    console.log("");
+    console.log(line("═"));
+    console.log(chalk.bold(`  ${title}`));
+    console.log(line("═"));
+}
+function printSection(title, color) {
+    console.log("");
+    console.log(line());
+    console.log(color(chalk.bold(`  ${title}`)));
+    console.log(line());
+    console.log("");
+}
+function printSummary(scannedCount, errors, warnings) {
     console.log("");
+    console.log(chalk.dim(`  Scanned ${scannedCount} staged file(s)`));
+    console.log(`  ${chalk.red(`Errors: ${errors}`)}${chalk.dim("  │  ")}${chalk.yellow(`Warnings: ${warnings}`)}`);
+}
+function printFinding(finding, index) {
+    const location = finding.line
+        ? `${finding.file}:${finding.line}`
+        : finding.file;
+    const checkLabel = chalk.dim(`[${finding.checkName}]`);
+    console.log(chalk.bold(`  ${index}.`) + ` ${checkLabel}`);
+    console.log(`     ${chalk.cyan(location)}`);
+    console.log(`     ${finding.message}`);
+    if (finding.suggestion) {
+        console.log(chalk.gray(`     → ${finding.suggestion}`));
+    }
+    console.log("");
+}
+function printFindings(findings, severity) {
+    const filtered = findings.filter((finding) => finding.severity === severity);
+    filtered.forEach((finding, index) => {
+        printFinding(finding, index + 1);
+    });
+}
+export function printReport(findings, scannedCount) {
+    const errors = findings.filter((finding) => finding.severity === "error");
+    const warnings = findings.filter((finding) => finding.severity === "warning");
+    printHeader(`${PRODUCT_NAME} Report`);
+    printSummary(scannedCount, errors.length, warnings.length);
     if (findings.length === 0) {
-        console.log(chalk.green("✅ No issues found. Commit looks clean.\n"));
+        console.log("");
+        console.log(chalk.green("  ✅ All clear — no issues found in staged files."));
+        console.log("");
+        console.log(line("═"));
+        console.log("");
         return;
     }
     if (errors.length > 0) {
-        console.log(chalk.red.bold("❌ Errors"));
-        for (const finding of errors) {
-            printFinding(finding);
-        }
+        printSection(`ERRORS (${errors.length})`, chalk.red);
+        printFindings(findings, "error");
     }
     if (warnings.length > 0) {
-        console.log(chalk.yellow.bold("\n⚠️ Warnings"));
-        for (const finding of warnings) {
-            printFinding(finding);
-        }
+        printSection(`WARNINGS (${warnings.length})`, chalk.yellow);
+        printFindings(findings, "warning");
     }
+    console.log(line("═"));
     console.log("");
 }
-function printFinding(finding) {
-    const location = finding.line
-        ? `${finding.file}:${finding.line}`
-        : finding.file;
-    console.log(`- ${chalk.bold(location)}`);
-    console.log(`  ${finding.message}`);
-    if (finding.suggestion) {
-        console.log(chalk.gray(`  Fix: ${finding.suggestion}`));
-    }
-}
 //# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

@@ -1 +1 @@
-{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,UAAU,WAAW,CAAC,QAAmB,EAAE,YAAoB;IACnE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,WAAW,YAAY,oBAAoB,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAElE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC,CAAC;QACrE,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QACxC,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;YAC7B,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;QAChD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CAAC,OAAgB;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI;QAC3B,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE;QACnC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAEjB,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEpC,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC"}
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"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"}

package/dist/runScan.d.ts

@@ -0,0 +1,2 @@
+export declare function runScan(strict?: boolean, allowConsoleLog?: boolean): Promise<number>;
+//# sourceMappingURL=runScan.d.ts.map

package/dist/runScan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runScan.d.ts","sourceRoot":"","sources":["../src/runScan.ts"],"names":[],"mappings":"AAKA,wBAAsB,OAAO,CAC3B,MAAM,UAAQ,EACd,eAAe,UAAQ,GACtB,OAAO,CAAC,MAAM,CAAC,CA0BjB"}

package/dist/runScan.js

@@ -0,0 +1,24 @@
+import { PRODUCT_NAME } from "./brand.js";
+import { getStagedFiles } from "./git.js";
+import { runChecks } from "./scanner.js";
+import { printReport } from "./reporter.js";
+export async function runScan(strict = false, allowConsoleLog = false) {
+    const stagedFiles = getStagedFiles();
+    if (stagedFiles.length === 0) {
+        console.log(`${PRODUCT_NAME}: No staged files found.`);
+        return 0;
+    }
+    const findings = await runChecks({
+        stagedFiles,
+        strict,
+        allowConsoleLog,
+    });
+    printReport(findings, stagedFiles.length);
+    const hasErrors = findings.some((finding) => finding.severity === "error");
+    const hasWarnings = findings.some((finding) => finding.severity === "warning");
+    if (hasErrors || (strict && hasWarnings)) {
+        return 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=runScan.js.map

package/dist/runScan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runScan.js","sourceRoot":"","sources":["../src/runScan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAM,GAAG,KAAK,EACd,eAAe,GAAG,KAAK;IAEvB,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,YAAY,0BAA0B,CAAC,CAAC;QACvD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC;QAC/B,WAAW;QACX,MAAM;QACN,eAAe;KAChB,CAAC,CAAC;IAEH,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAE1C,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAC/B,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAC5C,CAAC;IAEF,IAAI,SAAS,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AA+BxD,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CASzE"}
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AA+BxD,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAYzE"}

package/dist/scanner.js

@@ -28,7 +28,10 @@ const checks = [
 ];
 export async function runChecks(context) {
     const allFindings = [];
-    for (const check of checks) {
+    const activeChecks = context.allowConsoleLog
+        ? checks.filter((check) => check !== consoleLogCheck)
+        : checks;
+    for (const check of activeChecks) {
         const findings = await check.run(context);
         allFindings.push(...findings);
     }

package/dist/scanner.js.map

@@ -1 +1 @@
-{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,MAAM,GAAG;IACb,kBAAkB;IAClB,YAAY;IACZ,sBAAsB;IACtB,oBAAoB;IACpB,WAAW;IACX,gBAAgB;IAChB,eAAe;IACf,aAAa;IACb,cAAc;IACd,aAAa;IACb,kBAAkB;IAClB,cAAc;IACd,eAAe;CAChB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAqB;IACnD,MAAM,WAAW,GAAc,EAAE,CAAC;IAElC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,WAAW,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,MAAM,GAAG;IACb,kBAAkB;IAClB,YAAY;IACZ,sBAAsB;IACtB,oBAAoB;IACpB,WAAW;IACX,gBAAgB;IAChB,eAAe;IACf,aAAa;IACb,cAAc;IACd,aAAa;IACb,kBAAkB;IAClB,cAAc;IACd,eAAe;CAChB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAqB;IACnD,MAAM,WAAW,GAAc,EAAE,CAAC;IAClC,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe;QAC1C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,eAAe,CAAC;QACrD,CAAC,CAAC,MAAM,CAAC;IAEX,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,WAAW,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/types.d.ts

@@ -10,6 +10,10 @@ export type Finding = {
 export type CheckContext = {
     stagedFiles: string[];
     strict: boolean;
+    allowConsoleLog?: boolean;
+};
+export type WipFixOptions = {
+    fixConsoleLog?: boolean;
 };
 export type Check = {
     name: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CACpD,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CACpD,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "commit-cop",
-  "version": "1.0.1",
-  "description": "A pre-commit safety checker that scans staged files for risky commits.",
+  "version": "1.1.1",
+  "description": "Commit Cop — a pre-commit safety checker that scans staged files for risky commits.",
   "type": "module",
   "bin": {
     "commit-cop": "./dist/index.js"
@@ -10,7 +10,8 @@
     "dev": "tsx src/index.ts",
     "build": "tsc",
     "start": "node dist/index.js",
-    "commit-cop": "tsx src/index.ts"
+    "commit-cop": "tsx src/index.ts",
+    "demo:setup": "node scripts/setup-demo.mjs"
   },
   "repository": {
     "type": "git",

package/src/brand.ts

@@ -0,0 +1,3 @@
+export const PRODUCT_NAME = "Commit Cop";
+export const CLI_NAME = "commit-cop";
+export const TAGLINE = "Catch bad commits before they hit GitHub";

package/src/checks/binaryFileCheck.ts

@@ -52,9 +52,9 @@ export const binaryFileCheck: Check = {
           severity: "warning",
           checkName: this.name,
           file,
-          message: "Binary or non-text file is staged.",
-          suggestion:
-            "Remove it from the commit or store it outside Git (e.g. Git LFS).",
+          message:
+            "Binary file detected — archives, executables, and media don't belong in source control.",
+          suggestion: "Remove it from the commit or store it with Git LFS.",
         });
       }
     }

package/src/checks/consoleLogCheck.ts

@@ -27,8 +27,9 @@ export const consoleLogCheck: Check = {
             checkName: this.name,
             file,
             line: index + 1,
-            message: "console.log found in staged code.",
-            suggestion: "Remove debug logs before committing.",
+            message:
+              "Debug log left in code — easy to miss and clutters production output.",
+            suggestion: "Delete the console.log before committing.",
           });
         }
       });

package/src/checks/debuggerCheck.ts

@@ -20,8 +20,9 @@ export const debuggerCheck: Check = {
             checkName: this.name,
             file,
             line: index + 1,
-            message: "debugger statement found in staged code.",
-            suggestion: "Remove debugger statements before committing.",
+            message:
+              "debugger statement left in code — pauses execution and breaks CI/headless runs.",
+            suggestion: "Delete the debugger statement before committing.",
           });
         }
       });

package/src/checks/envFileCheck.ts

@@ -14,8 +14,9 @@ export const envFileCheck: Check = {
           severity: "error",
           checkName: this.name,
           file,
-          message: "Environment file is staged and may contain secrets.",
-          suggestion: `Run: git restore --staged ${file}`,
+          message:
+            ".env file detected — these often hold API keys, passwords, and tokens.",
+          suggestion: `Unstage it: git restore --staged ${file}`,
         });
       }
     }

package/src/checks/focusedTestCheck.ts

@@ -28,8 +28,8 @@ export const focusedTestCheck: Check = {
               checkName: this.name,
               file,
               line: index + 1,
-              message: `${pattern} found. This may skip the rest of the test suite.`,
-              suggestion: `Replace ${pattern} with the normal test function.`,
+              message: `${pattern} detected — only that test will run, hiding failures in the rest of the suite.`,
+              suggestion: `Change ${pattern} back to ${pattern.replace(".only", "")}.`,
             });
           }
         }

package/src/checks/generatedFolderCheck.ts

@@ -34,8 +34,8 @@ export const generatedFolderCheck: Check = {
           severity: "error",
           checkName: this.name,
           file,
-          message: `${matchedFolder} is staged but is usually generated and should not be committed.`,
-          suggestion: `Add ${matchedFolder} to .gitignore and run: git restore --staged ${file}`,
+          message: `Generated folder (${matchedFolder}) — auto-built files bloat the repo and cause merge pain.`,
+          suggestion: `Add ${matchedFolder} to .gitignore, then: git restore --staged ${file}`,
         });
       }
     }

package/src/checks/junkFileCheck.ts

@@ -28,8 +28,9 @@ export const junkFileCheck: Check = {
           severity: "warning",
           checkName: this.name,
           file,
-          message: "OS or editor junk file is staged.",
-          suggestion: `Run: git restore --staged ${file}`,
+          message:
+            "OS or editor junk file — adds noise and has no place in the repo.",
+          suggestion: `Unstage it: git restore --staged ${file}`,
         });
       }
     }

package/src/checks/largeFileCheck.ts

@@ -20,8 +20,8 @@ export const largeFileCheck: Check = {
           severity: "warning",
           checkName: this.name,
           file,
-          message: `Large file staged: ${sizeMb.toFixed(2)} MB.`,
-          suggestion: "Consider removing this file from Git or using Git LFS.",
+          message: `Large file (${sizeMb.toFixed(2)} MB) — slows clones and may hit GitHub's size limits.`,
+          suggestion: "Remove it from Git or use Git LFS for big assets.",
         });
       }
     }

package/src/checks/localHostCheck.ts

@@ -27,8 +27,8 @@ export const localHostCheck: Check = {
               checkName: this.name,
               file,
               line: index + 1,
-              message: `Hardcoded local URL found: ${pattern}`,
-              suggestion: "Use an environment variable instead of a hardcoded localhost URL.",
+              message: `Hardcoded local URL (${pattern}) — won't work in production or for teammates.`,
+              suggestion: "Move the URL to an environment variable (e.g. process.env.API_URL).",
             });
           }
         }

package/src/checks/lockfileDriftCheck.ts

@@ -18,8 +18,9 @@ export const lockfileDriftCheck: Check = {
         severity: "warning",
         checkName: this.name,
         file: "package.json",
-        message: "package.json is staged but package-lock.json is not.",
-        suggestion: "Run npm install and stage package-lock.json.",
+        message:
+          "package.json changed without its lockfile — teammates may get different dependency versions.",
+        suggestion: "Run npm install, then stage package-lock.json.",
       });
     }
 
@@ -28,8 +29,9 @@ export const lockfileDriftCheck: Check = {
         severity: "warning",
         checkName: this.name,
         file: "package-lock.json",
-        message: "package-lock.json is staged but package.json is not.",
-        suggestion: "Stage package.json or unstage the lockfile.",
+        message:
+          "Lockfile changed without package.json — the lockfile may not match your declared dependencies.",
+        suggestion: "Stage package.json too, or unstage package-lock.json.",
       });
     }
 

package/src/checks/mergeConflictCheck.ts

@@ -25,9 +25,10 @@ export const mergeConflictCheck: Check = {
               checkName: this.name,
               file,
               line: index + 1,
-              message: "Merge conflict marker found in staged file.",
+              message:
+                "Unresolved merge conflict — this file won't run correctly until fixed.",
               suggestion:
-                "Resolve the conflict, remove the markers, and restage the file.",
+                "Resolve the conflict, remove the <<<<<<< / ======= / >>>>>>> markers, then restage.",
             });
             return;
           }

package/src/checks/secretCheck.ts

@@ -6,21 +6,21 @@ import {
   shouldSkipContentScan,
 } from "./utils.js";
 
-const secretPatterns = [
-  /OPENAI_API_KEY\s*=/i,
-  /DATABASE_URL\s*=/i,
-  /JWT_SECRET\s*=/i,
-  /AUTH_SECRET\s*=/i,
-  /PRIVATE_KEY\s*=/i,
-  /SECRET_KEY\s*=/i,
-  /sk-[A-Za-z0-9_-]{20,}/,
-  /ghp_[A-Za-z0-9]{36,}/,
-  /github_pat_[A-Za-z0-9_]+/,
-  /AKIA[0-9A-Z]{16}/,
-  /sk_live_[A-Za-z0-9]+/,
-  /AIza[0-9A-Za-z_-]{35}/,
-  /hooks\.slack\.com\/services\//,
-  /password\s*=\s*['"][^'"]{8,}['"]/i,
+const secretRules: { pattern: RegExp; label: string }[] = [
+  { pattern: /OPENAI_API_KEY\s*=/i, label: "OpenAI API key" },
+  { pattern: /DATABASE_URL\s*=/i, label: "database connection string" },
+  { pattern: /JWT_SECRET\s*=/i, label: "JWT secret" },
+  { pattern: /AUTH_SECRET\s*=/i, label: "auth secret" },
+  { pattern: /PRIVATE_KEY\s*=/i, label: "private key" },
+  { pattern: /SECRET_KEY\s*=/i, label: "secret key" },
+  { pattern: /sk-[A-Za-z0-9_-]{20,}/, label: "API key" },
+  { pattern: /ghp_[A-Za-z0-9]{36,}/, label: "GitHub personal access token" },
+  { pattern: /github_pat_[A-Za-z0-9_]+/, label: "GitHub personal access token" },
+  { pattern: /AKIA[0-9A-Z]{16}/, label: "AWS access key" },
+  { pattern: /sk_live_[A-Za-z0-9]+/, label: "Stripe live secret key" },
+  { pattern: /AIza[0-9A-Za-z_-]{35}/, label: "Google API key" },
+  { pattern: /hooks\.slack\.com\/services\//, label: "Slack webhook URL" },
+  { pattern: /password\s*=\s*['"][^'"]{8,}['"]/i, label: "hardcoded password" },
 ];
 
 export const secretCheck: Check = {
@@ -38,16 +38,16 @@ export const secretCheck: Check = {
       lines.forEach((line, index) => {
         if (isCommentLine(line) || isPlaceholderValue(line)) return;
 
-        for (const pattern of secretPatterns) {
-          if (pattern.test(line)) {
+        for (const rule of secretRules) {
+          if (rule.pattern.test(line)) {
             findings.push({
               severity: "error",
               checkName: this.name,
               file,
               line: index + 1,
-              message: "Possible secret found in staged file.",
+              message: `Possible ${rule.label} — credentials pushed to GitHub can be scraped instantly.`,
               suggestion:
-                "Remove the secret and rotate it if it was already pushed.",
+                "Remove it from the code, unstage the file, and rotate the credential if it was ever pushed.",
             });
             return;
           }

package/src/checks/sensitiveFilenameCheck.ts

@@ -39,8 +39,9 @@ export const sensitiveFilenameCheck: Check = {
           severity: "error",
           checkName: this.name,
           file,
-          message: "Sensitive credential file is staged.",
-          suggestion: `Run: git restore --staged ${file}`,
+          message:
+            "Credential or key file detected — private keys and auth config should not be in Git.",
+          suggestion: `Unstage it: git restore --staged ${file}`,
         });
       }
     }

package/src/fix/debugCode.ts

@@ -0,0 +1,74 @@
+import fs from "node:fs";
+import path from "node:path";
+import { isCodeFile } from "../checks/utils.js";
+import { getStagedFiles } from "../git.js";
+import type { WipFixOptions } from "../types.js";
+
+const CONSOLE_LOG_LINE = /^\s*console\.log\([^)]*\);?\s*$/;
+const DEBUGGER_LINE = /^\s*debugger;?\s*$/;
+
+function stripDebugLines(
+  content: string,
+  options: { removeConsoleLog: boolean; removeDebugger: boolean }
+): { updated: string; removed: number } {
+  const lines = content.split("\n");
+  const kept: string[] = [];
+  let removed = 0;
+
+  for (const line of lines) {
+    const isConsoleLog = CONSOLE_LOG_LINE.test(line);
+    const isDebugger = DEBUGGER_LINE.test(line);
+
+    if (
+      (options.removeConsoleLog && isConsoleLog) ||
+      (options.removeDebugger && isDebugger)
+    ) {
+      removed += 1;
+      continue;
+    }
+    kept.push(line);
+  }
+
+  return { updated: kept.join("\n"), removed };
+}
+
+export function fixDebugCode(
+  cwd = process.cwd(),
+  options: WipFixOptions = {}
+): string[] {
+  const removeConsoleLog = Boolean(options.fixConsoleLog);
+  const removeDebugger = true;
+
+  if (!removeConsoleLog && !removeDebugger) {
+    return [];
+  }
+
+  let stagedFiles: string[];
+
+  try {
+    stagedFiles = getStagedFiles();
+  } catch {
+    return [];
+  }
+
+  const fixed: string[] = [];
+
+  for (const file of stagedFiles) {
+    if (!isCodeFile(file)) continue;
+
+    const absolutePath = path.resolve(cwd, file);
+    if (!fs.existsSync(absolutePath)) continue;
+
+    const content = fs.readFileSync(absolutePath, "utf-8");
+    const { updated, removed } = stripDebugLines(content, {
+      removeConsoleLog,
+      removeDebugger,
+    });
+    if (removed === 0) continue;
+
+    fs.writeFileSync(absolutePath, updated, "utf-8");
+    fixed.push(file);
+  }
+
+  return fixed;
+}