fallow 3.7.0 → 3.8.0

package/capabilities.json

@@ -1,6 +1,6 @@
 {
   "name": "fallow",
-  "version": "3.7.0",
+  "version": "3.8.0",
   "manifest_version": "1",
   "description": "Codebase analyzer for TypeScript/JavaScript: unused code, circular dependencies, code duplication, complexity hotspots, and architecture boundary violations",
   "global_flags": [
@@ -1952,6 +1952,40 @@
           ]
         }
       ]
+    },
+    {
+      "name": "viz",
+      "description": "Generate an interactive HTML map of the codebase",
+      "flags": [
+        {
+          "name": "--out",
+          "type": "string",
+          "required": false,
+          "description": "Output file path (default: fallow-viz.html in project root)"
+        },
+        {
+          "name": "--no-open",
+          "type": "bool",
+          "required": false,
+          "description": "Don't open the output file in the browser",
+          "possible_values": [
+            "true",
+            "false"
+          ]
+        },
+        {
+          "name": "--viz-format",
+          "type": "string",
+          "required": false,
+          "description": "Visualization output format",
+          "default": "html",
+          "possible_values": [
+            "html",
+            "dot",
+            "mermaid"
+          ]
+        }
+      ]
     }
   ],
   "default_command": null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fallow",
-  "version": "3.7.0",
+  "version": "3.8.0",
   "description": "Codebase intelligence for TypeScript and JavaScript. Free static analysis of code and styles, optional paid runtime intelligence (Fallow Runtime). Quality, risk, architecture, dependencies, duplication, and design-system drift for humans, CI, and the agents writing your code. Zero-config framework support.",
   "license": "MIT",
   "repository": {
@@ -84,16 +84,16 @@
     "detect-libc": "2.1.2"
   },
   "devDependencies": {
-    "@tanstack/intent": "0.3.5"
+    "@tanstack/intent": "0.3.6"
   },
   "optionalDependencies": {
-    "@fallow-cli/darwin-arm64": "3.7.0",
-    "@fallow-cli/darwin-x64": "3.7.0",
-    "@fallow-cli/linux-x64-gnu": "3.7.0",
-    "@fallow-cli/linux-arm64-gnu": "3.7.0",
-    "@fallow-cli/linux-x64-musl": "3.7.0",
-    "@fallow-cli/linux-arm64-musl": "3.7.0",
-    "@fallow-cli/win32-arm64-msvc": "3.7.0",
-    "@fallow-cli/win32-x64-msvc": "3.7.0"
+    "@fallow-cli/darwin-arm64": "3.8.0",
+    "@fallow-cli/darwin-x64": "3.8.0",
+    "@fallow-cli/linux-x64-gnu": "3.8.0",
+    "@fallow-cli/linux-arm64-gnu": "3.8.0",
+    "@fallow-cli/linux-x64-musl": "3.8.0",
+    "@fallow-cli/linux-arm64-musl": "3.8.0",
+    "@fallow-cli/win32-arm64-msvc": "3.8.0",
+    "@fallow-cli/win32-x64-msvc": "3.8.0"
   }
 }

package/skills/fallow/SKILL.md

@@ -122,6 +122,7 @@ Route by intent before reaching for the big analysis commands. Same matrix as `f
 | `coverage` | Runtime coverage setup, focused analysis, and cloud inventory workflow helper | `setup`, `setup --yes`, `setup --non-interactive`, `analyze --runtime-coverage <path>`, `analyze --cloud --repo owner/repo`, `upload-inventory` |
 | `coverage upload-source-maps` | Upload build source maps from CI so bundled runtime coverage resolves to original source paths. Retries 429 `Retry-After` and transient gateway failures. Use `FALLOW_CA_BUNDLE` for complete custom PEM trust bundles. | `--dir dist`, `--git-sha <sha>`, `--repo <name>`, `--strip-path=false`, `--dry-run` |
 | `setup-hooks` | Install or remove a Claude Code PreToolUse hook that gates `git commit` / `git push` on `fallow audit`, so the agent cleans findings before the command runs | `--agent`, `--dry-run`, `--force`, `--user`, `--gitignore-claude`, `--uninstall` |
+| `viz` | Render the codebase as a self-contained interactive HTML map (treemap + import graph, four lenses: dead code, duplication, boundaries, complexity, with click-through detail panels), or emit the import graph as text. Read-only. | `--out <path>`, `--no-open`, `--viz-format html\|dot\|mermaid`, `--root`, `--config`, `--production`, `--no-cache` |
 
 Run `fallow <command> --help` for the full flag list per command (see also references/cli-reference.md).
 <!-- generated:commands:end -->

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

@@ -510,7 +510,7 @@ fallow health --format json --quiet --trend
 {
   "kind": "health",
   "schema_version": 7,
-  "version": "3.7.0",
+  "version": "3.8.0",
   "elapsed_ms": 32,
   "summary": {
     "files_analyzed": 482,
@@ -908,7 +908,7 @@ fallow audit \
 {
   "kind": "audit",
   "schema_version": 7,
-  "version": "3.7.0",
+  "version": "3.8.0",
   "command": "audit",
   "verdict": "fail",
   "changed_files_count": 12,
@@ -930,7 +930,9 @@ fallow audit \
     "complexity_introduced": 1,
     "complexity_inherited": 0,
     "duplication_introduced": 0,
-    "duplication_inherited": 0
+    "duplication_inherited": 0,
+    "styling_introduced": 0,
+    "styling_inherited": 0
   },
   "dead_code": {
     "schema_version": 3,
@@ -946,7 +948,7 @@ fallow audit \
 }
 ```
 
-The `verdict` field is always present and is the primary decision signal. With the default `new-only` gate, the `attribution` object counts introduced vs inherited findings and audit sub-results annotate individual findings with `introduced: true/false`. With `gate=all`, audit skips that extra base-snapshot attribution pass, so introduced/inherited counts stay `0` and per-finding `introduced` fields are omitted. Dead code, complexity, and duplication sections follow their respective schemas from the individual commands. Thresholds for complexity are inherited from `fallow health` config (defaults: cyclomatic 20, cognitive 15).
+The `verdict` field is always present and is the primary decision signal. With the default `new-only` gate, the `attribution` object counts introduced vs inherited findings across dead code, complexity, duplication, and styling, and audit sub-results annotate individual findings with `introduced: true/false`. With `gate=all`, audit skips that extra base-snapshot attribution pass, so introduced/inherited counts stay `0` and per-finding `introduced` fields are omitted. Dead code, complexity, and duplication sections follow their respective schemas from the individual commands. Thresholds for complexity are inherited from `fallow health` config (defaults: cyclomatic 20, cognitive 15).
 
 Audit creates a temporary git worktree to compare against the base ref. When the current checkout has `node_modules`, audit links it into the base worktree so tsconfig `extends` chains into installed packages and path aliases resolve like the working tree. The worktree is removed on normal exit. If the process is force-killed, run `git worktree prune` to clean up stale `.git/worktrees/fallow-audit-base-*` entries.
 
@@ -983,7 +985,7 @@ fallow flags --format json --quiet --workspace my-package
 ```json
 {
   "schema_version": 7,
-  "version": "3.7.0",
+  "version": "3.8.0",
   "elapsed_ms": 116,
   "feature_flags": [],
   "total_flags": 0
@@ -1084,7 +1086,7 @@ fallow security --gate newly-reachable --changed-since origin/main
 {
   "kind": "security",
   "schema_version": "4",
-  "version": "3.7.0",
+  "version": "3.8.0",
   "elapsed_ms": 42,
   "config": {
     "rules": {
@@ -1113,7 +1115,7 @@ fallow security --gate newly-reachable --changed-since origin/main
 {
   "kind": "security",
   "schema_version": "4",
-  "version": "3.7.0",
+  "version": "3.8.0",
   "elapsed_ms": 42,
   "config": {
     "rules": {
@@ -1838,7 +1840,7 @@ The HTTP layer mirrors the bash `gh_api_retry` / `curl_retry` helpers: `FALLOW_A
 {
   "kind": "dead-code",
   "schema_version": 7,
-  "version": "3.7.0",
+  "version": "3.8.0",
   "elapsed_ms": 45,
   "total_issues": 12,
   "entry_points": {
@@ -1998,7 +2000,7 @@ When `--baseline` is used in combined output, the JSON includes a `baseline_delt
 {
   "kind": "dupes",
   "schema_version": 7,
-  "version": "3.7.0",
+  "version": "3.8.0",
   "elapsed_ms": 82,
   "total_clones": 15,
   "total_lines_duplicated": 230,
@@ -2042,11 +2044,11 @@ When running `fallow` with no subcommand (all analyses), the JSON output combine
 {
   "kind": "combined",
   "schema_version": 7,
-  "version": "3.7.0",
+  "version": "3.8.0",
   "elapsed_ms": 159,
   "check": {
     "schema_version": 7,
-    "version": "3.7.0",
+    "version": "3.8.0",
     "elapsed_ms": 45,
     "total_issues": 12,
     "unused_files": [],

package/types/output-contract.d.ts

@@ -961,6 +961,8 @@ complexity_introduced: number
 complexity_inherited: number
 duplication_introduced: number
 duplication_inherited: number
+styling_introduced: number
+styling_inherited: number
 }
 /**
  * Metric and rule definitions emitted under `_meta` when `--explain` is
@@ -7155,6 +7157,10 @@ fix_hint?: (string | null)
  * Suggested next steps (verify / suppress; never an auto-fix).
  */
 actions: CssCandidateAction[]
+/**
+ * Audit-mode flag indicating whether the finding is new versus the base snapshot.
+ */
+introduced?: (boolean | null)
 }
 /**
  * Envelope emitted by `fallow explain <issue-type> --format json`.