big-code-analysis-cli 2.0.0__py3-none-macosx_11_0_arm64.whl

man/bca-ops.1

@@ -0,0 +1,116 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH BCA-OPS 1  "big-code-analysis 2.0.0" "big-code-analysis Manual"
+.SH NAME
+bca\-ops \- Extract per\-file operands and operators
+.SH SYNOPSIS
+\fBbca\-ops\fR [\fB\-p\fR|\fB\-\-paths\fR] [\fB\-I\fR|\fB\-\-include\fR] [\fB\-X\fR|\fB\-\-exclude\fR] [\fB\-l\fR|\fB\-\-language\fR] [\fB\-\-no\-skip\-generated\fR] [\fB\-\-paths\-from\fR] [\fB\-\-exclude\-from\fR] [\fB\-\-no\-ignore\fR] [\fB\-\-no\-config\fR] [\fB\-j\fR|\fB\-\-jobs\fR] [\fB\-\-exclude\-tests\fR] [\fB\-\-cyclomatic\-count\-try\fR] [\fB\-\-preproc\-data\fR] [\fB\-\-color\fR] [\fB\-O\fR|\fB\-\-format\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-\-output\-dir\fR] [\fB\-\-pretty\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIPATHS\fR] 
+.SH DESCRIPTION
+Extract per\-file operands and operators
+.SH OPTIONS
+.TP
+\fB\-O\fR, \fB\-\-format\fR \fI<FORMAT>\fR
+Output format. When omitted, the default `text` format prints a human\-readable colored tree to stdout (`metrics` shows the metric tree, `ops` the operator/operand tree); pass `\-\-format text` to request that default explicitly (e.g. to override a `bca.toml` that set a structured format). `json` / `yaml` / `toml` / `cbor` / `csv` emit structured per\-file data. `\-\-output\-format` is accepted as a deprecated alias; it is hidden from help and slated for removal in 2.0
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+text: Human\-readable colored tree printed to stdout (`metrics` shows the metric tree, `ops` the operator/operand tree) — the default when `\-\-format` is omitted. Selecting it explicitly produces byte\-identical output to omitting the flag, so it is the way to request the default in a script or to override a `bca.toml` that set a structured format. It only ever streams to stdout, so unlike the structured serializers it has no file destination: pairing it with `\-\-output`/`\-\-output\-dir` is a hard error, not a silent no\-op — pass a structured `\-\-format` to write files
+.IP \(bu 2
+cbor
+.IP \(bu 2
+csv
+.IP \(bu 2
+json
+.IP \(bu 2
+toml
+.IP \(bu 2
+yaml
+.RE
+.TP
+\fB\-o\fR, \fB\-\-output\fR \fI<OUTPUT>\fR
+Output file. Writes one aggregate document (a top\-level array of the per\-file results; TOML wraps it under a `files` key) for the whole run. Stdout if omitted (CBOR requires this flag). Use `\-\-output\-dir` for the per\-file directory tree; passing both is an error
+.TP
+\fB\-\-output\-dir\fR \fI<OUTPUT_DIR>\fR
+Output directory. Writes one document per input file, named by the input path plus the format extension. Mutually exclusive with `\-\-output` (which writes a single aggregate file)
+.TP
+\fB\-\-pretty\fR
+Pretty\-print JSON / TOML output
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help (see a summary with \*(Aq\-h\*(Aq)
+.SH "INPUT SELECTION"
+.TP
+\fB\-p\fR, \fB\-\-paths\fR \fI<PATHS>\fR
+Input files or directories to analyze. Unioned with any positional `[PATHS]`. Defaults to the current directory (`.`) when omitted and no manifest `paths` is set; an explicitly\-given path that does not exist is an error (exit 1)
+.TP
+\fB\-I\fR, \fB\-\-include\fR \fI<INCLUDE>\fR
+Glob to include files. Repeat the flag to add multiple globs (`\-I \*(Aq*.rs\*(Aq \-I \*(Aq*.toml\*(Aq`); each occurrence takes exactly one value, so a positional argument that follows is never swallowed. A leading `./` is optional: `dir/**` and `./dir/**` are equivalent
+.TP
+\fB\-X\fR, \fB\-\-exclude\fR \fI<EXCLUDE>\fR
+Glob to exclude files. Repeat the flag to add multiple globs (`\-X \*(Aq*.tmp\*(Aq \-X \*(Aq*.bak\*(Aq`); each occurrence takes exactly one value, so a positional argument that follows is never swallowed. A leading `./` is optional: `dir/**` and `./dir/**` are equivalent. CLI values are *merged with* (unioned, not a replacement for) any `bca.toml` `exclude` list and any `\-\-exclude\-from` patterns, so a CLI `\-\-exclude` never silently un\-excludes a directory the project config deliberately skipped. Pass `\-\-no\-config` to ignore the manifest entirely
+.TP
+\fB\-l\fR, \fB\-\-language\fR \fI<LANGUAGE>\fR
+Force a language instead of inferring from extension. Accepts a canonical language name (`rust`, `python`, `cpp`, …) or a file extension (`rs`, `py`, …). An unrecognized value is a hard error
+.TP
+\fB\-\-no\-skip\-generated\fR
+Disable auto\-skip of files marked as generated (e.g. `@generated`, `DO NOT EDIT`, `GENERATED CODE` near the top). By default the CLI skips such files so generated bindings do not skew metrics
+.TP
+\fB\-\-paths\-from\fR \fI<PATHS_FROM>\fR
+Read newline\-separated input paths from a file. Use `\-` to read from stdin. Combined as a union with any `\-\-paths` values; globs still apply. Blank lines are skipped; `#` is treated as a path character (not a comment). To pass a file literally named `\-`, use `./\-`
+.TP
+\fB\-\-exclude\-from\fR \fI<EXCLUDE_FROM>\fR
+Read additional `\-\-exclude` glob patterns from a file (one per line, `.gitignore`\-style). Blank lines and lines whose first non\-whitespace character is `#` are skipped. Use `\-` to read from stdin; to pass a file literally named `\-`, use `./\-`. Patterns are unioned with any `\-\-exclude` values into a single deny\-set; order does not matter. Convention is a `.bcaignore` at the repo root, mirroring `.gitignore` / `.dockerignore`
+.TP
+\fB\-\-no\-ignore\fR
+Disable `.gitignore` / `.ignore` / global gitignore awareness when expanding input directories. Explicit file paths are always honored regardless of this flag
+.TP
+\fB\-\-no\-config\fR
+Skip auto\-discovery of a `bca.toml` manifest. By default `bca` climbs from the working directory to the repo root looking for `bca.toml` and merges its keys *under* any explicit CLI flags. Pass this for raw, fully\-explicit invocations that must not pick up repo\-level config (e.g. a reproducible CI one\-liner). When no manifest is discovered this flag is a no\-op
+.TP
+[\fIPATHS\fR]
+Input files or directories to analyze, given positionally (`bca metrics src/ tests/`). Unioned with any `\-\-paths`/`\-p` values
+.SH "WALKER TUNING"
+.TP
+\fB\-j\fR, \fB\-\-jobs\fR \fI<N|auto>\fR [default: auto]
+Number of jobs.
+
+Defaults to the effective CPU count as reported by the OS (cgroup\-quota\- and cpuset\-aware on Linux). Pass an explicit integer or `auto` to override. `\-\-jobs 1` forces serial mode for debugging. `\-\-num\-jobs` is kept as a hidden alias for one release cycle and is slated for removal in the next major.
+.TP
+\fB\-\-exclude\-tests\fR
+Exclude inline test code from metric computation. Currently applies to Rust only (skips `#[test]`, `#[cfg(test)]`, `#[tokio::test]`, `#[rstest]`, `#![cfg(test)]` items and their subtrees). Default is off — every node is counted, so numbers stay byte\-for\-byte stable. Languages without a test\-subtree skip rule ignore this flag
+.TP
+\fB\-\-cyclomatic\-count\-try\fR[=\fI<BOOL>\fR]
+Whether Rust\*(Aqs `?` operator (the `try_expression` node) contributes to cyclomatic complexity (standard and modified). Defaults to `true` — `?` counts +1, matching upstream rust\-code\-analysis and every published metric value. Pass `\-\-cyclomatic\-count\-try=false` to treat `?` as linear error propagation — useful when cyclomatic is used as a maintainability gate that should not penalize fallible\-but\-linear code. Rust\-only: no other language emits the node, so the flag is inert elsewhere. Mirrors the `cyclomatic_count_try` manifest key; the CLI value overrides the manifest in either direction
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+true
+.IP \(bu 2
+false
+.RE
+.SH PREPROCESSOR
+.TP
+\fB\-\-preproc\-data\fR \fI<PREPROC_DATA>\fR
+Existing preprocessor\-data JSON to consume during C/C++ analysis. Use `bca preproc` to produce one
+.SH OUTPUT
+.TP
+\fB\-\-color\fR \fI<WHEN>\fR [default: auto]
+When to colorize the human\-readable `text` dumps (`metrics` / `ops` default tree, `dump`, `find`, `functions`): `auto` (default — color only when stdout is a terminal and `NO_COLOR` is unset), `always` (force escapes even when piped/redirected), or `never` (plain text). Structured formats (`json` / `yaml` / `toml` / `cbor` / `csv`) and file output are never colorized. Honors the `NO_COLOR` convention (<https://no\-color.org>) unless `\-\-color always` overrides it
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+auto: Color when stdout is a terminal and `NO_COLOR` is unset
+.IP \(bu 2
+always: Always emit color, even when piped or redirected
+.IP \(bu 2
+never: Never emit color
+.RE

man/bca-preproc.1

@@ -0,0 +1,69 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH BCA-PREPROC 1  "big-code-analysis 2.0.0" "big-code-analysis Manual"
+.SH NAME
+bca\-preproc \- Generate preprocessor\-data JSON for C/C++ analysis
+.SH SYNOPSIS
+\fBbca\-preproc\fR [\fB\-p\fR|\fB\-\-paths\fR] [\fB\-I\fR|\fB\-\-include\fR] [\fB\-X\fR|\fB\-\-exclude\fR] [\fB\-l\fR|\fB\-\-language\fR] [\fB\-\-no\-skip\-generated\fR] [\fB\-\-paths\-from\fR] [\fB\-\-exclude\-from\fR] [\fB\-\-no\-ignore\fR] [\fB\-\-no\-config\fR] [\fB\-j\fR|\fB\-\-jobs\fR] [\fB\-\-exclude\-tests\fR] [\fB\-\-cyclomatic\-count\-try\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIPATHS\fR] 
+.SH DESCRIPTION
+Generate preprocessor\-data JSON for C/C++ analysis
+.SH OPTIONS
+.TP
+\fB\-o\fR, \fB\-\-output\fR \fI<OUTPUT>\fR
+Output JSON file. Stdout if omitted
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help (see a summary with \*(Aq\-h\*(Aq)
+.SH "INPUT SELECTION"
+.TP
+\fB\-p\fR, \fB\-\-paths\fR \fI<PATHS>\fR
+Input files or directories to analyze. Unioned with any positional `[PATHS]`. Defaults to the current directory (`.`) when omitted and no manifest `paths` is set; an explicitly\-given path that does not exist is an error (exit 1)
+.TP
+\fB\-I\fR, \fB\-\-include\fR \fI<INCLUDE>\fR
+Glob to include files. Repeat the flag to add multiple globs (`\-I \*(Aq*.rs\*(Aq \-I \*(Aq*.toml\*(Aq`); each occurrence takes exactly one value, so a positional argument that follows is never swallowed. A leading `./` is optional: `dir/**` and `./dir/**` are equivalent
+.TP
+\fB\-X\fR, \fB\-\-exclude\fR \fI<EXCLUDE>\fR
+Glob to exclude files. Repeat the flag to add multiple globs (`\-X \*(Aq*.tmp\*(Aq \-X \*(Aq*.bak\*(Aq`); each occurrence takes exactly one value, so a positional argument that follows is never swallowed. A leading `./` is optional: `dir/**` and `./dir/**` are equivalent. CLI values are *merged with* (unioned, not a replacement for) any `bca.toml` `exclude` list and any `\-\-exclude\-from` patterns, so a CLI `\-\-exclude` never silently un\-excludes a directory the project config deliberately skipped. Pass `\-\-no\-config` to ignore the manifest entirely
+.TP
+\fB\-l\fR, \fB\-\-language\fR \fI<LANGUAGE>\fR
+Force a language instead of inferring from extension. Accepts a canonical language name (`rust`, `python`, `cpp`, …) or a file extension (`rs`, `py`, …). An unrecognized value is a hard error
+.TP
+\fB\-\-no\-skip\-generated\fR
+Disable auto\-skip of files marked as generated (e.g. `@generated`, `DO NOT EDIT`, `GENERATED CODE` near the top). By default the CLI skips such files so generated bindings do not skew metrics
+.TP
+\fB\-\-paths\-from\fR \fI<PATHS_FROM>\fR
+Read newline\-separated input paths from a file. Use `\-` to read from stdin. Combined as a union with any `\-\-paths` values; globs still apply. Blank lines are skipped; `#` is treated as a path character (not a comment). To pass a file literally named `\-`, use `./\-`
+.TP
+\fB\-\-exclude\-from\fR \fI<EXCLUDE_FROM>\fR
+Read additional `\-\-exclude` glob patterns from a file (one per line, `.gitignore`\-style). Blank lines and lines whose first non\-whitespace character is `#` are skipped. Use `\-` to read from stdin; to pass a file literally named `\-`, use `./\-`. Patterns are unioned with any `\-\-exclude` values into a single deny\-set; order does not matter. Convention is a `.bcaignore` at the repo root, mirroring `.gitignore` / `.dockerignore`
+.TP
+\fB\-\-no\-ignore\fR
+Disable `.gitignore` / `.ignore` / global gitignore awareness when expanding input directories. Explicit file paths are always honored regardless of this flag
+.TP
+\fB\-\-no\-config\fR
+Skip auto\-discovery of a `bca.toml` manifest. By default `bca` climbs from the working directory to the repo root looking for `bca.toml` and merges its keys *under* any explicit CLI flags. Pass this for raw, fully\-explicit invocations that must not pick up repo\-level config (e.g. a reproducible CI one\-liner). When no manifest is discovered this flag is a no\-op
+.TP
+[\fIPATHS\fR]
+Input files or directories to analyze, given positionally (`bca metrics src/ tests/`). Unioned with any `\-\-paths`/`\-p` values
+.SH "WALKER TUNING"
+.TP
+\fB\-j\fR, \fB\-\-jobs\fR \fI<N|auto>\fR [default: auto]
+Number of jobs.
+
+Defaults to the effective CPU count as reported by the OS (cgroup\-quota\- and cpuset\-aware on Linux). Pass an explicit integer or `auto` to override. `\-\-jobs 1` forces serial mode for debugging. `\-\-num\-jobs` is kept as a hidden alias for one release cycle and is slated for removal in the next major.
+.TP
+\fB\-\-exclude\-tests\fR
+Exclude inline test code from metric computation. Currently applies to Rust only (skips `#[test]`, `#[cfg(test)]`, `#[tokio::test]`, `#[rstest]`, `#![cfg(test)]` items and their subtrees). Default is off — every node is counted, so numbers stay byte\-for\-byte stable. Languages without a test\-subtree skip rule ignore this flag
+.TP
+\fB\-\-cyclomatic\-count\-try\fR[=\fI<BOOL>\fR]
+Whether Rust\*(Aqs `?` operator (the `try_expression` node) contributes to cyclomatic complexity (standard and modified). Defaults to `true` — `?` counts +1, matching upstream rust\-code\-analysis and every published metric value. Pass `\-\-cyclomatic\-count\-try=false` to treat `?` as linear error propagation — useful when cyclomatic is used as a maintainability gate that should not penalize fallible\-but\-linear code. Rust\-only: no other language emits the node, so the flag is inert elsewhere. Mirrors the `cyclomatic_count_try` manifest key; the CLI value overrides the manifest in either direction
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+true
+.IP \(bu 2
+false
+.RE

man/bca-report.1

@@ -0,0 +1,105 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH BCA-REPORT 1  "big-code-analysis 2.0.0" "big-code-analysis Manual"
+.SH NAME
+bca\-report \- Generate an aggregated report across the analyzed source
+.SH SYNOPSIS
+\fBbca\-report\fR [\fB\-p\fR|\fB\-\-paths\fR] [\fB\-I\fR|\fB\-\-include\fR] [\fB\-X\fR|\fB\-\-exclude\fR] [\fB\-l\fR|\fB\-\-language\fR] [\fB\-\-no\-skip\-generated\fR] [\fB\-\-paths\-from\fR] [\fB\-\-exclude\-from\fR] [\fB\-\-no\-ignore\fR] [\fB\-\-no\-config\fR] [\fB\-j\fR|\fB\-\-jobs\fR] [\fB\-\-exclude\-tests\fR] [\fB\-\-cyclomatic\-count\-try\fR] [\fB\-\-preproc\-data\fR] [\fB\-O\fR|\fB\-\-format\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-\-top\fR] [\fB\-\-strip\-prefix\fR] [\fB\-\-no\-suppress\fR] [\fB\-\-vcs\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIFORMAT\fR] 
+.SH DESCRIPTION
+Generate an aggregated report across the analyzed source
+.SH OPTIONS
+.TP
+\fB\-O\fR, \fB\-\-format\fR \fI<FORMAT>\fR
+Report format (`markdown` or `html`). Defaults to `markdown` when neither this flag nor the deprecated positional form is given
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+markdown
+.IP \(bu 2
+html
+.RE
+.TP
+\fB\-o\fR, \fB\-\-output\fR \fI<OUTPUT>\fR
+Output file. Stdout if omitted
+.TP
+\fB\-\-top\fR \fI<TOP>\fR [default: 20]
+Maximum number of entries per hotspot table (`0` = all)
+.TP
+\fB\-\-strip\-prefix\fR \fI<STRIP_PREFIX>\fR [default: ]
+Path prefix to strip from displayed file paths
+.TP
+\fB\-\-no\-suppress\fR[=\fI<BOOL>\fR]
+Include functions silenced by in\-source suppression markers (`bca: suppress`, `bca: suppress\-file`, `#lizard forgives`) in the hotspot tables. By default the report honors these markers and omits a function from a metric\*(Aqs hotspot table when that metric is suppressed for it — matching `bca check` and the SARIF emitter. Pass this for the raw audit view that lists every offender. Value\-taking: a bare `\-\-no\-suppress` means `true`; `\-\-no\-suppress=false` forces the marker\-honoring default even when the `[report] no_suppress` key in `bca.toml` enabled it. The CLI value overrides the manifest in either direction
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+true
+.IP \(bu 2
+false
+.RE
+.TP
+\fB\-\-vcs\fR
+Append a "Change\-history risk" section ranking files by VCS risk (churn, authorship, fix history) using default windows, mirroring `bca metrics \-\-vcs`. Ignored (with a warning) outside a git working tree. See `bca vcs` for the standalone, tunable report
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help (see a summary with \*(Aq\-h\*(Aq)
+.SH "INPUT SELECTION"
+.TP
+\fB\-p\fR, \fB\-\-paths\fR \fI<PATHS>\fR
+Input files or directories to analyze. Unioned with any positional `[PATHS]`. Defaults to the current directory (`.`) when omitted and no manifest `paths` is set; an explicitly\-given path that does not exist is an error (exit 1)
+.TP
+\fB\-I\fR, \fB\-\-include\fR \fI<INCLUDE>\fR
+Glob to include files. Repeat the flag to add multiple globs (`\-I \*(Aq*.rs\*(Aq \-I \*(Aq*.toml\*(Aq`); each occurrence takes exactly one value, so a positional argument that follows is never swallowed. A leading `./` is optional: `dir/**` and `./dir/**` are equivalent
+.TP
+\fB\-X\fR, \fB\-\-exclude\fR \fI<EXCLUDE>\fR
+Glob to exclude files. Repeat the flag to add multiple globs (`\-X \*(Aq*.tmp\*(Aq \-X \*(Aq*.bak\*(Aq`); each occurrence takes exactly one value, so a positional argument that follows is never swallowed. A leading `./` is optional: `dir/**` and `./dir/**` are equivalent. CLI values are *merged with* (unioned, not a replacement for) any `bca.toml` `exclude` list and any `\-\-exclude\-from` patterns, so a CLI `\-\-exclude` never silently un\-excludes a directory the project config deliberately skipped. Pass `\-\-no\-config` to ignore the manifest entirely
+.TP
+\fB\-l\fR, \fB\-\-language\fR \fI<LANGUAGE>\fR
+Force a language instead of inferring from extension. Accepts a canonical language name (`rust`, `python`, `cpp`, …) or a file extension (`rs`, `py`, …). An unrecognized value is a hard error
+.TP
+\fB\-\-no\-skip\-generated\fR
+Disable auto\-skip of files marked as generated (e.g. `@generated`, `DO NOT EDIT`, `GENERATED CODE` near the top). By default the CLI skips such files so generated bindings do not skew metrics
+.TP
+\fB\-\-paths\-from\fR \fI<PATHS_FROM>\fR
+Read newline\-separated input paths from a file. Use `\-` to read from stdin. Combined as a union with any `\-\-paths` values; globs still apply. Blank lines are skipped; `#` is treated as a path character (not a comment). To pass a file literally named `\-`, use `./\-`
+.TP
+\fB\-\-exclude\-from\fR \fI<EXCLUDE_FROM>\fR
+Read additional `\-\-exclude` glob patterns from a file (one per line, `.gitignore`\-style). Blank lines and lines whose first non\-whitespace character is `#` are skipped. Use `\-` to read from stdin; to pass a file literally named `\-`, use `./\-`. Patterns are unioned with any `\-\-exclude` values into a single deny\-set; order does not matter. Convention is a `.bcaignore` at the repo root, mirroring `.gitignore` / `.dockerignore`
+.TP
+\fB\-\-no\-ignore\fR
+Disable `.gitignore` / `.ignore` / global gitignore awareness when expanding input directories. Explicit file paths are always honored regardless of this flag
+.TP
+\fB\-\-no\-config\fR
+Skip auto\-discovery of a `bca.toml` manifest. By default `bca` climbs from the working directory to the repo root looking for `bca.toml` and merges its keys *under* any explicit CLI flags. Pass this for raw, fully\-explicit invocations that must not pick up repo\-level config (e.g. a reproducible CI one\-liner). When no manifest is discovered this flag is a no\-op
+.SH "WALKER TUNING"
+.TP
+\fB\-j\fR, \fB\-\-jobs\fR \fI<N|auto>\fR [default: auto]
+Number of jobs.
+
+Defaults to the effective CPU count as reported by the OS (cgroup\-quota\- and cpuset\-aware on Linux). Pass an explicit integer or `auto` to override. `\-\-jobs 1` forces serial mode for debugging. `\-\-num\-jobs` is kept as a hidden alias for one release cycle and is slated for removal in the next major.
+.TP
+\fB\-\-exclude\-tests\fR
+Exclude inline test code from metric computation. Currently applies to Rust only (skips `#[test]`, `#[cfg(test)]`, `#[tokio::test]`, `#[rstest]`, `#![cfg(test)]` items and their subtrees). Default is off — every node is counted, so numbers stay byte\-for\-byte stable. Languages without a test\-subtree skip rule ignore this flag
+.TP
+\fB\-\-cyclomatic\-count\-try\fR[=\fI<BOOL>\fR]
+Whether Rust\*(Aqs `?` operator (the `try_expression` node) contributes to cyclomatic complexity (standard and modified). Defaults to `true` — `?` counts +1, matching upstream rust\-code\-analysis and every published metric value. Pass `\-\-cyclomatic\-count\-try=false` to treat `?` as linear error propagation — useful when cyclomatic is used as a maintainability gate that should not penalize fallible\-but\-linear code. Rust\-only: no other language emits the node, so the flag is inert elsewhere. Mirrors the `cyclomatic_count_try` manifest key; the CLI value overrides the manifest in either direction
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+true
+.IP \(bu 2
+false
+.RE
+.SH PREPROCESSOR
+.TP
+\fB\-\-preproc\-data\fR \fI<PREPROC_DATA>\fR
+Existing preprocessor\-data JSON to consume during C/C++ analysis. Use `bca preproc` to produce one

man/bca-strip-comments.1

@@ -0,0 +1,76 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH BCA-STRIP-COMMENTS 1  "big-code-analysis 2.0.0" "big-code-analysis Manual"
+.SH NAME
+bca\-strip\-comments \- Remove comments from source files
+.SH SYNOPSIS
+\fBbca\-strip\-comments\fR [\fB\-p\fR|\fB\-\-paths\fR] [\fB\-I\fR|\fB\-\-include\fR] [\fB\-X\fR|\fB\-\-exclude\fR] [\fB\-l\fR|\fB\-\-language\fR] [\fB\-\-no\-skip\-generated\fR] [\fB\-\-paths\-from\fR] [\fB\-\-exclude\-from\fR] [\fB\-\-no\-ignore\fR] [\fB\-\-no\-config\fR] [\fB\-j\fR|\fB\-\-jobs\fR] [\fB\-\-exclude\-tests\fR] [\fB\-\-cyclomatic\-count\-try\fR] [\fB\-\-preproc\-data\fR] [\fB\-\-in\-place\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIPATHS\fR] 
+.SH DESCRIPTION
+Remove comments from source files
+.SH OPTIONS
+.TP
+\fB\-\-in\-place\fR
+Rewrite each input file in place instead of writing to stdout. Use this for multi\-file rewrites; it is mutually exclusive with `\-\-output`
+.TP
+\fB\-o\fR, \fB\-\-output\fR \fI<OUTPUT>\fR
+Write the stripped output to this file instead of stdout. Requires a single input file — a multi\-file run is rejected (use `\-\-in\-place` for that). Mutually exclusive with `\-\-in\-place`. Omit it (and `\-\-in\-place`) to stream the result to stdout
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help (see a summary with \*(Aq\-h\*(Aq)
+.SH "INPUT SELECTION"
+.TP
+\fB\-p\fR, \fB\-\-paths\fR \fI<PATHS>\fR
+Input files or directories to analyze. Unioned with any positional `[PATHS]`. Defaults to the current directory (`.`) when omitted and no manifest `paths` is set; an explicitly\-given path that does not exist is an error (exit 1)
+.TP
+\fB\-I\fR, \fB\-\-include\fR \fI<INCLUDE>\fR
+Glob to include files. Repeat the flag to add multiple globs (`\-I \*(Aq*.rs\*(Aq \-I \*(Aq*.toml\*(Aq`); each occurrence takes exactly one value, so a positional argument that follows is never swallowed. A leading `./` is optional: `dir/**` and `./dir/**` are equivalent
+.TP
+\fB\-X\fR, \fB\-\-exclude\fR \fI<EXCLUDE>\fR
+Glob to exclude files. Repeat the flag to add multiple globs (`\-X \*(Aq*.tmp\*(Aq \-X \*(Aq*.bak\*(Aq`); each occurrence takes exactly one value, so a positional argument that follows is never swallowed. A leading `./` is optional: `dir/**` and `./dir/**` are equivalent. CLI values are *merged with* (unioned, not a replacement for) any `bca.toml` `exclude` list and any `\-\-exclude\-from` patterns, so a CLI `\-\-exclude` never silently un\-excludes a directory the project config deliberately skipped. Pass `\-\-no\-config` to ignore the manifest entirely
+.TP
+\fB\-l\fR, \fB\-\-language\fR \fI<LANGUAGE>\fR
+Force a language instead of inferring from extension. Accepts a canonical language name (`rust`, `python`, `cpp`, …) or a file extension (`rs`, `py`, …). An unrecognized value is a hard error
+.TP
+\fB\-\-no\-skip\-generated\fR
+Disable auto\-skip of files marked as generated (e.g. `@generated`, `DO NOT EDIT`, `GENERATED CODE` near the top). By default the CLI skips such files so generated bindings do not skew metrics
+.TP
+\fB\-\-paths\-from\fR \fI<PATHS_FROM>\fR
+Read newline\-separated input paths from a file. Use `\-` to read from stdin. Combined as a union with any `\-\-paths` values; globs still apply. Blank lines are skipped; `#` is treated as a path character (not a comment). To pass a file literally named `\-`, use `./\-`
+.TP
+\fB\-\-exclude\-from\fR \fI<EXCLUDE_FROM>\fR
+Read additional `\-\-exclude` glob patterns from a file (one per line, `.gitignore`\-style). Blank lines and lines whose first non\-whitespace character is `#` are skipped. Use `\-` to read from stdin; to pass a file literally named `\-`, use `./\-`. Patterns are unioned with any `\-\-exclude` values into a single deny\-set; order does not matter. Convention is a `.bcaignore` at the repo root, mirroring `.gitignore` / `.dockerignore`
+.TP
+\fB\-\-no\-ignore\fR
+Disable `.gitignore` / `.ignore` / global gitignore awareness when expanding input directories. Explicit file paths are always honored regardless of this flag
+.TP
+\fB\-\-no\-config\fR
+Skip auto\-discovery of a `bca.toml` manifest. By default `bca` climbs from the working directory to the repo root looking for `bca.toml` and merges its keys *under* any explicit CLI flags. Pass this for raw, fully\-explicit invocations that must not pick up repo\-level config (e.g. a reproducible CI one\-liner). When no manifest is discovered this flag is a no\-op
+.TP
+[\fIPATHS\fR]
+Input files or directories to analyze, given positionally (`bca metrics src/ tests/`). Unioned with any `\-\-paths`/`\-p` values
+.SH "WALKER TUNING"
+.TP
+\fB\-j\fR, \fB\-\-jobs\fR \fI<N|auto>\fR [default: auto]
+Number of jobs.
+
+Defaults to the effective CPU count as reported by the OS (cgroup\-quota\- and cpuset\-aware on Linux). Pass an explicit integer or `auto` to override. `\-\-jobs 1` forces serial mode for debugging. `\-\-num\-jobs` is kept as a hidden alias for one release cycle and is slated for removal in the next major.
+.TP
+\fB\-\-exclude\-tests\fR
+Exclude inline test code from metric computation. Currently applies to Rust only (skips `#[test]`, `#[cfg(test)]`, `#[tokio::test]`, `#[rstest]`, `#![cfg(test)]` items and their subtrees). Default is off — every node is counted, so numbers stay byte\-for\-byte stable. Languages without a test\-subtree skip rule ignore this flag
+.TP
+\fB\-\-cyclomatic\-count\-try\fR[=\fI<BOOL>\fR]
+Whether Rust\*(Aqs `?` operator (the `try_expression` node) contributes to cyclomatic complexity (standard and modified). Defaults to `true` — `?` counts +1, matching upstream rust\-code\-analysis and every published metric value. Pass `\-\-cyclomatic\-count\-try=false` to treat `?` as linear error propagation — useful when cyclomatic is used as a maintainability gate that should not penalize fallible\-but\-linear code. Rust\-only: no other language emits the node, so the flag is inert elsewhere. Mirrors the `cyclomatic_count_try` manifest key; the CLI value overrides the manifest in either direction
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+true
+.IP \(bu 2
+false
+.RE
+.SH PREPROCESSOR
+.TP
+\fB\-\-preproc\-data\fR \fI<PREPROC_DATA>\fR
+Existing preprocessor\-data JSON to consume during C/C++ analysis. Use `bca preproc` to produce one

man/bca-vcs-commit.1

@@ -0,0 +1,45 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH BCA-VCS-COMMIT 1  "big-code-analysis 2.0.0" "big-code-analysis Manual"
+.SH NAME
+bca\-vcs\-commit \- Score a single commit for defect\-induction risk — the just\-in\-time (JIT) defect\-prediction unit a CI gate reviews at check\-in. Emits a JSON breakdown of size / diffusion / history / experience / purpose features, their contributions, and an ordinal composite score. Window / `\-\-ref` / bot / merge / rename behaviour comes from the parent `vcs` flags. The old `jit` spelling stays a hidden alias for one release cycle
+.SH SYNOPSIS
+\fBbca\-vcs\-commit\fR [\fB\-\-diff\fR] [\fB\-O\fR|\fB\-\-format\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-\-pretty\fR] [\fB\-\-fail\-above\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fICOMMIT\fR] 
+.SH DESCRIPTION
+Score a single commit for defect\-induction risk — the just\-in\-time (JIT) defect\-prediction unit a CI gate reviews at check\-in. Emits a JSON breakdown of size / diffusion / history / experience / purpose features, their contributions, and an ordinal composite score. Window / `\-\-ref` / bot / merge / rename behaviour comes from the parent `vcs` flags. The old `jit` spelling stays a hidden alias for one release cycle
+.SH OPTIONS
+.TP
+\fB\-\-diff\fR \fI<FILE>\fR
+Score a `git diff` instead of a commit. Reads the diff from the given file, or from stdin when the value is `\-`. The input must be a git\-style unified diff with `diff \-\-git` file headers (as produced by `git diff` / `git format\-patch`); plain `diff \-u` output without those headers and combined / merge diffs (`git diff \-\-cc`, `@@@` headers) are not supported. A bare diff has no author / parent / history, so ONLY the size and diffusion groups are scored; the result is a deliberately PARTIAL report (history / experience / purpose are marked unavailable, not zero) and its score is NOT comparable to a commit score. Mutually exclusive with the positional commit spec
+.TP
+\fB\-O\fR, \fB\-\-format\fR \fI<FORMAT>\fR [default: json]
+Output format (`json` default, plus `yaml` / `toml` / `cbor`)
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+json
+.IP \(bu 2
+yaml
+.IP \(bu 2
+toml
+.IP \(bu 2
+cbor
+.RE
+.TP
+\fB\-o\fR, \fB\-\-output\fR \fI<OUTPUT>\fR
+Output file. Stdout if omitted (CBOR requires this flag — it is binary)
+.TP
+\fB\-\-pretty\fR
+Pretty\-print JSON / TOML output
+.TP
+\fB\-\-fail\-above\fR \fI<SCORE>\fR
+Fail the gate (exit code 2, the `check` "metric gate" convention) when the composite score is at or above this threshold. For use as a CI gate. The score is ordinal, so calibrate the threshold against the repository\*(Aqs own commit\-score distribution. The old `\-\-fail\-over` spelling stays a hidden alias for one release cycle
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help
+.TP
+[\fICOMMIT\fR] [default: HEAD]
+Commit / revision to score (any git revision spelling: a SHA, a tag, `HEAD`, `main~3`, …). Scored against its first parent. Mutually exclusive with `\-\-diff`

man/bca-vcs-trend.1

@@ -0,0 +1,43 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH BCA-VCS-TREND 1  "big-code-analysis 2.0.0" "big-code-analysis Manual"
+.SH NAME
+bca\-vcs\-trend \- Sample the change\-history metrics at several points in time and emit a per\-file time series, surfacing whether code is improving or degrading over the project\*(Aqs life. Each point re\-anchors at the mainline tip of that moment, so it is a faithful historical snapshot. Window / `\-\-ref` / bot / merge / rename / as\-of (the most\-recent anchor) and `\-\-top` (files kept) come from the parent `vcs` flags
+.SH SYNOPSIS
+\fBbca\-vcs\-trend\fR [\fB\-\-points\fR] [\fB\-\-span\fR] [\fB\-\-top\-deltas\fR] [\fB\-O\fR|\fB\-\-format\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-\-pretty\fR] [\fB\-h\fR|\fB\-\-help\fR] 
+.SH DESCRIPTION
+Sample the change\-history metrics at several points in time and emit a per\-file time series, surfacing whether code is improving or degrading over the project\*(Aqs life. Each point re\-anchors at the mainline tip of that moment, so it is a faithful historical snapshot. Window / `\-\-ref` / bot / merge / rename / as\-of (the most\-recent anchor) and `\-\-top` (files kept) come from the parent `vcs` flags
+.SH OPTIONS
+.TP
+\fB\-\-points\fR \fI<POINTS>\fR [default: 12]
+Number of evenly\-spaced sample points across `\-\-span`, inclusive of both endpoints (the oldest is `as\-of − span`, the newest is `as\-of`). Minimum 2, maximum 120 — the cap bounds the per\-point history walks on deep histories
+.TP
+\fB\-\-span\fR \fI<SPAN>\fR [default: 12mo]
+Total look\-back window the points span (`12mo`, `2y`, `52w`, `365d`, or ISO 8601 `P1Y`). With the default 12 points this yields roughly monthly snapshots over the past year
+.TP
+\fB\-\-top\-deltas\fR \fI<TOP_DELTAS>\fR [default: 10]
+Show only the top N files in each improving / regressing delta summary (`0` = all)
+.TP
+\fB\-O\fR, \fB\-\-format\fR \fI<FORMAT>\fR [default: json]
+Output format (`json` default, plus `yaml` / `cbor`). TOML is excluded — absent points serialize as `null`, which TOML cannot represent
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+json
+.IP \(bu 2
+yaml
+.IP \(bu 2
+cbor
+.RE
+.TP
+\fB\-o\fR, \fB\-\-output\fR \fI<OUTPUT>\fR
+Output file. Stdout if omitted (CBOR requires this flag — it is binary)
+.TP
+\fB\-\-pretty\fR
+Pretty\-print JSON output
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help

man/bca-vcs.1

@@ -0,0 +1,173 @@
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.TH BCA-VCS 1  "big-code-analysis 2.0.0" "big-code-analysis Manual"
+.SH NAME
+bca\-vcs \- Rank files by change\-history (VCS) risk: churn, commit and author counts, ownership dilution, and bug\- / security\-fix history over a git working tree. Errors clearly outside a repo
+.SH SYNOPSIS
+\fBbca\-vcs\fR [\fB\-p\fR|\fB\-\-paths\fR] [\fB\-I\fR|\fB\-\-include\fR] [\fB\-X\fR|\fB\-\-exclude\fR] [\fB\-l\fR|\fB\-\-language\fR] [\fB\-\-no\-skip\-generated\fR] [\fB\-\-paths\-from\fR] [\fB\-\-exclude\-from\fR] [\fB\-\-no\-ignore\fR] [\fB\-\-no\-config\fR] [\fB\-j\fR|\fB\-\-jobs\fR] [\fB\-\-exclude\-tests\fR] [\fB\-\-cyclomatic\-count\-try\fR] [\fB\-O\fR|\fB\-\-format\fR] [\fB\-o\fR|\fB\-\-output\fR] [\fB\-\-pretty\fR] [\fB\-\-long\-window\fR] [\fB\-\-recent\-window\fR] [\fB\-\-top\fR] [\fB\-\-file\-types\fR] [\fB\-\-ref\fR] [\fB\-\-full\-history\fR] [\fB\-\-include\-merges\fR] [\fB\-\-no\-follow\-renames\fR] [\fB\-\-no\-exclude\-bots\fR] [\fB\-\-bot\-pattern\fR] [\fB\-\-as\-of\fR] [\fB\-\-risk\-formula\fR] [\fB\-\-emit\-author\-details\fR] [\fB\-\-author\-hash\-key\fR] [\fB\-\-include\-deleted\fR] [\fB\-\-bus\-factor\-threshold\fR] [\fB\-\-no\-cache\fR] [\fB\-\-clear\-cache\fR] [\fB\-\-cache\-dir\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIsubcommands\fR]
+.SH DESCRIPTION
+Rank files by change\-history (VCS) risk: churn, commit and author counts, ownership dilution, and bug\- / security\-fix history over a git working tree. Errors clearly outside a repo
+.SH OPTIONS
+.TP
+\fB\-O\fR, \fB\-\-format\fR \fI<FORMAT>\fR
+Output format. When omitted, the human\-readable ranked `text` table is printed; pass `\-\-format text` to request it explicitly. `markdown` / `html` render a sortable report page like `bca report`; `json` / `yaml` / `toml` / `cbor` / `csv` emit structured data. `\-\-output\-format` is accepted as a deprecated alias
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+text: The human\-readable ranked table — the same output a bare `bca vcs` prints, now explicitly selectable so the human format is named and requestable everywhere
+.IP \(bu 2
+cbor
+.IP \(bu 2
+csv
+.IP \(bu 2
+json
+.IP \(bu 2
+toml
+.IP \(bu 2
+yaml
+.IP \(bu 2
+markdown
+.IP \(bu 2
+html
+.RE
+.TP
+\fB\-o\fR, \fB\-\-output\fR \fI<OUTPUT>\fR
+Output file. A change\-history report is a single whole\-repo document, so this names one file. Stdout if omitted (CBOR requires this flag — it is binary)
+.TP
+\fB\-\-pretty\fR
+Pretty\-print JSON / TOML output
+.TP
+\fB\-\-long\-window\fR \fI<LONG_WINDOW>\fR [default: 12mo]
+Long observation window (`12mo`, `2y`, `52w`, `365d`, or ISO 8601 `P1Y`). Accepted in the parent or subcommand position
+.TP
+\fB\-\-recent\-window\fR \fI<RECENT_WINDOW>\fR [default: 90d]
+Recent observation window. Accepted in the parent or subcommand position
+.TP
+\fB\-\-top\fR \fI<TOP>\fR [default: 50]
+Show only the top N files by risk score (`0` = all)
+.TP
+\fB\-\-file\-types\fR \fI<SCOPE>\fR
+Which tracked files to rank: `metrics` (only files bca has metrics for — the default), `all` (every tracked text file), or a comma\-separated extension allow\-list (`rs,py,toml`). Applied on top of `\-\-paths`/`\-\-include`/`\-\-exclude` (AND semantics). When omitted, the `bca.toml` `[vcs] file_types` key is used if present, else `metrics`. Setting it here replaces the manifest value
+.TP
+\fB\-\-ref\fR \fI<REFERENCE>\fR
+Revision to analyze (defaults to `HEAD`). Accepted in the parent or `trend` subcommand position, but rejected under `commit`, which names its commit positionally
+.TP
+\fB\-\-full\-history\fR
+Walk the full commit DAG rather than first\-parent only
+.TP
+\fB\-\-include\-merges\fR
+Include merge commits (skipped by default)
+.TP
+\fB\-\-no\-follow\-renames\fR
+Do not follow file renames across history
+.TP
+\fB\-\-no\-exclude\-bots\fR
+Do not exclude bot author identities
+.TP
+\fB\-\-bot\-pattern\fR \fI<BOT_PATTERN>\fR
+Override the bot\-author exclusion regex
+.TP
+\fB\-\-as\-of\fR \fI<AS_OF>\fR
+Reference "now" for reproducible runs (RFC 3339, `@unix`, or any git date spelling). Defaults to wall\-clock time
+.TP
+\fB\-\-risk\-formula\fR \fI<RISK_FORMULA>\fR [default: weighted]
+Composite risk\-score formula
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+weighted: Log\-scaled weighted sum with categorical bumps (default)
+.IP \(bu 2
+percentile: Per\-signal percentile rank within the analyzed set, averaged
+.RE
+.TP
+\fB\-\-emit\-author\-details\fR
+Emit SHA\-256\-hashed canonical author identities
+.TP
+\fB\-\-author\-hash\-key\fR \fI<KEY>\fR
+Secret key that hardens `\-\-emit\-author\-details` into a keyed HMAC\-SHA256: an attacker can no longer recover the emitted digests by hashing a candidate set of emails or with a precomputed email→hash table. Without it the digests are a bare SHA\-256 pseudonym. Requires `\-\-emit\-author\-details`; the same key yields the same digests across runs and a cache replay.
+
+Prefer the `BCA_AUTHOR_HASH_KEY` environment variable: a key on the command line is visible to other users via the process list (`ps`) and lands in shell history. The flag takes precedence when both are set.
+.TP
+\fB\-\-include\-deleted\fR
+Emit stats for files deleted at the target ref
+.TP
+\fB\-\-bus\-factor\-threshold\fR \fI<BUS_FACTOR_THRESHOLD>\fR [default: 0.5]
+Bus\-factor coverage (abandonment) threshold — the fraction of a directory\*(Aqs files that must be orphaned for the truck\-factor greedy removal to stop. Must be in `(0, 1)`; default `0.5` per Avelino. Ignored by `bca vcs commit`
+.TP
+\fB\-\-no\-cache\fR
+Disable the persistent change\-history cache for the file ranking: always walk fresh, and neither read nor write the cache. The cache otherwise reuses prior work on an unchanged tree and walks only new commits when `HEAD` has advanced
+.TP
+\fB\-\-clear\-cache\fR
+Remove this repository\*(Aqs cached history before ranking, forcing a full rebuild. Combine with `\-\-no\-cache` to wipe without re\-priming
+.TP
+\fB\-\-cache\-dir\fR \fI<CACHE_DIR>\fR
+Directory for the persistent history cache. Defaults to `$XDG_CACHE_HOME/big\-code\-analysis/vcs` (or the platform equivalent: `%LOCALAPPDATA%` on Windows, `~/.cache` otherwise)
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print help (see a summary with \*(Aq\-h\*(Aq)
+.SH "INPUT SELECTION"
+.TP
+\fB\-p\fR, \fB\-\-paths\fR \fI<PATHS>\fR
+Input files or directories to analyze. Unioned with any positional `[PATHS]`. Defaults to the current directory (`.`) when omitted and no manifest `paths` is set; an explicitly\-given path that does not exist is an error (exit 1)
+.TP
+\fB\-I\fR, \fB\-\-include\fR \fI<INCLUDE>\fR
+Glob to include files. Repeat the flag to add multiple globs (`\-I \*(Aq*.rs\*(Aq \-I \*(Aq*.toml\*(Aq`); each occurrence takes exactly one value, so a positional argument that follows is never swallowed. A leading `./` is optional: `dir/**` and `./dir/**` are equivalent
+.TP
+\fB\-X\fR, \fB\-\-exclude\fR \fI<EXCLUDE>\fR
+Glob to exclude files. Repeat the flag to add multiple globs (`\-X \*(Aq*.tmp\*(Aq \-X \*(Aq*.bak\*(Aq`); each occurrence takes exactly one value, so a positional argument that follows is never swallowed. A leading `./` is optional: `dir/**` and `./dir/**` are equivalent. CLI values are *merged with* (unioned, not a replacement for) any `bca.toml` `exclude` list and any `\-\-exclude\-from` patterns, so a CLI `\-\-exclude` never silently un\-excludes a directory the project config deliberately skipped. Pass `\-\-no\-config` to ignore the manifest entirely
+.TP
+\fB\-l\fR, \fB\-\-language\fR \fI<LANGUAGE>\fR
+Force a language instead of inferring from extension. Accepts a canonical language name (`rust`, `python`, `cpp`, …) or a file extension (`rs`, `py`, …). An unrecognized value is a hard error
+.TP
+\fB\-\-no\-skip\-generated\fR
+Disable auto\-skip of files marked as generated (e.g. `@generated`, `DO NOT EDIT`, `GENERATED CODE` near the top). By default the CLI skips such files so generated bindings do not skew metrics
+.TP
+\fB\-\-paths\-from\fR \fI<PATHS_FROM>\fR
+Read newline\-separated input paths from a file. Use `\-` to read from stdin. Combined as a union with any `\-\-paths` values; globs still apply. Blank lines are skipped; `#` is treated as a path character (not a comment). To pass a file literally named `\-`, use `./\-`
+.TP
+\fB\-\-exclude\-from\fR \fI<EXCLUDE_FROM>\fR
+Read additional `\-\-exclude` glob patterns from a file (one per line, `.gitignore`\-style). Blank lines and lines whose first non\-whitespace character is `#` are skipped. Use `\-` to read from stdin; to pass a file literally named `\-`, use `./\-`. Patterns are unioned with any `\-\-exclude` values into a single deny\-set; order does not matter. Convention is a `.bcaignore` at the repo root, mirroring `.gitignore` / `.dockerignore`
+.TP
+\fB\-\-no\-ignore\fR
+Disable `.gitignore` / `.ignore` / global gitignore awareness when expanding input directories. Explicit file paths are always honored regardless of this flag
+.TP
+\fB\-\-no\-config\fR
+Skip auto\-discovery of a `bca.toml` manifest. By default `bca` climbs from the working directory to the repo root looking for `bca.toml` and merges its keys *under* any explicit CLI flags. Pass this for raw, fully\-explicit invocations that must not pick up repo\-level config (e.g. a reproducible CI one\-liner). When no manifest is discovered this flag is a no\-op
+.SH "WALKER TUNING"
+.TP
+\fB\-j\fR, \fB\-\-jobs\fR \fI<N|auto>\fR [default: auto]
+Number of jobs.
+
+Defaults to the effective CPU count as reported by the OS (cgroup\-quota\- and cpuset\-aware on Linux). Pass an explicit integer or `auto` to override. `\-\-jobs 1` forces serial mode for debugging. `\-\-num\-jobs` is kept as a hidden alias for one release cycle and is slated for removal in the next major.
+.TP
+\fB\-\-exclude\-tests\fR
+Exclude inline test code from metric computation. Currently applies to Rust only (skips `#[test]`, `#[cfg(test)]`, `#[tokio::test]`, `#[rstest]`, `#![cfg(test)]` items and their subtrees). Default is off — every node is counted, so numbers stay byte\-for\-byte stable. Languages without a test\-subtree skip rule ignore this flag
+.TP
+\fB\-\-cyclomatic\-count\-try\fR[=\fI<BOOL>\fR]
+Whether Rust\*(Aqs `?` operator (the `try_expression` node) contributes to cyclomatic complexity (standard and modified). Defaults to `true` — `?` counts +1, matching upstream rust\-code\-analysis and every published metric value. Pass `\-\-cyclomatic\-count\-try=false` to treat `?` as linear error propagation — useful when cyclomatic is used as a maintainability gate that should not penalize fallible\-but\-linear code. Rust\-only: no other language emits the node, so the flag is inert elsewhere. Mirrors the `cyclomatic_count_try` manifest key; the CLI value overrides the manifest in either direction
+.br
+
+.br
+\fIPossible values:\fR
+.RS 14
+.IP \(bu 2
+true
+.IP \(bu 2
+false
+.RE
+.SH SUBCOMMANDS
+.TP
+bca\-vcs\-commit(1)
+Score a single commit for defect\-induction risk — the just\-in\-time (JIT) defect\-prediction unit a CI gate reviews at check\-in. Emits a JSON breakdown of size / diffusion / history / experience / purpose features, their contributions, and an ordinal composite score. Window / `\-\-ref` / bot / merge / rename behaviour comes from the parent `vcs` flags. The old `jit` spelling stays a hidden alias for one release cycle
+.TP
+bca\-vcs\-trend(1)
+Sample the change\-history metrics at several points in time and emit a per\-file time series, surfacing whether code is improving or degrading over the project\*(Aqs life. Each point re\-anchors at the mainline tip of that moment, so it is a faithful historical snapshot. Window / `\-\-ref` / bot / merge / rename / as\-of (the most\-recent anchor) and `\-\-top` (files kept) come from the parent `vcs` flags
+.TP
+bca\-vcs\-help(1)
+Print this message or the help of the given subcommand(s)