@maka/maka-cli 5.8.0 → 5.9.0

package/bundle/typescript/src/commands/game/sideQuest/scenes/scene2.json

@@ -178,60 +178,107 @@
     },
     {
       "name": "Purple Haze Bar",
-      "description": "The district's namesake: a smoky dive where the house special glows faintly and the booths have heard every job in Tacoma get planned. Runners drink here between runs.",
+      "description": "The district's namesake: a smoky dive with a long bar down one side and high-backed booths along the walls -- they've heard every job in Tacoma get planned. The house special glows faintly, a back corner sits where the light gives up, and the door lets the neon bleed in behind every arrival.",
       "roomType": "Bar",
+      "size": "large",
+      "spots": [
+        { "name": "door", "description": "The street door, where the neon bleeds in." },
+        { "name": "bar", "description": "The long counter, sticky with decades." },
+        { "name": "booths", "description": "High-backed booths built for quiet deals.", "tags": ["cover-partial"] },
+        { "name": "back corner", "description": "The dim table nobody chooses by accident." }
+      ],
       "exits": [
-        { "direction": "north", "targetRoom": "Bar Backroom" }
+        { "direction": "north", "targetRoom": "Bar Backroom", "atSpot": "back corner" }
       ]
     },
     {
       "name": "Bar Backroom",
-      "description": "Crates of unlabeled bottles, a card table with initials knifed into it, and a wall of photographs of runners who didn't come home. Quiet enough to actually talk.",
-      "roomType": "Bar"
+      "description": "Crates of unlabeled bottles by the door, a card table with initials knifed into it, and a wall of photographs of runners who didn't come home. Quiet enough to actually talk.",
+      "roomType": "Bar",
+      "size": "small",
+      "spots": [
+        { "name": "door" },
+        { "name": "card table" },
+        { "name": "crates" }
+      ]
     },
     {
       "name": "Mama Wu's Noodles",
-      "description": "Steam, chili oil, and the best laksa in the Barrens-adjacent world. Mama Wu feeds everyone and forgets nothing.",
-      "roomType": "Restaurant"
+      "description": "Steam, chili oil, and the best laksa in the Barrens-adjacent world -- a bead-curtain door opening onto six stools at the counter. Mama Wu feeds everyone and forgets nothing.",
+      "roomType": "Restaurant",
+      "size": "small",
+      "spots": [
+        { "name": "door", "description": "A bead curtain and a blast of chili-scented steam." },
+        { "name": "counter", "description": "Six stools and the pot that never empties." }
+      ]
     },
     {
       "name": "Night Market",
-      "description": "Stalls of counterfeit everything under strings of dying festival lights. The real shops open off the market's edges -- iron, circuits, medicine, and things with no barcode at all.",
+      "description": "From the entrance, stalls of counterfeit everything under strings of dying festival lights, and a shadowed edge where the light gives out. The real shops open off the stalls -- iron, circuits, medicine, and things with no barcode at all.",
       "roomType": "Market",
+      "size": "large",
+      "spots": [
+        { "name": "entrance" },
+        { "name": "stalls" },
+        { "name": "shadowed edge", "tags": ["cover-partial"] }
+      ],
       "exits": [
-        { "direction": "north", "targetRoom": "Ironmonger's Arms" },
-        { "direction": "east", "targetRoom": "Circuit Bazaar" },
-        { "direction": "south", "targetRoom": "Doc Halloran's Clinic" }
+        { "direction": "north", "targetRoom": "Ironmonger's Arms", "atSpot": "stalls" },
+        { "direction": "east", "targetRoom": "Circuit Bazaar", "atSpot": "stalls" },
+        { "direction": "south", "targetRoom": "Doc Halloran's Clinic", "atSpot": "stalls" }
       ]
     },
     {
       "name": "Ironmonger's Arms",
-      "description": "Racked steel and gun oil: Torque's shop sells serious hardware to serious people. Everything on the wall has a price and a history.",
+      "description": "Racked steel and gun oil: from the door, Torque's counter fronts wall racks of serious hardware for serious people. Everything on the racks has a price and a history.",
       "roomType": "Shop",
-      "owner": "Torque"
+      "owner": "Torque",
+      "size": "small",
+      "spots": [
+        { "name": "door" },
+        { "name": "counter" },
+        { "name": "racks" }
+      ]
     },
     {
       "name": "Circuit Bazaar",
-      "description": "Ratchet's electronics den -- benches of half-gutted decks, coils of optical cable, and a public host humming over the shopfront where locals trade files and gossip.",
+      "description": "Ratchet's electronics den -- a counter by the door, workbenches of half-gutted decks and optical cable behind it, and a public host humming over the shopfront where locals trade files and gossip.",
       "roomType": "Shop",
       "owner": "Ratchet",
       "hasNode": true,
+      "size": "small",
+      "spots": [
+        { "name": "door" },
+        { "name": "counter" },
+        { "name": "workbenches" }
+      ],
       "exits": [
         { "direction": "east", "targetRoom": "Talismonger's Hut" }
       ]
     },
     {
       "name": "Talismonger's Hut",
-      "description": "Bundled herbs, etched copper, and the pressure of old rituals: Sister Verdigris's shop sits inside a working ward that hums against your teeth.",
+      "description": "Bundled herbs and etched copper crowd the doorway; at the altar table, Sister Verdigris works under the pressure of old rituals. The whole shop sits inside a working ward that hums against your teeth.",
       "roomType": "Shop",
       "owner": "Sister Verdigris",
-      "warded": true
+      "warded": true,
+      "size": "small",
+      "spots": [
+        { "name": "doorway" },
+        { "name": "altar table" }
+      ]
     },
     {
       "name": "Doc Halloran's Clinic",
-      "description": "A three-bed street clinic that smells of antiseptic and burnt coffee. Halloran patches runners with no questions and a running tab.",
+      "description": "A street clinic that smells of antiseptic and burnt coffee: three cots past the door, a supply shelf under lock and habit. Halloran patches runners with no questions and a running tab.",
       "roomType": "Clinic",
-      "owner": "Doc Halloran"
+      "owner": "Doc Halloran",
+      "size": "small",
+      "spots": [
+        { "name": "door" },
+        { "name": "cots" },
+        { "name": "supply shelf" }
+      ]
     },
     {
       "name": "Rain-Chewed Alley",
@@ -244,17 +291,29 @@
     },
     {
       "name": "Union Pawnshop",
-      "description": "Whisper's cage of secondhand everything -- fenced goods, forgotten heirlooms, and a ledger of favors nobody wants called in.",
+      "description": "Whisper's cage of secondhand everything: a caged counter facing the door, back shelves of fenced goods and forgotten heirlooms, and a ledger of favors nobody wants called in.",
       "roomType": "Shop",
-      "owner": "Whisper"
+      "owner": "Whisper",
+      "size": "small",
+      "spots": [
+        { "name": "door" },
+        { "name": "counter" },
+        { "name": "back shelves" }
+      ]
     },
     {
       "name": "Flooded Undermarket",
-      "description": "The old market level, shin-deep in black water. Vendors work from stilted stalls; things move under the surface that nobody names.",
+      "description": "The old market level, shin-deep in black water below the entrance stair. Vendors work from stilted stalls over the flood; dry platforms raft the edges, and things move under the surface that nobody names.",
       "roomType": "Market",
+      "size": "large",
+      "spots": [
+        { "name": "entrance stair" },
+        { "name": "stilted stalls" },
+        { "name": "dry platforms" }
+      ],
       "exits": [
-        { "direction": "south", "targetRoom": "Smuggler's Tunnel" },
-        { "direction": "west", "targetRoom": "Condemned Chapel" }
+        { "direction": "south", "targetRoom": "Smuggler's Tunnel", "atSpot": "stilted stalls" },
+        { "direction": "west", "targetRoom": "Condemned Chapel", "atSpot": "dry platforms" }
       ]
     },
     {
@@ -268,29 +327,51 @@
     },
     {
       "name": "Haze Dragons Turf",
-      "description": "The Dragons' clubhouse: engine blocks for furniture, gang colors on every wall, and Brick holding court by the fire barrel. Respect gets you in; anything else gets you Brick.",
+      "description": "The Dragons' clubhouse: a watched gate, engine blocks for furniture, stacked crates along the wall, and Brick holding court by the fire barrel. Respect gets you in; anything else gets you Brick.",
       "roomType": "Gang Turf",
-      "owner": "Brick"
+      "owner": "Brick",
+      "size": "medium",
+      "spots": [
+        { "name": "gate" },
+        { "name": "fire barrel" },
+        { "name": "stacked crates", "tags": ["cover-partial"] }
+      ]
     },
     {
       "name": "Condemned Chapel",
-      "description": "A drowned chapel leaning into the flood, its pews rafted together and its saints scoured faceless. Something still sings here at the edge of hearing.",
+      "description": "A drowned chapel leaning into the flood: past the doorway, pews rafted together into a nave, and an altar where the saints stand scoured faceless. Something still sings here at the edge of hearing.",
       "roomType": "Chapel",
+      "size": "medium",
+      "spots": [
+        { "name": "doorway" },
+        { "name": "nave" },
+        { "name": "altar" }
+      ],
       "exits": [
-        { "direction": "down", "targetRoom": "Chapel Crypt", "puzzle": "Crypt Grate" }
+        { "direction": "down", "targetRoom": "Chapel Crypt", "puzzle": "Crypt Grate", "atSpot": "altar" }
       ]
     },
     {
       "name": "Chapel Crypt",
-      "description": "A dry vault below the waterline, older than the district above it. The reliquary niches were emptied long ago -- almost all of them.",
-      "roomType": "Crypt"
+      "description": "A dry vault below the waterline, older than the district above it. From the entry stairs, reliquary niches line the walls -- emptied long ago, almost all of them.",
+      "roomType": "Crypt",
+      "size": "small",
+      "spots": [
+        { "name": "entry stairs" },
+        { "name": "reliquary niches" }
+      ]
     },
     {
       "name": "Sim Den",
-      "description": "Rows of scavenged sim-couches wired into a matte-black host with no wireless presence at all -- hard lines only, the way the paranoid like it. The couches whisper with other people's dreams.",
+      "description": "Past the door, rows of scavenged sim-couches wired into a matte-black host with no wireless presence at all -- hard lines only, the way the paranoid like it. The couch rows whisper with other people's dreams.",
       "roomType": "Den",
       "hasNode": true,
-      "nodeAccess": "wired"
+      "nodeAccess": "wired",
+      "size": "small",
+      "spots": [
+        { "name": "door" },
+        { "name": "couch rows" }
+      ]
     },
     {
       "name": "Johnson's Office",
@@ -323,6 +404,7 @@
       "player": {
         "name": "Torque",
         "startLocation": "Ironmonger's Arms",
+        "startSpot": "counter",
         "lifestyleChoices": [],
         "combat": {
           "body": 5,
@@ -353,6 +435,7 @@
       "player": {
         "name": "Ratchet",
         "startLocation": "Circuit Bazaar",
+        "startSpot": "counter",
         "lifestyleChoices": [],
         "combat": {
           "body": 2,
@@ -382,6 +465,7 @@
       "player": {
         "name": "Sister Verdigris",
         "startLocation": "Talismonger's Hut",
+        "startSpot": "altar table",
         "lifestyleChoices": [],
         "combat": {
           "body": 3,
@@ -412,6 +496,7 @@
       "player": {
         "name": "Doc Halloran",
         "startLocation": "Doc Halloran's Clinic",
+        "startSpot": "cots",
         "lifestyleChoices": [],
         "combat": {
           "body": 3,
@@ -440,6 +525,7 @@
       "player": {
         "name": "Mama Wu",
         "startLocation": "Mama Wu's Noodles",
+        "startSpot": "counter",
         "lifestyleChoices": [],
         "combat": {
           "body": 3,
@@ -467,6 +553,7 @@
       "player": {
         "name": "Patch",
         "startLocation": "Purple Haze Bar",
+        "startSpot": "bar",
         "lifestyleChoices": [],
         "combat": {
           "body": 5,
@@ -498,6 +585,7 @@
       "player": {
         "name": "Old Cray",
         "startLocation": "Purple Haze Bar",
+        "startSpot": "booths",
         "lifestyleChoices": [],
         "combat": {
           "body": 3,
@@ -527,6 +615,7 @@
       "player": {
         "name": "Skitter",
         "startLocation": "Night Market",
+        "startSpot": "stalls",
         "lifestyleChoices": [],
         "combat": {
           "body": 2,
@@ -556,6 +645,7 @@
       "player": {
         "name": "Brick",
         "startLocation": "Haze Dragons Turf",
+        "startSpot": "fire barrel",
         "lifestyleChoices": [],
         "combat": {
           "body": 6,
@@ -586,6 +676,7 @@
       "player": {
         "name": "Whisper",
         "startLocation": "Union Pawnshop",
+        "startSpot": "counter",
         "lifestyleChoices": [],
         "combat": {
           "body": 2,
@@ -615,6 +706,7 @@
       "player": {
         "name": "Static Ghost",
         "startLocation": "Sim Den",
+        "startSpot": "couch rows",
         "lifestyleChoices": [],
         "combat": {
           "body": 3,
@@ -638,6 +730,7 @@
       "player": {
         "name": "The Drowned Choir",
         "startLocation": "Condemned Chapel",
+        "startSpot": "nave",
         "lifestyleChoices": [],
         "combat": {
           "body": 4,
@@ -677,6 +770,7 @@
       "rating": "Rare",
       "weight": 2,
       "room": "Ironmonger's Arms",
+      "atSpot": "racks",
       "owner": "Torque"
     },
     {
@@ -690,6 +784,7 @@
       "rating": "Standard",
       "weight": 2.5,
       "room": "Ironmonger's Arms",
+      "atSpot": "racks",
       "owner": "Torque"
     },
     {
@@ -703,6 +798,7 @@
       "rating": "Standard",
       "weight": 4,
       "room": "Ironmonger's Arms",
+      "atSpot": "racks",
       "owner": "Torque"
     },
     {
@@ -716,6 +812,7 @@
       "rating": "Common",
       "weight": 0.4,
       "room": "Ironmonger's Arms",
+      "atSpot": "racks",
       "owner": "Torque"
     },
     {
@@ -729,6 +826,7 @@
       "rating": "Standard",
       "weight": 2,
       "room": "Circuit Bazaar",
+      "atSpot": "counter",
       "owner": "Ratchet"
     },
     {
@@ -742,6 +840,7 @@
       "rating": "Standard",
       "weight": 0.1,
       "room": "Circuit Bazaar",
+      "atSpot": "counter",
       "owner": "Ratchet"
     },
     {
@@ -755,6 +854,7 @@
       "rating": "Rare",
       "weight": 6,
       "room": "Circuit Bazaar",
+      "atSpot": "workbenches",
       "owner": "Ratchet"
     },
     {
@@ -768,6 +868,7 @@
       "rating": "Standard",
       "weight": 0.3,
       "room": "Talismonger's Hut",
+      "atSpot": "altar table",
       "owner": "Sister Verdigris"
     },
     {
@@ -781,6 +882,7 @@
       "rating": "Standard",
       "weight": 0.2,
       "room": "Talismonger's Hut",
+      "atSpot": "altar table",
       "owner": "Sister Verdigris"
     },
     {
@@ -794,6 +896,7 @@
       "rating": "Rare",
       "weight": 1.5,
       "room": "Doc Halloran's Clinic",
+      "atSpot": "supply shelf",
       "owner": "Doc Halloran"
     },
     {
@@ -807,6 +910,7 @@
       "rating": "Standard",
       "weight": 1,
       "room": "Doc Halloran's Clinic",
+      "atSpot": "supply shelf",
       "owner": "Doc Halloran"
     },
     {
@@ -820,6 +924,7 @@
       "rating": "Standard",
       "weight": 0.05,
       "room": "Doc Halloran's Clinic",
+      "atSpot": "supply shelf",
       "owner": "Doc Halloran"
     },
     {
@@ -833,6 +938,7 @@
       "rating": "Standard",
       "weight": 0.5,
       "room": "Mama Wu's Noodles",
+      "atSpot": "counter",
       "owner": "Mama Wu"
     },
     {
@@ -846,6 +952,7 @@
       "rating": "Common",
       "weight": 0.5,
       "room": "Mama Wu's Noodles",
+      "atSpot": "counter",
       "owner": "Mama Wu"
     },
     {
@@ -859,6 +966,7 @@
       "rating": "Common",
       "weight": 0.4,
       "room": "Mama Wu's Noodles",
+      "atSpot": "counter",
       "owner": "Mama Wu"
     },
     {
@@ -872,6 +980,7 @@
       "rating": "Common",
       "weight": 0.3,
       "room": "Mama Wu's Noodles",
+      "atSpot": "counter",
       "owner": "Mama Wu"
     },
     {
@@ -885,6 +994,7 @@
       "rating": "Common",
       "weight": 0.3,
       "room": "Purple Haze Bar",
+      "atSpot": "bar",
       "owner": "Patch"
     },
     {
@@ -898,6 +1008,7 @@
       "rating": "Common",
       "weight": 0.4,
       "room": "Purple Haze Bar",
+      "atSpot": "bar",
       "owner": "Patch"
     },
     {
@@ -911,6 +1022,7 @@
       "rating": "Standard",
       "weight": 0.3,
       "room": "Purple Haze Bar",
+      "atSpot": "bar",
       "owner": "Patch"
     },
     {
@@ -924,6 +1036,7 @@
       "rating": "Common",
       "weight": 0.8,
       "room": "Night Market",
+      "atSpot": "stalls",
       "owner": "Skitter"
     },
     {
@@ -937,6 +1050,7 @@
       "rating": "Common",
       "weight": 0.1,
       "room": "Night Market",
+      "atSpot": "stalls",
       "owner": "Skitter"
     },
     {
@@ -950,6 +1064,7 @@
       "rating": "Common",
       "weight": 0.1,
       "room": "Night Market",
+      "atSpot": "stalls",
       "owner": "Skitter"
     },
     {
@@ -963,7 +1078,8 @@
       "texture": "Hand-Bound",
       "rating": "Common",
       "weight": 0.6,
-      "room": "Bar Backroom"
+      "room": "Bar Backroom",
+      "atSpot": "card table"
     },
     {
       "name": "Crypt Notes",
@@ -977,6 +1093,7 @@
       "rating": "Common",
       "weight": 0.3,
       "room": "Union Pawnshop",
+      "atSpot": "back shelves",
       "owner": "Whisper"
     },
     {
@@ -991,6 +1108,7 @@
       "weight": 0.2,
       "currencyAmount": 120,
       "room": "Union Pawnshop",
+      "atSpot": "counter",
       "owner": "Whisper"
     },
     {
@@ -1004,6 +1122,7 @@
       "rating": "Standard",
       "weight": 0.3,
       "room": "Union Pawnshop",
+      "atSpot": "back shelves",
       "owner": "Whisper"
     },
     {
@@ -1031,6 +1150,7 @@
       "weight": 0.2,
       "currencyAmount": 200,
       "room": "Haze Dragons Turf",
+      "atSpot": "stacked crates",
       "owner": "Brick"
     },
     {
@@ -1059,7 +1179,8 @@
       "rating": "Rare",
       "weight": 0,
       "plane": "matrix",
-      "room": "Sim Den"
+      "room": "Sim Den",
+      "atSpot": "couch rows"
     },
     {
       "name": "Drowned Reliquary",
@@ -1071,7 +1192,8 @@
       "texture": "Fused Silver",
       "rating": "Rare",
       "weight": 0.4,
-      "room": "Chapel Crypt"
+      "room": "Chapel Crypt",
+      "atSpot": "reliquary niches"
     },
     {
       "name": "Tarnished Credstick",
@@ -1084,7 +1206,8 @@
       "rating": "Common",
       "weight": 0.2,
       "currencyAmount": 300,
-      "room": "Chapel Crypt"
+      "room": "Chapel Crypt",
+      "atSpot": "reliquary niches"
     }
   ],
   "puzzles": [

package/bundle/typescript/src/commands/game/sideQuest/types/seed/exit-seed.d.ts

@@ -4,4 +4,5 @@ export interface IExitSeedJson {
     keyRequired?: string;
     doorName?: string;
     puzzle?: string;
+    atSpot?: string;
 }

package/bundle/typescript/src/commands/game/sideQuest/types/seed/item-seed.d.ts

@@ -22,4 +22,5 @@ export interface IItemSeedJson {
     transferable?: boolean;
     plane?: 'meat' | 'matrix' | 'astral';
     price?: number;
+    atSpot?: string;
 }

package/bundle/typescript/src/commands/game/sideQuest/types/seed/player-seed.d.ts

@@ -44,6 +44,7 @@ export interface ICombatSeedJson {
 export interface IPlayerSeedJson {
     name: string;
     startLocation: string;
+    startSpot?: string;
     lifestyleChoices: LifestyleChoice[];
     startingItems?: IItemSeedJson[];
     combat?: ICombatSeedJson;

package/bundle/typescript/src/commands/game/sideQuest/types/seed/puzzle-seed.d.ts

@@ -22,4 +22,5 @@ export interface IPuzzleSeedJson {
      * (e.g. a purely social one, solvable only by knowing the actual answer).
      */
     bypassType?: PuzzleBypassType;
+    atSpot?: string;
 }

package/bundle/typescript/src/commands/game/sideQuest/types/seed/room-seed.d.ts

@@ -11,6 +11,12 @@ export interface IRoomSeedJson {
     hasNode?: boolean;
     nodeAccess?: 'wireless' | 'wired';
     warded?: boolean;
+    spots?: {
+        name: string;
+        description?: string;
+        tags?: ('cover-partial' | 'cover-good')[];
+    }[];
+    size?: 'small' | 'medium' | 'large';
     supportedLifestyles?: {
         residenceTiers?: string[];
         employmentTags?: string[];

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

@@ -7,10 +7,46 @@ import { getArchetype, outfitArchetype } from './archetypes.js';
 import { STANCE_CYCLE } from './models/player.js';
 import { AutoFight } from './utilities/auto-fight.js';
 import { TERMINAL_RESET_SEQUENCE } from './utilities/terminal-reset.js';
+// Windows Terminal draws astral-plane emoji (📞 call icon, 📍 HUD pin,
+// 👥 companions, 💀) TWO columns wide, but blessed's 2015-era unicode
+// tables predate emoji being classified wide and count them as ONE. The
+// one-cell drift on every icon row pushed box borders sideways into the
+// next panel and left smartCSR's partial redraws smearing stray orphan
+// characters (two player screenshots; the text-presentation ⚔, one cell
+// on both sides, stayed flush). Teaching charWidth the pictograph blocks
+// fixes the model: strWidth (wrapping) and the cell renderer both route
+// through this same export. BMP dingbats stay untouched -- the terminal
+// really does draw those narrow.
+// TWO patches, and they only work as a pair (blessed's own draw comment:
+// "eat the next character which should be a space due to parseContent's
+// behavior"): charWidth makes wrapping count 2 and the emitter skip the
+// filler cell; chars.all makes parseContent actually INSERT that \x03
+// filler after each pictograph. Either alone leaves rows misaligned or
+// eats a real character.
+{
+    const uni = blessed.unicode;
+    const origCharWidth = uni.charWidth;
+    uni.charWidth = function (text, i) {
+        const point = typeof text === 'number' ? text : uni.codePointAt(text, i ?? 0);
+        if (point >= 0x1F300 && point <= 0x1FAFF)
+            return 2;
+        return origCharWidth.call(this, text, i);
+    };
+    // U+1F300-1FAFF as surrogate pairs. Wrapped in a fresh outer group so
+    // parseContent's "$1\x03" replacement still means "the whole match".
+    const pictographs = '\\ud83c[\\udf00-\\udfff]|\\ud83d[\\udc00-\\udfff]|\\ud83e[\\udc00-\\udeff]';
+    uni.chars.all = new RegExp(`(${uni.chars.all.source}|${pictographs})`, 'g');
+}
 export async function main(playerName, sceneSeed, options) {
     // Create a screen object
     const screen = blessed.screen({
         smartCSR: true,
+        // Without this, blessed strips every astral-plane character (all
+        // modern emoji -- the 📞 call icon, companion icons) to "?" during
+        // content parsing, no matter what the terminal can render. BMP
+        // symbols like ⚔ slipped through, which is why a session showed
+        // swords but question-mark phones.
+        fullUnicode: true,
         title: 'Side Quest Adventure Game',
     });
     // TERMINAL HYGIENE: blessed arms xterm modes (mouse tracking, alt
@@ -135,10 +171,16 @@ export async function main(playerName, sceneSeed, options) {
                     // asked while it works. Cyan: blessed has no dim tag and gray
                     // is banned; cyan is already this game's machine voice.
                     // pushLine, not Logger -- the transcript line above already
-                    // recorded it. "clear" is exempt (echo-then-wipe is noise).
-                    if (input.trim().length > 0 && input.trim().split(' ')[0] !== 'clear') {
+                    // recorded it. "clear" is exempt (echo-then-wipe is noise),
+                    // and "say" keeps only the blank separator -- your words
+                    // already land as the yellow speech line, and "> say hoi"
+                    // above "hoi" read as a stutter (playtest note).
+                    const echoVerb = input.trim().split(' ')[0]?.toLowerCase();
+                    if (input.trim().length > 0 && echoVerb !== 'clear') {
                         game.logBox.pushLine('');
-                        game.logBox.pushLine(`{cyan-fg}> ${input.trim()}{/cyan-fg}`);
+                        if (echoVerb !== 'say') {
+                            game.logBox.pushLine(`{cyan-fg}> ${input.trim()}{/cyan-fg}`);
+                        }
                         game.followLog();
                         screen.render();
                     }
@@ -159,6 +201,13 @@ export async function main(playerName, sceneSeed, options) {
                     if (input.split(' ')[0] === 'clear') {
                         game.logBox.setContent('');
                         game.metaBox.setContent('');
+                        // Blessed repositions a box's LABEL on 'scroll' events --
+                        // setContent('') resets the scroll base without firing one,
+                        // stranding the title mid-box (screenshot bug: "Game Log"
+                        // sitting at the bottom after "clear"). Scrolling home
+                        // fires the event and the label snaps back to the border.
+                        game.logBox.scrollTo(0);
+                        game.metaBox.scrollTo(0);
                     }
                     if (response)
                         gameLog.transcript(response);