flagshark 1.5.0 → 2.1.0

package/README.md

@@ -2,6 +2,8 @@
 
 **Find stale feature flags in your codebase.** Polyglot CLI + GitHub Action. 13 languages, 13 providers, zero config.
 
+📚 **CLI documentation: [flagshark.com/docs/getting-started/cli](https://flagshark.com/docs/getting-started/cli/)**
+
 ```bash
 npx flagshark scan
 ```
@@ -50,7 +52,7 @@ flagshark scan [options]
 
 Scan options:
   --diff <ref>             Only scan files changed since this git ref (e.g. main, HEAD~1)
-  --threshold <months>     Staleness age threshold (default: 6, or config.threshold)
+  --threshold <days>       Staleness age threshold (default: 30, or config.threshold)
   --verbose                Show all stale flags + effective exclude rules
 
 Output:
@@ -66,14 +68,14 @@ Configuration:
 Example invocations:
 
 ```bash
-# Scan current directory, default 6-month threshold
+# Scan current directory, default 30-day threshold
 flagshark scan
 
 # Scan only files changed since main
 flagshark scan --diff main
 
 # Stricter threshold + JSON for piping
-flagshark scan --threshold 3 --json | jq '.staleFlags'
+flagshark scan --threshold 7 --json | jq '.staleFlags'
 
 # Use a custom config file
 flagshark scan --config ./tooling/flagshark.yml
@@ -106,7 +108,7 @@ examples/
 ### `.flagshark.yml` — full config
 
 ```yaml
-threshold: 6
+threshold: 30
 
 excludes:
   paths:
@@ -124,9 +126,9 @@ suppress:
 
 paths:                           # Per-path threshold overrides
   - match: 'src/critical/**'
-    threshold: 3
+    threshold: 90                # stricter for critical code (days)
   - match: 'src/experimental/**'
-    threshold: 12
+    threshold: 365               # looser for experiments (days)
 ```
 
 The unconditional baseline — `node_modules`, `.git`, `dist`, `build`, `coverage`, `__pycache__`, `vendor`, `.next`, `.turbo` — is always skipped.
@@ -173,7 +175,7 @@ Building a tool on top of the engine? Use [`@flagshark/core`](https://www.npmjs.
 ```ts
 import { scanRepo } from '@flagshark/core'
 
-const result = await scanRepo({ cwd: process.cwd(), threshold: 6 })
+const result = await scanRepo({ cwd: process.cwd(), threshold: 30 })
 console.log(`${result.staleFlags.length} stale of ${result.totalFlags}`)
 ```
 

package/dist/cli.js

@@ -14,7 +14,7 @@ flagshark scan [options]
 Options:
   --json            Output as JSON
   --diff <ref>      Only scan files changed since <ref> (e.g., HEAD~1, main)
-  --threshold <n>   Staleness threshold in months (default: 6)
+  --threshold <n>   Staleness threshold in days (default: 30)
   --verbose         Show all stale flags (not just top 10)
   --help            Show help
   --version         Show version
@@ -82,7 +82,7 @@ function parseArgs(argv) {
         i++;
         args.threshold = parseInt(argv[i], 10);
         if (isNaN(args.threshold) || args.threshold < 1) {
-          throw new Error("--threshold requires a positive integer (months)");
+          throw new Error("--threshold requires a positive integer (days)");
         }
         break;
       case "--verbose":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flagshark",
-  "version": "1.5.0",
+  "version": "2.1.0",
   "type": "module",
   "description": "Find stale feature flags in your codebase",
   "license": "MIT",
@@ -23,7 +23,7 @@
   "typecheck": "tsc --noEmit"
 },
 "dependencies": {
-  "@flagshark/core": "1.5.0",
+  "@flagshark/core": "2.0.0",
   "yaml": "^2.4.0",
   "zod": "^3.23.0"
 },