clibuddy 1.0.0 → 1.1.0

package/dist/adventure/adventureUI.js

@@ -148,16 +148,20 @@ function renderExpeditionTab(lines, menu, state) {
     lines.push("");
     lines.push(`  ${screen_1.ansi.bold}Biome:${screen_1.ansi.reset} ${biome?.name ?? biomeId}  ${screen_1.ansi.dim}←→ to change${screen_1.ansi.reset}`);
     lines.push("");
+    const requiredLevel = Math.max(1, (diff - 1) * 2);
     const energyCost = 10 + diff * 3;
     const hungerCost = 5 + diff * 2;
-    lines.push(`  ${screen_1.ansi.dim}Cost: ${energyCost} energy, ${hungerCost} hunger${screen_1.ansi.reset}`);
-    const canGo = state.level >= Math.max(1, (diff - 1) * 2) && state.stats.energy >= energyCost && state.stats.hunger >= hungerCost;
+    const levelOk = state.level >= requiredLevel;
+    const energyOk = state.stats.energy >= energyCost;
+    const hungerOk = state.stats.hunger >= hungerCost;
+    const canGo = levelOk && energyOk && hungerOk;
+    const check = (ok) => ok ? `${screen_1.ansi.colors.green}✓${screen_1.ansi.reset}` : `${screen_1.ansi.colors.red}✗${screen_1.ansi.reset}`;
+    lines.push(`  ${check(levelOk)} Level: ${state.level} ${screen_1.ansi.dim}(need ${requiredLevel}+)${screen_1.ansi.reset}`);
+    lines.push(`  ${check(energyOk)} Energy: ${Math.round(state.stats.energy)} ${screen_1.ansi.dim}(costs ${energyCost})${screen_1.ansi.reset}`);
+    lines.push(`  ${check(hungerOk)} Hunger: ${Math.round(state.stats.hunger)} ${screen_1.ansi.dim}(costs ${hungerCost})${screen_1.ansi.reset}`);
     if (canGo) {
         lines.push(`  ${screen_1.ansi.colors.green}Ready to embark!${screen_1.ansi.reset}`);
     }
-    else {
-        lines.push(`  ${screen_1.ansi.colors.red}Not ready — check level/energy/hunger${screen_1.ansi.reset}`);
-    }
     lines.push(`  ${screen_1.ansi.dim}Enter to generate & start, Esc to close${screen_1.ansi.reset}`);
 }
 function renderEndlessTab(lines, state) {
@@ -170,14 +174,17 @@ function renderEndlessTab(lines, state) {
     lines.push(`  ${screen_1.ansi.dim}• Biome rotates each room${screen_1.ansi.reset}`);
     lines.push(`  ${screen_1.ansi.dim}• Defeat = run over${screen_1.ansi.reset}`);
     lines.push("");
-    lines.push(`  ${screen_1.ansi.dim}Requires: Level 5+, 20 energy, 15 hunger${screen_1.ansi.reset}`);
-    const canGo = state.level >= 5 && state.stats.energy >= 20 && state.stats.hunger >= 15;
+    const levelOk = state.level >= 5;
+    const energyOk = state.stats.energy >= 20;
+    const hungerOk = state.stats.hunger >= 15;
+    const canGo = levelOk && energyOk && hungerOk;
+    const check = (ok) => ok ? `${screen_1.ansi.colors.green}✓${screen_1.ansi.reset}` : `${screen_1.ansi.colors.red}✗${screen_1.ansi.reset}`;
+    lines.push(`  ${check(levelOk)} Level: ${state.level} ${screen_1.ansi.dim}(need 5+)${screen_1.ansi.reset}`);
+    lines.push(`  ${check(energyOk)} Energy: ${Math.round(state.stats.energy)} ${screen_1.ansi.dim}(costs 20)${screen_1.ansi.reset}`);
+    lines.push(`  ${check(hungerOk)} Hunger: ${Math.round(state.stats.hunger)} ${screen_1.ansi.dim}(costs 15)${screen_1.ansi.reset}`);
     if (canGo) {
         lines.push(`  ${screen_1.ansi.colors.green}Ready to descend!${screen_1.ansi.reset}`);
     }
-    else {
-        lines.push(`  ${screen_1.ansi.colors.red}Not ready — check level/energy/hunger${screen_1.ansi.reset}`);
-    }
     lines.push(`  ${screen_1.ansi.dim}Enter to begin your descent${screen_1.ansi.reset}`);
 }
 // ─── Adventure Room Rendering ────────────────────────────────

package/dist/adventure/combat/combatUI.d.ts

@@ -1,5 +1,14 @@
-import { BuddyState } from "../../buddy/types";
+import { BuddyState, InventorySlot } from "../../buddy/types";
 import { CombatState } from "../types";
+import { ItemRarity } from "../../inventory/items";
 export declare function renderCombat(combat: CombatState, state: BuddyState, adventureName: string): string;
 export declare function renderSkillMenu(combat: CombatState, state: BuddyState): string;
+/** Get inventory slots usable in combat (medicine items with health effect) */
+export declare function getCombatItems(inventory: InventorySlot[]): {
+    slot: InventorySlot;
+    name: string;
+    healAmount: number;
+    rarity: ItemRarity;
+}[];
+export declare function renderItemMenu(combat: CombatState, inventory: InventorySlot[], selectedIndex: number): string;
 //# sourceMappingURL=combatUI.d.ts.map

package/dist/adventure/combat/combatUI.js

@@ -2,11 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderCombat = renderCombat;
 exports.renderSkillMenu = renderSkillMenu;
+exports.getCombatItems = getCombatItems;
+exports.renderItemMenu = renderItemMenu;
 const types_1 = require("../../buddy/types");
 const species_1 = require("../../buddy/species");
 const types_2 = require("../types");
 const lines_1 = require("../../dialogue/lines");
 const skills_1 = require("./skills");
+const items_1 = require("../../inventory/items");
 const screen_1 = require("../../rendering/screen");
 const CONDITION_ICONS = {
     burn: "🔥", poison: "☠", freeze: "❄", stun: "⚡", charm: "💕",
@@ -113,4 +116,47 @@ function renderSkillMenu(combat, state) {
     lines.push(`  ${screen_1.ansi.dim}${"─".repeat(44)}${screen_1.ansi.reset}`);
     return lines.join("\n");
 }
+/** Get inventory slots usable in combat (medicine items with health effect) */
+function getCombatItems(inventory) {
+    const results = [];
+    for (const slot of inventory) {
+        if (slot.count <= 0)
+            continue;
+        const item = (0, items_1.getItem)(slot.itemId);
+        if (!item || item.type !== "medicine")
+            continue;
+        const healAmount = item.statEffect.health ?? 0;
+        if (healAmount > 0) {
+            results.push({ slot, name: item.name, healAmount, rarity: item.rarity });
+        }
+    }
+    return results;
+}
+function renderItemMenu(combat, inventory, selectedIndex) {
+    const items = getCombatItems(inventory);
+    const lines = [];
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(44)}${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.bold}Items${screen_1.ansi.reset}  ${screen_1.ansi.dim}HP: ${combat.playerStats.hp}/${combat.playerStats.maxHp}${screen_1.ansi.reset}`);
+    if (items.length === 0) {
+        lines.push(`  ${screen_1.ansi.dim}  No medicine in inventory${screen_1.ansi.reset}`);
+    }
+    else {
+        for (let i = 0; i < items.length; i++) {
+            const { name, healAmount, slot, rarity } = items[i];
+            const rarityColor = items_1.ITEM_RARITY_COLORS[rarity] ?? "";
+            const hpAfter = Math.min(combat.playerStats.maxHp, combat.playerStats.hp + healAmount);
+            const selected = i === selectedIndex;
+            const pointer = selected ? `${screen_1.ansi.colors.cyan}▸${screen_1.ansi.reset}` : " ";
+            if (selected) {
+                lines.push(`  ${pointer} ${rarityColor}${screen_1.ansi.bold}${name}${screen_1.ansi.reset} x${slot.count}  ${screen_1.ansi.colors.green}+${healAmount} HP${screen_1.ansi.reset} ${screen_1.ansi.dim}(→${hpAfter})${screen_1.ansi.reset}`);
+            }
+            else {
+                lines.push(`  ${pointer} ${screen_1.ansi.dim}${name} x${slot.count}${screen_1.ansi.reset}`);
+            }
+        }
+    }
+    lines.push(`  ${screen_1.ansi.dim}${"─".repeat(44)}${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.dim}Enter to use, Esc to close${screen_1.ansi.reset}`);
+    return lines.join("\n");
+}
 //# sourceMappingURL=combatUI.js.map

package/dist/buddy/roll.js

@@ -36,7 +36,7 @@ function createBuddyState(species, name) {
         name,
         speciesId: species.id,
         stats: {
-            hunger: 80,
+            hunger: 75,
             happiness: 80,
             health: 100,
             energy: 100,

package/dist/buddy/types.d.ts

@@ -83,6 +83,7 @@ export interface BuddyState {
     notifications: Notification[];
     adventureStats: AdventureStats;
     questProgress: import("../story/types").QuestProgress;
+    tutorialStep?: number;
 }
 export declare const RARITY_COLORS: Record<Rarity, string>;
 export declare const RARITY_LABELS: Record<Rarity, string>;

package/dist/commands/actions.js

@@ -38,12 +38,12 @@ function registerActivityCommand(name, description, activityType, countKey, mess
         },
     });
 }
-registerActivityCommand("feed", "Feed your buddy to restore hunger", "eating", "feeds", (name) => `${name} starts eating! Nom nom...`);
-registerActivityCommand("play", "Play with your buddy to boost happiness", "playing", "plays", (name) => `${name} starts playing!`, (state) => state.stats.energy < 10 ? `${state.name} is too tired to play. Let them /sleep first.` : null);
-registerActivityCommand("sleep", "Let your buddy rest to restore energy", "sleeping", "sleeps", (name) => `${name} curls up and falls asleep... Zzz`);
+registerActivityCommand("feed", "Feed — Hunger +25 (10s)", "eating", "feeds", (name) => `${name} starts eating! Nom nom...`);
+registerActivityCommand("play", "Play — Happiness +20, Energy -15 (15s)", "playing", "plays", (name) => `${name} starts playing!`, (state) => state.stats.energy < 10 ? `${state.name} is too tired to play. Let them /sleep first.` : null);
+registerActivityCommand("sleep", "Sleep — Energy +30 (2m, skippable)", "sleeping", "sleeps", (name) => `${name} curls up and falls asleep... Zzz`);
 (0, registry_1.registerCommand)({
     name: "heal",
-    description: "Heal your buddy to restore health (instant)",
+    description: "Heal — Health +20, +3 XP (instant)",
     execute: (state) => {
         if (!state.alive) {
             return { state: null, message: `${state.name} is no longer with us... Use /revive first.`, rerender: false };
@@ -66,21 +66,7 @@ registerActivityCommand("sleep", "Let your buddy rest to restore energy", "sleep
         if (state.alive) {
             return { state: null, message: `${state.name} is alive and well!`, rerender: false };
         }
-        const counts = { ...state.actionCounts, revives: state.actionCounts.revives + 1 };
-        const newState = {
-            ...state,
-            alive: true,
-            xp: Math.floor(state.xp / 2),
-            stats: { hunger: 50, happiness: 50, health: 50, energy: 50 },
-            lastUpdated: Date.now(),
-            activity: undefined,
-            actionCounts: counts,
-        };
-        return {
-            state: newState,
-            message: `${state.name} stirs back to life! They lost half their XP but they're back.`,
-            rerender: true,
-        };
+        return { state: null, message: "__CONFIRM_REVIVE__", rerender: false };
     },
 });
 (0, registry_1.registerCommand)({
@@ -100,7 +86,7 @@ registerActivityCommand("sleep", "Let your buddy rest to restore energy", "sleep
     name: "help",
     description: "Show all available commands",
     execute: () => {
-        return { state: null, message: "Press / to open the command palette!", rerender: false };
+        return { state: null, message: "Quick: [f]eed [p]lay [s]leep — or press / for all commands", rerender: false };
     },
 });
 (0, registry_1.registerCommand)({

package/dist/index.js

@@ -108,6 +108,8 @@ let endlessDepth = 0;
 let isEndlessMode = false;
 let adventureMenu = (0, adventureUI_1.createAdventureMenu)();
 let showingSkillMenu = false;
+let showingItemMenu = false;
+let itemMenuIndex = 0;
 let petSequence = null;
 let petTick = 0;
 let palette = (0, commandPalette_1.createPalette)();
@@ -116,6 +118,7 @@ let pendingCommand = null; // command selected, waiting for args
 let argsBuffer = "";
 let appPhase = "roll-wait";
 let nameBuffer = "";
+let pendingConfirmation = null;
 // ─── Rendering ───────────────────────────────────────────────
 function redraw() {
     if (appPhase === "playing" && buddyState) {
@@ -128,6 +131,9 @@ function redraw() {
                     if (showingSkillMenu) {
                         screen_ += "\n" + (0, combatUI_1.renderSkillMenu)(activeAdventure.combat, buddyState);
                     }
+                    else if (showingItemMenu) {
+                        screen_ += "\n" + (0, combatUI_1.renderItemMenu)(activeAdventure.combat, buddyState.inventory, itemMenuIndex);
+                    }
                     screen.draw(screen_, `  ${screen_1.ansi.dim}Esc to flee${screen_1.ansi.reset}`);
                 }
                 else if (activeAdventure.phase === "result") {
@@ -185,24 +191,42 @@ function redraw() {
         }
         else if (inventoryUI.active) {
             const s = buddyState.adventureStats;
-            const invLines = (0, inventoryUI_1.renderInventoryUI)(inventoryUI, s.equippedWeapon, s.equippedArmor, s.equippedHelmet, s.equippedBoots, s.equippedAccessory, buddyState.questProgress.gold);
+            const invLines = (0, inventoryUI_1.renderInventoryUI)(inventoryUI, s.equippedWeapon, s.equippedArmor, s.equippedHelmet, s.equippedBoots, s.equippedAccessory, buddyState.questProgress.gold, buddyState.stats);
             const combined = main + "\n" + invLines.join("\n");
             screen.draw(combined, `  ${screen_1.ansi.dim}Inventory open${screen_1.ansi.reset}`);
         }
         else if (palette.active) {
-            const paletteLines = (0, commandPalette_1.renderPalette)(palette);
+            const paletteLines = (0, commandPalette_1.renderPalette)(palette, buddyState.stats);
             const combined = main + "\n" + paletteLines.join("\n");
             const inputDisplay = `  ${screen_1.ansi.dim}>${screen_1.ansi.reset} /${palette.filter}`;
             screen.draw(combined, inputDisplay);
         }
+        else if (pendingConfirmation) {
+            const confirmLines = [
+                `  ${screen_1.ansi.dim}${"─".repeat(40)}${screen_1.ansi.reset}`,
+                `  ${screen_1.ansi.colors.yellow}${pendingConfirmation.message}${screen_1.ansi.reset}`,
+                `  ${screen_1.ansi.dim}${"─".repeat(40)}${screen_1.ansi.reset}`,
+            ];
+            const combined = main + "\n" + confirmLines.join("\n");
+            screen.draw(combined, `  ${screen_1.ansi.colors.yellow}Enter${screen_1.ansi.reset} to confirm, ${screen_1.ansi.colors.yellow}Esc${screen_1.ansi.reset} to cancel`);
+        }
         else if (pendingCommand) {
             const inputDisplay = `  ${screen_1.ansi.dim}>${screen_1.ansi.reset} /${pendingCommand} ${argsBuffer}`;
             screen.draw(main, inputDisplay);
         }
         else {
-            const inputDisplay = inputBuffer
-                ? `  ${screen_1.ansi.dim}>${screen_1.ansi.reset} ${inputBuffer}`
-                : `  ${screen_1.ansi.dim}> Type / for commands${screen_1.ansi.reset}`;
+            let inputDisplay;
+            if (buddyState.activity && buddyState.activity.type !== "idle" && !buddyState.activity.unskippable) {
+                const timerLabel = buddyState.activity.type === "sleeping" ? "Sleeping" :
+                    buddyState.activity.type === "eating" ? "Eating" : "Playing";
+                inputDisplay = `  ${screen_1.ansi.colors.cyan}${timerLabel}... (${(0, activities_1.formatTimeRemaining)(buddyState.activity)}) — press any key to skip${screen_1.ansi.reset}`;
+            }
+            else if (inputBuffer) {
+                inputDisplay = `  ${screen_1.ansi.dim}>${screen_1.ansi.reset} ${inputBuffer}`;
+            }
+            else {
+                inputDisplay = `  ${screen_1.ansi.dim}> [f]eed  [p]lay  [s]leep  /commands${screen_1.ansi.reset}`;
+            }
             screen.draw(main, inputDisplay);
         }
     }
@@ -513,11 +537,20 @@ function handleNamingInput(key) {
         // Confirm name
         const name = nameBuffer.trim() || rolledSpecies.name;
         buddyState = (0, roll_1.createBuddyState)(rolledSpecies, name);
+        buddyState = { ...buddyState, tutorialStep: 0 };
         (0, save_1.saveState)(buddyState);
         appPhase = "playing";
         showFeedback(`Welcome, ${name}! Take good care of them.`, 4000);
         startAnimation();
         startDecay();
+        // Start tutorial — show first hint after a short delay
+        setTimeout(() => {
+            if (buddyState && (buddyState.tutorialStep ?? 99) === 0) {
+                dialogueMessage = `I'm hungry! Try typing / and selecting "feed".`;
+                dialogueSource = "Tutorial";
+                redraw();
+            }
+        }, 5000);
         redraw();
         return;
     }
@@ -558,6 +591,20 @@ function handlePlayingInput(key) {
         handleMinigameMenuInput(key);
         return;
     }
+    // Confirmation prompt
+    if (pendingConfirmation) {
+        if (key === "\r" || key === "\n") {
+            const cb = pendingConfirmation.onConfirm;
+            pendingConfirmation = null;
+            cb();
+        }
+        else if (key === "\x1b") {
+            pendingConfirmation = null;
+            showFeedback("Cancelled.");
+        }
+        redraw();
+        return;
+    }
     // Overlay menus (titles, notifications)
     if (overlay.type) {
         handleOverlayInput(key);
@@ -630,6 +677,15 @@ function handlePlayingInput(key) {
         redraw();
         return;
     }
+    // Quick shortcuts — only when idle on main screen with empty input
+    if (!inputBuffer && !buddyState.activity) {
+        const shortcut = { f: "feed", p: "play", s: "sleep" };
+        const cmd = shortcut[key];
+        if (cmd) {
+            executeCommand(cmd);
+            return;
+        }
+    }
     if (key === "\x7f" || key === "\b") {
         inputBuffer = inputBuffer.slice(0, -1);
         redraw();
@@ -802,6 +858,30 @@ function executeCommand(cmdName, args = []) {
         redraw();
         return;
     }
+    if (result.message === "__CONFIRM_REVIVE__") {
+        const xpLoss = Math.floor(buddyState.xp / 2);
+        pendingConfirmation = {
+            message: `Revive ${buddyState.name}? This costs ${xpLoss} XP (${buddyState.xp} → ${buddyState.xp - xpLoss}).`,
+            onConfirm: () => {
+                if (!buddyState)
+                    return;
+                const counts = { ...buddyState.actionCounts, revives: buddyState.actionCounts.revives + 1 };
+                buddyState = {
+                    ...buddyState,
+                    alive: true,
+                    xp: buddyState.xp - xpLoss,
+                    stats: { hunger: 50, happiness: 50, health: 50, energy: 50 },
+                    lastUpdated: Date.now(),
+                    activity: undefined,
+                    actionCounts: counts,
+                };
+                (0, save_1.saveState)(buddyState);
+                showFeedback(`${buddyState.name} stirs back to life! They lost ${xpLoss} XP but they're back.`);
+            },
+        };
+        redraw();
+        return;
+    }
     if (result.message === "__PET__") {
         startPetSequence();
         redraw();
@@ -810,11 +890,62 @@ function executeCommand(cmdName, args = []) {
     if (result.message) {
         showFeedback(result.message);
     }
+    // Advance tutorial based on commands used
+    if (buddyState && buddyState.tutorialStep !== undefined && buddyState.tutorialStep < 3) {
+        advanceTutorial(cmdName);
+    }
     redraw();
 }
 function pickRandom(arr) {
     return arr[Math.floor(Math.random() * arr.length)];
 }
+function advanceTutorial(cmdName) {
+    if (!buddyState)
+        return;
+    const step = buddyState.tutorialStep ?? 99;
+    if (step === 0 && cmdName === "feed") {
+        buddyState = { ...buddyState, tutorialStep: 1 };
+        (0, save_1.saveState)(buddyState);
+        setTimeout(() => {
+            if (buddyState && buddyState.tutorialStep === 1) {
+                dialogueMessage = "Yum! My stats decay over time. Tip: press f, p, or s for quick feed/play/sleep!";
+                dialogueSource = "Tutorial";
+                if (dialogueTimeout)
+                    clearTimeout(dialogueTimeout);
+                dialogueTimeout = setTimeout(() => {
+                    if (buddyState && buddyState.tutorialStep === 1) {
+                        dialogueMessage = "Now press p to play, or /play — it makes me happy! (Costs energy though.)";
+                        dialogueSource = "Tutorial";
+                        redraw();
+                    }
+                }, 6000);
+                redraw();
+            }
+        }, 3000);
+    }
+    else if (step === 1 && cmdName === "play") {
+        buddyState = { ...buddyState, tutorialStep: 2 };
+        (0, save_1.saveState)(buddyState);
+        setTimeout(() => {
+            if (buddyState && buddyState.tutorialStep === 2) {
+                dialogueMessage = "I gain XP from activities! Try /sleep, /heal, /pet, and / to see everything.";
+                dialogueSource = "Tutorial";
+                if (dialogueTimeout)
+                    clearTimeout(dialogueTimeout);
+                dialogueTimeout = setTimeout(() => {
+                    if (buddyState) {
+                        buddyState = { ...buddyState, tutorialStep: 3 };
+                        (0, save_1.saveState)(buddyState);
+                        dialogueMessage = undefined;
+                        dialogueSource = undefined;
+                        redraw();
+                    }
+                }, 10000);
+                redraw();
+            }
+        }, 3000);
+    }
+}
 function startPetSequence() {
     if (!buddyState)
         return;
@@ -1174,6 +1305,8 @@ function handleCombatInput(key) {
     // Victory/Defeat/Fled — Enter to continue
     if (combat.phase === "victory" || combat.phase === "defeat" || combat.phase === "fled") {
         if (key === "\r" || key === "\n") {
+            showingSkillMenu = false;
+            showingItemMenu = false;
             const adv = currentAdventureDef;
             if (!adv)
                 return;
@@ -1255,32 +1388,60 @@ function handleCombatInput(key) {
         redraw();
         return;
     }
-    switch (key) {
-        case "1": // Attack
-            activeAdventure = { ...activeAdventure, combat: (0, combat_1.playerAttack)(combat) };
-            break;
-        case "2": // Skill menu
-            showingSkillMenu = true;
-            break;
-        case "3": // Item (use potion/food from inventory mid-combat)
-            // Simple: use first medicine in inventory
-            const medicine = buddyState.inventory.find((s) => {
-                const item = (0, items_1.getItem)(s.itemId);
-                return item?.type === "medicine" && s.count > 0;
-            });
-            if (medicine) {
-                const item = (0, items_1.getItem)(medicine.itemId);
+    if (showingItemMenu) {
+        const combatItems = (0, combatUI_1.getCombatItems)(buddyState.inventory);
+        if (key === "\x1b") {
+            showingItemMenu = false;
+            redraw();
+            return;
+        }
+        if (key === "\x1b[A") {
+            // Arrow up
+            if (combatItems.length > 0) {
+                itemMenuIndex = itemMenuIndex <= 0 ? combatItems.length - 1 : itemMenuIndex - 1;
+            }
+            redraw();
+            return;
+        }
+        if (key === "\x1b[B") {
+            // Arrow down
+            if (combatItems.length > 0) {
+                itemMenuIndex = itemMenuIndex >= combatItems.length - 1 ? 0 : itemMenuIndex + 1;
+            }
+            redraw();
+            return;
+        }
+        if (key === "\r" || key === "\n") {
+            // Use selected item
+            if (combatItems.length > 0 && itemMenuIndex < combatItems.length) {
+                const chosen = combatItems[itemMenuIndex];
+                const item = (0, items_1.getItem)(chosen.slot.itemId);
                 const healAmount = item.statEffect.health ?? 0;
                 const newHp = Math.min(combat.playerStats.maxHp, combat.playerStats.hp + healAmount);
                 activeAdventure = {
                     ...activeAdventure,
                     combat: { ...combat, playerStats: { ...combat.playerStats, hp: newHp }, phase: "player_animate", log: [...combat.log, `Used ${item.name}! +${healAmount} HP`], ticksInPhase: 0 },
                 };
-                buddyState = { ...buddyState, inventory: buddyState.inventory.map((s) => s.itemId === medicine.itemId ? { ...s, count: s.count - 1 } : s).filter((s) => s.count > 0) };
-            }
-            else {
-                activeAdventure = { ...activeAdventure, combat: { ...combat, log: [...combat.log, "No medicine in inventory!"] } };
+                buddyState = { ...buddyState, inventory: buddyState.inventory.map((s) => s.itemId === chosen.slot.itemId ? { ...s, count: s.count - 1 } : s).filter((s) => s.count > 0) };
+                showingItemMenu = false;
             }
+            redraw();
+            return;
+        }
+        return;
+    }
+    switch (key) {
+        case "1": // Attack
+            activeAdventure = { ...activeAdventure, combat: (0, combat_1.playerAttack)(combat) };
+            break;
+        case "2": // Skill menu
+            showingSkillMenu = true;
+            showingItemMenu = false;
+            break;
+        case "3": // Item menu
+            showingItemMenu = true;
+            showingSkillMenu = false;
+            itemMenuIndex = 0;
             break;
         case "4": // Defend
             activeAdventure = { ...activeAdventure, combat: (0, combat_1.playerDefend)(combat) };
@@ -1493,21 +1654,32 @@ function handleOverlayInput(key) {
             return;
         }
         else if (overlay.type === "shop") {
-            // Buy selected item
+            // Buy selected item — with confirmation
             const shopItem = shop_1.SHOP_ITEMS[overlay.scrollIndex];
             if (shopItem) {
-                const result = (0, progress_1.spendGold)(buddyState, shopItem.price);
-                if (result) {
-                    buddyState = { ...result, inventory: (0, items_1.addItemToInventory)(result.inventory, shopItem.itemId) };
-                    (0, save_1.saveState)(buddyState);
-                    const item = (0, items_1.getItem)(shopItem.itemId);
-                    showFeedback(`Bought ${item?.name ?? shopItem.itemId}! (-${shopItem.price}g)`);
+                const item = (0, items_1.getItem)(shopItem.itemId);
+                const gold = buddyState.questProgress.gold;
+                if (gold < shopItem.price) {
+                    showFeedback("Not enough gold!");
                 }
                 else {
-                    showFeedback("Not enough gold!");
+                    const itemName = item?.name ?? shopItem.itemId;
+                    overlay = (0, overlayUI_1.createOverlay)();
+                    pendingConfirmation = {
+                        message: `Buy ${itemName} for ${shopItem.price}g? (Gold: ${gold} → ${gold - shopItem.price})`,
+                        onConfirm: () => {
+                            if (!buddyState)
+                                return;
+                            const result = (0, progress_1.spendGold)(buddyState, shopItem.price);
+                            if (result) {
+                                buddyState = { ...result, inventory: (0, items_1.addItemToInventory)(result.inventory, shopItem.itemId) };
+                                (0, save_1.saveState)(buddyState);
+                                showFeedback(`Bought ${itemName}! (-${shopItem.price}g)`);
+                            }
+                        },
+                    };
                 }
             }
-            // Stay in shop
             redraw();
             return;
         }
@@ -1629,6 +1801,8 @@ async function main() {
     }, 4000);
     // Load settings
     (0, settings_1.loadSettings)();
+    // Enter alternate screen buffer (no scrollback pollution)
+    screen.enterAltScreen();
     // Handle clean exit
     process.on("SIGINT", shutdown);
     process.on("SIGTERM", shutdown);

package/dist/rendering/commandPalette.d.ts

@@ -12,5 +12,10 @@ export declare function openPalette(palette: PaletteState): PaletteState;
 export declare function updateFilter(palette: PaletteState, filter: string): PaletteState;
 export declare function moveSelection(palette: PaletteState, delta: number): PaletteState;
 export declare function getSelectedCommand(palette: PaletteState): string | null;
-export declare function renderPalette(palette: PaletteState): string[];
+export declare function renderPalette(palette: PaletteState, stats?: {
+    hunger: number;
+    happiness: number;
+    health: number;
+    energy: number;
+}): string[];
 //# sourceMappingURL=commandPalette.d.ts.map

package/dist/rendering/commandPalette.js

@@ -27,8 +27,9 @@ function openPalette(palette) {
 }
 function updateFilter(palette, filter) {
     const all = (0, registry_1.getAllCommands)().map((c) => ({ name: c.name, description: c.description }));
+    const lowerFilter = filter.toLowerCase();
     const filtered = filter
-        ? all.filter((c) => c.name.toLowerCase().startsWith(filter.toLowerCase()))
+        ? all.filter((c) => c.name.toLowerCase().includes(lowerFilter))
         : all;
     return {
         ...palette,
@@ -53,9 +54,17 @@ function getSelectedCommand(palette) {
         return null;
     return palette.filteredCommands[palette.selectedIndex].name;
 }
-function renderPalette(palette) {
+function renderPalette(palette, stats) {
     const lines = [];
     lines.push(`  ${screen_1.ansi.dim}${"─".repeat(40)}${screen_1.ansi.reset}`);
+    if (stats) {
+        const fmt = (val, label) => {
+            const color = val > 60 ? screen_1.ansi.colors.green : val > 30 ? screen_1.ansi.colors.yellow : screen_1.ansi.colors.red;
+            return `${color}${label}:${Math.round(val)}%${screen_1.ansi.reset}`;
+        };
+        lines.push(`  ${fmt(stats.hunger, "Hun")} ${fmt(stats.happiness, "Hap")} ${fmt(stats.health, "HP")} ${fmt(stats.energy, "Eng")}`);
+        lines.push(`  ${screen_1.ansi.dim}${"─".repeat(40)}${screen_1.ansi.reset}`);
+    }
     if (palette.filteredCommands.length === 0) {
         lines.push(`  ${screen_1.ansi.dim}  No matching commands${screen_1.ansi.reset}`);
     }

package/dist/rendering/display.js

@@ -10,6 +10,7 @@ const titles_1 = require("../buddy/titles");
 const items_1 = require("./items");
 const scene_1 = require("./scene");
 const screen_1 = require("./screen");
+const updates_1 = require("../updates");
 function statBar(value, label, width = 20) {
     const filled = Math.round((value / 100) * width);
     const empty = width - filled;
@@ -36,7 +37,7 @@ function renderMainScreen(state, frame, message, dialogue, dialogueSource) {
     const lines = [];
     // Header bar
     lines.push("");
-    lines.push(`  ${screen_1.ansi.bold}CLI Buddy${screen_1.ansi.reset}  ${screen_1.ansi.dim}v0.1${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.bold}CLI Buddy${screen_1.ansi.reset}  ${screen_1.ansi.dim}v${updates_1.CURRENT_VERSION}${screen_1.ansi.reset}`);
     lines.push(`  ${screen_1.ansi.dim}${"─".repeat(40)}${screen_1.ansi.reset}`);
     if (!state.alive) {
         lines.push("");
@@ -71,6 +72,17 @@ function renderMainScreen(state, frame, message, dialogue, dialogueSource) {
     else if (state.stats.happiness < 30 && species.animations.sad) {
         animKey = "sad";
     }
+    // Status tag for distressed states
+    const STATUS_TAGS = {
+        sick: `${screen_1.ansi.colors.red}[SICK]${screen_1.ansi.reset}`,
+        hungry: `${screen_1.ansi.colors.yellow}[HUNGRY]${screen_1.ansi.reset}`,
+        tired: `${screen_1.ansi.colors.blue}[TIRED]${screen_1.ansi.reset}`,
+        sad: `${screen_1.ansi.colors.magenta}[SAD]${screen_1.ansi.reset}`,
+    };
+    const statusTag = STATUS_TAGS[animKey];
+    if (statusTag) {
+        lines.push(`  ${statusTag}`);
+    }
     const frames = species.animations[animKey] ?? species.animations.idle;
     const frameIndex = frame % frames.length;
     const buddyArtLines = frames[frameIndex].split("\n");
@@ -124,7 +136,7 @@ function renderMainScreen(state, frame, message, dialogue, dialogueSource) {
 function renderRollScreen(phase, speciesName, speciesArt, rarityColor, rarityLabel) {
     const lines = [];
     lines.push("");
-    lines.push(`  ${screen_1.ansi.bold}CLI Buddy${screen_1.ansi.reset}  ${screen_1.ansi.dim}v0.1${screen_1.ansi.reset}`);
+    lines.push(`  ${screen_1.ansi.bold}CLI Buddy${screen_1.ansi.reset}  ${screen_1.ansi.dim}v${updates_1.CURRENT_VERSION}${screen_1.ansi.reset}`);
     lines.push(`  ${screen_1.ansi.dim}${"─".repeat(40)}${screen_1.ansi.reset}`);
     lines.push("");
     if (phase === "waiting") {

package/dist/rendering/inventoryUI.d.ts

@@ -1,4 +1,4 @@
-import { InventorySlot } from "../buddy/types";
+import { BuddyStats, InventorySlot } from "../buddy/types";
 export interface InventoryUIState {
     active: boolean;
     tab: "consumables" | "gear";
@@ -10,5 +10,5 @@ export declare function openInventoryUI(slots: InventorySlot[]): InventoryUIStat
 export declare function switchInventoryTab(ui: InventoryUIState): InventoryUIState;
 export declare function moveInventorySelection(ui: InventoryUIState, delta: number): InventoryUIState;
 export declare function getSelectedSlot(ui: InventoryUIState): InventorySlot | null;
-export declare function renderInventoryUI(ui: InventoryUIState, equippedWeapon?: string, equippedArmor?: string, equippedHelmet?: string, equippedBoots?: string, equippedAccessory?: string, gold?: number): string[];
+export declare function renderInventoryUI(ui: InventoryUIState, equippedWeapon?: string, equippedArmor?: string, equippedHelmet?: string, equippedBoots?: string, equippedAccessory?: string, gold?: number, buddyStats?: BuddyStats): string[];
 //# sourceMappingURL=inventoryUI.d.ts.map

package/dist/rendering/inventoryUI.js

@@ -36,7 +36,7 @@ function getSelectedSlot(ui) {
         return null;
     return filtered[ui.selectedIndex] ?? null;
 }
-function renderInventoryUI(ui, equippedWeapon, equippedArmor, equippedHelmet, equippedBoots, equippedAccessory, gold) {
+function renderInventoryUI(ui, equippedWeapon, equippedArmor, equippedHelmet, equippedBoots, equippedAccessory, gold, buddyStats) {
     const lines = [];
     lines.push(`  ${screen_1.ansi.dim}${"─".repeat(48)}${screen_1.ansi.reset}`);
     // Tab bar + gold
@@ -80,6 +80,19 @@ function renderInventoryUI(ui, equippedWeapon, equippedArmor, equippedHelmet, eq
                 // Consumables: show count, description
                 if (selected) {
                     lines.push(`  ${pointer} ${rarityColor}${screen_1.ansi.bold}${item.name}${screen_1.ansi.reset} x${slot.count}  ${screen_1.ansi.dim}${item.description}${screen_1.ansi.reset}`);
+                    // Preview stat outcome
+                    if (buddyStats && item.statEffect) {
+                        const previews = [];
+                        const STAT_LABELS = { hunger: "Hunger", happiness: "Happiness", health: "Health", energy: "Energy" };
+                        for (const [key, delta] of Object.entries(item.statEffect)) {
+                            const current = Math.round(buddyStats[key]);
+                            const after = Math.min(100, Math.round(buddyStats[key] + delta));
+                            previews.push(`${STAT_LABELS[key] ?? key}: ${current}%→${after}%`);
+                        }
+                        if (previews.length > 0) {
+                            lines.push(`    ${screen_1.ansi.colors.green}→ ${previews.join(", ")}${screen_1.ansi.reset}`);
+                        }
+                    }
                 }
                 else {
                     lines.push(`  ${pointer} ${screen_1.ansi.dim}${item.name} x${slot.count}${screen_1.ansi.reset}`);

package/dist/rendering/screen.d.ts

@@ -1,7 +1,7 @@
 /**
  * Full-screen terminal renderer.
- * Owns the entire terminal — clears and redraws each frame.
- * No scrolling, no message spam.
+ * Uses the alternate screen buffer so nothing leaks into scrollback.
+ * Redraws by moving to home and overwriting — no clear, no flicker.
  */
 export declare const ansi: {
     clearScreen: string;
@@ -9,6 +9,7 @@ export declare const ansi: {
     showCursor: string;
     moveTo: (row: number, col: number) => string;
     eraseDown: string;
+    eraseLine: string;
     bold: string;
     dim: string;
     reset: string;
@@ -22,6 +23,8 @@ export declare const ansi: {
         white: string;
         gray: string;
     };
+    altScreenOn: string;
+    altScreenOff: string;
 };
 export declare class Screen {
     private regions;
@@ -30,7 +33,9 @@ export declare class Screen {
     private width;
     private height;
     constructor();
-    /** Replace all content and redraw */
+    /** Enter alternate screen buffer and hide cursor */
+    enterAltScreen(): void;
+    /** Replace all content and redraw — no clear, just overwrite in place */
     draw(content: string, footer?: string): void;
     /** Update just the input line at the bottom without full redraw */
     drawInputLine(input: string): void;

package/dist/rendering/screen.js

@@ -1,8 +1,8 @@
 "use strict";
 /**
  * Full-screen terminal renderer.
- * Owns the entire terminal — clears and redraws each frame.
- * No scrolling, no message spam.
+ * Uses the alternate screen buffer so nothing leaks into scrollback.
+ * Redraws by moving to home and overwriting — no clear, no flicker.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Screen = exports.ansi = void 0;
@@ -13,6 +13,7 @@ exports.ansi = {
     showCursor: `${ESC}[?25h`,
     moveTo: (row, col) => `${ESC}[${row};${col}H`,
     eraseDown: `${ESC}[J`,
+    eraseLine: `${ESC}[2K`,
     bold: `${ESC}[1m`,
     dim: `${ESC}[2m`,
     reset: `${ESC}[0m`,
@@ -26,6 +27,9 @@ exports.ansi = {
         white: `${ESC}[37m`,
         gray: `${ESC}[90m`,
     },
+    // Alternate screen buffer
+    altScreenOn: `${ESC}[?1049h`,
+    altScreenOff: `${ESC}[?1049l`,
 };
 class Screen {
     regions = [];
@@ -41,20 +45,40 @@ class Screen {
             this.height = process.stdout.rows || 24;
         });
     }
-    /** Replace all content and redraw */
+    /** Enter alternate screen buffer and hide cursor */
+    enterAltScreen() {
+        process.stdout.write(exports.ansi.altScreenOn);
+        process.stdout.write(exports.ansi.hideCursor);
+    }
+    /** Replace all content and redraw — no clear, just overwrite in place */
     draw(content, footer) {
         const out = process.stdout;
         out.write(exports.ansi.hideCursor);
-        out.write(exports.ansi.clearScreen);
-        out.write(content);
+        // Move to top-left and write content
+        out.write(`${ESC}[H`);
+        // Split content into lines and write each, padding to full width to overwrite old content
+        const contentLines = content.split("\n");
+        const maxContentRow = this.height - 2; // leave 2 rows for footer + input
+        for (let i = 0; i < maxContentRow; i++) {
+            out.write(exports.ansi.moveTo(i + 1, 1));
+            out.write(exports.ansi.eraseLine);
+            if (i < contentLines.length) {
+                out.write(contentLines[i]);
+            }
+        }
+        // Draw footer at bottom - 1
         if (footer) {
-            // Draw footer at bottom
             out.write(exports.ansi.moveTo(this.height - 1, 1));
+            out.write(exports.ansi.eraseLine);
             out.write(footer);
         }
-        // Position cursor at input line
+        else {
+            out.write(exports.ansi.moveTo(this.height - 1, 1));
+            out.write(exports.ansi.eraseLine);
+        }
+        // Position cursor at input line (bottom row)
         out.write(exports.ansi.moveTo(this.height, 1));
-        out.write(exports.ansi.eraseDown);
+        out.write(exports.ansi.eraseLine);
         out.write(this.inputLine);
         out.write(exports.ansi.showCursor);
     }
@@ -63,7 +87,7 @@ class Screen {
         this.inputLine = input;
         const out = process.stdout;
         out.write(exports.ansi.moveTo(this.height, 1));
-        out.write("\x1b[2K"); // erase line
+        out.write(exports.ansi.eraseLine);
         out.write(input);
     }
     /** Draw an overlay (command palette) over the bottom portion of the screen */
@@ -73,12 +97,12 @@ class Screen {
         // Draw overlay lines
         for (let i = 0; i < lines.length; i++) {
             out.write(exports.ansi.moveTo(startRow + i, 1));
-            out.write("\x1b[2K"); // erase line
+            out.write(exports.ansi.eraseLine);
             out.write(lines[i]);
         }
         // Draw input line at bottom
         out.write(exports.ansi.moveTo(this.height, 1));
-        out.write("\x1b[2K");
+        out.write(exports.ansi.eraseLine);
         out.write(inputLine);
         out.write(exports.ansi.showCursor);
     }
@@ -90,7 +114,7 @@ class Screen {
     }
     cleanup() {
         process.stdout.write(exports.ansi.showCursor);
-        process.stdout.write(exports.ansi.clearScreen);
+        process.stdout.write(exports.ansi.altScreenOff);
     }
 }
 exports.Screen = Screen;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clibuddy",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "A tamagotchi-style virtual pet that lives in your terminal — feed, play, adventure, and battle!",
   "main": "dist/index.js",
   "bin": {
@@ -16,7 +16,7 @@
   ],
   "scripts": {
     "build": "tsc",
-    "dev": "CLIBUDDY_DEV=1 tsx src/index.ts",
+    "dev": "cross-env CLIBUDDY_DEV=1 tsx src/index.ts",
     "start": "node dist/index.js",
     "prepublishOnly": "npm run build",
     "sim": "tsx src/tests/combatSim.ts"
@@ -47,6 +47,7 @@
   "homepage": "https://github.com/ZippyDevlabs/CLIBuddy#readme",
   "devDependencies": {
     "@types/node": "^25.5.0",
+    "cross-env": "^10.1.0",
     "tsx": "^4.21.0",
     "typescript": "^6.0.2"
   }