@maka/maka-cli 5.68.0 → 5.69.0

package/bundle/typescript/src/commands/game/sideQuest/utilities/dice.d.ts

@@ -8,11 +8,51 @@
 export interface IDiceRoll {
     pool: number;
     rolls: number[];
+    /** Hits that COUNT -- after any limit has capped them. */
     hits: number;
+    /** Hits the dice actually showed, before the limit. Equal to `hits`
+     *  on an unlimited test. */
+    rawHits: number;
+    /** The cap that applied, when one did. */
+    limit?: number;
+    /** Whether the cap actually BOUND -- i.e. threw hits away. A limit
+     *  that never binds is indistinguishable from no limit, so this is
+     *  what lets a reader (and a play-tester) tell them apart. */
+    limited: boolean;
+    /** A limit of zero or less reached rollPool. That is a CALLER BUG --
+     *  no SR5 limit is ever zero -- so the limit is ignored rather than
+     *  silently making the test unwinnable, and this says so out loud
+     *  through formatRoll. */
+    limitIgnored: boolean;
     glitch: boolean;
     criticalGlitch: boolean;
 }
-export declare function rollPool(pool: number): IDiceRoll;
+/**
+ * LIMITS (SR5 p.46-47). A limit caps the number of hits you may COUNT
+ * from a test; it is never a die added to the pool. The book writes it
+ * in brackets -- `Hacking + Logic [Sleaze]` -- and p.244 files the
+ * whole Matrix action list by which limit it uses.
+ *
+ * It caps RAW hits, before an opposed test subtracts the defender's,
+ * and net hits are then taken from the capped number (p.46-47, worked
+ * through at p.195). It is NOT applied to the defender: limits apply
+ * only to pools built from a skill plus an attribute, and a defence
+ * like Intuition + Firewall has no skill in it (p.46-47, and the melee
+ * example at p.174 -- "no limit because there is no skill involved").
+ * So callers pass a limit on the ACTING roll only.
+ *
+ * GLITCHES ARE UNAFFECTED, and half of that is canon while half is a
+ * decision this engine had to make. A glitch is more than half the dice
+ * showing 1 (p.45-46) -- nothing to do with hits, so a limit cannot
+ * touch it. A CRITICAL glitch is a glitch with no hit achieved, and the
+ * book does not say whether a hit thrown away by a limit still counts
+ * as achieved. Asked directly and the rulebooks are silent, so rather
+ * than invent a rule this reads the RAW dice: you rolled a 5, you
+ * achieved a hit, the limit only stopped you counting it. In practice
+ * the two readings never diverge -- a real limit is at least 1, so a
+ * roll with any raw hit keeps at least one counted hit.
+ */
+export declare function rollPool(pool: number, limit?: number): IDiceRoll;
 /**
  * One-line render of a roll for the game log, e.g.: "8d6 -> 4 hits"
  * Pool and hits only. The individual faces have been through two

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

@@ -5,18 +5,53 @@
  * (it went ugly AND you failed). Pure functions, no game-state knowledge --
  * combat resolution lives in commands/attack.ts.
  */
-export function rollPool(pool) {
+/**
+ * LIMITS (SR5 p.46-47). A limit caps the number of hits you may COUNT
+ * from a test; it is never a die added to the pool. The book writes it
+ * in brackets -- `Hacking + Logic [Sleaze]` -- and p.244 files the
+ * whole Matrix action list by which limit it uses.
+ *
+ * It caps RAW hits, before an opposed test subtracts the defender's,
+ * and net hits are then taken from the capped number (p.46-47, worked
+ * through at p.195). It is NOT applied to the defender: limits apply
+ * only to pools built from a skill plus an attribute, and a defence
+ * like Intuition + Firewall has no skill in it (p.46-47, and the melee
+ * example at p.174 -- "no limit because there is no skill involved").
+ * So callers pass a limit on the ACTING roll only.
+ *
+ * GLITCHES ARE UNAFFECTED, and half of that is canon while half is a
+ * decision this engine had to make. A glitch is more than half the dice
+ * showing 1 (p.45-46) -- nothing to do with hits, so a limit cannot
+ * touch it. A CRITICAL glitch is a glitch with no hit achieved, and the
+ * book does not say whether a hit thrown away by a limit still counts
+ * as achieved. Asked directly and the rulebooks are silent, so rather
+ * than invent a rule this reads the RAW dice: you rolled a 5, you
+ * achieved a hit, the limit only stopped you counting it. In practice
+ * the two readings never diverge -- a real limit is at least 1, so a
+ * roll with any raw hit keeps at least one counted hit.
+ */
+export function rollPool(pool, limit) {
     const size = Math.max(0, Math.floor(pool));
     const rolls = Array.from({ length: size }, () => 1 + Math.floor(Math.random() * 6));
-    const hits = rolls.filter(r => r >= 5).length;
+    const rawHits = rolls.filter(r => r >= 5).length;
     const ones = rolls.filter(r => r === 1).length;
     const glitch = size > 0 && ones > size / 2;
+    const capped = limit !== undefined && Number.isFinite(limit) && limit > 0;
+    const limitIgnored = limit !== undefined && !capped;
+    const hits = capped ? Math.min(rawHits, Math.floor(limit)) : rawHits;
     return {
         pool: size,
         rolls,
         hits,
+        rawHits,
+        limit: capped ? Math.floor(limit) : undefined,
+        limited: capped && hits < rawHits,
+        limitIgnored,
+        // RAW hits on purpose -- see the note above: the book defines a
+        // critical glitch as a glitch with no hit achieved and is silent on
+        // whether a limit un-achieves one.
+        criticalGlitch: glitch && rawHits === 0,
         glitch,
-        criticalGlitch: glitch && hits === 0,
     };
 }
 /**
@@ -32,6 +67,19 @@ export function formatRoll(roll) {
     if (roll.pool === 0)
         return '0d6 -> no dice to roll';
     const glitchTag = roll.criticalGlitch ? ' -- CRITICAL GLITCH' : roll.glitch ? ' -- glitch' : '';
-    return `${roll.pool}d6 -> ${roll.hits} hit${roll.hits === 1 ? '' : 's'}${glitchTag}`;
+    // THE LIMIT HAS TO BE VISIBLE, and especially when it BOUND. A cap
+    // that never shows is indistinguishable from no cap, which is exactly
+    // the check-whose-two-sides-fail-together shape: a play-tester could
+    // not tell a limited engine from an unlimited one, and neither could
+    // a bench. So an unbound limit is shown quietly and a bound one says
+    // what it threw away.
+    const limitTag = roll.limitIgnored
+        ? ` [LIMIT IGNORED -- a caller computed one that is not a limit]`
+        : roll.limited
+            ? ` -- LIMITED to ${roll.limit} (${roll.rawHits} rolled)`
+            : roll.limit !== undefined
+                ? ` [limit ${roll.limit}]`
+                : '';
+    return `${roll.pool}d6 -> ${roll.hits} hit${roll.hits === 1 ? '' : 's'}${limitTag}${glitchTag}`;
 }
 //# sourceMappingURL=dice.js.map

package/bundle/typescript/src/commands/game/sideQuest/utilities/dice.js.map

@@ -1 +1 @@
-{"version":3,"file":"dice.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/utilities/dice.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC;IAE3C,OAAO;QACL,IAAI,EAAE,IAAI;QACV,KAAK;QACL,IAAI;QACJ,MAAM;QACN,cAAc,EAAE,MAAM,IAAI,IAAI,KAAK,CAAC;KACrC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,IAAe;IACxC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,wBAAwB,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAChG,OAAO,GAAG,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,SAAS,EAAE,CAAC;AACvF,CAAC"}
+{"version":3,"file":"dice.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/utilities/dice.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,KAAc;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IACjD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC;IAE3C,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;IAC1E,MAAM,YAAY,GAAG,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAErE,OAAO;QACL,IAAI,EAAE,IAAI;QACV,KAAK;QACL,IAAI;QACJ,OAAO;QACP,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7C,OAAO,EAAE,MAAM,IAAI,IAAI,GAAG,OAAO;QACjC,YAAY;QACZ,gEAAgE;QAChE,oEAAoE;QACpE,mCAAmC;QACnC,cAAc,EAAE,MAAM,IAAI,OAAO,KAAK,CAAC;QACvC,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,IAAe;IACxC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,wBAAwB,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAChG,mEAAmE;IACnE,sEAAsE;IACtE,qEAAqE;IACrE,qEAAqE;IACrE,qEAAqE;IACrE,sBAAsB;IACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY;QAChC,CAAC,CAAC,+DAA+D;QACjE,CAAC,CAAC,IAAI,CAAC,OAAO;YACZ,CAAC,CAAC,kBAAkB,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,OAAO,UAAU;YACzD,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS;gBACxB,CAAC,CAAC,WAAW,IAAI,CAAC,KAAK,GAAG;gBAC1B,CAAC,CAAC,EAAE,CAAC;IACX,OAAO,GAAG,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,QAAQ,GAAG,SAAS,EAAE,CAAC;AAClG,CAAC"}

package/bundle/typescript/src/commands/game/sideQuest/utilities/grid-view.d.ts

@@ -9,7 +9,7 @@ import { Scene } from '../models/scene.js';
  * exits, prose places -- is deliberately absent: if it isn't
  * broadcasting, it isn't here. Shared by look.ts (gridLook) and go.ts
  * (grid-jump arrivals). Glyphs match the grid map: ● host, ■
- * air-gapped, ◆ persona, ▣ PAN, ◇ data.
+ * air-gapped, ◆ persona, ▣ PAN, ▲ dangerous device, ◇ data.
  */
 export declare function gridIcons(scene: Scene, actor: Player, room: Room): string[];
 /**

package/bundle/typescript/src/commands/game/sideQuest/utilities/grid-view.js

@@ -9,20 +9,26 @@ import { isWatched, camerasLive, canSnoopFeeds } from './surveillance.js';
  * exits, prose places -- is deliberately absent: if it isn't
  * broadcasting, it isn't here. Shared by look.ts (gridLook) and go.ts
  * (grid-jump arrivals). Glyphs match the grid map: ● host, ■
- * air-gapped, ◆ persona, ▣ PAN, ◇ data.
+ * air-gapped, ◆ persona, ▣ PAN, ▲ dangerous device, ◇ data.
  */
 export function gridIcons(scene, actor, room) {
     const icons = [];
     if (room.hasNode) {
+        // A HOST IS DESCRIBED BY ITS RATING (SR5 p.247; Deditri,
+        // BTyfgybBnD2hjDmoN). It rides every read of a host, including the
+        // air-gapped one -- you can see that a host is there and how heavy
+        // it is without having a way in, which is exactly the decision the
+        // rating is for.
+        const hr = ` {bold}[HR ${room.hostRating}]{/bold}`;
         if (!canReachHost(actor, room)) {
-            icons.push(`■ The ${room.name} host -- DARK. Air-gapped: it only opens to a hard line ("jack in" from inside this room).`);
+            icons.push(`■ The ${room.name} host${hr} -- DARK. Air-gapped: it only opens to a hard line ("jack in" from inside this room).`);
         }
         else if (room.hostCracked) {
-            icons.push(`● The ${room.name} host -- cracked open, security in shreds. Whatever it guarded is unsealed.`);
+            icons.push(`● The ${room.name} host${hr} -- cracked open, security in shreds. Whatever it guarded is unsealed.`);
         }
         else {
             const myMarks = room.hostMarksBy.get(actor.name) ?? 0;
-            icons.push(`● The ${room.name} host -- sculpted ice geometry over the room's systems.${room.hostAlert ? ' Walls UP -- it holds a mark on an intruder.' : ''}${myMarks > 0 ? ` [your marks: ${myMarks}/3]` : ''} ("hack" slips in on sleaze; "hack loud" smashes; "mark" softens it first)`);
+            icons.push(`● The ${room.name} host${hr} -- sculpted ice geometry over the room's systems.${room.hostAlert ? ' Walls UP -- it holds a mark on an intruder.' : ''}${myMarks > 0 ? ` [your marks: ${myMarks}/3]` : ''} ("hack" slips in on sleaze; "hack loud" smashes; "mark" softens it first)`);
         }
     }
     for (const a of scene.getActorsInRoom(room)) {
@@ -46,9 +52,16 @@ export function gridIcons(scene, actor, room) {
             // into a single PAN icon, and that icon "often looks similar to
             // the physical device that serves as the master" (p.219). The PAN
             // is exactly what you see; the master is exactly what it is
-            // shaped like. (The book's own exception -- an interesting or
-            // dangerous device, a wireless gun, breaking out as its own icon
-            // -- is NOT modelled here and is on the board, not smuggled in.)
+            // shaped like.
+            //
+            // THE BOOK'S EXCEPTION IS NOW MODELLED, one icon down: "Some
+            // devices are not merged into the single PAN icon; if an
+            // individual is carrying a wireless-enabled gun -- or any other
+            // wireless device that might kill you -- it will show up
+            // separately so that it can be identified rapidly" (p.219, and
+            // p.217-218 "exceptions for interesting or dangerous devices in
+            // that network, such as a gun"). Confirmed against the book
+            // directly rather than taken secondhand (AKfemBJJWJP99nx8K).
             //
             // What the report was right about is that this line never SAID
             // any of that, so an icon labelled with someone's whole network
@@ -60,6 +73,31 @@ export function gridIcons(scene, actor, room) {
             if (master) {
                 const myMarks = a.panMarksBy.get(actor.name) ?? 0;
                 icons.push(`▣ ${a.name}'s PAN -- one icon, sculpted like the ${master.name} that masters it, everything else they carry folded inside.${myMarks > 0 ? ` [your marks: ${myMarks}/3]` : ''} ("look ${a.name}" reads the shape; "hack ${a.name}" cracks it open)`);
+                // THE GUN BREAKS OUT (p.219). Deliberately NOT gated behind a
+                // mark, unlike the PAN's contents: the whole point of the
+                // exception is that a dangerous device "can be identified
+                // rapidly", and a decker who has to crack a network first to
+                // learn the man across the room is armed has been told the
+                // opposite of what the book promises. Everything else that
+                // person carries stays folded inside the icon above.
+                //
+                // SAME SELECTOR AS hack.ts's top-priority PAN effect, on
+                // purpose: the icon must name exactly the device the verb will
+                // seize, or "identified rapidly" points at the wrong thing.
+                // This engine treats a held firearm as smartlinked -- there is
+                // no separate wireless flag on Item -- so held-and-a-firearm is
+                // the whole test, and the two surfaces agree by construction.
+                //
+                // Sitting INSIDE the isLinked branch is what makes running
+                // silent hide it, which is canon too: the book notes a user can
+                // hide these icons, and isLinked() is already false while
+                // silent. No second rule needed.
+                const gun = a.equipment.rightHand?.weapon ?? a.equipment.leftHand?.weapon;
+                if (gun?.isFirearm()) {
+                    icons.push(gun.jammed
+                        ? `▲ ${a.name}'s ${gun.name} -- its own icon beside the PAN, smartlink DEAD. Already seized; it will not fire until they reboot.`
+                        : `▲ ${a.name}'s ${gun.name} -- its own icon beside the PAN. A wireless gun does not hide inside a network: it is flagged so it can be seen fast. ("hack ${a.name}" seizes the smartlink)`);
+                }
             }
         }
     }

package/bundle/typescript/src/commands/game/sideQuest/utilities/grid-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"grid-view.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/utilities/grid-view.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"grid-view.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/utilities/grid-view.ts"],"names":[],"mappings":"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"}

package/bundle/typescript/src/commands/game/sideQuest/utilities/outdoors.d.ts

@@ -6,5 +6,12 @@
  * street-level open ground counts, anything underground or interior
  * doesn't. Keeping both callers on the same predicate is the point --
  * a curb the generator guarantees must be a curb the dispatcher accepts.
+ *
+ * A NAME HEURISTIC STANDING IN FOR A SPATIAL FACT, and it cannot be
+ * made correct by a better regex -- only narrower. Whether a room has a
+ * roof is a property of the room, and the durable fix is for a seed to
+ * SAY so rather than for this to guess from an English word. That is
+ * filed; what is here is the guessing made less wrong, in the direction
+ * that fails safely.
  */
 export declare function isOutdoorsPlace(name: string, roomType?: string): boolean;

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

@@ -6,11 +6,35 @@
  * street-level open ground counts, anything underground or interior
  * doesn't. Keeping both callers on the same predicate is the point --
  * a curb the generator guarantees must be a curb the dispatcher accepts.
+ *
+ * A NAME HEURISTIC STANDING IN FOR A SPATIAL FACT, and it cannot be
+ * made correct by a better regex -- only narrower. Whether a room has a
+ * roof is a property of the room, and the durable fix is for a seed to
+ * SAY so rather than for this to guess from an English word. That is
+ * filed; what is here is the guessing made less wrong, in the direction
+ * that fails safely.
  */
 export function isOutdoorsPlace(name, roomType) {
     const haystack = `${roomType ?? ''} ${name}`.toLowerCase();
     if (/under|tunnel|crypt|basement|cellar|sewer|vault|sub-|subterran/.test(haystack))
         return false;
+    // ROOFED PLACES THAT WEAR AN OUTDOOR WORD (rhYnX2eaWgTkDnJ4a: "I was
+    // able to call a taxi from inside, I think").
+    //
+    // The positive list below contains words that are perfectly happy
+    // indoors -- market, court, gate, plaza -- so a "Market Hall", a
+    // "Food Court" or a "Gate House" read as open street and the
+    // dispatcher sent a cab into a building. Checked BEFORE the positive
+    // pass, the same way the underground guard is, because the roof is
+    // the deciding fact and the outdoor word is incidental.
+    //
+    // THIS ERRS TOWARD INDOORS ON PURPOSE, and the asymmetry is real: a
+    // false "outdoors" hails a cab inside a building, which is the bug.
+    // A false "indoors" only tells a runner to step out, and the
+    // generator's own use is self-correcting -- normalizeSkeleton simply
+    // injects a curb when the start room fails this test.
+    if (/hall|lobby|foyer|atrium|concourse|arcade|indoor|interior|food court|mall\b/.test(haystack))
+        return false;
     return /street|alley|strip|yard|dock|gate|road|plaza|lot\b|court|bridge|park|curb|waterfront|pier|rooftop|exterior|outside|market/.test(haystack);
 }
 //# sourceMappingURL=outdoors.js.map

package/bundle/typescript/src/commands/game/sideQuest/utilities/outdoors.js.map

@@ -1 +1 @@
-{"version":3,"file":"outdoors.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/utilities/outdoors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAiB;IAC7D,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3D,IAAI,+DAA+D,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IACjG,OAAO,2HAA2H,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACpJ,CAAC"}
+{"version":3,"file":"outdoors.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/utilities/outdoors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAiB;IAC7D,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3D,IAAI,+DAA+D,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IACjG,qEAAqE;IACrE,8CAA8C;IAC9C,EAAE;IACF,kEAAkE;IAClE,iEAAiE;IACjE,6DAA6D;IAC7D,qEAAqE;IACrE,mEAAmE;IACnE,wDAAwD;IACxD,EAAE;IACF,oEAAoE;IACpE,oEAAoE;IACpE,6DAA6D;IAC7D,qEAAqE;IACrE,sDAAsD;IACtD,IAAI,4EAA4E,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9G,OAAO,2HAA2H,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACpJ,CAAC"}

package/bundle/typescript/src/commands/game/sideQuest/utilities/room-grid.d.ts

@@ -29,7 +29,45 @@ export interface GridCoord {
     z: number;
 }
 export declare const METERS_PER_CELL = 2;
+/**
+ * How tall one storey is. A CHOICE, not a citation -- SR5 never says how
+ * high a catwalk sits -- and it is load-bearing in three places now, so
+ * it is written down rather than left as a number three files read:
+ *
+ *   - falling damage (fallDamageDV): canon takes no damage at or under
+ *     three metres (p.172), so at exactly 3 a one-storey fall is the
+ *     hardest landing that still hurts nobody. That is deliberate: a
+ *     catwalk should bruise your pride.
+ *   - how many hits a free climb needs (climbHitsFor, below).
+ *   - straight-line distance for perception and ranges (distanceMeters).
+ *
+ * Three metres is about a real industrial catwalk over a warehouse
+ * floor. Moving it re-prices all three at once, which is the reason it
+ * is one constant.
+ */
 export declare const METERS_PER_LEVEL = 3;
+/**
+ * Hits needed to free-climb `meters` (SR5 p.134, Climbing Table:
+ * "Unassisted climbing upward -- 1 meter per 2 hits").
+ *
+ * ASSISTED climbing is 1 metre per hit and wants rope and harness; this
+ * engine has no climbing gear, so every climb it rolls is unassisted.
+ * When gear arrives, this is the one function that changes.
+ *
+ * The other rows are recorded here rather than implemented, because
+ * nothing in the engine yet distinguishes a surface: assisted
+ * horizontal is 1m/2 hits, assisted upside-down 1m/3, unassisted DOWN
+ * 1m per hit, and rappelling is 20m + 1m per hit. The dice-pool
+ * modifiers for surface (+1 chain-link, 0 broken, -3 flat, -5 sheer,
+ * -2 wet, -4 greased) are likewise real canon we do not model -- said
+ * plainly so the next reader knows they are missing, not forgotten.
+ */
+export declare function climbHitsFor(meters: number): number;
+/** How far up a climb actually got, from the hits it rolled -- the
+ *  inverse of climbHitsFor, used to price a fall from a climb that
+ *  fell short. Canon buys distance with hits whether or not you reach
+ *  the top; you do not teleport back to the floor to fall from it. */
+export declare function climbMetersFrom(hits: number): number;
 export declare const key: (c: GridCoord) => string;
 export type RoomSize = 'tiny' | 'small' | 'medium' | 'large' | 'huge';
 export type WallSide = 'north' | 'south' | 'east' | 'west';
@@ -193,6 +231,14 @@ export declare function blockingRegionFor(grid: IRoomGrid, from: GridCoord, to:
 /** SR5 p.172 (RAG-verified): DV = meters fallen, only beyond 3m; AP-4
  *  applies at the caller (resisted with Body+Armor -- move.ts's job). */
 export declare function fallDamageDV(zSteps: number): number;
+/**
+ * The same rule stated in METRES, for a fall from part-way up a climb
+ * (SR5 p.172: DV equals metres fallen, and a fall of three metres or
+ * less does nothing). fallDamageDV delegates here rather than repeating
+ * the comparison -- one rule, one place, so a change to the threshold
+ * cannot land on storeys and miss climbs.
+ */
+export declare function fallDamageDVMeters(meters: number): number;
 /** Does this path cross a 'climb' vertical link (the riskier route --
  *  stairs/ladder never roll anything)? Returns the z-delta of the
  *  riskiest crossing (for fallDamageDV), or undefined when the path

package/bundle/typescript/src/commands/game/sideQuest/utilities/room-grid.js

@@ -1,6 +1,48 @@
 import { Direction } from '../types/shared/direction-enum.js';
 export const METERS_PER_CELL = 2;
+/**
+ * How tall one storey is. A CHOICE, not a citation -- SR5 never says how
+ * high a catwalk sits -- and it is load-bearing in three places now, so
+ * it is written down rather than left as a number three files read:
+ *
+ *   - falling damage (fallDamageDV): canon takes no damage at or under
+ *     three metres (p.172), so at exactly 3 a one-storey fall is the
+ *     hardest landing that still hurts nobody. That is deliberate: a
+ *     catwalk should bruise your pride.
+ *   - how many hits a free climb needs (climbHitsFor, below).
+ *   - straight-line distance for perception and ranges (distanceMeters).
+ *
+ * Three metres is about a real industrial catwalk over a warehouse
+ * floor. Moving it re-prices all three at once, which is the reason it
+ * is one constant.
+ */
 export const METERS_PER_LEVEL = 3;
+/**
+ * Hits needed to free-climb `meters` (SR5 p.134, Climbing Table:
+ * "Unassisted climbing upward -- 1 meter per 2 hits").
+ *
+ * ASSISTED climbing is 1 metre per hit and wants rope and harness; this
+ * engine has no climbing gear, so every climb it rolls is unassisted.
+ * When gear arrives, this is the one function that changes.
+ *
+ * The other rows are recorded here rather than implemented, because
+ * nothing in the engine yet distinguishes a surface: assisted
+ * horizontal is 1m/2 hits, assisted upside-down 1m/3, unassisted DOWN
+ * 1m per hit, and rappelling is 20m + 1m per hit. The dice-pool
+ * modifiers for surface (+1 chain-link, 0 broken, -3 flat, -5 sheer,
+ * -2 wet, -4 greased) are likewise real canon we do not model -- said
+ * plainly so the next reader knows they are missing, not forgotten.
+ */
+export function climbHitsFor(meters) {
+    return Math.max(1, Math.ceil(meters * 2));
+}
+/** How far up a climb actually got, from the hits it rolled -- the
+ *  inverse of climbHitsFor, used to price a fall from a climb that
+ *  fell short. Canon buys distance with hits whether or not you reach
+ *  the top; you do not teleport back to the floor to fall from it. */
+export function climbMetersFrom(hits) {
+    return hits / 2;
+}
 export const key = (c) => `${c.x},${c.y},${c.z}`;
 /**
  * x,y cell counts per size class -- 2 m/cell.
@@ -291,8 +333,18 @@ export function blockingRegionFor(grid, from, to) {
 /** SR5 p.172 (RAG-verified): DV = meters fallen, only beyond 3m; AP-4
  *  applies at the caller (resisted with Body+Armor -- move.ts's job). */
 export function fallDamageDV(zSteps) {
-    const meters = zSteps * METERS_PER_LEVEL;
-    return meters > 3 ? meters : 0;
+    return fallDamageDVMeters(zSteps * METERS_PER_LEVEL);
+}
+/**
+ * The same rule stated in METRES, for a fall from part-way up a climb
+ * (SR5 p.172: DV equals metres fallen, and a fall of three metres or
+ * less does nothing). fallDamageDV delegates here rather than repeating
+ * the comparison -- one rule, one place, so a change to the threshold
+ * cannot land on storeys and miss climbs.
+ */
+export function fallDamageDVMeters(meters) {
+    const m = Math.round(meters);
+    return m > 3 ? m : 0;
 }
 /** Does this path cross a 'climb' vertical link (the riskier route --
  *  stairs/ladder never roll anything)? Returns the z-delta of the
@@ -501,14 +553,40 @@ export function synthesizeGrid(input) {
         grid.spotCells.set(spot.name, cell);
     }
     // --- Unplaced spots: spread out (max-min distance, rejection sampled). ---
+    //
+    // A SPOT'S LEVEL IS HONOURED WITHOUT A PLACE HINT. This sampler used
+    // to hardcode `z: 0`, so `level: 1` only reached the grid when the
+    // spot ALSO carried a `place` -- the placed branch above reads it,
+    // this one silently dropped it. A catwalk spot with no wall hint was
+    // therefore built on the floor.
+    //
+    // It is the two-sources-of-truth shape again, and it was invisible
+    // because the two sources disagreed QUIETLY: describeSpotRoster reads
+    // the seed and says "catwalk (up a level)", while everything spatial
+    // reads the grid and saw a ground-floor cell. The player was told the
+    // place was above their head and `climb` answered that there was
+    // nothing up there -- both surfaces honest, one of them wrong.
+    //
+    // Found by the repro bench, which builds its level spot without a
+    // place hint. That is the bench earning its keep: no unit test in the
+    // suite happened to omit the hint.
     const onPerimeter = (c) => c.x === 0 || c.y === 0 || c.x === dims.x - 1 || c.y === dims.y - 1;
     for (const spot of unplaced) {
+        const spotZ = clamp(spot.level ?? 0, 0, dims.z - 1);
+        // An upper storey is only its declared strip, so sample from the
+        // cells that actually exist up there rather than the whole
+        // footprint -- a random x,y on level 1 is usually thin air.
+        const levelCellKeys = spotZ === 0
+            ? undefined
+            : new Set(levelFootprint(grid, spotZ).map(key));
         let best;
         let bestScore = -1;
         for (let attempt = 0; attempt < 8; attempt++) {
             const x = Math.floor(rng() * dims.x);
             const y = Math.floor(rng() * dims.y);
-            const c = { x, y, z: 0 };
+            const c = { x, y, z: spotZ };
+            if (levelCellKeys && !levelCellKeys.has(key(c)))
+                continue;
             if (occupied.has(key(c)))
                 continue;
             // A DOOR IS A HOLE IN A WALL (item A, 2026-08-27). This sampler
@@ -528,10 +606,17 @@ export function synthesizeGrid(input) {
         }
         // Rejection sampling can miss a free perimeter cell in 8 tries, so
         // sweep for one before giving up on the constraint entirely.
-        if (!best && spot.preferPerimeter) {
+        if (!best && spot.preferPerimeter && spotZ === 0) {
             best = perimeterFreeCell(dims, occupied, exists);
         }
-        if (!best)
+        // BOTH FALLBACKS BUILD ON THE GROUND, so a level spot that the
+        // sampler missed must sweep its own storey instead -- otherwise the
+        // rescue path quietly reintroduces exactly the bug the loop above
+        // just fixed, and only for the crowded rooms where it matters.
+        if (!best && levelCellKeys) {
+            best = levelFootprint(grid, spotZ).find(c => !occupied.has(key(c)));
+        }
+        if (!best && spotZ === 0)
             best = fallbackFreeCell(dims, occupied);
         if (best) {
             claim(best);