@maka/maka-cli 5.163.0 → 5.165.0

package/bundle/typescript/package.json

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

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

@@ -408,6 +408,39 @@ Key Locations: ${json.rooms.map(r => r.name).join(', ')}
                 }
             }
         }
+        // Step 4.95: NO DOOR SHIPS LOCKED WITHOUT A WAY THROUGH
+        // (S8WdW7gm9tFGaxeCi, 2026-09-07: "I broke the gate, but the door is
+        // locked. It doesn't look like it has a way to open it"). A seed
+        // exit's `keyRequired` builds a locked Door with no Device: "pick",
+        // "breach" and "hack" all answer "nothing here", the refusal names
+        // no route, and the only verb that works ("unlock <dir>" while
+        // carrying the key) was never surfaced. The device path was
+        // hardened against exactly this (seed-migration synthesises a code
+        // rather than ship a routeless barrier); the keyed path never was.
+        //
+        // Same clamp-don't-throw rule as the keyItem repair above: a key
+        // that resolves (exactly or by the same fuzzy match) is written back
+        // under its real name so "unlock" finds it; a key that resolves to
+        // nothing means the door cannot be opened by anyone, ever, and it
+        // ships UNLOCKED with the error logged. Runs on every seed path --
+        // static, generated, repro, and the hub seed inside every save.
+        for (const roomJson of json.rooms) {
+            const room = scene.getRoom(roomJson.name);
+            if (!room)
+                continue;
+            for (const [direction, exit] of room.exits.entries()) {
+                if (!(exit instanceof Door) || !exit.checkIfLocked() || exit.heldBy)
+                    continue;
+                const wanted = exit.unlockItemOrSolution;
+                const key = wanted ? findItem(wanted) : undefined;
+                if (key) {
+                    exit.unlockItemOrSolution = key.name;
+                    continue;
+                }
+                exit.isLocked = false;
+                logger.error(`Scene "${json.name}": the door ${String(direction)} of ${room.name} was locked by "${wanted ?? '(nothing)'}", which no device holds and no item matches -- it ships unlocked rather than as a wall.`);
+            }
+        }
         // Step 4.05: NPCs wear their gear. "heldBy" only puts items in an NPC's
         // inventory, but combat pools (see Player.getWeaponProfile /
         // getArmorValue) read from EQUIPPED slots -- without this, an enforcer

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

@@ -2380,6 +2380,8 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
      * unchanged.
      */
     _conditionSink;
+    /** A hosted run's aftermath still owed to this hub (IPendingHomecoming). */
+    _pendingHomecoming;
     constructor(player, sceneSeed, conditionSink) {
         this._conditionSink = conditionSink;
         this.player = player;
@@ -3043,6 +3045,12 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         // party-loadable within moments of launch now -- requestSave pushes
         // the cloud mirror behind the local write.
         if (this._hubScene && this.scene === this._hubScene) {
+            // A HOSTED RUN'S AFTERMATH, SETTLED AT THE DOOR (8izFwokbehjHzkEAn,
+            // 3gFcHfheGSMPtpCFh): the site wrote the runner back with a
+            // homecoming owed; this is the hub entry that pays it.
+            const owed = this.applyHostedHomecoming();
+            if (owed)
+                Logger.getInstance().logWithColor(owed, 'green');
             this.requestSave('hub-arrival');
         }
         // A REGISTERED sprite from the save re-shells at the cot (the
@@ -3184,6 +3192,7 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         }
         applyHubOverlay(this.scene, save.hub, this.player, this._homeRoom);
         this._tier = save.game.tier;
+        this._pendingHomecoming = save.game.pendingHomecoming;
         this.contacts = new Map(save.game.contacts);
         // Roles are DERIVED, not earned -- re-derive them all on every
         // resume so old saves self-heal (pre-role saves read all "Street
@@ -3469,6 +3478,7 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
                     return all.length > 0 ? all : undefined;
                 })(),
                 crew: this.crew.map(m => ({ ...m, gear: [...m.gear] })),
+                pendingHomecoming: this._pendingHomecoming,
                 commandRefusals: { ...this.commandRefusals },
                 fencedCategories: [...this.fencedCategories],
                 rumorIndex: this._rumorIndex,
@@ -3843,6 +3853,50 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             contact.asked = false;
         // Fresh material for the buskers too (commands/perform.ts).
         this.performedThisCycle = false;
+        // LIFESTYLE upkeep and the High-lifestyle shower: settleLifestyleUpkeep,
+        // shared with the hosted run's owed homecoming (applyHostedHomecoming).
+        const { rentLine, comfortLine } = this.settleLifestyleUpkeep();
+        // Fresh streets, fresh gossip, restocked shelves, new work.
+        this.advanceRumor();
+        this.fenceSellsOn();
+        const restocked = this.restockVendorShelves();
+        const restockLine = restocked > 0 ? `\nThe district has restocked around you -- the wok steams, the bar's shelf is full, the market stalls are loud again.` : '';
+        this.advanceGig();
+        this.repaintForScene();
+        this.refreshLogLabel();
+        Logger.getInstance().write(`Returned to hub "${this._hubName}". Lifestyle ${this.lifestyleTier}: ${this.rentDebt} owed. Restocked ${restocked}. Rumor: ${this.activeRumor ?? '(none)'}`);
+        // Drones spin back up beside the cot.
+        const companionArrivalLines = this.unfoldCompanionsOnArrival();
+        const companionBlock = [...companionFoldLines, ...companionArrivalLines];
+        // The commanded ally's tour ends with the run (RAW's Command lasts
+        // turns; ours lasts the job): the crew disbands at the curb.
+        // The crew stays hired between jobs (the roster persists); their
+        // homecoming lines (obituaries, write-back) rode in above. Fresh
+        // faces on the for-hire board each homecoming.
+        this.rollHireCandidates();
+        // Social settlement: the street hears you're home.
+        this.beatPresence();
+        const allyLine = crewLines.length > 0 ? `\n${crewLines.join('\n')}` : '';
+        const docwagonLine = this.tickDocwagonHomecoming();
+        const deliveryLine = this.deliverProcurements();
+        // The night catches up on the ride (SINs & getting caught): a hot
+        // run means the wire between there and home. Settled AFTER the
+        // payout (the fee comes out of tonight's take) and BEFORE the save
+        // below -- a burned fake or an issued SIN must survive a quit.
+        const checkpointBlock = this.checkpointOnRideHome();
+        // The homecoming save: everything above (payout, rent, restock,
+        // contacts reset, deliveries, the checkpoint) settled first, so the
+        // save reflects the hub as the player will find it.
+        this.requestSave('homecoming');
+        const fateLine = wrappedRun
+            ? `The run's wrapped and the street swallows you back up.`
+            : `The run's behind you -- unfinished, unpaid, already someone else's problem. The street doesn't ask.`;
+        return `${checkpointBlock ? `\n${checkpointBlock}\n` : ''}\n${this._hubName.toUpperCase()}\n${fateLine} You're home -- your hideout, one door off ${hub.determineStartRoom().name}.${hint(` Call ${FIXER_NAME} when you're hungry for the next job.`)}${clientLine}${awarenessLine}\n${rentLine}${comfortLine}${restockLine}${deliveryLine}${docwagonLine}${allyLine}${companionBlock.length > 0 ? `\n${companionBlock.join('\n')}` : ''}`;
+    }
+    /** The rent, the slide, the tab, and the High-lifestyle shower --
+     *  homecoming's money half, for the solo ride home and the hosted
+     *  run's owed homecoming alike. */
+    settleLifestyleUpkeep() {
         // LIFESTYLE upkeep comes due with the homecoming: this tier's share
         // plus any standing debt, paid from carried cred as far as it goes.
         // Coming up short SLIDES YOU DOWN a tier (the district notices) and
@@ -3887,75 +3941,98 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             const cleared = this.player.healStun(this.player.stunTaken);
             comfortLine = `\nThe shower runs hot until the run is a rumor -- ${cleared} stun gone before your head hits the pillow.`;
         }
-        // Fresh streets, fresh gossip, restocked shelves, new work.
+        return { rentLine, comfortLine };
+    }
+    /** DOCWAGON's year ticks in homecomings (12 = a street year, player
+     *  ruling): the contract lapses quietly unless renewed at Doc's. */
+    tickDocwagonHomecoming() {
+        if (!this.docwagon)
+            return '';
+        this.docwagon.homecomingsLeft -= 1;
+        if (this.docwagon.homecomingsLeft <= 0) {
+            const tier = this.docwagon.tier;
+            this.docwagon = undefined;
+            return `\nYour DocWagon ${tier} contract LAPSES -- the wristband goes dark.${hint(` ("docwagon <tier>" at Doc's renews it.)`)}`;
+        }
+        if (this.docwagon.homecomingsLeft <= 2) {
+            return `\nDocWagon renewal coming due: ${this.docwagon.homecomingsLeft} homecoming${this.docwagon.homecomingsLeft === 1 ? '' : 's'} left on the ${this.docwagon.tier} contract.`;
+        }
+        return '';
+    }
+    /** SWAG deliveries (commands/source.ts): the contact's shopping run
+     *  lands with the homecoming -- straight into your gear, paid for at
+     *  order time. */
+    deliverProcurements() {
+        if (this.pendingProcurements.length === 0)
+            return '';
+        const delivered = [];
+        for (const order of this.pendingProcurements.splice(0)) {
+            try {
+                const item = restoreItem(order.itemConfig);
+                item.owner = this.player.name;
+                this.player.inventory.addItem(item);
+                delivered.push(`${item.name} (${order.contact} came through)`);
+            }
+            catch (err) {
+                Logger.getInstance().error(`Procurement delivery failed: ${err}`);
+            }
+        }
+        if (delivered.length === 0)
+            return '';
+        this.updateInventory(this.player.inventory, capitalCase(this.scene.getCurrencyType()));
+        return `\nWaiting with your gear: ${delivered.join(', ')}.`;
+    }
+    /**
+     * A HOSTED RUN'S HOMECOMING (8izFwokbehjHzkEAn, 3gFcHfheGSMPtpCFh): the
+     * aftermath returnToHub settles for a solo ride home, applied ONCE for
+     * a run that ended on the site -- from the flag the server left on the
+     * save (IPendingHomecoming), or handed in directly by a CLI that rode a
+     * shared table. What it settles: the loud-run awareness point, the
+     * Johnson's opinion, the crew's tally, contacts' legwork, rent and the
+     * slide, the shower, restock/rumor/gig, the hire board, the DocWagon
+     * year, deliveries. What it does not: the checkpoint on the ride home
+     * (heat is the run's, and the run is gone) and crew gear write-back
+     * (their shells never stood in this process). Clears the flag and
+     * writes the homecoming save. Undefined when nothing is owed, or when
+     * the player is not standing in the hub.
+     */
+    applyHostedHomecoming(info) {
+        const owed = info ?? this._pendingHomecoming;
+        this._pendingHomecoming = undefined;
+        if (!owed)
+            return undefined;
+        if (!this._hubScene || this.scene !== this._hubScene)
+            return undefined;
+        const awarenessLine = owed.alarmed && this.player.addPublicAwareness(`left "${owed.jobName ?? 'a job'}" screaming`)
+            ? `\nYou left the place howling behind you. Somebody filed a report, somebody kept a still -- your face is a little more public than it was this morning. (+1 Public Awareness, now ${this.player.publicAwareness})`
+            : '';
+        this.currentClient = owed.client ? { ...owed.client } : undefined;
+        const clientLine = this.settleClientReputation(owed.wrapped);
+        for (const member of this.crew) {
+            if (owed.wrapped && !member.ghost?.liveOnly)
+                member.jobsRun += 1;
+            member.trainedThisCycle = false;
+        }
+        for (const contact of this.contacts.values())
+            contact.asked = false;
+        this.performedThisCycle = false;
+        const { rentLine, comfortLine } = this.settleLifestyleUpkeep();
         this.advanceRumor();
         this.fenceSellsOn();
         const restocked = this.restockVendorShelves();
         const restockLine = restocked > 0 ? `\nThe district has restocked around you -- the wok steams, the bar's shelf is full, the market stalls are loud again.` : '';
         this.advanceGig();
-        this.repaintForScene();
-        this.refreshLogLabel();
-        Logger.getInstance().write(`Returned to hub "${this._hubName}". Lifestyle ${this.lifestyleTier}: ${paid} paid, ${this.rentDebt} owed. Restocked ${restocked}. Rumor: ${this.activeRumor ?? '(none)'}`);
-        // Drones spin back up beside the cot.
-        const companionArrivalLines = this.unfoldCompanionsOnArrival();
-        const companionBlock = [...companionFoldLines, ...companionArrivalLines];
-        // The commanded ally's tour ends with the run (RAW's Command lasts
-        // turns; ours lasts the job): the crew disbands at the curb.
-        // The crew stays hired between jobs (the roster persists); their
-        // homecoming lines (obituaries, write-back) rode in above. Fresh
-        // faces on the for-hire board each homecoming.
         this.rollHireCandidates();
-        // Social settlement: the street hears you're home.
-        this.beatPresence();
-        const allyLine = crewLines.length > 0 ? `\n${crewLines.join('\n')}` : '';
-        // DOCWAGON's year ticks in homecomings (12 = a street year, player
-        // ruling): the contract lapses quietly unless renewed at Doc's.
-        let docwagonLine = '';
-        if (this.docwagon) {
-            this.docwagon.homecomingsLeft -= 1;
-            if (this.docwagon.homecomingsLeft <= 0) {
-                docwagonLine = `\nYour DocWagon ${this.docwagon.tier} contract LAPSES -- the wristband goes dark.${hint(` ("docwagon <tier>" at Doc's renews it.)`)}`;
-                this.docwagon = undefined;
-            }
-            else if (this.docwagon.homecomingsLeft <= 2) {
-                docwagonLine = `\nDocWagon renewal coming due: ${this.docwagon.homecomingsLeft} homecoming${this.docwagon.homecomingsLeft === 1 ? '' : 's'} left on the ${this.docwagon.tier} contract.`;
-            }
-        }
-        // SWAG deliveries (commands/source.ts): the contact's shopping run
-        // lands with the homecoming -- straight into your gear, paid for at
-        // order time.
-        let deliveryLine = '';
-        if (this.pendingProcurements.length > 0) {
-            const delivered = [];
-            for (const order of this.pendingProcurements.splice(0)) {
-                try {
-                    const item = restoreItem(order.itemConfig);
-                    item.owner = this.player.name;
-                    this.player.inventory.addItem(item);
-                    delivered.push(`${item.name} (${order.contact} came through)`);
-                }
-                catch (err) {
-                    Logger.getInstance().error(`Procurement delivery failed: ${err}`);
-                }
-            }
-            if (delivered.length > 0) {
-                this.updateInventory(this.player.inventory, capitalCase(this.scene.getCurrencyType()));
-                deliveryLine = `\nWaiting with your gear: ${delivered.join(', ')}.`;
-            }
-        }
-        // The night catches up on the ride (SINs & getting caught): a hot
-        // run means the wire between there and home. Settled AFTER the
-        // payout (the fee comes out of tonight's take) and BEFORE the save
-        // below -- a burned fake or an issued SIN must survive a quit.
-        const checkpointBlock = this.checkpointOnRideHome();
-        // The homecoming save: everything above (payout, rent, restock,
-        // contacts reset, deliveries, the checkpoint) settled first, so the
-        // save reflects the hub as the player will find it.
+        const docwagonLine = this.tickDocwagonHomecoming();
+        const deliveryLine = this.deliverProcurements();
+        Logger.getInstance().write(`Hosted homecoming applied (${owed.outcome}, ended ${owed.endedAt}): rent ${this.rentDebt} owed, lifestyle ${this.lifestyleTier}.`);
         this.requestSave('homecoming');
-        const fateLine = wrappedRun
+        const fateLine = owed.outcome === 'wrapped'
             ? `The run's wrapped and the street swallows you back up.`
-            : `The run's behind you -- unfinished, unpaid, already someone else's problem. The street doesn't ask.`;
-        return `${checkpointBlock ? `\n${checkpointBlock}\n` : ''}\n${this._hubName.toUpperCase()}\n${fateLine} You're home -- your hideout, one door off ${hub.determineStartRoom().name}.${hint(` Call ${FIXER_NAME} when you're hungry for the next job.`)}${clientLine}${awarenessLine}\n${rentLine}${comfortLine}${restockLine}${deliveryLine}${docwagonLine}${allyLine}${companionBlock.length > 0 ? `\n${companionBlock.join('\n')}` : ''}`;
+            : owed.outcome === 'interrupted'
+                ? `The run was lost to the static -- the street doesn't ask.`
+                : `The run's behind you -- unfinished, unpaid, already someone else's problem. The street doesn't ask.`;
+        return `${fateLine} The table's settled; home takes its cut.${clientLine}${awarenessLine}\n${rentLine}${comfortLine}${restockLine}${deliveryLine}${docwagonLine}`;
     }
     /**
      * KNIGHT ERRANT CHECKPOINT (SINs & getting caught, ruling 2026-08-24;

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

@@ -261,6 +261,26 @@ export async function createHeadlessSession(opts) {
             const clientSpot = clientActor ? spotOf(clientActor) : undefined;
             logger.log(`📞 Your link chirps -- {bold}{underline}${clientName}{/underline}{/bold}: "${room ? `I'm at ${room}${clientSpot ? `, the ${clientSpot}` : ''}` : `I'm on-site`} -- waiting on you. Come sit down before somebody else does."`, 'all');
         }
+        // THE CREW RIDES ALONG (aCjJiDDJM9jGZJeER, 2026-09-11: "I can't see
+        // Hammerhead Joe doing any combat"). Game.spawnCrew has exactly one
+        // caller -- the SOLO arrival (activateRunScene) -- and this boot
+        // loaded only the leader's DocWagon wristband out of save.game, so a
+        // hosted run had no crew at all: a hired face the player had paid
+        // for simply was not in the scene. Same filter as Game's own save
+        // load (a friend invite rides live or not at all; a dead ghost
+        // dissolves), same spawn, same arrival lines, for the primary only
+        // -- a late joiner's crew is a table question this does not answer.
+        try {
+            const primarySave = opts.players[0];
+            game.crew = (primarySave?.game?.crew ?? [])
+                .filter(m => !(m.ghost && !m.ghost.liveOnly))
+                .map(m => ({ ...m, gear: [...m.gear] }));
+            for (const line of game.spawnCrew())
+                logger.log(line, 'all');
+        }
+        catch (err) {
+            logger.write(`spawnCrew (hosted boot) failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
         const spawnRoom = () => game.scene.determineStartRoom();
         // PER-PLAYER MAP EVENTS (map-overlay wave 2026-08-24): each rider
         // gets their own icon minimap -- the client holds no Room objects
@@ -368,6 +388,14 @@ export async function createHeadlessSession(opts) {
                 const res = await game.handleInputAs(actorName, input);
                 session.pushStatus();
                 pushMap();
+                // THE WEB MAP FOLLOWS THE ROOM, NOT JUST YOUR OWN BODY
+                // (oHhjxjqKuptDGMHLD: a looted body stayed on the map "until I
+                // move"; 9aEMA4APbB6rYtWnT: a killed NPC's dot never changed).
+                // The condition beat is what the browser draws actors from, and
+                // it fires only on the primary's OWN mutations -- a kill or a
+                // loot mutates the room, not the killer, so nothing fired until
+                // their next step. One nudge per command; the beat coalesces.
+                game.player.noteConditionChanged();
                 return res;
             })),
             addPlayer: (save) => runInSession(ctx, async () => {
@@ -489,6 +517,7 @@ export async function createHeadlessSession(opts) {
         game.onSceneChanged = () => {
             session.pushStatus();
             pushMap();
+            game.player.noteConditionChanged();
         };
         return session;
     });

package/bundle/typescript/src/commands/game/sideQuest/utilities/condition-report.js

@@ -236,23 +236,44 @@ export function buildConditionReport(player, deps) {
         // guessed role): a construct on the matrix plane -- IC, sprite, agent --
         // has no body in the room. Another player's body still shows even
         // while their persona rides the grid.
+        // DOWNED, NOT DROPPED (9aEMA4APbB6rYtWnT, 2026-09-11: "when I kill
+        // an NPC, their icon on the map should change"): the room panel
+        // draws somebody face-down as ☓; this beat used to drop them, so
+        // the web dot simply vanished -- or, worse, stood there until the
+        // next beat. They ride with kind 'downed' now.
         actors: (player.currentLocation ? visibleActorsIn(player.currentLocation, player) : [])
             .filter(a => !(a.plane === 'matrix' && a !== player && (a.icHost !== undefined || a.companionKind === 'sprite' || a.companionKind === 'agent')))
-            .filter(a => a !== player && !a.isIncapacitated())
+            .filter(a => a !== player)
             .slice(0, 24)
             .map(a => ({
             name: a.name,
             // THE SAME RED THE ROOM PANEL USES (see IConditionReportDeps
             // .isHostile): stance flag OR live enmity, and never a
             // surrendered one -- hostileByStance owns that clause.
-            kind: a.allyOf ? 'ally'
-                : (isHostile?.(a) ?? hostileByStance(a)) ? 'hostile' : 'neutral',
+            kind: a.isIncapacitated() ? 'downed'
+                : a.allyOf ? 'ally'
+                    : (isHostile?.(a) ?? hostileByStance(a)) ? 'hostile' : 'neutral',
             role: actorRole(a),
             spot: a.atSpot,
             cell: a.atCell ?? seats.get(a.name),
         })),
+        // THE DEAD (same report): the room's bodies, where they fell -- the
+        // panel's 💀. Gone from the list the moment a body is picked clean
+        // (loot.ts removeBody), which with the per-command beat is at once.
+        bodies: roomBodies(player),
     };
 }
+function roomBodies(player) {
+    const room = player.currentLocation;
+    if (!room || (player.plane !== 'meat' && player.plane !== 'drone'))
+        return [];
+    try {
+        return room.bodies.slice(0, 24).map(b => ({ name: b.name, cell: { x: b.cell.x, y: b.cell.y, z: b.cell.z } }));
+    }
+    catch {
+        return [];
+    }
+}
 let lastRoster = '';
 /** One session-log line whenever the room or the roster changes -- the
  *  cheapest possible answer to "what did the engine send?" */
@@ -276,7 +297,7 @@ function noteRoster(report) {
 const ADDITIVE_FIELDS = [
     'ar', 'actors', 'deckLine', 'deckDamage', 'astralPerceiving', 'bodyRoom', 'sustainingPenalty',
     'matrix', 'panMarks', 'hostMarksOnYou', 'marksPlaced', 'marksOnYou', 'deckStored', 'droneDamage', 'companions', 'pools', 'initiative',
-    'karma', 'nuyen', 'edge', 'grid',
+    'karma', 'nuyen', 'edge', 'grid', 'bodies',
 ];
 /** Refusal reasons already written to the session log -- one line each. */
 const announcedRefusals = new Map();

package/bundle/typescript/src/commands/game/sideQuest/utilities/npc-combat-brain.js

@@ -28,9 +28,25 @@ export async function runNpcActionPhase(enc, npc) {
     const logger = Logger.getInstance();
     if (npc.isIncapacitated() || npc.surrendered)
         return;
+    // THE ROOM SEES THE PHASE (aCjJiDDJM9jGZJeER, web run 2026-09-11: "I
+    // can't see Hammerhead Joe doing any combat" -- a hostile NPC). The
+    // verbs below answer the ACTOR: their return text is second person,
+    // goes into the NPC's own history and to a shell's master, and to
+    // nobody else. Only an attack that connects narrates through the
+    // exchange. So a phase spent readying a gun, reloading, closing the
+    // distance or taking cover -- most of a melee NPC's phases -- read to
+    // the player as "Joe acts (Initiative 9)." followed by nothing, which
+    // is the report. One third-person line per action, room-scoped, the
+    // same scope the exchange itself announces on.
+    const room = npc.currentLocation;
+    const tell = (line) => {
+        if (room)
+            logger.log(line, { room: room.name });
+    };
     const enemies = enc.enemiesOf(npc);
     if (enemies.length === 0) {
         logger.write(`Brain: ${npc.name} has nobody to fight -- phase forfeited.`);
+        tell(`${npc.name} looks for a target and finds none.`);
         return;
     }
     const target = pickTarget(npc, enemies);
@@ -49,8 +65,11 @@ export async function runNpcActionPhase(enc, npc) {
         if (weapon && !npc.weaponDrawn) {
             const r = await npc.actInCombat('draw');
             logger.write(`Brain: ${npc.name} draw -> ${r}`);
-            if (!npc.weaponDrawn)
+            if (!npc.weaponDrawn) {
+                tell(`${npc.name} fumbles for ${weapon.name} and comes up empty-handed.`);
                 return; // refused -- nothing else will go better
+            }
+            tell(`${npc.name} readies ${weapon.name}.`);
             continue;
         }
         // 2. A dry gun: reload if the pack allows, else it is a club.
@@ -58,6 +77,7 @@ export async function runNpcActionPhase(enc, npc) {
         if (dry && !weapon.jammed && hasAmmo(npc)) {
             const r = await npc.actInCombat('reload');
             logger.write(`Brain: ${npc.name} reload -> ${r}`);
+            tell(`${npc.name} reloads ${weapon.name}.`);
             return; // a reload is the phase (p.163 Reloading Weapons)
         }
         const melee = !firearm || dry || weapon.jammed;
@@ -68,16 +88,22 @@ export async function runNpcActionPhase(enc, npc) {
                 logger.write(`Brain: ${npc.name} move to ${targetSpot} -> ${r}`);
                 if (!canReach(npc, targetSpot)) {
                     // Couldn't close this turn: get behind something and wait.
+                    tell(`${npc.name} closes on ${target.name} but can't cover the ground this turn.`);
                     if (!isInCover(npc) && coverAvailableFor(npc) && (enc.budgetOf(npc)?.simple ?? 0) > 0) {
                         await npc.actInCombat('cover');
+                        if (isInCover(npc))
+                            tell(`${npc.name} ducks behind cover.`);
                     }
                     return;
                 }
+                tell(`${npc.name} closes on ${target.name}.`);
             }
             const b = enc.budgetOf(npc);
             if (b?.complexAvailable) {
                 const r = await npc.actInCombat(`attack ${target.name}`);
                 logger.write(`Brain: ${npc.name} attack ${target.name} -> ${r.split('\n')[0]}`);
+                if (!enc.budgetOf(npc)?.attackTaken)
+                    tell(`${npc.name} goes for ${target.name} and can't make it count.`);
             }
             return;
         }
@@ -87,13 +113,18 @@ export async function runNpcActionPhase(enc, npc) {
             logger.write(`Brain: ${npc.name} cover -> ${r}`);
             if (!isInCover(npc))
                 return;
+            tell(`${npc.name} ducks behind cover.`);
             continue;
         }
         if (!budget.attackTaken && budget.simple >= 1) {
             const r = await npc.actInCombat(`attack ${target.name}`);
             logger.write(`Brain: ${npc.name} attack ${target.name} -> ${r.split('\n')[0]}`);
-            if (!enc.budgetOf(npc)?.attackTaken)
+            if (!enc.budgetOf(npc)?.attackTaken) {
+                // The shot was refused (range, line, a jam): the room should
+                // see the attempt, not silence.
+                tell(`${npc.name} lines up on ${target.name} and the shot doesn't come.`);
                 return; // refused: don't loop on it
+            }
             continue;
         }
         return;

package/bundle/typescript/src/commands/game/sideQuest/utilities/shared-run.js

@@ -1319,6 +1319,18 @@ export class SharedRunSession {
                 restorePlayer(g.player, cloud.player);
                 if (g.saveFilePath)
                     writeSaveAtomic(g.saveFilePath, cloud);
+                // THE HOMECOMING OWED (8izFwokbehjHzkEAn, 3gFcHfheGSMPtpCFh): the
+                // server settled the table and left the aftermath on the save;
+                // this hub Game never went anywhere, so it pays it now -- rent,
+                // the DocWagon year, the Johnson's opinion -- and the homecoming
+                // save it writes clears the flag. After the disk write above, so
+                // the settled state is what lands, not the cloud's pre-settled one.
+                const owed = cloud.game?.pendingHomecoming;
+                if (owed) {
+                    const lines = g.applyHostedHomecoming(owed);
+                    if (lines)
+                        Logger.getInstance().logWithColor(lines, 'green');
+                }
             }
         }
         catch (err) {

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

@@ -1241,7 +1241,15 @@ export function lockedRouteHint(room, direction, door) {
     if (door.heldBy) {
         return ` It's barred from ${door.heldBy.room} -- ${door.heldBy.device} is over there, not here.`;
     }
-    // A plain keyed door has no device and no route to invent.
+    // A PLAIN KEYED DOOR (S8WdW7gm9tFGaxeCi): there IS a route, and the
+    // Door knows it -- the key item it was locked with, and the one verb
+    // that works it. The comment here used to say "no route to invent";
+    // naming a route that exists is not inventing one, and the silence
+    // read as a soft-lock in play. Scene-factory step 4.95 guarantees the
+    // named key is a real item somewhere in the scene.
+    if (door.unlockItemOrSolution) {
+        return ` It takes ${door.unlockItemOrSolution} -- "unlock ${String(direction).toLowerCase()}" with it on you.`;
+    }
     return '';
 }
 export function doorwayKindOf(spotName) {

package/package.json

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