clibuddy 1.0.0

package/dist/story/types.d.ts

@@ -0,0 +1,61 @@
+import { AdventureDef } from "../adventure/types";
+export interface QuestReward {
+    xp: number;
+    gold: number;
+    items?: string[];
+    titleId?: string;
+}
+export type ActType = "scene" | "exploration" | "dungeon";
+export interface ActDef {
+    id: string;
+    name: string;
+    type: ActType;
+    buildAdventure: () => AdventureDef;
+}
+export interface QuestChapter {
+    id: string;
+    name: string;
+    description: string;
+    prerequisites: string[];
+    levelRequired: number;
+    storyFlag: string;
+    rewards: QuestReward;
+    /** Sequence of acts that make up this chapter */
+    acts: ActDef[];
+}
+export interface QuestChain {
+    id: string;
+    name: string;
+    description: string;
+    type: "main" | "side" | "seasonal";
+    chapters: QuestChapter[];
+}
+export interface SavedAdventureState {
+    adventureId: string;
+    currentRoomId: string;
+    roomsVisited: string[];
+    morale: number;
+    lootCollected: string[];
+    xpEarned: number;
+    battlesWon: number;
+    battlesFled: number;
+    damageTaken: number;
+}
+export interface QuestProgress {
+    completedChapters: string[];
+    activeChain?: string;
+    activeChapter?: string;
+    activeActIndex?: number;
+    savedAdventure?: SavedAdventureState;
+    storyFlags: string[];
+    loreFragments: string[];
+    gold: number;
+}
+export declare function createDefaultQuestProgress(): QuestProgress;
+/** Check if a chapter's prerequisites are met */
+export declare function canStartChapter(chapter: QuestChapter, progress: QuestProgress, level: number): string | null;
+/** Check if a chapter is completed */
+export declare function isChapterComplete(chapterId: string, progress: QuestProgress): boolean;
+/** Check if a story flag is set */
+export declare function hasStoryFlag(flag: string, progress: QuestProgress): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/story/types.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultQuestProgress = createDefaultQuestProgress;
+exports.canStartChapter = canStartChapter;
+exports.isChapterComplete = isChapterComplete;
+exports.hasStoryFlag = hasStoryFlag;
+function createDefaultQuestProgress() {
+    return {
+        completedChapters: [],
+        storyFlags: [],
+        loreFragments: [],
+        gold: 0,
+    };
+}
+/** Check if a chapter's prerequisites are met */
+function canStartChapter(chapter, progress, level) {
+    if (level < chapter.levelRequired)
+        return `Requires level ${chapter.levelRequired}`;
+    for (const prereq of chapter.prerequisites) {
+        if (!progress.completedChapters.includes(prereq)) {
+            return `Requires completing a previous chapter`;
+        }
+    }
+    if (progress.completedChapters.includes(chapter.id))
+        return "Already completed";
+    return null;
+}
+/** Check if a chapter is completed */
+function isChapterComplete(chapterId, progress) {
+    return progress.completedChapters.includes(chapterId);
+}
+/** Check if a story flag is set */
+function hasStoryFlag(flag, progress) {
+    return progress.storyFlags.includes(flag);
+}
+//# sourceMappingURL=types.js.map

package/dist/updates.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Version check and self-update for npm-published CLIBuddy.
+ * Checks the npm registry on startup (non-blocking) and caches the result.
+ */
+export declare const CURRENT_VERSION: string;
+export declare const PACKAGE_NAME: string;
+/**
+ * Non-blocking check against the npm registry.
+ * Resolves silently — never throws, never blocks the app.
+ */
+export declare function checkForUpdates(): void;
+/** Returns an update banner string if an update is available, or null. */
+export declare function getUpdateBanner(): string | null;
+/** Check if an update is available (for use in commands). */
+export declare function isUpdateAvailable(): boolean;
+/** Get the latest version string, or null if not checked yet. */
+export declare function getLatestVersion(): string | null;
+/**
+ * Run the self-update. Returns a message describing what happened.
+ * This is synchronous and will block briefly while npm runs.
+ */
+export declare function runUpdate(): string;
+//# sourceMappingURL=updates.d.ts.map

package/dist/updates.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Version check and self-update for npm-published CLIBuddy.
+ * Checks the npm registry on startup (non-blocking) and caches the result.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PACKAGE_NAME = exports.CURRENT_VERSION = void 0;
+exports.checkForUpdates = checkForUpdates;
+exports.getUpdateBanner = getUpdateBanner;
+exports.isUpdateAvailable = isUpdateAvailable;
+exports.getLatestVersion = getLatestVersion;
+exports.runUpdate = runUpdate;
+const https = __importStar(require("https"));
+const child_process_1 = require("child_process");
+// Read version from package.json at build time
+const PKG = require("../package.json");
+exports.CURRENT_VERSION = PKG.version;
+exports.PACKAGE_NAME = PKG.name;
+let latestVersion = null;
+let updateAvailable = false;
+/**
+ * Non-blocking check against the npm registry.
+ * Resolves silently — never throws, never blocks the app.
+ */
+function checkForUpdates() {
+    const url = `https://registry.npmjs.org/${exports.PACKAGE_NAME}/latest`;
+    const req = https.get(url, { timeout: 3000 }, (res) => {
+        if (res.statusCode !== 200) {
+            res.resume(); // drain
+            return;
+        }
+        let data = "";
+        res.on("data", (chunk) => { data += chunk; });
+        res.on("end", () => {
+            try {
+                const json = JSON.parse(data);
+                if (json.version && json.version !== exports.CURRENT_VERSION) {
+                    latestVersion = json.version;
+                    updateAvailable = isNewer(json.version, exports.CURRENT_VERSION);
+                }
+            }
+            catch {
+                // Silently ignore parse errors
+            }
+        });
+    });
+    req.on("error", () => {
+        // Network error — offline, firewall, etc. Silently ignore.
+    });
+    req.on("timeout", () => {
+        req.destroy();
+    });
+}
+/** Compare semver strings: is `a` newer than `b`? */
+function isNewer(a, b) {
+    const pa = a.split(".").map(Number);
+    const pb = b.split(".").map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((pa[i] ?? 0) > (pb[i] ?? 0))
+            return true;
+        if ((pa[i] ?? 0) < (pb[i] ?? 0))
+            return false;
+    }
+    return false;
+}
+/** Returns an update banner string if an update is available, or null. */
+function getUpdateBanner() {
+    if (!updateAvailable || !latestVersion)
+        return null;
+    return [
+        "",
+        "  \x1b[33m╔══════════════════════════════════════════╗\x1b[0m",
+        `  \x1b[33m║\x1b[0m  CLIBuddy \x1b[1mv${latestVersion}\x1b[0m is available!            \x1b[33m║\x1b[0m`,
+        `  \x1b[33m║\x1b[0m  Current: v${exports.CURRENT_VERSION}                         \x1b[33m║\x1b[0m`,
+        "  \x1b[33m║\x1b[0m  Run \x1b[1m/update\x1b[0m or:                        \x1b[33m║\x1b[0m",
+        `  \x1b[33m║\x1b[0m  \x1b[2mnpm update -g ${exports.PACKAGE_NAME}\x1b[0m              \x1b[33m║\x1b[0m`,
+        "  \x1b[33m╚══════════════════════════════════════════╝\x1b[0m",
+        "",
+    ].join("\n");
+}
+/** Check if an update is available (for use in commands). */
+function isUpdateAvailable() {
+    return updateAvailable;
+}
+/** Get the latest version string, or null if not checked yet. */
+function getLatestVersion() {
+    return latestVersion;
+}
+/**
+ * Run the self-update. Returns a message describing what happened.
+ * This is synchronous and will block briefly while npm runs.
+ */
+function runUpdate() {
+    if (!updateAvailable) {
+        return `CLIBuddy v${exports.CURRENT_VERSION} is already up to date!`;
+    }
+    try {
+        (0, child_process_1.execSync)(`npm update -g ${exports.PACKAGE_NAME}`, { stdio: "pipe", timeout: 60000 });
+        return `Updated to v${latestVersion}! Restart CLIBuddy to use the new version.`;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes("EACCES") || msg.includes("permission")) {
+            return `Permission denied. Try: sudo npm update -g ${exports.PACKAGE_NAME}`;
+        }
+        return `Update failed: ${msg}\nTry manually: npm update -g ${exports.PACKAGE_NAME}`;
+    }
+}
+//# sourceMappingURL=updates.js.map

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "clibuddy",
+  "version": "1.0.0",
+  "description": "A tamagotchi-style virtual pet that lives in your terminal — feed, play, adventure, and battle!",
+  "main": "dist/index.js",
+  "bin": {
+    "clibuddy": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "!dist/tests/**",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "CLIBUDDY_DEV=1 tsx src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "sim": "tsx src/tests/combatSim.ts"
+  },
+  "keywords": [
+    "cli",
+    "tamagotchi",
+    "virtual-pet",
+    "terminal",
+    "ascii-art",
+    "game",
+    "rpg",
+    "adventure"
+  ],
+  "author": "Zippy",
+  "license": "MIT",
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ZippyDevlabs/CLIBuddy"
+  },
+  "bugs": {
+    "url": "https://github.com/ZippyDevlabs/CLIBuddy/issues"
+  },
+  "homepage": "https://github.com/ZippyDevlabs/CLIBuddy#readme",
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2"
+  }
+}