@vibecodetown/mcp-server 2.1.3 → 2.2.0

package/build/tools/vibe_pm/index.js

@@ -23,6 +23,9 @@ import { exportOutput } from "./export_output.js";
 import { searchOss } from "./search_oss.js";
 import { zoektEvidence } from "./zoekt_evidence.js";
 import { gate, gateInputSchema, gateOutputSchema } from "./gate.js";
+import { forceOverride, forceOverrideInputSchema, forceOverrideOutputSchema } from "./force_override.js";
+import { saveRule, saveRuleInputSchema, saveRuleOutputSchema } from "./save_rule.js";
+import { listRules, listRulesInputSchema, listRulesOutputSchema } from "./list_rules.js";
 import { getAuthGate } from "../../auth/index.js";
 import { ToolErrorOutputSchema } from "../../generated/tool_error_output.js";
 import { decorateToolOutputText, notifyDesktopBestEffort } from "../../dx/activity.js";
@@ -491,6 +494,60 @@ async function vibePmGate(input) {
         });
     }
 }
+async function vibePmForceOverride(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await forceOverride(input);
+        const validated = forceOverrideOutputSchema.parse(result);
+        return toolResult("vibe_pm.force_override", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.force_override", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.force_override", "force_override_failed", {
+            message: msg,
+            recovery: "acknowledge_risks: true 를 반드시 포함해야 합니다."
+        });
+    }
+}
+async function vibePmSaveRule(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await saveRule(input);
+        const validated = saveRuleOutputSchema.parse(result);
+        return toolResult("vibe_pm.save_rule", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.save_rule", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.save_rule", "save_rule_failed", {
+            message: msg,
+            recovery: "규칙 제목, 트리거, 액션을 확인하세요."
+        });
+    }
+}
+async function vibePmListRules(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await listRules(input);
+        const validated = listRulesOutputSchema.parse(result);
+        return toolResult("vibe_pm.list_rules", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.list_rules", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.list_rules", "list_rules_failed", {
+            message: msg,
+            recovery: ".vibe 폴더가 있는지 확인하세요."
+        });
+    }
+}
 // ============================================================
 // Export
 // ============================================================
@@ -518,6 +575,9 @@ export function defineVibePmTools() {
         searchOssInputSchema,
         zoektEvidenceInputSchema,
         gateInputSchema,
+        forceOverrideInputSchema,
+        saveRuleInputSchema,
+        listRulesInputSchema,
         // Tool handlers
         vibePmBriefing,
         vibePmGetDecision,
@@ -539,7 +599,10 @@ export function defineVibePmTools() {
         vibePmExportOutput,
         vibePmSearchOss,
         vibePmZoektEvidence,
-        vibePmGate
+        vibePmGate,
+        vibePmForceOverride,
+        vibePmSaveRule,
+        vibePmListRules
     };
 }
 // ============================================================
@@ -589,5 +652,13 @@ export const VIBE_PM_TOOL_DESCRIPTIONS = {
 사용 시점: 기능 구현 및 검수 후, 결과물을 다른 형태로 배포/공유하고 싶을 때`,
     "vibe_pm.gate": `작업 지시서가 시스템 설계 규칙을 준수하는지 검증합니다. (Schema/Path/Runtime/Semgrep Gate)
 사용 시점: 실행 전 work order가 규칙을 준수하는지 직접 확인하고 싶을 때
-BLOCK이 없으면 실행 가능, BLOCK이 있으면 수정이 필요합니다.`
+BLOCK이 없으면 실행 가능, BLOCK이 있으면 수정이 필요합니다.`,
+    "vibe_pm.force_override": `차단된 작업을 강제로 실행할 수 있는 탈출 경로입니다. (P2-1)
+사용 시점: 정책에 의해 차단되었지만 긴급히 실행이 필요할 때
+⚠ 주의: acknowledge_risks=true 필수, 모든 사용은 감사 로그에 기록됩니다.`,
+    "vibe_pm.save_rule": `프로젝트별 워크플로우 규칙을 저장합니다.
+사용 시점: 사용자가 "~할 때마다 ~해", "항상 ~해줘" 같은 반복 패턴을 지시할 때
+저장 위치: .vibe/project_rules.md`,
+    "vibe_pm.list_rules": `현재 프로젝트에 저장된 워크플로우 규칙 목록을 조회합니다.
+사용 시점: 작업 시작 전 적용할 규칙을 확인하고 싶을 때`
 };

package/build/tools/vibe_pm/list_rules.js

@@ -0,0 +1,135 @@
+// adapters/mcp-ts/src/tools/vibe_pm/list_rules.ts
+// vibe_pm.list_rules - 프로젝트 워크플로우 규칙 조회
+import { z } from "zod";
+import * as fs from "fs/promises";
+import * as path from "path";
+import { getVibeRepoPaths } from "../../local-mode/paths.js";
+// ============================================================
+// Schema
+// ============================================================
+export const listRulesInputSchema = z.object({
+    base_path: z.string().describe("프로젝트 루트 경로")
+}).strict();
+const ruleSchema = z.object({
+    title: z.string(),
+    trigger: z.string(),
+    action: z.string(),
+    example: z.string().optional(),
+    registered_at: z.string().optional()
+});
+export const listRulesOutputSchema = z.object({
+    status: z.enum(["ok", "empty", "error"]),
+    message: z.string(),
+    rules_file: z.string().describe(".vibe/project_rules.md 경로"),
+    rules: z.array(ruleSchema),
+    rule_count: z.number()
+}).strict();
+// ============================================================
+// Implementation
+// ============================================================
+const RULES_FILENAME = "project_rules.md";
+/**
+ * 규칙 파일 경로 반환
+ */
+function getRulesFilePath(basePath) {
+    const { vibeDir } = getVibeRepoPaths(basePath);
+    return path.join(vibeDir, RULES_FILENAME);
+}
+/**
+ * 마크다운에서 규칙 파싱
+ */
+function parseRules(content) {
+    const rules = [];
+    const lines = content.split("\n");
+    let currentRule = null;
+    for (const line of lines) {
+        // 새 규칙 시작 (## 제목)
+        if (line.startsWith("## ") && !line.includes("Project Workflow Rules")) {
+            // 이전 규칙 저장
+            if (currentRule && currentRule.title) {
+                rules.push({
+                    title: currentRule.title,
+                    trigger: currentRule.trigger ?? "",
+                    action: currentRule.action ?? "",
+                    example: currentRule.example,
+                    registered_at: currentRule.registered_at
+                });
+            }
+            currentRule = { title: line.substring(3).trim() };
+            continue;
+        }
+        if (!currentRule)
+            continue;
+        // 규칙 필드 파싱
+        if (line.startsWith("- **언제**:")) {
+            currentRule.trigger = line.replace("- **언제**:", "").trim();
+        }
+        else if (line.startsWith("- **무엇을**:")) {
+            currentRule.action = line.replace("- **무엇을**:", "").trim();
+        }
+        else if (line.startsWith("- **예시**:")) {
+            currentRule.example = line.replace("- **예시**:", "").trim();
+        }
+        else if (line.startsWith("- **등록일**:")) {
+            currentRule.registered_at = line.replace("- **등록일**:", "").trim();
+        }
+    }
+    // 마지막 규칙 저장
+    if (currentRule && currentRule.title) {
+        rules.push({
+            title: currentRule.title,
+            trigger: currentRule.trigger ?? "",
+            action: currentRule.action ?? "",
+            example: currentRule.example,
+            registered_at: currentRule.registered_at
+        });
+    }
+    return rules;
+}
+/**
+ * 규칙 목록 조회
+ */
+export async function listRules(input) {
+    const rulesFile = getRulesFilePath(input.base_path);
+    try {
+        // 파일 읽기
+        const content = await fs.readFile(rulesFile, "utf-8");
+        const rules = parseRules(content);
+        if (rules.length === 0) {
+            return {
+                status: "empty",
+                message: "저장된 규칙이 없습니다.",
+                rules_file: rulesFile,
+                rules: [],
+                rule_count: 0
+            };
+        }
+        return {
+            status: "ok",
+            message: `${rules.length}개의 규칙이 등록되어 있습니다.`,
+            rules_file: rulesFile,
+            rules,
+            rule_count: rules.length
+        };
+    }
+    catch (e) {
+        // 파일이 없는 경우
+        if (e.code === "ENOENT") {
+            return {
+                status: "empty",
+                message: "규칙 파일이 없습니다. vibe_pm.save_rule로 규칙을 추가하세요.",
+                rules_file: rulesFile,
+                rules: [],
+                rule_count: 0
+            };
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return {
+            status: "error",
+            message: `규칙 조회 실패: ${msg}`,
+            rules_file: rulesFile,
+            rules: [],
+            rule_count: 0
+        };
+    }
+}

package/build/tools/vibe_pm/pre_commit_analysis.js

@@ -0,0 +1,292 @@
+// adapters/mcp-ts/src/tools/vibe_pm/pre_commit_analysis.ts
+// Pre-commit analysis: categorize changes and suggest staging strategy
+import { simpleGit } from "simple-git";
+/**
+ * Categorize a file based on its path
+ */
+function categorizeFile(filePath) {
+    const normalized = filePath.replace(/\\/g, "/");
+    // MCP TypeScript
+    if (normalized.includes("adapters/mcp-ts/src/"))
+        return "mcp_source";
+    if (normalized.includes("adapters/mcp-ts/build/"))
+        return "mcp_build";
+    if (normalized.includes("adapters/mcp-ts/test"))
+        return "mcp_test";
+    if (normalized.includes("adapters/mcp-ts/"))
+        return "mcp_other";
+    // Engines (Rust)
+    if (normalized.includes("engines/") && normalized.endsWith(".rs"))
+        return "engine_rust";
+    if (normalized.includes("engines/"))
+        return "engine_other";
+    // Documentation
+    if (normalized.includes("docs/"))
+        return "docs";
+    if (normalized.endsWith(".md"))
+        return "docs";
+    // Python
+    if (normalized.includes("vibecoding_helper/"))
+        return "python_core";
+    if (normalized.endsWith(".py"))
+        return "python";
+    // Config/CI
+    if (normalized.includes(".github/"))
+        return "ci";
+    if (normalized.includes(".vibe/"))
+        return "vibe_config";
+    if (normalized.includes("schemas/"))
+        return "schemas";
+    if (normalized.endsWith(".json") ||
+        normalized.endsWith(".yaml") ||
+        normalized.endsWith(".yml") ||
+        normalized.endsWith(".toml"))
+        return "config";
+    // Generated
+    if (normalized.includes("/generated/"))
+        return "generated";
+    // Tests
+    if (normalized.includes("/test") || normalized.includes("/tests/"))
+        return "tests";
+    // Build artifacts
+    if (normalized.includes("/dist/") ||
+        normalized.includes("/build/") ||
+        normalized.includes("/target/"))
+        return "build_artifacts";
+    // Lock files
+    if (normalized.endsWith("-lock.json") ||
+        normalized.endsWith(".lock") ||
+        normalized.endsWith("-lock.yaml"))
+        return "lock_files";
+    return "other";
+}
+/**
+ * Get human-readable category info
+ */
+function getCategoryInfo(category) {
+    const info = {
+        mcp_source: {
+            name: "MCP 소스 코드",
+            description: "TypeScript MCP 서버 소스 (빌드 후 npm 배포 필요할 수 있음)",
+            suggested: true,
+        },
+        mcp_build: {
+            name: "MCP 빌드 결과물",
+            description: "컴파일된 JavaScript (보통 gitignore됨)",
+            suggested: false,
+        },
+        mcp_test: {
+            name: "MCP 테스트",
+            description: "TypeScript 테스트 파일",
+            suggested: true,
+        },
+        mcp_other: {
+            name: "MCP 기타",
+            description: "MCP 패키지 설정, 스크립트 등",
+            suggested: true,
+        },
+        engine_rust: {
+            name: "Rust 엔진 코드",
+            description: "엔진 소스 (빌드 후 GitHub Release 필요할 수 있음)",
+            suggested: true,
+        },
+        engine_other: {
+            name: "엔진 기타",
+            description: "엔진 설정, 문서 등",
+            suggested: true,
+        },
+        docs: {
+            name: "문서",
+            description: "마크다운 문서, 스펙",
+            suggested: true,
+        },
+        python_core: {
+            name: "Python 코어",
+            description: "vibecoding_helper 모듈",
+            suggested: true,
+        },
+        python: {
+            name: "Python 기타",
+            description: "Python 스크립트, 테스트",
+            suggested: true,
+        },
+        ci: {
+            name: "CI/CD",
+            description: "GitHub Actions 워크플로우",
+            suggested: true,
+        },
+        vibe_config: {
+            name: "Vibe 설정",
+            description: ".vibe/ 로컬 설정 (보통 gitignore됨)",
+            suggested: false,
+        },
+        schemas: {
+            name: "스키마",
+            description: "JSON Schema 정의",
+            suggested: true,
+        },
+        config: {
+            name: "설정 파일",
+            description: "JSON, YAML, TOML 설정",
+            suggested: true,
+        },
+        generated: {
+            name: "생성된 코드",
+            description: "스키마에서 자동 생성된 코드 (재생성 가능)",
+            suggested: false,
+        },
+        tests: {
+            name: "테스트",
+            description: "테스트 파일",
+            suggested: true,
+        },
+        build_artifacts: {
+            name: "빌드 결과물",
+            description: "컴파일된 파일 (보통 gitignore됨)",
+            suggested: false,
+        },
+        lock_files: {
+            name: "Lock 파일",
+            description: "의존성 잠금 파일",
+            suggested: true,
+        },
+        other: {
+            name: "기타",
+            description: "분류되지 않은 파일",
+            suggested: false,
+        },
+    };
+    return info[category] || info.other;
+}
+/**
+ * Analyze git status and categorize changes
+ */
+export async function analyzePreCommit(basePath = process.cwd()) {
+    const git = simpleGit({ baseDir: basePath });
+    const status = await git.status();
+    // Collect all changed files
+    const changes = [];
+    for (const file of status.not_added) {
+        changes.push({ path: file, status: "new", staged: false });
+    }
+    for (const file of status.created) {
+        changes.push({ path: file, status: "new", staged: true });
+    }
+    for (const file of status.modified) {
+        changes.push({ path: file, status: "modified", staged: false });
+    }
+    for (const file of status.staged) {
+        if (!changes.find((c) => c.path === file)) {
+            changes.push({ path: file, status: "modified", staged: true });
+        }
+    }
+    for (const file of status.deleted) {
+        changes.push({ path: file, status: "deleted", staged: false });
+    }
+    for (const file of status.renamed) {
+        changes.push({ path: file.to, status: "renamed", staged: true });
+    }
+    // Group by category
+    const categoryMap = new Map();
+    for (const change of changes) {
+        const cat = categorizeFile(change.path);
+        if (!categoryMap.has(cat)) {
+            categoryMap.set(cat, []);
+        }
+        categoryMap.get(cat).push(change);
+    }
+    // Build categories
+    const categories = [];
+    for (const [cat, files] of categoryMap) {
+        const info = getCategoryInfo(cat);
+        categories.push({
+            name: info.name,
+            description: info.description,
+            files,
+            suggested: info.suggested,
+        });
+    }
+    // Sort: suggested first, then by file count
+    categories.sort((a, b) => {
+        if (a.suggested !== b.suggested)
+            return a.suggested ? -1 : 1;
+        return b.files.length - a.files.length;
+    });
+    // Generate suggestions
+    const suggestions = [];
+    const warnings = [];
+    // Check for MCP source changes
+    const mcpSource = categoryMap.get("mcp_source");
+    if (mcpSource && mcpSource.length > 0) {
+        suggestions.push("MCP 소스 변경됨 → 커밋 후 `vibe_pm.publish_mcp` 실행 권장");
+    }
+    // Check for engine changes
+    const engineRust = categoryMap.get("engine_rust");
+    if (engineRust && engineRust.length > 0) {
+        suggestions.push("Rust 엔진 변경됨 → 커밋 후 엔진 빌드 + GitHub Release 필요할 수 있음");
+    }
+    // Check for vibe config
+    const vibeConfig = categoryMap.get("vibe_config");
+    if (vibeConfig && vibeConfig.length > 0) {
+        warnings.push(".vibe/ 파일은 보통 gitignore됩니다. 의도적 커밋인지 확인하세요.");
+    }
+    // Check for build artifacts
+    const buildArtifacts = categoryMap.get("build_artifacts");
+    if (buildArtifacts && buildArtifacts.length > 0) {
+        warnings.push("빌드 결과물은 보통 gitignore됩니다. 의도적 커밋인지 확인하세요.");
+    }
+    // Check for sensitive patterns
+    for (const change of changes) {
+        const lower = change.path.toLowerCase();
+        if (lower.includes("secret") ||
+            lower.includes("credential") ||
+            lower.includes(".env") ||
+            lower.includes("token")) {
+            warnings.push(`민감한 파일 감지: ${change.path} - 커밋 전 확인 필요`);
+        }
+    }
+    return {
+        categories,
+        total_files: changes.length,
+        suggestions,
+        warnings,
+    };
+}
+/**
+ * Generate a summary for user decision
+ */
+export function formatAnalysisSummary(analysis) {
+    const lines = [];
+    lines.push(`## 변경 파일 분석 (총 ${analysis.total_files}개)\n`);
+    for (const cat of analysis.categories) {
+        const emoji = cat.suggested ? "✅" : "⚠️";
+        lines.push(`### ${emoji} ${cat.name} (${cat.files.length}개)`);
+        lines.push(`> ${cat.description}`);
+        lines.push("");
+        // Show up to 5 files
+        const shown = cat.files.slice(0, 5);
+        for (const f of shown) {
+            const statusIcon = f.staged ? "📦" : "📝";
+            lines.push(`- ${statusIcon} ${f.path}`);
+        }
+        if (cat.files.length > 5) {
+            lines.push(`- ... 외 ${cat.files.length - 5}개`);
+        }
+        lines.push("");
+    }
+    if (analysis.suggestions.length > 0) {
+        lines.push("### 💡 제안");
+        for (const s of analysis.suggestions) {
+            lines.push(`- ${s}`);
+        }
+        lines.push("");
+    }
+    if (analysis.warnings.length > 0) {
+        lines.push("### ⚠️ 경고");
+        for (const w of analysis.warnings) {
+            lines.push(`- ${w}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}