Merge branch 'main' into feat/poweruse-list-handler

Kollision mit #264 (Handoff-Budget im Brief sichtbar machen): beide Seiten haben
HandoffRoundTracker, HandoffMcpTools und InteractiveLaunchSpecService angefasst.

Der Konflikt war inhaltlich, nicht nur textuell. #264 liest den Cap an zwei
Stellen aus der Konstante (GetStatus und das roundInfo-Rendering), waehrend
dieser Branch ihn zum Parameter aus app_settings gemacht hat. Ein reiner
Text-Merge haette kompiliert und trotzdem gelogen: Register haette den
konfigurierten Cap durchgesetzt, waehrend der Brief dem Modell weiter "2 Runden
uebrig" gemeldet haette, obwohl es 39 hat.

Aufgeloest so, dass der Cap eine einzige Quelle hat:
- GetStatus(taskId, maxHandoffs) nimmt den Cap als Parameter, mit demselben
  Clamp wie Register. Die Rechnerei liegt damit an einer Stelle.
- GetHandoffStatus liest das Setting und gibt es weiter.
- Das roundInfo-Rendering benutzt GetStatus statt eigener Arithmetik.

Zwei Tests nageln genau diesen Drift fest, damit er beim naechsten Merge nicht
unbemerkt zurueckkommt: einer auf GetHandoffStatus, einer auf den Brief.

MaxHandoffs -> DefaultMaxHandoffs in #264s vier Test-Referenzen; die laufen alle
mit Default-Settings, die Semantik bleibt.
This commit is contained in:
Mika Kuns
2026-09-02 15:48:43 +02:00
41 changed files with 2323 additions and 225 deletions
+1 -2
View File
@@ -408,8 +408,7 @@ public sealed class BatchMcpToolsTests : IDisposable
var listId = await SeedListAsync();
var predecessor = await SeedTaskAsync(listId, "predecessor", TaskStatus.Idle);
var task = await SeedTaskAsync(listId, "blocked", TaskStatus.Queued);
task.DependsOnTaskId = predecessor.Id;
await _tasks.UpdateAsync(task);
await _ctx.SeedDependsOnAsync(task.Id, predecessor.Id);
var sut = BuildSut();
var results = await sut.BatchGetTasks(new[] { task.Id }, cancellationToken: CancellationToken.None);
@@ -118,6 +118,10 @@ public sealed class ExternalMcpServiceTests : IDisposable
return id;
}
// The dependency set has no defined order, and the ids are random GUIDs -- sort both sides.
private static List<string> Sorted(params string[] ids) => ids.OrderBy(x => x).ToList();
private static List<string> Sorted(IEnumerable<string> ids) => ids.OrderBy(x => x).ToList();
private async Task<TaskEntity> SeedTaskAsync(
string listId, string title = "t", TaskStatus status = TaskStatus.Idle, string? parentId = null)
{
@@ -444,8 +448,7 @@ public sealed class ExternalMcpServiceTests : IDisposable
var listId = await SeedListAsync();
var predecessor = await SeedTaskAsync(listId, status: TaskStatus.Idle);
var task = await SeedTaskAsync(listId, status: TaskStatus.Queued);
task.DependsOnTaskId = predecessor.Id;
await _tasks.UpdateAsync(task, CancellationToken.None);
await _ctx.SeedDependsOnAsync(task.Id, predecessor.Id);
var sut = BuildSut(CreateQueue());
var dto = await sut.GetTask(task.Id, CancellationToken.None);
@@ -460,8 +463,7 @@ public sealed class ExternalMcpServiceTests : IDisposable
var listId = await SeedListAsync();
var predecessor = await SeedTaskAsync(listId, status: TaskStatus.Done);
var task = await SeedTaskAsync(listId, status: TaskStatus.Queued);
task.DependsOnTaskId = predecessor.Id;
await _tasks.UpdateAsync(task, CancellationToken.None);
await _ctx.SeedDependsOnAsync(task.Id, predecessor.Id);
var sut = BuildSut(CreateQueue());
var dto = await sut.GetTask(task.Id, CancellationToken.None);
@@ -478,8 +480,7 @@ public sealed class ExternalMcpServiceTests : IDisposable
var listId = await SeedListAsync();
var predecessor = await SeedTaskAsync(listId, status: TaskStatus.Idle);
var task = await SeedTaskAsync(listId, status: TaskStatus.Idle);
task.DependsOnTaskId = predecessor.Id;
await _tasks.UpdateAsync(task, CancellationToken.None);
await _ctx.SeedDependsOnAsync(task.Id, predecessor.Id);
var sut = BuildSut(CreateQueue());
var dto = await sut.GetTask(task.Id, CancellationToken.None);
@@ -493,8 +494,7 @@ public sealed class ExternalMcpServiceTests : IDisposable
var listId = await SeedListAsync();
var predecessor = await SeedTaskAsync(listId, "predecessor", TaskStatus.Idle);
var blocked = await SeedTaskAsync(listId, "blocked", TaskStatus.Queued);
blocked.DependsOnTaskId = predecessor.Id;
await _tasks.UpdateAsync(blocked, CancellationToken.None);
await _ctx.SeedDependsOnAsync(blocked.Id, predecessor.Id);
var unblocked = await SeedTaskAsync(listId, "unblocked", TaskStatus.Queued);
var sut = BuildSut(CreateQueue());
@@ -513,8 +513,7 @@ public sealed class ExternalMcpServiceTests : IDisposable
var listId = await SeedListAsync();
var predecessor = await SeedTaskAsync(listId, "predecessor", TaskStatus.Idle);
var blocked = await SeedTaskAsync(listId, "blocked", TaskStatus.Queued);
blocked.DependsOnTaskId = predecessor.Id;
await _tasks.UpdateAsync(blocked, CancellationToken.None);
await _ctx.SeedDependsOnAsync(blocked.Id, predecessor.Id);
var sut = BuildSut(CreateQueue());
var result = await sut.ListTasks(listId, includeDescription: true, cancellationToken: CancellationToken.None);
@@ -555,10 +554,10 @@ public sealed class ExternalMcpServiceTests : IDisposable
var dto = await sut.UpdateTask(task.Id, dependsOnTaskId: predecessor.Id, cancellationToken: CancellationToken.None);
Assert.Equal(predecessor.Id, dto.DependsOnTaskId);
Assert.Equal([predecessor.Id], dto.DependsOnTaskIds);
Assert.True(dto.Blocked);
var loaded = await _tasks.GetByIdAsync(task.Id);
Assert.Equal(predecessor.Id, loaded!.DependsOnTaskId);
Assert.Equal([predecessor.Id], loaded!.DependsOnTaskIds);
}
[Fact]
@@ -572,7 +571,7 @@ public sealed class ExternalMcpServiceTests : IDisposable
var dto = await sut.UpdateTask(task.Id, dependsOnTaskId: "", cancellationToken: CancellationToken.None);
Assert.Null(dto.DependsOnTaskId);
Assert.Empty(dto.DependsOnTaskIds!);
Assert.False(dto.Blocked);
}
@@ -589,6 +588,75 @@ public sealed class ExternalMcpServiceTests : IDisposable
sut.UpdateTask(a.Id, dependsOnTaskId: b.Id, cancellationToken: CancellationToken.None));
}
[Fact]
public async Task UpdateTask_WithDependsOnTaskIds_SetsSeveralPredecessors()
{
var listId = await SeedListAsync();
var a = await SeedTaskAsync(listId, "a", TaskStatus.Idle);
var b = await SeedTaskAsync(listId, "b", TaskStatus.Idle);
var task = await SeedTaskAsync(listId, status: TaskStatus.Queued);
var sut = BuildSut(CreateQueue());
var dto = await sut.UpdateTask(
task.Id, dependsOnTaskIds: [a.Id, b.Id], cancellationToken: CancellationToken.None);
Assert.Equal(Sorted(a.Id, b.Id), Sorted(dto.DependsOnTaskIds!));
Assert.True(dto.Blocked);
// Naming only the first predecessor would send a caller off to unblock the wrong task.
Assert.Contains(a.Id, dto.BlockedReason);
Assert.Contains(b.Id, dto.BlockedReason);
}
[Fact]
public async Task UpdateTask_WithEmptyDependsOnTaskIds_ClearsTheWholeSet()
{
var listId = await SeedListAsync();
var a = await SeedTaskAsync(listId, "a", TaskStatus.Idle);
var b = await SeedTaskAsync(listId, "b", TaskStatus.Idle);
var task = await SeedTaskAsync(listId, status: TaskStatus.Queued);
var sut = BuildSut(CreateQueue());
await sut.UpdateTask(task.Id, dependsOnTaskIds: [a.Id, b.Id], cancellationToken: CancellationToken.None);
var dto = await sut.UpdateTask(task.Id, dependsOnTaskIds: [], cancellationToken: CancellationToken.None);
Assert.Empty(dto.DependsOnTaskIds!);
Assert.False(dto.Blocked);
}
[Fact]
public async Task UpdateTask_LegacyScalarDependsOnTaskId_StillReplacesTheWholeSet()
{
// Back-compat: existing callers and prompts only know the scalar form. It has to keep
// behaving as "this is the one predecessor", not append to whatever is already there.
var listId = await SeedListAsync();
var a = await SeedTaskAsync(listId, "a", TaskStatus.Idle);
var b = await SeedTaskAsync(listId, "b", TaskStatus.Idle);
var task = await SeedTaskAsync(listId, status: TaskStatus.Queued);
var sut = BuildSut(CreateQueue());
await sut.UpdateTask(task.Id, dependsOnTaskIds: [a.Id, b.Id], cancellationToken: CancellationToken.None);
var dto = await sut.UpdateTask(task.Id, dependsOnTaskId: a.Id, cancellationToken: CancellationToken.None);
Assert.Equal([a.Id], dto.DependsOnTaskIds);
}
[Fact]
public async Task UpdateTask_WithCyclicDependsOnTaskIds_Throws()
{
var listId = await SeedListAsync();
var a = await SeedTaskAsync(listId, "a", TaskStatus.Idle);
var b = await SeedTaskAsync(listId, "b", TaskStatus.Idle);
var c = await SeedTaskAsync(listId, "c", TaskStatus.Idle);
var innocent = await SeedTaskAsync(listId, "innocent", TaskStatus.Idle);
var sut = BuildSut(CreateQueue());
await sut.UpdateTask(b.Id, dependsOnTaskId: a.Id, cancellationToken: CancellationToken.None);
await sut.UpdateTask(c.Id, dependsOnTaskId: b.Id, cancellationToken: CancellationToken.None);
// a -> {innocent, c} closes a -> c -> b -> a over three edges.
await Assert.ThrowsAsync<InvalidOperationException>(() =>
sut.UpdateTask(a.Id, dependsOnTaskIds: [innocent.Id, c.Id], cancellationToken: CancellationToken.None));
}
[Fact]
public async Task ReviewTask_Approve_SetsDone()
{
@@ -1488,11 +1556,29 @@ public sealed class ExternalMcpServiceTests : IDisposable
var dto = await sut.AddTask(
listId, "t", dependsOnTaskId: predecessor.Id, queueImmediately: true, cancellationToken: CancellationToken.None);
Assert.Equal(predecessor.Id, dto.Task.DependsOnTaskId);
Assert.Equal([predecessor.Id], dto.Task.DependsOnTaskIds);
Assert.True(dto.Task.Blocked);
Assert.Contains(predecessor.Id, dto.Task.BlockedReason);
var loaded = await _tasks.GetByIdAsync(dto.Task.Id);
Assert.Equal(predecessor.Id, loaded!.DependsOnTaskId);
Assert.Equal([predecessor.Id], loaded!.DependsOnTaskIds);
}
[Fact]
public async Task AddTask_WithDependsOnTaskIds_PersistsEveryLink()
{
var listId = await SeedListAsync();
var a = await SeedTaskAsync(listId, "a", TaskStatus.Idle);
var b = await SeedTaskAsync(listId, "b", TaskStatus.Done);
var sut = NewService();
var dto = await sut.AddTask(
listId, "t", dependsOnTaskIds: [a.Id, b.Id], queueImmediately: true,
cancellationToken: CancellationToken.None);
Assert.Equal(Sorted(a.Id, b.Id), Sorted(dto.Task.DependsOnTaskIds!));
Assert.True(dto.Task.Blocked);
var loaded = await _tasks.GetByIdAsync(dto.Task.Id);
Assert.Equal(Sorted(a.Id, b.Id), Sorted(loaded!.DependsOnTaskIds));
}
[Fact]
@@ -106,7 +106,7 @@ public sealed class ExternalMcpToolSchemaTests
"list_runs", "get_run", "get_task_log",
"list_agents",
"reset_failed_task", "submit_task_for_review",
"handoff_list_handler",
"handoff_list_handler", "get_handoff_status",
"get_app_settings",
"wait_for_task_change",
"get_queue_state",
@@ -209,6 +209,63 @@ public sealed class HandoffMcpToolsTests : IDisposable
secondSut.HandoffListHandler(handlerTask.Id, survivors, "wait", CancellationToken.None));
}
[Theory]
[InlineData(1, 3)]
[InlineData(2, 2)]
[InlineData(4, 0)]
public void HandoffRoundTracker_GetState_ReportsCountAfterNRegistrations(int registrations, int expectedRemaining)
{
var tracker = new HandoffRoundTracker();
var taskId = Guid.NewGuid().ToString();
for (var i = 0; i < registrations; i++)
tracker.Register(taskId, "wait");
var (count, sealedState) = tracker.GetState(taskId);
Assert.Equal(registrations, count);
Assert.Equal(expectedRemaining, HandoffRoundTracker.DefaultMaxHandoffs - count);
Assert.False(sealedState);
}
[Fact]
public void HandoffRoundTracker_GetState_UnregisteredTask_ReturnsZero()
{
var tracker = new HandoffRoundTracker();
var (count, sealedState) = tracker.GetState(Guid.NewGuid().ToString());
Assert.Equal(0, count);
Assert.False(sealedState);
}
[Fact]
public void HandoffRoundTracker_Register_DoesNotMutateStateVisibleFromGetState_BeyondItsOwnCall()
{
var tracker = new HandoffRoundTracker();
var taskId = Guid.NewGuid().ToString();
tracker.Register(taskId, "wait");
var (beforeCount, _) = tracker.GetState(taskId);
Assert.Equal(1, beforeCount);
// GetState itself must be read-only -- calling it repeatedly must not advance the round.
tracker.GetState(taskId);
tracker.GetState(taskId);
var (afterCount, _) = tracker.GetState(taskId);
Assert.Equal(beforeCount, afterCount);
}
[Fact]
public void HandoffRoundTracker_RejectedHandoff_ErrorNamesTheNextAction()
{
var tracker = new HandoffRoundTracker();
var taskId = Guid.NewGuid().ToString();
tracker.Register(taskId, "merge_final");
var result = tracker.Register(taskId, "wait");
Assert.True(result.Rejected);
Assert.Contains("new handler run", result.Error, StringComparison.OrdinalIgnoreCase);
}
[Fact]
public async Task HandoffListHandler_RaisedCapSetting_AllowsMoreRoundsBeforeCoercing()
{
@@ -258,6 +315,30 @@ public sealed class HandoffMcpToolsTests : IDisposable
Assert.Equal("merge_final", second.NextPhase);
}
/// GetHandoffStatus must report against the SAME cap HandoffListHandler enforces. Reading it
/// off the constant would understate a raised budget and make the tool lie about how much room
/// the chain has left.
[Fact]
public async Task GetHandoffStatus_RaisedCap_ReportsConfiguredRemaining()
{
await SetMaxHandoffsAsync(40);
var listId = await SeedListAsync();
var handlerTask = await SeedTaskAsync(listId);
var survivor = await SeedTaskAsync(listId, TaskStatus.WaitingForReview, title: "Survivor");
var tracker = new HandoffRoundTracker();
var survivors = new[] { survivor.Id };
await BuildSut(tracker).HandoffListHandler(handlerTask.Id, survivors, "wait", CancellationToken.None);
await BuildSut(tracker).HandoffListHandler(handlerTask.Id, survivors, "merge", CancellationToken.None);
var status = await BuildSut(tracker).GetHandoffStatus(handlerTask.Id, CancellationToken.None);
Assert.Equal(2, status.Round);
Assert.Equal(38, status.Remaining);
Assert.False(status.Final);
}
[Fact]
public async Task HandoffListHandler_TwoHandlerTasks_DoNotShareACounter()
{
@@ -280,4 +361,64 @@ public sealed class HandoffMcpToolsTests : IDisposable
Assert.False(resultB.Coerced);
Assert.Equal("wait", resultB.NextPhase);
}
[Fact]
public async Task GetHandoffStatus_NeverHandedOff_ReportsZeroRoundFullBudget()
{
var listId = await SeedListAsync();
var handlerTask = await SeedTaskAsync(listId);
var sut = BuildSut();
var status = await sut.GetHandoffStatus(handlerTask.Id, CancellationToken.None);
Assert.Equal(handlerTask.Id, status.TaskId);
Assert.Equal(handlerTask.Number, status.Number);
Assert.Equal(0, status.Round);
Assert.Equal(HandoffRoundTracker.DefaultMaxHandoffs, status.Remaining);
Assert.False(status.Final);
}
[Fact]
public async Task GetHandoffStatus_AfterHandoffs_ReflectsTrackerState()
{
var listId = await SeedListAsync();
var handlerTask = await SeedTaskAsync(listId);
var survivor = await SeedTaskAsync(listId, TaskStatus.WaitingForReview, title: "Survivor");
var tracker = new HandoffRoundTracker();
var survivors = new[] { survivor.Id };
await BuildSut(tracker).HandoffListHandler(handlerTask.Id, survivors, "wait", CancellationToken.None);
await BuildSut(tracker).HandoffListHandler(handlerTask.Id, survivors, "merge", CancellationToken.None);
var status = await BuildSut(tracker).GetHandoffStatus(handlerTask.Id, CancellationToken.None);
Assert.Equal(2, status.Round);
Assert.Equal(HandoffRoundTracker.DefaultMaxHandoffs - 2, status.Remaining);
Assert.False(status.Final);
}
[Fact]
public async Task GetHandoffStatus_AfterMergeFinal_ReportsFinal()
{
var listId = await SeedListAsync();
var handlerTask = await SeedTaskAsync(listId);
var survivor = await SeedTaskAsync(listId, TaskStatus.WaitingForReview, title: "Survivor");
var tracker = new HandoffRoundTracker();
var survivors = new[] { survivor.Id };
await BuildSut(tracker).HandoffListHandler(handlerTask.Id, survivors, "merge_final", CancellationToken.None);
var status = await BuildSut(tracker).GetHandoffStatus(handlerTask.Id, CancellationToken.None);
Assert.True(status.Final);
Assert.Equal(1, status.Round);
}
[Fact]
public async Task GetHandoffStatus_UnknownTask_Throws()
{
var sut = BuildSut();
await Assert.ThrowsAsync<InvalidOperationException>(() =>
sut.GetHandoffStatus("missing", CancellationToken.None));
}
}
@@ -220,8 +220,7 @@ public sealed class TaskWaitMcpToolsTests : IDisposable
{
var dependency = await SeedTaskAsync(TaskStatus.Idle);
var task = await SeedTaskAsync(TaskStatus.Queued);
task.DependsOnTaskId = dependency.Id;
await _tasks.UpdateAsync(task);
await _ctx.SeedDependsOnAsync(task.Id, dependency.Id);
var sut = BuildSut();
var sw = Stopwatch.StartNew();
@@ -240,8 +239,7 @@ public sealed class TaskWaitMcpToolsTests : IDisposable
{
var dependency = await SeedTaskAsync(TaskStatus.Done);
var task = await SeedTaskAsync(TaskStatus.Queued);
task.DependsOnTaskId = dependency.Id;
await _tasks.UpdateAsync(task);
await _ctx.SeedDependsOnAsync(task.Id, dependency.Id);
var sut = BuildSut();
var sw = Stopwatch.StartNew();