Context
From code review of #21 (multi-spec comparison feature).
Current Behavior
If Finalize fails during the rebase/merge operation (internal/variants/manager.go:458), the repository could be left in an inconsistent state. The error handling in cmd/orbit/finalize.go:131-138 provides some guidance, but recovery steps aren't fully documented.
Suggested Improvements
- Add detailed recovery instructions to error messages
- Document manual recovery steps in README or help text
- Consider adding a
orbit recover command for common failure scenarios
- Potentially wrap rebase in a transaction-like pattern with automatic rollback
Priority
Low - failures are rare and users can recover manually with git knowledge.
Context
From code review of #21 (multi-spec comparison feature).
Current Behavior
If
Finalizefails during the rebase/merge operation (internal/variants/manager.go:458), the repository could be left in an inconsistent state. The error handling incmd/orbit/finalize.go:131-138provides some guidance, but recovery steps aren't fully documented.Suggested Improvements
orbit recovercommand for common failure scenariosPriority
Low - failures are rare and users can recover manually with git knowledge.