test: add docker e2e planner guards

test/scripts/docker-e2e-plan.test.ts

@@ -0,0 +1,86 @@
+import { describe, expect, it } from "vitest";
+import {
+  DEFAULT_LIVE_RETRIES,
+  RELEASE_PATH_PROFILE,
+  resolveDockerE2ePlan,
+} from "../../scripts/lib/docker-e2e-plan.mjs";
+
+const orderLanes = <T>(lanes: T[]) => lanes;
+
+function planFor(
+  overrides: Partial<Parameters<typeof resolveDockerE2ePlan>[0]> = {},
+): ReturnType<typeof resolveDockerE2ePlan>["plan"] {
+  return resolveDockerE2ePlan({
+    includeOpenWebUI: false,
+    liveMode: "all",
+    liveRetries: DEFAULT_LIVE_RETRIES,
+    orderLanes,
+    planReleaseAll: false,
+    profile: "all",
+    releaseChunk: "core",
+    selectedLaneNames: [],
+    timingStore: undefined,
+    ...overrides,
+  }).plan;
+}
+
+describe("scripts/lib/docker-e2e-plan", () => {
+  it("plans the full release path against package-backed e2e images", () => {
+    const plan = planFor({
+      includeOpenWebUI: false,
+      planReleaseAll: true,
+      profile: RELEASE_PATH_PROFILE,
+    });
+
+    expect(plan.needs).toMatchObject({
+      bareImage: true,
+      e2eImage: true,
+      functionalImage: true,
+      liveImage: false,
+      package: true,
+    });
+    expect(plan.credentials).toEqual(["anthropic", "openai"]);
+    expect(plan.lanes.map((lane) => lane.name)).toContain("install-e2e");
+    expect(plan.lanes.map((lane) => lane.name)).toContain("mcp-channels");
+    expect(plan.lanes.map((lane) => lane.name)).not.toContain("openwebui");
+  });
+
+  it("plans a live-only selected lane without package e2e images", () => {
+    const plan = planFor({ selectedLaneNames: ["live-models"] });
+
+    expect(plan.lanes.map((lane) => lane.name)).toEqual(["live-models"]);
+    expect(plan.needs).toMatchObject({
+      bareImage: false,
+      e2eImage: false,
+      functionalImage: false,
+      liveImage: true,
+      package: false,
+    });
+  });
+
+  it("plans Open WebUI as a functional-image lane with OpenAI credentials", () => {
+    const plan = planFor({
+      includeOpenWebUI: true,
+      selectedLaneNames: ["openwebui"],
+    });
+
+    expect(plan.credentials).toEqual(["openai"]);
+    expect(plan.lanes).toEqual([
+      expect.objectContaining({
+        imageKind: "functional",
+        live: false,
+        name: "openwebui",
+      }),
+    ]);
+    expect(plan.needs).toMatchObject({
+      functionalImage: true,
+      package: true,
+    });
+  });
+
+  it("rejects unknown selected lanes with the available lane names", () => {
+    expect(() => planFor({ selectedLaneNames: ["missing-lane"] })).toThrow(
+      /OPENCLAW_DOCKER_ALL_LANES unknown lane\(s\): missing-lane/u,
+    );
+  });
+});