Epic: Agent harness integrations and handoffs #17

Goal

Agent memory beyond Claude Code: Cursor and Hermes Agent get the same start-up context and session capture, and any agent can leave a handoff that the next session in the same project claims exactly once.

Milestone: v0.2 Agents. Builds on the merged MVP (#1): src/agents/claude-code.ts, MCP server, wiki + git versioning.

Issues

After #35 merges, #36, #37 and #38 can run in parallel. #36 and #37 each add one line to HOOK_HANDLERS (trivial conflict: keep both).

Related docs chore (not part of this epic): #39 README update.

Evidence

• Cursor hooks: https://cursor.com/docs/agent/hooks; transcript JSONL shape inspected locally (structure only).
• Hermes shell hooks: https://hermes-agent.nousresearch.com/docs/user-guide/features/hooks and the installed v0.18.2 source (agent/shell_hooks.py, agent/turn_context.py, agent/turn_finalizer.py).
• Handoffs claimed once: https://github.com/akitaonrails/ai-memory; conditional-update claim validated locally with two SQLite connections.
• Do not proxy a user's Claude Code/Cursor subscription login as a backend for bots; the harness pulls context from Waymark, never the reverse.

Deferred (not in this milestone)

• LLM consolidation of sessions into readable pages (opt-in, needs a model provider).
• Cross-machine handoff locking (needs the server work in Epic: Permissions, auth and remote access #18).
• Sub-agent transcripts (Cursor subagents/, Hermes subagent_stop).
• install commands that edit harness config files.

Definition of done

• waymark hook claude-code|cursor|hermes all inject start-up context and capture sessions, tagged by harness.
• A handoff created from one harness is listed at start-up in another harness in the same project and can be claimed once; a second claim fails.
• Docs: docs/cursor.md, docs/hermes.md, handoffs section in docs/mcp.md.