@maka/maka-cli 5.122.1 → 5.123.1

package/bundle/typescript/src/commands/game/sideQuest/factories/scene-factory.js

@@ -132,12 +132,12 @@ export class SceneSynthesizer {
         // Shared context handed to every ensureAI*() call below, so room
         // descriptions, NPC appearances, and puzzle riddles all stay
         // consistent with the same scene tone.
-        const sceneContext = `
-Scene: ${json.name}
-Story: ${json.story}
-Currency: ${json.currency.type}
-Residence Tiers: ${json.residenceTiers.join(', ')}
-Key Locations: ${json.rooms.map(r => r.name).join(', ')}
+        const sceneContext = `
+Scene: ${json.name}
+Story: ${json.story}
+Currency: ${json.currency.type}
+Residence Tiers: ${json.residenceTiers.join(', ')}
+Key Locations: ${json.rooms.map(r => r.name).join(', ')}
 `.trim();
         // Step 2: Create and Register Rooms using RoomFactory
         logger.write(`Creating Rooms`);

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

@@ -319,6 +319,9 @@ export default class Game {
      *  touches this map -- the legacy single-contract path above is the
      *  solo behavior, byte for byte. */
     docwagonByPlayer: Map<string, IDocwagonContract>;
+    /** The cloud burn started by close(), awaited briefly so the death
+     *  screen can show the server-stamped time. */
+    private _burnInFlight?;
     /** Shared-run hook: a player's HTR extraction (stabilized and carried
      *  off the job). The hosting server writes their snapshot back and
      *  marks them 'left'. */
@@ -1234,7 +1237,30 @@ export default class Game {
      * would otherwise re-arm it).
      */
     launchPendingRun(): Promise<string>;
-    close(): Promise<void>;
+    /**
+     * `cause` is the engine's own death line ("💀 GAME OVER: ... was gunned
+     * down by ..."). It rides the burn to the server, which makes it the
+     * dossier's headline and the seed of the obituary (maka-cli-com-c3
+     * contract, 2026-09-04). A generic line here would produce a generic
+     * obituary, so the specific one is threaded all the way from the kill.
+     */
+    close(cause?: string): Promise<void>;
+    /**
+     * Waits BRIEFLY for the server to stamp the death and answer with the
+     * memorial. Raced against a timeout on purpose: the burn is already
+     * tombstoned locally and the launcher's sweep finishes it either way,
+     * so a slow or dead network costs the player a moment rather than the
+     * death screen itself.
+     */
+    private deathMemorial;
+    /**
+     * The death screen's offer. The URL is ALWAYS printed, for the same
+     * reason the chargen handoff prints its own: a headless or SSH session
+     * has no browser to open, so a link that exists only behind a keypress
+     * is no link at all. Headless sessions reach close() too (Phase C) and
+     * simply have no screen to bind -- the lines still land in the log.
+     */
+    private offerDossier;
     /**
      * THE CLOCK TICKER (playtest 2026-08-27). The gutter rendered once,
      * whenever the pane happened to paint, and then showed that moment
@@ -1418,6 +1444,24 @@ export default class Game {
      * programs / astral will and reads as Armed. White, not gray, for the
      * same legibility reason as the stance it now sits beside.
      */
+    /**
+     * THE DOCWAGON SLOT (user, 2026-09-04, after a Matrix fight killed Maka:
+     * "let's setup a status for docwagon level, so it's clear to see that I
+     * don't have one").
+     *
+     * NO CONTRACT IS THE STATE WORTH SEEING, so it is the one drawn in red
+     * and never omitted. A missing wristband is the difference between a
+     * bad fight and a dead character, and the panel that could have said so
+     * showed armor and an AR overlay and nothing about whether anyone was
+     * coming. It reads at a glance now, beside the two slots that already
+     * answer "how ready am I".
+     *
+     * The tier's resuscitations are what the band actually buys (p.450), so
+     * a contract with none left says that rather than the tier name alone --
+     * a Gold that has spent its one free resusc is closer to Basic than to
+     * Gold, and "GOLD" on its own would be a comforting lie.
+     */
+    private docwagonSlot;
     private armedLine;
     /**
      * THE LOG WEARS THE PLANE (player request 2026-08-25). Jacking in or

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

@@ -1,5 +1,8 @@
 import { agentRatingFromName } from './utilities/programs.js';
 import { MATRIX_STANCE_ACTION } from './models/player.js';
+import { buildDossierUrl } from './utilities/web-character-generator.js';
+import { makaHost } from '../../../tools/https/maka-host.js';
+import { openBrowser } from '../../../tools/browser/open-browser.js';
 import blessed from 'blessed';
 import { hostLabel } from './utilities/grid-names.js';
 import { marksPlaced, marksOnYou } from './utilities/marks.js';
@@ -18,7 +21,7 @@ import { SAVE_VERSION } from './types/save-file.js';
 import { serializePlayer, restorePlayer, captureHubOverlay, applyHubOverlay, writeSaveAtomic, deleteSave, restoreItem, readSave, serializeItem, saveSlug, spillPathFor, } from './utilities/persistence.js';
 import { heartbeatPresence, heartbeatPresenceNow } from './utilities/social.js';
 import { presenceBeatAllowed } from './utilities/presence-gate.js';
-import { pushSave, burnCloudSaveFor, enqueueBoundPush, flushPushQueue, writeSpill, clearSpill, hasPendingPush, } from './utilities/cloud-saves.js';
+import { pushSave, burnCloudSaveFor, enqueueBoundPush, flushPushQueue, writeSpill, takeLastMemorial, authToken, clearSpill, hasPendingPush, } from './utilities/cloud-saves.js';
 import { DOCWAGON_TIERS, RESUSC_FEE, DEATH_COMP } from './utilities/docwagon.js';
 import { isFence, LIFESTYLE_TIERS, canonicalLifestyleTier } from './utilities/commerce.js';
 import { attachBrandMark, attachBrandMarkBottomRight } from './utilities/brand-mark.js';
@@ -86,7 +89,7 @@ import { LeadCommand, RecruitCommand } from './commands/lead.js';
 import { CrewCommand, HireCommand, DismissCommand, TrainCommand } from './commands/crew.js';
 import { PalmCommand } from './commands/palm.js';
 import { CatalogCommand } from './commands/catalog.js';
-import { refreshCatalog } from './utilities/catalog.js';
+import { ensureCatalog } from './utilities/catalog.js';
 import { PerformCommand } from './commands/perform.js';
 import { EdgeCommand } from './commands/edge.js';
 import { SheetCommand } from './commands/sheet.js';
@@ -868,6 +871,9 @@ export default class Game {
      *  touches this map -- the legacy single-contract path above is the
      *  solo behavior, byte for byte. */
     docwagonByPlayer = new Map();
+    /** The cloud burn started by close(), awaited briefly so the death
+     *  screen can show the server-stamped time. */
+    _burnInFlight;
     /** Shared-run hook: a player's HTR extraction (stabilized and carried
      *  off the job). The hosting server writes their snapshot back and
      *  marks them 'left'. */
@@ -2168,7 +2174,7 @@ export default class Game {
         if (client.dead) {
             this.contacts.delete(client.name);
             Logger.getInstance().write(`Client reputation settled: ${client.name} (dead -- no contact).`);
-            return `
+            return `
 ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and their friends ask questions.`;
         }
         const existing = this.contacts.get(client.name);
@@ -2740,9 +2746,14 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             Logger.getInstance().logWithColor(`⚠ Your AI provider refused: "${message.slice(0, 140)}" -- NPC voices and job generation are OFFLINE until the key or credits are fixed. Dice, combat, and coms still work.`, 'yellow');
             this.screenRender?.();
         };
-        // The swag catalog warms from maka-cli.com in the background
+        // The catalog warms from maka-cli.com in the background
         // (utilities/catalog.ts): live list > local cache > baked-in floor.
-        void refreshCatalog();
+        //
+        // A VERSION CHECK FIRST, not a download every boot. The server is
+        // asked for a number; the ~900KB list follows only if the local
+        // cache is behind it. Signed-out players are served their cache or
+        // the floor and nothing leaves the machine.
+        void ensureCatalog({ token: authToken() });
         // No "Generating Scene... Please wait." box anymore: every path now
         // arrives with REAL prose (hand-authored static seeds, chunk-authored
         // generated scenes), so the old blocking AI-redressing pass -- 30-60
@@ -4286,7 +4297,14 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             return `The ride never shows and the job address goes dead. ${FIXER_NAME} will not enjoy hearing this -- call him for another.`;
         }
     }
-    async close() {
+    /**
+     * `cause` is the engine's own death line ("💀 GAME OVER: ... was gunned
+     * down by ..."). It rides the burn to the server, which makes it the
+     * dossier's headline and the seed of the obituary (maka-cli-com-c3
+     * contract, 2026-09-04). A generic line here would produce a generic
+     * obituary, so the specific one is threaded all the way from the kill.
+     */
+    async close(cause) {
         // PERMADEATH (player ruling): close() is reachable ONLY via
         // Scene.endGame(), and endGame fires ONLY on real death (combat
         // resolveDeath, street-decides knockout, drain burnout, ward
@@ -4299,7 +4317,7 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             deleteSave(this._saveFilePath);
             // The cloud copy burns too -- tombstone-first, so an offline death
             // can't be resurrected from the mirror (see cloud-saves.ts).
-            burnCloudSaveFor(this._saveFilePath, this.player.name);
+            this._burnInFlight = burnCloudSaveFor(this._saveFilePath, this.player.name, { manner: 'killed', ...(cause ? { cause } : {}) });
             Logger.getInstance().write(`Permadeath: save deleted (${this._saveFilePath}).`);
         }
         this.stopPursuitHeartbeat();
@@ -4310,12 +4328,66 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             this._inputBox.cancel(); // cancels any active input session
             this._inputBox.detach(); // optionally remove from screen
         }
+        // ONE LAST THING THEY CAN DO (user, 2026-09-04: "I'd like the player
+        // the option to open it ... as a last command they can do, or quit").
+        // A memorial only comes back for a BOUND runner whose burn reached
+        // the server. An anonymous one dies locally and is offered nothing,
+        // which is right -- there is no dossier to open (user ruling: "an
+        // anonymous runner doesn't need a server stamp, their character is
+        // local").
+        const memorial = await this.deathMemorial();
         if (this._screen) {
             this._screen.render(); // re-render if needed
             this._screen.key(['C-c'], () => {
                 process.exit(2);
             });
         }
+        if (memorial)
+            this.offerDossier(memorial);
+    }
+    /**
+     * Waits BRIEFLY for the server to stamp the death and answer with the
+     * memorial. Raced against a timeout on purpose: the burn is already
+     * tombstoned locally and the launcher's sweep finishes it either way,
+     * so a slow or dead network costs the player a moment rather than the
+     * death screen itself.
+     */
+    async deathMemorial() {
+        if (!this._burnInFlight)
+            return undefined;
+        const timeout = new Promise(resolve => { setTimeout(resolve, 4000).unref?.(); });
+        try {
+            await Promise.race([this._burnInFlight, timeout]);
+        }
+        catch { /* a failed burn is still a death; the sweep finishes it */ }
+        return takeLastMemorial();
+    }
+    /**
+     * The death screen's offer. The URL is ALWAYS printed, for the same
+     * reason the chargen handoff prints its own: a headless or SSH session
+     * has no browser to open, so a link that exists only behind a keypress
+     * is no link at all. Headless sessions reach close() too (Phase C) and
+     * simply have no screen to bind -- the lines still land in the log.
+     */
+    offerDossier(memorial) {
+        const token = authToken();
+        const url = token
+            ? buildDossierUrl(token, memorial.dossier)
+            : `${makaHost().origin}${memorial.dossier}`;
+        const died = new Date(memorial.diedAt);
+        const when = Number.isNaN(died.getTime()) ? memorial.diedAt : died.toLocaleString();
+        const log = Logger.getInstance();
+        log.logWithColor(`Time of death, on the record: ${when}`, 'red');
+        log.logWithColor(`Their dossier: ${url}`, 'red');
+        if (!this._screen)
+            return;
+        log.logWithColor(`Press D to open it, or ctrl-c to quit.`, 'red');
+        this._screen.key(['d', 'D'], () => {
+            openBrowser(url);
+            log.logWithColor(`Opening the dossier. Press ctrl-c when you're done.`, 'red');
+            this._screen?.render();
+        });
+        this._screen.render();
     }
     /**
      * THE CLOCK TICKER (playtest 2026-08-27). The gutter rendered once,
@@ -4948,6 +5020,38 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
      * programs / astral will and reads as Armed. White, not gray, for the
      * same legibility reason as the stance it now sits beside.
      */
+    /**
+     * THE DOCWAGON SLOT (user, 2026-09-04, after a Matrix fight killed Maka:
+     * "let's setup a status for docwagon level, so it's clear to see that I
+     * don't have one").
+     *
+     * NO CONTRACT IS THE STATE WORTH SEEING, so it is the one drawn in red
+     * and never omitted. A missing wristband is the difference between a
+     * bad fight and a dead character, and the panel that could have said so
+     * showed armor and an AR overlay and nothing about whether anyone was
+     * coming. It reads at a glance now, beside the two slots that already
+     * answer "how ready am I".
+     *
+     * The tier's resuscitations are what the band actually buys (p.450), so
+     * a contract with none left says that rather than the tier name alone --
+     * a Gold that has spent its one free resusc is closer to Basic than to
+     * Gold, and "GOLD" on its own would be a comforting lie.
+     */
+    docwagonSlot(contract) {
+        if (!contract)
+            return `{red-fg}✚ NO DOCWAGON{/red-fg}`;
+        const tier = contract.tier.replace('-', ' ').toUpperCase();
+        const { freeResuscs } = DOCWAGON_TIERS[contract.tier];
+        // A band with paid-up resuscs is the reassuring case; one that has
+        // spent them still summons a team, it just bills for the table.
+        const resuscs = freeResuscs === 0
+            ? ` (billed)`
+            : contract.resuscsLeft > 0
+                ? ` (${contract.resuscsLeft} resusc)`
+                : ` (spent -- billed)`;
+        const color = contract.resuscsLeft > 0 ? CALL_COLOR : 'yellow';
+        return `{${color}-fg}✚ ${tier}${resuscs}{/${color}-fg}`;
+    }
     armedLine(player) {
         const weapon = player.getWeaponProfile();
         const weaponItem = player.getCarriedWeapon();
@@ -5085,7 +5189,14 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         // The clock LEFT this line for the gutter beside the prompt. It was
         // the last field here, so it was the first thing clipped whenever
         // the pane got tight -- the reason the player could not find it.
-        lines.push(`${armorNote}${arSlot}  |  ${link}`);
+        // The band reads for whichever player this HUD belongs to: a shared
+        // run keeps contracts per player, solo keeps one on the Game.
+        // Optional chaining because the HUD builder runs against partially
+        // constructed Games in fixtures (threads-on-hud.test.ts builds a stub
+        // with no contract map) -- a status line must never be the thing that
+        // throws, least of all on the panel a dying player is reading.
+        const docwagon = this.docwagonSlot(this.docwagonByPlayer?.get(player.name) ?? (player === this.player ? this.docwagon : undefined));
+        lines.push(`${armorNote}${arSlot}  |  ${link}  |  ${docwagon}`);
         // Lines 4+: transient states, present only while active. Future
         // contexts (astral projection, VR hot-sim) join here the same way.
         if (player.sustainedArmor > 0) {
@@ -5331,7 +5442,7 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             const mapInner = mapWidth ?? 15;
             const mapView = Math.max(7, mapInner % 2 === 0 ? mapInner - 1 : mapInner);
             const mapLines = renderMapViewport(this.scene.getRooms(), here, (r, d) => this.scene.barrierSealing(r, d), {
-                visited: this.player.hasCapability('no-fog') ? undefined /* Mapsoft (p.442): the district drawn and named -- its row's capability (catalog v13) */ : this.player.visitedRooms,
+                visited: this.player.can('no-fog') ? undefined /* Mapsoft (p.442): the district drawn and named -- its row's capability (catalog v13) */ : this.player.visitedRooms,
                 arEyes: this.player.hasMatrixEyes(),
             }, mapView, tallestRoomRows());
             // The captions the HUD used to carry: where you are under the