@homie-rocks/studio 0.26.0 → 0.27.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

@@ -1273,6 +1273,84 @@
      }
     }
    }
+  },
+  "0.26.1": {
+   "files": {
+    "CLAUDE.md": "ddf2b2a0376202f6",
+    "README.md": "684b3cca8001673c",
+    "HANDOFF.md": "ce7a8fd91c6bbee2",
+    "games/README.md": "5ad32fe80c61f117",
+    "music/README.md": "a3dc042dadd39df8",
+    "videos/README.md": "16babc3437d5545b",
+    "posts/README.md": "37841aae476bd540",
+    "site/README.md": "ca131cd0472464fb",
+    "site/src/worker.mjs": "ca3f1630f2420ad3"
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "214aa46eb3a895d5",
+     "## Layout": "8baf49e4291e7e88",
+     "## Commands (all through the pinned CLI in node_modules)": "d80ec56e4b4fc4c6",
+     "## The site": "ab922bb6bde23293",
+     "## 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.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"
+      }
+     }
+    }
+   }
   }
  }
 }

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.0",
+  "version": "0.27.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': '*',
+    },
+  });
+}

package/worker/index.mjs

@@ -36,6 +36,9 @@
  *   /__homie/..., /<game>/__homie/...   `not-a-homie`: the answer a game with Homie's arcade controls gets when it
  *                              knocks for a Homie box, so it stops knocking (a studio site is not a box)
  *   /.well-known/homie-studio.json   what the homie.rocks directory reads
+ *   /robots.txt, /sitemap.xml, /llms.txt, /llms-full.txt   for search engines and AI agents, made from the public
+ *                              catalogue (worker/discover.mjs); every generated page also carries schema.org JSON-LD
+ *                              (worker/schema.mjs)
  *   /games/<id>/source.json    a public game's source for remixing, with its credit and licence (worker/license.mjs)
  *   /media/<key>               a loose file in the studio's R2 (`media put`), with byte ranges
  *   /music/<slug>/<file>, /videos/<slug>/<file>   a song's or video's files: from the site's own files, or, for a
@@ -93,7 +96,7 @@ import { doorPage, serverPage, serversPage } from './site.mjs';
 import { isLocalOrigin, qrSvg } from './qr.mjs';
 import { SEAT_MAX, perAddress, seatsOf } from './seats.mjs';
 import {
-  SITE_JS, atomFeed, creditsPage, customPage, gameCover, gameLanding, gamesPage, homePage, jsonFeed, mediaArt, mediaIndexPage,
+  SITE_JS, atomFeed, creditsPage, customPage, gameCover, gameLanding, gamesPage, homeLd, homePage, jsonFeed, landingLd, mediaArt, mediaIndexPage,
   notFoundPage, postPage, postsPage, roomView, roomsPage, sectionsOf, songPage, videoPage, watchOf,
 } from './site.mjs';
 import { cookieValues, count, countVisit, counter, isQa, onlyOf, ownerAllowed, playedByGame, playedThisWeek, rangeOf, readStats, today } from './stats.mjs';
@@ -108,7 +111,9 @@ import {
 // every device, and the owner's own account (`homie-studio players owner`) counts as the owner.
 usePlayers(playerAccounts);
 import { STUDIO_VERSION_TAG } from './version.mjs';
-import { roomBadge, shellShop, shopOf, shopRoutes } from './shop.mjs';
+import { readiness, roomBadge, shellShop, shopOf, shopRoutes } from './shop.mjs';
+import { DISCOVERY_FILES, discoveryResponse, llmsTxt, robotsTxt, sitemapXml } from './discover.mjs';
+import { ldScript, studioNode } from './schema.mjs';
 import { arrivalCookie, manifestReferrals } from './referrals.mjs';
 import { licenseOf, remixAllowed, remixRow } from './license.mjs';
 
@@ -143,6 +148,14 @@ async function catalogue(env, origin) {
 }
 
 /** The posts with their HTML (site/dist/_site/posts.json), for a post's page and the feeds. */
+/** The studio's shop when it really sells (shop.json checked, the key, the webhook secret and its tables in): its items
+ * are a landing's offers (worker/schema.mjs). Else null: a landing never names a price nobody can pay. */
+async function sellingShop(env, cat) {
+  const shop = shopOf(cat);
+  if (!shop || shop.broken) return null;
+  try { return (await readiness(env, shop)).ready ? shop : null; } catch { return null; }
+}
+
 async function postsOf(env, origin) {
   try {
     const res = await env.ASSETS.fetch(new Request(`${origin}/_site/posts.json`));
@@ -701,6 +714,23 @@ async function route(request, env, ctx) {
     }
   }
 
+  // Search engines and AI agents (0.27.0, worker/discover.mjs): robots.txt, sitemap.xml, llms.txt and llms-full.txt,
+  // made from the public catalogue (a private or invite-only game is in none of them); a file of the studio's own in
+  // site/public wins.
+  if (read && DISCOVERY_FILES.includes(path)) {
+    const own = await env.ASSETS.fetch(new Request(`${url.origin}${path}`));
+    if (own.ok) return own;
+    const cat = await getCat();
+    const method = request.method;
+    if (path === '/robots.txt') return discoveryResponse(robotsTxt(cat, url.origin, { preview: env.HOMIE_PREVIEW === '1' }), 'text/plain', { method });
+    const all = await getAll();
+    if (path === '/sitemap.xml') return discoveryResponse(sitemapXml(cat, url.origin, { all }), 'application/xml', { method });
+    const settings = await settingsOf(env);
+    const remixable = (g) => g.landing?.source !== false && remixOf(g, settings) && remixAllowed(g.license);
+    const full = path === '/llms-full.txt';
+    return discoveryResponse(llmsTxt(cat, url.origin, { remixable, directory: directoryOf(cat), full, posts: full ? await postsOf(env, url.origin) : null, all }), 'text/plain', { method });
+  }
+
   // A page the studio made itself (site/pages) wins at its address.
   if (read && (path.endsWith('/') || !path.includes('.'))) {
     const cat = await getCat();
@@ -714,7 +744,14 @@ async function route(request, env, ctx) {
         const game = (cat.games ?? []).find((g) => g.id === top);
         await countVisit(request, env, ctx, parts.length === 0 ? 'home' : game && parts.length === 1 ? game.id : parts.join('/').slice(0, 80));
         const active = game ? 'games' : sectionsOf(cat).some((s) => s.key === top) ? top : null;
-        return customPage(cat, await res.text(), { active });
+        const html = await res.text();
+        // <!-- homie:schema -->: the structured data the generated page here would carry (Home's, a landing's), else the
+        // studio's own Organization (an About page).
+        const schema = !/<!--\s*homie:schema\s*-->/.test(html) ? ''
+          : want === '/' ? ldScript(homeLd(cat, url.origin))
+            : game && parts.length === 1 ? ldScript(landingLd(cat, game, url.origin, { shop: await sellingShop(env, cat) }))
+              : ldScript([studioNode(cat, url.origin, { full: true })]);
+        return customPage(cat, html, { active, schema });
       }
     }
   }
@@ -825,7 +862,7 @@ async function route(request, env, ctx) {
       const { rooms, live } = await roomsOf(env, [meta], { servers: { [game]: servers } });
       const week = cat.studio?.stats?.share ? await weekOf(env, game) : null;
       const band = servers.some((x) => x.id !== 'public' && x.listed && x.state === 'open') ? await serverLive(env, meta, servers, url.origin, lobby) : null;
-      return gameLanding(cat, meta, { origin: url.origin, rooms, playing: live[game] ?? 0, week, remix: launch === 'public' && remixOf(meta, settings), servers: band });
+      return gameLanding(cat, meta, { origin: url.origin, rooms, playing: live[game] ?? 0, week, remix: launch === 'public' && remixOf(meta, settings), servers: band, listed: launch === 'public', shop: launch === 'public' ? await sellingShop(env, cat) : null });
     }
     if (sub === 'live') {
       if (!door.ok) return json({ ok: false, error: 'not-found' }, 404);