@vibecodetown/mcp-server 2.1.0

package/build/tools/vibe_pm/modules/planning_v1.js

@@ -0,0 +1,110 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fingerprintJson } from "./fingerprint.js";
+import { defaultVerifyCommand } from "./repo_context.js";
+function nowIso() {
+    return new Date().toISOString();
+}
+function ensureDir(p) {
+    fs.mkdirSync(p, { recursive: true });
+}
+export function generatePlanningModuleV1(opts) {
+    const version = "v1";
+    const verifyCmd = defaultVerifyCommand(opts.repoContext);
+    const input = {
+        module: "planning",
+        version,
+        goal: opts.goal,
+        repo_context: opts.repoContext,
+        skill_fingerprint: opts.skillFingerprint,
+        decisions: opts.decisionSnapshot.map((d) => ({ decision_id: d.decision_id, chosen: d.chosen ?? null })),
+        verify: verifyCmd,
+    };
+    const fingerprint = fingerprintJson("PLN", input);
+    const outDir = path.join(opts.specHighRunDir, "modules", "planning", "v1");
+    const outPath = path.join(outDir, "plan.json");
+    if (fs.existsSync(outPath)) {
+        try {
+            const existing = JSON.parse(fs.readFileSync(outPath, "utf-8"));
+            if (existing.fingerprint === fingerprint) {
+                return { version, fingerprint, path: outPath };
+            }
+        }
+        catch {
+            // regenerate
+        }
+    }
+    ensureDir(outDir);
+    const plan = opts.goal === "repair"
+        ? [
+            {
+                step: 1,
+                title: "재현/원인 고정",
+                actions: ["문제를 재현하는 최소 시나리오를 확인", "영향 범위를 좁히기"],
+                verification: [verifyCmd],
+                rollback: ["변경 전 상태 유지(최소 단위 변경)"],
+            },
+            {
+                step: 2,
+                title: "최소 수정",
+                actions: ["가장 작은 수정으로 문제 해결", "불필요한 리팩토링 금지"],
+                verification: [verifyCmd],
+                rollback: ["해당 변경만 되돌리기"],
+            },
+            {
+                step: 3,
+                title: "재검증",
+                actions: ["수정 후 핵심 동작 확인", "테스트/실행 결과 기록"],
+                verification: [verifyCmd],
+                rollback: ["최근 수정만 되돌리기"],
+            },
+            {
+                step: 4,
+                title: "재발 방지",
+                actions: ["유사 케이스를 막는 최소 테스트/게이트 추가", "문서/규칙 드리프트 점검"],
+                verification: [verifyCmd],
+                rollback: ["테스트/게이트 변경 분리"],
+            },
+        ]
+        : [
+            {
+                step: 1,
+                title: "변경 범위 확정",
+                actions: ["이번에 건드릴 파일/안 건드릴 파일 확정", "인터페이스 유지 조건 확인"],
+                verification: [verifyCmd],
+                rollback: ["변경 전 상태로 되돌릴 준비(파일/커밋)"],
+            },
+            {
+                step: 2,
+                title: "구현",
+                actions: ["작은 단위로 구현", "필요한 최소 변경만 수행"],
+                verification: [verifyCmd],
+                rollback: ["최근 변경만 되돌리기"],
+            },
+            {
+                step: 3,
+                title: "검증/정리",
+                actions: ["실행/테스트로 동작 확인", "에러 처리/엣지 케이스 확인"],
+                verification: [verifyCmd],
+                rollback: ["문제 발생 시 최근 변경만 철회"],
+            },
+            {
+                step: 4,
+                title: "SSOT 동기화",
+                actions: ["문서/출력 계약과 실제 구현 정합 점검", "필요 시 SSOT 업데이트"],
+                verification: [verifyCmd],
+                rollback: ["SSOT 변경 분리"],
+            },
+        ];
+    const doc = {
+        module: "planning",
+        version,
+        fingerprint,
+        generated_at: nowIso(),
+        goal: opts.goal,
+        plan,
+        exit_criteria: ["inspect_code=GO", "SSOT drift 없음", "message_template_id 존재"],
+    };
+    fs.writeFileSync(outPath, JSON.stringify(doc, null, 2), "utf-8");
+    return { version, fingerprint, path: outPath };
+}

package/build/tools/vibe_pm/modules/repo_context.js

@@ -0,0 +1,56 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+function exists(basePath, rel) {
+    return fs.existsSync(path.join(basePath, rel));
+}
+export function detectRepoContext(basePath) {
+    const hasCargo = exists(basePath, "Cargo.toml");
+    const hasPackageJson = exists(basePath, "package.json");
+    const hasPyproject = exists(basePath, "pyproject.toml") || exists(basePath, "requirements.txt");
+    const langs = [hasCargo ? "rust" : null, hasPackageJson ? "ts" : null, hasPyproject ? "py" : null].filter(Boolean);
+    const primary_language = langs.length === 0 ? "mixed" : langs.length === 1 ? langs[0] : "mixed";
+    const package_manager = exists(basePath, "pnpm-lock.yaml")
+        ? "pnpm"
+        : exists(basePath, "yarn.lock")
+            ? "yarn"
+            : exists(basePath, "package-lock.json")
+                ? "npm"
+                : null;
+    const repo_type = exists(basePath, "project.godot") || exists(basePath, "godot.project")
+        ? "game"
+        : exists(basePath, "action.yml") || exists(basePath, "action.yaml")
+            ? "tool"
+            : exists(basePath, "src")
+                ? "service"
+                : "tool";
+    const frameworks = [];
+    try {
+        if (hasPackageJson) {
+            const raw = fs.readFileSync(path.join(basePath, "package.json"), "utf-8");
+            const pkg = JSON.parse(raw);
+            const deps = { ...(pkg.dependencies ?? {}), ...(pkg.devDependencies ?? {}) };
+            for (const k of ["next", "react", "vue", "svelte", "vite"]) {
+                if (deps[k])
+                    frameworks.push(k);
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return { primary_language, repo_type, package_manager, frameworks };
+}
+export function defaultVerifyCommand(ctx) {
+    if (ctx.primary_language === "rust")
+        return "cargo test -q";
+    if (ctx.primary_language === "ts") {
+        if (ctx.package_manager === "pnpm")
+            return "pnpm test";
+        if (ctx.package_manager === "yarn")
+            return "yarn test";
+        return "npm test";
+    }
+    if (ctx.primary_language === "py")
+        return "pytest";
+    return "echo \"No default verify\"";
+}

package/build/tools/vibe_pm/modules/research_v1.js

@@ -0,0 +1,114 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { fingerprintJson } from "./fingerprint.js";
+function nowIso() {
+    return new Date().toISOString();
+}
+function ensureDir(p) {
+    fs.mkdirSync(p, { recursive: true });
+}
+function loadAllowlist(repoRoot) {
+    const allowPath = path.join(repoRoot, "docs", "ssot", "modules", "research", "sources_allowlist.yaml");
+    if (!fs.existsSync(allowPath))
+        return { version: 1, topics: [] };
+    const raw = fs.readFileSync(allowPath, "utf-8");
+    return parseYaml(raw) ?? { version: 1, topics: [] };
+}
+function loadProjectBriefFallback(specHighRunDir) {
+    const p1 = path.join(specHighRunDir, "modules", "_inputs", "project_brief.txt");
+    if (fs.existsSync(p1)) {
+        try {
+            return fs.readFileSync(p1, "utf-8").trim();
+        }
+        catch {
+            // ignore
+        }
+    }
+    const p2 = path.join(specHighRunDir, "notes", "decision_discovery.md");
+    if (fs.existsSync(p2)) {
+        try {
+            return fs.readFileSync(p2, "utf-8").slice(0, 1000);
+        }
+        catch {
+            // ignore
+        }
+    }
+    return "";
+}
+export function ensureResearchModuleV1(opts) {
+    const version = "v1";
+    const projectBrief = (opts.projectBrief ?? "").trim() || loadProjectBriefFallback(opts.specHighRunDir);
+    const input = {
+        module: "research",
+        version,
+        project_brief: projectBrief,
+        repo_context: opts.repoContext,
+        decision_candidates: opts.decisionSnapshot.slice(0, 10).map((d) => ({
+            decision_id: d.decision_id,
+            option_id: d.chosen,
+            summary: d.chosen_label ?? d.question ?? "",
+        })),
+    };
+    const fingerprint = fingerprintJson("RSH", input);
+    const outDir = path.join(opts.specHighRunDir, "modules", "research", "v1");
+    const outPath = path.join(outDir, "research.json");
+    const evidencePath = path.join(outDir, "evidence.json");
+    // Cache hit
+    if (fs.existsSync(outPath)) {
+        try {
+            const existing = JSON.parse(fs.readFileSync(outPath, "utf-8"));
+            if (existing.fingerprint === fingerprint) {
+                return { version, fingerprint, path: outPath };
+            }
+        }
+        catch {
+            // regenerate
+        }
+    }
+    ensureDir(outDir);
+    const allow = loadAllowlist(opts.repoRoot);
+    const topics = allow.topics ?? [];
+    const findings = topics.map((t) => {
+        const candidates = t.links?.map((l) => ({
+            name: t.title ?? t.id ?? "source",
+            type: "doc",
+            url: l.url ?? "",
+            why_relevant: l.note ?? "",
+            extractable_components: [],
+            risks: ["license"],
+        })) ?? [];
+        return {
+            topic: t.title ?? t.id ?? "topic",
+            candidates: candidates.filter((c) => c.url),
+            recommendation: {
+                best_fit: candidates.find((c) => c.url)?.name ?? "",
+                reason: "allowlist 기반 후보입니다.",
+                adaptation_notes: ["v1에서는 링크/키워드를 저장하고, 구체 적용은 작업 지시서에서 확정합니다."],
+            },
+        };
+    });
+    const research = {
+        module: "research",
+        version,
+        fingerprint,
+        generated_at: nowIso(),
+        summary: "조사 슬롯이 준비되었습니다.",
+        findings,
+        license_notes: [],
+    };
+    const keywords = topics.flatMap((t) => t.keywords ?? []).slice(0, 20);
+    const links = topics.flatMap((t) => (t.links ?? []).map((l) => ({ url: l.url ?? "", note: l.note ?? "" }))).filter((x) => x.url);
+    const evidence = {
+        module: "research",
+        version,
+        fingerprint,
+        generated_at: nowIso(),
+        sources_allowlist_path: "docs/ssot/modules/research/sources_allowlist.yaml",
+        keywords,
+        links,
+    };
+    fs.writeFileSync(outPath, JSON.stringify(research, null, 2), "utf-8");
+    fs.writeFileSync(evidencePath, JSON.stringify(evidence, null, 2), "utf-8");
+    return { version, fingerprint, path: outPath };
+}

package/build/tools/vibe_pm/modules/skills_v1.js

@@ -0,0 +1,100 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { fingerprintJson } from "./fingerprint.js";
+const SKILL_SUMMARY = {
+    "repo-scout": "레포 구조/핵심 파일 파악",
+    "code-slicer": "기능을 최소 단위로 분해",
+    "ssot-sync": "문서/출력 계약 드리프트 방지",
+    "cargo-check": "Rust 빌드/테스트 루프",
+    "clippy-fix": "Rust 품질 보완(clippy)",
+    "ts-typecheck": "TS typecheck/test 루프",
+};
+function nowIso() {
+    return new Date().toISOString();
+}
+function ensureDir(p) {
+    fs.mkdirSync(p, { recursive: true });
+}
+function loadBundle(repoRoot, bundleId) {
+    const p = path.join(repoRoot, "docs", "ssot", "modules", "skills", "bundles", `${bundleId}.yaml`);
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        return parseYaml(fs.readFileSync(p, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function selectBundleIds(ctx) {
+    const out = ["default"];
+    if (ctx.primary_language === "rust")
+        out.push("rust");
+    if (ctx.primary_language === "ts")
+        out.push("ts");
+    return Array.from(new Set(out));
+}
+export function generateSkillsModuleV1(opts) {
+    const version = "v1";
+    const bundleIds = selectBundleIds(opts.repoContext);
+    const selectedBundles = bundleIds
+        .map((id) => {
+        const b = loadBundle(opts.repoRoot, id);
+        const skills = (b?.skills ?? []).filter(Boolean);
+        return { bundle_id: id, skills };
+    })
+        .filter((b) => b.skills.length > 0);
+    const input = {
+        module: "skills",
+        version,
+        repo_context: opts.repoContext,
+        selected_bundles: selectedBundles,
+    };
+    const fingerprint = fingerprintJson("SKL", input);
+    const outDir = path.join(opts.specHighRunDir, "modules", "skills", "v1");
+    const outPath = path.join(outDir, "selection.json");
+    const promptPath = path.join(outDir, "bundle_prompt.md");
+    if (fs.existsSync(outPath)) {
+        try {
+            const existing = JSON.parse(fs.readFileSync(outPath, "utf-8"));
+            if (existing.fingerprint === fingerprint && fs.existsSync(promptPath)) {
+                return { version, fingerprint, path: outPath, bundle_prompt_path: promptPath };
+            }
+        }
+        catch {
+            // regenerate
+        }
+    }
+    ensureDir(outDir);
+    const selection = {
+        module: "skills",
+        version,
+        fingerprint,
+        generated_at: nowIso(),
+        selected_bundles: selectedBundles,
+        constraints: {
+            forbidden: ["breaking_api"],
+            must_preserve: ["SSOT", "message_template_id"],
+        },
+    };
+    const lines = [];
+    lines.push("## SKILLS_PACK v1");
+    lines.push("");
+    lines.push("선택된 번들:");
+    for (const b of selectedBundles) {
+        lines.push(`- ${b.bundle_id}: ${b.skills.join(", ")}`);
+    }
+    lines.push("");
+    lines.push("스킬 요약:");
+    const allSkills = Array.from(new Set(selectedBundles.flatMap((b) => b.skills)));
+    for (const s of allSkills) {
+        lines.push(`- ${s}: ${SKILL_SUMMARY[s] ?? ""}`.trim());
+    }
+    lines.push("");
+    lines.push("검증(최소 1회):");
+    lines.push("- 변경 후 테스트/실행을 최소 1회 확인하세요.");
+    fs.writeFileSync(outPath, JSON.stringify(selection, null, 2), "utf-8");
+    fs.writeFileSync(promptPath, lines.join("\n") + "\n", "utf-8");
+    return { version, fingerprint, path: outPath, bundle_prompt_path: promptPath };
+}

package/build/tools/vibe_pm/pm_language.js

@@ -0,0 +1,222 @@
+// adapters/mcp-ts/src/tools/vibe_pm/pm_language.ts
+// PM Language transformation utilities
+// Reference: docs/DEV_SPEC/MCP_TOOL_SCHEMA_SPEC.md Section: Status Mapping
+// ============================================================
+// Signal Level Mapping (Internal → User-facing)
+// ============================================================
+export const SIGNAL_TO_REVIEW = {
+    LEVEL_1: { result: "GO", verdict: "문제없습니다" },
+    LEVEL_2: { result: "FIX", verdict: "한 가지 수정이 필요합니다" },
+    LEVEL_3: { result: "BLOCK", verdict: "이대로 출시하면 위험합니다" }
+};
+export const REVIEW_TO_EMOJI = {
+    GO: "✅",
+    FIX: "⚠️",
+    BLOCK: "❌"
+};
+export const REVIEW_TO_STATUS_KO = {
+    GO: "진행 가능",
+    FIX: "보완 필요",
+    BLOCK: "반려"
+};
+// ============================================================
+// Forbidden Terms (Never expose to user)
+// ============================================================
+export const FORBIDDEN_TERMS = [
+    "run_id",
+    "bridge",
+    "schema",
+    "gate",
+    "signal",
+    "FSM",
+    "spec_drift",
+    "touches_out_of_scope",
+    "LEVEL_1",
+    "LEVEL_2",
+    "LEVEL_3",
+    "decision_card",
+    "clinic_bridge"
+];
+// ============================================================
+// Mode Display Mapping
+// ============================================================
+export const MODE_DISPLAY = {
+    mvp_fast: "MVP (속도 우선)",
+    balanced: "균형 모드",
+    quality_first: "품질 우선"
+};
+// ============================================================
+// Phase Display Mapping
+// ============================================================
+export const PHASE_DISPLAY = {
+    init: "초기화",
+    briefing: "접수 중",
+    decision: "결재 대기",
+    work_order: "작업 지시서 발행됨",
+    implementation: "구현 중",
+    review: "검수 중",
+    completed: "완료"
+};
+// ============================================================
+// Transformation Functions
+// ============================================================
+/**
+ * Convert internal signal level to user-facing review result
+ */
+export function signalToReview(signal) {
+    const mapping = SIGNAL_TO_REVIEW[signal];
+    if (mapping) {
+        return mapping;
+    }
+    // Default to most severe if unknown
+    return { result: "BLOCK", verdict: "상태를 확인할 수 없습니다" };
+}
+/**
+ * Get user-friendly status message with emoji
+ */
+export function getStatusMessage(result) {
+    const emoji = REVIEW_TO_EMOJI[result];
+    const status = REVIEW_TO_STATUS_KO[result];
+    return `${emoji} ${status}`;
+}
+/**
+ * Format mode for user display
+ */
+export function formatMode(mode) {
+    return MODE_DISPLAY[mode] ?? mode;
+}
+/**
+ * Format phase for user display
+ */
+export function formatPhase(phase) {
+    return PHASE_DISPLAY[phase] ?? phase;
+}
+/**
+ * Check if text contains forbidden terms
+ */
+export function containsForbiddenTerms(text) {
+    const lowerText = text.toLowerCase();
+    return FORBIDDEN_TERMS.some((term) => lowerText.includes(term.toLowerCase()));
+}
+/**
+ * Sanitize text by warning about forbidden terms (for debugging)
+ * In production, this should be used to validate output before sending
+ */
+export function detectForbiddenTerms(text) {
+    const lowerText = text.toLowerCase();
+    return FORBIDDEN_TERMS.filter((term) => lowerText.includes(term.toLowerCase()));
+}
+// ============================================================
+// Issue Type Mapping
+// ============================================================
+export const ISSUE_TYPE_DISPLAY = {
+    RULE_VIOLATION: {
+        name: "규칙 위반",
+        description: "금지된 사항을 위반했습니다"
+    },
+    VERIFY_FAIL: {
+        name: "검증 실패",
+        description: "검증 기준을 충족하지 못했습니다"
+    },
+    SCOPE_MISMATCH: {
+        name: "범위 이탈",
+        description: "이번 작업 범위를 벗어났습니다"
+    },
+    RISK_SPIKE: {
+        name: "위험 발생",
+        description: "새로운 위험이 발견되었습니다"
+    }
+};
+/**
+ * Get user-friendly issue type description
+ */
+export function formatIssueType(type) {
+    return (ISSUE_TYPE_DISPLAY[type] ?? {
+        name: "알 수 없는 문제",
+        description: "확인이 필요합니다"
+    });
+}
+/**
+ * Generate paste_to_agent text block
+ */
+export function generateWorkOrderText(data) {
+    const orderNum = data.orderNumber ?? "001";
+    const modeDisplay = formatMode(data.mode);
+    const includeList = data.includes.map((item) => `- ${item}`).join("\n");
+    const excludeList = data.excludes.map((item) => `- ${item}`).join("\n");
+    const doNotTouchList = data.doNotTouch.map((item) => `- ${item}`).join("\n");
+    const verifyList = data.verifyCriteria.map((item) => `- ${item}`).join("\n");
+    return `<<< Vibe PM 작업 지시서 #${orderNum} >>>
+
+프로젝트: ${data.projectName}
+모드: ${modeDisplay}
+
+[목표]
+${data.headline}
+
+[이번에 할 것]
+${includeList}
+
+[이번에 안 할 것]
+${excludeList}
+
+[건드리지 말 것]
+${doNotTouchList}
+
+[검증 기준]
+${verifyList}
+
+<<< 지시서 끝 >>>`;
+}
+/**
+ * Generate repair request prompt block
+ */
+export function generateRepairPrompt(data) {
+    const modeDisplay = formatMode(data.mode);
+    const fixList = data.fixDirection.map((item, i) => `${i + 1}. ${item}`).join("\n");
+    const verifyList = data.verifyCriteria.map((item) => `- ${item}`).join("\n");
+    return `<<< Vibe PM 수정 요청 >>>
+
+프로젝트: ${data.projectName}
+모드: ${modeDisplay}
+
+[문제]
+${data.problem}
+
+[원인]
+${data.cause}
+
+[수정 방향]
+${fixList}
+
+[검증 기준]
+${verifyList}
+
+<<< 수정 요청 끝 >>>`;
+}
+// ============================================================
+// Decision Text Transformation
+// ============================================================
+/**
+ * Transform technical ask_queue text to PM language
+ * This is a simplified version - full implementation would parse and restructure
+ */
+export function transformAskQueueText(rawText) {
+    let transformed = rawText;
+    // Replace common technical terms with PM-friendly alternatives
+    const replacements = [
+        [/run_id/gi, "프로젝트"],
+        [/bridge/gi, "작업 지시서"],
+        [/schema/gi, "구조"],
+        [/gate/gi, "검토"],
+        [/signal/gi, "상태"],
+        [/FSM/gi, "워크플로우"],
+        [/spec_drift/gi, "범위 변경"],
+        [/decision_card/gi, "결재 안건"],
+        [/clinic_bridge/gi, "검수 기준"]
+    ];
+    for (const [pattern, replacement] of replacements) {
+        transformed = transformed.replace(pattern, replacement);
+    }
+    return transformed;
+}