@dreamboard-games/cli 0.1.30-alpha.3 → 0.1.30-alpha.31

package/dist/agent-verifier/{chunk-E7SSWJXJ.mjs → reducer-native-test-harness-UFMSNNDY.mjs}

@@ -2,44 +2,52 @@
 import {
   bundleTypeScriptModuleText,
   importTypeScriptModule
-} from "./chunk-LUZ7KE6H.mjs";
-import {
-  STALE_CONTRACT_ARTIFACT_CODE,
-  isStaleContractArtifactError,
-  toDreamboardApiError
-} from "./chunk-S34FRJHS.mjs";
+} from "./chunk-QD4SQNUP.mjs";
 import {
   loadManifest
-} from "./chunk-XGWCY624.mjs";
+} from "./chunk-KDAQ4CZY.mjs";
+import "./chunk-GWRZRWCF.mjs";
 import {
   REDUCER_TESTING_TYPES_WRAPPER_CONTENT,
   buildReducerTestingContractContent
-} from "./chunk-F2DIOJJZ.mjs";
+} from "./chunk-XCQQIPCO.mjs";
+import {
+  ensureDir,
+  exists
+} from "./chunk-LMW66VBH.mjs";
 import {
+  CLIENT_PROBLEM_TYPES,
+  SERVER_PROBLEM_TYPES,
   createGameplayCapability,
   createProjectSession,
   createProjectSessionFromReducerSnapshot,
   getSessionSnapshot,
   hashContent,
-  startGame
-} from "./chunk-O4YCPU7C.mjs";
+  startGame,
+  zProblemDetails
+} from "./chunk-BWBN2TDJ.mjs";
 import {
   external_exports
-} from "./chunk-VS573ERH.mjs";
+} from "./chunk-JZTH3EMV.mjs";
+import "./chunk-TTB7AIHZ.mjs";
+import "./chunk-MYMVXTZT.mjs";
 import {
-  ensureDir,
-  exists,
-  readTextFileIfExists,
-  writeJsonFile,
-  writeTextFile
-} from "./chunk-IAYRNVUC.mjs";
+  readWorkspaceTextFileIfExists,
+  resolveWorkspacePath,
+  workspacePathExists,
+  writeWorkspaceJsonFile,
+  writeWorkspaceTextFile
+} from "./chunk-OJFZVGEL.mjs";
 import {
   PROJECT_DIR_NAME
-} from "./chunk-H76MT5UR.mjs";
+} from "./chunk-M7UVBANQ.mjs";
+import "./chunk-H6XDQJ3N.mjs";
 
 // src/services/testing/reducer-native-test-harness.ts
-import path2 from "path";
+import path from "path";
 import { randomUUID as randomUUID2 } from "crypto";
+import { createRequire } from "module";
+import { pathToFileURL } from "url";
 import {
   existsSync,
   mkdirSync,
@@ -49,14 +57,6 @@ import {
 } from "fs";
 import { readdir } from "fs/promises";
 import { isDeepStrictEqual } from "util";
-import {
-  contractFingerprint,
-  createReducerBundle
-} from "@dreamboard-games/sdk/reducer";
-import {
-  ReducerWireZod as ReducerContractZod
-} from "@dreamboard-games/sdk/reducer-contract";
-import { materializeManifestTable } from "@dreamboard-games/sdk/codegen";
 
 // src/services/gameplay-authority-submit.ts
 import { randomUUID } from "crypto";
@@ -636,36 +636,6 @@ async function submitGameplayAuthorityAction(options) {
   }
 }
 
-// src/ui/playwright-runner.ts
-import os from "os";
-import path from "path";
-function configurePlaywrightBrowsersPath() {
-  if (process.env.PLAYWRIGHT_BROWSERS_PATH) {
-    return;
-  }
-  const runtimeHome = process.env.HOME;
-  let realHome;
-  try {
-    realHome = os.userInfo().homedir;
-  } catch {
-    return;
-  }
-  if (!runtimeHome || path.resolve(runtimeHome) === path.resolve(realHome)) {
-    return;
-  }
-  const browserCachePath = process.platform === "darwin" ? path.join(realHome, "Library", "Caches", "ms-playwright") : process.platform === "win32" ? path.join(realHome, "AppData", "Local", "ms-playwright") : path.join(realHome, ".cache", "ms-playwright");
-  process.env.PLAYWRIGHT_BROWSERS_PATH = browserCachePath;
-}
-async function buildBrowserAuthInitScript(config) {
-  if (!config.authToken) return null;
-  return `(function(){localStorage.setItem('dreamboard_auth_token',${JSON.stringify(config.authToken)});})();`;
-}
-async function waitForGameReady(page, timeoutMs = 6e4) {
-  await page.waitForSelector('iframe[title="Game UI Plugin"]', {
-    timeout: timeoutMs
-  });
-}
-
 // src/services/workflows/resolve-setup-profile.ts
 function resolveSetupProfileSelection(options) {
   const setupProfiles = options.manifest.setupProfiles ?? [];
@@ -707,6 +677,120 @@ function resolveSetupProfileSelection(options) {
   };
 }
 
+// src/utils/problem-types.ts
+var CLI_PROBLEM_TYPES = {
+  ...SERVER_PROBLEM_TYPES,
+  ...CLIENT_PROBLEM_TYPES
+};
+
+// src/utils/errors.ts
+var STALE_CONTRACT_ARTIFACT_CODE = "STALE_CONTRACT_ARTIFACT";
+function isProblemViolationArray(value) {
+  return Array.isArray(value) && value.every(
+    (entry) => typeof entry === "object" && entry !== null && typeof entry.message === "string"
+  );
+}
+function isProblemDetails(value) {
+  return zProblemDetails.safeParse(value).success;
+}
+function coerceViolations(value) {
+  if (isProblemViolationArray(value)) {
+    return value;
+  }
+  if (Array.isArray(value) && value.every((entry) => typeof entry === "string")) {
+    return value.map((message) => ({ message }));
+  }
+  return void 0;
+}
+function getRequestId(response) {
+  return response?.headers?.get?.("X-Correlation-ID") ?? response?.headers?.get?.("x-correlation-id") ?? void 0;
+}
+function toApiProblem(error, response, fallback) {
+  if (isProblemDetails(error)) {
+    return {
+      ...error,
+      status: error.status || response?.status || 0,
+      requestId: error.requestId ?? getRequestId(response)
+    };
+  }
+  if (error instanceof Error) {
+    return {
+      type: CLI_PROBLEM_TYPES.TRANSPORT_ERROR,
+      title: response?.statusText || "API error",
+      status: response?.status ?? 0,
+      detail: error.message || fallback,
+      requestId: getRequestId(response)
+    };
+  }
+  if (error && typeof error === "object") {
+    const obj = error;
+    const detail2 = typeof obj.detail === "string" ? obj.detail : typeof obj.message === "string" ? obj.message : void 0;
+    const title = typeof obj.title === "string" ? obj.title : response?.statusText || "API error";
+    const violations = coerceViolations(obj.violations) ?? coerceViolations(obj.errors);
+    if (detail2) {
+      return {
+        type: typeof obj.type === "string" ? obj.type : CLI_PROBLEM_TYPES.UNKNOWN_API_ERROR,
+        title,
+        status: typeof obj.status === "number" ? obj.status : response?.status ?? 0,
+        detail: detail2,
+        requestId: typeof obj.requestId === "string" ? obj.requestId : getRequestId(response),
+        retryable: typeof obj.retryable === "boolean" ? obj.retryable : void 0,
+        context: typeof obj.context === "object" && obj.context !== null ? obj.context : void 0,
+        violations,
+        timestamp: typeof obj.timestamp === "string" ? obj.timestamp : void 0,
+        instance: typeof obj.instance === "string" ? obj.instance : void 0
+      };
+    }
+  }
+  const detail = typeof error === "string" ? error.trim() || fallback : fallback;
+  return {
+    type: CLI_PROBLEM_TYPES.UNKNOWN_API_ERROR,
+    title: response?.statusText || "API error",
+    status: response?.status ?? 0,
+    detail,
+    requestId: getRequestId(response)
+  };
+}
+function formatProblem(problem) {
+  const base = problem.detail || problem.title;
+  const violations = problem.violations && problem.violations.length > 0 ? ` (${problem.violations.map((entry) => entry.message).join("; ")})` : "";
+  const statusSuffix = problem.status && problem.status > 0 ? ` (HTTP ${problem.status})` : "";
+  return `${base}${violations}${statusSuffix}`;
+}
+var DreamboardApiError = class extends Error {
+  problem;
+  status;
+  requestId;
+  retryable;
+  constructor(problem, cause) {
+    super(formatProblem(problem), { cause });
+    this.name = "DreamboardApiError";
+    this.problem = problem;
+    this.status = problem.status;
+    this.requestId = problem.requestId;
+    this.retryable = problem.retryable;
+  }
+};
+function toDreamboardApiError(error, response, fallback) {
+  return new DreamboardApiError(toApiProblem(error, response, fallback), error);
+}
+function getObjectStringProperty(value, property) {
+  return value && typeof value === "object" && typeof value[property] === "string" ? value[property] : void 0;
+}
+function isStaleContractArtifactMessage(message) {
+  return message.includes(STALE_CONTRACT_ARTIFACT_CODE) || message.includes("StaleContractArtifactError") || message.toLowerCase().includes("stale contract artifact");
+}
+function isStaleContractArtifactError(error) {
+  if (getObjectStringProperty(error, "code") === STALE_CONTRACT_ARTIFACT_CODE) {
+    return true;
+  }
+  if (getObjectStringProperty(error, "name") === "StaleContractArtifactError") {
+    return true;
+  }
+  const message = getObjectStringProperty(error, "message");
+  return message ? isStaleContractArtifactMessage(message) : false;
+}
+
 // src/utils/session-game-source.ts
 function projectIdFromSessionGameSource(source) {
   if (source.kind === "USER_COMPILED") {
@@ -719,7 +803,6 @@ function projectIdFromSessionGameSource(source) {
 globalThis.__DREAMBOARD_AUTHORING_WARNINGS__ = true;
 var GENERATED_TESTING_TYPES_PREFIX = "// Generated by dreamboard";
 var TESTING_TYPES_STUB = "export function defineScenario(scenario) { return scenario; }\n";
-var DEFAULT_TIMEOUT_MS2 = 1e4;
 var BASE_SUFFIX = ".base.ts";
 var SCENARIO_SUFFIX = ".scenario.ts";
 var SDK_UI_RUNTIME_EXTERNALS = [
@@ -751,15 +834,15 @@ function findScenarioStackFrame(options) {
   if (!options.stack) {
     return null;
   }
-  const absolutePath = path2.resolve(options.scenarioFilePath);
-  const relativePath = path2.relative(options.projectRoot, absolutePath);
-  const normalizedRelativePath = relativePath.split(path2.sep).join("/");
+  const absolutePath = path.resolve(options.scenarioFilePath);
+  const relativePath = path.relative(options.projectRoot, absolutePath);
+  const normalizedRelativePath = relativePath.split(path.sep).join("/");
   const escapedAbsolutePath = escapeRegExp(absolutePath);
   const escapedRelativePath = escapeRegExp(normalizedRelativePath);
   const absoluteFrame = new RegExp(`${escapedAbsolutePath}:(\\d+):(\\d+)`);
   const relativeFrame = new RegExp(`${escapedRelativePath}:(\\d+):(\\d+)`);
   for (const line of options.stack.split("\n")) {
-    const normalizedLine = line.split(path2.sep).join("/");
+    const normalizedLine = line.split(path.sep).join("/");
     const match = normalizedLine.match(absoluteFrame) ?? normalizedLine.match(relativeFrame);
     if (match?.[1] && match?.[2]) {
       return `at ${normalizedRelativePath}:${match[1]}:${match[2]}`;
@@ -770,12 +853,45 @@ function findScenarioStackFrame(options) {
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-var testingExpectApiFactoryPromise;
-async function loadTestingExpectApiFactory() {
-  testingExpectApiFactoryPromise ??= import("@dreamboard-games/sdk/testing").then(
-    (module) => module.createExpectApi
+var projectReducerNativeModules = /* @__PURE__ */ new Map();
+function resolveProjectSdkModule(projectRoot, specifier) {
+  const requireFromProject = createRequire(
+    path.join(projectRoot, "package.json")
   );
-  return testingExpectApiFactoryPromise;
+  return requireFromProject.resolve(specifier);
+}
+async function importProjectSdkModule(projectRoot, specifier) {
+  const modulePath = resolveProjectSdkModule(projectRoot, specifier);
+  return await import(pathToFileURL(modulePath).href);
+}
+async function loadProjectReducerNativeModules(projectRoot) {
+  const cacheKey = path.resolve(projectRoot);
+  const cached = projectReducerNativeModules.get(cacheKey);
+  if (cached) {
+    return cached;
+  }
+  const promise = Promise.all([
+    importProjectSdkModule(cacheKey, "@dreamboard-games/sdk/reducer"),
+    importProjectSdkModule(cacheKey, "@dreamboard-games/sdk/reducer-contract"),
+    importProjectSdkModule(
+      cacheKey,
+      "@dreamboard-games/sdk/testing"
+    )
+  ]).then(([reducerModule, reducerContractModule, testingModule]) => {
+    if (typeof reducerModule.createReducerBundle !== "function" || typeof reducerModule.contractFingerprint !== "function" || typeof reducerContractModule.materializeManifestTable !== "function" || typeof testingModule.createExpectApi !== "function") {
+      throw new Error(
+        "Installed @dreamboard-games/sdk does not expose the reducer-native test helpers required by this CLI."
+      );
+    }
+    return {
+      createReducerBundle: reducerModule.createReducerBundle,
+      contractFingerprint: reducerModule.contractFingerprint,
+      materializeManifestTable: reducerContractModule.materializeManifestTable,
+      createExpectApi: testingModule.createExpectApi
+    };
+  });
+  projectReducerNativeModules.set(cacheKey, promise);
+  return promise;
 }
 function createSubmissionError(errorCode, message, fallbackMessage) {
   const error = new Error(message ?? fallbackMessage);
@@ -783,22 +899,9 @@ function createSubmissionError(errorCode, message, fallbackMessage) {
   error.errorCode = errorCode;
   return error;
 }
-function parseJsonValue(value) {
-  if (typeof value !== "string") {
-    return value;
-  }
-  try {
-    return JSON.parse(value);
-  } catch {
-    return value;
-  }
-}
 function deepEqual(left, right) {
   return isDeepStrictEqual(left, right);
 }
-function normalizeScenarioRunners(runners) {
-  return runners && runners.length > 0 ? runners : ["reducer"];
-}
 function shouldRefreshReducerTestingTypes(existingContent) {
   if (existingContent === null || existingContent.trim().length === 0 || existingContent === TESTING_TYPES_STUB || existingContent.startsWith(GENERATED_TESTING_TYPES_PREFIX)) {
     return true;
@@ -812,7 +915,7 @@ async function discoverFiles(root, suffix) {
   const entries = await readdir(root, { withFileTypes: true });
   const files = [];
   for (const entry of entries) {
-    const entryPath = path2.join(root, entry.name);
+    const entryPath = path.join(root, entry.name);
     if (entry.isDirectory()) {
       files.push(...await discoverFiles(entryPath, suffix));
       continue;
@@ -861,62 +964,52 @@ function parseTypedScenarioDefinition(value) {
   };
 }
 async function isReducerNativeTestingWorkspace(projectRoot) {
-  return await exists(path2.join(projectRoot, "app", "game.ts")) && await exists(
-    path2.join(projectRoot, "shared", "generated", "ui-contract.ts")
+  return await exists(path.join(projectRoot, "app", "game.ts")) && await exists(
+    path.join(projectRoot, "shared", "generated", "ui-contract.ts")
   );
 }
 async function ensureReducerNativeTestingFiles(projectRoot) {
-  const testingTypesPath = path2.join(projectRoot, "test", "testing-types.ts");
-  const testingContractPath = path2.join(
-    projectRoot,
-    "test",
-    "generated",
-    "testing-contract.ts"
-  );
-  const baseStatesPath = path2.join(
-    projectRoot,
-    "test",
-    "generated",
-    "base-states.generated.ts"
-  );
-  const baseStatesDtsPath = path2.join(
+  const testingTypesPath = "test/testing-types.ts";
+  const testingContractPath = "test/generated/testing-contract.ts";
+  const baseStatesPath = "test/generated/base-states.generated.ts";
+  const baseStatesDtsPath = "test/generated/base-states.generated.d.ts";
+  const scenarioManifestPath = "test/generated/scenario-manifest.generated.ts";
+  await ensureDir(resolveWorkspacePath(projectRoot, "test"));
+  await ensureDir(resolveWorkspacePath(projectRoot, "test/generated"));
+  const existingTestingTypes = await readWorkspaceTextFileIfExists(
     projectRoot,
-    "test",
-    "generated",
-    "base-states.generated.d.ts"
+    testingTypesPath
   );
-  const scenarioManifestPath = path2.join(
-    projectRoot,
-    "test",
-    "generated",
-    "scenario-manifest.generated.ts"
-  );
-  await ensureDir(path2.dirname(testingTypesPath));
-  await ensureDir(path2.dirname(testingContractPath));
-  const existingTestingTypes = await readTextFileIfExists(testingTypesPath);
   if (shouldRefreshReducerTestingTypes(existingTestingTypes)) {
-    await writeTextFile(
+    await writeWorkspaceTextFile(
+      projectRoot,
       testingTypesPath,
       REDUCER_TESTING_TYPES_WRAPPER_CONTENT
     );
   }
   const rejectionCodes = await collectKnownRejectionCodes(projectRoot);
-  await writeTextFile(
+  await writeWorkspaceTextFile(
+    projectRoot,
     testingContractPath,
     buildReducerTestingContractContent({ rejectionCodes })
   );
-  const header = "// Generated by dreamboard test generate. Do not edit by hand.\n";
-  if (!await exists(baseStatesPath)) {
-    await writeTextFile(
+  const header = "// Generated by dreamboard test. Do not edit by hand.\n";
+  if (!await workspacePathExists(projectRoot, baseStatesPath)) {
+    await writeWorkspaceTextFile(
+      projectRoot,
       baseStatesPath,
       `${header}export const BASE_STATES = {} as const;
 export const BASE_STATES_CONTRACT_FINGERPRINT = undefined;
 `
     );
   } else {
-    const existingBaseStates = await readTextFileIfExists(baseStatesPath);
+    const existingBaseStates = await readWorkspaceTextFileIfExists(
+      projectRoot,
+      baseStatesPath
+    );
     if (existingBaseStates && !existingBaseStates.includes("BASE_STATES_CONTRACT_FINGERPRINT")) {
-      await writeTextFile(
+      await writeWorkspaceTextFile(
+        projectRoot,
         baseStatesPath,
         `${existingBaseStates.trimEnd()}
 export const BASE_STATES_CONTRACT_FINGERPRINT = undefined;
@@ -924,17 +1017,22 @@ export const BASE_STATES_CONTRACT_FINGERPRINT = undefined;
       );
     }
   }
-  if (!await exists(baseStatesDtsPath)) {
-    await writeTextFile(
+  if (!await workspacePathExists(projectRoot, baseStatesDtsPath)) {
+    await writeWorkspaceTextFile(
+      projectRoot,
       baseStatesDtsPath,
       `${header}export declare const BASE_STATES: Record<string, unknown>;
 export declare const BASE_STATES_CONTRACT_FINGERPRINT: string | undefined;
 `
     );
   } else {
-    const existingBaseStatesDts = await readTextFileIfExists(baseStatesDtsPath);
+    const existingBaseStatesDts = await readWorkspaceTextFileIfExists(
+      projectRoot,
+      baseStatesDtsPath
+    );
     if (existingBaseStatesDts && !existingBaseStatesDts.includes("BASE_STATES_CONTRACT_FINGERPRINT")) {
-      await writeTextFile(
+      await writeWorkspaceTextFile(
+        projectRoot,
         baseStatesDtsPath,
         `${existingBaseStatesDts.trimEnd()}
 export declare const BASE_STATES_CONTRACT_FINGERPRINT: string | undefined;
@@ -942,8 +1040,9 @@ export declare const BASE_STATES_CONTRACT_FINGERPRINT: string | undefined;
       );
     }
   }
-  if (!await exists(scenarioManifestPath)) {
-    await writeTextFile(
+  if (!await workspacePathExists(projectRoot, scenarioManifestPath)) {
+    await writeWorkspaceTextFile(
+      projectRoot,
       scenarioManifestPath,
       `${header}export const SCENARIO_MANIFEST = [] as const;
 `
@@ -958,7 +1057,7 @@ var DEFAULT_REJECTION_CODES = [
 ];
 async function collectKnownRejectionCodes(projectRoot) {
   const knownCodes = new Set(DEFAULT_REJECTION_CODES);
-  const gamePath = path2.join(projectRoot, "app", "game.ts");
+  const gamePath = path.join(projectRoot, "app", "game.ts");
   if (!await exists(gamePath)) {
     return Array.from(knownCodes).sort(
       (left, right) => left.localeCompare(right)
@@ -985,7 +1084,7 @@ async function collectKnownRejectionCodes(projectRoot) {
 }
 async function loadTypedBases(projectRoot) {
   const baseFiles = await discoverFiles(
-    path2.join(projectRoot, "test", "bases"),
+    resolveWorkspacePath(projectRoot, "test/bases"),
     BASE_SUFFIX
   );
   const loaded = [];
@@ -1004,8 +1103,8 @@ async function loadTypedBases(projectRoot) {
   return loaded;
 }
 async function loadTypedScenarios(projectRoot, options) {
-  const scenarioFiles = options.scenarioPath ? [path2.resolve(projectRoot, options.scenarioPath)] : await discoverFiles(
-    path2.join(projectRoot, "test", "scenarios"),
+  const scenarioFiles = options.scenarioPath ? [resolveWorkspacePath(projectRoot, options.scenarioPath)] : await discoverFiles(
+    resolveWorkspacePath(projectRoot, "test/scenarios"),
     SCENARIO_SUFFIX
   );
   const loaded = [];
@@ -1024,8 +1123,8 @@ async function loadTypedScenarios(projectRoot, options) {
   return loaded;
 }
 function reducerNativeTestHelperExternals(projectRoot, filePath) {
-  const testingTypesPath = path2.join(projectRoot, "test", "testing-types");
-  const relative = path2.relative(path2.dirname(filePath), testingTypesPath).replaceAll("\\", "/");
+  const testingTypesPath = path.join(projectRoot, "test", "testing-types");
+  const relative = path.relative(path.dirname(filePath), testingTypesPath).replaceAll("\\", "/");
   const specifier = relative.startsWith(".") ? relative : `./${relative}`;
   return [specifier, `${specifier}.ts`, ...SDK_UI_RUNTIME_EXTERNALS];
 }
@@ -1206,7 +1305,8 @@ function summarizeTableValidationError(manifest, error) {
   ].join("\n");
 }
 var ShadowReducerRuntime = class {
-  constructor(manifest, gameModuleDefault, createInitialTable, seed, players, setupProfileId, debug = false) {
+  constructor(modules, manifest, gameModuleDefault, createInitialTable, seed, players, setupProfileId, debug = false) {
+    this.modules = modules;
     this.manifest = manifest;
     this.gameModuleDefault = gameModuleDefault;
     this.createInitialTable = createInitialTable;
@@ -1219,20 +1319,13 @@ var ShadowReducerRuntime = class {
         "app/game.ts must export a reducer-native game definition."
       );
     }
-    this.bundle = createReducerBundle(gameModuleDefault);
+    this.bundle = this.modules.createReducerBundle(gameModuleDefault);
     this.runtime = this.bundle.createInProcessRuntime();
     this.playerIds = Array.from(
       { length: players },
       (_, index) => `player-${index + 1}`
     );
   }
-  manifest;
-  gameModuleDefault;
-  createInitialTable;
-  seed;
-  players;
-  setupProfileId;
-  debug;
   bundle;
   runtime;
   playerIds;
@@ -1250,7 +1343,7 @@ var ShadowReducerRuntime = class {
         this.createInitialTable?.({
           playerIds: this.playerIds,
           shuffleItems
-        }) ?? materializeManifestTable({
+        }) ?? this.modules.materializeManifestTable({
           manifest: this.manifest,
           playerIds: this.playerIds,
           shuffleItems
@@ -1405,197 +1498,13 @@ function toReducerInput(input) {
     params: input.params
   };
 }
-var RemoteGameplayTracker = class {
-  constructor(sessionId, playerId) {
-    this.sessionId = sessionId;
-    this.playerId = playerId;
-    this.state.playerId = playerId;
-  }
-  sessionId;
-  playerId;
-  state = {
-    version: -1,
-    actionSetVersion: "",
-    currentPhase: null,
-    playerId: "player-1",
-    view: null,
-    availableInteractions: []
-  };
-  liveBootstrap = false;
-  async bootstrap() {
-    const { data, error, response } = await getSessionSnapshot({
-      path: { sessionId: this.sessionId },
-      query: { playerId: this.playerId }
-    });
-    if (error || !data || data.type !== "gameplay") {
-      throw toDreamboardApiError(
-        error ?? { detail: "Gameplay snapshot was unavailable." },
-        response,
-        "Failed to load the remote gameplay bootstrap snapshot"
-      );
-    }
-    if (data.gameplay.actionSetVersion === "authority") {
-      return;
-    }
-    this.liveBootstrap = true;
-    this.applyGameplay(data.gameplay);
-  }
-  hasLiveBootstrap() {
-    return this.liveBootstrap;
-  }
-  snapshot() {
-    return {
-      ...this.state,
-      availableInteractions: [...this.state.availableInteractions]
-    };
-  }
-  applyShadow(shadow) {
-    const projection = shadow.projectAllSeats();
-    const playerId = this.playerId;
-    const seat = projection.seats[playerId];
-    this.state.version = shadow.currentVersion();
-    this.state.actionSetVersion = "";
-    this.state.playerId = playerId;
-    this.state.currentPhase = shadow.phase();
-    this.state.view = seat?.view ?? null;
-    this.state.availableInteractions = shadow.availableInteractionsForPlayer(playerId);
-  }
-  applyGameplay(gameplay) {
-    const playerId = gameplay.perspectivePlayerId;
-    const seat = gameplay.seats[playerId];
-    this.state.version = gameplay.version;
-    this.state.actionSetVersion = gameplay.actionSetVersion;
-    this.state.playerId = playerId;
-    this.state.currentPhase = gameplay.shared.currentPhase;
-    this.state.view = parseSeatView(seat?.view ?? "null");
-    this.state.availableInteractions = (seat?.availableInteractionRefs ?? []).map((ref) => gameplay.interactionsByRef[ref]).filter(
-      (interaction) => Boolean(interaction)
-    ).map((interaction) => interaction.interactionId);
-  }
-};
-function parseSeatView(raw) {
-  return raw ? parseJsonValue(raw) : null;
-}
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function formatIssuePath(label, path3) {
-  let formatted = label;
-  for (const segment of path3) {
-    formatted += typeof segment === "number" ? `[${segment}]` : `.${String(segment)}`;
-  }
-  return formatted;
-}
-function parseWirePayload(methodName, value, label, schema) {
-  const parsed = schema.safeParse(value);
-  if (parsed.success) {
-    return parsed.data;
-  }
-  const firstIssue = parsed.error.issues[0];
-  const formattedPath = formatIssuePath(label, firstIssue?.path ?? []);
-  throw new Error(
-    `Reducer bundle returned invalid payload for '${methodName}': ${formattedPath} ${firstIssue?.message ?? "failed schema validation"}.`
-  );
-}
 function assertDispatchResultWireContract(result) {
-  return parseWirePayload(
-    "dispatch",
-    result,
-    "DispatchResult",
-    ReducerContractZod.DispatchResultSchema
-  );
-}
-async function createBrowserBridgeClient(page) {
-  const bridgeExists = async () => page.evaluate(
-    () => Boolean(
-      window.__dreamboardTestBridge__
-    )
-  );
-  const startedAt = Date.now();
-  while (!await bridgeExists()) {
-    if (Date.now() - startedAt > DEFAULT_TIMEOUT_MS2) {
-      const bodyText = await page.locator("body").innerText().catch(() => "");
-      const diagnostic = bodyText.trim().replace(/\s+/g, " ").slice(0, 400);
-      throw new Error(
-        diagnostic.length > 0 ? `Timed out waiting for browser test bridge. Page text: ${diagnostic}` : "Timed out waiting for browser test bridge."
-      );
-    }
-    await sleep(50);
-  }
-  return {
-    snapshot: () => page.evaluate(
-      () => window.__dreamboardTestBridge__.snapshot()
-    ),
-    submitInteraction: (playerId, interactionId, params) => page.evaluate(
-      ([nextPlayerId, nextInteractionId, nextParams]) => window.__dreamboardTestBridge__.submitInteraction(
-        nextPlayerId,
-        nextInteractionId,
-        nextParams
-      ),
-      [playerId, interactionId, params]
-    ),
-    waitForVersionChange: async (previousVersion, timeoutMs = DEFAULT_TIMEOUT_MS2) => {
-      const started = Date.now();
-      while (Date.now() - started < timeoutMs) {
-        const snapshot = await page.evaluate(
-          () => window.__dreamboardTestBridge__.snapshot()
-        );
-        if (snapshot.version > previousVersion) {
-          return snapshot;
-        }
-        await sleep(50);
-      }
-      throw new Error("Timed out waiting for browser gameplay version change.");
-    }
-  };
-}
-async function assertLiveMatchesShadow(runner, shadow, live) {
-  if (runner === "reducer") {
-    return;
-  }
-  const currentPhase = "currentPhase" in live ? live.currentPhase : shadow.phase();
-  if (currentPhase !== shadow.phase()) {
-    throw new Error(
-      `Live phase '${String(currentPhase)}' diverged from reducer phase '${shadow.phase()}'.`
-    );
-  }
-  const livePlayerId = "playerId" in live ? live.playerId : live.controllingPlayerId;
-  const liveView = "view" in live ? live.view : null;
-  if (livePlayerId && !deepEqual(liveView, await shadow.view(livePlayerId))) {
-    throw new Error("Live projected views diverged from reducer shadow views.");
-  }
-  const liveInteractions = "availableInteractions" in live ? live.availableInteractions : null;
-  if (livePlayerId && liveInteractions && !deepEqual(
-    liveInteractions,
-    shadow.availableInteractionsForPlayer(livePlayerId)
-  )) {
+  if (typeof result !== "object" || result === null) {
     throw new Error(
-      "Live available-interactions metadata diverged from reducer shadow state."
+      "Reducer bundle returned invalid payload for 'dispatch': DispatchResult must be an object."
     );
   }
-}
-async function loadBrowserDriver(projectRoot) {
-  const filePath = path2.join(projectRoot, "test", "browser-driver.ts");
-  if (!await exists(filePath)) {
-    return null;
-  }
-  const module = await importTypeScriptModule(filePath);
-  return module.default ?? module;
-}
-async function openBrowserPage(playUrl, config) {
-  configurePlaywrightBrowsersPath();
-  const { chromium } = await import("playwright");
-  const browser = await chromium.launch({ headless: true });
-  const context = await browser.newContext({
-    viewport: { width: 1440, height: 900 }
-  });
-  const initScript = await buildBrowserAuthInitScript(config);
-  if (initScript) {
-    await context.addInitScript({ content: initScript });
-  }
-  const page = await context.newPage();
-  await page.goto(playUrl, { waitUntil: "domcontentloaded" });
-  return { browser, page };
+  return result;
 }
 function sanitizeSnapshotSegment(value) {
   return value.replace(/[^a-zA-Z0-9._-]+/g, "-");
@@ -1603,19 +1512,16 @@ function sanitizeSnapshotSegment(value) {
 function createScenarioSnapshotMatcher(options) {
   return (filename, actual) => {
     const suffix = filename ? `.${sanitizeSnapshotSegment(filename)}` : "";
-    const snapshotPath = path2.join(
+    const snapshotPath = resolveWorkspacePath(
       options.projectRoot,
-      "test",
-      "generated",
-      "snapshots",
-      `${sanitizeSnapshotSegment(options.scenarioId)}${suffix}.snapshot.json`
+      `test/generated/snapshots/${sanitizeSnapshotSegment(options.scenarioId)}${suffix}.snapshot.json`
     );
     const wrappedValue = {
       value: actual
     };
     const serialized = `${JSON.stringify(wrappedValue, null, 2)}
 `;
-    mkdirSync(path2.dirname(snapshotPath), { recursive: true });
+    mkdirSync(path.dirname(snapshotPath), { recursive: true });
     if (!existsSync(snapshotPath) || options.updateSnapshots) {
       writeFileSync(snapshotPath, serialized, "utf8");
       return;
@@ -1623,7 +1529,7 @@ function createScenarioSnapshotMatcher(options) {
     const previous = JSON.parse(readFileSync(snapshotPath, "utf8"));
     if (!deepEqual(previous.value, actual)) {
       throw new Error(
-        `Snapshot mismatch for scenario '${options.scenarioId}'. Re-run with --update-snapshots to refresh ${path2.relative(options.projectRoot, snapshotPath)}.`
+        `Snapshot mismatch for scenario '${options.scenarioId}'. Re-run with --update-snapshots to refresh ${path.relative(options.projectRoot, snapshotPath)}.`
       );
     }
   };
@@ -1632,24 +1538,12 @@ async function createScenarioContext(options) {
   const api = {
     start: async () => {
       await options.shadow.start();
-      if (options.runner === "remote" && options.remote) {
-        if (options.remote.tracker.hasLiveBootstrap()) {
-          const live = options.remote.tracker.snapshot();
-          await assertLiveMatchesShadow("remote", options.shadow, live);
-        } else {
-          options.remote.tracker.applyShadow(options.shadow);
-        }
-      }
-      if (options.runner === "browser" && options.browser) {
-        const live = await options.browser.bridge.snapshot();
-        await assertLiveMatchesShadow("browser", options.shadow, live);
-      }
     },
     patchState: async (mutator) => {
       await api.start();
-      if (options.live || options.remote || options.browser || options.actionPlan) {
+      if (options.live || options.actionPlan) {
         throw new Error(
-          "game.patchState is only supported for reducer snapshot scenarios. Use it to materialize a state before --from-scenario or reducer tests, not inside live replay/browser runners."
+          "game.patchState is only supported for reducer snapshot scenarios. Use it to materialize a state before --from-scenario or reducer tests, not inside live replay."
         );
       }
       options.shadow.patchState(mutator);
@@ -1658,7 +1552,7 @@ async function createScenarioContext(options) {
       await api.start();
       const interactionParams = params ?? {};
       const normalizedInputs = interactionParams && typeof interactionParams === "object" && !Array.isArray(interactionParams) ? interactionParams : {};
-      const previousVersion = options.live ? options.live.version : options.actionPlan ? options.shadow.currentVersion() : options.runner === "remote" ? options.remote?.tracker.snapshot().version ?? 0 : options.runner === "browser" ? (await options.browser?.bridge.snapshot())?.version ?? 0 : 0;
+      const previousVersion = options.live ? options.live.version : options.actionPlan ? options.shadow.currentVersion() : 0;
       if (options.live) {
         if (!options.live.actionSetVersion) {
           options.live.actionSetVersion = await fetchLiveActionSetVersion(
@@ -1725,20 +1619,6 @@ async function createScenarioContext(options) {
         }
         options.live.version = typeof data?.version === "number" ? data.version : previousVersion + 1;
         options.live.actionSetVersion = data?.actionSetVersion ?? options.live.actionSetVersion;
-      } else if (options.runner === "remote" && options.remote) {
-      } else if (options.runner === "browser" && options.browser) {
-        const handled = await options.browser.driver?.interaction?.(options.browser.bridge, {
-          playerId,
-          interactionId,
-          params: interactionParams
-        }) === true;
-        if (!handled) {
-          await options.browser.bridge.submitInteraction(
-            playerId,
-            interactionId,
-            interactionParams
-          );
-        }
       }
       await options.shadow.submitInteraction(
         playerId,
@@ -1758,18 +1638,6 @@ async function createScenarioContext(options) {
         });
         options.actionPlan.submitIndex = (options.actionPlan.submitIndex ?? 0) + 1;
       }
-      if (options.runner === "remote" && options.remote) {
-        options.remote.tracker.applyShadow(options.shadow);
-        await assertLiveMatchesShadow(
-          "remote",
-          options.shadow,
-          options.remote.tracker.snapshot()
-        );
-      }
-      if (options.runner === "browser" && options.browser) {
-        const live = await options.browser.bridge.waitForVersionChange(previousVersion);
-        await assertLiveMatchesShadow("browser", options.shadow, live);
-      }
     }
   };
   return {
@@ -1853,19 +1721,26 @@ async function createSessionFromScenario(options) {
 }
 var MATERIALIZED_SCENARIO_CACHE_VERSION = 1;
 function materializedScenarioCachePath(options) {
-  return path2.join(
-    options.projectRoot,
+  return [
     PROJECT_DIR_NAME,
     "dev",
     "scenario-cache",
     `${sanitizeSnapshotSegment(options.baseId)}.${sanitizeSnapshotSegment(
       options.scenarioId
     )}.${options.fingerprintHash}.json`
+  ].join("/");
+}
+function materializedScenarioCacheFilePath(options) {
+  return resolveWorkspacePath(
+    options.projectRoot,
+    materializedScenarioCachePath(options)
   );
 }
 async function readMaterializedScenarioCache(options) {
-  const cachePath = materializedScenarioCachePath(options);
-  const text = await readTextFileIfExists(cachePath);
+  const text = await readWorkspaceTextFileIfExists(
+    options.projectRoot,
+    materializedScenarioCachePath(options)
+  );
   if (!text) return null;
   try {
     const payload = JSON.parse(
@@ -1880,13 +1755,17 @@ async function readMaterializedScenarioCache(options) {
   }
 }
 async function writeMaterializedScenarioCache(options) {
-  const cachePath = materializedScenarioCachePath(options);
-  await ensureDir(path2.dirname(cachePath));
-  await writeJsonFile(cachePath, {
-    cacheVersion: MATERIALIZED_SCENARIO_CACHE_VERSION,
-    fingerprintHash: options.fingerprintHash,
-    materialized: options.materialized
-  });
+  const cachePath = materializedScenarioCacheFilePath(options);
+  await ensureDir(path.dirname(cachePath));
+  await writeWorkspaceJsonFile(
+    options.projectRoot,
+    materializedScenarioCachePath(options),
+    {
+      cacheVersion: MATERIALIZED_SCENARIO_CACHE_VERSION,
+      fingerprintHash: options.fingerprintHash,
+      materialized: options.materialized
+    }
+  );
 }
 async function materializeScenarioReducerState(options) {
   await ensureReducerNativeTestingFiles(options.projectRoot);
@@ -1944,12 +1823,12 @@ async function materializeScenarioReducerState(options) {
   const generatedBase = generatedBaseStates?.[baseStateKey(base.definition.id)];
   if (!generatedBase) {
     throw new Error(
-      `Missing generated base artifact for '${base.definition.id}'. Run 'dreamboard test generate' before using --from-scenario.`
+      `Missing generated base artifact for '${base.definition.id}'. Run 'dreamboard test' before using --from-scenario.`
     );
   }
   if (typeof generatedBase.version !== "number") {
     throw new Error(
-      `Generated base artifact for '${base.definition.id}' is stale. Run 'dreamboard test generate' before using --from-scenario.`
+      `Generated base artifact for '${base.definition.id}' is stale. Run 'dreamboard test' before using --from-scenario.`
     );
   }
   const canTrustGeneratedFingerprint = options.trustGeneratedFingerprint === true && generatedBase.fingerprint.compiledResultId === options.compiledResultId && generatedBase.fingerprint.gameId === options.gameId;
@@ -1976,13 +1855,14 @@ async function materializeScenarioReducerState(options) {
   if (cached) {
     return cached;
   }
-  const [gameModule, manifestContractModule] = await Promise.all([
+  const [gameModule, manifestContractModule, modules] = await Promise.all([
     importTypeScriptModule(
-      path2.join(options.projectRoot, "app", "game.ts")
+      path.join(options.projectRoot, "app", "game.ts")
     ),
     importTypeScriptModule(
-      path2.join(options.projectRoot, "shared", "manifest-contract.ts")
-    )
+      path.join(options.projectRoot, "shared", "manifest-contract.ts")
+    ),
+    loadProjectReducerNativeModules(options.projectRoot)
   ]);
   const createInitialTable = typeof manifestContractModule.createInitialTable === "function" ? manifestContractModule.createInitialTable : null;
   const resolvedBase = resolveBaseDefinition(base, basesById);
@@ -1992,6 +1872,7 @@ async function materializeScenarioReducerState(options) {
     basesById
   });
   const shadow = new ShadowReducerRuntime(
+    modules,
     manifest,
     gameModule.default,
     createInitialTable,
@@ -2002,9 +1883,8 @@ async function materializeScenarioReducerState(options) {
   );
   shadow.hydrate(generatedBase.snapshot, generatedBase.version);
   const context = await createScenarioContext({
-    runner: "reducer",
     shadow,
-    expect: (await loadTestingExpectApiFactory())()
+    expect: modules.createExpectApi()
   });
   shadow.clearHistory();
   await scenario.definition.when(context);
@@ -2056,18 +1936,20 @@ async function replayScenarioThroughBackend(options) {
     generatedBaseStates,
     manifest,
     gameModule,
-    manifestContractModule
+    manifestContractModule,
+    modules
   ] = await Promise.all([
     loadTypedBases(options.projectRoot),
     loadTypedScenarios(options.projectRoot, {}),
     loadGeneratedBaseStates(options.projectRoot),
     loadManifest(options.projectRoot),
     importTypeScriptModule(
-      path2.join(options.projectRoot, "app", "game.ts")
+      path.join(options.projectRoot, "app", "game.ts")
     ),
     importTypeScriptModule(
-      path2.join(options.projectRoot, "shared", "manifest-contract.ts")
-    )
+      path.join(options.projectRoot, "shared", "manifest-contract.ts")
+    ),
+    loadProjectReducerNativeModules(options.projectRoot)
   ]);
   const matchingScenarios = scenarios.filter(
     (scenario2) => scenario2.definition.id === options.scenarioId
@@ -2089,7 +1971,7 @@ async function replayScenarioThroughBackend(options) {
   const generatedBase = generatedBaseStates?.[baseStateKey(base.definition.id)];
   if (!generatedBase) {
     throw new Error(
-      `Missing generated base artifact for '${base.definition.id}'. Run 'dreamboard test generate' before replaying a scenario.`
+      `Missing generated base artifact for '${base.definition.id}'. Run 'dreamboard test' before replaying a scenario.`
     );
   }
   validateGeneratedFingerprint({
@@ -2110,6 +1992,7 @@ async function replayScenarioThroughBackend(options) {
     basesById
   });
   const shadow = new ShadowReducerRuntime(
+    await loadProjectReducerNativeModules(options.projectRoot),
     manifest,
     gameModule.default,
     createInitialTable,
@@ -2122,7 +2005,7 @@ async function replayScenarioThroughBackend(options) {
     const parentArtifact = generatedBaseStates?.[baseStateKey(base.definition.extends)];
     if (!parentArtifact || typeof parentArtifact.version !== "number") {
       throw new Error(
-        `Base '${base.definition.id}' extends '${base.definition.extends}', but the parent artifact is missing or stale. Run 'dreamboard test generate' first.`
+        `Base '${base.definition.id}' extends '${base.definition.extends}', but the parent artifact is missing or stale. Run 'dreamboard test' first.`
       );
     }
     shadow.hydrate(parentArtifact.snapshot, parentArtifact.version);
@@ -2160,9 +2043,8 @@ async function replayScenarioThroughBackend(options) {
   }
   const diagnostics = [];
   const context = await createScenarioContext({
-    runner: "reducer",
     shadow,
-    expect: (await loadTestingExpectApiFactory())(),
+    expect: (await loadProjectReducerNativeModules(options.projectRoot)).createExpectApi(),
     live: {
       sessionId: session.sessionId,
       version: 0,
@@ -2211,18 +2093,20 @@ async function createScenarioActionPlan(options) {
     generatedBaseStates,
     manifest,
     gameModule,
-    manifestContractModule
+    manifestContractModule,
+    modules
   ] = await Promise.all([
     loadTypedBases(options.projectRoot),
     loadTypedScenarios(options.projectRoot, {}),
     loadGeneratedBaseStates(options.projectRoot),
     loadManifest(options.projectRoot),
     importTypeScriptModule(
-      path2.join(options.projectRoot, "app", "game.ts")
+      path.join(options.projectRoot, "app", "game.ts")
     ),
     importTypeScriptModule(
-      path2.join(options.projectRoot, "shared", "manifest-contract.ts")
-    )
+      path.join(options.projectRoot, "shared", "manifest-contract.ts")
+    ),
+    loadProjectReducerNativeModules(options.projectRoot)
   ]);
   const matchingScenarios = scenarios.filter(
     (scenario2) => scenario2.definition.id === options.scenarioId
@@ -2244,7 +2128,7 @@ async function createScenarioActionPlan(options) {
   const generatedBase = generatedBaseStates?.[baseStateKey(base.definition.id)];
   if (!generatedBase) {
     throw new Error(
-      `Missing generated base artifact for '${base.definition.id}'. Run 'dreamboard test generate' before replaying a scenario.`
+      `Missing generated base artifact for '${base.definition.id}'. Run 'dreamboard test' before replaying a scenario.`
     );
   }
   validateGeneratedFingerprint({
@@ -2265,6 +2149,7 @@ async function createScenarioActionPlan(options) {
     basesById
   });
   const shadow = new ShadowReducerRuntime(
+    await loadProjectReducerNativeModules(options.projectRoot),
     manifest,
     gameModule.default,
     createInitialTable,
@@ -2277,16 +2162,15 @@ async function createScenarioActionPlan(options) {
     const parentArtifact = generatedBaseStates?.[baseStateKey(base.definition.extends)];
     if (!parentArtifact || typeof parentArtifact.version !== "number") {
       throw new Error(
-        `Base '${base.definition.id}' extends '${base.definition.extends}', but the parent artifact is missing or stale. Run 'dreamboard test generate' first.`
+        `Base '${base.definition.id}' extends '${base.definition.extends}', but the parent artifact is missing or stale. Run 'dreamboard test' first.`
       );
     }
     shadow.hydrate(parentArtifact.snapshot, parentArtifact.version);
   }
   const diagnostics = [];
   const context = await createScenarioContext({
-    runner: "reducer",
     shadow,
-    expect: (await loadTestingExpectApiFactory())(),
+    expect: (await loadProjectReducerNativeModules(options.projectRoot)).createExpectApi(),
     actionPlan: {
       submitIndex: 0,
       diagnostics
@@ -2509,18 +2393,18 @@ function sortBasesForArtifacts(bases, basesById) {
   return ordered;
 }
 function writeProjectionSnapshots(options) {
-  const projectionDir = path2.join(
+  const projectionDir = resolveWorkspacePath(
     options.projectRoot,
-    "test",
-    "generated",
-    "bases",
-    options.baseId
+    `test/generated/bases/${sanitizeSnapshotSegment(options.baseId)}`
   );
   rmSync(projectionDir, { recursive: true, force: true });
   mkdirSync(projectionDir, { recursive: true });
   const projection = options.shadow.projectAllSeats();
   for (const [playerId, seatProjection] of Object.entries(projection.seats)) {
-    const outputPath = path2.join(projectionDir, `${playerId}.projection.json`);
+    const outputPath = resolveWorkspacePath(
+      options.projectRoot,
+      `test/generated/bases/${sanitizeSnapshotSegment(options.baseId)}/${sanitizeSnapshotSegment(playerId)}.projection.json`
+    );
     writeFileSync(
       outputPath,
       `${JSON.stringify(
@@ -2540,7 +2424,7 @@ function writeProjectionSnapshots(options) {
 function validateTypedScenarioBases(scenarios, basesById) {
   const available = new Set(basesById.keys());
   const invalid = scenarios.filter((scenario) => !available.has(scenario.definition.from)).map(
-    (scenario) => path2.relative(process.cwd(), scenario.filePath) + ` -> '${scenario.definition.from}'`
+    (scenario) => path.relative(process.cwd(), scenario.filePath) + ` -> '${scenario.definition.from}'`
   );
   if (invalid.length > 0) {
     throw new Error(
@@ -2554,28 +2438,32 @@ async function writeReducerNativeGeneratedFiles(options) {
   const manifestHash = hashContent(JSON.stringify(manifest));
   const appBundleHash = hashContent(
     await bundleTypeScriptModuleText(
-      path2.join(options.projectRoot, "app", "game.ts")
+      path.join(options.projectRoot, "app", "game.ts")
     )
   );
   const uiContractHash = hashContent(
     await bundleTypeScriptModuleText(
-      path2.join(options.projectRoot, "shared", "generated", "ui-contract.ts"),
+      path.join(options.projectRoot, "shared", "generated", "ui-contract.ts"),
       { external: SDK_UI_RUNTIME_EXTERNALS }
     )
   );
-  const generatedDir = path2.join(options.projectRoot, "test", "generated");
+  const generatedDir = resolveWorkspacePath(
+    options.projectRoot,
+    "test/generated"
+  );
   await ensureDir(generatedDir);
   const baseStates = {};
-  const [gameModule, manifestContractModule] = await Promise.all([
+  const [gameModule, manifestContractModule, modules] = await Promise.all([
     importTypeScriptModule(
-      path2.join(options.projectRoot, "app", "game.ts")
+      path.join(options.projectRoot, "app", "game.ts")
     ),
     importTypeScriptModule(
-      path2.join(options.projectRoot, "shared", "manifest-contract.ts")
-    )
+      path.join(options.projectRoot, "shared", "manifest-contract.ts")
+    ),
+    loadProjectReducerNativeModules(options.projectRoot)
   ]);
   const createInitialTable = typeof manifestContractModule.createInitialTable === "function" ? manifestContractModule.createInitialTable : null;
-  const contractFingerprintValue = contractFingerprint(
+  const contractFingerprintValue = modules.contractFingerprint(
     gameModule.default
   ).value;
   const basesById = new Map(
@@ -2589,6 +2477,7 @@ async function writeReducerNativeGeneratedFiles(options) {
       basesById
     });
     const shadow = new ShadowReducerRuntime(
+      modules,
       manifest,
       gameModule.default,
       createInitialTable,
@@ -2624,16 +2513,23 @@ async function writeReducerNativeGeneratedFiles(options) {
       shadow.hydrate(parentArtifact.snapshot, parentArtifact.version);
     }
     const context = await createScenarioContext({
-      runner: "reducer",
       shadow,
-      expect: (await loadTestingExpectApiFactory())()
+      expect: modules.createExpectApi()
     });
     await context.game.start();
-    await base.definition.setup({
-      game: context.game,
-      players: context.players,
-      seat: context.seat
-    });
+    try {
+      await base.definition.setup({
+        game: context.game,
+        players: context.players,
+        seat: context.seat
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      throw new Error(
+        `Base '${base.definition.id}' setup failed with setupProfileId '${effectiveSetup.setupProfileId ?? "none"}': ${message}`,
+        { cause: error instanceof Error ? error : void 0 }
+      );
+    }
     baseStates[baseStateKey(base.definition.id)] = {
       key: baseStateKey(base.definition.id),
       base: base.definition.id,
@@ -2661,42 +2557,48 @@ async function writeReducerNativeGeneratedFiles(options) {
       shadow
     });
   }
-  const header = "// Generated by dreamboard test generate. Do not edit by hand.\n";
-  await writeTextFile(
-    path2.join(generatedDir, "base-states.generated.ts"),
+  const header = "// Generated by dreamboard test. Do not edit by hand.\n";
+  await writeWorkspaceTextFile(
+    options.projectRoot,
+    "test/generated/base-states.generated.ts",
     `${header}export const BASE_STATES = ${JSON.stringify(baseStates, null, 2)} as const;
 export const BASE_STATES_CONTRACT_FINGERPRINT = ${JSON.stringify(contractFingerprintValue)};
 `
   );
-  await writeTextFile(
-    path2.join(generatedDir, "base-states.generated.d.ts"),
+  await writeWorkspaceTextFile(
+    options.projectRoot,
+    "test/generated/base-states.generated.d.ts",
     `${header}export declare const BASE_STATES: Record<string, unknown>;
 export declare const BASE_STATES_CONTRACT_FINGERPRINT: string | undefined;
 `
   );
-  await writeTextFile(
-    path2.join(generatedDir, "scenario-manifest.generated.ts"),
+  await writeWorkspaceTextFile(
+    options.projectRoot,
+    "test/generated/scenario-manifest.generated.ts",
     `${header}export const SCENARIO_MANIFEST = ${JSON.stringify(
       options.scenarios.map((scenario) => ({
         id: scenario.definition.id,
-        filePath: path2.relative(generatedDir, scenario.filePath),
-        base: scenario.definition.from,
-        runners: normalizeScenarioRunners(scenario.definition.runners)
+        filePath: path.relative(generatedDir, scenario.filePath),
+        base: scenario.definition.from
       })),
       null,
       2
     )} as const;
 `
   );
-  await writeJsonFile(path2.join(generatedDir, ".generation-meta.json"), {
-    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    contractFingerprint: contractFingerprintValue,
-    scenarioCount: options.scenarios.length,
-    baseStateCount: options.bases.length
-  });
+  await writeWorkspaceJsonFile(
+    options.projectRoot,
+    "test/generated/.generation-meta.json",
+    {
+      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      contractFingerprint: contractFingerprintValue,
+      scenarioCount: options.scenarios.length,
+      baseStateCount: options.bases.length
+    }
+  );
 }
 async function loadGeneratedBaseStates(projectRoot) {
-  const filePath = path2.join(
+  const filePath = path.join(
     projectRoot,
     "test",
     "generated",
@@ -2709,7 +2611,7 @@ async function loadGeneratedBaseStates(projectRoot) {
   return module.BASE_STATES ?? null;
 }
 async function loadGeneratedScenarioManifest(projectRoot) {
-  const filePath = path2.join(
+  const filePath = path.join(
     projectRoot,
     "test",
     "generated",
@@ -2734,7 +2636,7 @@ function validateGeneratedFingerprint(options) {
   const mismatches = [];
   if (options.generated.contractFingerprint && options.current.contractFingerprint && options.generated.contractFingerprint !== options.current.contractFingerprint) {
     const error = new Error(
-      `Base states were generated for contract ${options.generated.contractFingerprint} but the current contract is ${options.current.contractFingerprint}. Remedy: run \`dreamboard test generate\`, then re-run the tests.`
+      `Base states were generated for contract ${options.generated.contractFingerprint} but the current contract is ${options.current.contractFingerprint}. Remedy: run \`dreamboard test\`, then re-run the tests.`
     );
     error.code = STALE_CONTRACT_ARTIFACT_CODE;
     throw error;
@@ -2765,16 +2667,19 @@ function validateGeneratedFingerprint(options) {
   }
   if (mismatches.length > 0) {
     throw new Error(
-      `${mismatches.join("; ")}. Run 'dreamboard test generate' to refresh reducer-native base artifacts.`
+      `${mismatches.join("; ")}. Run 'dreamboard test' to refresh reducer-native base artifacts.`
     );
   }
 }
 async function currentFingerprint(options) {
   const manifest = await loadManifest(options.projectRoot);
-  const gameModule = await importTypeScriptModule(
-    path2.join(options.projectRoot, "app", "game.ts")
-  );
-  const contractFingerprintValue = contractFingerprint(
+  const [gameModule, modules] = await Promise.all([
+    importTypeScriptModule(
+      path.join(options.projectRoot, "app", "game.ts")
+    ),
+    loadProjectReducerNativeModules(options.projectRoot)
+  ]);
+  const contractFingerprintValue = modules.contractFingerprint(
     gameModule.default
   ).value;
   const resolvedBase = resolveBaseDefinition(
@@ -2812,12 +2717,12 @@ async function currentFingerprint(options) {
     manifestHash: hashContent(JSON.stringify(manifest)),
     appBundleHash: hashContent(
       await bundleTypeScriptModuleText(
-        path2.join(options.projectRoot, "app", "game.ts")
+        path.join(options.projectRoot, "app", "game.ts")
       )
     ),
     uiContractHash: hashContent(
       await bundleTypeScriptModuleText(
-        path2.join(options.projectRoot, "shared", "generated", "ui-contract.ts"),
+        path.join(options.projectRoot, "shared", "generated", "ui-contract.ts"),
         { external: SDK_UI_RUNTIME_EXTERNALS }
       )
     ),
@@ -2857,7 +2762,8 @@ async function runReducerNativeScenarios(options) {
     initialGeneratedBaseStates,
     manifest,
     gameModule,
-    manifestContractModule
+    manifestContractModule,
+    modules
   ] = await Promise.all([
     loadTypedBases(options.projectRoot),
     loadTypedScenarios(options.projectRoot, {
@@ -2866,11 +2772,12 @@ async function runReducerNativeScenarios(options) {
     loadGeneratedBaseStates(options.projectRoot),
     loadManifest(options.projectRoot),
     importTypeScriptModule(
-      path2.join(options.projectRoot, "app", "game.ts")
+      path.join(options.projectRoot, "app", "game.ts")
     ),
     importTypeScriptModule(
-      path2.join(options.projectRoot, "shared", "manifest-contract.ts")
-    )
+      path.join(options.projectRoot, "shared", "manifest-contract.ts")
+    ),
+    loadProjectReducerNativeModules(options.projectRoot)
   ]);
   let generatedBaseStates = initialGeneratedBaseStates;
   const createInitialTable = typeof manifestContractModule.createInitialTable === "function" ? manifestContractModule.createInitialTable : null;
@@ -2887,251 +2794,121 @@ async function runReducerNativeScenarios(options) {
     });
     generatedBaseStates = await loadGeneratedBaseStates(options.projectRoot);
   }
-  const runnerScenarios = scenarios.filter(
-    (scenario) => normalizeScenarioRunners(scenario.definition.runners).includes(
-      options.runner
-    )
-  );
-  let browser = null;
-  let page = null;
-  let browserBridge = null;
-  let browserDriver = null;
-  if (options.runner === "browser") {
-    const webBaseUrl = options.webBaseUrl ?? options.projectConfig.webBaseUrl;
-    if (!webBaseUrl) {
+  let passed = 0;
+  let failed = 0;
+  const results = [];
+  for (const scenario of scenarios) {
+    const base = basesById.get(scenario.definition.from);
+    if (!base) {
       throw new Error(
-        "Browser runner requires a local webBaseUrl. Start the local web stack and configure the project for env local."
+        `Missing typed base '${scenario.definition.from}' for scenario '${scenario.definition.id}'.`
       );
     }
-    browserDriver = await loadBrowserDriver(options.projectRoot);
-    const opened = await openBrowserPage(
-      `${webBaseUrl}/_dev`,
-      options.resolvedConfig
-    );
-    browser = opened.browser;
-    page = opened.page;
-  }
-  try {
-    let passed = 0;
-    let failed = 0;
-    const results = [];
-    for (const scenario of runnerScenarios) {
-      const base = basesById.get(scenario.definition.from);
-      if (!base) {
-        throw new Error(
-          `Missing typed base '${scenario.definition.from}' for scenario '${scenario.definition.id}'.`
-        );
+    if (generatedBaseStates?.[baseStateKey(base.definition.id)]) {
+      validateGeneratedFingerprint({
+        generated: generatedBaseStates[baseStateKey(base.definition.id)].fingerprint,
+        current: await currentFingerprint({
+          projectRoot: options.projectRoot,
+          base,
+          basesById,
+          compiledResultId: options.compiledResultId,
+          gameId: options.gameId
+        })
+      });
+    }
+    try {
+      const resolvedBase = resolveBaseDefinition(base, basesById);
+      const effectiveSetup = resolveEffectiveBaseSetup({
+        manifest,
+        base: base.definition,
+        basesById
+      });
+      const shadow = new ShadowReducerRuntime(
+        modules,
+        manifest,
+        gameModule.default,
+        createInitialTable,
+        resolvedBase.seed,
+        resolvedBase.players,
+        effectiveSetup.setupProfileId,
+        options.debug ?? false
+      );
+      if (base.definition.extends) {
+        const parentArtifact = generatedBaseStates?.[baseStateKey(base.definition.extends)];
+        if (!parentArtifact) {
+          throw new Error(
+            `Base '${base.definition.id}' extends '${base.definition.extends}', but the parent artifact is missing. Run 'dreamboard test' first.`
+          );
+        }
+        shadow.hydrate(parentArtifact.snapshot, parentArtifact.version);
       }
-      if (generatedBaseStates?.[baseStateKey(base.definition.id)]) {
-        validateGeneratedFingerprint({
-          generated: generatedBaseStates[baseStateKey(base.definition.id)].fingerprint,
-          current: await currentFingerprint({
+      const context = await createScenarioContext({
+        shadow,
+        expect: modules.createExpectApi({
+          matchSnapshot: createScenarioSnapshotMatcher({
             projectRoot: options.projectRoot,
-            base,
-            basesById,
-            compiledResultId: options.compiledResultId,
-            gameId: options.gameId
+            scenarioId: scenario.definition.id,
+            updateSnapshots: options.updateSnapshots ?? false
           })
-        });
-      } else if (options.runner !== "reducer") {
+        })
+      });
+      await context.game.start();
+      await base.definition.setup({
+        game: context.game,
+        players: context.players,
+        seat: context.seat
+      });
+      shadow.clearHistory();
+      await scenario.definition.when(context);
+      if (scenario.definition.phase && shadow.phase() !== scenario.definition.phase) {
         throw new Error(
-          "Missing reducer-native generated base artifacts. Run 'dreamboard test generate' first."
+          `Scenario '${scenario.definition.id}' expected phase '${scenario.definition.phase}' but reached '${shadow.phase()}'.`
         );
       }
-      try {
-        const resolvedBase = resolveBaseDefinition(base, basesById);
-        const effectiveSetup = resolveEffectiveBaseSetup({
-          manifest,
-          base: base.definition,
-          basesById
-        });
-        const shadow = new ShadowReducerRuntime(
-          manifest,
-          gameModule.default,
-          createInitialTable,
-          resolvedBase.seed,
-          resolvedBase.players,
-          effectiveSetup.setupProfileId,
-          options.debug ?? false
+      if (scenario.definition.stage && shadow.currentStage() !== scenario.definition.stage) {
+        throw new Error(
+          `Scenario '${scenario.definition.id}' expected stage '${scenario.definition.stage}' but reached '${shadow.currentStage() ?? "null"}'.`
         );
-        if (base.definition.extends) {
-          const parentArtifact = generatedBaseStates?.[baseStateKey(base.definition.extends)];
-          if (!parentArtifact) {
-            throw new Error(
-              `Base '${base.definition.id}' extends '${base.definition.extends}', but the parent artifact is missing. Run 'dreamboard test generate' first.`
-            );
-          }
-          shadow.hydrate(parentArtifact.snapshot, parentArtifact.version);
-        }
-        let remote;
-        if (options.runner === "remote") {
-          const compiledResultId = options.compiledResultId ?? options.projectConfig.compile?.latestSuccessful?.resultId;
-          if (!compiledResultId) {
-            throw new Error(
-              "Remote runner requires a compiled result. Compile the workspace first."
-            );
-          }
-          const {
-            data: session,
-            error: sessionError,
-            response: sessionResponse
-          } = await createProjectSession({
-            path: { projectId: options.projectConfig.projectId },
-            body: {
-              compiledResultId,
-              seed: resolvedBase.seed,
-              playerCount: resolvedBase.players,
-              autoAssignSeats: true,
-              setupProfileId: effectiveSetup.setupProfileId ?? void 0
-            }
-          });
-          if (!session || sessionError) {
-            throw toDreamboardApiError(
-              sessionError,
-              sessionResponse,
-              "Failed to create remote-runner session."
-            );
-          }
-          const tracker = new RemoteGameplayTracker(
-            session.sessionId,
-            "player-1"
-          );
-          const { error: startError, response: startResponse } = await startGame({
-            path: { sessionId: session.sessionId }
-          });
-          if (startError) {
-            throw toDreamboardApiError(
-              startError,
-              startResponse,
-              "Failed to start remote-runner session."
-            );
-          }
-          await tracker.bootstrap();
-          remote = {
-            sessionId: session.sessionId,
-            tracker
-          };
-        }
-        if (options.runner === "browser" && page) {
-          const compiledResultId = options.compiledResultId ?? options.projectConfig.compile?.latestSuccessful?.resultId;
-          if (!compiledResultId) {
-            throw new Error(
-              "Browser runner requires a compiled result. Compile the workspace first."
-            );
-          }
-          const {
-            data: session,
-            error: sessionError,
-            response: sessionResponse
-          } = await createProjectSession({
-            path: { projectId: options.projectConfig.projectId },
-            body: {
-              compiledResultId,
-              seed: resolvedBase.seed,
-              playerCount: resolvedBase.players,
-              autoAssignSeats: true,
-              setupProfileId: effectiveSetup.setupProfileId ?? void 0
-            }
-          });
-          if (!session || sessionError) {
-            throw toDreamboardApiError(
-              sessionError,
-              sessionResponse,
-              "Failed to create browser-runner session."
-            );
-          }
-          const { error: startError, data: started } = await startGame({
-            path: { sessionId: session.sessionId }
-          });
-          if (startError || !started) {
-            throw new Error("Failed to start browser-runner session.");
-          }
-          await page.goto(
-            `${options.webBaseUrl ?? options.projectConfig.webBaseUrl}/_dev/play/${started.context.shortCode}`,
-            { waitUntil: "domcontentloaded" }
-          );
-          await waitForGameReady(page);
-          browserBridge = await createBrowserBridgeClient(page);
-          await browserDriver?.onReady?.(browserBridge);
-        }
-        const context = await createScenarioContext({
-          runner: options.runner,
-          shadow,
-          expect: (await loadTestingExpectApiFactory())({
-            matchSnapshot: createScenarioSnapshotMatcher({
-              projectRoot: options.projectRoot,
-              scenarioId: scenario.definition.id,
-              updateSnapshots: options.updateSnapshots ?? false
-            })
-          }),
-          remote,
-          browser: options.runner === "browser" && browserBridge ? {
-            bridge: browserBridge,
-            driver: browserDriver
-          } : void 0
-        });
-        await context.game.start();
-        await base.definition.setup({
-          game: context.game,
-          players: context.players,
-          seat: context.seat
-        });
-        shadow.clearHistory();
-        await scenario.definition.when(context);
-        if (scenario.definition.phase && shadow.phase() !== scenario.definition.phase) {
-          throw new Error(
-            `Scenario '${scenario.definition.id}' expected phase '${scenario.definition.phase}' but reached '${shadow.phase()}'.`
-          );
-        }
-        if (scenario.definition.stage && shadow.currentStage() !== scenario.definition.stage) {
-          throw new Error(
-            `Scenario '${scenario.definition.id}' expected stage '${scenario.definition.stage}' but reached '${shadow.currentStage() ?? "null"}'.`
-          );
-        }
-        await scenario.definition.then(context);
-        passed += 1;
-        results.push({
-          id: scenario.definition.id,
-          success: true
-        });
-      } catch (error) {
-        failed += 1;
-        results.push({
-          id: scenario.definition.id,
-          success: false,
-          errorCode: isStaleContractArtifactError(error) ? STALE_CONTRACT_ARTIFACT_CODE : void 0,
-          error: error instanceof Error ? formatScenarioErrorForDisplay({
-            error,
-            projectRoot: options.projectRoot,
-            scenarioFilePath: scenario.filePath
-          }) : `Scenario '${scenario.definition.id}' failed.`
-        });
       }
-    }
-    return { passed, failed, results };
-  } finally {
-    if (browser) {
-      await browser.close();
+      await scenario.definition.then(context);
+      passed += 1;
+      results.push({
+        id: scenario.definition.id,
+        success: true
+      });
+    } catch (error) {
+      failed += 1;
+      results.push({
+        id: scenario.definition.id,
+        success: false,
+        errorCode: isStaleContractArtifactError(error) ? STALE_CONTRACT_ARTIFACT_CODE : void 0,
+        error: error instanceof Error ? formatScenarioErrorForDisplay({
+          error,
+          projectRoot: options.projectRoot,
+          scenarioFilePath: scenario.filePath
+        }) : `Scenario '${scenario.definition.id}' failed.`
+      });
+    } finally {
     }
   }
+  return { passed, failed, results };
 }
-
 export {
+  assertDispatchResultWireContract,
+  createActionPlanReplaySession,
+  createScenarioActionPlan,
+  createSessionFromScenario,
+  ensureReducerNativeTestingFiles,
   formatScenarioErrorForDisplay,
+  generateReducerNativeArtifacts,
   isReducerNativeTestingWorkspace,
-  ensureReducerNativeTestingFiles,
   loadTypedBases,
   loadTypedScenarios,
-  assertDispatchResultWireContract,
-  createSessionFromScenario,
   materializeScenarioReducerState,
-  replayScenarioThroughBackend,
-  createScenarioActionPlan,
-  replayActionPlanThroughBackend,
-  createActionPlanReplaySession,
   replayActionPlanInSession,
-  writeReducerNativeGeneratedFiles,
-  generateReducerNativeArtifacts,
-  runReducerNativeScenarios
+  replayActionPlanThroughBackend,
+  replayScenarioThroughBackend,
+  runReducerNativeScenarios,
+  writeReducerNativeGeneratedFiles
 };
-//# sourceMappingURL=chunk-E7SSWJXJ.mjs.map
+//# sourceMappingURL=reducer-native-test-harness-UFMSNNDY.mjs.map