@vibecodetown/mcp-server 2.2.0 → 2.2.1

package/build/tools/vibe_pm/index.js

@@ -1,7 +1,7 @@
 // adapters/mcp-ts/src/tools/vibe_pm/index.ts
 // vibe_pm.* MCP tools registration and export
 import { McpError } from "@modelcontextprotocol/sdk/types.js";
-import { briefingInputSchema, briefingOutputSchema, getDecisionInputSchema, getDecisionOutputSchema, submitDecisionInputSchema, submitDecisionOutputSchema, createWorkOrderInputSchema, createWorkOrderOutputSchema, inspectCodeInputSchema, inspectCodeOutputSchema, statusInputSchema, statusOutputSchema, memoryStatusInputSchema, memoryStatusOutputSchema, memorySyncInputSchema, memorySyncOutputSchema, advisoryReviewInputSchema, advisoryReviewOutputSchema, activateInputSchema, activateOutputSchema, repairPlanInputSchema, repairPlanOutputSchema, scaffoldInputSchema, scaffoldOutputSchema, finalizeWorkInputSchema, finalizeWorkOutputSchema, undoLastTaskInputSchema, undoLastTaskOutputSchema, runAppInputSchema, runAppOutputSchema, exportOutputInputSchema, exportOutputOutputSchema, searchOssInputSchema, searchOssOutputSchema, zoektEvidenceInputSchema, zoektEvidenceOutputSchema, doctorOutputSchema, updateOutputSchema } from "./types.js";
+import { briefingInputSchema, briefingOutputSchema, getDecisionInputSchema, getDecisionOutputSchema, submitDecisionInputSchema, submitDecisionOutputSchema, createWorkOrderInputSchema, createWorkOrderOutputSchema, inspectCodeInputSchema, inspectCodeOutputSchema, statusInputSchema, statusOutputSchema, memoryStatusInputSchema, memoryStatusOutputSchema, memorySyncInputSchema, memorySyncOutputSchema, advisoryReviewInputSchema, advisoryReviewOutputSchema, activateInputSchema, activateOutputSchema, repairPlanInputSchema, repairPlanOutputSchema, scaffoldInputSchema, scaffoldOutputSchema, finalizeWorkInputSchema, finalizeWorkOutputSchema, undoLastTaskInputSchema, undoLastTaskOutputSchema, runAppInputSchema, runAppOutputSchema, exportOutputInputSchema, exportOutputOutputSchema, searchOssInputSchema, searchOssOutputSchema, zoektEvidenceInputSchema, zoektEvidenceOutputSchema, ingressInputSchema, ingressOutputSchema, bridgeGenerateReferencesInputSchema, bridgeGenerateReferencesOutputSchema, bridgeConfirmReferenceInputSchema, bridgeConfirmReferenceOutputSchema, bridgeBuildSeedInputSchema, bridgeBuildSeedOutputSchema, doctorOutputSchema, updateOutputSchema } from "./types.js";
 import { briefing } from "./briefing.js";
 import { getDecision } from "./get_decision.js";
 import { submitDecision } from "./submit_decision.js";
@@ -22,13 +22,17 @@ import { runApp } from "./run_app.js";
 import { exportOutput } from "./export_output.js";
 import { searchOss } from "./search_oss.js";
 import { zoektEvidence } from "./zoekt_evidence.js";
+import { ingress } from "./ingress.js";
+import { bridgeGenerateReferences } from "./bridge_generate_references.js";
+import { bridgeConfirmReference } from "./bridge_confirm_reference.js";
+import { bridgeBuildSeed } from "./bridge_build_seed.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";
+import { resolveRunId } from "./context.js";
+import { checkIngressGate, isIngressGateRequiredForTool } from "./ingress_gate.js";
 // ============================================================
 // Helper Functions
 // ============================================================
@@ -85,6 +89,24 @@ function errorResult(toolName, error) {
         details
     });
 }
+async function enforceIngressGateIfNeeded(toolName, input) {
+    if (!isIngressGateRequiredForTool(toolName))
+        return null;
+    const basePath = process.cwd();
+    const project_id = input && typeof input === "object" && "project_id" in input && typeof input.project_id === "string"
+        ? input.project_id
+        : undefined;
+    const { run_id } = resolveRunId(project_id, basePath);
+    const gate = await checkIngressGate({ toolName, basePath, run_id });
+    if (gate.status === "BLOCK") {
+        return err(toolName, "ingress_gate_blocked", {
+            message: gate.message,
+            recovery: gate.recovery,
+            details: gate.details
+        });
+    }
+    return null;
+}
 // ============================================================
 // Tool Handlers (with error handling and structured content)
 // ============================================================
@@ -107,9 +129,30 @@ async function vibePmBriefing(input) {
         });
     }
 }
+async function vibePmIngress(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await ingress(input);
+        const validated = ingressOutputSchema.parse(result);
+        return toolResult("vibe_pm.ingress", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.ingress", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.ingress", "ingress_failed", {
+            message: msg,
+            recovery: "프로젝트 이어가기/새 작업을 확정하기 위한 입력을 확인해 주세요."
+        });
+    }
+}
 async function vibePmGetDecision(input) {
     const startedAt = Date.now();
     try {
+        const blocked = await enforceIngressGateIfNeeded("vibe_pm.get_decision", input);
+        if (blocked)
+            return blocked;
         const result = await getDecision(input);
         const validated = getDecisionOutputSchema.parse(result);
         return toolResult("vibe_pm.get_decision", validated, Date.now() - startedAt);
@@ -128,6 +171,9 @@ async function vibePmGetDecision(input) {
 async function vibePmSubmitDecision(input) {
     const startedAt = Date.now();
     try {
+        const blocked = await enforceIngressGateIfNeeded("vibe_pm.submit_decision", input);
+        if (blocked)
+            return blocked;
         const result = await submitDecision(input);
         const validated = submitDecisionOutputSchema.parse(result);
         return toolResult("vibe_pm.submit_decision", validated, Date.now() - startedAt);
@@ -146,6 +192,9 @@ async function vibePmSubmitDecision(input) {
 async function vibePmCreateWorkOrder(input) {
     const startedAt = Date.now();
     try {
+        const blocked = await enforceIngressGateIfNeeded("vibe_pm.create_work_order", input);
+        if (blocked)
+            return blocked;
         const result = await createWorkOrder(input);
         const validated = createWorkOrderOutputSchema.parse(result);
         return toolResult("vibe_pm.create_work_order", validated, Date.now() - startedAt);
@@ -164,6 +213,9 @@ async function vibePmCreateWorkOrder(input) {
 async function vibePmInspectCode(input) {
     const startedAt = Date.now();
     try {
+        const blocked = await enforceIngressGateIfNeeded("vibe_pm.inspect_code", input);
+        if (blocked)
+            return blocked;
         const result = await inspectCode(input);
         const validated = inspectCodeOutputSchema.parse(result);
         return toolResult("vibe_pm.inspect_code", validated, Date.now() - startedAt);
@@ -371,6 +423,9 @@ async function vibePmScaffold(input) {
 async function vibePmFinalizeWork(input) {
     const startedAt = Date.now();
     try {
+        const blocked = await enforceIngressGateIfNeeded("vibe_pm.finalize_work", input);
+        if (blocked)
+            return blocked;
         const result = await finalizeWork(input);
         const validated = finalizeWorkOutputSchema.parse(result);
         return toolResult("vibe_pm.finalize_work", validated, Date.now() - startedAt);
@@ -389,6 +444,9 @@ async function vibePmFinalizeWork(input) {
 async function vibePmUndoLastTask(input) {
     const startedAt = Date.now();
     try {
+        const blocked = await enforceIngressGateIfNeeded("vibe_pm.undo_last_task", input);
+        if (blocked)
+            return blocked;
         const result = await undoLastTask(input);
         const validated = undoLastTaskOutputSchema.parse(result);
         return toolResult("vibe_pm.undo_last_task", validated, Date.now() - startedAt);
@@ -407,6 +465,9 @@ async function vibePmUndoLastTask(input) {
 async function vibePmRunApp(input) {
     const startedAt = Date.now();
     try {
+        const blocked = await enforceIngressGateIfNeeded("vibe_pm.run_app", input);
+        if (blocked)
+            return blocked;
         const result = await runApp(input);
         const validated = runAppOutputSchema.parse(result);
         return toolResult("vibe_pm.run_app", validated, Date.now() - startedAt);
@@ -476,75 +537,93 @@ async function vibePmZoektEvidence(input) {
         });
     }
 }
-async function vibePmGate(input) {
+async function vibePmBridgeGenerateReferences(input) {
     const startedAt = Date.now();
     try {
-        const result = await gate(input);
-        const validated = gateOutputSchema.parse(result);
-        return toolResult("vibe_pm.gate", validated, Date.now() - startedAt);
+        const result = await bridgeGenerateReferences(input);
+        const validated = bridgeGenerateReferencesOutputSchema.parse(result);
+        return toolResult("vibe_pm.bridge_generate_references", validated, Date.now() - startedAt);
     }
     catch (e) {
         if (e instanceof McpError) {
-            return errorResult("vibe_pm.gate", e);
+            return errorResult("vibe_pm.bridge_generate_references", e);
         }
         const msg = e instanceof Error ? e.message : String(e);
-        return err("vibe_pm.gate", "gate_failed", {
+        return err("vibe_pm.bridge_generate_references", "bridge_generate_references_failed", {
             message: msg,
-            recovery: "work_order 형식을 확인하고 다시 시도해주세요."
+            recovery: "키워드/의도를 더 구체적으로 적은 뒤 다시 시도해주세요."
         });
     }
 }
-async function vibePmForceOverride(input) {
+async function vibePmBridgeConfirmReference(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);
+        const result = await bridgeConfirmReference(input);
+        const validated = bridgeConfirmReferenceOutputSchema.parse(result);
+        return toolResult("vibe_pm.bridge_confirm_reference", validated, Date.now() - startedAt);
     }
     catch (e) {
         if (e instanceof McpError) {
-            return errorResult("vibe_pm.force_override", e);
+            return errorResult("vibe_pm.bridge_confirm_reference", e);
         }
         const msg = e instanceof Error ? e.message : String(e);
-        return err("vibe_pm.force_override", "force_override_failed", {
+        return err("vibe_pm.bridge_confirm_reference", "bridge_confirm_reference_failed", {
             message: msg,
-            recovery: "acknowledge_risks: true 를 반드시 포함해야 합니다."
+            recovery: "A/B/C 중 하나로 선택한 뒤 다시 시도해주세요."
         });
     }
 }
-async function vibePmSaveRule(input) {
+async function vibePmBridgeBuildSeed(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await bridgeBuildSeed(input);
+        const validated = bridgeBuildSeedOutputSchema.parse(result);
+        return toolResult("vibe_pm.bridge_build_seed", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.bridge_build_seed", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.bridge_build_seed", "bridge_build_seed_failed", {
+            message: msg,
+            recovery: "레퍼런스 확정이 완료되었는지 확인한 뒤 다시 시도해주세요."
+        });
+    }
+}
+async function vibePmGate(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);
+        const result = await gate(input);
+        const validated = gateOutputSchema.parse(result);
+        return toolResult("vibe_pm.gate", validated, Date.now() - startedAt);
     }
     catch (e) {
         if (e instanceof McpError) {
-            return errorResult("vibe_pm.save_rule", e);
+            return errorResult("vibe_pm.gate", e);
         }
         const msg = e instanceof Error ? e.message : String(e);
-        return err("vibe_pm.save_rule", "save_rule_failed", {
+        return err("vibe_pm.gate", "gate_failed", {
             message: msg,
-            recovery: "규칙 제목, 트리거, 액션을 확인하세요."
+            recovery: "work_order 형식을 확인하고 다시 시도해주세요."
         });
     }
 }
-async function vibePmListRules(input) {
+async function vibePmForceOverride(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);
+        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.list_rules", e);
+            return errorResult("vibe_pm.force_override", e);
         }
         const msg = e instanceof Error ? e.message : String(e);
-        return err("vibe_pm.list_rules", "list_rules_failed", {
+        return err("vibe_pm.force_override", "force_override_failed", {
             message: msg,
-            recovery: ".vibe 폴더가 있는지 확인하세요."
+            recovery: "acknowledge_risks: true 를 반드시 포함해야 합니다."
         });
     }
 }
@@ -555,6 +634,7 @@ export function defineVibePmTools() {
     return {
         // Input schemas (for validation)
         briefingInputSchema,
+        ingressInputSchema,
         getDecisionInputSchema,
         submitDecisionInputSchema,
         createWorkOrderInputSchema,
@@ -574,12 +654,14 @@ export function defineVibePmTools() {
         exportOutputInputSchema,
         searchOssInputSchema,
         zoektEvidenceInputSchema,
+        bridgeGenerateReferencesInputSchema,
+        bridgeConfirmReferenceInputSchema,
+        bridgeBuildSeedInputSchema,
         gateInputSchema,
         forceOverrideInputSchema,
-        saveRuleInputSchema,
-        listRulesInputSchema,
         // Tool handlers
         vibePmBriefing,
+        vibePmIngress,
         vibePmGetDecision,
         vibePmSubmitDecision,
         vibePmCreateWorkOrder,
@@ -599,10 +681,11 @@ export function defineVibePmTools() {
         vibePmExportOutput,
         vibePmSearchOss,
         vibePmZoektEvidence,
+        vibePmBridgeGenerateReferences,
+        vibePmBridgeConfirmReference,
+        vibePmBridgeBuildSeed,
         vibePmGate,
-        vibePmForceOverride,
-        vibePmSaveRule,
-        vibePmListRules
+        vibePmForceOverride
     };
 }
 // ============================================================
@@ -611,6 +694,8 @@ export function defineVibePmTools() {
 export const VIBE_PM_TOOL_DESCRIPTIONS = {
     "vibe_pm.briefing": `프로젝트를 시작하거나 재개합니다. 사용자의 아이디어를 받아 구조화합니다.
 사용 시점: 사용자가 "시작해줘" 또는 새 아이디어를 설명할 때`,
+    "vibe_pm.ingress": `프로젝트를 이어가기/새 작업 시작을 확정하고, 필요한 사전 점검(컨텍스트 스캔)을 수행합니다.
+사용 시점: 기존 프로젝트를 이어서 할지, 새 작업을 시작할지 확정해야 할 때`,
     "vibe_pm.get_decision": `현재 결재가 필요한 안건을 조회합니다.
 사용 시점: 구현 전 승인이 필요할 때`,
     "vibe_pm.submit_decision": `결재를 제출합니다.
@@ -648,6 +733,12 @@ export const VIBE_PM_TOOL_DESCRIPTIONS = {
 사용 시점: export_output용 템플릿을 고르기 전에 후보를 좁히고 싶을 때`,
     "vibe_pm.zoekt_evidence": `로컬 루트들에서 패턴 증거를 수집합니다(zoekt/rg/python_scan).
 사용 시점: 특정 코드 패턴이 실제로 얼마나 쓰이는지 근거가 필요할 때`,
+    "vibe_pm.bridge_generate_references": `모호한 요구를 레퍼런스 후보(A/B/C)로 정리하고 파일로 저장합니다.
+사용 시점: 구현 전에 "어떤 스타일/유사 제품 기준으로 만들지"를 확정해야 할 때`,
+    "vibe_pm.bridge_confirm_reference": `레퍼런스 후보 중 하나(A/B/C)를 확정하고 확인 기록을 남깁니다.
+사용 시점: 레퍼런스 후보를 만든 뒤, 기준을 하나로 고정할 때`,
+    "vibe_pm.bridge_build_seed": `확정된 레퍼런스를 기반으로 작업 seed를 생성합니다.
+사용 시점: 레퍼런스 확정 후, create_work_order의 기준을 고정하고 싶을 때`,
     "vibe_pm.export_output": `구현된 기능을 원하는 형태로 내보냅니다. (문서/API/CLI 등)
 사용 시점: 기능 구현 및 검수 후, 결과물을 다른 형태로 배포/공유하고 싶을 때`,
     "vibe_pm.gate": `작업 지시서가 시스템 설계 규칙을 준수하는지 검증합니다. (Schema/Path/Runtime/Semgrep Gate)
@@ -655,10 +746,5 @@ export const VIBE_PM_TOOL_DESCRIPTIONS = {
 BLOCK이 없으면 실행 가능, BLOCK이 있으면 수정이 필요합니다.`,
     "vibe_pm.force_override": `차단된 작업을 강제로 실행할 수 있는 탈출 경로입니다. (P2-1)
 사용 시점: 정책에 의해 차단되었지만 긴급히 실행이 필요할 때
-⚠ 주의: acknowledge_risks=true 필수, 모든 사용은 감사 로그에 기록됩니다.`,
-    "vibe_pm.save_rule": `프로젝트별 워크플로우 규칙을 저장합니다.
-사용 시점: 사용자가 "~할 때마다 ~해", "항상 ~해줘" 같은 반복 패턴을 지시할 때
-저장 위치: .vibe/project_rules.md`,
-    "vibe_pm.list_rules": `현재 프로젝트에 저장된 워크플로우 규칙 목록을 조회합니다.
-사용 시점: 작업 시작 전 적용할 규칙을 확인하고 싶을 때`
+⚠ 주의: acknowledge_risks=true 필수, 모든 사용은 감사 로그에 기록됩니다.`
 };