Deploymentcenter-Anbindung auf SDK 2.8.2 nachgezogen (#218)
Der Changelog seit 2.6.0 nennt sechs Fassungen, 16 action_items und fuenf brechende Aenderungen. Davon trifft fast nichts diese Anwendung - und das ist ein Befund, kein Versaeumnis: - finding_status (brechend, 2.7.0): kein Aufrufer. Weder /api/supervisor/v1/observe noch /status werden hier angesprochen. Vorgemerkt fuer #528 Stufe 3 - wer den Manager baut, liest den Befundzustand von Anfang an aus diesem Feld. - Nachpruefungs-Status awaiting_verification, in_verification, fix_insufficient (brechend, 2.6.1): Die Anwendung wertet bugtracker_items.status nirgends aus. Betrifft den Arbeitsablauf der Agenten, und der steht in CLAUDE.md bereits richtig beschrieben. - Meldungen ohne project_slug (brechend, 2.8.1): BugtrackerClient und ErrorReporter schicken project_slug und build_version seit jeher mit. - Leseweg ohne project_slug und schmales dc_roadmap (brechend, 2.8.1): betrifft den MCP-Adapter, nicht den Anwendungscode. Geblieben ist die eine Zusage, die man nicht sieht, wenn man sie verletzt: Seit 2.8.1 erbt ein Watchdog-Monitor das Projekt seines Ping-Tokens. Ohne Bindung landen die Befunde im Scheinprojekt "default", und eine Abfrage nach dem eigenen Projekt liefert fuer eine laufende, fleissig meldende Instanz null Befunde - die Aufsicht sieht aus wie "nichts auffaellig". Das ist genau die Falle, in die hier schon einmal Meldungen gelaufen sind. Deshalb neu: TokenProvisioner.WhoAmIAsync gegen GET /api/tokens/v1/whoami (SDK 2.7.1) und der Typ TokenIdentity mit IsProjectBound. DeploymentcenterService fragt beim Start das eigene Melde-Token, protokolliert das Projekt und warnt, wenn keines dransteht. Bewusst nur eine Warnung: Monitoring, das bei unklarer Rechtelage gar nicht erst anlaeuft, ist genau dann still, wenn man es braucht. Faellt die Auskunft aus - aelterer Server, kein Netz -, bleibt es bei Debug. Gemessen statt geraten: TokenProvisioner schickt keinen project_slug mit, und ob der Server die Bindung vom Master-Token erbt, steht in keiner Beschreibung, die vorliegt. Ein Sub-Token dafuer eigens auf dem Produktivserver auszustellen waere zu viel Nebenwirkung gewesen; die erste Instanz, die eines zieht, sagt es jetzt selbst ins Protokoll. #176 ist erledigt und die Regel in CLAUDE.md gestrichen: dc_roadmap ohne project_slug liefert jetzt das eigene Projekt (nachgemessen: 51 Eintraege, alle clawddotnet). Wer projektuebergreifend lesen will, schickt project_slug=all. dc_link_project auf 2.8.2 gesetzt, CLAUDE.md-Zeile hochgesetzt. Build ohne Warnungen, 717 Tests gruen, 8 uebersprungen. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Richard
@@ -84,14 +84,14 @@ nicht: den Fehler ganz normal erneut melden — das Item wandert von selbst auf
|
||||
`unauthorized` → Token prüfen, nicht wiederholen. `already_claimed` → nächstes
|
||||
Item. `rate_limited` → Intervall verdoppeln, später erneut.
|
||||
|
||||
### Zwei Stolperstellen, solange sie offen sind
|
||||
### Eine Stolperstelle, solange sie offen ist
|
||||
|
||||
**`dc_roadmap` immer mit `project_slug: "clawddotnet"` aufrufen.** Ohne die
|
||||
Angabe liefert der Server die Roadmap *fremder* Projekte, obwohl die
|
||||
Werkzeugbeschreibung das eigene zusagt. Gemeldet als
|
||||
[#176](https://dc.mhdf.de/index.php#tab-bugtracker) unter `deploymentcenter`.
|
||||
Betrifft nur die lesenden Roadmap-Aufrufe; `dc_next_task` ist korrekt ans
|
||||
eigene Projekt gebunden.
|
||||
**#176 ist erledigt und die Regel dazu gestrichen.** Hier stand, `dc_roadmap`
|
||||
müsse immer mit `project_slug: "clawddotnet"` aufgerufen werden, weil der Server
|
||||
sonst fremde Projekte liefert. Seit SDK 2.8.1 gilt ohne Angabe das eigene
|
||||
Projekt — beim Lesen wie beim Melden. Nachgemessen am 2026-09-08: `dc_roadmap`
|
||||
ohne Slug liefert 51 Einträge, alle `clawddotnet`. Wer bewusst über alle
|
||||
Projekte lesen will, schickt jetzt ausdrücklich `project_slug: "all"`.
|
||||
|
||||
**`roadmap_rank` gilt hier projektweit**, nicht je Bereich — die durchgehende
|
||||
Reihenfolge aus `docs/Roadmap.md` hängt daran. Wer einen Eintrag im WebUI
|
||||
@@ -118,12 +118,28 @@ er liest `.mcp.json` beim Sitzungsbeginn. Eine neue Sitzung räumt das aus.
|
||||
`$DC_TOKEN` steht daneben in der Bash-Umgebung — damit lässt sich die REST-API
|
||||
direkt bedienen, wenn die Werkzeuge einmal ausfallen.
|
||||
|
||||
Deploymentcenter-Anbindung: SDK 2.6.0, integriert am 2026-08-30.
|
||||
Aktuell ist 2.7.0; der Sprung ist ein eigenes Vorhaben und steht auf der
|
||||
Roadmap. Vor jeder Änderung an der Anbindung:
|
||||
`GET /api/updateservice/v1/changelog?since=2.6.0`, danach diese Zeile
|
||||
Deploymentcenter-Anbindung: **SDK 2.8.2**, nachgezogen am 2026-09-08 (#218).
|
||||
Vor jeder Änderung an der Anbindung:
|
||||
`GET /api/updateservice/v1/changelog?since=2.8.2`, danach diese Zeile
|
||||
hochsetzen und `dc_link_project` aufrufen.
|
||||
|
||||
Was der Sprung 2.6.0 → 2.8.2 an dieser Anwendung geändert hat, ist wenig — und
|
||||
das ist ein Befund, kein Versäumnis: Von fünf brechenden Änderungen betrafen vier
|
||||
Wege, die diese Anwendung gar nicht geht (`?action=next`, Roadmap-Lesen,
|
||||
`/api/supervisor/v1/observe`). Der Meldepfad schickte `project_slug` und
|
||||
`build_version` bereits. Geblieben ist eine Zusage, die man nicht sieht, wenn man
|
||||
sie verletzt: Seit 2.8.1 erbt ein Watchdog-Monitor das Projekt seines
|
||||
Ping-Tokens; ohne Bindung landen die Befunde im Scheinprojekt „default", und
|
||||
`dc_findings` liefert für eine laufende, fleißig meldende Instanz **null
|
||||
Befunde** — die Aufsicht sieht aus wie „nichts auffällig". Die Anwendung fragt
|
||||
deshalb beim Start ihr eigenes Melde-Token über
|
||||
`GET /api/tokens/v1/whoami` (seit 2.7.1), protokolliert das Projekt und warnt,
|
||||
wenn keines dransteht.
|
||||
|
||||
`finding_status` (brechend seit 2.7.0) ist noch niemandes Baustelle: Diese
|
||||
Anwendung ruft `observe` und `status` nicht auf. Wer den Instanzmanager baut
|
||||
(#528, Stufe 3), liest den Befundzustand von Anfang an aus diesem Feld.
|
||||
|
||||
## Weitere Handbücher
|
||||
|
||||
| Dokument | Wofür |
|
||||
|
||||
@@ -121,6 +121,8 @@ public sealed class DeploymentcenterService : IAsyncDisposable
|
||||
var watchdog = instance.Watchdog;
|
||||
var token = await ResolveInstanceTokenAsync(instance, saveInstanceConfig, ct);
|
||||
|
||||
await WarnIfTokenHasNoProjectAsync(token, ct);
|
||||
|
||||
try
|
||||
{
|
||||
_heartbeat = WatchdogHeartbeatService.Create(
|
||||
@@ -191,6 +193,54 @@ public sealed class DeploymentcenterService : IAsyncDisposable
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Prüft, ob das Melde-Token an ein Projekt gebunden ist, und sagt es, wenn nicht.
|
||||
///
|
||||
/// <para><b>Warum das eine eigene Anfrage wert ist.</b> Seit SDK 2.8.1 erbt ein
|
||||
/// Watchdog-Monitor das Projekt seines Ping-Tokens. Fehlt dort die Bindung, legt der
|
||||
/// Server die Befunde im Scheinprojekt „default" ab — und eine Abfrage nach dem
|
||||
/// eigenen Projekt liefert für eine laufende, fleißig meldende Instanz dann
|
||||
/// <b>null Befunde</b>. Die Aufsicht sieht aus wie „nichts auffällig", und genau
|
||||
/// darauf verlässt sich niemand gern.</para>
|
||||
///
|
||||
/// <para>Der Fall ist nicht erfunden: Genau so sind schon Meldungen in „default"
|
||||
/// gelandet und waren danach für ihren eigenen Melder gesperrt. Ein Heartbeat, der
|
||||
/// ins Leere geht, meldet sich nicht von selbst — deshalb wird hier einmal
|
||||
/// nachgefragt, statt es anzunehmen.</para>
|
||||
///
|
||||
/// <para>Nur eine Warnung, kein Abbruch: Ein Monitoring, das bei unklarer Rechtelage
|
||||
/// gar nicht erst anläuft, ist genau dann still, wenn man es braucht.</para>
|
||||
/// </summary>
|
||||
private async Task WarnIfTokenHasNoProjectAsync(string token, CancellationToken ct)
|
||||
{
|
||||
try
|
||||
{
|
||||
using var api = new DeploymentcenterApi(_api.BaseUrl, token);
|
||||
var identity = await new TokenProvisioner(api).WhoAmIAsync(ct);
|
||||
|
||||
if (identity.IsProjectBound)
|
||||
{
|
||||
_logger.LogInformation(
|
||||
"Deploymentcenter: Meldungen gehen an Projekt {Projekt} (Token {TokenId}, {Typ}).",
|
||||
identity.ProjectSlug, identity.TokenId, identity.Type);
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
_logger.LogWarning(
|
||||
"Deploymentcenter: Das Melde-Token {TokenId} ist an kein Projekt gebunden. "
|
||||
+ "Watchdog-Befunde dieser Instanz landen damit im Scheinprojekt \"default\" "
|
||||
+ "und tauchen in der Projektansicht nicht auf.",
|
||||
identity.TokenId);
|
||||
}
|
||||
catch (Exception ex)
|
||||
{
|
||||
// Aelterer Server ohne whoami (vor SDK 2.7.1), kein Netz, kein Recht: Das ist
|
||||
// eine Auskunft, die ausfaellt, und kein Grund, den Heartbeat nicht zu starten.
|
||||
_logger.LogDebug(ex, "Deploymentcenter: Token-Auskunft nicht verfügbar.");
|
||||
}
|
||||
}
|
||||
|
||||
private static string DescribePlatform() =>
|
||||
$"{System.Runtime.InteropServices.RuntimeInformation.OSDescription} / "
|
||||
+ $".NET {System.Environment.Version}";
|
||||
|
||||
@@ -9,8 +9,30 @@ namespace ClawdDotNet.Core.Deploymentcenter;
|
||||
public sealed record ProvisionedToken(string Token, string TokenId, IReadOnlyList<string> Scopes);
|
||||
|
||||
/// <summary>
|
||||
/// Tauscht das anwendungsweite Master-Token gegen ein eigenes Sub-Token je Instanz
|
||||
/// (<c>POST /api/tokens/v1/provision</c>).
|
||||
/// Was ein Token über sich selbst sagt (<c>GET /api/tokens/v1/whoami</c>, seit SDK 2.7.1).
|
||||
///
|
||||
/// <para><see cref="ProjectSlug"/> ist das Feld, auf das es ankommt. Seit SDK 2.8.1 erbt
|
||||
/// ein Watchdog-Monitor das Projekt seines Ping-Tokens — ist dort nichts eingetragen,
|
||||
/// landen die Befunde im Scheinprojekt „default", und eine Abfrage nach dem eigenen
|
||||
/// Projekt liefert für eine laufende, meldende Instanz <b>null Befunde</b>. Die Aufsicht
|
||||
/// sähe dann aus wie „nichts auffällig", und das ist der schlechteste aller
|
||||
/// Irrtümer.</para>
|
||||
/// </summary>
|
||||
public sealed record TokenIdentity(
|
||||
string TokenId,
|
||||
string Name,
|
||||
string Type,
|
||||
string? ProjectSlug,
|
||||
string Environment,
|
||||
IReadOnlyList<string> Scopes)
|
||||
{
|
||||
/// <summary>Ob dieses Token an ein Projekt gebunden ist — siehe Klassenkommentar.</summary>
|
||||
public bool IsProjectBound => !string.IsNullOrWhiteSpace(ProjectSlug);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Der Zugang zu <c>/api/tokens/v1/…</c>: ein Sub-Token je Instanz ausstellen
|
||||
/// (<c>provision</c>) und ein Token nach sich selbst fragen (<c>whoami</c>).
|
||||
///
|
||||
/// <para>Das ersetzt die frühere Selbstregistrierung über <c>POST /api/register</c> —
|
||||
/// diesen Endpunkt gibt es im Deploymentcenter nicht (und im alten WatchDog-Server war
|
||||
@@ -70,4 +92,39 @@ public sealed class TokenProvisioner(DeploymentcenterApi api)
|
||||
|
||||
return new ProvisionedToken(token, tokenId, granted);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Fragt das Token, mit dem diese Verbindung arbeitet, nach sich selbst.
|
||||
///
|
||||
/// <para>Nicht Neugier, sondern die einzige Möglichkeit, die Projektbindung zu
|
||||
/// erfahren: Sie steht nicht im Token und ergibt sich nicht aus dem, was beim
|
||||
/// Ausstellen mitgeschickt wurde — sie ist eine Eigenschaft, die der Server führt.
|
||||
/// Siehe <see cref="TokenIdentity"/>, warum das nicht gleichgültig ist.</para>
|
||||
/// </summary>
|
||||
public async Task<TokenIdentity> WhoAmIAsync(CancellationToken ct = default)
|
||||
{
|
||||
var response = await api.GetAsync("/api/tokens/v1/whoami", ct).ConfigureAwait(false);
|
||||
|
||||
var scopes = new List<string>();
|
||||
if (response.TryGetProperty("scopes", out var s) && s.ValueKind == JsonValueKind.Array)
|
||||
{
|
||||
scopes.AddRange(s.EnumerateArray()
|
||||
.Where(e => e.ValueKind == JsonValueKind.String)
|
||||
.Select(e => e.GetString()!));
|
||||
}
|
||||
|
||||
return new TokenIdentity(
|
||||
Text(response, "token_id") ?? "",
|
||||
Text(response, "name") ?? "",
|
||||
Text(response, "type") ?? "unknown",
|
||||
Text(response, "project_slug"),
|
||||
Text(response, "environment") ?? "",
|
||||
scopes);
|
||||
}
|
||||
|
||||
/// <summary>Eine Zeichenkette aus der Antwort; <c>null</c> auch bei JSON-<c>null</c>.</summary>
|
||||
private static string? Text(JsonElement root, string name)
|
||||
=> root.TryGetProperty(name, out var v) && v.ValueKind == JsonValueKind.String
|
||||
? v.GetString()
|
||||
: null;
|
||||
}
|
||||
|
||||
@@ -47,4 +47,73 @@ public sealed class TokenProvisionerTests
|
||||
|
||||
ex.Code.ShouldBe("provision_denied");
|
||||
}
|
||||
// ─── whoami (SDK 2.7.1) ───
|
||||
|
||||
/// <summary>
|
||||
/// Die Auskunft, auf die es ankommt: an welches Projekt das Token gebunden ist.
|
||||
///
|
||||
/// <para>Seit SDK 2.8.1 erbt ein Watchdog-Monitor das Projekt seines Ping-Tokens.
|
||||
/// Fehlt die Bindung, landen die Befunde im Scheinprojekt „default" — und eine
|
||||
/// Abfrage nach dem eigenen Projekt liefert für eine laufende, meldende Instanz null
|
||||
/// Befunde. Die Aufsicht sähe aus wie „nichts auffällig".</para>
|
||||
/// </summary>
|
||||
[Fact]
|
||||
public async Task Whoami_liest_die_Projektbindung()
|
||||
{
|
||||
var handler = new CapturingHandler(HttpStatusCode.OK,
|
||||
"""
|
||||
{"status":"success","token_id":"tok_m_1","name":"DEV-ClawdDotNet","type":"master",
|
||||
"owner_type":"dev_agent","is_workbench":true,"project_slug":"clawddotnet",
|
||||
"environment":"all","scopes":["*"]}
|
||||
""");
|
||||
|
||||
using var api = new DeploymentcenterApi("https://dc.example", "master", new HttpClient(handler));
|
||||
|
||||
var identity = await new TokenProvisioner(api).WhoAmIAsync();
|
||||
|
||||
handler.LastRequest!.RequestUri!.ToString().ShouldBe("https://dc.example/api/tokens/v1/whoami");
|
||||
handler.LastRequest.Method.ShouldBe(HttpMethod.Get);
|
||||
|
||||
identity.TokenId.ShouldBe("tok_m_1");
|
||||
identity.Name.ShouldBe("DEV-ClawdDotNet");
|
||||
identity.Type.ShouldBe("master");
|
||||
identity.ProjectSlug.ShouldBe("clawddotnet");
|
||||
identity.IsProjectBound.ShouldBeTrue();
|
||||
identity.Scopes.ShouldContain("*");
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public async Task Ein_Token_ohne_Projekt_faellt_auf()
|
||||
{
|
||||
// project_slug ist JSON-null, nicht abwesend - genau so kommt es vom Server.
|
||||
var handler = new CapturingHandler(HttpStatusCode.OK,
|
||||
"""
|
||||
{"status":"success","token_id":"tok_s_9","name":"Instanz","type":"sub",
|
||||
"project_slug":null,"environment":"production","scopes":["watchdog:ping"]}
|
||||
""");
|
||||
|
||||
using var api = new DeploymentcenterApi("https://dc.example", "sub", new HttpClient(handler));
|
||||
|
||||
var identity = await new TokenProvisioner(api).WhoAmIAsync();
|
||||
|
||||
identity.ProjectSlug.ShouldBeNull();
|
||||
identity.IsProjectBound.ShouldBeFalse();
|
||||
}
|
||||
|
||||
[Fact]
|
||||
public async Task Eine_Antwort_ohne_Felder_wirft_nicht()
|
||||
{
|
||||
// Ein aelterer Server kennt whoami nicht in dieser Form. Die Auskunft darf
|
||||
// ausfallen; abstuerzen darf sie nicht.
|
||||
var handler = new CapturingHandler(HttpStatusCode.OK, """{"status":"success"}""");
|
||||
|
||||
using var api = new DeploymentcenterApi("https://dc.example", "t", new HttpClient(handler));
|
||||
|
||||
var identity = await new TokenProvisioner(api).WhoAmIAsync();
|
||||
|
||||
identity.TokenId.ShouldBe("");
|
||||
identity.Type.ShouldBe("unknown");
|
||||
identity.IsProjectBound.ShouldBeFalse();
|
||||
identity.Scopes.ShouldBeEmpty();
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user