refactor: make v0.3 runtime node-scoped

2026-06-08 22:19:30 +08:00
parent e8ab452b10
commit 187fb80a5d
38 changed files with 549 additions and 450 deletions
@@ -0,0 +1,945 @@
+import assert from "node:assert/strict";
+import { execFile } from "node:child_process";
+import { mkdir, mkdtemp, readFile, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import test from "node:test";
+import { promisify } from "node:util";
+
+import {
+  classifyGlobalChange,
+  componentModelsForServices,
+  createCiPlan,
+  envReuseRecipeForLane,
+  matchingPaths,
+  packageRuntimeFieldsChanged
+} from "./src/ci-plan-lib.mjs";
+import { readStructuredFile, writeStructuredFile } from "./src/structured-config.mjs";
+
+const execFileAsync = promisify(execFile);
+
+const V02_RUNTIME_SERVICE_IDS = Object.freeze([
+  "hwlab-cloud-api",
+  "hwlab-cloud-web",
+  "hwlab-gateway",
+  "hwlab-edge-proxy",
+  "hwlab-agent-skills"
+]);
+
+test("node CI planner maps bridge changes to cloud-api only", async () => {
+  const repo = await createFixtureRepo();
+  await writeFile(path.join(repo, "cmd/hwlab-deepseek-responses-bridge/main.ts"), "console.log('bridge v2');\n");
+  await git(repo, ["add", "."]);
+  await git(repo, ["commit", "-m", "change bridge"]);
+
+  const plan = await planV02CoreServices(repo, { baseRef: "HEAD~1", targetRef: "HEAD" });
+  assert.deepEqual(plan.affectedServices, ["hwlab-cloud-api"]);
+  assert.equal(plan.reusedServices.includes("hwlab-cloud-web"), true);
+  const cloudApi = plan.services.find((service) => service.serviceId === "hwlab-cloud-api");
+  assert.equal(cloudApi.affected, true);
+  assert.deepEqual(cloudApi.reason, ["code-input-changed", "component-path-changed"]);
+});
+
+test("node CI planner treats docs-only changes as no image build", async () => {
+  const repo = await createFixtureRepo();
+  await mkdir(path.join(repo, "docs/reference"), { recursive: true });
+  await writeFile(path.join(repo, "docs/reference/node-gitops-cicd.md"), "docs v2\n");
+  await git(repo, ["add", "."]);
+  await git(repo, ["commit", "-m", "change docs"]);
+
+  const plan = await planV02CoreServices(repo, { baseRef: "HEAD~1", targetRef: "HEAD" });
+  assert.deepEqual(plan.affectedServices, []);
+  assert.equal(plan.imageBuildRequired, false);
+  assert.equal(plan.changedPathSummary.docsOnly, true);
+});
+
+test("planner rebuilds when catalog digest is missing instead of blocking reuse", async () => {
+  const repo = await createFixtureRepo({ catalog: "missing-digest" });
+  await mkdir(path.join(repo, "docs/reference"), { recursive: true });
+  await writeFile(path.join(repo, "docs/reference/node-gitops-cicd.md"), "docs v2\n");
+  await git(repo, ["add", "."]);
+  await git(repo, ["commit", "-m", "change docs"]);
+
+  const plan = await planV02CoreServices(repo, { baseRef: "HEAD~1", targetRef: "HEAD" });
+  assert.deepEqual(plan.affectedServices, ["hwlab-cloud-api", "hwlab-cloud-web"]);
+  assert.equal(plan.imageBuildRequired, true);
+  assert.equal(plan.services.every((service) => service.envChanged === true), true);
+  assert.equal(plan.services.every((service) => service.reuse.status === "not-reused"), true);
+});
+
+test("v02 planner rolls cloud-api service code changes without rebuilding service image", async () => {
+  const repo = await createFixtureRepo();
+  const initialPlan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD",
+    targetRef: "HEAD",
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: ["hwlab-cloud-api", "hwlab-cloud-web"]
+  });
+  const initialCloudApi = initialPlan.services.find((service) => service.serviceId === "hwlab-cloud-api");
+  await writeFile(path.join(repo, "deploy/artifact-catalog.v02.json"), JSON.stringify(createCatalogFixture("ready", {
+    sourceCommitId: initialPlan.sourceCommitId,
+    environmentInputHashes: { "hwlab-cloud-api": initialCloudApi.environmentInputHash },
+    codeInputHashes: { "hwlab-cloud-api": initialCloudApi.codeInputHash },
+    bootCommits: { "hwlab-cloud-api": initialPlan.sourceCommitId }
+  }), null, 2));
+  await git(repo, ["add", "deploy/artifact-catalog.v02.json"]);
+  await git(repo, ["commit", "-m", "seed catalog with current cloud-api env reuse hashes"]);
+
+  await writeFile(path.join(repo, "cmd/hwlab-cloud-api/main.ts"), "console.log('api v2');\n");
+  await git(repo, ["add", "cmd/hwlab-cloud-api/main.ts"]);
+  await git(repo, ["commit", "-m", "change cloud-api service code"]);
+
+  const plan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD~1",
+    targetRef: "HEAD",
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: ["hwlab-cloud-api"]
+  });
+  const cloudApi = plan.services.find((service) => service.serviceId === "hwlab-cloud-api");
+  assert.equal(cloudApi.affected, true);
+  assert.equal(cloudApi.runtimeMode, "env-reuse-git-mirror-checkout");
+  assert.equal(cloudApi.envChanged, false);
+  assert.equal(cloudApi.codeChanged, true);
+  assert.equal(cloudApi.buildRequired, false);
+  assert.deepEqual(cloudApi.reason, ["code-input-changed", "component-path-changed"]);
+  assert.deepEqual(plan.buildServices, []);
+});
+
+test("v02 planner rebuilds env image when an env reuse catalog digest is missing", async () => {
+  const repo = await createFixtureRepo({ catalog: "missing-digest" });
+  await mkdir(path.join(repo, "docs/reference"), { recursive: true });
+  await writeFile(path.join(repo, "docs/reference/node-gitops-cicd.md"), "docs only with missing env digest\n");
+  await git(repo, ["add", "docs/reference/node-gitops-cicd.md"]);
+  await git(repo, ["commit", "-m", "docs after missing env digest"]);
+
+  const plan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD~1",
+    targetRef: "HEAD",
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: ["hwlab-cloud-api"]
+  });
+  const cloudApi = plan.services.find((service) => service.serviceId === "hwlab-cloud-api");
+  assert.equal(cloudApi.affected, true);
+  assert.equal(cloudApi.buildRequired, true);
+  assert.equal(cloudApi.envChanged, true);
+  assert.equal(cloudApi.reuse.status, "not-reused");
+  assert.deepEqual(cloudApi.reason, ["environment-input-changed"]);
+});
+
+test("artifact reuse paths preserve catalog provenance instead of current planner provenance", async () => {
+  const artifactPublish = await readFile("scripts/artifact-publish.mjs", "utf8");
+  assert.match(artifactPublish, /downloadDependencyScript/u);
+  assert.match(artifactPublish, /RUN \$\{downloadEnvPrefix\}\$\{downloadDependencyScript\}/u);
+  assert.match(artifactPublish, /ln -sf "\$\{runtimeRoot\}\/\$bun_bin" \/usr\/local\/bin\/bun/u);
+  assert.doesNotMatch(artifactPublish, /RUN \$\{dependencyScript\}/u);
+  assert.match(artifactPublish, /const catalogProvenance = serviceImageCatalogProvenance\(catalogService\);/u);
+  assert.match(artifactPublish, /\.\.\.catalogProvenance,[\s\S]{0,80}buildBackend: "reused-catalog"/u);
+  assert.match(artifactPublish, /envReuseRecipe: servicePlan\.envReuseRecipe \?\? null/u);
+  assert.match(artifactPublish, /componentInputHash: serviceResultValue\(env, service\.serviceId, "COMPONENT_INPUT_HASH"\) \?\? \(reusedServiceImage \? null : service\.componentInputHash \?\? null\)/u);
+
+  const gitopsRender = await readFile("scripts/gitops-render.mjs", "utf8");
+  assert.match(gitopsRender, /const componentInputHash = envReuse \? \(planned\.componentInputHash \|\| service\.componentInputHash \|\| ""\) : \(service\.componentInputHash \|\| ""\);/u);
+  assert.doesNotMatch(gitopsRender, /"component-input-hash": planned\.componentInputHash \|\| service\.componentInputHash \|\| ""/u);
+});
+
+test("component model uses service paths declared in deploy config", () => {
+  const deploy = createDeployFixture();
+  const models = componentModelsForServices(["hwlab-cloud-api"], deploy.lanes.v02);
+  assert.deepEqual(models[0].componentPaths, [
+    "cmd/hwlab-cloud-api/",
+    "cmd/hwlab-codex-api-responses-forwarder/",
+    "cmd/hwlab-deepseek-responses-bridge/",
+    "deploy/runtime/boot/hwlab-codex-api-responses-forwarder.sh",
+    "deploy/runtime/boot/hwlab-deepseek-responses-bridge.sh",
+    "internal/agent/agentrun-dispatch.mjs",
+    "internal/agent/prompts/",
+    "internal/audit/",
+    "internal/cloud/",
+    "internal/db/",
+    "skills/hwlab-agent-runtime/"
+  ]);
+  assert.deepEqual(models[0].sharedPaths, ["internal/build-metadata.mjs", "internal/protocol/"]);
+  assert.deepEqual(matchingPaths(["cmd/hwlab-cloud-api/main.ts"], models[0].componentPaths), ["cmd/hwlab-cloud-api/main.ts"]);
+});
+
+test("v02 planner rejects missing service declarations instead of falling back to an internal model", async () => {
+  const repo = await createFixtureRepo();
+  const deployPath = path.join(repo, "deploy/deploy.yaml");
+  const deploy = await readStructuredFile(repo, deployPath);
+  delete deploy.lanes.v02.serviceDeclarations;
+  await writeStructuredFile(repo, deployPath, deploy);
+  await git(repo, ["add", "deploy/deploy.yaml"]);
+  await git(repo, ["commit", "-m", "remove v02 declarations"]);
+
+  await assert.rejects(
+    () => createCiPlan({
+      repoRoot: repo,
+      lane: "v02",
+      baseRef: "HEAD~1",
+      targetRef: "HEAD",
+      artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+      services: ["hwlab-cloud-api"]
+    }),
+    /deploy\.lanes\.v02\.serviceDeclarations is required/u
+  );
+});
+
+test("v02 planner rejects missing boot script declarations instead of guessing paths", async () => {
+  const repo = await createFixtureRepo();
+  const deployPath = path.join(repo, "deploy/deploy.yaml");
+  const deploy = await readStructuredFile(repo, deployPath);
+  delete deploy.lanes.v02.bootScripts["hwlab-cloud-api"];
+  await writeStructuredFile(repo, deployPath, deploy);
+  await git(repo, ["add", "deploy/deploy.yaml"]);
+  await git(repo, ["commit", "-m", "remove v02 cloud-api boot script"]);
+
+  await assert.rejects(
+    () => createCiPlan({
+      repoRoot: repo,
+      lane: "v02",
+      baseRef: "HEAD~1",
+      targetRef: "HEAD",
+      artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+      services: ["hwlab-cloud-api"]
+    }),
+    /deploy\.lanes\.v02\.bootScripts\.hwlab-cloud-api is required/u
+  );
+});
+
+test("v02 planner keeps hwpod-spec changes out of runtime service env reuse", async () => {
+  const repo = await createFixtureRepo();
+  await writeFile(path.join(repo, ".hwlab/hwpod-spec.yaml"), "kind: Hwpod\nmetadata:\n  name: changed-preinstalled\nspec:\n  nodeBinding:\n    nodeId: node-changed\n  workspace:\n    path: F:\\\\Work\\\\D601-HWLAB\n  targetDevice:\n    board: D601-F103-V2\n  debugProbe:\n    type: daplink\n  ioProbe:\n    uart:\n      port: COM9\n", "utf8");
+  await git(repo, ["add", ".hwlab/hwpod-spec.yaml"]);
+  await git(repo, ["commit", "-m", "change preinstalled hwpod spec"]);
+
+  const plan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD~1",
+    targetRef: "HEAD",
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: ["hwlab-cloud-api", "hwlab-cloud-web"]
+  });
+  assert.deepEqual(plan.affectedServices, []);
+  assert.deepEqual(plan.buildServices, []);
+  assert.equal(plan.services.find((service) => service.serviceId === "hwlab-cloud-api").affected, false);
+  assert.equal(plan.services.find((service) => service.serviceId === "hwlab-cloud-web").affected, false);
+});
+
+test("v02 planner treats AgentRun runtime prompt changes as cloud-api inputs", async () => {
+  const repo = await createFixtureRepo();
+  await mkdir(path.join(repo, "internal/agent/prompts"), { recursive: true });
+  await writeFile(path.join(repo, "internal/agent/agentrun-dispatch.mjs"), "export const prompt = true;\n");
+  await writeFile(path.join(repo, "internal/agent/prompts/hwlab-v02-runtime.md"), "prompt v1\n");
+  await git(repo, ["add", "."]);
+  await git(repo, ["commit", "-m", "seed agentrun prompt"]);
+  const initialSha = (await git(repo, ["rev-parse", "HEAD"])).stdout.trim();
+  const initialPlan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD",
+    targetRef: initialSha,
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: ["hwlab-cloud-api", "hwlab-cloud-web"]
+  });
+  const initialCloudWeb = initialPlan.services.find((service) => service.serviceId === "hwlab-cloud-web");
+  await writeFile(path.join(repo, "deploy/artifact-catalog.v02.json"), JSON.stringify(createCatalogFixture("ready", catalogOptionsFromPlan(initialPlan, {
+    cloudWebEnvironmentInputHash: initialCloudWeb.environmentInputHash,
+    cloudWebCodeInputHash: initialCloudWeb.codeInputHash,
+    cloudWebBootCommit: initialPlan.sourceCommitId
+  })), null, 2));
+  await git(repo, ["add", "deploy/artifact-catalog.v02.json"]);
+  await git(repo, ["commit", "-m", "seed v02 catalog with agentrun prompt"]);
+
+  await writeFile(path.join(repo, "internal/agent/prompts/hwlab-v02-runtime.md"), "prompt v2\n");
+  await git(repo, ["add", "internal/agent/prompts/hwlab-v02-runtime.md"]);
+  await git(repo, ["commit", "-m", "change agentrun prompt"]);
+
+  const plan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD~1",
+    targetRef: "HEAD",
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: ["hwlab-cloud-api", "hwlab-cloud-web"]
+  });
+  assert.deepEqual(plan.affectedServices, ["hwlab-cloud-api"]);
+  assert.deepEqual(plan.buildServices, []);
+  assert.deepEqual(plan.rolloutServices, ["hwlab-cloud-api"]);
+  const cloudApi = plan.services.find((service) => service.serviceId === "hwlab-cloud-api");
+  assert.deepEqual(cloudApi.changedPaths, ["internal/agent/prompts/hwlab-v02-runtime.md"]);
+  assert.equal(cloudApi.envChanged, false);
+  assert.equal(cloudApi.codeChanged, true);
+  assert.deepEqual(cloudApi.reason, ["code-input-changed", "component-path-changed"]);
+});
+
+test("planner scopes cloud-web runtime changes to cloud-web", async () => {
+  const repo = await createFixtureRepo();
+  await writeFile(path.join(repo, "internal/dev-entrypoint/cloud-web-runtime.mjs"), "export const runtime = 2;\n");
+  await git(repo, ["add", "."]);
+  await git(repo, ["commit", "-m", "change cloud web runtime"]);
+
+  const plan = await planV02CoreServices(repo, { baseRef: "HEAD~1", targetRef: "HEAD" });
+  assert.deepEqual(plan.affectedServices, ["hwlab-cloud-web"]);
+  assert.equal(plan.services.some((service) => service.serviceId === "hwlab-agent-worker"), false);
+  const cloudWeb = plan.services.find((service) => service.serviceId === "hwlab-cloud-web");
+  assert.deepEqual(cloudWeb.reason, ["code-input-changed", "component-path-changed"]);
+});
+
+test("v02 planner treats shared trace renderer changes as cloud-web code rollout inputs", async () => {
+  const repo = await createFixtureRepo();
+  const initialSha = (await git(repo, ["rev-parse", "HEAD"])).stdout.trim();
+  const initialPlan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD",
+    targetRef: initialSha,
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: ["hwlab-cloud-api", "hwlab-cloud-web"]
+  });
+  const initialCloudWeb = initialPlan.services.find((service) => service.serviceId === "hwlab-cloud-web");
+  await writeFile(path.join(repo, "deploy/artifact-catalog.v02.json"), JSON.stringify(createCatalogFixture("ready", catalogOptionsFromPlan(initialPlan, {
+    cloudWebEnvironmentInputHash: initialCloudWeb.environmentInputHash,
+    cloudWebCodeInputHash: initialCloudWeb.codeInputHash,
+    cloudWebBootCommit: initialPlan.sourceCommitId
+  })), null, 2));
+  await git(repo, ["add", "deploy/artifact-catalog.v02.json"]);
+  await git(repo, ["commit", "-m", "seed v02 catalog with trace renderer"]);
+
+  await mkdir(path.join(repo, "tools/src/hwlab-cli"), { recursive: true });
+  await writeFile(path.join(repo, "tools/src/hwlab-cli/trace-renderer.ts"), "export const traceRenderer = 2;\n");
+  await git(repo, ["add", "tools/src/hwlab-cli/trace-renderer.ts"]);
+  await git(repo, ["commit", "-m", "change shared trace renderer"]);
+
+  const plan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD~1",
+    targetRef: "HEAD",
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: ["hwlab-cloud-api", "hwlab-cloud-web"]
+  });
+  const cloudApi = plan.services.find((service) => service.serviceId === "hwlab-cloud-api");
+  const cloudWeb = plan.services.find((service) => service.serviceId === "hwlab-cloud-web");
+  assert.deepEqual(plan.affectedServices, ["hwlab-cloud-web"]);
+  assert.deepEqual(plan.rolloutServices, ["hwlab-cloud-web"]);
+  assert.deepEqual(plan.buildServices, []);
+  assert.equal(cloudApi.affected, false);
+  assert.equal(cloudWeb.codeChanged, true);
+  assert.deepEqual(cloudWeb.codeChangedPaths, ["tools/src/hwlab-cli/trace-renderer.ts"]);
+  assert.deepEqual(cloudWeb.reason, ["code-input-changed", "component-path-changed"]);
+});
+
+test("planner ignores package script cleanup for runtime images", async () => {
+  const repo = await createFixtureRepo();
+  await writeFile(path.join(repo, "package.json"), JSON.stringify({
+    type: "module",
+    scripts: {
+      validate: "node scripts/check-runner.mjs --profile validate"
+    },
+    dependencies: {
+      "@openai/codex": "^0.128.0"
+    }
+  }, null, 2));
+  await git(repo, ["add", "package.json"]);
+  await git(repo, ["commit", "-m", "seed package scripts"]);
+  await refreshFixtureCatalogForHead(repo);
+
+  await writeFile(path.join(repo, "package.json"), JSON.stringify({
+    type: "module",
+    scripts: {
+      validate: "node scripts/check-runner.mjs --profile validate",
+      check: "node scripts/check-runner.mjs --profile check"
+    },
+    dependencies: {
+      "@openai/codex": "^0.128.0"
+    }
+  }, null, 2));
+  await git(repo, ["add", "package.json"]);
+  await git(repo, ["commit", "-m", "change package scripts"]);
+
+  assert.equal(await packageRuntimeFieldsChanged(repo, "HEAD~1", "HEAD"), false);
+  const plan = await planV02CoreServices(repo, { baseRef: "HEAD~1", targetRef: "HEAD" });
+  assert.deepEqual(plan.affectedServices, []);
+  assert.deepEqual(plan.buildServices, []);
+  assert.equal(plan.imageBuildRequired, false);
+  assert.equal(plan.buildSkippedCount, 2);
+});
+
+test("planner treats dependency changes as runtime image inputs", async () => {
+  const repo = await createFixtureRepo();
+  await writeFile(path.join(repo, "package.json"), JSON.stringify({
+    type: "module",
+    dependencies: {
+      "@openai/codex": "^0.128.0"
+    }
+  }, null, 2));
+  await git(repo, ["add", "package.json"]);
+  await git(repo, ["commit", "-m", "seed dependencies"]);
+
+  await writeFile(path.join(repo, "package.json"), JSON.stringify({
+    type: "module",
+    dependencies: {
+      "@openai/codex": "^0.129.0"
+    }
+  }, null, 2));
+  await git(repo, ["add", "package.json"]);
+  await git(repo, ["commit", "-m", "change dependencies"]);
+
+  assert.equal(await packageRuntimeFieldsChanged(repo, "HEAD~1", "HEAD"), true);
+  const plan = await planV02CoreServices(repo, { baseRef: "HEAD~1", targetRef: "HEAD" });
+  assert.deepEqual(plan.affectedServices, ["hwlab-cloud-api", "hwlab-cloud-web"]);
+  assert.equal(plan.imageBuildRequired, true);
+});
+
+test("global change classifier distinguishes gitops-only and test-only", () => {
+  assert.equal(classifyGlobalChange(["deploy/gitops/node/runtime-dev/workloads.yaml"]).gitopsOnly, true);
+  assert.equal(classifyGlobalChange(["cmd/hwlab-cloud-api/runtime-options.test.ts"]).testOnly, true);
+});
+
+test("v02 planner marks cloud-web code-only change as env reuse rollout", async () => {
+  const repo = await createFixtureRepo();
+  const initialSha = (await git(repo, ["rev-parse", "HEAD"])).stdout.trim();
+  const initialPlan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD",
+    targetRef: initialSha,
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: ["hwlab-cloud-web"]
+  });
+  const initialCloudWeb = initialPlan.services.find((service) => service.serviceId === "hwlab-cloud-web");
+  await writeFile(path.join(repo, "deploy/artifact-catalog.v02.json"), JSON.stringify(createCatalogFixture("ready", {
+    cloudWebEnvironmentInputHash: initialCloudWeb.environmentInputHash,
+    cloudWebCodeInputHash: initialCloudWeb.codeInputHash,
+    cloudWebBootCommit: initialPlan.sourceCommitId
+  }), null, 2));
+  await git(repo, ["add", "deploy/artifact-catalog.v02.json"]);
+  await git(repo, ["commit", "-m", "seed v02 cloud web catalog"]);
+
+  await writeFile(path.join(repo, "web/hwlab-cloud-web/index.html"), "<html>v2</html>\n");
+  await git(repo, ["add", "."]);
+  await git(repo, ["commit", "-m", "change cloud web code"]);
+
+  const plan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD~1",
+    targetRef: "HEAD",
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: ["hwlab-cloud-web"]
+  });
+  const cloudWeb = plan.services.find((service) => service.serviceId === "hwlab-cloud-web");
+  assert.equal(cloudWeb.runtimeMode, "env-reuse-git-mirror-checkout");
+  assert.equal(cloudWeb.envChanged, false);
+  assert.equal(cloudWeb.codeChanged, true);
+  assert.equal(cloudWeb.buildRequired, false);
+  assert.equal(cloudWeb.bootSh, "deploy/runtime/boot/hwlab-cloud-web.sh");
+  assert.deepEqual(plan.affectedServices, ["hwlab-cloud-web"]);
+  assert.deepEqual(plan.rolloutServices, ["hwlab-cloud-web"]);
+  assert.deepEqual(plan.buildServices, []);
+  assert.equal(plan.imageBuildRequired, false);
+  assert.equal(plan.ciCdPlan.noImageBuildReason, "env-reuse-code-only-rollout");
+});
+
+test("v02 planner enables env reuse for all retained runtime services", async () => {
+  const repo = await createFixtureRepo({ serviceIds: V02_RUNTIME_SERVICE_IDS });
+  const initialSha = (await git(repo, ["rev-parse", "HEAD"])).stdout.trim();
+  const initialPlan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD",
+    targetRef: initialSha,
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: V02_RUNTIME_SERVICE_IDS
+  });
+  const environmentInputHashes = Object.fromEntries(initialPlan.services.map((service) => [service.serviceId, service.environmentInputHash]));
+  const codeInputHashes = Object.fromEntries(initialPlan.services.map((service) => [service.serviceId, service.codeInputHash]));
+  const bootCommits = Object.fromEntries(initialPlan.services.map((service) => [service.serviceId, initialPlan.sourceCommitId]));
+  await writeFile(path.join(repo, "deploy/artifact-catalog.v02.json"), JSON.stringify(createCatalogFixture("ready", {
+    sourceCommitId: initialPlan.sourceCommitId,
+    environmentInputHashes,
+    codeInputHashes,
+    bootCommits,
+    serviceIds: V02_RUNTIME_SERVICE_IDS
+  }), null, 2));
+  await git(repo, ["add", "deploy/artifact-catalog.v02.json"]);
+  await git(repo, ["commit", "-m", "seed all v02 env reuse catalogs"]);
+
+  await writeFile(path.join(repo, "cmd/hwlab-cloud-api/main.ts"), "console.log('api v2');\n");
+  await writeFile(path.join(repo, "web/hwlab-cloud-web/index.html"), "<html>v2</html>\n");
+  await writeFile(path.join(repo, "cmd/hwlab-gateway/main.ts"), "console.log('gateway v2');\n");
+  await writeFile(path.join(repo, "cmd/hwlab-edge-proxy/main.ts"), "console.log('edge v2');\n");
+  await writeFile(path.join(repo, "skills/hwlab-agent-runtime/SKILL.md"), "agent runtime skill v2\n");
+  await git(repo, ["add", "."]);
+  await git(repo, ["commit", "-m", "change all v02 service code"]);
+
+  const plan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD~1",
+    targetRef: "HEAD",
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: V02_RUNTIME_SERVICE_IDS
+  });
+  assert.deepEqual(plan.compatibility.v02EnvReuseServiceIds, V02_RUNTIME_SERVICE_IDS);
+  assert.deepEqual(plan.affectedServices, sortedServiceIds(V02_RUNTIME_SERVICE_IDS));
+  assert.deepEqual(plan.rolloutServices, sortedServiceIds(V02_RUNTIME_SERVICE_IDS));
+  assert.deepEqual(plan.buildServices, []);
+  assert.equal(plan.imageBuildRequired, false);
+  for (const service of plan.services) {
+    assert.equal(service.runtimeMode, "env-reuse-git-mirror-checkout", service.serviceId);
+    assert.equal(service.envReuse, true, service.serviceId);
+    assert.equal(service.envChanged, false, service.serviceId);
+    assert.equal(service.codeChanged, true, service.serviceId);
+    assert.equal(service.buildRequired, false, service.serviceId);
+    assert.equal(service.bootSh, `deploy/runtime/boot/${service.serviceId}.sh`, service.serviceId);
+  }
+});
+
+test("v02 planner rejects removed HWLAB-owned agent worker service selections", async () => {
+  const repo = await createFixtureRepo();
+  await assert.rejects(
+    () => createCiPlan({
+      repoRoot: repo,
+      lane: "v02",
+      baseRef: "HEAD",
+      targetRef: "HEAD",
+      artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+      services: ["hwlab-agent-worker"]
+    }),
+    /unknown service IDs for node CI plan: hwlab-agent-worker/u
+  );
+});
+
+test("v02 planner keeps hwlab-cli-only changes out of runtime service builds", async () => {
+  const repo = await createFixtureRepo();
+  const initialSha = (await git(repo, ["rev-parse", "HEAD"])).stdout.trim();
+  const initialPlan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD",
+    targetRef: initialSha,
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: ["hwlab-cloud-api", "hwlab-cloud-web", "hwlab-agent-skills"]
+  });
+  await writeFile(path.join(repo, "deploy/artifact-catalog.v02.json"), JSON.stringify(createCatalogFixture("ready", catalogOptionsFromPlan(initialPlan)), null, 2));
+  await git(repo, ["add", "deploy/artifact-catalog.v02.json"]);
+  await git(repo, ["commit", "-m", "seed v02 catalog"]);
+
+  await writeFile(path.join(repo, "tools/src/hwlab-cli-lib.ts"), "export const harness = true;\n");
+  await writeFile(path.join(repo, "package.json"), JSON.stringify({
+    type: "module",
+    scripts: {
+      validate: "node scripts/check-runner.mjs --profile validate",
+      check: "node scripts/check-runner.mjs --profile check"
+    }
+  }, null, 2));
+  await git(repo, ["add", "."]);
+  await git(repo, ["commit", "-m", "change cli and host asset"]);
+
+  const plan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD~1",
+    targetRef: "HEAD",
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: ["hwlab-cloud-api", "hwlab-cloud-web", "hwlab-agent-skills"]
+  });
+  assert.deepEqual(plan.buildServices, []);
+  assert.deepEqual(plan.affectedServices, []);
+  assert.equal(plan.buildSkippedCount, 3);
+  assert.equal(plan.services.find((service) => service.serviceId === "hwlab-cloud-api").affected, false);
+});
+
+test("v02 planner scopes hwpod skill bundle changes to the skills service", async () => {
+  const repo = await createFixtureRepo();
+  const initialSha = (await git(repo, ["rev-parse", "HEAD"])).stdout.trim();
+  const initialPlan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD",
+    targetRef: initialSha,
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: ["hwlab-cloud-api", "hwlab-cloud-web", "hwlab-agent-skills"]
+  });
+  await writeFile(path.join(repo, "deploy/artifact-catalog.v02.json"), JSON.stringify(createCatalogFixture("ready", catalogOptionsFromPlan(initialPlan)), null, 2));
+  await git(repo, ["add", "deploy/artifact-catalog.v02.json"]);
+  await git(repo, ["commit", "-m", "seed v02 catalog"]);
+
+  await writeFile(path.join(repo, "tools/src/hwpod-harness-lib.ts"), "export const hwpod = true;\n");
+  await writeFile(path.join(repo, "skills/hwpod-cli/SKILL.md"), "hwpod skill v2\n");
+  await git(repo, ["add", "."]);
+  await git(repo, ["commit", "-m", "change hwpod runtime cli"]);
+
+  const plan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD~1",
+    targetRef: "HEAD",
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: ["hwlab-cloud-api", "hwlab-cloud-web", "hwlab-agent-skills"]
+  });
+  assert.deepEqual(plan.affectedServices, ["hwlab-agent-skills"]);
+  assert.deepEqual(plan.buildServices, []);
+  assert.equal(plan.services.find((service) => service.serviceId === "hwlab-cloud-api").affected, false);
+  assert.equal(plan.services.find((service) => service.serviceId === "hwlab-cloud-web").affected, false);
+  const skillsService = plan.services.find((service) => service.serviceId === "hwlab-agent-skills");
+  assert.equal(skillsService.codeChanged, true);
+  assert.equal(skillsService.envChanged, false);
+  assert.deepEqual(skillsService.reason, ["code-input-changed", "component-path-changed"]);
+});
+
+test("v02 planner reads env reuse declarations and recipe from deploy config", async () => {
+  const deploy = createDeployFixture();
+  deploy.lanes.v02.serviceDeclarations["hwlab-cloud-web"].componentPaths.push("custom/web-plugin/");
+  deploy.lanes.v02.envRecipe.bunVersion = "1.3.14";
+  deploy.lanes.v02.envRecipe.additionalEnvPaths.push("custom/env-tool.mjs");
+
+  const models = componentModelsForServices(["hwlab-cloud-web"], deploy.lanes.v02);
+  assert.equal(models[0].runtimeKind, "cloud-web");
+  assert.equal(models[0].entrypoint, "web/hwlab-cloud-web/index.html");
+  assert.equal(models[0].componentPaths.includes("custom/web-plugin/"), true);
+  assert.equal(models[0].buildSystemPaths.includes("custom/env-tool.mjs"), true);
+
+  const recipe = envReuseRecipeForLane(deploy, "v02");
+  assert.equal(recipe.bunVersion, "1.3.14");
+  assert.equal(recipe.downloadStack.npmRegistry, "https://registry.npmjs.org/");
+  assert.equal(recipe.downloadStack.bunPackages.x64, "@oven/bun-linux-x64");
+  assert.equal(recipe.launcherInputPaths.includes("deploy/runtime/launcher/hwlab-env-reuse-launcher.ts"), true);
+  assert.equal(recipe.launcherInputPaths.includes("custom/env-tool.mjs"), true);
+});
+
+test("v03 planner reads env reuse declarations and catalog from v03 lane config", async () => {
+  const repo = await createFixtureRepo();
+
+  const plan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v03",
+    baseRef: "HEAD",
+    targetRef: "HEAD",
+    services: ["hwlab-cloud-api", "hwlab-cloud-web"]
+  });
+
+  assert.equal(plan.compatibility.lane, "v03");
+  assert.equal(plan.compatibility.artifactCatalog, "deploy/artifact-catalog.v03.json");
+  assert.equal(plan.compatibility.serviceIdSource, "cli-services");
+  assert.equal(plan.compatibility.serviceDeclarationSource, "deploy.lanes.v03.serviceDeclarations");
+  assert.equal(plan.compatibility.envRecipeSource, "deploy.lanes.v03.envRecipe");
+  assert.deepEqual(plan.compatibility.envReuseServiceIds, ["hwlab-cloud-api", "hwlab-cloud-web"]);
+  assert.equal(plan.services.every((service) => service.envReuseRecipe.downloadStack.npmFetchTimeoutMs === 300000), true);
+  for (const service of plan.services) {
+    assert.equal(service.runtimeMode, "env-reuse-git-mirror-checkout", service.serviceId);
+    assert.equal(service.envReuse, true, service.serviceId);
+    assert.equal(service.bootRepo, "git@github.com:pikasTech/HWLAB.git", service.serviceId);
+    assert.equal(service.bootSh, `deploy/runtime/boot/${service.serviceId}.sh`, service.serviceId);
+  }
+});
+
+async function createFixtureRepo(options = {}) {
+  const serviceIds = options.serviceIds ?? ["hwlab-cloud-api", "hwlab-cloud-web"];
+  const laneServiceIds = options.laneServiceIds ?? V02_RUNTIME_SERVICE_IDS;
+  const repo = await mkdtemp(path.join(os.tmpdir(), "hwlab-ci-plan-"));
+  await mkdir(path.join(repo, "cmd/hwlab-cloud-api"), { recursive: true });
+  await mkdir(path.join(repo, "cmd/hwlab-codex-api-responses-forwarder"), { recursive: true });
+  await mkdir(path.join(repo, "cmd/hwlab-deepseek-responses-bridge"), { recursive: true });
+  await mkdir(path.join(repo, "cmd/hwlab-gateway"), { recursive: true });
+  await mkdir(path.join(repo, "cmd/hwlab-edge-proxy"), { recursive: true });
+  await mkdir(path.join(repo, "web/hwlab-cloud-web"), { recursive: true });
+  await mkdir(path.join(repo, "internal/dev-entrypoint"), { recursive: true });
+  await mkdir(path.join(repo, "internal/sim"), { recursive: true });
+  await mkdir(path.join(repo, "tools/hwlab-cli"), { recursive: true });
+  await mkdir(path.join(repo, "tools/src"), { recursive: true });
+  await mkdir(path.join(repo, "skills/hwpod-cli"), { recursive: true });
+  await mkdir(path.join(repo, "skills/hwpod-ctl"), { recursive: true });
+  await mkdir(path.join(repo, "skills/hwlab-agent-runtime"), { recursive: true });
+  await mkdir(path.join(repo, ".hwlab"), { recursive: true });
+  await mkdir(path.join(repo, "deploy/runtime/boot"), { recursive: true });
+  await mkdir(path.join(repo, "deploy/runtime/launcher"), { recursive: true });
+  await mkdir(path.join(repo, "deploy"), { recursive: true });
+  await writeStructuredFile(repo, "deploy/deploy.yaml", createDeployFixture({ serviceIds: laneServiceIds }));
+  const catalogMode = options.catalog ?? "ready";
+  await writeFile(path.join(repo, "package.json"), JSON.stringify({ type: "module" }, null, 2));
+  await writeFile(path.join(repo, "package-lock.json"), JSON.stringify({ lockfileVersion: 3 }, null, 2));
+  await writeFile(path.join(repo, "cmd/hwlab-cloud-api/main.ts"), "console.log('api');\n");
+  await writeFile(path.join(repo, "cmd/hwlab-codex-api-responses-forwarder/main.ts"), "console.log('forwarder');\n");
+  await writeFile(path.join(repo, "cmd/hwlab-deepseek-responses-bridge/main.ts"), "console.log('bridge');\n");
+  await writeFile(path.join(repo, "cmd/hwlab-deepseek-responses-bridge/main.test.ts"), "console.log('test');\n");
+  await writeFile(path.join(repo, "cmd/hwlab-gateway/main.ts"), "console.log('gateway');\n");
+  await writeFile(path.join(repo, "cmd/hwlab-edge-proxy/main.ts"), "console.log('edge');\n");
+  await writeFile(path.join(repo, "web/hwlab-cloud-web/index.html"), "<html></html>\n");
+  await writeFile(path.join(repo, "internal/dev-entrypoint/artifact-runtime.mjs"), "export const artifactRuntime = 1;\n");
+  await writeFile(path.join(repo, "internal/dev-entrypoint/cloud-web-runtime.mjs"), "export const runtime = 1;\n");
+  await writeFile(path.join(repo, "internal/dev-entrypoint/cloud-web-proxy.mjs"), "export const proxy = 1;\n");
+  await writeFile(path.join(repo, "internal/dev-entrypoint/cloud-web-routes.mjs"), "export const routes = 1;\n");
+  await writeFile(path.join(repo, "internal/dev-entrypoint/http.mjs"), "export const http = 1;\n");
+  await writeFile(path.join(repo, "internal/sim/http.mjs"), "export const simHttp = 1;\n");
+  await writeFile(path.join(repo, "tools/hwpod-cli.ts"), "console.log('hwpod cli');\n");
+  await writeFile(path.join(repo, "tools/hwpod-ctl.ts"), "console.log('hwpod ctl');\n");
+  await writeFile(path.join(repo, "tools/hwpod-compiler-cli.ts"), "console.log('hwpod compiler');\n");
+  await writeFile(path.join(repo, "tools/hwpod-node.ts"), "console.log('hwpod node');\n");
+  await writeFile(path.join(repo, "tools/src/hwpod-harness-lib.ts"), "export const hwpod = false;\n");
+  await writeFile(path.join(repo, "tools/src/hwpod-node-lib.ts"), "export const node = true;\n");
+  await writeFile(path.join(repo, "tools/src/hwpod-node-ops-contract.ts"), "export const ops = true;\n");
+  await writeFile(path.join(repo, "tools/src/runtime-endpoint-resolver.ts"), "export const endpoint = true;\n");
+  await writeFile(path.join(repo, "skills/hwpod-cli/SKILL.md"), "hwpod cli skill\n");
+  await writeFile(path.join(repo, "skills/hwpod-ctl/SKILL.md"), "hwpod ctl skill\n");
+  await writeFile(path.join(repo, ".hwlab/hwpod-spec.yaml"), "kind: Hwpod\nmetadata:\n  name: d601-f103-v2\nspec:\n  nodeBinding:\n    nodeId: node-d601-f103-v2\n  workspace:\n    path: F:\\\\Work\\\\D601-HWLAB\n  targetDevice:\n    board: D601-F103-V2\n  debugProbe:\n    type: daplink\n  ioProbe:\n    uart:\n      port: COM9\n");
+  await writeFile(path.join(repo, "deploy/runtime/boot/hwlab-cloud-web.sh"), "#!/bin/sh\nbun run --cwd web/hwlab-cloud-web build\nexec bun .hwlab-cloud-web-runtime.mjs\n");
+  await writeFile(path.join(repo, "deploy/runtime/boot/hwlab-cloud-api.sh"), "#!/bin/sh\nexec bun run cmd/hwlab-cloud-api/main.ts\n");
+  await writeFile(path.join(repo, "deploy/runtime/boot/hwlab-codex-api-responses-forwarder.sh"), "#!/bin/sh\nexec bun run cmd/hwlab-codex-api-responses-forwarder/main.ts\n");
+  await writeFile(path.join(repo, "deploy/runtime/boot/hwlab-deepseek-responses-bridge.sh"), "#!/bin/sh\nexec bun run cmd/hwlab-deepseek-responses-bridge/main.ts\n");
+  await writeFile(path.join(repo, "deploy/runtime/boot/hwlab-gateway.sh"), "#!/bin/sh\nexec bun run cmd/hwlab-gateway/main.ts\n");
+  await writeFile(path.join(repo, "deploy/runtime/boot/hwlab-edge-proxy.sh"), "#!/bin/sh\nexec bun run cmd/hwlab-edge-proxy/main.ts\n");
+  await writeFile(path.join(repo, "deploy/runtime/boot/hwlab-agent-skills.sh"), "#!/bin/sh\nexec bun .hwlab-agent-skills-runtime.mjs\n");
+  await writeFile(path.join(repo, "deploy/runtime/launcher/hwlab-env-reuse-launcher.ts"), "console.log('launcher');\n");
+  await writeFile(path.join(repo, "skills/hwlab-agent-runtime/SKILL.md"), "agent runtime skill\n");
+  await git(repo, ["init"]);
+  await git(repo, ["add", "."]);
+  await git(repo, ["commit", "-m", "initial"]);
+  if (catalogMode !== false) {
+    const initialSha = (await git(repo, ["rev-parse", "HEAD"])).stdout.trim();
+    const initialPlan = await createCiPlan({
+      repoRoot: repo,
+      lane: "v02",
+      baseRef: "HEAD",
+      targetRef: "HEAD",
+      artifactCatalogPath: "deploy/nonexistent-artifact-catalog.json",
+      services: serviceIds
+    });
+    const catalog = createCatalogFixture(catalogMode, catalogOptionsFromPlan(initialPlan, { sourceCommitId: initialSha, serviceIds }));
+    await writeFile(path.join(repo, "deploy/artifact-catalog.dev.json"), JSON.stringify(catalog, null, 2));
+    await writeFile(path.join(repo, "deploy/artifact-catalog.v02.json"), JSON.stringify(catalog, null, 2));
+    await writeFile(path.join(repo, "deploy/artifact-catalog.v03.json"), JSON.stringify(catalog, null, 2));
+    await git(repo, ["add", "deploy/artifact-catalog.dev.json", "deploy/artifact-catalog.v02.json", "deploy/artifact-catalog.v03.json"]);
+    await git(repo, ["commit", "-m", "seed artifact catalogs"]);
+  }
+  return repo;
+}
+
+async function refreshFixtureCatalogForHead(repo) {
+  const sourceCommitId = (await git(repo, ["rev-parse", "HEAD"])).stdout.trim();
+  const services = ["hwlab-cloud-api", "hwlab-cloud-web"];
+  const plan = await createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    baseRef: "HEAD",
+    targetRef: "HEAD",
+    artifactCatalogPath: "deploy/nonexistent-artifact-catalog.json",
+    services
+  });
+  const catalog = createCatalogFixture("ready", catalogOptionsFromPlan(plan, { sourceCommitId, serviceIds: services }));
+  await writeFile(path.join(repo, "deploy/artifact-catalog.dev.json"), JSON.stringify(catalog, null, 2));
+  await writeFile(path.join(repo, "deploy/artifact-catalog.v02.json"), JSON.stringify(catalog, null, 2));
+  await writeFile(path.join(repo, "deploy/artifact-catalog.v03.json"), JSON.stringify(catalog, null, 2));
+  await git(repo, ["add", "deploy/artifact-catalog.dev.json", "deploy/artifact-catalog.v02.json", "deploy/artifact-catalog.v03.json"]);
+  await git(repo, ["commit", "-m", "refresh fixture artifact catalogs"]);
+}
+
+function planV02CoreServices(repo, options) {
+  return createCiPlan({
+    repoRoot: repo,
+    lane: "v02",
+    artifactCatalogPath: "deploy/artifact-catalog.v02.json",
+    services: ["hwlab-cloud-api", "hwlab-cloud-web"],
+    ...options
+  });
+}
+
+function createDeployFixture({ serviceIds = V02_RUNTIME_SERVICE_IDS } = {}) {
+  const v02 = {
+        sourceRepo: "git@github.com:pikasTech/HWLAB.git",
+        artifactCatalog: "deploy/artifact-catalog.v02.json",
+        envReuseServices: [...serviceIds],
+        bootScripts: {
+          "hwlab-cloud-api": "deploy/runtime/boot/hwlab-cloud-api.sh",
+          "hwlab-cloud-web": "deploy/runtime/boot/hwlab-cloud-web.sh",
+          "hwlab-gateway": "deploy/runtime/boot/hwlab-gateway.sh",
+          "hwlab-edge-proxy": "deploy/runtime/boot/hwlab-edge-proxy.sh",
+          "hwlab-agent-skills": "deploy/runtime/boot/hwlab-agent-skills.sh"
+        },
+        serviceDeclarations: {
+          "hwlab-cloud-api": {
+            runtimeKind: "bun-command",
+            entrypoint: "cmd/hwlab-cloud-api/main.ts",
+            artifactKind: "bun-command",
+            healthPath: "/health/live",
+            healthPort: 6667,
+            componentPaths: [
+              "cmd/hwlab-cloud-api/",
+              "cmd/hwlab-codex-api-responses-forwarder/",
+              "cmd/hwlab-deepseek-responses-bridge/",
+              "deploy/runtime/boot/hwlab-codex-api-responses-forwarder.sh",
+              "deploy/runtime/boot/hwlab-deepseek-responses-bridge.sh",
+              "internal/cloud/",
+              "internal/db/",
+              "internal/audit/",
+              "internal/agent/agentrun-dispatch.mjs",
+              "internal/agent/prompts/",
+              "skills/hwlab-agent-runtime/"
+            ],
+            env: {},
+            observable: true
+          },
+          "hwlab-cloud-web": {
+            runtimeKind: "cloud-web",
+            entrypoint: "web/hwlab-cloud-web/index.html",
+            artifactKind: "cloud-web",
+            healthPath: "/health/live",
+            healthPort: 8080,
+            componentPaths: [
+              "web/hwlab-cloud-web/",
+              "internal/dev-entrypoint/cloud-web-runtime.mjs",
+              "internal/dev-entrypoint/cloud-web-proxy.mjs",
+              "internal/dev-entrypoint/cloud-web-routes.mjs",
+              "tools/src/hwlab-cli/trace-renderer.ts"
+            ],
+            env: {},
+            observable: true
+          },
+          "hwlab-gateway": {
+            runtimeKind: "bun-command",
+            entrypoint: "cmd/hwlab-gateway/main.ts",
+            artifactKind: "bun-command",
+            healthPath: "/health/live",
+            healthPort: 7001,
+            componentPaths: ["cmd/hwlab-gateway/", "internal/sim/"],
+            env: {},
+            observable: false
+          },
+          "hwlab-edge-proxy": {
+            runtimeKind: "bun-command",
+            entrypoint: "cmd/hwlab-edge-proxy/main.ts",
+            artifactKind: "bun-command",
+            healthPath: "/health",
+            healthPort: 6667,
+            componentPaths: ["cmd/hwlab-edge-proxy/", "internal/dev-entrypoint/http.mjs"],
+            env: {},
+            observable: true
+          },
+          "hwlab-agent-skills": {
+            runtimeKind: "skills-bundle",
+            entrypoint: "skills/hwlab-agent-runtime/SKILL.md",
+            artifactKind: "skills-bundle",
+            healthPath: "/health/live",
+            healthPort: 7430,
+            componentPaths: ["skills/"],
+            env: {},
+            observable: true
+          }
+        },
+        envRecipe: {
+          osPackages: ["ca-certificates", "git"],
+          bunVersion: "1.3.13",
+          downloadStack: {
+            httpProxy: "http://127.0.0.1:10808",
+            httpsProxy: "http://127.0.0.1:10808",
+            noProxy: ["127.0.0.1", "localhost", "::1", "hyueapi.com", ".hyueapi.com"],
+            npmRegistry: "https://registry.npmjs.org/",
+            npmFetchTimeoutMs: 300000,
+            bunPackages: {
+              x64: "@oven/bun-linux-x64",
+              arm64: "@oven/bun-linux-aarch64"
+            }
+          },
+          launcherPath: "deploy/runtime/launcher/hwlab-env-reuse-launcher.ts",
+          runtimeNodeModulesPath: "/opt/hwlab-env/node_modules",
+          additionalEnvPaths: [
+            "internal/dev-entrypoint/artifact-runtime.mjs",
+            "scripts/artifact-publish.mjs",
+            "scripts/src/dev-artifact-services.mjs"
+          ],
+          hwpodAliases: [
+            { command: "hwpod", script: "tools/hwpod-cli.ts" },
+            { command: "hwpod-ctl", script: "tools/hwpod-ctl.ts" },
+            { command: "hwpod-compiler", script: "tools/hwpod-compiler-cli.ts" }
+          ]
+        },
+        bootConfig: {
+          template: "default",
+          overrides: {}
+        }
+      };
+  const v03 = JSON.parse(JSON.stringify(v02));
+  v03.artifactCatalog = "deploy/artifact-catalog.v03.json";
+  const deploy = {
+    lanes: {
+      v02,
+      v03
+    }
+  };
+  return deploy;
+}
+
+function createCatalogFixture(mode, options = {}) {
+  const digest = mode === "ready" ? `sha256:${"1".repeat(64)}` : "not_published";
+  const serviceIds = options.serviceIds ?? uniquePreserveOrder([
+    "hwlab-cloud-api",
+    "hwlab-cloud-web",
+    ...Object.keys(options.componentInputHashes ?? {}),
+    ...Object.keys(options.environmentInputHashes ?? {}),
+    ...Object.keys(options.codeInputHashes ?? {})
+  ]);
+  return {
+    services: serviceIds.map((serviceId) => ({
+      serviceId,
+      commitId: "abc1234",
+      sourceCommitId: options.sourceCommitId ?? "abc1234",
+      image: `127.0.0.1:5000/hwlab/${serviceId}:abc1234`,
+      imageTag: "abc1234",
+      digest,
+      ...((options.componentInputHashes?.[serviceId] || (serviceId === "hwlab-cloud-api" && options.cloudApiComponentInputHash)) ? {
+        componentInputHash: options.cloudApiComponentInputHash ?? options.componentInputHashes?.[serviceId]
+      } : {}),
+      ...(V02_RUNTIME_SERVICE_IDS.includes(serviceId) ? {
+        runtimeMode: "env-reuse-git-mirror-checkout",
+        envReuse: true,
+        environmentImage: `127.0.0.1:5000/hwlab/${serviceId}-env:env-abc1234`,
+        environmentDigest: digest,
+        environmentInputHash: options.environmentInputHashes?.[serviceId] ?? (serviceId === "hwlab-cloud-web" ? options.cloudWebEnvironmentInputHash : null) ?? "e".repeat(64),
+        codeInputHash: options.codeInputHashes?.[serviceId] ?? (serviceId === "hwlab-cloud-web" ? options.cloudWebCodeInputHash : null) ?? "c".repeat(64),
+        bootRepo: "git@github.com:pikasTech/HWLAB.git",
+        bootCommit: options.bootCommits?.[serviceId] ?? (serviceId === "hwlab-cloud-web" ? options.cloudWebBootCommit : null) ?? "abc1234",
+        bootSh: `deploy/runtime/boot/${serviceId}.sh`
+      } : {})
+    }))
+  };
+}
+
+function catalogOptionsFromPlan(plan, extra = {}) {
+  const serviceIds = plan.services.map((service) => service.serviceId);
+  return {
+    sourceCommitId: plan.sourceCommitId,
+    serviceIds,
+    componentInputHashes: Object.fromEntries(plan.services.map((service) => [service.serviceId, service.componentInputHash])),
+    environmentInputHashes: Object.fromEntries(plan.services.map((service) => [service.serviceId, service.environmentInputHash]).filter(([, value]) => value)),
+    codeInputHashes: Object.fromEntries(plan.services.map((service) => [service.serviceId, service.codeInputHash]).filter(([, value]) => value)),
+    bootCommits: Object.fromEntries(plan.services.map((service) => [service.serviceId, plan.sourceCommitId])),
+    ...extra
+  };
+}
+
+function sortedServiceIds(values) {
+  return [...values].sort();
+}
+
+function uniquePreserveOrder(values) {
+  const seen = new Set();
+  const result = [];
+  for (const value of values) {
+    if (!value || seen.has(value)) continue;
+    seen.add(value);
+    result.push(value);
+  }
+  return result;
+}
+
+async function git(cwd, args) {
+  return execFileAsync("git", ["-c", "user.name=HWLAB Test", "-c", "user.email=hwlab-test@example.invalid", ...args], { cwd });
+}