@vibecodetown/mcp-server 2.1.0

package/build/tools/vibe_pm/index.js

@@ -0,0 +1,593 @@
+// 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 { briefing } from "./briefing.js";
+import { getDecision } from "./get_decision.js";
+import { submitDecision } from "./submit_decision.js";
+import { createWorkOrder } from "./create_work_order.js";
+import { inspectCode } from "./inspect_code.js";
+import { status } from "./status.js";
+import { memoryStatus } from "./memory_status.js";
+import { memorySync } from "./memory_sync.js";
+import { advisoryReview } from "./advisory_review.js";
+import { activate } from "./activate.js";
+import { repairPlan } from "./repair_plan.js";
+import { doctor, DoctorInputSchema } from "./doctor.js";
+import { update, UpdateInputSchema } from "./update.js";
+import { scaffold } from "./scaffold.js";
+import { finalizeWork } from "./finalize_work.js";
+import { undoLastTask } from "./undo_last_task.js";
+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 { gate, gateInputSchema, gateOutputSchema } from "./gate.js";
+import { getAuthGate } from "../../auth/index.js";
+import { ToolErrorOutputSchema } from "../../generated/tool_error_output.js";
+import { decorateToolOutputText, notifyDesktopBestEffort } from "../../dx/activity.js";
+// ============================================================
+// Helper Functions
+// ============================================================
+/**
+ * Create a successful tool result with both text and structured content
+ */
+function toolResult(toolName, data, durationMs) {
+    const jsonText = JSON.stringify(data, null, 2);
+    void notifyDesktopBestEffort({ toolName, data, outcome: "success", durationMs });
+    return {
+        content: decorateToolOutputText(toolName, jsonText, data, "success", durationMs),
+        structuredContent: data
+    };
+}
+/**
+ * Legacy helper for backward compatibility
+ */
+function toolText(obj) {
+    return { content: [{ type: "text", text: JSON.stringify(obj, null, 2) }] };
+}
+/**
+ * Create an error tool result (non-throwing for graceful degradation)
+ */
+function err(toolName, reason, extra) {
+    const out = ToolErrorOutputSchema.parse({
+        status: "ERROR",
+        reason,
+        message: extra?.message ?? "요청을 처리하는 중 문제가 생겼습니다.",
+        recovery: extra?.recovery,
+        is_retryable: extra?.is_retryable,
+        details: extra?.details,
+        debug: extra?.debug
+    });
+    const jsonText = JSON.stringify(out, null, 2);
+    void notifyDesktopBestEffort({ toolName, data: out, outcome: "error" });
+    return {
+        content: decorateToolOutputText(toolName, jsonText, out, "error"),
+        structuredContent: out,
+        isError: true
+    };
+}
+/**
+ * Convert McpError to tool result for consistent error handling
+ */
+function errorResult(toolName, error) {
+    const details = { mcp_code: error.code };
+    if (error.data !== undefined) {
+        details.mcp_data = error.data;
+    }
+    return err(toolName, "mcp_error", {
+        message: error.message,
+        recovery: "입력 값을 확인한 뒤 다시 시도해 주세요.",
+        is_retryable: false,
+        details
+    });
+}
+// ============================================================
+// Tool Handlers (with error handling and structured content)
+// ============================================================
+async function vibePmBriefing(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await briefing(input);
+        // Validate output against schema
+        const validated = briefingOutputSchema.parse(result);
+        return toolResult("vibe_pm.briefing", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.briefing", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.briefing", "briefing_failed", {
+            message: msg,
+            recovery: "프로젝트 아이디어를 더 구체적으로 설명해보세요."
+        });
+    }
+}
+async function vibePmGetDecision(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await getDecision(input);
+        const validated = getDecisionOutputSchema.parse(result);
+        return toolResult("vibe_pm.get_decision", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.get_decision", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.get_decision", "get_decision_failed", {
+            message: msg,
+            recovery: "vibe_pm.briefing 으로 프로젝트를 먼저 시작하세요."
+        });
+    }
+}
+async function vibePmSubmitDecision(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await submitDecision(input);
+        const validated = submitDecisionOutputSchema.parse(result);
+        return toolResult("vibe_pm.submit_decision", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.submit_decision", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.submit_decision", "submit_decision_failed", {
+            message: msg,
+            recovery: "vibe_pm.get_decision 으로 유효한 결재 항목을 확인하세요."
+        });
+    }
+}
+async function vibePmCreateWorkOrder(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await createWorkOrder(input);
+        const validated = createWorkOrderOutputSchema.parse(result);
+        return toolResult("vibe_pm.create_work_order", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.create_work_order", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.create_work_order", "create_work_order_failed", {
+            message: msg,
+            recovery: "모든 결재가 완료되었는지 vibe_pm.status 로 확인하세요."
+        });
+    }
+}
+async function vibePmInspectCode(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await inspectCode(input);
+        const validated = inspectCodeOutputSchema.parse(result);
+        return toolResult("vibe_pm.inspect_code", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.inspect_code", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.inspect_code", "inspect_code_failed", {
+            message: msg,
+            recovery: "vibe_pm.create_work_order 로 작업 지시서를 먼저 생성하세요."
+        });
+    }
+}
+async function vibePmStatus(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await status(input);
+        const validated = statusOutputSchema.parse(result);
+        return toolResult("vibe_pm.status", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.status", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.status", "status_failed", {
+            message: msg,
+            recovery: "vibe_pm.briefing 으로 프로젝트를 먼저 시작하세요."
+        });
+    }
+}
+async function vibePmMemoryStatus(input) {
+    const startedAt = Date.now();
+    try {
+        // Pro gating: memory_status is a PRO control tool (manual sync/status visibility)
+        const gate = getAuthGate();
+        const allowed = await gate.check("local_memory_pro_tools");
+        if (!allowed.allowed) {
+            return err("vibe_pm.memory_status", "feature_locked", {
+                message: "이 기능은 Pro 전용입니다. (Local Memory 상태 조회)",
+                recovery: "vibe_pm.activate로 라이선스를 등록한 뒤 다시 시도하세요.",
+                details: { feature: "local_memory_pro_tools", gate_reason: allowed.reason ?? "unknown" }
+            });
+        }
+        const result = await memoryStatus(input);
+        const validated = memoryStatusOutputSchema.parse(result);
+        return toolResult("vibe_pm.memory_status", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.memory_status", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.memory_status", "memory_status_failed", {
+            message: msg,
+            recovery: "Local Memory 상태 확인에 실패했습니다. vibe_pm.doctor 를 실행해보세요."
+        });
+    }
+}
+async function vibePmMemorySync(input) {
+    const startedAt = Date.now();
+    try {
+        // Pro gating: memory_sync performs indexing/refresh and is PRO-only.
+        const gate = getAuthGate();
+        const allowed = await gate.check("local_memory_pro_tools");
+        if (!allowed.allowed) {
+            return err("vibe_pm.memory_sync", "feature_locked", {
+                message: "이 기능은 Pro 전용입니다. (Local Memory 동기화)",
+                recovery: "vibe_pm.activate로 라이선스를 등록한 뒤 다시 시도하세요.",
+                details: { feature: "local_memory_pro_tools", gate_reason: allowed.reason ?? "unknown" }
+            });
+        }
+        const result = await memorySync(input);
+        const validated = memorySyncOutputSchema.parse(result);
+        return toolResult("vibe_pm.memory_sync", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.memory_sync", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.memory_sync", "memory_sync_failed", {
+            message: msg,
+            recovery: "Local Memory 갱신에 실패했습니다. vibe_pm.doctor 를 실행해보세요."
+        });
+    }
+}
+async function vibePmAdvisoryReview(input) {
+    const startedAt = Date.now();
+    try {
+        // P18: Pro gating (triage is always allowed; quick/thorough require deep_advisory entitlement)
+        const mode = (input.mode ?? "triage");
+        if (mode !== "triage") {
+            const gate = getAuthGate();
+            const allowed = await gate.check("deep_advisory");
+            if (!allowed.allowed) {
+                return err("vibe_pm.advisory_review", "feature_locked", {
+                    message: "이 기능은 Pro 전용입니다. (심층 리뷰)",
+                    recovery: "vibe_pm.activate로 라이선스 키를 등록한 뒤 다시 시도하세요.",
+                    details: { feature: "deep_advisory", gate_reason: allowed.reason ?? "unknown" }
+                });
+            }
+        }
+        const result = await advisoryReview(input);
+        const validated = advisoryReviewOutputSchema.parse(result);
+        return toolResult("vibe_pm.advisory_review", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.advisory_review", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.advisory_review", "advisory_review_failed", {
+            message: msg,
+            recovery: "필요하면 먼저 vibe_pm.memory_sync 로 문서 인덱스를 갱신한 뒤 다시 시도하세요."
+        });
+    }
+}
+async function vibePmActivate(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await activate(input);
+        const validated = activateOutputSchema.parse(result);
+        return toolResult("vibe_pm.activate", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.activate", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.activate", "activate_failed", {
+            message: msg,
+            recovery: "네트워크/키 상태를 확인한 뒤 다시 시도하세요. (오프라인 모드에서는 활성화가 불가합니다.)"
+        });
+    }
+}
+async function vibePmRepairPlan(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await repairPlan(input);
+        const validated = repairPlanOutputSchema.parse(result);
+        return toolResult("vibe_pm.repair_plan", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.repair_plan", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.repair_plan", "repair_plan_failed", {
+            message: msg,
+            recovery: "vibe_pm.inspect_code 를 먼저 실행하세요."
+        });
+    }
+}
+async function vibePmDoctor(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await doctor(input);
+        const validated = doctorOutputSchema.parse(result);
+        return toolResult("vibe_pm.doctor", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.doctor", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.doctor", "doctor_failed", { message: msg });
+    }
+}
+async function vibePmUpdate(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await update(input);
+        const validated = updateOutputSchema.parse(result);
+        return toolResult("vibe_pm.update", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.update", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.update", "update_failed", { message: msg });
+    }
+}
+async function vibePmScaffold(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await scaffold(input);
+        const validated = scaffoldOutputSchema.parse(result);
+        return toolResult("vibe_pm.scaffold", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.scaffold", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.scaffold", "scaffold_failed", {
+            message: msg,
+            recovery: "빈 디렉토리에서 실행하거나 force: true 옵션을 사용하세요."
+        });
+    }
+}
+async function vibePmFinalizeWork(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await finalizeWork(input);
+        const validated = finalizeWorkOutputSchema.parse(result);
+        return toolResult("vibe_pm.finalize_work", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.finalize_work", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.finalize_work", "finalize_work_failed", {
+            message: msg,
+            recovery: "Git 저장소인지 확인하고 다시 시도하세요."
+        });
+    }
+}
+async function vibePmUndoLastTask(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await undoLastTask(input);
+        const validated = undoLastTaskOutputSchema.parse(result);
+        return toolResult("vibe_pm.undo_last_task", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.undo_last_task", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.undo_last_task", "undo_last_task_failed", {
+            message: msg,
+            recovery: "Git 저장소인지 확인하고 커밋 이력이 있는지 확인하세요."
+        });
+    }
+}
+async function vibePmRunApp(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await runApp(input);
+        const validated = runAppOutputSchema.parse(result);
+        return toolResult("vibe_pm.run_app", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.run_app", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.run_app", "run_app_failed", {
+            message: msg,
+            recovery: "package.json 또는 requirements.txt가 있는지 확인하세요."
+        });
+    }
+}
+async function vibePmExportOutput(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await exportOutput(input);
+        const validated = exportOutputOutputSchema.parse(result);
+        return toolResult("vibe_pm.export_output", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.export_output", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.export_output", "export_output_failed", {
+            message: msg,
+            recovery: "내보내기 대상과 출력 폴더를 확인한 뒤 다시 시도해 주세요."
+        });
+    }
+}
+async function vibePmSearchOss(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await searchOss(input);
+        const validated = searchOssOutputSchema.parse(result);
+        return toolResult("vibe_pm.search_oss", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.search_oss", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.search_oss", "search_oss_failed", {
+            message: msg,
+            recovery: "gh 인증/설치 상태를 확인한 뒤 다시 시도해주세요."
+        });
+    }
+}
+async function vibePmZoektEvidence(input) {
+    const startedAt = Date.now();
+    try {
+        const result = await zoektEvidence(input);
+        const validated = zoektEvidenceOutputSchema.parse(result);
+        return toolResult("vibe_pm.zoekt_evidence", validated, Date.now() - startedAt);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.zoekt_evidence", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.zoekt_evidence", "zoekt_evidence_failed", {
+            message: msg,
+            recovery: "roots 경로/권한을 확인한 뒤 다시 시도해주세요."
+        });
+    }
+}
+async function vibePmGate(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);
+    }
+    catch (e) {
+        if (e instanceof McpError) {
+            return errorResult("vibe_pm.gate", e);
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return err("vibe_pm.gate", "gate_failed", {
+            message: msg,
+            recovery: "work_order 형식을 확인하고 다시 시도해주세요."
+        });
+    }
+}
+// ============================================================
+// Export
+// ============================================================
+export function defineVibePmTools() {
+    return {
+        // Input schemas (for validation)
+        briefingInputSchema,
+        getDecisionInputSchema,
+        submitDecisionInputSchema,
+        createWorkOrderInputSchema,
+        inspectCodeInputSchema,
+        statusInputSchema,
+        memoryStatusInputSchema,
+        memorySyncInputSchema,
+        advisoryReviewInputSchema,
+        activateInputSchema,
+        repairPlanInputSchema,
+        doctorInputSchema: DoctorInputSchema,
+        updateInputSchema: UpdateInputSchema,
+        scaffoldInputSchema,
+        finalizeWorkInputSchema,
+        undoLastTaskInputSchema,
+        runAppInputSchema,
+        exportOutputInputSchema,
+        searchOssInputSchema,
+        zoektEvidenceInputSchema,
+        gateInputSchema,
+        // Tool handlers
+        vibePmBriefing,
+        vibePmGetDecision,
+        vibePmSubmitDecision,
+        vibePmCreateWorkOrder,
+        vibePmInspectCode,
+        vibePmStatus,
+        vibePmMemoryStatus,
+        vibePmMemorySync,
+        vibePmAdvisoryReview,
+        vibePmActivate,
+        vibePmRepairPlan,
+        vibePmDoctor,
+        vibePmUpdate,
+        vibePmScaffold,
+        vibePmFinalizeWork,
+        vibePmUndoLastTask,
+        vibePmRunApp,
+        vibePmExportOutput,
+        vibePmSearchOss,
+        vibePmZoektEvidence,
+        vibePmGate
+    };
+}
+// ============================================================
+// Tool Descriptions (for MCP registration)
+// ============================================================
+export const VIBE_PM_TOOL_DESCRIPTIONS = {
+    "vibe_pm.briefing": `프로젝트를 시작하거나 재개합니다. 사용자의 아이디어를 받아 구조화합니다.
+사용 시점: 사용자가 "시작해줘" 또는 새 아이디어를 설명할 때`,
+    "vibe_pm.get_decision": `현재 결재가 필요한 안건을 조회합니다.
+사용 시점: 구현 전 승인이 필요할 때`,
+    "vibe_pm.submit_decision": `결재를 제출합니다.
+사용 시점: 사용자가 선택지(A/B/C/U)를 고른 후`,
+    "vibe_pm.create_work_order": `결정된 사항을 바탕으로 작업 지시서를 발행합니다.
+사용 시점: 모든 결재가 완료된 후, 구현 전`,
+    "vibe_pm.inspect_code": `구현된 코드를 검수합니다. auto_fix 옵션으로 의존성 문제 자동 수정.
+사용 시점: 구현 완료 후 검증이 필요할 때`,
+    "vibe_pm.status": `현재 프로젝트 상태를 조회합니다.
+사용 시점: 사용자가 "상태", "어디까지 했어" 물어볼 때`,
+    "vibe_pm.memory_status": `Local Memory(문서 자동 기억) 준비 상태를 조회합니다.
+사용 시점: 문서 참조가 잘 안 되거나 인덱스 상태를 확인하고 싶을 때`,
+    "vibe_pm.memory_sync": `Local Memory(문서 자동 기억) 인덱스를 갱신합니다. (변경분만 처리)
+사용 시점: 문서를 많이 바꿨거나 즉시 갱신이 필요할 때`,
+    "vibe_pm.advisory_review": `코드/설계/운영 관점의 고차원 조언 리뷰를 제공합니다. (기본: triage로 실행 여부/포커스만 결정)
+사용 시점: 사용자가 심층 리뷰를 원하거나, 마감 직전 최종 점검이 필요할 때`,
+    "vibe_pm.activate": `라이선스 키를 등록해 Pro 기능을 활성화합니다. (1회 온라인 활성화 → 로컬 토큰 캐시 → 오프라인 검증)
+사용 시점: Pro 기능을 쓰고 싶을 때 또는 라이선스 만료/재활성화가 필요할 때`,
+    "vibe_pm.repair_plan": `검수 실패 시 AI에게 보낼 수정 요청 프롬프트를 생성합니다.
+사용 시점: inspect_code가 FIX 또는 BLOCK을 반환했을 때`,
+    "vibe_pm.doctor": `설치 상태를 점검하고 문제가 있으면 자동으로 수정합니다.
+사용 시점: 도구가 동작하지 않거나 오류가 발생할 때`,
+    "vibe_pm.update": `엔진 바이너리를 최신 버전으로 업데이트합니다.
+사용 시점: 새 버전이 출시되었거나 업데이트가 필요할 때`,
+    "vibe_pm.scaffold": `표준 프로젝트 구조(Vibe-SDS)를 생성합니다.
+사용 시점: 새 프로젝트 시작 시, 빈 디렉토리에서 "프로젝트 시작해줘" 할 때
+템플릿: minimal, standard, python_cli, node_api`,
+    "vibe_pm.finalize_work": `작업 완료 후 문서 갱신, 개발 로그 작성, Git 커밋/푸시를 한 번에 처리합니다.
+사용 시점: 작업이 완료되고 "커밋해줘", "마무리해줘" 할 때`,
+    "vibe_pm.undo_last_task": `방금 완료한 작업을 취소하고 이전 상태로 되돌립니다. Git revert 사용.
+사용 시점: "방금 한 거 취소해줘", "롤백해줘" 할 때`,
+    "vibe_pm.run_app": `프로젝트를 자동으로 감지하여 실행합니다. Node.js/Python 지원.
+사용 시점: "실행해줘", "서버 켜줘" 할 때`,
+    "vibe_pm.search_oss": `OSS 템플릿/레포 후보를 검색(gh)하고 근거를 저장합니다.
+사용 시점: export_output용 템플릿을 고르기 전에 후보를 좁히고 싶을 때`,
+    "vibe_pm.zoekt_evidence": `로컬 루트들에서 패턴 증거를 수집합니다(zoekt/rg/python_scan).
+사용 시점: 특정 코드 패턴이 실제로 얼마나 쓰이는지 근거가 필요할 때`,
+    "vibe_pm.export_output": `구현된 기능을 원하는 형태로 내보냅니다. (문서/API/CLI 등)
+사용 시점: 기능 구현 및 검수 후, 결과물을 다른 형태로 배포/공유하고 싶을 때`,
+    "vibe_pm.gate": `작업 지시서가 시스템 설계 규칙을 준수하는지 검증합니다. (Schema/Path/Runtime/Semgrep Gate)
+사용 시점: 실행 전 work order가 규칙을 준수하는지 직접 확인하고 싶을 때
+BLOCK이 없으면 실행 가능, BLOCK이 있으면 수정이 필요합니다.`
+};