@homie-rocks/studio 0.26.1 → 0.28.0

package/lib/site.mjs

@@ -378,6 +378,20 @@ export function landingOf(g, out, { videos = [], songs = [], log = () => {} } =
   }
   if (!hero.wideImage) hero.wideImage = (trailer && hero.fromTrailer ? fileUrl(trailer, 'poster') : null) ?? cover;
   for (const k of Object.keys(hero)) if (!hero[k]) delete hero[k];
+  // Screenshots (0.27.0): game.json landing.screenshots (paths in the game's folder), else the pictures in
+  // games/<id>/screenshots/, by name; at most eight. The landing shows them and its VideoGame names them.
+  let screenshots = [];
+  if (Array.isArray(L.screenshots)) {
+    screenshots = L.screenshots.slice(0, 8).map((rel) => {
+      const abs = typeof rel === 'string' && IMAGE.test(rel) ? inside(g.dir, rel) : null;
+      const url = abs ? serve(abs, `screenshot ${rel}`) : null;
+      if (!url) log(`warning: games/${g.id}/game.json landing.screenshots "${String(rel).slice(0, 60)}" is not a picture in the game's folder`);
+      return url;
+    }).filter(Boolean);
+  } else if (existsSync(join(g.dir, 'screenshots')) && statSync(join(g.dir, 'screenshots')).isDirectory()) {
+    screenshots = readdirSync(join(g.dir, 'screenshots')).filter((n) => IMAGE.test(n) && !n.startsWith('.')).sort().slice(0, 8)
+      .map((n) => serve(join(g.dir, 'screenshots', n), `screenshots/${n}`)).filter(Boolean);
+  }
   const focus = /^\d{1,3}% \d{1,3}%$/.test(String(H.focus ?? '')) ? String(H.focus) : null;
   const tint = Number.isFinite(Number(H.tint)) && H.tint !== null && H.tint !== '' ? Math.max(0, Math.min(80, Math.round(Number(H.tint)))) : null;
   const alt = str(H.alt, 300);
@@ -446,6 +460,7 @@ export function landingOf(g, out, { videos = [], songs = [], log = () => {} } =
     hero: { ...hero, ...(focus ? { focus } : {}), ...(alt ? { alt } : {}), ...(tint !== null ? { tint } : {}) },
     headline: str(L.headline, 120),
     cover,
+    ...(screenshots.length ? { screenshots } : {}),
     words: words && (words.one || words.many) ? words : null,
     credits: { people, original, parts, texts: texts.length },
     trailer: trailer ? trailer.slug : null,

package/lib/template-history.json

@@ -1312,6 +1312,85 @@
      }
     }
    }
+  },
+  "0.27.0": {
+   "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": "2928ca4f079ab76b",
+    "site/src/worker.mjs": "ca3f1630f2420ad3"
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "214aa46eb3a895d5",
+     "## Layout": "8baf49e4291e7e88",
+     "## Commands (all through the pinned CLI in node_modules)": "d80ec56e4b4fc4c6",
+     "## The site": "366ecce1a424837a",
+     "## Making games": "abf2f0d59341512d",
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Art direction and models": "aaea65236db52126",
+     "## Running live games (the back office)": "4aa5f513a7cd2c3b",
+     "## Servers and AI seats": "98d08705087a33ec",
+     "## Selling things (the shop)": "b04b0a2b25f524f2",
+     "## Continuing a build from the Claude app": "0d68081e924ca419",
+     "## Rules": "7e8458adc1b81ece",
+     "## Beta": "9d02638207a26e73"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "b35df2c19cd4b534"
+      }
+     }
+    }
+   }
+  },
+  "0.28.0": {
+   "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": "2928ca4f079ab76b",
+    "site/src/worker.mjs": "ca3f1630f2420ad3"
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "214aa46eb3a895d5",
+     "## Layout": "8baf49e4291e7e88",
+     "## Commands (all through the pinned CLI in node_modules)": "d80ec56e4b4fc4c6",
+     "## The site": "366ecce1a424837a",
+     "## Making games": "abf2f0d59341512d",
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Art direction and models": "aaea65236db52126",
+     "## Running live games (the back office)": "4aa5f513a7cd2c3b",
+     "## Servers and AI seats": "98d08705087a33ec",
+     "## Selling things (the shop)": "b04b0a2b25f524f2",
+     "## Continuing a build from the Claude app": "0d68081e924ca419",
+     "## Rules": "7e8458adc1b81ece",
+     "## Telling Homie": "80b46fdd9e578db8",
+     "## Beta": "9d02638207a26e73"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "b35df2c19cd4b534"
+      }
+     }
+    }
+   }
   }
  }
 }

package/mcp/ui/card.css

@@ -92,3 +92,11 @@ details summary{cursor:pointer;color:var(--c-fg2);font-size:13px;margin-top:10px
 .clips{display:grid;grid-template-columns:repeat(auto-fill,minmax(104px,1fr));gap:8px}
 .clip{display:grid;gap:3px;align-content:start;padding:6px;border-radius:var(--r-sm);background:var(--c-bg)}.clip .art{aspect-ratio:1;border-radius:var(--r-sm);background:var(--c-bg3);display:grid;place-items:center;overflow:hidden;color:var(--c-fg3);font-size:20px}.clip .art img{width:100%;height:100%;object-fit:cover}
 .clip b{font-size:13px}.clip span{font-size:11.5px;color:var(--c-fg2);overflow-wrap:anywhere}.clip.missing{opacity:.8;box-shadow:inset 0 0 0 1px var(--c-line2)}.clip button{justify-self:start}
+/* Tell Homie (feedback.js): the note as it would go, and the editor that rewords it. */
+.quote{margin:8px 0 0;padding:12px 14px;border-radius:var(--r-md);background:var(--c-bg2);border-left:3px solid var(--accent);font:15px/1.5 var(--f-sans);color:var(--c-fg);white-space:normal;overflow-wrap:anywhere}
+.kinds{display:flex;flex-wrap:wrap;gap:6px;margin:4px 0 10px}
+textarea{display:block;width:100%;min-height:110px;resize:vertical;font:15px/1.45 var(--f-sans);padding:10px 12px;border-radius:var(--r-md);border:1px solid var(--c-line2);background:var(--c-bg);color:var(--c-fg)}
+input[type=email]{display:block;width:100%;margin:8px 0 12px;font:14px/1.2 var(--f-sans);padding:9px 10px;border-radius:var(--r-sm);border:1px solid var(--c-line2);background:var(--c-bg);color:var(--c-fg)}
+textarea:focus-visible,input[type=email]:focus-visible{outline:2px solid var(--c-fg);outline-offset:1px}
+.actions.send{margin-top:14px}
+@media (max-width:420px){.actions.send button{flex:1 1 auto}}

package/mcp/ui/feedback.js

@@ -0,0 +1,112 @@
+/* The Tell Homie card: a note to the people who make Homie, exactly as it would go, with Send, Edit and Don't send.
+ * Nothing leaves this computer until the person presses Send here (or says yes in the chat). Edit drafts the note
+ * again from the person's own words, through the same redaction, so what the card shows is always what would go.
+ * The model is told what the person chose, once. Every text is set as text, never as HTML. */
+(function () {
+  var C = Card;
+  var KINDS = [['stuck', 'Stuck'], ['confusing', 'Confusing'], ['idea', 'Idea'], ['praise', 'Praise'], ['bug', 'Bug']];
+  var LABEL = { stuck: 'Stuck', confusing: 'Confusing', idea: 'Idea', praise: 'Praise', bug: 'Bug' };
+  var ui = { editing: false, busy: false, why: null, kind: null, text: null, email: null };
+
+  function fieldsOf(sc) {
+    var n = sc.note || {};
+    return { kind: n.kind, text: n.text, step: n.step || undefined, email: n.email || undefined, offered: n.offered === true,
+      studioVersion: n.studioVersion || undefined, pluginVersion: n.pluginVersion || undefined, app: n.app || undefined,
+      // The studio the draft was made for (its pinned version is in the note): a send is checked against the same one.
+      studio: sc.studio || undefined };
+  }
+
+  function act(sc, args, after) {
+    if (ui.busy) return;
+    ui.busy = true; ui.why = null; C.render();
+    C.call('homie_feedback', args).then(function (res) {
+      ui.busy = false;
+      // Refused (not sent, a reworded note that cannot go, the app said no): the note stays on screen with why.
+      var d = res && res.structuredContent;
+      if (!d || d.kind !== 'feedback' || res.isError) { ui.why = C.textOf(res) || 'That did not work. Nothing was sent.'; C.render(); return; }
+      if (after) after(res);
+      C.take(res);
+    }).catch(function () { ui.busy = false; ui.why = 'The app did not answer. Nothing was sent.'; C.render(); });
+  }
+
+  function quote(text) {
+    var q = C.el('blockquote', 'quote');
+    String(text || '').split('\n').forEach(function (line, i) { if (i) q.appendChild(C.el('br')); q.appendChild(document.createTextNode(line)); });
+    return q;
+  }
+
+  function editor(card, sc) {
+    var n = sc.note || {};
+    if (ui.kind === null) { ui.kind = n.kind || 'idea'; ui.text = n.text || ''; ui.email = n.email || ''; }
+    var kinds = C.el('div', 'kinds'); kinds.setAttribute('role', 'radiogroup'); kinds.setAttribute('aria-label', 'What kind of note');
+    KINDS.forEach(function (k) {
+      var b = C.btn(k[1], 'small ' + (ui.kind === k[0] ? '' : 'ghost'), function () { ui.kind = k[0]; C.render(); });
+      b.setAttribute('role', 'radio'); b.setAttribute('aria-checked', ui.kind === k[0] ? 'true' : 'false');
+      kinds.appendChild(b);
+    });
+    card.appendChild(kinds);
+    var area = C.el('textarea'); area.value = ui.text; area.rows = 5; area.maxLength = 1500; area.setAttribute('aria-label', 'Your note, in your words');
+    area.oninput = function () { ui.text = area.value; };
+    card.appendChild(area);
+    var mail = C.el('input'); mail.type = 'email'; mail.placeholder = 'Your email, if you want a reply (optional)'; mail.value = ui.email; mail.setAttribute('aria-label', 'Reply address (optional)');
+    mail.oninput = function () { ui.email = mail.value; };
+    card.appendChild(mail);
+    var acts = C.el('div', 'actions');
+    acts.appendChild(C.btn(ui.busy ? 'Saving…' : 'Use this', '', function () {
+      var f = fieldsOf(sc);
+      act(sc, { action: 'draft', kind: ui.kind, text: ui.text, step: f.step, email: (ui.email || '').trim() || undefined, offered: f.offered, studioVersion: f.studioVersion, pluginVersion: f.pluginVersion, app: f.app, studio: f.studio, by: 'card' }, function (res) {
+        ui.editing = false; ui.kind = null;
+        var d = res && res.structuredContent;
+        if (d && d.state === 'draft') C.tell('edit:' + d.draft, 'The person reworded the note on the Tell Homie card. Nothing is sent yet; the card shows the new text (draft ' + d.draft + ') with Send. Do not send it yourself unless they say yes.');
+      });
+    }));
+    acts.appendChild(C.btn('Cancel', 'ghost', function () { ui.editing = false; ui.kind = null; C.render(); }));
+    card.appendChild(acts);
+  }
+
+  function render(sc) {
+    var card = C.el('main', 'card');
+    var state = sc.state;
+    var head = state === 'sent' ? C.pill('Sent', 'ok') : state === 'declined' ? C.pill('Not sent', '') : state === 'draft' ? C.pill('Not sent yet', 'warn') : C.pill('Not sent', 'bad');
+    C.add(card, C.top('Note', head));
+    card.appendChild(C.el('h1', '', state === 'sent' ? 'Sent to Homie. Thank you.' : state === 'declined' ? 'Not sent' : 'A note to the people who make Homie'));
+    var n = sc.note;
+    if (state === 'draft' && ui.editing) { editor(card, sc); }
+    else if (n) {
+      card.appendChild(C.el('p', 'sub', state === 'sent' ? 'This is what they got:' : state === 'declined' ? 'Nothing left this computer. This was the note:' : 'This is exactly what would go:'));
+      card.appendChild(C.add(C.el('div', 'chips'), C.pill(LABEL[n.kind] || n.kind, 'live')));
+      card.appendChild(quote(n.text));
+      if (sc.with) card.appendChild(C.el('p', 'fine', 'With it: ' + sc.with));
+      if (sc.taken && sc.taken.length) card.appendChild(C.el('p', 'fine', 'Homie took out ' + sc.taken.join(', ') + ' before showing it here.'));
+    }
+    if (ui.why) card.appendChild(C.el('p', 'note bad', ui.why));
+    if (state === 'draft' && !ui.editing) {
+      var acts = C.el('div', 'actions send');
+      var send = C.btn(ui.busy ? 'Sending…' : 'Send', '', function () {
+        act(sc, Object.assign({ action: 'send', draft: sc.draft, by: 'card' }, fieldsOf(sc)), function (res) {
+          var d = res && res.structuredContent;
+          if (d && d.state === 'sent') C.tell('sent:' + sc.draft, 'The person pressed Send on the Tell Homie card: the note went to Homie (reference ' + String(d.reference || '').slice(0, 8) + '). Thank them in one line, and do not offer another note in this session.');
+        });
+      });
+      send.disabled = ui.busy;
+      acts.appendChild(send);
+      var edit = C.btn('Edit', 'ghost', function () { ui.editing = true; ui.kind = null; C.render(); }); edit.disabled = ui.busy;
+      acts.appendChild(edit);
+      var no = C.btn('Don’t send', 'ghost', function () {
+        act(sc, { action: 'decline', draft: sc.draft, by: 'card' }, function () {
+          C.tell('declined:' + sc.draft, 'The person pressed Don’t send on the Tell Homie card. Nothing was sent. Do not offer to send a note again in this session.');
+        });
+      });
+      no.disabled = ui.busy;
+      acts.appendChild(no);
+      card.appendChild(acts);
+    }
+    if (state === 'sent' && sc.reference) card.appendChild(C.el('p', 'fine', 'Reference ' + String(sc.reference).slice(0, 8) + '. Notes are private: only the people who make Homie read them.'));
+    var foot = C.el('div', 'foot');
+    foot.appendChild(C.el('span', 'when', state === 'sent' ? 'Sent to ' + (sc.to || 'homie.rocks') : state === 'declined' ? 'Nothing was sent.' : 'Nothing is sent until you press Send. Goes to ' + (sc.to || 'homie.rocks') + ', privately.'));
+    card.appendChild(foot);
+    return card;
+  }
+
+  C.start({ kind: 'feedback', label: 'Note', render: render, poll: null });
+})();

package/media/MEDIA.md

@@ -25,6 +25,7 @@ show and why anything is left out.
       "title": "Night Owls Theme",
       "blurb": "The studio's theme: a short sung hook over a driving synth line.",
       "published": true,
+      "date": "2026-09-30",
       "duration": 16.0,
       "bpm": 120,
       "key": "A minor",
@@ -57,6 +58,10 @@ show and why anything is left out.
   `poster`, `captions` (WebVTT), `master`. `"public": false` keeps a file off the site (masters,
   raw captures). Loops and stems are offered for download on the song page, so another game can
   use them.
+- `date` (0.27.0): the day (or day and time, UTC) it came out; without one, `made.at`. A video's page gives it to
+  search engines as the video's upload date, and they show no video without one (the build says when a video has
+  neither). A music manifest's top-level `"album": "Night Route"` (or an entry's own `album`) makes its songs one
+  album in the pages' structured data (site/SITE.md, "Search engines and AI agents").
 - `rights` and `credits` are shown on the page, in plain words. Say what the provider's terms
   say for the plan the file was made on; nothing on the site claims more.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homie-rocks/studio",
-  "version": "0.26.1",
+  "version": "0.28.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/site/SITE.md

@@ -97,10 +97,17 @@ game.json's `landing` block, every key optional:
   "credits": [{ "role": "Music", "name": "Low Tide", "url": "https://example.com" }],
   "theme": { "accent": "#ff3bd4", "glow": "#00eaff" },
   "scheme": "light",
+  "screenshots": ["shots/rocks.jpg", "shots/finish.jpg"],
   "tv": true
 }
 ```
 
+**Screenshots** (0.27.0): `landing.screenshots` (pictures in the game's folder), else every picture in
+`games/<id>/screenshots/` by name, at most eight. The landing shows them in a band of their own, and its VideoGame
+names them. Beside the `landing` block, game.json takes `"genre"` (a word, or up to three: `["Racing", "Party"]`,
+shown with the room facts), `"released"` (the day it came out, else the commit that added its game.json) and
+`"schema"` (structured data of the owner's own: [Search engines and AI agents](#search-engines-and-ai-agents)).
+
 ## Posts: `posts/*.md`
 
 One markdown file each. The name is the address, `posts/2026-09-30-we-are-live.md` is `/posts/we-are-live/`, dated
@@ -141,8 +148,8 @@ atproto later. `/.well-known/homie-studio.json` lists the latest posts for the h
 | `site/theme.json` | The tokens every page uses: `bg`, `fg`, `accent`, `glow`, `panel`, `accentInk` (colours: `#hex`, `rgb()`, `hsl()`, `oklch()`), `display`, `text`, `mono` (font lists), `fonts` (`[{ "family", "src": "/fonts/x.woff2", "weight": "400 800" }]`, files in `site/public`), `radius` (0 to 40), `mark` (a logo), `icon`, `social` (the share picture), `wordmark`, `uppercase: false`, `scheme: "light"`. Or `palette`: neon, dock, gold, acid, ember, orchid, tide, candy. A value that is not what it should be is dropped, with a warning. |
 | `site/theme.css` | CSS after the site's own, on every generated page: restyle anything. |
 | `site/partials/<name>.html` | A piece of every generated page: `head` (in `<head>`), `header` (the top line and its tabs), `footer` (the "Made with Homie" footer), `home` (a band on Home), `game` (a band on every landing), `game-<id>` (a band on one), `post` (after a post). `{{studio.name}}`, `{{game.name}}`, `{{game.id}}`, `{{game.play}}`, `{{year}}` are filled in. A band partial sits in one of the page's bands, unless it is its own `<section class="band">`. |
-| `site/pages/<path>/index.html` (or `site/pages/<path>.html`) | A whole page at `/<path>/`, served as it is, instead of the generated one (`site/pages/index.html` is Home, `site/pages/<id>/index.html` a game's landing) or beside them (`/about/`). It may borrow the site's parts: `<!-- homie:style -->`, `<!-- homie:header -->`, `<!-- homie:footer -->`, `<!-- homie:script -->`. The rooms, the game files, the API and the owner's pages are never a page's. |
-| `site/public/` | Files served as they are at the same path: fonts, a logo, hero footage, a page's pictures. |
+| `site/pages/<path>/index.html` (or `site/pages/<path>.html`) | A whole page at `/<path>/`, served as it is, instead of the generated one (`site/pages/index.html` is Home, `site/pages/<id>/index.html` a game's landing) or beside them (`/about/`). It may borrow the site's parts: `<!-- homie:style -->`, `<!-- homie:header -->`, `<!-- homie:footer -->`, `<!-- homie:script -->`, and in its `<head>` `<!-- homie:schema -->` (the structured data the generated page there would carry: Home's, a landing's, else the studio's Organization). The rooms, the game files, the API and the owner's pages are never a page's. |
+| `site/public/` | Files served as they are at the same path: fonts, a logo, hero footage, a page's pictures. A `robots.txt`, `sitemap.xml`, `llms.txt` or `llms-full.txt` here replaces the one the site makes. |
 | `site/src/worker.mjs` | The Worker. A studio that keeps a whole brand site of its own (with its own routes) wraps the template's Worker here, as the house brands do; everything it does not answer goes to the template. |
 
 A studio with its own landing in `site/` keeps it: the template never replaces what the studio made.
@@ -306,6 +313,64 @@ goes there as a POST. The site answers at its root and under every game with `{
 "not-a-homie" }` (JSON, CORS-open, 200, a preflight answered), so the game stops asking and plays on its own; no
 studio needs a Worker of its own for it.
 
+## Search engines and AI agents
+
+From 0.27.0 the site tells search engines and AI agents what it is, from its own files, and nothing more
+(worker/schema.mjs, worker/discover.mjs).
+
+**Structured data.** Every generated page carries one `<script type="application/ld+json">` in its `<head>`, a
+schema.org `@graph`:
+
+| Page | Types |
+| --- | --- |
+| Home | `Organization` (the studio: name, address, `site/theme.json` `mark` as its logo, `social` as its image, the tagline) and `WebSite` |
+| `/games/`, `/rooms/` | `BreadcrumbList`, `ItemList` of the public games' landings (the Rooms page's data never carries a live count) |
+| `/<id>/` | `BreadcrumbList`, `VideoGame` co-typed `WebApplication`: name, description, the pitch as `abstract`, its pictures and screenshots, `genre`, `numberOfPlayers` (min and max), `playMode`, `gamePlatform`, the studio as author and publisher, `license` (the source's licence, linked to its SPDX page), `isBasedOn` (a remix's original page, a port's original), `trailer` (a `VideoObject`), `datePublished` and `dateModified`, a `PlayAction`, and one free-to-play `Offer` (price 0) |
+| `/<id>/credits`, `/<id>/servers/`, a server's page | `BreadcrumbList` |
+| `/music/`, `/music/<slug>/` | `MusicAlbum` (every song names one album) or an `ItemList`; `MusicRecording` (`byArtist` the studio, its duration, its `AudioObject`, its cover, `inAlbum`, `musicalKey`, its date) |
+| `/videos/`, `/videos/<slug>/` | `ItemList`; `VideoObject` (`thumbnailUrl`, `uploadDate`, `duration`, `contentUrl`: the file at its own address, from R2 or the site) |
+| `/posts/`, `/posts/<slug>/` | `Blog`; `BlogPosting` (headline, dates, the author it names or the studio, the publisher, its picture, the game it is about) |
+
+Never: a rating or a review (the page shows none), a price for anything the shop does not sell, or a number that is
+only true this minute. While the studio's shop really sells (shop/SHOP.md: shop.json checked, its key, webhook
+secret and tables in place), each item sold in a game is an `addOn` of that game's free offer, in real money; a tip
+has no price and is left out. A game that is not public yet (private, or an invite-only beta) offers nothing, and its
+landing answers `x-robots-tag: noindex`.
+
+A video's `uploadDate` is its manifest entry's `"date"`, else `made.at`; a video with neither is said by the build,
+because search engines show no video without it. A song's date is the same, and a music manifest's `"album"` (or an
+entry's own) makes the songs a `MusicAlbum`. A game's `datePublished` is game.json `"released"`, else the commit that
+added its game.json; `dateModified` is the last commit that touched its folder (nothing from a shallow clone).
+
+**The owner's own.** game.json `"schema"` adds schema.org properties to the game's `VideoGame`, and studio.json
+`"site": { "schema": { … } }` to the studio's `Organization` (its `sameAs`, say):
+
+```json
+"site": { "schema": { "sameAs": ["https://github.com/night-owls", "https://www.youtube.com/@nightowls"], "foundingDate": "2026" } }
+```
+
+Homie's own properties always win; `aggregateRating`, `review` and `offers` are refused, and the build says so, with
+any property schema.org does not put on that type. A whole block of the owner's own still goes in
+`site/partials/head.html`.
+
+**Files for crawlers and agents**, made from the public catalogue: a private or invite-only game is in none of them.
+
+- `/robots.txt`: every public page may be crawled; `/_studio/`, `/api/`, `/account/`, the shop's private steps
+  and each game's play, TV, watch, live, invite, API and socket doors may not; then the sitemap's address. A
+  Preview answers `Disallow: /`.
+- `/sitemap.xml`: Home, Games and each landing (and its credits), Rooms, Music, Videos, Posts and every page in
+  `site/pages`, with `lastmod` only where a real date says when it changed.
+- `/llms.txt`, following the llms.txt convention (an H1, a `>` summary, then `##` sections of links): what the
+  studio is; each game with its pitch, players, rounds, Play, Watch and the big screen; which games are open to remix,
+  with their licence, their `source.json` and the words to say to Claude Code or Codex with Homie (the plugin's
+  `game_remix` tool, or `homie-studio game remix <source> --id <new-id>`); songs; videos; posts with their Atom and
+  JSON feeds; the studio's own pages (a changelog among them); and homie.rocks's own llms.txt.
+- `/llms-full.txt`: the same, with each game's whole description, how to play, controls and credits, and every
+  post's text.
+
+A game is offered for remixing only when its source is shared, its owner's Remixable switch is on and its licence
+allows it, as for the directory. They are cached for five minutes. A file of the studio's own in `site/public` wins.
+
 ## Headers
 
 Every HTML answer is `no-transform` (a custom domain's edge injects nothing: Web Analytics' automatic beacon

package/worker/discover.mjs

@@ -0,0 +1,232 @@
+/**
+ * HOW SEARCH ENGINES AND AI AGENTS FIND A STUDIO (0.27.0): four plain files the site makes from its own catalogue,
+ * so they are never out of date and never name what is not public.
+ *
+ *   /robots.txt      every public page may be crawled; the owner's pages (/_studio/), the APIs, accounts, the shop's
+ *                    private steps and each game's play, TV, watch and socket doors may not; the sitemap's address.
+ *                    A Preview (a branch under review) asks not to be crawled at all.
+ *   /sitemap.xml     every public page (Home, Games and each landing, Music, Videos, Rooms, Posts, the studio's own
+ *                    pages), with lastmod only where a real date says when it changed
+ *   /llms.txt        the llms.txt convention (an H1, a > summary, then ## sections of links): what the studio is, each
+ *                    public game with its pitch, players, Play, Watch, the big screen and whether and how it can be
+ *                    remixed (the licence, the source, the words to say to Claude Code or Codex with Homie), songs,
+ *                    videos, posts with their feeds, the studio's own pages, and a link to homie.rocks's llms.txt
+ *   /llms-full.txt   the same, with each game's whole description, how to play, controls and credits, and every
+ *                    post's text
+ *
+ * Only public games are ever named (a private or invite-only game is in none of them), and a game is offered for
+ * remixing only when its owner's remix switch is on, its source is shared and its licence allows it. A file of the
+ * studio's own in site/public (robots.txt, sitemap.xml, llms.txt, llms-full.txt) wins over the made one.
+ */
+import { licenseOf, LICENSE_KINDS, remixRow } from './license.mjs';
+
+export const DISCOVERY_FILES = ['/robots.txt', '/sitemap.xml', '/llms.txt', '/llms-full.txt'];
+
+const studioName = (cat) => cat?.studio?.name ?? 'Studio';
+const one = (v, n = 400) => String(v ?? '').replace(/\s+/g, ' ').trim().slice(0, n);
+/** Text for a markdown link's words: brackets escaped, one line. */
+const label = (v) => one(v, 120).replace(/([[\]\\])/g, '\\$1');
+const xml = (v) => String(v ?? '').replace(/[&<>"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&apos;' })[c]);
+const dateOf = (v) => (typeof v === 'string' && Number.isFinite(Date.parse(v)) ? v : null);
+const newest = (list) => list.map(dateOf).filter(Boolean).sort((a, b) => Date.parse(b) - Date.parse(a))[0] ?? null;
+const day = (v) => (dateOf(v) ? new Date(Date.parse(v)).toISOString().slice(0, 10) : null);
+const clock = (s) => (Number.isFinite(s) && s > 0 ? `${Math.floor(s / 60)}:${String(Math.round(s % 60)).padStart(2, '0')}` : null);
+const KIND_WORD = { song: 'Song', score: 'Score', loop: 'Loop', stem: 'Stem', sfx: 'Sound', trailer: 'Trailer', 'music-video': 'Music video', cutscene: 'Cutscene', clip: 'Clip' };
+const players = (g) => { const min = g.players?.min ?? 1; const max = g.players?.max ?? 8; return max <= 1 ? '1 player' : min === max ? `${max} players` : `${min}–${max} players`; };
+const rounds = (s) => (Number.isFinite(s) && s > 0 ? (s % 60 ? `${s}-second rounds` : `${s / 60}-minute rounds`) : null);
+const watchable = (g) => !(g.watch === false || g.watch === 'off');
+const tv = (g) => g.landing?.tv !== false;
+const gameDate = (g) => dateOf(g.dates?.modified) ?? dateOf(g.dates?.published);
+const mediaDate = (e) => dateOf(e.date) ?? dateOf(e.made?.at);
+const postDate = (p) => dateOf(p.updated) ?? dateOf(p.date);
+
+/** The studio's own pages (site/pages) the sitemap and llms.txt name: not Home, not a game's landing, never the site's own places. */
+function ownPages(cat, all) {
+  const ids = new Set((all?.games ?? cat.games ?? []).map((g) => g.id));
+  return (cat.site?.pages ?? []).filter((p) => typeof p === 'string' && /^\/[a-z0-9][a-z0-9/_-]*\/$/i.test(p) && p !== '/')
+    .filter((p) => !ids.has(p.split('/')[1]) && !/^\/(?:games|music|videos|rooms|posts|account|shop|api|_studio|_homie|_site|media)\//.test(p));
+}
+const pageName = (p) => p.split('/').filter(Boolean).map((s) => s.replace(/[-_]+/g, ' ')).join(' · ').replace(/^./, (c) => c.toUpperCase());
+
+/* ------------------------------------------------------------------ robots.txt */
+
+export function robotsTxt(cat, origin, { preview = false } = {}) {
+  if (preview) {
+    return `# ${one(studioName(cat), 80)}: a Preview (a branch under review), not the studio's site. Nothing here is for search.\nUser-agent: *\nDisallow: /\n`;
+  }
+  const games = (cat.games ?? []).map((g) => g.id);
+  const lines = [
+    `# ${one(studioName(cat), 80)}, made with Homie (https://homie.rocks/studio/).`,
+    '# Every public page may be crawled. The owner\'s pages, the APIs, accounts, the shop\'s private steps and each game\'s',
+    '# play, TV, watch and socket doors may not (they open live rooms). AI agents: /llms.txt says what is here.',
+    'User-agent: *',
+    'Allow: /',
+    'Disallow: /_studio/',
+    'Disallow: /api/',
+    'Disallow: /account/',
+    'Disallow: /shop/thanks',
+    'Disallow: /shop/parent/',
+    'Disallow: /__homie',
+    ...games.flatMap((id) => [`Disallow: /${id}/play`, `Disallow: /${id}/tv`, `Disallow: /${id}/watch`, `Disallow: /${id}/live`, `Disallow: /${id}/invite`, `Disallow: /${id}/api/`, `Disallow: /${id}/__`, `Disallow: /${id}/s/*/play`, `Disallow: /${id}/s/*/tv`, `Disallow: /${id}/s/*/home`]),
+    '',
+    `Sitemap: ${origin}/sitemap.xml`,
+  ];
+  return `${lines.join('\n')}\n`;
+}
+
+/* ------------------------------------------------------------------ sitemap.xml */
+
+/** [{ path, lastmod }] for every public page, Home first. */
+export function sitemapEntries(cat, { all = null } = {}) {
+  const games = cat.games ?? [];
+  const songs = cat.songs ?? [];
+  const videos = cat.videos ?? [];
+  const posts = cat.posts ?? [];
+  const out = [];
+  const add = (path, lastmod = null) => { if (!out.some((x) => x.path === path)) out.push({ path, lastmod: dateOf(lastmod) }); };
+  add('/', newest([...games.map(gameDate), ...songs.map(mediaDate), ...videos.map(mediaDate), ...posts.map(postDate)]));
+  if (games.length) {
+    add('/games/', newest(games.map(gameDate)));
+    for (const g of games) {
+      add(`/${g.id}/`, gameDate(g));
+      if (g.landing?.credits?.texts) add(`/${g.id}/credits`, gameDate(g));
+    }
+    add('/rooms/');
+  }
+  if (songs.length) { add('/music/', newest(songs.map(mediaDate))); for (const e of songs) add(`/music/${e.slug}/`, mediaDate(e)); }
+  if (videos.length) { add('/videos/', newest(videos.map(mediaDate))); for (const e of videos) add(`/videos/${e.slug}/`, mediaDate(e)); }
+  if (posts.length) { add('/posts/', newest(posts.map(postDate))); for (const p of posts) add(`/posts/${p.slug}/`, postDate(p)); }
+  for (const p of ownPages(cat, all)) add(p);
+  return out;
+}
+
+export function sitemapXml(cat, origin, opts = {}) {
+  const urls = sitemapEntries(cat, opts).map((u) => `  <url><loc>${xml(`${origin}${u.path}`)}</loc>${u.lastmod ? `<lastmod>${xml(new Date(Date.parse(u.lastmod)).toISOString().replace(/\.\d{3}Z$/, 'Z'))}</lastmod>` : ''}</url>`);
+  return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${urls.join('\n')}\n</urlset>\n`;
+}
+
+/* ------------------------------------------------------------------ llms.txt */
+
+const HOMIE_INSTALL = 'in Claude Code, `/plugin marketplace add homie-rocks/homie` and then `/plugin install homie@homie` (Codex takes the same marketplace)';
+
+function licenceWords(g) {
+  const l = licenseOf(g.license);
+  const name = `${LICENSE_KINDS[l.kind]}${l.spdx ? `, ${l.spdx}` : ''}`;
+  if (l.kind === 'remix-freely') return `${name}: a credit is welcome, not asked for`;
+  return `${name}: a remix says "Remix of ${one(g.name, 80)} by ${one(g.studio, 80)}" with a link back`;
+}
+
+function summaryOf(cat, origin) {
+  const name = studioName(cat);
+  const tag = one(cat.studio?.tagline, 140);
+  const games = (cat.games ?? []).length;
+  // What it has, never what it might: a studio with no game says only what it publishes (a music studio makes no game).
+  const has = [(cat.songs ?? []).length ? 'songs' : null, (cat.videos ?? []).length ? 'videos' : null, (cat.posts ?? []).length ? 'posts' : null].filter(Boolean);
+  const kinds = has.length > 1 ? `${has.slice(0, -1).join(', ')} and ${has.at(-1)}` : has[0];
+  const what = games
+    ? 'It makes free multiplayer games that play in a web browser on a phone, a computer or a TV; press Play and you are in a live public room with whoever is playing, and bots hold the empty seats.'
+    : has.length ? `It publishes ${kinds}.` : 'Its first game is coming soon.';
+  return [
+    `# ${one(name, 120)}`,
+    '',
+    `> ${one(name, 120)} is a studio made with Homie${tag ? ` (${tag})` : ''}. ${what} Its site is ${origin}/.`,
+  ];
+}
+
+/** /llms.txt. `remixable(g)`: the owner's remix switch is on, the source is shared, and the licence allows it. */
+export function llmsTxt(cat, origin, { remixable = () => false, directory = 'https://homie.rocks', full = false, posts = null, all = null } = {}) {
+  const name = studioName(cat);
+  const games = (cat.games ?? []).map((g) => ({ ...g, studio: name }));
+  const songs = cat.songs ?? [];
+  const videos = cat.videos ?? [];
+  const list = cat.posts ?? [];
+  const out = summaryOf(cat, origin);
+  out.push('', full
+    ? `Everything ${one(name, 120)} has published, in full: each game's whole description, how to play, controls and credits, every song and video, and every post's text. The short version with links only is ${origin}/llms.txt.`
+    : `${games.length ? 'Every game below is free and needs no download or account. A game\'s page has its trailer, how to play and credits; its Play link puts a visitor straight into a live public room. ' : ''}Whole descriptions and every post's text: ${origin}/llms-full.txt.`);
+  if (games.length) {
+    out.push('', '## Games', '');
+    for (const g of games) {
+      const L = g.landing ?? {};
+      const doors = [`Play: ${origin}/${g.id}/play`, ...(watchable(g) ? [`Watch a live room: ${origin}/${g.id}/watch`] : []), ...(tv(g) ? [`On a TV: ${origin}/${g.id}/tv`] : [])];
+      const facts = [players(g), rounds(g.roundSeconds), ...(Array.isArray(g.genre) ? g.genre : g.genre ? [g.genre] : [])].filter(Boolean).join(', ');
+      const lineage = remixRow(g.remixOf);
+      const open = remixable(g);
+      out.push(`- [${label(g.name)}](${origin}/${g.id}/): ${one(L.pitch || g.blurb, 240)}${/[.!?]$/.test(one(L.pitch || g.blurb)) ? '' : '.'} ${facts}.${lineage ? ` A remix of ${one(lineage.name, 80)}${lineage.studio ? ` by ${one(lineage.studio, 80)}` : ''}.` : ''} ${doors.join('. ')}. ${open ? `Open to remix (${LICENSE_KINDS[licenseOf(g.license).kind]}${licenseOf(g.license).spdx ? `, ${licenseOf(g.license).spdx}` : ''}): see Remix below.` : 'Not open to remix.'}`);
+      if (full) {
+        const C = L.credits ?? {};
+        const lines = [];
+        if (g.blurb && one(g.blurb) !== one(L.pitch)) lines.push(one(g.blurb, 600));
+        if (L.about) lines.push(one(L.about, 1200));
+        if ((L.how ?? []).length) lines.push(`How to play: ${L.how.map((x) => one(x, 240)).join(' ')}`);
+        const ctl = ['phone', 'computer', 'tv'].filter((k) => L.controls?.[k]).map((k) => `${k === 'tv' ? 'TV' : k}: ${one(L.controls[k], 300)}`);
+        if (ctl.length) lines.push(`Controls. ${ctl.join('. ')}.`);
+        const credits = [`Made by ${one(name, 80)}`, ...(C.people ?? []).map((c) => `${c.role ? `${one(c.role, 60)}: ` : ''}${one(c.name, 80)}`)];
+        if (C.original && !C.original.house && C.original.title) credits.push(`Based on ${one(C.original.title, 120)}${C.original.author ? ` by ${one(C.original.author, 120)}` : ''}${C.original.year ? ` (${one(C.original.year, 12)})` : ''}${C.original.licence ? `, ${one(C.original.licence, 60)} licence` : ''}${C.original.url ? ` (${C.original.url})` : ''}`);
+        for (const p of C.parts ?? []) credits.push(`${one(p.what, 160)}${p.author ? `: ${one(p.author, 120)}` : ''}${p.licence ? `, ${one(p.licence, 60)}` : ''}`);
+        lines.push(`Credits: ${credits.join('; ')}.`);
+        if (C.texts) lines.push(`Licence texts: ${origin}/${g.id}/credits`);
+        for (const l of lines) out.push(`  ${l}`);
+      }
+    }
+    const open = games.filter((g) => remixable(g));
+    if (open.length) {
+      out.push('', '## Remix', '');
+      out.push(`Homie is a plugin for Claude Code and Codex that makes multiplayer games in a studio of your own, on your own free Cloudflare account. To remix one of these games, ${HOMIE_INSTALL}, then say "Remix <game> from <its source address> into a game of my own in my Homie studio". The plugin's \`game_remix\` tool (or \`npx --no-install homie-studio game remix <source address> --id <new-id>\` in a studio's folder) copies it in and writes the credit its licence asks for.`, '');
+      for (const g of open) out.push(`- [${label(g.name)} source](${origin}/games/${g.id}/source.json): ${licenceWords(g)}. Say: "Remix ${one(g.name, 80)} from ${origin}/games/${g.id}/source.json into a game of my own in my Homie studio".`);
+    }
+  }
+  if (songs.length) {
+    out.push('', '## Music', '');
+    for (const e of songs) {
+      out.push(`- [${label(e.title)}](${origin}/music/${e.slug}/): ${[KIND_WORD[e.kind] ?? 'Music', clock(e.duration), e.bpm ? `${e.bpm} BPM` : null, e.key, e.album ? `from ${one(e.album, 120)}` : null].filter(Boolean).join(', ')}.${e.blurb ? ` ${one(e.blurb, 300)}` : ''}`);
+      if (full && e.credits) out.push(`  ${one(e.credits, 600)}`);
+    }
+  }
+  if (videos.length) {
+    out.push('', '## Videos', '');
+    for (const e of videos) {
+      out.push(`- [${label(e.title)}](${origin}/videos/${e.slug}/): ${[KIND_WORD[e.kind] ?? 'Video', clock(e.duration)].filter(Boolean).join(', ')}.${e.blurb ? ` ${one(e.blurb, 300)}` : ''}`);
+      if (full && e.credits) out.push(`  ${one(e.credits, 600)}`);
+    }
+  }
+  if (list.length) {
+    out.push('', '## Posts', '');
+    out.push(`- [Atom feed](${origin}/posts/feed.xml): every post, newest first, with its full text`);
+    out.push(`- [JSON Feed](${origin}/posts/feed.json): the same, as JSON`);
+    for (const p of list.slice(0, full ? 200 : 20)) out.push(`- [${label(p.title)}](${origin}/posts/${p.slug}/): ${day(p.date) ?? ''}${p.summary ? `. ${one(p.summary, 300)}` : ''}`);
+    if (full && posts?.length) {
+      for (const p of posts) {
+        const textOf = p.record?.text;
+        if (!textOf) continue;
+        out.push('', `### ${one(p.title, 140)} (${day(p.date) ?? ''})`, '', `${origin}/posts/${p.slug}/`, '', String(textOf).trim().slice(0, 30000));
+      }
+    }
+  }
+  const pages = ownPages(cat, all);
+  if (pages.length) {
+    out.push('', '## Pages', '');
+    for (const p of pages) out.push(`- [${label(pageName(p))}](${origin}${p})`);
+  }
+  out.push('', '## Optional', '');
+  if (games.length) out.push(`- [Rooms](${origin}/rooms/): every public room playing now (${origin}/api/rooms is the same as JSON)`);
+  out.push(`- [Studio manifest](${origin}/.well-known/homie-studio.json): the games, songs, videos and posts as JSON`);
+  out.push(`- [Sitemap](${origin}/sitemap.xml): every public page`);
+  if (!full) out.push(`- [Everything, in full](${origin}/llms-full.txt): each game's whole description, how to play and credits, and every post's text`);
+  const hub = /^https:\/\/[a-z0-9.-]+$/i.test(String(directory ?? '')) ? directory : 'https://homie.rocks';
+  out.push(`- [Homie](${hub}/llms.txt): what Homie is, and how to make a studio like this one`);
+  return `${out.join('\n')}\n`;
+}
+
+/** The plain-text answer every one of these files is sent with. */
+export function discoveryResponse(body, type, { method = 'GET' } = {}) {
+  return new Response(method === 'HEAD' ? null : body, {
+    headers: {
+      'content-type': `${type}; charset=utf-8`,
+      // A game the owner makes private leaves these within five minutes.
+      'cache-control': 'public, max-age=300',
+      'x-content-type-options': 'nosniff',
+      'access-control-allow-origin': '*',
+    },
+  });
+}