fallow 3.31.0 → 3.33.0

package/capabilities.json

@@ -1,6 +1,6 @@
 {
   "name": "fallow",
-  "version": "3.31.0",
+  "version": "3.33.0",
   "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`, `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"
     },
     {
       "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`, `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. The path must resolve inside the project root, its Git work tree, the CI workspace or a temp directory"
     },
     {
       "name": "--production",
@@ -241,6 +241,12 @@
         "section"
       ]
     },
+    {
+      "name": "--group",
+      "type": "string",
+      "required": false,
+      "description": "Keep only the matching groups of a `--group-by` health run. Accepts exact group keys, glob patterns, and `!`-prefixed negations. Values can be comma-separated or repeated. Project-level sections are not filtered. Supported by `fallow health` only"
+    },
     {
       "name": "--performance",
       "type": "bool",
@@ -305,7 +311,7 @@
       "name": "--sarif-file",
       "type": "string",
       "required": false,
-      "description": "Write SARIF output to a file (in addition to the primary --format output). Used by bare `fallow`, `dead-code` and `security`. The path must resolve inside the project root, its Git work tree, the CI workspace or a temp directory"
+      "description": "Write SARIF output to a file (in addition to the primary --format output). Used by bare `fallow`, `dead-code`, `architecture` and `security`. The path must resolve inside the project root, its Git work tree, the CI workspace or a temp directory"
     },
     {
       "name": "--output-file",
@@ -393,7 +399,8 @@
       "possible_values": [
         "dead-code",
         "dupes",
-        "health"
+        "health",
+        "architecture"
       ]
     },
     {
@@ -404,7 +411,8 @@
       "possible_values": [
         "dead-code",
         "dupes",
-        "health"
+        "health",
+        "architecture"
       ]
     },
     {
@@ -493,6 +501,26 @@
         "false"
       ]
     },
+    {
+      "name": "--dupes-ignore-symlinks",
+      "type": "bool",
+      "required": false,
+      "description": "Omit clone instances whose path is a symlink, or lies under a symlinked directory, in combined mode",
+      "possible_values": [
+        "true",
+        "false"
+      ]
+    },
+    {
+      "name": "--dupes-no-ignore-symlinks",
+      "type": "bool",
+      "required": false,
+      "description": "Report symlinked clone instances in combined mode (opt out of a config `duplicates.ignoreSymlinks: true`)",
+      "possible_values": [
+        "true",
+        "false"
+      ]
+    },
     {
       "name": "--score",
       "type": "bool",
@@ -513,6 +541,12 @@
         "false"
       ]
     },
+    {
+      "name": "--trend-from",
+      "type": "string",
+      "required": false,
+      "description": "Compare current health metrics against this snapshot file in combined mode. Implies --trend and --score"
+    },
     {
       "name": "--save-snapshot",
       "type": "string",
@@ -553,6 +587,16 @@
         "false"
       ]
     },
+    {
+      "name": "--show-cascade",
+      "type": "bool",
+      "required": false,
+      "description": "Also report the unused exports, types, class members and enum members of unused files. By default the report hides them, because deleting the file removes them, and counts them in `cascade_hidden`",
+      "possible_values": [
+        "true",
+        "false"
+      ]
+    },
     {
       "name": "--type-aware",
       "type": "bool",
@@ -593,7 +637,7 @@
   "commands": [
     {
       "name": "dead-code",
-      "description": "Analyze project for unused code and circular dependencies",
+      "description": "Analyze project for unused code and dependency hygiene",
       "flags": [
         {
           "name": "--unused-files",
@@ -715,6 +759,16 @@
             "false"
           ]
         },
+        {
+          "name": "--absent-component-props",
+          "type": "bool",
+          "required": false,
+          "description": "Review optional props omitted by known reachable callers (enables this rule)",
+          "possible_values": [
+            "true",
+            "false"
+          ]
+        },
         {
           "name": "--unused-component-emits",
           "type": "bool",
@@ -809,7 +863,7 @@
           "name": "--circular-deps",
           "type": "bool",
           "required": false,
-          "description": "Only report circular dependencies",
+          "description": "Only report circular dependencies. Deprecated alias: use `fallow architecture --cycles`",
           "possible_values": [
             "true",
             "false"
@@ -819,7 +873,7 @@
           "name": "--re-export-cycles",
           "type": "bool",
           "required": false,
-          "description": "Only report re-export cycles",
+          "description": "Only report re-export cycles. Deprecated alias: use `fallow architecture --cycles`",
           "possible_values": [
             "true",
             "false"
@@ -829,7 +883,7 @@
           "name": "--package-cycles",
           "type": "bool",
           "required": false,
-          "description": "Only report dependency cycles between workspace packages",
+          "description": "Only report dependency cycles between workspace packages. Deprecated alias: use `fallow architecture --cycles`",
           "possible_values": [
             "true",
             "false"
@@ -839,7 +893,7 @@
           "name": "--boundary-violations",
           "type": "bool",
           "required": false,
-          "description": "Only report boundary violations",
+          "description": "Only report boundary violations. Deprecated alias: use `fallow architecture --boundaries`",
           "possible_values": [
             "true",
             "false"
@@ -849,7 +903,7 @@
           "name": "--policy-violations",
           "type": "bool",
           "required": false,
-          "description": "Only report rule-pack policy violations",
+          "description": "Only report rule-pack policy violations. Deprecated alias: use `fallow architecture --policy`",
           "possible_values": [
             "true",
             "false"
@@ -981,6 +1035,60 @@
         }
       ]
     },
+    {
+      "name": "architecture",
+      "description": "Check import cycles, boundaries and policy rules after editing",
+      "flags": [
+        {
+          "name": "--cycles",
+          "type": "bool",
+          "required": false,
+          "description": "Only report import cycles: circular dependencies, re-export cycles and package cycles",
+          "possible_values": [
+            "true",
+            "false"
+          ]
+        },
+        {
+          "name": "--boundaries",
+          "type": "bool",
+          "required": false,
+          "description": "Only report boundary violations, boundary coverage and forbidden calls",
+          "possible_values": [
+            "true",
+            "false"
+          ]
+        },
+        {
+          "name": "--policy",
+          "type": "bool",
+          "required": false,
+          "description": "Only report rule-pack policy violations",
+          "possible_values": [
+            "true",
+            "false"
+          ]
+        },
+        {
+          "name": "--file",
+          "type": "string",
+          "required": false,
+          "description": "Only report issues in the specified file(s). Accepts multiple values. The full project graph is still built, but only issues in matching files are reported"
+        },
+        {
+          "name": "--finding-id",
+          "type": "string",
+          "required": false,
+          "description": "Only report the findings with these `finding_id` values. Repeat the flag or pass a comma-separated list"
+        },
+        {
+          "name": "path",
+          "type": "string",
+          "required": false,
+          "description": "Scope reported findings to this file or directory (default: whole project). The full project graph is still built; only reported items are narrowed"
+        }
+      ]
+    },
     {
       "name": "watch",
       "description": "Watch for changes and re-run analysis",
@@ -1089,7 +1197,41 @@
           "name": "symbol",
           "type": "string",
           "required": false,
-          "description": "Target symbol, formatted as FILE:SYMBOL (e.g. src/utils.ts:formatDate). Omitted when `--path` is used"
+          "description": "Target symbol, formatted as FILE:SYMBOL (e.g. src/utils.ts:formatDate). Omitted when `--path` or `--dependency` is used"
+        },
+        {
+          "name": "--dependency",
+          "type": "string",
+          "required": false,
+          "description": "How the code uses each imported name of a package: file and call counts, one hop through project wrappers, and a count of each use that the trace cannot resolve"
+        },
+        {
+          "name": "--specifier",
+          "type": "string",
+          "required": false,
+          "description": "With `--dependency`, report only these imported names (repeatable or comma-separated). Turns on the site page"
+        },
+        {
+          "name": "--sites",
+          "type": "bool",
+          "required": false,
+          "description": "With `--dependency`, list the usage sites with file, line and column",
+          "possible_values": [
+            "true",
+            "false"
+          ]
+        },
+        {
+          "name": "--limit",
+          "type": "string",
+          "required": false,
+          "description": "With `--dependency`, the largest number of sites on a page (1 to 500, default 50). Turns on the site page"
+        },
+        {
+          "name": "--cursor",
+          "type": "string",
+          "required": false,
+          "description": "With `--dependency`, the `next_cursor` of the previous page. Turns on the site page"
         },
         {
           "name": "--path",
@@ -1481,6 +1623,26 @@
             "false"
           ]
         },
+        {
+          "name": "--ignore-symlinks",
+          "type": "bool",
+          "required": false,
+          "description": "Omit clone instances whose path is a symlink, or lies under a symlinked directory. A clone group with fewer than two remaining instances is not reported. Without this flag, JSON output marks these instances with `is_symlink: true`",
+          "possible_values": [
+            "true",
+            "false"
+          ]
+        },
+        {
+          "name": "--no-ignore-symlinks",
+          "type": "bool",
+          "required": false,
+          "description": "Report symlinked clone instances (opt out of a config `duplicates.ignoreSymlinks: true`)",
+          "possible_values": [
+            "true",
+            "false"
+          ]
+        },
         {
           "name": "--top",
           "type": "string",
@@ -1730,6 +1892,12 @@
             "false"
           ]
         },
+        {
+          "name": "--trend-from",
+          "type": "string",
+          "required": false,
+          "description": "Compare current metrics against this snapshot file instead of the newest file in `.fallow/snapshots/`. Use it to restore a baseline from external storage in CI. With --group-by, groups are compared by key when the snapshot holds the same grouping. Implies --trend"
+        },
         {
           "name": "--coverage",
           "type": "string",
@@ -2093,6 +2261,11 @@
       "description": "Maintain reusable audit base-snapshot caches",
       "flags": []
     },
+    {
+      "name": "baselines",
+      "description": "Maintain the committed baseline files that the config points at",
+      "flags": []
+    },
     {
       "name": "decision-surface",
       "description": "Surface the consequential structural DECISIONS a change embeds (the apex of the review brief), each framed as a judgment question with the routed expert to ask",
@@ -2194,13 +2367,13 @@
     },
     {
       "name": "report",
-      "description": "Render a saved `--format json` results file in another format without re-running analysis (analyze once, then render every CI surface from the same file). Supports GitHub annotations/summary, CodeClimate, SARIF, and GitHub/GitLab PR-comment and review formats",
+      "description": "Render a saved `--format json` results file in another format without re-running analysis (analyze once, then render every CI surface from the same file). Supports GitHub annotations/summary, CodeClimate, SARIF, markdown, and GitHub/GitLab PR-comment and review formats",
       "flags": [
         {
           "name": "--from",
           "type": "string",
           "required": true,
-          "description": "Path to a fallow JSON results file produced by `--format json` (dead-code, dupes, health, audit, security, or bare combined)"
+          "description": "Path to a fallow JSON results file produced by `--format json` (dead-code, architecture, dupes, health, audit, security, or bare combined)"
         }
       ]
     },
@@ -2410,7 +2583,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-files"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-files"
     },
     {
       "id": "unused-export",
@@ -2447,7 +2620,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-exports"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-exports"
     },
     {
       "id": "unused-type",
@@ -2481,7 +2654,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-types"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-types"
     },
     {
       "id": "private-type-leak",
@@ -2518,7 +2691,7 @@
       "note": "Opt-in API hygiene check; the rule defaults to off",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#private-type-leaks"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#private-type-leaks"
     },
     {
       "id": "deprecated-export-in-use",
@@ -2555,7 +2728,7 @@
       "note": "Opt-in migration sweep; the rule defaults to off",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#deprecated-exports-in-use"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#deprecated-exports-in-use"
     },
     {
       "id": "unused-dependency",
@@ -2592,7 +2765,7 @@
       "note": "--unused-deps controls unused-dependency, unused-dev-dependency, unused-optional-dependency, type-only-dependency, and test-only-dependency",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-dependencies"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-dependencies"
     },
     {
       "id": "unused-dev-dependency",
@@ -2632,7 +2805,7 @@
       "note": "--unused-deps controls unused-dependency, unused-dev-dependency, unused-optional-dependency, type-only-dependency, and test-only-dependency",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-devdependencies"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-devdependencies"
     },
     {
       "id": "unused-optional-dependency",
@@ -2672,7 +2845,7 @@
       "note": "--unused-deps controls unused-dependency, unused-dev-dependency, unused-optional-dependency, type-only-dependency, and test-only-dependency",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-optionaldependencies"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-optionaldependencies"
     },
     {
       "id": "type-only-dependency",
@@ -2709,7 +2882,7 @@
       "note": "Only reported in --production mode; --unused-deps scopes it together with the other dependency kinds",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#type-only-dependencies"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#type-only-dependencies"
     },
     {
       "id": "test-only-dependency",
@@ -2746,7 +2919,7 @@
       "note": "Not reported in --production mode (test files are excluded there); --unused-deps scopes it together with the other dependency kinds",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#test-only-dependencies"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#test-only-dependencies"
     },
     {
       "id": "dev-dependency-in-production",
@@ -2783,7 +2956,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#dev-dependencies-in-production"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#dev-dependencies-in-production"
     },
     {
       "id": "unused-enum-member",
@@ -2820,7 +2993,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-enum-members"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-enum-members"
     },
     {
       "id": "unused-class-member",
@@ -2857,7 +3030,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-class-members"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-class-members"
     },
     {
       "id": "unused-store-member",
@@ -2896,7 +3069,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-store-members"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-store-members"
     },
     {
       "id": "unresolved-import",
@@ -2933,7 +3106,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unresolved-imports"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unresolved-imports"
     },
     {
       "id": "unlisted-dependency",
@@ -2970,7 +3143,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unlisted-dependencies"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unlisted-dependencies"
     },
     {
       "id": "duplicate-export",
@@ -3007,7 +3180,7 @@
       "note": "fallow fix can add an ignoreExports rule to the fallow config instead of editing source",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#duplicate-exports"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#duplicate-exports"
     },
     {
       "id": "circular-dependency",
@@ -3046,7 +3219,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#circular-dependencies"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#circular-dependencies"
     },
     {
       "id": "re-export-cycle",
@@ -3087,7 +3260,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#re-export-cycles"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#re-export-cycles"
     },
     {
       "id": "package-cycle",
@@ -3126,7 +3299,7 @@
       "note": "Requires a workspace with two or more packages",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#package-cycles"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#package-cycles"
     },
     {
       "id": "boundary-violation",
@@ -3163,7 +3336,7 @@
       "note": "Requires configured boundary zones (boundaries config)",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#boundary-violations"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#boundary-violations"
     },
     {
       "id": "boundary-coverage",
@@ -3199,7 +3372,7 @@
       "note": "Requires boundaries.coverage.requireAllFiles",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#boundary-violations"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#boundary-violations"
     },
     {
       "id": "boundary-call-violation",
@@ -3236,14 +3409,14 @@
       "note": "Requires boundaries.calls.forbidden patterns",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#boundary-violations"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#boundary-violations"
     },
     {
       "id": "policy-violation",
       "rule_id": "fallow/policy-violation",
       "command": "dead-code",
       "category": "Policy",
-      "description": "Banned usage matched a rule-pack rule",
+      "description": "Usage violates a configured rule-pack policy",
       "label": "Policy Violations",
       "config_key": "policy-violation",
       "registry_index": 24,
@@ -3272,7 +3445,7 @@
       "note": "Requires a configured rule pack (rulePacks config)",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#policy-violations"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#policy-violations"
     },
     {
       "id": "stale-suppression",
@@ -3282,7 +3455,7 @@
       "description": "Suppression comment or tag no longer matches any issue",
       "label": "Stale Suppressions",
       "config_key": "stale-suppressions",
-      "registry_index": 39,
+      "registry_index": 40,
       "aliases": [],
       "lsp": true,
       "filter_flag": "--stale-suppressions",
@@ -3308,7 +3481,7 @@
       "note": "Fix by removing the stale suppression marker itself",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#stale-suppressions"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#stale-suppressions"
     },
     {
       "id": "missing-suppression-reason",
@@ -3318,7 +3491,7 @@
       "description": "Suppression comment omits a required reason",
       "label": "Missing Suppression Reasons",
       "config_key": "require-suppression-reason",
-      "registry_index": 40,
+      "registry_index": 41,
       "aliases": [
         "missing-suppression-reasons"
       ],
@@ -3340,7 +3513,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#stale-suppressions"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#stale-suppressions"
     },
     {
       "id": "unused-catalog-entry",
@@ -3350,7 +3523,7 @@
       "description": "Catalog entry not referenced by any workspace package",
       "label": "Unused Catalog Entries",
       "config_key": "unused-catalog-entries",
-      "registry_index": 41,
+      "registry_index": 42,
       "aliases": [
         "catalog",
         "unused-catalog-entries"
@@ -3380,7 +3553,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-catalog-entries"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-catalog-entries"
     },
     {
       "id": "empty-catalog-group",
@@ -3390,7 +3563,7 @@
       "description": "Named catalog group has no entries",
       "label": "Empty Catalog Groups",
       "config_key": "empty-catalog-groups",
-      "registry_index": 42,
+      "registry_index": 43,
       "aliases": [
         "empty-catalog",
         "empty-catalog-groups"
@@ -3420,7 +3593,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#empty-catalog-groups"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#empty-catalog-groups"
     },
     {
       "id": "unresolved-catalog-reference",
@@ -3430,7 +3603,7 @@
       "description": "package.json references a catalog that does not declare the package",
       "label": "Unresolved Catalog References",
       "config_key": "unresolved-catalog-references",
-      "registry_index": 43,
+      "registry_index": 44,
       "aliases": [
         "unresolved-catalog",
         "unresolved-catalog-references"
@@ -3460,7 +3633,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unresolved-catalog-references"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unresolved-catalog-references"
     },
     {
       "id": "unused-dependency-override",
@@ -3470,7 +3643,7 @@
       "description": "Package-manager override target is not declared or resolved",
       "label": "Unused Dependency Overrides",
       "config_key": "unused-dependency-overrides",
-      "registry_index": 44,
+      "registry_index": 45,
       "aliases": [
         "unused-dependency-overrides",
         "unused-override",
@@ -3501,7 +3674,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-dependency-overrides"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-dependency-overrides"
     },
     {
       "id": "misconfigured-dependency-override",
@@ -3511,7 +3684,7 @@
       "description": "Package-manager override has an unparsable key or value",
       "label": "Misconfigured Dependency Overrides",
       "config_key": "misconfigured-dependency-overrides",
-      "registry_index": 45,
+      "registry_index": 46,
       "aliases": [
         "misconfigured-dependency-overrides",
         "misconfigured-override",
@@ -3542,7 +3715,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#misconfigured-dependency-overrides"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#misconfigured-dependency-overrides"
     },
     {
       "id": "invalid-client-export",
@@ -3580,7 +3753,7 @@
       "note": "Requires the project to declare next",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#invalid-client-exports"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#invalid-client-exports"
     },
     {
       "id": "mixed-client-server-barrel",
@@ -3616,7 +3789,7 @@
       "note": "Requires the project to declare next",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#mixed-client-server-barrels"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#mixed-client-server-barrels"
     },
     {
       "id": "misplaced-directive",
@@ -3652,7 +3825,7 @@
       "note": "Requires the project to declare next",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#misplaced-directives"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#misplaced-directives"
     },
     {
       "id": "unprovided-inject",
@@ -3670,7 +3843,7 @@
       "filter_flag": "--unprovided-injects",
       "result_key": "unprovided_injects",
       "summary_label": "Unprovided injects",
-      "summary_docs_anchor": "unprovided-inject",
+      "summary_docs_anchor": "unprovided-injects",
       "sarif_rule_ids": [
         "fallow/unprovided-inject"
       ],
@@ -3688,7 +3861,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unprovided-injects"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unprovided-injects"
     },
     {
       "id": "unrendered-component",
@@ -3706,7 +3879,7 @@
       "filter_flag": "--unrendered-components",
       "result_key": "unrendered_components",
       "summary_label": "Unrendered components",
-      "summary_docs_anchor": "unrendered-component",
+      "summary_docs_anchor": "unrendered-components",
       "sarif_rule_ids": [
         "fallow/unrendered-component"
       ],
@@ -3724,7 +3897,43 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unrendered-components"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unrendered-components"
+    },
+    {
+      "id": "absent-component-prop",
+      "rule_id": "fallow/absent-component-prop",
+      "command": "dead-code",
+      "category": "Dead code",
+      "description": "Known reachable callers omit an optional prop consumed inside its component",
+      "label": "Absent Optional Component Props",
+      "config_key": "absent-component-props",
+      "registry_index": 31,
+      "aliases": [
+        "absent-component-props"
+      ],
+      "lsp": true,
+      "filter_flag": "--absent-component-props",
+      "result_key": "absent_component_props",
+      "summary_label": "Absent optional component props",
+      "summary_docs_anchor": "absent-component-props",
+      "sarif_rule_ids": [
+        "fallow/absent-component-prop"
+      ],
+      "codeclimate_check_names": [
+        "fallow/absent-component-prop"
+      ],
+      "ts_alias": null,
+      "counts_in_total": true,
+      "fixable": false,
+      "suppressible": true,
+      "suppress_comment": "// fallow-ignore-next-line absent-component-prop",
+      "default_severity": "off",
+      "opt_in": true,
+      "frameworks": [],
+      "note": "Opt-in manual review candidate; defaults to off. Inspect caller evidence and defaults before changing the component. No automatic fix.",
+      "license": "free",
+      "license_note": null,
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#absent-component-props"
     },
     {
       "id": "unused-component-prop",
@@ -3742,7 +3951,7 @@
       "filter_flag": "--unused-component-props",
       "result_key": "unused_component_props",
       "summary_label": "Unused component props",
-      "summary_docs_anchor": "unused-component-prop",
+      "summary_docs_anchor": "unused-component-props",
       "sarif_rule_ids": [
         "fallow/unused-component-prop"
       ],
@@ -3760,7 +3969,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-component-props"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-component-props"
     },
     {
       "id": "unused-component-emit",
@@ -3770,7 +3979,7 @@
       "description": "A Vue <script setup> defineEmits event is emitted nowhere in its own component",
       "label": "Unused Component Emits",
       "config_key": "unused-component-emits",
-      "registry_index": 31,
+      "registry_index": 32,
       "aliases": [
         "unused-component-emits"
       ],
@@ -3778,7 +3987,7 @@
       "filter_flag": "--unused-component-emits",
       "result_key": "unused_component_emits",
       "summary_label": "Unused component emits",
-      "summary_docs_anchor": "unused-component-emit",
+      "summary_docs_anchor": "unused-component-emits",
       "sarif_rule_ids": [
         "fallow/unused-component-emit"
       ],
@@ -3796,7 +4005,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-component-emits"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-component-emits"
     },
     {
       "id": "unused-component-input",
@@ -3806,7 +4015,7 @@
       "description": "An Angular @Input() / signal input() / model() input is read nowhere in its own component",
       "label": "Unused Component Inputs",
       "config_key": "unused-component-inputs",
-      "registry_index": 32,
+      "registry_index": 33,
       "aliases": [
         "unused-component-inputs"
       ],
@@ -3814,7 +4023,7 @@
       "filter_flag": "--unused-component-inputs",
       "result_key": "unused_component_inputs",
       "summary_label": "Unused component inputs",
-      "summary_docs_anchor": "unused-component-input",
+      "summary_docs_anchor": "unused-component-inputs",
       "sarif_rule_ids": [
         "fallow/unused-component-input"
       ],
@@ -3832,7 +4041,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-component-inputs"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-component-inputs"
     },
     {
       "id": "unused-component-output",
@@ -3842,7 +4051,7 @@
       "description": "An Angular @Output() / signal output() output is emitted nowhere in its own component",
       "label": "Unused Component Outputs",
       "config_key": "unused-component-outputs",
-      "registry_index": 33,
+      "registry_index": 34,
       "aliases": [
         "unused-component-outputs"
       ],
@@ -3850,7 +4059,7 @@
       "filter_flag": "--unused-component-outputs",
       "result_key": "unused_component_outputs",
       "summary_label": "Unused component outputs",
-      "summary_docs_anchor": "unused-component-output",
+      "summary_docs_anchor": "unused-component-outputs",
       "sarif_rule_ids": [
         "fallow/unused-component-output"
       ],
@@ -3868,7 +4077,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-component-outputs"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-component-outputs"
     },
     {
       "id": "unused-svelte-event",
@@ -3878,7 +4087,7 @@
       "description": "A Svelte component dispatches a createEventDispatcher event whose name is listened to nowhere in the project",
       "label": "Unused Svelte Events",
       "config_key": "unused-svelte-events",
-      "registry_index": 34,
+      "registry_index": 35,
       "aliases": [
         "unused-svelte-events"
       ],
@@ -3886,7 +4095,7 @@
       "filter_flag": "--unused-svelte-events",
       "result_key": "unused_svelte_events",
       "summary_label": "Unused Svelte events",
-      "summary_docs_anchor": "unused-svelte-event",
+      "summary_docs_anchor": "unused-svelte-events",
       "sarif_rule_ids": [
         "fallow/unused-svelte-event"
       ],
@@ -3904,7 +4113,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-svelte-events"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-svelte-events"
     },
     {
       "id": "unused-server-action",
@@ -3914,7 +4123,7 @@
       "description": "A Next.js Server Action exported from a \"use server\" file is referenced by no code in the project",
       "label": "Unused Server Actions",
       "config_key": "unused-server-actions",
-      "registry_index": 35,
+      "registry_index": 36,
       "aliases": [
         "unused-server-actions"
       ],
@@ -3922,7 +4131,7 @@
       "filter_flag": "--unused-server-actions",
       "result_key": "unused_server_actions",
       "summary_label": "Unused server actions",
-      "summary_docs_anchor": "unused-server-action",
+      "summary_docs_anchor": "unused-server-actions",
       "sarif_rule_ids": [
         "fallow/unused-server-action"
       ],
@@ -3940,7 +4149,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-server-actions"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-server-actions"
     },
     {
       "id": "unused-load-data-key",
@@ -3950,7 +4159,7 @@
       "description": "A SvelteKit load() return-object key is read by no consumer",
       "label": "Unused Load Data Keys",
       "config_key": "unused-load-data-keys",
-      "registry_index": 36,
+      "registry_index": 37,
       "aliases": [
         "unused-load-data-keys"
       ],
@@ -3958,7 +4167,7 @@
       "filter_flag": "--unused-load-data-keys",
       "result_key": "unused_load_data_keys",
       "summary_label": "Unused load data keys",
-      "summary_docs_anchor": "unused-load-data-key",
+      "summary_docs_anchor": "unused-load-data-keys",
       "sarif_rule_ids": [
         "fallow/unused-load-data-key"
       ],
@@ -3976,7 +4185,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#unused-load-data-keys"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#unused-load-data-keys"
     },
     {
       "id": "prop-drilling",
@@ -3986,7 +4195,7 @@
       "description": "A React/Preact prop is forwarded unchanged through 3+ pass-through components to a distant consumer",
       "label": "Prop Drilling",
       "config_key": "prop-drilling",
-      "registry_index": 51,
+      "registry_index": 52,
       "aliases": [],
       "lsp": true,
       "filter_flag": null,
@@ -4008,7 +4217,7 @@
       "note": "Opt-in: set rules.prop-drilling to warn or error to enable. Defaults to off.",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#prop-drilling"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#prop-drilling"
     },
     {
       "id": "thin-wrapper",
@@ -4018,7 +4227,7 @@
       "description": "A React/Preact component whose whole body is a single spread-forwarded child render (a candidate for inlining)",
       "label": "Thin Wrappers",
       "config_key": "thin-wrapper",
-      "registry_index": 52,
+      "registry_index": 53,
       "aliases": [
         "thin-wrappers"
       ],
@@ -4042,7 +4251,7 @@
       "note": "Opt-in: set rules.thin-wrapper to warn or error to enable. Defaults to off.",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#thin-wrapper"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#thin-wrapper"
     },
     {
       "id": "duplicate-prop-shape",
@@ -4052,7 +4261,7 @@
       "description": "Three or more React/Preact components across two or more files declare an identical prop-name set (a missing shared Props type)",
       "label": "Duplicate Prop Shapes",
       "config_key": "duplicate-prop-shape",
-      "registry_index": 53,
+      "registry_index": 54,
       "aliases": [
         "duplicate-prop-shapes"
       ],
@@ -4076,7 +4285,7 @@
       "note": "Opt-in: set rules.duplicate-prop-shape to warn or error to enable. Defaults to off.",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#duplicate-prop-shape"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#duplicate-prop-shape"
     },
     {
       "id": "route-collision",
@@ -4086,7 +4295,7 @@
       "description": "Two or more Next.js App Router route files resolve to the same URL",
       "label": "Route Collisions",
       "config_key": "route-collision",
-      "registry_index": 37,
+      "registry_index": 38,
       "aliases": [
         "route-collisions"
       ],
@@ -4114,7 +4323,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#route-collisions"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#route-collisions"
     },
     {
       "id": "dynamic-segment-name-conflict",
@@ -4124,7 +4333,7 @@
       "description": "Sibling Next.js dynamic route segments use different slug names at the same position",
       "label": "Dynamic Segment Conflicts",
       "config_key": "dynamic-segment-name-conflict",
-      "registry_index": 38,
+      "registry_index": 39,
       "aliases": [
         "dynamic-segment-name-conflicts"
       ],
@@ -4152,7 +4361,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/dead-code#dynamic-segment-name-conflicts"
+      "docs_url": "https://fallow.tools/docs/explanations/dead-code/#dynamic-segment-name-conflicts"
     },
     {
       "id": "high-cyclomatic-complexity",
@@ -4182,7 +4391,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/health#cyclomatic-complexity"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#cyclomatic-complexity"
     },
     {
       "id": "high-cognitive-complexity",
@@ -4212,7 +4421,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/health#cognitive-complexity"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#cognitive-complexity"
     },
     {
       "id": "high-complexity",
@@ -4242,7 +4451,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/health#complexity-metrics"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#complexity-metrics"
     },
     {
       "id": "high-crap-score",
@@ -4272,7 +4481,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/health#crap-score"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#crap-score"
     },
     {
       "id": "refactoring-target",
@@ -4302,7 +4511,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/health#refactoring-targets"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#refactoring-targets"
     },
     {
       "id": "css-token-drift",
@@ -4312,7 +4521,7 @@
       "description": "CSS or CSS-in-JS hardcoded styling value bypasses the design token system",
       "label": "CSS Token Drift",
       "config_key": "css-token-drift",
-      "registry_index": 54,
+      "registry_index": 55,
       "aliases": [],
       "lsp": false,
       "filter_flag": null,
@@ -4332,7 +4541,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/health#css-token-drift"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#css-token-drift"
     },
     {
       "id": "css-duplicate-block",
@@ -4342,7 +4551,7 @@
       "description": "CSS or CSS-in-JS declaration block is duplicated across rules",
       "label": "CSS Duplicate Block",
       "config_key": "css-duplicate-block",
-      "registry_index": 55,
+      "registry_index": 56,
       "aliases": [],
       "lsp": false,
       "filter_flag": null,
@@ -4362,7 +4571,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/health#css-duplicate-block"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#css-duplicate-block"
     },
     {
       "id": "css-selector-complexity",
@@ -4372,7 +4581,7 @@
       "description": "CSS selector, nesting, or important usage is structurally complex",
       "label": "CSS Selector Complexity",
       "config_key": "css-selector-complexity",
-      "registry_index": 56,
+      "registry_index": 57,
       "aliases": [],
       "lsp": false,
       "filter_flag": null,
@@ -4392,7 +4601,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/health#css-selector-complexity"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#css-selector-complexity"
     },
     {
       "id": "css-dead-surface",
@@ -4402,7 +4611,7 @@
       "description": "CSS or CSS-in-JS surface appears unused",
       "label": "CSS Dead Surface",
       "config_key": "css-dead-surface",
-      "registry_index": 57,
+      "registry_index": 58,
       "aliases": [],
       "lsp": false,
       "filter_flag": null,
@@ -4422,7 +4631,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/health#css-dead-surface"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#css-dead-surface"
     },
     {
       "id": "css-broken-reference",
@@ -4432,7 +4641,7 @@
       "description": "CSS or CSS-in-JS reference resolves to no stylesheet definition",
       "label": "CSS Broken Reference",
       "config_key": "css-broken-reference",
-      "registry_index": 58,
+      "registry_index": 59,
       "aliases": [],
       "lsp": false,
       "filter_flag": null,
@@ -4452,7 +4661,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/health#css-broken-reference"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#css-broken-reference"
     },
     {
       "id": "untested-file",
@@ -4482,7 +4691,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/health#coverage-gaps"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#coverage-gaps"
     },
     {
       "id": "untested-export",
@@ -4512,7 +4721,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/health#coverage-gaps"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#coverage-gaps"
     },
     {
       "id": "runtime-safe-to-delete",
@@ -4542,7 +4751,7 @@
       "note": "Requires --runtime-coverage input (V8 directory, V8 JSON, or Istanbul map)",
       "license": "freemium",
       "license_note": "A single local runtime-coverage capture is free; continuous or multi-capture runtime monitoring requires an active license (fallow license activate).",
-      "docs_url": "https://docs.fallow.tools/explanations/health#runtime-coverage"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#runtime-coverage"
     },
     {
       "id": "runtime-review-required",
@@ -4572,7 +4781,7 @@
       "note": "Requires --runtime-coverage input (V8 directory, V8 JSON, or Istanbul map)",
       "license": "freemium",
       "license_note": "A single local runtime-coverage capture is free; continuous or multi-capture runtime monitoring requires an active license (fallow license activate).",
-      "docs_url": "https://docs.fallow.tools/explanations/health#runtime-coverage"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#runtime-coverage"
     },
     {
       "id": "runtime-low-traffic",
@@ -4602,7 +4811,7 @@
       "note": "Requires --runtime-coverage input (V8 directory, V8 JSON, or Istanbul map)",
       "license": "freemium",
       "license_note": "A single local runtime-coverage capture is free; continuous or multi-capture runtime monitoring requires an active license (fallow license activate).",
-      "docs_url": "https://docs.fallow.tools/explanations/health#runtime-coverage"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#runtime-coverage"
     },
     {
       "id": "runtime-coverage-unavailable",
@@ -4632,7 +4841,7 @@
       "note": "Requires --runtime-coverage input (V8 directory, V8 JSON, or Istanbul map)",
       "license": "freemium",
       "license_note": "A single local runtime-coverage capture is free; continuous or multi-capture runtime monitoring requires an active license (fallow license activate).",
-      "docs_url": "https://docs.fallow.tools/explanations/health#runtime-coverage"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#runtime-coverage"
     },
     {
       "id": "runtime-coverage",
@@ -4662,7 +4871,7 @@
       "note": "Requires --runtime-coverage input (V8 directory, V8 JSON, or Istanbul map)",
       "license": "freemium",
       "license_note": "A single local runtime-coverage capture is free; continuous or multi-capture runtime monitoring requires an active license (fallow license activate).",
-      "docs_url": "https://docs.fallow.tools/explanations/health#runtime-coverage"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#runtime-coverage"
     },
     {
       "id": "coverage-intelligence-risky-change",
@@ -4692,7 +4901,7 @@
       "note": "Produced by fallow coverage analyze",
       "license": "freemium",
       "license_note": "A single local runtime-coverage capture is free; continuous or multi-capture runtime monitoring requires an active license (fallow license activate).",
-      "docs_url": "https://docs.fallow.tools/explanations/health#coverage-intelligence"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#coverage-intelligence"
     },
     {
       "id": "coverage-intelligence-delete",
@@ -4722,7 +4931,7 @@
       "note": "Produced by fallow coverage analyze",
       "license": "freemium",
       "license_note": "A single local runtime-coverage capture is free; continuous or multi-capture runtime monitoring requires an active license (fallow license activate).",
-      "docs_url": "https://docs.fallow.tools/explanations/health#coverage-intelligence"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#coverage-intelligence"
     },
     {
       "id": "coverage-intelligence-review",
@@ -4752,7 +4961,7 @@
       "note": "Produced by fallow coverage analyze",
       "license": "freemium",
       "license_note": "A single local runtime-coverage capture is free; continuous or multi-capture runtime monitoring requires an active license (fallow license activate).",
-      "docs_url": "https://docs.fallow.tools/explanations/health#coverage-intelligence"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#coverage-intelligence"
     },
     {
       "id": "coverage-intelligence-refactor",
@@ -4782,7 +4991,7 @@
       "note": "Produced by fallow coverage analyze",
       "license": "freemium",
       "license_note": "A single local runtime-coverage capture is free; continuous or multi-capture runtime monitoring requires an active license (fallow license activate).",
-      "docs_url": "https://docs.fallow.tools/explanations/health#coverage-intelligence"
+      "docs_url": "https://fallow.tools/docs/explanations/health/#coverage-intelligence"
     },
     {
       "id": "code-duplication",
@@ -4812,7 +5021,7 @@
       "note": "Reported by fallow dupes (and bare fallow / fallow audit)",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/explanations/duplication#clone-groups"
+      "docs_url": "https://fallow.tools/docs/explanations/duplication/#clone-groups"
     },
     {
       "id": "feature-flag",
@@ -4822,7 +5031,7 @@
       "description": "Detected feature flag pattern",
       "label": "Feature Flags",
       "config_key": "feature-flags",
-      "registry_index": 49,
+      "registry_index": 50,
       "aliases": [],
       "lsp": false,
       "filter_flag": null,
@@ -4842,7 +5051,7 @@
       "note": "Reported by fallow flags",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/flags"
+      "docs_url": "https://fallow.tools/docs/cli/flags/"
     },
     {
       "id": "flag-retirement-candidate",
@@ -4872,7 +5081,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/flags#retirement-report"
+      "docs_url": "https://fallow.tools/docs/cli/flags/#retirement-report"
     },
     {
       "id": "tainted-sink",
@@ -4902,7 +5111,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "client-server-leak",
@@ -4932,7 +5141,7 @@
       "note": null,
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "hardcoded-secret",
@@ -4962,7 +5171,7 @@
       "note": "Include-required category: enable via security.categories.include",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "dangerous-html",
@@ -4992,7 +5201,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "template-escape-bypass",
@@ -5022,7 +5231,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "command-injection",
@@ -5052,7 +5261,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "code-injection",
@@ -5082,7 +5291,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "dynamic-regex",
@@ -5112,7 +5321,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "redos-regex",
@@ -5142,7 +5351,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "resource-amplification",
@@ -5172,7 +5381,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "dynamic-module-load",
@@ -5202,7 +5411,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "sql-injection",
@@ -5232,7 +5441,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "ssrf",
@@ -5262,7 +5471,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "secret-to-network",
@@ -5292,7 +5501,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "path-traversal",
@@ -5322,7 +5531,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "header-injection",
@@ -5352,7 +5561,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "open-redirect",
@@ -5382,7 +5591,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "postmessage-wildcard-origin",
@@ -5412,7 +5621,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "tls-validation-disabled",
@@ -5442,7 +5651,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "cleartext-transport",
@@ -5472,7 +5681,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "electron-unsafe-webpreferences",
@@ -5502,7 +5711,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "world-writable-permission",
@@ -5532,7 +5741,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "insecure-temp-file",
@@ -5562,7 +5771,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "mysql-multiple-statements",
@@ -5592,7 +5801,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "permissive-cors",
@@ -5622,7 +5831,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "insecure-cookie",
@@ -5652,7 +5861,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "mass-assignment",
@@ -5682,7 +5891,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "weak-crypto",
@@ -5712,7 +5921,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "insecure-randomness",
@@ -5742,7 +5951,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "jwt-alg-none",
@@ -5772,7 +5981,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "jwt-verify-missing-algorithms",
@@ -5802,7 +6011,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "deprecated-cipher",
@@ -5832,7 +6041,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "unsafe-buffer-alloc",
@@ -5862,7 +6071,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "unsafe-deserialization",
@@ -5892,7 +6101,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "angular-trusted-html",
@@ -5922,7 +6131,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "nextjs-open-redirect",
@@ -5952,7 +6161,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "dom-document-write",
@@ -5982,7 +6191,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "jquery-html",
@@ -6012,7 +6221,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "route-send-file",
@@ -6042,7 +6251,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "webview-injection",
@@ -6072,7 +6281,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "prototype-pollution",
@@ -6102,7 +6311,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "zip-slip",
@@ -6132,7 +6341,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "nosql-injection",
@@ -6162,7 +6371,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "ssti",
@@ -6192,7 +6401,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "xxe",
@@ -6222,7 +6431,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "secret-pii-log",
@@ -6252,7 +6461,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "xpath-injection",
@@ -6282,7 +6491,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     },
     {
       "id": "llm-call-injection",
@@ -6312,7 +6521,7 @@
       "note": "Tainted-sink catalogue category; the security-sink suppression token covers every category",
       "license": "free",
       "license_note": null,
-      "docs_url": "https://docs.fallow.tools/cli/security"
+      "docs_url": "https://fallow.tools/docs/cli/security/"
     }
   ],
   "suppression_comments": {
@@ -6394,6 +6603,7 @@
     "FALLOW_API_KEY": "Fallow Cloud bearer token for coverage upload commands, and the fallback bearer for fallow license refresh when the stored license JWT is missing or too stale.",
     "FALLOW_CA_BUNDLE": "Path to a PEM certificate bundle for Fallow Cloud and provider HTTP calls (replaces the default WebPKI roots).",
     "FALLOW_UPDATE_CHECK": "Set to off/0/false to disable the human-TTY upgrade nudge and its background version check.",
+    "FALLOW_CLAUDE_CODE_HINT": "Set to off/0/false/no/disabled to suppress the one-line Claude Code plugin hint on stderr. Fallow writes the hint only inside a Claude Code session (CLAUDECODE or CLAUDE_CODE_CHILD_SESSION), for human output without --quiet, outside CI, and when no Fallow plugin or skill is set up for the project. Default on.",
     "FALLOW_SUGGESTIONS": "Set to off/0/false/no/disabled to suppress the next_steps[] array of read-only follow-up commands in JSON output (and the human Next: line). Useful for CI consumers that snapshot-diff raw --format json output. Default on.",
     "FALLOW_TELEMETRY": "Opt-in telemetry mode: off, on, or inspect (print the payload to stderr without sending). Telemetry is off by default.",
     "FALLOW_TELEMETRY_DISABLED": "Admin/fleet kill switch: truthy values hard-disable telemetry and refuse fallow telemetry enable.",
@@ -6932,6 +7142,24 @@
         "read_only": false,
         "code_mode_alias": "checkChanged"
       },
+      {
+        "name": "check_architecture",
+        "kind": "analysis",
+        "description": "Architecture check: import cycles, boundary violations, and rule-pack policy violations in the `architecture` envelope, each with a stable finding_id",
+        "cli_command": "fallow architecture --format json --quiet",
+        "key_params": [
+          "cycles",
+          "boundaries",
+          "policy",
+          "baseline",
+          "group_by",
+          "file"
+        ],
+        "license": "free",
+        "license_note": null,
+        "read_only": true,
+        "code_mode_alias": "checkArchitecture"
+      },
       {
         "name": "security_candidates",
         "kind": "analysis",
@@ -7453,10 +7681,14 @@
       {
         "name": "trace_dependency",
         "kind": "trace",
-        "description": "Trace where a dependency is imported and whether scripts or CI use it",
+        "description": "Trace where a dependency is imported, whether scripts or CI use it, and how the code uses each imported name",
         "cli_command": "fallow dead-code --trace-dependency <package> --format json --quiet",
         "key_params": [
-          "package_name"
+          "package_name",
+          "specifiers",
+          "sites",
+          "limit",
+          "cursor"
         ],
         "license": "free",
         "license_note": null,
@@ -7569,7 +7801,7 @@
     ]
   },
   "plugins": {
-    "count": 128,
+    "count": 134,
     "note": "Built-in framework plugins, auto-activated when their enabler dependency is present; run fallow list --plugins for the set active in a specific project",
     "names": [
       "nextjs",
@@ -7589,6 +7821,8 @@
       "expo-router",
       "firebase",
       "nestjs",
+      "nestjs-trpc",
+      "nest-commander",
       "adonis",
       "docusaurus",
       "gatsby",
@@ -7596,6 +7830,7 @@
       "nitro",
       "capacitor",
       "ionic",
+      "kibana",
       "sanity",
       "supabase",
       "vitepress",
@@ -7608,6 +7843,7 @@
       "convex",
       "lit",
       "lexical",
+      "ag-ui",
       "obsidian",
       "content-collections",
       "contentlayer",
@@ -7615,6 +7851,7 @@
       "mintlify",
       "velite",
       "ember",
+      "eve",
       "vite",
       "vscode",
       "webpack",
@@ -7670,6 +7907,7 @@
       "commitizen",
       "commit-and-tag-version",
       "semantic-release",
+      "release-it",
       "danger",
       "hardhat",
       "vercel",
@@ -7723,6 +7961,11 @@
       "command": "fallow dead-code --trace-dependency <name>",
       "note": null
     },
+    {
+      "task": "migrate a dependency",
+      "command": "fallow trace --dependency <name> --sites",
+      "note": "Counts each imported name, follows one hop through project wrappers, and counts each use that it cannot resolve."
+    },
     {
       "task": "commit or open a PR",
       "command": "fallow audit --base <ref>",
@@ -7763,6 +8006,11 @@
       "command": "fallow guard <files>",
       "note": null
     },
+    {
+      "task": "check import cycles, boundaries and policy rules after changing code",
+      "command": "fallow architecture",
+      "note": null
+    },
     {
       "task": "surface security candidates",
       "command": "fallow security",