v0.7.0
The folding release: fold a long file down to just the parts that matter — driven by the agent as it explains, or by hand.
focus — the agent folds the file to what it's explaining
Fifth MCP tool, for guided walkthroughs: focus {file, regions: [{start, end}, …]} switches the pane to that file's source view, lands on the first region, and collapses everything between the regions into ⋯ N lines folded ⋯ pills. Call it again to refocus; an empty regions array clears the agent's focus without moving your cursor. You're never trapped: pills expand with Enter or a click, and a later goto into a folded stretch auto-expands it. Annotations hidden by a fold show up as a note badge on the pill (⋯ 24 lines folded · 1 note ⋯) and ride back with the verdict regardless.
f / F — fold it yourself
In source view, f folds the visual selection — or, with no selection, the indentation block under the cursor line: f on a def/fn header tucks the body away while the signature stays visible (multi-line signatures included; the closing ): / ) -> … { folds with the body). F reveals the whole file. Manual and agent-driven folds share one engine: touching folds merge into a single pill, and expanding a merged pill reveals everything it covered. The block detection is indentation-based and language-agnostic by design — for layouts it doesn't recognize, select the lines and f folds exactly those.
Sturdier guided navigation
Gotos that arrive while you're typing a comment are now queued and replayed in order once the box closes (previously only the latest survived, which could silently drop an earlier focus). A focus whose regions miss the file entirely folds nothing and moves nothing.
127 tests. Wire-compatible with 0.6.x (protocol v2; focus rides an optional field on the goto frame, older panes simply ignore it). Docs moved to docs/ — the README is now just the pitch and quick start. Install/update: herdr plugin install JonasBaeumer/herdr-file-annotator
Full Changelog: v0.6.1...v0.7.0