@maka/maka-cli 5.175.0 → 5.176.0

package/bundle/typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maka/maka-cli",
-  "version": "5.175.0",
+  "version": "5.176.0",
   "type": "module",
   "summary": "A command line tool for scaffolding Meteor 3.x applications using either React.",
   "description": "A command line tool for scaffolding Meteor 3.x applications using React.",

package/bundle/typescript/src/commands/game/sideQuest/engine-version.js

@@ -430,5 +430,12 @@
 //   the purpose. A `hub: true` seed is stripped of hosts, ice and files on
 //   load -- the shipped hub (scene2) no longer stands one over the Bazaar
 //   or the Sim Den.
-export const ENGINE_VERSION = '1.50.0';
+// 1.51.0 (2026-09-12): THE HUB LIVES ON THE SITE. The hub seed is served
+//   by maka-cli.com (/api/v1/game-hub) and cached like the catalog; the
+//   package ships no scene2.json. Save-shape field the server writes
+//   back: hubSeedRef {id, version, contentHash} beside the (for one
+//   release) still-embedded hubSeed. Hosted hub sessions
+//   (createHeadlessHub) run the solo hub loop in the site's process with
+//   a save sink; a browser player can enter the hub.
+export const ENGINE_VERSION = '1.51.0';
 //# sourceMappingURL=engine-version.js.map

package/bundle/typescript/src/commands/game/sideQuest/factories/chargen-factory.js

@@ -12,7 +12,8 @@ import { findCatalogItem, itemFromCatalog, loadCatalog, augFor, spellFor, adeptP
 import { SKILL_GROUPS } from '../skill-groups.js';
 import { serializePlayer, serializeItem } from '../utilities/persistence.js';
 import { canonicalLifestyleTier, LIFESTYLE_TIERS, canonicalLifestyleOption, lifestyleOptionAllowed, LIFESTYLE_OPTIONS, } from '../utilities/commerce.js';
-import { SAVE_VERSION } from '../types/save-file.js';
+import { SAVE_VERSION, DUAL_WRITE_HUB_SEED } from '../types/save-file.js';
+import { hubSeedRefOf } from '../utilities/hub-seed.js';
 /**
  * THE ENGINE-SIDE CHARACTER FACTORY -- one payload in, one bootable save
  * out, so the maka-cli.com web generator and the CLI cannot produce
@@ -527,32 +528,25 @@ export function buildFromChargen(payload) {
     return { player, garage, lifestyleTier, lifestyleOptions };
 }
 /**
- * The payload's save. `hubSeed` is the SHIPPED scene2 seed by ruling --
- * it is embedded rather than referenced so a resume never depends on
- * scene2.json still existing or still matching.
- */
-/**
- * THE SHIPPED HUB SEED -- the default home for a character born without one.
+ * The payload's save, born into `hubSeed`.
  *
- * The CLI offers this same scene (scenes/scene2.json, the primary; scene1 is
- * the smoke test) to a new character it creates itself, so a WEB-born runner
- * defaulting to it starts exactly where a CLI-born one does. This is what
- * lets the web's finalize call the factory with no hubSeed at all -- the one
- * argument it could never produce, since scene generation lives CLI-side.
+ * THE HUB SEED IS AN ARGUMENT NOW, AND A REQUIRED ONE (2026-09-12). The
+ * shipped scene2.json is gone: the hub lives on maka-cli.com
+ * (utilities/hub-seed.ts fetches and caches it for a terminal; the site
+ * reads its own GameHubSeeds collection for a web birth), and a factory
+ * that quietly reached for a bundled copy would be the second source of
+ * truth this migration removes. Nothing in this repo creates a
+ * character without first holding the served seed.
  *
- * A LITERAL require, deliberately: the pkg binary traces literal require()
- * paths only -- a computed path ships a binary with the seed missing
- * (the blessed-terminfo lesson, recorded in the packaging notes).
+ * The save records the seed by REFERENCE (hubSeedRef, from the stamp
+ * the server put on it) and, for one release, still embeds it
+ * (hubSeed) so a binary from before the migration can resume the
+ * runner -- see ISaveFileV1.hubSeed and DUAL_WRITE_HUB_SEED in game.ts.
  */
-import { createRequire } from 'module';
-const requireSeed = createRequire(import.meta.url);
-function shippedHubSeed() {
-    return requireSeed('../scenes/scene2.json');
-}
 export function createNewCharacterSave(payload, hubSeed) {
-    return createNewCharacterSaveWithSeed(payload, hubSeed ?? shippedHubSeed());
-}
-function createNewCharacterSaveWithSeed(payload, hubSeed) {
+    if (!hubSeed || typeof hubSeed !== 'object' || !Array.isArray(hubSeed.rooms)) {
+        throw new ChargenPayloadError('A runner needs a home district: createNewCharacterSave requires the served hub seed.');
+    }
     const { player, garage, lifestyleTier, lifestyleOptions } = buildFromChargen(payload);
     // WHAT A BIRTH CERTIFICATE CARRIES, AND WHAT IT DOES NOT (2026-09-05).
     // Game.applyResumeState restores the PLAYER, applies the LIFESTYLE and
@@ -578,7 +572,8 @@ function createNewCharacterSaveWithSeed(payload, hubSeed) {
             lifestyleTier,
             hubName: hubSeed.name ?? 'the hub',
         },
-        hubSeed,
+        hubSeedRef: hubSeedRefOf(hubSeed),
+        ...(DUAL_WRITE_HUB_SEED ? { hubSeed } : {}),
         player: serializePlayer(player),
         game: {
             lifestyleTier, lifestyleOptions, rentDebt: 0, tier: 1, contacts: [],

package/bundle/typescript/src/commands/game/sideQuest/factories/repro-scene.js

@@ -278,7 +278,7 @@ export function buildReproScene(fixture) {
      *  the room seed -- see types/seed/room-seed.ts. Nothing is invented
      *  here, so a bench cannot describe a host the engine cannot build. */
     const hostFields = (side) => (host && hostSide === side
-        ? { hasNode: true, nodeAccess: host.access ?? 'wireless', hostRating: host.rating }
+        ? { hasNode: true, nodeAccess: host.access ?? 'wireless', hostRating: host.rating, hostPurpose: host.purpose, hostSculpt: host.sculpt }
         : {});
     // Cameras WITHOUT a host. Never emitted alongside one: a host is
     // always watched already, and saying it twice invites the next reader
@@ -400,6 +400,13 @@ export function buildReproScene(fixture) {
             skills: { ...(seed.player.combat?.skills ?? {}), 'first-aid': 6, medicine: 6 },
         };
     });
+    // A FILE NEEDS A HOST TO SIT IN (items[].file). Same refusal as
+    // homeless ice, for the same reason: a builder that quietly invented
+    // the host would be inventing the thing under test.
+    const homelessFile = items.find(it => it.file) && !host;
+    if (homelessFile) {
+        throw new ReproFixtureError(`This fixture has a file but no host. A file lives inside a host -- add "host": {} so there is something for it to be in.`);
+    }
     const itemSeeds = items.map(it => ({
         name: it.name,
         description: it.description,
@@ -411,8 +418,11 @@ export function buildReproScene(fixture) {
         texture: 'Plain',
         rating: 'Common',
         weight: 0.1,
-        room: roomFor(it.side ?? 'barrier'),
-        atSpot: it.atDoorway ? REPRO_DOORWAY_SPOT : REPRO_FLOOR_SPOT,
+        // A FILE rides the host's room on the matrix plane and takes no
+        // spot -- a spot is a meat position (see the ice rule above).
+        ...(it.file
+            ? { plane: 'matrix', room: roomFor(hostSide) }
+            : { room: roomFor(it.side ?? 'barrier'), atSpot: it.atDoorway ? REPRO_DOORWAY_SPOT : REPRO_FLOOR_SPOT }),
     }));
     // INVARIANT 4: the key is on the side the runner starts on. A key
     // behind the door it opens is a bench nobody can work, and it reads

package/bundle/typescript/src/commands/game/sideQuest/game.js

@@ -18,7 +18,8 @@ import { Category, Size, Rating } from './types/shared/item-enum.js';
 import { Item } from './models/item.js';
 import { Room, Container } from './models/_index.js';
 import { Door } from './models/door.js';
-import { SAVE_VERSION } from './types/save-file.js';
+import { SAVE_VERSION, DUAL_WRITE_HUB_SEED } from './types/save-file.js';
+import { hubSeedRefOf } from './utilities/hub-seed.js';
 import { serializePlayer, restorePlayer, captureHubOverlay, applyHubOverlay, applyHomeBlock, writeSaveAtomic, deleteSave, restoreItem, readSave, serializeItem, saveSlug, spillPathFor, } from './utilities/persistence.js';
 import { heartbeatPresence, heartbeatPresenceNow } from './utilities/social.js';
 import { presenceBeatAllowed } from './utilities/presence-gate.js';
@@ -665,13 +666,15 @@ export default class Game {
      * push one right now and say so.
      */
     async pushPresenceNow() {
-        if (this._anonymous || this._bench)
+        // A hosted hub never dials the site from inside the site: the box's
+        // own `maka login`, if any, is not this player's.
+        if (this._anonymous || this._bench || this._hostedHub)
             return 'offline';
         return heartbeatPresenceNow(this.presencePayload());
     }
     startPresenceHeartbeat() {
-        if (this._anonymous || this._bench)
-            return; // account-less, or a bench: never on the street
+        if (this._anonymous || this._bench || this._hostedHub)
+            return; // account-less, a bench, or hosted on the site: never on the street
         if (this._presenceTimer)
             return;
         this.beatPresence();
@@ -1285,7 +1288,12 @@ export default class Game {
     _saveFilePath; // from options.saveFilePath; unset = never save
     _dead = false; // set in close(); suppresses any later save
     _resume; // present when this session continues a save
-    _hubSeed; // the seed embedded into every save
+    _hubSeed; // the served hub seed this session plays (its stamp is the save's hubSeedRef)
+    /** A HUB HOSTED ON THE SITE (IMainGameConfig.hostedHub): no presence,
+     *  no DDP hub link, no auto-draft, and every save beat goes to the
+     *  sink instead of a file. */
+    _hostedHub = false;
+    _saveSink;
     /**
      * The one correct runtime NPC spawn (mirrors scene-factory's seed
      * path): construct with a scene-bound registry, add to the scene
@@ -2898,6 +2906,8 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         this._useAi = options.useAi;
         this._logFilePath = options.logFilePath;
         this._saveFilePath = options.saveFilePath;
+        this._hostedHub = options.hostedHub === true;
+        this._saveSink = options.saveSink;
         this._owner = options.owner;
         this._anonymous = options.anonymousRunner === true;
         this._bench = options.reproBench === true;
@@ -3027,9 +3037,13 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             // and the DDP hub link (run invites, shared sessions -- Phase C)
             // warms up behind them. All fire-and-forget.
             this.startPresenceHeartbeat();
-            void import('./utilities/shared-run.js')
-                .then(m => m.ensureHubLink(this))
-                .catch(() => undefined);
+            // NOT FROM A HOSTED HUB: the DDP hub link is a terminal's line to
+            // the site, and this game already runs inside it (2026-09-12).
+            if (!this._hostedHub) {
+                void import('./utilities/shared-run.js')
+                    .then(m => m.ensureHubLink(this))
+                    .catch(() => undefined);
+            }
             // The next run starts cooking the moment you're home (player
             // request): generation takes 20-40s, and waiting for the player
             // to CALL first meant "give me a bit" every time. Draft now --
@@ -3043,7 +3057,10 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             // player explicitly calls Krow (or takes from the jobs board),
             // never automatically on load. Solo drafts on the player's own
             // key keep cooking at arrival as always.
-            if (!this._resume && this.livePartyFingerprint() === '' && this.canDraftNextScene().allowed) {
+            // NEVER FROM A HOSTED HUB (2026-09-12): on the site a draft is a
+            // generation on the site's own key, and it happens only when the
+            // player calls Krow -- not on every browser entry.
+            if (!this._resume && !this._hostedHub && this.livePartyFingerprint() === '' && this.canDraftNextScene().allowed) {
                 this.draftNextSceneInBackground();
             }
         }
@@ -3073,7 +3090,7 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             // Krow's "1 new message" ping lands mid-session as usual.
             // Same live-seat gate as the fresh-start draft above: crew work
             // is commissioned by CALLING, never by loading in.
-            if (!this._pendingRunSeed && this.livePartyFingerprint() === '' && this.canDraftNextScene().allowed) {
+            if (!this._pendingRunSeed && !this._hostedHub && this.livePartyFingerprint() === '' && this.canDraftNextScene().allowed) {
                 this.draftNextSceneInBackground();
             }
         }
@@ -3385,7 +3402,7 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         // GUARDS BEFORE THE LOGGER: the "move" beat fires from any room change,
         // including ones outside a logging session (harnesses, benches). A
         // no-op beat must cost nothing and touch nothing.
-        if (!this.initialized || this._dead || !this._saveFilePath)
+        if (!this.initialized || this._dead || (!this._saveFilePath && !this._saveSink))
             return;
         if (!this.hasHub || this.scene !== this._hubScene || !this._hubSeed)
             return;
@@ -3394,6 +3411,25 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         if (this.scene.isPlayerExchangeActive())
             return;
         const logger = Logger.getInstance();
+        // A HOSTED HUB SAVES INTO THE SINK (2026-09-12): the site writes the
+        // GameSaves doc itself. No file, no spill, no push queue -- those are
+        // a terminal's answer to a network it does not own. The sink's
+        // promise is not awaited here (a beat must not block a command);
+        // flushBoundSave awaits it for quit/evict.
+        if (this._saveSink && !this._saveFilePath) {
+            try {
+                const save = this.buildSaveFile(reason);
+                this._lastSinkWrite = Promise.resolve(this._saveSink(save, reason))
+                    .catch(err => logger.write(`Saved (${reason}) -> sink FAILED: ${err instanceof Error ? err.message : String(err)}`));
+                logger.write(`Saved (${reason}) -> sink.`);
+            }
+            catch (err) {
+                logger.write(`requestSave(${reason}) failed to build: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            return;
+        }
+        if (!this._saveFilePath)
+            return;
         try {
             const save = this.buildSaveFile(reason);
             // Carry the cloud-sync stamp FORWARD through local writes: the
@@ -3453,6 +3489,13 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
      * nothing to seal and must never be made to wait on a network.
      */
     async flushBoundSave(reason) {
+        // A HOSTED HUB: one final beat into the sink, awaited -- the caller
+        // (quit, evict, drain) needs the write to have landed.
+        if (this._saveSink && !this._saveFilePath) {
+            this.requestSave(reason);
+            await this._lastSinkWrite;
+            return true;
+        }
         if (!this.boundRunner)
             return true;
         // Take a final beat first, so the thing we seal is the state the
@@ -3490,7 +3533,12 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
                 lifestyleTier: this.lifestyleTier,
                 hubName: this._hubName,
             },
-            hubSeed: this._hubSeed,
+            // BY REFERENCE (engine 1.51.0): the stamp maka-cli.com put on the
+            // seed this session plays. An unstamped seed (a hand-written
+            // fixture, a scene handed straight to Game.getInstance) records no
+            // ref; the dual-written embed below still carries it this release.
+            hubSeedRef: hubSeedRefOf(this._hubSeed),
+            ...(DUAL_WRITE_HUB_SEED ? { hubSeed: this._hubSeed } : {}),
             player: serializePlayer(this.player),
             game: {
                 location: this.hubLocationSnapshot(),
@@ -5784,6 +5832,37 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         }
         return Game.instance;
     }
+    /**
+     * A HUB HOSTED ON maka-cli.com (headless.ts createHeadlessHub): the
+     * same boot as a terminal resume -- a Game over the served hub seed
+     * continuing `save` -- but NEVER through the singleton: one server
+     * process hosts many runners' hubs at once, and Game.instance is the
+     * one terminal's game. Pair with initEngine({ hostedHub: true, ... }).
+     */
+    static forHostedHub(player, hubSeed, save, conditionSink) {
+        const game = new Game(player, hubSeed, conditionSink);
+        game._resume = save;
+        return game;
+    }
+    /** Standing in the hub (as opposed to out on a run). */
+    get onHubScene() {
+        return this._hubScene !== undefined && this.scene === this._hubScene;
+    }
+    /**
+     * THE SAVE AS IT STANDS, for a hosting server's quit/evict/drain --
+     * the same file requestSave would write, or undefined when there is
+     * nothing to save (out on a run, dead, down). The pending run rides
+     * the last hub save, exactly as it does when a terminal quits mid-job.
+     */
+    snapshotSave(reason) {
+        if (!this.initialized || this._dead || !this.onHubScene || !this._hubSeed)
+            return undefined;
+        if (this.player.isDown() || this.player.isUnconscious())
+            return undefined;
+        return this.buildSaveFile(reason);
+    }
+    /** The last sink write in flight, awaited by flushBoundSave. */
+    _lastSinkWrite;
     /**
      * The verb the LAST handleInput actually ran, after typo correction
      * ("sjeet" -> "sheet"). ui.ts routes menu output to the Mechanics