@homie-rocks/studio 0.42.0 → 0.44.0

package/lib/rules-build.mjs

@@ -53,9 +53,9 @@ function readMap(g) {
   const dir = join(g.dir, 'map');
   const names = existsSync(dir) ? readdirSync(dir).filter((n) => n.endsWith('.json')).sort() : [];
   const name = names.includes('main.json') ? 'main.json' : names[0];
-  if (!name) throw new Error(`games/${g.id}/map/ needs a map: map/main.json with "bounds", and the "boxes", "circles" and named "spots" the rules use`);
+  if (!name) throw new Error(`${g.kind === 'app' ? 'apps' : 'games'}/${g.id}/map/ needs a map: map/main.json with "bounds", and the "boxes", "circles" and named "spots" the rules use`);
   const raw = readJson(join(dir, name));
-  if (!raw || typeof raw !== 'object') throw new Error(`games/${g.id}/map/${name} is not JSON`);
+  if (!raw || typeof raw !== 'object') throw new Error(`${g.kind === 'app' ? 'apps' : 'games'}/${g.id}/map/${name} is not JSON`);
   return { ...raw, name: name.replace(/\.json$/, '') };
 }
 
@@ -142,7 +142,7 @@ export function smokeRun(H, compiled, id, { timer = () => { const t = process.cp
  */
 export async function prepareRules(esbuild, root, g, { log = () => {}, longCheck = false } = {}) {
   const guarded = await guardRules(esbuild, root, g.dir);
-  if (!guarded.ok) throw new Error(`games/${g.id}: its rules were refused.\n${guarded.problems.slice(0, 20).map((p) => `  ${problemLine(p)}`).join('\n')}${guarded.problems.length > 20 ? `\n  … and ${guarded.problems.length - 20} more` : ''}`);
+  if (!guarded.ok) throw new Error(`${g.kind === 'app' ? 'apps' : 'games'}/${g.id}: its rules were refused.\n${guarded.problems.slice(0, 20).map((p) => `  ${problemLine(p)}`).join('\n')}${guarded.problems.length > 20 ? `\n  … and ${guarded.problems.length - 20} more` : ''}`);
   const tune = readJson(join(g.dir, 'tunables.json')) ?? {};
   const map = readMap(g);
   const seats = Math.max(1, Math.min(32, Math.floor(Number(g.players?.max)) || 8));
@@ -151,12 +151,12 @@ export async function prepareRules(esbuild, root, g, { log = () => {}, longCheck
   // The declarations first, for the type check: a wrong program is named by the compiler before anything is played.
   await typecheckRules(root, g, await runRulesWorker(bundle, data, { declarationsOnly: true }), tune, { log });
   const checked = await runRulesWorker(bundle, data, { allowance: longCheck ? LONG_ALLOWANCE : ALLOWANCE });
-  for (const p of checked.problems) log(`warning: games/${g.id}/game.json: ${p}`);
+  for (const p of checked.problems) log(`warning: ${g.kind === 'app' ? 'apps' : 'games'}/${g.id}/${g.kind === 'app' ? 'app' : 'game'}.json: ${p}`);
   for (const line of checked.information) log(`info: ${line}`);
   const { settings, schema, publicTune, rounds, stateHash } = checked;
   const trial = RULES_CAPACITY_TRIAL;
   log(`info: rules runtime reference trial: ${trial.game}, ${trial.seats} players at ${trial.tickHz} Hz for ${trial.minutes} minutes on ${trial.host} (${trial.platform}). Cloudflare capacity and billing are unmeasured.`);
-  if (settings.tickHz > trial.tickHz) log(`info: games/${g.id} asks for ${settings.tickHz} Hz, above the completed local reference trial's ${trial.tickHz} Hz. This game's generated check does not establish live room capacity.`);
+  if (settings.tickHz > trial.tickHz) log(`info: ${g.kind === 'app' ? 'apps' : 'games'}/${g.id} asks for ${settings.tickHz} Hz, above the completed local reference trial's ${trial.tickHz} Hz. This game's generated check does not establish live room capacity.`);
   const { def, R, H } = await loadRules(esbuild, root, g.id, guarded.code);
   const compiled = R.compileRules(def, { tune, map: R.compileMap(map, map.name), settings, seats });
   const stats = smokeRun(H, compiled, g.id, { timer: () => 0, vocab: data.vocab });
@@ -168,7 +168,7 @@ export async function prepareRules(esbuild, root, g, { log = () => {}, longCheck
       ...(t !== 'snap' && rate > rateCap ? [`${t} ${rate}/s (cap ${rateCap}/s; over by ${rate - rateCap}/s)`] : [])];
   });
   if (exceeded.length) {
-    const message = `games/${g.id}: browser rules smoke run measured snapshot ${stats.snapshotBytes} B (cap ${snapshotCap} B), checkpoint ${stats.checkpointBytes} B (cap ${checkpointCap} B). Exceeded: ${exceeded.join(', ')}. Reduce these frames or use room.host: server; offline play has no relay caps.`;
+    const message = `${g.kind === 'app' ? 'apps' : 'games'}/${g.id}: browser rules smoke run measured snapshot ${stats.snapshotBytes} B (cap ${snapshotCap} B), checkpoint ${stats.checkpointBytes} B (cap ${checkpointCap} B). Exceeded: ${exceeded.join(', ')}. Reduce these frames or use room.host: server; offline play has no relay caps.`;
     if (settings.host === 'browser') throw new Error(message);
     log(`warning: ${message}`);
   }

package/lib/rules-guard.mjs

@@ -42,7 +42,7 @@ import babelTraverse from '@babel/traverse';
 import * as babelGenerator from '@babel/generator';
 import * as t from '@babel/types';
 import { TraceMap, originalPositionFor } from '@jridgewell/trace-mapping';
-import { existsSync, readFileSync, statSync } from 'node:fs';
+import { existsSync, readFileSync, realpathSync, statSync } from 'node:fs';
 import { dirname, join, relative, resolve } from 'node:path';
 
 const traverse = babelTraverse.default ?? babelTraverse;
@@ -757,12 +757,18 @@ export async function guardFiles(esbuild, root, gameDir, entry) {
 
 /** An esbuild plugin that serves a game's guarded files in place of its sources (`stub`: files a bundle must not hold at all). */
 export function guardedPlugin(files, { stub = [] } = {}) {
+  // esbuild resolves filesystem aliases (including macOS /tmp -> /private/tmp).
+  // Match those paths to the exact sources already checked and rewritten.
+  const canonical = (file) => existsSync(file) ? realpathSync(file) : file;
+  const guarded = new Map([...files].map(([file, code]) => [canonical(file), code]));
+  const omitted = new Set(stub.map(canonical));
   return {
     name: 'homie-rules-guard',
     setup(b) {
       b.onLoad({ filter: /\.(?:ts|js|mjs)$/ }, (a) => {
-        if (stub.includes(a.path)) return { contents: 'export default {};\n', loader: 'js' };
-        const code = files.get(a.path);
+        const file = canonical(a.path);
+        if (omitted.has(file)) return { contents: 'export default {};\n', loader: 'js' };
+        const code = guarded.get(file);
         return typeof code === 'string' ? { contents: code, loader: 'js' } : null;
       });
     },

package/lib/scaffold.mjs

@@ -126,7 +126,7 @@ directory lists its games; homie.rocks does not host them.
 
 | Path | What it is |
 | --- | --- |
-| \`games/<id>/\` | One game: \`game.json\` (id, name, blurb, players, round length), \`index.html\`, \`src/main.ts\`; and, when it has them, \`tunables.json\` (the numbers that shape how it feels: the Game Lab's sliders, kept values written back) and \`lab.json\` (the Game Lab's takes). |
+| \`games/<id>/\` | One game: \`game.json\` (id, name, blurb, players, round length), \`index.html\`, \`src/rules.ts\`, \`src/move.ts\`, \`src/view.ts\` and shared \`map/\` data; and, when it has them, \`tunables.json\` (the numbers that shape how it feels: the Game Lab's sliders, kept values written back) and \`lab.json\` (the Game Lab's takes). |
 | \`music/\`, \`videos/\` | Songs, scores, loops; trailers, music videos, cutscenes. \`manifest.json\` lists each one (\`node_modules/@homie-rocks/studio/media/MEDIA.md\`); a published entry gets a page at \`/music/<slug>/\` or \`/videos/<slug>/\`. Without storage the site serves each file itself (up to 25 MiB). Once the studio has storage (see below), its big media (over 1 MiB, or left out of git) lives in its own R2: every deploy uploads it, checks it by SHA-256 and serves it from R2 at the same address. Large files never go into git. The Homie plugin's \`music\` and \`video\` skills make them. |
 | \`games/<id>/assets/\` | Every model and texture a game ships, with where it came from and its licence (\`manifest.json\`), and \`RIGHTS.md\` in plain words; \`games/<id>/codex/decisions.json\` (private, like the codex) is its look as decisions, and \`style.json\` the palette, fonts, light and camera the game draws with. \`art/<slug>/\` holds art jobs (concepts, receipts; \`raw/\` is git-ignored). |
 | \`posts/\` | The studio's news and drops: one markdown file each (\`posts/2026-09-30-we-are-live.md\`: \`title:\`, \`date:\`, \`summary:\`, and \`game:\` / \`song:\` / \`video:\` to link one). They are the site's Posts, with Atom and JSON feeds. |
@@ -171,7 +171,7 @@ studio's pinned copy, never a registry lookup of the bare name.
   game: copy a starter only when the person asks for one, or once their game is planned.
 - \`npx --no-install homie-studio port plan <folder>\` — read an existing single-player web game and grade
   how hard making it multiplayer will be; \`port import\` brings it into \`games/\`, \`port check\` runs the
-  owner tests (real touch, a late joiner, a killed host, two browsers finishing a round). The Homie
+  owner tests (real touch, a late joiner, one browser leaving, two browsers finishing a round). The Homie
   plugin's \`port\` skill does the whole job.
 - \`npm run build\` — bundle every game into \`site/dist\`. It builds in a folder of its own and puts the result
   in place only when all of it is there: a game that does not build fails the command (a non-zero exit) and
@@ -197,7 +197,7 @@ studio's pinned copy, never a registry lookup of the bare name.
 - \`npx --no-install homie-studio check <id> --url <site>\` — two headless browsers press Play and must
   land in the same room and finish a round. Run it before you say a game works.
 - \`npx --no-install homie-studio perf <id> --url <site>\` — how fast a game runs, on a computer and an emulated
-  phone, with two browsers in a room (the host and a replica): frame times, the game's JavaScript and the main thread
+  phone, with two browsers in a room (two replicas when the server hosts): frame times, the game's JavaScript and the main thread
   per frame, time to playable, what it downloads, the heap, netplay messages a second (files under \`.perf/\`). The
   Homie plugin's \`perf\` skill runs the whole loop: one change at a time, kept only when it is better beyond the noise
   and \`check\` still passes, and a report in \`perf/<id>/\`.
@@ -279,11 +279,37 @@ studio's pinned copy, never a registry lookup of the bare name.
 
 ## Making games
 
-- Every game is multiplayer on the web through the netplay contract
-  (\`node_modules/@homie-rocks/studio/netplay/NETPLAY.md\`): every browser renders the game
-  itself, one browser hosts the rules, strangers meet in public rooms, bots fill empty
-  seats, anyone arriving takes a bot's place, rounds end and restart on their own.
-- Import it as \`import { createNetplay } from '@homie-rocks/studio/netplay'\`.
+- **New games are rules plus view, hosted by the server.** Read the Homie game skill and its
+  RULES.md before writing code (MCP: studio_guide game, then studio_guide game file RULES.md).
+  Start with coin-dash, gem-rush, ember-vale, gem-rush-3d or hero-rush-3d; all five follow this contract.
+  In games/<id>/src/rules.ts, defineRules declares entities, fields, handlers, events, rounds and companions.
+  The view calls openRoom and sends input/commands; it draws, plays sound and handles controls. It never
+  decides a hit, score, spawn, turn or result. Keep game.json room.host set to server, up to 32 seats.
+- **Movement feels immediate through prediction.** Put the shared defineMove callback in src/move.ts;
+  it runs authoritatively on the server and immediately for your own view, then reconciles. Other bodies
+  interpolate. Use the starter's sweep/slide and room.me/room.each poses; no second browser physics loop,
+  and no owner-movement workaround. Discrete actions wait for the server's decision.
+- **Truth is declared and deterministic.** Entity handlers write their own fields and send next-tick events;
+  room handlers write shared fields. Use world.tick/dt/ticks/after/random and world.math (ctx.math in move),
+  never clocks, Math.random, hidden module state, async/network calls or browser APIs in rules.
+  Read RULES.md for the bounded query and execution budget, declared commands/effects/asks, and message fixes.
+- **Level data is shared.** map/main.json describes collision and bounds in metres. A 3D rules body's z is
+  height at its feet; Three.js draws x,z,y. Floors, walls and platforms must agree in rules and view.
+  Public tunables describe movement. Bots and companions use the same inputs and declared goals, with a
+  scripted floor that plays without AI. Asks declare bounded state, questions and a deterministic floor.
+- **Choose sensible defaults yourself.** Do not ask the person for a hosting mode, movement mode, tick rate
+  or serialization scheme. Preserve the requested mechanic. Turn-based games and live apps may use manual
+  rounds. Shared live app state uses these same rooms; durable records and authentication use the app APIs.
+  A build-only request ends with a working local result; publish only within the owner's requested scope.
+- **Check changes honestly.** Build first, repair each source-located guard/type/play-check error using RULES.md,
+  then check with two browsers and play the requested mechanic with network delay. Info is not a failure.
+  Never remove rules, weaken checks, forge a probe or switch hosting to get past a message.
+  Rules hashes and room saves are automatic; character saves are player-owned, untrusted input. Room state
+  is replicated, not secret. Bigger rooms and private state are not delivered by milestone 1.
+- **Existing games:** change rules truth in rules and presentation in view. Browser hosting is for offline,
+  local development and private friends games. Untouched older createNetplay/createRoom games still work;
+  when asked to rewrite one, read the game skill's REWRITE.md and preserve its art, view and feel. There is
+  no automatic converter. NETPLAY.md section 29 is the rules contract; earlier sections describe older APIs.
 - Phones and computers: touch controls on phones only, keys on computers; keep the
   centre of the screen clear during play.
 - The play page's small room button (Invite, Big screen, the room code) sits top right, with the Chat pill
@@ -433,7 +459,10 @@ studio's pinned copy, never a registry lookup of the bare name.
   \`--policy beginner --guides 2 [--kids]\`, \`--policy humans-only\`) makes one at once; \`servers set <id> <server>
   --level-max 3 …\` changes one; \`servers close <id> <server>\`. A change that narrows who may come in (humans-only,
   a stricter door) and closing one only ASK, with the owner's one-tap link, like \`office kick\`.
-- **The skill dial:** every room has a level, 1 Rookie, 2 Steady, 3 Fair, 4 Strong, 5 Maxed, each \`{ reactionMs,
+- **Rules companions:** use world.level, world.guideLevel, world.guideSeats and world.kids; guide.view,
+  guide.floor, think and goalDone follow the rules contract. The old BotBrain/useAgents/decide recipes below
+  apply only to unchanged browser-hosted games. Read RULES.md for a new game.
+- **The skill dial (older browser-hosted games):** every room has a level, 1 Rookie, 2 Steady, 3 Fair, 4 Strong, 5 Maxed, each \`{ reactionMs,
   aimNoise, aggression, positioning }\`. The party sets it by voting on a card in the play page (the middle vote
   wins, capped by the server's ceiling). Make a game's bots honour it: \`net.skillOf(slot)\` in their step (the
   snippet is in \`NETPLAY.md\` section 17; \`BotBrain\` from the port kit reads it with a rebuild), and declare
@@ -1018,10 +1047,11 @@ export function newStudio(folder, { name, homie, slug: askedSlug, install = true
   const q = JSON.stringify(realpathSync(dir));
   return { ok: true, command: 'new', dir: realpathSync(dir), name, slug, wrote, git, installed, studio: STUDIO_VERSION, next: [
     `cd ${q}${install ? '' : ' && npm install'}`,
-    'see a working game first, with nothing copied here: npx --no-install homie-studio demo (a live game on Homie Arcade)',
-    'a copy of a starter only when the person asks for one: npx --no-install homie-studio game new <id> --from gem-rush --name "<Game Name>"',
+    'read the game skill and RULES.md; choose sensible defaults and make the requested game as server rules plus view',
+    'optional live example, without copying a game here: npx --no-install homie-studio demo',
+    'only when the person asks for a game: start from a rules starter and implement the requested mechanic: npx --no-install homie-studio game new <id> --from gem-rush --name "<Game Name>"',
     'npm run dev   (the home page, "first game coming soon", at http://127.0.0.1:8787/; with a game: npx --no-install homie-studio check <id> --url http://127.0.0.1:8787)',
-    'npm run deploy   (then the Homie MCP tool studio_publish, or: npx --no-install homie-studio publish)',
+    'when the owner asks to publish: npm run deploy   (then studio_publish, or: npx --no-install homie-studio publish)',
   ], online: 'Going online creates one Worker, one D1 database and two Durable Objects on your own Cloudflare account: free plan, no payment method, no R2. `npx --no-install homie-studio deploy --plan` says exactly what, and changes nothing.' };
 }
 

package/lib/studio.mjs

@@ -108,7 +108,7 @@ function listKind(root, kind) {
 /**
  * RULES ON THE SERVER (NETPLAY.md section 29). A game written as rules plus view says so in game.json with a `"room"`
  * object (where its rules run, its tick rate…; rules/rules.ts `roomSettings` checks them at build) and has a
- * src/rules.ts. Any other game is hosted by a player's browser, as before. The file alone decides nothing: games made
+ * src/rules.ts. Other games need the browser-hosted netplay contract checked by the build. The file alone decides nothing: games made
  * before this had their own src/rules.ts, with whatever they liked in it, and they build exactly as they did.
  */
 export const isRulesGame = (g) => g?.room != null && typeof g.room === 'object' && existsSync(join(g.dir, 'src', 'rules.ts'));
@@ -129,7 +129,7 @@ export function starters() {
   const dir = join(PACKAGE_ROOT, 'starters');
   return readdirSync(dir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => {
     const meta = JSON.parse(readFileSync(join(dir, d.name, 'game.json'), 'utf8'));
-    // `example`: a starter that shows how something is written (coin-dash: rules on the server) and is not yet offered as the start of a new game.
+    // `example`: marks the smallest reference (coin-dash); all starters use server rules and can start a new game.
     return { id: d.name, name: meta.name, blurb: meta.blurb, players: meta.players, roundSeconds: meta.roundSeconds, ...(meta.example === true ? { example: true } : {}) };
   });
 }
@@ -309,7 +309,7 @@ export async function newApp(root, id, { name } = {}) {
   const meta = JSON.parse(readFileSync(file, 'utf8'));
   meta.id = id; meta.name = String(name ?? 'Welcome together').slice(0, 60);
   writeFileSync(file, `${JSON.stringify(meta, null, 2)}\n`);
-  const main = join(dest, 'src/main.ts');
+  const main = join(dest, meta.entry ?? 'src/main.ts');
   writeFileSync(main, readFileSync(main, 'utf8').replaceAll("game: 'welcome'", `game: '${id}'`));
   return { ok: true, command: 'app new', id, dir: dest, files: readdirSync(dest, { recursive: true }).map(String), ...addNeeds(root, meta.needs) };
 }

package/lib/template-history.json

@@ -2199,6 +2199,68 @@
    }
   },
   "0.40.0": {
+   "files": {
+    "CLAUDE.md": "ddf2b2a0376202f6",
+    "README.md": "684b3cca8001673c",
+    "HANDOFF.md": "29337e2ace95b2e7",
+    "games/README.md": "5ad32fe80c61f117",
+    "music/README.md": "a3dc042dadd39df8",
+    "videos/README.md": "16babc3437d5545b",
+    "posts/README.md": "37841aae476bd540",
+    "site/README.md": "732894273a32dc3f",
+    "site/src/worker.mjs": [
+     "34444a6ca4b14437",
+     "fc90f3609cad18ba"
+    ]
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "214aa46eb3a895d5",
+     "## Layout": [
+      "c18362ed28975d81",
+      "f3a280b8c96cd068"
+     ],
+     "## Apps: one screen, roles and parts": [
+      "4db0abe4cdfac09f",
+      "be6f8fa45f93211a"
+     ],
+     "## Commands (all through the pinned CLI in node_modules)": [
+      "a7f290579585368c",
+      "c920ac84d44c872a"
+     ],
+     "## The site": "0cb8dd9a6f8a0096",
+     "## Making games": [
+      "2da7fa74c8884834",
+      "9e44559de535d842"
+     ],
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Art direction and models": "a48fff7bf0a5f2fc",
+     "## Running live games (the back office)": "51ebf2ab756f6e4d",
+     "## Servers and AI seats": [
+      "98d08705087a33ec",
+      "d0028361fe567add"
+     ],
+     "## Selling things (the shop)": "9e020d69dd6a954e",
+     "## Continuing a build from the Claude app": "0d68081e924ca419",
+     "## Rules": "2e6b29afb85dcf7e",
+     "## Telling Homie": "80b46fdd9e578db8",
+     "## Beta": "9d02638207a26e73"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": [
+        "7cad8fd10f62fef1",
+        "cae1df6235f51d17"
+       ]
+      }
+     }
+    }
+   }
+  },
+  "0.41.0": {
    "files": {
     "CLAUDE.md": "ddf2b2a0376202f6",
     "README.md": "684b3cca8001673c",
@@ -2213,15 +2275,15 @@
    "sections": {
     "AGENTS.md": {
      "(intro)": "214aa46eb3a895d5",
-     "## Layout": "c18362ed28975d81",
+     "## Layout": "f3a280b8c96cd068",
      "## Apps: one screen, roles and parts": "be6f8fa45f93211a",
-     "## Commands (all through the pinned CLI in node_modules)": "a7f290579585368c",
+     "## Commands (all through the pinned CLI in node_modules)": "159151b8861fc051",
      "## The site": "0cb8dd9a6f8a0096",
-     "## Making games": "2da7fa74c8884834",
+     "## Making games": "9e44559de535d842",
      "## The Game Codex and progress": "0738ef719cef3a4c",
      "## Art direction and models": "a48fff7bf0a5f2fc",
      "## Running live games (the back office)": "51ebf2ab756f6e4d",
-     "## Servers and AI seats": "98d08705087a33ec",
+     "## Servers and AI seats": "d0028361fe567add",
      "## Selling things (the shop)": "9e020d69dd6a954e",
      "## Continuing a build from the Claude app": "0d68081e924ca419",
      "## Rules": "2e6b29afb85dcf7e",
@@ -2233,7 +2295,7 @@
     "Homie Arcade": {
      "sections": {
       "AGENTS.md": {
-       "## Commands (all through the pinned CLI in node_modules)": "7cad8fd10f62fef1"
+       "## Commands (all through the pinned CLI in node_modules)": "2cdd530e48170bfd"
       }
      }
     }
@@ -2282,6 +2344,88 @@
      }
     }
    }
+  },
+  "0.43.0": {
+   "files": {
+    "CLAUDE.md": "ddf2b2a0376202f6",
+    "README.md": "684b3cca8001673c",
+    "HANDOFF.md": "29337e2ace95b2e7",
+    "games/README.md": "5ad32fe80c61f117",
+    "music/README.md": "a3dc042dadd39df8",
+    "videos/README.md": "16babc3437d5545b",
+    "posts/README.md": "37841aae476bd540",
+    "site/README.md": "732894273a32dc3f",
+    "site/src/worker.mjs": "34444a6ca4b14437"
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "214aa46eb3a895d5",
+     "## Layout": "f3a280b8c96cd068",
+     "## Apps: one screen, roles and parts": "8596f2b25edda3e2",
+     "## Commands (all through the pinned CLI in node_modules)": "159151b8861fc051",
+     "## The site": "0cb8dd9a6f8a0096",
+     "## Making games": "9e44559de535d842",
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Art direction and models": "a48fff7bf0a5f2fc",
+     "## Running live games (the back office)": "51ebf2ab756f6e4d",
+     "## Servers and AI seats": "d0028361fe567add",
+     "## Selling things (the shop)": "9e020d69dd6a954e",
+     "## Continuing a build from the Claude app": "0d68081e924ca419",
+     "## Rules": "2e6b29afb85dcf7e",
+     "## Telling Homie": "80b46fdd9e578db8",
+     "## Beta": "9d02638207a26e73"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "2cdd530e48170bfd"
+      }
+     }
+    }
+   }
+  },
+  "0.44.0": {
+   "files": {
+    "CLAUDE.md": "ddf2b2a0376202f6",
+    "README.md": "684b3cca8001673c",
+    "HANDOFF.md": "29337e2ace95b2e7",
+    "games/README.md": "5ad32fe80c61f117",
+    "music/README.md": "a3dc042dadd39df8",
+    "videos/README.md": "16babc3437d5545b",
+    "posts/README.md": "37841aae476bd540",
+    "site/README.md": "732894273a32dc3f",
+    "site/src/worker.mjs": "34444a6ca4b14437"
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "214aa46eb3a895d5",
+     "## Layout": "f3a280b8c96cd068",
+     "## Apps: one screen, roles and parts": "8596f2b25edda3e2",
+     "## Commands (all through the pinned CLI in node_modules)": "159151b8861fc051",
+     "## The site": "0cb8dd9a6f8a0096",
+     "## Making games": "9e44559de535d842",
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Art direction and models": "a48fff7bf0a5f2fc",
+     "## Running live games (the back office)": "51ebf2ab756f6e4d",
+     "## Servers and AI seats": "d0028361fe567add",
+     "## Selling things (the shop)": "9e020d69dd6a954e",
+     "## Continuing a build from the Claude app": "0d68081e924ca419",
+     "## Rules": "2e6b29afb85dcf7e",
+     "## Telling Homie": "80b46fdd9e578db8",
+     "## Beta": "9d02638207a26e73"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "2cdd530e48170bfd"
+      }
+     }
+    }
+   }
   }
  }
 }

package/lib/trailer.mjs

@@ -1,8 +1,8 @@
 /**
  * `homie-studio trailer <id>`: a trailer of a game, in one command.
  *
- * The work is not here. It is the Homie plugin's video skill (`video.mjs trailer`): the game rendered frame by frame
- * on a virtual clock, its sound rebuilt from its own files, the highlights picked from what it played, an end card,
+ * The work is not here. It is the Homie plugin's video skill (`video.mjs trailer`): live footage for server rules,
+ * or a virtual clock and rebuilt sound for older browser games, selected highlights, an end card,
  * and 16:9, 1:1 and 9:16 deliveries. This finds that script and hands the command over, so a person at a terminal
  * and an agent with the plugin run the same thing. The video goes to videos/<id>-trailer/ (or --slug <slug>).
  *
@@ -36,10 +36,14 @@ export function trailerCommand(root, id, rest, { skills = null, slug = null } =
 }
 
 export function trailerLines(r) {
+  const live = r.capture?.mode === 'live';
+  const audio = r.capture?.audio;
+  const sound = audio?.rebuilt ? `${audio.placed} sounds rebuilt from the game's own files`
+    : audio ? 'game audio captured live' : live ? 'no audio captured' : 'the game logged no sound';
   return [
     ...(r.problems ?? []).map((x) => `PROBLEM: ${x}`),
     `${r.seconds} s trailer of ${r.game}: ${Object.values(r.outputs ?? {}).map((o) => o.file).join(', ')}`,
-    `  filmed ${r.capture?.seconds} s frame by frame (${r.capture?.frames} frames, ${r.capture?.heldFrames} held); ${r.capture?.audio ? `${r.capture.audio.placed} sounds rebuilt from the game's own files` : 'the game logged no sound'}`,
+    `  filmed ${r.capture?.seconds} s ${live ? 'live' : 'frame by frame'} (${r.capture?.frames} frames, ${r.capture?.heldFrames} held); ${sound}`,
     `  ${r.edit?.shots} shots of ${r.edit?.shotSeconds} s, picked ${r.edit?.picked}`,
     ...(r.warnings ?? []).map((w) => `  warning: ${w}`),
     ...(r.next ? [`  next (the video skill's script): ${r.next}`] : []),

package/lib/typecheck.mjs

@@ -93,12 +93,12 @@ export function typecheck(root, games, { log = () => {} } = {}) {
       }
       // An error with no file is the project itself (a tsconfig.json that does not read): the game's to fix.
       const bare = /^error (TS\d+): (.*)$/.exec(line);
-      if (bare) mine.push(`games/${g.id}${own ? '/tsconfig.json' : ''} ${bare[1]} ${bare[2]}`);
+      if (bare) mine.push(`${g.kind === 'app' ? 'apps' : 'games'}/${g.id}${own ? '/tsconfig.json' : ''} ${bare[1]} ${bare[2]}`);
     }
     rows.push({ id: g.id, checked: true, with: own ? 'its tsconfig.json' : 'the build\'s own settings', errors: mine.length, elsewhere });
-    if (elsewhere) log(`types: games/${g.id}: ${elsewhere} ${elsewhere === 1 ? 'error' : 'errors'} outside the game's own files (a package it imports as source); not the game's, so not counted`);
+    if (elsewhere) log(`types: ${g.kind === 'app' ? 'apps' : 'games'}/${g.id}: ${elsewhere} ${elsewhere === 1 ? 'error' : 'errors'} outside the game's own files (a package it imports as source); not the game's, so not counted`);
     if (mine.length) found.push(...mine);
-    else log(`types: games/${g.id} has no type errors (TypeScript ${ts.version ?? '?'}, ${own ? 'its tsconfig.json' : 'the build\'s own settings'})`);
+    else log(`types: ${g.kind === 'app' ? 'apps' : 'games'}/${g.id} has no type errors (TypeScript ${ts.version ?? '?'}, ${own ? 'its tsconfig.json' : 'the build\'s own settings'})`);
   }
   if (found.length) {
     const shown = found.slice(0, 20);
@@ -125,7 +125,7 @@ export async function typecheckRules(root, g, checked, tune, { log = () => {} }
     '@homie-rocks/studio/*': [join(PACKAGE_ROOT, '*')],
   } }, files: [join(g.dir, 'src/rules.ts'), join(g.dir, g.entry ?? 'src/view.ts'), join(dir, 'files.d.ts')] }, null, 2)}\n`);
   const res = await runRulesCompiler(compiler, ['-p', project, '--pretty', 'false']);
-  if (res.error) throw new Error(`games/${g.id}: the rules type check could not finish: ${res.error.message}`);
+  if (res.error) throw new Error(`${g.kind === 'app' ? 'apps' : 'games'}/${g.id}: the rules type check could not finish: ${res.error.message}`);
   const messages = [];
   for (const line of `${res.stdout ?? ''}\n${res.stderr ?? ''}`.split(/\r?\n/)) {
     const at = /^(.+?)\((\d+),(\d+)\): error (TS\d+): (.*)$/.exec(line);
@@ -134,7 +134,9 @@ export async function typecheckRules(root, g, checked, tune, { log = () => {} }
       // Imported game helpers count too. Only the toolkit's own implementation is outside the author's remit.
       if (!file.startsWith(`${PACKAGE_ROOT}${sep}`) && !file.includes(`${sep}node_modules${sep}`) || file.startsWith(`${g.dir}${sep}`)) {
         const sourceLine = readFileSync(file,'utf8').split(/\r?\n/)[Number(at[2])-1] ?? '';
-        const advice = /Property 'ask'.*type 'never'/.test(at[5]) ? 'This handler scope never calls world.ask, so no answer can arrive here. Handle the answer in the scope that asks.'
+        const advice = /Property 'bot'.*RosterRow/.test(at[5]) ? "Rules roster rows use driver === 'bot' or 'ai' (not row.bot); preserve the visible AI label."
+          : /'[^']*\.at' is possibly 'undefined'/.test(at[5]) ? 'Effects carry either at (position) or id (entity). Check e.at before reading coordinates, or resolve e.id with room.get.'
+          : /Property 'ask'.*type 'never'/.test(at[5]) ? 'This handler scope never calls world.ask, so no answer can arrive here. Handle the answer in the scope that asks.'
           : /world\.round\.end/.test(sourceLine) && at[4] === 'TS2339' ? 'Only room handlers end a round. Send a declared event to a room handler that calls world.round.end().'
           : /'check'.*does not exist/.test(at[5]) ? 'Remove the obsolete check key. Generated observations require no exemption.'
           : /=> (?:GameDecision|GuideDecision)'/.test(at[5]) ? 'A floor returns goal and say names from agents.json with exactly the args and sayArgs each declares, or {} to decline. Forward a request as { goal: ask.k, args: ask.args }.'
@@ -150,7 +152,7 @@ export async function typecheckRules(root, g, checked, tune, { log = () => {} }
     } else if (/^error TS/.test(line)) messages.push(line);
     else if (/^\s+\S/.test(line) && messages.length) messages[messages.length - 1] += `\n${line.length > 360 ? line.slice(0, 220) + ' … ' + line.slice(-100) : line}`;
   }
-  if (messages.length) throw new Error(`games/${g.id}: its rules have type errors:\n${messages.slice(0, 30).map((m) => `  ${m}`).join('\n')}`);
-  if (res.status !== 0 && !res.stdout) throw new Error(`games/${g.id}: TypeScript stopped without diagnostics (${res.signal ?? res.status})`);
-  log(`types: games/${g.id}: rules, move and view checked with the toolkit's strict compiler`);
+  if (messages.length) throw new Error(`${g.kind === 'app' ? 'apps' : 'games'}/${g.id}: its rules have type errors:\n${messages.slice(0, 30).map((m) => `  ${m}`).join('\n')}`);
+  if (res.status !== 0 && !res.stdout) throw new Error(`${g.kind === 'app' ? 'apps' : 'games'}/${g.id}: TypeScript stopped without diagnostics (${res.signal ?? res.status})`);
+  log(`types: ${g.kind === 'app' ? 'apps' : 'games'}/${g.id}: rules, move and view checked with the toolkit's strict compiler`);
 }

package/netplay/NETPLAY.md

@@ -1,5 +1,13 @@
 # Homie netplay contract, v1 (revision 11)
 
+**Authoring now:** New games use rules plus view and the server as host. Read the
+Homie game skill's RULES.md and section 29 below. Sections 1–28 preserve the
+browser-hosted helper contract for existing games and describe shared shell
+features; their createNetplay/host-loop examples are not a recipe for new games.
+Use the skill's REWRITE.md for an owner-requested rewrite. All five starters use
+server rules. Room seats are capped at 32; larger rooms are future work.
+
+
 Status: **v1, revision 11** (2026-10-08, `@homie-rocks/studio` 0.33.1). The wire
 version is `v: 1`. Everything revisions 2 to 11 added is either an optional field, a new message type,
 a new refusal, or a change of pace inside the old caps, and both sides ignore types they do

package/netplay/netplay.ts

@@ -2628,6 +2628,9 @@ export function createNetplay<S = unknown, A = unknown, C = unknown>(opts: Netpl
       setRole(next, wasOffline && roleKnown ? 'reconnected' : String(m['why'] ?? 'welcome'), { ckpt, snap, round: roundInfo, roster: slots });
       if (next === 'host' && snap) tick = Math.max(tick, snap.k);
     }
+    // A reconnect to the same role emits no role event, but its welcome is a new
+    // connection's keyframe. Rules views must adopt it before the first delta.
+    if (rulesGame && snap && next !== 'host') emit('snapshot', snap);
     if (continuing) { rulesHost?.sync(rulesPeers()); reannounce(); catchUp(had, hadSeat); }
     if (link === 'online') paintLink(); else setLink('online', 'welcome');
     // A build older than the live one, let in to its own room (section 23).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homie-rocks/studio",
-  "version": "0.42.0",
+  "version": "0.44.0",
   "description": "A studio for games, music and video on its own Cloudflare: scaffold, multiplayer starters on the netplay contract, a port toolkit that makes existing single-player web games multiplayer, the site Worker with public rooms (Table/Lobby Durable Objects and D1, all on the free Workers plan, no payment method), a site with the hub's sections (Home, Games, Music, Videos, Rooms, Posts with feeds) in the studio's own look, an epic landing page for every game, big songs and videos in the studio's own R2 once it has storage (uploaded, checked by SHA-256, served at the same addresses), deploy, and the homie.rocks directory.",
   "type": "module",
   "license": "Apache-2.0",

package/rules/host.ts

@@ -2,8 +2,8 @@
  * host.ts — the host runtime: a rules module playing the host's part on the wire.
  * =============================================================================
  *
- * Today one player's browser is a room's host: it runs the rules and the clock and sends everybody the state. The host
- * runtime is that host with no browser in it. It takes a compiled rules module (rules.ts) and three things from its
+ * The server normally hosts the room: rules, clock and state. Browser hosting uses the same runtime
+ * for offline play, local development or private friends games. It takes a compiled rules module (rules.ts) and three things from its
  * caller: a way to send a frame, a clock and a store. It has no transport in it and no Cloudflare in it, in the style of
  * worker/room.mjs. Inside the `Table` (worker/index.mjs) the relay hands it parsed frames and fans out what it sends;
  * in Node the tests and the build check drive it with a clock of their own.
@@ -99,6 +99,7 @@ export interface Host {
   readonly running: boolean;
   readonly paused: boolean;
   readonly people: number;
+  readonly viewRadiusM: number | null;
   frame(m: Record<string, unknown>): void;
   /** Start the tick loop (the first person has joined). */
   start(): void;
@@ -767,6 +768,7 @@ export function createHost(o: HostOptions): Host {
   }
 
   return {
+    get viewRadiusM() { return c.settings.view?.radiusM ?? null; },
     get tick() { return core.tick; },
     get epoch() { return epoch; },
     get running() { return running; },

package/rules/interest.mjs

@@ -0,0 +1,79 @@
+/** Per-connection state delivery. Pure data, shared by the relay and the view.
+ * Deltas name a keyframe, never an unacknowledged previous delta. Losing a delta
+ * therefore loses no baseline. A new keyframe bounds recovery to one second.
+ * No history grows with time: one keyframe per connection, no per-frame queue.
+ */
+export function interestSnapshot(snap, seat, radiusM) {
+  const [round, entities] = snap.d;
+  const own = seat === null ? null : entities.find(e => e[9] === seat && e[10] === 0);
+  const visible = own && radiusM !== null ? entities.filter(e => {
+    const p = e[3], q = own[3];
+    return e === own || (p[0] - q[0]) ** 2 + (p[1] - q[1]) ** 2 + ((p[2] ?? 0) - (q[2] ?? 0)) ** 2 <= radiusM ** 2;
+  }) : seat === null ? entities : own ? entities : [];
+  return { ...snap, d: [round, visible], c: (snap.c ?? []).filter(row => row[0] === seat) };
+}
+
+export function snapshotEncoder(keyframeTicks) {
+  let base = null;
+  let rows = new Map();
+  return {
+    reset() { base = null; rows.clear(); },
+    encode(snap) {
+      if (!base || snap.e !== base.e || snap.k <= base.k || snap.k - base.k >= keyframeTicks) {
+        base = snap;
+        rows = new Map(snap.d[1].map(e => [e[0], e.map(v => JSON.stringify(v))]));
+        return snap;
+      }
+      const present = new Set(), changed = [];
+      for (const entity of snap.d[1]) {
+        const id = entity[0]; present.add(id);
+        const before = rows.get(id);
+        if (!before) { changed.push(entity); continue; }
+        let mask = 0; const values = [];
+        for (let i = 1; i < entity.length; i++) if (JSON.stringify(entity[i]) !== before[i]) { mask |= 1 << i; values.push(entity[i]); }
+        if (mask) changed.push([id, mask, values]);
+      }
+      return { ...snap, d: { base: base.k, round: snap.d[0], changed, removed: [...rows.keys()].filter(id => !present.has(id)) } };
+    },
+  };
+}
+
+export function snapshotDecoder() {
+  let base = null;
+  let rows = new Map();
+  return {
+    reset() { base = null; rows.clear(); },
+    decode(snap) {
+      if (!snap || typeof snap !== 'object') return null;
+      if (Array.isArray(snap.d)) {
+        if (!Array.isArray(snap.d[0]) || !Array.isArray(snap.d[1]) ||
+          !snap.d[1].every(e => Array.isArray(e) && e.length >= 9 && typeof e[0] === 'string')) return null;
+        // A late duplicate keyframe must not replace the newer baseline.
+        if (!base || snap.e !== base.e || snap.k >= base.k) {
+          base = snap; rows = new Map(snap.d[1].map(e => [e[0], e]));
+        }
+        return snap;
+      }
+      const d = snap.d;
+      if (!base || !d || d.base !== base.k || snap.e !== base.e || snap.k <= base.k) return null;
+      if (!Array.isArray(d.round) || !Array.isArray(d.removed) || !Array.isArray(d.changed)) return null;
+      const next = new Map(rows);
+      for (const id of d.removed) next.delete(id);
+      for (const change of d.changed) {
+        if (!Array.isArray(change) || typeof change[0] !== 'string') return null;
+        if (change.length !== 3) {
+          if (change.length < 9) return null;
+          next.set(change[0], change); continue;
+        }
+        if (!Number.isInteger(change[1]) || change[1] < 0 || !Array.isArray(change[2])) return null;
+        const old = rows.get(change[0]);
+        if (!old) return null;
+        const entity = old.slice(); let j = 0;
+        for (let i = 1; i < entity.length; i++) if (change[1] & (1 << i)) entity[i] = change[2][j++];
+        if (j !== change[2].length) return null;
+        next.set(entity[0], entity);
+      }
+      return { ...snap, d: [d.round, [...next.values()]] };
+    },
+  };
+}