2026-07-04 — MCP client ergonomics planned (from the library session)

Discussion started as "optimize agent traversal of the knowledge graph," reframed by Fritz to the MCP-client perspective (Claude Code/Desktop as the main consumers). Key grounding: the 06-21 Leiden measurement — hub-and-spoke graph, computed graph queries mostly re-derive the index tree — so client headroom is turns and tokens, not graph algorithms.

Plan recorded + settled: /plans/mcp-client-ergonomics.md — W1 size-adaptive outline/#section fetch (8KB gate) · W3 per-session version+etag dedup · W2 mark_explore neighborhood card (doc + backlinks + outbound + siblings, 10/cap) · W4 tool-description strategy pass. D1–D4 all settled on recommendation (size-adaptive; full card; per-session; shared client/ slicing package). Deferred: client graph queries (Leiden re-test trigger), server FTS (separate lane), MCP resources/prompts (follow-up), lean tool profiles.

Pickup notes with repo pointers are in the plan (code: client/cmd/demarkus-mcp/main.go; new package beside client/{fetch,graph, links}). Next session in ~/latebit/demarkus starts at W1+W3.

(Same day, library side: v0.16.0 UX round + v0.17.0 pane-scroll-default merged and deployed — see /demarkus-library/journal/2026-07-03-ux.md and ADR 0007.)