@homie-rocks/studio 0.58.18 → 0.58.20

package/CHANGELOG.md

@@ -17,6 +17,26 @@ To bring a studio up to date, tell Claude: "Upgrade my studio to the newest Homi
 `npx -y @homie-rocks/studio@latest upgrade`, which shows what's new since the version your studio pins (from this
 file) and what the upgrade would change, and changes nothing until you agree.
 
+## [0.58.20] - 2026-10-26
+
+**Plugin 0.58.14**
+
+An upgrade keeps a studio's game routes when nothing has been built yet.
+
+### Fixed
+
+- `homie-studio upgrade` in a fresh checkout (no `site/dist`, as on a new machine or a hosting platform's clone) no longer rewrites `wrangler.jsonc` without the studio's game routes (`/<game>`, `/<game>/*` and the static-asset exclusions). Without build output the Worker config keeps the routes the last build wrote; the next build still sets them from the games it finds.
+
+## [0.58.19] - 2026-10-21
+
+**Plugin 0.58.13**
+
+A platform that runs a studio's scheduled ticks can use the worker's own cron parser.
+
+### Added
+
+- `@homie-rocks/studio/worker/schedule` exports the worker's own cron parser (`parseSchedule`, `nextDue`, with its types), Cloudflare's five-field UTC dialect, so a platform that runs a dispatch Worker's scheduled ticks schedules them as the studio's Cron Triggers would fire.
+
 ## [0.58.18] - 2026-10-21
 
 **Plugin 0.58.12**

package/lib/template-history.json

@@ -4722,6 +4722,90 @@
      }
     }
    }
+  },
+  "0.58.19": {
+   "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": "1dbdf22c03a1e505",
+    "site/src/worker.mjs": "6cc5c6131eaf6fd0"
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "af7f2f732505d379",
+     "## Version-matched authoring guides": "f6261a0e5801b96b",
+     "## Layout": "f3a280b8c96cd068",
+     "## Apps: one screen, roles and parts": "c10aa0441ea89702",
+     "## Commands (all through the pinned CLI in node_modules)": "c20d90de21cde0c7",
+     "## The site": "0cb8dd9a6f8a0096",
+     "## Making games": "bb715272fd1a615b",
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Art direction and models": "a48fff7bf0a5f2fc",
+     "## Running live games (the back office)": "51ebf2ab756f6e4d",
+     "## Servers and AI seats": "1ccfd549d2369a60",
+     "## Selling things (the shop)": "0df5a5fe1833c624",
+     "## Continuing a build from the Claude app": "0d68081e924ca419",
+     "## Rules": "b2234d80f6cbe71d",
+     "## Telling Homie": "80b46fdd9e578db8",
+     "## Beta": "9d02638207a26e73"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "8364e05cebefcba4"
+      }
+     }
+    }
+   }
+  },
+  "0.58.20": {
+   "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": "1dbdf22c03a1e505",
+    "site/src/worker.mjs": "6cc5c6131eaf6fd0"
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "af7f2f732505d379",
+     "## Version-matched authoring guides": "f6261a0e5801b96b",
+     "## Layout": "f3a280b8c96cd068",
+     "## Apps: one screen, roles and parts": "c10aa0441ea89702",
+     "## Commands (all through the pinned CLI in node_modules)": "c20d90de21cde0c7",
+     "## The site": "0cb8dd9a6f8a0096",
+     "## Making games": "bb715272fd1a615b",
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Art direction and models": "a48fff7bf0a5f2fc",
+     "## Running live games (the back office)": "51ebf2ab756f6e4d",
+     "## Servers and AI seats": "1ccfd549d2369a60",
+     "## Selling things (the shop)": "0df5a5fe1833c624",
+     "## Continuing a build from the Claude app": "0d68081e924ca419",
+     "## Rules": "b2234d80f6cbe71d",
+     "## Telling Homie": "80b46fdd9e578db8",
+     "## Beta": "9d02638207a26e73"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "8364e05cebefcba4"
+      }
+     }
+    }
+   }
   }
  }
 }

package/lib/worker-config.mjs

@@ -49,6 +49,19 @@ export function updateWorkerConfig(root,generated) {
   const text='// Generated by homie-studio. Edit studio.json or wrangler.custom.json, then build.\n'+JSON.stringify(next,null,2)+'\n';
   if(!existsSync(file)||readFileSync(file,'utf8')!==text) {const temp=`${file}.${process.pid}.tmp`;writeFileSync(temp,text);renameSync(temp,file);}
 }
+/**
+ * The Worker routes for the studio's games: the last build's catalogue (site/dist/games.json). Without build output (a
+ * fresh checkout, or an upgrade run before any build) there is no catalogue, so the routes the last build wrote into the
+ * Worker config are kept, with the toolkit's own routes, instead of dropping every game's route until the next build.
+ */
+export function workerRoutesOf(root) {
+  const catalogue=join(root,'site/dist/games.json');
+  if(existsSync(catalogue))return staticWorkerRoutes(read(catalogue));
+  const before=read(configPath(root)).assets?.run_worker_first;
+  if(before===true)return true;
+  const base=staticWorkerRoutes(null);
+  return Array.isArray(before)?[...new Set([...base,...before])]:base;
+}
 export function refreshWorkerConfig(root,overrides={}) {
   const studio=readStudio(root),cf=studio.cloudflare;
   if(!cf?.worker)return;
@@ -57,5 +70,5 @@ export function refreshWorkerConfig(root,overrides={}) {
   const tools=read(join(root,'site/src/tools/declarations.json'));
   const ai=cf.ai??listExperiences(root).some(g=>g.decide===true || g.chat!==false && (g.chat?.mode??'text')==='text' && g.chat?.ai!==false);
   const paid=paidReleases(root).length>0||existsSync(join(root,'shop.json'))||tools.paid===true;
-  updateWorkerConfig(root,wranglerConfig({analytics:studio.stats?.analytics===true,workerRoutes:staticWorkerRoutes(read(join(root,'site/dist/games.json'))),worker:cf.worker,name:studio.name,d1:cf.d1,d1Id:cf.d1Id,r2:cf.r2,layout:layoutOf(root),ai,paidParts:paid,partsRateLimit:cf.purchaseRateLimit??null,routes:cf.routes??null,eventFeeds:studio.mcp?.events,triggers:{crons:[scheduleTrigger(functions,{eventFeeds:Object.keys(studio.mcp?.events??{}).length>0})].filter(Boolean)},...overrides}));
+  updateWorkerConfig(root,wranglerConfig({analytics:studio.stats?.analytics===true,workerRoutes:workerRoutesOf(root),worker:cf.worker,name:studio.name,d1:cf.d1,d1Id:cf.d1Id,r2:cf.r2,layout:layoutOf(root),ai,paidParts:paid,partsRateLimit:cf.purchaseRateLimit??null,routes:cf.routes??null,eventFeeds:studio.mcp?.events,triggers:{crons:[scheduleTrigger(functions,{eventFeeds:Object.keys(studio.mcp?.events??{}).length>0})].filter(Boolean)},...overrides}));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homie-rocks/studio",
-  "version": "0.58.18",
+  "version": "0.58.20",
   "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",
@@ -85,6 +85,10 @@
       "default": "./apps/apps.ts"
     },
     "./worker/selling": "./worker/selling/index.mjs",
+    "./worker/schedule": {
+      "types": "./worker/function-schedule.d.ts",
+      "default": "./worker/function-schedule.mjs"
+    },
     "./tools": {
       "types": "./tools/tools.ts",
       "default": "./tools/tools.ts"

package/worker/build-id.mjs

@@ -1,2 +1,2 @@
 // Generated by lib/build-identity.mjs; identifies the bundled runtime sources.
-export const STUDIO_BUILD = Object.freeze({"version":"0.58.18","sha256":"333254a4a029de3f655b1689480b580903801f14cc0d9e6ea99f2bac4b9e5c7f"});
+export const STUDIO_BUILD = Object.freeze({"version":"0.58.20","sha256":"8e8f40665f1f6a370f288217983318a04937be8ad2d51e80d0f52feb4cc3782d"});

package/worker/function-schedule.d.ts

@@ -0,0 +1,14 @@
+/** A five-field Cloudflare cron expression in UTC (Sunday = 1), parsed. */
+export interface Schedule {
+  parts: string[];
+  fields: {values: number[]; special: string[]}[];
+  dayMatches(date: Date): boolean;
+  /** Whether the expression is due at this time (its UTC minute). */
+  matches(time: number): boolean;
+}
+/** Parse a cron expression; throws on one Cloudflare would refuse. */
+export function parseSchedule(expression: string): Schedule;
+/** The first time after `after` the expression is due, or null when it never is. */
+export function nextDue(expression: string | Schedule, after?: number): number | null;
+export function scheduleTrigger(definitions: {schedule?: string}[], options?: {eventFeeds?: boolean}): string | null;
+export function scheduleStatus(definitions: {name: string; schedule?: string}[], crons: string[], now?: number): {function: string; schedule: string; nextDue: string | null; status: string}[];

package/worker/version.mjs

@@ -1,2 +1,2 @@
 /** The @homie-rocks/studio version this Worker code is (package.json's; a test keeps them equal). Cache-busts /_homie/site.js. */
-export const STUDIO_VERSION_TAG = '0.58.18';
+export const STUDIO_VERSION_TAG = '0.58.20';