Module impact 

Fallow Impact: local, opt-in value reporting.

Structs

AttributionInput

AuditRunRecord

Record an audit run into the rolling store.

CloneInput

ContainmentEvent

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

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

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.

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 and ensure .fallow/ is gitignored.

load

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

record_audit_run

record_combined_run

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

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).

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.