flagshark 1.2.0 → 1.3.0

package/dist/cli.js

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { scanRepo } from "@flagshark/core";
+import { readFileSync, existsSync } from "node:fs";
+import { parse as parseYaml } from "yaml";
+import { scanRepo, FlagsharkConfigSchema } from "@flagshark/core";
 
 // src/formatter.ts
 var VERSION = "1.2.0";
@@ -49,6 +51,9 @@ function formatText(result, options) {
   lines.push("");
   const langCount = Object.keys(result.languageBreakdown).length;
   lines.push(`Scanned ${result.filesScanned} files across ${langCount} language${langCount === 1 ? "" : "s"}`);
+  if (result.excludedCount && result.excludedCount > 0) {
+    lines.push(`(${result.excludedCount} excluded via .flagsharkignore + excludes)`);
+  }
   if (result.totalFlags === 0) {
     lines.push("No feature flags detected.");
     lines.push("");
@@ -85,6 +90,13 @@ function formatText(result, options) {
     lines.push("Automate cleanup \u2192 https://flagshark.com");
     lines.push("Open source CLI  \u2192 https://github.com/FlagShark/flagshark");
   }
+  if (result.excludedPaths && result.excludedPaths.length > 0) {
+    lines.push("");
+    lines.push(`Excluded files (${result.excludedPaths.length}):`);
+    for (const p of result.excludedPaths) {
+      lines.push(`  ${p}`);
+    }
+  }
   return lines.join("\n");
 }
 function formatJson(result) {
@@ -110,6 +122,7 @@ function formatJson(result) {
     detectedProviders: result.detectedProviders,
     languages,
     flags,
+    excludedPaths: result.excludedPaths,
     scanDuration: result.scanDuration,
     links: {
       dashboard: "https://flagshark.com",
@@ -121,7 +134,7 @@ function formatJson(result) {
 }
 
 // src/cli.ts
-var VERSION2 = "1.2.0";
+var VERSION2 = "1.3.0";
 var HELP_TEXT = `
 flagshark scan [options]
 
@@ -132,19 +145,30 @@ Options:
   --verbose         Show all stale flags (not just top 10)
   --help            Show help
   --version         Show version
+
+Configuration:
+  --config <path>          Use this config file (overrides .flagshark.yml discovery)
+  --no-config              Skip config file discovery
+  --no-ignore-file         Skip .flagsharkignore discovery
+  --show-excluded          Show excluded files in text output
 `.trim();
 function parseArgs(argv) {
   const args = {
     json: false,
     diff: null,
-    threshold: 6,
+    threshold: void 0,
     verbose: false,
     help: false,
     version: false
   };
   let i = 2;
   while (i < argv.length) {
-    const arg = argv[i];
+    let arg = argv[i];
+    if (arg.startsWith("--") && arg.includes("=")) {
+      const eqIdx = arg.indexOf("=");
+      argv.splice(i, 1, arg.slice(0, eqIdx), arg.slice(eqIdx + 1));
+      arg = argv[i];
+    }
     switch (arg) {
       case "--json":
         args.json = true;
@@ -174,6 +198,32 @@ function parseArgs(argv) {
       case "-v":
         args.version = true;
         break;
+      case "--engine": {
+        const value = argv[++i];
+        if (value !== "regex" && value !== "tree-sitter") {
+          process.stderr.write(`Error: --engine must be 'regex' or 'tree-sitter', got '${value}'
+`);
+          process.exit(2);
+        }
+        args.engine = value;
+        break;
+      }
+      case "--config":
+        i++;
+        args.configPath = argv[i];
+        if (!args.configPath) {
+          throw new Error("--config requires a file path argument");
+        }
+        break;
+      case "--no-config":
+        args.noConfig = true;
+        break;
+      case "--no-ignore-file":
+        args.noIgnoreFile = true;
+        break;
+      case "--show-excluded":
+        args.showExcluded = true;
+        break;
       case "scan":
         break;
       default:
@@ -212,12 +262,48 @@ async function main() {
   } else {
     logger.info("Scanning current directory...");
   }
+  let configOverride;
+  if (args.configPath) {
+    if (!existsSync(args.configPath)) {
+      process.stderr.write(`Error: config file not found: ${args.configPath}
+`);
+      process.exit(2);
+    }
+    const raw = readFileSync(args.configPath, "utf-8");
+    const parsed = parseYaml(raw);
+    const configResult = FlagsharkConfigSchema.safeParse(parsed);
+    if (!configResult.success) {
+      process.stderr.write(`Error: invalid config at ${args.configPath}: ${configResult.error.message}
+`);
+      process.exit(2);
+    }
+    configOverride = configResult.data;
+  }
   const result = await scanRepo({
     cwd: process.cwd(),
     threshold: args.threshold,
     diff: args.diff ?? void 0,
+    engine: args.engine,
+    config: configOverride,
+    noConfig: args.noConfig,
+    noIgnoreFile: args.noIgnoreFile,
+    collectExcludedPaths: args.showExcluded,
     logger
   });
+  if (args.verbose && result.effectiveExcludes) {
+    const r = result.effectiveExcludes;
+    const allRules = [
+      ...r.paths.map((p) => `excludes.paths: ${p}`),
+      ...r.files.map((p) => `excludes.files: ${p}`),
+      ...r.presets.flatMap((name, i) => [`excludes.presets[${i}]: ${name}`]),
+      ...r.ignoreFile.map((p) => `.flagsharkignore: ${p}`)
+    ];
+    if (allRules.length > 0) {
+      process.stderr.write("Effective excludes:\n");
+      for (const rule of allRules) process.stderr.write(`  ${rule}
+`);
+    }
+  }
   const output = args.json ? formatJson(result) + "\n" : formatText(result, { json: false, verbose: args.verbose, maxDisplay: 10 }) + "\n";
   const exitCode = result.staleFlags.length > 0 ? 1 : 0;
   if (process.stdout.write(output)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flagshark",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "type": "module",
   "description": "Find stale feature flags in your codebase",
   "license": "MIT",
@@ -17,12 +17,13 @@
 "main": "./dist/cli.js",
 "files": ["dist/", "bin/"],
 "scripts": {
-  "build": "esbuild src/cli.ts --bundle --platform=node --target=node18 --format=esm --outfile=dist/cli.js --external:zod --external:@flagshark/core",
+  "build": "esbuild src/cli.ts --bundle --platform=node --target=node18 --format=esm --outfile=dist/cli.js --external:zod --external:@flagshark/core --external:yaml",
   "test": "vitest run",
   "typecheck": "tsc --noEmit"
 },
 "dependencies": {
-  "@flagshark/core": "1.0.0",
+  "@flagshark/core": "1.2.0",
+  "yaml": "^2.4.0",
   "zod": "^3.23.0"
 },
 "devDependencies": {