codymaster 4.1.2 → 4.1.4

package/dist/ui/hooks.js

@@ -0,0 +1,253 @@
+"use strict";
+/**
+ * 🪝 Hook Engine — Trigger → Action → Variable Reward → Investment
+ * Based on Nir Eyal's Hook Model for habit-forming CLI experience
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadProfile = loadProfile;
+exports.saveProfile = saveProfile;
+exports.isFirstRun = isFirstRun;
+exports.getContextualTrigger = getContextualTrigger;
+exports.checkAchievements = checkAchievements;
+exports.formatAchievement = formatAchievement;
+exports.recordCommand = recordCommand;
+exports.getLevelDisplay = getLevelDisplay;
+exports.formatProfileSummary = formatProfileSummary;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const theme_1 = require("./theme");
+const theme_2 = require("./theme");
+// ─── Profile Storage ───────────────────────────────────────────────────────
+const PROFILE_DIR = path_1.default.join(os_1.default.homedir(), '.codymaster');
+const PROFILE_FILE = path_1.default.join(PROFILE_DIR, 'profile.json');
+const DEFAULT_PROFILE = {
+    userName: '',
+    platform: '',
+    onboardingStep: 0,
+    onboardingComplete: false,
+    firstRunAt: '',
+    lastRunAt: '',
+    totalCommands: 0,
+    streak: 0,
+    lastStreakDate: '',
+    level: 'beginner',
+    achievements: [],
+    commandHistory: {},
+    skillsUsed: [],
+};
+/**
+ * Load user profile from disk
+ */
+function loadProfile() {
+    try {
+        if (fs_1.default.existsSync(PROFILE_FILE)) {
+            const raw = fs_1.default.readFileSync(PROFILE_FILE, 'utf-8');
+            return Object.assign(Object.assign({}, DEFAULT_PROFILE), JSON.parse(raw));
+        }
+    }
+    catch ( /* ignore */_a) { /* ignore */ }
+    return Object.assign({}, DEFAULT_PROFILE);
+}
+/**
+ * Save user profile to disk
+ */
+function saveProfile(profile) {
+    try {
+        if (!fs_1.default.existsSync(PROFILE_DIR)) {
+            fs_1.default.mkdirSync(PROFILE_DIR, { recursive: true });
+        }
+        fs_1.default.writeFileSync(PROFILE_FILE, JSON.stringify(profile, null, 2));
+    }
+    catch ( /* ignore */_a) { /* ignore */ }
+}
+/**
+ * Check if this is the first run (profile doesn't exist)
+ */
+function isFirstRun() {
+    return !fs_1.default.existsSync(PROFILE_FILE);
+}
+/**
+ * Get a contextual trigger message based on user data
+ * Hook Model: External trigger that becomes internal over time
+ */
+function getContextualTrigger(profile, ctx) {
+    const now = new Date();
+    const lastRun = profile.lastRunAt ? new Date(profile.lastRunAt) : null;
+    const hoursSinceLastRun = lastRun ? (now.getTime() - lastRun.getTime()) / 3600000 : 999;
+    // Re-engagement trigger
+    if (hoursSinceLastRun > 48) {
+        return `Haven't seen you in a while! 👋 Let's get back to it`;
+    }
+    // Streak trigger  
+    if (profile.streak >= 3) {
+        return `${theme_2.ICONS.fire} ${profile.streak}-day streak! Keep it going!`;
+    }
+    // Task-based triggers
+    if ((ctx === null || ctx === void 0 ? void 0 : ctx.tasksInProgress) && ctx.tasksInProgress > 0) {
+        return `${ctx.tasksInProgress} task${ctx.tasksInProgress > 1 ? 's' : ''} cooking! ${theme_2.ICONS.hamster}`;
+    }
+    if ((ctx === null || ctx === void 0 ? void 0 : ctx.tasksInReview) && ctx.tasksInReview > 0) {
+        return `${ctx.tasksInReview} task${ctx.tasksInReview > 1 ? 's' : ''} waiting for review 👀`;
+    }
+    if ((ctx === null || ctx === void 0 ? void 0 : ctx.totalTasks) === 0) {
+        return `Clean slate! What shall we build? 🏗️`;
+    }
+    if ((ctx === null || ctx === void 0 ? void 0 : ctx.tasksDone) && ctx.totalTasks && ctx.tasksDone === ctx.totalTasks) {
+        return `All clear! ${theme_2.ICONS.star} What's next?`;
+    }
+    // Default
+    return `Ready when you are! ${theme_2.ICONS.hamster}`;
+}
+// ─── VARIABLE REWARD: Achievement System ───────────────────────────────────
+const ACHIEVEMENTS = {
+    'first_run': { name: 'Hello World', emoji: '👋', desc: 'First time running CodyMaster' },
+    'first_task': { name: 'Task Master', emoji: '✅', desc: 'Created your first task' },
+    'first_done': { name: 'Shipper', emoji: '🚀', desc: 'Completed your first task' },
+    'five_tasks': { name: 'Busy Bee', emoji: '🐝', desc: 'Created 5 tasks' },
+    'first_deploy': { name: 'Deploy Hero', emoji: '🦸', desc: 'First deployment recorded' },
+    'first_skill': { name: 'Skill Hunter', emoji: '🧩', desc: 'Used your first skill' },
+    'streak_3': { name: 'On Fire', emoji: '🔥', desc: '3-day usage streak' },
+    'streak_7': { name: 'Committed', emoji: '💎', desc: '7-day usage streak' },
+    'commands_50': { name: 'Power User', emoji: '⚡', desc: '50 commands executed' },
+    'commands_100': { name: 'CLI Ninja', emoji: '🥷', desc: '100 commands executed' },
+    'level_builder': { name: 'Builder', emoji: '🏗️', desc: 'Reached Builder level' },
+    'level_master': { name: 'Master', emoji: '🏆', desc: 'Reached Master level' },
+};
+/**
+ * Check and unlock new achievements
+ * Returns newly unlocked achievements
+ */
+function checkAchievements(profile) {
+    const newAchievements = [];
+    const check = (id, condition) => {
+        if (condition && !profile.achievements.includes(id)) {
+            profile.achievements.push(id);
+            newAchievements.push(id);
+        }
+    };
+    check('first_run', profile.totalCommands >= 1);
+    check('first_task', (profile.commandHistory['task add'] || 0) >= 1);
+    check('five_tasks', (profile.commandHistory['task add'] || 0) >= 5);
+    check('first_done', (profile.commandHistory['task done'] || 0) >= 1);
+    check('first_deploy', (profile.commandHistory['deploy'] || 0) >= 1);
+    check('first_skill', profile.skillsUsed.length >= 1);
+    check('streak_3', profile.streak >= 3);
+    check('streak_7', profile.streak >= 7);
+    check('commands_50', profile.totalCommands >= 50);
+    check('commands_100', profile.totalCommands >= 100);
+    check('level_builder', profile.level === 'builder' || profile.level === 'master' || profile.level === 'legend');
+    check('level_master', profile.level === 'master' || profile.level === 'legend');
+    return newAchievements;
+}
+/**
+ * Format achievement unlock message
+ */
+function formatAchievement(id) {
+    const a = ACHIEVEMENTS[id];
+    if (!a)
+        return '';
+    return `  ${a.emoji} ${(0, theme_1.success)('Achievement Unlocked:')} ${(0, theme_1.brand)(a.name)} — ${(0, theme_1.dim)(a.desc)}`;
+}
+// ─── INVESTMENT: Track & Level Up ──────────────────────────────────────────
+/**
+ * Record a command execution (Investment phase)
+ * Updates profile with usage data → CLI becomes more personal
+ */
+function recordCommand(profile, command) {
+    const now = new Date();
+    const today = now.toISOString().split('T')[0];
+    // Update totals
+    profile.totalCommands++;
+    profile.commandHistory[command] = (profile.commandHistory[command] || 0) + 1;
+    profile.lastRunAt = now.toISOString();
+    // First run
+    if (!profile.firstRunAt) {
+        profile.firstRunAt = now.toISOString();
+    }
+    // Streak calculation
+    if (profile.lastStreakDate !== today) {
+        const yesterday = new Date(now);
+        yesterday.setDate(yesterday.getDate() - 1);
+        const yesterdayStr = yesterday.toISOString().split('T')[0];
+        if (profile.lastStreakDate === yesterdayStr) {
+            profile.streak++;
+        }
+        else if (profile.lastStreakDate !== today) {
+            profile.streak = 1;
+        }
+        profile.lastStreakDate = today;
+    }
+    // Level calculation
+    updateLevel(profile);
+}
+function updateLevel(profile) {
+    const cmds = profile.totalCommands;
+    const skills = profile.skillsUsed.length;
+    if (cmds >= 100 && skills >= 10) {
+        profile.level = 'legend';
+    }
+    else if (cmds >= 50 && skills >= 5) {
+        profile.level = 'master';
+    }
+    else if (cmds >= 10 && skills >= 1) {
+        profile.level = 'builder';
+    }
+    else {
+        profile.level = 'beginner';
+    }
+}
+/**
+ * Get level display with emoji
+ */
+function getLevelDisplay(level) {
+    const levels = {
+        beginner: { emoji: '🌱', color: theme_1.dim },
+        builder: { emoji: '🏗️', color: theme_1.info },
+        master: { emoji: '🏆', color: theme_1.brand },
+        legend: { emoji: '👑', color: theme_1.success },
+    };
+    const l = levels[level] || levels.beginner;
+    return `${l.emoji} ${l.color(level.charAt(0).toUpperCase() + level.slice(1))}`;
+}
+/**
+ * Format profile summary for `cm profile` command
+ */
+function formatProfileSummary(profile) {
+    const lines = [
+        '',
+        `  ${(0, theme_1.brand)('🐹 Your Profile')}`,
+        '',
+        `  ${(0, theme_1.dim)('Name:')}     ${profile.userName || (0, theme_1.dim)('(not set)')}`,
+        `  ${(0, theme_1.dim)('Level:')}    ${getLevelDisplay(profile.level)}`,
+        `  ${(0, theme_1.dim)('Streak:')}   ${profile.streak > 0 ? `${theme_2.ICONS.fire} ${(0, theme_1.brand)(String(profile.streak))} days` : (0, theme_1.dim)('Start today!')}`,
+        `  ${(0, theme_1.dim)('Commands:')} ${(0, theme_1.brand)(String(profile.totalCommands))} total`,
+        `  ${(0, theme_1.dim)('Platform:')} ${profile.platform || (0, theme_1.dim)('(auto-detect)')}`,
+        '',
+    ];
+    // Achievements
+    if (profile.achievements.length > 0) {
+        lines.push(`  ${(0, theme_1.brand)('Achievements')} (${profile.achievements.length}/${Object.keys(ACHIEVEMENTS).length})`);
+        for (const id of profile.achievements) {
+            const a = ACHIEVEMENTS[id];
+            if (a)
+                lines.push(`    ${a.emoji} ${a.name}`);
+        }
+        lines.push('');
+    }
+    // Top commands
+    const topCmds = Object.entries(profile.commandHistory)
+        .sort(([, a], [, b]) => b - a)
+        .slice(0, 5);
+    if (topCmds.length > 0) {
+        lines.push(`  ${(0, theme_1.brand)('Top Commands')}`);
+        for (const [cmd, count] of topCmds) {
+            lines.push(`    ${(0, theme_1.dim)('cm')} ${cmd} ${(0, theme_1.muted)(`×${count}`)}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}

package/dist/ui/onboarding.js

@@ -0,0 +1,315 @@
+"use strict";
+/**
+ * 🎳 Self-Onboarding System — Bowling Alley / Straight-Line Onboarding
+ * Based on ProductLed EUREKA framework by Ramli John
+ *
+ * 5 Steps → First Strike (Aha! moment) → Power User
+ * Each step: ONE action + bumpers to prevent confusion
+ */
+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;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runOnboarding = runOnboarding;
+exports.showReturningWelcome = showReturningWelcome;
+const theme_1 = require("./theme");
+const theme_2 = require("./theme");
+const box_1 = require("./box");
+const hamster_1 = require("./hamster");
+const hooks_1 = require("./hooks");
+// ─── Onboarding Steps ──────────────────────────────────────────────────────
+const TOTAL_STEPS = 5;
+const STEP_INFO = {
+    1: { title: 'Meet your assistant', desc: 'What should I call you?' },
+    2: { title: 'Pick your platform', desc: 'Where do you code?' },
+    3: { title: 'Your first task', desc: 'Add something to build' },
+    4: { title: 'See the magic', desc: 'Discover your 34 skills' },
+    5: { title: 'You\'re ready!', desc: 'Welcome to the team' },
+};
+/**
+ * Run the full onboarding wizard
+ * Returns the updated profile
+ */
+function runOnboarding(version) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const profile = (0, hooks_1.loadProfile)();
+        const p = (yield Promise.resolve().then(() => __importStar(require('@clack/prompts')))).default || (yield Promise.resolve().then(() => __importStar(require('@clack/prompts'))));
+        // If already complete, skip
+        if (profile.onboardingComplete)
+            return profile;
+        const startStep = profile.onboardingStep || 0;
+        // ─── STEP 1: Name ──────────────────────────────
+        if (startStep < 1) {
+            console.clear();
+            console.log('');
+            console.log((0, hamster_1.getHamsterArt)('greeting'));
+            console.log('');
+            console.log(`    ${(0, theme_1.brandBold)('Hi there! I\'m Cody')} ${theme_2.ICONS.hamster}`);
+            console.log(`    ${(0, theme_1.dim)('Your smart coding companion.')}`);
+            console.log('');
+            console.log((0, box_1.renderStepProgress)(1, TOTAL_STEPS));
+            console.log('');
+            const nameResult = yield p.text({
+                message: 'What should I call you?',
+                placeholder: 'Your name',
+                validate: (val) => {
+                    if (!val || val.trim().length === 0)
+                        return 'Just type your name — even a nickname works!';
+                    if (val.trim().length > 30)
+                        return 'That\'s a bit long! Try a shorter name';
+                    return undefined;
+                },
+            });
+            if (p.isCancel(nameResult)) {
+                console.log((0, theme_1.dim)('\n  No worries! Run cm again anytime. 👋\n'));
+                process.exit(0);
+            }
+            profile.userName = nameResult.trim();
+            profile.onboardingStep = 1;
+            profile.firstRunAt = new Date().toISOString();
+            (0, hooks_1.saveProfile)(profile);
+        }
+        // ─── STEP 2: Platform ──────────────────────────
+        if (startStep < 2) {
+            console.log('');
+            console.log(`    ${(0, theme_1.success)('✓')} ${(0, theme_1.dim)('Nice to meet you,')} ${(0, theme_1.brand)(profile.userName)}${(0, theme_1.dim)('!')}`);
+            console.log('');
+            console.log((0, box_1.renderStepProgress)(2, TOTAL_STEPS));
+            console.log('');
+            const platformResult = yield p.select({
+                message: 'Where do you code?',
+                options: [
+                    { label: '✦  Google Antigravity (Gemini)', value: 'gemini', hint: 'recommended' },
+                    { label: '🟣 Claude Code', value: 'claude', hint: 'plugin system' },
+                    { label: '⬡  Cursor', value: 'cursor', hint: 'rules directory' },
+                    { label: '🌊 Windsurf', value: 'windsurf', hint: 'rules directory' },
+                    { label: '🔶 Cline / RooCode', value: 'cline', hint: 'skills directory' },
+                    { label: '📦 OpenCode', value: 'opencode', hint: 'skills directory' },
+                    { label: '🪁 Kiro', value: 'kiro', hint: 'steering docs' },
+                    { label: '🤖 GitHub Copilot', value: 'copilot', hint: 'auto-context' },
+                    { label: '🔧 Other / Not sure', value: 'other', hint: 'auto-detect' },
+                ],
+            });
+            if (p.isCancel(platformResult)) {
+                profile.onboardingStep = 1;
+                (0, hooks_1.saveProfile)(profile);
+                console.log((0, theme_1.dim)('\n  No worries! Run cm again to continue. 👋\n'));
+                process.exit(0);
+            }
+            profile.platform = platformResult;
+            profile.onboardingStep = 2;
+            (0, hooks_1.saveProfile)(profile);
+        }
+        // ─── STEP 3: First Task (The First Strike 🎳) ──
+        if (startStep < 3) {
+            console.log('');
+            console.log(`    ${(0, theme_1.success)('✓')} ${(0, theme_1.dim)('Great choice!')} ${(0, theme_1.brand)(profile.platform)}`);
+            console.log('');
+            console.log((0, box_1.renderStepProgress)(3, TOTAL_STEPS));
+            console.log('');
+            console.log(`    ${(0, theme_1.brandBold)('Let\'s add your first task!')} ${theme_2.ICONS.sparkle}`);
+            console.log(`    ${(0, theme_1.dim)('This is what you want to build or work on.')}`);
+            console.log('');
+            const taskResult = yield p.text({
+                message: 'What are you working on?',
+                placeholder: 'e.g., "Build my landing page"',
+                validate: (val) => {
+                    if (!val || val.trim().length === 0)
+                        return 'Just describe what you\'re building — keep it simple!';
+                    return undefined;
+                },
+            });
+            if (p.isCancel(taskResult)) {
+                profile.onboardingStep = 2;
+                (0, hooks_1.saveProfile)(profile);
+                console.log((0, theme_1.dim)('\n  No worries! Run cm again to continue. 👋\n'));
+                process.exit(0);
+            }
+            // Actually create the task
+            const taskTitle = taskResult.trim();
+            try {
+                const { loadData, saveData, logActivity, shortId, DATA_FILE } = yield Promise.resolve().then(() => __importStar(require('../data')));
+                const crypto = yield Promise.resolve().then(() => __importStar(require('crypto')));
+                const data = loadData();
+                // Ensure default project exists
+                if (data.projects.length === 0) {
+                    const dp = {
+                        id: crypto.randomUUID(),
+                        name: 'My Project',
+                        path: process.cwd(),
+                        agents: [],
+                        createdAt: new Date().toISOString(),
+                    };
+                    data.projects.push(dp);
+                }
+                const projectId = data.projects[0].id;
+                const now = new Date().toISOString();
+                const task = {
+                    id: crypto.randomUUID(),
+                    projectId,
+                    title: taskTitle,
+                    description: '',
+                    column: 'backlog',
+                    order: 0,
+                    priority: 'medium',
+                    agent: '',
+                    skill: '',
+                    createdAt: now,
+                    updatedAt: now,
+                };
+                data.tasks.push(task);
+                logActivity(data, 'task_created', `Task "${taskTitle}" created during onboarding`, projectId);
+                saveData(data);
+                console.log('');
+                console.log((0, hamster_1.getHamsterArt)('celebrating'));
+                console.log('');
+                console.log(`    ${(0, theme_1.success)('✅')} ${(0, theme_1.brandBold)('First task created!')} ${(0, hamster_1.getCelebration)()}`);
+                console.log(`    ${(0, theme_1.dim)(`"${taskTitle}"`)}`);
+                console.log('');
+            }
+            catch (_a) {
+                console.log('');
+                console.log(`    ${(0, theme_1.success)('✓')} ${(0, theme_1.dim)('Got it!')} ${(0, theme_1.brand)(taskTitle)}`);
+                console.log('');
+            }
+            profile.onboardingStep = 3;
+            (0, hooks_1.recordCommand)(profile, 'task add');
+            (0, hooks_1.saveProfile)(profile);
+        }
+        // ─── STEP 4: Skill Discovery ───────────────────
+        if (startStep < 4) {
+            console.log((0, box_1.renderStepProgress)(4, TOTAL_STEPS));
+            console.log('');
+            console.log(`    ${(0, theme_1.brandBold)('You have 34 superpowers!')} ${theme_2.ICONS.skill}`);
+            console.log(`    ${(0, theme_1.dim)('Grouped by what they help you do:')}`);
+            console.log('');
+            const SKILL_DOMAINS = [
+                { domain: '⚙️  Engineering', skills: [
+                        { name: 'cm-tdd', desc: 'Test-driven development' },
+                        { name: 'cm-debugging', desc: 'Smart bug hunting' },
+                        { name: 'cm-quality-gate', desc: 'Pre-deploy verification' },
+                    ] },
+                { domain: '🚀 Operations', skills: [
+                        { name: 'cm-safe-deploy', desc: 'Multi-gate deploy' },
+                        { name: 'cm-secret-shield', desc: 'Secret scanning' },
+                        { name: 'cm-git-worktrees', desc: 'Isolated branches' },
+                    ] },
+                { domain: '🎨 Product & Design', skills: [
+                        { name: 'cm-planning', desc: 'Plan before you code' },
+                        { name: 'cm-ui-preview', desc: 'AI-powered UI design' },
+                        { name: 'cm-ux-master', desc: '48 UX Laws + design system' },
+                    ] },
+                { domain: '📈 Growth & Content', skills: [
+                        { name: 'cm-content-factory', desc: 'Self-learning content engine' },
+                        { name: 'cm-ads-tracker', desc: 'Conversion tracking setup' },
+                        { name: 'cro-methodology', desc: 'Conversion rate optimization' },
+                    ] },
+                { domain: '🤖 Orchestration', skills: [
+                        { name: 'cm-execution', desc: 'Parallel agent dispatch' },
+                        { name: 'cm-skill-chain', desc: 'Multi-skill pipelines' },
+                        { name: 'cm-continuity', desc: 'Working memory protocol' },
+                    ] },
+                { domain: '🔧 Workflow', skills: [
+                        { name: 'cm-start', desc: 'Idea → production code' },
+                        { name: 'cm-project-bootstrap', desc: 'Zero-to-production setup' },
+                        { name: 'cm-dashboard', desc: 'Visual Mission Control' },
+                    ] },
+            ];
+            for (const d of SKILL_DOMAINS) {
+                console.log(`    ${(0, theme_1.brand)(d.domain)}`);
+                for (const s of d.skills) {
+                    console.log(`      ${(0, theme_1.dim)('›')} ${s.name.padEnd(22)} ${(0, theme_1.muted)(s.desc)}`);
+                }
+                console.log('');
+            }
+            console.log(`    ${(0, theme_1.dim)(`Total: 34 skills across 6 domains`)}`);
+            console.log('');
+            const viewAll = yield p.confirm({
+                message: 'Want to browse all 34 skills in detail?',
+                initialValue: false,
+            });
+            profile.onboardingStep = 4;
+            (0, hooks_1.saveProfile)(profile);
+            if (viewAll === true) {
+                console.log((0, theme_1.dim)('\n  Run: cm list   to see all skills\n'));
+            }
+        }
+        // ─── STEP 5: Complete! 🎉 ──────────────────────
+        if (startStep < 5) {
+            console.log('');
+            console.log((0, box_1.renderStepProgress)(5, TOTAL_STEPS));
+            console.log('');
+            console.log((0, hamster_1.getHamsterArt)('celebrating'));
+            console.log('');
+            console.log(`    ${(0, theme_1.success)('🎉')} ${(0, theme_1.brandBold)(`You're all set, ${profile.userName}!`)}`);
+            console.log('');
+            const quickRef = [
+                `${(0, theme_1.brand)('cm')}                 ${(0, theme_1.dim)('Quick menu')}`,
+                `${(0, theme_1.brand)('cm task add')} ${(0, theme_1.dim)('"..."')}  ${(0, theme_1.dim)('Add a task')}`,
+                `${(0, theme_1.brand)('cm status')}           ${(0, theme_1.dim)('See progress')}`,
+                `${(0, theme_1.brand)('cm list')}             ${(0, theme_1.dim)('Browse skills')}`,
+                `${(0, theme_1.brand)('cm dashboard')}        ${(0, theme_1.dim)('Open Mission Control')}`,
+                `${(0, theme_1.brand)('cm profile')}          ${(0, theme_1.dim)('Your stats & achievements')}`,
+            ];
+            console.log((0, box_1.renderBox)(quickRef, { title: 'Quick Reference', width: 52 }));
+            console.log('');
+            profile.onboardingStep = 5;
+            profile.onboardingComplete = true;
+            const newAchievements = (0, hooks_1.checkAchievements)(profile);
+            (0, hooks_1.saveProfile)(profile);
+            // Show achievements
+            for (const id of newAchievements) {
+                console.log((0, hooks_1.formatAchievement)(id));
+            }
+            if (newAchievements.length > 0)
+                console.log('');
+        }
+        return profile;
+    });
+}
+/**
+ * Show returning user welcome (post-onboarding)
+ * Displays hamster + trigger + quick action
+ */
+function showReturningWelcome(profile, version, cwd) {
+    console.log((0, hamster_1.renderHamsterBanner)(profile.userName, version, cwd));
+}

package/dist/ui/theme.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * 🎨 CodyMaster Theme — Centralized color palette & styling
+ * Warm amber/orange accent system for the Hamster Shell
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ICONS = exports.STATUS = exports.PRI = exports.COL = exports.info = exports.warning = exports.error = exports.success = exports.text = exports.muted = exports.dim = exports.brandBg = exports.brandBold = exports.brand = exports.COLORS = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+// ─── Brand Colors ──────────────────────────────────────────────────────────
+exports.COLORS = {
+    // Primary brand
+    primary: '#F59E0B', // Amber/orange
+    primaryDim: '#D97706',
+    primaryBright: '#FBBF24',
+    // Backgrounds
+    bg: '#1a1b26',
+    bgPanel: '#24283b',
+    // Status
+    success: '#10B981',
+    error: '#EF4444',
+    warning: '#F59E0B',
+    info: '#3B82F6',
+    // Task columns
+    backlog: '#6B7280',
+    inProgress: '#3B82F6',
+    review: '#F59E0B',
+    done: '#10B981',
+    // Priority
+    low: '#10B981',
+    medium: '#F59E0B',
+    high: '#EF4444',
+    urgent: '#A855F7',
+    // Text
+    text: '#E5E7EB',
+    textDim: '#6B7280',
+    textMuted: '#4B5563',
+};
+// ─── Chalk Helpers ─────────────────────────────────────────────────────────
+exports.brand = chalk_1.default.hex(exports.COLORS.primary);
+exports.brandBold = chalk_1.default.hex(exports.COLORS.primary).bold;
+exports.brandBg = chalk_1.default.bgHex(exports.COLORS.primary).black;
+exports.dim = chalk_1.default.hex(exports.COLORS.textDim);
+exports.muted = chalk_1.default.hex(exports.COLORS.textMuted);
+exports.text = chalk_1.default.hex(exports.COLORS.text);
+exports.success = chalk_1.default.hex(exports.COLORS.success);
+exports.error = chalk_1.default.hex(exports.COLORS.error);
+exports.warning = chalk_1.default.hex(exports.COLORS.warning);
+exports.info = chalk_1.default.hex(exports.COLORS.info);
+// Column colors
+exports.COL = {
+    backlog: chalk_1.default.hex(exports.COLORS.backlog),
+    'in-progress': chalk_1.default.hex(exports.COLORS.inProgress),
+    review: chalk_1.default.hex(exports.COLORS.review),
+    done: chalk_1.default.hex(exports.COLORS.done),
+};
+// Priority colors
+exports.PRI = {
+    low: chalk_1.default.hex(exports.COLORS.low),
+    medium: chalk_1.default.hex(exports.COLORS.medium),
+    high: chalk_1.default.hex(exports.COLORS.high),
+    urgent: chalk_1.default.hex(exports.COLORS.urgent),
+};
+// Status colors
+exports.STATUS = {
+    success: chalk_1.default.hex(exports.COLORS.success),
+    failed: chalk_1.default.hex(exports.COLORS.error),
+    pending: chalk_1.default.hex(exports.COLORS.warning),
+    running: chalk_1.default.hex(exports.COLORS.inProgress),
+    rolled_back: chalk_1.default.hex(exports.COLORS.urgent),
+};
+// ─── Icons ─────────────────────────────────────────────────────────────────
+exports.ICONS = {
+    // Status
+    dot: '●',
+    dotEmpty: '○',
+    check: '✓',
+    cross: '✗',
+    arrow: '›',
+    arrowRight: '→',
+    // Categories
+    task: '📋',
+    project: '📦',
+    deploy: '🚀',
+    skill: '🧩',
+    dashboard: '📊',
+    history: '📜',
+    settings: '⚙️',
+    // Status
+    success: '✅',
+    error: '❌',
+    warning: '⚠️',
+    info: 'ℹ️',
+    // Hamster
+    hamster: '🐹',
+    fire: '🔥',
+    star: '⭐',
+    trophy: '🏆',
+    sparkle: '✨',
+    party: '🎉',
+    muscle: '💪',
+    rocket: '🚀',
+};