@su-record/vibe 2.6.35 → 2.6.41

package/dist/cli/index.js

@@ -1,25 +1,10 @@
 #!/usr/bin/env node
 /**
- * vibe CLI (TypeScript version 2.0)
- * SPEC-driven AI coding framework (Claude Code exclusive)
+ * core CLI — SPEC-driven AI coding framework (Claude Code exclusive)
  */
-import path from 'path';
-import fs from 'fs';
-import os from 'os';
-import { execSync } from 'child_process';
-import { fileURLToPath } from 'url';
-import { createRequire } from 'module';
-import { log, setSilentMode, ensureDir, removeDirRecursive, getPackageJson, compareVersions, } from './utils.js';
-import { detectTechStacks } from './detect.js';
-import { formatLLMStatus, getLLMAuthStatus } from './auth.js';
-import { setupCollaboratorAutoInstall } from './collaborator.js';
-import { setupExternalLLM, removeExternalLLM, gptAuth, gptStatus, gptLogout, geminiAuth, geminiStatus, geminiLogout, } from './llm.js';
-import { updateConstitution, updateClaudeMd, updateRules, migrateLegacyVibe, updateGitignore, updateConfig, cleanupLegacy, removeLocalAssets, cleanupClaudeConfig, cleanupLegacyMcp, installProjectHooks, installCursorRules, } from './setup.js';
-import { showHud, startHud, updateHudPhase, manageHudAgent, updateHudContext, resetHud, showHudHelp, } from './hud.js';
-import { installCursorAgents, generateCursorRules, generateCursorSkills, } from './postinstall.js';
-const require = createRequire(import.meta.url);
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
+import { setSilentMode } from './utils.js';
+import { setupExternalLLM, removeExternalLLM, gptAuth, gptStatus, gptLogout, geminiAuth, geminiStatus, geminiLogout, claudeStatus, claudeLogout, } from './llm.js';
+import { init, setup, update, upgrade, remove, showHelp, showStatus, showVersion, syncLogin, syncPush, syncPull, syncStatus, syncLogout, telegramSetup, telegramChat, telegramStatus, telegramHelp, slackSetup, slackChannel, slackStatus, slackHelp, } from './commands/index.js';
 // ============================================================================
 // Constants
 // ============================================================================
@@ -28,458 +13,16 @@ const command = args[0];
 const options = {
     silent: args.includes('--silent') || args.includes('-s')
 };
-const skipUpgrade = args.includes('--skip-upgrade');
 const positionalArgs = args.filter(arg => !arg.startsWith('-'));
 // Silent 모드 설정
 setSilentMode(options.silent);
 // ============================================================================
-// Helper Functions
-// ============================================================================
-/**
- * Update global Cursor assets (agents, rules, skills)
- * Called by both vibe init and vibe update
- * @param detectedStacks - 감지된 기술 스택 배열 (예: ['typescript-react', 'python-fastapi'])
- */
-function updateCursorGlobalAssets(detectedStacks = []) {
-    try {
-        const packageRoot = path.resolve(__dirname, '..', '..');
-        const agentsSource = path.join(packageRoot, 'agents');
-        // VIBE 언어 룰 디렉토리 (~/.claude/vibe/languages/ 또는 패키지 내 languages/)
-        const globalLanguagesDir = path.join(os.homedir(), '.claude', 'vibe', 'languages');
-        const packageLanguagesDir = path.join(packageRoot, 'languages');
-        const languagesDir = fs.existsSync(globalLanguagesDir) ? globalLanguagesDir : packageLanguagesDir;
-        // 1. Cursor agents (12 reviewers)
-        const cursorAgentsDir = path.join(os.homedir(), '.cursor', 'agents');
-        if (fs.existsSync(agentsSource)) {
-            installCursorAgents(agentsSource, cursorAgentsDir);
-        }
-        // 2. Cursor rules template (VIBE 언어 룰 기반 + 공통 룰)
-        const cursorRulesTemplateDir = path.join(os.homedir(), '.cursor', 'rules-template');
-        generateCursorRules(cursorRulesTemplateDir, detectedStacks, languagesDir);
-        // 3. Cursor skills (7 VIBE skills)
-        const cursorSkillsDir = path.join(os.homedir(), '.cursor', 'skills');
-        generateCursorSkills(cursorSkillsDir);
-    }
-    catch (err) {
-        // Non-critical - don't fail init/update
-        if (!options.silent) {
-            console.warn(`   ⚠️ Cursor assets update warning: ${err.message}`);
-        }
-    }
-}
-// ============================================================================
-// Main Commands
-// ============================================================================
-async function init(projectName) {
-    try {
-        let projectRoot = process.cwd();
-        let isNewProject = false;
-        if (projectName) {
-            projectRoot = path.join(process.cwd(), projectName);
-            if (fs.existsSync(projectRoot)) {
-                log(`❌ Folder already exists: ${projectName}/`);
-                return;
-            }
-            log(`📁 Creating project: ${projectName}/\n`);
-            fs.mkdirSync(projectRoot, { recursive: true });
-            isNewProject = true;
-        }
-        const claudeDir = path.join(projectRoot, '.claude');
-        const vibeDir = path.join(claudeDir, 'vibe');
-        if (fs.existsSync(vibeDir)) {
-            log('❌ .claude/vibe/ already exists.');
-            return;
-        }
-        ensureDir(vibeDir);
-        // 레거시 마이그레이션
-        migrateLegacyVibe(projectRoot, vibeDir);
-        // .gitignore 업데이트
-        updateGitignore(projectRoot);
-        // 기술 스택 감지
-        const { stacks: detectedStacks, details: stackDetails } = detectTechStacks(projectRoot);
-        if (detectedStacks.length > 0) {
-            log(`   🔍 Detected stacks:\n`);
-            detectedStacks.forEach(s => {
-                log(`      - ${s.type}${s.path ? ` (${s.path}/)` : ''}\n`);
-            });
-            if (stackDetails.databases.length > 0) {
-                log(`      - DB: ${stackDetails.databases.join(', ')}\n`);
-            }
-            if (stackDetails.stateManagement.length > 0) {
-                log(`      - State: ${stackDetails.stateManagement.join(', ')}\n`);
-            }
-        }
-        // constitution.md 생성
-        updateConstitution(vibeDir, detectedStacks, stackDetails);
-        // config.json 생성
-        updateConfig(vibeDir, detectedStacks, stackDetails, false);
-        // CLAUDE.md 병합
-        updateClaudeMd(projectRoot, detectedStacks, false);
-        // 규칙 복사
-        updateRules(vibeDir, detectedStacks, false);
-        // 협업자 자동 설치 설정
-        setupCollaboratorAutoInstall(projectRoot);
-        // 프로젝트 레벨 훅 설치
-        installProjectHooks(projectRoot);
-        // Cursor 글로벌 에셋 업데이트 (agents, skills, rules-template) - 먼저 실행!
-        const stackTypes = detectedStacks.map(s => s.type);
-        updateCursorGlobalAssets(stackTypes);
-        // Cursor IDE 룰 설치 (프로젝트 레벨) - rules-template 생성 후 현재 스택에 해당하는 룰만 복사
-        installCursorRules(projectRoot, stackTypes);
-        // 완료 메시지
-        const packageJson = getPackageJson();
-        log(`✅ vibe initialized (v${packageJson.version})
-${formatLLMStatus()}
-📦 Context7 plugin (recommended): /plugin install context7
-
-Next: ${isNewProject ? `cd ${projectName} && ` : ''}/vibe.spec "feature"
-`);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error('❌ Init failed:', message);
-        process.exit(1);
-    }
-}
-async function checkAndUpgradeVibe() {
-    const currentVersion = getPackageJson().version;
-    try {
-        const latestVersion = execSync('npm view @su-record/vibe version', {
-            encoding: 'utf-8',
-            stdio: ['pipe', 'pipe', 'pipe']
-        }).trim();
-        const isNewer = compareVersions(latestVersion, currentVersion) > 0;
-        if (isNewer) {
-            log(`⬆️ Upgrading v${currentVersion} → v${latestVersion}...\n`);
-            execSync('npm install -g @su-record/vibe@latest', {
-                stdio: options.silent ? 'pipe' : 'inherit'
-            });
-            // 업그레이드 완료 후 새 버전으로 설정 업데이트 (--skip-upgrade로 무한 루프 방지)
-            execSync(`vibe update --skip-upgrade${options.silent ? ' --silent' : ''}`, {
-                stdio: 'inherit',
-                cwd: process.cwd()
-            });
-            return true;
-        }
-        return false;
-    }
-    catch { /* ignore: optional operation */
-        return false;
-    }
-}
-async function update() {
-    try {
-        const projectRoot = process.cwd();
-        const vibeDir = path.join(projectRoot, '.claude', 'vibe');
-        const claudeDir = path.join(projectRoot, '.claude');
-        const legacyVibeDir = path.join(projectRoot, '.vibe');
-        // CI/프로덕션 환경에서는 스킵
-        if (process.env.NODE_ENV === 'production' || process.env.CI === 'true') {
-            return;
-        }
-        // 1. 최신 버전 확인 및 업그레이드 (전역 패키지 먼저)
-        // npm install -g 실행 시 postinstall이 전역 설정을 자동 처리
-        // --skip-upgrade 플래그가 있으면 업그레이드 체크 건너뜀 (무한 루프 방지)
-        if (!skipUpgrade) {
-            const wasUpgraded = await checkAndUpgradeVibe();
-            if (wasUpgraded)
-                return;
-        }
-        // 2. 프로젝트 설정 업데이트
-        // 레거시 마이그레이션
-        if (fs.existsSync(legacyVibeDir) && !fs.existsSync(vibeDir)) {
-            migrateLegacyVibe(projectRoot, vibeDir);
-        }
-        if (!fs.existsSync(vibeDir) && !fs.existsSync(legacyVibeDir)) {
-            // 프로젝트가 없어도 전역 업그레이드는 완료됨
-            const packageJson = getPackageJson();
-            log(`✅ vibe global updated (v${packageJson.version})
-${formatLLMStatus()}
-`);
-            return;
-        }
-        ensureDir(vibeDir);
-        // 레거시 정리
-        cleanupLegacy(projectRoot, claudeDir);
-        // 기술 스택 감지
-        const { stacks: detectedStacks, details: stackDetails } = detectTechStacks(projectRoot);
-        // config.json 업데이트
-        updateConfig(vibeDir, detectedStacks, stackDetails, true);
-        // constitution.md 업데이트
-        updateConstitution(vibeDir, detectedStacks, stackDetails);
-        // CLAUDE.md 업데이트
-        updateClaudeMd(projectRoot, detectedStacks, true);
-        // 규칙 업데이트
-        updateRules(vibeDir, detectedStacks, true);
-        // 프로젝트 로컬 자산 제거
-        removeLocalAssets(claudeDir);
-        // .gitignore 업데이트
-        updateGitignore(projectRoot);
-        // 협업자 자동 설치 설정
-        setupCollaboratorAutoInstall(projectRoot);
-        // 프로젝트 레벨 훅 설치
-        installProjectHooks(projectRoot);
-        // Cursor 글로벌 에셋 업데이트 (agents, skills, rules-template) - 먼저 실행!
-        const stackTypes = detectedStacks.map(s => s.type);
-        updateCursorGlobalAssets(stackTypes);
-        // Cursor IDE 룰 설치/업데이트 (프로젝트 레벨) - rules-template 생성 후 현재 스택에 해당하는 룰만 복사
-        installCursorRules(projectRoot, stackTypes);
-        // ~/.claude.json 정리
-        cleanupClaudeConfig();
-        // 레거시 mcp 폴더 정리
-        cleanupLegacyMcp(vibeDir);
-        const packageJson = getPackageJson();
-        log(`✅ vibe updated (v${packageJson.version})
-${formatLLMStatus()}
-📦 Context7 plugin (recommended): /plugin install context7
-`);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error('❌ Update failed:', message);
-        process.exit(1);
-    }
-}
-function remove() {
-    const projectRoot = process.cwd();
-    const vibeDir = path.join(projectRoot, '.claude', 'vibe');
-    const legacyVibeDir = path.join(projectRoot, '.vibe');
-    const claudeDir = path.join(projectRoot, '.claude');
-    if (!fs.existsSync(vibeDir) && !fs.existsSync(legacyVibeDir)) {
-        console.log('❌ Not a vibe project.');
-        return;
-    }
-    console.log('🗑️  Removing vibe...\n');
-    // .claude/vibe 폴더 제거
-    if (fs.existsSync(vibeDir)) {
-        removeDirRecursive(vibeDir);
-        console.log('   ✅ .claude/vibe/ removed\n');
-    }
-    // 레거시 .vibe 폴더도 제거
-    if (fs.existsSync(legacyVibeDir)) {
-        removeDirRecursive(legacyVibeDir);
-        console.log('   ✅ .vibe/ removed (legacy)\n');
-    }
-    // .claude/commands 제거
-    const commandsDir = path.join(claudeDir, 'commands');
-    if (fs.existsSync(commandsDir)) {
-        const vibeCommands = ['vibe.spec.md', 'vibe.run.md', 'vibe.verify.md', 'vibe.reason.md', 'vibe.analyze.md', 'vibe.ui.md', 'vibe.diagram.md'];
-        vibeCommands.forEach(cmd => {
-            const cmdPath = path.join(commandsDir, cmd);
-            if (fs.existsSync(cmdPath)) {
-                fs.unlinkSync(cmdPath);
-            }
-        });
-        console.log('   ✅ Slash commands removed\n');
-    }
-    // .claude/agents 제거
-    const agentsDir = path.join(claudeDir, 'agents');
-    if (fs.existsSync(agentsDir)) {
-        const vibeAgents = ['simplifier.md', 'explorer.md', 'implementer.md', 'tester.md', 'searcher.md'];
-        vibeAgents.forEach(agent => {
-            const agentPath = path.join(agentsDir, agent);
-            if (fs.existsSync(agentPath)) {
-                fs.unlinkSync(agentPath);
-            }
-        });
-        console.log('   ✅ Subagents removed\n');
-    }
-    // .claude/settings.json에서 hooks 제거
-    const settingsPath = path.join(claudeDir, 'settings.json');
-    if (fs.existsSync(settingsPath)) {
-        try {
-            const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
-            if (settings.hooks) {
-                delete settings.hooks;
-                fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
-                console.log('   ✅ Hooks removed\n');
-            }
-        }
-        catch { /* ignore: optional operation */ }
-    }
-    // Cursor 글로벌 에셋 제거
-    const cursorDir = path.join(os.homedir(), '.cursor');
-    // Cursor agents 제거 (12 reviewers)
-    const cursorAgentsDir = path.join(cursorDir, 'agents');
-    if (fs.existsSync(cursorAgentsDir)) {
-        const vibeReviewers = [
-            'security-reviewer.md', 'architecture-reviewer.md', 'data-integrity-reviewer.md',
-            'typescript-reviewer.md', 'python-reviewer.md', 'react-reviewer.md', 'rails-reviewer.md',
-            'performance-reviewer.md', 'complexity-reviewer.md', 'simplicity-reviewer.md',
-            'test-coverage-reviewer.md', 'git-history-reviewer.md'
-        ];
-        let removedAgents = 0;
-        vibeReviewers.forEach(agent => {
-            const agentPath = path.join(cursorAgentsDir, agent);
-            if (fs.existsSync(agentPath)) {
-                fs.unlinkSync(agentPath);
-                removedAgents++;
-            }
-        });
-        if (removedAgents > 0) {
-            console.log(`   ✅ Cursor agents removed (${removedAgents})\n`);
-        }
-    }
-    // Cursor skills 제거 (7 vibe skills)
-    const cursorSkillsDir = path.join(cursorDir, 'skills');
-    if (fs.existsSync(cursorSkillsDir)) {
-        const vibeSkills = ['vibe-spec', 'vibe-run', 'vibe-review', 'vibe-analyze', 'vibe-verify', 'vibe-reason', 'vibe-ui'];
-        let removedSkills = 0;
-        vibeSkills.forEach(skill => {
-            const skillDir = path.join(cursorSkillsDir, skill);
-            if (fs.existsSync(skillDir)) {
-                removeDirRecursive(skillDir);
-                removedSkills++;
-            }
-        });
-        if (removedSkills > 0) {
-            console.log(`   ✅ Cursor skills removed (${removedSkills})\n`);
-        }
-    }
-    // Cursor rules template 제거 (5 rules)
-    const cursorRulesDir = path.join(cursorDir, 'rules-template');
-    if (fs.existsSync(cursorRulesDir)) {
-        const vibeRules = [
-            'typescript-standards.mdc', 'react-patterns.mdc', 'code-quality.mdc',
-            'security-checklist.mdc', 'python-standards.mdc'
-        ];
-        let removedRules = 0;
-        vibeRules.forEach(rule => {
-            const rulePath = path.join(cursorRulesDir, rule);
-            if (fs.existsSync(rulePath)) {
-                fs.unlinkSync(rulePath);
-                removedRules++;
-            }
-        });
-        if (removedRules > 0) {
-            console.log(`   ✅ Cursor rules template removed (${removedRules})\n`);
-        }
-    }
-    console.log(`
-✅ vibe removed!
-
-Removed:
-  - MCP server (context7)
-  - .claude/vibe/ folder
-  - Slash commands (7)
-  - Subagents (5)
-  - Hooks settings
-  - Cursor agents (12)
-  - Cursor skills (7)
-  - Cursor rules template (5)
-
-To reinstall: vibe init
-  `);
-}
-// ============================================================================
-// Info Commands
-// ============================================================================
-function showHelp() {
-    console.log(`
-📖 Vibe - SPEC-driven AI coding framework (Claude Code exclusive)
-
-Commands:
-  vibe init [project]     Initialize project
-  vibe update             Update settings
-  vibe status             Show status
-  vibe hud [subcommand]   HUD status display
-  vibe help               Help
-  vibe version            Version
-
-GPT:
-  vibe gpt auth           OAuth authentication (Plus/Pro)
-  vibe gpt key <KEY>      Set API key
-  vibe gpt status         Check status
-  vibe gpt logout         Logout
-  vibe gpt remove         Remove config
-
-Gemini:
-  vibe gemini auth        OAuth authentication
-  vibe gemini key <KEY>   Set API key
-  vibe gemini status      Check status
-  vibe gemini logout      Logout
-  vibe gemini remove      Remove config
-
-Slash Commands (Claude Code):
-  /vibe.spec "feature"    Create SPEC + parallel research
-  /vibe.run "feature"     Execute implementation
-  /vibe.verify "feature"  BDD verification
-  /vibe.review            Parallel code review (13+ agents)
-  /vibe.reason "problem"  Systematic reasoning
-  /vibe.analyze           Project analysis
-  /vibe.utils             Utilities (--e2e, --diagram, --continue)
-
-Workflow:
-  /vibe.spec "feature" ultrawork    Full automation (SPEC→Review→Implement)
-  /vibe.spec → /vibe.run            Manual step-by-step
-
-Docs: https://github.com/su-record/vibe
-  `);
-}
-function showStatus() {
-    const projectRoot = process.cwd();
-    const vibeDir = path.join(projectRoot, '.claude', 'vibe');
-    const configPath = path.join(vibeDir, 'config.json');
-    const packageJson = getPackageJson();
-    const isVibeProject = fs.existsSync(vibeDir);
-    let config = { language: 'ko', models: {} };
-    if (isVibeProject && fs.existsSync(configPath)) {
-        config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-    }
-    // 실제 OAuth 인증 상태 확인 (전역 설정)
-    const authStatus = getLLMAuthStatus();
-    // GPT 상태: OAuth 인증 > config enabled
-    let gptStatusText = '⬚ Disabled';
-    if (authStatus.gpt?.valid) {
-        gptStatusText = authStatus.gpt.type === 'oauth'
-            ? `✅ OAuth (${authStatus.gpt.email})`
-            : '✅ API Key';
-    }
-    else if (config.models?.gpt?.enabled) {
-        gptStatusText = '⚠️  Configured (auth required)';
-    }
-    // Gemini 상태: OAuth 인증 > config enabled
-    let geminiStatusText = '⬚ Disabled';
-    if (authStatus.gemini?.valid) {
-        geminiStatusText = authStatus.gemini.type === 'oauth'
-            ? `✅ OAuth (${authStatus.gemini.email})`
-            : '✅ API Key';
-    }
-    else if (config.models?.gemini?.enabled) {
-        geminiStatusText = '⚠️  Configured (auth required)';
-    }
-    // 프로젝트 상태
-    const projectStatus = isVibeProject
-        ? `✅ ${projectRoot}`
-        : `⬚ Not a vibe project (run: vibe init)`;
-    console.log(`
-📊 Vibe Status (v${packageJson.version})
-
-Project: ${projectStatus}
-${isVibeProject ? `Language: ${config.language || 'ko'}` : ''}
-
-Models:
-  Opus 4.5          Orchestrator
-  Sonnet 4          Implementation
-  Haiku 4.5         Code exploration
-  GPT 5.2           ${gptStatusText}
-  Gemini 3          ${geminiStatusText}
-
-MCP:
-  context7          Library docs search
-  `);
-}
-function showVersion() {
-    const packageJson = getPackageJson();
-    console.log(`vibe v${packageJson.version}`);
-}
-// ============================================================================
 // Tool Exports (for slash commands)
 // ============================================================================
-export * from '../lib/MemoryManager.js';
-export * from '../lib/ProjectCache.js';
-export * from '../lib/ContextCompressor.js';
-export * from '../lib/ProgressTracker.js';
+export * from '../infra/lib/MemoryManager.js';
+export * from '../infra/lib/ProjectCache.js';
+export * from '../infra/lib/ContextCompressor.js';
+export * from '../infra/lib/ProgressTracker.js';
 export { saveMemory } from '../tools/memory/saveMemory.js';
 export { recallMemory } from '../tools/memory/recallMemory.js';
 export { listMemories } from '../tools/memory/listMemories.js';
@@ -512,13 +55,54 @@ switch (command) {
     case 'init':
         init(positionalArgs[1]);
         break;
+    case 'setup':
+        (async () => {
+            await setup();
+        })();
+        break;
     case 'update':
-        update();
+        update(options);
+        break;
+    case 'upgrade':
+        upgrade(options);
         break;
     case 'remove':
     case 'uninstall':
         remove();
         break;
+    // vibe claude <subcommand>
+    case 'claude': {
+        const subCommand = positionalArgs[1];
+        switch (subCommand) {
+            case 'key': {
+                const apiKey = positionalArgs[2] || args.find(a => !a.startsWith('-') && a !== 'claude' && a !== 'key');
+                if (apiKey) {
+                    setupExternalLLM('claude', apiKey);
+                }
+                else {
+                    console.log('Usage: vibe claude key <ANTHROPIC_API_KEY>');
+                }
+                break;
+            }
+            case 'logout':
+            case 'remove':
+                claudeLogout();
+                break;
+            case 'status':
+                claudeStatus();
+                break;
+            default:
+                console.log(`
+Claude Commands:
+  vibe claude key <key>     Set Anthropic API key
+  vibe claude status        Check status
+  vibe claude logout        Remove key
+
+Get key: https://console.anthropic.com/settings/keys
+        `);
+        }
+        break;
+    }
     // vibe gpt <subcommand>
     case 'gpt': {
         const subCommand = positionalArgs[1];
@@ -548,11 +132,13 @@ switch (command) {
             default:
                 console.log(`
 GPT Commands:
-  vibe gpt auth     OAuth authentication (Plus/Pro)
-  vibe gpt key      Set API key
-  vibe gpt status   Check status
-  vibe gpt logout   Logout
-  vibe gpt remove   Remove config
+  vibe gpt auth                    OAuth authentication (Plus/Pro)
+  vibe gpt key <key>               Set API key
+  vibe gpt status                  Check status
+  vibe gpt logout                  Logout
+  vibe gpt remove                  Remove config
+
+Auth order: oauth → apikey
         `);
         }
         break;
@@ -562,7 +148,7 @@ GPT Commands:
         const subCommand = positionalArgs[1];
         switch (subCommand) {
             case 'auth':
-                geminiAuth();
+                await geminiAuth();
                 break;
             case 'key': {
                 const apiKey = positionalArgs[2] || args.find(a => !a.startsWith('-') && a !== 'gemini' && a !== 'key');
@@ -586,11 +172,14 @@ GPT Commands:
             default:
                 console.log(`
 Gemini Commands:
-  vibe gemini auth     OAuth authentication
-  vibe gemini key      Set API key
-  vibe gemini status   Check status
-  vibe gemini logout   Logout
-  vibe gemini remove   Remove config
+  vibe gemini auth                 Detect Gemini CLI credentials
+  vibe gemini key <key>            Set API key
+  vibe gemini status               Check status
+  vibe gemini logout               Clear config
+  vibe gemini remove               Remove config
+
+Auth order: gemini-cli → apikey
+Requires: npm i -g @google/gemini-cli && gemini
         `);
         }
         break;
@@ -598,66 +187,97 @@ Gemini Commands:
     case 'status':
         showStatus();
         break;
-    // vibe hud <subcommand>
-    case 'hud': {
-        const subCommand = positionalArgs[1];
-        switch (subCommand) {
-            case 'show':
-                showHud(positionalArgs[2] || 'focused');
+    // vibe telegram <subcommand>
+    case 'telegram': {
+        const telegramSub = positionalArgs[1];
+        switch (telegramSub) {
+            case 'setup':
+                telegramSetup(positionalArgs[2]);
                 break;
-            case 'start':
-                startHud(positionalArgs[2] || 'ultrawork', positionalArgs[3]);
+            case 'chat':
+                telegramChat(positionalArgs[2]);
                 break;
-            case 'phase': {
-                const current = parseInt(positionalArgs[2], 10) || 1;
-                const total = parseInt(positionalArgs[3], 10) || current;
-                const phaseName = positionalArgs.slice(4).join(' ') || undefined;
-                updateHudPhase(current, total, phaseName);
+            case 'status':
+                telegramStatus();
                 break;
-            }
-            case 'agent': {
-                const action = positionalArgs[2];
-                if (action === 'add') {
-                    manageHudAgent('add', positionalArgs[3], positionalArgs[4]);
-                }
-                else if (action === 'remove') {
-                    manageHudAgent('remove', positionalArgs[3]);
-                }
-                else if (action === 'clear') {
-                    manageHudAgent('clear');
-                }
-                else {
-                    console.log(`
-Agent Commands:
-  vibe hud agent add <name> [model]  Add agent (default: sonnet)
-  vibe hud agent remove <name>       Remove agent
-  vibe hud agent clear               Clear all agents
-          `);
-                }
+            case 'help':
+                telegramHelp();
                 break;
-            }
-            case 'context': {
-                const used = parseInt(positionalArgs[2], 10) || 0;
-                const total = parseInt(positionalArgs[3], 10) || 200000;
-                updateHudContext(used, total);
+            default:
+                telegramHelp();
+        }
+        break;
+    }
+    // vibe slack <subcommand>
+    case 'slack': {
+        const slackSub = positionalArgs[1];
+        switch (slackSub) {
+            case 'setup':
+                slackSetup(positionalArgs[2], positionalArgs[3]);
                 break;
-            }
-            case 'reset':
-            case 'done':
-                resetHud();
+            case 'channel':
+                slackChannel(positionalArgs[2]);
                 break;
-            case 'help':
-                showHudHelp();
+            case 'status':
+                slackStatus();
                 break;
-            case undefined:
-                // No subcommand: show focused status by default
-                showHud('focused');
+            case 'help':
+                slackHelp();
                 break;
             default:
-                showHudHelp();
+                slackHelp();
         }
         break;
     }
+    // vibe sync <subcommand> (async)
+    case 'sync': {
+        const syncSub = positionalArgs[1];
+        const onlyAuth = args.includes('--only') && args[args.indexOf('--only') + 1] === 'auth';
+        const onlyMemory = args.includes('--only') && args[args.indexOf('--only') + 1] === 'memory';
+        const only = onlyAuth ? 'auth' : onlyMemory ? 'memory' : undefined;
+        (async () => {
+            try {
+                switch (syncSub) {
+                    case 'login':
+                        await syncLogin();
+                        break;
+                    case 'push':
+                        await syncPush(only);
+                        break;
+                    case 'pull':
+                        await syncPull(only);
+                        break;
+                    case 'status':
+                        syncStatus();
+                        break;
+                    case 'logout':
+                        syncLogout();
+                        break;
+                    default:
+                        console.log(`
+vibe sync — Google Drive AppData 인증/메모리 동기화
+
+  vibe sync login              Google 계정 연결 (1회)
+  vibe sync push               현재 인증+메모리를 클라우드에 업로드
+  vibe sync push --only auth   인증만 업로드
+  vibe sync push --only memory 메모리만 업로드
+  vibe sync pull               클라우드에서 복원
+  vibe sync pull --only auth   인증만 복원
+  vibe sync pull --only memory 메모리만 복원
+  vibe sync status             로그인 상태 확인
+  vibe sync logout             연결 해제
+
+필요: VIBE_SYNC_GOOGLE_CLIENT_ID (Google Cloud OAuth Desktop 클라이언트)
+        `);
+                }
+            }
+            catch (err) {
+                console.error('❌', err.message);
+                process.exit(1);
+            }
+        })();
+        break;
+    }
     case 'version':
     case '-v':
     case '--version':
@@ -674,15 +294,18 @@ Agent Commands:
 ❌ Unknown command: ${command}
 
 Available commands:
-  vibe init         Initialize project
-  vibe update       Update settings
-  vibe hud <cmd>    HUD status (show, start, phase, agent, reset)
-  vibe gpt <cmd>    GPT commands (auth, key, status, logout)
-  vibe gemini <cmd> Gemini commands (auth, key, status, logout)
-  vibe status       Show status
-  vibe remove       Remove vibe
-  vibe help         Help
-  vibe version      Version info
+  vibe setup              셋업 위자드
+  vibe upgrade            최신 버전으로 업그레이드
+  vibe update             프로젝트 설정 업데이트
+  vibe status             전체 상태 확인
+  vibe sync <cmd>         클라우드 동기화
+
+  vibe claude <cmd>       Claude (key, status, logout)
+  vibe gpt <cmd>          GPT (auth, key, status, logout)
+  vibe gemini <cmd>       Gemini (auth, key, status, logout)
+
+  vibe telegram <cmd>     Telegram (setup, status) - notification only
+  vibe slack <cmd>        Slack (setup, status) - notification only
 
 Usage: vibe help
     `);