Make a fresh clone work without submodules or a build step

A fresh `git clone && bun install` previously could not run `bun dev`:
@executor-js/vite-plugin and @executor-js/react/console-routes only ship
built `dist/` entrypoints, which used to require knowing to run
`turbo run build` after installing. The root `prepare` hook now bundles
both on every install (tsup, well under a second), so vite configs
resolve on a fresh clone. (Pointing `exports.default` at the TS source
instead would only work on Node >= 23.6 type-stripping — vite
externalizes these imports from vite.config.ts, so Node itself has to
load them.)

Delete `testkit/` instead of porting it off the vendored mcporter
submodule: it was the throwaway MCP-surface MVP that the e2e
scenario x target framework (#926) superseded — nothing references it,
no CI runs it, and keeping it meant carrying its own npm lockfile.
`vendor/README.md` documents that the `vendor/` submodules are optional
(everything consumes the published @executor-js packages from npm).

(Earlier versions of this branch also wired e2e/ to @executor-js/mcporter
from npm and stubbed WorkOS Vault under EXECUTOR_E2E_STUB; the wire-level
emulators PR (#931) absorbed the former and replaced the latter with real
/vault/v1/kv routes on the WorkOS emulator.)

Verified by cloning the repo fresh into /tmp: install, format, lint,
typecheck, and the full e2e suite (cloud + selfhost) all pass with no
submodules initialized and no manual build step.

Author: RhysSullivan

.gitignore

@@ -60,10 +60,11 @@ apps/desktop/resources/
 apps/cloud/.dev-db/
 apps/cloud/.e2e-db/
 
-# e2e suite: generated run artifacts + throwaway target state
+# e2e suite: generated run artifacts + throwaway target state (the * also
+# covers ad-hoc variants like .e2e-stub-db-manual from debugging boots)
 e2e/runs/
-apps/cloud/.e2e-stub-db/
-apps/host-selfhost/.e2e-data/
+apps/cloud/.e2e-stub-db*/
+apps/host-selfhost/.e2e-data*/
 
 # playwright e2e artifacts
 test-results/
@@ -109,5 +110,3 @@ LEARNINGS.md
 # Throwaway UX prototype (not part of the app)
 ux-demo/
 
-# testkit run outputs (superseded by e2e/runs, also generated)
-testkit/runs/

.oxfmtrc.json

@@ -6,7 +6,6 @@
     ".turbo",
     "dist",
     "vendor",
-    "testkit",
     "e2e/runs",
     "integrationsdotsh",
     "node_modules",

.oxlintrc.jsonc

@@ -152,7 +152,6 @@
     "dist/",
     "vendor/",
     "emulators/",
-    "testkit/",
     "e2e/runs/",
     "integrationsdotsh/",
     "node_modules/",

README.md

@@ -126,6 +126,17 @@ bun dev
 
 The dev server starts at `http://127.0.0.1:4788`.
 
+### Tests
+
+```bash
+bun run test       # unit + integration suites
+bun run test:e2e   # full-stack e2e: boots the cloud and self-host apps and drives them
+```
+
+The browser e2e scenarios need Playwright's Chromium once per machine:
+`bunx playwright install chromium`. The git submodules under `vendor/` are
+optional — see [vendor/README.md](vendor/README.md).
+
 ## Community
 
 Join the Discord: [https://discord.gg/eF29HBHwM6](https://discord.gg/eF29HBHwM6)

e2e/src/surfaces/mcp.ts

@@ -1,7 +1,7 @@
-// MCP surface: the vendored mcporter fork as a programmatic MCP client, with
-// headless OAuth via the target's consent strategy. Session methods are
-// Effects; mcporter itself is promise-native underneath. Assertions are
-// vitest's job.
+// MCP surface: our mcporter fork (@executor-js/mcporter on npm; develop it in
+// the vendor/mcporter submodule) as a programmatic MCP client, with headless
+// OAuth via the target's consent strategy. Session methods are Effects;
+// mcporter itself is promise-native underneath. Assertions are vitest's job.
 import { createHash, randomBytes, randomUUID } from "node:crypto";
 import { mkdtempSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";

package.json

@@ -63,7 +63,7 @@
     "release:publish:packages:prepare": "bun run scripts/publish-packages.ts --prepare-only",
     "release:smoke:packages": "bun run scripts/smoke-test-packed.ts",
     "clean": "bun run scripts/clean.ts",
-    "prepare": "effect-language-service patch && effect-tsgo patch"
+    "prepare": "effect-language-service patch && effect-tsgo patch && bun run --cwd packages/core/vite-plugin build:bundle && bun run --cwd packages/react build"
   },
   "dependencies": {},
   "devDependencies": {

packages/core/vite-plugin/package.json

@@ -35,6 +35,7 @@
   },
   "scripts": {
     "build": "tsup && (tsc --declaration --emitDeclarationOnly --outDir dist --rootDir src || true)",
+    "build:bundle": "tsup",
     "typecheck": "tsgo --noEmit",
     "test": "vitest run",
     "typecheck:slow": "tsc --noEmit"