@vibecodetown/mcp-server 2.1.4 → 2.2.1

package/build/vibe-cli.js

@@ -6,6 +6,7 @@ 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 { listAvailableSkills, listActivatedSkills, getSkillById, activateSkills, deactivateSkill, getSkillsHealth, getSkillContent } from "./bootstrap/skills-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";
@@ -77,9 +78,21 @@ async function cmdDoctor() {
     // 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
+    // Check Skills Bundle
     console.log("");
-    console.log("  Agent Skills:");
+    console.log("  Skills Bundle:");
+    const skillsStatus = health.skills.status;
+    const skillsIcon = skillsStatus === "OK"
+        ? c("green", "✓")
+        : skillsStatus === "WARN"
+            ? c("yellow", "⚠")
+            : c("red", "✗");
+    console.log(`    Status:       ${skillsIcon} ${skillsStatus}`);
+    console.log(`    Version:      ${health.skills.version ?? c("dim", "unknown")}`);
+    console.log(`    Installed:    ${health.skills.summary.ok}/${health.skills.summary.total}`);
+    // Check Agent Skills files (project-level guidance)
+    console.log("");
+    console.log("  Agent Guidance Files:");
     const skillFiles = [
         { name: "AGENTS.md", path: "AGENTS.md" },
         { name: ".cursorrules", path: ".cursorrules" },
@@ -93,7 +106,7 @@ async function cmdDoctor() {
     // Summary
     console.log("");
     console.log(c("cyan", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
-    const allOk = health.status === "OK" && cacheResult.valid;
+    const allOk = health.status === "OK" && cacheResult.valid && skillsStatus === "OK";
     if (allOk) {
         console.log("");
         console.log(`  ${c("green", "✓ 모든 것이 정상입니다!")}`);
@@ -112,6 +125,50 @@ 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);
@@ -126,6 +183,15 @@ async function cmdSetup() {
     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")}`);
@@ -139,16 +205,18 @@ async function cmdSetup() {
         return;
     }
     // Step 1: Local mode
-    console.log("  Step 1/3: 로컬 모드 초기화...");
+    console.log("  Step 1/4: 로컬 모드 초기화...");
     // Step 2: Engines
     if (!localOnly) {
-        console.log("  Step 2/3: 엔진 설치...");
+        console.log("  Step 2/4: 엔진 설치...");
     }
     else {
-        console.log("  Step 2/3: 엔진 설치 (스킵 - local-only)");
+        console.log("  Step 2/4: 엔진 설치 (스킵 - local-only)");
     }
     // Step 3: Version lock
-    console.log("  Step 3/3: 버전 잠금...");
+    console.log("  Step 3/4: 버전 잠금...");
+    // Step 4: Skills
+    console.log("  Step 4/4: 스킬 활성화...");
     const result = await runSetup(repoRoot, VERSION, {
         force: forceFlag,
         localOnly,
@@ -168,6 +236,9 @@ async function cmdSetup() {
         const ok = result.engines.filter(e => e.status === "ok").length;
         console.log(`  ${c("green", "\u2713")} 엔진: ${ok}/${result.engines.length} 준비됨`);
     }
+    if (result.skills.activated.length > 0) {
+        console.log(`  ${c("green", "\u2713")} 스킬: ${result.skills.activated.length}개 활성화됨`);
+    }
     if (result.versionLock) {
         console.log(`  ${c("green", "\u2713")} 버전 잠금 생성됨`);
     }
@@ -201,6 +272,15 @@ function cmdInit() {
     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", "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
@@ -297,6 +377,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}`);
@@ -440,51 +522,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() {
@@ -511,6 +633,497 @@ async function cmdUpdate() {
     }
     console.log("");
 }
+// ============================================================
+// Skills Management Commands
+// ============================================================
+/**
+ * vibe skills - Skill bundle management
+ *
+ * Subcommands:
+ *   list       - List all available skills
+ *   activate   - Activate skill(s) for this project
+ *   deactivate - Deactivate a skill from this project
+ *   info       - Show skill details
+ *   status     - Show skills health status
+ */
+async function cmdSkills() {
+    const args = process.argv.slice(3); // after "vibe skills"
+    const subcommand = args[0] ?? "list";
+    const jsonMode = args.includes("--json");
+    const projectRoot = process.cwd();
+    switch (subcommand) {
+        case "list": {
+            const available = listAvailableSkills();
+            const activated = listActivatedSkills(projectRoot);
+            if (jsonMode) {
+                console.log(JSON.stringify({ available, activated }, null, 2));
+                return;
+            }
+            console.log("");
+            console.log(c("cyan", "Vibe PM Skills"));
+            console.log("");
+            console.log("  Available Skills:");
+            if (available.length === 0) {
+                console.log(`    ${c("dim", "(none)")}`);
+            }
+            else {
+                for (const skill of available) {
+                    const isActive = activated.includes(skill.id);
+                    const status = isActive ? c("green", "✓") : c("dim", "○");
+                    console.log(`    ${status} ${skill.id.padEnd(35)} v${skill.version}`);
+                    console.log(`      ${c("dim", skill.description)}`);
+                }
+            }
+            console.log("");
+            if (activated.length > 0) {
+                console.log(`  Activated: ${c("green", String(activated.length))} / ${available.length}`);
+            }
+            else {
+                console.log(`  ${c("dim", "No skills activated. Run:")} ${c("cyan", "vibe skills activate <id>")}`);
+            }
+            console.log("");
+            break;
+        }
+        case "activate": {
+            const skillIds = args.slice(1).filter(a => !a.startsWith("-"));
+            if (skillIds.length === 0) {
+                // Activate all skills if no ID specified
+                console.log("");
+                console.log(c("cyan", "Activating all available skills..."));
+                console.log("");
+            }
+            const result = await activateSkills(projectRoot, skillIds.length > 0 ? skillIds : undefined);
+            if (jsonMode) {
+                console.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            if (result.activated.length > 0) {
+                console.log(`  ${c("green", "✓")} Activated skills:`);
+                for (const id of result.activated) {
+                    console.log(`    - ${id}`);
+                }
+            }
+            if (result.errors.length > 0) {
+                console.log("");
+                console.log(`  ${c("red", "✗")} Errors:`);
+                for (const err of result.errors) {
+                    console.log(`    - ${err}`);
+                }
+            }
+            console.log("");
+            break;
+        }
+        case "deactivate": {
+            const skillId = args[1];
+            if (!skillId || skillId.startsWith("-")) {
+                console.log(`  ${c("red", "✗")} Usage: vibe skills deactivate <skill_id>`);
+                return;
+            }
+            const result = await deactivateSkill(projectRoot, skillId);
+            if (jsonMode) {
+                console.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            if (result.success) {
+                console.log(`  ${c("green", "✓")} Deactivated: ${skillId}`);
+            }
+            else {
+                console.log(`  ${c("red", "✗")} ${result.error}`);
+            }
+            console.log("");
+            break;
+        }
+        case "info": {
+            const skillId = args[1];
+            if (!skillId || skillId.startsWith("-")) {
+                console.log(`  ${c("red", "✗")} Usage: vibe skills info <skill_id>`);
+                return;
+            }
+            const skill = getSkillById(skillId);
+            if (!skill) {
+                console.log(`  ${c("red", "✗")} Skill not found: ${skillId}`);
+                return;
+            }
+            if (jsonMode) {
+                console.log(JSON.stringify(skill, null, 2));
+                return;
+            }
+            console.log("");
+            console.log(c("cyan", `Skill: ${skill.id}`));
+            console.log("");
+            console.log(`  Version:     ${skill.version}`);
+            console.log(`  Description: ${skill.description}`);
+            console.log(`  Tags:        ${skill.tags.join(", ")}`);
+            console.log(`  File:        ${skill.file}`);
+            console.log(`  SHA256:      ${skill.sha256.slice(0, 16)}...`);
+            console.log("");
+            // Show content preview
+            const content = getSkillContent(skillId);
+            if (content) {
+                const lines = content.split("\n").slice(0, 10);
+                console.log(c("dim", "  Preview:"));
+                for (const line of lines) {
+                    console.log(`  ${c("dim", line.slice(0, 60))}`);
+                }
+                if (content.split("\n").length > 10) {
+                    console.log(`  ${c("dim", "...")}`);
+                }
+            }
+            console.log("");
+            break;
+        }
+        case "status": {
+            const health = getSkillsHealth();
+            if (jsonMode) {
+                console.log(JSON.stringify(health, null, 2));
+                return;
+            }
+            console.log("");
+            console.log(c("cyan", "Skills Bundle Status"));
+            console.log("");
+            console.log(`  Installed:    ${health.installed ? c("green", "✓") : c("red", "✗")}`);
+            console.log(`  Bundle Path:  ${health.bundlePath ?? c("dim", "(not found)")}`);
+            console.log(`  Version:      ${health.version ?? c("dim", "(unknown)")}`);
+            console.log("");
+            console.log("  Skills:");
+            for (const skill of health.skills) {
+                const icon = skill.status === "ok"
+                    ? c("green", "✓")
+                    : skill.status === "missing"
+                        ? c("red", "✗")
+                        : c("yellow", "⚠");
+                console.log(`    ${icon} ${skill.id} (${skill.status})`);
+                if (skill.error) {
+                    console.log(`      ${c("dim", skill.error)}`);
+                }
+            }
+            console.log("");
+            console.log(`  Summary: ${c("green", String(health.summary.ok))} ok, ` +
+                `${c("red", String(health.summary.missing))} missing, ` +
+                `${c("yellow", String(health.summary.corrupted))} corrupted`);
+            console.log("");
+            break;
+        }
+        case "help":
+        default: {
+            console.log("");
+            console.log(c("cyan", "vibe skills") + " - Skill bundle management");
+            console.log("");
+            console.log("Subcommands:");
+            console.log(`  ${c("green", "list")}        List all available skills`);
+            console.log(`  ${c("green", "activate")}    Activate skill(s) for this project`);
+            console.log(`  ${c("green", "deactivate")}  Deactivate a skill from this project`);
+            console.log(`  ${c("green", "info")}        Show skill details`);
+            console.log(`  ${c("green", "status")}      Show skills health status`);
+            console.log("");
+            console.log("Examples:");
+            console.log(`  ${c("dim", "$")} vibe skills list`);
+            console.log(`  ${c("dim", "$")} vibe skills activate VRIP_INSTALL_MANIFEST_DOCTOR`);
+            console.log(`  ${c("dim", "$")} vibe skills activate  # activate all`);
+            console.log(`  ${c("dim", "$")} vibe skills info VRIP_INSTALL_MANIFEST_DOCTOR`);
+            console.log(`  ${c("dim", "$")} vibe skills status --json`);
+            console.log("");
+            break;
+        }
+    }
+}
+// ============================================================
+// 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 = {
     setup: `vibe setup - 통합 설치 (권장)
@@ -603,9 +1216,81 @@ Usage: vibe update
 Usage: vibe reset [options]
 
 Options:
-  -f, --force     실제로 삭제 실행
+  -f, --force       실제로 삭제 실행
+  --keep-context    .vibe/decisions/ 유지 (결정 기록 보존)
+
+삭제 대상:
+  - runs/           실행 기록
+  - .vibe/state/    현재 작업 상태
 
-runs/ 디렉토리의 실행 기록을 삭제합니다.
+--keep-context 사용 시 유지:
+  - .vibe/decisions/  결정 기록 (컨텍스트 보존)
+
+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 도구 사용)
+`,
+    skills: `vibe skills - 스킬 번들 관리
+
+Usage: vibe skills <command> [options]
+
+Commands:
+  list        사용 가능한 스킬 목록
+  activate    프로젝트에 스킬 활성화
+  deactivate  스킬 비활성화
+  info        스킬 상세 정보
+  status      스킬 번들 상태 확인
+
+Options:
+  --json      JSON 형식 출력
+
+Examples:
+  $ vibe skills list
+  $ vibe skills activate VRIP_INSTALL_MANIFEST_DOCTOR
+  $ vibe skills activate                # 모든 스킬 활성화
+  $ vibe skills info VRIP_INSTALL_MANIFEST_DOCTOR
+  $ vibe skills status --json
 `,
 };
 // P0-1: Helper functions for --help priority handling
@@ -632,12 +1317,16 @@ function cmdHelp(subcommand) {
     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")}    설치 상태 확인 및 진단`);
     console.log(`  ${c("green", "version")}   버전 정보 출력`);
     console.log(`  ${c("green", "reset")}     프로젝트 초기화 (runs/ 정리)`);
     console.log(`  ${c("green", "update")}    엔진 바이너리 업데이트`);
+    console.log(`  ${c("green", "skills")}    스킬 번들 관리`);
     console.log(`  ${c("green", "help")}      이 도움말 표시`);
     console.log("");
     console.log("Options:");
@@ -648,10 +1337,12 @@ function cmdHelp(subcommand) {
     console.log("Examples:");
     console.log(`  ${c("dim", "$")} vibe setup              # 통합 설치 (권장)`);
     console.log(`  ${c("dim", "$")} vibe setup --check      # 설치 상태 확인`);
-    console.log(`  ${c("dim", "$")} vibe setup --help       # setup 명령어 도움말`);
     console.log(`  ${c("dim", "$")} vibe ticket \"Fix auth\"   # 작업 티켓 생성`);
     console.log(`  ${c("dim", "$")} vibe check              # 푸시 전 로컬 검증`);
+    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 skills list        # 스킬 목록`);
     console.log(`  ${c("dim", "$")} vibe reset --force      # 프로젝트 초기화`);
     console.log("");
     console.log("More info:");
@@ -719,6 +1410,18 @@ async function main() {
             case "update":
                 await cmdUpdate();
                 break;
+            case "exec":
+                await cmdExec();
+                break;
+            case "inspect":
+                await cmdInspect();
+                break;
+            case "run":
+                await cmdRun();
+                break;
+            case "skills":
+                await cmdSkills();
+                break;
             case "help":
             case "-h":
             case "--help":