@maka/maka-cli 5.3.17 → 5.4.0

package/bundle/typescript/package.json

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

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

@@ -0,0 +1,43 @@
+import { ICombatAttributes } from './models/player.js';
+import { Item } from './models/item.js';
+import { Size, Category, Rating } from './types/shared/item-enum.js';
+/**
+ * Playable archetypes -- the SR5e core-book spreads, picked at game launch
+ * (see sideQuest.sub.cmd.ts). This is deliberately archetype-pick rather
+ * than point-buy: one quick select and you're on the street. Each spread
+ * trades away as much as it gains against the balanced Runner baseline
+ * (body 4 / agility 4 / reaction 4 / skill 3 / str 3 / wil 3 / log 3 /
+ * int 3 / cha 3 / edge 2), and the premium attributes are the identity:
+ * magic makes a caster, magic+adept makes an adept, resonance makes a
+ * technomancer, logic 7 makes a decker.
+ *
+ * REQUISITES: `gear` is the archetype's signature kit, granted (and
+ * auto-equipped where wearable) at character creation ON TOP of the
+ * scene's generic starting loadout. A Decker without a deck isn't a
+ * decker -- the gear is part of the build.
+ */
+export interface IArchetypeGearDef {
+    name: string;
+    description: string;
+    size: Size;
+    category: Category;
+    rating: Rating;
+    weight: number;
+    shape: string;
+    color: string;
+    texture: string;
+}
+export interface IArchetype {
+    name: string;
+    description: string;
+    combat: ICombatAttributes;
+    gear?: IArchetypeGearDef[];
+}
+export declare const ARCHETYPES: IArchetype[];
+export declare function getArchetype(name?: string): IArchetype;
+/**
+ * Instantiates an archetype's requisite gear (see IArchetype.gear).
+ * ui.ts grants these at character creation and auto-equips the wearable
+ * ones -- a samurai starts with the Predator IN HAND, not in a duffel.
+ */
+export declare function createArchetypeGear(archetype: IArchetype): Item[];

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

@@ -0,0 +1,131 @@
+import { Item } from './models/item.js';
+import { Size, Category, Rating } from './types/shared/item-enum.js';
+const gearDef = (partial) => ({
+    size: Size.Small,
+    weight: 1,
+    shape: 'Gear',
+    color: 'Black',
+    texture: 'Matte',
+    ...partial,
+});
+export const ARCHETYPES = [
+    {
+        name: 'Runner',
+        description: 'The balanced default: decent at everything, spectacular at nothing.',
+        combat: { body: 4, agility: 4, reaction: 4, combatSkill: 3, strength: 3, willpower: 3, logic: 3, intuition: 3, charisma: 3, edge: 2, magic: 0 },
+    },
+    {
+        name: 'Street Samurai',
+        description: 'Chrome and trigger discipline. Hits hard, soaks harder, thinks later.',
+        combat: { body: 5, agility: 5, reaction: 4, combatSkill: 5, strength: 4, willpower: 3, logic: 2, intuition: 3, charisma: 2, edge: 2, magic: 0 },
+        gear: [
+            gearDef({ name: 'Ares Predator V', description: 'The iconic heavy pistol of the shadows -- smartgun-linked, and it never jams when it matters.', category: Category.RangedWeapon, rating: Rating.Rare, shape: 'Pistol', weight: 2 }),
+        ],
+    },
+    {
+        // Physical magic: counts as Awakened (auras, assensing) but casts
+        // nothing and cannot project -- half their magic rides every meat
+        // attack and defense pool instead (see Player.adept).
+        name: 'Adept',
+        description: 'Magic as muscle: faster than chrome, no spells, no projection -- the body IS the focus.',
+        combat: { body: 4, agility: 4, reaction: 4, combatSkill: 4, strength: 4, willpower: 4, logic: 2, intuition: 3, charisma: 2, edge: 2, magic: 5, adept: true },
+        gear: [
+            gearDef({ name: 'Weapon Focus Katana', description: 'A blade that drinks its wielder\'s magic -- the edge sings at frequencies steel shouldn\'t reach.', category: Category.MeleeWeapon, rating: Rating.Rare, size: Size.Medium, shape: 'Sword', color: 'Silver', texture: 'Folded Steel', weight: 1.5 }),
+        ],
+    },
+    {
+        name: 'Covert Ops',
+        description: 'In through the vents, out before the alarm. Locks are suggestions.',
+        combat: { body: 3, agility: 5, reaction: 4, combatSkill: 3, strength: 3, willpower: 3, logic: 3, intuition: 5, charisma: 3, edge: 3, magic: 0 },
+        gear: [
+            gearDef({ name: 'Lockpick Set', description: 'Precision picks, tension bars, and a maglock passkey of arguable legality.', category: Category.Tool, rating: Rating.Standard, size: Size.Tiny, weight: 0.3 }),
+            gearDef({ name: 'Chameleon Suit', description: 'Ruthenium-coated infiltration wear that drinks the light around it.', category: Category.ArmorClothing, rating: Rating.Standard, size: Size.Medium, shape: 'Suit', color: 'Shifting Gray', texture: 'Ruthenium Weave', weight: 2 }),
+        ],
+    },
+    {
+        name: 'Face',
+        description: 'Talks the job open before anyone draws. Charm, luck, and just enough gun.',
+        combat: { body: 3, agility: 3, reaction: 3, combatSkill: 3, strength: 3, willpower: 4, logic: 3, intuition: 4, charisma: 6, edge: 3, magic: 0 },
+        gear: [
+            gearDef({ name: 'Transys Avalon', description: 'A top-shelf commlink -- the AR overlay alone is worth the felony it took to afford it.', category: Category.Commlink, rating: Rating.Rare, size: Size.Tiny, weight: 0.2 }),
+            gearDef({ name: 'Berwick Suit', description: 'Tailored armor-weave that reads boardroom, not battlefield.', category: Category.ArmorClothing, rating: Rating.Standard, size: Size.Medium, shape: 'Suit', color: 'Charcoal', texture: 'Armored Silk', weight: 2 }),
+        ],
+    },
+    {
+        name: 'Street Doc',
+        description: 'Keeps the team breathing: brains, steady hands, and a bag full of trauma kits.',
+        combat: { body: 3, agility: 3, reaction: 3, combatSkill: 2, strength: 3, willpower: 4, logic: 6, intuition: 4, charisma: 3, edge: 2, magic: 0 },
+        gear: [
+            gearDef({ name: 'Trauma Kit', description: 'A doc-grade field kit: sprays, staples, and things that hiss.', category: Category.Medical, rating: Rating.Rare, weight: 1.5 }),
+            gearDef({ name: 'Kamikaze Stim Patch', description: 'A combat stim slap-patch. The crash is tomorrow\'s problem.', category: Category.StimPatch, rating: Rating.Standard, size: Size.Tiny, weight: 0.1 }),
+        ],
+    },
+    {
+        name: 'Combat Mage',
+        description: 'Awakened artillery: manabolts through milspec armor, if the drain doesn\'t eat you first.',
+        combat: { body: 3, agility: 3, reaction: 3, combatSkill: 2, strength: 2, willpower: 5, logic: 4, intuition: 4, charisma: 3, edge: 2, magic: 6 },
+        gear: [
+            gearDef({ name: 'Spellcasting Focus', description: 'An orichalcum-threaded ring that gathers mana the way a lens gathers light.', category: Category.Focus, rating: Rating.Standard, size: Size.Tiny, shape: 'Ring', color: 'Gold', texture: 'Orichalcum', weight: 0.1 }),
+        ],
+    },
+    {
+        name: 'Street Shaman',
+        description: 'Awakened the hard way: iron will, sharp instincts, spirits on speed dial.',
+        combat: { body: 3, agility: 2, reaction: 3, combatSkill: 2, strength: 2, willpower: 6, logic: 3, intuition: 5, charisma: 4, edge: 2, magic: 5 },
+        gear: [
+            gearDef({ name: 'Spirit Talisman', description: 'Feathers, bone, and braided wire -- a focus that hums when the other world leans close.', category: Category.Focus, rating: Rating.Standard, size: Size.Tiny, shape: 'Talisman', color: 'Bone White', texture: 'Feather and Wire', weight: 0.2 }),
+        ],
+    },
+    {
+        // Logic drives EVERYTHING a decker cares about: Matrix attack pools,
+        // firewall soak, thought-speed initiative, hacking hosts -- and the
+        // deck is the requisite: its quality feeds program damage and
+        // firewall, and its hardware track is what the ice chews on.
+        name: 'Decker',
+        description: 'A ghost in the grid: hosts crack, ice burns, maglocks open. Just don\'t get caught in meatspace.',
+        combat: { body: 3, agility: 2, reaction: 3, combatSkill: 2, strength: 2, willpower: 4, logic: 7, intuition: 5, charisma: 2, edge: 3, magic: 0 },
+        gear: [
+            gearDef({ name: 'Novatech Navigator', description: 'A workhorse cyberdeck -- scuffed case, immaculate boards. Your ticket into the Matrix.', category: Category.Cyberdeck, rating: Rating.Standard, weight: 2 }),
+        ],
+    },
+    {
+        // The living persona (see ICombatAttributes.resonance): no deck, no
+        // commlink -- and no hardware between their stun track and the ice.
+        name: 'Technomancer',
+        description: 'The Matrix answers when they think at it. No deck to brick -- only a mind to burn.',
+        combat: { body: 2, agility: 2, reaction: 3, combatSkill: 2, strength: 2, willpower: 5, logic: 5, intuition: 4, charisma: 3, edge: 3, magic: 0, resonance: 6 },
+    },
+    {
+        // The drone is the mechanic: "drone" launches the Fly-Spy for live
+        // recon of every adjacent room (see commands/drone.ts). Jumped-in
+        // drone rigging can build on this later.
+        name: 'Rigger',
+        description: 'Eyes everywhere: the Fly-Spy scouts the next room so your body never has to.',
+        combat: { body: 3, agility: 3, reaction: 5, combatSkill: 3, strength: 3, willpower: 3, logic: 5, intuition: 4, charisma: 2, edge: 2, magic: 0 },
+        gear: [
+            gearDef({ name: 'Fly-Spy Drone', description: 'A palm-sized surveillance drone, quiet as a moth and twice as nosy.', category: Category.Drone, rating: Rating.Standard, size: Size.Tiny, shape: 'Insectoid', color: 'Gunmetal', texture: 'Micro-rotor', weight: 0.5 }),
+        ],
+    },
+];
+export function getArchetype(name) {
+    return ARCHETYPES.find(a => a.name === name) ?? ARCHETYPES[0];
+}
+/**
+ * Instantiates an archetype's requisite gear (see IArchetype.gear).
+ * ui.ts grants these at character creation and auto-equips the wearable
+ * ones -- a samurai starts with the Predator IN HAND, not in a duffel.
+ */
+export function createArchetypeGear(archetype) {
+    return (archetype.gear ?? []).map(def => new Item({
+        name: def.name,
+        description: def.description,
+        size: def.size,
+        category: def.category,
+        shape: def.shape,
+        color: def.color,
+        texture: def.texture,
+        rating: def.rating,
+        weight: def.weight,
+    }));
+}
+//# sourceMappingURL=archetypes.js.map

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

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

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

@@ -0,0 +1,14 @@
+import { Command, ICommand } from './command.js';
+/**
+ * Astral perception: read the world's auras without (or while) leaving
+ * your body. Awakened only. "assense" reads the room -- wards, the magical
+ * temperature; "assense <name>" reads a person: health, whether they're
+ * Awakened, the emotional weather on them, and the magic they carry. This
+ * is the recon tool that makes a mage the crew's lie detector and
+ * ward-spotter.
+ */
+export declare class AssenseCommand 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/assense.js

@@ -0,0 +1,79 @@
+import { Command } from './command.js';
+import { fuzzyPickName } from '../utilities/fuzzy-match.js';
+/**
+ * Astral perception: read the world's auras without (or while) leaving
+ * your body. Awakened only. "assense" reads the room -- wards, the magical
+ * temperature; "assense <name>" reads a person: health, whether they're
+ * Awakened, the emotional weather on them, and the magic they carry. This
+ * is the recon tool that makes a mage the crew's lie detector and
+ * ward-spotter.
+ */
+export class AssenseCommand extends Command {
+    static verb = 'assense';
+    static description = 'Read auras (Awakened only): "assense" for the room and its wards, "assense <name>" for someone\'s health, nature, and the magic on them.';
+    async execute(args = []) {
+        const actor = this.actor;
+        if (!actor.isAwakened()) {
+            return `You squint. Nothing happens. Reading auras takes the Awakened gift.`;
+        }
+        if (actor.plane === 'matrix') {
+            return `There are no auras in here -- only geometry and other people's code.`;
+        }
+        const room = actor.currentLocation;
+        // Bare assense: the room's astral weather.
+        if (!args || args.length === 0) {
+            const lines = [`You open your astral senses:`];
+            lines.push(room.warded
+                ? `  • This place is WARDED -- an astral barrier seals it against projection.`
+                : `  • No wards here -- the astral is open ground.`);
+            if (room.hasNode) {
+                lines.push(`  • The room's tech hums with dataflow -- a live Matrix node (nothing astral, but a decker would care).`);
+            }
+            const others = this.scene.getActorsInRoom(room).filter(a => a !== actor && actor.canPerceive(a));
+            if (others.length === 0) {
+                lines.push(`  • No living auras nearby.`);
+            }
+            else {
+                lines.push(`  • Auras present: ${others.map(a => a.name).join(', ')} -- "assense <name>" to read one.`);
+            }
+            return lines.join('\n');
+        }
+        // Targeted assense: one aura, read deep.
+        const candidates = this.scene.getActorsInRoom(room).filter(a => a !== actor && actor.canPerceive(a));
+        const picked = fuzzyPickName(args.join(' '), candidates.map(a => a.name));
+        const target = picked ? candidates.find(a => a.name === picked) : undefined;
+        if (!target) {
+            const present = candidates.map(a => a.name).join(', ') || 'no one';
+            return `No aura by that name here. Present: ${present}.`;
+        }
+        const physHurt = target.damageTaken > 0;
+        const stunHurt = target.stunTaken > 0;
+        const health = !physHurt && !stunHurt
+            ? `whole and unhurt`
+            : `marred${physHurt ? ` -- physical trauma (${target.damageTaken}/${target.maxConditionBoxes})` : ''}${stunHurt ? ` -- exhaustion and shock (${target.stunTaken}/${target.maxStunBoxes})` : ''}`;
+        const lines = [`You read ${target.name}'s aura:`];
+        lines.push(`  • Health: ${health}.`);
+        lines.push(target.isAwakened()
+            ? `  • They BURN -- Awakened, magic ${target.magic}. Treat accordingly.`
+            : `  • Mundane -- no spark in them.`);
+        if (target.surrendered) {
+            lines.push(`  • The fight has gone out of them entirely -- the surrender is genuine.`);
+        }
+        else if (target.combatOpponent) {
+            lines.push(`  • Violence swirls close to the surface -- they're in a fight, or barely out of one.`);
+        }
+        const magicGear = target.inventory.getAllItems().filter(i => {
+            const c = String(i.category).toLowerCase();
+            return c.includes('focus') || c.includes('grimoire') || c.includes('spellformula') || c.includes('spell formula');
+        });
+        if (magicGear.length > 0) {
+            lines.push(`  • Enchantment clings to their gear: ${magicGear.map(i => i.name).join(', ')}.`);
+        }
+        if (target.plane === 'meat' && actor.plane === 'astral') {
+            lines.push(`  • They can't see you watching.`);
+        }
+        this.logger.write(`${actor.name} assensed ${target.name}.`);
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=assense.js.map

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

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

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

@@ -0,0 +1,42 @@
+import { Command, ICommand } from './command.js';
+import { CombatExchange, IStrikeProfile } from '../utilities/combat-exchange.js';
+import { Player } from '../models/player.js';
+import { NPC } from '../models/npc.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 declare class AttackCommand extends Command implements ICommand {
+    protected static verb: string;
+    protected static description: string;
+    execute(args?: string[]): Promise<string>;
+    /** subdue.ts overrides to false: its strike ignores the equipped gun entirely. */
+    protected usesEquippedWeapon(): boolean;
+    /** Overridden by subdue.ts to swap in a stun-dealing strike. undefined = weapon default. */
+    protected strikeProfile(_exchange: CombatExchange, _target: Player | NPC): IStrikeProfile | undefined;
+    /** The verb observers see ("attacks" / "moves to subdue"). */
+    protected actionVerb(): string;
+    /**
+     * 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.
+     */
+    protected resolveTakedown(exchange: CombatExchange, fallen: Player | NPC, killer: Player | NPC): Promise<string[] | null>;
+}

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

@@ -0,0 +1,224 @@
+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 } 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.`;
+        }
+        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) {
+                    const lines = resolveBodyAttack(this.scene, this.actor, shell);
+                    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');
+                }
+            }
+            // 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.
+        exchange.beginExchange(target);
+        try {
+            this.actor.performAction(this.actionVerb(), target.name);
+            this.scene.addWorldEvent(`${this.actor.name} ${this.actionVerb()} ${target.name} in ${room.name}.`);
+            // ---- 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/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>;
+}