chore: import upstream snapshot with attribution

showcase/scripts/__tests__/validate-pins.cli.test.ts

@@ -0,0 +1,119 @@
+// Split from validate-pins.test.ts — see validate-pins.shared.ts header
+// for the full rationale (vitest birpc 60s cliff, fork-per-file).
+
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import fs from "fs";
+import path from "path";
+import { spawnSync } from "child_process";
+import { VALIDATE_PINS_SCRIPT, tmpdir, write } from "./validate-pins.shared.js";
+
+function writeCanonical(
+  repoRoot: string,
+  version = "1.59.2",
+  overrides: Record<string, Record<string, string>> = {},
+): void {
+  write(
+    path.join(repoRoot, "showcase", "scripts", "showcase-canonical-pins.json"),
+    JSON.stringify({ canonicalCopilotKitVersion: version, overrides }),
+  );
+}
+
+describe("validate-pins CLI exit codes", () => {
+  let repoRoot: string;
+
+  beforeEach(() => {
+    repoRoot = tmpdir();
+    fs.mkdirSync(path.join(repoRoot, "showcase", "integrations"), {
+      recursive: true,
+    });
+    writeCanonical(repoRoot);
+  });
+
+  afterEach(() => {
+    fs.rmSync(repoRoot, { recursive: true, force: true });
+  });
+
+  function runCli() {
+    return spawnSync("npx", ["tsx", VALIDATE_PINS_SCRIPT], {
+      encoding: "utf-8",
+      env: { ...process.env, VALIDATE_PINS_REPO_ROOT: repoRoot },
+      timeout: 30_000,
+    });
+  }
+
+  it("exits 1 when FAIL>0 (real drift: non-exact pin)", () => {
+    const slug = "mastra";
+    const pkgDir = path.join(repoRoot, "showcase", "integrations", slug);
+    fs.mkdirSync(pkgDir, { recursive: true });
+    write(
+      path.join(pkgDir, "package.json"),
+      JSON.stringify({
+        name: slug,
+        dependencies: { "@mastra/core": "next" },
+      }),
+    );
+    const r = runCli();
+    expect(r.status, r.stdout + r.stderr).toBe(1);
+  });
+
+  it("exits 0 when clean (all framework deps exact-pinned and @copilotkit canonical)", () => {
+    const slug = "mastra";
+    const pkgDir = path.join(repoRoot, "showcase", "integrations", slug);
+    fs.mkdirSync(pkgDir, { recursive: true });
+    write(
+      path.join(pkgDir, "package.json"),
+      JSON.stringify({
+        name: slug,
+        dependencies: {
+          "@copilotkit/react-core": "1.59.2",
+          "@mastra/core": "0.15.0",
+        },
+      }),
+    );
+    const r = runCli();
+    expect(r.status, r.stdout + r.stderr).toBe(0);
+  });
+});
+
+describe("validate-pins CLI exit code 3 (unreadable input)", () => {
+  it("exits 3 when VALIDATE_PINS_REPO_ROOT points at a non-directory", () => {
+    const tmp = tmpdir();
+    try {
+      const filePath = path.join(tmp, "not-a-dir");
+      fs.writeFileSync(filePath, "x");
+      const r = spawnSync("npx", ["tsx", VALIDATE_PINS_SCRIPT], {
+        encoding: "utf-8",
+        env: { ...process.env, VALIDATE_PINS_REPO_ROOT: filePath },
+        timeout: 30_000,
+      });
+      expect(r.status, r.stdout + r.stderr).toBe(3);
+    } finally {
+      fs.rmSync(tmp, { recursive: true, force: true });
+    }
+  });
+});
+
+describe("module import does not invoke main()", () => {
+  it("importing the module exits cleanly (status 0)", () => {
+    // Use tsx's module loader via a small inline program that imports
+    // validate-pins.js. If main() were invoked on import, the process
+    // would exit with the validator's report status (likely 1 in this
+    // test environment), NOT 0.
+    const prog = `import(${JSON.stringify(
+      VALIDATE_PINS_SCRIPT,
+    )}).then(() => process.exit(0)).catch((e) => { console.error(e); process.exit(42); });`;
+
+    const r = spawnSync("npx", ["tsx", "-e", prog], {
+      encoding: "utf-8",
+      env: {
+        ...process.env,
+        // Point REPO_ROOT at this worktree so computeRepoRoot's override
+        // validation passes; the value is irrelevant because main() must
+        // not run.
+        VALIDATE_PINS_REPO_ROOT: path.resolve(__dirname, "..", "..", ".."),
+      },
+      timeout: 30_000,
+    });
+    expect(r.status, r.stdout + r.stderr).toBe(0);
+  });
+});