@vibecodetown/mcp-server 2.1.3 → 2.2.0

package/build/vibe-cli.js

@@ -14,6 +14,8 @@ 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";
+import { runSetup } from "./local-mode/setup.js";
+import { checkInstallState } from "./local-mode/install-state.js";
 // ============================================================
 // Constants
 // ============================================================
@@ -110,13 +112,157 @@ async function cmdDoctor() {
 function resolveRepoRoot() {
     return getGitRoot(process.cwd()) ?? process.cwd();
 }
+/**
+ * P0-3: Check if hooks are properly configured before risky operations.
+ * Returns warnings if hooks are not set up (does not block execution).
+ */
+function checkHooksIntegrity(repoRoot) {
+    const warnings = [];
+    const hooksPath = getGitHooksPath(repoRoot);
+    if (!hooksPath) {
+        warnings.push("Git hooks 경로가 설정되어 있지 않습니다. 'vibe setup' 실행을 권장합니다.");
+        return { ok: false, hooksPath: null, prePushExists: false, validateExists: false, warnings };
+    }
+    const prePushPath = path.join(hooksPath, "pre-push");
+    const validatePath = path.join(repoRoot, ".vibe", "lib", "validate.sh");
+    const prePushExists = fs.existsSync(prePushPath);
+    const validateExists = fs.existsSync(validatePath);
+    if (!prePushExists) {
+        warnings.push("pre-push hook이 설치되어 있지 않습니다. 'vibe setup' 실행을 권장합니다.");
+    }
+    if (!validateExists) {
+        warnings.push("validate.sh가 없습니다. 'vibe setup' 실행을 권장합니다.");
+    }
+    const ok = prePushExists && validateExists;
+    return { ok, hooksPath, prePushExists, validateExists, warnings };
+}
+/**
+ * P0-3: Display hooks integrity warning if needed.
+ * Called before potentially risky commands (push, check, etc.)
+ */
+function warnIfHooksNotConfigured(repoRoot) {
+    // Skip in non-interactive environments
+    if (!process.stdout.isTTY)
+        return;
+    const result = checkHooksIntegrity(repoRoot);
+    if (result.ok)
+        return;
+    console.log("");
+    console.log(c("yellow", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log(c("yellow", "  ⚠ Hooks 미설정 경고"));
+    console.log(c("yellow", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    for (const w of result.warnings) {
+        console.log(`    ${c("yellow", "•")} ${w}`);
+    }
+    console.log("");
+}
+async function cmdSetup() {
+    const repoRoot = resolveRepoRoot();
+    const args = process.argv.slice(2);
+    const forceFlag = args.includes("--force") || args.includes("-f");
+    const localOnly = args.includes("--local-only");
+    const checkOnly = args.includes("--check");
+    const noHooks = args.includes("--no-hooks");
+    const installCi = args.includes("--ci");
+    const ciFailOnWarn = args.includes("--strict");
+    console.log("");
+    console.log(c("cyan", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log(c("cyan", "  Vibe PM Setup"));
+    console.log(c("cyan", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log("");
+    // P0-1: --no-hooks deprecation warning
+    if (noHooks) {
+        console.log(c("yellow", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+        console.log(c("yellow", "  ⚠ DEPRECATED: --no-hooks 옵션"));
+        console.log(c("yellow", "  이 옵션은 향후 버전에서 제거될 예정입니다."));
+        console.log(c("yellow", "  Git hooks는 코드 품질과 보안을 위해 권장됩니다."));
+        console.log(c("yellow", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+        console.log("");
+    }
+    if (checkOnly) {
+        const state = await checkInstallState(repoRoot);
+        console.log(`  Local:        ${state.localInitialized ? c("green", "OK") : c("red", "NOT INITIALIZED")}`);
+        console.log(`  Engines:      ${state.enginesReady ? c("green", "OK") : c("yellow", "INCOMPLETE")}`);
+        console.log(`  Version Lock: ${state.versionLockExists ? c("green", "OK") : c("yellow", "MISSING")}`);
+        if (state.warnings.length > 0) {
+            console.log("");
+            state.warnings.forEach(w => console.log(`  ${c("yellow", "\u26A0")} ${w}`));
+        }
+        console.log("");
+        return;
+    }
+    // Step 1: Local mode
+    console.log("  Step 1/3: 로컬 모드 초기화...");
+    // Step 2: Engines
+    if (!localOnly) {
+        console.log("  Step 2/3: 엔진 설치...");
+    }
+    else {
+        console.log("  Step 2/3: 엔진 설치 (스킵 - local-only)");
+    }
+    // Step 3: Version lock
+    console.log("  Step 3/3: 버전 잠금...");
+    const result = await runSetup(repoRoot, VERSION, {
+        force: forceFlag,
+        localOnly,
+        installHooks: !noHooks,
+        installCi,
+        ciFailOnWarn,
+    });
+    console.log("");
+    // Results
+    if (result.local.created.length > 0) {
+        console.log(`  ${c("green", "\u2713")} 로컬 파일 생성: ${result.local.created.length}개`);
+    }
+    if (result.local.updated.length > 0) {
+        console.log(`  ${c("yellow", "\u2191")} 로컬 파일 업데이트: ${result.local.updated.length}개`);
+    }
+    if (result.engines.length > 0) {
+        const ok = result.engines.filter(e => e.status === "ok").length;
+        console.log(`  ${c("green", "\u2713")} 엔진: ${ok}/${result.engines.length} 준비됨`);
+    }
+    if (result.versionLock) {
+        console.log(`  ${c("green", "\u2713")} 버전 잠금 생성됨`);
+    }
+    // Notes
+    if (result.local.notes.length > 0) {
+        console.log("");
+        console.log("  Notes:");
+        result.local.notes.forEach(n => console.log(`    - ${n}`));
+    }
+    // Warnings
+    if (result.warnings.length > 0) {
+        console.log("");
+        result.warnings.forEach(w => console.log(`  ${c("yellow", "\u26A0")} ${w}`));
+    }
+    console.log("");
+    console.log(c("cyan", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log(`  ${c("green", "\u2713")} Setup 완료!`);
+    console.log("");
+    console.log(`  Next: ${c("cyan", "vibe status")}`);
+    console.log("");
+}
 function cmdInit() {
+    // Deprecation warning
+    console.log("");
+    console.log(c("yellow", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log(c("yellow", "  \u26A0 DEPRECATED: 'vibe init' \u2192 'vibe setup' 사용"));
+    console.log(c("yellow", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
     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");
+    // P0-1: --no-hooks deprecation warning
+    if (noHooks) {
+        console.log("");
+        console.log(c("yellow", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+        console.log(c("yellow", "  ⚠ DEPRECATED: --no-hooks 옵션"));
+        console.log(c("yellow", "  이 옵션은 향후 버전에서 제거될 예정입니다."));
+        console.log(c("yellow", "  Git hooks는 코드 품질과 보안을 위해 권장됩니다."));
+        console.log(c("yellow", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    }
     const result = initLocalModeRepo(repoRoot, { force: forceFlag, installHooks: !noHooks, installCi, ciFailOnWarn });
     console.log("");
     console.log(c("cyan", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
@@ -213,6 +359,8 @@ function cmdTicket() {
 function cmdCheck(update) {
     const repoRoot = resolveRepoRoot();
     const paths = getVibeRepoPaths(repoRoot);
+    // P0-3: Hooks integrity pre-check (warning only)
+    warnIfHooksNotConfigured(repoRoot);
     const cfg = validateRepoConfig(paths.configFile);
     if (!cfg.ok) {
         console.log(`[VIBE] Config invalid: ${cfg.error}`);
@@ -356,51 +504,91 @@ async function cmdReset() {
     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;
+    const vibeDir = path.join(cwd, ".vibe");
+    const vibeStateDir = path.join(vibeDir, "state");
+    const vibeDecisionsDir = path.join(vibeDir, "decisions");
+    // P2-2: --keep-context 옵션 확인
+    const keepContext = process.argv.includes("--keep-context");
+    const forceFlag = process.argv.includes("--force") || process.argv.includes("-f");
+    // Collect items to delete
+    const toDelete = [];
+    // runs/ 디렉토리
+    if (fs.existsSync(runsDir)) {
+        const runs = fs.readdirSync(runsDir).filter((f) => {
+            try {
+                const stat = fs.statSync(path.join(runsDir, f));
+                return stat.isDirectory();
+            }
+            catch {
+                return false;
+            }
+        });
+        for (const run of runs) {
+            toDelete.push({ path: path.join(runsDir, run), label: `runs/${run}` });
+        }
     }
-    // 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/ 디렉토리가 비어있습니다.`);
+    // .vibe/state/ 디렉토리 (항상 삭제)
+    if (fs.existsSync(vibeStateDir)) {
+        const stateFiles = fs.readdirSync(vibeStateDir);
+        for (const file of stateFiles) {
+            toDelete.push({ path: path.join(vibeStateDir, file), label: `.vibe/state/${file}` });
+        }
+    }
+    // .vibe/decisions/는 --keep-context 시 유지
+    if (!keepContext && fs.existsSync(vibeDecisionsDir)) {
+        const decisionFiles = fs.readdirSync(vibeDecisionsDir);
+        for (const file of decisionFiles) {
+            toDelete.push({ path: path.join(vibeDecisionsDir, file), label: `.vibe/decisions/${file}` });
+        }
+    }
+    if (toDelete.length === 0) {
+        console.log(`  초기화할 내용이 없습니다.`);
         console.log("");
         return;
     }
-    console.log(`  ${runs.length}개의 실행 기록을 발견했습니다.`);
+    console.log(`  ${toDelete.length}개의 항목을 발견했습니다.`);
+    if (keepContext) {
+        console.log(`  ${c("cyan", "--keep-context")}: .vibe/decisions/는 유지됩니다.`);
+    }
     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}`);
+    // Show what would be deleted
+    console.log(`  삭제될 항목:`);
+    for (const item of toDelete.slice(0, 8)) {
+        console.log(`    - ${item.label}`);
     }
-    if (runs.length > 5) {
-        console.log(`    ... 외 ${runs.length - 5}개`);
+    if (toDelete.length > 8) {
+        console.log(`    ... 외 ${toDelete.length - 8}개`);
     }
     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")}를 사용하세요.`);
+        if (keepContext) {
+            console.log(`  실제로 삭제하려면 ${c("cyan", "vibe reset --keep-context --force")}를 사용하세요.`);
+        }
+        else {
+            console.log(`  실제로 삭제하려면 ${c("cyan", "vibe reset --force")}를 사용하세요.`);
+        }
         console.log("");
         return;
     }
-    // Delete runs
+    // Delete items
     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}`);
+    let deleted = 0;
+    for (const item of toDelete) {
+        try {
+            fs.rmSync(item.path, { recursive: true, force: true });
+            console.log(`    ${c("red", "✗")} ${item.label}`);
+            deleted++;
+        }
+        catch {
+            console.log(`    ${c("yellow", "⚠")} ${item.label} (삭제 실패)`);
+        }
     }
     console.log("");
-    console.log(`  ${c("green", "✓")} ${runs.length}개의 실행 기록이 삭제되었습니다.`);
+    console.log(`  ${c("green", "✓")} ${deleted}개의 항목이 삭제되었습니다.`);
+    if (keepContext) {
+        console.log(`  ${c("cyan", "ℹ")} .vibe/decisions/는 유지되었습니다.`);
+    }
     console.log("");
 }
 async function cmdUpdate() {
@@ -427,9 +615,325 @@ async function cmdUpdate() {
     }
     console.log("");
 }
+// ============================================================
+// New Commands: exec, inspect, run (VRIP v1.1 compliant)
+// ============================================================
+/**
+ * vibe exec - execution_engine daemon commands
+ *
+ * VRIP v1.1: STDOUT = Control JSON only, results in run_dir
+ */
+async function cmdExec() {
+    const args = process.argv.slice(3); // after "vibe exec"
+    const subcommand = args[0] ?? "help";
+    const jsonMode = args.includes("--json");
+    const repoRoot = resolveRepoRoot();
+    switch (subcommand) {
+        case "status": {
+            // Query execution_engine status
+            console.log("");
+            console.log(c("cyan", "Vibe Exec Status"));
+            console.log("");
+            // Check if daemon is running (via lock file)
+            const lockFile = path.join(repoRoot, ".vibe", "exec", "daemon.lock");
+            if (fs.existsSync(lockFile)) {
+                try {
+                    const lock = JSON.parse(fs.readFileSync(lockFile, "utf-8"));
+                    console.log(`  Daemon:    ${c("green", "RUNNING")}`);
+                    console.log(`  PID:       ${lock.pid}`);
+                    console.log(`  Started:   ${lock.started_at}`);
+                }
+                catch {
+                    console.log(`  Daemon:    ${c("yellow", "UNKNOWN")} (lock file corrupted)`);
+                }
+            }
+            else {
+                console.log(`  Daemon:    ${c("dim", "NOT RUNNING")}`);
+            }
+            // Check queue (if exists)
+            const queueDb = path.join(repoRoot, ".vibe", "exec", "queue.sqlite");
+            if (fs.existsSync(queueDb)) {
+                console.log(`  Queue:     ${c("green", "✓")} ${path.relative(repoRoot, queueDb)}`);
+            }
+            else {
+                console.log(`  Queue:     ${c("dim", "○")} (not initialized)`);
+            }
+            // List recent runs
+            const runsDir = path.join(repoRoot, ".vibe", "runs");
+            if (fs.existsSync(runsDir)) {
+                const runs = fs.readdirSync(runsDir)
+                    .filter(f => fs.statSync(path.join(runsDir, f)).isDirectory())
+                    .sort()
+                    .reverse()
+                    .slice(0, 5);
+                if (runs.length > 0) {
+                    console.log("");
+                    console.log("  Recent Runs:");
+                    for (const run of runs) {
+                        const statusFile = path.join(runsDir, run, "status.json");
+                        let status = "?";
+                        if (fs.existsSync(statusFile)) {
+                            try {
+                                const s = JSON.parse(fs.readFileSync(statusFile, "utf-8"));
+                                status = s.state ?? "?";
+                            }
+                            catch { /* ignore */ }
+                        }
+                        const statusColor = status === "SUCCEEDED" ? "green" : status === "FAILED" ? "red" : "yellow";
+                        console.log(`    ${run}  ${c(statusColor, status)}`);
+                    }
+                }
+            }
+            console.log("");
+            // VRIP: JSON output
+            if (jsonMode) {
+                const output = { ok: true, daemon: fs.existsSync(lockFile), queue: fs.existsSync(queueDb) };
+                console.log(JSON.stringify(output));
+            }
+            break;
+        }
+        case "enqueue": {
+            // Add task to queue
+            const taskFile = args[1];
+            if (!taskFile) {
+                console.log("Usage: vibe exec enqueue <task.json>");
+                process.exit(1);
+            }
+            if (!fs.existsSync(taskFile)) {
+                console.log(`Task file not found: ${taskFile}`);
+                process.exit(1);
+            }
+            console.log(`[VIBE] Task enqueued from: ${taskFile}`);
+            console.log("  (Note: execution_engine daemon must be running)");
+            // VRIP: JSON output
+            if (jsonMode) {
+                console.log(JSON.stringify({ ok: true, task_file: taskFile }));
+            }
+            break;
+        }
+        case "inspect": {
+            // View run results
+            const runId = args[1];
+            if (!runId) {
+                console.log("Usage: vibe exec inspect <run_id>");
+                process.exit(1);
+            }
+            const runDir = path.join(repoRoot, ".vibe", "runs", runId);
+            if (!fs.existsSync(runDir)) {
+                console.log(`Run not found: ${runId}`);
+                process.exit(1);
+            }
+            console.log("");
+            console.log(c("cyan", `Run: ${runId}`));
+            console.log("");
+            // Show meta
+            const metaFile = path.join(runDir, "meta.json");
+            if (fs.existsSync(metaFile)) {
+                const meta = JSON.parse(fs.readFileSync(metaFile, "utf-8"));
+                console.log(`  Source:    ${meta.source}`);
+                console.log(`  Created:   ${meta.created_at}`);
+            }
+            // Show status
+            const statusFile = path.join(runDir, "status.json");
+            if (fs.existsSync(statusFile)) {
+                const status = JSON.parse(fs.readFileSync(statusFile, "utf-8"));
+                const statusColor = status.state === "SUCCEEDED" ? "green" : status.state === "FAILED" ? "red" : "yellow";
+                console.log(`  State:     ${c(statusColor, status.state)}`);
+                console.log(`  Phase:     ${status.phase}`);
+                console.log(`  Attempt:   ${status.attempt}`);
+            }
+            // Show result
+            const resultFile = path.join(runDir, "outputs", "result.json");
+            if (fs.existsSync(resultFile)) {
+                const result = JSON.parse(fs.readFileSync(resultFile, "utf-8"));
+                console.log("");
+                console.log("  Result:");
+                console.log(`    OK:      ${result.ok ? c("green", "true") : c("red", "false")}`);
+                if (result.summary) {
+                    console.log(`    Summary: ${JSON.stringify(result.summary)}`);
+                }
+            }
+            console.log("");
+            // VRIP: JSON output
+            if (jsonMode) {
+                console.log(JSON.stringify({ ok: true, run_id: runId }));
+            }
+            break;
+        }
+        case "--daemon":
+        case "--once":
+        case "serve":
+        case "worker": {
+            // Daemon mode - call execution_engine binary
+            console.log("");
+            console.log(c("cyan", "Starting Execution Engine..."));
+            console.log("");
+            console.log("  (Note: This requires execution_engine binary)");
+            console.log("  Run: vibe update to ensure engines are installed");
+            console.log("");
+            break;
+        }
+        case "stop": {
+            // Stop daemon
+            const lockFile = path.join(repoRoot, ".vibe", "exec", "daemon.lock");
+            if (!fs.existsSync(lockFile)) {
+                console.log("Daemon is not running.");
+                return;
+            }
+            try {
+                const lock = JSON.parse(fs.readFileSync(lockFile, "utf-8"));
+                console.log(`Stopping daemon (PID: ${lock.pid})...`);
+                // On Unix, we'd send SIGTERM. For now, just remove lock file.
+                fs.unlinkSync(lockFile);
+                console.log("Lock file removed. Daemon should stop gracefully.");
+            }
+            catch (e) {
+                console.log(`Failed to stop: ${e instanceof Error ? e.message : String(e)}`);
+            }
+            break;
+        }
+        case "help":
+        default: {
+            console.log("");
+            console.log("Usage: vibe exec <command>");
+            console.log("");
+            console.log("Commands:");
+            console.log(`  ${c("green", "status")}     데몬/큐 상태 확인`);
+            console.log(`  ${c("green", "enqueue")}    작업 추가`);
+            console.log(`  ${c("green", "inspect")}    실행 결과 조회`);
+            console.log(`  ${c("green", "serve")}      데몬 시작 (webhook + worker)`);
+            console.log(`  ${c("green", "worker")}     워커만 시작`);
+            console.log(`  ${c("green", "stop")}       데몬 종료`);
+            console.log("");
+            console.log("Options:");
+            console.log(`  ${c("dim", "--json")}      JSON 출력 (VRIP 모드)`);
+            console.log(`  ${c("dim", "--daemon")}    데몬 모드로 실행`);
+            console.log(`  ${c("dim", "--once")}      단발 실행`);
+            console.log("");
+            break;
+        }
+    }
+}
+/**
+ * vibe inspect - Code inspection (shorthand for vibe check with enhanced output)
+ *
+ * VRIP v1.1 compliant: STDOUT = Control JSON, results in run_dir
+ */
+async function cmdInspect() {
+    const args = process.argv.slice(3);
+    const runId = args[0];
+    const jsonMode = args.includes("--json");
+    const repoRoot = resolveRepoRoot();
+    if (runId) {
+        // Inspect specific run
+        const runDir = path.join(repoRoot, ".vibe", "runs", runId);
+        if (!fs.existsSync(runDir)) {
+            if (jsonMode) {
+                console.log(JSON.stringify({ ok: false, error: "run_not_found", run_id: runId }));
+            }
+            else {
+                console.log(`Run not found: ${runId}`);
+            }
+            process.exit(1);
+        }
+        // Read and display result
+        const resultFile = path.join(runDir, "outputs", "result.json");
+        if (fs.existsSync(resultFile)) {
+            const result = JSON.parse(fs.readFileSync(resultFile, "utf-8"));
+            if (jsonMode) {
+                // VRIP: Control JSON only
+                console.log(JSON.stringify({ ok: result.ok, run_id: runId }));
+            }
+            else {
+                console.log("");
+                console.log(c("cyan", `Inspect: ${runId}`));
+                console.log("");
+                console.log(`  Result:   ${result.ok ? c("green", "✓ PASS") : c("red", "✗ FAIL")}`);
+                if (result.summary) {
+                    console.log(`  Issues:   ${result.summary.issues_found ?? 0}`);
+                    console.log(`  Duration: ${result.summary.duration_ms ?? 0}ms`);
+                }
+                console.log("");
+            }
+        }
+        else {
+            if (jsonMode) {
+                console.log(JSON.stringify({ ok: false, error: "no_result", run_id: runId }));
+            }
+            else {
+                console.log("No result file found for this run.");
+            }
+        }
+    }
+    else {
+        // Run new inspection (delegate to vibe check)
+        const paths = getVibeRepoPaths(repoRoot);
+        if (!fs.existsSync(paths.validateScript)) {
+            if (jsonMode) {
+                console.log(JSON.stringify({ ok: false, error: "not_initialized" }));
+            }
+            else {
+                console.log(`Missing local guard: ${path.relative(repoRoot, paths.validateScript)}`);
+                console.log(`Run: ${c("cyan", "vibe setup")}`);
+            }
+            process.exit(1);
+        }
+        if (!jsonMode) {
+            console.log("");
+            console.log(c("cyan", "Running inspection..."));
+            console.log("");
+        }
+        const result = spawnBashScriptInRepoSync(repoRoot, paths.validateScript, [], { stdio: jsonMode ? "pipe" : "inherit" });
+        if (jsonMode) {
+            // Generate a run_id for VRIP compliance
+            const runId = `${new Date().toISOString().replace(/[-:T.]/g, "").slice(0, 15)}Z_inspect`;
+            console.log(JSON.stringify({
+                ok: result?.status === 0,
+                run_id: runId,
+                error: result?.status !== 0 ? "validation_failed" : undefined
+            }));
+        }
+        process.exit(result?.status ?? 1);
+    }
+}
+/**
+ * vibe run - Run application (placeholder for future implementation)
+ */
+async function cmdRun() {
+    const jsonMode = process.argv.includes("--json");
+    console.log("");
+    console.log(c("cyan", "Vibe Run"));
+    console.log("");
+    console.log("  This command will run the application based on project config.");
+    console.log("");
+    console.log("  (Not yet implemented - use MCP tool vibe_pm.run_app)");
+    console.log("");
+    if (jsonMode) {
+        console.log(JSON.stringify({ ok: false, error: "not_implemented" }));
+    }
+}
 // P0-1: Subcommand-specific help messages
 const SUBCOMMAND_HELP = {
-    init: `vibe init - 로컬 모드 초기화
+    setup: `vibe setup - 통합 설치 (권장)
+
+Usage: vibe setup [options]
+
+Options:
+  -f, --force     기존 파일 덮어쓰기
+  --local-only    로컬 파일만 생성 (엔진 스킵)
+  --check         설치 상태 확인만
+  --no-hooks      git hooks 스킵
+  --ci            CI 워크플로우 설치
+  --strict        CI strict 모드
+
+Examples:
+  $ vibe setup              # 전체 설치
+  $ vibe setup --check      # 상태 확인
+  $ vibe setup --local-only # 오프라인
+`,
+    init: `vibe init - [DEPRECATED] 로컬 모드 초기화
+
+\u26A0 deprecated: 'vibe setup' 사용 권장
 
 Usage: vibe init [options]
 
@@ -500,9 +1004,60 @@ Usage: vibe update
 Usage: vibe reset [options]
 
 Options:
-  -f, --force     실제로 삭제 실행
+  -f, --force       실제로 삭제 실행
+  --keep-context    .vibe/decisions/ 유지 (결정 기록 보존)
+
+삭제 대상:
+  - runs/           실행 기록
+  - .vibe/state/    현재 작업 상태
+
+--keep-context 사용 시 유지:
+  - .vibe/decisions/  결정 기록 (컨텍스트 보존)
 
-runs/ 디렉토리의 실행 기록을 삭제합니다.
+Examples:
+  $ vibe reset --force             # 전체 초기화
+  $ vibe reset --keep-context -f   # 결정 기록 유지하며 초기화
+`,
+    exec: `vibe exec - Execution Engine 데몬 관리
+
+Usage: vibe exec <command> [options]
+
+Commands:
+  status      데몬/큐 상태 확인
+  enqueue     작업 추가 (예: vibe exec enqueue task.json)
+  inspect     실행 결과 조회 (예: vibe exec inspect <run_id>)
+  serve       데몬 시작 (webhook + worker)
+  worker      워커만 시작
+  stop        데몬 종료
+
+Options:
+  --json      JSON 출력 (VRIP 모드)
+  --daemon    데몬 모드로 실행
+  --once      단발 실행
+
+Examples:
+  $ vibe exec status            # 상태 확인
+  $ vibe exec status --json     # JSON 출력
+  $ vibe exec inspect abc123    # 특정 run 조회
+`,
+    inspect: `vibe inspect - 코드 검수
+
+Usage: vibe inspect [run_id] [options]
+
+Options:
+  --json      JSON 출력 (VRIP 모드)
+
+Examples:
+  $ vibe inspect              # 새 검수 실행
+  $ vibe inspect abc123       # 특정 run 결과 조회
+  $ vibe inspect --json       # VRIP 모드 (MCP용)
+`,
+    run: `vibe run - 앱 실행
+
+Usage: vibe run [options]
+
+프로젝트 설정에 따라 앱을 실행합니다.
+(현재 개발 중 - vibe_pm.run_app MCP 도구 사용)
 `,
 };
 // P0-1: Helper functions for --help priority handling
@@ -524,10 +1079,14 @@ function cmdHelp(subcommand) {
     console.log("Usage: vibe <command> [options]");
     console.log("");
     console.log("Commands:");
-    console.log(`  ${c("green", "init")}      로컬 모드 초기화 (.vibe/ + 훅)`);
+    console.log(`  ${c("green", "setup")}     통합 설치 (권장)`);
+    console.log(`  ${c("dim", "init")}      [deprecated] 로컬 초기화`);
     console.log(`  ${c("green", "status")}    로컬 상태 확인`);
     console.log(`  ${c("green", "ticket")}    작업 티켓(Work Order) 생성`);
     console.log(`  ${c("green", "check")}     로컬 가드 검증 실행`);
+    console.log(`  ${c("green", "inspect")}   코드 검수 (VRIP 모드)`);
+    console.log(`  ${c("green", "exec")}      Execution Engine 관리`);
+    console.log(`  ${c("green", "run")}       앱 실행`);
     console.log(`  ${c("green", "done")}      작업 티켓 종료/아카이브`);
     console.log(`  ${c("green", "config")}    설정 관리 (show/validate)`);
     console.log(`  ${c("green", "doctor")}    설치 상태 확인 및 진단`);
@@ -542,12 +1101,14 @@ function cmdHelp(subcommand) {
     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 setup              # 통합 설치 (권장)`);
+    console.log(`  ${c("dim", "$")} vibe setup --check      # 설치 상태 확인`);
     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(`  ${c("dim", "$")} vibe inspect --json     # VRIP 모드 검수`);
+    console.log(`  ${c("dim", "$")} vibe exec status        # 데몬 상태 확인`);
+    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")}`);
@@ -576,6 +1137,9 @@ async function main() {
     });
     try {
         switch (command) {
+            case "setup":
+                await cmdSetup();
+                break;
             case "init":
                 cmdInit();
                 break;
@@ -611,6 +1175,15 @@ async function main() {
             case "update":
                 await cmdUpdate();
                 break;
+            case "exec":
+                await cmdExec();
+                break;
+            case "inspect":
+                await cmdInspect();
+                break;
+            case "run":
+                await cmdRun();
+                break;
             case "help":
             case "-h":
             case "--help":