handoff-distilllisted

# handoff-distill ## Purpose Distill the current session — or a named past chat — into one canonical handoff block: decisions, evidence-backed completions, open items, exact absolute paths, verification state, and a paste-ready next-session prompt. The block is the deliverable; write a file only when the user asks for one. The point is that the next session can start cold and lose nothing. ## Triggers Invoke on any of: `handoff` · `distill this session` · `prep next session` · `session handoff` · `handoff block`. ## Provenance rule Only these count as ground truth: explicit user statements, executed tool output visible in the thread, and files/artifacts actually produced. Assistant recommendations, drafts, and plans are `PROPOSED` — never promoted to `DECIDED` or `DONE` without a user commitment in a human turn. Hypotheticals stay hypothetical. This rule governs every row of the template. The assistant's memory of "done" is unreliable; only evidence visible in-thread makes something Completed. A positive user reaction to a suggestion ("nice", "sounds good") is not a commitment unless it clearly adopts the item. ## Workflow 1. **Scope.** Default = the current conversation; no search needed. If the user names another chat: run `conversation_search` with content nouns from their reference (not meta-words like "chat" or "yesterday"); open the best hit via `read_conversation` with that hit's `page_token`; page adjacent turns only; ≤2 chats total. If the reference is too v