feat(gstack2): add capability readiness process

2026-09-21 04:10:47 +02:00 · 2026-07-20 16:23:38 -07:00
parent a1b2b05a18
commit 2e1e52eae7
12 changed files with 324 additions and 8 deletions
@@ -0,0 +1,113 @@
+import { describe, expect, test } from "bun:test";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { main } from "../runtime/cli.js";
+import { capabilityReadiness, formatCapabilityReadiness } from "../runtime/doctor.js";
+import { setupRuntime } from "../runtime/setup.js";
+
+function report(checks: Array<Record<string, unknown>>) {
+  return {
+    ok: !checks.some((check) => check.status === "fail"),
+    home: "/fixture/.gstack",
+    checkedAt: "2026-07-20T00:00:00.000Z",
+    checks,
+  };
+}
+
+function capture() {
+  let value = "";
+  return { stream: { write: (chunk: string) => { value += chunk; } }, value: () => value };
+}
+
+describe("capability readiness", () => {
+  test("keeps pure judgment, preview consent, and install consent separate when unavailable", () => {
+    const result = capabilityReadiness(report([
+      { id: "managed-runtime", status: "fail", message: "No active managed runtime" },
+      { id: "capability:pdf", status: "warn", message: "not installed" },
+    ]), "pdf");
+
+    expect(result).toMatchObject({
+      ok: false,
+      judgment: { status: "available" },
+      platform: { status: "supported" },
+      consent: {
+        preview: { status: "required", granted: false },
+        install: { status: "required-after-preview", granted: false },
+      },
+      readiness: { status: "unavailable" },
+    });
+  });
+
+  test("distinguishes ready, degraded, and failed runtime states", () => {
+    const ready = capabilityReadiness(report([
+      { id: "managed-runtime", status: "pass", message: "active" },
+      { id: "capability:design", status: "pass", message: "runnable" },
+    ]), "design");
+    const degraded = capabilityReadiness(report([
+      { id: "managed-runtime", status: "warn", message: "recovered" },
+      { id: "capability:design", status: "pass", message: "runnable" },
+    ]), "design");
+    const failed = capabilityReadiness(report([
+      { id: "managed-runtime", status: "pass", message: "active" },
+      { id: "capability:diagram", status: "fail", message: "launcher metadata missing" },
+    ]), "diagram");
+
+    expect(ready).toMatchObject({ ok: true, readiness: { status: "ready" } });
+    expect(degraded).toMatchObject({ ok: true, readiness: { status: "degraded" } });
+    expect(failed).toMatchObject({ ok: false, readiness: { status: "failed" } });
+    expect(failed.consent.install.status).toBe("required-after-preview");
+  });
+
+  test("reports physical iOS as unsupported without turning off pure judgment", () => {
+    const result = capabilityReadiness(report([]), "ios", { platform: "linux" });
+    expect(result).toMatchObject({
+      ok: false,
+      judgment: { status: "available" },
+      platform: { status: "unsupported", platform: "linux" },
+      consent: {
+        preview: { status: "not-applicable" },
+        install: { status: "not-applicable" },
+      },
+      readiness: { status: "unsupported" },
+    });
+  });
+
+  test("human output exposes every state axis", () => {
+    const result = capabilityReadiness(report([
+      { id: "managed-runtime", status: "pass", message: "active" },
+      { id: "capability:browser", status: "pass", message: "launched" },
+    ]), "browser");
+    expect(formatCapabilityReadiness(result)).toContain("judgment: available");
+    expect(formatCapabilityReadiness(result)).toContain("preview consent: not-required");
+    expect(formatCapabilityReadiness(result)).toContain("install consent: not-required");
+    expect(formatCapabilityReadiness(result)).toContain("readiness: ready");
+  });
+
+  test("doctor capability JSON is non-mutating and uses the unified result envelope", async () => {
+    const root = await fs.mkdtemp(path.join(os.tmpdir(), "gstack-capability-doctor-"));
+    const home = path.join(root, "home");
+    const stdout = capture();
+    const stderr = capture();
+    try {
+      await setupRuntime({ home, cwd: root });
+      const exit = await main(["doctor", "--capability", "pdf", "--json"], {
+        cwd: root,
+        env: { ...process.env, GSTACK_HOME: home },
+        stdout: stdout.stream,
+        stderr: stderr.stream,
+      });
+      const result = JSON.parse(stdout.value());
+      expect(exit).toBe(1);
+      expect(stderr.value()).toBe("");
+      expect(result).toMatchObject({
+        ok: false,
+        capability: "pdf",
+        judgment: { status: "available" },
+        readiness: { status: "unavailable" },
+      });
+    } finally {
+      await fs.rm(root, { recursive: true, force: true });
+    }
+  });
+});