staleness

Documentation

Overview

Package staleness detects map-quality advisory findings: uncovered paths, dead module rules, and stale reviewed_at timestamps.

All findings carry kind "advisory" and never contribute to gate verdicts.

Index

• func Check(g *graph.Graph, cfg config.StalenessConfig, now time.Time) []finding.Finding

Functions

func Check

func Check(g *graph.Graph, cfg config.StalenessConfig, now time.Time) []finding.Finding

Check inspects the graph against the module map and returns advisory findings for any of the three staleness conditions:

• "map/uncovered_path": a package or file node has no matching module paths glob.
• "map/dead_rule": a module paths glob matches zero graph nodes.
• "map/stale_review": a module's reviewed_at is set and older than threshold.

Returns nil when cfg.Enabled is false.