@maka/maka-cli 5.3.17 → 5.4.0

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' : '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":"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"}

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;
+}

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

@@ -0,0 +1,149 @@
+import { Command } from './command.js';
+import { Category } from '../types/shared/item-enum.js';
+import { parseArgsWithQuotes } from './talk.js';
+import { CALL_ICON, CALL_COLOR } from '../utilities/comm-style.js';
+import { FIXER_NAME } from '../factories/scene-seed-generator.js';
+import { fuzzyPickName } from '../utilities/fuzzy-match.js';
+export class CallCommand extends Command {
+    static verb = 'call';
+    static description = 'Call someone remotely over a commlink (no need to be in the same room; commlink must be equipped).';
+    async execute(args) {
+        if (!args || args.length === 0) {
+            return 'Usage: call <name> [message]';
+        }
+        const rawWords = parseArgsWithQuotes(args.join(' '));
+        if (!this.hasEquippedCommlink(this.actor)) {
+            return `You need to equip a commlink before you can call anyone.`;
+        }
+        // Running silent kills the broadcast both ways (see silent.ts).
+        if (this.actor.runningSilent) {
+            return `You're running silent -- your link isn't broadcasting. Go loud ("silent") before calling anyone.`;
+        }
+        // Hacked dark is a different kind of quiet (see hack.ts PAN attacks).
+        if (this.actor.arOffline) {
+            return `Your AR is CUT -- someone cracked your PAN and your link is dead air. "reboot" first.`;
+        }
+        const { target, remainingWords } = this.resolveTargetAndMessage(rawWords);
+        if (!target) {
+            return `You don't know anyone by the name "${rawWords[0]}" to call.`;
+        }
+        if (target === this.actor) {
+            return "You can't call yourself.";
+        }
+        if (!this.hasCommlink(target)) {
+            return `You don't get through -- ${target.name} doesn't seem to have a commlink.`;
+        }
+        if (target.runningSilent) {
+            return `You can't raise ${target.name} -- their link isn't broadcasting. They're running silent.`;
+        }
+        const message = remainingWords.join(' ');
+        const greeting = message || `(calling) You there, ${target.name}?`;
+        this.actor.performAction('calls', target.name);
+        this.logger.write(`${this.actor.name} calls ${target.name}: "${greeting}"`);
+        // Cleanly disconnect any stale prior call on either side before linking
+        // the new one -- otherwise a former partner would be left thinking
+        // they're still connected (their own "say" would keep routing to
+        // someone who's since moved on). See end-call.ts for the explicit
+        // version of this same disconnect.
+        if (this.actor.activeCallPartner && this.actor.activeCallPartner !== target) {
+            this.actor.activeCallPartner.activeCallPartner = undefined;
+        }
+        if (target.activeCallPartner && target.activeCallPartner !== this.actor) {
+            target.activeCallPartner.activeCallPartner = undefined;
+        }
+        // Symmetric: either side can now reach the other with an ordinary
+        // "say", not just this initial hail -- see say.ts. Stays connected
+        // until "end-call" (or a new call replaces it, per above).
+        this.actor.activeCallPartner = target;
+        target.activeCallPartner = this.actor;
+        // If the caller is holding this run's win-condition macguffin and
+        // calls its intended recipient, treat the call itself as the hand-off.
+        // Fixers work deals over comms, not face to face -- there's no in-world
+        // reason a physical "give" should ever be required for a job-giver
+        // who's meant to be unreachable in person. Resolved synchronously
+        // (doesn't depend on the NPC's reply), so it's reflected in this
+        // command's own return text right away.
+        let deliveryNote = '';
+        let deliveredItemName = '';
+        const wc = this.scene.getWinCondition();
+        if (wc?.type === 'give' && wc.toNpc?.toLowerCase() === target.name.toLowerCase()) {
+            const item = this.actor.inventory.getItem(wc.item);
+            if (item) {
+                const delivered = this.actor.inventory.transferItemTo(item.name, target.inventory);
+                if (delivered) {
+                    this.scene.updateInventory(this.scene.getPlayer().inventory);
+                    this.scene.checkWinCondition(item.name, target.name);
+                    deliveryNote = ` You relay that you have the ${item.name} -- consider it delivered.`;
+                    deliveredItemName = item.name;
+                }
+            }
+        }
+        // Fold the delivery into what the NPC actually hears (not just the
+        // player-facing confirmation above) -- otherwise an NPC whose reply is
+        // AI-generated has no way to know the job's already done, and keeps
+        // asking about it on a callback.
+        const heardMessage = deliveredItemName
+            ? `${greeting} [System note: ${this.actor.name} just delivered "${deliveredItemName}" to you over this call.]`
+            : greeting;
+        // Deliberately does NOT require sharing a room with the target -- the
+        // whole point of a commlink call is reaching someone you can't walk up
+        // to (a fixer working from a hideout you'll never set foot in, say).
+        // Deliberately NOT awaited: the target's reply (if any) comes from an
+        // AI round-trip and announces itself to the screen on its own once it
+        // arrives. Awaiting it here would block this confirmation behind that
+        // delay, so the reply could render before "You call X" does -- making
+        // it look like the call was never actually made.
+        void Promise.resolve(target.hear(this.actor, heardMessage)).catch(err => {
+            this.logger.error(`${target.name} failed to handle a call from ${this.actor.name}: ${err}`);
+        });
+        // Calling ${FIXER_NAME} once the job's done is what actually gets you
+        // the next one -- the in-fiction equivalent of typing "continue", which
+        // still works too as an explicit fallback. Deliberately checks the
+        // fixer's identity directly, NOT the win condition's toNpc: a job's
+        // "give" target is often a one-off contact ${FIXER_NAME} pointed the
+        // runner toward, not ${FIXER_NAME} himself (see the "broker, not always
+        // the destination" convention), so it's ${FIXER_NAME} specifically who
+        // lines up the next gig, regardless of who this job's delivery went to.
+        // Not gated on this call being the one that JUST completed the job:
+        // checking in on an already-finished job (e.g. delivered via "give"
+        // instead) triggers it just as well. Runs in the background (see
+        // Game.draftNextSceneInBackground()) -- job generation can take 20-40+
+        // seconds, and this confirmation shouldn't wait behind it.
+        if (this.game && this.scene.isCompleted() && target.name === FIXER_NAME) {
+            this.game.draftNextSceneInBackground();
+        }
+        return `{${CALL_COLOR}-fg}${CALL_ICON} You call ${target.name}: "${greeting}"${deliveryNote}{/${CALL_COLOR}-fg}`;
+    }
+    hasEquippedCommlink(actor) {
+        return actor.equipment.head?.commlink != null;
+    }
+    hasCommlink(actor) {
+        const inInventory = actor.inventory.getAllItems().some(item => item.category === Category.Commlink);
+        return inInventory || this.hasEquippedCommlink(actor);
+    }
+    /**
+     * 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.
+     */
+    resolveTargetAndMessage(words) {
+        // Includes the caller too, so "call <own name>" resolves into the
+        // actual "can't call yourself" check below rather than a confusing
+        // "don't know anyone" -- self is never a real target.
+        const candidates = [this.actor, ...this.scene.allActors];
+        const names = candidates.map(a => a.name);
+        for (let i = words.length; i >= 1; i--) {
+            const picked = fuzzyPickName(words.slice(0, i).join(' '), names);
+            if (picked) {
+                return { target: candidates.find(a => a.name === picked), remainingWords: words.slice(i) };
+            }
+        }
+        return { target: undefined, remainingWords: [] };
+    }
+}
+//# sourceMappingURL=call.js.map

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

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

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

@@ -0,0 +1,58 @@
+import { BypassCommand } from './bypass-command.js';
+import { PuzzleBypassType } from '../types/seed/puzzle-seed.js';
+/**
+ * Gear-driven spellcasting (see Player's magic section): you know a spell
+ * if you carry its SpellFormula (or any Grimoire), and the best Focus on
+ * you scales the casting pool. "cast <spell> [at <target>]" casts; a bare
+ * "cast" (or "cast <direction/barrier>") is still the ward-bypass route
+ * inherited from BypassCommand -- now gated on actually having magic gear,
+ * instead of being a free-floating coin flip anyone could attempt.
+ */
+export declare class CastCommand extends BypassCommand {
+    protected static verb: string;
+    protected static description: string;
+    protected bypassType: PuzzleBypassType;
+    protected noPuzzleMessage: string;
+    execute(args?: string[]): Promise<string>;
+    /**
+     * Lenient spell-name matching: the exact key, or a unique fragment of at
+     * least 3 characters ("bolt"/"mana" -> manabolt). Anything that doesn't
+     * resolve falls through to the ward-bypass path, which is what a
+     * direction or barrier name ("cast north", "cast maglock") needs.
+     */
+    private resolveSpellName;
+    private castSpell;
+    /**
+     * Support spells (heal/armor) default to SELF but can target an ally:
+     * "cast heal on jinx". Touch range -- the target must share the room --
+     * and the same fuzzy name matching as everything else. Returns an error
+     * string instead of a target when the name can't be resolved here.
+     */
+    private resolveAllyTarget;
+    /** How the caster's pool reads in narration: focus-assisted, raw talent, or book-learned. */
+    private castingLabel;
+    /**
+     * Drain, resolved AFTER the spell: resist with Body, take whatever gets
+     * through as STUN damage -- casting doesn't cut you, it wrings you out.
+     * A full stun track is a knockout, and overflow past it spills into the
+     * physical track (enough drain doesn't just put you down, it starts
+     * killing you). Callers check drainCollapse() afterward.
+     */
+    private applyDrain;
+    /**
+     * What the drain just did to the caster, if anything: overflow filling
+     * the physical track is a burnout DEATH; a full stun track alone is a
+     * knockout -- out of the run, but honestly narrated as unconsciousness.
+     */
+    private drainCollapse;
+    private castManabolt;
+    private castHeal;
+    private castArmor;
+    /**
+     * Non-combat casts are a single block, no exchange pacing needed: the
+     * player's own casts return the text for ui.ts to print, while an NPC's
+     * cast self-announces to a witnessing player (its return value only ever
+     * feeds its AI history) -- same rationale as CombatExchange.
+     */
+    private finishSpell;
+}