Plan 2: feature_resume brief + GH thread mutations (3.1.0)

[ashmitb95]

Summary

• One-shot session-start primitive: canopy resume <alias> / mcp__canopy__feature_resume(alias) resolves the alias → switches the canonical slot if needed → refreshes GitHub + Linear → returns a structured brief with intent_hints for the most likely next actions.
• Canopy can finally close + reply to GH review threads: new GraphQL helpers in integrations/github.py plus first-class canopy resolve <thread_id> / canopy reply <thread_id> [--resolve] verbs and MCP tools. commit --address optionally takes the round-trip all the way through with --resolve-thread.
• switch now bumps last_visit on every successful switch and embeds a counts-only since_last_visit_summary in its return — the agent sees "something changed" without a full resume round-trip.

Bumps canopy to 3.1.0 (Plan 1 shipped 3.0.0). Adds 13 modules / extends 8 / adds 67 MCP tools total.

What changed

CLI

• canopy resume <alias> [--json] [--reset-anchor] — the full brief
• canopy resolve <thread_id> [--feature] [--json] — close a GH thread + log locally
• canopy reply <thread_id> [--body | --body-file | stdin] [--resolve] [--feature] [--json]
• canopy commit --address <id> [--resolve-thread | --no-resolve-thread] — round-trip the addressing commit through the thread

MCP

• feature_resume(alias) — full brief
• resolve_thread(thread_id, feature?)
• reply_to_thread(thread_id, body, feature?, resolve_after?)

State files (new, atomic temp+rename)

• .canopy/state/visits.json — {feature: {last_visit, previous_visit}}
• .canopy/state/thread_resolutions.json — {thread_id: {resolved_by_canopy_at, feature, via_command, via_commit_sha}} (used so the brief can attribute by_canopy: true on threads_resolved_on_github)

Augment

• [augments] auto_resolve_threads_on_address = true — make commit --address --resolve-thread the default

Modules added

• actions/last_visit.py, actions/resume.py, actions/thread_actions.py, actions/thread_resolutions.py

Extended

• integrations/github.py — GraphQL: list_review_threads, resolve_thread, unresolve_thread, reply_to_thread. Every comment from get_review_comments now carries thread_id and author_type (derived from GraphQL __typename).
• actions/switch.py — mark_visited after write_state; since_last_visit_summary embedded in return (uses prior anchor, set to degraded: true on GH failure).
• actions/commit.py — --resolve-thread hooks into the new GH GraphQL + writes attribution to thread_resolutions.json.
• Bundled using-canopy and augment-canopy skills, plus CLAUDE.md, docs/concepts.md, docs/commands.md, docs/mcp.md, docs/agents.md, CHANGELOG.md.

Plan + protocol

• Plan file: /Users/ashmit/.claude/plans/2026-05-28-feature-resume-brief.md (18 tasks across foundation + compound action).
• Executed subagent-driven, one implementer per task; three milestone code reviews with fix commits along the way (c2ad0c3, dc78643, 1dbfe94).
• Depends on Plan 1's slot model (3.0.0) — slot model must ship before this.

Test plan

• 857 tests passing locally (pytest tests/ — baseline 754 on main)
• No regressions in existing suites (tests/test_switch.py, tests/test_commit.py, tests/test_github.py paths)
• CLI smokes: canopy resume --help, canopy resolve --help, canopy reply --help all show the new subparsers
• Real GH integration smoke — run canopy resume DOC-xxxx against the docsum workspace, verify the brief carries actual PR/thread data
• Switch round-trip — canopy switch X → switch Y → resume Y (canonical) advances last_visit once per resume; the previous_visit field reflects the prior anchor
• commit --address --resolve-thread — pick a bot comment, run it end-to-end, verify the GH thread closes + thread_resolutions.json records via_command: "commit_address" + via_commit_sha
• Augment default — set auto_resolve_threads_on_address = true, verify commit --address <id> auto-resolves without the flag