# v0.25.10 — Robustness Hardening

## What Changed

Four reliability improvements that prevent the cascade failure pattern where a stuck git rebase takes down an entire agent for days:

1. **GitSync pre-flight recovery** — Before every pull, git-sync now checks for stuck rebases and detached HEAD states. If found, it automatically aborts the rebase and re-attaches to the main branch. Previously, a stuck rebase from an interrupted pull would silently block all future syncs.

2. **ServerSupervisor git state healing** — The supervisor's preflight self-heal now detects and aborts stuck git rebases before spawning the server. This catches the problem even earlier in the startup chain.

3. **Wider slow-retry window** — The circuit breaker's slow-retry mode now uses a 60-second detection window (up from 10 seconds). The old window was so narrow that retries could be missed entirely if health check timing didn't align with the 2-hour boundary.

4. **AgentRegistry sync lock retries** — Synchronous registry operations now retry up to 5 times with exponential backoff when encountering lock contention. Previously, sync lock acquisition had zero retries and would fail immediately, causing constant heartbeat errors on machines running multiple agents.

5. **Shell detection fix** — The supervisor's shell execution helper now uses the SHELL environment variable instead of hardcoding /bin/sh, which could fail in certain environments.

## What to Tell Your User

We fixed a reliability issue where a stuck git rebase could take down an agent for days. The system now automatically detects and recovers from stuck rebases, and the retry logic is more resilient. If you've seen agents go stale and not recover, this update addresses that.

## Summary of New Capabilities

- Automatic recovery from stuck git rebases during sync and server startup
- More reliable agent registry operations under concurrent access from multiple agents
- Wider retry windows so the circuit breaker doesn't silently miss recovery attempts
- Better shell compatibility across different environments
