{"$schema":"https://verifymcp.io/schemas/trust-report.json","schemaVersion":1,"license":{"name":"CC BY-NC 4.0","url":"https://creativecommons.org/licenses/by-nc/4.0/"},"generatedAt":"2026-11-21T23:42:23.444Z","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow","markdownUrl":"https://verifymcp.io/servers/fallow-rs-fallow/fallow.md","server":{"slug":"fallow-rs-fallow","name":"Fallow","registryName":"io.github.fallow-rs/fallow","description":"Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.","registryStatus":"active","deletedAt":null,"statusMessage":null,"liveness":"live","publisher":{"class":"unknown","claimed":false}},"component":{"slug":"fallow","type":"npm","identifier":"fallow","withdrawn":false,"url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow","version":"3.46.0","transport":"stdio","scoredAt":"2026-11-21T08:42:05.339Z"},"score":{"total":83,"tier":"high trust","status":"scored","weekDelta":18,"history":[{"date":"2026-11-21","total":83},{"date":"2026-11-20","total":83},{"date":"2026-11-19","total":82},{"date":"2026-11-18","total":82},{"date":"2026-11-17","total":81},{"date":"2026-11-16","total":81},{"date":"2026-11-15","total":80},{"date":"2026-11-14","total":65},{"date":"2026-11-13","total":64}]},"categories":[{"name":"Supply Chain Security","score":100,"verdict":"pass","reasons":["No malware found by supply-chain analysis.","No known CVEs affecting this package version or its production dependencies.","No install/post-install scripts declared.","0 of 9 dependencies flagged as unhealthy."],"codes":[{"code":"supplychain.malware_clean","args":{}},{"code":"cve.none","args":{}},{"code":"installscript.none","args":{}},{"code":"dephealth.assessed","args":{"deps":"9","unhealthy":"0"}}]},{"name":"Provenance & Transparency","score":100,"verdict":"pass","reasons":["Source repository is publicly reachable at the declared URL.","Cryptographically verified build provenance (signed, bound to fallow-rs/fallow).","Clear OSI-approved license (MIT).","Actively maintained (last published 1 days ago).","Publishes a security disclosure policy (SECURITY.md)."],"codes":[{"code":"provenance.repo_verified","args":{}},{"code":"provenance.verified","args":{"repo":"fallow-rs/fallow"}},{"code":"license.osi","args":{"spdx":"MIT"}},{"code":"maintenance.recent","args":{"age_days":"1"}},{"code":"disclosure.present","args":{}}]},{"name":"Schema Quality & AI Usability","score":71,"verdict":"fail","reasons":["100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).","AI-judged instruction clarity (excellent).","Context-footprint check failed: tool/resource definitions use about 31281 tokens (~601/item across 52 items; 44 tools + 8 resources), over budget; trim descriptions and params.","Usage-examples check failed: none of the tools include examples."],"codes":[{"code":"schema.descriptions","args":{"pct":"100"}},{"code":"schema.ai_quality","args":{"band":"excellent"}},{"code":"schema.footprint_heavy","args":{"avg":"601","items":"52","tools":"44","tokens":"31281","resources":"8"}},{"code":"schema.examples_absent","args":{}}]},{"name":"Stability & Change Management","score":27,"verdict":"partial","reasons":["Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses."],"codes":[{"code":"stability.building_history","args":{"days":"8"}}]},{"name":"Tool Coverage","score":100,"verdict":"pass","reasons":["100% of tools have a non-trivial description (not blank, and not just the tool's name).","100% of tool parameters carry a description."],"codes":[{"code":"toolquality.descriptions","args":{"pct":"100"}},{"code":"toolquality.param_docs","args":{"pct":"100"}}]},{"name":"Tool Safety","score":75,"verdict":"fail","reasons":["No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.","0 of 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; \"check_runtime_coverage\" implies \"merge\" and declares readOnlyHint instead, contradicting what its own name says it does.","An AI judge read all 46 captured unit(s) of tool text and found none that tries to manipulate the model reading it."],"codes":[{"code":"toolsafety.injection_clean","args":{}},{"code":"toolsafety.destructive_undeclared","args":{"pct":"0","tool":"check_runtime_coverage","verb":"merge","declared":"read_only","annotated":"0","destructive":"2"}},{"code":"toolsafety.manipulation_clean","args":{"units":"46","judged":"46"}}]},{"name":"Capabilities","score":100,"verdict":"pass","reasons":["Implements a current MCP spec version (2026-07-28)."],"codes":[{"code":"protocol.current","args":{"version":"2026-07-28"}}]}],"inconclusive":[],"malware":[],"components":[{"slug":"fallow","type":"npm","identifier":"fallow","withdrawn":false,"score":83,"current":true,"url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow","markdownUrl":"https://verifymcp.io/servers/fallow-rs-fallow/fallow.md"}],"facts":[{"label":"Registry","value":"npm"},{"label":"Package","value":"fallow"},{"label":"Version","value":"3.46.0"},{"label":"Transport","value":"stdio"}],"install":{"available":true,"bundleSha256":null},"tools":[{"name":"analyze","title":null,"description":"Analyze a TypeScript/JavaScript project for unused code and dependency cycles. On a Rust root, it runs `cargo fallow check` (deps, visibility; no score) and takes only root. Detects unused files, exports, types, dependencies, enum/class members, unresolved imports, unlisted dependencies, duplicate exports, circular dependencies, re-export cycles (barrel files that form a structural loop, silently breaking re-exports), package cycles (workspace packages that import each other in a loop), boundary violations, rule-pack policy violations (banned calls, imports, and catalogue-derived effects declared via the rulePacks config key), stale suppression comments, missing suppression reasons when rules.require-suppression-reason is enabled, unused pnpm catalog entries (entries in pnpm-workspace.yaml `catalog:` / `catalogs:` not referenced by any workspace package), empty pnpm catalog groups, unresolved catalog references (workspace package.json declares `catalog:` but the catalog has no entry), unused dependency overrides (entries in `pnpm-workspace.yaml#overrides`, `package.json#pnpm.overrides`, top-level `package.json#overrides`, or Bun `package.json#resolutions` whose target package no workspace package declares and the active readable lockfile does not resolve), and misconfigured dependency overrides (unparsable key or empty value; the active package manager may reject or ignore the entry). Opt-in issue_types: [\"private-type-leaks\"] (API hygiene), [\"deprecated-exports-in-use\"] (@deprecated in use), [\"absent-component-props\"] (optional-prop review), [\"constant-parameters\"] (parameter review). Returns structured JSON with all issues found, grouped by issue type. Each finding has a stable `finding_id`; an id absent from a scoped or differently configured run means unknown, not resolved. For code duplication use find_dupes, for complexity hotspots use check_health. Supports baselines, regression detection, performance tuning, boundary_violations, and group_by. Read the `fall…","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"baseline","type":"string|null","required":false,"description":"Compare results against a saved baseline file. Only new issues (not in\nthe baseline) are reported. The response carries `baseline_staleness`:\nread `gate_trips` to see whether the baseline has entries…"},{"name":"boundary_violations","type":"boolean|null","required":false,"description":"Analyze only architecture boundary violations."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"fail_on_regression","type":"boolean|null","required":false,"description":"Fail if the issue count increased beyond `tolerance` compared to a\nregression baseline."},{"name":"file","type":"array|null","required":false,"description":"Scope analysis to these project-relative files instead of the whole project."},{"name":"finding_ids","type":"array|null","required":false,"description":"Report only these `finding_id` values. The response adds\n`finding_id_query`; a missing id is resolved only when `conclusive` is true."},{"name":"group_by","type":"string|null","required":false,"description":"Group findings by CODEOWNERS ownership, directory, workspace package, or\nGitLab CODEOWNERS section. Values: \"owner\", \"directory\", \"package\", \"section\"."},{"name":"include_entry_exports","type":"boolean|null","required":false,"description":"Report unused exports in entry files instead of auto-marking them as used."},{"name":"issue_types","type":"array|null","required":false,"description":"Issue types to include, for example `[\"unused-exports\", \"unused-files\"]`;\nempty or omitted means all registered issue types."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"no_package_baselines","type":"boolean|null","required":false,"description":"Ignore the per-package refs of `workspaces.changedSince` for this call,\nso every workspace package is analyzed in full scope. Use it to judge\nor save a whole-project baseline."},{"name":"production","type":"boolean|null","required":false,"description":"Production mode: exclude test, story, and dev files, only start/build\nscripts, and report type-only dependencies."},{"name":"regression_baseline","type":"string|null","required":false,"description":"Path to the regression baseline file."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"save_baseline","type":"string|null","required":false,"description":"Save current results as a baseline file for future comparisons. The path\nmust resolve inside the project root, its Git work tree, the CI workspace or a temp directory.\nA relative path resolves agains…"},{"name":"save_regression_baseline","type":"string|null","required":false,"description":"Save the current issue counts as a regression baseline file at this\npath. An empty or absent value writes nothing: this tool cannot write the\ncounts into the fallow config. The path must resolve insi…"},{"name":"show_cascade","type":"boolean|null","required":false,"description":"Keep the unused exports, types, class members and enum members of\nunused files. By default the report hides them and counts them in\n`cascade_hidden`. Passed through to the CLI's `--show-cascade` flag."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"tolerance","type":"string|null","required":false,"description":"Allowed issue count increase before a regression is flagged. Defaults to \"0\"."},{"name":"type_aware","type":"boolean|null","required":false,"description":"Refine project-wide public API findings with TypeScript symbol identity.\n`false` keeps the run syntactic, also when the config turns type-aware analysis on. `type_aware_projects` or `type_aware_requi…"},{"name":"type_aware_projects","type":"array|null","required":false,"description":"Explicit tsconfig paths for type-aware analysis."},{"name":"type_aware_require","type":null,"required":false,"description":"Whether incomplete semantic evidence is advisory or gating."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":1379},{"name":"audit","title":null,"description":"Audit changed files for dead code, complexity, duplication, styling, and diff risk. Purpose-built for reviewing AI-generated code. Combines the analyses scoped to changed files and returns a verdict (pass/warn/fail). Auto-detects the base branch if not specified. By default, audit runs the base ref too and gates only findings introduced by the changeset; inherited findings are annotated with introduced=false and counted under attribution. Set gate=\"all\" or audit.gate=\"all\" in config to gate every finding. Returns JSON with verdict, summary counts per category, attribution counts, and full issue details with actions array for remediation guidance. Per-analysis payloads nest under `dead_code`, `duplication`, and `complexity`; the `complexity` block carries the health sub-analysis output (audit JSON has no `health` key). The `diff_risk` section reports facts about the change itself, such as weakened tests, added suppressions, and a clone copy edited without its siblings. Styling analytics are on by default. Read the fallow://tools/audit guide for the diff-risk rules, styling, coverage, synthetic complexity units, grouping, baselines, runtime coverage, and `FALLOW_DIFF_FILE` scoping. Use this after generating code to verify quality before committing.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"base","type":"string|null","required":false,"description":"Git ref to compare against (e.g., \"main\", \"HEAD~5\"). When unset, the\nbase is the git merge-base against the branch's upstream or the remote\ndefault (`origin/main`); set `FALLOW_AUDIT_BASE` in the ser…"},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"coverage","type":"string|null","required":false,"description":"Path to Istanbul coverage data (coverage-final.json) or raw V8 coverage\n(a `NODE_V8_COVERAGE` directory or one V8 JSON file) for accurate\nper-function CRAP scores in audit's health sub-analysis.\nWhen…"},{"name":"coverage_root","type":"string|null","required":false,"description":"Absolute prefix to strip from coverage data paths before CRAP matching.\nUse when coverage was generated in a different checkout root in CI or Docker.\nWhen omitted, `FALLOW_COVERAGE_ROOT` and then the…"},{"name":"css","type":"boolean|null","required":false,"description":"Set `false` to skip styling analytics in audit. Unset or `true` uses\n`audit.css` from the config, which defaults to enabled."},{"name":"css_deep","type":"boolean|null","required":false,"description":"Enable or disable deep CSS analysis for audit: project-wide styling\nreachability and near-duplicate theme-token candidates, narrowed back to\nchanged anchors. Unset uses `audit.cssDeep` from the confi…"},{"name":"dead_code_baseline","type":"string|null","required":false,"description":"Path to a dead-code baseline file (produced by `fallow dead-code\n--save-baseline`). When set, dead-code issues present in the\nbaseline are excluded from the audit verdict. Passed through to\nthe CLI's…"},{"name":"dupes_baseline","type":"string|null","required":false,"description":"Path to a duplication baseline file (produced by `fallow dupes\n--save-baseline`). When set, clone groups present in the baseline\nare excluded from the audit verdict. Passed through to the CLI's\n`--du…"},{"name":"explain_skipped","type":"boolean|null","required":false,"description":"Show per-pattern counts for skipped files: the default duplicates\nignores, and the built-in discovery ignores that removed source files\nfrom the walk.\nHuman-format only (human/markdown CLI output); M…"},{"name":"gate","type":"string|null","required":false,"description":"Which findings affect the audit verdict. Values: \"new-only\" or \"all\".\nUnset uses `audit.gate` from the config, which defaults to \"new-only\".\nPassed through to the CLI's `--gate` flag."},{"name":"group_by","type":"string|null","required":false,"description":"Group audit findings by CODEOWNERS ownership, directory, workspace\npackage, or GitLab CODEOWNERS section. Values: \"owner\", \"directory\",\n\"package\", \"section\". `section` attaches an `owners: string[]`…"},{"name":"health_baseline","type":"string|null","required":false,"description":"Path to a health baseline file (produced by `fallow health\n--save-baseline`). When set, complexity findings present in the\nbaseline are excluded from the audit verdict. Passed through to\nthe CLI's `-…"},{"name":"health_baseline_mode","type":null,"required":false,"description":"How `health_baseline` matches complexity findings: \"count\" (per file\nand category, the CLI default) or \"identity\" (per function identity,\nstrict; requires a baseline saved with `--baseline-mode ident…"},{"name":"include_entry_exports","type":"boolean|null","required":false,"description":"Report unused exports in entry files instead of auto-marking them as\nused. Catches typos in framework exports (e.g. `meatdata` instead of\n`metadata`). Also configurable persistently via\n`includeEntry…"},{"name":"max_crap","type":"number|null","required":false,"description":"Maximum CRAP score threshold (default 30.0). Functions meeting or\nexceeding this score cause audit to fail. Pair with `coverage` on\n`check_health` for accurate per-function CRAP; without Istanbul dat…"},{"name":"min_invocations_hot","type":"integer|null","required":false,"description":"Threshold for hot-path classification (default 100). Forwarded to\nthe sidecar when `runtime_coverage` is set. Passed through to the\nCLI's `--min-invocations-hot` flag."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"only","type":"array|null","required":false,"description":"Run only these audit sub-analyses, with the values of bare `fallow\n--only`: `dead-code`, `architecture`, `dupes`, `health`. Replaces the\n`audit.deadCode`, `audit.health` and `audit.dupes` config sele…"},{"name":"production","type":"boolean|null","required":false,"description":"Only analyze production code (excludes tests, stories, dev files)."},{"name":"production_dead_code","type":"boolean|null","required":false,"description":"Run only the dead-code sub-analysis in production mode."},{"name":"production_dupes","type":"boolean|null","required":false,"description":"Run only the duplication sub-analysis in production mode."},{"name":"production_health","type":"boolean|null","required":false,"description":"Run only the health sub-analysis in production mode."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"runtime_coverage","type":"string|null","required":false,"description":"Runtime coverage input (V8 directory, V8 JSON, or Istanbul coverage\nmap JSON). When set, audit adds runtime-coverage findings to the same\ncall: agents get the `hot-path-touched` verdict next to dead-…"},{"name":"show_cascade","type":"boolean|null","required":false,"description":"Keep the unused exports, types, class members and enum members of\nunused files. By default the report hides them and counts them in\n`cascade_hidden`. Passed through to the CLI's `--show-cascade` flag."},{"name":"skip","type":"array|null","required":false,"description":"Skip these audit sub-analyses, with the values of `only`. A skipped\nsub-analysis leaves the verdict; the response omits its block and sets\n`summary.dead_code_skipped`, `complexity_skipped` or\n`duplic…"},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"type_aware","type":"boolean|null","required":false,"description":"Refine both audit sides with TypeScript symbol identity before attribution.\n`false` keeps the run syntactic, also when the config turns type-aware analysis on. `type_aware_projects` or `type_aware_re…"},{"name":"type_aware_projects","type":"array|null","required":false,"description":"Explicit tsconfig paths for type-aware analysis."},{"name":"type_aware_require","type":null,"required":false,"description":"Whether incomplete semantic evidence is advisory or gating."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."},{"name":"worsened","type":"string|null","required":false,"description":"Verdict effect of an inherited complexity finding whose measured value\ngrew: \"warn\" (default), \"error\" (counts as introduced) or \"off\". Unset uses\n`audit.worsened`."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":2024},{"name":"check_architecture","title":null,"description":"Check import cycles, boundary violations (with coverage and forbidden calls), and rule-pack policy violations. Returns the `kind: \"architecture\"` envelope: the finding arrays, `finding_id` values and actions of `analyze` for these issue types, with its own `schema_version`. Set `cycles`, `boundaries`, or `policy` to report one kind. Call `guard` before an edit and this tool after it. `baseline` takes a dead-code baseline. On a Rust root, it runs `cargo fallow boundaries`: `kind: \"boundaries\"`.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"baseline","type":"string|null","required":false,"description":"Saved dead-code baseline file; only new findings are reported."},{"name":"boundaries","type":"boolean|null","required":false,"description":"Only boundary violations, coverage and forbidden calls."},{"name":"changed_since","type":"string|null","required":false,"description":"Report only findings in files changed since this git ref."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"cycles","type":"boolean|null","required":false,"description":"Only import cycles."},{"name":"file","type":"array|null","required":false,"description":"Project-relative files to scope the report to."},{"name":"group_by","type":"string|null","required":false,"description":"\"owner\", \"directory\", \"package\", or \"section\"."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"policy","type":"boolean|null","required":false,"description":"Only rule-pack policy violations."},{"name":"production","type":"boolean|null","required":false,"description":"Production mode: exclude test, story, and dev files, only start/build\nscripts, and report type-only dependencies."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":396},{"name":"check_changed","title":null,"description":"Analyze only files changed since a git ref. Useful for incremental CI checks on pull requests. Returns the same structured JSON as analyze, but filtered to only include issues in changed files. Each finding keeps its `finding_id` from analyze; an id absent here means unknown, not resolved. Supports baseline comparisons (baseline/save_baseline), regression detection (fail_on_regression, tolerance, regression_baseline, save_regression_baseline), and performance tuning (no_cache, threads).","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"baseline","type":"string|null","required":false,"description":"Compare results against a saved baseline file. Only new issues (not in\nthe baseline) are reported. The response carries `baseline_staleness`:\nread `gate_trips` to see whether the baseline has entries…"},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"fail_on_regression","type":"boolean|null","required":false,"description":"Fail if the issue count increased beyond `tolerance` compared to a\nregression baseline."},{"name":"include_entry_exports","type":"boolean|null","required":false,"description":"Report unused exports in entry files instead of auto-marking them as used."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"production","type":"boolean|null","required":false,"description":"Production mode: exclude test, story, and dev files, only start/build\nscripts, and report type-only dependencies."},{"name":"regression_baseline","type":"string|null","required":false,"description":"Path to the regression baseline file."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"save_baseline","type":"string|null","required":false,"description":"Save current results as a baseline file for future comparisons. The path\nmust resolve inside the project root, its Git work tree, the CI workspace or a temp directory.\nA relative path resolves agains…"},{"name":"save_regression_baseline","type":"string|null","required":false,"description":"Save the current issue counts as a regression baseline file at this\npath. An empty or absent value writes nothing: this tool cannot write the\ncounts into the fallow config. The path must resolve insi…"},{"name":"show_cascade","type":"boolean|null","required":false,"description":"Keep the unused exports, types, class members and enum members of\nunused files. By default the report hides them and counts them in\n`cascade_hidden`. Passed through to the CLI's `--show-cascade` flag."},{"name":"since","type":"string","required":true,"description":"Git ref to compare against (e.g. \"main\", \"HEAD~5\"). Only files changed\nsince this ref are analyzed. Required."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"tolerance","type":"string|null","required":false,"description":"Allowed issue count increase before a regression is flagged. Defaults to \"0\"."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":767},{"name":"check_health","title":null,"description":"Check code health metrics (cyclomatic and cognitive complexity) for functions in the project. Returns structured JSON with complexity scores per function, sorted by severity. On a Rust root, it runs `cargo fallow complexity` (max_cyclomatic, max_cognitive; no score). Set score=true for a single 0-100 health score with letter grade (A/B/C/D/F); runs duplication analysis automatically, but the churn-backed hotspot penalty requires hotspots=true (or targets=true). Set min_score=N to fail only when the score drops below a threshold (CI quality gate); min_score is authoritative, so complexity findings become informational and min_score=0 never fails. Exit codes are not surfaced over MCP, but the verdict is: a gated run publishes `gate_outcomes`, where `health-min-score` and `health-min-severity` carry a status, whether it was enforced, and the numbers compared. min_severity composes with min_score. Set file_scores=true for per-file health scores (maintainability index, fan-in, fan-out, dead code ratio, complexity density, CRAP risk), sorted in risk-aware triage order so lower MI and higher CRAP risk appear first. Set css=true to add a `css_analytics` section (specificity hotspots, `!important` density, over-complex selectors, deep nesting, design-token sprawl, unreferenced custom properties and `@keyframes`); opt-in because it parses every project stylesheet. Set complexity_breakdown=true to add a per-decision-point `contributions[]` array to each complexity finding, so you can explain WHY a function scored high and which lines to refactor. Set coverage_gaps=true to explicitly include static test coverage gaps: runtime files and exports with no test dependency path (not line-level coverage). A provided config file may also enable coverage gaps via rules.coverage-gaps when no health sections are explicitly selected. Set hotspots=true to identify files that are both complex and frequently changing (combines git churn with complexity). Set churn_file to a `fallow-churn/v1`…","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"baseline","type":"string|null","required":false,"description":"Compare results against a saved baseline file. Only new issues (not in the baseline) are reported.\n`summary.baseline_staleness` reports how much of the baseline still matches: read `gate_trips`\nto se…"},{"name":"baseline_mode","type":null,"required":false,"description":"How `baseline` matches health findings and which buckets `save_baseline`\nwrites: \"count\" (per file and category, the CLI default) or \"identity\"\n(per function identity, strict; requires a baseline sav…"},{"name":"changed_since","type":"string|null","required":false,"description":"Git ref to compare against. Only files changed since this ref are analyzed."},{"name":"churn_file","type":"string|null","required":false,"description":"Import change history from a `fallow-churn/v1` JSON file instead of `git\nlog`, so `hotspots` / `ownership` / `targets` work on projects with no git\nrepository (Yandex Arc, Mercurial, Perforce). A sma…"},{"name":"complexity","type":"boolean|null","required":false,"description":"Show only complexity findings. By default all sections are shown; use this to select only complexity."},{"name":"complexity_breakdown","type":"boolean|null","required":false,"description":"Include the per-decision-point complexity breakdown (`contributions[]`) on\neach complexity finding. Each entry names the construct (if, else-if,\nSvelte await/then, loop, boolean operator, React hook…"},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"coverage","type":"string|null","required":false,"description":"Path to coverage data for accurate per-function CRAP scores: an Istanbul\nmap (coverage-final.json), a directory containing one, a raw V8 coverage\ndirectory (`NODE_V8_COVERAGE`), or a single V8 covera…"},{"name":"coverage_gaps","type":"boolean|null","required":false,"description":"Explicitly request static test coverage gaps: runtime files and exports with\nno test dependency path. A provided config file may also enable coverage\ngaps via `rules.coverage-gaps` when no health sec…"},{"name":"coverage_root","type":"string|null","required":false,"description":"Absolute prefix to strip from coverage data paths before prepending the project root.\nUse when coverage was generated in a different environment (CI runner, Docker).\nWhen omitted, `FALLOW_COVERAGE_RO…"},{"name":"css","type":"boolean|null","required":false,"description":"Add a structural CSS analytics section (`css_analytics`): specificity\nhotspots, `!important` density, over-complex selectors, deep nesting,\ndesign-token sprawl (distinct colors / font-sizes / z-index…"},{"name":"effort","type":"string|null","required":false,"description":"Analysis effort level. Controls the depth of analysis: \"low\" (fast, surface-level),\n\"medium\" (balanced, default), \"high\" (thorough, includes all heuristics)."},{"name":"file_scores","type":"boolean|null","required":false,"description":"Show only per-file health scores, sorted by risk-aware triage concern:\nlower maintainability index and higher CRAP risk first."},{"name":"group","type":"string|null","required":false,"description":"Keep only the matching groups of a `group_by` run: exact group keys,\nglobs, and `!`-prefixed negations, comma-separated. Project-level\nsections are not filtered. Requires `group_by`. Passed through t…"},{"name":"group_by","type":"string|null","required":false,"description":"Group health findings by CODEOWNERS ownership, directory, workspace\npackage, or GitLab CODEOWNERS section. Values: \"owner\", \"directory\",\n\"package\", \"section\". `section` attaches an `owners: string[]`…"},{"name":"hotspots","type":"boolean|null","required":false,"description":"Show only hotspots: files that are both complex and frequently changing."},{"name":"low_traffic_threshold","type":"number|null","required":false,"description":"Fraction of `trace_count` below which an invoked function is\nclassified `low_traffic` rather than `active`. Expressed as a\ndecimal (0.001 = 0.1%). Inherits the sidecar default (0.001) when\nomitted. T…"},{"name":"max_cognitive","type":"integer|null","required":false,"description":"Maximum cognitive complexity threshold. Functions exceeding this are reported."},{"name":"max_crap","type":"number|null","required":false,"description":"Maximum CRAP score threshold (default 30.0). Functions meeting or\nexceeding this score are reported alongside complexity findings. Pair\nwith `coverage` for accurate per-function CRAP; without Istanbu…"},{"name":"max_cyclomatic","type":"integer|null","required":false,"description":"Maximum cyclomatic complexity threshold. Functions exceeding this are reported."},{"name":"max_file_lines","type":"integer|null","required":false,"description":"Maximum physical lines per file (default 0, off). A longer file is\nreported as a complexity finding with `exceeded: \"file_lines\"`.\nPassed through to the CLI's `--max-file-lines` flag."},{"name":"min_commits","type":"integer|null","required":false,"description":"Minimum commits for a file to appear in hotspot ranking."},{"name":"min_invocations_hot","type":"integer|null","required":false,"description":"Minimum invocation count for a function to be classified as a hot\npath in runtime-coverage output. Inherits the CLI default (100)\nwhen omitted. Takes effect only when `runtime_coverage` is also\nset;…"},{"name":"min_observation_volume","type":"integer|null","required":false,"description":"Minimum total trace volume before the sidecar may emit high-confidence\n`safe_to_delete` or `review_required` verdicts. Below this threshold,\nconfidence is capped at `medium` to protect against overco…"},{"name":"min_score","type":"number|null","required":false,"description":"Fail if the health score is below this threshold (0–100). Implies --score."},{"name":"min_severity","type":"string|null","required":false,"description":"Only exit with error for findings at or above this severity (moderate, high, critical)."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"ownership","type":"boolean|null","required":false,"description":"Attach ownership signals (bus factor, contributors, declared owner,\ndrift) to hotspot entries. Implies `hotspots`. Requires git."},{"name":"ownership_email_mode","type":null,"required":false,"description":"Privacy mode for author emails when `ownership` is enabled.\nImplies `ownership`. Defaults to `handle` server-side when omitted."},{"name":"production","type":"boolean|null","required":false,"description":"Only analyze production code (excludes tests, stories, dev files)."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"runtime_coverage","type":"string|null","required":false,"description":"Path to runtime coverage input. Accepts a V8 coverage directory\n(`NODE_V8_COVERAGE=...`), a single V8 coverage JSON file, or an\nIstanbul `coverage-final.json`. A single local capture is free and\nruns…"},{"name":"save_baseline","type":"string|null","required":false,"description":"Save current results as a baseline file for future comparisons. The path\nmust resolve inside the project root, its Git work tree, the CI workspace or a temp directory.\nA relative path resolves agains…"},{"name":"save_snapshot","type":"string|null","required":false,"description":"Save a vital signs snapshot. Provide a file path, or omit value for default (`.fallow/snapshots/{timestamp}.json`).\nThe path must resolve inside the project root, its Git work tree, the CI workspace…"},{"name":"score","type":"boolean|null","required":false,"description":"Show only the project health score (0–100) with letter grade (A/B/C/D/F).\nRuns duplication analysis automatically; pair with `hotspots=true` (or\n`targets=true`) for the churn-backed hotspot penalty."},{"name":"since","type":"string|null","required":false,"description":"Git history window for hotspot analysis. Accepts durations (6m, 90d, 1y) or ISO dates.\nIt also sets the window for change coupling and change dispersion. When absent,\nhotspots read 6 months and chang…"},{"name":"sort","type":"string|null","required":false,"description":"Sort order for results (e.g., \"cyclomatic\", \"cognitive\", \"lines\", \"severity\")."},{"name":"summary","type":"boolean|null","required":false,"description":"Include a natural-language summary of findings alongside the structured JSON output."},{"name":"targets","type":"boolean|null","required":false,"description":"Show only refactoring targets: ranked recommendations based on complexity, coupling, churn, and dead code."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"top","type":"integer|null","required":false,"description":"Number of top results to return."},{"name":"trend","type":"boolean|null","required":false,"description":"Compare current metrics against the most recent saved snapshot and show per-metric deltas.\nImplies --score. Reads from `.fallow/snapshots/`."},{"name":"trend_from","type":"string|null","required":false,"description":"Compare current metrics against this snapshot file instead of the newest\nfile in `.fallow/snapshots/`. Implies `trend`. With `group_by`, each group\nis compared by key when the snapshot holds the same…"},{"name":"type_aware","type":"boolean|null","required":false,"description":"Enable the TypeScript semantic backend.\n`false` keeps the run syntactic, also when the config turns type-aware analysis on. `type_aware_projects` or `type_aware_require` turns it on and wins over `fa…"},{"name":"type_aware_projects","type":"array|null","required":false,"description":"Explicit tsconfig paths for type-aware analysis."},{"name":"type_aware_require","type":null,"required":false,"description":"Whether incomplete semantic evidence is advisory or gating."},{"name":"type_coupling","type":"boolean|null","required":false,"description":"Include advisory project-local public-signature type coupling."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":3718},{"name":"check_runtime_coverage","title":null,"description":"Merge runtime-coverage data into the health report. Focused entry point for the runtime-coverage pipeline: pass a V8 coverage directory (`NODE_V8_COVERAGE=<dir>`), a single V8 coverage JSON file, or an Istanbul `coverage-final.json` via the required `coverage` field. A single local capture is free and runs without a license; continuous or multi-capture runtime monitoring (multiple JSON files in a V8 directory) requires an active license JWT (start a 30-day trial with `fallow license activate --trial --email <addr>`; check state with `fallow license status`). Returns structured JSON with a `runtime_coverage` block containing surfaced `findings` verdicts (`safe_to_delete` / `review_required` / `low_traffic` / `coverage_unavailable`), stable content-hash IDs (`fallow:prod:<hash>`), evidence, percentile-ranked hot paths (each with `start_line` and `end_line` so consumers can match against a PR diff), and on protocol-0.3+ sidecars a `summary.capture_quality` block that flags short-window captures. The sidecar may still classify other functions as `active`, but the CLI omits those from `runtime_coverage.findings` to keep the surfaced list actionable. Tunable via `min_invocations_hot` (hot-path threshold, default 100), `min_observation_volume` (high-confidence verdict floor, default 5000), and `low_traffic_threshold` (active/low_traffic split, default 0.001). `group_by` partitions results by CODEOWNERS / directory / package / section. PR-context behavior: when `FALLOW_DIFF_FILE` (path to a unified diff) is set in the agent's process environment, the top-level `runtime_coverage.verdict` promotes `hot-path-touched` over `cold-code-detected` so reviewers see the diff-tied signal first, AND every hot path is narrowed to functions whose `[start_line, end_line]` overlaps an added hunk. `FALLOW_CHANGED_SINCE` (git ref) also scopes (file-level). Without a change scope the verdict stays cold-code-primary and all hot paths are returned. The full unprioritized list is always in `run…","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"coverage","type":"string","required":true,"description":"Path to runtime coverage input. Accepts a V8 coverage directory\n(`NODE_V8_COVERAGE=<dir>`), a single V8 coverage JSON file, or an\nIstanbul `coverage-final.json`. Required."},{"name":"group_by","type":"string|null","required":false,"description":"Group health findings by CODEOWNERS ownership, directory, workspace\npackage, or GitLab CODEOWNERS section. Values: \"owner\", \"directory\",\n\"package\", \"section\". `section` attaches an `owners: string[]`…"},{"name":"low_traffic_threshold","type":"number|null","required":false,"description":"Fraction of `trace_count` below which an invoked function is\nclassified `low_traffic` rather than `active`. Expressed as a\ndecimal (0.001 = 0.1%). Inherits the sidecar default (0.001) when\nomitted."},{"name":"max_crap","type":"number|null","required":false,"description":"Maximum CRAP score threshold (default 30.0). Functions meeting or\nexceeding this score appear as findings alongside complexity violations.\nProduction V8 coverage yields the most accurate per-function…"},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"min_invocations_hot","type":"integer|null","required":false,"description":"Minimum invocation count for a function to be classified as a hot\npath. Inherits the CLI default (100) when omitted."},{"name":"min_observation_volume","type":"integer|null","required":false,"description":"Minimum total trace volume before the sidecar may emit high-confidence\n`safe_to_delete` or `review_required` verdicts. Below this threshold,\nconfidence is capped at `medium` to protect against overco…"},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"production","type":"boolean|null","required":false,"description":"Only analyze production code (excludes tests, stories, dev files)."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"top","type":"integer|null","required":false,"description":"Show only the top N runtime findings, hot paths, file scores, and\nrefactoring targets. Passed through to the CLI's `--top` flag."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":1144},{"name":"code_execute","title":null,"description":"Execute a bounded, read-only JavaScript Code Mode snippet against fallow's MCP host API. `code` must be a JavaScript function expression or function body that receives `{ fallow, root }` and returns a JSON-serializable value. The embedded sandbox exposes only a typed `fallow` object with read-only analysis calls: analyze, combined, checkChanged, checkArchitecture, securityCandidates, findDupes, projectInfo, traceExport, traceFile, impactClosure, traceDependency, traceClone, checkHealth, audit, explain, listBoundaries, featureFlags, impact, checkRuntimeCoverage, getHotPaths, getBlastRadius, getImportance, getCleanupCandidates, plus `fallow.run(tool, params)` for the same allowlist. Similar-code (15-minute timeouts) and mutation are excluded; use the standalone find_similar_code, inspect_similar_code, mutation_plan, and mutation_inspect MCP tools. Mutating fix tools are intentionally not exposed. The sandbox has no filesystem, network, module imports, process, require, Deno, Bun, or shell access, and no dynamic code compilation: eval, Function, and the async and generator function constructors are removed, including the `constructor` route reachable through function prototypes. `root` is injected into host calls that omit params.root. `timeout_ms` caps JS execution and subprocess-backed host calls. In Code Mode, analyze, checkArchitecture, securityCandidates, findDupes, impactClosure, checkHealth, audit, impact, checkRuntimeCoverage, getHotPaths, getBlastRadius, getImportance, and getCleanupCandidates stay subprocess-backed and are killed on timeout. Every other host call runs in this process, where `timeout_ms` both answers you on time and sets that call's cancellation token: the analysis is asked to stop rather than only abandoned. The stop is cooperative and has no upper bound, because a token set inside a long analysis stage is not read until that stage ends, so the work may still be winding down after the call returns, and while it is the next in-process call fa…","inputs":[{"name":"code","type":"string","required":true,"description":"JavaScript function expression or function body. The function receives\n`{ fallow, root }` and must return a JSON-serializable value."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Maximum total bytes of fallow JSON output that sandbox host calls may\nread. Defaults to 1000000 and is capped at 4000000."},{"name":"root","type":"string|null","required":false,"description":"Default project root injected into fallow host calls when their params\nomit `root`."},{"name":"timeout_ms","type":"integer|null","required":false,"description":"Overall sandbox timeout in milliseconds. Defaults to 5000 and is capped\nat 30000."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":1132},{"name":"decision_surface","title":null,"description":"Surface the consequential structural decisions a change embeds, each framed as a judgment question for a human with taste (`fallow decision-surface --format json`). The apex of the review brief and the single call that puts taste-decisions in front of a reviewer; separable and cheap, it runs the same changed-code analysis as the brief, not the full project pipeline. Returns `kind: \"decision-surface\"` with `schema_version`, a ranked `decisions[]` list, an optional `truncated` note, and `signal_count`. Each decision carries a `signal_id` (a deterministic anchor to the fallow-emitted candidate it frames; an agent decision whose `signal_id` fallow did not emit must be rejected, so a decision cannot name a signal that fallow did not find), a `category` (exactly one of `coupling-boundary`, `public-api-contract` and `dependency`), the framed `question`, the `anchor_file`/`anchor_line`, the `blast` (modules affected beyond the diff) and `consequence` rank, the routed `expert[]` (who to ask) with a `bus_factor_one` flag, and structured `actions[]` (`ask-expert`, `suppress`). The surface is capped to a small number of decisions (default 4, configurable via `max_decisions`, clamped to 3-5); decisions beyond the cap collapse into `truncated`. Every `coupling-boundary` and `public-api-contract` decision is suppressible with a `// fallow-ignore` comment on the anchor file (the `suppress` action carries the paste-ready comment); a `dependency` decision anchors on a `package.json`, which cannot carry a comment, so it has no `suppress` action. Always exits 0 (advisory, never a gate). Use `base` to pick the comparison point (defaults to the git merge-base). Use this to answer \"what are the few decisions in this change that actually need human judgment?\" rather than scanning the whole diff.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"base","type":"string|null","required":false,"description":"Git ref to compare against (e.g., \"main\", \"HEAD~5\"). When unset, the\nbase is the git merge-base against the branch's upstream or the remote\ndefault (`origin/main`); set `FALLOW_AUDIT_BASE` in the ser…"},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"max_decisions","type":"integer|null","required":false,"description":"Cap on the number of consequential structural decisions surfaced (the\nworking-memory limit). Default 4; clamped to the 3-5 band (4 plus or minus\n1)."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":668},{"name":"fallow_explain","title":null,"description":"Explain one fallow issue type without running analysis. Returns the rule id, name, rationale, worked example, fix guidance, and docs URL as JSON. Use this before applying fixes when an agent or reviewer needs to understand what a finding means. If your client exposes MCP resources, `fallow://explain/{issue_type}` serves the same document as a cacheable resource read.","inputs":[{"name":"issue_type","type":"string","required":true,"description":"Issue type or rule id to explain, for example \"unused-export\",\n\"fallow/unused-dependency\", \"high-complexity\", or \"code-duplication\"."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":129},{"name":"feature_flags","title":null,"description":"Detect feature flag patterns in a TypeScript/JavaScript project. Identifies environment variable flags (process.env.FEATURE_*), SDK calls from common providers, and config object patterns. Returns flag locations, detection confidence, and cross-reference with dead code findings. `retirement: true` adds advisory retirement rows (reasons, git age, evidence).","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"flag_age","type":"string|null","required":false,"description":"Flag age: \"blame\" (default, lower bound), \"pickaxe\" or \"off\". Needs `retirement`."},{"name":"flag_state","type":"string|null","required":false,"description":"Offline vendor flag export for the vendor reasons; relative to `root`. Needs `retirement`."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"production","type":"boolean|null","required":false,"description":"Only analyze production code (excludes tests, stories, dev files)."},{"name":"retirement","type":"boolean|null","required":false,"description":"Add the `retirement` block: one row per flag with reasons, git age and evidence."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"top","type":"integer|null","required":false,"description":"Show only the top N flags."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":325},{"name":"find_dupes","title":null,"description":"Find code duplication across the project. Detects clone groups (identical or similar code blocks) with configurable detection modes and thresholds. Returns clone families with refactoring suggestions. On a Rust root, it runs `cargo fallow dupes` (mode, min_tokens, min_lines, threshold). Each clone_groups[] entry carries a stable `fingerprint` (dup:<id>); pass it to the trace_clone tool to deep-dive that group (locations, an extract-function suggestion with estimated savings, and a best-effort suggested name). Set top=N to show only the N highest-ranked clone groups. Ranking combines token count, occurrence count, and a capped spread boost for distant files or same-file locations. Set group_by to \"owner\" (CODEOWNERS), \"directory\", \"package\" (workspace), or \"section\" (GitLab CODEOWNERS `[Section]` headers, with `owners` metadata per group) to partition results. Import declarations are excluded from clone detection by default (sorted import blocks are a formatting artifact, not copy-paste); pass ignore_imports=false to count them again. Clone instances omit their verbatim `fragment` text over MCP (it was most of the payload, and `file` plus the line/column range addresses the same code); set include_fragments=true to get it back. explain_skipped only changes the human-format skipped-default-ignores note (human/markdown CLI output); MCP JSON responses stay clean. Supports config, workspace scoping, baseline comparisons, and performance tuning (no_cache, threads).","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"baseline","type":"string|null","required":false,"description":"Compare results against a saved baseline file. Only new clone groups\n(not in the baseline) are reported. The response carries\n`baseline_staleness`: read `gate_trips` to see whether the baseline has\ne…"},{"name":"changed_since","type":"string|null","required":false,"description":"Git ref to compare against when limiting duplication to changed files."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"cross_language","type":"boolean|null","required":false,"description":"Enable cross-language detection (strips TypeScript type annotations for TS/JS matching)."},{"name":"explain_skipped","type":"boolean|null","required":false,"description":"Show a per-pattern breakdown for default duplicate ignores. `dupes`\nprints only that breakdown; the built-in discovery ignores are reported\nby `check`, `dead-code`, `audit` and the default run.\nHuman…"},{"name":"group_by","type":"string|null","required":false,"description":"Group findings by CODEOWNERS ownership, directory, workspace package, or\nGitLab CODEOWNERS section. Values: \"owner\", \"directory\", \"package\", \"section\"."},{"name":"ignore_imports","type":"boolean|null","required":false,"description":"Exclude import declarations from clone detection. Defaults to `true`\n(sorted import blocks are a formatting artifact, not copy-paste); set\n`false` to count them again."},{"name":"ignore_symlinks","type":"boolean|null","required":false,"description":"Omit clone instances whose path is a symlink or lies under a symlinked\ndirectory. Defaults to the project config; set `false` to report them\neven when the config sets `ignoreSymlinks`."},{"name":"include_fragments","type":"boolean|null","required":false,"description":"Include the verbatim source text on each clone instance. Defaults to\nfalse: `file` plus the line and column range address the same code, and\nthe text is most of the response. Set true only when you n…"},{"name":"min_lines","type":"integer|null","required":false,"description":"Minimum line count for a clone. Defaults to the project config, or 5 if unset."},{"name":"min_occurrences","type":"integer|null","required":false,"description":"Minimum number of occurrences before a clone group is reported. Raise\nto focus on widespread copy-paste and skip pair-only clones. Defaults\nto the project config, or 2 if unset."},{"name":"min_tokens","type":"integer|null","required":false,"description":"Minimum token count for a clone. Defaults to the project config, or 50 if unset."},{"name":"mode","type":"string|null","required":false,"description":"Detection mode: \"strict\", \"mild\", \"weak\", or \"semantic\". Defaults to\nthe project config, or \"mild\" if unset."},{"name":"near","type":"boolean|null","required":false,"description":"Detect function-scoped near-miss clones in addition to exact clones."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"no_package_baselines","type":"boolean|null","required":false,"description":"Ignore the per-package refs of `workspaces.changedSince` for this call,\nso every workspace package is analyzed in full scope. Use it to judge\nor save a whole-project baseline."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"save_baseline","type":"string|null","required":false,"description":"Save current results as a baseline file for future comparisons. The path\nmust resolve inside the project root, its Git work tree, the CI workspace or a temp directory.\nA relative path resolves agains…"},{"name":"skip_local","type":"boolean|null","required":false,"description":"Only report cross-directory duplicates."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"threshold","type":"number|null","required":false,"description":"Fail if duplication exceeds this percentage (0 = no limit). Defaults\nto the project config, or 0 if unset."},{"name":"top","type":"integer|null","required":false,"description":"Show only the N highest-ranked clone groups. `clone_families[]` is\nrebuilt from the groups that survive, so it narrows too. `stats` keeps\ndescribing the whole corpus; read `clone_groups_shown` /\n`clo…"},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":1345},{"name":"find_similar_code","title":null,"description":"Find semantically similar functions with Fallow's exact pinned local model. Results are unverified candidates, not probabilities, duplication findings, refactor instructions, or CI gates. Source stays on the local machine. Each candidate carries stable candidate_id and review_key identities, exact locations, reproducible provider/model provenance, completion accounting, and read-only inspect/review actions. The command never downloads a model: if explicit setup has not happened, it returns structured guidance to run `fallow similar-code setup --local`. Use threshold only as a candidate-retrieval cutoff, then call inspect_similar_code before deciding whether two functions are behaviorally equivalent or safe to consolidate. Supports root, config, workspace, changed_since, changed_workspaces, paths, threshold, min_lines, top, no_cache, and threads. Cold local inference has a dedicated 15-minute subprocess window; FALLOW_TIMEOUT_SECS still overrides it when an operator needs a different bound.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"changed_since","type":"string|null","required":false,"description":"Git ref used to report candidate pairs touching changed files."},{"name":"changed_workspaces","type":"string|null","required":false,"description":"Scope candidate reporting to workspaces touched since this git ref."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"min_lines","type":"integer|null","required":false,"description":"Minimum extracted source lines per function."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"paths","type":"array|null","required":false,"description":"Report candidate pairs touching one of these project-relative files."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"threshold","type":"number|null","required":false,"description":"Minimum cosine similarity from zero through one. This is not a\nprobability or verification verdict."},{"name":"top","type":"integer|null","required":false,"description":"Cap returned candidates after bounded full-corpus comparison."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to scope candidates to; mutually exclusive with `changed_workspaces`."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":478},{"name":"fix_apply","title":null,"description":"Apply auto-fixes to the project. Removes unused exports from the public API, may delete dead exported enum declarations, deletes unused dependencies from package.json, removes unused enum members, removes unused pnpm catalog entries (rewriting empty groups to `{}` so pnpm install does not reject null), and appends duplicate-export `ignoreExports` rules to the fallow config file. When no fallow config exists outside a monorepo subpackage, this CREATES `.fallowrc.json` using `fallow init`'s framework-aware scaffolding (`$schema`, `entry`, `ignorePatterns`, framework defaults) and layers the `ignoreExports` rules on top. Inside a monorepo subpackage (workspace marker `pnpm-workspace.yaml` / `package.json#workspaces` / `turbo.json` / `lerna.json` / `rush.json` above the invocation directory) the create-fallback refuses and emits `skip_reason: \"monorepo_subpackage\"` with a relative `workspace_root` path; the agent should re-run `fallow init` at the workspace root or invoke from there. Set `no_create_config: true` to opt out of the create-fallback entirely (recommended for CI and unattended use); the duplicate-export path is skipped with `skip_reason: \"no_create_config\"` and source-file edits proceed normally. When a source file's xxh3 content hash at fix time differs from the hash captured during the in-process analysis (parallel editor save, CI rebase, or other tool mutated the file between analysis and write), the per-file fix is skipped with `skip_reason: \"content_changed\"`; the envelope's top-level `skipped_content_changed` count is incremented and the run exits with code 2 so CI surfaces the mismatch instead of treating the partial run as a clean no-op. When a source file mixes CRLF and bare-LF line endings, the per-file fix is skipped with `skip_reason: \"mixed_line_endings\"`; the envelope's top-level `skipped_mixed_line_endings` count is incremented and the run exits with code 2. This skip is NOT self-healing: re-running fallow alone does not normalize the file an…","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"no_create_config","type":"boolean|null","required":false,"description":"Refuse to create a new fallow config file when none exists. Use this\nfrom pre-commit hooks and CI bots where silently materializing a new\ntop-level config file would surprise the user."},{"name":"production","type":"boolean|null","required":false,"description":"Production mode: exclude test, story, and dev files, only start/build\nscripts, and report type-only dependencies."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"show_cascade","type":"boolean|null","required":false,"description":"Also fix the unused exports, types, class members and enum members\nof unused files. By default `fix` skips them, as the report hides\nthem. Passed through to the CLI's `--show-cascade` flag."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":1270},{"name":"fix_preview","title":null,"description":"Preview auto-fixes without modifying any files. Shows what would be changed: which unused exports would be removed, which unused dependencies would be deleted from package.json, which unused enum members would be removed, which unused pnpm catalog entries would be cleaned up, and which duplicate-export `ignoreExports` rules would be added to the fallow config file. For `add-to-config` actions, each fix entry carries a `proposed_diff` field with the unified-diff preview of the proposed config write. When no fallow config exists outside a monorepo subpackage, fix_apply would CREATE `.fallowrc.json` using `fallow init`'s framework-aware scaffolding (`$schema`, `entry`, `ignorePatterns`, etc.) and layer the `ignoreExports` rules on top; preview entries on that path carry `created_files: [\".fallowrc.json\"]`. Set `no_create_config: true` to skip the config-creation path with `skip_reason: \"no_create_config\"`; source-file previews are unaffected. When a source file's xxh3 content hash at preview time differs from the hash captured during the in-process analysis (a concurrent source edit), the per-file entry is emitted with `skip_reason: \"content_changed\"` and the envelope's top-level `skipped_content_changed` count is incremented; re-run after refreshing analysis. When a source file mixes CRLF and bare-LF line endings, the per-file entry is emitted with `skip_reason: \"mixed_line_endings\"` and the envelope's top-level `skipped_mixed_line_endings` count is incremented; this skip is NOT self-healing because re-running fallow alone does not normalize the file. The agent must run `dos2unix <path>` (or instruct the user to set `git config core.autocrlf input` and re-checkout) before re-running. When an unused export lives in a test, mock, or fixture directory, or in a file that itself has an unresolved import, its removal is withheld as low confidence because the consumer may be invisible to static analysis: the per-file entry carries `skip_reason: \"low_confidence_off_graph\"` o…","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"no_create_config","type":"boolean|null","required":false,"description":"Refuse to create a new fallow config file when none exists. Use this\nfrom pre-commit hooks and CI bots where silently materializing a new\ntop-level config file would surprise the user."},{"name":"production","type":"boolean|null","required":false,"description":"Production mode: exclude test, story, and dev files, only start/build\nscripts, and report type-only dependencies."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"show_cascade","type":"boolean|null","required":false,"description":"Also fix the unused exports, types, class members and enum members\nof unused files. By default `fix` skips them, as the report hides\nthem. Passed through to the CLI's `--show-cascade` flag."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":927},{"name":"get_blast_radius","title":null,"description":"Return first-class blast-radius context alongside local runtime coverage. Pass `coverage` as a V8 coverage directory, single V8 JSON file, or Istanbul `coverage-final.json`. A single local capture is free and runs without a license; continuous or multi-capture runtime monitoring requires an active license. Returns the standard health JSON; agents should read `runtime_coverage.blast_radius`, which contains stable `fallow:blast:<hash>` IDs, caller counts, traffic-weighted caller reach, and low/medium/high risk bands. This blast-radius signal augments context only: it scores the RISK of changing a function. It MUST NOT gate `safe_to_delete` or a confidence score (a function having callers does not make it 'keep'); only the three-state runtime tracking signal (called / never_called / untracked) can issue a deletion verdict.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"coverage","type":"string","required":true,"description":"Path to runtime coverage input. Accepts a V8 coverage directory\n(`NODE_V8_COVERAGE=<dir>`), a single V8 coverage JSON file, or an\nIstanbul `coverage-final.json`. Required."},{"name":"group_by","type":"string|null","required":false,"description":"Group health findings by CODEOWNERS ownership, directory, workspace\npackage, or GitLab CODEOWNERS section. Values: \"owner\", \"directory\",\n\"package\", \"section\". `section` attaches an `owners: string[]`…"},{"name":"low_traffic_threshold","type":"number|null","required":false,"description":"Fraction of `trace_count` below which an invoked function is\nclassified `low_traffic` rather than `active`. Expressed as a\ndecimal (0.001 = 0.1%). Inherits the sidecar default (0.001) when\nomitted."},{"name":"max_crap","type":"number|null","required":false,"description":"Maximum CRAP score threshold (default 30.0). Functions meeting or\nexceeding this score appear as findings alongside complexity violations.\nProduction V8 coverage yields the most accurate per-function…"},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"min_invocations_hot","type":"integer|null","required":false,"description":"Minimum invocation count for a function to be classified as a hot\npath. Inherits the CLI default (100) when omitted."},{"name":"min_observation_volume","type":"integer|null","required":false,"description":"Minimum total trace volume before the sidecar may emit high-confidence\n`safe_to_delete` or `review_required` verdicts. Below this threshold,\nconfidence is capped at `medium` to protect against overco…"},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"production","type":"boolean|null","required":false,"description":"Only analyze production code (excludes tests, stories, dev files)."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"top","type":"integer|null","required":false,"description":"Show only the top N runtime findings, hot paths, file scores, and\nrefactoring targets. Passed through to the CLI's `--top` flag."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":782},{"name":"get_cleanup_candidates","title":null,"description":"Return cleanup candidates grounded in local runtime coverage. Pass `coverage` as a V8 coverage directory, single V8 JSON file, or Istanbul `coverage-final.json`. A single local capture is free and runs without a license; continuous or multi-capture runtime monitoring requires an active license. Returns the standard health JSON; agents should read `runtime_coverage.findings` for `safe_to_delete`, `review_required`, `low_traffic`, and `coverage_unavailable` verdicts.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"coverage","type":"string","required":true,"description":"Path to runtime coverage input. Accepts a V8 coverage directory\n(`NODE_V8_COVERAGE=<dir>`), a single V8 coverage JSON file, or an\nIstanbul `coverage-final.json`. Required."},{"name":"group_by","type":"string|null","required":false,"description":"Group health findings by CODEOWNERS ownership, directory, workspace\npackage, or GitLab CODEOWNERS section. Values: \"owner\", \"directory\",\n\"package\", \"section\". `section` attaches an `owners: string[]`…"},{"name":"low_traffic_threshold","type":"number|null","required":false,"description":"Fraction of `trace_count` below which an invoked function is\nclassified `low_traffic` rather than `active`. Expressed as a\ndecimal (0.001 = 0.1%). Inherits the sidecar default (0.001) when\nomitted."},{"name":"max_crap","type":"number|null","required":false,"description":"Maximum CRAP score threshold (default 30.0). Functions meeting or\nexceeding this score appear as findings alongside complexity violations.\nProduction V8 coverage yields the most accurate per-function…"},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"min_invocations_hot","type":"integer|null","required":false,"description":"Minimum invocation count for a function to be classified as a hot\npath. Inherits the CLI default (100) when omitted."},{"name":"min_observation_volume","type":"integer|null","required":false,"description":"Minimum total trace volume before the sidecar may emit high-confidence\n`safe_to_delete` or `review_required` verdicts. Below this threshold,\nconfidence is capped at `medium` to protect against overco…"},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"production","type":"boolean|null","required":false,"description":"Only analyze production code (excludes tests, stories, dev files)."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"top","type":"integer|null","required":false,"description":"Show only the top N runtime findings, hot paths, file scores, and\nrefactoring targets. Passed through to the CLI's `--top` flag."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":706},{"name":"get_cloud_deployment_changes","title":null,"description":"Read how production behavior changed between two deployments from Fallow Cloud. Backed by `fallow coverage deployment-changes --format json`. `repo` is required; `sha` defaults to `HEAD` of `root`, `base` to the previous deployment with production runtime. Each function has a change kind (`new_called`, `new_not_called`, `heated_up`, `cooled_down`, `stopped`, `unchanged`); `change`, `limit` and `cursor` filter and page. Read `comparable` first. Context only, never a deletion verdict. Needs `FALLOW_API_KEY` in the server environment.","inputs":[{"name":"base","type":"string|null","required":false,"description":"Base deployment commit SHA."},{"name":"change","type":"string|null","required":false,"description":"One change kind to keep."},{"name":"cursor","type":"string|null","required":false,"description":"`meta.cursor` of the previous page."},{"name":"limit","type":"integer|null","required":false,"description":"Page size, 1 to 200."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"repo","type":"string","required":true,"description":"Repository as `owner/repo`. Required."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"sha","type":"string|null","required":false,"description":"Deployment commit SHA; defaults to `HEAD`."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":293},{"name":"get_cloud_review_packet","title":null,"description":"Read production facts for a few changed files or functions from Fallow Cloud, with no full pull and no local analysis. Backed by `fallow coverage review-packet --format json`. `repo` is required; pass `files` and/or `functions` (`{file, name, line?}`), or neither to send the files changed against `base`. Rows carry `repo_path`, `tracking_state` (current deployment) and `period_tracking_state` (whole period); `evidence_window` is the real evidence span. A current `never_called` with `period_tracking_state: called` is not dead code. Needs `FALLOW_API_KEY` in the server environment; see `fallow://tools/get_cloud_review_packet`.","inputs":[{"name":"base","type":"string|null","required":false,"description":"Base ref for the changed-file default."},{"name":"commit_sha","type":"string|null","required":false,"description":"Deployment commit SHA."},{"name":"files","type":"array|null","required":false,"description":"Repo-relative files, at most 1000."},{"name":"functions","type":"array|null","required":false,"description":"Functions, at most 1000."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"period_days","type":"integer|null","required":false,"description":"Window in days, 1 to 90."},{"name":"project_id","type":"string|null","required":false,"description":"Project disambiguator."},{"name":"repo","type":"string","required":true,"description":"Repository as `owner/repo`. Required."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":330},{"name":"get_cloud_runtime_context","title":null,"description":"Pull runtime coverage for a repository from Fallow Cloud instead of a local V8 or Istanbul dump, and return the same `runtime_coverage` block the local runtime-coverage tools return. Backed by `fallow coverage analyze --cloud --format json`: Fallow Cloud is asked for the repository's runtime facts over the requested window, and the answer is joined against this project's static analysis, so `root` must be a checkout of the same repository. It makes a network call and needs a Fallow Cloud account (for a scoped question, get_cloud_review_packet is smaller); cloud pull is a Team-tier feature, and a repository your org cannot see is refused by the cloud rather than returned empty. The API key is never a parameter: the CLI reads `FALLOW_API_KEY` in the server's own environment, else the key that `fallow cloud login` stored. A call without a key stops before the analysis, with `isError`, `exit_code: 2`, and `code: \"cloud_api_key_missing\"`. `repo` (`owner/repo`) is required. `project_id`, `period_days` (1-90, default 30), `environment`, and `commit_sha` narrow what the cloud returns; `production`, `top`, and `min_invocations_hot` behave as they do on check_runtime_coverage. Read `runtime_coverage.findings` for `safe_to_delete` / `review_required` / `low_traffic` / `coverage_unavailable` verdicts, `runtime_coverage.hot_paths` for production hot paths, `runtime_coverage.blast_radius` and `runtime_coverage.importance` for review context that never gates a deletion verdict, `runtime_coverage.summary.data_source` to confirm the evidence is `cloud`, and `runtime_coverage.warnings` for the codes that explain a thin answer (`no_runtime_data`, `cloud_functions_unmatched`).","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"commit_sha","type":"string|null","required":false,"description":"Commit SHA filter for the runtime facts the cloud returns."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"environment","type":"string|null","required":false,"description":"Runtime environment filter, for example `production`."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"min_invocations_hot","type":"integer|null","required":false,"description":"Minimum invocation count for a function to be classified as a hot\npath. Inherits the CLI default (100) when omitted."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"period_days","type":"integer|null","required":false,"description":"Runtime observation window in days, 1 to 90. Inherits the CLI default\n(30) when omitted."},{"name":"production","type":"boolean|null","required":false,"description":"Only analyze production code (excludes tests, stories, dev files)."},{"name":"project_id","type":"string|null","required":false,"description":"Project disambiguator when one repository reports several projects."},{"name":"repo","type":"string","required":true,"description":"Repository Fallow Cloud holds runtime facts for, as `owner/repo`.\nRequired."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory. It must be a checkout\nof `repo`: cloud functions are joined against its static analysis."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"top","type":"integer|null","required":false,"description":"Show only the top N runtime findings and hot paths."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":746},{"name":"get_hot_paths","title":null,"description":"Return production hot paths from a local V8 or Istanbul runtime coverage dump. Pass `coverage` as a V8 coverage directory, single V8 JSON file, or Istanbul `coverage-final.json`. A single local capture is free and runs without a license; continuous or multi-capture runtime monitoring requires an active license. Returns the standard health JSON; agents should read `runtime_coverage.hot_paths`, which is sorted by percentile and invocation count. Each entry carries `start_line` and `end_line` so agents can match the function's full body against a PR diff. Use `top` to cap the returned hot paths. Each hot path with a static counterpart also carries `optimization_target`: `cost_score` (invocations multiplied by the per-call cost), `cost_basis` (`inner_iterations` from V8 block counts, else `cognitive`), `cognitive`, `cyclomatic`, `line_count`, and `inner_iterations_per_call`. To pick speed work, sort by `cost_basis` (`inner_iterations` first), then by `cost_score` descending: scores on different bases do not compare. The hot paths are selected and capped by invocations, so a function with fewer calls but more work per call can be absent. Use `get_importance` to judge the risk of a change. Environment-driven scoping: if `FALLOW_DIFF_FILE` (path to a unified diff) is set in the agent's process env, hot paths are narrowed to functions whose `[start_line, end_line]` overlaps an added hunk; a file the diff touched but with no added lines (deletion-only / pure-rename) drops its hot paths rather than falling through to changed-since file-level matching. `FALLOW_CHANGED_SINCE` (git ref) covers the fallback case (file-level match for files NOT in the diff at all). Unset both for project-wide hot paths.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"coverage","type":"string","required":true,"description":"Path to runtime coverage input. Accepts a V8 coverage directory\n(`NODE_V8_COVERAGE=<dir>`), a single V8 coverage JSON file, or an\nIstanbul `coverage-final.json`. Required."},{"name":"group_by","type":"string|null","required":false,"description":"Group health findings by CODEOWNERS ownership, directory, workspace\npackage, or GitLab CODEOWNERS section. Values: \"owner\", \"directory\",\n\"package\", \"section\". `section` attaches an `owners: string[]`…"},{"name":"low_traffic_threshold","type":"number|null","required":false,"description":"Fraction of `trace_count` below which an invoked function is\nclassified `low_traffic` rather than `active`. Expressed as a\ndecimal (0.001 = 0.1%). Inherits the sidecar default (0.001) when\nomitted."},{"name":"max_crap","type":"number|null","required":false,"description":"Maximum CRAP score threshold (default 30.0). Functions meeting or\nexceeding this score appear as findings alongside complexity violations.\nProduction V8 coverage yields the most accurate per-function…"},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"min_invocations_hot","type":"integer|null","required":false,"description":"Minimum invocation count for a function to be classified as a hot\npath. Inherits the CLI default (100) when omitted."},{"name":"min_observation_volume","type":"integer|null","required":false,"description":"Minimum total trace volume before the sidecar may emit high-confidence\n`safe_to_delete` or `review_required` verdicts. Below this threshold,\nconfidence is capped at `medium` to protect against overco…"},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"production","type":"boolean|null","required":false,"description":"Only analyze production code (excludes tests, stories, dev files)."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"top","type":"integer|null","required":false,"description":"Show only the top N runtime findings, hot paths, file scores, and\nrefactoring targets. Passed through to the CLI's `--top` flag."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":995},{"name":"get_importance","title":null,"description":"Return first-class production-importance context from local runtime coverage plus static health signals. Pass `coverage` as a V8 coverage directory, single V8 JSON file, or Istanbul `coverage-final.json`. A single local capture is free and runs without a license; continuous or multi-capture runtime monitoring requires an active license. Returns the standard health JSON; agents should read `runtime_coverage.importance`, which contains stable `fallow:importance:<hash>` IDs, invocations, cyclomatic complexity, owner count, a 0-100 score, and a templated reason. This importance signal augments context only. It MUST NOT gate `safe_to_delete` or a confidence score (a high or low score never decides deletion); only the three-state runtime tracking signal (called / never_called / untracked) can issue a deletion verdict.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"coverage","type":"string","required":true,"description":"Path to runtime coverage input. Accepts a V8 coverage directory\n(`NODE_V8_COVERAGE=<dir>`), a single V8 coverage JSON file, or an\nIstanbul `coverage-final.json`. Required."},{"name":"group_by","type":"string|null","required":false,"description":"Group health findings by CODEOWNERS ownership, directory, workspace\npackage, or GitLab CODEOWNERS section. Values: \"owner\", \"directory\",\n\"package\", \"section\". `section` attaches an `owners: string[]`…"},{"name":"low_traffic_threshold","type":"number|null","required":false,"description":"Fraction of `trace_count` below which an invoked function is\nclassified `low_traffic` rather than `active`. Expressed as a\ndecimal (0.001 = 0.1%). Inherits the sidecar default (0.001) when\nomitted."},{"name":"max_crap","type":"number|null","required":false,"description":"Maximum CRAP score threshold (default 30.0). Functions meeting or\nexceeding this score appear as findings alongside complexity violations.\nProduction V8 coverage yields the most accurate per-function…"},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"min_invocations_hot","type":"integer|null","required":false,"description":"Minimum invocation count for a function to be classified as a hot\npath. Inherits the CLI default (100) when omitted."},{"name":"min_observation_volume","type":"integer|null","required":false,"description":"Minimum total trace volume before the sidecar may emit high-confidence\n`safe_to_delete` or `review_required` verdicts. Below this threshold,\nconfidence is capped at `medium` to protect against overco…"},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"production","type":"boolean|null","required":false,"description":"Only analyze production code (excludes tests, stories, dev files)."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"top","type":"integer|null","required":false,"description":"Show only the top N runtime findings, hot paths, file scores, and\nrefactoring targets. Passed through to the CLI's `--top` flag."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":778},{"name":"get_token_blast_radius","title":null,"description":"Return design-token blast radius from static analysis. Runs `fallow health --css --format json`; agents should read `css_analytics.token_consumers`, a reverse index keyed by each token of its defining site plus a `consumer_count` and a capped located `consumers[]` sample of `{path,line,kind}`. Covers TWO token origins, disambiguated by token shape and consumer `kind`: Tailwind v4 `@theme` tokens (`token` is the `--`-prefixed custom property like `--color-brand`; `kind` in `theme-var` / `css-var` / `utility` / `apply`) AND CSS-in-JS token definitions (StyleX `defineVars` / `unstable_defineVarsNested`, vanilla-extract `createTheme` / `createThemeContract` / `createGlobalTheme`; `token` is the binding-qualified dotted access path like `vars.color.primary`, `namespace` is the defining binding, member reads use `js-member`, and StyleX theme-group calls use `js-call`). StyleX theme-group calls credit the complete resolved contract, including partial overrides and empty reset themes. The index is empty or absent on projects using neither. `consumer_count` is a static lower bound because computed class names, dynamic token structures, unresolved imports, and computed token access cannot always be counted. For Tailwind a `consumer_count` of 0 mirrors the unused-theme-token population (the dead-token verdict stays on `unused_theme_tokens` via check_health); CSS-in-JS tokens have no corroborating dead-token finding, so treat a CSS-in-JS 0 as weaker. Use this tool to scope the impact of editing or renaming a token, not to decide deletion.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":504},{"name":"guard","title":null,"description":"Report the architecture rules that apply to specific files before editing them: the file's boundary zone, which zones it may import from (same-zone imports are always allowed), forbidden call patterns, and every rule-pack policy in scope with its severity and suppression token. Works for files that do not exist yet, so it can be called before writing new code. A path that matches no configured zone returns an empty rule set rather than an error. It reads config only and runs no analysis; to find existing violations use `analyze` or `list_boundaries`.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"files","type":"array","required":true,"description":"Files to report on, project-root-relative. They do not need to exist yet."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":237},{"name":"impact","title":null,"description":"Read fallow's local value-tracking report. Runs NO analysis: it reads a per-project history file from the user's private config dir (never inside the repo), answering \"what has fallow done for me over time\" rather than \"what is wrong now\" (for live findings use analyze / audit / check_health). LOCAL-DEV ONLY: history accrues only on a developer's machine (local dev, or a persistent pre-commit gate); fallow never records in CI, so in CI / ephemeral runners this returns an empty report (enabled:false) and must NOT be used as a CI metric. Always returns a populated JSON object (never {}): branch on `enabled` and `enabled_source` (`project` = an explicit per-repo enable/disable, `user` = the user-global default, `default` = off). When `enabled:false`, use `explicit_decision` to decide what to say: `explicit_decision:false` means tracking was never set up here, so recommend the user run `fallow impact enable` (do not run it yourself); `explicit_decision:true` means the user deliberately disabled it here, so do NOT nag. Also branch on `record_count` (0 with enabled:true = set up but awaiting gate runs). When enabled with history it returns `surfacing` (issue counts from the most recent recorded run), `trend` (count delta vs the previous run; improving/declining/stable on the wire), `containment_count` + `recent_containment` (pre-commit gate runs that blocked a commit then later cleared), and a short-SHA `latest_git_sha` for correlation. On fallow with impact v1.5+ the report also carries `resolved_total` / `suppressed_total` / `recent_resolved` / `attribution_active`, crediting findings fallow saw genuinely fixed (code removed or refactored) and never counting a fallow-ignore suppression as a win; older fallow binaries omit these fields. On fallow with impact v1.6+ the report also carries `project_surfacing` / `project_trend`: a WHOLE-PROJECT view from the last full `fallow` run (additive optional under the same `schema_version`, omitted by older binaries). Treat changed…","inputs":[{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"root","type":"string|null","required":false,"description":"Project root whose local value history to read (stored outside the repo); defaults to the working directory."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":612},{"name":"impact_all","title":null,"description":"Roll EVERY tracked fallow project on this machine into one cross-repo value report (`fallow impact --all --format json`). Runs NO analysis: it reads the per-project history files in the user's private config dir, answering \"what has fallow done for me across all my repos\". Use this instead of `impact` when the agent wants a portfolio view rather than one repo; use `impact` (with `root`) for a single project. Returns `kind: \"impact-cross-repo\"` with `schema_version` \"2\", `project_count` (stores enumerated), `tracked_count` (projects with recorded history shown as rows), `unreadable_count` (corrupt/newer-schema stores skipped), a `totals` roll-up (resolved/contained/surfacing summed over ALL tracked projects, including repos since deleted from disk), and a `projects[]` array. Each project row carries a hashed `project_key` (never a filesystem path, and the only always-present identifier), an optional human `label` (the repo's directory basename; omitted on rows recorded by older fallow binaries, so fall back to `project_key` when `label` is null/absent), `last_recorded`, and a nested per-project `report`. Privacy: the aggregate exposes NO absolute paths, only the hash key plus the basename label. Projects that are enabled but have no recorded history yet are counted in `project_count` but excluded from `projects[]` rows. `sort` orders rows (`recent` default / `resolved` / `contained` / `name`); `limit` caps the rows returned while `totals` still reflect every tracked project. LOCAL-DEV ONLY: history accrues only on developer machines (fallow never records in CI), so in CI / ephemeral runners this returns zero tracked projects and must NOT be used as a CI metric. When `project_count` is 0, no project on this machine has tracking enabled yet: in a local dev session suggest the user run `fallow impact enable` in a repo they care about (do not run it yourself), but in CI stay silent because zero is the expected, non-actionable result. Read-only; the mutating enable / dis…","inputs":[{"name":"limit","type":"integer|null","required":false,"description":"Cap the number of project rows returned. Grand totals still reflect\nevery tracked project, including any beyond the cap. Omit for all rows."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"sort","type":"string|null","required":false,"description":"Row ordering: `recent` (default, most recently recorded project first),\n`resolved` (most findings resolved first), `contained` (most commits\ncontained first), or `name` (alphabetical by project label…"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":611},{"name":"impact_closure","title":null,"description":"Trace a file's impact closure. Runs `fallow dead-code --impact-closure <path> --format json --quiet` and returns the transitive affected-but-not-in-diff set plus coordination gaps for file-contract consumers. Evidence for review planning, not proof that affected files are wrong. Gaps carry `search_visibility`; see fallow://tools/impact_closure. Supports root, config, production, workspace, no_cache, and threads.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"path","type":"string","required":true,"description":"Project-relative path to the file whose impact closure to trace."},{"name":"production","type":"boolean|null","required":false,"description":"Production mode: exclude test, story, and dev files, only start/build\nscripts, and report type-only dependencies."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":321},{"name":"inspect_similar_code","title":null,"description":"Inspect one exact unverified candidate from find_similar_code without rerunning provider retrieval or global ranking. Pass candidate_id plus a bounded snapshot containing the unchanged discovery schema_version, generation, selected candidate, completion, and diagnostics fields. Current source is re-extracted and both source_sha256 values must still match before bounded source windows, syntactic behavior hints, graph relationships, reachability, callers/callees, ownership, churn, tests, and deterministic clone overlap are returned. Stale source fails closed. Missing evidence is represented explicitly, never inferred. This remains read-only and never declares behavioral equivalence or refactor safety.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"candidate_id","type":"string","required":true,"description":"Snapshot-stable candidate identity returned by `find_similar_code`."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"snapshot","type":"object","required":true,"description":"Bounded exact-candidate snapshot object selected from the original\ndiscovery response. Pass generation, candidate, completion, and\ndiagnostics unchanged; inspect validates current source hashes befor…"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":410},{"name":"inspect_target","title":null,"description":"Inspect one file or exported symbol and return one typed evidence bundle. Address a file with target={type:\"file\", file:\"src/a.ts\"}; address a symbol with target={type:\"symbol\", file:\"src/a.ts\", export_name:\"foo\"}. Composes existing read-only analysis systems only: trace_file, trace_export for symbols, file-scoped dead-code actions, duplication groups filtered to the file, complexity findings filtered to the file, security candidates scoped to the file, and the impact closure for the file (the transitive affected-but-not-in-diff set plus the coordination gap: modules that consume this file's contract but are not shown alongside it; a syntactic attention pointer, not a correctness proof). Set include_churn=true to attach target-level git churn from the in-process health hotspot subsystem; it is off by default, and missing git history is reported explicitly. Set cloud=true on a file target to attach the `cloud` evidence section of `fallow inspect --cloud` (Fallow Cloud production data per local function); repo selects the `owner/repo`. The key comes from the server environment or `fallow cloud login`, never from the call. The section status is ok, no_key, plan_required, unavailable, or untracked, and a status other than ok does not fail the call; see fallow://tools/inspect_target. Set format=\"compact\" to get the plain text of `fallow inspect --format compact` (about 1 KB, no JSON) instead of the bundle. production is forwarded only to child analyses that support it: trace, dead-code, and health. Symbol targets include file-scoped evidence with explicit scope fields because file:line enclosing-symbol mapping is a follow-up. This bundled query runs independent evidence analyses in parallel; large repositories can exceed the default 120s subprocess timeout, so raise FALLOW_TIMEOUT_SECS when needed.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"cloud","type":"boolean|null","required":false,"description":"Opt-in (default off): attach the Fallow Cloud `cloud` evidence section\nfor a file target: production data per local function. The CLI reads\nthe key: `FALLOW_API_KEY` in the server environment, else t…"},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"format","type":null,"required":false,"description":"Response format: `json` (default) returns the evidence bundle.\n`compact` returns the plain text of `fallow inspect --format compact`:\nabout 1 KB, one line per item, and no JSON."},{"name":"include_churn","type":"boolean|null","required":false,"description":"Opt-in (default off): attach target-level git churn evidence. Missing\ngit history is returned as an explicit unavailable evidence section."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"production","type":"boolean|null","required":false,"description":"Production mode: exclude test, story, and dev files, only start/build\nscripts, and report type-only dependencies. Forwarded only to child\nanalyses that support it: trace, dead-code, and health."},{"name":"repo","type":"string|null","required":false,"description":"Fallow Cloud repository for `cloud`, as `owner/repo`. Needs\n`cloud: true`. Precedence: this value, then `FALLOW_REPO` in the server\nenvironment, then the `origin` git remote."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"symbol_chain","type":"boolean|null","required":false,"description":"Opt-in (default off): also attach the best-effort symbol-level call chain\n(`fallow trace`) as the `symbol_chain` evidence section. Only\nmeaningful for a symbol target. Best-effort and syntactic, and…"},{"name":"target","type":null,"required":true,"description":"The file or exported symbol to inspect. See the tool description for\nthe two addressing shapes."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"type_aware","type":"boolean|null","required":false,"description":"Include project-wide TypeScript semantic evidence for symbol targets.\n`false` keeps the run syntactic, also when the config turns type-aware analysis on. `type_aware_projects` or `type_aware_require`…"},{"name":"type_aware_projects","type":"array|null","required":false,"description":"Explicit tsconfig paths for type-aware analysis."},{"name":"type_aware_require","type":null,"required":false,"description":"Whether incomplete semantic evidence is advisory or gating."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":1080},{"name":"list_boundaries","title":null,"description":"List architecture boundary zones and access rules configured for the project. Returns zone definitions (name, glob patterns, matched file count), access rules (which zones may import from which), and `logical_groups[]` (one entry per pre-expansion `autoDiscover` zone, surfacing the user-authored parent name, verbatim `auto_discover` paths, discovered `children`, `status` (`ok` / `empty` / `invalid_path`), `source_zone_index`, summed `file_count`, optional `authored_rule`, optional `fallback_zone` cross-reference for the Bulletproof case, optional `merged_from` when the parent name was declared multiple times, optional `original_zone_root` echo for monorepo subtree scopes, and optional `child_source_indices` attribution when multiple paths were authored). If boundaries are not configured, returns {\"configured\": false}; in that case, boundary violation checks will find no issues and can be skipped. Use this to understand the project's architecture constraints before running analysis.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":305},{"name":"list_suppressions","title":null,"description":"List active fallow-ignore suppression markers grouped per file with line, kind, level, reason, and a stale cross-reference. Runs `fallow suppressions --format json` and returns the `kind: \"suppression-inventory\"` envelope verbatim (a `summary` roll-up plus `files[]`); a governance surface for distrusting a clean verdict by seeing what is suppressed, not a gate, so it always exits 0 even when suppressions exist. Scope with `workspace`, `changed_since` (the natural pull-request review scope), or repeated `file` entries. Read-only. It runs a full analysis to populate the inventory, so on large repos raise `FALLOW_TIMEOUT_SECS` above the default 120s if it times out.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"changed_since","type":"string|null","required":false,"description":"Git ref (e.g. \"main\", \"HEAD~5\"). Scopes the inventory to files changed\nsince the ref, the natural pull-request review scope."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"file","type":"array|null","required":false,"description":"Only list suppressions in these files. Relative paths resolve against the\nproject root; forwarded as a repeated `--file` flag."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"production","type":"boolean|null","required":false,"description":"Only analyze production code (excludes tests, stories, dev files)."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":432},{"name":"mutation_inspect","title":null,"description":"Inspect one mutant of a saved `fallow mutation` JSON report (default: the report that the last run saved in the Fallow cache): original and mutated code, covering tests, and the killing test. A source_sha256 mismatch with the current file gives a stale status, not a wrong answer. This tool never runs tests. A report needs the CLI command `fallow mutation`, which executes the project's tests, so ask your host first. On a Rust root, it reads only the cached map of `cargo fallow mutants`.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Used only\nwithout `report`, as for `config`. Defaults to false and never grants\nprocess-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file. Used only without `report`, to find the\ncache directory that holds the report of the last run."},{"name":"mutant_id","type":"string","required":true,"description":"The `mutant_id` from a mutation plan or report."},{"name":"package","type":"string|null","required":false,"description":"The Cargo package of a Rust workspace with more than one package.\nValid only on a Rust workspace."},{"name":"report","type":"string|null","required":false,"description":"Path to a saved `fallow mutation` report or `mutation_plan` output.\nA relative path resolves against `root`. Without `root`, it resolves\nagainst the working directory of the MCP server. Omitted: the…"},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":334},{"name":"mutation_plan","title":null,"description":"Plan mutation testing and return the plan envelope: each mutant's id, position, operator, disposition, and static test files, plus a source_sha256 per file. Scope: changed code by default, or `all`, or `paths`. This tool never runs tests. Running the mutants needs the CLI command `fallow mutation`, which executes the project's tests, so ask your host first. On a Rust root, it runs `cargo fallow mutants --list` for one `package`, by default all of it.","inputs":[{"name":"all","type":"boolean|null","required":false,"description":"Plan every source file instead of the changed code."},{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"changed_since","type":"string|null","required":false,"description":"Base ref for the default changed-code scope. Omitted: the base is\ndetected as for `audit`."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"function_scope","type":"boolean|null","required":false,"description":"Plan every mutant of each function that holds a changed line. Omitted:\nthe `mutation.functionScope` config key, else the changed lines only."},{"name":"max_mutants","type":"integer|null","required":false,"description":"Maximum number of mutants to plan; the rest are `pending`. A run fills\nthe limit with covered mutants, so it can also run a `pending` one."},{"name":"mutants_per_line","type":"integer|null","required":false,"description":"Keep at most this many mutants on each line; the rest are `pending`\nwith the reason `sampled-out`. Omitted: the `mutation.mutantsPerLine`\nconfig key, else no limit."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"operators","type":"array|null","required":false,"description":"Kebab-case operator names, for example `relational-operator`.\nOmitted: the `mutation.operators` config key, else the default set.\nThe opt-in operators, such as `block-statement`, run only when named."},{"name":"package","type":"string|null","required":false,"description":"The Cargo package of a Rust workspace with more than one package.\nValid only on a Rust workspace, where the plan covers the whole package\nunless `paths` or `changed_since` is set."},{"name":"paths","type":"array|null","required":false,"description":"Plan only these files or directories, relative to the root."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":507},{"name":"mutation_tasks","title":null,"description":"List the open tasks of a saved `fallow mutation` JSON report as one batch (default: the report that the last run saved in the Fallow cache). A task is a survived or no_coverage mutant: a small change to the code that no test detected. Each task has the mutant_id, file, line, function, operator, status, the source lines before and after the change (original_lines, mutated_lines), and the covering test files. After `fallow mutation --record-args values`, a task can have witness; only witness.verdict witness gives a test input (args, original, mutant), and a verdict is never equivalent; see fallow://tools/mutation_tasks. Write tests that pass on the current code and fail on the changed code; one test can cover several tasks, and a task that no input can detect can be skipped. A task whose file changed after the report is stale and has no code. This tool never runs tests. A report needs the CLI command `fallow mutation`, which executes the project's tests, so ask your host first. A Rust root is not supported yet.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Used only\nwithout `report`, as for `config`. Defaults to false and never grants\nprocess-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file. Used only without `report`, to find the\ncache directory that holds the report of the last run."},{"name":"report","type":"string|null","required":false,"description":"Path to a saved `fallow mutation --format json` report. A relative\npath resolves against `root`. Without `root`, it resolves against the\nworking directory of the MCP server. Omitted: the report that…"},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":403},{"name":"project_info","title":null,"description":"Get project metadata: active framework plugins, discovered source files, and detected entry points. Useful for understanding how fallow sees the project before running analysis. Supports performance tuning (no_cache, threads).","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"boundaries","type":"boolean|null","required":false,"description":"Include discovered architecture boundary zones in the response."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"entry_points","type":"boolean|null","required":false,"description":"Include entry-point patterns in the response."},{"name":"files","type":"boolean|null","required":false,"description":"Include discovered source files in the response."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"plugins","type":"boolean|null","required":false,"description":"Include active framework plugins in the response."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":202},{"name":"recommend","title":null,"description":"Recommend a project-tailored fallow config for an agent to author (`fallow recommend --format json`). Read-only: runs project detection (frameworks, workspace layout, tooling) but not the analysis pipeline, and always exits 0. Returns `{detected, proposed_config, decisions[]}`. `detected` is what fallow saw; `proposed_config` is a safe starting config that both validates against config-schema and loads through fallow's real config loader; `decisions[]` has three tiers: `auto` (decided from unambiguous detection and applied silently), `default` (a disclosed, overridable default carrying a quantified `rationale`), and `taste` (a genuinely subjective choice surfaced as an open multiple-choice `question` with 2-4 options and no baked-in recommended answer, per fallow's taste-ownership principle). Framework rules are never uniformly auto-enabled on a heterogeneous monorepo; entry points beyond the obvious fall back to fallow's own defaults rather than a baked-in guess. Zero-config is a valid stop: the proposed config is an optional refinement over already-strong defaults, not a requirement. Pair with `fallow schema` (the capability manifest carrying per-rule default severity + opt-in) for the full cold-start discover -> recommend -> ask-taste -> author sequence. Honors `root`.","inputs":[{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"root","type":"string|null","required":false,"description":"Project root for framework, workspace, and tooling detection; defaults to the working directory."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":355},{"name":"security_candidates","title":null,"description":"Returns unverified security candidates, not confirmed vulnerabilities. Runs `fallow security --format json` and returns `kind: \"security\"`, `security_findings`, category, CWE, severity, evidence, structural trace, reachability ranking context, blind-spot counters, and optional unresolved-callee diagnostics for agent verification. `severity` is a review-priority tier, not a verified vulnerability verdict. Each finding also carries an agent-actionable `candidate` record (`source_kind`, the untrusted-input kind as a stable catalogue id or null; a self-contained `sink` with the captured callee and optional `url_shape` for URL candidates; and the `boundary` crossed), an optional `taint_flow` source-to-sink triple (present only when an untrusted source is import-reachable to the sink), a `finding_id` (the SARIF fingerprint), and a `stable_finding_id` that survives line moves, for verdicts. Set `surface: true` to include the top-level `attack_surface` inventory with source-to-sink paths and defensive-boundary verification prompts. Set gate to `new` for changed-line candidates or `newly-reachable` for candidates that became reachable from entry points; `newly-reachable` requires changed_since. There is no `impact` field: deciding exploitability is the agent's job. `reachability.untrusted_source_trace` is module-level context only and does not prove value flow. `reachability.taint_confidence` tiers reachable candidates as `arg-level` or `module-level`; tier from that field rather than evidence prose. Verify trace, reachability context, severity, and evidence before editing code or presenting a finding as a vulnerability. Supports root, config, workspace, changed_since, paths, changed_workspaces, surface, gate, no_cache, and threads. Use paths for the agent edit loop: it forwards to `fallow security --file` and scopes returned candidates to matching finding anchors, trace hops, untrusted-source reachability trace hops, or unresolved-callee diagnostics while cached analysis k…","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"changed_since","type":"string|null","required":false,"description":"Git ref to compare against when limiting candidates to changed files."},{"name":"changed_workspaces","type":"string|null","required":false,"description":"Scope candidates to workspaces touched since this git ref. Mutually\nexclusive with `workspace`."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"gate","type":"string|null","required":false,"description":"Optional security regression gate. Valid values: \"new\" or\n\"newly-reachable\". The \"newly-reachable\" gate requires `changed_since`."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"paths","type":"array|null","required":false,"description":"Scope candidates to just-edited files for the agent edit loop. Each path\nis passed to `fallow security --file` and matches finding anchors or\ntrace hops."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"surface","type":"boolean|null","required":false,"description":"Include the attack-surface inventory with defensive-boundary verification\nprompts in the JSON response."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to scope candidates to; mutually exclusive with `changed_workspaces`."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":797},{"name":"symbol_impact","title":null,"description":"Return exact-symbol consumers, transitive affected files, and targeted tests for a TypeScript export or exported class method. Select either export_name, or both class_name and member_name. The result is advisory project-impact evidence and does not duplicate tsc or Oxlint diagnostics.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"class_name","type":"string|null","required":false,"description":"Exact exported class name. Must be paired with `member_name`."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"export_name","type":"string|null","required":false,"description":"Exact exported symbol name. Mutually exclusive with the class-method\nselector."},{"name":"file","type":"string","required":true,"description":"Project-root-relative declaration file."},{"name":"member_name","type":"string|null","required":false,"description":"Exact method name. Must be paired with `class_name`."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"type_aware_projects","type":"array|null","required":false,"description":"Explicit tsconfig paths. Project auto-discovery is used when omitted."},{"name":"type_aware_require","type":null,"required":false,"description":"Whether incomplete semantic evidence is advisory or gating."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":272},{"name":"trace_clone","title":null,"description":"Deep-dive a duplicate-code clone group. Address it either by a source location (file + line) or by a stable fingerprint (fingerprint=\"dup:<id>\" from a find_dupes clone_groups[].fingerprint, usually dup:<8hex> and widened only on rare report collisions). Returns the matched clone instance, every sibling clone group / location, plus per group an extract-function suggestion with estimated line savings and a best-effort suggested_name (the field is omitted, not null, when there is no confident name, so branch on key presence; advisory, verify before applying, never auto-apply). Provide exactly one addressing form. Import declarations are excluded from clone detection by default; pass ignore_imports=false to count them again. Use after find_dupes when consolidating duplication and you need exact sibling locations and a refactor target.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"cross_language","type":"boolean|null","required":false,"description":"Enable cross-language detection (strips TypeScript type annotations for TS/JS matching)."},{"name":"file","type":"string|null","required":false,"description":"Project-relative path to a file containing the clone instance. Used\nwith `line` to address by source location; omit when using `fingerprint`."},{"name":"fingerprint","type":"string|null","required":false,"description":"Stable clone-group identity (`dup:<id>`) from a `find_dupes`\n`clone_groups[].fingerprint`. Alternative to addressing by `file` plus `line`."},{"name":"ignore_imports","type":"boolean|null","required":false,"description":"Exclude import declarations from clone detection. Defaults to `true`\n(sorted import blocks are a formatting artifact, not copy-paste); set\n`false` to count them again."},{"name":"ignore_symlinks","type":"boolean|null","required":false,"description":"Omit clone instances whose path is a symlink or lies under a symlinked\ndirectory. Defaults to the project config; set `false` to report them\neven when the config sets `ignoreSymlinks`."},{"name":"line","type":"integer|null","required":false,"description":"Line number of the clone instance within `file`. Used with `file` to\naddress by source location; omit when using `fingerprint`."},{"name":"min_lines","type":"integer|null","required":false,"description":"Minimum line count for a clone. Defaults to the project config, or 5 if unset."},{"name":"min_occurrences","type":"integer|null","required":false,"description":"Minimum number of occurrences before a clone group is reported.\nDefaults to the project config, or 2 if unset."},{"name":"min_tokens","type":"integer|null","required":false,"description":"Minimum token count for a clone. Defaults to the project config, or 50 if unset."},{"name":"mode","type":"string|null","required":false,"description":"Detection mode: \"strict\", \"mild\", \"weak\", or \"semantic\". Defaults to\nthe project config, or \"mild\" if unset."},{"name":"near","type":"boolean|null","required":false,"description":"Detect function-scoped near-miss clones before resolving the trace."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"skip_local","type":"boolean|null","required":false,"description":"Only report cross-directory duplicates."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"threshold","type":"number|null","required":false,"description":"Fail if duplication exceeds this percentage (0 = no limit). Defaults\nto the project config, or 0 if unset."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":733},{"name":"trace_dependency","title":null,"description":"Trace where a dependency is used. Returns which files import the package, which imports are type-only, whether the package is referenced from package.json scripts or CI configs (`used_in_scripts`), and whether the dependency is used at all (`is_used` accounts for imports, script usage, and the used packages that list it as a peer (`peer_of`), matching the unused-deps detector). `unused_in` names each manifest that the detector still flags, because an import credits only the nearest manifest that installs the package. Set `usage`, `specifiers`, `sites` (paged with `limit` and `cursor`) or `closure_depth` to add a `usage` object: per imported name, the file, call and unresolved counts, one hop through project wrappers, and the usage sites. Useful before removing a dependency, moving it between dependencies and devDependencies, or migrating its API.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"closure_depth","type":"integer|null","required":false,"description":"Add importers of the users, up to this depth. Implies `usage`."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"cursor","type":"string|null","required":false,"description":"`usage.sites.next_cursor` of the previous page."},{"name":"limit","type":"integer|null","required":false,"description":"Sites per page (default 50). Implies `sites`."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"package_name","type":"string","required":true,"description":"Name of the npm package to trace usage for."},{"name":"production","type":"boolean|null","required":false,"description":"Production mode: exclude test, story, and dev files, only start/build\nscripts, and report type-only dependencies."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"sites","type":"boolean|null","required":false,"description":"Add one page of usage sites. Implies `usage`."},{"name":"specifiers","type":"array|null","required":false,"description":"Imported names to report. Implies `sites`."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"usage","type":"boolean|null","required":false,"description":"Add the per-name `usage` counts."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":478},{"name":"trace_error","title":null,"description":"Resolve a runtime stack trace against the project graph: paste the trace text in `trace` and get, per frame, which definitions in THIS project the frame's identifier names. The verb for \"my service threw this in production, what code is that\". Returns `kind: \"trace-error\"` with retained frames in input order, each carrying an `origin` (`in_project`, `node_modules`, `out_of_corpus`) and a `resolution` (`resolved`, `ambiguous`, `not_found`, `not_attempted`), plus `candidates[]` naming the file, symbol, member and declaration line. It is built to refuse overclaiming: a frame matching several definitions is `ambiguous`, with bounded candidates and `candidates_omitted` instead of a preferred match, a frame the graph was never asked about is `not_attempted` rather than a softer `not_found`, and `line_mismatch` marks a resolved frame whose own line sits at a different declaration, so a name-only match is visible instead of implied. `counts` closes over the reported frames and publishes `frames_omitted` and `unparsed_lines`, so a capped or unreadable input cannot look complete. No source maps are read: a frame inside built output says so instead of being rebound through a map that may be stale, so give it a trace from unbundled source or the source paths a map already resolved. The RESOLUTION outcome never fails the call: a trace in which nothing resolves is an ANSWER, and exits 0. A refused input still is a refusal: an empty or oversized `trace` returns `isError` with `FALLOW_INVALID_TRACE_OPTIONS`.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"production","type":"boolean|null","required":false,"description":"Production mode: exclude test, story, and dev files, only start/build\nscripts, and report type-only dependencies."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"source","type":"string|null","required":false,"description":"Where the trace came from, echoed back as the payload's `source`."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"trace","type":"string","required":true,"description":"The runtime stack trace text, pasted verbatim."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":544},{"name":"trace_export","title":null,"description":"Trace why an export is considered used or unused. Returns file reachability, entry-point status, direct references, re-export chains, the framework plugin rules that mark the export as used (`plugin_credits`), and a concise reason string. If export_name is a class / enum / store MEMBER rather than a top-level export, returns a member trace instead (carrying member_name, member_kind, owner_export, owner_is_used) that reports the owning class's reachability and usage plus a pointer to the matching --unused-<kind>-members command, so a class-member finding can be debugged too. Use this when an agent needs evidence before deleting or rewriting a supposedly unused export or class member. References carry `search_visibility`; see fallow://tools/trace_export. When the config or FALLOW_TYPE_AWARE turns type-aware analysis on, the trace also carries a `semantic` block with checker-backed evidence, as `fallow dead-code --trace` does.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"export_name","type":"string","required":true,"description":"Name of the exported symbol (or class/enum/store member) to trace."},{"name":"file","type":"string","required":true,"description":"Project-relative path to the file that declares the export."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"production","type":"boolean|null","required":false,"description":"Production mode: exclude test, story, and dev files, only start/build\nscripts, and report type-only dependencies."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":400},{"name":"trace_file","title":null,"description":"Trace a file's graph context. Returns whether the file is reachable or an entry point, what it exports, what it imports, what imports it, and which re-exports it declares. Use this to understand whether a file is isolated, barrel-only, or imported by live entry points.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"file","type":"string","required":true,"description":"Project-relative path to the file to trace."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"production","type":"boolean|null","required":false,"description":"Production mode: exclude test, story, and dev files, only start/build\nscripts, and report type-only dependencies."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":236},{"name":"trace_import_path","title":null,"description":"Shortest import path from one module to another, hop by hop with each hop's import line and whether the hop is type-only. Unreachable answers `reachable: false`; the same module answers `reachable: true`. Both report `hops: 0`, so branch on `reachable`, not the count. Exact project paths take priority; ambiguous abbreviations are refused. Use trace_file for one file's direct neighbours.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"from","type":"string","required":true,"description":"Project-relative path of the module the walk starts from."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"production","type":"boolean|null","required":false,"description":"Production mode: exclude test, story, and dev files, only start/build\nscripts, and report type-only dependencies."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"to","type":"string","required":true,"description":"Project-relative path of the module the walk is looking for."},{"name":"workspace","type":"string|null","required":false,"description":"Workspace packages to analyze: name or repo-relative path, comma-separated list, globs, `!` negation."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":284},{"name":"trace_symbol","title":null,"description":"Trace an exact TypeScript symbol with checker-backed references, namespace identity, aliases, and re-export hops. Root trace fields preserve syntactic context; treat `semantic.references`, `semantic.status`, and `semantic.identity` as the authoritative exact evidence. The proof covers only the lane named by `semantic.target.namespace`, so a root trace that lists a reference the proof does not is wider evidence rather than stale. This is project-wide evidence for Fallow decisions, not a compiler-diagnostic or lint-rule surface.","inputs":[{"name":"allow_remote_extends","type":"boolean|null","required":false,"description":"Allow trusted HTTPS config `extends` for this request. Defaults to false\nand never grants process-global trust."},{"name":"config","type":"string|null","required":false,"description":"Path to a fallow config file."},{"name":"export_name","type":"string","required":true,"description":"Name of the exported symbol to trace."},{"name":"file","type":"string","required":true,"description":"Project-relative path to the file that declares the export."},{"name":"max_output_bytes","type":"integer|null","required":false,"description":"Byte cap for this call's response. Lowers the server cap (default\n1000000); over it the call is REFUSED (`isError`, `exit_code: 2`)."},{"name":"no_cache","type":"boolean|null","required":false,"description":"Disable the incremental parse cache."},{"name":"root","type":"string|null","required":false,"description":"Project root; defaults to the working directory."},{"name":"threads","type":"integer|null","required":false,"description":"Parser thread count; defaults to CPU cores."},{"name":"type_aware_projects","type":"array|null","required":false,"description":"Explicit tsconfig paths. Project auto-discovery is used when omitted."},{"name":"type_aware_require","type":null,"required":false,"description":"Whether incomplete semantic evidence is advisory or gating."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":322}],"toolsTruncatedAtCapture":false,"diagnostics":{"capturedAt":"2026-11-21T08:42:05.000Z","track":"package","endpoint":null,"declaredUrl":null,"truncated":false,"tls":null,"dnssec":null,"auth":null,"httpsRedirect":null,"transports":[],"provenance":{"outcome":"verified","label":"Verified","reason":"verified","reasonLabel":"Verified","discovery":"attestation_endpoint","discoveryLabel":"Registry attestation endpoint","sourceRepo":null,"attestationSkipped":null,"attestationSkippedLabel":null},"installScripts":[],"installScriptsTotal":null,"vulnerabilities":[],"vulnerabilitiesTotal":null,"dependencies":{"nodes":9,"partial":false,"deprecated":null,"stale":null,"noRepo":null}},"mismatches":[],"changelog":{"trackingSince":"2026-11-13","recent":[{"id":"chg_01a1f83f-f17c-777f-a417-7c77153ec332","kind":"package.version_changed","summary":"Package version (3.44.0 → 3.45.0)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-20","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1f83f-f17c-777f-a417-7c77153ec332"},{"id":"chg_01a1f83f-f17d-727a-9fd5-e0ad2ba971e0","kind":"score.total_changed","summary":"Trust score (82 → 83)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-20","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1f83f-f17d-727a-9fd5-e0ad2ba971e0"},{"id":"chg_01a1f344-27eb-7ba1-9917-30dce8f826d5","kind":"package.version_changed","summary":"Package version (3.43.2 → 3.44.0)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-19","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1f344-27eb-7ba1-9917-30dce8f826d5"},{"id":"chg_01a1edcc-2951-7386-b489-09c58e8206e1","kind":"score.total_changed","summary":"Trust score (81 → 82)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-18","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1edcc-2951-7386-b489-09c58e8206e1"},{"id":"chg_01a1e660-f8ac-70e6-a3ad-337ac91b27a8","kind":"score.total_changed","summary":"Trust score (50 → 81)","materiality":"functional","direction":"improvement","scoreDelta":31,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1e660-f8ac-70e6-a3ad-337ac91b27a8"},{"id":"chg_01a1e660-04e5-72c5-b0b2-4ddede315a4e","kind":"check.unverifiable","summary":"Stability (0.07 → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1e660-04e5-72c5-b0b2-4ddede315a4e"},{"id":"chg_01a1e660-04eb-7a9a-93ca-08f5855f1251","kind":"check.unverifiable","summary":"Tool safety (pass → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1e660-04eb-7a9a-93ca-08f5855f1251"},{"id":"chg_01a1e660-04ec-7356-83d9-5e65b76d0216","kind":"check.unverifiable","summary":"Capabilities (pass → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1e660-04ec-7356-83d9-5e65b76d0216"},{"id":"chg_01a1e660-04ec-795e-bc3e-c3598e9d57b6","kind":"check.unverifiable","summary":"Tool coverage (100 → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1e660-04ec-795e-bc3e-c3598e9d57b6"},{"id":"chg_01a1e660-04ef-70d7-9f76-63a48e0e8e8d","kind":"check.unverifiable","summary":"Schema quality (100 → unverified)","materiality":"functional","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1e660-04ef-70d7-9f76-63a48e0e8e8d"},{"id":"chg_01a1e660-04ef-7654-9653-dd695651b879","kind":"package.version_changed","summary":"Package version (3.43.1 → 3.43.2)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1e660-04ef-7654-9653-dd695651b879"},{"id":"chg_01a1e660-04ef-7c2a-a4a0-8e89fe77deb0","kind":"score.total_changed","summary":"Trust score (81 → 50)","materiality":"functional","direction":"regression","scoreDelta":-31,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1e660-04ef-7c2a-a4a0-8e89fe77deb0"},{"id":"chg_01a1e37c-5ce6-735d-bb2a-ca73817c7118","kind":"score.total_changed","summary":"Trust score (80 → 81)","materiality":"functional","direction":"improvement","scoreDelta":1,"occurredOn":"2026-11-16","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1e37c-5ce6-735d-bb2a-ca73817c7118"},{"id":"chg_01a1de58-8696-7689-9589-f25b52ed4e89","kind":"check.reverified","summary":"Malware scan (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-15","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1de58-8696-7689-9589-f25b52ed4e89"},{"id":"chg_01a1de58-8698-709d-b95b-555b3dd71492","kind":"score.total_changed","summary":"Trust score (65 → 80)","materiality":"functional","direction":"improvement","scoreDelta":15,"occurredOn":"2026-11-15","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1de58-8698-709d-b95b-555b3dd71492"},{"id":"chg_01a1dc38-f991-7208-b9f6-5d2c21ed142c","kind":"check.reverified","summary":"Stability (unverified → 0.03)","materiality":"functional","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-14","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1dc38-f991-7208-b9f6-5d2c21ed142c"},{"id":"chg_01a1dc38-f992-71e2-b547-a1e8b03b6b7a","kind":"package.version_changed","summary":"Package version (3.43.0 → 3.43.1)","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-14","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1dc38-f992-71e2-b547-a1e8b03b6b7a"},{"id":"chg_01a1dc38-f992-7c9f-9576-9a33ccde35e8","kind":"score.total_changed","summary":"Trust score (79 → 65)","materiality":"functional","direction":"regression","scoreDelta":-14,"occurredOn":"2026-11-14","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1dc38-f992-7c9f-9576-9a33ccde35e8"},{"id":"chg_01a1d930-0f18-7071-accf-a1e8a5f17f4a","kind":"check.reverified","summary":"Malware scan (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-14","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1d930-0f18-7071-accf-a1e8a5f17f4a"},{"id":"chg_01a1d930-0f19-7b34-b304-9eef22cad663","kind":"score.total_changed","summary":"Trust score (64 → 79)","materiality":"functional","direction":"improvement","scoreDelta":15,"occurredOn":"2026-11-14","url":"https://verifymcp.io/servers/fallow-rs-fallow/fallow#chg-chg_01a1d930-0f19-7b34-b304-9eef22cad663"}],"truncated":true,"feedUrl":"https://verifymcp.io/servers/fallow-rs-fallow/fallow/changelog.json"},"links":{"html":"https://verifymcp.io/servers/fallow-rs-fallow/fallow","markdown":"https://verifymcp.io/servers/fallow-rs-fallow/fallow.md","changelogJson":"https://verifymcp.io/servers/fallow-rs-fallow/fallow/changelog.json","changelogRss":"https://verifymcp.io/servers/fallow-rs-fallow/fallow.xml","external":[{"label":"npm package","href":"https://www.npmjs.com/package/fallow"},{"label":"Socket report","href":"https://socket.dev/npm/package/fallow"},{"label":"Repository","href":"https://github.com/fallow-rs/fallow"},{"label":"Website","href":"https://fallow.tools/docs/integrations/mcp/"}]}}