brainrot-cli 0.1.0

package/dist/ralph-loop-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph-loop-parser.js","sourceRoot":"","sources":["../src/ralph-loop-parser.ts"],"names":[],"mappings":"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"}

package/dist/stats.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Stats and Achievement System
+ *
+ * Tracks gameplay statistics and provides an achievement system with
+ * unlockable milestones. Data persists using XDG Base Directory conventions.
+ */
+/** Stats for a single game */
+export interface GameStats {
+    /** Total games played */
+    gamesPlayed: number;
+    /** Total time played in seconds */
+    timePlayed: number;
+    /** Highest score achieved */
+    highestScore: number;
+    /** Total score accumulated across all games */
+    totalScore: number;
+    /** Number of wins (for games with win conditions) */
+    wins: number;
+    /** Number of losses */
+    losses: number;
+    /** Last played timestamp */
+    lastPlayed: string | null;
+    /** Game-specific stats */
+    custom?: Record<string, number>;
+}
+/** Global stats across all games */
+export interface GlobalStats {
+    /** Total games played across all games */
+    totalGamesPlayed: number;
+    /** Total time played in seconds */
+    totalTimePlayed: number;
+    /** Total achievements unlocked */
+    achievementsUnlocked: number;
+    /** First played timestamp */
+    firstPlayed: string | null;
+    /** Last played timestamp */
+    lastPlayed: string | null;
+    /** Session count (app opens) */
+    sessionCount: number;
+    /** Current streak (consecutive days played) */
+    currentStreak: number;
+    /** Best streak */
+    bestStreak: number;
+    /** Last streak date */
+    lastStreakDate: string | null;
+}
+/** Achievement definition */
+export interface Achievement {
+    /** Unique identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Description of how to unlock */
+    description: string;
+    /** Category of achievement */
+    category: "general" | "snake" | "pong" | "tetris" | "minesweeper";
+    /** Icon to display */
+    icon: string;
+    /** Whether this achievement is hidden until unlocked */
+    hidden?: boolean;
+    /** Condition check function - receives stats and returns true if unlocked */
+    condition: (stats: StatsData) => boolean;
+}
+/** Unlocked achievement record */
+export interface UnlockedAchievement {
+    /** Achievement ID */
+    id: string;
+    /** Timestamp when unlocked */
+    unlockedAt: string;
+}
+/** Complete stats data structure */
+export interface StatsData {
+    /** Data format version */
+    version: number;
+    /** Global stats */
+    global: GlobalStats;
+    /** Per-game stats */
+    games: Record<string, GameStats>;
+    /** Unlocked achievements */
+    achievements: UnlockedAchievement[];
+}
+export declare const ACHIEVEMENTS: Achievement[];
+/**
+ * Load stats from disk
+ */
+export declare function loadStats(): Promise<StatsData>;
+/**
+ * Save stats to disk
+ */
+export declare function saveStats(data: StatsData): Promise<void>;
+/**
+ * Get stats for a specific game
+ */
+export declare function getGameStats(gameId: string): Promise<GameStats>;
+/**
+ * Get global stats
+ */
+export declare function getGlobalStats(): Promise<GlobalStats>;
+/**
+ * Record a game session
+ */
+export declare function recordGameSession(gameId: string, score: number, duration: number, won?: boolean, customStats?: Record<string, number>): Promise<string[]>;
+/**
+ * Record a session start (increment session count)
+ */
+export declare function recordSessionStart(): Promise<void>;
+/**
+ * Check for newly unlocked achievements
+ * Returns array of newly unlocked achievement IDs
+ */
+export declare function checkAchievements(data: StatsData): string[];
+/**
+ * Get all achievements with unlock status
+ */
+export declare function getAchievements(): Promise<Array<Achievement & {
+    unlocked: boolean;
+    unlockedAt: string | null;
+}>>;
+/**
+ * Get achievement by ID
+ */
+export declare function getAchievementById(id: string): Achievement | undefined;
+/**
+ * Get achievement count
+ */
+export declare function getAchievementCount(): Promise<{
+    unlocked: number;
+    total: number;
+}>;
+/**
+ * Get all stats data
+ */
+export declare function getAllStats(): Promise<StatsData>;
+/**
+ * Format duration in seconds to human-readable string
+ */
+export declare function formatDuration(seconds: number): string;
+/**
+ * Format a date string for display
+ */
+export declare function formatStatsDate(timestamp: string | null): string;
+//# sourceMappingURL=stats.d.ts.map

package/dist/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"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"}

package/dist/stats.js

@@ -0,0 +1,521 @@
+/**
+ * Stats and Achievement System
+ *
+ * Tracks gameplay statistics and provides an achievement system with
+ * unlockable milestones. Data persists using XDG Base Directory conventions.
+ */
+import { readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { getDataFilePath, ensureDataDir } from "./config.js";
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+const DATA_VERSION = 1;
+const STATS_FILE = "stats.json";
+/** Default empty game stats */
+const DEFAULT_GAME_STATS = {
+    gamesPlayed: 0,
+    timePlayed: 0,
+    highestScore: 0,
+    totalScore: 0,
+    wins: 0,
+    losses: 0,
+    lastPlayed: null,
+};
+/** Default global stats */
+const DEFAULT_GLOBAL_STATS = {
+    totalGamesPlayed: 0,
+    totalTimePlayed: 0,
+    achievementsUnlocked: 0,
+    firstPlayed: null,
+    lastPlayed: null,
+    sessionCount: 0,
+    currentStreak: 0,
+    bestStreak: 0,
+    lastStreakDate: null,
+};
+// ============================================================================
+// ACHIEVEMENT DEFINITIONS
+// ============================================================================
+export const ACHIEVEMENTS = [
+    // General achievements
+    {
+        id: "first_game",
+        name: "First Steps",
+        description: "Play your first game",
+        category: "general",
+        icon: "🎮",
+        condition: (stats) => stats.global.totalGamesPlayed >= 1,
+    },
+    {
+        id: "ten_games",
+        name: "Getting Started",
+        description: "Play 10 games",
+        category: "general",
+        icon: "🎯",
+        condition: (stats) => stats.global.totalGamesPlayed >= 10,
+    },
+    {
+        id: "fifty_games",
+        name: "Dedicated Player",
+        description: "Play 50 games",
+        category: "general",
+        icon: "⭐",
+        condition: (stats) => stats.global.totalGamesPlayed >= 50,
+    },
+    {
+        id: "hundred_games",
+        name: "Game Master",
+        description: "Play 100 games",
+        category: "general",
+        icon: "🏆",
+        condition: (stats) => stats.global.totalGamesPlayed >= 100,
+    },
+    {
+        id: "hour_played",
+        name: "Time Flies",
+        description: "Play for a total of 1 hour",
+        category: "general",
+        icon: "⏰",
+        condition: (stats) => stats.global.totalTimePlayed >= 3600,
+    },
+    {
+        id: "five_hours",
+        name: "Marathon Runner",
+        description: "Play for a total of 5 hours",
+        category: "general",
+        icon: "🏃",
+        condition: (stats) => stats.global.totalTimePlayed >= 18000,
+    },
+    {
+        id: "three_day_streak",
+        name: "Consistent",
+        description: "Play 3 days in a row",
+        category: "general",
+        icon: "🔥",
+        condition: (stats) => stats.global.bestStreak >= 3,
+    },
+    {
+        id: "week_streak",
+        name: "Dedicated",
+        description: "Play 7 days in a row",
+        category: "general",
+        icon: "📅",
+        condition: (stats) => stats.global.bestStreak >= 7,
+    },
+    {
+        id: "all_games",
+        name: "Variety Pack",
+        description: "Play all 4 games at least once",
+        category: "general",
+        icon: "🎲",
+        condition: (stats) => {
+            const games = ["snake", "pong", "tetris", "minesweeper"];
+            return games.every((g) => (stats.games[g]?.gamesPlayed ?? 0) >= 1);
+        },
+    },
+    // Snake achievements
+    {
+        id: "snake_first",
+        name: "Slithering Start",
+        description: "Play your first Snake game",
+        category: "snake",
+        icon: "🐍",
+        condition: (stats) => (stats.games.snake?.gamesPlayed ?? 0) >= 1,
+    },
+    {
+        id: "snake_50_score",
+        name: "Growing Snake",
+        description: "Score 50 points in Snake",
+        category: "snake",
+        icon: "📈",
+        condition: (stats) => (stats.games.snake?.highestScore ?? 0) >= 50,
+    },
+    {
+        id: "snake_100_score",
+        name: "Long Snake",
+        description: "Score 100 points in Snake",
+        category: "snake",
+        icon: "🏅",
+        condition: (stats) => (stats.games.snake?.highestScore ?? 0) >= 100,
+    },
+    {
+        id: "snake_200_score",
+        name: "Snake Charmer",
+        description: "Score 200 points in Snake",
+        category: "snake",
+        icon: "👑",
+        condition: (stats) => (stats.games.snake?.highestScore ?? 0) >= 200,
+    },
+    {
+        id: "snake_10_games",
+        name: "Snake Enthusiast",
+        description: "Play Snake 10 times",
+        category: "snake",
+        icon: "🎮",
+        condition: (stats) => (stats.games.snake?.gamesPlayed ?? 0) >= 10,
+    },
+    // Pong achievements
+    {
+        id: "pong_first",
+        name: "Paddle Ready",
+        description: "Play your first Pong game",
+        category: "pong",
+        icon: "🏓",
+        condition: (stats) => (stats.games.pong?.gamesPlayed ?? 0) >= 1,
+    },
+    {
+        id: "pong_first_win",
+        name: "First Victory",
+        description: "Win your first Pong game",
+        category: "pong",
+        icon: "✌️",
+        condition: (stats) => (stats.games.pong?.wins ?? 0) >= 1,
+    },
+    {
+        id: "pong_10_wins",
+        name: "Pong Champion",
+        description: "Win 10 Pong games",
+        category: "pong",
+        icon: "🥇",
+        condition: (stats) => (stats.games.pong?.wins ?? 0) >= 10,
+    },
+    {
+        id: "pong_50_wins",
+        name: "Pong Master",
+        description: "Win 50 Pong games",
+        category: "pong",
+        icon: "🏆",
+        condition: (stats) => (stats.games.pong?.wins ?? 0) >= 50,
+    },
+    // Tetris achievements
+    {
+        id: "tetris_first",
+        name: "Block Party",
+        description: "Play your first Tetris game",
+        category: "tetris",
+        icon: "🧱",
+        condition: (stats) => (stats.games.tetris?.gamesPlayed ?? 0) >= 1,
+    },
+    {
+        id: "tetris_1000_score",
+        name: "Stacking Up",
+        description: "Score 1000 points in Tetris",
+        category: "tetris",
+        icon: "📊",
+        condition: (stats) => (stats.games.tetris?.highestScore ?? 0) >= 1000,
+    },
+    {
+        id: "tetris_5000_score",
+        name: "Tetris Pro",
+        description: "Score 5000 points in Tetris",
+        category: "tetris",
+        icon: "🌟",
+        condition: (stats) => (stats.games.tetris?.highestScore ?? 0) >= 5000,
+    },
+    {
+        id: "tetris_10000_score",
+        name: "Tetris Legend",
+        description: "Score 10000 points in Tetris",
+        category: "tetris",
+        icon: "💎",
+        condition: (stats) => (stats.games.tetris?.highestScore ?? 0) >= 10000,
+    },
+    {
+        id: "tetris_lines_cleared",
+        name: "Line Clearer",
+        description: "Clear 100 lines in Tetris",
+        category: "tetris",
+        icon: "📏",
+        condition: (stats) => (stats.games.tetris?.custom?.linesCleared ?? 0) >= 100,
+    },
+    // Minesweeper achievements
+    {
+        id: "minesweeper_first",
+        name: "Mine Explorer",
+        description: "Play your first Minesweeper game",
+        category: "minesweeper",
+        icon: "💣",
+        condition: (stats) => (stats.games.minesweeper?.gamesPlayed ?? 0) >= 1,
+    },
+    {
+        id: "minesweeper_first_win",
+        name: "Bomb Defuser",
+        description: "Win your first Minesweeper game",
+        category: "minesweeper",
+        icon: "🛡️",
+        condition: (stats) => (stats.games.minesweeper?.wins ?? 0) >= 1,
+    },
+    {
+        id: "minesweeper_10_wins",
+        name: "Mine Sweeper",
+        description: "Win 10 Minesweeper games",
+        category: "minesweeper",
+        icon: "🎖️",
+        condition: (stats) => (stats.games.minesweeper?.wins ?? 0) >= 10,
+    },
+    {
+        id: "minesweeper_fast",
+        name: "Speed Demon",
+        description: "Complete Minesweeper in under 60 seconds",
+        category: "minesweeper",
+        icon: "⚡",
+        condition: (stats) => (stats.games.minesweeper?.custom?.fastestWin ?? 999) < 60,
+    },
+];
+// ============================================================================
+// FILE OPERATIONS
+// ============================================================================
+function getStatsFile() {
+    return getDataFilePath(STATS_FILE);
+}
+function createEmptyStats() {
+    return {
+        version: DATA_VERSION,
+        global: { ...DEFAULT_GLOBAL_STATS },
+        games: {},
+        achievements: [],
+    };
+}
+/**
+ * Load stats from disk
+ */
+export async function loadStats() {
+    try {
+        const statsFile = getStatsFile();
+        if (!existsSync(statsFile)) {
+            return createEmptyStats();
+        }
+        const content = await readFile(statsFile, "utf-8");
+        const data = JSON.parse(content);
+        if (data.version !== DATA_VERSION) {
+            return createEmptyStats();
+        }
+        return data;
+    }
+    catch {
+        return createEmptyStats();
+    }
+}
+/**
+ * Save stats to disk
+ */
+export async function saveStats(data) {
+    try {
+        await ensureDataDir();
+        const statsFile = getStatsFile();
+        await writeFile(statsFile, JSON.stringify(data, null, 2), "utf-8");
+    }
+    catch {
+        // Silently fail - stats are nice to have but not critical
+    }
+}
+// ============================================================================
+// STATS OPERATIONS
+// ============================================================================
+/**
+ * Get stats for a specific game
+ */
+export async function getGameStats(gameId) {
+    const data = await loadStats();
+    return data.games[gameId] ?? { ...DEFAULT_GAME_STATS };
+}
+/**
+ * Get global stats
+ */
+export async function getGlobalStats() {
+    const data = await loadStats();
+    return data.global;
+}
+/**
+ * Update streak based on today's date
+ */
+function updateStreak(stats) {
+    const today = new Date().toISOString().split("T")[0];
+    const lastDate = stats.global.lastStreakDate;
+    if (!lastDate) {
+        // First time playing
+        stats.global.currentStreak = 1;
+        stats.global.bestStreak = 1;
+        stats.global.lastStreakDate = today;
+    }
+    else if (lastDate === today) {
+        // Already played today, no change
+    }
+    else {
+        // Check if yesterday
+        const yesterday = new Date();
+        yesterday.setDate(yesterday.getDate() - 1);
+        const yesterdayStr = yesterday.toISOString().split("T")[0];
+        if (lastDate === yesterdayStr) {
+            // Consecutive day
+            stats.global.currentStreak++;
+            if (stats.global.currentStreak > stats.global.bestStreak) {
+                stats.global.bestStreak = stats.global.currentStreak;
+            }
+        }
+        else {
+            // Streak broken
+            stats.global.currentStreak = 1;
+        }
+        stats.global.lastStreakDate = today;
+    }
+}
+/**
+ * Record a game session
+ */
+export async function recordGameSession(gameId, score, duration, won, customStats) {
+    const data = await loadStats();
+    const now = new Date().toISOString();
+    // Initialize game stats if needed
+    if (!data.games[gameId]) {
+        data.games[gameId] = { ...DEFAULT_GAME_STATS };
+    }
+    const gameStats = data.games[gameId];
+    // Update game stats
+    gameStats.gamesPlayed++;
+    gameStats.timePlayed += duration;
+    gameStats.totalScore += score;
+    if (score > gameStats.highestScore) {
+        gameStats.highestScore = score;
+    }
+    if (won !== undefined) {
+        if (won) {
+            gameStats.wins++;
+        }
+        else {
+            gameStats.losses++;
+        }
+    }
+    gameStats.lastPlayed = now;
+    // Merge custom stats
+    if (customStats) {
+        if (!gameStats.custom) {
+            gameStats.custom = {};
+        }
+        for (const [key, value] of Object.entries(customStats)) {
+            gameStats.custom[key] = (gameStats.custom[key] ?? 0) + value;
+        }
+    }
+    // Update global stats
+    data.global.totalGamesPlayed++;
+    data.global.totalTimePlayed += duration;
+    if (!data.global.firstPlayed) {
+        data.global.firstPlayed = now;
+    }
+    data.global.lastPlayed = now;
+    // Update streak
+    updateStreak(data);
+    // Check for new achievements
+    const newAchievements = checkAchievements(data);
+    // Save
+    await saveStats(data);
+    return newAchievements;
+}
+/**
+ * Record a session start (increment session count)
+ */
+export async function recordSessionStart() {
+    const data = await loadStats();
+    data.global.sessionCount++;
+    await saveStats(data);
+}
+// ============================================================================
+// ACHIEVEMENT OPERATIONS
+// ============================================================================
+/**
+ * Check for newly unlocked achievements
+ * Returns array of newly unlocked achievement IDs
+ */
+export function checkAchievements(data) {
+    const newUnlocks = [];
+    const unlockedIds = new Set(data.achievements.map((a) => a.id));
+    for (const achievement of ACHIEVEMENTS) {
+        if (!unlockedIds.has(achievement.id) && achievement.condition(data)) {
+            newUnlocks.push(achievement.id);
+            data.achievements.push({
+                id: achievement.id,
+                unlockedAt: new Date().toISOString(),
+            });
+        }
+    }
+    // Update achievement count
+    data.global.achievementsUnlocked = data.achievements.length;
+    return newUnlocks;
+}
+/**
+ * Get all achievements with unlock status
+ */
+export async function getAchievements() {
+    const data = await loadStats();
+    const unlockedMap = new Map(data.achievements.map((a) => [a.id, a.unlockedAt]));
+    return ACHIEVEMENTS.map((achievement) => ({
+        ...achievement,
+        unlocked: unlockedMap.has(achievement.id),
+        unlockedAt: unlockedMap.get(achievement.id) ?? null,
+    }));
+}
+/**
+ * Get achievement by ID
+ */
+export function getAchievementById(id) {
+    return ACHIEVEMENTS.find((a) => a.id === id);
+}
+/**
+ * Get achievement count
+ */
+export async function getAchievementCount() {
+    const data = await loadStats();
+    return {
+        unlocked: data.achievements.length,
+        total: ACHIEVEMENTS.length,
+    };
+}
+/**
+ * Get all stats data
+ */
+export async function getAllStats() {
+    return loadStats();
+}
+// ============================================================================
+// FORMATTING HELPERS
+// ============================================================================
+/**
+ * Format duration in seconds to human-readable string
+ */
+export function formatDuration(seconds) {
+    if (seconds < 60) {
+        return `${Math.floor(seconds)}s`;
+    }
+    if (seconds < 3600) {
+        const mins = Math.floor(seconds / 60);
+        const secs = Math.floor(seconds % 60);
+        return secs > 0 ? `${mins}m ${secs}s` : `${mins}m`;
+    }
+    const hours = Math.floor(seconds / 3600);
+    const mins = Math.floor((seconds % 3600) / 60);
+    return mins > 0 ? `${hours}h ${mins}m` : `${hours}h`;
+}
+/**
+ * Format a date string for display
+ */
+export function formatStatsDate(timestamp) {
+    if (!timestamp)
+        return "Never";
+    const date = new Date(timestamp);
+    const now = new Date();
+    if (date.toDateString() === now.toDateString()) {
+        return "Today";
+    }
+    const yesterday = new Date();
+    yesterday.setDate(yesterday.getDate() - 1);
+    if (date.toDateString() === yesterday.toDateString()) {
+        return "Yesterday";
+    }
+    return date.toLocaleDateString([], {
+        month: "short",
+        day: "numeric",
+        year: date.getFullYear() !== now.getFullYear() ? "numeric" : undefined,
+    });
+}
+//# sourceMappingURL=stats.js.map