@maka/maka-cli 5.108.0 → 5.110.0

package/bundle/typescript/src/commands/game/sideQuest/factories/room-factory.d.ts

@@ -1,6 +1,34 @@
-import { Room } from '../models/_index.js';
+import { Room, IRoomConstructorConfig } from '../models/_index.js';
 import { IRoomSeedJson } from '../types/seed/room-seed.js';
+import type { IRoomGrid } from '../utilities/room-grid.js';
 export declare class RoomFactory {
     createRoomFromJson(config: IRoomSeedJson): Promise<Room>;
-    private convertToRoomConfigFromJson;
+    convertToRoomConfigFromJson(roomJson: IRoomSeedJson): IRoomConstructorConfig;
 }
+/**
+ * THE ONE-ASSEMBLER GRID EXPORT (maka-cli.com contract, 2026-09-01).
+ *
+ * The web sheet renders a room's true geometry from the save's embedded
+ * hub seed. Grid synthesis is deterministic (room-grid.ts's contract),
+ * but the INPUT ASSEMBLY is not trivially so -- ensureGrid resolves
+ * declared exit bindings and kind-matched doorways, and this engine has
+ * already paid twice for a second assembler drifting (the direction-
+ * blind doorway bug, the centroid hub bug -- both documented in
+ * ensureGrid). So the web calls THIS, which builds the room from its
+ * seed exactly as the scene factory does -- same whitelist, same
+ * declared-binding rule (scene-factory.ts:202) -- and asks the room's
+ * OWN ensureGrid. One assembler; a wrapper, not a re-implementation.
+ *
+ * Exit values are the seed's target-room NAMES (Room.exits accepts
+ * strings; ensureGrid only reads the direction keys), so no Door
+ * machinery and no neighbor rooms are needed. terrainHints stay
+ * whatever the Room ctor derives -- a fresh-from-seed room has no
+ * device-opened regions, which matches a fresh boot; a mid-session
+ * device unlock changes walkability, not walls/spots/doors, so the
+ * rendered geometry stays honest either way.
+ *
+ * Caller must be inside a session context (Room construction resolves
+ * the ambient logger) -- the web's runInSession wrapper, as with the
+ * character factory.
+ */
+export declare function roomGridFromSeed(seed: IRoomSeedJson): IRoomGrid | undefined;

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

@@ -5,6 +5,8 @@ export class RoomFactory {
         const room = new Room(roomConfig);
         return room;
     }
+    // Public since the roomGridFromSeed export below reuses it -- the same
+    // whitelist building the same config, which is the whole point.
     convertToRoomConfigFromJson(roomJson) {
         return {
             name: roomJson.name,
@@ -31,4 +33,41 @@ export class RoomFactory {
         };
     }
 }
+/**
+ * THE ONE-ASSEMBLER GRID EXPORT (maka-cli.com contract, 2026-09-01).
+ *
+ * The web sheet renders a room's true geometry from the save's embedded
+ * hub seed. Grid synthesis is deterministic (room-grid.ts's contract),
+ * but the INPUT ASSEMBLY is not trivially so -- ensureGrid resolves
+ * declared exit bindings and kind-matched doorways, and this engine has
+ * already paid twice for a second assembler drifting (the direction-
+ * blind doorway bug, the centroid hub bug -- both documented in
+ * ensureGrid). So the web calls THIS, which builds the room from its
+ * seed exactly as the scene factory does -- same whitelist, same
+ * declared-binding rule (scene-factory.ts:202) -- and asks the room's
+ * OWN ensureGrid. One assembler; a wrapper, not a re-implementation.
+ *
+ * Exit values are the seed's target-room NAMES (Room.exits accepts
+ * strings; ensureGrid only reads the direction keys), so no Door
+ * machinery and no neighbor rooms are needed. terrainHints stay
+ * whatever the Room ctor derives -- a fresh-from-seed room has no
+ * device-opened regions, which matches a fresh boot; a mid-session
+ * device unlock changes walkability, not walls/spots/doors, so the
+ * rendered geometry stays honest either way.
+ *
+ * Caller must be inside a session context (Room construction resolves
+ * the ambient logger) -- the web's runInSession wrapper, as with the
+ * character factory.
+ */
+export function roomGridFromSeed(seed) {
+    const room = new Room(new RoomFactory().convertToRoomConfigFromJson(seed));
+    for (const exit of seed.exits ?? []) {
+        const dir = exit.direction.toLowerCase();
+        room.exits.set(dir, exit.targetRoom);
+        const atSpot = exit.atSpot;
+        if (atSpot)
+            room.exitSpots.set(dir, atSpot);
+    }
+    return room.ensureGrid();
+}
 //# sourceMappingURL=room-factory.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"room-factory.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/factories/room-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAA0B,MAAM,qBAAqB,CAAC;AAGnE,MAAM,OAAO,WAAW;IACtB,KAAK,CAAC,kBAAkB,CAAC,MAAqB;QAC5C,MAAM,UAAU,GAA2B,IAAI,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC;QACpF,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,2BAA2B,CAAC,QAAuB;QACzD,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE;YACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,gEAAgE;YAChE,+DAA+D;YAC/D,iCAAiC;YACjC,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,+DAA+D;YAC/D,6DAA6D;YAC7D,2CAA2C;YAC3C,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;SAClD,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"room-factory.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/factories/room-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAA0B,MAAM,qBAAqB,CAAC;AAKnE,MAAM,OAAO,WAAW;IACtB,KAAK,CAAC,kBAAkB,CAAC,MAAqB;QAC5C,MAAM,UAAU,GAA2B,IAAI,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC;QACpF,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uEAAuE;IACvE,gEAAgE;IAChE,2BAA2B,CAAC,QAAuB;QACjD,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE;YACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,gEAAgE;YAChE,+DAA+D;YAC/D,iCAAiC;YACjC,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,+DAA+D;YAC/D,6DAA6D;YAC7D,2CAA2C;YAC3C,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;SAClD,CAAC;IACJ,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAmB;IAClD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAe,CAAC;QACtD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,MAAM,GAAI,IAA4B,CAAC,MAAM,CAAC;QACpD,IAAI,MAAM;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;AAC3B,CAAC"}

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

@@ -4,7 +4,7 @@ import { dirname } from 'path';
 import { capitalCase } from 'change-case';
 import { Category, Size, Rating } from './types/shared/item-enum.js';
 import { Item } from './models/item.js';
-import { Room } from './models/_index.js';
+import { Room, Container } from './models/_index.js';
 import { Door } from './models/door.js';
 import { SAVE_VERSION } from './types/save-file.js';
 import { serializePlayer, restorePlayer, captureHubOverlay, applyHubOverlay, writeSaveAtomic, deleteSave, restoreItem, readSave, serializeItem, saveSlug, spillPathFor, } from './utilities/persistence.js';
@@ -51,6 +51,7 @@ import { SearchCommand } from './commands/search.js';
 import { SayCommand } from './commands/say.js';
 import { TalkCommand } from './commands/talk.js';
 import { StoreCommand } from './commands/store.js';
+import { OpenCommand, CloseCommand, PutCommand } from './commands/container-verbs.js';
 import { GiveCommand } from './commands/give.js';
 import { ReadCommand } from './commands/read.js';
 import { KillCommand } from './commands/kill.js';
@@ -2225,6 +2226,12 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         CommandFactory.registerCommand('search', SearchCommand);
         CommandFactory.registerCommand('say', SayCommand);
         CommandFactory.registerCommand('store', StoreCommand);
+        // CONTAINERS (increment 1, 2026-09-01): open/close/put claimed --
+        // unclaimed, they fell to the typo-matcher (the jackpoint lesson).
+        // "take <x> from <c>" rides the take verb; `stow` belongs to holster.
+        CommandFactory.registerCommand('open', OpenCommand);
+        CommandFactory.registerCommand('close', CloseCommand);
+        CommandFactory.registerCommand('put', PutCommand);
         CommandFactory.registerCommand('talk-to', TalkCommand);
         CommandFactory.registerCommand('give', GiveCommand);
         CommandFactory.registerCommand('read', ReadCommand);
@@ -2637,6 +2644,19 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             description: this.lifestyle.homeDescription,
             roomType: 'Residence',
         });
+        // THE FOOTLOCKER (containers increment 1, 2026-09-01): the secure
+        // stash's tangible face. secureFor makes it the player's alone; its
+        // contents persist as ISavedHub.home.secureStash (the key that
+        // round-tripped empty for every save ever written -- the stash was
+        // dead code until this furniture arrived to be its body). Boots
+        // SHUT each session, like a fresh Device. Game-created beside the
+        // room, never seeded -- the room is code-owned, its contents are
+        // save-owned.
+        this._homeRoom.containers.push(new Container({
+            name: 'Footlocker',
+            description: 'A battered steel footlocker, bolted to the floor -- the one place in the sprawl that answers to you alone.',
+            secureFor: this.player.name,
+        }));
         // SHARED RUNS (server-hosted, headless.ts): the crew RODE to the
         // jobsite -- nobody's cot is stapled to it, and the leader arrives
         // AT the job like every joiner (2026-08-24 playtest: the leader
@@ -5403,7 +5423,7 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
      */
     static HELP_CATEGORIES = [
         { title: 'moving', entries: [['look'], ['go'], ['move', 'walk', 'approach'], ['run'], ['sprint'], ['climb', 'mantle', 'scale', 'clamber'], ['descend'], ['sit', 'kneel'], ['lie', 'prone'], ['stand'], ['follow'], ['unfollow'], ['map', 'exits'], ['search'], ['sneak']] },
-        { title: 'gear', entries: [['inv', 'inventory'], ['equipment', 'eq'], ['take'], ['loot'], ['drop'], ['give'], ['store'], ['equip'], ['unequip'], ['brandish', 'draw'], ['holster', 'stow'], ['reload'], ['use'], ['read']] },
+        { title: 'gear', entries: [['inv', 'inventory'], ['equipment', 'eq'], ['take'], ['loot'], ['drop'], ['give'], ['store'], ['open'], ['close'], ['put'], ['equip'], ['unequip'], ['brandish', 'draw'], ['holster', 'stow'], ['reload'], ['use'], ['read']] },
         { title: 'combat', entries: [['attack'], ['kill'], ['subdue'], ['grapple', 'restrain', 'clinch'], ['struggle'], ['release'], ['cover'], ['stance'], ['surrender'], ['edge'], ['rest'], ['heal', 'firstaid', 'bandage', 'patch']] },
         // The party layer: everyone who walks (or flies, or manifests) at
         // your side answers to these.