@maka/maka-cli 5.3.17 → 5.5.0

package/bundle/typescript/src/commands/game/sideQuest/utilities/fuzzy-match.js

@@ -0,0 +1,92 @@
+/**
+ * Shared fuzzy name-matching, extracted from Inventory's item resolution so
+ * actor targeting (attack.ts, cast.ts) behaves the same way "take" does --
+ * found via a real session where "cast manabolt at mr krow" failed against
+ * "Mr. Krow" over a missing period. Three tiers, in order of confidence:
+ *
+ *   1. Exact match on the loosely-normalized strings (case, punctuation,
+ *      and extra whitespace ignored -- "mr krow" == "Mr. Krow").
+ *   2. Substring containment, either direction -- short aliases ("krow"),
+ *      or extra/missing words at the edges.
+ *   3. Word-overlap with light per-word typo tolerance (Levenshtein <= 1
+ *      on words longer than 3 chars, stopwords ignored) -- misspellings
+ *      and reordered/inserted words.
+ *
+ * A tier only matches when it produces exactly ONE candidate (or a clear
+ * best score) -- an ambiguous guess deliberately misses rather than
+ * picking someone at random.
+ */
+export const STOPWORDS = new Set(['a', 'an', 'the', 'of', 'on', 'in', 'at', 'to', 'with']);
+/** Lowercase, strip punctuation, collapse whitespace. */
+export function normalizeLoose(s) {
+    return s.toLowerCase().replace(/[^\w\s]/g, '').replace(/\s+/g, ' ').trim();
+}
+export function significantWords(s) {
+    return s.split(/\s+/).filter(w => w.length > 0 && !STOPWORDS.has(w));
+}
+export function wordsAreCloseEnough(a, b) {
+    if (a === b)
+        return true;
+    if (a.length <= 3 || b.length <= 3)
+        return false; // too short for typo tolerance to be safe
+    return levenshteinDistance(a, b) <= 1;
+}
+/**
+ * Damerau-Levenshtein (OSA variant): like plain Levenshtein but a swap of
+ * two adjacent letters counts as ONE edit, not two -- transpositions
+ * ("jhonson" for "johnson", "teh" for "the") are the single most common
+ * typo class, and plain Levenshtein prices them out of the <=1 tolerance.
+ */
+export function levenshteinDistance(a, b) {
+    const dp = Array.from({ length: a.length + 1 }, () => new Array(b.length + 1).fill(0));
+    for (let i = 0; i <= a.length; i++)
+        dp[i][0] = i;
+    for (let j = 0; j <= b.length; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= a.length; i++) {
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+            if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
+                dp[i][j] = Math.min(dp[i][j], dp[i - 2][j - 2] + cost);
+            }
+        }
+    }
+    return dp[a.length][b.length];
+}
+/**
+ * Picks the single name from `names` that `input` most plausibly refers
+ * to, or undefined when nothing (or more than one thing) qualifies.
+ * Returns the ORIGINAL name string, not the normalized form.
+ */
+export function fuzzyPickName(input, names) {
+    const normalized = normalizeLoose(input);
+    if (normalized.length === 0)
+        return undefined;
+    const candidates = names.map(name => ({ name, norm: normalizeLoose(name) }));
+    const exact = candidates.filter(c => c.norm === normalized);
+    if (exact.length === 1)
+        return exact[0].name;
+    if (exact.length > 1)
+        return undefined;
+    const substring = candidates.filter(c => c.norm.includes(normalized) || normalized.includes(c.norm));
+    if (substring.length === 1)
+        return substring[0].name;
+    const inputWords = significantWords(normalized);
+    if (inputWords.length === 0)
+        return undefined;
+    const scored = candidates
+        .map(c => {
+        const nameWords = significantWords(c.norm);
+        const matched = inputWords.filter(iw => nameWords.some(nw => wordsAreCloseEnough(iw, nw))).length;
+        return { name: c.name, score: matched / inputWords.length };
+    })
+        .filter(s => s.score >= 0.6)
+        .sort((a, b) => b.score - a.score);
+    if (scored.length === 1)
+        return scored[0].name;
+    if (scored.length > 1 && scored[0].score > scored[1].score)
+        return scored[0].name; // clear winner
+    return undefined;
+}
+//# sourceMappingURL=fuzzy-match.js.map

package/bundle/typescript/src/commands/game/sideQuest/utilities/fuzzy-match.js.map

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

package/bundle/typescript/src/commands/game/sideQuest/utilities/planes.d.ts

@@ -0,0 +1,77 @@
+import { Player, SimMode, Plane } from '../models/player.js';
+import { Item } from '../models/item.js';
+import { NPC } from '../models/npc.js';
+import { Scene } from '../models/scene.js';
+import { Room } from '../models/room.js';
+/**
+ * Plane transitions and their tolls -- the one place that moves an actor
+ * between meat, Matrix, and astral (see Player.plane for the model).
+ *
+ * The invariant every transition preserves: while off the meat plane, the
+ * actor's empty body slumps in `bodyRoom`, visible and attackable
+ * (resolveBodyAttack); snapping back -- voluntarily or forced -- returns
+ * the actor there and settles the toll:
+ *
+ *   Matrix  -- voluntary jack-out is clean; a forced dump is DUMPSHOCK,
+ *              resisted with Willpower: stun in cold-sim, PHYSICAL in
+ *              hot-sim. The persona's Matrix track resets either way (a
+ *              rebooted persona comes back clean).
+ *   Astral  -- the longer you were out (astralTicks, one per room-move),
+ *              the harder the snap-back: resist ceil(ticks/2) stun with
+ *              Willpower + half Magic; a forced return adds +2 before the
+ *              resist.
+ */
+export declare function planeLabel(actor: Player): string;
+/** Every off-plane actor whose empty body lies in this room. */
+export declare function shellsInRoom(scene: Scene, room: Room): (Player | NPC)[];
+export declare function enterMatrix(scene: Scene, actor: Player, mode: SimMode): string[];
+export declare function leaveMatrix(scene: Scene, actor: Player, opts?: {
+    forced?: boolean;
+    reason?: string;
+}): string[];
+export declare function projectAstral(scene: Scene, actor: Player): string[];
+/**
+ * Whether this actor's jacked-in persona can touch the host in `room`.
+ * A wireless host (the default) is on the grid -- any persona standing in
+ * the room's overlay reaches it. A WIRED host is air-gapped: it only
+ * opens to a hard line, meaning the actor's BODY is in this room (they
+ * jacked in here). Movement is never gated -- the grid overlays every
+ * room -- only the host itself (hacking it, and its vaulted files).
+ */
+export declare function canReachHost(actor: Player, room: Room): boolean;
+/**
+ * An item name tinted for the plane it lives on -- the game's plane
+ * palette (matrix cyan, astral magenta, same as the HUD) applied to item
+ * listings so WHAT a thing is reads at a glance. A real session's decker
+ * found matrix paydata via a jacked-in search and didn't realize it was
+ * takeable right there: the name looked exactly like every meat item, so
+ * they jacked out and walked the whole map hunting for it physically.
+ * `viewerPlane` drives the astral cross-plane annotation (they see meat
+ * items, dimly, but can't carry them -- see take.ts).
+ */
+export declare function planeTintItemName(item: Item, viewerPlane: Plane): string;
+/**
+ * The "you can see them, but you can't touch them" refusal. When a target
+ * name matches someone in the room on a plane the actor perceives but
+ * can't reach (today: an astral projector eyeing a meat body), returns a
+ * line naming the actual rule -- because "Present: no one" right after
+ * "look" listed that very person's aura reads as a bug, not a boundary
+ * (real session: three attempts on a visible Mr. Krow, all told "no one").
+ * Returns null when no cross-plane match, so callers fall through to
+ * their normal miss handling. `deed` picks the phrasing: a weapon strike,
+ * a combat spell, or touch-range support magic.
+ */
+export declare function crossPlaneRefusal(scene: Scene, actor: Player, room: Room, targetName: string, deed: 'strike' | 'spell' | 'touch'): string | null;
+export declare function returnToBody(scene: Scene, actor: Player, opts?: {
+    forced?: boolean;
+    reason?: string;
+}): string[];
+/**
+ * A meat-plane attack on an empty body: one UNANSWERED strike -- no
+ * defense roll (nobody's home), meat soak only (Body + worn armor; the
+ * plane-aware getSoakPool would wrongly price the persona's firewall) --
+ * then the owner is slammed back into a body under attack, paying the
+ * forced-return toll on top of whatever got through. Returns the full
+ * narration; the caller announces it.
+ */
+export declare function resolveBodyAttack(scene: Scene, attacker: Player | NPC, victim: Player | NPC): string[];

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

@@ -0,0 +1,265 @@
+import { Logger } from './logger.js';
+import { rollPool, formatRoll } from './dice.js';
+import { fuzzyPickName } from './fuzzy-match.js';
+/**
+ * Plane transitions and their tolls -- the one place that moves an actor
+ * between meat, Matrix, and astral (see Player.plane for the model).
+ *
+ * The invariant every transition preserves: while off the meat plane, the
+ * actor's empty body slumps in `bodyRoom`, visible and attackable
+ * (resolveBodyAttack); snapping back -- voluntarily or forced -- returns
+ * the actor there and settles the toll:
+ *
+ *   Matrix  -- voluntary jack-out is clean; a forced dump is DUMPSHOCK,
+ *              resisted with Willpower: stun in cold-sim, PHYSICAL in
+ *              hot-sim. The persona's Matrix track resets either way (a
+ *              rebooted persona comes back clean).
+ *   Astral  -- the longer you were out (astralTicks, one per room-move),
+ *              the harder the snap-back: resist ceil(ticks/2) stun with
+ *              Willpower + half Magic; a forced return adds +2 before the
+ *              resist.
+ */
+export function planeLabel(actor) {
+    if (actor.plane === 'matrix')
+        return `MATRIX (${actor.simMode ?? 'cold'}-sim)`;
+    if (actor.plane === 'astral')
+        return 'ASTRAL';
+    return 'MEAT';
+}
+/** Every off-plane actor whose empty body lies in this room. */
+export function shellsInRoom(scene, room) {
+    return scene.allActors.filter(a => a.plane !== 'meat' && a.bodyRoom === room);
+}
+export function enterMatrix(scene, actor, mode) {
+    actor.bodyRoom = actor.currentLocation;
+    actor.plane = 'matrix';
+    actor.simMode = mode;
+    // The deck you ride in on is the deck that takes the damage (see
+    // Item's device condition monitor). Its existing dents come with it --
+    // hardware doesn't heal between runs.
+    actor.activeDeck = actor.getCyberdeck();
+    actor.performAction('jacks in', `slumping where they stand, eyes flickering (${mode}-sim)`);
+    scene.addWorldEvent(`${actor.name} jacked into the Matrix in ${actor.bodyRoom.name}.`);
+    Logger.getInstance().write(`${actor.name} entered the Matrix (${mode}-sim, ${actor.activeDeck?.name ?? (actor.isTechnomancer() ? 'living persona' : 'no deck?!')}) from ${actor.bodyRoom.name}.`);
+    const hotWarning = mode === 'hot'
+        ? ` Hot-sim: everything is faster and hits harder -- including what hits YOU. Ice biofeedback bleeds into your real stun track.`
+        : actor.isTechnomancer()
+            ? ` There is no deck between you and the ice -- every hit out here is YOUR mind taking it.`
+            : ` Cold-sim: the ice can only chew on your deck, not your brain.`;
+    const deckNote = actor.activeDeck && actor.activeDeck.deckDamage > 0
+        ? ` Your ${actor.activeDeck.name} is already scarred: ${actor.activeDeck.deckSummary()}.`
+        : '';
+    const entry = actor.isTechnomancer()
+        ? `You close your eyes and the Matrix is simply THERE -- no deck, no interface, just the resonance singing. Your body slumps where you stood in ${actor.bodyRoom.name}, empty.`
+        : `Your ${actor.activeDeck?.name ?? 'deck'} spins up and the room dissolves into geometry -- you're in. Your body slumps where you stood in ${actor.bodyRoom.name}, empty.`;
+    return [
+        `${entry}${hotWarning}${deckNote}`,
+        `Move with "go" (the grid overlays the world), "hack" inside a host node, "jack out" to return.`,
+    ];
+}
+export function leaveMatrix(scene, actor, opts) {
+    const lines = [];
+    const body = actor.bodyRoom;
+    const wasHot = actor.simMode === 'hot';
+    if (opts?.forced) {
+        // Dumpshock: 4 boxes resisted with Willpower -- stun in cold-sim,
+        // physical in hot-sim (your brain was IN there).
+        const resist = rollPool(actor.willpower);
+        const dealt = Math.max(0, 4 - resist.hits);
+        lines.push(opts.reason ?? `The connection is severed from the other side.`);
+        lines.push(`  DUMPSHOCK -- resist: ${formatRoll(resist)}`);
+        if (dealt > 0) {
+            if (wasHot) {
+                actor.takeDamage(dealt);
+                lines.push(`  The world tears loose -- ${dealt} box${dealt === 1 ? '' : 'es'} PHYSICAL (hot-sim): ${actor.conditionSummary()}`);
+            }
+            else {
+                actor.takeStun(dealt);
+                lines.push(`  Your head rings like a struck bell -- ${dealt} stun: ${actor.stunSummary()}`);
+            }
+        }
+        else {
+            lines.push(`  You ride it out -- no damage.`);
+        }
+    }
+    else {
+        lines.push(`You back out clean and unplug.`);
+    }
+    // Deck damage STAYS -- it's hardware, not a session variable. A bricked
+    // deck refuses the next jack-in until repaired (rest.ts).
+    if (actor.activeDeck?.isBricked) {
+        lines.push(`Your ${actor.activeDeck.name} is BRICKED -- dead boards, burnt trace. It repairs while you rest somewhere safe.`);
+    }
+    actor.plane = 'meat';
+    actor.simMode = undefined;
+    actor.activeDeck = undefined;
+    if (body) {
+        actor.currentLocation = body;
+        actor.bodyRoom = undefined;
+        lines.push(`You're back in your body in ${body.name}.`);
+    }
+    actor.performAction('jacks out', 'stirring awake');
+    scene.addWorldEvent(`${actor.name} jacked out of the Matrix.`);
+    scene.updateStatus();
+    return lines;
+}
+export function projectAstral(scene, actor) {
+    actor.bodyRoom = actor.currentLocation;
+    actor.plane = 'astral';
+    actor.astralTicks = 0;
+    // Projection IS full astral senses -- the sustained half-sight toggle
+    // (and its -2) makes no sense out here.
+    actor.astralPerceiving = false;
+    actor.performAction('projects', 'body going slack, something vast leaving their eyes');
+    scene.addWorldEvent(`${actor.name} projected astrally from ${actor.bodyRoom.name}.`);
+    Logger.getInstance().write(`${actor.name} projected astrally from ${actor.bodyRoom.name}.`);
+    return [
+        `You slip free of your flesh. The world stays -- shifted: auras where faces were, glass-bright emotion, the meat world dim and untouchable below. Your body slumps in ${actor.bodyRoom.name}, empty.`,
+        `Move with "go" (locked doors mean nothing; wards do), "assense" what you see, "return" to your body. Every move out here is a debt the snap-back collects.`,
+        `The meat world is READ-ONLY from out here: you can watch and assense it, nothing more. No touching, no taking, no talking to the living, no spells or strikes across the veil -- astral combat only finds spirits and other projections. To act on flesh, go back to yours.`,
+    ];
+}
+/**
+ * Whether this actor's jacked-in persona can touch the host in `room`.
+ * A wireless host (the default) is on the grid -- any persona standing in
+ * the room's overlay reaches it. A WIRED host is air-gapped: it only
+ * opens to a hard line, meaning the actor's BODY is in this room (they
+ * jacked in here). Movement is never gated -- the grid overlays every
+ * room -- only the host itself (hacking it, and its vaulted files).
+ */
+export function canReachHost(actor, room) {
+    if (!room.hasNode)
+        return false;
+    if (room.nodeAccess !== 'wired')
+        return true;
+    return actor.bodyRoom === room;
+}
+/**
+ * An item name tinted for the plane it lives on -- the game's plane
+ * palette (matrix cyan, astral magenta, same as the HUD) applied to item
+ * listings so WHAT a thing is reads at a glance. A real session's decker
+ * found matrix paydata via a jacked-in search and didn't realize it was
+ * takeable right there: the name looked exactly like every meat item, so
+ * they jacked out and walked the whole map hunting for it physically.
+ * `viewerPlane` drives the astral cross-plane annotation (they see meat
+ * items, dimly, but can't carry them -- see take.ts).
+ */
+export function planeTintItemName(item, viewerPlane) {
+    if (item.plane === 'matrix') {
+        return `{cyan-fg}${item.name} [data]{/cyan-fg}`;
+    }
+    if (item.plane === 'astral') {
+        return `{magenta-fg}${item.name} [astral]{/magenta-fg}`;
+    }
+    if (viewerPlane === 'astral') {
+        return `${item.name} (physical -- look, don't touch)`;
+    }
+    return item.name;
+}
+/**
+ * The "you can see them, but you can't touch them" refusal. When a target
+ * name matches someone in the room on a plane the actor perceives but
+ * can't reach (today: an astral projector eyeing a meat body), returns a
+ * line naming the actual rule -- because "Present: no one" right after
+ * "look" listed that very person's aura reads as a bug, not a boundary
+ * (real session: three attempts on a visible Mr. Krow, all told "no one").
+ * Returns null when no cross-plane match, so callers fall through to
+ * their normal miss handling. `deed` picks the phrasing: a weapon strike,
+ * a combat spell, or touch-range support magic.
+ */
+export function crossPlaneRefusal(scene, actor, room, targetName, deed) {
+    const visible = scene.getActorsInRoom(room)
+        .filter(a => a !== actor && a.plane !== actor.plane && actor.canPerceive(a));
+    const picked = fuzzyPickName(targetName, visible.map(a => a.name));
+    if (!picked)
+        return null;
+    const other = visible.find(a => a.name === picked);
+    if (actor.plane === 'astral' && other.plane === 'meat') {
+        switch (deed) {
+            case 'strike':
+                return `${other.name} is right there -- but only in the meat. From the astral you're a ghost: watch them, "assense" them, and that's all. Astral strikes only land on astral things (spirits, other projections). "return" to your body if you want to lay hands on them.`;
+            case 'spell':
+                return `${other.name}'s aura burns right below you, but mana can't cross back into the meat from out here. Spells cast while projecting only touch astral targets (spirits, projections). "return" to your body, then cast with flesh behind it.`;
+            case 'touch':
+                return `${other.name} is meat and right now you're not -- touch-range magic needs your hands. "return" to your body first.`;
+        }
+    }
+    return `${other.name} is on a plane your hands can't reach -- you can see them, not touch them.`;
+}
+export function returnToBody(scene, actor, opts) {
+    const lines = [];
+    const body = actor.bodyRoom;
+    const debt = Math.ceil(actor.astralTicks / 2) + (opts?.forced ? 2 : 0);
+    if (opts?.reason)
+        lines.push(opts.reason);
+    if (debt > 0) {
+        const resist = rollPool(actor.willpower + Math.floor(actor.magic / 2));
+        const dealt = Math.max(0, debt - resist.hits);
+        lines.push(`  The snap-back (${debt}) -- resist: ${formatRoll(resist)}`);
+        if (dealt > 0) {
+            actor.takeStun(dealt);
+            lines.push(`  Re-entry burns -- ${dealt} stun: ${actor.stunSummary()}`);
+        }
+        else {
+            lines.push(`  You settle back into your flesh without a tremor.`);
+        }
+    }
+    else {
+        lines.push(`You flow back down the silver thread.`);
+    }
+    actor.plane = 'meat';
+    actor.astralTicks = 0;
+    if (body) {
+        actor.currentLocation = body;
+        actor.bodyRoom = undefined;
+        lines.push(`You open your own eyes in ${body.name}.`);
+    }
+    actor.performAction('returns to their body', 'drawing a sharp breath');
+    scene.addWorldEvent(`${actor.name} returned to their body.`);
+    scene.updateStatus();
+    return lines;
+}
+/**
+ * A meat-plane attack on an empty body: one UNANSWERED strike -- no
+ * defense roll (nobody's home), meat soak only (Body + worn armor; the
+ * plane-aware getSoakPool would wrongly price the persona's firewall) --
+ * then the owner is slammed back into a body under attack, paying the
+ * forced-return toll on top of whatever got through. Returns the full
+ * narration; the caller announces it.
+ */
+export function resolveBodyAttack(scene, attacker, victim) {
+    const logger = Logger.getInstance();
+    const lines = [];
+    const wasPlane = victim.plane;
+    const weapon = attacker.getWeaponProfile();
+    const attack = rollPool(attacker.getAttackPool());
+    const soakPool = Math.max(0, victim.body + victim.getArmorValue());
+    lines.push(`${attacker.name} attacks ${victim.name}'s empty body with ${weapon.name} -- nobody's home to dodge:`);
+    lines.push(`  Attack:  ${formatRoll(attack)}`);
+    if (attack.hits === 0) {
+        lines.push(`  Somehow, the blow goes wide of even a motionless target.`);
+    }
+    else {
+        const incoming = weapon.damage + attack.hits;
+        const soak = rollPool(soakPool);
+        const dealt = Math.max(0, incoming - soak.hits);
+        lines.push(`  Hit! ${incoming} damage incoming.`);
+        lines.push(`  Soak:    ${formatRoll(soak)}`);
+        if (dealt === 0) {
+            lines.push(`  The armor holds -- the body doesn't even rock.`);
+        }
+        else {
+            victim.takeDamage(dealt);
+            lines.push(`  ${dealt} box${dealt === 1 ? '' : 'es'} into the defenseless flesh.`);
+        }
+    }
+    logger.write(`${attacker.name} attacked ${victim.name}'s empty body (${wasPlane}).`);
+    // The owner feels it and snaps back -- into a room with an attacker.
+    const reason = `Something is happening to your BODY --`;
+    const back = wasPlane === 'matrix'
+        ? leaveMatrix(scene, victim, { forced: true, reason })
+        : returnToBody(scene, victim, { forced: true, reason });
+    lines.push('', ...back);
+    return lines;
+}
+//# sourceMappingURL=planes.js.map

package/bundle/typescript/src/commands/game/sideQuest/utilities/planes.js.map

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

package/bundle/typescript/src/commands/game/sideQuest/utilities/pursuit.d.ts

@@ -0,0 +1,16 @@
+import { Scene } from '../models/scene.js';
+import { Room } from '../models/room.js';
+/**
+ * When a combat target isn't in the room, work out where they actually are
+ * and phrase it as something actionable -- found via a real session where a
+ * player ping-ponged between two rooms and the hostile NPC's AI loop just
+ * spammed dozens of failed "attack" commands at the empty room instead of
+ * chasing. The failed command's RESULT string is the one thing guaranteed
+ * to land in an NPC's AI history, so putting the literal next command in it
+ * ("go west" to chase) is what converts flailing into pursuit. Works for
+ * the player too: attacking someone who just fled tells you where they ran.
+ *
+ * Returns undefined when the name matches nobody in the scene at all --
+ * the caller keeps its ordinary "no such person" message for that.
+ */
+export declare function describeFledTarget(scene: Scene, fromRoom: Room, targetName: string): string | undefined;

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

@@ -0,0 +1,36 @@
+import { Door } from '../models/door.js';
+import { fuzzyPickName } from './fuzzy-match.js';
+/**
+ * When a combat target isn't in the room, work out where they actually are
+ * and phrase it as something actionable -- found via a real session where a
+ * player ping-ponged between two rooms and the hostile NPC's AI loop just
+ * spammed dozens of failed "attack" commands at the empty room instead of
+ * chasing. The failed command's RESULT string is the one thing guaranteed
+ * to land in an NPC's AI history, so putting the literal next command in it
+ * ("go west" to chase) is what converts flailing into pursuit. Works for
+ * the player too: attacking someone who just fled tells you where they ran.
+ *
+ * Returns undefined when the name matches nobody in the scene at all --
+ * the caller keeps its ordinary "no such person" message for that.
+ */
+export function describeFledTarget(scene, fromRoom, targetName) {
+    const elsewhere = scene.allActors.filter(a => a.currentLocation !== fromRoom);
+    const pickedName = fuzzyPickName(targetName, elsewhere.map(a => a.name));
+    if (!pickedName)
+        return undefined;
+    const target = elsewhere.find(a => a.name === pickedName);
+    if (!target || !target.currentLocation)
+        return undefined;
+    const theirRoom = target.currentLocation;
+    // Adjacent? Name the direction and whether the way is open.
+    for (const [direction, exit] of fromRoom.exits.entries()) {
+        if (exit instanceof Door && exit.getOtherSide(fromRoom) === theirRoom) {
+            if (exit.checkIfLocked()) {
+                return `${target.name} isn't here -- they're through the ${direction} door in ${theirRoom.name}, but it's locked.`;
+            }
+            return `${target.name} isn't here -- they went ${direction}, to ${theirRoom.name}. ("go ${direction}" to chase them.)`;
+        }
+    }
+    return `${target.name} isn't here -- they're somewhere else (${theirRoom.name}), not within reach of this room.`;
+}
+//# sourceMappingURL=pursuit.js.map

package/bundle/typescript/src/commands/game/sideQuest/utilities/pursuit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pursuit.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/utilities/pursuit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAY,EAAE,QAAc,EAAE,UAAkB;IACjF,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC;IAC9E,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzE,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe;QAAE,OAAO,SAAS,CAAC;IAEzD,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,CAAC;IAEzC,4DAA4D;IAC5D,KAAK,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACzD,IAAI,IAAI,YAAY,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;YACtE,IAAI,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;gBACzB,OAAO,GAAG,MAAM,CAAC,IAAI,sCAAsC,SAAS,YAAY,SAAS,CAAC,IAAI,oBAAoB,CAAC;YACrH,CAAC;YACD,OAAO,GAAG,MAAM,CAAC,IAAI,4BAA4B,SAAS,QAAQ,SAAS,CAAC,IAAI,UAAU,SAAS,mBAAmB,CAAC;QACzH,CAAC;IACH,CAAC;IAED,OAAO,GAAG,MAAM,CAAC,IAAI,0CAA0C,SAAS,CAAC,IAAI,mCAAmC,CAAC;AACnH,CAAC"}

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

@@ -6,6 +6,12 @@ import PlayCommand from './play.command.js';
 import { Command } from '../../command.js';
 import { Actions } from '../../tools/actions/actions.class.js';
 import { Log } from '../../tools/log/log.class.js';
+import { SceneSeedGenerator } from './sideQuest/factories/scene-seed-generator.js';
+import { ARCHETYPES, getArchetype, outfitArchetype } from './sideQuest/archetypes.js';
+import { Player } from './sideQuest/models/player.js';
+import { Room } from './sideQuest/models/room.js';
+import { Logger } from './sideQuest/utilities/logger.js';
+import { AI } from '../../tools/ai/ai.class.js';
 const shadowrunConfig1 = require('./sideQuest/scenes/scene1.json');
 const shadowrunConfig2 = require('./sideQuest/scenes/scene2.json');
 import { fileURLToPath } from 'url';
@@ -24,20 +30,85 @@ Command.create({
 }, async function (args, opts) {
     try {
         const makaDir = this.fsi.getGlobalMakaDir();
-        const logFilePath = path.join(makaDir, 'side-quest.log');
+        // Each play session gets its own directory (timestamp-named) instead of
+        // appending to one ever-growing log file. Generated AI scenes are saved
+        // alongside the log for that same session -- see SceneSeedGenerator.
+        const sessionId = new Date().toISOString().replace(/[:.]/g, '-');
+        const sessionDir = path.join(makaDir, 'side-quest-sessions', sessionId);
+        const logFilePath = path.join(sessionDir, 'game.log');
         const playerName = (opts.player) ? opts.player : await Actions.ask('What is your name? [Maka]') || 'Maka';
+        // Pick who you are before what the job is -- the archetype spread
+        // becomes the player's full attribute sheet (see archetypes.ts), and
+        // the mage archetypes are the road to playing Awakened.
+        const archetypeName = await Actions.select({
+            message: 'Who are you on the street?',
+            name: 'archetypeName',
+            choices: ARCHETYPES.map(a => ({ name: `${a.name} -- ${a.description}`, value: a.name })),
+        });
         const gameOptions = {
             ...opts,
-            logFilePath
+            logFilePath,
+            // Matches the convention NPC dialogue already uses elsewhere in this
+            // game: AI features turn on automatically whenever a key is
+            // configured, with no separate flag for the player to remember.
+            // AI.isConfigured() picks whichever provider is set up (OpenAI or
+            // Anthropic -- see tools/ai/ai.class.ts).
+            useAi: AI.isConfigured(),
+            archetype: archetypeName
         };
-        const sideQuestAnswer = await Actions.select({
+        const GENERATE_NEW_RUN = 'GENERATE_NEW_RUN';
+        // The hub (Tacoma Purple Haze) leads the list -- it's the intended
+        // starting ground: live there, call the fixer for runs, come home
+        // between them. Seattle Underground stays as the compact smoke-test
+        // scene (and the generation-failure fallback below).
+        const choices = [
+            { name: shadowrunConfig2.name, value: shadowrunConfig2 },
+            { name: shadowrunConfig1.name, value: shadowrunConfig1 },
+        ];
+        if (gameOptions.useAi) {
+            choices.push({ name: 'Generate a new Run (AI)', value: GENERATE_NEW_RUN });
+        }
+        let sideQuestAnswer = await Actions.select({
             message: 'Which Run would you like to play?',
             name: 'sideQuestAnswer',
-            choices: [
-                { name: shadowrunConfig1.name, value: shadowrunConfig1 },
-                { name: shadowrunConfig2.name, value: shadowrunConfig2 },
-            ]
+            choices
         });
+        if (sideQuestAnswer === GENERATE_NEW_RUN) {
+            const spinner = Log.withSpinner();
+            spinner.start('Generating a new Run');
+            // A throwaway player built from the picked archetype, purely as the
+            // generation dossier source (see buildPlayerDossier) -- the REAL
+            // player is constructed in the spawned ui.js child from the same
+            // archetype options, so this one is never played. Without it, the
+            // first run of a session was archetype-blind: a real Decker session
+            // drew a job with no Matrix content anywhere. The Logger singleton
+            // must be primed first -- Player's constructor grabs it, and its
+            // first getInstance() call demands a screen (the same headless stub
+            // SceneSeedGenerator itself uses).
+            Logger.getInstance(logFilePath, { children: [], render: () => { } });
+            const archetype = getArchetype(gameOptions.archetype);
+            const dossierPlayer = new Player({
+                playerName,
+                startLocation: new Room({ name: 'Nexus', description: 'A featureless room where lost souls drift.', roomType: 'void' }),
+                combat: archetype.combat,
+            });
+            outfitArchetype(dossierPlayer, archetype);
+            const generated = await SceneSeedGenerator.generate(logFilePath, 1, undefined, dossierPlayer);
+            if (generated) {
+                spinner.success(`-- "${generated.name}" is ready.`);
+                sideQuestAnswer = generated;
+            }
+            else {
+                // The blessed UI takes over the terminal's alternate screen buffer
+                // as soon as the child process starts, so a spinner message printed
+                // here would be swallowed before the player ever sees it -- carry
+                // it into the game itself instead.
+                const notice = 'Could not generate a new AI run this time (after 3 attempts) -- starting "Seattle Underground" instead.';
+                spinner.failure(notice);
+                sideQuestAnswer = shadowrunConfig1;
+                gameOptions.generationNotice = notice;
+            }
+        }
         if (playerName && sideQuestAnswer) {
             // Spawn a new process to run your main function
             const child = spawn('node', [path.resolve(__dirname, './sideQuest/ui.js'), playerName, JSON.stringify(sideQuestAnswer), JSON.stringify(gameOptions)], {