@vibecodetown/mcp-server 1.3.1

package/build/db_sync/parsers/gate.js

@@ -0,0 +1,73 @@
+/**
+ * db_sync/parsers/gate.ts
+ *
+ * gate_report.json 파서
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { isVerdict } from "../types.js";
+/**
+ * gate_report.json 파싱
+ *
+ * @param runDir run 디렉토리 경로
+ * @returns ParsedGate 또는 null (파일 없음)
+ */
+export function parseGateReport(runDir) {
+    const filePath = path.join(runDir, "gate", "gate_report.json");
+    const relativePath = "gate/gate_report.json";
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const raw = JSON.parse(content);
+        const verdictRaw = extractString(raw, "verdict", "result", "gate_verdict");
+        const verdict = isVerdict(verdictRaw) ? verdictRaw : "ERROR";
+        return {
+            verdict,
+            issues: extractObjectArray(raw, "issues", "problems", "errors"),
+            risk_score: extractNumber(raw, "risk_score", "score", "risk"),
+            evidence_path: relativePath,
+            raw,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 숫자 필드 추출
+ */
+function extractNumber(obj, ...keys) {
+    for (const key of keys) {
+        const value = obj[key];
+        if (typeof value === "number") {
+            return value;
+        }
+    }
+    return 0;
+}
+/**
+ * 문자열 필드 추출
+ */
+function extractString(obj, ...keys) {
+    for (const key of keys) {
+        const value = obj[key];
+        if (typeof value === "string") {
+            return value;
+        }
+    }
+    return undefined;
+}
+/**
+ * 객체 배열 추출
+ */
+function extractObjectArray(obj, ...keys) {
+    for (const key of keys) {
+        const value = obj[key];
+        if (Array.isArray(value)) {
+            return value.filter((v) => typeof v === "object" && v !== null);
+        }
+    }
+    return [];
+}

package/build/db_sync/parsers/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * db_sync/parsers/index.ts
+ *
+ * 증거 파일 파서 모듈 exports
+ */
+export { parseIngressSummary, type ParsedIngress } from "./ingress.js";
+export { parseChangeMap, type ParsedMapping } from "./mapping.js";
+export { parseGateReport, type ParsedGate } from "./gate.js";
+export { parseBitnetTrace, type ParsedBitnet } from "./bitnet.js";
+export { parseEvidenceFile, parseAllEvidence, extractRiskScore, extractChangedLines, extractChangedFiles, extractTopRisks, type EvidenceParseResult, type EvidenceType, } from "./orchestrator.js";

package/build/db_sync/parsers/index.js

@@ -0,0 +1,10 @@
+/**
+ * db_sync/parsers/index.ts
+ *
+ * 증거 파일 파서 모듈 exports
+ */
+export { parseIngressSummary } from "./ingress.js";
+export { parseChangeMap } from "./mapping.js";
+export { parseGateReport } from "./gate.js";
+export { parseBitnetTrace } from "./bitnet.js";
+export { parseEvidenceFile, parseAllEvidence, extractRiskScore, extractChangedLines, extractChangedFiles, extractTopRisks, } from "./orchestrator.js";

package/build/db_sync/parsers/ingress.d.ts

@@ -0,0 +1,22 @@
+/**
+ * db_sync/parsers/ingress.ts
+ *
+ * ingress_summary.json 파서
+ */
+/**
+ * ingress_summary.json 파싱 결과
+ */
+export interface ParsedIngress {
+    changed_files: number;
+    staged_files: number;
+    mode: string;
+    resolution?: string;
+    raw: Record<string, unknown>;
+}
+/**
+ * ingress_summary.json 파싱
+ *
+ * @param runDir run 디렉토리 경로
+ * @returns ParsedIngress 또는 null (파일 없음)
+ */
+export declare function parseIngressSummary(runDir: string): ParsedIngress | null;

package/build/db_sync/parsers/ingress.js

@@ -0,0 +1,57 @@
+/**
+ * db_sync/parsers/ingress.ts
+ *
+ * ingress_summary.json 파서
+ */
+import * as fs from "fs";
+import * as path from "path";
+/**
+ * ingress_summary.json 파싱
+ *
+ * @param runDir run 디렉토리 경로
+ * @returns ParsedIngress 또는 null (파일 없음)
+ */
+export function parseIngressSummary(runDir) {
+    const filePath = path.join(runDir, "ingress", "ingress_summary.json");
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const raw = JSON.parse(content);
+        return {
+            changed_files: extractNumber(raw, "changed_files_count", "changed_files"),
+            staged_files: extractNumber(raw, "staged_files_count", "staged_files"),
+            mode: extractString(raw, "mode", "resolution_mode") ?? "unknown",
+            resolution: extractString(raw, "resolution", "resolution_status"),
+            raw,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 숫자 필드 추출 (여러 키 시도)
+ */
+function extractNumber(obj, ...keys) {
+    for (const key of keys) {
+        const value = obj[key];
+        if (typeof value === "number") {
+            return value;
+        }
+    }
+    return 0;
+}
+/**
+ * 문자열 필드 추출 (여러 키 시도)
+ */
+function extractString(obj, ...keys) {
+    for (const key of keys) {
+        const value = obj[key];
+        if (typeof value === "string") {
+            return value;
+        }
+    }
+    return undefined;
+}

package/build/db_sync/parsers/mapping.d.ts

@@ -0,0 +1,22 @@
+/**
+ * db_sync/parsers/mapping.ts
+ *
+ * change_map.v1.json 파서
+ */
+/**
+ * change_map.v1.json 파싱 결과
+ */
+export interface ParsedMapping {
+    domains: string[];
+    risk_areas: string[];
+    lines_changed: number;
+    file_count: number;
+    raw: Record<string, unknown>;
+}
+/**
+ * change_map.v1.json 파싱
+ *
+ * @param runDir run 디렉토리 경로
+ * @returns ParsedMapping 또는 null (파일 없음)
+ */
+export declare function parseChangeMap(runDir: string): ParsedMapping | null;

package/build/db_sync/parsers/mapping.js

@@ -0,0 +1,57 @@
+/**
+ * db_sync/parsers/mapping.ts
+ *
+ * change_map.v1.json 파서
+ */
+import * as fs from "fs";
+import * as path from "path";
+/**
+ * change_map.v1.json 파싱
+ *
+ * @param runDir run 디렉토리 경로
+ * @returns ParsedMapping 또는 null (파일 없음)
+ */
+export function parseChangeMap(runDir) {
+    const filePath = path.join(runDir, "mapping", "change_map.v1.json");
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const raw = JSON.parse(content);
+        return {
+            domains: extractStringArray(raw, "domains", "affected_domains"),
+            risk_areas: extractStringArray(raw, "risk_areas", "risks"),
+            lines_changed: extractNumber(raw, "lines_changed", "total_lines"),
+            file_count: extractNumber(raw, "file_count", "files_count"),
+            raw,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 숫자 필드 추출
+ */
+function extractNumber(obj, ...keys) {
+    for (const key of keys) {
+        const value = obj[key];
+        if (typeof value === "number") {
+            return value;
+        }
+    }
+    return 0;
+}
+/**
+ * 문자열 배열 추출
+ */
+function extractStringArray(obj, ...keys) {
+    for (const key of keys) {
+        const value = obj[key];
+        if (Array.isArray(value)) {
+            return value.filter((v) => typeof v === "string");
+        }
+    }
+    return [];
+}

package/build/db_sync/parsers/orchestrator.d.ts

@@ -0,0 +1,66 @@
+/**
+ * db_sync/parsers/orchestrator.ts
+ *
+ * 증거 파일 파싱 오케스트레이터
+ */
+import { type ParsedIngress } from "./ingress.js";
+import { type ParsedMapping } from "./mapping.js";
+import { type ParsedGate } from "./gate.js";
+import { type ParsedBitnet } from "./bitnet.js";
+/**
+ * 증거 파일 타입
+ */
+export type EvidenceType = "ingress" | "mapping" | "gate" | "bitnet";
+/**
+ * 증거 파싱 결과
+ */
+export interface EvidenceParseResult {
+    ingress: ParsedIngress | null;
+    mapping: ParsedMapping | null;
+    gate: ParsedGate | null;
+    bitnet: ParsedBitnet | null;
+}
+/**
+ * 단일 증거 파일 파싱
+ *
+ * @param runDir run 디렉토리 경로
+ * @param type 증거 타입
+ * @returns 파싱 결과 또는 null
+ */
+export declare function parseEvidenceFile(runDir: string, type: EvidenceType): ParsedIngress | ParsedMapping | ParsedGate | ParsedBitnet | null;
+/**
+ * 모든 증거 파일 파싱
+ *
+ * @param runDir run 디렉토리 경로
+ * @returns EvidenceParseResult
+ */
+export declare function parseAllEvidence(runDir: string): EvidenceParseResult;
+/**
+ * 증거에서 risk_score 추출
+ *
+ * @param evidence EvidenceParseResult
+ * @returns 0-100 범위의 risk score
+ */
+export declare function extractRiskScore(evidence: EvidenceParseResult): number;
+/**
+ * 증거에서 changed_lines 추출
+ *
+ * @param evidence EvidenceParseResult
+ * @returns 변경 라인 수
+ */
+export declare function extractChangedLines(evidence: EvidenceParseResult): number;
+/**
+ * 증거에서 changed_files 추출
+ *
+ * @param evidence EvidenceParseResult
+ * @returns 변경 파일 수
+ */
+export declare function extractChangedFiles(evidence: EvidenceParseResult): number;
+/**
+ * 증거에서 top_risks 추출
+ *
+ * @param evidence EvidenceParseResult
+ * @param limit 최대 개수
+ * @returns top risks 배열
+ */
+export declare function extractTopRisks(evidence: EvidenceParseResult, limit?: number): Record<string, unknown>[];

package/build/db_sync/parsers/orchestrator.js

@@ -0,0 +1,110 @@
+/**
+ * db_sync/parsers/orchestrator.ts
+ *
+ * 증거 파일 파싱 오케스트레이터
+ */
+import { parseIngressSummary } from "./ingress.js";
+import { parseChangeMap } from "./mapping.js";
+import { parseGateReport } from "./gate.js";
+import { parseBitnetTrace } from "./bitnet.js";
+/**
+ * 단일 증거 파일 파싱
+ *
+ * @param runDir run 디렉토리 경로
+ * @param type 증거 타입
+ * @returns 파싱 결과 또는 null
+ */
+export function parseEvidenceFile(runDir, type) {
+    switch (type) {
+        case "ingress":
+            return parseIngressSummary(runDir);
+        case "mapping":
+            return parseChangeMap(runDir);
+        case "gate":
+            return parseGateReport(runDir);
+        case "bitnet":
+            return parseBitnetTrace(runDir);
+        default:
+            return null;
+    }
+}
+/**
+ * 모든 증거 파일 파싱
+ *
+ * @param runDir run 디렉토리 경로
+ * @returns EvidenceParseResult
+ */
+export function parseAllEvidence(runDir) {
+    return {
+        ingress: parseIngressSummary(runDir),
+        mapping: parseChangeMap(runDir),
+        gate: parseGateReport(runDir),
+        bitnet: parseBitnetTrace(runDir),
+    };
+}
+/**
+ * 증거에서 risk_score 추출
+ *
+ * @param evidence EvidenceParseResult
+ * @returns 0-100 범위의 risk score
+ */
+export function extractRiskScore(evidence) {
+    // gate report의 risk_score 우선
+    if (evidence.gate?.risk_score != null) {
+        return evidence.gate.risk_score;
+    }
+    // bitnet risk_level 변환
+    if (evidence.bitnet?.risk_level) {
+        const levelToScore = {
+            low: 20,
+            medium: 50,
+            high: 75,
+            critical: 95,
+        };
+        return levelToScore[evidence.bitnet.risk_level] ?? 0;
+    }
+    return 0;
+}
+/**
+ * 증거에서 changed_lines 추출
+ *
+ * @param evidence EvidenceParseResult
+ * @returns 변경 라인 수
+ */
+export function extractChangedLines(evidence) {
+    return evidence.mapping?.lines_changed ?? 0;
+}
+/**
+ * 증거에서 changed_files 추출
+ *
+ * @param evidence EvidenceParseResult
+ * @returns 변경 파일 수
+ */
+export function extractChangedFiles(evidence) {
+    return (evidence.ingress?.changed_files ?? evidence.mapping?.file_count ?? 0);
+}
+/**
+ * 증거에서 top_risks 추출
+ *
+ * @param evidence EvidenceParseResult
+ * @param limit 최대 개수
+ * @returns top risks 배열
+ */
+export function extractTopRisks(evidence, limit = 5) {
+    const risks = [];
+    // gate issues
+    if (evidence.gate?.issues) {
+        risks.push(...evidence.gate.issues.slice(0, limit).map((issue) => ({
+            source: "gate",
+            ...issue,
+        })));
+    }
+    // mapping risk_areas
+    if (evidence.mapping?.risk_areas) {
+        risks.push(...evidence.mapping.risk_areas.slice(0, limit).map((area) => ({
+            source: "mapping",
+            area,
+        })));
+    }
+    return risks.slice(0, limit);
+}

package/build/db_sync/pool.d.ts

@@ -0,0 +1,120 @@
+/**
+ * db_sync/pool.ts
+ *
+ * PostgreSQL Secondary Truth Layer - Connection Pool
+ *
+ * @description
+ * PostgreSQL 커넥션 풀 관리 및 rail 혼입 방지.
+ * pg 패키지는 조건부 로드됩니다 (DB sync 비활성화 시 로드 안 함).
+ *
+ * @see docs/DEV_SPEC/active/postgresql-secondary-truth/CONTRACT.md
+ */
+import type { Rail } from "./types.js";
+/**
+ * pg.Pool 인터페이스 최소 정의 (선택적 의존성)
+ */
+export interface PoolLike {
+    query<T = unknown>(text: string, values?: unknown[]): Promise<{
+        rows: T[];
+        rowCount: number | null;
+    }>;
+    connect(): Promise<ClientLike>;
+    end(): Promise<void>;
+}
+/**
+ * pg.PoolClient 인터페이스 최소 정의
+ */
+export interface ClientLike {
+    query<T = unknown>(text: string, values?: unknown[]): Promise<{
+        rows: T[];
+        rowCount: number | null;
+    }>;
+    release(): void;
+}
+/**
+ * 커넥션 풀 획득
+ *
+ * @param rail 실행 레일 (local/mcp)
+ * @returns Promise<PoolLike>
+ * @throws Error if VIBE_DB_URL is not set
+ *
+ * @description
+ * - Rail별로 단일 풀 인스턴스 유지
+ * - 연결 직후 assertDbRail()로 rail 일치 검증 (P0-1)
+ * - pg 패키지 동적 로드 (번들 크기 최적화)
+ */
+export declare function getPool(rail: Rail): Promise<PoolLike>;
+/**
+ * 특정 rail의 풀 종료
+ *
+ * @param rail 실행 레일
+ */
+export declare function closePool(rail: Rail): Promise<void>;
+/**
+ * 모든 풀 종료
+ */
+export declare function closeAllPools(): Promise<void>;
+/**
+ * DB의 rail 정체성 검증
+ *
+ * @param pool 커넥션 풀
+ * @param expected 기대하는 rail
+ * @throws Error if DB rail doesn't match expected
+ *
+ * @description
+ * P0-1 CRITICAL: Rail 혼입 방지
+ * - local 레일이 server DB에 쓰기 금지
+ * - mcp 레일이 local DB에 쓰기 금지
+ * - meta.db_identity 테이블에서 DB의 정체성 확인
+ */
+export declare function assertDbRail(pool: PoolLike, expected: Rail): Promise<void>;
+/**
+ * run 단위 advisory lock 획득
+ *
+ * @param pool 커넥션 풀
+ * @param key lock 키 (rail|workspace_id|run_id)
+ * @returns lock 해제 함수
+ *
+ * @description
+ * P0-7: MCP sync 폭주 방지를 위한 advisory lock
+ * 같은 run에 대한 동시 sync 방지
+ */
+export declare function acquireRunLock(pool: PoolLike, key: string): Promise<() => Promise<void>>;
+/**
+ * run 단위 advisory lock 시도 (non-blocking)
+ *
+ * @param pool 커넥션 풀
+ * @param key lock 키 (rail|workspace_id|run_id)
+ * @returns { acquired: boolean, release: () => Promise<void> }
+ */
+export declare function tryAcquireRunLock(pool: PoolLike, key: string): Promise<{
+    acquired: boolean;
+    release: () => Promise<void>;
+}>;
+/**
+ * 트랜잭션 실행
+ *
+ * @param pool 커넥션 풀
+ * @param fn 트랜잭션 내에서 실행할 함수
+ * @returns 함수 반환값
+ */
+export declare function withTransaction<T>(pool: PoolLike, fn: (client: ClientLike) => Promise<T>): Promise<T>;
+/**
+ * run lock과 함께 트랜잭션 실행
+ *
+ * @param pool 커넥션 풀
+ * @param lockKey lock 키
+ * @param fn 트랜잭션 내에서 실행할 함수
+ * @returns 함수 반환값
+ */
+export declare function withLockedTransaction<T>(pool: PoolLike, lockKey: string, fn: (client: ClientLike) => Promise<T>): Promise<T>;
+/**
+ * DB 연결 상태 확인
+ *
+ * @param pool 커넥션 풀
+ * @returns { healthy: boolean, error?: string }
+ */
+export declare function checkPoolHealth(pool: PoolLike): Promise<{
+    healthy: boolean;
+    error?: string;
+}>;