@vibecodetown/mcp-server 1.3.1

package/build/db_sync/writer.js

@@ -0,0 +1,377 @@
+/**
+ * db_sync/writer.ts
+ *
+ * PostgreSQL Secondary Truth Layer - DB Writers
+ *
+ * @description
+ * ssot/rm 테이블에 대한 idempotent upsert 함수들.
+ * 모든 upsert는 반복 실행해도 결과가 동일합니다.
+ *
+ * @see docs/DEV_SPEC/active/postgresql-secondary-truth/CONTRACT.md
+ */
+// =============================================================================
+// ssot.run
+// =============================================================================
+/**
+ * ssot.run upsert
+ *
+ * @param client DB client
+ * @param run run 데이터
+ *
+ * @description
+ * idempotent: 같은 (rail, workspace_id, run_id)로 여러 번 호출해도 1행만 존재
+ */
+export async function upsertRun(client, run) {
+    await client.query(`
+    INSERT INTO ssot.run (
+      rail, workspace_id, run_id,
+      branch, commit_sha,
+      run_dir, ingress_dir, mapping_dir, ci_dir,
+      snapshot_hash,
+      created_at, updated_at
+    ) VALUES (
+      $1, $2, $3,
+      $4, $5,
+      $6, $7, $8, $9,
+      $10,
+      COALESCE($11, NOW()), NOW()
+    )
+    ON CONFLICT (rail, workspace_id, run_id)
+    DO UPDATE SET
+      branch = EXCLUDED.branch,
+      commit_sha = EXCLUDED.commit_sha,
+      run_dir = EXCLUDED.run_dir,
+      ingress_dir = EXCLUDED.ingress_dir,
+      mapping_dir = EXCLUDED.mapping_dir,
+      ci_dir = EXCLUDED.ci_dir,
+      snapshot_hash = EXCLUDED.snapshot_hash,
+      updated_at = NOW()
+    `, [
+        run.rail,
+        run.workspace_id,
+        run.run_id,
+        run.branch ?? null,
+        run.commit_sha ?? null,
+        run.run_dir,
+        run.ingress_dir ?? null,
+        run.mapping_dir ?? null,
+        run.ci_dir ?? null,
+        run.snapshot_hash,
+        run.created_at ?? null,
+    ]);
+}
+// =============================================================================
+// ssot.file_index
+// =============================================================================
+/**
+ * ssot.file_index upsert (단일 파일)
+ *
+ * @param client DB client
+ * @param file 파일 인덱스 데이터
+ */
+export async function upsertFileIndex(client, file) {
+    await client.query(`
+    INSERT INTO ssot.file_index (
+      rail, workspace_id, run_id,
+      logical_path, content_sha, bytes, mtime,
+      content_type, tags, json_cache
+    ) VALUES (
+      $1, $2, $3,
+      $4, $5, $6, $7,
+      $8, $9, $10
+    )
+    ON CONFLICT (rail, workspace_id, run_id, logical_path)
+    DO UPDATE SET
+      content_sha = EXCLUDED.content_sha,
+      bytes = EXCLUDED.bytes,
+      mtime = EXCLUDED.mtime,
+      content_type = EXCLUDED.content_type,
+      tags = EXCLUDED.tags,
+      json_cache = EXCLUDED.json_cache
+    `, [
+        file.rail,
+        file.workspace_id,
+        file.run_id,
+        file.logical_path,
+        file.content_sha,
+        file.bytes,
+        file.mtime ?? null,
+        file.content_type ?? null,
+        file.tags,
+        file.json_cache ?? null,
+    ]);
+}
+/**
+ * ssot.file_index batch upsert (여러 파일)
+ *
+ * @param client DB client
+ * @param files 파일 인덱스 배열
+ *
+ * @description
+ * 대량 파일에 대해 단일 트랜잭션으로 처리
+ */
+export async function upsertFileIndexBatch(client, files) {
+    if (files.length === 0)
+        return;
+    // 배치 크기 제한 (PostgreSQL 파라미터 수 제한)
+    const BATCH_SIZE = 100;
+    for (let i = 0; i < files.length; i += BATCH_SIZE) {
+        const batch = files.slice(i, i + BATCH_SIZE);
+        await upsertFileIndexBatchInner(client, batch);
+    }
+}
+/**
+ * 내부 배치 upsert (100개 이하)
+ */
+async function upsertFileIndexBatchInner(client, files) {
+    if (files.length === 0)
+        return;
+    // VALUES 절 생성
+    const values = [];
+    const placeholders = [];
+    files.forEach((file, idx) => {
+        const offset = idx * 10;
+        placeholders.push(`($${offset + 1}, $${offset + 2}, $${offset + 3}, $${offset + 4}, $${offset + 5}, $${offset + 6}, $${offset + 7}, $${offset + 8}, $${offset + 9}, $${offset + 10})`);
+        values.push(file.rail, file.workspace_id, file.run_id, file.logical_path, file.content_sha, file.bytes, file.mtime ?? null, file.content_type ?? null, file.tags, file.json_cache ?? null);
+    });
+    await client.query(`
+    INSERT INTO ssot.file_index (
+      rail, workspace_id, run_id,
+      logical_path, content_sha, bytes, mtime,
+      content_type, tags, json_cache
+    ) VALUES ${placeholders.join(", ")}
+    ON CONFLICT (rail, workspace_id, run_id, logical_path)
+    DO UPDATE SET
+      content_sha = EXCLUDED.content_sha,
+      bytes = EXCLUDED.bytes,
+      mtime = EXCLUDED.mtime,
+      content_type = EXCLUDED.content_type,
+      tags = EXCLUDED.tags,
+      json_cache = EXCLUDED.json_cache
+    `, values);
+}
+// =============================================================================
+// ssot.event
+// =============================================================================
+/**
+ * ssot.event insert
+ *
+ * @param client DB client
+ * @param event 이벤트 데이터
+ * @returns event_id
+ *
+ * @description
+ * 이벤트는 append-only (upsert가 아닌 insert)
+ */
+export async function insertEvent(client, event) {
+    const result = await client.query(`
+    INSERT INTO ssot.event (
+      rail, workspace_id, run_id,
+      ts, kind, actor, severity, payload
+    ) VALUES (
+      $1, $2, $3,
+      COALESCE($4, NOW()), $5, $6, COALESCE($7, 'info'), $8
+    )
+    RETURNING event_id
+    `, [
+        event.rail,
+        event.workspace_id,
+        event.run_id,
+        event.ts ?? null,
+        event.kind,
+        event.actor,
+        event.severity ?? "info",
+        event.payload,
+    ]);
+    return BigInt(result.rows[0].event_id);
+}
+// =============================================================================
+// ssot.gate_verdict
+// =============================================================================
+/**
+ * ssot.gate_verdict upsert
+ *
+ * @param client DB client
+ * @param verdict verdict 데이터
+ */
+export async function upsertGateVerdict(client, verdict) {
+    await client.query(`
+    INSERT INTO ssot.gate_verdict (
+      rail, workspace_id, run_id,
+      verdict, reason, evidence_path, updated_at
+    ) VALUES (
+      $1, $2, $3,
+      $4, $5, $6, NOW()
+    )
+    ON CONFLICT (rail, workspace_id, run_id)
+    DO UPDATE SET
+      verdict = EXCLUDED.verdict,
+      reason = EXCLUDED.reason,
+      evidence_path = EXCLUDED.evidence_path,
+      updated_at = NOW()
+    `, [
+        verdict.rail,
+        verdict.workspace_id,
+        verdict.run_id,
+        verdict.verdict,
+        verdict.reason ?? null,
+        verdict.evidence_path ?? null,
+    ]);
+}
+// =============================================================================
+// rm.run_card
+// =============================================================================
+/**
+ * rm.run_card upsert
+ *
+ * @param client DB client
+ * @param card run card 데이터
+ */
+export async function upsertRunCard(client, card) {
+    await client.query(`
+    INSERT INTO rm.run_card (
+      rail, workspace_id, run_id,
+      created_at, last_event_at, verdict, risk_score,
+      changed_files, changed_lines, top_risks, next_actions
+    ) VALUES (
+      $1, $2, $3,
+      $4, $5, $6, $7,
+      $8, $9, $10, $11
+    )
+    ON CONFLICT (rail, workspace_id, run_id)
+    DO UPDATE SET
+      last_event_at = EXCLUDED.last_event_at,
+      verdict = EXCLUDED.verdict,
+      risk_score = EXCLUDED.risk_score,
+      changed_files = EXCLUDED.changed_files,
+      changed_lines = EXCLUDED.changed_lines,
+      top_risks = EXCLUDED.top_risks,
+      next_actions = EXCLUDED.next_actions
+    `, [
+        card.rail,
+        card.workspace_id,
+        card.run_id,
+        card.created_at,
+        card.last_event_at ?? null,
+        card.verdict ?? null,
+        card.risk_score ?? null,
+        card.changed_files ?? null,
+        card.changed_lines ?? null,
+        card.top_risks ?? null,
+        card.next_actions ?? null,
+    ]);
+}
+// =============================================================================
+// rm.artifact
+// =============================================================================
+/**
+ * rm.artifact upsert
+ *
+ * @param client DB client
+ * @param artifact artifact 데이터
+ */
+export async function upsertArtifact(client, artifact) {
+    await client.query(`
+    INSERT INTO rm.artifact (
+      rail, workspace_id, run_id,
+      kind, logical_path, content_sha, summary
+    ) VALUES (
+      $1, $2, $3,
+      $4, $5, $6, $7
+    )
+    ON CONFLICT (rail, workspace_id, run_id, kind, logical_path)
+    DO UPDATE SET
+      content_sha = EXCLUDED.content_sha,
+      summary = EXCLUDED.summary
+    `, [
+        artifact.rail,
+        artifact.workspace_id,
+        artifact.run_id,
+        artifact.kind,
+        artifact.logical_path,
+        artifact.content_sha,
+        artifact.summary ?? null,
+    ]);
+}
+// =============================================================================
+// pub.public_run (MCP 서버 전용)
+// =============================================================================
+/**
+ * pub.public_run upsert
+ *
+ * @param client DB client
+ * @param publicRun public run 데이터
+ *
+ * @description
+ * MCP 서버에서만 사용. pub.sync_public_run() 함수 직접 호출 권장.
+ */
+export async function upsertPublicRun(client, publicRun) {
+    await client.query(`
+    INSERT INTO pub.public_run (
+      workspace_id, run_id, owner_org, is_public,
+      created_at, verdict, risk_score, summary
+    ) VALUES (
+      $1, $2, $3, $4,
+      COALESCE($5, NOW()), $6, $7, $8
+    )
+    ON CONFLICT (workspace_id, run_id)
+    DO UPDATE SET
+      is_public = EXCLUDED.is_public,
+      verdict = EXCLUDED.verdict,
+      risk_score = EXCLUDED.risk_score,
+      summary = EXCLUDED.summary
+    `, [
+        publicRun.workspace_id,
+        publicRun.run_id,
+        publicRun.owner_org,
+        publicRun.is_public,
+        publicRun.created_at ?? null,
+        publicRun.verdict ?? null,
+        publicRun.risk_score ?? null,
+        publicRun.summary ?? null,
+    ]);
+}
+/**
+ * pub.sync_public_run 함수 호출
+ *
+ * @param client DB client
+ * @param workspaceId workspace_id
+ * @param runId run_id
+ * @param ownerOrg 테넌트 키
+ * @param isPublic 공개 여부
+ */
+export async function syncPublicRun(client, workspaceId, runId, ownerOrg, isPublic) {
+    await client.query(`SELECT pub.sync_public_run($1, $2, $3, $4)`, [workspaceId, runId, ownerOrg, isPublic]);
+}
+// =============================================================================
+// Delete Operations (Clean-up)
+// =============================================================================
+/**
+ * run 삭제 (cascade로 관련 데이터 모두 삭제)
+ *
+ * @param client DB client
+ * @param rail 레일
+ * @param workspaceId workspace_id
+ * @param runId run_id
+ */
+export async function deleteRun(client, rail, workspaceId, runId) {
+    await client.query(`DELETE FROM ssot.run WHERE rail = $1 AND workspace_id = $2 AND run_id = $3`, [rail, workspaceId, runId]);
+}
+/**
+ * 특정 workspace의 오래된 run 정리
+ *
+ * @param client DB client
+ * @param rail 레일
+ * @param workspaceId workspace_id
+ * @param keepDays 유지할 일수
+ * @returns 삭제된 run 수
+ */
+export async function cleanupOldRuns(client, rail, workspaceId, keepDays) {
+    const result = await client.query(`
+    DELETE FROM ssot.run
+    WHERE rail = $1
+      AND workspace_id = $2
+      AND created_at < NOW() - INTERVAL '1 day' * $3
+    `, [rail, workspaceId, keepDays]);
+    return result.rowCount ?? 0;
+}

package/build/decision-log-reader.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Decision Log Reader
+ *
+ * decision_log.v1.jsonl 파일에서 Decision 엔트리를 읽는 유틸리티.
+ * FAIL-SAFE: 파일이 없거나 파싱 에러 시 빈 배열 반환.
+ */
+import type { DecisionLogEntry } from "./reviewer-ux-types.js";
+/**
+ * Decision Log에서 특정 run_id의 엔트리 조회
+ *
+ * @param workspaceRoot - 프로젝트 루트 경로
+ * @param runId - 조회할 run_id
+ * @returns Decision 엔트리 배열 (없으면 빈 배열)
+ */
+export declare function readDecisionLog(workspaceRoot: string, runId: string): DecisionLogEntry[];
+/**
+ * Decision Log 전체 조회 (최근 N개)
+ *
+ * @param workspaceRoot - 프로젝트 루트 경로
+ * @param limit - 최대 반환 개수 (기본 100)
+ * @returns Decision 엔트리 배열 (최신순)
+ */
+export declare function readRecentDecisions(workspaceRoot: string, limit?: number): DecisionLogEntry[];
+/**
+ * Decision evidence 존재 여부 확인
+ *
+ * @param workspaceRoot - 프로젝트 루트 경로
+ * @param runId - 확인할 run_id
+ * @returns true면 해당 run_id에 대한 decision이 존재
+ */
+export declare function hasDecisionEvidence(workspaceRoot: string, runId: string): boolean;
+/**
+ * Decision Log 파일 경로 조회
+ *
+ * @param workspaceRoot - 프로젝트 루트 경로
+ * @returns 존재하는 decision log 파일 경로 (없으면 null)
+ */
+export declare function findDecisionLogPath(workspaceRoot: string): string | null;

package/build/decision-log-reader.js

@@ -0,0 +1,116 @@
+/**
+ * Decision Log Reader
+ *
+ * decision_log.v1.jsonl 파일에서 Decision 엔트리를 읽는 유틸리티.
+ * FAIL-SAFE: 파일이 없거나 파싱 에러 시 빈 배열 반환.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+const DECISION_LOG_FILENAME = "decision_log.v1.jsonl";
+/**
+ * Decision Log 후보 경로 목록
+ */
+function getDecisionLogPaths(workspaceRoot) {
+    return [
+        path.join(workspaceRoot, ".vibe", DECISION_LOG_FILENAME),
+        path.join(workspaceRoot, "docs", "decisions", DECISION_LOG_FILENAME),
+    ];
+}
+/**
+ * Decision Log에서 특정 run_id의 엔트리 조회
+ *
+ * @param workspaceRoot - 프로젝트 루트 경로
+ * @param runId - 조회할 run_id
+ * @returns Decision 엔트리 배열 (없으면 빈 배열)
+ */
+export function readDecisionLog(workspaceRoot, runId) {
+    const candidates = getDecisionLogPaths(workspaceRoot);
+    for (const logPath of candidates) {
+        if (!fs.existsSync(logPath))
+            continue;
+        try {
+            const entries = [];
+            const content = fs.readFileSync(logPath, "utf-8");
+            for (const line of content.split("\n")) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const entry = JSON.parse(line);
+                    if (entry.run_id === runId) {
+                        entries.push(entry);
+                    }
+                }
+                catch {
+                    // Skip malformed lines
+                }
+            }
+            return entries;
+        }
+        catch {
+            // File read error, try next candidate
+        }
+    }
+    return [];
+}
+/**
+ * Decision Log 전체 조회 (최근 N개)
+ *
+ * @param workspaceRoot - 프로젝트 루트 경로
+ * @param limit - 최대 반환 개수 (기본 100)
+ * @returns Decision 엔트리 배열 (최신순)
+ */
+export function readRecentDecisions(workspaceRoot, limit = 100) {
+    const candidates = getDecisionLogPaths(workspaceRoot);
+    for (const logPath of candidates) {
+        if (!fs.existsSync(logPath))
+            continue;
+        try {
+            const entries = [];
+            const content = fs.readFileSync(logPath, "utf-8");
+            for (const line of content.split("\n")) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const entry = JSON.parse(line);
+                    entries.push(entry);
+                }
+                catch {
+                    // Skip malformed lines
+                }
+            }
+            // 최신순 정렬 후 limit 적용
+            return entries
+                .sort((a, b) => b.ts.localeCompare(a.ts))
+                .slice(0, limit);
+        }
+        catch {
+            // File read error, try next candidate
+        }
+    }
+    return [];
+}
+/**
+ * Decision evidence 존재 여부 확인
+ *
+ * @param workspaceRoot - 프로젝트 루트 경로
+ * @param runId - 확인할 run_id
+ * @returns true면 해당 run_id에 대한 decision이 존재
+ */
+export function hasDecisionEvidence(workspaceRoot, runId) {
+    return readDecisionLog(workspaceRoot, runId).length > 0;
+}
+/**
+ * Decision Log 파일 경로 조회
+ *
+ * @param workspaceRoot - 프로젝트 루트 경로
+ * @returns 존재하는 decision log 파일 경로 (없으면 null)
+ */
+export function findDecisionLogPath(workspaceRoot) {
+    const candidates = getDecisionLogPaths(workspaceRoot);
+    for (const logPath of candidates) {
+        if (fs.existsSync(logPath)) {
+            return logPath;
+        }
+    }
+    return null;
+}

package/build/deep-link.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Deep Link Utilities
+ *
+ * IDE 연동을 위한 Deep Link 생성 및 터미널 하이퍼링크 출력
+ *
+ * 지원:
+ * - VS Code (vscode://file/...)
+ * - JetBrains (jetbrains://...)
+ * - OSC 8 터미널 하이퍼링크
+ */
+import type { ViolationType } from "./correction-messages.js";
+export interface ViolationLink {
+    /** 위반 유형 */
+    type: ViolationType;
+    /** 심각도 */
+    severity: "BLOCK" | "FIX" | "WARN";
+    /** 표시 제목 */
+    title: string;
+    /** 파일 경로 */
+    path: string;
+    /** 라인 번호 */
+    line?: number;
+    /** 컬럼 번호 */
+    column?: number;
+    /** Deep Link URL */
+    deepLink: string;
+}
+/**
+ * VS Code Deep Link 생성
+ *
+ * @example
+ * createVscodeLink('/project/src/auth/config.ts', 42, 10)
+ * // => 'vscode://file//project/src/auth/config.ts:42:10'
+ */
+export declare function createVscodeLink(filePath: string, line?: number, column?: number): string;
+/**
+ * JetBrains IDE Deep Link 생성
+ * IntelliJ IDEA, WebStorm, PyCharm 등 지원
+ */
+export declare function createJetBrainsLink(filePath: string, line?: number, column?: number): string;
+/**
+ * OSC 8 터미널 하이퍼링크 렌더링
+ *
+ * 클릭 가능한 링크를 터미널에 출력합니다.
+ * 지원 터미널: iTerm2, Windows Terminal, GNOME Terminal, Kitty, etc.
+ *
+ * @example
+ * renderTerminalLink('Click here', 'https://example.com')
+ * // 터미널에서 'Click here'를 클릭하면 URL 열림
+ */
+export declare function renderTerminalLink(text: string, url: string): string;
+/**
+ * 링크 없이 일반 텍스트로 반환 (비지원 터미널용)
+ */
+export declare function renderPlainLink(text: string, url: string): string;
+/**
+ * 터미널이 OSC 8을 지원하는지 확인
+ * 환경 변수 기반 추론
+ */
+export declare function supportsOsc8(): boolean;
+/**
+ * 위반 사항 목록을 터미널에 클릭 가능한 링크로 출력
+ *
+ * @example
+ * renderViolationLinks(violations, '/project')
+ * // 터미널 출력:
+ * // 위반 구역 긴급 출동 (Click to Open):
+ * //  - 금지 구역 수정 시도: src/auth/config.ts (클릭)
+ */
+export declare function renderViolationLinks(violations: Array<{
+    type: ViolationType;
+    severity: "BLOCK" | "FIX" | "WARN";
+    title: string;
+    path: string;
+    line?: number;
+    column?: number;
+}>, projectRoot: string): void;
+/**
+ * 위반 사항을 ViolationLink 객체 배열로 변환
+ */
+export declare function buildViolationLinks(violations: Array<{
+    type: ViolationType;
+    severity: "BLOCK" | "FIX" | "WARN";
+    title: string;
+    path: string;
+    line?: number;
+    column?: number;
+}>, projectRoot: string): ViolationLink[];
+/**
+ * 검수 결과 요약 링크 생성
+ * Evidence Report 파일로 바로 이동
+ */
+export declare function createReportLink(reportPath: string): string;
+/**
+ * 요약 메시지 출력 (검수 완료 후)
+ */
+export declare function renderSummaryWithLink(verdict: "GO" | "FIX" | "BLOCK", reportPath: string, violationCount: number): void;