@boshu2/vibe-check 1.5.0 → 1.6.1

package/PLAN-ultimate-game.md

@@ -1,1362 +0,0 @@
-# Ultimate Vibe-Coding Game - Implementation Plan
-
-**Type:** Plan
-**Created:** 2025-11-29
-**Version:** 1.5.0 (target)
-**Loop:** Middle (bridges research to implementation)
-**Tags:** gamification, leaderboards, challenges, prestige
-
----
-
-## Overview
-
-Transform vibe-check from a metrics tool into the **ultimate gamified coding experience**. This plan adds:
-
-1. **Weekly Challenges** - Auto-generated goals based on your weak metrics
-2. **Prestige System** - Endless progression beyond Grandmaster
-3. **Enhanced Streak Display** - Visual progression (🔥→🌟→👑)
-4. **Local Leaderboards** - Personal high scores across repos
-5. **Hall of Fame** - Personal records and bests
-6. **Weekly Stats with Sparklines** - Trend visualization
-7. **Rank Badges** - Bronze → Diamond visual tiers
-8. **Share-to-Clipboard** - Brag on Slack/Discord
-9. **Near-miss Psychology** - "SO CLOSE!" motivation
-
-**Philosophy:** Maximize FAAFO and user experience. Games are fun. Vibe-coding should be fun too.
-
----
-
-## PDC Strategy
-
-### Prevent
-- [ ] Don't add npm dependencies (chalk already handles everything)
-- [ ] Don't overengineer (local JSON storage, no server)
-- [ ] Don't gamify bad practices (quality > quantity)
-
-### Detect
-- [ ] Test each feature independently before integration
-- [ ] Verify XP calculations don't break existing logic
-- [ ] Check profile migration handles new fields
-
-### Correct
-- [ ] All features are additive (existing profiles still work)
-- [ ] Profile migration auto-adds new fields with defaults
-
----
-
-## Sprint 1: Core Gamification Boost (4-5 hours)
-
-### 1.1 Weekly Challenges System
-
-**New File: `src/gamification/challenges.ts`**
-
-```typescript
-import { UserProfile, SessionRecord, StreakState } from './types';
-
-// Challenge types
-export type ChallengeType =
-  | 'TRUST_STREAK'      // Get 90%+ trust N times
-  | 'ZERO_SPIRALS'      // 0 spirals for N days
-  | 'ELITE_COUNT'       // Get N ELITE sessions
-  | 'COMMIT_VOLUME'     // Analyze N commits
-  | 'STREAK_EXTEND';    // Extend streak by N days
-
-export interface Challenge {
-  id: string;
-  type: ChallengeType;
-  name: string;
-  description: string;
-  icon: string;
-  target: number;           // Goal to reach
-  progress: number;         // Current progress
-  reward: number;           // XP reward
-  weekStart: string;        // ISO date of week start
-  completed: boolean;
-  completedAt?: string;
-}
-
-export const CHALLENGE_DEFINITIONS: Record<ChallengeType, {
-  name: string;
-  description: (target: number) => string;
-  icon: string;
-  targets: number[];        // Easy, medium, hard
-  rewards: number[];        // Corresponding rewards
-}> = {
-  TRUST_STREAK: {
-    name: 'Trust Gauntlet',
-    description: (n) => `Get 90%+ trust in ${n} sessions`,
-    icon: '🎯',
-    targets: [3, 5, 7],
-    rewards: [50, 100, 150],
-  },
-  ZERO_SPIRALS: {
-    name: 'Zen Mode',
-    description: (n) => `${n} sessions with 0 spirals`,
-    icon: '🧘',
-    targets: [3, 5, 7],
-    rewards: [50, 100, 150],
-  },
-  ELITE_COUNT: {
-    name: 'Elite Streak',
-    description: (n) => `Get ${n} ELITE ratings this week`,
-    icon: '✨',
-    targets: [2, 4, 6],
-    rewards: [50, 100, 150],
-  },
-  COMMIT_VOLUME: {
-    name: 'Commit Champion',
-    description: (n) => `Analyze ${n}+ commits this week`,
-    icon: '📊',
-    targets: [50, 100, 200],
-    rewards: [30, 60, 100],
-  },
-  STREAK_EXTEND: {
-    name: 'Streak Builder',
-    description: (n) => `Extend your streak by ${n} days`,
-    icon: '🔥',
-    targets: [3, 5, 7],
-    rewards: [40, 80, 120],
-  },
-};
-
-/**
- * Generate weekly challenges based on user's weak metrics
- */
-export function generateWeeklyChallenges(profile: UserProfile): Challenge[] {
-  const weekStart = getWeekStartISO(new Date());
-  const recentSessions = getSessionsThisWeek(profile.sessions, weekStart);
-
-  // Analyze weak areas
-  const avgTrust = recentSessions.length > 0
-    ? recentSessions.reduce((sum, s) => sum + (s.vibeScore || 0), 0) / recentSessions.length
-    : 50;
-  const spiralCount = recentSessions.reduce((sum, s) => sum + s.spirals, 0);
-  const eliteCount = recentSessions.filter(s => s.overall === 'ELITE').length;
-
-  // Pick 3 challenges (1 based on weakness, 2 random)
-  const challenges: Challenge[] = [];
-  const usedTypes = new Set<ChallengeType>();
-
-  // Challenge 1: Based on weakness
-  if (avgTrust < 80) {
-    challenges.push(createChallenge('TRUST_STREAK', weekStart, 1)); // Medium
-    usedTypes.add('TRUST_STREAK');
-  } else if (spiralCount > 3) {
-    challenges.push(createChallenge('ZERO_SPIRALS', weekStart, 1));
-    usedTypes.add('ZERO_SPIRALS');
-  } else if (eliteCount < 2) {
-    challenges.push(createChallenge('ELITE_COUNT', weekStart, 1));
-    usedTypes.add('ELITE_COUNT');
-  } else {
-    challenges.push(createChallenge('STREAK_EXTEND', weekStart, 1));
-    usedTypes.add('STREAK_EXTEND');
-  }
-
-  // Challenge 2-3: Random from remaining
-  const remainingTypes = (Object.keys(CHALLENGE_DEFINITIONS) as ChallengeType[])
-    .filter(t => !usedTypes.has(t));
-
-  for (let i = 0; i < 2 && remainingTypes.length > 0; i++) {
-    const idx = Math.floor(Math.random() * remainingTypes.length);
-    const type = remainingTypes.splice(idx, 1)[0];
-    challenges.push(createChallenge(type, weekStart, 0)); // Easy difficulty
-  }
-
-  return challenges;
-}
-
-function createChallenge(type: ChallengeType, weekStart: string, difficultyIdx: number): Challenge {
-  const def = CHALLENGE_DEFINITIONS[type];
-  const target = def.targets[difficultyIdx];
-  const reward = def.rewards[difficultyIdx];
-
-  return {
-    id: `${type}-${weekStart}`,
-    type,
-    name: def.name,
-    description: def.description(target),
-    icon: def.icon,
-    target,
-    progress: 0,
-    reward,
-    weekStart,
-    completed: false,
-  };
-}
-
-/**
- * Update challenge progress after a session
- */
-export function updateChallengeProgress(
-  challenges: Challenge[],
-  session: SessionRecord,
-  streak: StreakState
-): { challenges: Challenge[]; completed: Challenge[] } {
-  const completed: Challenge[] = [];
-
-  for (const challenge of challenges) {
-    if (challenge.completed) continue;
-
-    switch (challenge.type) {
-      case 'TRUST_STREAK':
-        if (session.vibeScore >= 90) challenge.progress++;
-        break;
-      case 'ZERO_SPIRALS':
-        if (session.spirals === 0 && session.commits >= 10) challenge.progress++;
-        break;
-      case 'ELITE_COUNT':
-        if (session.overall === 'ELITE') challenge.progress++;
-        break;
-      case 'COMMIT_VOLUME':
-        challenge.progress += session.commits;
-        break;
-      case 'STREAK_EXTEND':
-        challenge.progress = streak.current - (challenge.progress || 0);
-        break;
-    }
-
-    if (challenge.progress >= challenge.target) {
-      challenge.completed = true;
-      challenge.completedAt = new Date().toISOString();
-      completed.push(challenge);
-    }
-  }
-
-  return { challenges, completed };
-}
-
-/**
- * Get current week's challenges, generating if needed
- */
-export function getCurrentChallenges(profile: UserProfile): Challenge[] {
-  const weekStart = getWeekStartISO(new Date());
-  const existingChallenges = profile.challenges || [];
-
-  // Check if we have challenges for this week
-  const thisWeekChallenges = existingChallenges.filter(c => c.weekStart === weekStart);
-
-  if (thisWeekChallenges.length >= 3) {
-    return thisWeekChallenges;
-  }
-
-  // Generate new challenges
-  return generateWeeklyChallenges(profile);
-}
-
-/**
- * Format challenges for display
- */
-export function formatChallenges(challenges: Challenge[]): string {
-  const lines: string[] = [];
-
-  for (const c of challenges) {
-    const progressBar = createProgressBar(c.progress, c.target, 10);
-    const status = c.completed ? '✓ COMPLETE' : `${c.progress}/${c.target}`;
-    lines.push(`${c.icon} ${c.name}: ${progressBar} ${status}`);
-  }
-
-  return lines.join('\n');
-}
-
-function createProgressBar(current: number, total: number, length: number): string {
-  const pct = Math.min(current / total, 1);
-  const filled = Math.round(pct * length);
-  const empty = length - filled;
-  return '█'.repeat(filled) + '░'.repeat(empty);
-}
-
-function getWeekStartISO(date: Date): string {
-  const d = new Date(date);
-  const day = d.getDay();
-  const diff = d.getDate() - day + (day === 0 ? -6 : 1);
-  d.setDate(diff);
-  d.setHours(0, 0, 0, 0);
-  return d.toISOString().split('T')[0];
-}
-
-function getSessionsThisWeek(sessions: SessionRecord[], weekStart: string): SessionRecord[] {
-  const start = new Date(weekStart);
-  return sessions.filter(s => new Date(s.date) >= start);
-}
-```
-
-**Modify: `src/gamification/types.ts`**
-
-Add after line 78 (after `stats` block):
-
-```typescript
-  // Weekly challenges (v1.5.0)
-  challenges?: Challenge[];
-```
-
-Add import at top:
-```typescript
-import { Challenge } from './challenges';
-```
-
-**Validation:** `npm test` passes, `npm run build` succeeds
-
----
-
-### 1.2 Prestige System
-
-**Modify: `src/gamification/types.ts:150-158`**
-
-Replace LEVELS constant:
-
-```typescript
-// Level progression (including prestige)
-export const LEVELS = [
-  { level: 1, name: 'Novice', icon: '🌱', minXP: 0, maxXP: 100 },
-  { level: 2, name: 'Apprentice', icon: '🌿', minXP: 100, maxXP: 300 },
-  { level: 3, name: 'Practitioner', icon: '🌳', minXP: 300, maxXP: 600 },
-  { level: 4, name: 'Expert', icon: '🌲', minXP: 600, maxXP: 1000 },
-  { level: 5, name: 'Master', icon: '🎋', minXP: 1000, maxXP: 2000 },
-  { level: 6, name: 'Grandmaster', icon: '🏔️', minXP: 2000, maxXP: 5000 },
-] as const;
-
-// Prestige tiers (after Grandmaster)
-export const PRESTIGE_TIERS = [
-  { tier: 1, name: 'Archmage', icon: '🔮', minXP: 5000, maxXP: 10000 },
-  { tier: 2, name: 'Sage', icon: '📿', minXP: 10000, maxXP: 20000 },
-  { tier: 3, name: 'Zenmester', icon: '☯️', minXP: 20000, maxXP: 40000 },
-  { tier: 4, name: 'Transcendent', icon: '🌟', minXP: 40000, maxXP: 80000 },
-  { tier: 5, name: 'Legendary', icon: '💫', minXP: 80000, maxXP: Infinity },
-] as const;
-```
-
-**Modify: `src/gamification/types.ts:12-20`**
-
-Update XPState interface:
-
-```typescript
-export interface XPState {
-  total: number;             // Lifetime XP
-  level: number;             // Current level (1-6)
-  levelName: string;         // "Novice", "Apprentice", etc.
-  currentLevelXP: number;    // XP in current level
-  nextLevelXP: number;       // XP needed for next level
-  lastSessionXP: number;     // XP earned in last session
-  prestigeTier?: number;     // Prestige tier (0 = none, 1-5 = Archmage to Legendary)
-  prestigeName?: string;     // Prestige tier name
-}
-```
-
-**Modify: `src/gamification/xp.ts:88-95`**
-
-Update `getLevelForXP` to handle prestige:
-
-```typescript
-import { LEVELS, PRESTIGE_TIERS } from './types';
-
-/**
- * Get level for given XP amount (including prestige)
- */
-export function getLevelForXP(xp: number): {
-  level: number;
-  levelInfo: typeof LEVELS[number];
-  prestigeTier?: number;
-  prestigeInfo?: typeof PRESTIGE_TIERS[number];
-} {
-  // Check prestige tiers first
-  if (xp >= 5000) {
-    for (let i = PRESTIGE_TIERS.length - 1; i >= 0; i--) {
-      if (xp >= PRESTIGE_TIERS[i].minXP) {
-        return {
-          level: 6,
-          levelInfo: LEVELS[5],
-          prestigeTier: PRESTIGE_TIERS[i].tier,
-          prestigeInfo: PRESTIGE_TIERS[i],
-        };
-      }
-    }
-  }
-
-  // Regular levels
-  for (let i = LEVELS.length - 1; i >= 0; i--) {
-    if (xp >= LEVELS[i].minXP) {
-      return { level: LEVELS[i].level, levelInfo: LEVELS[i] };
-    }
-  }
-  return { level: 1, levelInfo: LEVELS[0] };
-}
-```
-
-**Modify: `src/gamification/xp.ts:63-83`**
-
-Update `addXP` to handle prestige:
-
-```typescript
-export function addXP(currentXP: XPState, earnedXP: number): {
-  xp: XPState;
-  leveledUp: boolean;
-  newLevel?: typeof LEVELS[number];
-  prestigedUp?: boolean;
-  newPrestige?: typeof PRESTIGE_TIERS[number];
-} {
-  const newTotal = currentXP.total + earnedXP;
-  const { level, levelInfo, prestigeTier, prestigeInfo } = getLevelForXP(newTotal);
-
-  const leveledUp = level > currentXP.level;
-  const prestigedUp = prestigeTier !== undefined &&
-    (currentXP.prestigeTier === undefined || prestigeTier > currentXP.prestigeTier);
-
-  const maxXP = prestigeInfo ? prestigeInfo.maxXP : levelInfo.maxXP;
-  const minXP = prestigeInfo ? prestigeInfo.minXP : levelInfo.minXP;
-
-  const newXP: XPState = {
-    total: newTotal,
-    level,
-    levelName: prestigeInfo ? prestigeInfo.name : levelInfo.name,
-    currentLevelXP: newTotal - minXP,
-    nextLevelXP: maxXP === Infinity ? Infinity : maxXP - minXP,
-    lastSessionXP: earnedXP,
-    prestigeTier,
-    prestigeName: prestigeInfo?.name,
-  };
-
-  return {
-    xp: newXP,
-    leveledUp,
-    newLevel: leveledUp ? levelInfo : undefined,
-    prestigedUp,
-    newPrestige: prestigedUp ? prestigeInfo : undefined,
-  };
-}
-```
-
-**Validation:** `npm test` passes, profile shows prestige tier
-
----
-
-### 1.3 Enhanced Streak Display
-
-**Modify: `src/gamification/streaks.ts:102-118`**
-
-Replace `formatStreak` function:
-
-```typescript
-/**
- * Format streak for display with visual progression
- */
-export function formatStreak(streak: StreakState): string {
-  if (streak.current === 0) {
-    return 'No active streak';
-  }
-
-  const isPersonalBest = streak.current === streak.longest && streak.current > 1;
-
-  // Visual progression: 🔥 (1-5) → 🌟 (6-14) → 👑 (15+)
-  let icon: string;
-  if (streak.current >= 15) {
-    icon = '👑';
-  } else if (streak.current >= 6) {
-    icon = '🌟';
-  } else {
-    icon = '🔥';
-  }
-
-  // Multiple icons for emphasis
-  const repeatCount = Math.min(Math.ceil(streak.current / 5), 3);
-  const icons = icon.repeat(repeatCount);
-
-  let text = `${icons} ${streak.current}-day streak`;
-
-  if (isPersonalBest && streak.current > 7) {
-    text += ' 🏆 (Personal Best!)';
-  }
-
-  return text;
-}
-
-/**
- * Format streak with risk indicator
- */
-export function formatStreakWithRisk(streak: StreakState): string {
-  const base = formatStreak(streak);
-  const daysUntil = getDaysUntilExpiry(streak);
-
-  if (streak.current > 0 && daysUntil <= 1) {
-    return `${base}\n⚠️  Streak at risk! Check in today to keep it alive`;
-  }
-
-  return base;
-}
-
-/**
- * Format freezes display
- */
-export function formatFreezes(streak: StreakState): string {
-  const freezeIcon = '❄️';
-  return `${freezeIcon} ${streak.freezesRemaining} freeze${streak.freezesRemaining !== 1 ? 's' : ''} available`;
-}
-```
-
-**Validation:** `vibe-check profile` shows enhanced streak display
-
----
-
-## Sprint 2: Leaderboards & Records (3-4 hours)
-
-### 2.1 Local Leaderboards
-
-**New File: `src/gamification/leaderboards.ts`**
-
-```typescript
-import * as fs from 'fs';
-import * as path from 'path';
-import * as os from 'os';
-import { SessionRecord } from './types';
-
-const LEADERBOARD_FILE = 'leaderboards.json';
-
-export interface LeaderboardEntry {
-  date: string;
-  repoPath: string;
-  repoName: string;
-  vibeScore: number;
-  overall: string;
-  commits: number;
-  xpEarned: number;
-}
-
-export interface Leaderboards {
-  version: string;
-  entries: LeaderboardEntry[];      // All-time entries (top 100)
-  byRepo: Record<string, LeaderboardEntry[]>;  // Per-repo top 10
-  personalBests: {
-    highestScore: LeaderboardEntry | null;
-    longestStreak: number;
-    bestWeekXP: { week: string; xp: number } | null;
-    mostCommits: LeaderboardEntry | null;
-  };
-}
-
-/**
- * Get leaderboards file path
- */
-export function getLeaderboardsPath(): string {
-  return path.join(os.homedir(), '.vibe-check', LEADERBOARD_FILE);
-}
-
-/**
- * Load leaderboards from disk
- */
-export function loadLeaderboards(): Leaderboards {
-  const filePath = getLeaderboardsPath();
-
-  if (fs.existsSync(filePath)) {
-    try {
-      return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-    } catch {
-      return createInitialLeaderboards();
-    }
-  }
-
-  return createInitialLeaderboards();
-}
-
-/**
- * Save leaderboards to disk
- */
-export function saveLeaderboards(leaderboards: Leaderboards): void {
-  const filePath = getLeaderboardsPath();
-  const dir = path.dirname(filePath);
-
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-
-  fs.writeFileSync(filePath, JSON.stringify(leaderboards, null, 2));
-}
-
-/**
- * Create initial leaderboards
- */
-export function createInitialLeaderboards(): Leaderboards {
-  return {
-    version: '1.0.0',
-    entries: [],
-    byRepo: {},
-    personalBests: {
-      highestScore: null,
-      longestStreak: 0,
-      bestWeekXP: null,
-      mostCommits: null,
-    },
-  };
-}
-
-/**
- * Record a session to leaderboards
- */
-export function recordToLeaderboard(
-  session: SessionRecord,
-  repoPath: string,
-  xpEarned: number,
-  streak: number
-): Leaderboards {
-  const leaderboards = loadLeaderboards();
-  const repoName = path.basename(repoPath);
-
-  const entry: LeaderboardEntry = {
-    date: session.date,
-    repoPath,
-    repoName,
-    vibeScore: session.vibeScore,
-    overall: session.overall,
-    commits: session.commits,
-    xpEarned,
-  };
-
-  // Add to global entries (sorted by score, top 100)
-  leaderboards.entries.push(entry);
-  leaderboards.entries.sort((a, b) => b.vibeScore - a.vibeScore);
-  leaderboards.entries = leaderboards.entries.slice(0, 100);
-
-  // Add to repo-specific entries (top 10)
-  if (!leaderboards.byRepo[repoPath]) {
-    leaderboards.byRepo[repoPath] = [];
-  }
-  leaderboards.byRepo[repoPath].push(entry);
-  leaderboards.byRepo[repoPath].sort((a, b) => b.vibeScore - a.vibeScore);
-  leaderboards.byRepo[repoPath] = leaderboards.byRepo[repoPath].slice(0, 10);
-
-  // Update personal bests
-  if (!leaderboards.personalBests.highestScore ||
-      session.vibeScore > leaderboards.personalBests.highestScore.vibeScore) {
-    leaderboards.personalBests.highestScore = entry;
-  }
-
-  if (streak > leaderboards.personalBests.longestStreak) {
-    leaderboards.personalBests.longestStreak = streak;
-  }
-
-  if (!leaderboards.personalBests.mostCommits ||
-      session.commits > leaderboards.personalBests.mostCommits.commits) {
-    leaderboards.personalBests.mostCommits = entry;
-  }
-
-  // Track weekly XP
-  const weekStart = getWeekStartISO(new Date(session.date));
-  const currentWeekXP = leaderboards.personalBests.bestWeekXP;
-  if (!currentWeekXP || currentWeekXP.week !== weekStart) {
-    // New week - check if we beat previous best
-    // (simplified - in practice would need to sum week's XP)
-    leaderboards.personalBests.bestWeekXP = { week: weekStart, xp: xpEarned };
-  } else {
-    currentWeekXP.xp += xpEarned;
-  }
-
-  saveLeaderboards(leaderboards);
-  return leaderboards;
-}
-
-/**
- * Format leaderboard for display
- */
-export function formatLeaderboard(leaderboards: Leaderboards, repoPath?: string): string {
-  const lines: string[] = [];
-
-  if (repoPath && leaderboards.byRepo[repoPath]) {
-    const repoEntries = leaderboards.byRepo[repoPath];
-    lines.push(`📊 Top Scores - ${path.basename(repoPath)}`);
-    lines.push('');
-
-    for (let i = 0; i < Math.min(repoEntries.length, 5); i++) {
-      const e = repoEntries[i];
-      const medal = i === 0 ? '🥇' : i === 1 ? '🥈' : i === 2 ? '🥉' : '  ';
-      lines.push(`${medal} ${e.vibeScore}% ${e.overall.padEnd(6)} ${e.date}`);
-    }
-  } else {
-    lines.push('🏆 All-Time Top Scores');
-    lines.push('');
-
-    for (let i = 0; i < Math.min(leaderboards.entries.length, 10); i++) {
-      const e = leaderboards.entries[i];
-      const medal = i === 0 ? '🥇' : i === 1 ? '🥈' : i === 2 ? '🥉' : `${i + 1}.`;
-      lines.push(`${medal} ${e.vibeScore}% ${e.overall.padEnd(6)} ${e.repoName} (${e.date})`);
-    }
-  }
-
-  return lines.join('\n');
-}
-
-function getWeekStartISO(date: Date): string {
-  const d = new Date(date);
-  const day = d.getDay();
-  const diff = d.getDate() - day + (day === 0 ? -6 : 1);
-  d.setDate(diff);
-  return d.toISOString().split('T')[0];
-}
-```
-
-**Validation:** `npm run build` succeeds
-
----
-
-### 2.2 Hall of Fame (Personal Bests)
-
-**New File: `src/gamification/hall-of-fame.ts`**
-
-```typescript
-import { Leaderboards } from './leaderboards';
-
-export interface HallOfFameRecord {
-  category: string;
-  icon: string;
-  value: string;
-  date: string;
-  context: string;
-}
-
-/**
- * Get Hall of Fame records from leaderboards
- */
-export function getHallOfFame(leaderboards: Leaderboards): HallOfFameRecord[] {
-  const records: HallOfFameRecord[] = [];
-  const pb = leaderboards.personalBests;
-
-  if (pb.highestScore) {
-    records.push({
-      category: 'Best Vibe Score',
-      icon: '🏆',
-      value: `${pb.highestScore.vibeScore}%`,
-      date: pb.highestScore.date,
-      context: `${pb.highestScore.repoName} - ${pb.highestScore.overall}`,
-    });
-  }
-
-  if (pb.longestStreak > 0) {
-    records.push({
-      category: 'Longest Streak',
-      icon: '🔥',
-      value: `${pb.longestStreak} days`,
-      date: 'All time',
-      context: 'Consecutive daily check-ins',
-    });
-  }
-
-  if (pb.bestWeekXP) {
-    records.push({
-      category: 'Best Week XP',
-      icon: '⚡',
-      value: `${pb.bestWeekXP.xp} XP`,
-      date: pb.bestWeekXP.week,
-      context: 'Most XP earned in a single week',
-    });
-  }
-
-  if (pb.mostCommits) {
-    records.push({
-      category: 'Most Commits',
-      icon: '📊',
-      value: `${pb.mostCommits.commits}`,
-      date: pb.mostCommits.date,
-      context: `${pb.mostCommits.repoName} - single session`,
-    });
-  }
-
-  return records;
-}
-
-/**
- * Format Hall of Fame for display
- */
-export function formatHallOfFame(records: HallOfFameRecord[]): string {
-  if (records.length === 0) {
-    return 'No records yet. Keep coding!';
-  }
-
-  const lines: string[] = ['🏛️  HALL OF FAME', ''];
-
-  for (const record of records) {
-    lines.push(`${record.icon} ${record.category}: ${record.value}`);
-    lines.push(`   ${record.date} - ${record.context}`);
-    lines.push('');
-  }
-
-  return lines.join('\n');
-}
-```
-
----
-
-### 2.3 Weekly Stats with Sparklines
-
-**New File: `src/gamification/stats.ts`**
-
-```typescript
-import { SessionRecord } from './types';
-
-/**
- * Create a sparkline from values
- */
-export function createSparkline(values: number[]): string {
-  if (values.length === 0) return '';
-
-  const chars = ['▁', '▂', '▃', '▄', '▅', '▆', '▇', '█'];
-  const min = Math.min(...values);
-  const max = Math.max(...values);
-  const range = max - min || 1;
-
-  return values
-    .map(v => chars[Math.floor(((v - min) / range) * 7)])
-    .join('');
-}
-
-/**
- * Get trend indicator
- */
-export function getTrend(values: number[]): { direction: 'up' | 'down' | 'stable'; emoji: string } {
-  if (values.length < 2) return { direction: 'stable', emoji: '➡️' };
-
-  const recent = values.slice(-3);
-  const older = values.slice(0, 3);
-
-  const recentAvg = recent.reduce((a, b) => a + b, 0) / recent.length;
-  const olderAvg = older.reduce((a, b) => a + b, 0) / older.length;
-
-  const diff = recentAvg - olderAvg;
-
-  if (diff > 5) return { direction: 'up', emoji: '↑' };
-  if (diff < -5) return { direction: 'down', emoji: '↓' };
-  return { direction: 'stable', emoji: '→' };
-}
-
-export interface WeeklyStats {
-  avgScore: number;
-  sessions: number;
-  totalCommits: number;
-  eliteCount: number;
-  spiralCount: number;
-  sparkline: string;
-  trend: { direction: string; emoji: string };
-  xpEarned: number;
-}
-
-/**
- * Calculate weekly statistics
- */
-export function getWeeklyStats(sessions: SessionRecord[]): WeeklyStats {
-  const weekStart = getWeekStartDate(new Date());
-  const weekSessions = sessions.filter(s => new Date(s.date) >= weekStart);
-
-  if (weekSessions.length === 0) {
-    return {
-      avgScore: 0,
-      sessions: 0,
-      totalCommits: 0,
-      eliteCount: 0,
-      spiralCount: 0,
-      sparkline: '',
-      trend: { direction: 'stable', emoji: '→' },
-      xpEarned: 0,
-    };
-  }
-
-  const scores = weekSessions.map(s => s.vibeScore);
-
-  return {
-    avgScore: Math.round(scores.reduce((a, b) => a + b, 0) / scores.length),
-    sessions: weekSessions.length,
-    totalCommits: weekSessions.reduce((sum, s) => sum + s.commits, 0),
-    eliteCount: weekSessions.filter(s => s.overall === 'ELITE').length,
-    spiralCount: weekSessions.reduce((sum, s) => sum + s.spirals, 0),
-    sparkline: createSparkline(scores),
-    trend: getTrend(scores),
-    xpEarned: weekSessions.reduce((sum, s) => sum + s.xpEarned, 0),
-  };
-}
-
-/**
- * Format weekly stats for display
- */
-export function formatWeeklyStats(stats: WeeklyStats): string {
-  const lines: string[] = [];
-
-  lines.push('📅 THIS WEEK');
-  lines.push(`   Avg Score: ${stats.avgScore}% ${stats.trend.emoji}`);
-  lines.push(`   Sessions: ${stats.sessions}`);
-  lines.push(`   XP Earned: ${stats.xpEarned}`);
-  lines.push(`   ELITE: ${stats.eliteCount} | Spirals: ${stats.spiralCount}`);
-
-  if (stats.sparkline) {
-    lines.push(`   Trend: ${stats.sparkline}`);
-  }
-
-  return lines.join('\n');
-}
-
-function getWeekStartDate(date: Date): Date {
-  const d = new Date(date);
-  const day = d.getDay();
-  const diff = d.getDate() - day + (day === 0 ? -6 : 1);
-  d.setDate(diff);
-  d.setHours(0, 0, 0, 0);
-  return d;
-}
-```
-
----
-
-## Sprint 3: Polish & Social (3-4 hours)
-
-### 3.1 Rank Badges
-
-**New File: `src/gamification/badges.ts`**
-
-```typescript
-export interface RankBadge {
-  id: string;
-  name: string;
-  icon: string;
-  color: string;
-  requirement: string;
-  threshold: {
-    type: 'sessions' | 'streak' | 'xp' | 'score';
-    value: number;
-  };
-}
-
-export const RANK_BADGES: RankBadge[] = [
-  {
-    id: 'bronze',
-    name: 'Bronze',
-    icon: '🥉',
-    color: '#CD7F32',
-    requirement: '10 sessions',
-    threshold: { type: 'sessions', value: 10 },
-  },
-  {
-    id: 'silver',
-    name: 'Silver',
-    icon: '🥈',
-    color: '#C0C0C0',
-    requirement: '50 sessions',
-    threshold: { type: 'sessions', value: 50 },
-  },
-  {
-    id: 'gold',
-    name: 'Gold',
-    icon: '🥇',
-    color: '#FFD700',
-    requirement: '100 sessions',
-    threshold: { type: 'sessions', value: 100 },
-  },
-  {
-    id: 'platinum',
-    name: 'Platinum',
-    icon: '💎',
-    color: '#E5E4E2',
-    requirement: '14-day streak',
-    threshold: { type: 'streak', value: 14 },
-  },
-  {
-    id: 'diamond',
-    name: 'Diamond',
-    icon: '🔷',
-    color: '#B9F2FF',
-    requirement: '5000+ XP',
-    threshold: { type: 'xp', value: 5000 },
-  },
-];
-
-/**
- * Get current rank badge
- */
-export function getCurrentBadge(
-  sessions: number,
-  streak: number,
-  xp: number
-): RankBadge | null {
-  // Check from highest to lowest
-  for (let i = RANK_BADGES.length - 1; i >= 0; i--) {
-    const badge = RANK_BADGES[i];
-    const { type, value } = badge.threshold;
-
-    switch (type) {
-      case 'sessions':
-        if (sessions >= value) return badge;
-        break;
-      case 'streak':
-        if (streak >= value) return badge;
-        break;
-      case 'xp':
-        if (xp >= value) return badge;
-        break;
-    }
-  }
-
-  return null;
-}
-
-/**
- * Get next badge and progress
- */
-export function getNextBadge(
-  sessions: number,
-  streak: number,
-  xp: number
-): { badge: RankBadge; progress: number; remaining: string } | null {
-  const current = getCurrentBadge(sessions, streak, xp);
-  const currentIdx = current ? RANK_BADGES.findIndex(b => b.id === current.id) : -1;
-
-  if (currentIdx >= RANK_BADGES.length - 1) return null;
-
-  const next = RANK_BADGES[currentIdx + 1];
-  const { type, value } = next.threshold;
-
-  let currentValue: number;
-  let unit: string;
-
-  switch (type) {
-    case 'sessions':
-      currentValue = sessions;
-      unit = 'sessions';
-      break;
-    case 'streak':
-      currentValue = streak;
-      unit = 'day streak';
-      break;
-    case 'xp':
-      currentValue = xp;
-      unit = 'XP';
-      break;
-    default:
-      return null;
-  }
-
-  const progress = Math.min((currentValue / value) * 100, 99);
-  const remaining = `${value - currentValue} ${unit}`;
-
-  return { badge: next, progress, remaining };
-}
-
-/**
- * Format badge display
- */
-export function formatBadge(badge: RankBadge | null): string {
-  if (!badge) return 'No badge yet';
-  return `${badge.icon} ${badge.name} Tier`;
-}
-```
-
----
-
-### 3.2 Share-to-Clipboard
-
-**New File: `src/gamification/share.ts`**
-
-```typescript
-import { UserProfile } from './types';
-import { getCurrentBadge } from './badges';
-import { LEVELS, PRESTIGE_TIERS } from './types';
-
-export interface ShareableProfile {
-  username?: string;
-  level: number;
-  levelName: string;
-  totalXP: number;
-  badge: string | null;
-  streak: number;
-  longestStreak: number;
-  totalSessions: number;
-  avgScore: number;
-  bestScore: number;
-  achievementCount: number;
-  prestigeTier?: number;
-  generatedAt: string;
-}
-
-/**
- * Create shareable profile data
- */
-export function createShareableProfile(
-  profile: UserProfile,
-  username?: string
-): ShareableProfile {
-  const badge = getCurrentBadge(
-    profile.stats.totalSessions,
-    profile.streak.longest,
-    profile.xp.total
-  );
-
-  return {
-    username,
-    level: profile.xp.level,
-    levelName: profile.xp.levelName,
-    totalXP: profile.xp.total,
-    badge: badge?.name || null,
-    streak: profile.streak.current,
-    longestStreak: profile.streak.longest,
-    totalSessions: profile.stats.totalSessions,
-    avgScore: profile.stats.avgVibeScore,
-    bestScore: profile.stats.bestVibeScore,
-    achievementCount: profile.achievements.length,
-    prestigeTier: profile.xp.prestigeTier,
-    generatedAt: new Date().toISOString(),
-  };
-}
-
-/**
- * Format profile for sharing (text format)
- */
-export function formatShareText(shareable: ShareableProfile): string {
-  const lines: string[] = [];
-
-  const name = shareable.username || 'Anonymous Coder';
-  const badgeStr = shareable.badge ? ` ${shareable.badge}` : '';
-  const prestigeStr = shareable.prestigeTier
-    ? ` (${PRESTIGE_TIERS[shareable.prestigeTier - 1].name})`
-    : '';
-
-  lines.push(`🎮 ${name}'s Vibe-Check Profile`);
-  lines.push('');
-  lines.push(`Level ${shareable.level} ${shareable.levelName}${prestigeStr}${badgeStr}`);
-  lines.push(`${shareable.totalXP.toLocaleString()} Total XP`);
-  lines.push('');
-  lines.push(`🔥 ${shareable.streak}-day streak (Best: ${shareable.longestStreak})`);
-  lines.push(`📊 ${shareable.totalSessions} sessions | Avg: ${shareable.avgScore}% | Best: ${shareable.bestScore}%`);
-  lines.push(`🏆 ${shareable.achievementCount} achievements unlocked`);
-  lines.push('');
-  lines.push('Track your coding vibes: npx @boshu2/vibe-check');
-
-  return lines.join('\n');
-}
-
-/**
- * Format profile as JSON for clipboard
- */
-export function formatShareJSON(shareable: ShareableProfile): string {
-  return JSON.stringify(shareable, null, 2);
-}
-```
-
----
-
-### 3.3 Near-Miss Psychology
-
-**Modify: `src/output/terminal.ts`**
-
-Add after line 126 (after opportunities section):
-
-```typescript
-  // Near-miss psychology - motivational close calls
-  const nearMisses = getNearMisses(result, metrics);
-  if (nearMisses.length > 0) {
-    lines.push('');
-    lines.push(chalk.bold.magenta('  🎯 SO CLOSE!'));
-    for (const miss of nearMisses) {
-      lines.push(chalk.magenta(`  ${miss}`));
-    }
-  }
-```
-
-Add function at end of file:
-
-```typescript
-/**
- * Find near-miss motivational messages
- */
-function getNearMisses(result: VibeCheckResult | VibeCheckResultV2, metrics: any[]): string[] {
-  const misses: string[] = [];
-
-  // Check for near-ELITE overall
-  if (result.overall === 'HIGH') {
-    const eliteCount = metrics.filter(m => m.metric.rating === 'elite').length;
-    if (eliteCount >= 3) {
-      misses.push('Just 1-2 metrics away from ELITE overall!');
-    }
-  }
-
-  // Check for near-90% score
-  if (isV2Result(result) && result.vibeScore) {
-    const score = result.vibeScore.value * 100;
-    if (score >= 85 && score < 90) {
-      misses.push(`${Math.round(score)}% vibe score - just ${90 - Math.round(score)}% from the Ninety Club!`);
-    }
-  }
-
-  // Check for near-perfect trust
-  const trust = result.metrics.trustPassRate;
-  if (trust.value >= 90 && trust.value < 100 && trust.rating !== 'elite') {
-    misses.push(`${trust.value}% trust - ${100 - trust.value}% from Perfect Trust!`);
-  }
-
-  // Check for near-zero spirals
-  if (result.fixChains.length === 1 && result.commits.total >= 20) {
-    misses.push('Only 1 spiral! Next time could be Zen Master territory.');
-  }
-
-  return misses.slice(0, 2); // Max 2 near-misses
-}
-```
-
----
-
-## Integration: Update Profile Command
-
-**Modify: `src/commands/profile.ts`**
-
-Add new imports:
-
-```typescript
-import { getCurrentChallenges, formatChallenges } from '../gamification/challenges';
-import { loadLeaderboards, formatLeaderboard } from '../gamification/leaderboards';
-import { getHallOfFame, formatHallOfFame } from '../gamification/hall-of-fame';
-import { getWeeklyStats, formatWeeklyStats } from '../gamification/stats';
-import { getCurrentBadge, getNextBadge, formatBadge } from '../gamification/badges';
-import { createShareableProfile, formatShareText } from '../gamification/share';
-import { formatStreakWithRisk, formatFreezes } from '../gamification/streaks';
-import { PRESTIGE_TIERS } from '../gamification/types';
-```
-
-Add new options:
-
-```typescript
-.option('--challenges', 'Show weekly challenges', false)
-.option('--leaderboard', 'Show personal leaderboard', false)
-.option('--hall-of-fame', 'Show Hall of Fame records', false)
-.option('--weekly', 'Show this week stats', false)
-.option('--share', 'Copy shareable profile to stdout', false)
-```
-
-Update display in `runProfile` to show new elements (challenges, badge, prestige).
-
----
-
-## Validation Strategy
-
-### Syntax Validation
-```bash
-npm run build
-# Expected: Compiles without errors
-```
-
-### Unit Tests
-```bash
-npm test
-# Expected: All tests pass
-```
-
-### Integration Testing
-```bash
-# Test prestige
-node dist/cli.js profile
-# Expected: Shows prestige tier if XP > 5000
-
-# Test challenges
-node dist/cli.js profile --challenges
-# Expected: Shows 3 weekly challenges with progress
-
-# Test leaderboard
-node dist/cli.js profile --leaderboard
-# Expected: Shows personal high scores
-
-# Test share
-node dist/cli.js profile --share
-# Expected: Outputs shareable JSON
-```
-
----
-
-## Implementation Order
-
-**CRITICAL: Follow this sequence**
-
-| Step | Action | Validation | Rollback |
-|------|--------|------------|----------|
-| 1 | Create `challenges.ts` | `npm run build` | Delete file |
-| 2 | Update `types.ts` (prestige + challenges) | `npm run build` | Revert changes |
-| 3 | Update `xp.ts` (prestige logic) | `npm test` | Revert changes |
-| 4 | Update `streaks.ts` (enhanced display) | `npm test` | Revert changes |
-| 5 | Create `leaderboards.ts` | `npm run build` | Delete file |
-| 6 | Create `hall-of-fame.ts` | `npm run build` | Delete file |
-| 7 | Create `stats.ts` | `npm run build` | Delete file |
-| 8 | Create `badges.ts` | `npm run build` | Delete file |
-| 9 | Create `share.ts` | `npm run build` | Delete file |
-| 10 | Update `terminal.ts` (near-miss) | `npm run build` | Revert changes |
-| 11 | Update `profile.ts` command | `npm test` | Revert changes |
-| 12 | Full integration test | `npm test && npm run build` | Revert all |
-
----
-
-## Rollback Procedure
-
-**Time to rollback:** 5 minutes
-
-### Full Rollback
-```bash
-git checkout HEAD -- src/
-rm -f src/gamification/challenges.ts
-rm -f src/gamification/leaderboards.ts
-rm -f src/gamification/hall-of-fame.ts
-rm -f src/gamification/stats.ts
-rm -f src/gamification/badges.ts
-rm -f src/gamification/share.ts
-npm run build
-npm test
-```
-
----
-
-## Risk Assessment
-
-### Low Risk
-- All features are additive (no breaking changes)
-- Existing profiles auto-migrate
-- No new npm dependencies
-
-### Medium Risk
-- XP/prestige calculation changes could affect existing users
-- **Mitigation:** Prestige only kicks in at 5000+ XP (most users below)
-
----
-
-## Approval Checklist
-
-**Human must verify before `/implement`:**
-
-- [ ] Every file specified precisely (file:line)
-- [ ] All templates complete (no placeholders)
-- [ ] Validation commands provided
-- [ ] Rollback procedure complete
-- [ ] Implementation order is correct
-- [ ] No new dependencies needed
-
----
-
-## Target Output
-
-After implementation, `vibe-check profile` will show:
-
-```
-╔════════════════════════════════════════════════════════════╗
-║  🏔️  ARCHMAGE I  (Prestige 1)  💎 Platinum Tier           ║
-╠════════════════════════════════════════════════════════════╣
-║  XP: ████████████░░░░  1,250 / 2,000                       ║
-║  👑👑 12-day streak 🏆 (Personal Best!)                     ║
-║  ❄️ 2 freezes available                                    ║
-╠════════════════════════════════════════════════════════════╣
-║  WEEKLY CHALLENGES                                         ║
-║  🎯 Trust Gauntlet:  ████████░░  4/5                       ║
-║  🧘 Zen Mode:        ██████████  ✓ COMPLETE (+100 XP)      ║
-║  🔥 Streak Builder:  ██░░░░░░░░  1/5                       ║
-╠════════════════════════════════════════════════════════════╣
-║  📅 THIS WEEK                                              ║
-║     Avg Score: 87% ↑                                       ║
-║     Trend: ▂▄▃▆▅██  Improving!                            ║
-╠════════════════════════════════════════════════════════════╣
-║  🏛️  HALL OF FAME                                          ║
-║  🏆 Best Score: 96% (Nov 15)                               ║
-║  🔥 Longest Streak: 15 days                                ║
-║  ⚡ Best Week: 847 XP                                      ║
-╚════════════════════════════════════════════════════════════╝
-```
-
----
-
-## Next Step
-
-Once approved: `/implement PLAN-ultimate-game.md`