@maka/maka-cli 5.6.0 → 5.8.0

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

@@ -1,6 +1,9 @@
 import blessed from 'blessed';
 import { ISceneSeedJson } from './types/seed/scene-seed.js';
+import { Item } from './models/item.js';
 import { Player, Inventory, Room, Scene } from './models/_index.js';
+import { ILifestyleTier } from './utilities/commerce.js';
+import { NPC } from './models/npc.js';
 import { AutoFight } from './utilities/auto-fight.js';
 import { IMainGameConfig } from './ui.js';
 import { PlayerEquipment } from './types/player-equipment.js';
@@ -13,6 +16,7 @@ export default class Game {
     autoFight: AutoFight;
     private _screen;
     private _logBox;
+    private _metaBox;
     private _statusBox;
     private _inputBox;
     private _useAi;
@@ -22,6 +26,165 @@ export default class Game {
     private _hubScene?;
     private _hubName;
     get hasHub(): boolean;
+    /** The active job's name (seed name) -- notoriety incidents cite it. */
+    get currentJobName(): string | undefined;
+    contacts: Map<string, {
+        connection: number;
+        loyalty: number;
+        spent: number;
+        gigs: number;
+        asked: boolean;
+    }>;
+    /** How much juice the name carries, read off the role. */
+    static connectionFor(npc: {
+        name: string;
+        description?: string;
+    }): number;
+    /**
+     * HOME TURF: the hub is where the runner LIVES -- everyone in the
+     * district already knows them (player request: "all NPCs there should
+     * already know them"). Called at hub capture: the whole meat-plane
+     * cast opens at Loyalty 1 ("knows your name"), so legwork works from
+     * day one and only run-scene faces are ever strangers. Depth is still
+     * earned -- trade, gigs, patronage -- exactly as before. Ice and
+     * spirits don't do noodles: non-meat actors stay off the roster.
+     */
+    private seedHomeTurfContacts;
+    companions: {
+        npc: NPC;
+        kind: 'spirit' | 'agent' | 'drone' | 'ally';
+        services?: number;
+        force: number;
+        boundDevice?: Item;
+    }[];
+    private _pendingRedeploys;
+    /**
+     * The one correct runtime NPC spawn (mirrors scene-factory's seed
+     * path): construct with a scene-bound registry, add to the scene
+     * (names must be unique -- addActor throws), place via
+     * setCharacterLocation (the ONLY path that binds room observers), and
+     * hand it the scene for its AI context.
+     */
+    spawnCompanionShell(opts: {
+        name: string;
+        description: string;
+        kind: 'spirit' | 'agent' | 'drone' | 'ally';
+        combat: Partial<import('./models/player.js').ICombatAttributes>;
+        room: Room;
+        plane: 'meat' | 'matrix' | 'astral';
+        force: number;
+        services?: number;
+        boundDevice?: Item;
+    }): NPC | null;
+    /**
+     * The autonomous-drone shell, shared by the deploy command and
+     * arrival re-shelling: the frame's dog-brain (Pilot = 2 + quality)
+     * stands in for every attribute it lacks (RAW p.269-271).
+     */
+    private static readonly DRONE_CARGO_KG;
+    deployDroneShell(item: Item, room: Room): NPC | null;
+    /** Drops a companion's shell and its roster entry. */
+    dismissCompanion(entry: (typeof this.companions)[number], reason: string): void;
+    /**
+     * An actor left the world (Scene.removeActor). For a companion shell
+     * that DIED (not a deliberate dismissal -- those set deathClaimed
+     * first and prune themselves), settle the wreckage: a drone's frame is
+     * wrecked where it fell, an agent derezzes (the deck already ate the
+     * damage), a spirit is banished outright.
+     */
+    onActorRemoved(name: string): void;
+    /**
+     * Spirits with no services left depart once no exchange holds them
+     * (called from CombatExchange.finishExchange): the bargain is spent.
+     */
+    settleSpiritServices(): void;
+    private _pursuitTimer?;
+    private readonly _pursuitInFlight;
+    private static readonly PURSUIT_TICK_MS;
+    private startPursuitHeartbeat;
+    stopPursuitHeartbeat(): void;
+    spurCompanionPursuits(): void;
+    /** Pre-travel: every shell folds, each with its own goodbye. */
+    foldCompanionsForTravel(): string[];
+    /** Post-arrival: re-shell what was deployed when you left (drones). */
+    unfoldCompanionsOnArrival(): string[];
+    /**
+     * Records a real transaction with a hub NPC: first contact opens the
+     * relationship at Loyalty 1 (a safeguard -- the hub cast is pre-seeded
+     * by seedHomeTurfContacts); gigs raise it a point each (cap 6);
+     * cumulative spend raises it at each full 1,000 nuyen (cap 3).
+     * Returns a player-facing line when something changed, else null.
+     */
+    touchContact(name: string, kind: 'trade' | 'gig', spent?: number): string | null;
+    pendingSale?: {
+        itemName: string;
+        price: number;
+        fence: string;
+        haggled: boolean;
+    };
+    lifestyleTier: string;
+    rentDebt: number;
+    /** The active lifestyle tier's row (falls back to Squatter). */
+    get lifestyle(): ILifestyleTier;
+    /**
+     * Makes the hideout LOOK like what the rent buys: the room's description
+     * follows the active tier (player request -- an upgraded lifestyle read
+     * as the same windowless squat). Called wherever the tier moves: the
+     * lifestyle command, and the shortfall slide in returnToHub.
+     */
+    syncHomeToLifestyle(): void;
+    private static readonly RESTOCK_CATEGORIES;
+    private _restockSnapshot;
+    /** Captures every restockable shelf item's blueprint (hub capture time). */
+    private snapshotVendorStock;
+    /** Refills empty shelves from the snapshot; returns how many came back. */
+    private restockVendorShelves;
+    /** The fence moves merchandise: anything sold to a fence is sold ON. */
+    private fenceSellsOn;
+    gigAvailable?: {
+        from: string;
+        to: string;
+        itemName: string;
+        itemDescription: string;
+        pay: number;
+        brief: string;
+    };
+    activeGig?: {
+        from: string;
+        to: string;
+        itemName: string;
+        pay: number;
+    };
+    private _gigPool;
+    private _gigIndex;
+    /** Rotates the gig on offer (skipped while one is already in hand). */
+    private advanceGig;
+    /**
+     * WORK FROM A RELATIONSHIP (see commands/ask.ts): a contact puts THEIR
+     * errand on the table. Their seeded gigs get first claim -- spliced
+     * out of the rotating pool, so work handed to you personally never
+     * reappears on the ambient board -- and when the pool holds nothing of
+     * theirs, the relationship synthesizes one: a sealed parcel to another
+     * hub local, priced off Connection (their reach IS the stakes) with a
+     * Loyalty kicker. Loyalty 5+ pays the family rate (+25%). The offer
+     * lands as gigAvailable: the existing "work" pickup and "give"
+     * delivery handle the rest unchanged.
+     */
+    offerGigFrom(contactName: string): {
+        from: string;
+        to: string;
+        itemName: string;
+        itemDescription: string;
+        pay: number;
+        brief: string;
+        familyRate: boolean;
+    } | null;
+    fencedCategories: Set<string>;
+    private _rumorPool;
+    private _rumorIndex;
+    activeRumor?: string;
+    /** Rotates to the next rumor and plants it where NPCs will hear it. */
+    private advanceRumor;
     /** The persistent hideout room -- go.ts's walk-home trigger checks it. */
     get homeRoom(): Room | undefined;
     private _pendingRunSeed?;
@@ -62,6 +225,7 @@ export default class Game {
      */
     private connectHomeRoom;
     get logBox(): blessed.Widgets.BoxElement;
+    get metaBox(): blessed.Widgets.BoxElement;
     get inputBox(): blessed.Widgets.TextboxElement;
     init(options: IMainGameConfig, screen: blessed.Widgets.Screen): Promise<string>;
     /**
@@ -114,6 +278,19 @@ export default class Game {
      * start -- you rode there, you arrive AT the job).
      */
     private activateRunScene;
+    /**
+     * The needs check at every job departure (SR5e p.56 / p.172, scaled to
+     * job-cycle "days"). Fed AND slept since the last departure: edge
+     * refills and you head out sharp. Skip either: edge stays at whatever's
+     * left. Keep skipping: escalating fatigue (1S, 2S, 3S... per cycle),
+     * resisted Body + Willpower, landing as LOCKED stun no recovery touches
+     * until the need is met (Player.healStun / markFed / markSlept). A
+     * Sleep Regulator (augmentations.ts) halves the effective sleep debt.
+     * Fatigue is capped one box short of a knockout -- RAW would drop you,
+     * but collapsing INSIDE the departure transition would strand the
+     * session between scenes; "running on fumes" carries the spirit.
+     */
+    private applyDepartureNeeds;
     /**
      * "travel": takes the arranged transport to the pending job (see
      * commands/travel.ts). The player arrives AT the run's start room --
@@ -126,6 +303,25 @@ export default class Game {
     close(): Promise<void>;
     private initInputBox;
     private initLogBox;
+    /**
+     * Scroll the log to its tail -- unless the player has paged up to read
+     * history (followBottom off), in which case their place is left alone.
+     * Every "new line arrived" site goes through here.
+     */
+    followLog(): void;
+    /**
+     * The MECHANICS column (readability pass, player request: the log was
+     * a "wall of text"): dice anatomy and resource arithmetic land here
+     * (via Logger.meta) instead of the world log, so the narrative stays
+     * prose. A full-height COLUMN beside the world log, not a bottom
+     * strip -- the first playtest's 3-row ticker scrolled combat rolls
+     * away faster than they could be read. De-emphasis is the BLUE border
+     * -- gray is banned (ANSI bright-black, illegible on stock dark
+     * palettes). Follow-only (no keys); the full interleaved record lives
+     * in session.log. Roll lines wrap at the column width -- fine in a
+     * tall column. NO mouse (see initInputBox): never arm mouse tracking.
+     */
+    private initMetaBox;
     /**
      * The HUD: a fixed strip between the log and the input box for the
      * important real-time state -- condition tracks, armed/link status,