@vibecodetown/mcp-server 1.3.1

package/build/db_sync/config.js

@@ -0,0 +1,153 @@
+/**
+ * db_sync/config.ts
+ *
+ * PostgreSQL Secondary Truth Layer - Configuration
+ *
+ * @description
+ * 환경변수에서 DB 동기화 설정을 읽어옵니다.
+ * Rail은 바이너리/엔트리포인트에서 고정되어야 합니다 (env로 런타임 변경 금지).
+ *
+ * @see docs/DEV_SPEC/active/postgresql-secondary-truth/CONTRACT.md
+ */
+import { DB_SYNC_ENV, DEFAULT_POOL_CONFIG, isRail, } from "./types.js";
+// =============================================================================
+// Configuration Getters
+// =============================================================================
+/**
+ * DB 동기화 활성화 여부
+ *
+ * @returns VIBE_DB_SYNC_ENABLED=1이고 VIBE_DB_URL이 설정된 경우 true
+ */
+export function isDbSyncEnabled() {
+    const enabled = process.env[DB_SYNC_ENV.ENABLED];
+    const dbUrl = process.env[DB_SYNC_ENV.URL];
+    return enabled === "1" && typeof dbUrl === "string" && dbUrl.length > 0;
+}
+/**
+ * DB 동기화 설정 조회
+ *
+ * @param defaultRail 기본 레일 (엔트리포인트에서 고정)
+ * @returns DbConfig 객체
+ *
+ * @example
+ * // vibe-ci.ts에서
+ * const config = getDbConfig('local');
+ *
+ * // MCP router에서
+ * const config = getDbConfig('mcp');
+ */
+export function getDbConfig(defaultRail) {
+    // Rail은 환경변수보다 인자 우선 (P0-1: 바이너리 고정 원칙)
+    const envRail = process.env[DB_SYNC_ENV.RAIL];
+    const rail = isRail(envRail) ? envRail : defaultRail;
+    const dbUrl = process.env[DB_SYNC_ENV.URL];
+    const workspaceId = process.env[DB_SYNC_ENV.WORKSPACE_ID];
+    const enabledEnv = process.env[DB_SYNC_ENV.ENABLED];
+    return {
+        rail,
+        dbUrl: dbUrl || undefined,
+        workspaceId: workspaceId || undefined,
+        enabled: enabledEnv === "1" && !!dbUrl,
+    };
+}
+/**
+ * 커넥션 풀 설정 조회
+ *
+ * @returns PoolConfig 객체
+ */
+export function getPoolConfig() {
+    const maxEnv = process.env[DB_SYNC_ENV.POOL_MAX];
+    const idleEnv = process.env[DB_SYNC_ENV.POOL_IDLE_TIMEOUT];
+    const connectEnv = process.env[DB_SYNC_ENV.POOL_CONNECT_TIMEOUT];
+    return {
+        max: parseIntWithDefault(maxEnv, DEFAULT_POOL_CONFIG.max),
+        idleTimeoutMillis: parseIntWithDefault(idleEnv, DEFAULT_POOL_CONFIG.idleTimeoutMillis),
+        connectionTimeoutMillis: parseIntWithDefault(connectEnv, DEFAULT_POOL_CONFIG.connectionTimeoutMillis),
+    };
+}
+/**
+ * PostgreSQL 접속 URL 조회
+ *
+ * @returns DB URL 또는 undefined
+ */
+export function getDbUrl() {
+    const url = process.env[DB_SYNC_ENV.URL];
+    return url && url.length > 0 ? url : undefined;
+}
+/**
+ * 명시적 workspace_id 조회
+ *
+ * @returns workspace_id 또는 undefined (자동 생성 필요)
+ */
+export function getExplicitWorkspaceId() {
+    const wsId = process.env[DB_SYNC_ENV.WORKSPACE_ID];
+    return wsId && wsId.length > 0 ? wsId : undefined;
+}
+// =============================================================================
+// Validation
+// =============================================================================
+/**
+ * DB 설정 유효성 검사
+ *
+ * @param config DbConfig
+ * @throws Error if configuration is invalid
+ */
+export function validateDbConfig(config) {
+    if (config.enabled && !config.dbUrl) {
+        throw new Error(`[db_sync] VIBE_DB_SYNC_ENABLED=1 but VIBE_DB_URL is not set`);
+    }
+    if (config.dbUrl && !config.dbUrl.startsWith("postgresql://")) {
+        throw new Error(`[db_sync] VIBE_DB_URL must start with postgresql://`);
+    }
+}
+/**
+ * Rail 일치 여부 검사 (엔트리포인트 고정 원칙)
+ *
+ * @param expected 기대하는 rail (바이너리에서 고정)
+ * @param actual 실제 rail (환경변수 또는 인자)
+ * @throws Error if rails don't match
+ *
+ * @description
+ * P0-1: Rail은 바이너리/엔트리포인트에서 고정되어야 합니다.
+ * vibe-ci.ts는 항상 'local', MCP router는 항상 'mcp'.
+ */
+export function assertRailMatch(expected, actual) {
+    if (expected !== actual) {
+        throw new Error(`[db_sync] Rail mismatch: expected=${expected}, actual=${actual}. ` +
+            `Rail must be fixed at binary/entrypoint level.`);
+    }
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * 정수 파싱 (기본값 지원)
+ */
+function parseIntWithDefault(value, defaultValue) {
+    if (!value)
+        return defaultValue;
+    const parsed = parseInt(value, 10);
+    return isNaN(parsed) ? defaultValue : parsed;
+}
+// =============================================================================
+// Debug
+// =============================================================================
+/**
+ * 현재 DB 동기화 설정을 로그 형식으로 반환
+ *
+ * @param rail 레일
+ * @returns 디버그 문자열
+ */
+export function getDbConfigSummary(rail) {
+    const config = getDbConfig(rail);
+    const masked = config.dbUrl
+        ? config.dbUrl.replace(/\/\/[^@]+@/, "//***@")
+        : "(not set)";
+    return [
+        `[db_sync] Configuration:`,
+        `  rail: ${config.rail}`,
+        `  enabled: ${config.enabled}`,
+        `  dbUrl: ${masked}`,
+        `  workspaceId: ${config.workspaceId || "(auto)"}`,
+    ].join("\n");
+}

package/build/db_sync/index.d.ts

@@ -0,0 +1,86 @@
+/**
+ * db_sync/index.ts
+ *
+ * PostgreSQL Secondary Truth Layer - Main Module
+ *
+ * @description
+ * Filesystem SSOT의 파생 데이터를 PostgreSQL에 동기화합니다.
+ * 2-Rail 아키텍처: local (CI) / mcp (서버)
+ *
+ * @example
+ * // CI (vibe-ci.ts)
+ * await syncLocalRun({
+ *   rail: 'local',
+ *   workspaceId: 'ws_abc123',
+ *   runId: 'r_20260202_041512_abc123',
+ *   runDir: '/path/to/runs/r_20260202_041512_abc123',
+ * });
+ *
+ * // MCP (vibe_pm router)
+ * await syncMcpToolResult({
+ *   rail: 'mcp',
+ *   workspaceId: 'ws_abc123',
+ *   runId: 'my_project_20260202041512',
+ *   toolKind: 'inspect_code',
+ *   result: toolResult,
+ * });
+ *
+ * @see docs/DEV_SPEC/active/postgresql-secondary-truth/CONTRACT.md
+ */
+export type { Rail, Verdict, Severity, SsotRunKey, SsotRunInput, FileIndexInput, FileEntry, EventInput, GateVerdictInput, RunCardInput, ArtifactInput, PublicRunInput, DbConfig, PoolConfig, SyncLocalRunOptions, SyncMcpToolResultOptions, SyncResult, ParsedIngress, ParsedMapping, ParsedGate, ParsedBitnet, } from "./types.js";
+export { DB_SYNC_ENV, DEFAULT_POOL_CONFIG, isRail, isVerdict, isSeverity, isSsotRunKey } from "./types.js";
+export { isDbSyncEnabled, getDbConfig, getPoolConfig, getDbUrl, getExplicitWorkspaceId, validateDbConfig, assertRailMatch, getDbConfigSummary, } from "./config.js";
+export type { PoolLike, ClientLike } from "./pool.js";
+export { getPool, closePool, closeAllPools, assertDbRail, acquireRunLock, tryAcquireRunLock, withTransaction, withLockedTransaction, checkPoolHealth, } from "./pool.js";
+export { SCAN_WHITELIST, scanRunDirectory, computeContentHash, computeSnapshotHash, determineFileTags, generateWorkspaceId, toLogicalPath, getGitInfo, runDirectoryExists, evidenceFileExists, } from "./scanner.js";
+export { upsertRun, upsertFileIndex, upsertFileIndexBatch, insertEvent, upsertGateVerdict, upsertRunCard, upsertArtifact, upsertPublicRun, syncPublicRun, deleteRun, cleanupOldRuns, } from "./writer.js";
+export { parseIngressSummary, parseChangeMap, parseGateReport, parseBitnetTrace, parseEvidenceFile, parseAllEvidence, } from "./parsers/index.js";
+export { buildRunCardFromDb, buildRunCardFromFiles, buildArtifactsFromFiles, rebuildAllRunCards, } from "./read_model.js";
+export type { PublishOptions, PublishResult, PublishEligibility, } from "./publish.js";
+export { checkPublishEligibility, publishRun, unpublishRun, listPublishedRuns, autoPublishGoRuns, } from "./publish.js";
+import type { SyncLocalRunOptions, SyncMcpToolResultOptions, SyncResult } from "./types.js";
+/**
+ * Local Rail 동기화 (CI용)
+ *
+ * @param opts sync 옵션
+ * @returns SyncResult
+ *
+ * @description
+ * CI (vibe-ci.ts) verdict 결정 후, exit 전에 호출.
+ * 1회 full flush, 결정적(deterministic).
+ *
+ * @example
+ * // vibe-ci.ts
+ * if (process.env.VIBE_DB_URL) {
+ *   await syncLocalRun({
+ *     rail: 'local',
+ *     workspaceId: getWorkspaceId(),
+ *     runId: runId,
+ *     runDir: runDir,
+ *   });
+ * }
+ */
+export declare function syncLocalRun(opts: SyncLocalRunOptions): Promise<SyncResult>;
+/**
+ * MCP Rail 동기화 (서버용)
+ *
+ * @param opts sync 옵션
+ * @returns SyncResult
+ *
+ * @description
+ * MCP tool 호출 성공 시 호출.
+ * Increment 방식, 호출마다 부분 갱신.
+ *
+ * @example
+ * // vibe_pm router
+ * if (result && !isError(result)) {
+ *   await syncMcpToolResult({
+ *     rail: 'mcp',
+ *     workspaceId: context.workspaceId,
+ *     runId: extractRunId(result),
+ *     toolKind: context.toolName,
+ *     result: result,
+ *   });
+ * }
+ */
+export declare function syncMcpToolResult(opts: SyncMcpToolResultOptions): Promise<SyncResult>;

package/build/db_sync/index.js

@@ -0,0 +1,294 @@
+/**
+ * db_sync/index.ts
+ *
+ * PostgreSQL Secondary Truth Layer - Main Module
+ *
+ * @description
+ * Filesystem SSOT의 파생 데이터를 PostgreSQL에 동기화합니다.
+ * 2-Rail 아키텍처: local (CI) / mcp (서버)
+ *
+ * @example
+ * // CI (vibe-ci.ts)
+ * await syncLocalRun({
+ *   rail: 'local',
+ *   workspaceId: 'ws_abc123',
+ *   runId: 'r_20260202_041512_abc123',
+ *   runDir: '/path/to/runs/r_20260202_041512_abc123',
+ * });
+ *
+ * // MCP (vibe_pm router)
+ * await syncMcpToolResult({
+ *   rail: 'mcp',
+ *   workspaceId: 'ws_abc123',
+ *   runId: 'my_project_20260202041512',
+ *   toolKind: 'inspect_code',
+ *   result: toolResult,
+ * });
+ *
+ * @see docs/DEV_SPEC/active/postgresql-secondary-truth/CONTRACT.md
+ */
+export { DB_SYNC_ENV, DEFAULT_POOL_CONFIG, isRail, isVerdict, isSeverity, isSsotRunKey } from "./types.js";
+// =============================================================================
+// Config Exports
+// =============================================================================
+export { isDbSyncEnabled, getDbConfig, getPoolConfig, getDbUrl, getExplicitWorkspaceId, validateDbConfig, assertRailMatch, getDbConfigSummary, } from "./config.js";
+export { getPool, closePool, closeAllPools, assertDbRail, acquireRunLock, tryAcquireRunLock, withTransaction, withLockedTransaction, checkPoolHealth, } from "./pool.js";
+// =============================================================================
+// Scanner Exports
+// =============================================================================
+export { SCAN_WHITELIST, scanRunDirectory, computeContentHash, computeSnapshotHash, determineFileTags, generateWorkspaceId, toLogicalPath, getGitInfo, runDirectoryExists, evidenceFileExists, } from "./scanner.js";
+// =============================================================================
+// Writer Exports
+// =============================================================================
+export { upsertRun, upsertFileIndex, upsertFileIndexBatch, insertEvent, upsertGateVerdict, upsertRunCard, upsertArtifact, upsertPublicRun, syncPublicRun, deleteRun, cleanupOldRuns, } from "./writer.js";
+// =============================================================================
+// Parser Exports
+// =============================================================================
+export { parseIngressSummary, parseChangeMap, parseGateReport, parseBitnetTrace, parseEvidenceFile, parseAllEvidence, } from "./parsers/index.js";
+// =============================================================================
+// Read Model Exports
+// =============================================================================
+export { buildRunCardFromDb, buildRunCardFromFiles, buildArtifactsFromFiles, rebuildAllRunCards, } from "./read_model.js";
+export { checkPublishEligibility, publishRun, unpublishRun, listPublishedRuns, autoPublishGoRuns, } from "./publish.js";
+import { isDbSyncEnabled, getDbConfig } from "./config.js";
+import { getPool, withLockedTransaction } from "./pool.js";
+import { scanRunDirectory, computeSnapshotHash, toLogicalPath, getGitInfo, } from "./scanner.js";
+import { upsertRun, upsertFileIndexBatch, insertEvent, upsertGateVerdict } from "./writer.js";
+import { buildRunCardFromFiles, buildArtifactsFromFiles } from "./read_model.js";
+import { parseGateReport } from "./parsers/index.js";
+/**
+ * Local Rail 동기화 (CI용)
+ *
+ * @param opts sync 옵션
+ * @returns SyncResult
+ *
+ * @description
+ * CI (vibe-ci.ts) verdict 결정 후, exit 전에 호출.
+ * 1회 full flush, 결정적(deterministic).
+ *
+ * @example
+ * // vibe-ci.ts
+ * if (process.env.VIBE_DB_URL) {
+ *   await syncLocalRun({
+ *     rail: 'local',
+ *     workspaceId: getWorkspaceId(),
+ *     runId: runId,
+ *     runDir: runDir,
+ *   });
+ * }
+ */
+export async function syncLocalRun(opts) {
+    // sync 비활성화 시 skip
+    if (!isDbSyncEnabled()) {
+        return { success: true, filesIndexed: 0, eventsLogged: 0 };
+    }
+    const config = getDbConfig("local");
+    try {
+        const pool = await getPool("local");
+        // lock key: rail|workspace_id|run_id
+        const lockKey = `${opts.rail}|${opts.workspaceId}|${opts.runId}`;
+        return await withLockedTransaction(pool, lockKey, async (client) => {
+            // 1. 파일 스캔
+            const files = await scanRunDirectory(opts.runDir);
+            const snapshotHash = computeSnapshotHash(files);
+            // 2. Git 정보
+            const gitInfo = getGitInfo(opts.runDir);
+            // 3. ssot.run upsert
+            await upsertRun(client, {
+                rail: "local",
+                workspace_id: opts.workspaceId,
+                run_id: opts.runId,
+                branch: gitInfo?.branch ?? null,
+                commit_sha: gitInfo?.commitSha ?? null,
+                run_dir: toLogicalPath(opts.runDir, opts.runDir), // 논리 경로
+                ingress_dir: "ingress",
+                mapping_dir: "mapping",
+                ci_dir: "ci",
+                snapshot_hash: snapshotHash,
+            });
+            // 4. ssot.file_index batch upsert
+            const fileInputs = files.map((f) => ({
+                rail: "local",
+                workspace_id: opts.workspaceId,
+                run_id: opts.runId,
+                logical_path: f.logical_path,
+                content_sha: f.content_sha,
+                bytes: f.bytes,
+                mtime: f.mtime,
+                content_type: f.content_type,
+                tags: f.tags,
+                json_cache: null,
+            }));
+            await upsertFileIndexBatch(client, fileInputs);
+            // 5. ssot.event (sync 이벤트)
+            await insertEvent(client, {
+                rail: "local",
+                workspace_id: opts.workspaceId,
+                run_id: opts.runId,
+                kind: "sync",
+                actor: "ci",
+                severity: "info",
+                payload: {
+                    files_count: files.length,
+                    snapshot_hash: snapshotHash,
+                },
+            });
+            // 6. ssot.gate_verdict (있으면)
+            const gateReport = parseGateReport(opts.runDir);
+            if (gateReport) {
+                await upsertGateVerdict(client, {
+                    rail: "local",
+                    workspace_id: opts.workspaceId,
+                    run_id: opts.runId,
+                    verdict: gateReport.verdict,
+                    reason: gateReport.issues.length > 0
+                        ? JSON.stringify(gateReport.issues[0])
+                        : null,
+                    evidence_path: gateReport.evidence_path,
+                });
+            }
+            // 7. rm.run_card 빌드
+            await buildRunCardFromFiles(client, {
+                rail: "local",
+                workspace_id: opts.workspaceId,
+                run_id: opts.runId,
+            }, opts.runDir, new Date());
+            // 8. rm.artifact 빌드
+            await buildArtifactsFromFiles(client, {
+                rail: "local",
+                workspace_id: opts.workspaceId,
+                run_id: opts.runId,
+            }, opts.runDir);
+            return {
+                success: true,
+                filesIndexed: files.length,
+                eventsLogged: 1,
+            };
+        });
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * MCP Rail 동기화 (서버용)
+ *
+ * @param opts sync 옵션
+ * @returns SyncResult
+ *
+ * @description
+ * MCP tool 호출 성공 시 호출.
+ * Increment 방식, 호출마다 부분 갱신.
+ *
+ * @example
+ * // vibe_pm router
+ * if (result && !isError(result)) {
+ *   await syncMcpToolResult({
+ *     rail: 'mcp',
+ *     workspaceId: context.workspaceId,
+ *     runId: extractRunId(result),
+ *     toolKind: context.toolName,
+ *     result: result,
+ *   });
+ * }
+ */
+export async function syncMcpToolResult(opts) {
+    // sync 비활성화 시 skip
+    if (!isDbSyncEnabled()) {
+        return { success: true, filesIndexed: 0, eventsLogged: 0 };
+    }
+    try {
+        const pool = await getPool("mcp");
+        // lock key: rail|workspace_id|run_id
+        const lockKey = `${opts.rail}|${opts.workspaceId}|${opts.runId}`;
+        return await withLockedTransaction(pool, lockKey, async (client) => {
+            // 1. run 존재 확인/생성
+            await ensureRunExists(client, opts);
+            // 2. ssot.event insert
+            await insertEvent(client, {
+                rail: "mcp",
+                workspace_id: opts.workspaceId,
+                run_id: opts.runId,
+                kind: opts.toolKind,
+                actor: "mcp",
+                severity: "info",
+                payload: sanitizeResult(opts.result),
+            });
+            // 3. verdict 갱신 (inspect_code인 경우)
+            if (opts.toolKind === "inspect_code" && isVerdictResult(opts.result)) {
+                await upsertGateVerdict(client, {
+                    rail: "mcp",
+                    workspace_id: opts.workspaceId,
+                    run_id: opts.runId,
+                    verdict: opts.result.verdict,
+                    reason: null,
+                    evidence_path: null,
+                });
+            }
+            // 4. run_card 재빌드
+            const { buildRunCardFromDb } = await import("./read_model.js");
+            await buildRunCardFromDb(client, {
+                rail: "mcp",
+                workspace_id: opts.workspaceId,
+                run_id: opts.runId,
+            });
+            return {
+                success: true,
+                filesIndexed: 0,
+                eventsLogged: 1,
+            };
+        });
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * run 존재 확인 (없으면 생성)
+ */
+async function ensureRunExists(client, opts) {
+    const result = await client.query(`SELECT 1 FROM ssot.run WHERE rail = $1 AND workspace_id = $2 AND run_id = $3`, ["mcp", opts.workspaceId, opts.runId]);
+    if (result.rows.length === 0) {
+        await upsertRun(client, {
+            rail: "mcp",
+            workspace_id: opts.workspaceId,
+            run_id: opts.runId,
+            run_dir: `.vibe/runs/${opts.runId}`,
+            snapshot_hash: "", // MCP는 파일 스캔 없이 이벤트만 기록
+        });
+    }
+}
+/**
+ * verdict 결과인지 확인
+ */
+function isVerdictResult(result) {
+    if (typeof result !== "object" || result === null)
+        return false;
+    const obj = result;
+    return (typeof obj.verdict === "string" &&
+        ["GO", "FIX", "BLOCK", "ERROR"].includes(obj.verdict));
+}
+/**
+ * 결과 객체 sanitize (크기 제한)
+ */
+function sanitizeResult(result) {
+    if (typeof result !== "object" || result === null) {
+        return { _raw: String(result) };
+    }
+    const json = JSON.stringify(result);
+    const MAX_SIZE = 64 * 1024; // 64KB
+    if (json.length <= MAX_SIZE) {
+        return result;
+    }
+    // 크기 초과 시 최소 정보만
+    return {
+        _truncated: true,
+        _original_size: json.length,
+    };
+}

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

@@ -0,0 +1,20 @@
+/**
+ * db_sync/parsers/bitnet.ts
+ *
+ * bitnet_trace.jsonl 파서
+ */
+/**
+ * bitnet_trace.jsonl 파싱 결과
+ */
+export interface ParsedBitnet {
+    signals: Record<string, unknown>[];
+    risk_level: string;
+    trace_count: number;
+}
+/**
+ * bitnet_trace.jsonl 파싱
+ *
+ * @param runDir run 디렉토리 경로
+ * @returns ParsedBitnet 또는 null (파일 없음)
+ */
+export declare function parseBitnetTrace(runDir: string): ParsedBitnet | null;

package/build/db_sync/parsers/bitnet.js

@@ -0,0 +1,61 @@
+/**
+ * db_sync/parsers/bitnet.ts
+ *
+ * bitnet_trace.jsonl 파서
+ */
+import * as fs from "fs";
+import * as path from "path";
+/**
+ * bitnet_trace.jsonl 파싱
+ *
+ * @param runDir run 디렉토리 경로
+ * @returns ParsedBitnet 또는 null (파일 없음)
+ */
+export function parseBitnetTrace(runDir) {
+    const filePath = path.join(runDir, "90_logs", "bitnet_trace.jsonl");
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const lines = content.split("\n").filter((line) => line.trim().length > 0);
+        const signals = [];
+        let maxRiskLevel = "low";
+        for (const line of lines) {
+            try {
+                const entry = JSON.parse(line);
+                signals.push(entry);
+                // risk_level 추출 및 최대값 갱신
+                const entryRisk = entry.risk_level ?? entry.risk ?? entry.severity;
+                if (typeof entryRisk === "string") {
+                    maxRiskLevel = compareRiskLevel(maxRiskLevel, entryRisk);
+                }
+            }
+            catch {
+                // 개별 라인 파싱 실패는 무시
+            }
+        }
+        return {
+            signals,
+            risk_level: maxRiskLevel,
+            trace_count: signals.length,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * risk level 비교 (높은 것 반환)
+ */
+function compareRiskLevel(current, incoming) {
+    const levels = {
+        low: 1,
+        medium: 2,
+        high: 3,
+        critical: 4,
+    };
+    const currentScore = levels[current.toLowerCase()] ?? 0;
+    const incomingScore = levels[incoming.toLowerCase()] ?? 0;
+    return incomingScore > currentScore ? incoming.toLowerCase() : current;
+}

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

@@ -0,0 +1,23 @@
+/**
+ * db_sync/parsers/gate.ts
+ *
+ * gate_report.json 파서
+ */
+import type { Verdict } from "../types.js";
+/**
+ * gate_report.json 파싱 결과
+ */
+export interface ParsedGate {
+    verdict: Verdict;
+    issues: Record<string, unknown>[];
+    risk_score: number;
+    evidence_path: string;
+    raw: Record<string, unknown>;
+}
+/**
+ * gate_report.json 파싱
+ *
+ * @param runDir run 디렉토리 경로
+ * @returns ParsedGate 또는 null (파일 없음)
+ */
+export declare function parseGateReport(runDir: string): ParsedGate | null;