// One-command setup for a fresh checkout or agent worktree: dependencies // (whose prepare hook builds the internal packages dev servers need) and the // Playwright browser the e2e suite drives. Idempotent and safe to re-run; // each step prints what it is doing. // // There are no fork submodules: our upstream forks (@executor-js/emulate, // @executor-js/mcporter) are consumed purely as published npm packages and // developed in their own standalone repos. Nothing to init here. import { execFileSync } from "node:child_process"; import { existsSync } from "node:fs"; import { resolve } from "node:path"; import { fileURLToPath } from "node:url"; const repoRoot = resolve(fileURLToPath(new URL("..", import.meta.url))); const run = (label: string, cmd: string, args: ReadonlyArray) => { console.log(`\n[bootstrap] ${label}: ${cmd} ${args.join(" ")}`); execFileSync(cmd, [...args], { cwd: repoRoot, stdio: "inherit" }); }; // `bun install` runs the workspace prepare hook, which builds // @executor-js/vite-plugin and @executor-js/react — the two artifacts the // apps' vite dev servers fail without in a fresh worktree. run("dependencies (+ prepare builds)", "bun", ["install"]); // Assert load-bearing patched dependencies actually installed in patched form. // A bun cache edge case can leave a stale, unpatched dist in node_modules even // though the lockfile records the patch (bun reports "no changes"). That would // silently drop the agents MCP transport hang fix; fail here so a fresh // checkout or worktree surfaces it immediately instead of at deploy time. run("verify patched deps", "bun", ["run", "scripts/check-patched-deps.ts"]); // e2e browser scenarios need Playwright's chromium; the cache is shared // per-machine so this is a fast no-op when already present. run("playwright chromium", "bunx", ["playwright", "install", "chromium"]); if (!existsSync(resolve(repoRoot, "node_modules/.bin/vitest"))) { throw new Error("bootstrap: vitest missing after install — bun install likely failed"); } // Point git at the tracked .githooks dir so the pre-commit hook auto-formats // staged code with oxfmt. hooksPath is local config, never cloned or copied // into worktrees, so every fresh checkout and agent worktree must re-set it; // without it, unformatted commits slip through and CI's `format` job fails. run("git hooks", "git", ["config", "core.hooksPath", ".githooks"]); console.log("\n[bootstrap] done — `cd e2e && bun run test` runs the full suite.");