Module impact 

Fallow Impact: local, opt-in value reporting.

Structs

AttributionInput

AuditRunRecord

Record an audit run into the rolling store.

CloneInput

ContainmentEvent

CrossRepoImpactReport

The cross-repo aggregate report (fallow impact --all --format json).

CrossRepoProjectEntry

One project’s row in the cross-repo roll-up.

CrossRepoTotals

Grand totals across every tracked project (including repos whose directory no longer exists on disk: their past wins still count toward lifetime impact).

FileFrontier

FindingInput

FrontierFinding

ImpactCounts

Per-category issue counts captured at a recorded run.

ImpactDigest

A due periodic value digest: the headline counters for “what has fallow done for you here”. Returned by take_due_digest at most once per DIGEST_INTERVAL_SECS per project.

ImpactRecord

ImpactReport

The rendered impact report, derived purely from the store (no analysis run).

ImpactStore

PendingContainment

ResolutionEvent

TrendSummary

A computed trend between the two most recent records.

Enums

CrossRepoImpactSchemaVersion

Independent wire-version for the cross-repo report, on its own cadence (it versions separately from the per-project ImpactReportSchemaVersion and the on-disk STORE_SCHEMA_VERSION).

CrossRepoSort

Ranking for the cross-repo rows.

EnabledSource

Why Impact tracking is (or is not) active for a project. Project = an explicit per-repo enable; User = the user-global default with no per-repo decision; Default = off (no per-repo decision and no global default).

ImpactReportSchemaVersion

Wire-version discriminator for ImpactReport. Independent from the global SchemaVersion (the impact report versions on its own cadence) and from the on-disk STORE_SCHEMA_VERSION (the persisted store shape versions separately). Serializes as a string const so JSON consumers can switch on it, matching the other independently-versioned envelopes (e.g. CoverageAnalyzeSchemaVersion).

ImpactTrendDirection

Direction of a count trend between two recorded runs.

Scope

Functions

aggregate

Build the cross-repo report by enumerating the config dir.

build_aggregate_report

Build the cross-repo aggregate from enumerated stores. Excludes enabled-but-empty projects from the rows (counted in project_count), sums totals over every tracked project, and sorts the rows by sort.

build_report

collect_clone_findings

Collect clone-group identities (fingerprint, instance paths) from a duplication report. The fingerprint is content-derived (dup:<hash>), so it is stable across pure relocation.

collect_complexity_findings

Collect line-independent complexity finding identities (path, function name) from a health report. The function name is line-independent, so a function moving within its file keeps the same identity.

collect_dead_code_findings

decline_onboarding

Persist that the local user declined the agent onboarding prompt. Writes only to the user store; nothing is written into the repo.

disable

Disable Impact tracking. Retains existing history. Returns whether it was newly disabled (false if already off). Also records the explicit decision, so declining the impact opt-in on a never-enabled project (impact disable) persists “asked and said no” for the agent skill.

enable

Enable Impact tracking for THIS project (an explicit per-repo decision that overrides the user-global default). Writes nothing into the repo: the store lives in the user config dir.

load

Load the store. Missing or unreadable files fall back to defaults; unreadable files are warned about rather than silently disabling tracking.

load_all

Enumerate every per-project store in <config-dir>/fallow/impact/, returning (project_key, store) pairs plus the count of files that failed to parse. Read-only; never writes. The global impact.json toggle is a sibling FILE of this dir (one level up), so it is naturally excluded. Corrupt/newer-schema files are skipped and counted, never substituted with a default store.

record_audit_run

record_combined_run

Record a whole-project combined run into the project track.

render_cross_repo_human

Render the cross-repo roll-up as human-readable text. limit caps the printed rows (grand totals always reflect every tracked project). Path-free: the CLI adds the single store-dir discoverability line, gated on !quiet.

render_cross_repo_json

Render the cross-repo report as JSON via the typed ImpactCrossRepo envelope.

render_cross_repo_markdown

Render the cross-repo roll-up as Markdown (paste-ready, path-free).

render_human

Render the report as human-readable text.

render_json

Render the report as JSON.

render_markdown

Render the report as Markdown (paste-ready for a PR description or standup).

reset

Delete THIS project’s store file. Returns whether a file was removed.

reset_all

Delete the whole per-project impact dir (<config-dir>/fallow/impact/). Does NOT touch the global default toggle (impact.json): a data wipe should not silently re-disable an opt-in the user made. Returns whether the dir was present and removed.

resolved_project_key

The resolved (worktree-collapsed) project key for root, for display.

resolved_store_path

The resolved per-project store-file path for root, for status display (so a wrong key is debuggable). None when no config dir is resolvable.

set_global_default

Set the user-global default. Returns whether the value changed.

store_dir

The per-project store directory (<config-dir>/fallow/impact/), for the impact --all human discoverability footer. None when no config dir.

take_due_digest

Return the periodic value digest when it is due, stamping the store so the next one is at least DIGEST_INTERVAL_SECS away. Due means: tracking is enabled, there is non-zero value to report (anti-nag: a zero digest never surfaces), and the previous digest is older than the interval (or never happened). Best-effort like the rest of the store: a clean run that drops the emitted step simply defers the digest to the next interval.