@maka/maka-cli 5.17.16 → 5.17.18

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

@@ -6,8 +6,7 @@ import { Room } from './models/_index.js';
 import { Door } from './models/door.js';
 import { SAVE_VERSION } from './types/save-file.js';
 import { serializePlayer, restorePlayer, captureHubOverlay, applyHubOverlay, writeSaveAtomic, deleteSave, restoreItem, readSave, serializeItem, saveSlug, } from './utilities/persistence.js';
-import { appendCrewLedger } from './utilities/crew-ledger.js';
-import { heartbeatPresence, heartbeatPresenceNow, ghostHireable, syncCrewLedger, claimGhostEarnings } from './utilities/social.js';
+import { heartbeatPresence, heartbeatPresenceNow } from './utilities/social.js';
 import { pushSave, burnCloudSaveFor } from './utilities/cloud-saves.js';
 import { DOCWAGON_TIERS, RESUSC_FEE, DEATH_COMP } from './utilities/docwagon.js';
 import { isFence, LIFESTYLE_TIERS } from './utilities/commerce.js';
@@ -77,7 +76,9 @@ import { ContactsCommand } from './commands/contacts.js';
 import { JumpCommand } from './commands/jump.js';
 import { InitiateCommand } from './commands/initiate.js';
 import { SummonCommand } from './commands/summon.js';
-import { CompileCommand } from './commands/compile.js';
+import { CompileCommand, SPRITE_TYPES } from './commands/compile.js';
+import { ThreadCommand } from './commands/thread.js';
+import { RegisterCommand } from './commands/register.js';
 import { OrderCommand } from './commands/order.js';
 import { DeployCommand, AgentCommand, RecallCommand } from './commands/companions.js';
 import { DeckCommand, LoadProgramCommand, UnloadProgramCommand } from './commands/deck.js';
@@ -133,6 +134,11 @@ export default class Game {
     _inputBox;
     _useAi = false;
     _aiRefusalAnnounced = false;
+    // ACCOUNT BINDING (ruling 2026-08-23): who this runner belongs to,
+    // and whether they're explicitly account-less. Anonymous = the whole
+    // social layer stays dark (presence, cloud mirror, street, drafts).
+    _owner;
+    _anonymous = false;
     _logFilePath = '';
     _tier = 1;
     // Guards against two overlapping continueToNextScene() calls -- found via
@@ -222,9 +228,9 @@ export default class Game {
     // talent pool churns; whoever you HIRED is the persistent part.
     crewForHire = [];
     // PRESENCE (social layer, Phase B): a hub heartbeat announces this
-    // runner to the street's player list on maka-cli.com -- and carries
-    // the "hireable while away" ghost opt-in. Only beats while the scene
-    // IS the hub (the run is nobody's business); silent no-op logged out.
+    // runner to the street's player list on maka-cli.com. Only beats
+    // while the scene IS the hub (the run is nobody's business); silent
+    // no-op logged out.
     _presenceTimer;
     static PRESENCE_TICK_MS = 60_000;
     presencePayload() {
@@ -232,7 +238,6 @@ export default class Game {
             playerName: this.player.name,
             slug: saveSlug(this.player.name),
             hubName: this._hubName,
-            ghostHireable: ghostHireable(),
             // ONLINE means the LINK is live (player ruling): commlink equipped
             // and broadcasting. Pull the link or run silent -> off the street.
             linkUp: this.player.equipment.head?.commlink != null && !this.player.runningSilent,
@@ -276,32 +281,19 @@ export default class Game {
      * push one right now and say so.
      */
     async pushPresenceNow() {
+        if (this._anonymous)
+            return 'offline';
         return heartbeatPresenceNow(this.presencePayload());
     }
     startPresenceHeartbeat() {
+        if (this._anonymous)
+            return; // account-less: never on the street
         if (this._presenceTimer)
             return;
         this.beatPresence();
         this._presenceTimer = setInterval(() => this.beatPresence(), Game.PRESENCE_TICK_MS);
         this._presenceTimer.unref();
     }
-    /** Ghost earnings home delivery: what YOUR runner made riding in
-     *  other players' crews since last time. Fire-and-forget from hub
-     *  arrival beats; pays onto the job credstick when anything landed. */
-    async collectGhostEarnings() {
-        try {
-            const claimed = await claimGhostEarnings(saveSlug(this.player.name));
-            if (!claimed || this.scene !== this._hubScene)
-                return;
-            const paid = this.scene.payRunner(claimed.total, 'ghost earnings');
-            if (!paid)
-                return;
-            const jobs = claimed.entries.map(e => `"${e.job}" with ${e.hiredBy} (${e.amount}¥)`).join(', ');
-            Logger.getInstance().logWithColor(`While you were gone, your runner rode other crews: ${jobs}. ${paid.net}¥ certified lands on your stick.`, 'green');
-            this.updateStatus();
-        }
-        catch { /* offline -- next homecoming */ }
-    }
     static HIRE_NAMES = [
         'Jax', 'Sable', 'Vex', 'Rook', 'Nyx', 'Cinder', 'Halo', 'Grifter',
         'Static', 'Mercy', 'Tinder', 'Chrome Marie', 'Deacon', 'Fetch', 'Loa',
@@ -451,9 +443,6 @@ export default class Game {
             const cut = Math.floor(gross * (member.cutPct * scale) / 100);
             taken += cut;
             parts.push(`${member.name} ${member.cutPct}% (${cut}¥)`);
-            if (member.ghost) {
-                appendCrewLedger({ slug: member.ghost.slug, owner: member.ghost.owner, amount: cut, job: this.currentJobName ?? 'a job', when: new Date().toISOString() });
-            }
         }
         return { share: gross - taken, line: `Crew cut: ${parts.join(', ')}.` };
     }
@@ -723,6 +712,9 @@ export default class Game {
     // death both remove the entry; persistent state (the frame, the deck)
     // lives on Items in the player's possession, never here.
     companions = [];
+    /** A registered sprite folded for travel, waiting to re-shell at the
+     *  destination (the drone _pendingRedeploys school). */
+    _pendingSpriteRedeploy;
     // Drones deployed at travel time re-shell on arrival ("the rotors spin
     // back up at the curb") -- tracked as their items across the swap.
     _pendingRedeploys = [];
@@ -924,7 +916,15 @@ export default class Game {
                 lines.push(`Your bound spirit thins into the rain -- the summons doesn't outlast the ride.`);
             }
             else if (entry.kind === 'sprite') {
-                lines.push(`Your sprite decompiles into clean static -- the thread doesn't outlast the ride.`);
+                // A REGISTERED sprite persists (register.ts): it folds into
+                // your PAN for the ride and re-shells at the curb.
+                if (entry.registered && entry.spriteType) {
+                    this._pendingSpriteRedeploy = { spriteType: entry.spriteType, level: entry.force, tasks: entry.services ?? 0 };
+                    lines.push(`${entry.npc.name} folds into your PAN for the ride -- registered code travels with you.`);
+                }
+                else {
+                    lines.push(`Your sprite decompiles into clean static -- the thread doesn't outlast the ride.`);
+                }
             }
             else if (entry.kind === 'drone') {
                 lines.push(`The ${entry.boundDevice?.name ?? 'drone'} autopilots home to your hand for the ride.`);
@@ -951,8 +951,42 @@ export default class Game {
             if (shell)
                 lines.push(`The ${item.name}'s rotors spin back up at the curb.`);
         }
+        // A REGISTERED sprite re-shells from the PAN (register.ts).
+        if (this._pendingSpriteRedeploy) {
+            const spec = this._pendingSpriteRedeploy;
+            this._pendingSpriteRedeploy = undefined;
+            const line = this.respawnRegisteredSprite(spec);
+            if (line)
+                lines.push(line);
+        }
         return lines;
     }
+    /** Re-shell a registered sprite (travel arrival, or a resumed save).
+     *  Returns the arrival line, or undefined when the shell can't land
+     *  (name collision -- vanishingly rare). */
+    respawnRegisteredSprite(spec) {
+        const type = SPRITE_TYPES[spec.spriteType];
+        if (!type)
+            return undefined;
+        const shell = this.spawnCompanionShell({
+            name: `${type.name} Sprite (Level ${spec.level})`,
+            description: `A registered ${type.name.toLowerCase()} sprite riding ${this.player.name}'s PAN -- ${type.blurb}. It serves until its ${spec.tasks} task${spec.tasks === 1 ? '' : 's'} are spent.`,
+            kind: 'sprite',
+            combat: type.combat(spec.level),
+            room: this.player.currentLocation,
+            plane: 'matrix',
+            force: spec.level,
+            services: spec.tasks,
+        });
+        if (!shell)
+            return undefined;
+        const entry = this.companions.find(c => c.npc === shell);
+        if (entry) {
+            entry.registered = true;
+            entry.spriteType = spec.spriteType;
+        }
+        return `${shell.name} unfolds from your PAN, luminous and patient -- ${spec.tasks} task${spec.tasks === 1 ? '' : 's'} standing.`;
+    }
     /**
      * Records a real transaction with a hub NPC: first contact opens the
      * relationship at Loyalty 1 (a safeguard -- the hub cast is pre-seeded
@@ -1210,6 +1244,8 @@ export default class Game {
     /** The transport, hooks-first, CLI default second; undefined =
      *  offline/logged out/classic mode (callers degrade quietly). */
     async streetTransport() {
+        if (this._anonymous)
+            return undefined; // account-less: no street
         if (this.listStreetPlayers && this.sendPage) {
             return { list: this.listStreetPlayers, send: this.sendPage };
         }
@@ -1242,7 +1278,11 @@ export default class Game {
         if (!channel)
             return undefined;
         player.crewChannel = undefined;
-        void this.streetTransport().then(t => t?.send({ from: player.name, handle: channel.handle, text: END_CALL_SENTINEL })).catch(() => undefined);
+        // The PARTY LINE is a conference: dropping off is local, nobody
+        // else's line dies. Only a 1:1 call signals the far side.
+        if (!channel.party && channel.handle) {
+            void this.streetTransport().then(t => t?.send({ from: player.name, handle: channel.handle, text: END_CALL_SENTINEL })).catch(() => undefined);
+        }
         return channel.playerName;
     }
     /** Trash the offer wholesale ("decline", and any future fixer snub). */
@@ -1567,6 +1607,8 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         CommandFactory.registerCommand('conjure', SummonCommand);
         CommandFactory.registerCommand('compile', CompileCommand);
         CommandFactory.registerCommand('decompile', CompileCommand);
+        CommandFactory.registerCommand('thread', ThreadCommand);
+        CommandFactory.registerCommand('register', RegisterCommand);
         // "At" spots (utilities/spots.ts): walk/move/approach are one
         // crossing; run and sprint are the fast modes (combat semantics in
         // the spot-move phase).
@@ -1676,6 +1718,8 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         this._useAi = options.useAi;
         this._logFilePath = options.logFilePath;
         this._saveFilePath = options.saveFilePath;
+        this._owner = options.owner;
+        this._anonymous = options.anonymousRunner === true;
         // ONE loud notice the moment the AI provider refuses on ACCOUNT
         // grounds (empty credits, bad key). Without it a dead key mutes
         // every NPC and makes every job "fall through" invisibly -- a real
@@ -1751,16 +1795,12 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             // First deal of the for-hire board (rotates each homecoming).
             this.rollHireCandidates();
             // The street learns you're home (social layer): presence beats,
-            // unsynced ghost earnings go up, and anything YOUR runner earned
-            // riding other crews comes down. All fire-and-forget. The DDP hub
-            // link (run invites, shared sessions -- Phase C) warms up behind
-            // them.
+            // and the DDP hub link (run invites, shared sessions -- Phase C)
+            // warms up behind them. All fire-and-forget.
             this.startPresenceHeartbeat();
             void import('./utilities/shared-run.js')
                 .then(m => m.ensureHubLink(this))
                 .catch(() => undefined);
-            void syncCrewLedger();
-            void this.collectGhostEarnings();
             // The next run starts cooking the moment you're home (player
             // request): generation takes 20-40s, and waiting for the player
             // to CALL first meant "give me a bit" every time. Draft now --
@@ -1808,6 +1848,15 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         if (this._hubScene && this.scene === this._hubScene) {
             this.requestSave('hub-arrival');
         }
+        // A REGISTERED sprite from the save re-shells at the cot (the
+        // technomancer's persistent companion -- register.ts).
+        if (this._pendingSpriteRedeploy && this.scene === this._hubScene) {
+            const spec = this._pendingSpriteRedeploy;
+            this._pendingSpriteRedeploy = undefined;
+            const line = this.respawnRegisteredSprite(spec);
+            if (line)
+                Logger.getInstance().logWithColor(line, 'cyan');
+        }
         if (this._resume) {
             const pendingNote = this._pendingRunSeed
                 ? hint(`\n\n${FIXER_NAME}'s job is still on offer: "${this._pendingRunSeed.name}". "call taxi" when you're ready, or "call ${FIXER_NAME}" to hear it again.`)
@@ -1872,7 +1921,16 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         this.docwagon = save.game.docwagon ? { ...save.game.docwagon } : undefined;
         // THE CREW rides the save; the deprecated one-slot enlistedAlly
         // migrates in once (old saves) and is never written again.
-        this.crew = (save.game.crew ?? []).map(m => ({ ...m, gear: [...m.gear] }));
+        // GHOST MIGRATION (mechanic removed 2026-08-23): hired AI copies of
+        // other players' runners dissolve on load -- live seats (liveOnly)
+        // and ordinary hires ride on unchanged.
+        this.crew = (save.game.crew ?? [])
+            .filter(m => !(m.ghost && !m.ghost.liveOnly))
+            .map(m => ({ ...m, gear: [...m.gear] }));
+        // The registered sprite stages for its re-shell at hub arrival.
+        if (save.game.registeredSprite) {
+            this._pendingSpriteRedeploy = { ...save.game.registeredSprite };
+        }
         if (this.crew.length === 0 && save.game.enlistedAlly) {
             const legacy = save.game.enlistedAlly;
             this.crew.push({
@@ -1942,7 +2000,9 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             // Local-first: the beat is DONE the moment the file lands. The
             // cloud mirror rides behind, fire-and-forget (see cloud-saves.ts
             // -- logged-out/offline/expired all degrade to a silent no-op).
-            void pushSave(this._saveFilePath, save);
+            // An ANONYMOUS runner's life never leaves this machine.
+            if (!this._anonymous)
+                void pushSave(this._saveFilePath, save);
         }
         catch (err) {
             logger.error(`requestSave(${reason}) failed: ${err}`);
@@ -1953,6 +2013,8 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             version: SAVE_VERSION,
             savedAt: new Date().toISOString(),
             reason,
+            owner: this._owner,
+            anonymous: this._anonymous ? true : undefined,
             playerName: this.player.name,
             summary: {
                 archetypeName: this.player.archetypeName,
@@ -1970,6 +2032,14 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
                 contacts: [...this.contacts.entries()],
                 procurements: [...this.pendingProcurements],
                 docwagon: this.docwagon ? { ...this.docwagon } : undefined,
+                registeredSprite: (() => {
+                    // A live registered sprite rides the save; a travel-folded one
+                    // is in the redeploy stash. Either way it survives the session.
+                    const live = this.companions.find(c => c.kind === 'sprite' && c.registered && c.spriteType);
+                    if (live)
+                        return { spriteType: live.spriteType, level: live.force, tasks: live.services ?? 0 };
+                    return this._pendingSpriteRedeploy ? { ...this._pendingSpriteRedeploy } : undefined;
+                })(),
                 crew: this.crew.map(m => ({ ...m, gear: [...m.gear] })),
                 commandRefusals: { ...this.commandRefusals },
                 fencedCategories: [...this.fencedCategories],
@@ -2170,11 +2240,8 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         // homecoming lines (obituaries, write-back) rode in above. Fresh
         // faces on the for-hire board each homecoming.
         this.rollHireCandidates();
-        // Social settlement: presence resumes, ghost cuts sync up, earnings
-        // come home.
+        // Social settlement: the street hears you're home.
         this.beatPresence();
-        void syncCrewLedger();
-        void this.collectGhostEarnings();
         const allyLine = crewLines.length > 0 ? `\n${crewLines.join('\n')}` : '';
         // DOCWAGON's year ticks in homecomings (12 = a street year, player
         // ruling): the contract lapses quietly unless renewed at Doc's.
@@ -2235,7 +2302,7 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         // offer flow (his call, accept/decline, the taxi) works unchanged.
         // Offline owners fall back to the Phase B ghost riders below.
         let sharedDeclineNote = '';
-        if (this.hasHub) {
+        if (this.hasHub && !this._anonymous) {
             const srMod = await import('./utilities/shared-run.js').catch(() => undefined);
             const shared = srMod ? await srMod.tryCreateSharedSession(this).catch(() => undefined) : undefined;
             if (shared && 'declined' in shared) {
@@ -2247,7 +2314,7 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
                 // means update THIS machine.
                 const skew = /runs engine ([\d.]+)/.exec(String(shared.declined));
                 sharedDeclineNote = skew
-                    ? ` "Crew channel's scrambled tonight -- this one's quoted without them."\n{yellow-fg}(Out of character: version mismatch -- this maka is ${srMod?.engineVersion() ?? '?'}, the street runs ${skew[1]}. Update THIS machine: npm i -g @maka/maka-cli@${skew[1]}, then relaunch.){/yellow-fg}`
+                    ? ` "Crew channel's scrambled tonight -- this one's quoted without them."\n{yellow-fg}(Out of character: engine mismatch -- this machine runs ${srMod?.engineVersion() ?? '?'}, the street runs ${skew[1]}. If yours is older: npm i -g @maka/maka-cli@latest, then relaunch. If newer, the street is still rolling out.){/yellow-fg}`
                     : ` "Couldn't raise the whole crew -- ${shared.declined} This one's quoted without them."`;
             }
             else if (shared) {
@@ -2913,7 +2980,7 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         if (player.crewChannel) {
             // Reads exactly like an NPC call (player ruling: "keep it simple
             // -- On a call with Steve, just like any call to a contact").
-            lines.push(`{${CALL_COLOR}-fg}${CALL_ICON} On a call with ${player.crewChannel.playerName}{/${CALL_COLOR}-fg}`);
+            lines.push(`{${CALL_COLOR}-fg}${CALL_ICON} ${player.crewChannel.party ? 'On the party line' : `On a call with ${player.crewChannel.playerName}`}{/${CALL_COLOR}-fg}`);
         }
         // The party: one line per live companion shell, with the tracks that
         // matter for its kind. A spirit shows its BODY too (it's a full
@@ -3168,7 +3235,10 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         // players" / "crew street"); the bare verb still answers quietly.
         { title: 'party', entries: [['crew', 'party'], ['hire'], ['dismiss'], ['train'], ['order'], ['lead'], ['command'], ['deploy'], ['recall']] },
         { title: 'magic', entries: [['spells'], ['cast'], ['summon', 'conjure'], ['project'], ['return'], ['assense']] },
-        { title: 'matrix', entries: [['jack'], ['deck'], ['load'], ['unload'], ['hack'], ['pan'], ['silent'], ['reboot'], ['agent'], ['compile', 'decompile'], ['drone'], ['jump', 'rig']] },
+        { title: 'matrix', entries: [['jack'], ['deck'], ['load'], ['unload'], ['hack'], ['pan'], ['silent'], ['reboot'], ['agent'], ['drone'], ['jump', 'rig']] },
+        // The Emerged get their own shelf (player request: "there MUST be
+        // resonance" -- matrix is the place, Resonance is the talent).
+        { title: 'resonance', entries: [['compile', 'decompile'], ['thread'], ['register']] },
         { title: 'social', entries: [['say'], ['talk-to'], ['call'], ['end-call', 'end', 'hangup'], ['accept'], ['decline', 'deny', 'refuse'], ['haggle', 'negotiate'], ['persuade', 'convince'], ['ask'], ['contacts']] },
         { title: 'street', entries: [['browse', 'buy'], ['sell'], ['catalog'], ['source', 'procure'], ['work', 'gig'], ['perform'], ['palm'], ['docwagon'], ['treat'], ['eat'], ['drink'], ['lifestyle'], ['pay']] },
         { title: 'barriers', entries: [['solve'], ['pick'], ['bluff'], ['unlock'], ['lock']] },
@@ -3211,14 +3281,44 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
                 }
                 return lines.join('\n');
             }
-            // "help <command>": one description, aliases resolved to their primary.
-            const allVerbs = [...covered, ...uncategorized];
-            const pickedVerb = fuzzyPickName(query, allVerbs);
+            // "help <command>" (and "help <command> <sub>"): the command's
+            // one-liner plus a TIDY subcommand table when it declares one
+            // (player ruling: structured rows, not a paragraph; a second word
+            // drills into one row).
+            const words = query.split(/\s+/);
+            const pickedVerb = fuzzyPickName(words[0], [...covered, ...uncategorized])
+                ?? fuzzyPickName(query, [...covered, ...uncategorized]);
             if (pickedVerb) {
                 const entry = Game.HELP_CATEGORIES.flatMap(c => c.entries).find(e => e.includes(pickedVerb));
                 const primary = entry?.[0] ?? pickedVerb;
                 const aliases = entry?.slice(1) ?? [];
-                return `${primary}${aliases.length > 0 ? ` (${aliases.join(', ')})` : ''}: ${this.describeVerb(primary)}`;
+                const CommandClass = CommandFactory.getAllRegisteredCommands()[primary];
+                const subs = CommandClass?.getSubcommands?.();
+                const title = `${primary}${aliases.length > 0 ? ` (${aliases.join(', ')})` : ''}`;
+                if (subs && subs.length > 0) {
+                    // Drill-down: "help crew hire" -> just the hire row, long form.
+                    const subQuery = words.slice(1).join(' ');
+                    if (subQuery) {
+                        // A row's key: the word after the primary verb when usage
+                        // starts with it, else its first word.
+                        const subKey = (s) => {
+                            const t = s.usage.split(/\\s+/);
+                            return (t[0] === primary ? t[1] ?? t[0] : t[0]).replace(/[<>|]/g, '');
+                        };
+                        const pickedSub = fuzzyPickName(subQuery, subs.map(subKey));
+                        const sub = pickedSub ? subs.find(s => subKey(s) === pickedSub) : undefined;
+                        if (sub)
+                            return `${sub.usage}\n  ${sub.long ?? sub.short}`;
+                        return `${title}: no subcommand matching "${subQuery}".\n${subs.map(s => `  ${s.usage.padEnd(24)} ${s.short}`).join('\n')}`;
+                    }
+                    const lines = [`${title}: ${this.describeVerb(primary).split('. ')[0]}.`];
+                    for (const s of subs)
+                        lines.push(`  ${s.usage.padEnd(24)} ${s.short}`);
+                    lines.push('');
+                    lines.push(`"help ${primary} <sub>" drills into one.`);
+                    return lines.join('\n');
+                }
+                return `${title}: ${this.describeVerb(primary)}`;
             }
             return `No command or category called "${query}". Try plain "help".`;
         }