fallow 3.33.0 → 3.33.1

package/capabilities.json

@@ -1,6 +1,6 @@
 {
   "name": "fallow",
-  "version": "3.33.0",
+  "version": "3.33.1",
   "manifest_version": "1",
   "description": "Codebase analyzer for TypeScript/JavaScript: unused code, circular dependencies, code duplication, complexity hotspots, and architecture boundary violations",
   "global_flags": [
@@ -142,7 +142,7 @@
       "name": "--baseline",
       "type": "string",
       "required": false,
-      "description": "Compare against a previously saved baseline file. Used by bare `fallow`, `dead-code`, `architecture`, `dupes` and `health`; other subcommands reject it"
+      "description": "Compare against a previously saved baseline file. Used by bare `fallow`, `dead-code`, `architecture`, `dupes` and `health`; other subcommands reject it. On bare `fallow` it holds the dead-code baseline only: pass health and duplication baselines with `--health-baseline` and `--dupes-baseline`"
     },
     {
       "name": "--baseline-mode",
@@ -164,7 +164,7 @@
       "name": "--save-baseline",
       "type": "string",
       "required": false,
-      "description": "Save the current results as a baseline file. Used by bare `fallow`, `dead-code`, `architecture`, `dupes` and `health`; other subcommands reject it. The path must resolve inside the project root, its Git work tree, the CI workspace or a temp directory"
+      "description": "Save the current results as a baseline file. Used by bare `fallow`, `dead-code`, `architecture`, `dupes` and `health`; other subcommands reject it. On bare `fallow` it saves the dead-code baseline only: save the others with `fallow health --save-baseline` and `fallow dupes --save-baseline`. The path must resolve inside the project root, its Git work tree, the CI workspace or a temp directory"
     },
     {
       "name": "--production",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fallow",
-  "version": "3.33.0",
+  "version": "3.33.1",
   "mcpName": "io.github.fallow-rs/fallow",
   "description": "Codebase intelligence for TypeScript and JavaScript: health, complexity, duplication, architecture, styling drift, and unused code from one graph. CLI, LSP, and MCP server. Zero config for over 100 frameworks.",
   "license": "MIT",
@@ -89,14 +89,14 @@
     "@tanstack/intent": "0.4.0"
   },
   "optionalDependencies": {
-    "@fallow-cli/darwin-arm64": "3.33.0",
-    "@fallow-cli/darwin-x64": "3.33.0",
-    "@fallow-cli/linux-x64-gnu": "3.33.0",
-    "@fallow-cli/linux-arm64-gnu": "3.33.0",
-    "@fallow-cli/linux-x64-musl": "3.33.0",
-    "@fallow-cli/linux-arm64-musl": "3.33.0",
-    "@fallow-cli/win32-arm64-msvc": "3.33.0",
-    "@fallow-cli/win32-x64-msvc": "3.33.0",
-    "fallow-type-aware": "3.33.0"
+    "@fallow-cli/darwin-arm64": "3.33.1",
+    "@fallow-cli/darwin-x64": "3.33.1",
+    "@fallow-cli/linux-x64-gnu": "3.33.1",
+    "@fallow-cli/linux-arm64-gnu": "3.33.1",
+    "@fallow-cli/linux-x64-musl": "3.33.1",
+    "@fallow-cli/linux-arm64-musl": "3.33.1",
+    "@fallow-cli/win32-arm64-msvc": "3.33.1",
+    "@fallow-cli/win32-x64-msvc": "3.33.1",
+    "fallow-type-aware": "3.33.1"
   }
 }

package/skills/fallow/SKILL.md

@@ -286,7 +286,7 @@ fallow dead-code --format json --quiet --save-baseline .fallow/snapshot.json
 fallow dead-code --format json --quiet --baseline .fallow/snapshot.json
 ```
 
-`--save-regression-baseline` / `--regression-baseline` / `--fail-on-regression` / `--tolerance` are count-based gates for `dead-code`, `architecture`, bare combined mode, and `flags --retirement` (a flags baseline needs a PATH; without `--retirement` the options have no effect on `flags` and it warns). `--save-baseline` / `--baseline` are identity-based (track finding identity, fail on new). `audit` rejects the global baseline flags and uses `--dead-code-baseline` / `--health-baseline` / `--dupes-baseline` instead.
+`--save-regression-baseline` / `--regression-baseline` / `--fail-on-regression` / `--tolerance` are count-based gates for `dead-code`, `architecture`, bare combined mode, and `flags --retirement` (a flags baseline needs a PATH; without `--retirement` the options have no effect on `flags` and it warns). `--save-baseline` / `--baseline` are identity-based (track finding identity, fail on new). On bare `fallow` they hold the dead-code baseline only; pass health and duplication baselines with `--health-baseline` / `--dupes-baseline`. `audit` rejects the global baseline flags and uses `--dead-code-baseline` / `--health-baseline` / `--dupes-baseline` instead.
 
 With no path, `--save-regression-baseline` updates `regression.baseline` in the discovered fallow config, or creates `.fallowrc.json` when none exists. Pass a path only when a standalone baseline file is preferred.
 

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

@@ -520,7 +520,7 @@ Human output groups paths under "Shared with your team (commit these)" and "Loca
 {
   "kind": "agent-install",
   "schema_version": 1,
-  "fallow_version": "3.33.0",
+  "fallow_version": "3.33.1",
   "root": "/abs/path",
   "mode": "install",
   "dry_run": false,
@@ -730,7 +730,7 @@ fallow health --format json --quiet --trend
 {
   "kind": "health",
   "schema_version": 7,
-  "version": "3.33.0",
+  "version": "3.33.1",
   "elapsed_ms": 32,
   "summary": {
     "files_analyzed": 482,
@@ -1146,7 +1146,7 @@ fallow audit \
 {
   "kind": "audit",
   "schema_version": 7,
-  "version": "3.33.0",
+  "version": "3.33.1",
   "command": "audit",
   "verdict": "fail",
   "changed_files_count": 12,
@@ -1234,7 +1234,7 @@ fallow flags --format json --quiet --workspace my-package
 ```json
 {
   "schema_version": 7,
-  "version": "3.33.0",
+  "version": "3.33.1",
   "elapsed_ms": 116,
   "feature_flags": [],
   "total_flags": 0
@@ -1335,7 +1335,7 @@ fallow security --gate newly-reachable --changed-since origin/main
 {
   "kind": "security",
   "schema_version": "4",
-  "version": "3.33.0",
+  "version": "3.33.1",
   "elapsed_ms": 42,
   "config": {
     "rules": {
@@ -1364,7 +1364,7 @@ fallow security --gate newly-reachable --changed-since origin/main
 {
   "kind": "security",
   "schema_version": "4",
-  "version": "3.33.0",
+  "version": "3.33.1",
   "elapsed_ms": 42,
   "config": {
     "rules": {
@@ -1957,10 +1957,10 @@ Available on all commands:
 | `--diff-stdin` | `bool` | `false` | Read the unified diff from stdin. Equivalent to `--diff-file -` |
 | `--churn-file` | `string` | - | Import change history from a `fallow-churn/v1` JSON file instead of `git log`, powering hotspots, ownership, and bus-factor on projects with no git repository (Yandex Arc, Mercurial, Perforce). A small wrapper translates your VCS log into the contract. Resolved relative to `--root`. Affects `health --hotspots` / `--ownership` / `--targets` only; `audit`, `impact`, and `--changed-since` still require git |
 | `--max-file-size` | `string` | - | Skip source files larger than this many megabytes (default 5) instead of parsing them, guarding against the out-of-memory blowup a single multi-MB generated/vendored/bundled file causes on large repos. Use `0` for no limit. Declaration files (`.d.ts`) are always analyzed. Skipped files are reported and excluded from every analysis. Also settable via `FALLOW_MAX_FILE_SIZE` |
-| `--baseline` | `string` | - | Compare to baseline |
+| `--baseline` | `string` | - | Compare to baseline. On bare `fallow` it holds the dead-code baseline only; use `--health-baseline` and `--dupes-baseline` for the others |
 | `--baseline-mode` | `count\|identity` | - | How `--baseline` matches health findings: per file and category (`count`, the default) or per function identity (`identity`, strict, and only against a baseline saved with `--baseline-mode identity`; such a baseline still reads in count mode). Identity is file path plus function name, so renaming or moving a function that is still in the baseline reports it as new; re-save after that kind of refactor. |
 | `--parent-run` | `string` | - | Correlate this run with a previous telemetry analysis run |
-| `--save-baseline` | `string` | - | Save results as baseline |
+| `--save-baseline` | `string` | - | Save results as baseline. On bare `fallow` it saves the dead-code baseline only |
 | `--production` | `bool` | `false` | Exclude test/dev files, only start/build scripts (applies to every analysis) |
 | `--no-production` | `bool` | `false` | Force production mode OFF for every analysis, overriding a project config's `production: true` (and `FALLOW_PRODUCTION`). Conflicts with `--production` |
 | `--production-dead-code` | `bool` | `false` | Run dead-code analysis in production mode when using bare combined mode |
@@ -2179,7 +2179,7 @@ The HTTP layer mirrors the bash `gh_api_retry` / `curl_retry` helpers: `FALLOW_A
 {
   "kind": "dead-code",
   "schema_version": 7,
-  "version": "3.33.0",
+  "version": "3.33.1",
   "elapsed_ms": 45,
   "total_issues": 12,
   "entry_points": {
@@ -2339,7 +2339,7 @@ When `--baseline` is used in combined output, the JSON includes a `baseline_delt
 {
   "kind": "dupes",
   "schema_version": 7,
-  "version": "3.33.0",
+  "version": "3.33.1",
   "elapsed_ms": 82,
   "total_clones": 15,
   "total_lines_duplicated": 230,
@@ -2383,11 +2383,11 @@ When running `fallow` with no subcommand (all analyses), the JSON output combine
 {
   "kind": "combined",
   "schema_version": 7,
-  "version": "3.33.0",
+  "version": "3.33.1",
   "elapsed_ms": 159,
   "check": {
     "schema_version": 7,
-    "version": "3.33.0",
+    "version": "3.33.1",
     "elapsed_ms": 45,
     "total_issues": 12,
     "unused_files": [],

package/skills/fallow-setup/references/ci-gate.md

@@ -58,4 +58,4 @@ fallow health --format json --quiet --save-baseline fallow-baselines/health.json
 fallow dupes --format json --quiet --save-baseline fallow-baselines/dupes.json
 ```
 
-Commit the baseline files. Pass each file to the matching command with `--baseline <path>`. `fallow audit` uses `--dead-code-baseline`, `--health-baseline`, and `--dupes-baseline` instead. `--fail-on-baseline-growth` makes a committed baseline shrink-only. After a fix, `fallow baselines prune` removes the entries that match no current finding, so `--fail-on-stale-baseline` stays green. Point `audit.deadCodeBaseline`, `audit.healthBaseline` and `audit.dupesBaseline` at the files so that one command prunes all three. Tell the user how many findings the baseline contains, and suggest that the team removes them by category.
+Commit the baseline files. Pass each file to the matching command with `--baseline <path>`. On bare `fallow`, `--baseline` holds the dead-code baseline only: pass the health and duplication files with `--health-baseline` and `--dupes-baseline`. The GitHub Action takes them as the `baseline`, `health-baseline` and `dupes-baseline` inputs, and the GitLab template as `FALLOW_BASELINE`, `FALLOW_HEALTH_BASELINE` and `FALLOW_DUPES_BASELINE`. `fallow audit` uses `--dead-code-baseline`, `--health-baseline`, and `--dupes-baseline` instead. `--fail-on-baseline-growth` makes a committed baseline shrink-only. After a fix, `fallow baselines prune` removes the entries that match no current finding, so `--fail-on-stale-baseline` stays green. Point `audit.deadCodeBaseline`, `audit.healthBaseline` and `audit.dupesBaseline` at the files so that one command prunes all three. Tell the user how many findings the baseline contains, and suggest that the team removes them by category.