@vibecodetown/mcp-server 2.1.4 → 2.2.1

package/build/tools/vibe_pm/save_rule.js

@@ -0,0 +1,120 @@
+// adapters/mcp-ts/src/tools/vibe_pm/save_rule.ts
+// vibe_pm.save_rule - 프로젝트 워크플로우 규칙 저장
+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 saveRuleInputSchema = z.object({
+    base_path: z.string().describe("프로젝트 루트 경로"),
+    rule_title: z.string().min(1).describe("규칙 제목 (예: 'API 변경 시 문서 갱신')"),
+    trigger: z.string().min(1).describe("언제 적용되는지 (예: 'API 엔드포인트를 수정할 때마다')"),
+    action: z.string().min(1).describe("무엇을 해야 하는지 (예: 'docs/api.md를 함께 갱신한다')"),
+    example: z.string().optional().describe("구체적인 예시 (선택)")
+}).strict();
+export const saveRuleOutputSchema = z.object({
+    status: z.enum(["saved", "error"]),
+    message: z.string(),
+    rules_file: z.string().describe(".vibe/project_rules.md 경로"),
+    rule_count: z.number().describe("현재 저장된 규칙 수")
+}).strict();
+// ============================================================
+// Implementation
+// ============================================================
+const RULES_FILENAME = "project_rules.md";
+/**
+ * 규칙 파일 경로 반환
+ */
+function getRulesFilePath(basePath) {
+    const { vibeDir } = getVibeRepoPaths(basePath);
+    return path.join(vibeDir, RULES_FILENAME);
+}
+/**
+ * 규칙 파일 읽기 (없으면 기본 템플릿 반환)
+ */
+async function readRulesFile(filePath) {
+    try {
+        return await fs.readFile(filePath, "utf-8");
+    }
+    catch {
+        // 파일이 없으면 기본 템플릿 반환
+        return `# Project Workflow Rules
+
+> 이 파일은 Vibe PM이 자동으로 관리합니다.
+> 프로젝트별 워크플로우 규칙이 여기에 저장됩니다.
+
+---
+
+`;
+    }
+}
+/**
+ * 규칙 수 계산
+ */
+function countRules(content) {
+    const lines = content.split("\n");
+    let count = 0;
+    for (const line of lines) {
+        if (line.startsWith("## ") && !line.includes("Project Workflow Rules")) {
+            count++;
+        }
+    }
+    return count;
+}
+/**
+ * 새 규칙을 마크다운 형식으로 포맷
+ */
+function formatRule(input) {
+    const timestamp = new Date().toISOString().split("T")[0];
+    let rule = `## ${input.rule_title}
+
+- **언제**: ${input.trigger}
+- **무엇을**: ${input.action}
+`;
+    if (input.example) {
+        rule += `- **예시**: ${input.example}
+`;
+    }
+    rule += `- **등록일**: ${timestamp}
+
+---
+
+`;
+    return rule;
+}
+/**
+ * 규칙 저장
+ */
+export async function saveRule(input) {
+    const rulesFile = getRulesFilePath(input.base_path);
+    try {
+        // .vibe 디렉토리 확인/생성
+        const vibeDir = path.dirname(rulesFile);
+        await fs.mkdir(vibeDir, { recursive: true });
+        // 기존 규칙 읽기
+        let content = await readRulesFile(rulesFile);
+        // 새 규칙 추가
+        const newRule = formatRule(input);
+        content += newRule;
+        // 파일 저장
+        await fs.writeFile(rulesFile, content, "utf-8");
+        const ruleCount = countRules(content);
+        return {
+            status: "saved",
+            message: `규칙 '${input.rule_title}'이(가) 저장되었습니다.`,
+            rules_file: rulesFile,
+            rule_count: ruleCount
+        };
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return {
+            status: "error",
+            message: `규칙 저장 실패: ${msg}`,
+            rules_file: rulesFile,
+            rule_count: 0
+        };
+    }
+}

package/build/tools/vibe_pm/search_oss.js

@@ -1,10 +1,11 @@
 // adapters/mcp-ts/src/tools/vibe_pm/search_oss.ts
 // vibe_pm.search_oss - Search OSS repos (gh) and write evidence under runs/<run_id>/export/
 import { McpError, ErrorCode } from "@modelcontextprotocol/sdk/types.js";
-import { runEngine } from "../../engine.js";
+import { runPythonCli } from "../../engine.js";
 import { safeJsonParse } from "../../cli.js";
 import { validateToolInput } from "../../security/input-validator.js";
 import { resolveProjectId, resolveRunId } from "./context.js";
+import { classifyPythonError } from "./python_error.js";
 function toCsv(values) {
     return values
         .map((v) => (typeof v === "string" ? v.trim() : ""))
@@ -64,9 +65,10 @@ export async function searchOss(input) {
     const writeEvidence = input?.write_evidence !== false;
     if (!writeEvidence)
         cmd.push("--no-write-evidence");
-    const res = await runEngine("vibecoding-helper", cmd, { timeoutMs: 180_000 });
+    const res = await runPythonCli(cmd, { timeoutMs: 180_000 });
     if (res.code !== 0) {
-        throw new Error(`search-oss failed: ${res.stderr || res.stdout || `exit_code=${res.code}`}`);
+        const classified = classifyPythonError(res.stderr ?? "", res.code, "OSS 검색");
+        throw new Error(`${classified.issueCode}: ${classified.summary}`);
     }
     const parsed = safeJsonParse(res.stdout);
     if (!parsed.ok) {

package/build/tools/vibe_pm/spec_rag.js

@@ -0,0 +1,185 @@
+// adapters/mcp-ts/src/tools/vibe_pm/spec_rag.ts
+// Spec RAG: Auto-inject SSOT context into work orders
+// Reference: docs/DEV_SPEC/0124/SPEC_RAG_WORK_PROTOCOL
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { runKceRetrieve, runKceStatus } from "./kce/preflight.js";
+/**
+ * Priority-ordered list of SSOT documents to inject
+ */
+const SPEC_DOCS = [
+    "docs/ssot/DECISION_SSOT.md",
+    "docs/ssot/QUALITY_SSOT.md",
+    "docs/ssot/MCP_SSOT.md",
+    "docs/SSOT.md"
+];
+/**
+ * Get spec context for injection into work orders.
+ *
+ * Strategy:
+ * 1. Try KCE retrieval (if status=READY)
+ * 2. Fallback to direct file reading
+ * 3. Return empty if both fail
+ */
+export async function getSpecContext(opts) {
+    const maxChars = opts.maxChars ?? 2500;
+    const maxItems = opts.maxItems ?? 4;
+    const basePath = opts.basePath ?? process.cwd();
+    // Strategy 1: Try KCE retrieval
+    try {
+        const status = await runKceStatus();
+        if (status.readiness_state === "READY") {
+            const result = await runKceRetrieve({
+                query: opts.query,
+                maxItems,
+                limit: 10,
+                maxTotalChars: maxChars,
+                maxChunkChars: Math.min(800, Math.floor(maxChars / maxItems)),
+                pathPrefix: "docs/ssot"
+            });
+            if (result.context_block.trim()) {
+                const referencedDocs = (result.hits ?? [])
+                    .map((h) => h.path)
+                    .filter((p) => p.endsWith(".md"));
+                return {
+                    context_block: buildSpecBlock(result.context_block, referencedDocs),
+                    source: "kce",
+                    referenced_docs: referencedDocs
+                };
+            }
+        }
+    }
+    catch {
+        // KCE unavailable, fall through to fallback
+    }
+    // Strategy 2: Fallback to direct file reading
+    try {
+        const { content, docs } = readSpecDocsFallback(basePath, maxChars);
+        if (content.trim()) {
+            return {
+                context_block: buildSpecBlock(content, docs),
+                source: "fallback",
+                referenced_docs: docs
+            };
+        }
+    }
+    catch {
+        // Fallback also failed
+    }
+    // Strategy 3: Return empty
+    return {
+        context_block: "",
+        source: "empty",
+        referenced_docs: []
+    };
+}
+/**
+ * Build the [SPEC_CONTEXT] block for injection
+ */
+export function buildSpecBlock(content, docs) {
+    if (!content.trim())
+        return "";
+    const lines = [];
+    lines.push("[SPEC_CONTEXT]");
+    lines.push(content.trim());
+    if (docs.length > 0) {
+        lines.push("");
+        lines.push("[참조 문서]");
+        for (const doc of docs.slice(0, 6)) {
+            const basename = path.basename(doc);
+            lines.push(`- ${basename}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Fallback: Read spec docs directly from filesystem
+ */
+function readSpecDocsFallback(basePath, maxChars) {
+    const chunks = [];
+    const docs = [];
+    let totalChars = 0;
+    const perDocLimit = Math.floor(maxChars / SPEC_DOCS.length);
+    for (const docPath of SPEC_DOCS) {
+        if (totalChars >= maxChars)
+            break;
+        const fullPath = path.join(basePath, docPath);
+        if (!fs.existsSync(fullPath))
+            continue;
+        try {
+            const content = fs.readFileSync(fullPath, "utf-8");
+            const extracted = extractRelevantSections(content, perDocLimit);
+            if (extracted.trim()) {
+                const basename = path.basename(docPath);
+                chunks.push(`### ${basename}\n${extracted.trim()}`);
+                docs.push(docPath);
+                totalChars += extracted.length;
+            }
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    return {
+        content: chunks.join("\n\n"),
+        docs
+    };
+}
+/**
+ * Extract relevant sections from a markdown document
+ * Focus on rules, constraints, and key definitions
+ */
+function extractRelevantSections(content, maxChars) {
+    // Priority headers to extract
+    const priorityPatterns = [
+        /^#+\s*(?:규칙|Rules|제약|Constraints|필수|Required|금지|Prohibited)/im,
+        /^#+\s*(?:개요|Overview|핵심|Core|원칙|Principles)/im,
+        /^#+\s*(?:정의|Definitions|용어|Terms)/im
+    ];
+    const lines = content.split("\n");
+    const sections = [];
+    let currentSection = [];
+    let inPrioritySection = false;
+    let sectionHeader = "";
+    for (const line of lines) {
+        // Check if this is a header
+        const isHeader = /^#+\s+/.test(line);
+        if (isHeader) {
+            // Save previous section if it was a priority section
+            if (inPrioritySection && currentSection.length > 0) {
+                sections.push([sectionHeader, ...currentSection].join("\n"));
+            }
+            // Check if this header is a priority section
+            inPrioritySection = priorityPatterns.some((p) => p.test(line));
+            sectionHeader = line;
+            currentSection = [];
+        }
+        else if (inPrioritySection) {
+            currentSection.push(line);
+        }
+    }
+    // Don't forget the last section
+    if (inPrioritySection && currentSection.length > 0) {
+        sections.push([sectionHeader, ...currentSection].join("\n"));
+    }
+    // If no priority sections found, extract the first N characters as overview
+    if (sections.length === 0) {
+        const overview = content.slice(0, Math.min(maxChars, 500)).trim();
+        if (overview) {
+            // Try to end at a sentence boundary
+            const lastPeriod = overview.lastIndexOf(".");
+            const lastNewline = overview.lastIndexOf("\n");
+            const cutoff = Math.max(lastPeriod, lastNewline);
+            return cutoff > 100 ? overview.slice(0, cutoff + 1) : overview;
+        }
+        return "";
+    }
+    // Combine sections up to maxChars
+    let result = "";
+    for (const section of sections) {
+        if (result.length + section.length > maxChars)
+            break;
+        result += (result ? "\n\n" : "") + section;
+    }
+    return result;
+}

package/build/tools/vibe_pm/status.js

@@ -1,11 +1,14 @@
 // adapters/mcp-ts/src/tools/vibe_pm/status.ts
 // vibe_pm.status - Project status query
+import * as fs from "node:fs";
+import * as path from "node:path";
 import { runEngineWithCache } from "../../engine.js";
 import { safeJsonParse } from "../../cli.js";
 import { resolveRunId, resolveProjectId, getRunContext, readRunState } from "./context.js";
 import { formatMode, formatPhase, signalToReview } from "./pm_language.js";
 import { validateToolInput } from "../../security/input-validator.js";
 import { SpecHighValidateOutputSchema } from "../../generated/spec_high_validate_output.js";
+import { IngressSummaryFileSchema } from "../../generated/ingress_summary_file.js";
 /**
  * vibe_pm.status - Query current project status
  *
@@ -13,8 +16,7 @@ import { SpecHighValidateOutputSchema } from "../../generated/spec_high_validate
  *   → spec-high validate <run_id>
  *   → status summary generation
  */
-export async function status(input) {
-    const basePath = process.cwd();
+export async function status(input, basePath = process.cwd()) {
     validateToolInput({ project_id: input.project_id });
     // Resolve run_id
     const { run_id, is_new } = resolveRunId(input.project_id, basePath);
@@ -77,7 +79,17 @@ export async function status(input) {
     // Collect risks
     const risks = validateResult?.risks ?? [];
     // Determine next action based on state
-    const nextAction = determineNextAction(phase, decisionsPending, lastReviewStatus);
+    let nextAction = determineNextAction(phase, decisionsPending, lastReviewStatus);
+    // P27: deterministic auto-routing for "pre-work clarification" (based on ingress signals)
+    const routed = maybeAutoRouteForClarification({
+        runDirAbs: context.runs_path,
+        phase,
+        decisionsPending
+    });
+    if (routed) {
+        risks.push(routed.risk_note);
+        nextAction = routed.next_action;
+    }
     return {
         project_id,
         project: {
@@ -95,6 +107,41 @@ export async function status(input) {
         next_action: nextAction
     };
 }
+function maybeAutoRouteForClarification(args) {
+    // Never override when user still has pending approvals.
+    if (args.decisionsPending > 0)
+        return null;
+    // Only relevant before work order is issued.
+    if (!(args.phase === "decision" || args.phase === "briefing" || args.phase === "init"))
+        return null;
+    const summaryAbs = path.join(args.runDirAbs, "ingress", "ingress_summary.json");
+    if (!fs.existsSync(summaryAbs))
+        return null;
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(summaryAbs, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+    const parsed = IngressSummaryFileSchema.safeParse(raw);
+    if (!parsed.success)
+        return null;
+    const recommended = parsed.data.high_level.clarification_recommended === true;
+    if (!recommended)
+        return null;
+    // Treat as completed if seed exists (protocol done).
+    const seedAbs = path.join(args.runDirAbs, "bridge", "work_order_seed.json");
+    if (fs.existsSync(seedAbs))
+        return null;
+    return {
+        next_action: {
+            tool: "vibe_pm.bridge_generate_references",
+            label: "다음 할 일: 예시를 고르고 작업 방향을 고정하기"
+        },
+        risk_note: "작업 방향이 아직 충분히 고정되지 않았습니다. 예시를 한 번 선택하면 다음 단계가 빨라집니다."
+    };
+}
 function determineNextAction(phase, decisionsPending, lastReviewStatus) {
     // If there are pending decisions
     if (decisionsPending > 0) {

package/build/tools/vibe_pm/submit_decision.js

@@ -20,8 +20,8 @@ export async function submitDecision(input) {
     const project_id = resolveProjectId(run_id, basePath);
     // Format answer text (combine choice with note if provided)
     const answerText = input.note ? `${input.choice}: ${input.note}` : input.choice;
-    // Step 1: Submit answer
-    const answerResult = await runEngine("vibecoding-helper", ["answer", run_id, "--text", answerText], { timeoutMs: 120_000 });
+    // Step 1: Submit answer via spec-high
+    const answerResult = await runEngine("spec-high", ["--root", "engines/spec_high", "answer", run_id, "--text", answerText], { timeoutMs: 120_000 });
     if (answerResult.code !== 0) {
         throw new Error(`결재 제출 실패: ${answerResult.stderr || "알 수 없는 오류"}`);
     }

package/build/tools/vibe_pm/types.js

@@ -183,6 +183,14 @@ import { SearchOssInputSchema } from "../../generated/search_oss_input.js";
 import { SearchOssOutputSchema } from "../../generated/search_oss_output.js";
 import { ZoektEvidenceInputSchema } from "../../generated/zoekt_evidence_input.js";
 import { ZoektEvidenceOutputSchema } from "../../generated/zoekt_evidence_output.js";
+import { IngressInputSchema } from "../../generated/ingress_input.js";
+import { IngressOutputSchema } from "../../generated/ingress_output.js";
+import { BridgeGenerateReferencesInputSchema } from "../../generated/bridge_generate_references_input.js";
+import { BridgeGenerateReferencesOutputSchema } from "../../generated/bridge_generate_references_output.js";
+import { BridgeConfirmReferenceInputSchema } from "../../generated/bridge_confirm_reference_input.js";
+import { BridgeConfirmReferenceOutputSchema } from "../../generated/bridge_confirm_reference_output.js";
+import { BridgeBuildSeedInputSchema } from "../../generated/bridge_build_seed_input.js";
+import { BridgeBuildSeedOutputSchema } from "../../generated/bridge_build_seed_output.js";
 export const finalizeWorkInputSchema = FinalizeWorkInputSchema;
 // Output schema is generated from JSON Schema SSOT.
 export const finalizeWorkOutputSchema = FinalizeWorkOutputSchema;
@@ -222,6 +230,26 @@ export const zoektEvidenceInputSchema = ZoektEvidenceInputSchema;
 // Output schema is generated from JSON Schema SSOT.
 export const zoektEvidenceOutputSchema = ZoektEvidenceOutputSchema;
 // ============================================================
+// vibe_pm.ingress
+// ============================================================
+export const ingressInputSchema = IngressInputSchema;
+export const ingressOutputSchema = IngressOutputSchema;
+// ============================================================
+// vibe_pm.bridge_generate_references
+// ============================================================
+export const bridgeGenerateReferencesInputSchema = BridgeGenerateReferencesInputSchema;
+export const bridgeGenerateReferencesOutputSchema = BridgeGenerateReferencesOutputSchema;
+// ============================================================
+// vibe_pm.bridge_confirm_reference
+// ============================================================
+export const bridgeConfirmReferenceInputSchema = BridgeConfirmReferenceInputSchema;
+export const bridgeConfirmReferenceOutputSchema = BridgeConfirmReferenceOutputSchema;
+// ============================================================
+// vibe_pm.bridge_build_seed
+// ============================================================
+export const bridgeBuildSeedInputSchema = BridgeBuildSeedInputSchema;
+export const bridgeBuildSeedOutputSchema = BridgeBuildSeedOutputSchema;
+// ============================================================
 // vibe_pm.doctor / vibe_pm.update (Output SSOT only)
 // ============================================================
 export const doctorOutputSchema = DoctorOutputSchema;

package/build/tools/vibe_pm/undo_last_task.js

@@ -1,10 +1,11 @@
 // adapters/mcp-ts/src/tools/vibe_pm/undo_last_task.ts
 // vibe_pm.undo_last_task - Time machine rollback via git revert
+//
+// All subprocess invocations go through cli_invoker for centralized management.
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { exec } from "node:child_process";
-import { promisify } from "node:util";
-const execAsync = promisify(exec);
+import { invokeGit } from "../../runtime/cli_invoker.js";
+import { isGitConflictError } from "../../errors.js";
 /**
  * vibe_pm.undo_last_task - Rollback recent commits via git revert
  *
@@ -43,24 +44,25 @@ export async function undoLastTask(input) {
     const revertedTasks = [];
     const revertErrors = [];
     for (const commit of commits) {
-        try {
-            await execAsync(`git revert --no-edit ${commit.hash}`, { cwd: basePath });
+        const result = await invokeGit(["revert", "--no-edit", commit.hash], basePath);
+        if (result.exitCode === 0) {
             revertedTasks.push({
                 commit_hash: commit.shortHash,
                 task_summary: commit.subject,
                 timestamp: commit.timestamp
             });
         }
-        catch (err) {
-            const errMsg = err instanceof Error ? err.message : String(err);
+        else {
+            const errMsg = result.stderr || result.stdout;
             revertErrors.push(`${commit.shortHash}: ${errMsg}`);
             // If revert fails due to conflicts, abort and stop
-            if (errMsg.includes("conflict") || errMsg.includes("CONFLICT")) {
-                try {
-                    await execAsync("git revert --abort", { cwd: basePath });
-                }
-                catch {
-                    // Ignore abort errors
+            // Check for conflict indicators (exit code 1 with conflict message)
+            // P1-4: Use centralized error pattern
+            if (isGitConflictError(errMsg) || result.exitCode === 1) {
+                const abortResult = await invokeGit(["revert", "--abort"], basePath);
+                if (abortResult.exitCode !== 0) {
+                    // Abort failed - critical state inconsistency
+                    revertErrors.push(`[CRITICAL] git revert --abort 실패. 수동 복구 필요: git status 확인 후 git revert --abort 또는 git revert --continue 실행`);
                 }
                 break;
             }
@@ -99,9 +101,12 @@ export async function undoLastTask(input) {
  * Get recent commits from git log
  */
 async function getRecentCommits(basePath, count) {
-    const { stdout } = await execAsync(`git log --oneline -n ${count} --format="%H|%h|%s|%ci"`, { cwd: basePath });
+    const result = await invokeGit(["log", "--oneline", "-n", String(count), "--format=%H|%h|%s|%ci"], basePath);
+    if (result.exitCode !== 0) {
+        throw new Error(result.stderr || "git log failed");
+    }
     const commits = [];
-    const lines = stdout.trim().split("\n").filter(Boolean);
+    const lines = result.stdout.trim().split("\n").filter(Boolean);
     for (const line of lines) {
         const [hash, shortHash, subject, timestamp] = line.split("|");
         if (hash && shortHash && subject) {
@@ -119,13 +124,11 @@ async function getRecentCommits(basePath, count) {
  * Get current HEAD commit hash
  */
 async function getCurrentCommit(basePath) {
-    try {
-        const { stdout } = await execAsync("git rev-parse --short HEAD", { cwd: basePath });
-        return stdout.trim();
-    }
-    catch {
+    const result = await invokeGit(["rev-parse", "--short", "HEAD"], basePath);
+    if (result.exitCode !== 0) {
         return "unknown";
     }
+    return result.stdout.trim();
 }
 /**
  * Add rollback entry to DEV_LOG