@vibecodetown/mcp-server 1.3.1

package/build/db_sync/read_model.js

@@ -0,0 +1,254 @@
+/**
+ * db_sync/read_model.ts
+ *
+ * PostgreSQL Secondary Truth Layer - Read Model Builder
+ *
+ * @description
+ * ssot 데이터에서 rm (Read Model) 테이블을 빌드합니다.
+ * rm.* 테이블은 언제든 ssot.*에서 재생성 가능합니다.
+ *
+ * @see docs/DEV_SPEC/active/postgresql-secondary-truth/CONTRACT.md
+ */
+import { isVerdict } from "./types.js";
+import { upsertRunCard, upsertArtifact } from "./writer.js";
+import { parseAllEvidence, extractRiskScore, extractChangedFiles, extractChangedLines, extractTopRisks, } from "./parsers/index.js";
+// =============================================================================
+// Run Card Builder
+// =============================================================================
+/**
+ * rm.run_card 빌드 (DB 쿼리 기반)
+ *
+ * @param client DB client
+ * @param key run 키
+ *
+ * @description
+ * ssot 테이블에서 데이터를 집계하여 run_card를 빌드합니다.
+ * 이 함수는 DB에 데이터가 이미 있을 때 사용합니다.
+ */
+export async function buildRunCardFromDb(client, key) {
+    // ssot.run에서 기본 정보 조회
+    const runResult = await client.query(`SELECT created_at FROM ssot.run
+     WHERE rail = $1 AND workspace_id = $2 AND run_id = $3`, [key.rail, key.workspace_id, key.run_id]);
+    if (runResult.rows.length === 0) {
+        throw new Error(`[db_sync] Run not found: ${key.rail}/${key.workspace_id}/${key.run_id}`);
+    }
+    const createdAt = runResult.rows[0].created_at;
+    // ssot.event에서 last_event_at 조회
+    const eventResult = await client.query(`SELECT MAX(ts) as last_event_at FROM ssot.event
+     WHERE rail = $1 AND workspace_id = $2 AND run_id = $3`, [key.rail, key.workspace_id, key.run_id]);
+    const lastEventAt = eventResult.rows[0]?.last_event_at ?? null;
+    // ssot.gate_verdict에서 verdict, risk_score 조회
+    const verdictResult = await client.query(`SELECT verdict FROM ssot.gate_verdict
+     WHERE rail = $1 AND workspace_id = $2 AND run_id = $3`, [key.rail, key.workspace_id, key.run_id]);
+    const verdictRaw = verdictResult.rows[0]?.verdict;
+    const verdict = isVerdict(verdictRaw) ? verdictRaw : null;
+    // ssot.file_index에서 파일 수 조회
+    const fileResult = await client.query(`SELECT COUNT(*) as file_count FROM ssot.file_index
+     WHERE rail = $1 AND workspace_id = $2 AND run_id = $3`, [key.rail, key.workspace_id, key.run_id]);
+    const changedFiles = parseInt(fileResult.rows[0]?.file_count ?? "0", 10);
+    // ssot.event에서 top_risks 추출 (gate 이벤트의 payload)
+    const riskResult = await client.query(`SELECT payload FROM ssot.event
+     WHERE rail = $1 AND workspace_id = $2 AND run_id = $3
+       AND kind = 'gate'
+     ORDER BY ts DESC LIMIT 1`, [key.rail, key.workspace_id, key.run_id]);
+    const gatePayload = riskResult.rows[0]?.payload;
+    const riskScore = typeof gatePayload?.risk_score === "number"
+        ? gatePayload.risk_score
+        : null;
+    const topRisks = Array.isArray(gatePayload?.issues)
+        ? gatePayload.issues.slice(0, 5)
+        : null;
+    // run_card upsert
+    const card = {
+        ...key,
+        created_at: createdAt,
+        last_event_at: lastEventAt,
+        verdict,
+        risk_score: riskScore,
+        changed_files: changedFiles,
+        changed_lines: null, // DB에서는 lines 정보 없음 (파일 기반에서만 가능)
+        top_risks: topRisks,
+        next_actions: null,
+    };
+    await upsertRunCard(client, card);
+}
+/**
+ * rm.run_card 빌드 (파일 시스템 기반)
+ *
+ * @param client DB client
+ * @param key run 키
+ * @param runDir run 디렉토리 경로
+ * @param createdAt run 생성 시각
+ *
+ * @description
+ * 파일 시스템에서 직접 증거를 파싱하여 run_card를 빌드합니다.
+ * CI sync에서 주로 사용됩니다.
+ */
+export async function buildRunCardFromFiles(client, key, runDir, createdAt) {
+    // 증거 파싱
+    const evidence = parseAllEvidence(runDir);
+    // verdict 결정
+    const verdict = evidence.gate?.verdict ?? null;
+    // run_card 빌드
+    const card = {
+        ...key,
+        created_at: createdAt,
+        last_event_at: new Date(),
+        verdict,
+        risk_score: extractRiskScore(evidence),
+        changed_files: extractChangedFiles(evidence),
+        changed_lines: extractChangedLines(evidence),
+        top_risks: extractTopRisks(evidence),
+        next_actions: buildNextActions(evidence),
+    };
+    await upsertRunCard(client, card);
+}
+/**
+ * next_actions 빌드
+ */
+function buildNextActions(evidence) {
+    const actions = [];
+    // verdict에 따른 기본 액션
+    if (evidence.gate?.verdict === "FIX") {
+        actions.push({
+            action: "fix_issues",
+            description: "Fix the reported issues before proceeding",
+            priority: "high",
+        });
+    }
+    else if (evidence.gate?.verdict === "BLOCK") {
+        actions.push({
+            action: "review_required",
+            description: "Manual review required due to blocking issues",
+            priority: "critical",
+        });
+    }
+    else if (evidence.gate?.verdict === "GO") {
+        actions.push({
+            action: "ready_to_proceed",
+            description: "All checks passed, ready to proceed",
+            priority: "info",
+        });
+    }
+    // bitnet 위험 수준에 따른 액션
+    if (evidence.bitnet?.risk_level === "high" || evidence.bitnet?.risk_level === "critical") {
+        actions.push({
+            action: "bitnet_review",
+            description: `BitNet flagged ${evidence.bitnet.risk_level} risk level`,
+            priority: "high",
+        });
+    }
+    return actions.length > 0 ? actions : null;
+}
+// =============================================================================
+// Artifact Builder
+// =============================================================================
+/**
+ * rm.artifact 빌드 (증거 파일별)
+ *
+ * @param client DB client
+ * @param key run 키
+ * @param runDir run 디렉토리 경로
+ */
+export async function buildArtifactsFromFiles(client, key, runDir) {
+    const evidence = parseAllEvidence(runDir);
+    // ingress artifact
+    if (evidence.ingress) {
+        await upsertArtifact(client, {
+            ...key,
+            kind: "ingress_summary",
+            logical_path: "ingress/ingress_summary.json",
+            content_sha: "", // 파일 해시는 file_index에서 가져와야 함
+            summary: truncateSummary({
+                changed_files: evidence.ingress.changed_files,
+                staged_files: evidence.ingress.staged_files,
+                mode: evidence.ingress.mode,
+            }),
+        });
+    }
+    // mapping artifact
+    if (evidence.mapping) {
+        await upsertArtifact(client, {
+            ...key,
+            kind: "change_map",
+            logical_path: "mapping/change_map.v1.json",
+            content_sha: "",
+            summary: truncateSummary({
+                domains: evidence.mapping.domains,
+                risk_areas: evidence.mapping.risk_areas,
+                lines_changed: evidence.mapping.lines_changed,
+            }),
+        });
+    }
+    // gate artifact
+    if (evidence.gate) {
+        await upsertArtifact(client, {
+            ...key,
+            kind: "gate_report",
+            logical_path: "gate/gate_report.json",
+            content_sha: "",
+            summary: truncateSummary({
+                verdict: evidence.gate.verdict,
+                risk_score: evidence.gate.risk_score,
+                issue_count: evidence.gate.issues.length,
+            }),
+        });
+    }
+    // bitnet artifact
+    if (evidence.bitnet) {
+        await upsertArtifact(client, {
+            ...key,
+            kind: "bitnet_trace",
+            logical_path: "90_logs/bitnet_trace.jsonl",
+            content_sha: "",
+            summary: truncateSummary({
+                risk_level: evidence.bitnet.risk_level,
+                trace_count: evidence.bitnet.trace_count,
+            }),
+        });
+    }
+}
+/**
+ * summary 크기 제한 (P0-8: 16KB 상한)
+ */
+function truncateSummary(obj) {
+    const json = JSON.stringify(obj);
+    const MAX_SIZE = 16 * 1024; // 16KB
+    if (json.length <= MAX_SIZE) {
+        return obj;
+    }
+    // 크기 초과 시 최소 정보만 유지
+    return {
+        _truncated: true,
+        _original_size: json.length,
+    };
+}
+// =============================================================================
+// Rebuild Functions
+// =============================================================================
+/**
+ * 특정 workspace의 모든 run_card 재빌드
+ *
+ * @param client DB client
+ * @param rail 레일
+ * @param workspaceId workspace_id
+ * @returns 재빌드된 run 수
+ */
+export async function rebuildAllRunCards(client, rail, workspaceId) {
+    const result = await client.query(`SELECT run_id FROM ssot.run WHERE rail = $1 AND workspace_id = $2`, [rail, workspaceId]);
+    let count = 0;
+    for (const row of result.rows) {
+        try {
+            await buildRunCardFromDb(client, {
+                rail: rail,
+                workspace_id: workspaceId,
+                run_id: row.run_id,
+            });
+            count++;
+        }
+        catch {
+            // 개별 실패는 무시하고 계속
+        }
+    }
+    return count;
+}

package/build/db_sync/scanner.d.ts

@@ -0,0 +1,97 @@
+/**
+ * db_sync/scanner.ts
+ *
+ * PostgreSQL Secondary Truth Layer - File Scanner
+ *
+ * @description
+ * run 디렉토리의 증거 파일을 스캔하고 해시를 계산합니다.
+ * snapshot_hash는 내용 동일성만 반영합니다 (mtime 미포함, P0-4).
+ *
+ * @see docs/DEV_SPEC/active/postgresql-secondary-truth/CONTRACT.md
+ */
+import type { FileEntry } from "./types.js";
+/**
+ * 스캔 대상 경로 패턴 (whitelist)
+ */
+export declare const SCAN_WHITELIST: readonly ["ingress/**", "mapping/**", "ci/**", "gate/**", "90_logs/**"];
+/**
+ * run 디렉토리 스캔
+ *
+ * @param runDir run 디렉토리 절대 경로
+ * @param whitelist 스캔 대상 패턴 (기본값: SCAN_WHITELIST)
+ * @returns FileEntry 배열
+ *
+ * @example
+ * const files = await scanRunDirectory('/path/to/runs/r_20260202_041512_abc123');
+ */
+export declare function scanRunDirectory(runDir: string, whitelist?: readonly string[]): Promise<FileEntry[]>;
+/**
+ * 파일 콘텐츠 해시 계산 (SHA-256)
+ *
+ * @param content 파일 바이트
+ * @returns hex 인코딩된 SHA-256 해시
+ */
+export declare function computeContentHash(content: Buffer): string;
+/**
+ * snapshot_hash 계산
+ *
+ * @param files FileEntry 배열
+ * @returns hex 인코딩된 SHA-256 해시
+ *
+ * @description
+ * P0-4: mtime은 snapshot_hash 계산에 포함되지 않습니다.
+ * 내용 동일성(content identity)만 반영합니다.
+ *
+ * 정렬된 `${logical_path}|${bytes}|${content_sha}` 문자열의 해시
+ */
+export declare function computeSnapshotHash(files: FileEntry[]): string;
+/**
+ * 파일 태그 결정
+ *
+ * @param logicalPath 논리 경로
+ * @returns 태그 배열
+ */
+export declare function determineFileTags(logicalPath: string): string[];
+/**
+ * workspace_id 생성 (결정적)
+ *
+ * @param workspaceRoot 워크스페이스 루트 (논리 경로)
+ * @param repoRemoteUrl git remote URL (optional)
+ * @param defaultBranch 기본 브랜치 (optional)
+ * @returns ws_<sha256_12> 형식의 workspace_id
+ *
+ * @description
+ * P0-2: 결정적 workspace_id 생성
+ * 같은 입력에 대해 항상 같은 결과
+ */
+export declare function generateWorkspaceId(workspaceRoot: string, repoRemoteUrl?: string, defaultBranch?: string): string;
+/**
+ * 논리 경로 생성 (절대 경로 → 논리 경로)
+ *
+ * @param absolutePath 절대 경로
+ * @param workspaceRoot 워크스페이스 루트
+ * @returns 논리 경로
+ *
+ * @description
+ * DB에는 논리 경로만 저장 (절대 경로 금지)
+ */
+export declare function toLogicalPath(absolutePath: string, workspaceRoot: string): string;
+/**
+ * Git 정보 획득
+ *
+ * @param workspaceRoot 워크스페이스 루트
+ * @returns { branch, commitSha, remoteUrl } or null
+ */
+export declare function getGitInfo(workspaceRoot: string): {
+    branch: string | null;
+    commitSha: string | null;
+    remoteUrl: string | null;
+} | null;
+/**
+ * run 디렉토리 존재 확인
+ */
+export declare function runDirectoryExists(runDir: string): boolean;
+/**
+ * 특정 증거 파일 존재 확인
+ */
+export declare function evidenceFileExists(runDir: string, relativePath: string): boolean;

package/build/db_sync/scanner.js

@@ -0,0 +1,287 @@
+/**
+ * db_sync/scanner.ts
+ *
+ * PostgreSQL Secondary Truth Layer - File Scanner
+ *
+ * @description
+ * run 디렉토리의 증거 파일을 스캔하고 해시를 계산합니다.
+ * snapshot_hash는 내용 동일성만 반영합니다 (mtime 미포함, P0-4).
+ *
+ * @see docs/DEV_SPEC/active/postgresql-secondary-truth/CONTRACT.md
+ */
+import * as fs from "fs";
+import * as path from "path";
+import * as crypto from "crypto";
+// =============================================================================
+// Constants
+// =============================================================================
+/**
+ * 스캔 대상 경로 패턴 (whitelist)
+ */
+export const SCAN_WHITELIST = [
+    "ingress/**",
+    "mapping/**",
+    "ci/**",
+    "gate/**",
+    "90_logs/**",
+];
+/**
+ * 파일 태그 매핑
+ */
+const TAG_PATTERNS = [
+    { pattern: /^ingress\//, tags: ["ingress"] },
+    { pattern: /ingress_summary\.json$/, tags: ["ingress", "summary"] },
+    { pattern: /^mapping\//, tags: ["mapping"] },
+    { pattern: /change_map\.v1\.json$/, tags: ["mapping", "change_map"] },
+    { pattern: /^ci\//, tags: ["ci"] },
+    { pattern: /^gate\//, tags: ["gate"] },
+    { pattern: /gate_report\.json$/, tags: ["gate", "report"] },
+    { pattern: /^90_logs\//, tags: ["logs"] },
+    { pattern: /bitnet_trace\.jsonl$/, tags: ["logs", "bitnet"] },
+];
+/**
+ * Content-Type 매핑
+ */
+const CONTENT_TYPE_MAP = {
+    ".json": "application/json",
+    ".jsonl": "application/jsonl",
+    ".md": "text/markdown",
+    ".txt": "text/plain",
+    ".ts": "text/typescript",
+    ".js": "application/javascript",
+    ".yaml": "application/yaml",
+    ".yml": "application/yaml",
+};
+// =============================================================================
+// Main Scanner
+// =============================================================================
+/**
+ * run 디렉토리 스캔
+ *
+ * @param runDir run 디렉토리 절대 경로
+ * @param whitelist 스캔 대상 패턴 (기본값: SCAN_WHITELIST)
+ * @returns FileEntry 배열
+ *
+ * @example
+ * const files = await scanRunDirectory('/path/to/runs/r_20260202_041512_abc123');
+ */
+export async function scanRunDirectory(runDir, whitelist = SCAN_WHITELIST) {
+    const results = [];
+    // 각 whitelist 패턴에 대해 스캔
+    for (const pattern of whitelist) {
+        const baseDir = pattern.replace(/\/\*\*$/, "");
+        const targetDir = path.join(runDir, baseDir);
+        if (!fs.existsSync(targetDir)) {
+            continue;
+        }
+        const files = await scanDirectoryRecursive(targetDir, runDir);
+        results.push(...files);
+    }
+    return results;
+}
+/**
+ * 디렉토리 재귀 스캔
+ */
+async function scanDirectoryRecursive(dir, runDir) {
+    const results = [];
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            const subFiles = await scanDirectoryRecursive(fullPath, runDir);
+            results.push(...subFiles);
+        }
+        else if (entry.isFile()) {
+            const fileEntry = await processFile(fullPath, runDir);
+            if (fileEntry) {
+                results.push(fileEntry);
+            }
+        }
+    }
+    return results;
+}
+/**
+ * 단일 파일 처리
+ */
+async function processFile(fullPath, runDir) {
+    try {
+        const stat = fs.statSync(fullPath);
+        const content = fs.readFileSync(fullPath);
+        // 논리 경로 (runDir 기준 상대 경로)
+        const logicalPath = path.relative(runDir, fullPath).replace(/\\/g, "/");
+        // 콘텐츠 해시
+        const contentSha = computeContentHash(content);
+        // 확장자
+        const ext = path.extname(fullPath).toLowerCase();
+        // 태그 결정
+        const tags = determineFileTags(logicalPath);
+        return {
+            logical_path: logicalPath,
+            content_sha: contentSha,
+            bytes: stat.size,
+            mtime: stat.mtime, // 참고용 (snapshot_hash에는 미포함)
+            content_type: CONTENT_TYPE_MAP[ext] || null,
+            tags,
+        };
+    }
+    catch {
+        // 파일 읽기 실패 시 skip
+        return null;
+    }
+}
+// =============================================================================
+// Hash Functions
+// =============================================================================
+/**
+ * 파일 콘텐츠 해시 계산 (SHA-256)
+ *
+ * @param content 파일 바이트
+ * @returns hex 인코딩된 SHA-256 해시
+ */
+export function computeContentHash(content) {
+    return crypto.createHash("sha256").update(content).digest("hex");
+}
+/**
+ * snapshot_hash 계산
+ *
+ * @param files FileEntry 배열
+ * @returns hex 인코딩된 SHA-256 해시
+ *
+ * @description
+ * P0-4: mtime은 snapshot_hash 계산에 포함되지 않습니다.
+ * 내용 동일성(content identity)만 반영합니다.
+ *
+ * 정렬된 `${logical_path}|${bytes}|${content_sha}` 문자열의 해시
+ */
+export function computeSnapshotHash(files) {
+    const sorted = files
+        .map((f) => `${f.logical_path}|${f.bytes}|${f.content_sha}`)
+        .sort();
+    const combined = sorted.join("\n");
+    return crypto.createHash("sha256").update(combined).digest("hex");
+}
+// =============================================================================
+// Tag Functions
+// =============================================================================
+/**
+ * 파일 태그 결정
+ *
+ * @param logicalPath 논리 경로
+ * @returns 태그 배열
+ */
+export function determineFileTags(logicalPath) {
+    const tags = new Set();
+    for (const { pattern, tags: matchTags } of TAG_PATTERNS) {
+        if (pattern.test(logicalPath)) {
+            for (const tag of matchTags) {
+                tags.add(tag);
+            }
+        }
+    }
+    return Array.from(tags);
+}
+// =============================================================================
+// Workspace ID Generation (P0-2)
+// =============================================================================
+/**
+ * workspace_id 생성 (결정적)
+ *
+ * @param workspaceRoot 워크스페이스 루트 (논리 경로)
+ * @param repoRemoteUrl git remote URL (optional)
+ * @param defaultBranch 기본 브랜치 (optional)
+ * @returns ws_<sha256_12> 형식의 workspace_id
+ *
+ * @description
+ * P0-2: 결정적 workspace_id 생성
+ * 같은 입력에 대해 항상 같은 결과
+ */
+export function generateWorkspaceId(workspaceRoot, repoRemoteUrl, defaultBranch) {
+    const canonical = [
+        `root=${workspaceRoot}`,
+        `remote=${repoRemoteUrl ?? ""}`,
+        `branch=${defaultBranch ?? ""}`,
+    ].join("|");
+    const hash = crypto
+        .createHash("sha256")
+        .update(canonical)
+        .digest("hex")
+        .substring(0, 12);
+    return `ws_${hash}`;
+}
+/**
+ * 논리 경로 생성 (절대 경로 → 논리 경로)
+ *
+ * @param absolutePath 절대 경로
+ * @param workspaceRoot 워크스페이스 루트
+ * @returns 논리 경로
+ *
+ * @description
+ * DB에는 논리 경로만 저장 (절대 경로 금지)
+ */
+export function toLogicalPath(absolutePath, workspaceRoot) {
+    return path.relative(workspaceRoot, absolutePath).replace(/\\/g, "/");
+}
+// =============================================================================
+// Git Integration
+// =============================================================================
+/**
+ * Git 정보 획득
+ *
+ * @param workspaceRoot 워크스페이스 루트
+ * @returns { branch, commitSha, remoteUrl } or null
+ */
+export function getGitInfo(workspaceRoot) {
+    const gitDir = path.join(workspaceRoot, ".git");
+    if (!fs.existsSync(gitDir)) {
+        return null;
+    }
+    try {
+        // HEAD 읽기
+        const headPath = path.join(gitDir, "HEAD");
+        const headContent = fs.readFileSync(headPath, "utf-8").trim();
+        let branch = null;
+        let commitSha = null;
+        if (headContent.startsWith("ref: refs/heads/")) {
+            branch = headContent.replace("ref: refs/heads/", "");
+            // ref 파일에서 commit SHA 읽기
+            const refPath = path.join(gitDir, "refs", "heads", branch);
+            if (fs.existsSync(refPath)) {
+                commitSha = fs.readFileSync(refPath, "utf-8").trim();
+            }
+        }
+        else {
+            // detached HEAD
+            commitSha = headContent;
+        }
+        // remote origin URL 읽기
+        let remoteUrl = null;
+        const configPath = path.join(gitDir, "config");
+        if (fs.existsSync(configPath)) {
+            const configContent = fs.readFileSync(configPath, "utf-8");
+            const match = configContent.match(/\[remote "origin"\][^[]*url\s*=\s*(.+)/);
+            if (match) {
+                remoteUrl = match[1].trim();
+            }
+        }
+        return { branch, commitSha, remoteUrl };
+    }
+    catch {
+        return null;
+    }
+}
+// =============================================================================
+// Utilities
+// =============================================================================
+/**
+ * run 디렉토리 존재 확인
+ */
+export function runDirectoryExists(runDir) {
+    return fs.existsSync(runDir) && fs.statSync(runDir).isDirectory();
+}
+/**
+ * 특정 증거 파일 존재 확인
+ */
+export function evidenceFileExists(runDir, relativePath) {
+    const fullPath = path.join(runDir, relativePath);
+    return fs.existsSync(fullPath) && fs.statSync(fullPath).isFile();
+}