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

package/README.md

@@ -1,50 +1,207 @@
-# Dreamboard CLI
+# dreamboard
 
-Dreamboard CLI supports three main workflows:
+Dreamboard CLI for working with Dreamboard games from your own editor/tooling.
 
-- Authoring: `dreamboard sync`, `dreamboard compile`, `dreamboard pull`
-- Interactive verification: `dreamboard dev`
-- Scripted verification: `dreamboard test generate`, `dreamboard test run`
+Dreamboard is built to take you from napkin sketch to playable prototype without the paper cuts:
+
+- Describe the game you want to make.
+- Generate the rules, components, and scaffolding.
+- Playtest instantly with a frictionless lobby and live iteration loops.
+
+The platform’s core promise is the same one described on the landing page: digital prototyping for everyone, with AI helping you move from idea to playable faster.
 
 ## Install
 
+Published npm package:
+
 ```bash
 npm install -g dreamboard
+```
+
+The published CLI targets Node 20+.
+
+## Why Dreamboard
+
+- `Describe`: start from theme, mechanics, and player experience instead of boilerplate setup.
+- `Generate`: Dreamboard handles the sandbox primitives like turns, hands, and structured scaffolding.
+- `Playtest`: share a live prototype instead of printing fresh paper every time a rule changes.
+- `Iterate live`: keep testing momentum by changing values and flows without resetting the whole process.
+
+## Authentication
+
+Use browser login:
+
+```bash
 dreamboard login
 ```
 
-## Create a game
+The published CLI stores your refreshable session in:
+
+```bash
+~/.dreamboard/config.json
+```
+
+That stored session includes the refresh token the CLI needs to renew access automatically. Direct JWT injection is intentionally not part of the published CLI flow.
+
+## Source Checkout Setup
+
+For local source-checkout development, install workspace dependencies with pnpm and keep Bun available for local embedded-harness workflows:
+
+```bash
+pnpm install
+```
+
+Playwright (for `dreamboard run`):
+
+```bash
+npx playwright install
+```
+
+## Commands
+
+Create a new game:
+
+```bash
+dreamboard new my-game --description "A trick-taking card game"
+```
+
+Clone an existing game:
 
 ```bash
-dreamboard new my-game --description "A short game description"
-cd my-game
+dreamboard clone my-game
 ```
 
-## Iterate
+Sync local authored changes and regenerate scaffolded files:
 
 ```bash
 dreamboard sync
+dreamboard sync --update-sdk
+```
+
+If the remote has advanced unexpectedly, reconcile authored changes explicitly with:
+
+```bash
+dreamboard pull
+```
+
+Compile the current authored head:
+
+```bash
 dreamboard compile
-dreamboard dev
+dreamboard compile --skip-local-check
+```
+
+Inspect local vs remote state:
+
+```bash
+dreamboard status
+dreamboard status --json
+```
+
+Run the game locally (server-compiled UI):
+
+```bash
+dreamboard run
+dreamboard run --players 4
+dreamboard run --seed 1337
+dreamboard run --new-session
+```
+
+If no successful compile exists for the current authored state yet, `dreamboard run` will ask you to run `dreamboard compile` first.
+By default, the CLI uses `manifest.json`'s `playerConfig.minPlayers` to decide how many seats to create.
+
+`dreamboard run` now defaults to a wait-and-observe loop when no scenario is provided:
+
+1. Reuse the previous active session (`--resume` defaults to true) unless `--new-session` is set.
+2. Subscribe to session SSE events.
+3. Exit when `YOUR_TURN` (default `--until`) or `GAME_ENDED` is received.
+4. Persist artifacts in `.dreamboard/run/`:
+   - `session.json`
+   - `events.ndjson`
+   - `latest-your-turn.json`
+   - `last-run-summary.json`
+
+`dreamboard run` is deterministic-by-default for new sessions: if `--seed` is not provided, it uses `1337`.
+
+Useful flags:
+
+- `--until YOUR_TURN|GAME_ENDED|ANY`
+- `--observe-events turns|all` (default `turns`; persist `YOUR_TURN` and `ACTION_REJECTED` messages)
+- `--seed <int>` (deterministic RNG seed for new sessions, default `1337`)
+- `--timeout-ms <ms>`
+- `--max-events <count>`
+- `--screenshot` (capture one Playwright screenshot for the selected run session)
+- `--output <path>`
+- `--delay <ms>`
+- `--width <px>`
+- `--height <px>`
+- `--scenario-driver api|ui` (default `api`)
+
+Playwright launch is now optional:
+
+1. It is launched when `--scenario-driver ui` is used.
+2. It is launched when `--screenshot` is used.
+3. Default API scenarios (`--scenario` with `--scenario-driver api`) do not require Playwright.
+4. Pure observe runs (`dreamboard run` without scenario/screenshot) do not require a browser session.
+
+## Scenario Files
+
+`dreamboard run --scenario <file>` supports scenario JSON (API driver by default):
+
+```json
+{
+  "steps": [
+    {
+      "playerId": "player-1",
+      "actionType": "playCard",
+      "parameters": { "cardId": "hearts-7" },
+      "turns": 1
+    },
+    {
+      "playerId": "player-1",
+      "actionType": "endTurn",
+      "parameters": {},
+      "turns": 1
+    }
+  ]
+}
+```
+
+`playerId` is required on every scenario step. The CLI executes all steps in order per invocation:
+
+```bash
+dreamboard run
+dreamboard run --scenario path/to/scenario.json
+dreamboard run --scenario path/to/scenario.json --scenario-driver ui
 ```
 
-`dreamboard dev` starts the local iframe host for the current project while gameplay continues on the backend.
+If there is no current `.dreamboard/run/latest-your-turn.json` for the active session (for example with `--new-session`), `dreamboard run --scenario ...` first observes SSE until it receives the initial `YOUR_TURN`, then starts executing scenario steps.
+
+API-driven scenarios are strict per step: after each `submitAction`, the CLI waits for either `ACTION_EXECUTED` or `ACTION_REJECTED`. On rejection, it stops immediately with `stopReason=scenario_rejected`.
+
+Screenshots are saved to `.dreamboard/screenshots/` by default. The CLI captures the same session selected by `--resume` / `--new-session`.
 
-## Test
+To capture a screenshot during observe or scenario runs:
 
 ```bash
-dreamboard test generate
-dreamboard test run
-dreamboard test run --scenario test/scenarios/example.scenario.ts
+dreamboard run --screenshot
+dreamboard run --scenario path/to/scenario.json --screenshot
+dreamboard run --screenshot --output ./shot.png --delay 1500 --width 1440 --height 900
 ```
 
-Scenario assertions must use the projection-only API from `test/testing-types.ts`:
+## Notes
 
-- `players()`
-- `state()`
-- `view(playerId)`
-- `expect`
+- Project state lives in `.dreamboard/project.json`.
+- Snapshots for `status` are stored in `.dreamboard/snapshot.json`.
+- Published/public CLI installs target Node 20+ and support remote workflows.
+- Published/public CLI builds are production-only; they do not support environment overrides or direct JWT injection.
+- Local embedded-harness testing remains Bun-only and requires a source checkout with local backend support.
+- Internal source-checkout builds may expose extra auth and environment helpers, but those are not part of the published CLI contract.
 
-## Scaffold ownership
+## Skill Source
 
-Framework-owned static scaffold files are restored by `dreamboard sync`. Generated projects no longer expose wire-format message typings.
+- Public skill source lives under `skills/dreamboard/`.
+- `skills/dreamboard/references/*.md` are generated from `docs/` via `pnpm run sync:skill-docs`.
+- `dreamboard new` installs the bundled skill into `.agents/skills/dreamboard/` in the generated game project.
+- The Node helper script for run-artifact inspection is `.agents/skills/dreamboard/scripts/events-extract.mjs`.
+- Public GitHub repo for the CLI is [dreamboard-games/dreamboard-cli](https://github.com/dreamboard-games/dreamboard-cli).

package/dist/agent-verifier/agent-workspace-verifier.mjs

@@ -3,16 +3,16 @@ import {
   assertCompilerPortableDependencies,
   consola,
   resolveProjectContext
-} from "./chunk-JH22JNYD.mjs";
-import "./chunk-HJFQDSTU.mjs";
-import "./chunk-4WD3YU2E.mjs";
-import "./chunk-2E5P5NWG.mjs";
-import "./chunk-MINCYHXN.mjs";
-import "./chunk-LM3OZLZG.mjs";
-import "./chunk-SHUMAVAP.mjs";
-import "./chunk-XYDL7GY6.mjs";
+} from "./chunk-3UKQVWLV.mjs";
+import "./chunk-SH5JKYOB.mjs";
+import "./chunk-776W3UGV.mjs";
+import "./chunk-NAK77WXW.mjs";
+import "./chunk-TAEQKBJB.mjs";
+import "./chunk-IAYRNVUC.mjs";
+import "./chunk-H76MT5UR.mjs";
+import "./chunk-SKI2ESE5.mjs";
 
-// src/agent-workspace-verifier.ts
+// src/agent-verifier/agent-workspace-verifier.ts
 import { readFile } from "fs/promises";
 main().catch((error) => {
   console.error(error instanceof Error ? error.message : String(error));
@@ -39,15 +39,17 @@ function printHelp() {
 
 Usage:
   agent-workspace-verifier materialize-prepared-workspace --input <path>
-  agent-workspace-verifier preflight [--env local|dev|prod]
-  agent-workspace-verifier verify [--env local|dev|prod]
-  agent-workspace-verifier fin [--env local|dev|prod]
+  agent-workspace-verifier preflight [--env local|staging|prod]
+  agent-workspace-verifier verify [--env local|staging|prod]
+  agent-workspace-verifier fin [--env local|staging|prod]
 `);
 }
 async function materializePreparedWorkspace(args) {
   const inputPath = readRequiredOption(args, "--input");
-  const input = JSON.parse(await readFile(inputPath, "utf8"));
-  const { materializeWorkspaceProject } = await import("./materialize-workspace-FKALAE2T.mjs");
+  const { materializeWorkspaceProject } = await import("./materialize-workspace-ZAVGQQSF.mjs");
+  const input = JSON.parse(
+    await readFile(inputPath, "utf8")
+  );
   await materializeWorkspaceProject({
     ...input,
     agentManaged: true,
@@ -80,9 +82,9 @@ async function verifyAgentWorkspace(rawMode, args) {
 }
 async function runFullBackendConnectedVerification(parsedFlags) {
   const [{ default: cmdSync }, { default: cmdCompile }, { default: cmdTest }] = await Promise.all([
-    import("./sync-3DUQH32H.mjs"),
-    import("./compile-5QSPIOUT.mjs"),
-    import("./test-P4U5INTD.mjs")
+    import("./sync-THAI546U.mjs"),
+    import("./compile-TEQVA46V.mjs"),
+    import("./test-AFAQFKOB.mjs")
   ]);
   await runCommandDefinition(cmdSync, { ...parsedFlags, force: true });
   await runCommandDefinition(cmdCompile, parsedFlags);
@@ -90,10 +92,7 @@ async function runFullBackendConnectedVerification(parsedFlags) {
     resolveTestSubCommand(cmdTest, "generate"),
     parsedFlags
   );
-  await runCommandDefinition(
-    resolveTestSubCommand(cmdTest, "run"),
-    parsedFlags
-  );
+  await runCommandDefinition(resolveTestSubCommand(cmdTest, "run"), parsedFlags);
 }
 async function runCommandDefinition(command, args) {
   if (!command.run) {
@@ -149,12 +148,12 @@ async function runCloudLocalVerification(projectRoot, projectConfig, config) {
     { assertReducerContractPreflight },
     { getProjectLocalMaintainerRegistry }
   ] = await Promise.all([
-    import("./static-scaffold-AJMZZQWS.mjs"),
-    import("./local-files-MTPLP62S.mjs"),
-    import("./workspace-codegen-JDZJRSDV.mjs"),
-    import("./workspace-dependencies-HZ6VVS4G.mjs"),
-    import("./reducer-contract-preflight-22X7DSZW.mjs"),
-    import("./project-state-7GR6BQTQ.mjs")
+    import("./static-scaffold-R7SVDRQI.mjs"),
+    import("./local-files-JFOQQZDL.mjs"),
+    import("./workspace-codegen-2ZMQRIKJ.mjs"),
+    import("./workspace-dependencies-NOOQBK6I.mjs"),
+    import("./reducer-contract-preflight-TUMQ43JV.mjs"),
+    import("./project-state-K576C2TE.mjs")
   ]);
   consola.start("Refreshing static scaffold...");
   await scaffoldStaticWorkspace(projectRoot, "update", {
@@ -168,8 +167,8 @@ async function runCloudLocalVerification(projectRoot, projectConfig, config) {
   consola.start("Validating reducer contract...");
   await assertReducerContractPreflight(projectRoot);
   const [{ runLocalTypecheck }, { assertReducerBundleSmoke }] = await Promise.all([
-    import("./local-typecheck-QFYYAZOK.mjs"),
-    import("./reducer-bundle-preflight-C73LEXI2.mjs")
+    import("./local-typecheck-XVGWI75X.mjs"),
+    import("./reducer-bundle-preflight-LXNJUBKL.mjs")
   ]);
   consola.start("Running local typecheck...");
   const typecheckResult = await runLocalTypecheck(projectRoot);
@@ -187,7 +186,7 @@ async function runCloudLocalVerification(projectRoot, projectConfig, config) {
     generateReducerNativeArtifacts,
     isReducerNativeTestingWorkspace,
     runReducerNativeScenarios
-  } = await import("./reducer-native-test-harness-GMWBUISX.mjs");
+  } = await import("./reducer-native-test-harness-CHX5MBL5.mjs");
   if (await isReducerNativeTestingWorkspace(projectRoot)) {
     const { bases } = await generateReducerNativeArtifacts({
       projectRoot,
@@ -225,3 +224,4 @@ function readRequiredOption(args, name) {
   }
   return value;
 }
+//# sourceMappingURL=agent-workspace-verifier.mjs.map

package/dist/agent-verifier/agent-workspace-verifier.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/agent-verifier/agent-workspace-verifier.ts"],"sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport consola from \"consola\";\nimport type { CommandDef } from \"citty\";\nimport type { ConfigFlags } from \"../flags.js\";\nimport type { ProjectConfig, ResolvedConfig } from \"../types.js\";\nimport { resolveProjectContext } from \"../config/resolve.js\";\nimport { assertCompilerPortableDependencies } from \"../services/project/dependency-portability.js\";\n\ntype VerificationMode = \"preflight\" | \"verify\" | \"fin\" | \"cloud-local\";\n\nmain().catch((error) => {\n  console.error(error instanceof Error ? error.message : String(error));\n  process.exit(1);\n});\n\nasync function main() {\n  const [command, ...args] = process.argv.slice(2);\n  if (command === \"--help\" || command === \"help\") {\n    printHelp();\n    return;\n  }\n  if (command === \"materialize-prepared-workspace\") {\n    if (args.includes(\"--help\")) {\n      printHelp();\n      return;\n    }\n    await materializePreparedWorkspace(args);\n    return;\n  }\n  await verifyAgentWorkspace(command ?? \"verify\", args);\n}\n\nfunction printHelp() {\n  console.log(`Dreamboard agent workspace verifier\n\nUsage:\n  agent-workspace-verifier materialize-prepared-workspace --input <path>\n  agent-workspace-verifier preflight [--env local|staging|prod]\n  agent-workspace-verifier verify [--env local|staging|prod]\n  agent-workspace-verifier fin [--env local|staging|prod]\n`);\n}\n\nasync function materializePreparedWorkspace(args: string[]) {\n  const inputPath = readRequiredOption(args, \"--input\");\n  const { materializeWorkspaceProject } = await import(\n    \"../services/project/materialize-workspace.js\"\n  );\n  const input = JSON.parse(\n    await readFile(inputPath, \"utf8\"),\n  ) as Parameters<typeof materializeWorkspaceProject>[0];\n  await materializeWorkspaceProject({\n    ...input,\n    agentManaged: true,\n    workspacePrepared: true,\n    allowCreateGame: false,\n    installDependencies: false,\n  });\n  consola.success(`Prepared workspace in ${input.targetDir}`);\n}\n\nasync function verifyAgentWorkspace(rawMode: string, args: string[]) {\n  const requestedMode = parseVerificationMode(rawMode);\n  const parsedFlags = parseConfigArgs(args);\n  const { projectRoot, projectConfig, config } =\n    await resolveProjectContext(parsedFlags);\n  await assertCompilerPortableDependencies({ projectRoot, projectConfig });\n\n  if (requestedMode === \"preflight\") {\n    consola.success(\"Agent workspace preflight passed.\");\n    return;\n  }\n\n  if (process.env.DREAMBOARD_AGENT_FINAL_SYNC_VERIFY === \"1\") {\n    await runFullBackendConnectedVerification(parsedFlags);\n    return;\n  }\n\n  if (\n    requestedMode === \"cloud-local\" ||\n    requestedMode === \"verify\" ||\n    requestedMode === \"fin\"\n  ) {\n    await runCloudLocalVerification(projectRoot, projectConfig, config);\n    return;\n  }\n\n  throw new Error(\n    \"Agent workspaces now run cloud-local verification directly. Use `fin` only through the generated wrapper.\",\n  );\n}\n\nasync function runFullBackendConnectedVerification(\n  parsedFlags: ConfigFlags,\n): Promise<void> {\n  const [{ default: cmdSync }, { default: cmdCompile }, { default: cmdTest }] =\n    await Promise.all([\n      import(\"../commands/sync.js\"),\n      import(\"../commands/compile.js\"),\n      import(\"../commands/test.js\"),\n    ]);\n  await runCommandDefinition(cmdSync, { ...parsedFlags, force: true });\n  await runCommandDefinition(cmdCompile, parsedFlags);\n  await runCommandDefinition(\n    resolveTestSubCommand(cmdTest, \"generate\"),\n    parsedFlags,\n  );\n  await runCommandDefinition(resolveTestSubCommand(cmdTest, \"run\"), parsedFlags);\n}\n\nasync function runCommandDefinition(\n  command: CommandDef<any>,\n  args: Record<string, unknown>,\n) {\n  if (!command.run) {\n    throw new Error(\"Verifier command is missing a runnable step.\");\n  }\n  await command.run({ args, rawArgs: [], cmd: command } as any);\n}\n\nfunction resolveTestSubCommand(\n  cmdTest: CommandDef<any>,\n  name: \"generate\" | \"run\",\n): CommandDef<any> {\n  const subCommands = cmdTest.subCommands as\n    | Record<string, CommandDef<any>>\n    | undefined;\n  const command = subCommands?.[name];\n  if (!command) {\n    throw new Error(`Verifier command is missing test ${name}.`);\n  }\n  return command;\n}\n\nfunction parseVerificationMode(value: unknown): VerificationMode {\n  if (\n    value === \"preflight\" ||\n    value === \"verify\" ||\n    value === \"fin\" ||\n    value === \"cloud-local\"\n  ) {\n    return value;\n  }\n  throw new Error(\n    `Expected mode to be one of preflight, verify, fin, or cloud-local. Received: ${String(value)}`,\n  );\n}\n\nfunction parseConfigArgs(args: string[]): ConfigFlags {\n  const flags: ConfigFlags = {};\n  for (let index = 0; index < args.length; index += 1) {\n    const arg = args[index];\n    if (arg === \"--env\") {\n      const value = args[++index];\n      if (value === \"local\" || value === \"staging\" || value === \"prod\") {\n        flags.env = value;\n        continue;\n      }\n      throw new Error(`Invalid --env value: ${String(value)}`);\n    }\n    if (arg === \"--token\") {\n      flags.token = args[++index];\n      continue;\n    }\n    if (arg === \"--skip-install\") {\n      continue;\n    }\n    throw new Error(`Unknown verifier argument: ${arg}`);\n  }\n  return flags;\n}\n\nasync function runCloudLocalVerification(\n  projectRoot: string,\n  projectConfig: ProjectConfig,\n  config: ResolvedConfig,\n): Promise<void> {\n  const [\n    { scaffoldStaticWorkspace },\n    { loadManifest },\n    { applyWorkspaceCodegen },\n    { reconcileWorkspaceDependencies },\n    { assertReducerContractPreflight },\n    { getProjectLocalMaintainerRegistry },\n  ] = await Promise.all([\n    import(\"../services/project/static-scaffold.js\"),\n    import(\"../services/project/local-files.js\"),\n    import(\"../services/project/workspace-codegen.js\"),\n    import(\"../services/project/workspace-dependencies.js\"),\n    import(\"../services/project/reducer-contract-preflight.js\"),\n    import(\"../services/project/project-state.js\"),\n  ]);\n\n  consola.start(\"Refreshing static scaffold...\");\n  await scaffoldStaticWorkspace(projectRoot, \"update\", {\n    localMaintainerRegistry: getProjectLocalMaintainerRegistry(projectConfig),\n  });\n\n  consola.start(\"Applying workspace codegen...\");\n  const manifest = await loadManifest(projectRoot);\n  await applyWorkspaceCodegen({ projectRoot, manifest });\n\n  consola.start(\"Reconciling workspace dependencies...\");\n  await reconcileWorkspaceDependencies(projectRoot);\n\n  consola.start(\"Validating reducer contract...\");\n  await assertReducerContractPreflight(projectRoot);\n\n  const [{ runLocalTypecheck }, { assertReducerBundleSmoke }] =\n    await Promise.all([\n      import(\"../services/project/local-typecheck.js\"),\n      import(\"../services/project/reducer-bundle-preflight.js\"),\n    ]);\n\n  consola.start(\"Running local typecheck...\");\n  const typecheckResult = await runLocalTypecheck(projectRoot);\n  if (typecheckResult.skipped) {\n    if (typecheckResult.output) consola.warn(typecheckResult.output);\n  } else if (!typecheckResult.success) {\n    if (typecheckResult.output) consola.error(typecheckResult.output);\n    throw new Error(\n      \"Local typecheck failed. Fix the diagnostics before syncing.\",\n    );\n  }\n\n  consola.start(\"Smoke-testing reducer bundle...\");\n  await assertReducerBundleSmoke({ projectRoot, manifest });\n\n  const {\n    generateReducerNativeArtifacts,\n    isReducerNativeTestingWorkspace,\n    runReducerNativeScenarios,\n  } = await import(\n    \"../services/testing/reducer-native-test-harness.js\"\n  );\n\n  if (await isReducerNativeTestingWorkspace(projectRoot)) {\n    const { bases } = await generateReducerNativeArtifacts({\n      projectRoot,\n      gameId: projectConfig.gameId,\n      compiledResultId: projectConfig.compile?.latestSuccessful?.resultId,\n    });\n    const summary = await runReducerNativeScenarios({\n      projectRoot,\n      projectConfig,\n      resolvedConfig: config,\n      runner: \"reducer\",\n      gameId: projectConfig.gameId,\n      compiledResultId: projectConfig.compile?.latestSuccessful?.resultId,\n    });\n    if (summary.failed > 0) {\n      const failures = summary.results\n        .filter((result) => !result.success)\n        .map((result) =>\n          result.error\n            ? `FAIL ${result.id}: ${result.error}`\n            : `FAIL ${result.id}`,\n        );\n      throw new Error(\n        [\n          `Reducer-native verification failed: ${summary.failed} failed, ${summary.passed} passed.`,\n          ...failures,\n        ].join(\"\\n\"),\n      );\n    }\n    consola.success(`Generated ${bases.length} reducer-native base state(s).`);\n  }\n\n  consola.success(\"Agent workspace cloud-local verification passed.\");\n}\n\nfunction readRequiredOption(args: string[], name: string): string {\n  const index = args.indexOf(name);\n  const value = index >= 0 ? args[index + 1] : undefined;\n  if (!value) {\n    throw new Error(`${name} is required.`);\n  }\n  return value;\n}\n"],"mappings":"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","names":[]}

package/dist/agent-verifier/{chunk-JH22JNYD.mjs → chunk-3UKQVWLV.mjs}

@@ -3,25 +3,25 @@ import {
   getStoredSession,
   loadGlobalConfig,
   setCredentials
-} from "./chunk-HJFQDSTU.mjs";
+} from "./chunk-SH5JKYOB.mjs";
 import {
   IS_PUBLISHED_BUILD,
   PUBLISHED_ENVIRONMENT,
   findProjectRoot,
   loadProjectConfig
-} from "./chunk-4WD3YU2E.mjs";
+} from "./chunk-776W3UGV.mjs";
 import {
   client
-} from "./chunk-2E5P5NWG.mjs";
+} from "./chunk-NAK77WXW.mjs";
 import {
   readJsonFile,
   readTextFileIfExists
-} from "./chunk-LM3OZLZG.mjs";
+} from "./chunk-IAYRNVUC.mjs";
 import {
   DEFAULT_API_BASE_URL,
   DEFAULT_WEB_BASE_URL,
   ENVIRONMENT_CONFIGS
-} from "./chunk-SHUMAVAP.mjs";
+} from "./chunk-H76MT5UR.mjs";
 
 // ../../node_modules/.pnpm/consola@3.4.2/node_modules/consola/dist/core.mjs
 var LogLevels = {
@@ -1105,7 +1105,7 @@ function createConsola2(options = {}) {
     defaults: { level },
     stdout: process.stdout,
     stderr: process.stderr,
-    prompt: (...args) => import("./prompt-3BAINGAQ.mjs").then((m) => m.prompt(...args)),
+    prompt: (...args) => import("./prompt-MJRJMOGQ.mjs").then((m) => m.prompt(...args)),
     reporters: options.reporters || [
       options.fancy ?? !(T || R) ? new FancyReporter() : new BasicReporter()
     ],
@@ -1142,8 +1142,9 @@ function assertConfigured(config) {
     throw new Error(
       [
         "Clerk OAuth CLI is not configured for this environment.",
-        "Set DREAMBOARD_CLERK_OAUTH_ISSUER and DREAMBOARD_CLERK_OAUTH_CLIENT_ID",
-        "or the environment-specific DREAMBOARD_<ENV>_CLERK_OAUTH_* variables.",
+        "The CLI expects first-party environments to be configured in its built-in registry.",
+        "If this environment has no registered public Clerk OAuth client, create one and release a CLI with its client id.",
+        "For emergency overrides, set the environment-specific DREAMBOARD_<ENV>_CLERK_OAUTH_* variables or DREAMBOARD_CLERK_OAUTH_*.",
         "For local harness auth, use `pnpm auth:local` or the auto-bootstrapped local harness flows instead."
       ].join(" ")
     );
@@ -1290,6 +1291,7 @@ function resolveConfig(globalConfig, flags, project, credentials) {
   const resolvedWebBaseUrl = IS_PUBLISHED_BUILD ? publishedEnvConfig?.webBaseUrl ?? DEFAULT_WEB_BASE_URL : hasExplicitEnvironmentOverride ? projectLocalBaseUrl(project?.webBaseUrl, environment) || envConfig?.webBaseUrl || DEFAULT_WEB_BASE_URL : project?.webBaseUrl || envConfig?.webBaseUrl || DEFAULT_WEB_BASE_URL;
   const webBaseUrl = valueOrUndefined(process.env.DREAMBOARD_WEB_BASE_URL) ?? resolvedWebBaseUrl;
   const snapshot = buildCredentialSnapshot(flags, credentials, environment);
+  const oauthConfig = resolveEnvironmentOAuthConfig(environment, envConfig);
   return {
     environment,
     apiBaseUrl,
@@ -1297,14 +1299,31 @@ function resolveConfig(globalConfig, flags, project, credentials) {
     authToken: snapshot.accessToken,
     refreshToken: snapshot.refreshToken,
     tokenExpiresAt: snapshot.tokenExpiresAt,
-    clerkOAuthIssuer: snapshot.clerkOAuthIssuer ?? envConfig?.clerkOAuthIssuer,
-    clerkOAuthClientId: snapshot.clerkOAuthClientId ?? envConfig?.clerkOAuthClientId,
-    clerkOAuthTokenUrl: snapshot.clerkOAuthTokenUrl ?? valueOrUndefined(process.env.DREAMBOARD_CLERK_OAUTH_TOKEN_URL),
-    clerkOAuthScope: envConfig?.clerkOAuthScope,
+    clerkOAuthIssuer: snapshot.clerkOAuthIssuer ?? oauthConfig.issuer,
+    clerkOAuthClientId: snapshot.clerkOAuthClientId ?? oauthConfig.clientId,
+    clerkOAuthTokenUrl: snapshot.clerkOAuthTokenUrl ?? oauthConfig.tokenUrl,
+    clerkOAuthScope: oauthConfig.scope,
     authTokenSource: snapshot.authTokenSource,
     refreshTokenSource: snapshot.refreshTokenSource
   };
 }
+function resolveEnvironmentOAuthConfig(environment, envConfig) {
+  const prefix = environment.toUpperCase();
+  return {
+    issuer: valueOrUndefined(
+      process.env[`DREAMBOARD_${prefix}_CLERK_OAUTH_ISSUER`]
+    ) ?? valueOrUndefined(process.env.DREAMBOARD_CLERK_OAUTH_ISSUER) ?? envConfig?.clerkOAuthIssuer,
+    clientId: valueOrUndefined(
+      process.env[`DREAMBOARD_${prefix}_CLERK_OAUTH_CLIENT_ID`]
+    ) ?? valueOrUndefined(process.env.DREAMBOARD_CLERK_OAUTH_CLIENT_ID) ?? envConfig?.clerkOAuthClientId,
+    tokenUrl: valueOrUndefined(
+      process.env[`DREAMBOARD_${prefix}_CLERK_OAUTH_TOKEN_URL`]
+    ) ?? valueOrUndefined(process.env.DREAMBOARD_CLERK_OAUTH_TOKEN_URL) ?? envConfig?.clerkOAuthTokenUrl,
+    scope: valueOrUndefined(
+      process.env[`DREAMBOARD_${prefix}_CLERK_OAUTH_SCOPE`]
+    ) ?? valueOrUndefined(process.env.DREAMBOARD_CLERK_OAUTH_SCOPE) ?? envConfig?.clerkOAuthScope
+  };
+}
 function buildCredentialSnapshot(flags, storedCredentials, environment) {
   const flagToken = valueOrUndefined(flags.token);
   const agentEnvToken = valueOrUndefined(process.env.DREAMBOARD_AGENT_TOKEN);
@@ -1548,6 +1567,10 @@ async function buildSourceDependencyProfile(options) {
 }
 async function assertCompilerPortableDependencies(options) {
   const packageJson = await readProjectPackageJson(options.projectRoot);
+  const legacyProblems = collectLegacyDreamboardSpecifiers(packageJson);
+  if (legacyProblems.length > 0) {
+    throwLegacyDreamboardPackageError(legacyProblems);
+  }
   const problems = collectUnportableDreamboardSpecifiers(packageJson);
   if (problems.length > 0) {
     const details = problems.map(
@@ -1557,7 +1580,7 @@ async function assertCompilerPortableDependencies(options) {
       [
         "Compiler-bound workspaces must install Dreamboard packages from a registry.",
         `Found unportable Dreamboard dependency specifier(s): ${details}.`,
-        "Run `dreamboard sync` from a workspace that uses registry-pinned @dreamboard/* and dreamboard versions before compiling."
+        "Run `dreamboard sync` from a workspace that uses registry-pinned @dreamboard-games/* and dreamboard versions before compiling."
       ].join(" ")
     );
   }
@@ -1573,6 +1596,11 @@ async function assertCompilerPortableDependencies(options) {
   return profile;
 }
 async function assertReleaseEnvironmentPortableDependencies(options) {
+  const packageJson = await readProjectPackageJson(options.projectRoot);
+  const legacyProblems = collectLegacyDreamboardSpecifiers(packageJson);
+  if (legacyProblems.length > 0) {
+    throwLegacyDreamboardPackageError(legacyProblems);
+  }
   const profile = await buildSourceDependencyProfile(options);
   if (!isReleaseEnvironment(options.environment)) {
     return profile;
@@ -1606,7 +1634,7 @@ function collectDreamboardPackageSpecifiers(packageJson) {
     const dependencies = packageJson[field];
     if (!dependencies) continue;
     for (const [packageName, specifier] of Object.entries(dependencies)) {
-      if (isDreamboardPackage(packageName)) {
+      if (isPortableDreamboardPackage(packageName)) {
         packages[packageName] = specifier;
       }
     }
@@ -1614,7 +1642,7 @@ function collectDreamboardPackageSpecifiers(packageJson) {
   const overrides = packageJson.pnpm?.overrides;
   if (overrides) {
     for (const [packageName, specifier] of Object.entries(overrides)) {
-      if (isDreamboardPackage(packageName) && typeof specifier === "string" && packages[packageName] === void 0) {
+      if (isPortableDreamboardPackage(packageName) && typeof specifier === "string" && packages[packageName] === void 0) {
         packages[packageName] = specifier;
       }
     }
@@ -1627,7 +1655,7 @@ function collectUnportableDreamboardSpecifiers(packageJson) {
     const dependencies = packageJson[field];
     if (!dependencies) continue;
     for (const [packageName, specifier] of Object.entries(dependencies)) {
-      if (isDreamboardPackage(packageName) && UNPORTABLE_SPECIFIER_PATTERN.test(specifier)) {
+      if (isPortableDreamboardPackage(packageName) && UNPORTABLE_SPECIFIER_PATTERN.test(specifier)) {
         problems.push({ location: field, packageName, specifier });
       }
     }
@@ -1635,7 +1663,7 @@ function collectUnportableDreamboardSpecifiers(packageJson) {
   const overrides = packageJson.pnpm?.overrides;
   if (overrides) {
     for (const [packageName, specifier] of Object.entries(overrides)) {
-      if (isDreamboardPackage(packageName) && typeof specifier === "string" && UNPORTABLE_SPECIFIER_PATTERN.test(specifier)) {
+      if (isPortableDreamboardPackage(packageName) && typeof specifier === "string" && UNPORTABLE_SPECIFIER_PATTERN.test(specifier)) {
         problems.push({
           location: "pnpm.overrides",
           packageName,
@@ -1646,8 +1674,42 @@ function collectUnportableDreamboardSpecifiers(packageJson) {
   }
   return problems;
 }
-function isDreamboardPackage(packageName) {
-  return packageName === "dreamboard" || packageName.startsWith("@dreamboard/") || packageName.startsWith("@dreamboard-games/");
+function collectLegacyDreamboardSpecifiers(packageJson) {
+  const problems = [];
+  for (const field of DEPENDENCY_FIELDS) {
+    const dependencies = packageJson[field];
+    if (!dependencies) continue;
+    for (const packageName of Object.keys(dependencies)) {
+      if (isLegacyDreamboardPackage(packageName)) {
+        problems.push({ location: field, packageName });
+      }
+    }
+  }
+  const overrides = packageJson.pnpm?.overrides;
+  if (overrides) {
+    for (const packageName of Object.keys(overrides)) {
+      if (isLegacyDreamboardPackage(packageName)) {
+        problems.push({ location: "pnpm.overrides", packageName });
+      }
+    }
+  }
+  return problems;
+}
+function throwLegacyDreamboardPackageError(problems) {
+  const details = problems.map((problem) => `${problem.location} ${problem.packageName}`).join("; ");
+  throw new Error(
+    [
+      "Legacy @dreamboard/* package dependencies are no longer supported in compiler-bound workspaces.",
+      `Found ${details}.`,
+      "Repin to the public @dreamboard-games/* packages and rerun the command."
+    ].join(" ")
+  );
+}
+function isPortableDreamboardPackage(packageName) {
+  return packageName === "dreamboard" || packageName.startsWith("@dreamboard-games/");
+}
+function isLegacyDreamboardPackage(packageName) {
+  return packageName.startsWith("@dreamboard/");
 }
 function isReleaseEnvironment(environment) {
   return environment === "staging" || environment === "prod";
@@ -1679,3 +1741,4 @@ export {
   assertCompilerPortableDependencies,
   assertReleaseEnvironmentPortableDependencies
 };
+//# sourceMappingURL=chunk-3UKQVWLV.mjs.map