@maka/maka-cli 5.3.17 → 5.5.0

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

@@ -0,0 +1,243 @@
+import { Command } from './command.js';
+import { CombatExchange } from '../utilities/combat-exchange.js';
+import { fuzzyPickName } from '../utilities/fuzzy-match.js';
+import { describeFledTarget } from '../utilities/pursuit.js';
+import { shellsInRoom, resolveBodyAttack, crossPlaneRefusal } from '../utilities/planes.js';
+/**
+ * Shadowrun-style dice-pool combat, one full exchange per command:
+ *
+ *   1. Attacker rolls Agility + combat skill + weapon bonus, opposed by the
+ *      defender's Reaction. Net hits land the blow.
+ *   2. Damage = weapon DV + net hits, soaked by Body + armor (each soak hit
+ *      cancels one box).
+ *   3. Whatever gets through fills the defender's condition monitor; a full
+ *      track is death.
+ *   4. If the defender survives, they immediately strike back with the same
+ *      math reversed -- starting a fight means eating one, so a fight is a
+ *      real decision, not a free action.
+ *
+ * Wound modifiers (-1 die per 3 boxes taken) apply to every pool on both
+ * sides, so a fight tilts as it goes. Pools/derivations live on Player
+ * (getAttackPool() etc.); narration pacing, strike resolution, and death
+ * handling live in CombatExchange (shared with spell combat -- see
+ * cast.ts). This command only orchestrates the weapon exchange.
+ */
+export class AttackCommand extends Command {
+    static verb = 'attack';
+    static description = 'Attack someone in the room -- dice-pool combat with your equipped weapon. They WILL hit back.';
+    async execute(args = []) {
+        if (!args || args.length === 0) {
+            return 'Who do you want to attack? Try: `attack <name>`';
+        }
+        // The dead (and the unconscious) don't fight. Covers a downed player
+        // (who stays in the scene -- endGame only freezes input) and a downed
+        // NPC whose in-flight AI loop is still issuing commands after removal
+        // from the scene.
+        if (this.actor.isIncapacitated()) {
+            return `You're down. The fight is over.`;
+        }
+        // Violence is loud -- sneak mode ends the moment you swing.
+        this.actor.sneaking = false;
+        const room = this.actor.currentLocation;
+        if (!room) {
+            return 'You are not in a valid location to fight anyone.';
+        }
+        // Same fuzzy matching "take" uses (see utilities/fuzzy-match.ts) --
+        // punctuation, case, typos, and partial names all resolve, but an
+        // ambiguous guess deliberately misses rather than shooting someone
+        // at random. You can only fight what shares your plane: meat can't
+        // touch a Matrix persona or an astral form, and vice versa.
+        const targetName = args.join(' ');
+        const candidates = this.scene.getActorsInRoom(room).filter(a => a !== this.actor && a.plane === this.actor.plane);
+        const pickedName = fuzzyPickName(targetName, candidates.map(a => a.name));
+        const target = pickedName ? candidates.find(a => a.name === pickedName) : undefined;
+        if (!target) {
+            // An empty body IS attackable from the meat plane -- one unanswered
+            // strike, and its owner gets slammed back into it (see planes.ts).
+            if (this.actor.plane === 'meat') {
+                const shells = shellsInRoom(this.scene, room);
+                const shellPick = fuzzyPickName(targetName, shells.map(s => s.name));
+                const shell = shellPick ? shells.find(s => s.name === shellPick) : undefined;
+                if (shell) {
+                    // Even a defenseless body gets shot, not slapped -- draw first.
+                    const drawn = this.actor.drawWeapon();
+                    const lines = resolveBodyAttack(this.scene, this.actor, shell);
+                    if (drawn)
+                        lines.unshift(`${this.actor.name} draws ${drawn.name}.`);
+                    const exchange = new CombatExchange(this.scene, this.logger, this.actor);
+                    await exchange.announce(lines);
+                    if (shell.isDown()) {
+                        const death = await exchange.resolveDeath(shell, this.actor, {
+                            fallLine: `${shell.name}'s body never wakes -- whatever came rushing back arrived too late. Their gear scatters across ${room.name}.`,
+                        });
+                        lines.push(...death);
+                    }
+                    return this.actor === this.scene.getPlayer() ? '' : lines.join('\n');
+                }
+            }
+            // Visible on another plane beats "no one": a projecting mage's look
+            // lists the meat world's auras, so a miss here must name the actual
+            // rule, not deny the person exists (see planes.crossPlaneRefusal).
+            const cross = crossPlaneRefusal(this.scene, this.actor, room, targetName, 'strike');
+            if (cross)
+                return cross;
+            // If they exist but fled the room, say WHERE and how to chase --
+            // this result is what lands in a pursuing NPC's AI history, and
+            // without the explicit direction a hostile NPC just spams failed
+            // attacks at the empty room instead of following (real session:
+            // dozens of them while the player ping-ponged between two rooms).
+            const fled = describeFledTarget(this.scene, room, targetName);
+            if (fled)
+                return fled;
+            const present = candidates.map(a => a.name).join(', ') || 'no one';
+            return `You don't see anyone named "${targetName}" here to attack. Present: ${present}.`;
+        }
+        // The dead can't be fought either. A downed NPC is removed from the
+        // scene, so a still-present downed target can only be the dead player
+        // -- found via a real session where the killer's AI loop, with nothing
+        // gating this, beat the player's corpse for a full minute, re-running
+        // the whole death sequence every swing. The plain-text result below is
+        // what actually lands in the attacker's AI history and tells it the
+        // fight is over.
+        if (target.isIncapacitated()) {
+            return `${target.name} is already down. The fight is over -- there's nothing left to attack.`;
+        }
+        // One exchange at a time per combatant: overlapping AI loops firing
+        // parallel exchanges once double-killed a target (two death events,
+        // two narrations). The player is refused cleanly (they can just retype
+        // in the lull); an NPC's attack instead WAITS for the lull and re-runs
+        // -- discarding it meant NPCs never got a single action off, because
+        // their AI always reacts while the player's exchange is still beating
+        // out (see CombatExchange.waitForLull).
+        if (this.actor.inExchange || target.inExchange) {
+            if (this.actor === this.scene.getPlayer()) {
+                return this.actor.inExchange
+                    ? `You're already mid-exchange -- let it resolve.`
+                    : `${target.name} is already trading fire -- wait for that exchange to resolve.`;
+            }
+            if (this.actor.waitingForLull) {
+                return `You're already waiting for an opening -- one move at a time.`;
+            }
+            this.actor.waitingForLull = true;
+            try {
+                const settled = await CombatExchange.waitForLull([this.actor, target]);
+                if (!settled) {
+                    return `You're already mid-exchange -- let it resolve.`;
+                }
+                this.logger.write(`${this.actor.name}'s attack waited out an exchange and now retries.`);
+                return await this.execute(args);
+            }
+            finally {
+                this.actor.waitingForLull = false;
+            }
+        }
+        // A deliberately INITIATED attack with a dry gun is blocked with a
+        // reload prompt -- the involuntary strikes (retaliation) auto-fall-back
+        // to fists instead (see CombatExchange.weaponProfile).
+        const weaponItem = this.actor.equipment.rightHand?.weapon ?? this.actor.equipment.leftHand?.weapon;
+        if (this.usesEquippedWeapon() && weaponItem?.isFirearm() && weaponItem.jammed) {
+            return `The ${weaponItem.name}'s smartlink is LOCKED -- someone cracked your PAN. "reboot" to clear it, or go in swinging.`;
+        }
+        if (this.usesEquippedWeapon() && weaponItem?.isFirearm() && weaponItem.ammo <= 0) {
+            return `Click -- the ${weaponItem.name} is dry. "reload" (needs ammunition), or go in swinging with something else.`;
+        }
+        const exchange = new CombatExchange(this.scene, this.logger, this.actor);
+        const report = [];
+        // Movement locks for the duration of the exchange when the player is a
+        // combatant (see go.ts) -- the try/finally is exception safety so a
+        // crash mid-exchange can never leave the player permanently rooted.
+        // beginExchange auto-draws holstered weapons for whoever's weapon is
+        // about to speak -- the aggressor only when this attack actually uses
+        // it (subdue's hold doesn't; the defender's counter always does).
+        const drawLines = exchange.beginExchange(target, { aggressorDraws: this.usesEquippedWeapon() });
+        try {
+            this.actor.performAction(this.actionVerb(), target.name);
+            this.scene.addWorldEvent(`${this.actor.name} ${this.actionVerb()} ${target.name} in ${room.name}.`);
+            if (drawLines.length > 0) {
+                report.push(...drawLines);
+                await exchange.announce(drawLines);
+            }
+            // ---- Initiative decides who acts first (see rollInitiative) ----
+            const init = exchange.rollInitiative(this.actor, target);
+            report.push(...init.lines);
+            await exchange.announce(init.lines);
+            // ---- The two strikes, in initiative order. The aggressor's strike
+            // uses this command's profile (weapon, or subdue's stun hold); the
+            // defender's answer is always their own lethal weapon. Being
+            // preempted and dropped means your swing never happens. ----
+            for (const striker of [init.first, init.second]) {
+                if (striker.isIncapacitated())
+                    continue;
+                const defender = striker === this.actor ? target : this.actor;
+                if (defender.isIncapacitated())
+                    break;
+                // A mid-exchange forced dump (cold-sim persona crash) yanks a
+                // combatant off this plane -- the fight is over, not continued
+                // across realities.
+                if (striker.plane !== defender.plane)
+                    break;
+                const profile = striker === this.actor ? this.strikeProfile(exchange, target) : undefined;
+                const prefix = striker === init.second ? [`${striker.name} retaliates!`] : [];
+                const strike = [...prefix, ...exchange.resolveStrike(striker, defender, profile)];
+                report.push('', ...strike);
+                await exchange.announce(strike);
+                const takedown = await this.resolveTakedown(exchange, defender, striker);
+                if (takedown) {
+                    report.push(...takedown);
+                    return await exchange.finishExchange(report);
+                }
+            }
+            // ---- The initiative pass: a decisive winner presses the advantage
+            // with one extra strike. ----
+            if (init.extraStriker && !init.extraStriker.isIncapacitated()) {
+                const defender = init.extraStriker === this.actor ? target : this.actor;
+                if (!defender.isIncapacitated() && init.extraStriker.plane === defender.plane) {
+                    const profile = init.extraStriker === this.actor ? this.strikeProfile(exchange, target) : undefined;
+                    const strike = [`${init.extraStriker.name} presses the advantage!`, ...exchange.resolveStrike(init.extraStriker, defender, profile)];
+                    report.push('', ...strike);
+                    await exchange.announce(strike);
+                    const takedown = await this.resolveTakedown(exchange, defender, init.extraStriker);
+                    if (takedown)
+                        report.push(...takedown);
+                }
+            }
+            return await exchange.finishExchange(report);
+        }
+        finally {
+            this.scene.endPlayerExchange();
+            exchange.releaseExchange();
+        }
+    }
+    /** subdue.ts overrides to false: its strike ignores the equipped gun entirely. */
+    usesEquippedWeapon() {
+        return true;
+    }
+    /** Overridden by subdue.ts to swap in a stun-dealing strike. undefined = weapon default. */
+    strikeProfile(_exchange, _target) {
+        return undefined;
+    }
+    /** The verb observers see ("attacks" / "moves to subdue"). */
+    actionVerb() {
+        return 'attacks';
+    }
+    /**
+     * Post-strike incapacitation, both flavors: a full physical track is a
+     * death; a full stun track (only reachable via a stun-dealing strike,
+     * or its overflow) is a live capture. Returns the narration, or null if
+     * the fallen still stands. Either combatant can be the one who falls --
+     * initiative order means the aggressor eats preemptive strikes too.
+     */
+    async resolveTakedown(exchange, fallen, killer) {
+        if (fallen.isDown()) {
+            return exchange.resolveDeath(fallen, killer);
+        }
+        if (fallen.isUnconscious()) {
+            return exchange.resolveDeath(fallen, killer, {
+                fatal: false,
+                fallLine: `${fallen.name} sags and drops -- out cold, breathing. Their gear scatters across ${fallen.currentLocation.name}.`,
+            });
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=attack.js.map

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

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

package/bundle/typescript/src/commands/game/sideQuest/commands/bluff.d.ts

@@ -0,0 +1,16 @@
+import { BypassCommand } from './bypass-command.js';
+import { PuzzleBypassType } from '../types/seed/puzzle-seed.js';
+/**
+ * The CON skill's barrier verb: fast-talk past a social gate -- a doorman,
+ * an intercom challenge, a receptionist with a list (bypassType "con").
+ * Same fatal stakes as pick/hack/cast: a blown story means whoever you
+ * were working knows exactly what you are. Rolled on Charisma + con.
+ */
+export declare class BluffCommand extends BypassCommand {
+    protected static verb: string;
+    protected static description: string;
+    protected bypassType: PuzzleBypassType;
+    protected noPuzzleMessage: string;
+    execute(args: string[]): Promise<string>;
+    protected determineOutcome(): Promise<boolean>;
+}

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

@@ -0,0 +1,39 @@
+import { BypassCommand } from './bypass-command.js';
+import { rollPool, formatRoll } from '../utilities/dice.js';
+/**
+ * The CON skill's barrier verb: fast-talk past a social gate -- a doorman,
+ * an intercom challenge, a receptionist with a list (bypassType "con").
+ * Same fatal stakes as pick/hack/cast: a blown story means whoever you
+ * were working knows exactly what you are. Rolled on Charisma + con.
+ */
+export class BluffCommand extends BypassCommand {
+    static verb = 'bluff';
+    static description = 'Talk your way past a social barrier (a doorman, a voice-gate) without the passphrase -- Charisma + con, but a blown bluff is fatal: no second chances.';
+    bypassType = 'con';
+    noPuzzleMessage = `There's nobody here to bluff past.`;
+    async execute(args) {
+        // Fast-talk needs a face and a voice on the scene -- your meat ones.
+        if (this.actor.plane === 'matrix') {
+            return `Your silver tongue is meat-side, slumped with the rest of you. "jack out" to run your game in person.`;
+        }
+        if (this.actor.plane === 'astral') {
+            return `Nobody physical can hear a word you say from out here. "return" to your body first.`;
+        }
+        // Working a mark out loud is the opposite of sneaking (see sneak.ts).
+        this.actor.sneaking = false;
+        return super.execute(args);
+    }
+    async determineOutcome() {
+        // A CON test (Charisma + con, 2 hits; unskilled Charisma - 1) -- the
+        // Face's answer to the decker's terminal and the ops specialist's
+        // maglock.
+        const skill = this.actor.skillRating('con');
+        const pool = Math.max(1, this.actor.charisma + (skill > 0 ? skill : -1) + this.actor.woundModifier - this.actor.sustainingPenalty);
+        const roll = rollPool(pool);
+        if (this.actor === this.scene.getPlayer()) {
+            this.logger.log(`Con: ${formatRoll(roll)} (2+ to sell it)`);
+        }
+        return roll.hits >= 2;
+    }
+}
+//# sourceMappingURL=bluff.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bluff.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/bluff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,aAAa;IACnC,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC;IACtB,MAAM,CAAC,WAAW,GAAG,wJAAwJ,CAAC;IAC9K,UAAU,GAAqB,KAAK,CAAC;IACrC,eAAe,GAAG,oCAAoC,CAAC;IAEjE,KAAK,CAAC,OAAO,CAAC,IAAc;QAC1B,qEAAqE;QACrE,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,uGAAuG,CAAC;QACjH,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,qFAAqF,CAAC;QAC/F,CAAC;QACD,sEAAsE;QACtE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC;QAC5B,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAES,KAAK,CAAC,gBAAgB;QAC9B,qEAAqE;QACrE,kEAAkE;QAClE,WAAW;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACnI,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;IACxB,CAAC"}

package/bundle/typescript/src/commands/game/sideQuest/commands/brandish.d.ts

@@ -0,0 +1,21 @@
+import { Command, ICommand } from './command.js';
+/**
+ * The two halves of the holster mechanic (see Player.weaponDrawn): an
+ * equipped weapon rides holstered until "brandish" puts it in hand, and
+ * "holster" stows it again. Combat never requires either -- an exchange
+ * auto-draws (CombatExchange.beginExchange) -- so what these verbs really
+ * are is body language: both fire performAction, so every NPC in the room
+ * watches the steel come out (a threat display) or go away (a de-escalation
+ * that pairs with "surrender"). Registered as brandish/draw and
+ * holster/stow.
+ */
+export declare class BrandishCommand extends Command implements ICommand {
+    protected static verb: string;
+    protected static description: string;
+    execute(_args?: string[]): Promise<string>;
+}
+export declare class HolsterCommand extends Command implements ICommand {
+    protected static verb: string;
+    protected static description: string;
+    execute(_args?: string[]): Promise<string>;
+}

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

@@ -0,0 +1,82 @@
+import { Command } from './command.js';
+import { Category } from '../types/shared/item-enum.js';
+import { rollPool, formatRoll } from '../utilities/dice.js';
+/**
+ * The two halves of the holster mechanic (see Player.weaponDrawn): an
+ * equipped weapon rides holstered until "brandish" puts it in hand, and
+ * "holster" stows it again. Combat never requires either -- an exchange
+ * auto-draws (CombatExchange.beginExchange) -- so what these verbs really
+ * are is body language: both fire performAction, so every NPC in the room
+ * watches the steel come out (a threat display) or go away (a de-escalation
+ * that pairs with "surrender"). Registered as brandish/draw and
+ * holster/stow.
+ */
+export class BrandishCommand extends Command {
+    static verb = 'brandish';
+    static description = 'Draw your holstered weapon -- everyone present sees it happen. "holster" stows it.';
+    async execute(_args = []) {
+        const actor = this.actor;
+        // Your gun is meat -- it stayed behind with the rest of you.
+        if (actor.plane === 'matrix') {
+            return `Your weapon is hanging off a body you're not currently in. The Matrix runs on attack programs, not iron.`;
+        }
+        if (actor.plane === 'astral') {
+            return `Your weapon stayed with your body -- on the astral, your will IS the weapon.`;
+        }
+        const carried = actor.getCarriedWeapon();
+        if (!carried) {
+            // Point at the fix if there's a weapon one "equip" away.
+            const weaponCategories = [Category.Weapon, Category.MeleeWeapon, Category.RangedWeapon];
+            const inBag = actor.inventory.getAllItems().find(i => weaponCategories.includes(i.category));
+            return inBag
+                ? `Nothing holstered. The ${inBag.name} is still loose in your bag -- "equip ${inBag.name}" first.`
+                : `Nothing to draw -- you're not carrying a weapon.`;
+        }
+        if (actor.weaponDrawn) {
+            return `The ${carried.name} is already in your hand.`;
+        }
+        actor.drawWeapon();
+        // A threat display is the OPPOSITE of sneaking.
+        actor.sneaking = false;
+        // The INTIMIDATION skill gives the display its teeth: the menace roll
+        // rides into the witnessed action itself, so every NPC's AI hears HOW
+        // convincing the steel looked -- and reacts to that, not just the act.
+        const skill = actor.skillRating('intimidation');
+        const menaceRoll = rollPool(Math.max(1, actor.charisma + (skill > 0 ? skill : -1) + actor.woundModifier - actor.sustainingPenalty));
+        const menace = menaceRoll.hits >= 3
+            ? 'radiating flat, lethal intent'
+            : menaceRoll.hits >= 1
+                ? 'with hard, steady eyes'
+                : 'though the hand wavers, just a little';
+        actor.performAction('draws', `${carried.name} -- ${menace}`);
+        this.logger.write(`${actor.name} brandishes ${carried.name} (${menaceRoll.hits} menace hits).`);
+        this.scene.updateStatus();
+        const ammoNote = carried.isFirearm()
+            ? (carried.ammo === 0 ? ' The magazine is DRY -- "reload".' : ` ${carried.ammo} rounds ready.`)
+            : '';
+        return `You draw the ${carried.name}.${ammoNote} Menace: ${formatRoll(menaceRoll)} -- everyone here just watched you do it.`;
+    }
+}
+export class HolsterCommand extends Command {
+    static verb = 'holster';
+    static description = 'Stow your drawn weapon -- a visible stand-down. "brandish" draws it again.';
+    async execute(_args = []) {
+        const actor = this.actor;
+        if (actor.inExchange) {
+            return `Mid-exchange is no time to put your weapon away -- let it resolve.`;
+        }
+        const carried = actor.getCarriedWeapon();
+        if (!carried) {
+            return `Nothing to holster -- you're not carrying a weapon.`;
+        }
+        if (!actor.weaponDrawn) {
+            return `The ${carried.name} is already holstered.`;
+        }
+        actor.stowWeapon();
+        actor.performAction('holsters', carried.name);
+        this.logger.write(`${actor.name} holsters ${carried.name}.`);
+        this.scene.updateStatus();
+        return `You holster the ${carried.name}. Hands empty, posture easy -- everyone here saw you stand down.`;
+    }
+}
+//# sourceMappingURL=brandish.js.map

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

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

package/bundle/typescript/src/commands/game/sideQuest/commands/bypass-command.d.ts

@@ -0,0 +1,28 @@
+import { Command, ICommand } from './command.js';
+import { PuzzleBypassType } from '../types/seed/puzzle-seed.js';
+/**
+ * Shared implementation for pick/hack/cast. The gate check (already
+ * solved? prerequisite met? does this puzzle even have this bypassType?)
+ * always runs first and synchronously, so a doomed attempt never makes the
+ * player sit through an interactive challenge they were never going to be
+ * allowed to attempt. Each concrete command differs in its verb,
+ * description, bypass type, the "nothing to do that to" message, and
+ * optionally how the outcome itself gets determined (see
+ * determineOutcome() -- defaults to a coin flip; lockpicking overrides it
+ * with a real minigame).
+ */
+export declare abstract class BypassCommand extends Command implements ICommand {
+    protected abstract bypassType: PuzzleBypassType;
+    protected abstract noPuzzleMessage: string;
+    /** Default: a flat coin flip. Override for a type with its own minigame. */
+    protected determineOutcome(): Promise<boolean>;
+    /**
+     * There's no typed answer here to disambiguate with (unlike solve.ts),
+     * so with more than one barrier in the room the player has to name which
+     * one: a direction ("pick north", for a locked door) or a word from the
+     * barrier's own name ("pick maglock"). With only one candidate, a bare
+     * "pick" still works exactly as before.
+     */
+    private resolveTarget;
+    execute(args: string[]): Promise<string>;
+}

package/bundle/typescript/src/commands/game/sideQuest/commands/bypass-command.js

@@ -0,0 +1,101 @@
+import { Command } from './command.js';
+/**
+ * Shared implementation for pick/hack/cast. The gate check (already
+ * solved? prerequisite met? does this puzzle even have this bypassType?)
+ * always runs first and synchronously, so a doomed attempt never makes the
+ * player sit through an interactive challenge they were never going to be
+ * allowed to attempt. Each concrete command differs in its verb,
+ * description, bypass type, the "nothing to do that to" message, and
+ * optionally how the outcome itself gets determined (see
+ * determineOutcome() -- defaults to a coin flip; lockpicking overrides it
+ * with a real minigame).
+ */
+export class BypassCommand extends Command {
+    /** Default: a flat coin flip. Override for a type with its own minigame. */
+    async determineOutcome() {
+        return Math.random() < 0.5;
+    }
+    /**
+     * There's no typed answer here to disambiguate with (unlike solve.ts),
+     * so with more than one barrier in the room the player has to name which
+     * one: a direction ("pick north", for a locked door) or a word from the
+     * barrier's own name ("pick maglock"). With only one candidate, a bare
+     * "pick" still works exactly as before.
+     */
+    resolveTarget(args, targets) {
+        const raw = args.join(' ').trim().toLowerCase();
+        if (!raw) {
+            if (targets.length === 1)
+                return { target: targets[0] };
+            const options = targets.map(t => t.direction ?? t.label).join(', ');
+            return { error: `There's more than one thing to ${this.bypassType === 'lockpick' ? 'pick' : this.bypassType === 'hack' ? 'hack' : this.bypassType === 'con' ? 'bluff' : 'cast'} at here -- say which: ${options}.` };
+        }
+        if (this.isValidDirection(raw)) {
+            const match = targets.find(t => t.direction === raw);
+            return match ? { target: match } : { error: `There's nothing to bypass in that direction.` };
+        }
+        const matches = targets.filter(t => t.label.toLowerCase().includes(raw));
+        if (matches.length === 1)
+            return { target: matches[0] };
+        if (matches.length > 1)
+            return { error: `That could mean more than one thing here -- be more specific.` };
+        return { error: `There's nothing here called "${raw}".` };
+    }
+    async execute(args) {
+        const room = this.actor.currentLocation;
+        const targets = (room?.getPuzzleTargets() ?? []).filter(t => t.puzzle.bypassType === this.bypassType);
+        if (targets.length === 0) {
+            return this.noPuzzleMessage;
+        }
+        const { target, error } = this.resolveTarget(args, targets);
+        if (!target) {
+            return error ?? this.noPuzzleMessage;
+        }
+        const gate = target.puzzle.checkBypassGate(this.bypassType);
+        if (!gate.allowed) {
+            return gate.message ?? `You can't do that here.`;
+        }
+        const succeeded = await this.determineOutcome();
+        const result = target.puzzle.resolveBypass(this.bypassType, succeeded);
+        if (result.success) {
+            if (target.door) {
+                target.door.isLocked = false;
+                this.scene.updateExits(room);
+                this.scene.addWorldEvent(`${this.actor.name} bypassed (${this.bypassType}) the way ${target.direction} in ${room.name}.`);
+            }
+            else if (target.puzzle.rewardItem) {
+                this.actor.inventory.addItem(target.puzzle.rewardItem);
+                this.scene.addWorldEvent(`${this.actor.name} bypassed "${target.puzzle.name}" (${this.bypassType}) in ${room.name}.`);
+                this.scene.updateInventory(this.scene.getPlayer().inventory);
+            }
+        }
+        if (result.alarmed) {
+            // The consequence for a failed bypass: NPCs already listen for world
+            // events (see scene.ts's getWorldEventsSummary()), so this alone lets
+            // them react organically without a dedicated alarm/alert subsystem.
+            this.scene.addWorldEvent(`${this.actor.name}'s ${this.bypassType} attempt on "${target.puzzle.name}" in ${room.name} went loud.`);
+        }
+        this.logger.write(`${this.actor.name} attempted to ${this.bypassType} "${target.puzzle.name}": ${result.success ? 'success' : 'failure'}${result.alarmed ? ' (alarmed)' : ''}`);
+        this.actor.performAction(this.bypassType, result.message);
+        // A failed bypass is instant, unrecoverable death -- there's no partial
+        // credit for tripping an alarm or a ward's backlash mid-run. Reuses the
+        // same endGame() a player-kill already uses (see kill.ts): freezes
+        // input and self-announces directly to the screen, so the fatal reason
+        // stays on screen instead of vanishing the instant blessed's alternate
+        // buffer tears down. That announcement happens synchronously before
+        // this returns, so it renders BEFORE this command's own return value --
+        // found via a real session where an immediate process.exit() killed the
+        // alternate screen before the player had any chance to read why. Only
+        // ends the actual player's session: an NPC has no `game` in its context
+        // (see command.ts), so this is a no-op for an NPC's own failed attempt.
+        if (result.alarmed && this.game) {
+            await this.scene.endGame();
+            this.logger.logWithColor(result.message, 'red');
+            this.logger.logWithColor(`💀 GAME OVER -- your run ends here.`, 'red');
+            this.logger.logWithColor(`Press ctrl-c to quit.`, 'red');
+            return '';
+        }
+        return result.message;
+    }
+}
+//# sourceMappingURL=bypass-command.js.map

package/bundle/typescript/src/commands/game/sideQuest/commands/bypass-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bypass-command.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/bypass-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,cAAc,CAAC;AAIjD;;;;;;;;;;GAUG;AACH,MAAM,OAAgB,aAAc,SAAQ,OAAO;IAIjD,4EAA4E;IAClE,KAAK,CAAC,gBAAgB;QAC9B,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACK,aAAa,CAAC,IAAc,EAAE,OAAuB;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAEhD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpE,OAAO,EAAE,KAAK,EAAE,kCAAkC,IAAI,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,0BAA0B,OAAO,GAAG,EAAE,CAAC;QACvN,CAAC;QAED,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC;YACrD,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,8CAA8C,EAAE,CAAC;QAC/F,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACzE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,+DAA+D,EAAE,CAAC;QAC1G,OAAO,EAAE,KAAK,EAAE,gCAAgC,GAAG,IAAI,EAAE,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAc;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;QACxC,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU,CAAC,CAAC;QAEtG,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,eAAe,CAAC;QAC9B,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,KAAK,IAAI,IAAI,CAAC,eAAe,CAAC;QACvC,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,OAAO,IAAI,yBAAyB,CAAC;QACnD,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAEvE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;gBAC7B,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC7B,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,cAAc,IAAI,CAAC,UAAU,aAAa,MAAM,CAAC,SAAS,OAAO,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YAC5H,CAAC;iBAAM,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;gBACpC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBACvD,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,cAAc,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,UAAU,QAAQ,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;gBACtH,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,qEAAqE;YACrE,sEAAsE;YACtE,oEAAoE;YACpE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,IAAI,CAAC,UAAU,gBAAgB,MAAM,CAAC,MAAM,CAAC,IAAI,QAAQ,IAAI,CAAC,IAAI,aAAa,CAAC,CAAC;QACpI,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,iBAAiB,IAAI,CAAC,UAAU,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChL,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAE1D,wEAAwE;QACxE,wEAAwE;QACxE,mEAAmE;QACnE,uEAAuE;QACvE,uEAAuE;QACvE,oEAAoE;QACpE,wEAAwE;QACxE,wEAAwE;QACxE,sEAAsE;QACtE,wEAAwE;QACxE,wEAAwE;QACxE,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAChC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;YACvE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;YACzD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;CACF"}

package/bundle/typescript/src/commands/game/sideQuest/commands/call.d.ts

@@ -0,0 +1,19 @@
+import { Command, ICommand } from './command.js';
+export declare class CallCommand extends Command implements ICommand {
+    protected static verb: string;
+    protected static description: string;
+    execute(args: string[]): Promise<string>;
+    private hasEquippedCommlink;
+    private hasCommlink;
+    /**
+     * Multi-word names ("Mr. Johnson") shouldn't require the player to quote
+     * them just to call someone, and partial names shouldn't fail -- found
+     * via real sessions where "call Mr. Johnson" (period parsing), then
+     * "call mr" and "call Mr. J" (partials) all bounced. Tries progressively
+     * shorter word-prefixes of the input (longest first), resolving each
+     * through the same fuzzy matcher "take"/"attack"/"cast" use (punctuation
+     * and typo tolerant; an ambiguous fragment deliberately misses).
+     * Whatever's left over after the matched name becomes the message.
+     */
+    private resolveTargetAndMessage;
+}