feat(lanes): add --qc boot flag + QC_BOOT_ENV for deterministic QC stacks (E1)

2026-08-04 17:51:03 +07:00
parent c37933adfe
commit 31f984c750
6 changed files with 195 additions and 8 deletions
@@ -0,0 +1,92 @@
+/**
+ * @file Tests for profile parsing and hook environment setup.
+ * @author Nguyễn Ngọc Trí Vĩ <vinnt@smartgift.vn>
+ */
+
+const os = require("node:os");
+const pathMod = require("node:path");
+const fsMod = require("node:fs");
+
+const SUITE_ROOT = fsMod.mkdtempSync(pathMod.join(os.tmpdir(), "ccam-profile-"));
+process.env.DASHBOARD_DB_PATH = pathMod.join(SUITE_ROOT, "dashboard.db");
+process.env.LANES_ROOT = pathMod.join(SUITE_ROOT, "lanes");
+process.env.CCAM_SECRETS_PATH = pathMod.join(SUITE_ROOT, "secrets.env");
+
+const { describe, it, after } = require("node:test");
+const assert = require("node:assert/strict");
+
+const lanesLib = require("../lib/lanes");
+const slots = require("../lib/lane-slots");
+const profileLib = require("../lib/lane-profile");
+
+after(() => fsMod.rmSync(SUITE_ROOT, { recursive: true, force: true }));
+
+let laneSeq = 0;
+/** A managed lane row backed by a real directory. */
+function makeLane(over = {}) {
+  laneSeq += 1;
+  const cwd = pathMod.join(SUITE_ROOT, `profile-lane-cwd-${laneSeq}`);
+  fsMod.mkdirSync(cwd, { recursive: true });
+  return lanesLib.createLane({
+    title: `profile-lane ${laneSeq}`,
+    cwd,
+    kind: "managed",
+    source_repo: cwd,
+    ...over,
+  });
+}
+
+/** Write a profile into a repo directory. `hooks` maps name -> script body. */
+function writeProfile(root, envText, hooks = {}) {
+  const dir = pathMod.join(root, ".ccam", "profile");
+  fsMod.mkdirSync(pathMod.join(dir, "hooks"), { recursive: true });
+  fsMod.writeFileSync(pathMod.join(dir, "profile.env"), envText);
+  for (const [name, body] of Object.entries(hooks)) {
+    const file = pathMod.join(dir, "hooks", `${name}.sh`);
+    fsMod.writeFileSync(file, body);
+    fsMod.chmodSync(file, 0o755);
+  }
+  return dir;
+}
+
+describe("parseQcBootEnv", () => {
+  it("parses space-separated KEY=value pairs", () => {
+    assert.deepEqual(profileLib.parseQcBootEnv("MOCK_PAYMENTS=1 STUB_EMAIL=1"), {
+      MOCK_PAYMENTS: "1",
+      STUB_EMAIL: "1",
+    });
+  });
+
+  it("returns an empty object for an empty or missing declaration", () => {
+    assert.deepEqual(profileLib.parseQcBootEnv(""), {});
+    assert.deepEqual(profileLib.parseQcBootEnv(undefined), {});
+  });
+
+  it("ignores a malformed token with no =", () => {
+    assert.deepEqual(profileLib.parseQcBootEnv("GOOD=1 malformed"), { GOOD: "1" });
+  });
+});
+
+describe("hookEnv extraEnv", () => {
+  it("merges extraEnv on top of everything else, including profile.env", () => {
+    const lane = makeLane();
+    writeProfile(lane.cwd, "PORTS=api\n");
+    slots.allocateSlot(lane.id);
+    const current = lanesLib.getLane(lane.id);
+    const profile = profileLib.resolveProfile(current);
+    const env = profileLib.hookEnv(current, profile, { PORTS: "overridden" });
+    assert.equal(env.PORTS, "overridden");
+    slots.releaseSlot(lane.id);
+  });
+
+  it("defaults extraEnv to nothing when omitted (existing callers unaffected)", () => {
+    const lane = makeLane();
+    writeProfile(lane.cwd, "PORTS=api\n");
+    slots.allocateSlot(lane.id);
+    const current = lanesLib.getLane(lane.id);
+    const profile = profileLib.resolveProfile(current);
+    const env = profileLib.hookEnv(current, profile);
+    assert.equal(env.LANE_ID, String(current.id));
+    slots.releaseSlot(lane.id);
+  });
+});