@maka/maka-cli 5.193.0 → 5.194.0

package/bundle/typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maka/maka-cli",
-  "version": "5.193.0",
+  "version": "5.194.0",
   "type": "module",
   "summary": "A command line tool for scaffolding Meteor 3.x applications using either React.",
   "description": "A command line tool for scaffolding Meteor 3.x applications using React.",

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

@@ -91,6 +91,14 @@ export class LookCommand extends Command {
                 .getActorsInRoom(this.actor.currentLocation)
                 .find(a => a.name.toLowerCase() === target.toLowerCase() && this.actor.canPerceive(a));
             if (exactActorMatch) {
+                // THE FACE IS WRITTEN WHEN SOMEBODY ACTUALLY LOOKS (2026-09-14).
+                // Authored appearances (the hub's regulars) are already set and
+                // return immediately; a generated run's stranger gets theirs
+                // here, once, instead of every NPC in the scene being written up
+                // at boot for text most of them never show.
+                if (exactActorMatch instanceof NPC) {
+                    await exactActorMatch.ensureAIAppearance(this.scene.story ?? '');
+                }
                 return this.inspectActor(exactActorMatch.name);
             }
             if (this.actor.inventory.hasItem(target)) {

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

@@ -19,6 +19,13 @@ export class NPCFactory {
         // Native off-plane residents: ice lives on the Matrix, spirits on the
         // astral. They have no body to leave behind -- the plane IS their home.
         npc.plane = json.plane ?? 'meat';
+        // AN AUTHORED FACE IS FINAL (2026-09-14). Seeding the appearance also
+        // closes the door on the generator: setAuthoredAppearance marks it
+        // written, so ensureAIAppearance returns early and the district's
+        // regulars keep the same face every visit instead of being re-invented
+        // on each hub entry.
+        if (json.appearance)
+            npc.setAuthoredAppearance(json.appearance);
         return npc;
     }
     convertPlayerSeedToConstructorConfig(seed) {

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

@@ -2538,28 +2538,6 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
     get pendingRide() {
         return this._pendingRide;
     }
-    /**
-     * Generates NPC first-impression appearances ("look at <npc>") in the
-     * background, one at a time -- the only AI dressing still worth doing
-     * now that every scene arrives with real prose. Fire-and-forget: until
-     * an appearance lands, look-at just shows a bit less flavor.
-     */
-    warmNpcAppearancesInBackground() {
-        if (!this._useAi)
-            return;
-        const npcs = this.scene.allActors.filter((a) => a instanceof NPC);
-        const context = `${this.sceneSeed?.name ?? ''} -- ${this.scene.story}`;
-        void (async () => {
-            for (const npc of npcs) {
-                try {
-                    await npc.ensureAIAppearance(context);
-                }
-                catch {
-                    // Non-fatal: the next look-at simply has less flavor.
-                }
-            }
-        })();
-    }
     // A single fixed room, created once and never torn down across job
     // transitions -- the player's own place, unlike every job's generated
     // rooms which get discarded wholesale when the next job replaces them.
@@ -3271,7 +3249,6 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         // (player request). Occupied slots (archetype signature gear) are
         // never swapped out.
         equipIntoEmptySlots(this.player);
-        this.warmNpcAppearancesInBackground();
         this.startPursuitHeartbeat();
         this.startClockTicker();
         this.startMapHeartbeat();
@@ -4753,7 +4730,6 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         const arrivalLines = this.unfoldCompanionsOnArrival();
         // The crew meets you at the jobsite (commands/crew.ts, lead.ts).
         const allyLines = this.spawnCrew();
-        this.warmNpcAppearancesInBackground();
         this.refreshLogLabel();
         // THE MEET opens the job (canon p.28): the seed's client is this
         // run's Johnson -- track them, and point the arrival at the meet.

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

@@ -913,10 +913,38 @@ Available in-game commands (use with [COMMAND] prefix):
         return this._appearance;
     }
     /**
-     * Generates a spoiler-free, player-facing first impression once per scene
-     * load. Deliberately kept separate from `_description`, which holds
-     * GM-only behavior notes (e.g. "will kill on sight") that would ruin the
-     * game if surfaced through `look at <npc>`.
+     * THE SEED WROTE THIS FACE, so nothing may write it again
+     * (2026-09-14). Setting `hasAIAppearance` is the whole point: it is
+     * the same latch ensureAIAppearance sets after generating, so an
+     * authored appearance and a generated one are indistinguishable to
+     * every reader, and neither is ever overwritten.
+     *
+     * Used by the NPC factory for a seed carrying `appearance` -- the hub's
+     * twelve regulars, who are authored content and must keep their faces
+     * between visits.
+     */
+    setAuthoredAppearance(appearance) {
+        this._appearance = appearance;
+        this.hasAIAppearance = true;
+    }
+    /**
+     * Generates a spoiler-free, player-facing first impression. Deliberately
+     * kept separate from `_description`, which holds GM-only behavior notes
+     * (e.g. "will kill on sight") that would ruin the game if surfaced
+     * through `look at <npc>`.
+     *
+     * CALLED ON FIRST LOOK, NOT ON SCENE BOOT (2026-09-14, mjmcee: "why are
+     * they being regnerated?"). This used to be warmed for EVERY NPC in the
+     * scene the moment it loaded -- twelve calls per hub entry, measured in
+     * production, for text that is read only if the player looks at that
+     * particular person, and most of them are never looked at.
+     *
+     * The cost of waiting until the look is one short call in front of one
+     * reply the player explicitly asked for. The cost of warming was twelve
+     * calls per visit whether or not anyone ever looked, and it did not even
+     * buy stability: every visit rebuilt the NPCs and re-invented all of
+     * them. Authored appearances (setAuthoredAppearance) answer the second
+     * half; this answers the first.
      */
     async ensureAIAppearance(sceneContext) {
         if (this.hasAIAppearance)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maka/maka-cli",
-  "version": "5.193.0",
+  "version": "5.194.0",
   "type": "module",
   "summary": "A command line tool for scaffolding Meteor 3.x applications using either React.",
   "description": "A command line tool for scaffolding Meteor 3.x applications using React.",