Module score 

Project navigability score (0–100) and its estimated token-cost (“quality tax”).

Higher score = easier for an agent to navigate = lower token cost. The score is a pure function of aggregated structural inputs (how many functions exceed the cognitive threshold, the worst offender, import cycles) so it is deterministic and unit-testable. All surfaces (watch, dashboard, ctx_metrics, ctx_quality) read this one score.

Structs

Hotspot

A single complexity hotspot surfaced to the agent.

NavigabilityInputs

Inputs for navigability. Behavioral inputs (wasted_tokens) and pricing are supplied by the caller so this stays a pure function. Copy (all fields are Copy, including the borrowed hotspot slice) so it passes by value cheaply.

NavigabilityScore

Project-level navigability summary.

Functions

grade

Letter grade for a navigability score, for compact display.

navigability

Compute the navigability score from aggregated inputs. Deterministic.