@dreamboard-games/cli 0.1.30-alpha.4 → 0.1.30-alpha.40

package/dist/internal.js

@@ -1,30 +1,55 @@
 #!/usr/bin/env node
 import {
   CONFIG_FLAG_ARGS,
-  applyWorkspaceCodegen,
   configureClient,
-  configurePlaywrightBrowsersPath,
   ensureReducerNativeTestingFiles,
   findCompiledResultsForAuthoringState,
-  loadManifest,
-  loadProjectConfig,
   parseConfigFlags,
   requireAuth,
   resolveConfig,
   resolveProjectContext,
+  shortHash
+} from "./chunk-5IYJOVUA.js";
+import {
+  applyWorkspaceCodegen,
+  loadManifest,
+  loadProjectConfig,
+  materializeWorkspaceProject,
   setLatestCompileAttempt,
-  shortHash,
   updateProjectState,
   writeSnapshot
-} from "./chunk-M4SCKH5M.js";
+} from "./chunk-USZAPMQ4.js";
 import {
-  ENVIRONMENT_CONFIGS,
   getStoredSession,
-  loadGlobalConfig,
+  loadGlobalConfig
+} from "./chunk-6NYVJYN4.js";
+import {
+  ENVIRONMENT_CONFIGS,
   readJsonFile,
   writeJsonFile
-} from "./chunk-3NRROR4P.js";
+} from "./chunk-EQNBQVIW.js";
 import "./chunk-2H7UOFLK.js";
+
+// 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;
+}
 export {
   CONFIG_FLAG_ARGS,
   ENVIRONMENT_CONFIGS,
@@ -37,6 +62,7 @@ export {
   loadGlobalConfig,
   loadManifest,
   loadProjectConfig,
+  materializeWorkspaceProject,
   parseConfigFlags,
   readJsonFile,
   requireAuth,

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../src/ui/playwright-runner.ts"],"sourcesContent":["import os from \"node:os\";\nimport path from \"node:path\";\nimport type { ResolvedConfig } from \"../types.js\";\nimport { createUserSessionManager } from \"../auth/user-session-manager.js\";\nimport { resolveLocalHarnessAccessToken } from \"../config/local-harness-auth.js\";\n\n/**\n * Browser test runner helpers shared with reducer-native-test-harness (browser runner).\n * Screenshot / JSON scenario navigation helpers lived in the deleted `run` command.\n */\nexport function configurePlaywrightBrowsersPath(): void {\n  if (process.env.PLAYWRIGHT_BROWSERS_PATH) {\n    return;\n  }\n\n  const runtimeHome = process.env.HOME;\n  let realHome: string;\n  try {\n    realHome = os.userInfo().homedir;\n  } catch {\n    return;\n  }\n\n  if (!runtimeHome || path.resolve(runtimeHome) === path.resolve(realHome)) {\n    return;\n  }\n\n  const browserCachePath =\n    process.platform === \"darwin\"\n      ? path.join(realHome, \"Library\", \"Caches\", \"ms-playwright\")\n      : process.platform === \"win32\"\n        ? path.join(realHome, \"AppData\", \"Local\", \"ms-playwright\")\n        : path.join(realHome, \".cache\", \"ms-playwright\");\n\n  process.env.PLAYWRIGHT_BROWSERS_PATH = browserCachePath;\n}\n\nexport async function buildBrowserAuthInitScript(\n  config: ResolvedConfig,\n): Promise<string | null> {\n  const resolvedToken =\n    resolveLocalHarnessAccessToken(config) ??\n    (await createUserSessionManager(config).resolveApiToken())?.token;\n  if (!resolvedToken) return null;\n\n  return `(function(){localStorage.setItem('dreamboard_auth_token',${JSON.stringify(resolvedToken)});})();`;\n}\n\nexport async function waitForGameReady(\n  page: import(\"playwright\").Page,\n  timeoutMs = 60000,\n): Promise<void> {\n  await page.waitForSelector('iframe[title=\"Game UI Plugin\"]', {\n    timeout: timeoutMs,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AASV,SAAS,kCAAwC;AACtD,MAAI,QAAQ,IAAI,0BAA0B;AACxC;AAAA,EACF;AAEA,QAAM,cAAc,QAAQ,IAAI;AAChC,MAAI;AACJ,MAAI;AACF,eAAW,GAAG,SAAS,EAAE;AAAA,EAC3B,QAAQ;AACN;AAAA,EACF;AAEA,MAAI,CAAC,eAAe,KAAK,QAAQ,WAAW,MAAM,KAAK,QAAQ,QAAQ,GAAG;AACxE;AAAA,EACF;AAEA,QAAM,mBACJ,QAAQ,aAAa,WACjB,KAAK,KAAK,UAAU,WAAW,UAAU,eAAe,IACxD,QAAQ,aAAa,UACnB,KAAK,KAAK,UAAU,WAAW,SAAS,eAAe,IACvD,KAAK,KAAK,UAAU,UAAU,eAAe;AAErD,UAAQ,IAAI,2BAA2B;AACzC;","names":[]}

package/dist/{keychain-backend-JHTXAKWC.js → keychain-backend-FSNTNTZE.js}

@@ -29,11 +29,14 @@ function parsePayload(raw) {
   if (trimmed.length === 0) return null;
   try {
     const parsed = JSON.parse(trimmed);
-    if (!parsed.accessToken && !parsed.refreshToken) return null;
+    const accessToken = parsed.clerkAccessToken ?? parsed.accessToken;
+    if (!accessToken && !parsed.refreshToken) return null;
     return {
-      accessToken: parsed.accessToken || void 0,
+      accessToken: accessToken || void 0,
       refreshToken: parsed.refreshToken || void 0,
-      tokenExpiresAt: parsed.tokenExpiresAt || void 0,
+      tokenExpiresAt: parsed.clerkAccessExpiresAt || parsed.tokenExpiresAt || void 0,
+      dreamboardApiToken: parsed.dreamboardApiToken || void 0,
+      dreamboardApiExpiresAt: parsed.dreamboardApiExpiresAt || void 0,
       clerkOAuthIssuer: parsed.clerkOAuthIssuer || void 0,
       clerkOAuthClientId: parsed.clerkOAuthClientId || void 0,
       clerkOAuthTokenUrl: parsed.clerkOAuthTokenUrl || void 0,
@@ -50,9 +53,11 @@ function writeFull(entry, creds) {
     );
   }
   const payload = {
-    accessToken: creds.accessToken,
+    clerkAccessToken: creds.accessToken,
     refreshToken: creds.refreshToken,
-    tokenExpiresAt: creds.tokenExpiresAt,
+    clerkAccessExpiresAt: creds.tokenExpiresAt,
+    dreamboardApiToken: creds.dreamboardApiToken,
+    dreamboardApiExpiresAt: creds.dreamboardApiExpiresAt,
     clerkOAuthIssuer: creds.clerkOAuthIssuer,
     clerkOAuthClientId: creds.clerkOAuthClientId,
     clerkOAuthTokenUrl: creds.clerkOAuthTokenUrl,
@@ -132,4 +137,4 @@ export {
   _setKeyringModuleForTests,
   tryKeychainBackend
 };
-//# sourceMappingURL=keychain-backend-JHTXAKWC.js.map
+//# sourceMappingURL=keychain-backend-FSNTNTZE.js.map

package/dist/keychain-backend-FSNTNTZE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/keychain-backend.ts"],"sourcesContent":["/**\n * OS keychain-backed `CredentialBackend` built on top of `@napi-rs/keyring`.\n *\n * Keychain is an optional storage backend. Users can opt in with\n * `credentialBackend: \"keychain\"` in `~/.dreamboard/config.json`\n * (see `credential-store.ts` for the resolver).\n * When enabled, it gives us:\n * - A refresh token encrypted at rest by the OS (Keychain on macOS,\n *   Credential Vault on Windows, Secret Service on Linux).\n * - Protection against other processes running as the same user tailing\n *   `~/.dreamboard/auth.json` to scrape the token.\n *\n * This module is loaded optionally: `@napi-rs/keyring` is declared as an\n * `optionalDependencies` entry. If the native binary or OS keyring is\n * unavailable, the resolver falls back to the file backend.\n *\n * One-time migration: when the active backend is keychain and `auth.json` still\n * has tokens, `credential-store.ts` copies them into the keychain, verifies the\n * keychain read, and deletes the file. This is the only path that intentionally\n * mutates both backends.\n */\n\nimport type {\n  CredentialBackend,\n  Credentials,\n  StoredSessionSnapshot,\n} from \"./credential-store.js\";\n\n/** Keychain service id. Shared across all Dreamboard CLI builds. */\nconst KEYCHAIN_SERVICE = \"dreamboard-cli\";\n/**\n * Keychain account id. The `user@host` shape is conventional but we keep\n * it fixed for now because the CLI only cares about \"the session for this\n * OS user\", not per-process sessions.\n */\nconst KEYCHAIN_ACCOUNT = \"session\";\n\ntype EntryInstance = {\n  setPassword(value: string): void;\n  getPassword(): string | null | undefined;\n  deletePassword(): boolean;\n};\n\ntype KeyringModule = {\n  Entry: new (service: string, account: string) => EntryInstance;\n};\n\nlet cachedModule: KeyringModule | null | undefined;\n\nasync function loadKeyringModule(): Promise<KeyringModule | null> {\n  if (cachedModule !== undefined) return cachedModule;\n  try {\n    // `@napi-rs/keyring` is an optional dependency. If the native binary is\n    // missing on this platform the dynamic import throws; resolver policy in\n    // credential-store decides whether that is fatal.\n    const mod = (await import(\"@napi-rs/keyring\")) as unknown as KeyringModule;\n    cachedModule = mod;\n  } catch {\n    cachedModule = null;\n  }\n  return cachedModule;\n}\n\nfunction keychainProbe(entry: EntryInstance): boolean {\n  // Some platforms have the module installed but no accessible keyring\n  // (e.g. headless Linux without DBus). Touch getPassword to verify we\n  // can talk to the service without side effects.\n  try {\n    entry.getPassword();\n    return true;\n  } catch {\n    return false;\n  }\n}\n\ntype KeychainPayload = {\n  clerkAccessToken?: string;\n  accessToken?: string;\n  refreshToken?: string;\n  clerkAccessExpiresAt?: string;\n  tokenExpiresAt?: string;\n  dreamboardApiToken?: string;\n  dreamboardApiExpiresAt?: string;\n  clerkOAuthIssuer?: string;\n  clerkOAuthClientId?: string;\n  clerkOAuthTokenUrl?: string;\n  environment?: string;\n};\n\nfunction parsePayload(\n  raw: string | null | undefined,\n): StoredSessionSnapshot | null {\n  if (raw === null || raw === undefined) return null;\n  const trimmed = raw.trim();\n  if (trimmed.length === 0) return null;\n  try {\n    const parsed = JSON.parse(trimmed) as KeychainPayload;\n    const accessToken = parsed.clerkAccessToken ?? parsed.accessToken;\n    if (!accessToken && !parsed.refreshToken) return null;\n    return {\n      accessToken: accessToken || undefined,\n      refreshToken: parsed.refreshToken || undefined,\n      tokenExpiresAt:\n        parsed.clerkAccessExpiresAt || parsed.tokenExpiresAt || undefined,\n      dreamboardApiToken: parsed.dreamboardApiToken || undefined,\n      dreamboardApiExpiresAt: parsed.dreamboardApiExpiresAt || undefined,\n      clerkOAuthIssuer: parsed.clerkOAuthIssuer || undefined,\n      clerkOAuthClientId: parsed.clerkOAuthClientId || undefined,\n      clerkOAuthTokenUrl: parsed.clerkOAuthTokenUrl || undefined,\n      environment: parsed.environment || undefined,\n    };\n  } catch {\n    return null;\n  }\n}\n\nfunction writeFull(entry: EntryInstance, creds: Credentials): void {\n  if (!creds.accessToken || !creds.refreshToken) {\n    throw new Error(\n      \"Refusing to persist credentials with an empty accessToken or refreshToken.\",\n    );\n  }\n  const payload: KeychainPayload = {\n    clerkAccessToken: creds.accessToken,\n    refreshToken: creds.refreshToken,\n    clerkAccessExpiresAt: creds.tokenExpiresAt,\n    dreamboardApiToken: creds.dreamboardApiToken,\n    dreamboardApiExpiresAt: creds.dreamboardApiExpiresAt,\n    clerkOAuthIssuer: creds.clerkOAuthIssuer,\n    clerkOAuthClientId: creds.clerkOAuthClientId,\n    clerkOAuthTokenUrl: creds.clerkOAuthTokenUrl,\n    environment: creds.environment,\n  };\n  entry.setPassword(JSON.stringify(payload));\n}\n\nfunction writeAccessOnly(entry: EntryInstance, accessToken: string): void {\n  if (!accessToken) {\n    throw new Error(\"Refusing to persist an empty access token.\");\n  }\n  const payload: KeychainPayload = { accessToken };\n  entry.setPassword(JSON.stringify(payload));\n}\n\nfunction clear(entry: EntryInstance): void {\n  try {\n    entry.deletePassword();\n  } catch {\n    // keyring-rs throws when the entry does not exist. That is fine -\n    // Session clearing is idempotent.\n  }\n}\n\nexport type KeychainAvailability =\n  | { available: true; backend: CredentialBackend }\n  | { available: false; reason: string };\n\n/**\n * Attempt to construct a keychain-backed `CredentialBackend`. Returns an\n * `available: false` result (with a reason) if the native module, the\n * OS keyring, or the probe fails.\n */\nexport async function tryKeychainBackend(): Promise<KeychainAvailability> {\n  const mod = await loadKeyringModule();\n  if (!mod) {\n    return {\n      available: false,\n      reason: \"@napi-rs/keyring is not installed for this platform\",\n    };\n  }\n\n  let entry: EntryInstance;\n  try {\n    entry = new mod.Entry(KEYCHAIN_SERVICE, KEYCHAIN_ACCOUNT);\n  } catch (err) {\n    return {\n      available: false,\n      reason: `Failed to construct keyring entry: ${String((err as Error).message ?? err)}`,\n    };\n  }\n\n  if (!keychainProbe(entry)) {\n    return {\n      available: false,\n      reason: \"OS keyring is not accessible from this process\",\n    };\n  }\n\n  const backend: CredentialBackend = {\n    name: \"keychain\",\n    async read() {\n      try {\n        return parsePayload(entry.getPassword());\n      } catch (err) {\n        const message = String((err as Error).message ?? err);\n        // Transient keychain access errors (e.g. Touch ID prompt\n        // cancelled) should not surface as \"session wiped\". Treat the\n        // unreadable state as \"no session\" so the caller can fall back\n        // to prompting for login.\n        if (/no matching entry|not found/i.test(message)) {\n          return null;\n        }\n        throw err;\n      }\n    },\n    async writeFull(creds) {\n      writeFull(entry, creds);\n    },\n    async writeAccessOnly(accessToken) {\n      writeAccessOnly(entry, accessToken);\n    },\n    async clear() {\n      clear(entry);\n    },\n  };\n  return { available: true, backend };\n}\n\n/**\n * Test-only escape hatch so unit tests can install a fake keyring module\n * without going through the dynamic import cache.\n */\nexport function _setKeyringModuleForTests(mod: KeyringModule | null): void {\n  cachedModule = mod;\n}\n\nexport function _resetKeyringModuleForTests(): void {\n  cachedModule = undefined;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreamboard-games/cli",
-  "version": "0.1.30-alpha.4",
+  "version": "0.1.30-alpha.40",
   "description": "Design board games with AI and turn ideas into playable digital prototypes.",
   "type": "module",
   "bin": {
@@ -8,6 +8,10 @@
   },
   "exports": {
     ".": "./dist/index.js",
+    "./authoring-compatibility-internal": {
+      "types": "./dist/authoring-compatibility-internal.d.ts",
+      "default": "./dist/authoring-compatibility-internal.js"
+    },
     "./internal": {
       "types": "./dist/internal.d.ts",
       "default": "./dist/internal.js"
@@ -18,6 +22,8 @@
   "files": [
     "dist",
     "README.md",
+    "release",
+    "scaffold",
     "skills"
   ],
   "keywords": [
@@ -34,29 +40,13 @@
     "access": "public"
   },
   "dependencies": {
-    "@dreamboard-games/api-client": "0.3.0-alpha.3",
+    "@dreamboard-games/api-client": "0.3.0-alpha.4",
     "@dreamboard-games/gameplay-authority-client": "0.1.0-alpha.1",
-    "@dreamboard-games/sdk": "0.4.0-alpha.0",
-    "@dreamboard-games/ui-host-runtime": "0.1.0-alpha.2",
-    "@tailwindcss/postcss": "^4.3.0",
-    "@vitejs/plugin-react": "^4.7.0",
     "citty": "^0.2.2",
-    "clsx": "^2.1.1",
     "consola": "^3.4.2",
     "esbuild": "^0.25.12",
-    "lucide-react": "^1.17.0",
     "picocolors": "^1.1.1",
-    "postcss": "^8.5.15",
-    "react": "^19.2.7",
-    "react-dom": "^19.2.7",
-    "sonner": "^2.0.7",
-    "tailwind-merge": "^3.6.0",
-    "tailwindcss": "^4.3.0",
-    "tw-animate-css": "^1.4.0",
-    "vaul": "^1.1.2",
-    "vite": "^5.4.21",
-    "zod": "4.4.3",
-    "zustand": "^5.0.14"
+    "zod": "4.4.3"
   },
   "optionalDependencies": {
     "@napi-rs/keyring": "^1.3.0"

package/release/authoring-release-set.json

@@ -0,0 +1,38 @@
+{
+  "schemaVersion": 1,
+  "channel": "public",
+  "packages": {
+    "cli": {
+      "name": "@dreamboard-games/cli",
+      "version": "0.1.30-alpha.40"
+    },
+    "sdk": {
+      "name": "@dreamboard-games/sdk",
+      "version": "0.4.0-alpha.6"
+    },
+    "apiClient": {
+      "name": "@dreamboard-games/api-client",
+      "version": "0.3.0-alpha.4"
+    },
+    "devHost": {
+      "name": "@dreamboard-games/dev-host",
+      "version": "0.1.30-alpha.27"
+    }
+  },
+  "protocols": {
+    "authoringAdapter": 1,
+    "devHost": 1,
+    "verifier": 1
+  },
+  "schemas": {
+    "scaffold": 2,
+    "manifest": 2,
+    "generatedArtifacts": 1
+  },
+  "registry": {
+    "kind": "public-npm",
+    "portable": true
+  },
+  "packageManager": "pnpm@10.4.1",
+  "releaseSetId": "sha256:b1ba68e0bd81fbf6c44d39665e716f5fba81342036f04f1d102b12da77c73f1c"
+}

package/skills/dreamboard/SKILL.md

@@ -6,18 +6,18 @@ metadata:
   tags: [dreamboard, cli, game-dev, board-game, turn-based, multiplayer]
 ---
 
-# Dreamboard CLI
+# Dreamboard
 
 ## Goal
 
-Create and iterate on a Dreamboard game locally, then sync authored changes,
-compile, run, and test against the current reducer-native scaffold.
+Create and iterate on a Dreamboard game locally with the Git-native Dreamboard
+command, then verify exact commits, run tests, and use the local dev host.
 
 ## Prereqs
 
-- Dreamboard CLI installed and available as `dreamboard`
+- Dreamboard installed and available as `dreamboard`
   Install with `npm install -g dreamboard`
-- Authenticated via `dreamboard login`
+- Authenticated via `dreamboard auth login`
 
 ## Buliding Your First Game
 See [tutorials/building-your-first-game.md](references/building-your-first-game.md)
@@ -60,18 +60,25 @@ The current scaffold centers on these files:
 
 Use the commands for different kinds of state:
 
-- `dreamboard sync`
-  Upload local authored changes and advance the remote authored head. Run this after editing `rule.md`, `manifest.json`, or authored source files that should be part of the next remote build.
-- `dreamboard compile`
-  Compile the current remote authored head. Run this after `sync`, or re-run it after a failed compile when you have not made new authored edits.
-- `dreamboard pull`
-  Reconcile remote authored changes into the current workspace. Run this when someone else advanced the remote authored head or `dreamboard status` shows authored state `behind` or `diverged`.
+- `dreamboard project create <slug> --description <text>`
+  Create a project workspace and configure its Git remote.
+- `dreamboard project clone <project>`
+  Clone an existing project repository.
+- `dreamboard project status --commit <rev> [--wait]`
+  Read server state for one exact commit.
+- `dreamboard verify --commit <rev>`
+  Verify one exact commit from a detached worktree.
+- `dreamboard test`
+  Regenerate derived test artifacts as needed and run offline reducer tests.
+- `dreamboard dev [--from-scenario <id>]`
+  Start the local dev host for browser validation.
 
 Quick rule:
 
-- edited files locally: `dreamboard sync` then `dreamboard compile`
-- compile failed but you have not edited files since: `dreamboard compile` again
-- remote authored head moved: `dreamboard pull` first
+- edited files locally: commit them with Git and push the branch
+- need server readback: `dreamboard project status --commit <rev> --wait`
+- need exact local proof: `dreamboard verify --commit <rev>`
+- need scenario proof: `dreamboard test`
 
 ## Workflow
 
@@ -79,23 +86,22 @@ Use this order by default:
 
 1. Write or revise `rule.md`.
 2. Align `manifest.json` to the rules.
-3. Run `dreamboard sync`.
-4. Implement reducer state, phases, actions, and views in `app/`.
-5. Implement the playable UI in `ui/App.tsx`.
-6. Run `dreamboard compile`.
-7. Generate test artifacts with `dreamboard test generate`.
-8. Run scenarios with `dreamboard test run`.
-9. Validate the local runtime with `dreamboard run`.
+3. Implement reducer state, phases, actions, and views in `app/`.
+4. Implement the playable UI in `ui/App.tsx`.
+5. Commit and push authored changes with Git.
+6. Run `dreamboard project status --commit HEAD --wait`.
+7. Run `dreamboard verify --commit HEAD`.
+8. Run scenarios with `dreamboard test`.
+9. Validate the local runtime with `dreamboard dev`.
 10. For agent-built games, run `dreamboard dev` and verify the browser UI before handoff. Use Playwright to open the dev host, check that the plugin iframe renders without console errors, and click a primary interaction such as selecting a playable hand card. Reducer scenarios alone are not enough when the game has an interactive UI.
 
 ## Guardrails
 
 - `manifest.json` and `rule.md` are the source of truth for scaffolding.
-- Run `dreamboard sync` after authored changes to keep generated files and the remote authored head in sync.
-- `dreamboard pull` reconciles authored divergence into the current workspace.
-- `dreamboard compile` is separate from authored sync; failed compiles do not mean the workspace needs a pull or another sync unless you changed authored files again.
-- Use `dreamboard status` to distinguish authored sync from compile health before deciding whether the next command should be `sync`, `compile`, or `pull`.
-- Re-run `dreamboard test generate` after runtime-shape changes in `manifest.json` or `app/`.
+- Use Git for source-control state transitions; Dreamboard does not stage,
+  commit, pull, merge, branch, or push for you.
+- Use `dreamboard project status --commit <rev>` for server state, not local Git status.
+- Run `dreamboard test` after runtime-shape changes in `manifest.json` or `app/`; it regenerates derived test artifacts automatically.
 - Keep reducer-owned UI data in views; do not reintroduce the old `shared/ui-args.ts` pattern in new scaffolds.
 - When a game exposes clickable hands, markets, boards, or prompts, prove the same interaction works through `dreamboard dev` in a browser. A direct scenario submission can pass even when the rendered surface does not collect the input.
 - For interactive card hands, render generated surfaces such as `handSurface.Hand` and `handSurface.Card` consistently. Do not swap a surface card for a raw `Card` or custom tile based on `me.canAct`; the surface primitive is responsible for disabling unavailable interactions.
@@ -124,7 +130,3 @@ Do not edit generated or framework-owned files such as:
 
 ## Offical Documentation
 Visit https://dreamboard.games/docs
-
-## Framework Feedback
-
-Use `feedback.md` in the game project root to record framework issues, missing features, or workflow friction. Include reproduction steps, expected behavior, and actual behavior when possible.

package/skills/dreamboard/references/building-your-first-game.md

@@ -33,13 +33,13 @@ By the end of the tutorial you will have:
 
 ## Prerequisites
 
-- Dreamboard CLI installed: `npm install -g dreamboard`
-- authenticated with `dreamboard login`
+- Dreamboard installed: `npm install -g dreamboard`
+- authenticated with `dreamboard auth login`
 
 ## 1. Create the workspace
 
 ```bash
-dreamboard new race-to-ten --description "A tiny scoring game with one shared die"
+dreamboard project create race-to-ten --description "A tiny scoring game with one shared die"
 cd race-to-ten
 ```
 
@@ -138,16 +138,17 @@ This game needs player-count metadata and one shared die.
 }
 ```
 
-Run:
+Commit and push the authored source with Git, then wait for the server to
+observe and verify the exact commit:
 
 ```bash
-dreamboard sync
-dreamboard compile
+git add .
+git commit -m "Build Race to Ten"
+git push -u origin main
+dreamboard project status --commit HEAD --wait
+dreamboard verify --commit HEAD
 ```
 
-`dreamboard sync` refreshes generated contracts from authored files.
-`dreamboard compile` builds the current authored head.
-
 ## 4. Define the reducer contract
 
 Open `app/game-contract.ts` and replace the empty schemas with the state the
@@ -471,23 +472,22 @@ export default defineScenario({
 });
 ```
 
-Generate artifacts and run the test suite:
+Run the test suite:
 
 ```bash
-dreamboard test generate
-dreamboard test run
+dreamboard test
 ```
 
 ## 10. Run the game locally
 
-Use the local runtime to verify the same flow manually:
+Use the local dev host to verify the same flow manually:
 
 ```bash
-dreamboard run
+dreamboard dev
 ```
 
-If you edit `rule.md` or `manifest.json`, run `dreamboard sync` again before
-continuing.
+If you edit `rule.md` or `manifest.json`, commit and push the changes before
+running commit-scoped build, preview, release, or remote test commands.
 
 ## Where to go next
 

package/skills/dreamboard/references/cli.md

@@ -1,25 +1,25 @@
 <!-- Generated by apps/dreamboard-cli/scripts/sync-skill-docs.ts. -->
 <!-- Source: docs/reference/cli.mdx -->
 
-# CLI
+# Dreamboard command reference
 
-Reference for Dreamboard CLI workflows and commands.
+Reference for Dreamboard workflows and commands.
 
-Dreamboard CLI manages the authored workspace loop: authenticate, create or
-clone a game, sync authored changes, compile, run, and test.
+Dreamboard manages the Git-native authored workspace loop: authenticate,
+create or clone a project, verify exact commits, build or preview pushed
+commits, run a local dev host, and test reducer scenarios.
 
 ## Responsibility
 
-Use the CLI for:
+Use Dreamboard for:
 
 - authenticating the current machine
-- creating or cloning game workspaces
-- syncing authored files to the remote authoring head
-- compiling the current authored head
-- inspecting local versus remote state
-- pulling remote authored changes into the workspace
-- starting or observing playable sessions
-- generating and running reducer-native tests
+- creating or cloning project workspaces
+- inspecting server state for an exact commit
+- verifying an exact commit from a detached worktree
+- building, previewing, and publishing pushed commits
+- starting the local dev host
+- running offline reducer tests
 
 ## Install targets
 
@@ -27,76 +27,76 @@ Use the published package for normal game work:
 
 ```bash
 npm install -g dreamboard
-dreamboard login
+dreamboard auth login
 ```
 
 ## Command flow
 
 Use this sequence for the normal authored loop:
 
-1. `dreamboard login`
-2. `dreamboard new ...` or `dreamboard clone ...`
+1. `dreamboard auth login`
+2. `dreamboard project create ...` or `dreamboard project clone ...`
 3. edit `rule.md`, `manifest.json`, and authored source files
-4. `dreamboard sync`
-5. `dreamboard compile`
-6. `dreamboard run` or `dreamboard start`
-7. `dreamboard test generate`
-8. `dreamboard test run`
-
-When the remote authored head moves first, run `dreamboard pull` before the
-next sync or compile. Use `dreamboard status` to decide whether the workspace is
-ahead, behind, or diverged.
+4. commit with Git and push to the configured remote
+5. `dreamboard project status --commit <rev> --wait`
+6. `dreamboard verify --commit <rev>`
+7. `dreamboard test`
+8. `dreamboard build --commit <rev>`
+9. `dreamboard preview --commit <rev>`
 
 ## Workspace commands
 
-| Command | Use it for |
-| --- | --- |
-| `dreamboard login` | Open browser login and store a refreshable session |
-| `dreamboard new <slug> --description "..."` | Create a new game and scaffold a local workspace |
-| `dreamboard clone <slug>` | Clone an existing game into a new local workspace |
-| `dreamboard sync` | Upload authored changes and refresh scaffolded files |
-| `dreamboard compile` | Compile the current remote authored head |
-| `dreamboard status` | Compare local authored and compile state with remote |
-| `dreamboard pull` | Reconcile remote authored changes into the workspace |
+| Command                                                | Use it for                                                      |
+| ------------------------------------------------------ | --------------------------------------------------------------- |
+| `dreamboard auth login`                                | Open browser login and store a refreshable session              |
+| `dreamboard auth status`                               | Show the current authenticated session                          |
+| `dreamboard project create <slug> --description "..."` | Create a project, scaffold a local workspace, and configure Git |
+| `dreamboard project clone <project>`                   | Clone an existing project repository                            |
+| `dreamboard project status --commit <rev>`             | Show server state for one exact commit                          |
+| `dreamboard verify --commit <rev>`                     | Verify one exact commit in a detached worktree                  |
 
 ```bash
-dreamboard new race-to-ten --description "A tiny scoring game"
-dreamboard sync
-dreamboard compile
-dreamboard status --json
+dreamboard auth login
+dreamboard project create race-to-ten --description "A tiny scoring game"
+git add .
+git commit -m "Create Race to Ten"
+git push -u origin main
+dreamboard project status --commit HEAD --wait
+dreamboard verify --commit HEAD
 ```
 
-## Session commands
+## Commit commands
 
-Use session commands after you have a successful compile for the current
-authored head.
+Use commit commands after the commit has been pushed to the configured Git
+remote.
 
-| Command | Use it for |
-| --- | --- |
-| `dreamboard run` | Start or resume a playable session and observe it from the CLI |
-| `dreamboard start` | Start a fresh session and open it in the browser |
+| Command                                           | Use it for                                |
+| ------------------------------------------------- | ----------------------------------------- |
+| `dreamboard test`                                 | Run offline reducer tests                 |
+| `dreamboard dev [--from-scenario <id>]`           | Start the local project dev host          |
+| `dreamboard build --commit <rev>`                 | Create a server build for a pushed commit |
+| `dreamboard preview --commit <rev>`               | Create a preview for a pushed commit      |
+| `dreamboard release publish --commit <rev> --yes` | Publish an explicit release               |
+| `dreamboard release current`                      | Show the current release pointer          |
 
 ```bash
-dreamboard run
-dreamboard run --players 4 --seed 1337
-dreamboard run --scenario path/to/scenario.json
-dreamboard start --players 2
+dreamboard test
+dreamboard dev
+dreamboard build --commit HEAD
+dreamboard preview --commit HEAD
 ```
 
-`dreamboard run` reuses the previous active session by default. Use
-`--new-session` when you want a fresh session instead.
-
 ## Test commands
 
 Use the scaffolded reducer-native test workspace for repeatable game assertions.
 
 ```bash
-dreamboard test generate
-dreamboard test run
-dreamboard test run --scenario test/scenarios/player-two-wins.scenario.ts
+dreamboard test
+dreamboard test --scenario test/scenarios/player-two-wins.scenario.ts
 ```
 
 ## Start local server
+
 ```bash
 dreamboard dev
 ```

package/skills/dreamboard/references/manifest-authoring.md

@@ -121,14 +121,15 @@ Use `home` on cards, piece seeds, and die seeds to place authored inventory.
 
 ## `cardSets`
 
-`cardSets` define the cards that exist. They do not place cards into zones by themselves.
+`cardSets` define the cards that exist. `defaultHome` or per-card `home` places
+authored inventory into zones.
 
 ### `CardSetDefinition`
 
 | Variant | Required fields | Notes |
 | --- | --- | --- |
-| `type: "manual"` | `id`, `name`, `cardSchema`, `cards` | Define your own cards |
-| `type: "preset"` | `id`, `name` | Use a built-in set |
+| `type: "manual"` | `id`, `name`, `cardSchema`, `cards`, `defaultHome` | Define your own cards |
+| `type: "preset"` | `id`, `name`, `defaultHome` | Use a built-in set |
 
 Current supported preset ID: `standard_52_deck`.
 
@@ -153,6 +154,10 @@ Current supported preset ID: `standard_52_deck`.
       "type": "manual",
       "id": "project-cards",
       "name": "Project cards",
+      "defaultHome": {
+        "type": "zone",
+        "zoneId": "project-deck"
+      },
       "cardSchema": {
         "properties": {
           "cost": { "type": "integer" },
@@ -181,6 +186,9 @@ Current supported preset ID: `standard_52_deck`.
 ## `zones`
 
 Use `zones` for shared piles, per-player hands, pools, bags, and other table-level containers.
+`allowedCardSetIds` controls destination compatibility. `defaultHome` and
+per-card `home` control initial placement. Use reducer setup for dynamic
+distribution and shuffle.
 
 | Field | Required | Notes |
 | --- | --- | --- |