handoff

Manage a Claude Code ↔ Pi handoff in the current git worktree. Parse $ARGUMENTS as exactly one of:

• pi [--next "<exact next action>"] or claude [--next "<exact next action>"] — create a planned handoff to that harness.
• resume <checkpoint-id> [--acknowledge-degraded] — acquire and continue a checkpoint in the current harness.
• recover --from <claude|pi> --source-stopped — salvage deterministic workspace state after the source harness has stopped unexpectedly.
• close <checkpoint-id> — end the lease and retain the closed checkpoint for normal cleanup.

Reject any other arguments with a short usage message.

Preflight

Run once before planned checkpoint creation. Resume, recovery, and close use the exact single-pipeline forms below because the ownership hook permits only those lifecycle commands through an active or released lease:

command -v swe-workbench-handoff >/dev/null 2>&1 || {
  echo "swe-workbench handoff runtime is not on PATH — reinstall or update the plugin." >&2
  exit 1
}
command -v swe-workbench-result-check >/dev/null 2>&1 || {
  echo "swe-workbench result checker is not on PATH — reinstall or update the plugin." >&2
  exit 1
}

Never export, copy, summarize from, or persist a native Claude/Pi transcript. Never include environment values, credentials, arbitrary messages, raw tool output, patches, or file bodies in handoff state.

Planned handoff: pi or claude

1. Build one JSON object with this exact top-level shape:

   {
     "operation_id": "new UUID",
     "source_harness": "claude or pi",
     "target_harness": "pi or claude",
     "source_session_ref": "current session reference when known",
     "semantic": {
       "goal": "bounded summary",
       "constraints": ["bounded strings"],
       "decisions": ["bounded strings"],
       "progress": {"done": ["bounded strings"], "in_progress": ["bounded strings"]},
       "changed_path_intents": {"relative/path": "intent only, never content"},
       "verification": [{"command": "bounded command", "label": "bounded label", "exit_status": 0, "timestamp": "ISO-8601 timestamp", "result": "bounded status"}],
       "blockers": ["bounded strings"],
       "risks": ["bounded strings"],
       "exact_next_action": "one executable next action"
     }
   }