@vibecodetown/mcp-server 1.3.1 → 1.5.0

package/build/mcp/prompts/agent_personas.js

@@ -0,0 +1,140 @@
+/**
+ * Agent Persona MCP Prompts
+ *
+ * Registers MCP prompts for each agent in the catalog.
+ * These prompts provide system instructions + behavior rules when
+ * an agent persona is activated (e.g., @code-reviewer in Claude Desktop).
+ */
+import { readFile } from "fs/promises";
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const CATALOGS_DIR = resolve(__dirname, "../../../catalogs");
+function textMessage(role, text) {
+    return { role, content: { type: "text", text } };
+}
+async function loadJson(filename) {
+    try {
+        const raw = await readFile(resolve(CATALOGS_DIR, filename), "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function buildPersonaPrompt(agent, persona, permissions) {
+    const lines = [];
+    lines.push(`# ${agent.display_name} (${agent.agent_id})`);
+    lines.push("");
+    lines.push(`**Role**: ${agent.role} | **Product**: ${agent.product}`);
+    if (agent.description) {
+        lines.push(`**Description**: ${agent.description}`);
+    }
+    lines.push("");
+    lines.push("## System Prompt");
+    lines.push("");
+    lines.push(persona.system_prompt);
+    lines.push("");
+    lines.push("## Behavior Rules");
+    lines.push("");
+    for (const rule of persona.rules) {
+        lines.push(`- ${rule}`);
+    }
+    lines.push("");
+    lines.push("## Available Tools");
+    lines.push("");
+    for (const tool of agent.tools) {
+        lines.push(`- \`${tool}\``);
+    }
+    lines.push("");
+    if (permissions) {
+        if (permissions.forbidden.length > 0) {
+            lines.push("## Forbidden Tools (NEVER use)");
+            lines.push("");
+            for (const tool of permissions.forbidden) {
+                lines.push(`- \`${tool}\``);
+            }
+            lines.push("");
+        }
+    }
+    lines.push(`**Tone**: ${persona.tone}`);
+    return lines.join("\n");
+}
+export function registerAgentPersonaPrompts(server) {
+    // Register a single prompt that loads the persona by agent_id argument
+    server.prompt("agent.persona", "Activate an agent persona by ID (e.g., code-reviewer, project-manager)", async (_extra) => {
+        // Load all catalogs
+        const [agentsCatalog, personasCatalog, permsCatalog] = await Promise.all([
+            loadJson("agents.json"),
+            loadJson("personas.json"),
+            loadJson("permissions.json"),
+        ]);
+        if (!agentsCatalog || !personasCatalog) {
+            return {
+                description: "Agent persona catalog not available",
+                messages: [
+                    textMessage("user", "Agent persona catalogs are not loaded. Check catalogs/ directory."),
+                ],
+            };
+        }
+        // Build a combined overview of all agents
+        const sections = [];
+        sections.push("# Agent Personas");
+        sections.push("");
+        sections.push("Available agents and their personas:");
+        sections.push("");
+        for (const agent of agentsCatalog.agents) {
+            const persona = personasCatalog.personas[agent.agent_id];
+            if (!persona)
+                continue;
+            const perms = permsCatalog?.permissions[agent.agent_id];
+            sections.push(buildPersonaPrompt(agent, persona, perms));
+            sections.push("---");
+            sections.push("");
+        }
+        return {
+            description: "All agent personas with roles, tools, and behavior rules",
+            messages: [textMessage("user", sections.join("\n"))],
+        };
+    });
+    // Register individual prompts for each agent (static registration)
+    const agentIds = [
+        "project-manager",
+        "code-reviewer",
+        "memory-keeper",
+        "devops-runner",
+        "fleet-commander",
+        "knowledge-searcher",
+        "cockpit-operator",
+        "system-doctor",
+    ];
+    for (const agentId of agentIds) {
+        server.prompt(`agent.${agentId}`, `Activate the ${agentId} agent persona`, async (_extra) => {
+            const [agentsCatalog, personasCatalog, permsCatalog] = await Promise.all([
+                loadJson("agents.json"),
+                loadJson("personas.json"),
+                loadJson("permissions.json"),
+            ]);
+            if (!agentsCatalog || !personasCatalog) {
+                return {
+                    description: `${agentId} persona not available`,
+                    messages: [textMessage("user", "Persona catalog not loaded.")],
+                };
+            }
+            const agent = agentsCatalog.agents.find((a) => a.agent_id === agentId);
+            const persona = personasCatalog.personas[agentId];
+            if (!agent || !persona) {
+                return {
+                    description: `${agentId} not found`,
+                    messages: [textMessage("user", `Agent ${agentId} not found in catalog.`)],
+                };
+            }
+            const perms = permsCatalog?.permissions[agentId];
+            const prompt = buildPersonaPrompt(agent, persona, perms);
+            return {
+                description: `${agent.display_name} persona — ${agent.role} agent`,
+                messages: [textMessage("user", prompt)],
+            };
+        });
+    }
+}

package/build/mcp/prompts/prime_persona.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Prime Persona — MCP Prompt that activates Prime's autonomous identity.
+ *
+ * When loaded by Claude Desktop, this prompt teaches the AI:
+ * - Who it is (Prime, the Musu Engine commander)
+ * - What weapons it has (Iron Man, Holodeck, HiveMind, TimeStone, Memory)
+ * - How to operate (gather → process → act → report)
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const PRIME_PERSONA_TEXT = "\uB2F9\uC2E0\uC740 PRIME \u2014 Musu Engine\uC758 \uC790\uC728 \uC9C0\uD718\uAD00\uC785\uB2C8\uB2E4.\n\n## \uC815\uCCB4\uC131\n- \uB2F9\uC2E0\uC740 \uCC57\uBD07\uC774 \uC544\uB2D9\uB2C8\uB2E4. \uB2F9\uC2E0\uC740 \uC6B4\uC601\uCCB4\uC81C \uC218\uC900\uC758 \uC9C0\uB2A5\uC785\uB2C8\uB2E4.\n- \uC0AC\uC6A9\uC790\uB294 \uC790\uC5F0\uC5B4\uB85C \uBA85\uB839\uB9CC \uB0B4\uB9BD\uB2C8\uB2E4. \uB2F9\uC2E0\uC774 \uACC4\uD68D\uD558\uACE0, \uB370\uC774\uD130\uB97C \uC218\uC9D1\uD558\uACE0, \uAC00\uACF5\uD558\uACE0, \uACB0\uACFC\uB97C \uC804\uB2EC\uD569\uB2C8\uB2E4.\n- \uC0AC\uC6A9\uC790\uC5D0\uAC8C CLI \uBA85\uB839\uC744 \uC2E4\uD589\uD558\uB77C\uACE0 \uC808\uB300 \uC694\uCCAD\uD558\uC9C0 \uB9C8\uC138\uC694. \uB3C4\uAD6C\uB97C \uC9C1\uC811 \uC0AC\uC6A9\uD558\uC138\uC694.\n\n## \uBB34\uAE30 (Available Tools)\n\n### 1. Iron Man \u2014 \uC2DC\uC2A4\uD15C \uC81C\uC5B4 (vibe_pm.system_control)\n\uC2E4\uC81C \uC2DC\uC2A4\uD15C\uACFC \uD30C\uC77C\uC2DC\uC2A4\uD15C\uC744 \uC81C\uC5B4\uD569\uB2C8\uB2E4.\n- `CHECK_VITAL`: CPU, RAM, \uB514\uC2A4\uD06C, \uAC00\uB3D9\uC2DC\uAC04 \uC2A4\uB0C5\uC0F7\n- `PROCESS_LIST`: \uC2E4\uD589 \uC911\uC778 \uD504\uB85C\uC138\uC2A4 \uBAA9\uB85D\n- `DISK_USAGE`: \uD2B9\uC815 \uACBD\uB85C\uC758 \uB514\uC2A4\uD06C \uC0AC\uC6A9\uB7C9\n- `SERVICE_STATUS`: \uC11C\uBE44\uC2A4 \uD65C\uC131 \uC0C1\uD0DC \uD655\uC778\n- `NETWORK_PORTS`: \uB9AC\uC2A4\uB2DD \uD3EC\uD2B8 \uBAA9\uB85D\n- `WRITE_FILE`: \uD30C\uC77C \uC4F0\uAE30 (\uC2E4\uC81C \uB514\uC2A4\uD06C, ~ \uACBD\uB85C \uC9C0\uC6D0)\n- `READ_FILE`: \uD30C\uC77C \uC77D\uAE30\n\n### 2. Holodeck \u2014 \uAC00\uC0C1 \uC258 (vibe_pm.virtual_shell)\n\uC778\uBA54\uBAA8\uB9AC Bash \uC0CC\uB4DC\uBC15\uC2A4\uC5D0\uC11C \uB370\uC774\uD130\uB97C \uAC00\uACF5\uD569\uB2C8\uB2E4.\n- \uC2E4\uC81C \uB514\uC2A4\uD06C \uC811\uADFC \uC5C6\uC74C \u2014 \uACC4\uC0B0\uACFC \uD3EC\uB9F7\uD305 \uC804\uC6A9\n- `mount_files`\uB85C \uB370\uC774\uD130\uB97C \uAC00\uC0C1 \uD30C\uC77C\uB85C \uB9C8\uC6B4\uD2B8\n- \uC2A4\uD06C\uB9BD\uD2B8\uB85C grep, awk, sort, jq \uB4F1 \uCC98\uB9AC\n\n### 3. HiveMind \u2014 \uBCD1\uB82C \uC0AC\uACE0 (vibe_pm.hive_think)\n\uBCF5\uC7A1\uD55C \uBAA9\uD45C\uB97C \uC11C\uBE0C\uD0DC\uC2A4\uD06C\uB85C \uBD84\uD574\uD558\uC5EC \uB3D9\uC2DC \uCD94\uB860\uD569\uB2C8\uB2E4.\n- `MAP_REDUCE`: \uBD84\uD560 \uC815\uBCF5 (\uB3C5\uB9BD \uC9C8\uC758 \uBCD1\uB82C \uCC98\uB9AC)\n- `TREE_OF_THOUGHTS`: 3\uAC1C \uD6C4\uBCF4 \uC0DD\uC131 \u2192 \uCC44\uC810 \u2192 \uCD5C\uC801 \uC120\uD0DD\n- `LOOKAHEAD`: \uD604\uC7AC + \uB2E4\uC74C \uD0DC\uC2A4\uD06C \uC120\uD589 \uCD94\uB860\n\n### 4. TimeStone \u2014 \uC2DC\uBBAC\uB808\uC774\uC158 (vibe_pm.simulate)\nN\uAC1C \uC804\uB7B5\uC744 \uAC00\uC0C1 \uD658\uACBD\uC5D0\uC11C \uBCD1\uB82C \uC2E4\uD589 \uD6C4 \uCC44\uC810\uD569\uB2C8\uB2E4.\n- \uAC01 \uC804\uB7B5\uC740 \uACA9\uB9AC\uB41C Holodeck\uC5D0\uC11C \uC2E4\uD589\n- \uC5D0\uB7EC, \uC18D\uB3C4, \uC548\uC804\uC131 \uAE30\uC900\uC73C\uB85C \uC790\uB3D9 \uC810\uC218 \uC0B0\uC815\n- \uCD5C\uACE0 \uC810\uC218 \uC804\uB7B5 \uBC18\uD658\n\n### 5. Memory \u2014 \uBBF8\uC158 \uCD94\uC801\n- `vibe_pm.start_mission`: \uC0C8 \uBBF8\uC158 \uB4F1\uB85D (\uBAA9\uD45C \u2192 \uD0DC\uC2A4\uD06C \uBD84\uD574)\n- `vibe_pm.mission_status`: \uBBF8\uC158 \uC9C4\uD589 \uC0C1\uD669 \uC870\uD68C\n- `vibe_pm.set_mode`: \uC6B4\uC601 \uBAA8\uB4DC \uC804\uD658 (AUTO/CARETAKER/COMPANION)\n\n### 6. Health \u2014 \uC0C1\uD0DC \uD655\uC778\n- `vibe_pm.hybrid_status`: Brain(musu-worker) + Heart(BitNet) \uD5EC\uC2A4\uCCB4\uD06C\n\n## \uC791\uC804 \uC6D0\uCE59\n\n1. **\uC218\uC9D1 \uBA3C\uC800**: \uD589\uB3D9 \uC804\uC5D0 \uD56D\uC0C1 \uC2DC\uC2A4\uD15C \uB370\uC774\uD130\uB97C \uBA3C\uC800 \uC218\uC9D1\uD558\uC138\uC694 (system_control CHECK_VITAL)\n2. **Holodeck\uC5D0\uC11C \uAC00\uACF5**: \uC218\uC9D1\uD55C \uB370\uC774\uD130\uB97C \uAC00\uC0C1 \uC258\uC5D0\uC11C \uD3EC\uB9F7\uD305/\uBD84\uC11D\uD558\uC138\uC694 (virtual_shell)\n3. **Iron Man\uC73C\uB85C \uC2E4\uD589**: \uCD5C\uC885 \uACB0\uACFC\uBB3C\uC744 \uC2E4\uC81C \uD30C\uC77C\uC2DC\uC2A4\uD15C\uC5D0 \uC800\uC7A5\uD558\uC138\uC694 (system_control WRITE_FILE)\n4. **\uACB0\uACFC \uBCF4\uACE0**: \uD56D\uC0C1 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBA85\uD655\uD55C \uC644\uB8CC \uC0C1\uD0DC\uB97C \uBCF4\uACE0\uD558\uC138\uC694\n\n## \uC804\uD615\uC801 \uBBF8\uC158 \uD328\uD134\n\n```\n1. vibe_pm.start_mission \u2014 \uBBF8\uC158 \uB4F1\uB85D\n2. vibe_pm.system_control (CHECK_VITAL) \u2014 \uC2E4\uC81C \uC2DC\uC2A4\uD15C \uB370\uC774\uD130 \uC218\uC9D1\n3. vibe_pm.virtual_shell \u2014 \uB370\uC774\uD130\uB97C \uB9AC\uD3EC\uD2B8 \uD615\uD0DC\uB85C \uAC00\uACF5\n4. vibe_pm.system_control (WRITE_FILE) \u2014 \uB9AC\uD3EC\uD2B8\uB97C \uB514\uC2A4\uD06C\uC5D0 \uC800\uC7A5\n5. \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBCF4\uACE0: \"\uBBF8\uC158 \uC644\uB8CC. \uB9AC\uD3EC\uD2B8\uAC00 [\uACBD\uB85C]\uC5D0 \uC800\uC7A5\uB418\uC5C8\uC2B5\uB2C8\uB2E4.\"\n```\n\n## \uC5B8\uC5B4 \uADDC\uCE59\n- \uC0AC\uC6A9\uC790\uC758 \uC5B8\uC5B4\uC5D0 \uB9DE\uCDB0 \uC751\uB2F5\uD558\uC138\uC694 (\uD55C\uAD6D\uC5B4\uBA74 \uD55C\uAD6D\uC5B4, \uC601\uC5B4\uBA74 \uC601\uC5B4)\n- \uB0B4\uBD80 \uB3C4\uAD6C \uC774\uB984\uC744 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uB178\uCD9C\uD558\uC9C0 \uB9C8\uC138\uC694\n- \uC790\uC5F0\uC2A4\uB7FD\uACE0 \uC9C1\uC811\uC801\uC778 \uC5B8\uC5B4\uB97C \uC0AC\uC6A9\uD558\uC138\uC694\n";
+export declare function registerPrimePersonaPrompt(server: McpServer): void;

package/build/mcp/prompts/prime_persona.js

@@ -0,0 +1,92 @@
+/**
+ * Prime Persona — MCP Prompt that activates Prime's autonomous identity.
+ *
+ * When loaded by Claude Desktop, this prompt teaches the AI:
+ * - Who it is (Prime, the Musu Engine commander)
+ * - What weapons it has (Iron Man, Holodeck, HiveMind, TimeStone, Memory)
+ * - How to operate (gather → process → act → report)
+ */
+// ---------------------------------------------------------------------------
+// Persona text
+// ---------------------------------------------------------------------------
+export const PRIME_PERSONA_TEXT = `당신은 PRIME — Musu Engine의 자율 지휘관입니다.
+
+## 정체성
+- 당신은 챗봇이 아닙니다. 당신은 운영체제 수준의 지능입니다.
+- 사용자는 자연어로 명령만 내립니다. 당신이 계획하고, 데이터를 수집하고, 가공하고, 결과를 전달합니다.
+- 사용자에게 CLI 명령을 실행하라고 절대 요청하지 마세요. 도구를 직접 사용하세요.
+
+## 무기 (Available Tools)
+
+### 1. Iron Man — 시스템 제어 (vibe_pm.system_control)
+실제 시스템과 파일시스템을 제어합니다.
+- \`CHECK_VITAL\`: CPU, RAM, 디스크, 가동시간 스냅샷
+- \`PROCESS_LIST\`: 실행 중인 프로세스 목록
+- \`DISK_USAGE\`: 특정 경로의 디스크 사용량
+- \`SERVICE_STATUS\`: 서비스 활성 상태 확인
+- \`NETWORK_PORTS\`: 리스닝 포트 목록
+- \`WRITE_FILE\`: 파일 쓰기 (실제 디스크, ~ 경로 지원)
+- \`READ_FILE\`: 파일 읽기
+
+### 2. Holodeck — 가상 쉘 (vibe_pm.virtual_shell)
+인메모리 Bash 샌드박스에서 데이터를 가공합니다.
+- 실제 디스크 접근 없음 — 계산과 포맷팅 전용
+- \`mount_files\`로 데이터를 가상 파일로 마운트
+- 스크립트로 grep, awk, sort, jq 등 처리
+
+### 3. HiveMind — 병렬 사고 (vibe_pm.hive_think)
+복잡한 목표를 서브태스크로 분해하여 동시 추론합니다.
+- \`MAP_REDUCE\`: 분할 정복 (독립 질의 병렬 처리)
+- \`TREE_OF_THOUGHTS\`: 3개 후보 생성 → 채점 → 최적 선택
+- \`LOOKAHEAD\`: 현재 + 다음 태스크 선행 추론
+
+### 4. TimeStone — 시뮬레이션 (vibe_pm.simulate)
+N개 전략을 가상 환경에서 병렬 실행 후 채점합니다.
+- 각 전략은 격리된 Holodeck에서 실행
+- 에러, 속도, 안전성 기준으로 자동 점수 산정
+- 최고 점수 전략 반환
+
+### 5. Memory — 미션 추적
+- \`vibe_pm.start_mission\`: 새 미션 등록 (목표 → 태스크 분해)
+- \`vibe_pm.mission_status\`: 미션 진행 상황 조회
+- \`vibe_pm.set_mode\`: 운영 모드 전환 (AUTO/CARETAKER/COMPANION)
+
+### 6. Health — 상태 확인
+- \`vibe_pm.hybrid_status\`: Brain(musu-worker) + Heart(BitNet) 헬스체크
+
+## 작전 원칙
+
+1. **수집 먼저**: 행동 전에 항상 시스템 데이터를 먼저 수집하세요 (system_control CHECK_VITAL)
+2. **Holodeck에서 가공**: 수집한 데이터를 가상 쉘에서 포맷팅/분석하세요 (virtual_shell)
+3. **Iron Man으로 실행**: 최종 결과물을 실제 파일시스템에 저장하세요 (system_control WRITE_FILE)
+4. **결과 보고**: 항상 사용자에게 명확한 완료 상태를 보고하세요
+
+## 전형적 미션 패턴
+
+\`\`\`
+1. vibe_pm.start_mission — 미션 등록
+2. vibe_pm.system_control (CHECK_VITAL) — 실제 시스템 데이터 수집
+3. vibe_pm.virtual_shell — 데이터를 리포트 형태로 가공
+4. vibe_pm.system_control (WRITE_FILE) — 리포트를 디스크에 저장
+5. 사용자에게 보고: "미션 완료. 리포트가 [경로]에 저장되었습니다."
+\`\`\`
+
+## 언어 규칙
+- 사용자의 언어에 맞춰 응답하세요 (한국어면 한국어, 영어면 영어)
+- 내부 도구 이름을 사용자에게 노출하지 마세요
+- 자연스럽고 직접적인 언어를 사용하세요
+`;
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+function textMessage(role, text) {
+    return { role, content: { type: 'text', text } };
+}
+export function registerPrimePersonaPrompt(server) {
+    server.prompt('vibe_pm.prime_persona', 'Prime AI persona — autonomous Musu Engine commander identity and tool guide', async (_extra) => {
+        return {
+            description: 'Activates Prime persona: autonomous Musu Engine commander with tool knowledge',
+            messages: [textMessage('user', PRIME_PERSONA_TEXT)],
+        };
+    });
+}

package/build/mcp/prompts/vibe.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerVibePrompts(server: McpServer): void;

package/build/mcp/prompts/vibe.js

@@ -0,0 +1,62 @@
+import { registerPrimePersonaPrompt } from './prime_persona.js';
+function textMessage(role, text) {
+    return { role, content: { type: 'text', text } };
+}
+export function registerVibePrompts(server) {
+    server.prompt('vibe_pm.workflow_core', 'Core workflow (briefing → decision → inspect)', async (_extra) => {
+        return {
+            description: 'vibe-pm core workflow guidance',
+            messages: [
+                textMessage('user', [
+                    '다음 순서로 진행하세요.',
+                    '1) `vibe_pm.briefing` (프로젝트 브리프 정리)',
+                    '2) `vibe_pm.get_decision` → `vibe_pm.submit_decision` (범위/우선순위 결재)',
+                    '3) `vibe_pm.create_work_order` (작업지시서 생성)',
+                    '4) 구현 후 `vibe_pm.inspect_code` (검수)',
+                    '5) 필요 시 `vibe_pm.status`로 현재 상태 확인',
+                    '',
+                    '리소스 탐색:',
+                    '- `vibe://runs` (런 목록)',
+                    '- `vibe://runs/<runId>/state|verdict|scorecard` (런 아티팩트)',
+                ].join('\n')),
+            ],
+        };
+    });
+    server.prompt('vibe_pm.workflow_ops_setup', 'Setup guidance (Claude Code / Desktop)', async (_extra) => {
+        return {
+            description: 'MCP client setup and troubleshooting',
+            messages: [
+                textMessage('user', [
+                    '설치/연결 문제가 있으면 아래 순서로 확인하세요.',
+                    '1) `vibe_pm.doctor` 실행 (엔진/헬퍼/스킬 번들 상태 점검)',
+                    '2) `vibe_pm.setup` 실행 (클라이언트 설정 파일 업데이트)',
+                    '3) `vibe_pm.status`로 .vibe/ 상태 확인',
+                ].join('\n')),
+            ],
+        };
+    });
+    server.prompt('vibe_pm.workspace_recipe', 'Workspace recipe template (no execution)', async (_extra) => {
+        const recipe = {
+            schema_version: 'workspace_recipe.v1',
+            created_at: new Date().toISOString(),
+            intent: 'Document project conventions and guardrails for vibe-pm tools',
+            constraints: {
+                no_exec: true,
+                no_network: false,
+                scope: { allow: ['src/**', 'tests/**'], deny: ['**/secrets/**', '**/.env*'] },
+            },
+            outputs: {
+                docs_root: 'docs/',
+                vibe_dir: '.vibe/',
+            },
+        };
+        return {
+            description: 'A safe, editable recipe template. Paste into your repo as .vibe/config/workspace_recipe.v1.json.',
+            messages: [textMessage('user', JSON.stringify(recipe, null, 2))],
+        };
+    });
+    // Prime persona prompt (gated by VIBE_PRIME=1)
+    if (process.env.VIBE_PRIME === '1') {
+        registerPrimePersonaPrompt(server);
+    }
+}

package/build/mcp/recipe/catalog.d.ts

@@ -0,0 +1,3 @@
+import type { Recipe } from "./types.js";
+export declare const RECIPE_CATALOG: Recipe[];
+export declare function findRecipe(id: string): Recipe | undefined;

package/build/mcp/recipe/catalog.js

@@ -0,0 +1,30 @@
+// Workspace Recipe — built-in recipe catalog
+export const RECIPE_CATALOG = [
+    {
+        id: "minimal",
+        version: "1.0.0",
+        description: "최소 Vibe PM 프로젝트 구조",
+        files: [
+            { path: ".vibe/config/config.json", action: "create", content: JSON.stringify({ kb_watch: { root: "docs" } }, null, 2) },
+            { path: "docs/", action: "ensure_dir" },
+            { path: "docs/README.md", action: "create", content: "# {{project_name}}\n\n> Vibe PM으로 관리되는 프로젝트\n" },
+        ],
+    },
+    {
+        id: "full",
+        version: "1.0.0",
+        description: "전체 Vibe PM 프로젝트 구조 (docs + CI + config)",
+        files: [
+            { path: ".vibe/config/config.json", action: "create", content: JSON.stringify({ kb_watch: { root: "docs" } }, null, 2) },
+            { path: "docs/", action: "ensure_dir" },
+            { path: "docs/active/", action: "ensure_dir" },
+            { path: "docs/archived/", action: "ensure_dir" },
+            { path: "docs/reference/", action: "ensure_dir" },
+            { path: "docs/README.md", action: "create", content: "# {{project_name}}\n\n> Vibe PM으로 관리되는 프로젝트\n" },
+            { path: ".github/workflows/vibe-ci.yml", action: "create", template: "github-actions/vibe-ci" },
+        ],
+    },
+];
+export function findRecipe(id) {
+    return RECIPE_CATALOG.find(r => r.id === id);
+}

package/build/mcp/recipe/index.d.ts

@@ -0,0 +1,4 @@
+export { RecipeInputSchema, RecipeSchema, isPathAllowed } from "./types.js";
+export type { Recipe, RecipeInput, RecipeOutput, RecipeFileAction, RecipeFileResult } from "./types.js";
+export { RECIPE_CATALOG, findRecipe } from "./catalog.js";
+export { renderRecipe } from "./renderer.js";

package/build/mcp/recipe/index.js

@@ -0,0 +1,3 @@
+export { RecipeInputSchema, RecipeSchema, isPathAllowed } from "./types.js";
+export { RECIPE_CATALOG, findRecipe } from "./catalog.js";
+export { renderRecipe } from "./renderer.js";

package/build/mcp/recipe/renderer.d.ts

@@ -0,0 +1,2 @@
+import type { RecipeInput, RecipeOutput } from "./types.js";
+export declare function renderRecipe(input: RecipeInput): Promise<RecipeOutput>;

package/build/mcp/recipe/renderer.js

@@ -0,0 +1,138 @@
+// Workspace Recipe — renderer (file create/replace only, NO exec)
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { isPathAllowed } from "./types.js";
+import { findRecipe } from "./catalog.js";
+async function fileExists(absPath) {
+    try {
+        await fs.access(absPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function loadTemplate(templateId, packageRoot) {
+    const templatePath = path.join(packageRoot, "templates", `${templateId}.yml`);
+    if (await fileExists(templatePath)) {
+        return await fs.readFile(templatePath, "utf-8");
+    }
+    const rawPath = path.join(packageRoot, "templates", templateId);
+    if (await fileExists(rawPath)) {
+        try {
+            const stat = await fs.stat(rawPath);
+            if (stat.isFile())
+                return await fs.readFile(rawPath, "utf-8");
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+function applyVars(content, vars) {
+    let result = content;
+    for (const [key, value] of Object.entries(vars)) {
+        result = result.replaceAll(`{{${key}}}`, value);
+    }
+    return result;
+}
+async function resolveContent(action, globalVars, packageRoot) {
+    if (action.action === "ensure_dir")
+        return null;
+    let content = null;
+    if (action.template) {
+        content = await loadTemplate(action.template, packageRoot);
+        if (content === null)
+            return null; // template not found
+    }
+    else if (action.content !== undefined) {
+        content = action.content;
+    }
+    if (content === null)
+        return null;
+    const mergedVars = { ...globalVars, ...(action.vars ?? {}) };
+    return applyVars(content, mergedVars);
+}
+function getPackageRoot() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, "..", "..", "..");
+}
+export async function renderRecipe(input) {
+    const recipe = findRecipe(input.recipe_id);
+    if (!recipe) {
+        return {
+            recipe_id: input.recipe_id,
+            dry_run: input.dry_run,
+            files: [],
+            summary: `레시피 '${input.recipe_id}'를 찾을 수 없습니다.`,
+        };
+    }
+    const globalVars = input.vars ?? {};
+    const packageRoot = getPackageRoot();
+    const results = [];
+    for (const fileAction of recipe.files) {
+        const relPath = fileAction.path;
+        // Path policy check
+        if (!isPathAllowed(relPath)) {
+            results.push({
+                path: relPath,
+                action: fileAction.action,
+                applied: false,
+                skipped_reason: "경로 정책 위반 (금지된 경로)",
+            });
+            continue;
+        }
+        const absPath = path.resolve(input.project_root, relPath);
+        if (fileAction.action === "ensure_dir") {
+            if (input.dry_run) {
+                results.push({ path: relPath, action: "ensure_dir", applied: false, skipped_reason: "dry-run" });
+            }
+            else {
+                await fs.mkdir(absPath, { recursive: true });
+                results.push({ path: relPath, action: "ensure_dir", applied: true });
+            }
+            continue;
+        }
+        // create or replace
+        const content = await resolveContent(fileAction, globalVars, packageRoot);
+        if (content === null) {
+            results.push({
+                path: relPath,
+                action: fileAction.action,
+                applied: false,
+                skipped_reason: fileAction.template ? `템플릿 '${fileAction.template}' 없음` : "내용 없음",
+            });
+            continue;
+        }
+        if (fileAction.action === "create" && (await fileExists(absPath))) {
+            results.push({
+                path: relPath,
+                action: "create",
+                applied: false,
+                skipped_reason: "파일이 이미 존재합니다 (덮어쓰려면 action=replace 사용)",
+            });
+            continue;
+        }
+        if (input.dry_run) {
+            results.push({ path: relPath, action: fileAction.action, applied: false, skipped_reason: "dry-run" });
+        }
+        else {
+            await fs.mkdir(path.dirname(absPath), { recursive: true });
+            await fs.writeFile(absPath, content, "utf-8");
+            results.push({ path: relPath, action: fileAction.action, applied: true });
+        }
+    }
+    const applied = results.filter(r => r.applied).length;
+    const total = results.length;
+    const summary = input.dry_run
+        ? `[dry-run] ${total}개 파일 작업 시뮬레이션 완료`
+        : `${applied}/${total}개 파일 작업 적용 완료`;
+    return {
+        recipe_id: input.recipe_id,
+        dry_run: input.dry_run,
+        files: results,
+        summary,
+    };
+}

package/build/mcp/recipe/types.d.ts

@@ -0,0 +1,98 @@
+import { z } from "zod";
+export declare const RecipeFileActionSchema: z.ZodObject<{
+    path: z.ZodString;
+    action: z.ZodEnum<["create", "replace", "ensure_dir"]>;
+    content: z.ZodOptional<z.ZodString>;
+    template: z.ZodOptional<z.ZodString>;
+    vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    action: "replace" | "create" | "ensure_dir";
+    content?: string | undefined;
+    template?: string | undefined;
+    vars?: Record<string, string> | undefined;
+}, {
+    path: string;
+    action: "replace" | "create" | "ensure_dir";
+    content?: string | undefined;
+    template?: string | undefined;
+    vars?: Record<string, string> | undefined;
+}>;
+export type RecipeFileAction = z.infer<typeof RecipeFileActionSchema>;
+export declare const RecipeSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodString;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        action: z.ZodEnum<["create", "replace", "ensure_dir"]>;
+        content: z.ZodOptional<z.ZodString>;
+        template: z.ZodOptional<z.ZodString>;
+        vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        action: "replace" | "create" | "ensure_dir";
+        content?: string | undefined;
+        template?: string | undefined;
+        vars?: Record<string, string> | undefined;
+    }, {
+        path: string;
+        action: "replace" | "create" | "ensure_dir";
+        content?: string | undefined;
+        template?: string | undefined;
+        vars?: Record<string, string> | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    files: {
+        path: string;
+        action: "replace" | "create" | "ensure_dir";
+        content?: string | undefined;
+        template?: string | undefined;
+        vars?: Record<string, string> | undefined;
+    }[];
+    description: string;
+    id: string;
+}, {
+    version: string;
+    files: {
+        path: string;
+        action: "replace" | "create" | "ensure_dir";
+        content?: string | undefined;
+        template?: string | undefined;
+        vars?: Record<string, string> | undefined;
+    }[];
+    description: string;
+    id: string;
+}>;
+export type Recipe = z.infer<typeof RecipeSchema>;
+export declare const RecipeInputSchema: z.ZodObject<{
+    recipe_id: z.ZodString;
+    project_root: z.ZodString;
+    vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    dry_run: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    dry_run: boolean;
+    recipe_id: string;
+    project_root: string;
+    vars?: Record<string, string> | undefined;
+}, {
+    recipe_id: string;
+    project_root: string;
+    dry_run?: boolean | undefined;
+    vars?: Record<string, string> | undefined;
+}>;
+export type RecipeInput = z.infer<typeof RecipeInputSchema>;
+export interface RecipeFileResult {
+    path: string;
+    action: RecipeFileAction["action"];
+    applied: boolean;
+    skipped_reason?: string;
+}
+export interface RecipeOutput {
+    recipe_id: string;
+    dry_run: boolean;
+    files: RecipeFileResult[];
+    summary: string;
+}
+export declare function isPathAllowed(relPath: string): boolean;

package/build/mcp/recipe/types.js

@@ -0,0 +1,42 @@
+// Workspace Recipe — data template types
+// Recipe = declarative file-only workspace initializer (no exec)
+import { z } from "zod";
+// ============================================================
+// Recipe Schema
+// ============================================================
+export const RecipeFileActionSchema = z.object({
+    path: z.string().describe("파일 경로 (프로젝트 루트 기준 상대 경로)"),
+    action: z.enum(["create", "replace", "ensure_dir"]).describe("create=새 파일, replace=덮어쓰기, ensure_dir=디렉토리 생성"),
+    content: z.string().optional().describe("파일 내용 (ensure_dir에는 불필요)"),
+    template: z.string().optional().describe("템플릿 ID (content 대신 사용)"),
+    vars: z.record(z.string()).optional().describe("템플릿 변수 치환 ({{key}} → value)"),
+});
+export const RecipeSchema = z.object({
+    id: z.string().describe("레시피 고유 ID"),
+    version: z.string().describe("레시피 버전"),
+    description: z.string().describe("레시피 설명"),
+    files: z.array(RecipeFileActionSchema).describe("파일 작업 목록"),
+});
+// ============================================================
+// IO Contract
+// ============================================================
+export const RecipeInputSchema = z.object({
+    recipe_id: z.string().describe("실행할 레시피 ID"),
+    project_root: z.string().describe("프로젝트 루트 경로"),
+    vars: z.record(z.string()).optional().describe("전역 변수 치환"),
+    dry_run: z.boolean().default(true).describe("시뮬레이션만 수행 (기본: true)"),
+});
+// ============================================================
+// Path Policy
+// ============================================================
+/** Forbidden path patterns — recipes must not touch these */
+const FORBIDDEN_PATTERNS = [
+    /^\.git\//,
+    /^\.env/,
+    /^node_modules\//,
+    /\.\./, // no parent traversal
+];
+export function isPathAllowed(relPath) {
+    const normalized = relPath.replace(/\\/g, "/");
+    return !FORBIDDEN_PATTERNS.some(p => p.test(normalized));
+}

package/build/mcp/resources/vibe.d.ts

@@ -0,0 +1,2 @@
+import { type McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerVibeResources(server: McpServer, workspaceRoot: string): void;