chore: mark benchmark/report output as stub

Author: jdrhyne

src/commands/benchmark.ts

@@ -89,14 +89,13 @@ export const registerBenchmarkCommand = (program: Command) => {
         const startedAt = new Date();
         const runs = buildPlaceholderRuns(startedAt);
         const finishedAt = new Date(
-          new Date(runs[runs.length - 1]?.finishedAt ?? startedAt.toISOString())
-            .getTime()
+          new Date(runs[runs.length - 1]?.finishedAt ?? startedAt.toISOString()).getTime()
         );
         const avgLatencyMs =
-          runs.reduce((sum, run) => sum + run.metrics.latencyMs, 0) /
-          runs.length;
+          runs.reduce((sum, run) => sum + run.metrics.latencyMs, 0) / runs.length;
 
         const result = {
+          status: "stub",
           suite,
           startedAt: startedAt.toISOString(),
           finishedAt: finishedAt.toISOString(),
@@ -105,6 +104,7 @@ export const registerBenchmarkCommand = (program: Command) => {
             runCount: runs.length,
             avgLatencyMs,
           },
+          warnings: ["Benchmark results are placeholders."],
         };
 
         await fs.writeFile(resolvedOutput, JSON.stringify(result, null, 2), "utf8");

src/commands/report.ts

@@ -8,6 +8,7 @@ type ReportOptions = {
 };
 
 type BenchmarkResults = {
+  status?: string;
   suite?: string;
   runs?: Array<{
     metrics?: {
@@ -17,6 +18,7 @@ type BenchmarkResults = {
   summary?: {
     avgLatencyMs?: number;
   };
+  warnings?: string[];
 };
 
 const toErrorMessage = (error: unknown): string =>
@@ -105,24 +107,32 @@ export const registerReportCommand = (program: Command) => {
           .filter(isFiniteNumber);
         const avgLatency =
           latencies.length > 0
-            ? latencies.reduce((sum, value) => sum + value, 0) /
-              latencies.length
+            ? latencies.reduce((sum, value) => sum + value, 0) / latencies.length
             : isFiniteNumber(parsed.summary?.avgLatencyMs)
               ? parsed.summary?.avgLatencyMs
               : undefined;
         const avgLatencyText =
-          typeof avgLatency === "number"
-            ? avgLatency.toFixed(2)
-            : "N/A";
+          typeof avgLatency === "number" ? avgLatency.toFixed(2) : "N/A";
+
+        const status = parsed.status ? parsed.status : "unknown";
+        const warnings = Array.isArray(parsed.warnings) ? parsed.warnings : [];
 
         const lines = [
           "# Benchmark Report",
           "",
+          `- Status: ${status}`,
           `- Suite: ${suite}`,
           `- Runs: ${runCount}`,
           `- Avg latency (ms): ${avgLatencyText}`,
           "",
-        ];
+          warnings.length > 0 ? "## Warnings" : "",
+          ...warnings.map((warning) => `- ${warning}`),
+          warnings.length > 0 ? "" : "",
+          "## Notes",
+          "- If this report is marked as stub, replace placeholder metrics with real benchmark output.",
+          "- Re-run `dws benchmark --suite <name>` after integrating the DWS API.",
+          "",
+        ].filter((line) => line !== "");
 
         await fs.writeFile(resolvedOutput, lines.join("\n"), "utf8");
         console.log(`Wrote report to ${resolvedOutput}`);