recover-stalled-subagent

What problem does it solve?

The recovery operator tool salvages uncommitted work from a stalled initiative-executor subagent by creating a durable WIP commit on the remediation branch and cleanly removing its worktree, ensuring durable progress is preserved for orchestration.

Core Features & Use Cases

• Validate that a subagent's worktree is recoverable and bound to remediation/<id>, then stage and commit local changes as a WIP with an informative message.
• Push the recovered work to origin when needed and emit a STATE_HANDOFF block for downstream planning, enabling retry, defer, or hand-off decisions.
• Safely remove the worktree and avoid deleting the remediation branch, while providing guardrails to prevent data loss and ensure reproducible recovery outcomes.

Quick Start

Provide the target remediation branch name to begin the recovery process.