@vibecodetown/mcp-server 2.1.0

package/build/vibe-cli.js

@@ -0,0 +1,631 @@
+#!/usr/bin/env node
+// vibe-cli.ts - Thin CLI wrapper for non-technical users
+// Usage: vibe <command> [options]
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { healthCheck, validateCacheIntegrity, checkForUpdates } from "./bootstrap/doctor.js";
+import { ensureEngines } from "./bootstrap/installer.js";
+import { CONTRACTS_BUNDLE_SHA256, CONTRACTS_VERSION } from "./generated/contracts_bundle_info.js";
+import { spawnBashScriptInRepoSync } from "./local-mode/bash.js";
+import { getGitHooksPath, getGitRoot } from "./local-mode/git.js";
+import { initLocalModeRepo } from "./local-mode/init.js";
+import { setRepoConfigValue, validateRepoConfig } from "./local-mode/config.js";
+import { getVibeRepoPaths } from "./local-mode/paths.js";
+import { archiveCurrentWorkOrder, createWorkOrderTemplate, readCurrentWorkOrder, writeCurrentWorkOrder } from "./local-mode/work-order.js";
+import { autoUpdateOnStart } from "./version-check.js";
+// ============================================================
+// Constants
+// ============================================================
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const VERSION = JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf-8")).version;
+// ANSI color codes (no dependencies)
+const colors = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    magenta: "\x1b[35m",
+    cyan: "\x1b[36m",
+};
+const c = (color, text) => process.stdout.isTTY ? `${colors[color]}${text}${colors.reset}` : text;
+// ============================================================
+// CLI Commands
+// ============================================================
+async function cmdDoctor() {
+    console.log("");
+    console.log(c("cyan", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log(c("cyan", "  Vibe PM Doctor"));
+    console.log(c("cyan", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log("");
+    // Check MCP server
+    console.log(`  MCP Server:     ${c("green", "✓")} @vibecode/mcp-server@${VERSION}`);
+    console.log(`  Contracts:      ${c("green", "✓")} v${CONTRACTS_VERSION} (${CONTRACTS_BUNDLE_SHA256.slice(0, 12)})`);
+    // Health check - gets list of EngineHealth objects
+    const health = await healthCheck();
+    // Show engine status
+    console.log("");
+    console.log("  Engines:");
+    for (const engine of health.engines) {
+        const statusIcon = engine.status === "ok"
+            ? c("green", "✓")
+            : engine.status === "needs_update"
+                ? c("yellow", "↑")
+                : c("red", "✗");
+        const versionStr = engine.currentVersion ?? "not installed";
+        console.log(`    ${engine.name.padEnd(20)} ${statusIcon} ${versionStr}`);
+    }
+    // Check for updates
+    console.log("");
+    const updates = await checkForUpdates();
+    if (updates.hasUpdates) {
+        console.log(`  Updates available: ${c("yellow", "Yes")}`);
+        for (const [name, info] of Object.entries(updates.updates)) {
+            console.log(`    ${name}: ${info.current ?? "none"} → ${info.required}`);
+        }
+        console.log("");
+        console.log(`  Run ${c("cyan", "vibe update")} to install updates.`);
+    }
+    else {
+        console.log(`  Updates:        ${c("green", "✓")} All engines up to date`);
+    }
+    // Check cache integrity
+    const cacheResult = await validateCacheIntegrity();
+    console.log(`  Cache:          ${cacheResult.valid ? c("green", "✓") : c("yellow", "⚠")} ${cacheResult.valid ? "valid" : "needs repair"}`);
+    // Check Agent Skills files
+    console.log("");
+    console.log("  Agent Skills:");
+    const skillFiles = [
+        { name: "AGENTS.md", path: "AGENTS.md" },
+        { name: ".cursorrules", path: ".cursorrules" },
+        { name: "CLAUDE.md", path: "CLAUDE.md" },
+    ];
+    for (const file of skillFiles) {
+        const fileExists = fs.existsSync(path.join(process.cwd(), file.path));
+        const status = fileExists ? c("green", "✓") : c("dim", "○");
+        console.log(`    ${file.name.padEnd(15)} ${status}`);
+    }
+    // Summary
+    console.log("");
+    console.log(c("cyan", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    const allOk = health.status === "OK" && cacheResult.valid;
+    if (allOk) {
+        console.log("");
+        console.log(`  ${c("green", "✓ 모든 것이 정상입니다!")}`);
+        console.log("");
+        console.log('  에디터에서 "시작해줘"라고 말해보세요.');
+    }
+    else {
+        console.log("");
+        console.log(`  ${c("yellow", "⚠ 일부 문제가 있습니다.")}`);
+        console.log("");
+        console.log(`  ${c("cyan", "vibe reset")}으로 초기화하거나`);
+        console.log(`  ${c("cyan", "vibe update")}로 업데이트하세요.`);
+    }
+    console.log("");
+}
+function resolveRepoRoot() {
+    return getGitRoot(process.cwd()) ?? process.cwd();
+}
+function cmdInit() {
+    const repoRoot = resolveRepoRoot();
+    const args = process.argv.slice(2);
+    const forceFlag = args.includes("--force") || args.includes("-f");
+    const noHooks = args.includes("--no-hooks");
+    const installCi = args.includes("--ci") || args.includes("--install-ci");
+    const ciFailOnWarn = args.includes("--strict");
+    const result = initLocalModeRepo(repoRoot, { force: forceFlag, installHooks: !noHooks, installCi, ciFailOnWarn });
+    console.log("");
+    console.log(c("cyan", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log(c("cyan", "  Vibe PM Local Mode Init"));
+    console.log(c("cyan", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log("");
+    console.log(`  Repo: ${repoRoot}`);
+    if (result.created.length > 0) {
+        console.log("");
+        console.log("  Created:");
+        for (const p of result.created)
+            console.log(`    ${c("green", "✓")} ${path.relative(repoRoot, p)}`);
+    }
+    if (result.updated.length > 0) {
+        console.log("");
+        console.log("  Updated:");
+        for (const p of result.updated)
+            console.log(`    ${c("yellow", "↑")} ${path.relative(repoRoot, p)}`);
+    }
+    if (result.notes.length > 0) {
+        console.log("");
+        console.log("  Notes:");
+        for (const n of result.notes)
+            console.log(`    - ${n}`);
+    }
+    console.log("");
+    console.log(`  Next: ${c("cyan", "vibe status")}`);
+    console.log("");
+}
+function cmdStatus() {
+    const repoRoot = resolveRepoRoot();
+    const paths = getVibeRepoPaths(repoRoot);
+    if (!fs.existsSync(paths.configFile)) {
+        console.log(`Not a Vibe-managed repo in: ${repoRoot}`);
+        console.log(`Run: ${c("cyan", "vibe init")}`);
+        return;
+    }
+    const cfgResult = validateRepoConfig(paths.configFile);
+    const config = cfgResult.ok ? cfgResult.config : null;
+    const hooksPath = getGitHooksPath(repoRoot);
+    const workOrder = readCurrentWorkOrder(paths.currentWorkOrderFile);
+    console.log("");
+    console.log(c("cyan", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log(c("cyan", "  Vibe PM Status (Local Mode)"));
+    console.log(c("cyan", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log("");
+    console.log(`  Repo:          ${repoRoot}`);
+    console.log(`  Config:        ${fs.existsSync(paths.configFile) ? c("green", "✓") : c("red", "✗")} ${path.relative(repoRoot, paths.configFile)}`);
+    if (!cfgResult.ok) {
+        console.log(`  Config Valid:  ${c("red", "✗")} ${cfgResult.error}`);
+    }
+    else if (config) {
+        console.log(`  Mode:          ${config.mode ?? "local-first"}`);
+        console.log(`  Enforcement:   ${config.policy?.enforcement ?? "warn"}`);
+    }
+    console.log(`  Hooks Path:    ${hooksPath ? hooksPath : c("dim", "(not set)")}`);
+    console.log(`  CI Workflow:   ${fs.existsSync(paths.ciWorkflowFile) ? c("green", "✓") : c("dim", "○")} ${path.relative(repoRoot, paths.ciWorkflowFile)}`);
+    console.log(`  Work Order:    ${workOrder ? c("green", "✓") : c("dim", "○")} ${path.relative(repoRoot, paths.currentWorkOrderFile)}`);
+    if (workOrder) {
+        console.log(`    ID:          ${workOrder.run_id}`);
+        console.log(`    Topic:       ${workOrder.topic ?? ""}`);
+        console.log(`    Created:     ${workOrder.created_at}`);
+    }
+    console.log("");
+}
+function cmdTicket() {
+    const repoRoot = resolveRepoRoot();
+    const paths = getVibeRepoPaths(repoRoot);
+    if (!fs.existsSync(paths.configFile)) {
+        console.log(`Not a Vibe-managed repo in: ${repoRoot}`);
+        console.log(`Run: ${c("cyan", "vibe init")}`);
+        process.exit(1);
+    }
+    const cfg = validateRepoConfig(paths.configFile);
+    if (!cfg.ok) {
+        console.log(`[VIBE] Config invalid: ${cfg.error}`);
+        console.log(`Fix: vibe config validate`);
+        process.exit(1);
+    }
+    if (cfg.config.mode === "server-required") {
+        console.log(`[VIBE] Command disabled by policy (mode=server-required).`);
+        console.log(`Tip: switch mode to local-first in .vibe/config.json to use local ticket templates.`);
+        process.exit(1);
+    }
+    const args = process.argv.slice(2);
+    const forceFlag = args.includes("--force") || args.includes("-f");
+    const topic = args.filter((a) => !a.startsWith("-")).slice(1).join(" ").trim() || undefined;
+    const wo = createWorkOrderTemplate(topic);
+    writeCurrentWorkOrder(paths.currentWorkOrderFile, wo, { overwrite: forceFlag });
+    console.log(`[VIBE] Work order created (local)`);
+    console.log(`  ID:    ${wo.run_id}`);
+    console.log(`  File:  ${path.relative(repoRoot, paths.currentWorkOrderFile)}`);
+}
+function cmdCheck(update) {
+    const repoRoot = resolveRepoRoot();
+    const paths = getVibeRepoPaths(repoRoot);
+    const cfg = validateRepoConfig(paths.configFile);
+    if (!cfg.ok) {
+        console.log(`[VIBE] Config invalid: ${cfg.error}`);
+        console.log(`Fix: vibe config validate`);
+        process.exit(1);
+    }
+    if (cfg.config.mode === "server-required") {
+        console.log(`[VIBE] Command disabled by policy (mode=server-required).`);
+        console.log(`Tip: switch mode to local-first in .vibe/config.json to use local checks.`);
+        process.exit(1);
+    }
+    if (!fs.existsSync(paths.validateScript)) {
+        console.log(`Missing local guard: ${path.relative(repoRoot, paths.validateScript)}`);
+        console.log(`Run: ${c("cyan", "vibe init")}`);
+        process.exit(1);
+    }
+    const result = spawnBashScriptInRepoSync(repoRoot, paths.validateScript, [], { stdio: "inherit" });
+    if (!result) {
+        console.log("[VIBE] bash runtime not found.");
+        console.log("Install Git Bash (recommended) or WSL to run local guard scripts.");
+        process.exit(1);
+    }
+    // Local Mode signal alignment: update checks never block execution.
+    // This is a best-effort WARN reminder after the primary guard run.
+    if (update?.updateAvailable && !update.updated) {
+        const from = update.localVersion ?? "?";
+        const to = update.remoteVersion ?? "?";
+        console.log("");
+        console.log(`[VIBE] 새 버전이 있습니다: ${from} → ${to}`);
+        console.log("Tip: 다음 실행에서 업데이트를 허용하거나, 원격과 fast-forward로 동기화하세요.");
+        console.log("");
+    }
+    process.exit(result.status ?? 1);
+}
+function cmdDone() {
+    const repoRoot = resolveRepoRoot();
+    const paths = getVibeRepoPaths(repoRoot);
+    if (!fs.existsSync(paths.configFile)) {
+        console.log(`Not a Vibe-managed repo in: ${repoRoot}`);
+        console.log(`Run: ${c("cyan", "vibe init")}`);
+        process.exit(1);
+    }
+    const cfg = validateRepoConfig(paths.configFile);
+    if (!cfg.ok) {
+        console.log(`[VIBE] Config invalid: ${cfg.error}`);
+        console.log(`Fix: vibe config validate`);
+        process.exit(1);
+    }
+    if (cfg.config.mode === "server-required") {
+        console.log(`[VIBE] Command disabled by policy (mode=server-required).`);
+        console.log(`Tip: switch mode to local-first in .vibe/config.json to allow local finalization.`);
+        process.exit(1);
+    }
+    const archived = archiveCurrentWorkOrder(paths.currentWorkOrderFile, paths.archiveDir);
+    if (!archived) {
+        console.log("[VIBE] No active work order to finalize.");
+        return;
+    }
+    console.log("[VIBE] Work finalized.");
+    console.log(`  Archived: ${path.relative(repoRoot, archived.archivedPath)}`);
+}
+function cmdConfig() {
+    const repoRoot = resolveRepoRoot();
+    const paths = getVibeRepoPaths(repoRoot);
+    const args = process.argv.slice(2);
+    const sub = args[1]?.toLowerCase() ?? "help";
+    switch (sub) {
+        case "show": {
+            const raw = fs.existsSync(paths.configFile) ? fs.readFileSync(paths.configFile, "utf-8") : "{}\n";
+            process.stdout.write(raw);
+            break;
+        }
+        case "set": {
+            const key = args[2];
+            const value = args[3];
+            if (!key || value === undefined) {
+                console.log("Usage: vibe config set <key> <value>");
+                console.log("Supported keys:");
+                console.log("  mode (local-first|server-required)");
+                console.log("  policy.enforcement (warn|block)");
+                console.log("  policy.auto_update_on_start (off|prompt|silent)");
+                console.log("  hooks.pre_push.enabled (true|false)");
+                console.log("  hooks.pre_push.enforcement (warn|block)");
+                console.log("  hooks.pre_push.gitleaks_required (true|false)");
+                process.exit(1);
+            }
+            if (!fs.existsSync(paths.configFile)) {
+                console.log(`Missing config: ${path.relative(repoRoot, paths.configFile)}`);
+                console.log(`Run: ${c("cyan", "vibe init")}`);
+                process.exit(1);
+            }
+            const result = setRepoConfigValue(paths.configFile, key, value);
+            if (!result.ok) {
+                console.log(`✗ ${result.error}`);
+                process.exit(1);
+            }
+            console.log(`✓ ${key} set to ${value}`);
+            break;
+        }
+        case "validate": {
+            const result = validateRepoConfig(paths.configFile);
+            if (result.ok) {
+                console.log("✓ Config is valid (schema validated)");
+                break;
+            }
+            console.log(`✗ Config invalid: ${result.error}`);
+            process.exit(1);
+        }
+        default: {
+            console.log("");
+            console.log("Usage: vibe config <command>");
+            console.log("");
+            console.log("Commands:");
+            console.log(`  ${c("green", "show")}       설정 파일 출력`);
+            console.log(`  ${c("green", "set")}        설정 변경 (예: set policy.enforcement block)`);
+            console.log(`  ${c("green", "validate")}   설정 스키마 검증`);
+            console.log("");
+            break;
+        }
+    }
+}
+async function cmdVersion() {
+    console.log(`@vibecode/mcp-server v${VERSION}`);
+    console.log(`contracts v${CONTRACTS_VERSION} (${CONTRACTS_BUNDLE_SHA256.slice(0, 12)})`);
+    // Also show engine versions if available
+    try {
+        const health = await healthCheck();
+        for (const engine of health.engines) {
+            if (engine.status === "ok" && engine.currentVersion) {
+                console.log(`  ${engine.name}: ${engine.currentVersion}`);
+            }
+        }
+    }
+    catch {
+        // Ignore errors, just show MCP version
+    }
+}
+async function cmdReset() {
+    console.log("");
+    console.log(c("yellow", "Vibe PM Reset"));
+    console.log("");
+    const cwd = process.cwd();
+    const runsDir = path.join(cwd, "runs");
+    // Check if runs directory exists
+    if (!fs.existsSync(runsDir)) {
+        console.log(`  runs/ 디렉토리가 없습니다. 초기화할 내용이 없습니다.`);
+        console.log("");
+        return;
+    }
+    // Count runs
+    const runs = fs.readdirSync(runsDir).filter((f) => {
+        const stat = fs.statSync(path.join(runsDir, f));
+        return stat.isDirectory();
+    });
+    if (runs.length === 0) {
+        console.log(`  runs/ 디렉토리가 비어있습니다.`);
+        console.log("");
+        return;
+    }
+    console.log(`  ${runs.length}개의 실행 기록을 발견했습니다.`);
+    console.log("");
+    // Interactive confirmation would need readline, but for simplicity
+    // we'll just show what would be deleted
+    console.log(`  삭제될 디렉토리:`);
+    for (const run of runs.slice(0, 5)) {
+        console.log(`    - runs/${run}`);
+    }
+    if (runs.length > 5) {
+        console.log(`    ... 외 ${runs.length - 5}개`);
+    }
+    console.log("");
+    // Check for --force flag
+    const forceFlag = process.argv.includes("--force") || process.argv.includes("-f");
+    if (!forceFlag) {
+        console.log(`  ${c("yellow", "주의:")} 이 작업은 되돌릴 수 없습니다.`);
+        console.log(`  실제로 삭제하려면 ${c("cyan", "vibe reset --force")}를 사용하세요.`);
+        console.log("");
+        return;
+    }
+    // Delete runs
+    console.log(`  삭제 중...`);
+    for (const run of runs) {
+        const runPath = path.join(runsDir, run);
+        fs.rmSync(runPath, { recursive: true, force: true });
+        console.log(`    ${c("red", "✗")} runs/${run}`);
+    }
+    console.log("");
+    console.log(`  ${c("green", "✓")} ${runs.length}개의 실행 기록이 삭제되었습니다.`);
+    console.log("");
+}
+async function cmdUpdate() {
+    console.log("");
+    console.log(c("cyan", "Vibe PM Update"));
+    console.log("");
+    console.log("  엔진 업데이트 확인 중...");
+    try {
+        // Force reinstall all engines
+        const engines = await ensureEngines();
+        console.log("");
+        console.log("  설치된 엔진:");
+        for (const [name, enginePath] of Object.entries(engines)) {
+            if (enginePath) {
+                console.log(`    ${c("green", "✓")} ${name}`);
+            }
+        }
+        console.log("");
+        console.log(`  ${c("green", "✓")} 업데이트 완료!`);
+    }
+    catch (error) {
+        console.log("");
+        console.log(`  ${c("red", "✗")} 업데이트 실패: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    console.log("");
+}
+// P0-1: Subcommand-specific help messages
+const SUBCOMMAND_HELP = {
+    init: `vibe init - 로컬 모드 초기화
+
+Usage: vibe init [options]
+
+Options:
+  -f, --force     기존 파일 덮어쓰기
+  --no-hooks      git hooks 설치 스킵
+  --ci            GitHub Actions 워크플로우 설치
+  --strict        CI에서 경고도 실패 처리
+
+Examples:
+  $ vibe init               # 기본 초기화
+  $ vibe init --force       # 기존 파일 덮어쓰기
+  $ vibe init --ci          # CI 워크플로우 포함
+`,
+    status: `vibe status - 로컬 상태 확인
+
+Usage: vibe status
+
+현재 레포지토리의 Vibe PM 상태를 표시합니다.
+`,
+    ticket: `vibe ticket - 작업 티켓 생성
+
+Usage: vibe ticket [topic] [options]
+
+Options:
+  -f, --force     기존 티켓 덮어쓰기
+
+Examples:
+  $ vibe ticket "Fix auth"   # 주제 지정
+  $ vibe ticket --force      # 기존 티켓 덮어쓰기
+`,
+    check: `vibe check - 로컬 가드 검증 실행
+
+Usage: vibe check
+
+푸시 전 로컬 검증을 실행합니다.
+gitleaks 등의 보안 검사를 포함합니다.
+`,
+    done: `vibe done - 작업 티켓 종료
+
+Usage: vibe done
+
+현재 작업 티켓을 아카이브합니다.
+`,
+    config: `vibe config - 설정 관리
+
+Usage: vibe config <command>
+
+Commands:
+  show       설정 파일 출력
+  set        설정 변경 (예: set policy.enforcement block)
+  validate   설정 스키마 검증
+`,
+    doctor: `vibe doctor - 설치 상태 확인
+
+Usage: vibe doctor
+
+설치된 엔진, 캐시 상태, 에이전트 스킬 파일을 점검합니다.
+`,
+    update: `vibe update - 엔진 바이너리 업데이트
+
+Usage: vibe update
+
+최신 엔진 바이너리를 다운로드/설치합니다.
+`,
+    reset: `vibe reset - 프로젝트 초기화
+
+Usage: vibe reset [options]
+
+Options:
+  -f, --force     실제로 삭제 실행
+
+runs/ 디렉토리의 실행 기록을 삭제합니다.
+`,
+};
+// P0-1: Helper functions for --help priority handling
+function hasHelpFlag(args) {
+    return args.includes("--help") || args.includes("-h");
+}
+function getCommandArgs(args) {
+    return args.slice(1);
+}
+function cmdHelp(subcommand) {
+    // P0-1: Show subcommand-specific help if available
+    if (subcommand && SUBCOMMAND_HELP[subcommand]) {
+        console.log(SUBCOMMAND_HELP[subcommand]);
+        return;
+    }
+    console.log("");
+    console.log(c("cyan", "Vibe PM") + " - AI Project Manager for Non-Technical Founders");
+    console.log("");
+    console.log("Usage: vibe <command> [options]");
+    console.log("");
+    console.log("Commands:");
+    console.log(`  ${c("green", "init")}      로컬 모드 초기화 (.vibe/ + 훅)`);
+    console.log(`  ${c("green", "status")}    로컬 상태 확인`);
+    console.log(`  ${c("green", "ticket")}    작업 티켓(Work Order) 생성`);
+    console.log(`  ${c("green", "check")}     로컬 가드 검증 실행`);
+    console.log(`  ${c("green", "done")}      작업 티켓 종료/아카이브`);
+    console.log(`  ${c("green", "config")}    설정 관리 (show/validate)`);
+    console.log(`  ${c("green", "doctor")}    설치 상태 확인 및 진단`);
+    console.log(`  ${c("green", "version")}   버전 정보 출력`);
+    console.log(`  ${c("green", "reset")}     프로젝트 초기화 (runs/ 정리)`);
+    console.log(`  ${c("green", "update")}    엔진 바이너리 업데이트`);
+    console.log(`  ${c("green", "help")}      이 도움말 표시`);
+    console.log("");
+    console.log("Options:");
+    console.log(`  ${c("dim", "-f, --force")}     강제 실행 (reset 명령에서 사용)`);
+    console.log(`  ${c("dim", "--no-update")}     자동 업데이트 체크 스킵`);
+    console.log(`  ${c("dim", "-h, --help")}      명령어별 도움말 표시`);
+    console.log("");
+    console.log("Examples:");
+    console.log(`  ${c("dim", "$")} vibe init               # 로컬 모드 초기화`);
+    console.log(`  ${c("dim", "$")} vibe init --help        # init 명령어 도움말`);
+    console.log(`  ${c("dim", "$")} vibe ticket \"Fix auth\"   # 작업 티켓 생성`);
+    console.log(`  ${c("dim", "$")} vibe check              # 푸시 전 로컬 검증`);
+    console.log(`  ${c("dim", "$")} vibe doctor        # 설치 상태 확인`);
+    console.log(`  ${c("dim", "$")} vibe reset --force # 프로젝트 초기화`);
+    console.log("");
+    console.log("More info:");
+    console.log(`  Documentation: ${c("blue", "https://vibecode.town/docs")}`);
+    console.log(`  Support:       ${c("blue", "mayor@vibecode.town")}`);
+    console.log("");
+}
+// ============================================================
+// Main Entry Point
+// ============================================================
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0]?.toLowerCase() ?? "help";
+    const commandArgs = getCommandArgs(args);
+    const noUpdate = args.includes("--no-update");
+    // P0-1: --help는 실행보다 우선 처리
+    if (hasHelpFlag(commandArgs) && command !== "help" && command !== "-h" && command !== "--help") {
+        cmdHelp(command);
+        return;
+    }
+    // 자동 업데이트 체크 (CLI 진입 훅)
+    // 정책: 모든 실패는 GO (절대 실행을 막지 않음)
+    const update = await autoUpdateOnStart({
+        cwd: process.cwd(),
+        noUpdate,
+        silent: command === "version" || command === "-v" || command === "--version",
+    });
+    try {
+        switch (command) {
+            case "init":
+                cmdInit();
+                break;
+            case "status":
+                cmdStatus();
+                break;
+            case "ticket":
+            case "create_work_order":
+                cmdTicket();
+                break;
+            case "check":
+            case "inspect_code":
+                cmdCheck(update);
+                break;
+            case "done":
+            case "finalize_work":
+                cmdDone();
+                break;
+            case "config":
+                cmdConfig();
+                break;
+            case "doctor":
+                await cmdDoctor();
+                break;
+            case "version":
+            case "-v":
+            case "--version":
+                await cmdVersion();
+                break;
+            case "reset":
+                await cmdReset();
+                break;
+            case "update":
+                await cmdUpdate();
+                break;
+            case "help":
+            case "-h":
+            case "--help":
+            default:
+                cmdHelp();
+                break;
+        }
+    }
+    catch (error) {
+        console.error("");
+        console.error(c("red", "Error:"), error instanceof Error ? error.message : String(error));
+        console.error("");
+        console.error(`문제가 계속되면 ${c("cyan", "vibe doctor")}를 실행해 보세요.`);
+        console.error("");
+        process.exit(1);
+    }
+}
+main();