@homie-rocks/studio 0.30.2 → 0.31.1

package/lib/template-history.json

@@ -1551,6 +1551,107 @@
      }
     }
    }
+  },
+  "0.31.0": {
+   "files": {
+    "CLAUDE.md": "ddf2b2a0376202f6",
+    "README.md": "684b3cca8001673c",
+    "HANDOFF.md": [
+     "29337e2ace95b2e7",
+     "ce7a8fd91c6bbee2"
+    ],
+    "games/README.md": "5ad32fe80c61f117",
+    "music/README.md": "a3dc042dadd39df8",
+    "videos/README.md": "16babc3437d5545b",
+    "posts/README.md": "37841aae476bd540",
+    "site/README.md": "732894273a32dc3f",
+    "site/src/worker.mjs": "ca3f1630f2420ad3"
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "214aa46eb3a895d5",
+     "## Layout": "8baf49e4291e7e88",
+     "## Commands (all through the pinned CLI in node_modules)": [
+      "29a04ed3d956610a",
+      "f25ef8c7dde1f5c2"
+     ],
+     "## The site": [
+      "0cb8dd9a6f8a0096",
+      "71bec10e44e5062f"
+     ],
+     "## Making games": [
+      "b0b921cb81b0cfbd",
+      "f52aa1c3566c0c19"
+     ],
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Art direction and models": [
+      "a48fff7bf0a5f2fc",
+      "aaea65236db52126"
+     ],
+     "## Running live games (the back office)": [
+      "4aa5f513a7cd2c3b",
+      "51ebf2ab756f6e4d"
+     ],
+     "## Servers and AI seats": "98d08705087a33ec",
+     "## Selling things (the shop)": "b04b0a2b25f524f2",
+     "## Continuing a build from the Claude app": "0d68081e924ca419",
+     "## Rules": "13617a3dd1a66be6",
+     "## Telling Homie": "80b46fdd9e578db8",
+     "## Beta": "9d02638207a26e73"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": [
+        "5d1c068adda1116b",
+        "a44e5bdd5425d5b6"
+       ]
+      }
+     }
+    }
+   }
+  },
+  "0.31.1": {
+   "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": "ca3f1630f2420ad3"
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "214aa46eb3a895d5",
+     "## Layout": "8baf49e4291e7e88",
+     "## Commands (all through the pinned CLI in node_modules)": "29a04ed3d956610a",
+     "## The site": "0cb8dd9a6f8a0096",
+     "## Making games": "2da7fa74c8884834",
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Art direction and models": "a48fff7bf0a5f2fc",
+     "## Running live games (the back office)": "51ebf2ab756f6e4d",
+     "## Servers and AI seats": "98d08705087a33ec",
+     "## Selling things (the shop)": "b04b0a2b25f524f2",
+     "## 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)": "5d1c068adda1116b"
+      }
+     }
+    }
+   }
   }
  }
 }

package/lib/trailer.mjs

@@ -0,0 +1,47 @@
+/**
+ * `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,
+ * 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>).
+ *
+ * The skills are looked for where the MCP server looks: --skills <folder>, HOMIE_SKILLS, beside this package in the
+ * repository (plugins/homie/skills), or beside it in the plugin (../skills). When none is there, it says so and
+ * says what to install, instead of pretending there is a trailer tool in this package alone.
+ */
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { PACKAGE_ROOT } from './studio.mjs';
+
+export function trailerScript(skills = null) {
+  const dirs = [skills, process.env.HOMIE_SKILLS, join(PACKAGE_ROOT, '..', '..', 'plugins', 'homie', 'skills'), join(PACKAGE_ROOT, '..', 'skills')].filter(Boolean).map((d) => resolve(String(d)));
+  return dirs.map((d) => join(d, 'video', 'scripts', 'video.mjs')).find((f) => existsSync(f)) ?? null;
+}
+
+/** `rest` is every word after the game's id, as typed: it goes to the script unchanged. */
+export function trailerCommand(root, id, rest, { skills = null, slug = null } = {}) {
+  if (!id || !/^[a-z0-9][a-z0-9-]{0,39}$/.test(String(id))) return { ok: false, command: 'trailer', why: 'usage: homie-studio trailer <game id> [--url <site>] [--seconds 40] [--length 20] [--title "…"] [--end "…"] (the site: http://127.0.0.1:8787 while `homie-studio dev` runs)' };
+  const script = trailerScript(skills);
+  if (!script) return { ok: false, command: 'trailer', why: 'the trailer tool is the Homie plugin\'s video skill, and its scripts are not on this computer where this package looks. Install the plugin (the studio\'s AGENTS.md says how), or point at its skills folder: homie-studio trailer <id> --skills <the plugin\'s skills folder>' };
+  const pass = [];
+  for (let i = 0; i < rest.length; i++) {
+    if (rest[i] === '--skills' || rest[i] === '--slug') { i++; continue; }
+    if (rest[i] === '--json' || rest[i].startsWith('--skills=') || rest[i].startsWith('--slug=')) continue;
+    pass.push(rest[i]);
+  }
+  const r = spawnSync(process.execPath, [script, 'trailer', String(slug ?? `${id}-trailer`), '--game', String(id), ...pass, '--json'], { cwd: root, encoding: 'utf8', stdio: ['ignore', 'pipe', 'inherit'], timeout: 90 * 60_000, maxBuffer: 64 * 1024 * 1024 });
+  try { return { ...JSON.parse(r.stdout), command: 'trailer' }; } catch { return { ok: false, command: 'trailer', why: `the video skill's script gave no result (${(r.stdout ?? '').trim().split('\n').pop() || `exit ${r.status}`})` }; }
+}
+
+export function trailerLines(r) {
+  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'}`,
+    `  ${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

@@ -0,0 +1,107 @@
+/**
+ * `homie-studio build --types` — the games' TypeScript, checked before anything is built.
+ *
+ * The build bundles with esbuild, which strips types and never reads them: `const hp: number = "full"` builds and
+ * ships. This is the check a creator's agent would otherwise have no way to run, because a studio had no TypeScript
+ * of its own to run `npx tsc` with.
+ *
+ *   - The compiler is the STUDIO'S OWN (`typescript` in its node_modules, which a new studio's package.json asks
+ *     for). @homie-rocks/studio does not depend on it: the check is something a studio opts into, and a studio that
+ *     never does pays nothing for it. Without it the command stops and says the one line that installs it.
+ *   - A game with a tsconfig.json of its own is checked with it. Any other game is checked the way esbuild reads
+ *     it: its entry and whatever that imports, as ES2022 for a browser, strictly, with the pictures, sounds and
+ *     models it imports as addresses (the build's own loaders).
+ *   - Only errors in the game's own files stop the build. A game imports the toolkit's helpers as TypeScript
+ *     source, and a creator can do nothing about a line in node_modules; those are counted and said, never fatal.
+ *
+ * Never run unasked: a plain `build` is exactly as fast as it was.
+ */
+import { spawnSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+
+/** What the build's file loaders turn into an address (lib/build.mjs LOADERS): an import of one is a string. */
+const ADDRESSES = ['png', 'jpg', 'jpeg', 'gif', 'webp', 'mp3', 'ogg', 'wav', 'm4a', 'glb', 'gltf', 'bin', 'hdr', 'svg', 'woff2', 'ttf'];
+const AMBIENT = `// Written by homie-studio build --types: what the build's loaders give an import of each kind of file.\n${ADDRESSES.map((x) => `declare module '*.${x}' { const address: string; export default address; }`).join('\n')}\n`;
+
+/** How a game with no tsconfig.json of its own is read: as the build reads it. */
+const OPTIONS = {
+  target: 'ES2022', module: 'ESNext', moduleResolution: 'Bundler', lib: ['ES2022', 'DOM', 'DOM.Iterable'],
+  strict: true, noEmit: true, skipLibCheck: true, allowImportingTsExtensions: true, resolveJsonModule: true,
+  isolatedModules: true, allowJs: true, checkJs: false, useDefineForClassFields: true,
+  // A studio's node_modules has Node's types (its tools bring them); a game runs in a browser, where a timer is a number.
+  types: [],
+};
+
+/** The studio's own TypeScript: { tsc, version }, or null when it has none. */
+export function studioTypescript(root) {
+  try {
+    const pkg = createRequire(join(root, 'package.json')).resolve('typescript/package.json');
+    const tsc = join(dirname(pkg), 'bin', 'tsc');
+    return existsSync(tsc) ? { tsc, version: JSON.parse(readFileSync(pkg, 'utf8')).version ?? null } : null;
+  } catch { return null; }
+}
+
+export const NO_TYPESCRIPT = 'build --types checks the games\' TypeScript with the studio\'s own compiler, and this studio has none: run `npm install --save-dev typescript` in the studio, then build --types again (a plain build never needs it)';
+
+/** The TypeScript a game's build starts from, or null (a plain-JavaScript game, or one with its own build). */
+function entryOf(g) {
+  const mode = g.build?.mode ?? 'bundle';
+  if (mode === 'command') return null;
+  const entry = mode === 'static' ? g.entry : (g.entry ?? 'src/main.ts');
+  return typeof entry === 'string' && /\.(ts|tsx|mts)$/i.test(entry) && existsSync(join(g.dir, entry)) ? entry : null;
+}
+
+/**
+ * Check every game given. Returns { typescript, games: [{ id, checked, with, errors, elsewhere, why }] } when none
+ * of them has a type error in its own files; throws (so the command fails and nothing is built) when one has, with
+ * the first errors as `file:line:column TS1234 message`, or when the studio has no TypeScript.
+ */
+export function typecheck(root, games, { log = () => {} } = {}) {
+  const ts = studioTypescript(root);
+  if (!ts) throw new Error(NO_TYPESCRIPT);
+  const rows = [];
+  const found = [];
+  for (const g of games) {
+    const entry = entryOf(g);
+    if (!entry) { rows.push({ id: g.id, checked: false, why: (g.build?.mode ?? 'bundle') === 'command' ? 'it has a build of its own' : 'no TypeScript entry' }); continue; }
+    let project = join(g.dir, 'tsconfig.json');
+    const own = existsSync(project);
+    if (!own) {
+      const dir = join(root, '.studio', 'types', g.id);
+      mkdirSync(dir, { recursive: true });
+      writeFileSync(join(dir, 'files.d.ts'), AMBIENT);
+      project = join(dir, 'tsconfig.json');
+      writeFileSync(project, `${JSON.stringify({ compilerOptions: OPTIONS, files: [join(g.dir, entry), join(dir, 'files.d.ts')] }, null, 2)}\n`);
+    }
+    const res = spawnSync(process.execPath, [ts.tsc, '-p', project, '--noEmit', '--pretty', 'false'], { cwd: root, encoding: 'utf8', timeout: 5 * 60_000, maxBuffer: 64 * 1024 * 1024 });
+    if (res.error) throw new Error(`build --types could not run TypeScript ${ts.version ?? ''}: ${res.error.message}`);
+    let home = g.dir;
+    try { home = realpathSync(g.dir); } catch { /* keep */ }
+    const mine = [];
+    let elsewhere = 0;
+    for (const line of `${res.stdout ?? ''}\n${res.stderr ?? ''}`.split(/\r?\n/)) {
+      const at = /^(.+?)\((\d+),(\d+)\): error (TS\d+): (.*)$/.exec(line);
+      if (at) {
+        let file = isAbsolute(at[1]) ? at[1] : resolve(root, at[1]);
+        try { file = realpathSync(file); } catch { /* keep */ }
+        if (file.startsWith(`${home}${sep}`)) mine.push(`${relative(root, g.dir).split(sep).join('/')}/${relative(home, file).split(sep).join('/')}:${at[2]}:${at[3]} ${at[4]} ${at[5]}`);
+        else elsewhere += 1;
+        continue;
+      }
+      // 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]}`);
+    }
+    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 (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'})`);
+  }
+  if (found.length) {
+    const shown = found.slice(0, 20);
+    throw new Error(`${found.length} type ${found.length === 1 ? 'error' : 'errors'} (build --types); nothing was built:\n${shown.map((e) => `  ${e}`).join('\n')}${found.length > shown.length ? `\n  … and ${found.length - shown.length} more` : ''}`);
+  }
+  return { typescript: ts.version, games: rows };
+}

package/mcp/ui/lineup.js

@@ -21,14 +21,14 @@
     var list = C.el('ul', 'list');
     (sc.rows || []).forEach(function (r) {
       var li = C.el('li', r.flags.length ? 'now' : 'done');
-      li.appendChild(C.add(C.el('div', 'cb'), C.el('b', '', r.label + (r.size ? ' · ' + r.size[1] + ' m' : '')), C.el('span', '', r.kind + ', ' + r.route + (r.drift ? (r.drift.repaint ? ' · repainted from style.json in the game' : ' · palette distance ' + r.drift.mean) : '')), r.flags.length ? C.el('span', 'fix', r.flags.join(' · ')) : null));
+      li.appendChild(C.add(C.el('div', 'cb'), C.el('b', '', r.label + (r.size ? ' · ' + r.size[1] + ' m' : '')), C.el('span', '', r.kind + ', ' + r.route + (r.usage === 'unused' ? ' · unused (not drawn by the game)' : '') + (r.drift ? (r.drift.repaint ? ' · repainted from style.json in the game' : ' · palette distance ' + r.drift.mean) : '')), r.flags.length ? C.el('span', 'fix', r.flags.join(' · ')) : null));
       li.appendChild(C.pill(r.flags.length ? r.flags.length + ' flag' + (r.flags.length === 1 ? '' : 's') : 'Fits', r.flags.length ? 'warn' : 'ok'));
       list.appendChild(li);
     });
     card.appendChild(list);
     if (sc.totals && sc.budgets) {
-      card.appendChild(C.el('h2', '', 'Phone budgets, the whole scene'));
-      [bar('Draw calls', sc.totals.drawCalls, sc.budgets.drawCalls), bar('Triangles', sc.totals.triangles, sc.budgets.triangles), bar('Picture memory', sc.totals.textureMB, sc.budgets.textureMB, ' MB'), bar('First play', sc.totals.firstPlayMB, sc.budgets.firstPlayMB, ' MB')].forEach(function (b) { if (b) card.appendChild(b); });
+      card.appendChild(C.el('h2', '', 'Phone budgets: an estimate from the recorded files'));
+      [bar('Draw calls', sc.totals.drawCalls, sc.budgets.drawCalls), bar('Triangles', sc.totals.triangles, sc.budgets.triangles), bar('Picture memory', sc.totals.textureMB, sc.budgets.textureMB, ' MB'), bar('Shipped payload', sc.totals.firstPlayMB, sc.budgets.firstPlayMB, ' MB')].forEach(function (b) { if (b) card.appendChild(b); });
     }
   }
   function make(card, sc) {

package/mcp/ui/rights.js

@@ -1,8 +1,7 @@
 /* The rights card: every asset's licence in plain words (asset_rights): where it came from, its licence, the credit it
- * owes, what a remixer gets; what would stop a public game from publishing, with its fix; and RIGHTS.md itself. */
+ * owes; what would stop a public game from publishing, with its fix; and RIGHTS.md itself. */
 (function () {
   var C = Card;
-  var REMIX = { include: 'A remix gets it', reference: 'A remix fetches it from its origin', none: 'A remix gets a placeholder' };
   var LICENCE = { cc0: 'CC0 (public domain)', 'cc-by-4.0': 'CC BY 4.0', 'cc-by-3.0': 'CC BY 3.0', own: 'Your own work', generated: 'Generated on your account', qal: 'Quaternius licence', mixamo: 'Mixamo', other: 'Other' };
   function render(sc) {
     var card = C.el('main', 'card');
@@ -12,7 +11,6 @@
     (sc.rows || []).forEach(function (r) {
       var li = C.el('li', r.license ? 'done' : 'now');
       li.appendChild(C.add(C.el('div', 'cb'), C.el('b', '', r.id + ' · ' + r.kind), C.el('span', '', (LICENCE[r.license] || r.license || 'NO LICENCE RECORDED') + ' · ' + r.route + (r.from ? ' (' + r.from + ')' : '') + (r.placeholder ? ' · a placeholder' : '')), r.attribution ? C.el('span', 'fix', 'Credit: ' + r.attribution) : null));
-      li.appendChild(C.pill(REMIX[r.remix] || 'No remix rule', r.remix === 'include' ? 'ok' : 'warn'));
       list.appendChild(li);
     });
     card.appendChild(list);