@homie-rocks/studio 0.18.0 → 0.18.2

package/README.md

@@ -110,8 +110,8 @@ are watched only by those they let in (NETPLAY.md section 16, site/SITE.md).
 A studio pins one version, so nothing changes until it asks. To take a newer one:
 
 ```sh
-npx -y @homie-rocks/studio@0.17.0 upgrade          # the plan; changes nothing
-npx -y @homie-rocks/studio@0.17.0 upgrade --apply  # after the person agrees
+npx -y @homie-rocks/studio@0.18.2 upgrade          # the plan; changes nothing
+npx -y @homie-rocks/studio@0.18.2 upgrade --apply  # after the person agrees
 npm install && npm run build
 ```
 
@@ -278,7 +278,7 @@ npx homie-studio agents pass night-rush --label Claude
 ## Setup status
 
 ```sh
-npx -y @homie-rocks/studio@0.17.0 setup status --connector yes   # before a studio exists
+npx -y @homie-rocks/studio@0.18.2 setup status --connector yes   # before a studio exists
 npx homie-studio setup status                                    # in a studio (also: homie-studio doctor)
 ```
 
@@ -288,9 +288,16 @@ with the studio's own Wrangler, and the account's email verified: a deploy that
 deploy refused for it is remembered), Chrome for the checks, ffmpeg, and the optional GitHub, ElevenLabs and
 fal (and, in Claude Code, the status line). Each row is green, missing or "do this now", says what it
 unlocks, and gives the exact fix: a command the AI runs or a page the person taps. It only reads, answers in
-seconds, and never prints a key, a token or an account's name. A studio the Claude app's setup card made
+seconds, and never prints a key, a token or an account's name or id. A studio the Claude app's setup card made
 (`setup attach`) counts as connected to Cloudflare and GitHub there. `--json` gives the rows.
 
+When a server's AI guides think with Workers AI (0.18.1), a **Workers AI** row checks that the model they use
+(`HOMIE_BRAIN_MODEL` in wrangler.jsonc `vars`, else `@cf/meta/llama-3.1-8b-instruct-fp8-fast`) answers on the
+studio's account: one tiny call through Cloudflare's API with the studio's own Wrangler login (a one-word prompt,
+one token out: about 0.1 of the 10,000 free neurons a day; `lib/brain-probe.mjs`). A model Cloudflare moved to
+Workers Paid (error 5035) or retired (5007) is named, with what to do: pick another model, or, the person's money,
+Workers Paid. A spent daily allowance (3036) is said as that, not as a broken model.
+
 ## The Game Codex
 
 `games/<id>/CODEX.md` is a game's plan: Markdown with a small frontmatter for its look (palette, fonts, a
@@ -459,7 +466,7 @@ npx homie-studio port check my-game --url http://127.0.0.1:8787   # the owner te
 | `template/` (repository root), `scripts/template.mjs` | The public "Deploy to Cloudflare" template, generated from `new --template`. |
 | `lib/port.mjs` | `port plan` (reads a game and grades the port) and `port import`. |
 | `lib/port-check.mjs` | `port check`: held and alternating directions on keys, Android Chrome and iPhone WebKit touch, UI cover, two browsers finishing a round, a killed host, a late joiner, the big screen. |
-| `port/` | The port toolkit (`@homie-rocks/studio/port`, or `window.HomiePort` from `homie-port.js` in a static game): `createRoom`, the touch kit, keys, camera rules, bots, a HUD, sandbox shims, first-touch audio, `exposePort`. |
+| `port/` | The port toolkit (`@homie-rocks/studio/port`, or `window.HomiePort` from `homie-port.js` in a static game): `createRoom`, the touch kit, keys, camera rules, bots, a HUD, sandbox shims, first-touch audio, `exposePort`; `fitView` and `createLabels` (`port/view.ts`): a flat world on every screen (the whole of it where it reads, else filling a phone held upright and following the player) and names that never pile up when bodies crowd (yours placed first, the rest moved or faded). |
 | `worker/index.mjs` | The site Worker and the `Table` (netplay relay, `room.mjs`) and `Lobby` Durable Objects; `/<game>/tv` is the big screen with a join QR (`qr.mjs`); `/<game>/watch` watches a live room from any player's view (NETPLAY.md section 16); `/music/<slug>/` and `/videos/<slug>/` are song and video pages (their files served with byte ranges, from the site's files or, once moved, from the studio's R2 at the same address; a loose file from `media put` at `/media/<key>`). `seats.mjs`: room sizes (up to 32). |
 | `worker/site.mjs`, `lib/site.mjs`, `lib/markdown.mjs`, `site/SITE.md` | The site: its sections, each game's landing, posts and their feeds, the look (theme tokens) and what the studio's `site/` folder overrides; the safe markdown posts are written in. `worker/pages.mjs`: the play page. |
 | `worker/stats.mjs`, `worker/stats-page.mjs`, `lib/stats.mjs` | The studio's own stats: what is counted and how, the owner-only `/api/stats` and `/_studio/stats`, and `homie-studio stats`. |

package/lib/brain-probe.mjs

@@ -0,0 +1,154 @@
+/**
+ * `homie-studio doctor`'s Workers AI row: when a server's AI guides think with Workers AI (brain `workers-ai`), is the
+ * model they use (wrangler.jsonc var HOMIE_BRAIN_MODEL, else worker/brain.mjs DEFAULT_MODEL) one this studio's
+ * Cloudflare account can run? Cloudflare moves models to the Workers Paid plan from time to time (three on 2026-07-28,
+ * error 5035) and retires others (5007); either way the guides fall back to the game's script without a word, so the
+ * doctor asks once.
+ *
+ * The check is ONE tiny call to the model through Cloudflare's REST API (`POST /accounts/:id/ai/run/:model`, a
+ * one-word prompt, max_tokens 1: about 0.1 of the 10,000 free neurons a day), with the studio's own Wrangler login
+ * (`wrangler auth token`, held in this process only) or CLOUDFLARE_API_TOKEN. It never prints the token, the account's
+ * id or its name. A call that cannot be made (not signed in, several accounts and none named) says so and spends
+ * nothing.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { DEFAULT_MODEL } from '../worker/brain.mjs';
+import { configPath, workerDir } from './studio.mjs';
+
+const MODELS = 'https://developers.cloudflare.com/workers-ai/models/';
+/** A Workers AI model id: @cf/<maker>/<model> (or @hf/…); nothing that could leave the API path. */
+export const MODEL_ID = /^@[a-z0-9-]+\/[A-Za-z0-9._-]+\/[A-Za-z0-9._:-]+$/;
+
+const parseJson = (text) => { const s = String(text ?? ''); const i = s.search(/[[{]/); if (i < 0) return null; try { return JSON.parse(s.slice(i)); } catch { return null; } };
+
+/** The model the studio's guides think with: wrangler.jsonc "vars".HOMIE_BRAIN_MODEL, else the toolkit's default. */
+export function brainModelOf(root) {
+  try {
+    const json = JSON.parse(readFileSync(configPath(root), 'utf8').replace(/^\s*\/\/.*$/gm, ''));
+    const v = json?.vars?.HOMIE_BRAIN_MODEL;
+    if (typeof v === 'string' && v.trim()) return { model: v.trim(), set: true };
+  } catch { /* no config: the default */ }
+  return { model: DEFAULT_MODEL, set: false };
+}
+
+/**
+ * Whether any open server of the studio's games thinks with Workers AI: a game.json seed in the built catalogue, or a
+ * row in the live database (one read-only `wrangler d1 execute --remote`). A database without the servers table, or
+ * one that cannot be read, says no.
+ */
+export async function usesWorkersAi(root, { exec, env = process.env, accountId = null, bin } = {}) {
+  try {
+    const cat = JSON.parse(readFileSync(join(root, 'site', 'dist', 'games.json'), 'utf8'));
+    if ((cat.games ?? []).some((g) => (g.servers ?? []).some((s) => s.brain === 'workers-ai'))) return true;
+  } catch { /* not built */ }
+  if (!bin || !existsSync(bin)) return false;
+  let db = 'DB';
+  try { db = JSON.parse(readFileSync(configPath(root), 'utf8').replace(/^\s*\/\/.*$/gm, ''))?.d1_databases?.[0]?.binding ?? 'DB'; } catch { /* the default binding */ }
+  const r = await exec(bin, ['d1', 'execute', db, '--remote', '--json', '--command', "SELECT COUNT(*) AS n FROM servers WHERE brain = 'workers-ai' AND state = 'open'"], {
+    cwd: workerDir(root), timeout: 25_000, env: { ...env, WRANGLER_SEND_METRICS: 'false', CI: '1', ...(accountId ? { CLOUDFLARE_ACCOUNT_ID: accountId } : {}) },
+  });
+  if (r.code !== 0) return false;
+  const parsed = parseJson(r.stdout);
+  return Number((Array.isArray(parsed) ? parsed[0] : parsed)?.results?.[0]?.n) > 0;
+}
+
+/** How to call Cloudflare's API as this computer's Wrangler login: headers, or null. Never printed. */
+export async function cloudflareAuth({ exec, env = process.env, bin, cwd } = {}) {
+  if (env.CLOUDFLARE_API_TOKEN) return { authorization: `Bearer ${env.CLOUDFLARE_API_TOKEN}` };
+  if (env.CLOUDFLARE_API_KEY && env.CLOUDFLARE_EMAIL) return { 'x-auth-key': env.CLOUDFLARE_API_KEY, 'x-auth-email': env.CLOUDFLARE_EMAIL };
+  if (!bin || !existsSync(bin)) return null;
+  const r = await exec(bin, ['auth', 'token', '--json'], { cwd, timeout: 15_000, env: { ...env, WRANGLER_SEND_METRICS: 'false', CI: '1' } });
+  if (r.code !== 0) return null;
+  const j = parseJson(r.stdout);
+  if (typeof j?.token === 'string' && j.token) return { authorization: `Bearer ${j.token}` };
+  if (typeof j?.key === 'string' && typeof j?.email === 'string') return { 'x-auth-key': j.key, 'x-auth-email': j.email };
+  return null;
+}
+
+/**
+ * What Cloudflare's answer to the probe means (its errors: developers.cloudflare.com/workers-ai/platform/errors/):
+ * `{ why, state }` with why one of ok, paid-only, missing, not-allowed, agreement, allowance, busy, auth, other.
+ */
+export function classifyProbe(status, body) {
+  const errs = Array.isArray(body?.errors) ? body.errors : [];
+  const codes = errs.map((e) => Number(e?.code)).filter(Number.isFinite);
+  const msg = errs.map((e) => String(e?.message ?? '')).filter(Boolean).join('; ');
+  const has = (c) => codes.includes(c);
+  if (status >= 200 && status < 300 && body?.success !== false) return { why: 'ok', state: 'ok', msg };
+  if (has(5035) || (status === 403 && /workers paid|paid plan|upgrade/i.test(msg))) return { why: 'paid-only', state: 'act', msg };
+  if (has(5007) || /no such model/i.test(msg) || status === 404) return { why: 'missing', state: 'act', msg };
+  if (has(5018)) return { why: 'not-allowed', state: 'act', msg };
+  if (has(5016) || /agree/i.test(msg)) return { why: 'agreement', state: 'act', msg };
+  if (has(3036) || (status === 429 && /free allocation|neurons/i.test(msg))) return { why: 'allowance', state: 'later', msg };
+  if (has(3040) || status === 429 || status >= 500) return { why: 'busy', state: 'unknown', msg };
+  if (status === 401 || has(10000) || has(10001) || (status === 403 && /auth/i.test(msg))) return { why: 'auth', state: 'unknown', msg };
+  if (status === 400) return { why: 'input', state: 'act', msg };
+  return { why: 'other', state: 'unknown', msg };
+}
+
+/**
+ * The one call. `{ status, body }`, or `{ error }` when the network failed. `fetchFn` stands in for the network in
+ * tests; the call is a one-word prompt with max_tokens 1.
+ */
+export async function probeModel({ model, accountId, headers, fetchFn = globalThis.fetch, base = 'https://api.cloudflare.com/client/v4', ms = 12_000 }) {
+  try {
+    const res = await fetchFn(`${String(base).replace(/\/+$/, '')}/accounts/${encodeURIComponent(accountId)}/ai/run/${model}`, {
+      method: 'POST',
+      headers: { ...headers, 'content-type': 'application/json', accept: 'application/json', 'user-agent': 'homie-studio-doctor' },
+      body: JSON.stringify({ messages: [{ role: 'user', content: 'Say OK.' }], max_tokens: 1 }),
+      signal: AbortSignal.timeout(ms),
+    });
+    return { status: res.status, body: await res.json().catch(() => null) };
+  } catch (error) {
+    return { error: String(error?.name === 'TimeoutError' ? `no answer in ${Math.round(ms / 1000)} s` : error?.message ?? error) };
+  }
+}
+
+/**
+ * The doctor's row, or null when no server thinks with Workers AI. `who`: the doctor's Wrangler answer
+ * (`signedIn`, `accountIds`); `bin`: the studio's own Wrangler; `remote`: the studio is live, so its database may be
+ * read; `exec`, `fetchFn` replaceable for tests.
+ */
+export async function workersAiRow({ root, studio, env = process.env, exec, fetchFn = globalThis.fetch, who = {}, bin, remote = false, cli = 'npx --no-install homie-studio' }) {
+  if (!root) return null;
+  const accountId = env.CLOUDFLARE_ACCOUNT_ID || studio?.cloudflare?.accountId || (who.accountIds?.length === 1 ? who.accountIds[0] : null);
+  if (!(await usesWorkersAi(root, { exec, env, accountId, bin: remote ? bin : null }))) return null;
+  const { model, set } = brainModelOf(root);
+  const row = {
+    id: 'workers-ai', label: 'Workers AI', need: 'for AI guides', model,
+    unlocks: 'AI guides that think and talk on servers whose brain is workers-ai, on the studio\'s own Workers AI (free: 10,000 neurons a day for the account)',
+  };
+  const where = set ? 'HOMIE_BRAIN_MODEL in wrangler.jsonc' : 'the toolkit\'s default';
+  const pick = (lead) => ({
+    who: 'ai', open: MODELS,
+    say: `${lead}Pick a model the account can run: set HOMIE_BRAIN_MODEL in wrangler.jsonc "vars" to a text-generation model from ${MODELS} that is not marked Workers Paid${set && model !== DEFAULT_MODEL ? ` (or remove it for the default, ${DEFAULT_MODEL})` : ''}, run \`${cli} doctor\` again, then \`npm run deploy\`. Until then the guides answer from the game's script.`,
+  });
+  const money = ' Moving the account to Workers Paid ($5 a month) also works, but that is the person\'s money: ask them, never decide it.';
+  if (!MODEL_ID.test(model)) return { ...row, state: 'act', detail: `${where} is "${model.slice(0, 80)}", which is not a Workers AI model id (@cf/<maker>/<model>)`, fix: pick('') };
+  if (who.signedIn === false && !env.CLOUDFLARE_API_TOKEN) return { ...row, state: 'later', detail: `${model} (${where}): checked once Wrangler is signed in`, fix: null };
+  if (!accountId) return { ...row, state: 'unknown', detail: `${model}: this login reaches several Cloudflare accounts and studio.json does not say which is the studio's (cloudflare.accountId, written at the first deploy)`, fix: null };
+  const headers = await cloudflareAuth({ exec, env, bin, cwd: workerDir(root) });
+  if (!headers) return { ...row, state: 'unknown', detail: `${model}: could not ask Cloudflare (no sign-in to call its API with)`, fix: { who: 'ai', run: 'npx wrangler login', say: 'Sign in to Cloudflare again (you approve once in the browser), then run doctor again.' } };
+  const answer = await probeModel({ model, accountId, headers, fetchFn, base: env.CLOUDFLARE_API_BASE_URL || undefined });
+  // Cloudflare's own words, without the account's id, and short.
+  const plain = (s) => String(s ?? '').split(accountId).join('<account>').replace(/\s+/g, ' ').trim().slice(0, 160);
+  if (answer.error) return { ...row, state: 'unknown', detail: `${model}: this computer's request to Cloudflare failed (${plain(answer.error)}); run doctor again`, fix: null };
+  const c = classifyProbe(answer.status, answer.body);
+  const said = c.msg ? ` (Cloudflare: "${plain(c.msg)}")` : '';
+  switch (c.why) {
+    case 'ok': return { ...row, state: 'ok', detail: `${model} answers on this studio's Cloudflare account (${where}; one tiny call just now)`, fix: null };
+    case 'paid-only': {
+      const fix = pick(model === DEFAULT_MODEL ? 'The toolkit\'s default model is paid-only now. ' : '');
+      return { ...row, state: 'act', detail: `${model} needs the Workers Paid plan, and this account is on Workers Free: every guide on a workers-ai server answers from the game's script${said}`, fix: { ...fix, say: fix.say + money } };
+    }
+    case 'missing': return { ...row, state: 'act', detail: `Cloudflare has no model ${model} (renamed or retired)${said}`, fix: pick('') };
+    case 'not-allowed': return { ...row, state: 'act', detail: `this account may not use ${model} (a private model)${said}`, fix: pick('') };
+    case 'agreement': return { ...row, state: 'act', detail: `${model} asks for its maker's licence to be agreed once before it is used${said}`, fix: pick('Agreeing to a licence is the person\'s to do, never yours; or simply: ') };
+    case 'input': return { ...row, state: 'act', detail: `${model} did not take a chat message: the guides need a text-generation model${said}`, fix: pick('') };
+    case 'allowance': return { ...row, state: 'later', detail: `today's free Workers AI allowance (10,000 neurons for the account) is used up, so ${model} could not be checked; the guides answer from the script until 00:00 UTC`, fix: { who: 'person', say: `Nothing to do now: run doctor again after 00:00 UTC. The studio's daily budget (\`${cli} agents brain <game> <server> workers-ai --budget <neurons>\`) keeps the guides under the allowance.` } };
+    case 'busy': return { ...row, state: 'unknown', detail: `Workers AI was busy just now (status ${answer.status})${said}; run doctor again in a minute`, fix: null };
+    case 'auth': return { ...row, state: 'unknown', detail: `Cloudflare did not let this sign-in run Workers AI (status ${answer.status})${said}`, fix: { who: 'ai', run: 'npx wrangler login', say: 'Sign in to Cloudflare again (the login includes Workers AI), then run doctor again.' } };
+    default: return { ...row, state: 'unknown', detail: `${model}: Cloudflare answered ${answer.status}${said}`, fix: null };
+  }
+}

package/lib/doctor.mjs

@@ -8,6 +8,9 @@
  *                                  Homie tools are there: --connector yes|no)
  *   Cloudflare         to go online: signed in, and the account's email verified (Cloudflare checks that at the
  *                                  first deploy; a deploy that went through proves it)
+ *   Workers AI         for AI guides  only when a server's guides think with Workers AI: the model they use
+ *                                  (HOMIE_BRAIN_MODEL, else the default) answers on the studio's account, not paid-only
+ *                                  or retired (lib/brain-probe.mjs: one tiny call, about 0.1 of the free daily neurons)
  *   Chrome             for checks  the two-browser check, the look pictures and playtests
  *   ffmpeg             recommended sound effects and the theme, trailers and hero footage
  *   GitHub             optional    a private backup, publishing by pull request, building from the Claude app
@@ -17,12 +20,14 @@
  *
  * It is safe at any time, inside a studio or before one exists: it only reads (local files, `--version` of a few
  * tools, `wrangler whoami`, `gh auth status`, `elevenlabs auth status`, one GET to the directory and, when a fal key
- * is set, fal's free pricing API), never changes anything, and never prints a key, a token or an account's name.
+ * is set, fal's free pricing API; when a server's AI guides use Workers AI, one read of the live database and one
+ * one-word call to the model), never changes anything, and never prints a key, a token or an account's name or id.
  * Every check has a time limit, so it answers in seconds even with no network.
  */
 import { spawn } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { workersAiRow } from './brain-probe.mjs';
 import { findChrome } from './chrome.mjs';
 import { whyFailed } from './net.mjs';
 import { isOurs } from './statusline.mjs';
@@ -98,7 +103,8 @@ export async function setupStatus({
       if (!bin || !existsSync(bin)) return { signedIn: null };
       const r = await exec(bin, ['whoami', '--json'], { cwd: root, timeout: 25_000, env: { ...env, WRANGLER_SEND_METRICS: 'false', CI: '1' } });
       if (r.code === 124) return { signedIn: null, why: 'Wrangler did not answer in time' };
-      try { const d = JSON.parse(r.stdout.slice(Math.max(0, r.stdout.indexOf('{')))); return { signedIn: Boolean(d.loggedIn), accounts: Array.isArray(d.accounts) ? d.accounts.length : null }; } catch { return { signedIn: false }; }
+      // The accounts' ids stay in this process (the Workers AI row calls the studio's own account); never printed.
+      try { const d = JSON.parse(r.stdout.slice(Math.max(0, r.stdout.indexOf('{')))); return { signedIn: Boolean(d.loggedIn), accounts: Array.isArray(d.accounts) ? d.accounts.length : null, accountIds: Array.isArray(d.accounts) ? d.accounts.map((a) => a?.id).filter(Boolean) : [] }; } catch { return { signedIn: false }; }
     })(),
     (async () => {
       const git = await exec('git', ['--version']);
@@ -182,6 +188,15 @@ export async function setupStatus({
     });
   }
 
+  // Workers AI, only when a server's AI guides think with it: does the model they use answer on this account?
+  {
+    const local = root ? readLocal(root) : {};
+    const live = Boolean(local.deployedAt || local.connectedAt || (studio?.cloudflare?.created ?? []).some((c) => String(c).startsWith('worker:')));
+    const bin = root ? join(root, 'node_modules', '.bin', win ? 'wrangler.cmd' : 'wrangler') : null;
+    const row = root ? await workersAiRow({ root, studio, env, exec, fetchFn, who, bin, remote: live && Boolean(who.signedIn || env.CLOUDFLARE_API_TOKEN), cli }) : null;
+    if (row) rows.push(row);
+  }
+
   // Chrome, for the checks.
   {
     const found = chrome();
@@ -254,6 +269,7 @@ export async function setupStatus({
     { feature: 'Backup and pull requests', state: ready(by.github.state), needs: ['github'] },
     { feature: 'Songs and game scores', state: ready(by.elevenlabs.state), needs: ['elevenlabs'] },
     { feature: 'Painted art and generated video', state: ready(by.fal.state), needs: ['fal'] },
+    ...(by['workers-ai'] ? [{ feature: 'AI guides that think (Workers AI)', state: ready(by['workers-ai'].state), needs: ['workers-ai'] }] : []),
   ];
   const now = rows.filter((r) => ['missing', 'act'].includes(r.state) && r.fix);
   const meanwhile = rows.filter((r) => r.fix?.open && r.state !== 'ok' && (r.fix.who === 'person' || r.state === 'later'));

package/lib/template-history.json

@@ -1,6 +1,6 @@
 {
  "v": 1,
- "about": "Fingerprints of every studio template version (scripts/studio-template-history.mjs): homie-studio upgrade replaces a file or an AGENTS.md section only when it is exactly one of these.",
+ "about": "Fingerprints of every studio template version (scripts/studio-template-history.mjs): homie-studio upgrade replaces a file or an AGENTS.md section only when it is exactly one of these. A version's named entries are for a studio the template itself names (lib/upgrade.mjs NAMED_IN_TEMPLATE), as that studio reads them.",
  "versions": {
   "0.2.0": {
    "files": {
@@ -138,14 +138,23 @@
     "music/README.md": "b8a828de9311bd28",
     "videos/README.md": "70614388cbb203c7",
     "posts/README.md": "37841aae476bd540",
-    "site/README.md": "0fd152a20a3eb55f",
+    "site/README.md": [
+     "0fd152a20a3eb55f",
+     "ca131cd0472464fb"
+    ],
     "site/src/worker.mjs": "ca3f1630f2420ad3"
    },
    "sections": {
     "AGENTS.md": {
      "(intro)": "214aa46eb3a895d5",
-     "## Layout": "b5f801e112d163a9",
-     "## Commands (all through the pinned CLI in node_modules)": "63833b7006efdef4",
+     "## Layout": [
+      "b5f801e112d163a9",
+      "dc8ce5f6276d369e"
+     ],
+     "## Commands (all through the pinned CLI in node_modules)": [
+      "2af7c804c1e81d86",
+      "63833b7006efdef4"
+     ],
      "## The site": "7d3525ba39b7f262",
      "## Making games": "c204473d9b468f49",
      "## Rules": "969318425c99f5a5",
@@ -252,24 +261,44 @@
    "files": {
     "CLAUDE.md": "ddf2b2a0376202f6",
     "README.md": "684b3cca8001673c",
-    "games/README.md": "5e5e942baa7e0372",
+    "games/README.md": [
+     "5ad32fe80c61f117",
+     "5e5e942baa7e0372"
+    ],
     "music/README.md": "b8a828de9311bd28",
     "videos/README.md": "70614388cbb203c7",
     "posts/README.md": "37841aae476bd540",
     "site/README.md": "ca131cd0472464fb",
-    "site/src/worker.mjs": "ca3f1630f2420ad3"
+    "site/src/worker.mjs": "ca3f1630f2420ad3",
+    "HANDOFF.md": "ce7a8fd91c6bbee2"
    },
    "sections": {
     "AGENTS.md": {
      "(intro)": "214aa46eb3a895d5",
      "## Layout": "f14d641159480e6c",
-     "## Commands (all through the pinned CLI in node_modules)": "3a3d3bef7e8d1a50",
-     "## The site": "7d3525ba39b7f262",
+     "## Commands (all through the pinned CLI in node_modules)": [
+      "3a3d3bef7e8d1a50",
+      "e579cd6ce3ce342a"
+     ],
+     "## The site": [
+      "7c1618431bae6324",
+      "7d3525ba39b7f262"
+     ],
      "## Making games": "63069b31c87a2aa2",
      "## The Game Codex and progress": "0738ef719cef3a4c",
      "## Running live games (the back office)": "f0566f07cff04113",
      "## Rules": "969318425c99f5a5",
-     "## Beta": "9d02638207a26e73"
+     "## Beta": "9d02638207a26e73",
+     "## Continuing a build from the Claude app": "0d68081e924ca419"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "befe520937e71984"
+      }
+     }
     }
    }
   },
@@ -298,6 +327,15 @@
      "## Rules": "969318425c99f5a5",
      "## Beta": "9d02638207a26e73"
     }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "befe520937e71984"
+      }
+     }
+    }
    }
   },
   "0.14.1": {
@@ -325,6 +363,15 @@
      "## Rules": "969318425c99f5a5",
      "## Beta": "9d02638207a26e73"
     }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "befe520937e71984"
+      }
+     }
+    }
    }
   },
   "0.14.2": {
@@ -352,6 +399,15 @@
      "## Rules": "969318425c99f5a5",
      "## Beta": "9d02638207a26e73"
     }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "befe520937e71984"
+      }
+     }
+    }
    }
   },
   "0.14.3": {
@@ -379,6 +435,15 @@
      "## Rules": "969318425c99f5a5",
      "## Beta": "9d02638207a26e73"
     }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "befe520937e71984"
+      }
+     }
+    }
    }
   },
   "0.14.4": {
@@ -406,6 +471,15 @@
      "## Rules": "969318425c99f5a5",
      "## Beta": "9d02638207a26e73"
     }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "befe520937e71984"
+      }
+     }
+    }
    }
   },
   "0.15.0": {
@@ -433,6 +507,15 @@
      "## Rules": "969318425c99f5a5",
      "## Beta": "9d02638207a26e73"
     }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "befe520937e71984"
+      }
+     }
+    }
    }
   },
   "0.16.0": {
@@ -461,6 +544,15 @@
      "## Rules": "969318425c99f5a5",
      "## Beta": "9d02638207a26e73"
     }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "befe520937e71984"
+      }
+     }
+    }
    }
   },
   "0.16.1": {
@@ -489,6 +581,15 @@
      "## Rules": "969318425c99f5a5",
      "## Beta": "9d02638207a26e73"
     }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "befe520937e71984"
+      }
+     }
+    }
    }
   },
   "0.17.0": {
@@ -517,6 +618,15 @@
      "## Rules": "969318425c99f5a5",
      "## Beta": "9d02638207a26e73"
     }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "befe520937e71984"
+      }
+     }
+    }
    }
   },
   "0.18.0": {
@@ -545,6 +655,89 @@
      "## Rules": "969318425c99f5a5",
      "## Beta": "9d02638207a26e73"
     }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "eedef844b7aaf7ad"
+      }
+     }
+    }
+   }
+  },
+  "0.18.1": {
+   "files": {
+    "CLAUDE.md": "ddf2b2a0376202f6",
+    "README.md": "684b3cca8001673c",
+    "HANDOFF.md": "ce7a8fd91c6bbee2",
+    "games/README.md": "5ad32fe80c61f117",
+    "music/README.md": "a3dc042dadd39df8",
+    "videos/README.md": "16babc3437d5545b",
+    "posts/README.md": "37841aae476bd540",
+    "site/README.md": "ca131cd0472464fb",
+    "site/src/worker.mjs": "ca3f1630f2420ad3"
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "214aa46eb3a895d5",
+     "## Layout": "eb1942414b8af7f8",
+     "## Commands (all through the pinned CLI in node_modules)": "9c51f189412e6a9f",
+     "## The site": "ab922bb6bde23293",
+     "## Making games": "a8a893eeada33bf5",
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Running live games (the back office)": "f0566f07cff04113",
+     "## Servers and AI seats": "0a332b07e22d3fce",
+     "## Continuing a build from the Claude app": "0d68081e924ca419",
+     "## Rules": "969318425c99f5a5",
+     "## Beta": "9d02638207a26e73"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "eedef844b7aaf7ad"
+      }
+     }
+    }
+   }
+  },
+  "0.18.2": {
+   "files": {
+    "CLAUDE.md": "ddf2b2a0376202f6",
+    "README.md": "684b3cca8001673c",
+    "HANDOFF.md": "ce7a8fd91c6bbee2",
+    "games/README.md": "5ad32fe80c61f117",
+    "music/README.md": "a3dc042dadd39df8",
+    "videos/README.md": "16babc3437d5545b",
+    "posts/README.md": "37841aae476bd540",
+    "site/README.md": "ca131cd0472464fb",
+    "site/src/worker.mjs": "ca3f1630f2420ad3"
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "214aa46eb3a895d5",
+     "## Layout": "eb1942414b8af7f8",
+     "## Commands (all through the pinned CLI in node_modules)": "9c51f189412e6a9f",
+     "## The site": "ab922bb6bde23293",
+     "## Making games": "a8a893eeada33bf5",
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Running live games (the back office)": "f0566f07cff04113",
+     "## Servers and AI seats": "0a332b07e22d3fce",
+     "## Continuing a build from the Claude app": "0d68081e924ca419",
+     "## Rules": "969318425c99f5a5",
+     "## Beta": "9d02638207a26e73"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "eedef844b7aaf7ad"
+      }
+     }
+    }
    }
   }
  }