@maka/maka-cli 5.3.17 → 5.5.0

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

@@ -1,7 +1,9 @@
 import { Command } from './command.js';
+import { Category } from '../types/shared/item-enum.js';
+import { rollPool, formatRoll } from '../utilities/dice.js';
 export class UseCommand extends Command {
     static verb = 'use';
-    static description = 'Use an item.';
+    static description = 'Use an item. A Medical item (medkit, stim patch) heals your wounds and is consumed.';
     async execute(args) {
         return this.use(args);
     }
@@ -18,6 +20,12 @@ export class UseCommand extends Command {
             this.logger.write(`UseCommand: ${itemName} not retrieved from ${this.actor.name}'s inventory.`);
             return `You don't have the ${itemName} to use.`;
         }
+        if (itemToUse.category === Category.Medical) {
+            return this.applyFirstAid(itemToUse);
+        }
+        if (itemToUse.category === Category.StimPatch) {
+            return this.applyStim(itemToUse);
+        }
         // If the item has a 'use' method, call it and use the return value in the response.
         if (typeof itemToUse.use === 'function') {
             const result = itemToUse.use();
@@ -30,5 +38,98 @@ export class UseCommand extends Command {
             return `You can't use the ${itemName} in this way.`;
         }
     }
+    /**
+     * Healing, matching combat's texture (see commands/attack.ts): a visible
+     * first-aid dice pool scaled by the item's quality, applied to the
+     * condition monitor. Pool is 2 * (1 + quality) d6 (a common medkit rolls
+     * 2d6, a military-grade one 10d6) and the recovery is hits + 1 + quality
+     * -- the floor guarantees even an all-miss roll isn't a wasted kit, and
+     * quality dominates, since gear is the game's whole progression system.
+     * Single-use: the kit is consumed. Healing also restores wound-modifier
+     * dice, since those derive from current damage.
+     *
+     * Deliberately refuses BEFORE consuming when there's nothing to heal --
+     * burning a medkit at full health would just be a trap -- and when the
+     * user is already down: death is death, not a big wound.
+     */
+    applyFirstAid(kit) {
+        if (this.actor.isDown()) {
+            return `You're past the help of a ${kit.name}.`;
+        }
+        if (this.actor.damageTaken === 0) {
+            return `You're not hurt -- save the ${kit.name} for when you're bleeding.`;
+        }
+        // First aid is Logic + FIRST-AID skill now (unskilled: Logic - 1,
+        // fumbling with the sprays), with the kit's quality still deciding how
+        // much each hit actually closes (hits + 1 + quality below).
+        const quality = kit.qualityBonus;
+        const firstAid = this.actor.skillRating('first-aid');
+        const roll = rollPool(Math.max(1, this.actor.logic + (firstAid > 0 ? firstAid : -1) + this.actor.woundModifier));
+        const healed = this.actor.healDamage(roll.hits + 1 + quality);
+        this.actor.inventory.removeItem(kit.name);
+        this.logger.write(`UseCommand: ${this.actor.name} used ${kit.name} and healed ${healed} boxes (${this.actor.damageTaken}/${this.actor.maxConditionBoxes}).`);
+        this.actor.performAction('uses', kit.name);
+        this.scene.addWorldEvent(`${this.actor.name} patched themselves up with ${kit.name}.`);
+        this.scene.updateInventory(this.scene.getPlayer().inventory);
+        this.scene.updateStatus();
+        return [
+            `You use the ${kit.name}:`,
+            `  First aid: ${formatRoll(roll)}`,
+            `  You recover ${healed} box${healed === 1 ? '' : 'es'}: ${this.actor.conditionSummary()}`,
+            `  (The ${kit.name} is spent.)`,
+        ].join('\n');
+    }
+    /**
+     * Stim patches are the STUN answer (spell drain fills stun; medkits only
+     * touch physical): same quality-scaled pool and consumable economy as a
+     * medkit, but with the classic stim tradeoff -- the CRASH. After the
+     * lift, 1 box of real physical damage lands. Slapping a stim while
+     * already bleeding out can genuinely kill you; that's the gamble, and
+     * the reason a safe rest (see rest.ts) exists as the free alternative.
+     */
+    applyStim(patch) {
+        if (this.actor.isIncapacitated()) {
+            return `You're past the help of a ${patch.name}.`;
+        }
+        if (this.actor.stunTaken === 0) {
+            return `You're not winded -- save the ${patch.name} for when the drain's caught up with you.`;
+        }
+        const quality = patch.qualityBonus;
+        const roll = rollPool(2 * (1 + quality));
+        const recovered = this.actor.healStun(roll.hits + 1 + quality);
+        this.actor.inventory.removeItem(patch.name);
+        this.actor.performAction('uses', patch.name);
+        this.scene.addWorldEvent(`${this.actor.name} slapped on a ${patch.name}.`);
+        const lines = [
+            `You slap on the ${patch.name}:`,
+            `  Stim: ${formatRoll(roll)}`,
+            `  The fog burns off -- ${recovered} stun recovered: ${this.actor.stunSummary()}`,
+        ];
+        // The crash: chemicals collect their fee in real damage.
+        this.actor.takeDamage(1);
+        this.logger.write(`UseCommand: ${this.actor.name} used ${patch.name}: +${recovered} stun, crash 1 physical (${this.actor.damageTaken}/${this.actor.maxConditionBoxes}).`);
+        lines.push(`  ...then the crash bites: 1 box physical: ${this.actor.conditionSummary()}`);
+        lines.push(`  (The ${patch.name} is spent.)`);
+        if (this.actor.isDown()) {
+            // Stimming while nearly bled out finished the job -- same GAME
+            // OVER/removal flows every other death uses (see kill.ts).
+            const isPlayer = this.actor === this.scene.getPlayer();
+            this.scene.addWorldEvent(`${this.actor.name} collapsed dead from a stim crash.`);
+            if (isPlayer) {
+                void this.scene.endGame().then(() => {
+                    this.logger.logWithColor(`💀 GAME OVER: ${this.actor.name}'s heart gave out under the stim crash.`, 'red');
+                    this.logger.logWithColor(`Press ctrl-c to quit.`, 'red');
+                });
+                lines.push('', `Your chest seizes. The lift was a lie -- the crash takes everything.`);
+            }
+            else {
+                this.scene.removeActor(this.actor.name);
+                lines.push('', `${this.actor.name} seizes and drops -- the stim took more than it gave.`);
+            }
+        }
+        this.scene.updateInventory(this.scene.getPlayer().inventory);
+        this.scene.updateStatus();
+        return lines.join('\n');
+    }
 }
 //# sourceMappingURL=use.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"use.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/use.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,cAAc,CAAC;AAEjD,MAAM,OAAO,UAAW,SAAQ,OAAO;IAC3B,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC;IACpB,MAAM,CAAC,WAAW,GAAG,cAAc,CAAC;IAE9C,KAAK,CAAC,OAAO,CAAC,IAAc;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAEO,GAAG,CAAC,IAAc;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAE9C,qDAAqD;QACrD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,IAAI,qBAAqB,QAAQ,oCAAoC,CAAC,CAAC;YACnH,OAAO,sBAAsB,QAAQ,UAAU,CAAC;QAClD,CAAC;QAED,uCAAuC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAEzD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,QAAQ,uBAAuB,IAAI,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,CAAC;YAChG,OAAO,sBAAsB,QAAQ,UAAU,CAAC;QAClD,CAAC;QAED,oFAAoF;QACpF,IAAI,OAAO,SAAS,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,QAAQ,GAAG,CAAC,CAAC;YACtE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACxC,OAAO,MAAM,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,QAAQ,6BAA6B,CAAC,CAAC;YACxE,OAAO,qBAAqB,QAAQ,eAAe,CAAC;QACtD,CAAC;IACH,CAAC"}
+{"version":3,"file":"use.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/use.ts"],"names":[],"mappings":"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"}

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

@@ -14,7 +14,8 @@ export class ItemFactory {
             weight: json.weight,
             details: json.details,
             satisfiesLifestyle: json.satisfiesLifestyle,
-            transferable: json.transferable
+            transferable: json.transferable,
+            plane: json.plane
         });
         if (json.currencyAmount && item.isCurrencyCarrier()) {
             item.addCurrency(json.currencyAmount);

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

@@ -1 +1 @@
-{"version":3,"file":"item-factory.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/factories/item-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAEtE,MAAM,OAAO,WAAW;IACtB,KAAK,CAAC,kBAAkB,CAAC,IAAmB;QAC1C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC;YACpB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YACrB,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;YACjC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;YAC3C,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACpD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"item-factory.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/factories/item-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAEtE,MAAM,OAAO,WAAW;IACtB,KAAK,CAAC,kBAAkB,CAAC,IAAmB;QAC1C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC;YACpB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YACrB,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;YACjC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;YAC3C,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACpD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

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

@@ -11,11 +11,15 @@ export class NPCFactory {
         }
         const playerConstructorConfig = this.convertPlayerSeedToConstructorConfig(json.player);
         const commandRegistry = new CommandRegistry(this.scene);
-        return new NPC({
+        const npc = new NPC({
             dialog: json.dialogue ?? ["..."],
             description: json.description ?? "Not interesting",
             playerConstructorConfig
         }, commandRegistry);
+        // Native off-plane residents: ice lives on the Matrix, spirits on the
+        // astral. They have no body to leave behind -- the plane IS their home.
+        npc.plane = json.plane ?? 'meat';
+        return npc;
     }
     convertPlayerSeedToConstructorConfig(seed) {
         if (!seed.name) {
@@ -28,7 +32,8 @@ export class NPCFactory {
         return {
             playerName: seed.name,
             lifestyleChoices: seed.lifestyleChoices,
-            startLocation
+            startLocation,
+            combat: seed.combat
         };
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"npc-factory.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/factories/npc-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAIvC,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,MAAM,OAAO,UAAU;IACb,KAAK,CAAQ;IAErB,YAAY,KAAY;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,IAAkB;QACxC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,uBAAuB,GAAG,IAAI,CAAC,oCAAoC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvF,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAExD,OAAO,IAAI,GAAG,CAAC;YACb,MAAM,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC;YAChC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,iBAAiB;YAClD,uBAAuB;SACxB,EAAE,eAAe,CAAC,CAAC;IACtB,CAAC;IAEO,oCAAoC,CAAC,IAA4B;QACvE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7D,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,aAAa;SACd,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"npc-factory.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/factories/npc-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAIvC,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,MAAM,OAAO,UAAU;IACb,KAAK,CAAQ;IAErB,YAAY,KAAY;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,IAAkB;QACxC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,uBAAuB,GAAG,IAAI,CAAC,oCAAoC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvF,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAExD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC;YAClB,MAAM,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC;YAChC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,iBAAiB;YAClD,uBAAuB;SACxB,EAAE,eAAe,CAAC,CAAC;QACpB,sEAAsE;QACtE,wEAAwE;QACxE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC;QACjC,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,oCAAoC,CAAC,IAA4B;QACvE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7D,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,aAAa;YACb,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF"}

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

@@ -17,7 +17,8 @@ export class PuzzleFactory {
             rewardItem,
             successMessage: json.successMessage,
             failureMessage: json.failureMessage,
-            hobbyTags: json.hobbyTags
+            hobbyTags: json.hobbyTags,
+            bypassType: json.bypassType
         });
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"puzzle-factory.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/factories/puzzle-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAI7C,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,oBAAoB,CAAC,IAAqB,EAAE,OAA0B;QAC1E,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpF,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE9E,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,YAAY,2BAA2B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAC9F,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,UAAU,2BAA2B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAC1F,CAAC;QAED,OAAO,IAAI,MAAM,CAAC;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,YAAY;YACZ,UAAU;YACV,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"puzzle-factory.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/factories/puzzle-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAI7C,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,oBAAoB,CAAC,IAAqB,EAAE,OAA0B;QAC1E,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpF,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE9E,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,YAAY,2BAA2B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAC9F,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,UAAU,2BAA2B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAC1F,CAAC;QAED,OAAO,IAAI,MAAM,CAAC;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,YAAY;YACZ,UAAU;YACV,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -12,6 +12,9 @@ export class RoomFactory {
             isStartRoom: roomJson.isStartRoom,
             roomType: roomJson.roomType,
             tags: roomJson.tags ?? [],
+            hasNode: roomJson.hasNode,
+            nodeAccess: roomJson.nodeAccess,
+            warded: roomJson.warded,
             supportedLifestyles: roomJson.supportedLifestyles
         };
     }

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,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE;YACzB,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;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,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE;YACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;SAClD,CAAC;IACJ,CAAC;CACF"}

package/bundle/typescript/src/commands/game/sideQuest/factories/scene-chunks.d.ts

@@ -0,0 +1,175 @@
+import { Player } from '../models/player.js';
+import { ISceneSeedJson } from '../types/seed/scene-seed.js';
+/**
+ * CHUNKED scene generation (see SceneSeedGenerator.generate for the
+ * pipeline that drives this module). One monolithic whole-scene completion
+ * kept hitting the response token ceiling as scenes grew -- a real session
+ * lost four of six tier-2 attempts to JSON truncated mid-string -- and a
+ * single validation miss threw the entire scene away. So generation now
+ * runs in passes:
+ *
+ *   1. SKELETON: the whole scene's STRUCTURE -- rooms with exits/locks/
+ *      nodes, the NPC roster with locations, puzzle placements, every
+ *      item's name/role/location, and the win condition. Compact (one-line
+ *      concepts instead of prose), so every cross-reference the validators
+ *      check lives in one small completion.
+ *   2. DETAIL CHUNKS, each its own small completion against the fixed
+ *      skeleton: room prose; NPC voices/stats; puzzle riddles and
+ *      passphrases; item descriptions (clue items get their puzzle's exact
+ *      phrase baked into "details" -- which is why items runs AFTER
+ *      puzzles).
+ *   3. Assembly + the same validators as ever; a failure regenerates ONLY
+ *      the chunk responsible.
+ *
+ * No single completion carries the whole scene, so scene scale is no
+ * longer bounded by the provider's output budget.
+ */
+export declare const FIXER_NAME = "Mr. Johnson";
+export interface ISkeletonExit {
+    direction: string;
+    targetRoom: string;
+    keyRequired?: string;
+    puzzle?: string;
+}
+export interface ISkeletonRoom {
+    name: string;
+    concept: string;
+    roomType?: string;
+    isStartRoom?: boolean;
+    reachable?: boolean;
+    hasNode?: boolean;
+    nodeAccess?: 'wireless' | 'wired';
+    warded?: boolean;
+    owner?: string;
+    exits?: ISkeletonExit[];
+}
+export interface ISkeletonNpc {
+    name: string;
+    concept: string;
+    plane?: 'meat' | 'matrix' | 'astral';
+    startLocation: string;
+}
+export interface ISkeletonPuzzle {
+    name: string;
+    /** Room-anchored placement; omit for a door puzzle (referenced from exits[].puzzle). */
+    room?: string;
+    concept: string;
+    bypassType?: 'lockpick' | 'hack' | 'spell' | 'con';
+    requiresPuzzle?: string;
+    rewardItem?: string;
+}
+export type SkeletonItemRole = 'winCondition' | 'reward' | 'key' | 'clue' | 'loot' | 'starting';
+export interface ISkeletonItem {
+    name: string;
+    role: SkeletonItemRole;
+    category: string;
+    room?: string;
+    heldBy?: string;
+    plane?: 'meat' | 'matrix';
+    /** clue items only: which puzzle's requiredPhrase this clue reveals. */
+    forPuzzle?: string;
+}
+export interface ISceneSkeleton {
+    name: string;
+    story: string;
+    completionMessage: string;
+    rooms: ISkeletonRoom[];
+    npcs: ISkeletonNpc[];
+    puzzles: ISkeletonPuzzle[];
+    items: ISkeletonItem[];
+    winCondition: {
+        item: string;
+        toNpc: string;
+        payout: number;
+        rewardItem?: string;
+    };
+}
+export interface IRoomDetail {
+    name: string;
+    description: string;
+    roomType?: string;
+}
+export interface INpcDetail {
+    name: string;
+    description: string;
+    dialogue: string[];
+    combat?: Record<string, unknown>;
+}
+export interface IPuzzleDetail {
+    name: string;
+    riddle: string;
+    requiredPhrase: string;
+    successMessage: string;
+    failureMessage: string;
+    lockedMessage?: string;
+}
+export interface IItemDetail {
+    name: string;
+    description: string;
+    size: string;
+    category: string;
+    shape: string;
+    color: string;
+    texture: string;
+    rating: string;
+    weight: number;
+    currencyAmount?: number;
+    details?: string;
+    transferable?: boolean;
+}
+export interface ISceneDetails {
+    rooms: IRoomDetail[];
+    npcs: INpcDetail[];
+    puzzles: IPuzzleDetail[];
+    items: IItemDetail[];
+}
+/**
+ * A compact character sheet injected into the skeleton prompt so a job is
+ * built FOR the runner actually playing it (archetype, stats, toolkit).
+ * Returns '' when no player is available.
+ */
+export declare function buildPlayerDossier(player?: Player): string;
+export declare function buildSkeletonPrompt(tier: number, previousFixerName?: string, player?: Player, previousError?: string): string;
+export declare function buildRoomsPrompt(skeleton: ISceneSkeleton, previousError?: string): string;
+export declare function buildNpcsPrompt(skeleton: ISceneSkeleton, previousError?: string): string;
+export declare function buildPuzzlesPrompt(skeleton: ISceneSkeleton, previousError?: string): string;
+export declare function buildItemsPrompt(skeleton: ISceneSkeleton, puzzles: IPuzzleDetail[], previousError?: string): string;
+/**
+ * Whether THIS runner can reliably work a barrier of the given bypassType
+ * with their own hands -- no written-down credential required. This is
+ * what loosens the "every puzzle needs a discoverable clue" rule when the
+ * scene is generated against a dossier: a lockpick maglock in a scene
+ * built for a master locksmith doesn't need its code lying in a book --
+ * the pick IS their route. Deliberately conservative: EXPLICIT skill
+ * ratings only (the combatSkill fallback would let any bruiser "qualify"
+ * as a hacker), threshold 3 (trained professional), and with no dossier
+ * at all the strict clue rule stays.
+ */
+export declare function canBypassUnaided(player: Player | undefined, bypassType?: string): boolean;
+/** Strips accidental markdown fences and parses; throws with a useful message. */
+export declare function parseJsonReply<T>(reply: string): T;
+/**
+ * Fast structural checks on the skeleton BEFORE any detail pass spends
+ * tokens building on it. Deeper semantics (reachability, clue coverage,
+ * matrix defense...) are still enforced by the assembled-scene validators.
+ */
+export declare function validateSkeleton(skeleton: ISceneSkeleton, player?: Player): void;
+/**
+ * Auto-fixes skeleton faults that have exactly one sane resolution,
+ * instead of burning a whole retry on them. Today: a puzzle both placed
+ * in a room AND referenced by exactly one door keeps the DOOR placement
+ * (the model near-always meant "the door in that room" -- this exact
+ * fault killed two consecutive real generations). Returns notes for the
+ * log.
+ */
+export declare function normalizeSkeleton(skeleton: ISceneSkeleton): string[];
+/** Merges the skeleton's structure with the detail passes into a full seed. */
+export declare function assembleScene(skeleton: ISceneSkeleton, details: ISceneDetails, playerName: string): ISceneSeedJson;
+export type RepairTarget = 'rooms' | 'npcs' | 'puzzles' | 'items' | 'skeleton';
+/**
+ * Maps a validation failure to the chunk that owns the broken content, so
+ * a repair regenerates ONE pass instead of the whole scene. Anything
+ * structural (topology, placement, rosters) is skeleton-owned and restarts
+ * the pipeline with the error as feedback.
+ */
+export declare function classifyRepair(message: string): RepairTarget;