@maka/maka-cli 5.63.1 → 5.65.0

package/bundle/typescript/src/commands/game/sideQuest/scenes/scene1.json

@@ -11,7 +11,9 @@
   ],
   "currency": {
     "type": "nuyen",
-    "authorityRoomTags": ["Bank"]
+    "authorityRoomTags": [
+      "Bank"
+    ]
   },
   "player": {
     "name": "Maka",
@@ -95,20 +97,30 @@
       }
     ]
   },
-
   "rooms": [
     {
       "name": "Barrens Apartment",
       "description": "A grimy studio in the heart of the Redmond Barrens. The synth-leather couch sags by the window, the door barely locks, and a dead mage's bookshelf still holds a few things worth having.",
-      "tags": ["residence"],
+      "tags": [
+        "residence"
+      ],
       "size": "small",
       "spots": [
-        { "name": "door" },
-        { "name": "couch" },
-        { "name": "bookshelf" }
+        {
+          "name": "door"
+        },
+        {
+          "name": "couch"
+        },
+        {
+          "name": "bookshelf"
+        }
       ],
       "supportedLifestyles": {
-        "residenceTypes": ["Street", "Squatter"]
+        "residenceTypes": [
+          "Street",
+          "Squatter"
+        ]
       },
       "exits": [
         {
@@ -121,15 +133,25 @@
     {
       "name": "Redmond Safehouse",
       "description": "A hidden bolthole where four tunnels meet at a scraped-clear entryway -- gear cache on one wall, a card sharp's abandoned bunk on the other. Every direction out of here leads somewhere that will test a different part of you.",
-      "tags": ["residence"],
+      "tags": [
+        "residence"
+      ],
       "size": "medium",
       "spots": [
-        { "name": "entryway" },
-        { "name": "gear cache" },
-        { "name": "bunk" }
+        {
+          "name": "entryway"
+        },
+        {
+          "name": "gear cache"
+        },
+        {
+          "name": "bunk"
+        }
       ],
       "supportedLifestyles": {
-        "residenceTypes": ["Low"]
+        "residenceTypes": [
+          "Low"
+        ]
       },
       "exits": [
         {
@@ -156,11 +178,17 @@
       "owner": "Mr. Krow",
       "size": "small",
       "spots": [
-        { "name": "door" },
-        { "name": "desk" }
+        {
+          "name": "door"
+        },
+        {
+          "name": "desk"
+        }
       ],
       "supportedLifestyles": {
-        "employmentRoles": ["Fixer"]
+        "employmentRoles": [
+          "Fixer"
+        ]
       },
       "exits": [
         {
@@ -172,35 +200,27 @@
     },
     {
       "name": "Lucky Chummer",
-      "description": "A neon casino buzzing with illicit energy. Cards snap at the tables, chips clatter down the bar rail, and past the entrance a velvet rope on the roped stair guards the way deeper in.",
+      "description": "A neon casino buzzing with illicit energy. Cards snap at the tables, chips clatter down the bar rail, and a frayed cord hangs across the disused stair at the back.",
       "size": "large",
       "spots": [
-        { "name": "entrance" },
-        { "name": "card tables" },
-        { "name": "bar rail" },
-        { "name": "roped stair" }
-      ],
-      "supportedLifestyles": {
-        "habitTags": ["Gambling"]
-      },
-      "exits": [
         {
-          "direction": "north",
-          "targetRoom": "Chummer Backroom",
-          "puzzle": "Velvet Rope",
-          "atSpot": "roped stair"
+          "name": "entrance"
+        },
+        {
+          "name": "card tables"
+        },
+        {
+          "name": "bar rail"
+        },
+        {
+          "name": "roped stair"
         }
-      ]
-    },
-    {
-      "name": "Chummer Backroom",
-      "description": "The counting room behind the casino floor: a battered floor safe against the safe wall, a card table of ledgers nobody audits, and the smell of old money by the door.",
-      "size": "small",
-      "spots": [
-        { "name": "door" },
-        { "name": "card table" },
-        { "name": "safe wall" }
-      ]
+      ],
+      "supportedLifestyles": {
+        "habitTags": [
+          "Gambling"
+        ]
+      }
     },
     {
       "name": "Grid Vault",
@@ -209,8 +229,15 @@
       "nodeAccess": "wired",
       "size": "small",
       "spots": [
-        { "name": "door" },
-        { "name": "server racks", "tags": ["cover-partial"] }
+        {
+          "name": "door"
+        },
+        {
+          "name": "server racks",
+          "tags": [
+            "cover-partial"
+          ]
+        }
       ]
     },
     {
@@ -219,8 +246,12 @@
       "warded": true,
       "size": "small",
       "spots": [
-        { "name": "threshold" },
-        { "name": "shrine" }
+        {
+          "name": "threshold"
+        },
+        {
+          "name": "shrine"
+        }
       ]
     }
   ],
@@ -265,10 +296,10 @@
       }
     },
     {
-      "description": "Salli Vex tends bar at the Lucky Chummer and hears everything. She won't cross Krow for free, but she likes a good talker and knows the doorman's phrase, the safe's history, and what really sits in the Grid Vault.",
+      "description": "Salli Vex tends bar at the Lucky Chummer and hears everything. She won't cross Krow for free, but she likes a good talker and knows who owes the house, how Krow plays his own table, and what really sits in the Grid Vault.",
       "dialogue": [
         "First drink's watered down. So is the second.",
-        "The rope? Toro only moves for the right words.",
+        "Krow keeps his door open. Doesn't mean you're invited through it.",
         "Everything in this place is rigged, sugar. Including me."
       ],
       "player": {
@@ -435,20 +466,6 @@
       "room": "Barrens Apartment",
       "atSpot": "bookshelf"
     },
-    {
-      "name": "Dragon Door Etiquette",
-      "description": "A slim etiquette pamphlet for the Lucky Chummer's high-roller room, dog-eared at the section on the door.",
-      "details": "The dog-eared page reads: 'Toro moves the rope for members only. Members announce themselves properly: the silver dragon says. Say it like you belong.'",
-      "size": "Small",
-      "category": "Book",
-      "shape": "Pamphlet",
-      "color": "Purple",
-      "texture": "Glossy Paper",
-      "rating": "Common",
-      "weight": 0.2,
-      "room": "Barrens Apartment",
-      "atSpot": "bookshelf"
-    },
     {
       "name": "Spare Clip",
       "description": "A boxy magazine of 10 rounds, factory-wrapped. Fits most street-caliber sidearms.",
@@ -488,20 +505,6 @@
       "room": "Redmond Safehouse",
       "atSpot": "gear cache"
     },
-    {
-      "name": "Card Sharp's Notebook",
-      "description": "A battered notebook, pages soft with handling, filled with a card sharp's private notes on the Lucky Chummer's back rooms.",
-      "details": "One page is circled twice: 'The counting-room safe still runs the house code from the old management: double or nothing. They never changed it. They never change anything.'",
-      "size": "Small",
-      "category": "Book",
-      "shape": "Rectangle",
-      "color": "Brown",
-      "texture": "Worn Leather",
-      "rating": "Common",
-      "weight": 0.3,
-      "room": "Redmond Safehouse",
-      "atSpot": "bunk"
-    },
     {
       "name": "Cuban Cigar",
       "description": "Hard to find, but delicious.",
@@ -541,43 +544,9 @@
       "weight": 0.2,
       "room": "Chapel Alcove",
       "atSpot": "shrine"
-    },
-    {
-      "name": "House Take Credstick",
-      "description": "A certified credstick straight out of the counting-room safe -- the house's own skim, still warm.",
-      "size": "Small",
-      "category": "CurrencyContainer",
-      "shape": "Rectangle",
-      "color": "Matte Black",
-      "texture": "Smooth",
-      "rating": "Standard",
-      "weight": 0.2,
-      "currencyAmount": 800
-    }
-  ],
-  "puzzles": [
-    {
-      "name": "Velvet Rope",
-      "riddle": "You see a velvet rope across the backroom stair, and Toro behind it -- two and a half meters of troll in a tailored suit. He looks through you, waiting for the members' phrase.",
-      "requiredPhrase": "the silver dragon says",
-      "successMessage": "Toro unhooks the rope without a word and looks back at nothing. You belong now.",
-      "failureMessage": "Toro's eyes narrow a millimeter. The rope stays. Somewhere a pit boss glances over.",
-      "bypassType": "con"
-    },
-    {
-      "name": "Backroom Safe",
-      "room": "Chummer Backroom",
-      "atSpot": "safe wall",
-      "riddle": "You see a battered floor safe behind the counting table, its mechanical dial worn shiny. It wants the house code.",
-      "requiredPhrase": "double or nothing",
-      "rewardItem": "House Take Credstick",
-      "requiresPuzzle": "Velvet Rope",
-      "lockedMessage": "You'd need to actually be inside the counting room's circle of trust before anyone lets you kneel at the safe.",
-      "successMessage": "The dial lands, tumblers surrender, and the house's own skim slides into your hand.",
-      "failureMessage": "The dial jams. Somewhere above, a camera swivels toward the counting room.",
-      "bypassType": "lockpick"
     }
   ],
+  "puzzles": [],
   "winCondition": {
     "type": "possess",
     "item": "Krow's Datachip",

package/bundle/typescript/src/commands/game/sideQuest/scenes/scene2.json

@@ -220,30 +220,6 @@
           "name": "back corner",
           "description": "The dim table nobody chooses by accident."
         }
-      ],
-      "exits": [
-        {
-          "direction": "north",
-          "targetRoom": "Bar Backroom",
-          "atSpot": "back corner"
-        }
-      ]
-    },
-    {
-      "name": "Bar Backroom",
-      "description": "Crates of unlabeled bottles by the door, a card table with initials knifed into it, and a wall of photographs of runners who didn't come home. Quiet enough to actually talk.",
-      "roomType": "Bar",
-      "size": "small",
-      "spots": [
-        {
-          "name": "door"
-        },
-        {
-          "name": "card table"
-        },
-        {
-          "name": "crates"
-        }
       ]
     },
     {
@@ -491,28 +467,6 @@
         {
           "name": "altar"
         }
-      ],
-      "exits": [
-        {
-          "direction": "down",
-          "targetRoom": "Chapel Crypt",
-          "puzzle": "Crypt Grate",
-          "atSpot": "altar"
-        }
-      ]
-    },
-    {
-      "name": "Chapel Crypt",
-      "description": "A dry vault below the waterline, older than the district above it. From the entry stairs, reliquary niches line the walls -- emptied long ago, almost all of them.",
-      "roomType": "Crypt",
-      "size": "tiny",
-      "spots": [
-        {
-          "name": "entry stairs"
-        },
-        {
-          "name": "reliquary niches"
-        }
       ]
     },
     {
@@ -1228,7 +1182,7 @@
     },
     {
       "name": "Wall of the Fallen Ledger",
-      "description": "A hand-bound book beneath the backroom's photographs, recording every runner the district lost and how.",
+      "description": "A hand-bound book in the bar's back corner, kept beneath a handful of pinned photographs, recording every runner the district lost and how.",
       "details": "The last page is half-filled. There is room for more names, and the handwriting changes every few years -- whoever keeps the wall, keeps it faithfully.",
       "size": "Small",
       "category": "Book",
@@ -1237,23 +1191,8 @@
       "texture": "Hand-Bound",
       "rating": "Common",
       "weight": 0.6,
-      "room": "Bar Backroom",
-      "atSpot": "card table"
-    },
-    {
-      "name": "Crypt Notes",
-      "description": "A pawned notebook of a dead urban explorer, thick with sketches of the chapel's lower level.",
-      "details": "The final sketch shows the crypt grate and its old mechanical lock, annotated: 'The verger's trick -- the tumblers answer to the saint of rust. Say it, or pick it, but the grate WILL open for the patient.'",
-      "size": "Small",
-      "category": "Book",
-      "shape": "Notebook",
-      "color": "Gray",
-      "texture": "Water-Stained",
-      "rating": "Common",
-      "weight": 0.3,
-      "room": "Union Pawnshop",
-      "atSpot": "back shelves",
-      "owner": "Whisper"
+      "room": "Purple Haze Bar",
+      "atSpot": "back corner"
     },
     {
       "name": "Chipped Credstick",
@@ -1341,33 +1280,6 @@
       "room": "Sim Den",
       "atSpot": "couch rows"
     },
-    {
-      "name": "Drowned Reliquary",
-      "description": "A small reliquary of fused glass and silver from the crypt's one unlooted niche, cold as deep water and humming with old faith.",
-      "size": "Tiny",
-      "category": "Focus",
-      "shape": "Reliquary",
-      "color": "Sea Glass",
-      "texture": "Fused Silver",
-      "rating": "Rare",
-      "weight": 0.4,
-      "room": "Chapel Crypt",
-      "atSpot": "reliquary niches"
-    },
-    {
-      "name": "Tarnished Credstick",
-      "description": "A pre-flood credstick from the crypt floor, miraculously still certified.",
-      "size": "Small",
-      "category": "CurrencyContainer",
-      "shape": "Cylinder",
-      "color": "Tarnished",
-      "texture": "Corroded",
-      "rating": "Common",
-      "weight": 0.2,
-      "currencyAmount": 300,
-      "room": "Chapel Crypt",
-      "atSpot": "reliquary niches"
-    },
     {
       "name": "Torque's Commlink",
       "description": "A ruggedized shop commlink, speed-dial worn down to the metal -- Torque answers for paying customers.",
@@ -1453,14 +1365,5 @@
       "transferable": false
     }
   ],
-  "puzzles": [
-    {
-      "name": "Crypt Grate",
-      "riddle": "You see a rust-welded iron grate in the chapel floor, its old mechanical lock built to answer a spoken verger's phrase -- or a very patient set of picks.",
-      "requiredPhrase": "the saint of rust",
-      "successMessage": "The tumblers grind through decades of corrosion and the grate swings up on screaming hinges.",
-      "failureMessage": "The mechanism seizes. Flakes of rust drift down into the dark, and the Choir's song falters for a beat.",
-      "bypassType": "lockpick"
-    }
-  ]
+  "puzzles": []
 }

package/bundle/typescript/src/commands/game/sideQuest/types/save-file.d.ts

@@ -166,6 +166,30 @@ export interface ISavedHub {
     /** Seed NPCs absent from the live scene (killed) -- removed QUIETLY
      *  on load; their dropped gear is already in the room overlays. */
     deadActors: string[];
+    /** Devices by name, and the whole of their state. `bypassBurned`
+     *  went with the puzzle mechanic -- a lock you failed to force is a
+     *  lock you can try again. */
+    devices: {
+        name: string;
+        open: boolean;
+    }[];
+    /**
+     * A TOMBSTONE, always written as [], never read by this build.
+     *
+     * It exists for an OLDER READER, not for us. v5.64.0 is shipped, and
+     * its persistence.ts line 530 is `for (const p of saved.puzzles)`
+     * with no guard -- so a save written without this field makes that
+     * build throw "saved.puzzles is not iterable" on resume. Not
+     * degraded: a hard crash.
+     *
+     * And saves MOVE. cloud-saves.ts mirrors the whole ISaveFileV1
+     * including this overlay, so a player on two machines, a rollback,
+     * or a server pin lagging the client all put a new save in front of
+     * an old reader.
+     *
+     * SAFE TO DELETE only once v5.64.0 is out of the wild -- check
+     * before you do; nothing in THIS build will fail if you remove it.
+     */
     puzzles: {
         name: string;
         solved: boolean;

package/bundle/typescript/src/commands/game/sideQuest/types/seed/device-seed.d.ts

@@ -0,0 +1,52 @@
+/**
+ * A DEVICE IN A ROOM -- the seed shape that replaces the old puzzles[].
+ *
+ * The user's framing is the specification: "A lock is not a puzzle, it
+ * has a key. A keypad has an interface (to use). An NPC in the doorway
+ * can be persuaded/bluffed/conned to move aside. A persistent forcewall
+ * can be dispelled."
+ *
+ * Three of those four are DEVICES; the fourth is a person and has no
+ * entry here on purpose (see npcs[].guarding / npcs[].passphrase).
+ *
+ * A DEVICE ALWAYS BELONGS TO A ROOM. There is no "attached to a door"
+ * form, because a keypad beside a grate stands in one room -- the one
+ * you must be in to reach it. The puzzle shape allowed both, and the
+ * cost was two validators that had to agree, a normaliser between them,
+ * and a placement fault the comments record as killing two consecutive
+ * generations.
+ */
+export type DeviceSeedKind = 'lock' | 'panel' | 'ward';
+export interface IDeviceSeedJson {
+    name: string;
+    /** MANDATORY. What the player sees when they look at it. Optional
+     *  descriptions are how a barrier ended up rendering the literal
+     *  string "undefined" into an NPC's prompt. */
+    description: string;
+    kind: DeviceSeedKind;
+    /**
+     * The credential that opens it -- ONLY valid on a 'panel'.
+     *
+     * User ruling, verbatim: "if it's a _mechanical_ lock, it has a key
+     * or can be picked. You can't talk at a _mechanical_ lock." A lock
+     * opens by key or by force; a ward answers to the Art. Neither has
+     * anything to hear a phrase with, and the migration drops a code off
+     * anything that is not a panel.
+     */
+    code?: string;
+    /** Item name that opens it outright -- a keycard, a physical key. */
+    keyItem?: string;
+    /** Item name handed over when it opens (a safe's contents). */
+    grantsItem?: string;
+    /** "At" spot of its room that it physically stands at. */
+    atSpot?: string;
+    /** The exit OF ITS OWN ROOM that opening this device unseals. The
+     *  door starts locked and the device is what unlocks it. */
+    opensExit?: string;
+    /** Terrain this device's footprint seals on the room grid, if it is
+     *  physically in the way (rubble, a shutter). */
+    guardsExit?: string;
+    footprint?: 'small' | 'medium' | 'large';
+    openMessage?: string;
+    refuseMessage?: string;
+}

package/bundle/typescript/src/commands/game/sideQuest/types/seed/device-seed.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=device-seed.js.map

package/bundle/typescript/src/commands/game/sideQuest/types/seed/device-seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-seed.js","sourceRoot":"","sources":["../../../../../../../../src/commands/game/sideQuest/types/seed/device-seed.ts"],"names":[],"mappings":""}

package/bundle/typescript/src/commands/game/sideQuest/types/seed/legacy-puzzle-seed.d.ts

@@ -0,0 +1,63 @@
+/**
+ * THE SHAPE OF AN OLD SEED, kept only so it can be TRANSLATED.
+ *
+ * This is not a live seed type. The puzzle mechanic is gone (2026-08-27
+ * -- barriers are room-owned Devices worked by the verb that suits the
+ * thing; see types/seed/device-seed.ts). Nothing in the engine consumes
+ * a puzzle any more.
+ *
+ * It survives for exactly one reader: factories/seed-migration.ts,
+ * which converts `puzzles[]` into devices and guards on the way in. And
+ * it has to keep surviving, because a seed is not only a file on disk
+ * -- every save EMBEDS its hub seed, so a returning player's save
+ * carries a puzzles[] array written by a build that still had them.
+ *
+ * >>> DELETE THIS FILE WHEN no save in the wild still embeds a
+ * >>> puzzles[] hubSeed. Until then it is load-bearing, and the import
+ * >>> line in seed-migration.ts is the only place it should appear.
+ *
+ * It is named and located to make that status legible: a file called
+ * `puzzle-seed.ts` sitting in types/seed/ beside the live types reads
+ * as current to anyone browsing, which is how a dead mechanic keeps
+ * looking alive.
+ *
+ * ---- what the fields meant, for whoever is reading a legacy seed ----
+ *
+ * `bypassType` was the risky route past a barrier. "con" used to be in
+ * that union too, for barriers that were "really a person or a
+ * voice-gate", and it went first (player ruling: "'bluff' shouldn't
+ * work on Barriers like locks/wards/etc ... NPCs can be barriers").
+ * That was the modelling correction the rest of this file eventually
+ * followed: a lock has no opinion to change, and making a PERSON into
+ * a Puzzle dragged them through machinery that made no sense for a
+ * human being. The migration reads these values one last time and maps
+ * them to a device kind, or to a guarding NPC.
+ */
+export type LegacyPuzzleBypassType = 'lockpick' | 'hack' | 'spell';
+export interface ILegacyPuzzleSeedJson {
+    name: string;
+    room?: string;
+    riddle: string;
+    requiredPhrase?: string;
+    requiredItem?: string;
+    rewardItem?: string;
+    successMessage?: string;
+    failureMessage?: string;
+    hobbyTags?: string[];
+    /** Name of another puzzle in this same scene that must be solved first. */
+    requiresPuzzle?: string;
+    /** Shown when attempting to solve this puzzle before requiresPuzzle is met. */
+    lockedMessage?: string;
+    /**
+     * Optional risky alternate route to the same reward, matching this
+     * barrier's in-fiction nature (a lock -> "pick", a terminal -> "hack", a
+     * ward -> "cast") -- a coin-flip chance to bypass without ever knowing
+     * requiredPhrase, but a failed attempt is loud (see Puzzle.attemptBypass).
+     * Leave unset for a puzzle with no such physical/technical/magical route
+     * (e.g. a purely social one, solvable only by knowing the actual answer).
+     */
+    bypassType?: LegacyPuzzleBypassType;
+    atSpot?: string;
+    guardsExit?: string;
+    footprint?: 'small' | 'medium' | 'large';
+}

package/bundle/typescript/src/commands/game/sideQuest/types/seed/legacy-puzzle-seed.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=legacy-puzzle-seed.js.map

package/bundle/typescript/src/commands/game/sideQuest/types/seed/legacy-puzzle-seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-puzzle-seed.js","sourceRoot":"","sources":["../../../../../../../../src/commands/game/sideQuest/types/seed/legacy-puzzle-seed.ts"],"names":[],"mappings":""}

package/bundle/typescript/src/commands/game/sideQuest/types/seed/player-seed.d.ts

@@ -45,6 +45,12 @@ export interface IPlayerSeedJson {
     name: string;
     startLocation: string;
     startSpot?: string;
+    /** This NPC HOLDS their position against passage -- a doorman, a
+     *  picket. Combined with a startSpot on a doorway, it makes them a
+     *  barrier you cannot walk through (see Player.guarding and
+     *  utilities/spots.ts holdsGround). The way past is social or
+     *  violent, never a lockpick. */
+    guarding?: boolean;
     lifestyleChoices: LifestyleChoice[];
     startingItems?: IItemSeedJson[];
     combat?: ICombatSeedJson;

package/bundle/typescript/src/commands/game/sideQuest/types/seed/room-seed.d.ts

@@ -1,3 +1,4 @@
+import { IDeviceSeedJson } from './device-seed.js';
 import { IExitSeedJson } from './exit-seed.js';
 import { RoomSize, SpotPlace, IGridSynthesisLevel } from '../../utilities/room-grid.js';
 export interface IRoomSeedJson {
@@ -8,6 +9,9 @@ export interface IRoomSeedJson {
     owner?: string;
     tags?: string[];
     exits: IExitSeedJson[];
+    /** Devices standing in THIS room (see types/seed/device-seed.ts).
+     *  Always room-owned -- there is no device-on-a-door form. */
+    devices?: IDeviceSeedJson[];
     reachable?: boolean;
     hasNode?: boolean;
     nodeAccess?: 'wireless' | 'wired';

package/bundle/typescript/src/commands/game/sideQuest/types/seed/scene-seed.d.ts

@@ -1,7 +1,7 @@
 import { IRoomSeedJson } from './room-seed.js';
 import { INPCSeedJson } from './npc-seed.js';
 import { IItemSeedJson } from './item-seed.js';
-import { IPuzzleSeedJson } from './puzzle-seed.js';
+import { ILegacyPuzzleSeedJson } from './legacy-puzzle-seed.js';
 import { IPlayerSeedJson } from './player-seed.js';
 import { IWinConditionSeedJson } from './win-condition-seed.js';
 export interface ISceneSeedJson {
@@ -13,7 +13,8 @@ export interface ISceneSeedJson {
     rooms: IRoomSeedJson[];
     npcs: INPCSeedJson[];
     items: IItemSeedJson[];
-    puzzles: IPuzzleSeedJson[];
+    /** LEGACY, migrated away on load -- see legacy-puzzle-seed.ts. */
+    puzzles: ILegacyPuzzleSeedJson[];
     residenceTiers: string[];
     story: string;
     /** The logging-in player who will be actively controlled */