@maka/maka-cli 5.67.0 → 5.69.0

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

@@ -0,0 +1,48 @@
+import { Command, ICommand } from './command.js';
+/**
+ * "climb" and "descend" -- the WORDS for vertical travel, over the
+ * machinery that already did it (items KE4oqRZBdf4prfani and
+ * vkDz3cquad25GACpm: "how do I go up in elevation? commands like
+ * 'mantle' and 'decend' aren't here").
+ *
+ * THESE ARE SHORTCUTS, NOT A SECOND IMPLEMENTATION, and that is the
+ * whole design constraint. `move to <spot>` already crosses levels: it
+ * paths through the grid, prefers a level's own stairs or ladder over a
+ * free climb, rolls Gymnastics + Strength on a climb (SR5 p.134) and
+ * applies falling damage on a failure (p.172). Every one of those
+ * behaviours is inherited here by DELEGATING to MoveCommand rather than
+ * repeated -- two paths up would drift, and the one that drifted would
+ * be the one that forgot the fall.
+ *
+ * So the only work these verbs do is CHOOSING A DESTINATION: the spot
+ * on a level above you (climb) or below you (descend). Everything after
+ * that is move's.
+ *
+ * WHY THEY EXIST AT ALL, given move already worked: a player looking at
+ * a drawn ladder reached for "mantle" and "descend" twice, unprompted,
+ * and got nothing. Vocabulary is not the mechanism, but a mechanism
+ * nobody can name is not reachable either.
+ *
+ * THE REFUSALS ARE THE CAREFUL PART. A room can legitimately have a
+ * storey with nothing to stand on -- generation is repaired for it
+ * (factories/scene-chunks.ts) but a hand-authored seed can still do it.
+ * Answering that with "you can't climb here" would say the game has no
+ * climbing, which is the false-impression bug this whole wave has been
+ * about. It says the true thing instead: there is a way up, and nothing
+ * up there to stand on.
+ */
+type Way = 'up' | 'down';
+declare abstract class VerticalCommand extends Command {
+    protected travel(way: Way, args: string[]): Promise<string>;
+}
+export declare class ClimbCommand extends VerticalCommand implements ICommand {
+    protected static verb: string;
+    protected static description: string;
+    execute(args?: string[]): Promise<string>;
+}
+export declare class DescendCommand extends VerticalCommand implements ICommand {
+    protected static verb: string;
+    protected static description: string;
+    execute(args?: string[]): Promise<string>;
+}
+export {};

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

@@ -0,0 +1,107 @@
+import { Command } from './command.js';
+import { MoveCommand } from './move.js';
+import { hint } from '../utilities/hints.js';
+import { fuzzyPickName } from '../utilities/fuzzy-match.js';
+import { spotOf, spotsActive } from '../utilities/spots.js';
+import { distanceMeters } from '../utilities/room-grid.js';
+class VerticalCommand extends Command {
+    async travel(way, args) {
+        const actor = this.actor;
+        const room = actor.currentLocation;
+        const word = way === 'up' ? 'climb' : 'descend';
+        const other = way === 'up' ? 'descend' : 'climb';
+        const grid = room.ensureGrid();
+        const mine = spotOf(actor);
+        if (!grid || !spotsActive(room)) {
+            return `${room.name} is one level all the way through -- nothing here to ${word}.${hint(` ("exits" lists the ways out.)`)}`;
+        }
+        // Circulating: no cell, so no level. Claim one first -- the same
+        // rule move applies to every other crossing.
+        const from = mine ? grid.spotCells.get(mine) : undefined;
+        const myZ = from?.z ?? 0;
+        // Every spot on a level in the direction asked for.
+        const candidates = [...grid.spotCells.entries()]
+            .filter(([, c]) => (way === 'up' ? c.z > myZ : c.z < myZ))
+            .map(([name]) => name);
+        if (candidates.length === 0) {
+            // Distinguish the three ways this can be empty. They are
+            // different facts about the world and a player acts on them
+            // differently.
+            const levelsExist = (room.levels ?? []).length > 0;
+            const anywhereElse = [...grid.spotCells.entries()]
+                .filter(([, c]) => c.z !== myZ).map(([name]) => name);
+            if (!levelsExist) {
+                return `${room.name} is one level all the way through -- nothing here to ${word}.${hint(` ("exits" lists the ways out; "go up"/"go down" take stairs BETWEEN rooms.)`)}`;
+            }
+            if (anywhereElse.length === 0) {
+                // The empty-storey case. There IS a way up -- the grid built
+                // the links and the panel draws them -- and nowhere to arrive.
+                const named = (room.levels ?? []).map(l => l.name).join(' and ');
+                return `There's a way up to the ${named}, but nothing up there to stand on -- no ledge, no walkway, nowhere to put your feet.${hint(` (That's a gap in this place, not in you.)`)}`;
+            }
+            // Levels exist and hold spots, just not in this direction.
+            return way === 'up'
+                ? `You're already as high as this place goes.${hint(` ("${other}" goes back down.)`)}`
+                : `You're on the ground floor already.${hint(` ("${other}" goes up.)`)}`;
+        }
+        let target = candidates[0];
+        const query = (args ?? []).filter(w => !/^(to|the|a|an|up|down)$/i.test(w)).join(' ').trim();
+        if (query.length > 0) {
+            const picked = fuzzyPickName(query, candidates);
+            if (!picked) {
+                // Naming something real that is not in this direction is worth
+                // saying precisely -- "no such place" would be a lie.
+                const elsewhere = fuzzyPickName(query, [...grid.spotCells.keys()]);
+                if (elsewhere) {
+                    return `${elsewhere} isn't ${way} from here.${hint(` ("move to ${elsewhere}" walks you there.)`)}`;
+                }
+                return `Nothing ${way} from here answers to "${query}". Up there: ${candidates.join(', ')}.`;
+            }
+            target = picked;
+        }
+        else if (candidates.length > 1) {
+            // ASK ONLY WHEN THE CHOICE IS A REAL ONE -- which is a question
+            // about ALTITUDE, not about how many spots there are.
+            //
+            // Bare "descend" off a catwalk used to answer "Which one?
+            // doorway, back wall, open floor", because the ground floor has
+            // three places on it. That is not a choice the player was making:
+            // they said "get me down", and every candidate satisfies it.
+            // Climbing with two storeys overhead IS a choice, and still asks.
+            const zs = new Set(candidates.map(n => grid.spotCells.get(n).z));
+            if (zs.size > 1) {
+                return `Which one? ${candidates.join(', ')}.${hint(` ("${word} <place>")`)}`;
+            }
+            // One destination level, several places on it: take the nearest,
+            // the way a person would.
+            const here = from ?? grid.spotCells.get(mine ?? '') ?? { x: 0, y: 0, z: myZ };
+            target = candidates.reduce((best, name) => {
+                const a = grid.spotCells.get(name);
+                const b = grid.spotCells.get(best);
+                return distanceMeters(here, a) < distanceMeters(here, b) ? name : best;
+            }, candidates[0]);
+        }
+        // EVERYTHING FROM HERE IS MOVE'S -- the pathing, the safe-link
+        // preference, the Gymnastics + Strength test, the fall, the
+        // narration. Delegated exactly as move.ts itself delegates to
+        // GoCommand when a step lands on a doorway.
+        return await new MoveCommand({
+            actor, scene: this.scene, rooms: this.rooms, screen: this.screen, game: this.game,
+        }).execute([target]);
+    }
+}
+export class ClimbCommand extends VerticalCommand {
+    static verb = 'climb';
+    static description = 'Climb to a place above you -- a catwalk, a mezzanine, a balcony ("climb catwalk", or bare "climb" when there is only one way up). A level\'s own stairs or ladder are used when it has them; a free climb is Gymnastics + Strength (SR5 p.134) and a failure means falling. Shorthand for "move to <place>", which does the same thing.';
+    async execute(args = []) {
+        return this.travel('up', args);
+    }
+}
+export class DescendCommand extends VerticalCommand {
+    static verb = 'descend';
+    static description = 'Climb back down to a place below you ("descend", or "descend floor" when there is a choice). Shorthand for "move to <place>".';
+    async execute(args = []) {
+        return this.travel('down', args);
+    }
+}
+//# sourceMappingURL=climb.js.map

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

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

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

@@ -24,10 +24,46 @@ export declare class AgentCommand extends Command implements ICommand {
     protected static description: string;
     execute(_args?: string[]): Promise<string>;
 }
-/** "recall": fold a deployed autonomous drone back to hand (or, with
- * nothing in the air, spin a remote agent down into its deck). */
+/** "recall": fold a deployed autonomous drone back to hand, spin a
+ * remote agent down into its deck, or work CALL/DISMISS SPRITE -- see
+ * the sprite branch below. */
 export declare class RecallCommand extends Command implements ICommand {
     protected static verb: string;
     protected static description: string;
-    execute(_args?: string[]): Promise<string>;
+    execute(args?: string[]): Promise<string>;
+    /**
+     * CALL/DISMISS SPRITE (SR5 p.250, Simple Action), on this verb rather
+     * than a new one.
+     *
+     * TWO BUGS IN ONE PLACE, and they are worth separating. The missing
+     * action is the smaller one. The larger is that `recall` ASSERTED A
+     * FALSEHOOD: it looked for kind 'drone', fell back to 'agent', and
+     * otherwise told the player "Nothing of yours is in the air" -- to a
+     * technomancer with a registered sprite standing right there. The
+     * reported item reads like a feature request ("there should also be a
+     * way to recall the sprite"), and it is half a bug report: the way
+     * they went looking already existed and denied them.
+     *
+     * WHY THIS VERB AND NOT `call`. `call` is CallCommand, the phone.
+     * Registering a second handler for it would silently clobber a
+     * technomancer's ability to ring their fixer, so implementing the
+     * sprite action would have broken an unrelated one. `recall` already
+     * means "bring my thing home to me" for drones and agents, and
+     * canon's action is bidirectional, so the word already fits both
+     * halves. The name and action type are IMPORTED from the p.250 table
+     * rather than restated here -- two copies that agree today drift on
+     * the first edit.
+     *
+     * THE DIRECTIONS ARE NOT SYMMETRICAL, on purpose. Calling is free and
+     * reversible. Dismissing "releas[es] it from any tasks it still owes
+     * you" (p.250), which is why p.256 sells STANDBY for 1 task as the
+     * cheaper way to park one. So a bare "recall" only ever CALLS, and
+     * sending a sprite away has to be asked for by name -- the same rule
+     * decompile follows, for the same reason.
+     *
+     * Returns undefined when the words are not about sprites at all, so
+     * the caller's own "nothing of yours is in the air" still stands for
+     * a player who really has nothing.
+     */
+    private recallSprite;
 }

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

@@ -2,6 +2,7 @@ import { Command } from './command.js';
 import { hint } from '../utilities/hints.js';
 import { fuzzyPickName } from '../utilities/fuzzy-match.js';
 import { agentRatingFromName } from '../utilities/programs.js';
+import { resonanceAction } from '../resonance-actions.js';
 /**
  * The rigger's autonomous frames (SR5e p.269-271): "deploy <drone>" puts
  * a carried frame in the air under its own DOG-BRAIN -- no control rig
@@ -116,12 +117,13 @@ export class AgentCommand extends Command {
         ].join('\n');
     }
 }
-/** "recall": fold a deployed autonomous drone back to hand (or, with
- * nothing in the air, spin a remote agent down into its deck). */
+/** "recall": fold a deployed autonomous drone back to hand, spin a
+ * remote agent down into its deck, or work CALL/DISMISS SPRITE -- see
+ * the sprite branch below. */
 export class RecallCommand extends Command {
     static verb = 'recall';
-    static description = 'Recall your deployed drone to your hand (or fold a running agent back into its deck).';
-    async execute(_args = []) {
+    static description = `Recall your deployed drone to your hand, fold a running agent back into its deck, or call a registered sprite out of the Resonance. "${resonanceAction('call-dismiss-sprite')?.name}" (${resonanceAction('call-dismiss-sprite')?.actionType}, SR5 p.250): "recall <name>" also sends a standing registered sprite back -- which releases every task it still owes you. To park one cheaply instead, "standby" spends a single task (p.256).`;
+    async execute(args = []) {
         const game = this.game;
         const entry = game?.companions.find(c => c.kind === 'drone');
         if (!entry) {
@@ -136,6 +138,9 @@ export class RecallCommand extends Command {
                     ? `Your agent's icon collapses back into your persona -- folded into the deck.`
                     : `The deck spins its agent down -- the DECK IN AR light dies as the icon folds home.`;
             }
+            const sprite = this.recallSprite(args);
+            if (sprite !== undefined)
+                return sprite;
             return `Nothing of yours is in the air.`;
         }
         const name = entry.boundDevice?.name ?? entry.npc.name;
@@ -144,5 +149,85 @@ export class RecallCommand extends Command {
         this.scene.updateStatus();
         return `The ${name} banks once and settles back onto your hand, rotors folding.${entry.boundDevice && entry.boundDevice.droneDamage > 0 ? ` The airframe carries its dents (${entry.boundDevice.droneSummary()})${hint(' -- rest repairs it')}.` : ''}`;
     }
+    /**
+     * CALL/DISMISS SPRITE (SR5 p.250, Simple Action), on this verb rather
+     * than a new one.
+     *
+     * TWO BUGS IN ONE PLACE, and they are worth separating. The missing
+     * action is the smaller one. The larger is that `recall` ASSERTED A
+     * FALSEHOOD: it looked for kind 'drone', fell back to 'agent', and
+     * otherwise told the player "Nothing of yours is in the air" -- to a
+     * technomancer with a registered sprite standing right there. The
+     * reported item reads like a feature request ("there should also be a
+     * way to recall the sprite"), and it is half a bug report: the way
+     * they went looking already existed and denied them.
+     *
+     * WHY THIS VERB AND NOT `call`. `call` is CallCommand, the phone.
+     * Registering a second handler for it would silently clobber a
+     * technomancer's ability to ring their fixer, so implementing the
+     * sprite action would have broken an unrelated one. `recall` already
+     * means "bring my thing home to me" for drones and agents, and
+     * canon's action is bidirectional, so the word already fits both
+     * halves. The name and action type are IMPORTED from the p.250 table
+     * rather than restated here -- two copies that agree today drift on
+     * the first edit.
+     *
+     * THE DIRECTIONS ARE NOT SYMMETRICAL, on purpose. Calling is free and
+     * reversible. Dismissing "releas[es] it from any tasks it still owes
+     * you" (p.250), which is why p.256 sells STANDBY for 1 task as the
+     * cheaper way to park one. So a bare "recall" only ever CALLS, and
+     * sending a sprite away has to be asked for by name -- the same rule
+     * decompile follows, for the same reason.
+     *
+     * Returns undefined when the words are not about sprites at all, so
+     * the caller's own "nothing of yours is in the air" still stands for
+     * a player who really has nothing.
+     */
+    recallSprite(args) {
+        const game = this.game;
+        if (!game)
+            return undefined;
+        const waiting = game.registeredSpritesWaiting();
+        const standing = game.companions.filter(c => c.kind === 'sprite' && c.registered);
+        if (waiting.length === 0 && standing.length === 0)
+            return undefined;
+        const query = (args ?? []).map(w => w.toLowerCase()).filter(w => !/^(a|an|the|sprite)$/.test(w)).join(' ').trim();
+        if (query.length > 0) {
+            const named = fuzzyPickName(query, waiting.map(s => s.name));
+            if (named) {
+                const line = game.callSpriteFromResonance(named);
+                this.scene.updateStatus();
+                return line ?? `${named} answers, but there is no room on the grid for its icon.`;
+            }
+            // Naming one that is already here is the DISMISS direction.
+            const here = fuzzyPickName(query, standing.map(c => c.npc.name));
+            if (here) {
+                const target = standing.find(c => c.npc.name === here);
+                const owed = target.services ?? 0;
+                if (!game.dismissSpriteToResonance(target))
+                    return undefined;
+                this.scene.updateStatus();
+                // The warning now names its cure. It was written when there was
+                // no cheaper door; STANDBY (p.256) is that door, and a warning
+                // about a cost the player cannot avoid is worth less than one
+                // that tells them how.
+                return `${here} folds back into the Resonance and waits there, registered and yours.${owed > 0 ? ` It owed you ${owed} task${owed === 1 ? '' : 's'}; dismissing releases every one of them.${hint(` ("standby" spends ONE and keeps the rest.)`)}` : ''}${hint(` ("recall ${here}" calls it back.)`)}`;
+            }
+            return `Nothing of yours answers to "${query}".${waiting.length > 0 ? ` Waiting in the Resonance: ${waiting.map(s => `"${s.name}"`).join(', ')}.` : ''}${standing.length > 0 ? ` Already with you: ${standing.map(c => `"${c.npc.name}"`).join(', ')}.` : ''}`;
+        }
+        // Bare "recall": the safe direction only.
+        if (waiting.length > 0) {
+            const line = game.callSpriteFromResonance();
+            this.scene.updateStatus();
+            if (line) {
+                return waiting.length > 1
+                    ? `${line}${hint(` (${waiting.length - 1} more waiting -- "recall <name>" for a particular one.)`)}`
+                    : line;
+            }
+        }
+        // Standing, and nothing waiting: say so, and name the route rather
+        // than doing the destructive half unasked.
+        return `${standing.length === 1 ? `${standing[0].npc.name} is` : `Your sprites are`} already here with you, not in the Resonance.${hint(` ("standby" parks it for ONE task and keeps the rest; "recall ${standing[0].npc.name}" sends it back for free but releases every task it owes.)`)}`;
+    }
 }
 //# sourceMappingURL=companions.js.map

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

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

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

@@ -6,11 +6,22 @@ import { Command, ICommand } from './command.js';
  * become TASKS (services); the sprite manifests as a Matrix companion
  * shell: it rides your persona, fights ice at your side when you jack
  * in (one task per fight, same leash as spirits), obeys "order", and
- * decompiles when the tasks are spent, when released ("compile" again),
- * or when you travel. FADING is the toll: 2 x the sprite's hits (min
- * 2), resisted with Resonance + Willpower -- PHYSICAL when the Level
- * exceeds your Resonance, the same overreach law as overcasting. Level
- * past twice your Resonance is refused outright.
+ * decompiles when the tasks are spent, when you unmake it
+ * ("decompile"), or when you travel. FADING is the toll: 2 x the
+ * sprite's hits (min 2), resisted with Resonance + Willpower --
+ * PHYSICAL when the Level exceeds your Resonance, the same overreach
+ * law as overcasting. Level past twice your Resonance is refused
+ * outright.
+ *
+ * COMPILE DOES NOT RELEASE (items xxc3SGZJmjAPaZPhb and
+ * Av93mThv54YRH26gj, 2026-08-28). This verb used to double as the
+ * release: any second "compile" decompiled whatever was standing. That
+ * is not a rule the books have. p.250 lists Compile Sprite (Complex),
+ * Decompile Sprite (Complex) and Call/Dismiss Sprite (Simple) as three
+ * separate actions, and p.256 says outright "You can decompile your own
+ * sprites if you need to, but usually just dismissing them is enough."
+ * Compiling is now a summons and nothing else; the slot check below
+ * REFUSES and names the two verbs that actually let go.
  *
  * The companion symmetry this completes: mage -> spirit, decker ->
  * agent, rigger -> drone, technomancer -> SPRITE. Unlike an agent, a
@@ -26,20 +37,29 @@ export interface ISpriteType {
 /** Exported for game.ts: re-shelling a REGISTERED sprite after travel
  *  or a resumed save needs the same stat builder. */
 export declare const SPRITE_TYPES: Record<string, ISpriteType>;
+/**
+ * A free shell name for a sprite of this type and Level.
+ *
+ * spawnCompanionShell REFUSES a name already in the scene and returns
+ * null, which the caller can only report as "it collides with a process
+ * name already taken" -- a compile that cost real Fading and produced
+ * nothing. That was unreachable while one sprite was the hard maximum.
+ * It stopped being unreachable the moment a REGISTERED sprite was
+ * allowed to stand alongside a newly compiled one (SR5 p.254-256):
+ * register a Courier at Level 4, compile another Courier at Level 4,
+ * and both want the same name.
+ *
+ * Typed against the shape it uses rather than Scene, so this stays
+ * importable from game.ts (which imports this module) without a cycle.
+ *
+ * The unsuffixed name is preserved when it is free, so the overwhelming
+ * common case reads exactly as it always has.
+ */
+export declare function uniqueSpriteName(scene: {
+    getActor(name: string): unknown;
+}, typeName: string, level: number): string;
 export declare class CompileCommand extends Command implements ICommand {
     protected static verb: string;
     protected static description: string;
     execute(args?: string[]): Promise<string>;
-    /**
-     * "decompile <name>": unmake a HOSTILE matrix construct -- ice, an
-     * enemy agent -- by tearing its thread apart (the offensive mirror of
-     * releasing your own sprite). Opposed Resonance + compiling vs the
-     * construct's code integrity (Willpower + Logic/2); net hits plus
-     * Resonance/2 land straight on its monitor, no soak -- the opposed
-     * test WAS the resistance. Fading bills the same toll as compiling
-     * (2x its hits, min 2). A failed pull leaves it standing, alert, and
-     * pointed at you. Returns undefined when the words name no hostile
-     * construct here (the summons flow's turn).
-     */
-    private tryDecompileEnemy;
 }