@maka/maka-cli 5.61.0 → 5.63.0

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

@@ -0,0 +1,184 @@
+import { isLinked, CALL_COLOR } from './comm-style.js';
+import { isWatched, camerasLive, canSnoopFeeds } from './surveillance.js';
+import { Category } from '../types/shared/item-enum.js';
+import { hint } from './hints.js';
+/**
+ * AROs -- AUGMENTED REALITY OBJECTS (player request 2026-08-26: "we
+ * need AROs on anything online"). The 2075 street is not bare: anything
+ * broadcasting wears an icon in the eye of anyone whose commlink is up.
+ * Until now that layer existed only from the INSIDE -- a jacked-in
+ * persona saw hosts, PANs and camera clusters as icons (grid-view.ts),
+ * and a decker standing in the same room in the flesh saw a bar.
+ *
+ * This is the same objects seen from the meat side, and deliberately
+ * the SAME GLYPHS (● host, ▣ PAN, ◎ cameras, ▤ a loose device), so the
+ * two views read as one world looked at twice rather than two games.
+ *
+ * WHAT IS DELIBERATELY NOT HERE:
+ *  - Anything not broadcasting. Silent PANs, air-gapped hosts and
+ *    powered-down gear have no wireless presence to annotate; that is
+ *    what silence and a hard line BUY, and grid-view.ts omits them for
+ *    the same reason.
+ *  - Loot you have not found. Only items already in plain sight get a
+ *    tag (Room.plainSightItems -- the same subset take.ts lets you
+ *    sweep unsearched). An AR overlay that x-rayed a drawer would hand
+ *    the room's whole inventory to anyone with a commlink and make
+ *    "search" pointless.
+ *  - Marks, alert states and host internals. Those are a persona's
+ *    read, bought by being out there on the grid. AR is the shop
+ *    window, not the back office.
+ */
+/** Whether this actor's AR overlay is actually up right now. */
+export function arSightUp(actor) {
+    // Meat only. A persona IS on the grid (grid-view.ts renders it), an
+    // astral form is nowhere near a commlink, and a jumped-in rigger is
+    // looking through a drone's cameras.
+    if (actor.plane !== 'meat')
+        return false;
+    // SILENCE IS NOT A BLINDFOLD (canon p.229 vs p.235-236, RAG-checked
+    // 2026-08-27). This used to return false while runningSilent, on the
+    // reasoning that the overlay rides the broadcast. Canon says
+    // otherwise: AR is what you RECEIVE (p.229), running silent is about
+    // what you EMIT -- it hides your icon from others and costs you -2
+    // dice on your own Matrix actions (p.235-236, see
+    // Player.matrixActionPenalty), and it "doesn't stop [your traffic]
+    // entirely". A silent runner still sees the street's AROs.
+    //
+    // Keeping the check here was ALSO a live bug: the district map paints
+    // its host markers off Player.hasMatrixEyes(), which never tested
+    // silence, so going silent printed prose about a dead overlay while
+    // the map kept painting hosts. hasMatrixEyes is the single source of
+    // truth now -- one predicate, so the two views cannot disagree.
+    return actor.hasMatrixEyes();
+}
+/**
+ * Every ARO in this room, one line each. Empty when AR is down, muted,
+ * hacked dark, or nothing here is online.
+ */
+export function aroTags(scene, actor, room) {
+    if (!arSightUp(actor))
+        return [];
+    const tags = [];
+    // THE HOST's public face. An air-gapped host has no wireless presence
+    // at all -- from the street it simply is not there (canReachHost is
+    // the persona-side twin of this rule).
+    if (room.hasNode && room.nodeAccess !== 'wired') {
+        tags.push(room.hostCracked
+            ? `● ${room.name} host -- its marquee still turning, its walls in shreds.`
+            : `● ${room.name} host -- a public marquee turning slowly over the room.`);
+    }
+    // EVERY OTHER PRESENCE that is broadcasting. Same test grid-view.ts
+    // uses from the other side, so the two views never disagree about who
+    // is loud.
+    for (const other of scene.getActorsInRoom(room)) {
+        if (other === actor)
+            continue;
+        if (other.isIncapacitated() || !isLinked(other))
+            continue;
+        const master = other.getPanMaster();
+        if (!master)
+            continue;
+        tags.push(`▣ ${other.name} -- ${master.name} broadcasting, public profile up.`);
+    }
+    // THE EYES. Whether they are looped is knowledge you had to take from
+    // the host, so it shows only to whoever owns the feeds.
+    if (isWatched(room)) {
+        const rooms = scene.getRooms();
+        // The verb rides the tag: standing in the room IS the requirement
+        // for a direct connection (commands/tap.ts), so this is the one
+        // place the player is always in a position to use it.
+        tags.push(canSnoopFeeds(rooms, room, actor) && !camerasLive(rooms, room)
+            ? `◎ Camera cluster -- wireless, and looping empty hallways for the house.`
+            : `◎ Camera cluster -- wireless, and watching.${hint(` ("tap" cables into it -- a slaved lens can't hide behind its host)`)}`);
+    }
+    // LOOSE DEVICES lying in plain sight. A wireless deck on a table
+    // announces itself; one in a drawer you never opened does not.
+    for (const item of room.inventory.getAllItems()) {
+        if (item.plane !== 'meat')
+            continue;
+        if (!room.plainSightItems.has(item.name.toLowerCase()))
+            continue;
+        if (!WIRELESS_CATEGORIES.has(item.category))
+            continue;
+        tags.push(`▤ ${item.name} -- powered up and on the grid.`);
+    }
+    return tags;
+}
+/**
+ * THE HUD's AR READ (backlog item 4 -- Maka: "I still can't tell if I
+ * am in AR, there is no status icon"). TWO SLOTS, NEVER ONE. The HUD
+ * ranked five states down a single chain and could therefore only ever
+ * report the winner, so an overlay state was unreadable the moment
+ * anything outranked it. These answer different questions and have
+ * different cures:
+ *
+ *   OVERLAY -- is the world being painted FOR me? Muting is my own
+ *     choice ("ar" flips it back); a hacker cutting it is not
+ *     ("reboot" is the only cure).
+ *   LINK -- is my commlink BROADCASTING? That is what calls ride
+ *     (call.ts wants a worn commlink) and what silence kills.
+ *
+ * They are genuinely independent -- canon p.229 vs p.235-236: AR is
+ * what you RECEIVE, silence is what you EMIT -- so a silent runner
+ * reads "AR ON | Link SILENT", both true at once. One slot could never
+ * say that, which was the whole complaint.
+ *
+ * The overlay slot asks arSightUp() rather than re-deriving state, so
+ * the HUD, the AR block on "look", and the district map's host markers
+ * all answer to one predicate and cannot drift apart. The old line
+ * tested `equipment.head?.commlink` for BOTH meanings, so a decker
+ * whose PAN master is a cyberdeck and who wears no commlink was told
+ * "Link offline" while their overlay painted happily -- literally the
+ * state Maka could not read.
+ *
+ * No gray anywhere (standing ruling): blessed's gray is ANSI
+ * bright-black and vanishes on stock dark palettes. White is the
+ * neutral.
+ */
+export function arStatusSlots(actor) {
+    const overlay = arSightUp(actor)
+        ? `{${CALL_COLOR}-fg}◉ AR ON{/${CALL_COLOR}-fg}`
+        : actor.arOffline
+            // CUT outranks MUTED: the state that was done TO you, and that
+            // survives you flipping your own switch, is the one you need to
+            // see. Its cure is named once, on the link slot.
+            ? `{red-fg}◌ AR CUT{/red-fg}`
+            : actor.arMuted
+                ? `{white-fg}◌ AR OFF{/white-fg}`
+                : !actor.getPanMaster() && !actor.isTechnomancer()
+                    ? `{white-fg}◌ no AR rig{/white-fg}`
+                    // Off-plane, or any future state that puts the overlay down
+                    // without being one of the above. game.ts drops the slot
+                    // entirely while off-plane -- a persona has its own HUD line.
+                    : `{white-fg}◌ AR dark{/white-fg}`;
+    // The link slot keeps asking for a WORN commlink, because that is
+    // what call.ts asks for. A deck-only decker reading "AR ON | Link
+    // offline" is not a contradiction -- it is the true and previously
+    // unsayable answer: the overlay paints, nobody can call you.
+    const link = actor.equipment.head?.commlink == null
+        ? `{white-fg}Link offline{/white-fg}`
+        : actor.arOffline
+            ? `{red-fg}Link CRACKED -- reboot{/red-fg}`
+            : actor.runningSilent
+                ? `{magenta-fg}Link SILENT{/magenta-fg}`
+                : `{${CALL_COLOR}-fg}Link online{/${CALL_COLOR}-fg}`;
+    return { overlay, link };
+}
+/** The tags as the standard cyan block, or '' when there is nothing to
+ *  show -- callers append it to their own output. */
+export function aroBlock(scene, actor, room) {
+    const tags = aroTags(scene, actor, room);
+    if (tags.length === 0)
+        return '';
+    return `{cyan-fg}AR OVERLAY:{/cyan-fg}\n${tags.map(t => `  {cyan-fg}${t}{/cyan-fg}`).join('\n')}`;
+}
+/** Gear that talks to the grid on its own. Weapons are absent on
+ *  purpose: a smartgun's link belongs to its carrier's PAN, and it is
+ *  already covered by their ▣ line. */
+const WIRELESS_CATEGORIES = new Set([
+    Category.Commlink,
+    Category.Cyberdeck,
+    Category.RCC,
+    Category.Drone,
+]);
+//# sourceMappingURL=ar.js.map

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

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

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

@@ -0,0 +1,76 @@
+import type { Player } from '../models/player.js';
+import type { NPC } from '../models/npc.js';
+import type { Room } from '../models/room.js';
+/**
+ * WHO CAN OVERHEAR A MURMUR (playtest, Deditri: "a private place for
+ * calls"). A call is audible to the room, and that is correct and
+ * load-bearing -- it is how a table learns what a partner is arranging,
+ * and NPC AIs react to the half of a conversation they catch. What was
+ * missing was anywhere to GO to avoid it: say.ts's call fan-out
+ * iterated `room.getActors()` flat, while ordinary speech (Room.say)
+ * had been spot-local since the "at" spots pass. Two code paths
+ * answering "who hears this" had drifted apart, so ducking into the
+ * booths changed nothing -- Patch at the bar and Old Cray in the booths
+ * overheard you either way.
+ *
+ * The place to duck into already existed. The hub seeds carry it and
+ * the fiction was already written for it: "High-backed booths built for
+ * quiet deals", "the dim table nobody chooses by accident", the Night
+ * Market's "shadowed edge". Nothing new is invented here; the call path
+ * just respects the position everyone else already respects.
+ *
+ * THE RULE, and why it is not Room.say's rule: room speech that finds
+ * nobody at your spot escalates to a SHOUT and carries room-wide -- that
+ * is how you call across a bar. A commlink held to your face never
+ * escalates; talking quietly into it is the whole point of it. So a
+ * murmur reaches your spot and stops there.
+ *
+ * WHAT DOES NOT BUY PRIVACY, deliberately:
+ *  - CIRCULATING (no atSpot) is the compat state and means "anywhere in
+ *    the room" -- it both reaches and is reached by everything. It is
+ *    also the common case, and it stays exactly as loud as it has always
+ *    been.
+ *  - THE OPEN FLOOR is a real position but it is bare ground in the
+ *    middle of the room, no cover, always visible (see spots.ts). Being
+ *    apart from people is not the same as being out of earshot, and a
+ *    runner muttering into their link in the middle of a bar is not
+ *    having a private call.
+ * Privacy is furniture you go and stand at. You never get it by
+ * accident, and you never get it by standing back.
+ *
+ * Position is read off `Player.atSpot` through spots.ts on every call.
+ * Nothing here caches, stores, or derives a second notion of where
+ * anybody is.
+ */
+/**
+ * Everyone in the speaker's room close enough to catch a murmur.
+ * From a named spot: whoever shares it, plus anyone circulating.
+ * From the open floor or while circulating: the whole room.
+ */
+export declare function murmurAudience(speaker: Player): (Player | NPC)[];
+export interface EarshotReading {
+    /** The room declares named places at all. When it doesn't there is
+     *  nowhere in THIS room to duck into and the answer is another room. */
+    spotted: boolean;
+    /** Where the speaker stands; undefined = circulating (see spots.ts). */
+    spot?: string;
+    /** Circulating or on the open floor: nothing between you and the room. */
+    inTheOpen: boolean;
+    /** Who would catch a murmur from here. */
+    audience: (Player | NPC)[];
+    /** Nobody would. */
+    unheard: boolean;
+    /** Named places here with nobody at them -- where to go instead. */
+    quiet: string[];
+}
+export declare function readEarshot(speaker: Player): EarshotReading;
+/**
+ * Named places in this room that nobody is standing at -- the honest
+ * answer to "so where do I go", thresholds sorted to the back. A
+ * CIRCULATING actor is at none of them and all of them at once (the
+ * compat rule), so their presence disqualifies every spot: there is
+ * nowhere to get away from somebody who is everywhere. The open floor
+ * is never offered; it is the one position that explicitly buys
+ * nothing.
+ */
+export declare function quietSpotsIn(room: Room, speaker: Player): string[];

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

@@ -0,0 +1,98 @@
+import { sameSpot, spotOf, spotsActive, OPEN_FLOOR } from './spots.js';
+/**
+ * WHO CAN OVERHEAR A MURMUR (playtest, Deditri: "a private place for
+ * calls"). A call is audible to the room, and that is correct and
+ * load-bearing -- it is how a table learns what a partner is arranging,
+ * and NPC AIs react to the half of a conversation they catch. What was
+ * missing was anywhere to GO to avoid it: say.ts's call fan-out
+ * iterated `room.getActors()` flat, while ordinary speech (Room.say)
+ * had been spot-local since the "at" spots pass. Two code paths
+ * answering "who hears this" had drifted apart, so ducking into the
+ * booths changed nothing -- Patch at the bar and Old Cray in the booths
+ * overheard you either way.
+ *
+ * The place to duck into already existed. The hub seeds carry it and
+ * the fiction was already written for it: "High-backed booths built for
+ * quiet deals", "the dim table nobody chooses by accident", the Night
+ * Market's "shadowed edge". Nothing new is invented here; the call path
+ * just respects the position everyone else already respects.
+ *
+ * THE RULE, and why it is not Room.say's rule: room speech that finds
+ * nobody at your spot escalates to a SHOUT and carries room-wide -- that
+ * is how you call across a bar. A commlink held to your face never
+ * escalates; talking quietly into it is the whole point of it. So a
+ * murmur reaches your spot and stops there.
+ *
+ * WHAT DOES NOT BUY PRIVACY, deliberately:
+ *  - CIRCULATING (no atSpot) is the compat state and means "anywhere in
+ *    the room" -- it both reaches and is reached by everything. It is
+ *    also the common case, and it stays exactly as loud as it has always
+ *    been.
+ *  - THE OPEN FLOOR is a real position but it is bare ground in the
+ *    middle of the room, no cover, always visible (see spots.ts). Being
+ *    apart from people is not the same as being out of earshot, and a
+ *    runner muttering into their link in the middle of a bar is not
+ *    having a private call.
+ * Privacy is furniture you go and stand at. You never get it by
+ * accident, and you never get it by standing back.
+ *
+ * Position is read off `Player.atSpot` through spots.ts on every call.
+ * Nothing here caches, stores, or derives a second notion of where
+ * anybody is.
+ */
+/**
+ * Everyone in the speaker's room close enough to catch a murmur.
+ * From a named spot: whoever shares it, plus anyone circulating.
+ * From the open floor or while circulating: the whole room.
+ */
+export function murmurAudience(speaker) {
+    const others = speaker.currentLocation.getActors().filter(a => a !== speaker);
+    const spot = spotOf(speaker);
+    if (spot === undefined || spot === OPEN_FLOOR)
+        return others;
+    return others.filter(a => sameSpot(speaker, a));
+}
+export function readEarshot(speaker) {
+    const room = speaker.currentLocation;
+    const spot = spotOf(speaker);
+    const audience = murmurAudience(speaker);
+    return {
+        spotted: spotsActive(room),
+        spot,
+        inTheOpen: spot === undefined || spot === OPEN_FLOOR,
+        audience,
+        unheard: audience.length === 0,
+        quiet: quietSpotsIn(room, speaker),
+    };
+}
+/**
+ * A THRESHOLD is not a hiding place. The same name convention spots.ts
+ * uses to find the spot that owns a doorway (see entrySpotFor) -- an
+ * empty doorway is still empty, and still worth listing, but it is the
+ * worst place in the room to take a call and must never be the one the
+ * report recommends.
+ */
+const DOORISH = /door|entrance|entry|threshold|gate/i;
+/**
+ * Named places in this room that nobody is standing at -- the honest
+ * answer to "so where do I go", thresholds sorted to the back. A
+ * CIRCULATING actor is at none of them and all of them at once (the
+ * compat rule), so their presence disqualifies every spot: there is
+ * nowhere to get away from somebody who is everywhere. The open floor
+ * is never offered; it is the one position that explicitly buys
+ * nothing.
+ */
+export function quietSpotsIn(room, speaker) {
+    if (!spotsActive(room))
+        return [];
+    const others = room.getActors().filter(a => a !== speaker);
+    if (others.some(a => spotOf(a) === undefined))
+        return [];
+    const taken = new Set(others.map(a => spotOf(a)));
+    const mine = spotOf(speaker);
+    const empty = (room.spots ?? [])
+        .map(s => s.name)
+        .filter(name => name !== OPEN_FLOOR && name !== mine && !taken.has(name));
+    return [...empty.filter(n => !DOORISH.test(n)), ...empty.filter(n => DOORISH.test(n))];
+}
+//# sourceMappingURL=earshot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"earshot.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/utilities/earshot.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC;IAC7D,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAW,CAAC,CAAC,CAAC;AAC5D,CAAC;AAkBD,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO;QACL,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC;QAC1B,IAAI;QACJ,SAAS,EAAE,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU;QACpD,QAAQ;QACR,OAAO,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC9B,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC;KACnC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,GAAG,qCAAqC,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,IAAU,EAAE,OAAe;IACtD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAW,CAAC,KAAK,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IACnE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAW,CAAC,CAAC,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;SAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAChB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzF,CAAC"}

package/bundle/typescript/src/commands/game/sideQuest/utilities/generation-capture.js

@@ -52,15 +52,27 @@ export class GenerationCapture {
             prompt: clampPrompt(rec.prompt ?? ''),
             reply: clampReply(rec.reply ?? ''),
         });
-        // EVICT THE OLDEST, don't refuse the newest (fixed 2026-08-26 after
-        // review). The first cut returned early once full, which is
-        // first-12-wins -- and the records a bad run produces LAST are its
-        // repair-round failures, precisely the ones worth training on. A
-        // pathological run therefore dropped its most interesting evidence
-        // and kept its least. The bound was the point; which end it bites
-        // was an accident.
-        while (this.records.length > this.MAX_RECORDS)
-            this.records.shift();
+        // EVICT BY VALUE, NOT BY POSITION (fixed 2026-08-27; supersedes the
+        // 2026-08-26 evict-oldest fix, which superseded the original
+        // first-12-wins refusal). Both earlier policies were positional,
+        // and the first production batch proved position is the wrong axis
+        // outright: 12 records, exactly MAX_RECORDS, and pipeline 1 was
+        // entirely absent along with pipeline 2's skeleton. But reaching
+        // pipeline 3 MEANS pipelines 1 and 2 failed -- so evict-oldest had
+        // thrown away precisely the fault records and kept the successful
+        // run. The corpus preserved the successes and discarded the faults,
+        // the exact inverse of what this module exists for.
+        //
+        // Successes are cheap and numerous (one per stage per pipeline);
+        // faults are the entire point. So when the buffer is full, drop the
+        // OLDEST ACCEPTED record, and only fall back to dropping the oldest
+        // fault when there is nothing else left to give up. A 12-slot
+        // buffer under this policy would have kept everything interesting
+        // from that run and lost nothing that mattered.
+        while (this.records.length > this.MAX_RECORDS) {
+            const victim = this.records.findIndex(r => r.outcome === 'accepted');
+            this.records.splice(victim === -1 ? 0 : victim, 1);
+        }
     }
     /** Writes only when something was actually captured. Never throws --
      *  a corpus is a nice-to-have and must never cost the player a run. */

package/bundle/typescript/src/commands/game/sideQuest/utilities/generation-capture.js.map

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

package/bundle/typescript/src/commands/game/sideQuest/utilities/grid-view.d.ts

@@ -12,5 +12,21 @@ import { Scene } from '../models/scene.js';
  * air-gapped, ◆ persona, ▣ PAN, ◇ data.
  */
 export declare function gridIcons(scene: Scene, actor: Player, room: Room): string[];
+/**
+ * THE ROOM AS THE GRID DRAWS IT (player ruling 2026-08-26: "looking in
+ * the matrix shouldn't show the meatworld"). A persona's `look` used to
+ * open with the room's own meat prose -- steam off the noodle pot, the
+ * cracked vinyl, whoever is leaning on the counter. None of that is
+ * where a persona stands: the grid OVERLAYS a space, it does not
+ * furnish it, and a decker reading furniture they cannot touch (from a
+ * body slumped rooms away) is the plane fiction coming apart.
+ *
+ * So this is the orientation that replaces the prose: the room's NAME
+ * -- icons are labelled, and the grid map (map.ts) lists rooms by name
+ * for exactly the same reason -- and how dense the local grid is. The
+ * host itself is deliberately NOT described here: it is an ICON, and
+ * gridIcons below already names it with its state and its verbs.
+ */
+export declare function gridSculpt(actor: Player, room: Room): string;
 /** The icons rendered as the standard cyan block, or the thin-grid line. */
 export declare function gridIconBlock(scene: Scene, actor: Player, room: Room): string;

package/bundle/typescript/src/commands/game/sideQuest/utilities/grid-view.js

@@ -58,11 +58,44 @@ export function gridIcons(scene, actor, room) {
             icons.push(`◎ Camera cluster -- live, and answering to YOU as much as the house. ("snoop <room>" watches remotely)`);
         }
         else {
-            icons.push(`◎ Camera cluster -- live, feeding the site's host. Loud acts here travel. (own the host to loop them)`);
+            // Seen from the grid, the cluster is worth naming as a WAY IN,
+            // not just a hazard (backlog item 10): it is slaved to the host,
+            // and a cable into a slave is a road to its master (p.233). The
+            // catch is that a persona cannot hold a cable -- so this reads as
+            // something your BODY could do, which is the price the rule
+            // charges. See commands/tap.ts.
+            icons.push(`◎ Camera cluster -- live, feeding the site's host. Loud acts here travel. (own the host to loop them -- or walk in and "tap" a lens in the flesh: slaved to the host means a key to the host)`);
         }
     }
     return icons;
 }
+/**
+ * THE ROOM AS THE GRID DRAWS IT (player ruling 2026-08-26: "looking in
+ * the matrix shouldn't show the meatworld"). A persona's `look` used to
+ * open with the room's own meat prose -- steam off the noodle pot, the
+ * cracked vinyl, whoever is leaning on the counter. None of that is
+ * where a persona stands: the grid OVERLAYS a space, it does not
+ * furnish it, and a decker reading furniture they cannot touch (from a
+ * body slumped rooms away) is the plane fiction coming apart.
+ *
+ * So this is the orientation that replaces the prose: the room's NAME
+ * -- icons are labelled, and the grid map (map.ts) lists rooms by name
+ * for exactly the same reason -- and how dense the local grid is. The
+ * host itself is deliberately NOT described here: it is an ICON, and
+ * gridIcons below already names it with its state and its verbs.
+ */
+export function gridSculpt(actor, room) {
+    const header = `{cyan-fg}THE GRID :: ${room.name.toUpperCase()}{/cyan-fg}`;
+    // Thin ground says nothing extra on purpose: gridIconBlock's own
+    // empty-case line already calls it thin, and where there ARE icons
+    // they speak for themselves. Only a host earns a second line.
+    if (!room.hasNode)
+        return header;
+    const ground = canReachHost(actor, room)
+        ? `Dense ground -- a host's architecture stands over this patch, and everything on it answers to that.`
+        : `Dead ground -- there is architecture here, but no door onto it from the wireless grid.`;
+    return `${header}\n{cyan-fg}${ground}{/cyan-fg}`;
+}
 /** The icons rendered as the standard cyan block, or the thin-grid line. */
 export function gridIconBlock(scene, actor, room) {
     const icons = gridIcons(scene, actor, room);

package/bundle/typescript/src/commands/game/sideQuest/utilities/grid-view.js.map

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

package/bundle/typescript/src/commands/game/sideQuest/utilities/room-grid.js

@@ -600,6 +600,40 @@ export const OPEN_FLOOR_NAME = 'open floor';
 function clamp(n, lo, hi) { return Math.max(lo, Math.min(hi, n)); }
 function jitter(rng) { return Math.floor(rng() * 3) - 1; }
 function chebyshev(a, b) { return Math.max(Math.abs(a.x - b.x), Math.abs(a.y - b.y)); }
+/**
+ * LATENT HAZARD, investigated 2026-08-27 and deliberately NOT fixed:
+ * this scans a SQUARE neighbourhood with no wall constraint, so an exit
+ * cell whose wall midpoint is taken can in principle be walked one step
+ * INWARD, off its wall and into open floor. That is the shape of the
+ * open backlog item "the back door is in the middle of the room" -- but
+ * it is NOT that bug. Probed with a tiny room, four exits and a
+ * deliberately crowded north wall: all four exit cells stayed on their
+ * walls, because the r=1 ring reaches the along-wall neighbours before
+ * any interior cell. It needs a fully occupied wall ROW to bite, which
+ * the placement order makes hard to arrange. Left alone rather than
+ * fixed speculatively.
+ *
+ * WHERE THAT BUG ACTUALLY LIVES, for whoever picks the item up (probed,
+ * not guessed -- all 25 shipped seed rooms are clean, so it only bites
+ * GENERATED scenes):
+ *   1. Room.namedDoorwayFor() rescues only ONE doorway-named spot per
+ *      room -- it is a `.find`, singular. A room drafted with both a
+ *      "front door" and a "back door" binds the first and leaves the
+ *      second attached to no exit, however many exits are free.
+ *   2. Any spot left unbound falls through to the "unplaced spots:
+ *      spread out" sampler at the bottom of synthesizeGrid, which is a
+ *      max-min distance rejection sample with NO perimeter constraint.
+ *      Correct for a table, wrong for a door: it seats the thing in
+ *      open floor. Reproduced at (1,4) of a 12x8 room.
+ *   3. namedDoorwayFor only fires at all when some exit direction is
+ *      UNCLAIMED, so a room whose every exit carries a seed `atSpot`
+ *      pointing at non-doorway furniture strands its doorway spot the
+ *      same way even when there is only one.
+ * The multi-exit centroid hub rule below is NOT implicated: it is
+ * reachable only for a spot the seed explicitly bound to several exits,
+ * and Night Market's "stalls" -- the case it was written for -- places
+ * correctly.
+ */
 function nearestFree(start, occupied, dims, exists) {
     if (exists(start) && !occupied.has(key(start)))
         return start;