Module narrowing 

Hierarchical narrowing middleware.

Implements a three-phase progressive-disclosure strategy:

1. tree — build a directory map of the project
2. skeleton — extract signatures from candidate files
3. targeted read — return only the relevant function/range

This reduces token usage versus reading entire files by ~75%.

Structs

HierarchicalNarrowing

Hierarchical narrowing engine.

NarrowingQuery

Query parameters for hierarchical narrowing.

NarrowingResult

A single result from hierarchical narrowing.

Enums

NarrowingError

Errors produced by HierarchicalNarrowing.

Functions

file_score

Score a file path by the proportion of query words that appear in it.

symbol_score

Score a skeleton line by query word overlap.