feat(worker): Handler-Session nach Usage-Limit-Reset automatisch neu starten

Eine List-Handler-ConPTY-Session, die mitten in einer Phase stirbt, war bisher
ein stilles totes Tile: InteractiveTerminalViewModel.OnSessionProcessExited
setzte nur bei einem Tod innerhalb des 5s-Grace-Fensters ein sichtbares Banner.

Neu:
- HandlerRoundState (JSON unter ~/.claudeDo/handler-rounds.json, keine
  EF-Migration): Phase + Task-Set der laufenden Runde, geschrieben von
  BuildForMergeHelperAsync ("triage") und BuildForMergeHelperHandoffAsync.
  Ohne das existieren beide nur im transienten HandoffRequested-Broadcast.
- HandlerRestartCoordinator: entscheidet den Neustart, fail-closed. Beleg fuer
  "war das Usage-Limit" ist FiveHour.Utilization >= 95 zum Todeszeitpunkt --
  eine ConPTY-Session hat kein stdout, TaskRunner.IsUsageLimitMessage hat hier
  nichts zu lesen. Nur bei PowerUse (beide Keys), max ein Neustart pro Runde,
  Warten bis FiveHour.ResetsAt, dann HandoffRequested erneut broadcasten.
  Verbraucht kein Handoff-Budget (HandoffRoundTracker.Register wird nicht
  angefasst). WorkerLog-Zeilen beim Tod und beim Neustart.
- Ui meldet den Exit-Code (nur dort bekannt) via
  WorkerHub.ReportInteractiveSessionExited, ohne selbst zu filtern.

Sibling zu UsageLimitAutoContinueCoordinator, kein Umbau davon: der sieht nur
headless Runs.
This commit is contained in:
mika kuns
2026-09-02 19:17:51 +02:00
parent 20b3b4ce2b
commit 016b9203f8
18 changed files with 843 additions and 12 deletions
@@ -49,4 +49,54 @@ public class InteractiveTerminalViewModelTests
Assert.True(terminal.HasExited);
Assert.Null(terminal.StartError);
}
// ── ExitedAfterStartup (a session that ran, then broke -- used to be a silent dead tile;
// the worker turns it into a usage-limit auto-restart for list handlers) ───────────────────
[Fact]
public void ProcessExitsNonzero_AfterRunningAWhile_RaisesExitedAfterStartup()
{
using var terminal = NewTerminalExitingAfter(TimeSpan.FromMinutes(90));
int? reported = null;
terminal.ExitedAfterStartup += code => reported = code;
terminal.OnSessionProcessExited(null, 1);
Assert.Equal(1, reported);
}
[Fact]
public void ProcessExitsNonzero_WithinGraceWindow_DoesNotRaiseExitedAfterStartup()
{
using var terminal = new InteractiveTerminalViewModel(() => LaunchedAt);
terminal.IsRunning = true;
var raised = false;
terminal.ExitedAfterStartup += _ => raised = true;
terminal.OnSessionProcessExited(null, 1);
Assert.False(raised);
Assert.NotNull(terminal.StartError); // still the startup-failure banner
}
[Fact]
public void ProcessExitsZero_AfterRunningAWhile_DoesNotRaiseExitedAfterStartup()
{
using var terminal = NewTerminalExitingAfter(TimeSpan.FromMinutes(90));
var raised = false;
terminal.ExitedAfterStartup += _ => raised = true;
terminal.OnSessionProcessExited(null, 0);
Assert.False(raised);
}
private static InteractiveTerminalViewModel NewTerminalExitingAfter(TimeSpan uptime)
{
var callCount = 0;
var terminal = new InteractiveTerminalViewModel(
() => callCount++ == 0 ? LaunchedAt : LaunchedAt + uptime);
terminal.IsRunning = true; // records LaunchedAt via the first clock call
return terminal;
}
}