feat(gstack2): add unified execution result contract

2026-09-21 04:10:47 +02:00 · 2026-07-20 16:22:28 -07:00
parent d6ef673e4d
commit 9b5ae4071d
19 changed files with 738 additions and 4 deletions
@@ -0,0 +1,35 @@
+import { describe, expect, test } from "bun:test";
+import {
+  EXECUTION_RESULT_ERROR_CODES,
+  executionResult,
+  renderExecutionResult,
+  validateExecutionResult,
+} from "../runtime/execution-result.js";
+
+describe("GStack execution-result contract", () => {
+  test("accepts evidenced success and preserves it in both renderings", () => {
+    const result = executionResult({ status: "success", summary: "Probe completed", evidence: ["exit code 0"], data: { count: 1 } });
+    expect(JSON.parse(renderExecutionResult(result, { json: true }))).toEqual(result);
+    expect(renderExecutionResult(result)).toContain("SUCCESS: Probe completed");
+  });
+
+  test("rejects empty and malformed values instead of inferring success", () => {
+    expect(() => validateExecutionResult(null)).toThrow();
+    expect(() => executionResult({ status: "success", summary: "Done", evidence: [], data: null }))
+      .toThrow("requires evidence");
+    try {
+      executionResult({ status: "success", summary: "Done", evidence: [], data: null });
+    } catch (error: any) {
+      expect(error.code).toBe(EXECUTION_RESULT_ERROR_CODES.EMPTY);
+    }
+  });
+
+  test.each([
+    ["degraded", "EXECUTION_DEGRADED"],
+    ["unsupported", "EXECUTION_UNSUPPORTED"],
+    ["failed", "EXECUTION_FAILED"],
+  ])("keeps %s explicitly non-success", (status, code) => {
+    const result = executionResult({ status, code, summary: `${status} result`, evidence: [], data: null });
+    expect(renderExecutionResult(result)).toStartWith(`${status.toUpperCase()} [${code}]`);
+  });
+});