fallow 2.67.0 → 2.68.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fallow",
-  "version": "2.67.0",
+  "version": "2.68.0",
   "description": "Codebase intelligence for TypeScript and JavaScript. Finds unused code, duplication, circular dependencies, complexity hotspots, and architecture drift. Optional runtime intelligence layer (Fallow Runtime) adds production execution evidence. Rust-native, sub-second, 94 framework plugins.",
   "license": "MIT",
   "repository": {
@@ -55,13 +55,13 @@
     "@tanstack/intent": "0.0.36"
   },
   "optionalDependencies": {
-    "@fallow-cli/darwin-arm64": "2.67.0",
-    "@fallow-cli/darwin-x64": "2.67.0",
-    "@fallow-cli/linux-x64-gnu": "2.67.0",
-    "@fallow-cli/linux-arm64-gnu": "2.67.0",
-    "@fallow-cli/linux-x64-musl": "2.67.0",
-    "@fallow-cli/linux-arm64-musl": "2.67.0",
-    "@fallow-cli/win32-arm64-msvc": "2.67.0",
-    "@fallow-cli/win32-x64-msvc": "2.67.0"
+    "@fallow-cli/darwin-arm64": "2.68.0",
+    "@fallow-cli/darwin-x64": "2.68.0",
+    "@fallow-cli/linux-x64-gnu": "2.68.0",
+    "@fallow-cli/linux-arm64-gnu": "2.68.0",
+    "@fallow-cli/linux-x64-musl": "2.68.0",
+    "@fallow-cli/linux-arm64-musl": "2.68.0",
+    "@fallow-cli/win32-arm64-msvc": "2.68.0",
+    "@fallow-cli/win32-x64-msvc": "2.68.0"
   }
 }

package/schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "FallowConfig",
-  "description": "User-facing configuration loaded from `.fallowrc.json` or `fallow.toml`.\n\n# Examples\n\n```\nuse fallow_config::FallowConfig;\n\n// Default config has sensible defaults\nlet config = FallowConfig::default();\nassert!(config.entry.is_empty());\nassert!(!config.production);\n\n// Deserialize from JSON\nlet config: FallowConfig = serde_json::from_str(r#\"{\n    \"entry\": [\"src/main.ts\"],\n    \"production\": true\n}\"#).unwrap();\nassert_eq!(config.entry, vec![\"src/main.ts\"]);\nassert!(config.production);\n```",
+  "description": "User-facing configuration loaded from `.fallowrc.json`, `.fallowrc.jsonc`, `fallow.toml`, or `.fallow.toml`.\n\n# Examples\n\n```\nuse fallow_config::FallowConfig;\n\n// Default config has sensible defaults\nlet config = FallowConfig::default();\nassert!(config.entry.is_empty());\nassert!(!config.production);\n\n// Deserialize from JSON\nlet config: FallowConfig = serde_json::from_str(r#\"{\n    \"entry\": [\"src/main.ts\"],\n    \"production\": true\n}\"#).unwrap();\nassert_eq!(config.entry, vec![\"src/main.ts\"]);\nassert!(config.production);\n```",
   "type": "object",
   "properties": {
     "$schema": {
@@ -1004,7 +1004,7 @@
       ]
     },
     "FlagsConfig": {
-      "description": "Feature flag detection configuration.\n\nControls which patterns fallow uses to detect feature flags in source code.\nConfigured via the `flags` section in `.fallowrc.json` or `fallow.toml`.\n\n# Examples\n\n```json\n{\n  \"flags\": {\n    \"sdkPatterns\": [\n      { \"function\": \"useFlag\", \"nameArg\": 0, \"provider\": \"LaunchDarkly\" }\n    ],\n    \"envPrefixes\": [\"FEATURE_\", \"NEXT_PUBLIC_ENABLE_\"],\n    \"configObjectHeuristics\": false\n  }\n}\n```",
+      "description": "Feature flag detection configuration.\n\nControls which patterns fallow uses to detect feature flags in source code.\nConfigured via the `flags` section in `.fallowrc.json`, `.fallowrc.jsonc`, `fallow.toml`, or `.fallow.toml`.\n\n# Examples\n\n```json\n{\n  \"flags\": {\n    \"sdkPatterns\": [\n      { \"function\": \"useFlag\", \"nameArg\": 0, \"provider\": \"LaunchDarkly\" }\n    ],\n    \"envPrefixes\": [\"FEATURE_\", \"NEXT_PUBLIC_ENABLE_\"],\n    \"configObjectHeuristics\": false\n  }\n}\n```",
       "type": "object",
       "properties": {
         "sdkPatterns": {
@@ -1056,7 +1056,7 @@
       ]
     },
     "ResolveConfig": {
-      "description": "Module resolver configuration.\n\nControls how fallow resolves import specifiers against package.json\n`exports` / `imports` fields and tsconfig paths. Configured via the\n`resolve` section in `.fallowrc.json` or `fallow.toml`.\n\n# Examples\n\n```json\n{\n  \"resolve\": {\n    \"conditions\": [\"development\", \"worker\"]\n  }\n}\n```",
+      "description": "Module resolver configuration.\n\nControls how fallow resolves import specifiers against package.json\n`exports` / `imports` fields and tsconfig paths. Configured via the\n`resolve` section in `.fallowrc.json`, `.fallowrc.jsonc`, `fallow.toml`, or `.fallow.toml`.\n\n# Examples\n\n```json\n{\n  \"resolve\": {\n    \"conditions\": [\"development\", \"worker\"]\n  }\n}\n```",
       "type": "object",
       "properties": {
         "conditions": {

package/skills/fallow/SKILL.md

@@ -287,14 +287,17 @@ fallow dead-code --format json --quiet --trace-dependency lodash
 # Preview migration
 fallow migrate --dry-run
 
-# Apply migration (creates .fallowrc.json)
+# Apply migration (auto-mirrors source extension: knip.jsonc -> .fallowrc.jsonc, knip.json -> .fallowrc.json)
 fallow migrate
 
+# Force JSONC output regardless of source (lets editors syntax-highlight comments)
+fallow migrate --jsonc
+
 # Migrate to TOML (creates fallow.toml)
 fallow migrate --toml
 ```
 
-Auto-detects `knip.json`, `.knip.json`, `.jscpd.json`, and package.json embedded configs.
+Auto-detects `knip.json`, `knip.jsonc`, `.knip.json`, `.knip.jsonc`, `.jscpd.json`, and package.json embedded configs.
 
 ### Initialize a new config
 

package/skills/fallow/references/cli-reference.md

@@ -266,10 +266,13 @@ Migrates configuration from knip and/or jscpd to fallow. Auto-detects config fil
 
 | Flag | Type | Description |
 |------|------|-------------|
-| `--toml` | bool | Output as TOML instead of JSON |
+| `--toml` | bool | Output as `fallow.toml` (mutually exclusive with `--jsonc`) |
+| `--jsonc` | bool | Write to `.fallowrc.jsonc` instead of `.fallowrc.json`. Same JSONC content either way; the `.jsonc` extension lets editors auto-detect JSON-with-comments syntax highlighting |
 | `--dry-run` | bool | Preview without writing |
 | `--from` | path | Specify source config file path |
 
+Without `--jsonc` or `--toml`, fallow auto-mirrors the source extension: a `knip.jsonc` migration writes `.fallowrc.jsonc`, a `knip.json` migration writes `.fallowrc.json`.
+
 ### Detected Source Configs
 
 - `knip.json`, `knip.jsonc`, `.knip.json`, `.knip.jsonc`
@@ -280,10 +283,11 @@ Migrates configuration from knip and/or jscpd to fallow. Auto-detects config fil
 ### Examples
 
 ```bash
-fallow migrate --dry-run    # preview
-fallow migrate              # auto-detect and write .fallowrc.json
-fallow migrate --toml       # output as TOML
-fallow migrate --from knip.json
+fallow migrate --dry-run        # preview
+fallow migrate                  # auto-detect; mirrors source extension
+fallow migrate --jsonc          # force .fallowrc.jsonc output
+fallow migrate --toml           # output as fallow.toml
+fallow migrate --from knip.jsonc
 ```
 
 ---
@@ -1378,9 +1382,9 @@ With `--score`, the combined output's `health` section includes a `health_score`
 
 ## Configuration File Format
 
-Config files are searched in priority order: `.fallowrc.json` > `fallow.toml` > `.fallow.toml`
+Config files are searched in priority order: `.fallowrc.json` > `.fallowrc.jsonc` > `fallow.toml` > `.fallow.toml`. Both `.fallowrc.json` and `.fallowrc.jsonc` are parsed as JSON-with-comments; the `.jsonc` extension lets editors auto-detect JSONC syntax highlighting.
 
-### JSON Format (`.fallowrc.json`)
+### JSON Format (`.fallowrc.json` / `.fallowrc.jsonc`)
 
 ```jsonc
 {