From 418a22d18d7609d725f6952c4744e58bed4d731d Mon Sep 17 00:00:00 2001 From: Meleki Date: Sat, 20 Jun 2026 18:18:49 +0200 Subject: [PATCH] docs: Kommentar-Schreibweise wf_.json zu .json vereinheitlicht Die runId ist bereits mit "wf_" praefixiert; der Code erzeugt /workflows/.json. Die Kurz-Referenzen in den Code-Kommentaren (WorkflowProgressTracker, ClaudeCliService, AnthropicService, SessionEndpoint) nutzten faelschlich das doppelte "wf_"-Praefix. Co-Authored-By: Claude Opus 4.8 --- Endpoints/SessionEndpoint.cs | 2 +- Services/AnthropicService.cs | 2 +- Services/ClaudeCliService.cs | 2 +- Services/WorkflowProgressTracker.cs | 8 ++++---- 4 files changed, 7 insertions(+), 7 deletions(-) diff --git a/Endpoints/SessionEndpoint.cs b/Endpoints/SessionEndpoint.cs index e35dc3f..2548b89 100644 --- a/Endpoints/SessionEndpoint.cs +++ b/Endpoints/SessionEndpoint.cs @@ -457,7 +457,7 @@ public static class SessionEndpoint var streaming = streamingTracker.IsStreaming(sessionId); // 1) Aktueller Lauf registriert: Telemetrie aus den Transcript-Dateien lesen – - // live aus journal.jsonl (Counts), nach Abschluss aus wf_.json (reich). + // live aus journal.jsonl (Counts), nach Abschluss aus .json (reich). var run = workflowTracker.Get(sessionId); if (run != null) { diff --git a/Services/AnthropicService.cs b/Services/AnthropicService.cs index be5f4c6..1654b82 100644 --- a/Services/AnthropicService.cs +++ b/Services/AnthropicService.cs @@ -331,7 +331,7 @@ public partial class AnthropicService { try { - // Reiche End-Telemetrie aus der wf_.json des Laufs lesen und persistieren + // Reiche End-Telemetrie aus der .json des Laufs lesen und persistieren // (Fallback: Live-Counts aus dem journal.jsonl, falls die json noch nicht da ist). var wp = WorkflowTelemetryReader.Read(_workflowTracker.Get(chain.SessionId)); if (wp != null) diff --git a/Services/ClaudeCliService.cs b/Services/ClaudeCliService.cs index 3f963d2..b17a7a0 100644 --- a/Services/ClaudeCliService.cs +++ b/Services/ClaudeCliService.cs @@ -96,7 +96,7 @@ public class ClaudeCliService /// Erkennt den tool_result des dynamischen Workflow-Tools ("Workflow launched in background … /// Transcript dir: …") und registriert den Lauf im WorkflowProgressTracker. Der Workflow läuft /// als detachter Hintergrund-Task mit eigenem Transcript – seine Live-/End-Telemetrie wird - /// später aus den dort liegenden Dateien (journal.jsonl / wf_<runId>.json) gelesen, nicht aus + /// später aus den dort liegenden Dateien (journal.jsonl / <runId>.json) gelesen, nicht aus /// dem Stream. Rein additiv – wirft nie (Telemetrie darf den Stream-Parser nicht stören). /// private void TapWorkflowLaunch(string sessionId, string chainId, string resultContent) diff --git a/Services/WorkflowProgressTracker.cs b/Services/WorkflowProgressTracker.cs index a2ba659..886f5e1 100644 --- a/Services/WorkflowProgressTracker.cs +++ b/Services/WorkflowProgressTracker.cs @@ -77,13 +77,13 @@ public class WorkflowRunRef /// /// Liest die Workflow-Telemetrie aus den CLI-Transcript-Dateien. Zwei Quellen, je nach Phase: -/// das append-only journal.jsonl (live, während des Laufs) und die reiche wf_<runId>.json +/// das append-only journal.jsonl (live, während des Laufs) und die reiche <runId>.json /// (erst bei Abschluss). Alle Methoden sind defensiv und liefern null statt zu werfen. /// public static class WorkflowTelemetryReader { /// - /// Bevorzugt die reiche, fertige wf_<runId>.json (existiert nur nach Abschluss); + /// Bevorzugt die reiche, fertige <runId>.json (existiert nur nach Abschluss); /// fällt sonst auf das live journal.jsonl zurück. Liefert null, wenn nichts lesbar ist. /// public static WorkflowProgress Read(WorkflowRunRef run) @@ -96,7 +96,7 @@ public static class WorkflowTelemetryReader return null; } - /// Reiche Telemetrie aus der wf_<runId>.json (am Laufende geschrieben). + /// Reiche Telemetrie aus der <runId>.json (am Laufende geschrieben). public static WorkflowProgress ReadCompleted(string richJsonPath) { if (string.IsNullOrEmpty(richJsonPath) || !File.Exists(richJsonPath)) return null; @@ -207,7 +207,7 @@ public static class WorkflowTelemetryReader /// /// Telemetrie eines dynamischen Workflows. Live (aus journal.jsonl): nur Status + Subagent-Zähler. -/// Abgeschlossen (aus wf_<runId>.json): zusätzlich Phasen, Per-Agent-Details (Tokens, Tool-Calls, +/// Abgeschlossen (aus <runId>.json): zusätzlich Phasen, Per-Agent-Details (Tokens, Tool-Calls, /// Dauer, Label, Phase) und Summen. Wird beim Chain-Finalize als JSON in chains.workflow_info /// persistiert und vom /workflow-status-Endpoint ausgeliefert. ///