Instanzmanager: Weboberflaeche kennt Instanzen, geordnetes Ende, Puls (#528, #531)

Weboberflaeche (#531): X-Instanz an der einen fetch-Stelle, Instanzauswahl in der
Kopfzeile, Verwaltungsansicht mit Anlegen/Starten/Anhalten/Fenster, Herkunft der
Ereignisse, Sicherungs- und Einstellungsansicht. 402/409/502 werden eigen behandelt.

Sicherungen im Manager (#530): Auflisten, Anlegen, Wiederherstellen, Loeschen. Das
Zurueckspielen haelt die Instanz vorher an und startet sie danach wieder.

Geordnetes Ende (Konzept 9.8). Zwei Befunde waren der Anlass:

Der Manager konnte eine Instanz MIT FENSTER nie geordnet beenden.
Control.ShutdownRequested war nur in HeadlessRun verdrahtet, nicht in der
Avalonia-Anwendung - und ein Fenster ist die Vorgabe. Die Bitte wurde mit 202
beantwortet, niemand hoerte zu, und der Manager schoss den Prozess nach Ablauf
seiner Frist jedes Mal ab.

InstanceSupervisor.StopAsync hielt Socket-Schweigen fuer einen Todesnachweis und
meldete "beendet", ohne den Prozess anzufassen. Bei einer verstummten Instanz ist
der Socket von vornherein still - der Neustart haette einen zweiten Prozess auf
dieselbe state.db gesetzt. Genau der Schaden, gegen den #528 gebaut ist.

- ShutdownCoordinator: erst die Tuer schliessen, dann auf offene Arbeiten warten,
  Frist zwei Minuten. Vorher brach TaskScanner.DisposeAsync mitten in ProcessAsync
  ab, sodass die Aufgabe bis zum Lease-Ablauf auf "running" stehenblieb.
- GET /api/instanz/puls hinter dem Socket-Gate: Phase und offene Arbeiten. Weiter
  gefragt statt gemeldet - ein Puls, den die Instanz von sich aus schickt, fehlt
  genau dann, wenn sie haengt.
- Eskalationsleiter: drei Durchgaenge ohne Antwort, einmal um ein Ende bitten,
  nach 30s beenden und den Vollzug abwarten, gemeldet als Absturz.
- EnsureDeadAsync vor jedem Start.

Weiteres aus dem Review:
- .gitignore verankert: "Instances/" passte auch auf src/ClawdDotNet.Core/Instances/.
  InstanceEndpoint.cs und InstanceLayout.cs waren dadurch nie eingecheckt.
- Das WebUI-Token stand im Protokoll des Managers. Konsole ja, Datei nein.
- Ein Klick auf "Instanz anlegen" loeste requestSubmit() zweimal aus.
- [Obsolete] auf WebServerPort wieder entfernt: sechs Warnungen, die niemand
  abstellen konnte, solange E-M5 nicht fertig ist.
- Die Wiederherstellung bricht nicht mehr ab, wenn der Browser weggeht.
- Entwicklungspfade zum Instanzmanager aus Segmenten statt mit Rueckstrichen, und
  der Port kommt aus manager.json statt fest aus der Zeile.

Offen und gemeldet: --managed hebelt die Lizenzpruefung aus (#535).

806 Tests gruen, 0 Warnungen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

src/ClawdDotNet.Core/Engine/AgentEngine.cs

@@ -145,10 +145,16 @@ public sealed class AgentEngine : IAgentMessageRouter, Staging.IFrozenCallExecut
         string? taskId = null,
         DelegationChain? delegation = null)
     {
+        // Vor allem anderen: Endet die Instanz gerade, faengt hier nichts Neues mehr an.
+        if (RefuseWhileShuttingDown(agentConfig) is { } zu)
+            return zu;
+
         // Vor der ersten Anfrage prüfen — ein erschöpftes Budget soll gar nichts kosten.
         if (await CheckBudgetAsync(agentConfig, externalCt) is { } denied)
             return denied;
 
+        using var lauf = TrackRun();
+
         var runId = Guid.NewGuid().ToString("N");
         var chain = delegation ?? DelegationChain.Root(agentConfig.AgentId);
         var result = await RunCoreAsync(agentConfig, userMessage, instanceId, externalCt, runId, source, chain);
@@ -340,9 +346,14 @@ public sealed class AgentEngine : IAgentMessageRouter, Staging.IFrozenCallExecut
         string? taskId = null,
         DelegationChain? delegation = null)
     {
+        if (RefuseWhileShuttingDown(agentConfig) is { } zu)
+            return zu;
+
         if (await CheckBudgetAsync(agentConfig, externalCt) is { } denied)
             return denied;
 
+        using var lauf = TrackRun();
+
         var runId = Guid.NewGuid().ToString("N");
         var chain = delegation ?? DelegationChain.Root(agentConfig.AgentId);
 
@@ -630,6 +641,63 @@ public sealed class AgentEngine : IAgentMessageRouter, Staging.IFrozenCallExecut
         get { lock (_lock) return _runningChats.Count; }
     }
 
+    // ─── Geordnetes Ende (#528) ───
+
+    private int _openRuns;
+    private int _accepting = 1;
+
+    /// <summary>
+    /// Wie viele Agentenläufe gerade laufen — Chats <em>und</em> angestoßene Läufe.
+    ///
+    /// <para>Nicht dasselbe wie <see cref="RunningChatCount"/>: Der zählt <em>Agenten</em>
+    /// mit mindestens einem Chat, dieser zählt <em>Läufe</em>. Fürs Herunterfahren ist der
+    /// Lauf die Einheit — zwei Läufe desselben Agenten sind zwei Dinge, die zu Ende kommen
+    /// müssen.</para>
+    /// </summary>
+    public int OpenRunCount => Volatile.Read(ref _openRuns);
+
+    /// <summary>Nimmt die Engine noch neue Läufe an?</summary>
+    public bool IsAcceptingWork => Volatile.Read(ref _accepting) == 1;
+
+    /// <summary>
+    /// Schließt die Tür: ab jetzt kein neuer Lauf mehr.
+    ///
+    /// <para>Laufende werden <b>nicht</b> abgebrochen — das ist der ganze Punkt. Wer sie
+    /// abbrechen will, hat dafür <c>AbortChat</c>.</para>
+    /// </summary>
+    public void StopAccepting() => Volatile.Write(ref _accepting, 0);
+
+    private AgentRunResult? RefuseWhileShuttingDown(AgentConfig agentConfig)
+        => IsAcceptingWork
+            ? null
+            : new AgentRunResult(
+                agentConfig.AgentId, AgentRunStatus.ShuttingDown,
+                "[Die Instanz endet gerade — es werden keine neuen Läufe mehr angenommen]",
+                0, 0, TimeSpan.Zero);
+
+    /// <summary>
+    /// Zählt einen laufenden Lauf, solange sie lebt.
+    ///
+    /// <para>Als <c>using</c>-Wert statt als <c>try/finally</c> von Hand, weil beide
+    /// Einstiege mehrere Rückgabewege haben und ein vergessener Weg den Zähler dauerhaft
+    /// verschöbe — eine Instanz, die dann nie mehr enden könnte, weil ein Lauf zu Buche
+    /// steht, den es nicht gibt.</para>
+    /// </summary>
+    private RunScope TrackRun() => new(this);
+
+    private readonly struct RunScope : IDisposable
+    {
+        private readonly AgentEngine _engine;
+
+        public RunScope(AgentEngine engine)
+        {
+            _engine = engine;
+            Interlocked.Increment(ref engine._openRuns);
+        }
+
+        public void Dispose() => Interlocked.Decrement(ref _engine._openRuns);
+    }
+
     /// <summary>
     /// Momentaufnahme des Konversationskontexts eines Agenten — also der Nachrichten,
     /// die beim nächsten Schritt tatsächlich an das Modell gehen.