sparkles:fuzzy

sparkles:fuzzy is the bounded compute core for interactive file and symbol pickers. It parses a query into fuzzy terms and metadata constraints, analyzes Unicode text with source-byte provenance, admits typo-tolerant matches through an exact witness, ranks them deterministically, and advances immutable corpora in clock-free chunks.

The library does not read files, clocks, git state, cancellation flags, or an event loop. Callers provide fixed workspaces and concrete metadata; hue owns snapshots, scheduling, persistence, and presentation.

Documentation

• Tutorial: build a small file search
• How-to: run a chunked, paginated search
• Reference: public API and capacities
• Explanation: admission, scoring, and ownership
• Benchmark baseline and methodology

The specification is normative and the delivery plan records its verification gates.