@vibecodetown/mcp-server 2.1.3 → 2.1.4

package/build/local-mode/install-state.js

@@ -0,0 +1,37 @@
+// adapters/mcp-ts/src/local-mode/install-state.ts
+// Installation state verification
+import * as fs from "node:fs";
+import { getVibeRepoPaths } from "./paths.js";
+import { readVersionLock } from "./version-lock.js";
+import { healthCheck } from "../bootstrap/doctor.js";
+/**
+ * Check installation state of the repository
+ */
+export async function checkInstallState(repoRoot) {
+    const paths = getVibeRepoPaths(repoRoot);
+    const warnings = [];
+    // Check local init
+    const localInitialized = fs.existsSync(paths.configFile);
+    if (!localInitialized) {
+        warnings.push("로컬 모드 미초기화. 'vibe setup' 실행 필요");
+    }
+    // Check engines
+    let enginesReady = false;
+    try {
+        const health = await healthCheck();
+        enginesReady = health.engines.every(e => e.status === "ok");
+        if (!enginesReady) {
+            const missing = health.engines.filter(e => e.status !== "ok").map(e => e.name);
+            warnings.push(`엔진 누락: ${missing.join(", ")}`);
+        }
+    }
+    catch {
+        warnings.push("엔진 상태 확인 실패");
+    }
+    // Check version lock
+    const versionLockExists = readVersionLock(repoRoot) !== null;
+    if (!versionLockExists && localInitialized) {
+        warnings.push("버전 잠금 파일 없음. 'vibe setup' 재실행 권장");
+    }
+    return { localInitialized, enginesReady, versionLockExists, warnings };
+}

package/build/local-mode/paths.js

@@ -20,5 +20,6 @@ export function getVibeRepoPaths(repoRoot) {
         ciWorkflowFile,
         gitleaksConfigFile,
         bootstrapManifest: path.join(vibeDir, "bootstrap_manifest.json"),
+        versionLockFile: path.join(vibeDir, "version_lock.json"),
     };
 }

package/build/local-mode/setup.js

@@ -0,0 +1,46 @@
+// adapters/mcp-ts/src/local-mode/setup.ts
+// Unified installation logic
+import { initLocalModeRepo } from "./init.js";
+import { writeVersionLock } from "./version-lock.js";
+import { ensureEngines } from "../bootstrap/installer.js";
+import { healthCheck } from "../bootstrap/doctor.js";
+/**
+ * Run unified setup process
+ */
+export async function runSetup(repoRoot, cliVersion, opts) {
+    const warnings = [];
+    // Step 1: Local mode init
+    const local = initLocalModeRepo(repoRoot, {
+        force: opts.force,
+        installHooks: opts.installHooks ?? true,
+        installCi: opts.installCi,
+        ciFailOnWarn: opts.ciFailOnWarn,
+    });
+    // Step 2: Engine installation (unless localOnly)
+    let engines = [];
+    if (!opts.localOnly) {
+        try {
+            await ensureEngines();
+            const health = await healthCheck();
+            engines = health.engines.map(e => ({
+                name: e.name,
+                version: e.version,
+                status: e.status,
+            }));
+        }
+        catch (e) {
+            warnings.push(`엔진 설치 실패: ${e instanceof Error ? e.message : String(e)}`);
+            warnings.push("오프라인 모드: vibe setup --local-only");
+        }
+    }
+    // Step 3: Version lock
+    let versionLock = null;
+    try {
+        const engineVersions = Object.fromEntries(engines.filter(e => e.status === "ok").map(e => [e.name, e.version]));
+        versionLock = writeVersionLock(repoRoot, cliVersion, engineVersions);
+    }
+    catch (e) {
+        warnings.push(`버전 잠금 파일 생성 실패: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    return { local, engines, versionLock, warnings };
+}

package/build/local-mode/version-lock.js

@@ -0,0 +1,53 @@
+// adapters/mcp-ts/src/local-mode/version-lock.ts
+// Version lock management for unified installation
+import * as fs from "node:fs";
+import { z } from "zod";
+import { getVibeRepoPaths } from "./paths.js";
+export const VersionLockSchema = z.object({
+    schema_version: z.literal(1),
+    created_at: z.string(),
+    updated_at: z.string(),
+    cli: z.object({
+        name: z.string(),
+        version: z.string(),
+    }),
+    engines: z.record(z.string(), z.object({
+        version: z.string(),
+        installed_at: z.string(),
+    })),
+});
+/**
+ * Read version lock file from repo
+ */
+export function readVersionLock(repoRoot) {
+    const paths = getVibeRepoPaths(repoRoot);
+    if (!fs.existsSync(paths.versionLockFile))
+        return null;
+    try {
+        const data = JSON.parse(fs.readFileSync(paths.versionLockFile, "utf-8"));
+        return VersionLockSchema.parse(data);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write version lock file to repo
+ */
+export function writeVersionLock(repoRoot, cliVersion, engines) {
+    const paths = getVibeRepoPaths(repoRoot);
+    const now = new Date().toISOString();
+    const existing = readVersionLock(repoRoot);
+    const lock = {
+        schema_version: 1,
+        created_at: existing?.created_at ?? now,
+        updated_at: now,
+        cli: { name: "@vibecode/mcp-server", version: cliVersion },
+        engines: Object.fromEntries(Object.entries(engines).map(([name, version]) => [
+            name,
+            { version, installed_at: now }
+        ])),
+    };
+    fs.writeFileSync(paths.versionLockFile, JSON.stringify(lock, null, 2) + "\n");
+    return paths.versionLockFile;
+}

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,7 +112,89 @@ async function cmdDoctor() {
 function resolveRepoRoot() {
     return getGitRoot(process.cwd()) ?? process.cwd();
 }
+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("");
+    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");
@@ -429,7 +513,26 @@ async function cmdUpdate() {
 }
 // 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]
 
@@ -524,7 +627,8 @@ 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")}     로컬 가드 검증 실행`);
@@ -542,12 +646,13 @@ 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 setup --help       # setup 명령어 도움말`);
     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 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 +681,9 @@ async function main() {
     });
     try {
         switch (command) {
+            case "setup":
+                await cmdSetup();
+                break;
             case "init":
                 cmdInit();
                 break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecodetown/mcp-server",
-  "version": "2.1.3",
+  "version": "2.1.4",
   "type": "module",
   "description": "Vibe PM - AI Project Manager MCP Server for non-technical founders",
   "keywords": [
@@ -27,9 +27,9 @@
     "node": ">=18"
   },
   "bin": {
-    "mcp-server": "./build/index.js",
-    "vibecode-mcp": "./build/index.js",
-    "vibe": "./build/vibe-cli.js"
+    "mcp-server": "build/index.js",
+    "vibecode-mcp": "build/index.js",
+    "vibe": "build/vibe-cli.js"
   },
   "main": "./build/index.js",
   "files": [