@vibecodetown/mcp-server 1.3.1

package/build/db_sync/types.d.ts

@@ -0,0 +1,254 @@
+/**
+ * db_sync/types.ts
+ *
+ * PostgreSQL Secondary Truth Layer - Type Definitions
+ *
+ * @description
+ * Filesystem SSOT의 파생 데이터를 PostgreSQL에 동기화하기 위한 타입 정의.
+ * 이 모듈은 2-Rail 아키텍처(local/mcp)를 지원합니다.
+ *
+ * @see docs/DEV_SPEC/active/postgresql-secondary-truth/CONTRACT.md
+ */
+/**
+ * 데이터가 생성된 실행 레일
+ * - local: CI/vibe-ci 환경 (vibe_local DB)
+ * - mcp: MCP 서버 환경 (vibe_srv DB)
+ */
+export type Rail = "local" | "mcp";
+/**
+ * 게이트 판정 결과
+ */
+export type Verdict = "GO" | "FIX" | "BLOCK" | "ERROR";
+/**
+ * 이벤트 심각도
+ */
+export type Severity = "info" | "warn" | "error";
+/**
+ * ssot.run 테이블의 복합 PK
+ */
+export interface SsotRunKey {
+    rail: Rail;
+    workspace_id: string;
+    run_id: string;
+}
+/**
+ * ssot.run 테이블 입력
+ */
+export interface SsotRunInput extends SsotRunKey {
+    branch?: string | null;
+    commit_sha?: string | null;
+    run_dir: string;
+    ingress_dir?: string | null;
+    mapping_dir?: string | null;
+    ci_dir?: string | null;
+    snapshot_hash: string;
+    created_at?: Date;
+    updated_at?: Date;
+}
+/**
+ * ssot.file_index 테이블 입력
+ */
+export interface FileIndexInput extends SsotRunKey {
+    logical_path: string;
+    content_sha: string;
+    bytes: number;
+    mtime?: Date | null;
+    content_type?: string | null;
+    tags: string[];
+    json_cache?: Record<string, unknown> | null;
+}
+/**
+ * ssot.event 테이블 입력
+ */
+export interface EventInput extends SsotRunKey {
+    ts?: Date;
+    kind: string;
+    actor: string;
+    severity?: Severity;
+    payload: Record<string, unknown>;
+}
+/**
+ * ssot.gate_verdict 테이블 입력
+ */
+export interface GateVerdictInput extends SsotRunKey {
+    verdict: Verdict;
+    reason?: string | null;
+    evidence_path?: string | null;
+    updated_at?: Date;
+}
+/**
+ * 파일 스캔 결과 (scanner.ts 출력)
+ *
+ * @description
+ * mtime은 DB에 저장되지만 snapshot_hash 계산에는 포함되지 않음 (P0-4)
+ */
+export interface FileEntry {
+    logical_path: string;
+    content_sha: string;
+    bytes: number;
+    mtime: Date | null;
+    content_type: string | null;
+    tags: string[];
+}
+/**
+ * rm.run_card 테이블 입력
+ */
+export interface RunCardInput extends SsotRunKey {
+    created_at: Date;
+    last_event_at?: Date | null;
+    verdict?: Verdict | null;
+    risk_score?: number | null;
+    changed_files?: number | null;
+    changed_lines?: number | null;
+    top_risks?: Record<string, unknown>[] | null;
+    next_actions?: Record<string, unknown>[] | null;
+}
+/**
+ * rm.artifact 테이블 입력
+ */
+export interface ArtifactInput extends SsotRunKey {
+    kind: string;
+    logical_path: string;
+    content_sha: string;
+    summary?: Record<string, unknown> | null;
+}
+/**
+ * pub.public_run 테이블 입력
+ */
+export interface PublicRunInput {
+    workspace_id: string;
+    run_id: string;
+    owner_org: string;
+    is_public: boolean;
+    created_at?: Date;
+    verdict?: Verdict | null;
+    risk_score?: number | null;
+    summary?: Record<string, unknown> | null;
+}
+/**
+ * DB 동기화 설정
+ */
+export interface DbConfig {
+    /** 실행 레일 */
+    rail: Rail;
+    /** PostgreSQL 접속 URL (없으면 sync 비활성화) */
+    dbUrl: string | undefined;
+    /** 명시적 workspace_id (없으면 자동 생성) */
+    workspaceId: string | undefined;
+    /** sync 활성화 여부 */
+    enabled: boolean;
+}
+/**
+ * 커넥션 풀 설정
+ */
+export interface PoolConfig {
+    /** 최대 커넥션 수 */
+    max: number;
+    /** 유휴 커넥션 타임아웃 (ms) */
+    idleTimeoutMillis: number;
+    /** 연결 타임아웃 (ms) */
+    connectionTimeoutMillis: number;
+}
+/**
+ * Local Rail 동기화 옵션 (CI용)
+ */
+export interface SyncLocalRunOptions {
+    rail: "local";
+    workspaceId: string;
+    runId: string;
+    runDir: string;
+}
+/**
+ * MCP Rail 동기화 옵션 (서버용)
+ */
+export interface SyncMcpToolResultOptions {
+    rail: "mcp";
+    workspaceId: string;
+    runId: string;
+    toolKind: string;
+    result: unknown;
+}
+/**
+ * 동기화 결과
+ */
+export interface SyncResult {
+    success: boolean;
+    filesIndexed?: number;
+    eventsLogged?: number;
+    error?: string;
+}
+/**
+ * ingress_summary.json 파싱 결과
+ */
+export interface ParsedIngress {
+    changed_files: number;
+    staged_files: number;
+    mode: string;
+    resolution?: string;
+    raw: Record<string, unknown>;
+}
+/**
+ * change_map.v1.json 파싱 결과
+ */
+export interface ParsedMapping {
+    domains: string[];
+    risk_areas: string[];
+    lines_changed: number;
+    raw: Record<string, unknown>;
+}
+/**
+ * gate_report.json 파싱 결과
+ */
+export interface ParsedGate {
+    verdict: Verdict;
+    issues: Record<string, unknown>[];
+    risk_score: number;
+    raw: Record<string, unknown>;
+}
+/**
+ * bitnet_trace.jsonl 파싱 결과
+ */
+export interface ParsedBitnet {
+    signals: Record<string, unknown>[];
+    risk_level: string;
+    trace_count: number;
+}
+/**
+ * 환경변수 이름 (SSOT)
+ */
+export declare const DB_SYNC_ENV: {
+    /** DB sync 활성화 (0|1) */
+    readonly ENABLED: "VIBE_DB_SYNC_ENABLED";
+    /** 레일 선택 (local|mcp) */
+    readonly RAIL: "VIBE_DB_RAIL";
+    /** PostgreSQL 접속 URL */
+    readonly URL: "VIBE_DB_URL";
+    /** 명시적 workspace_id */
+    readonly WORKSPACE_ID: "VIBE_DB_WORKSPACE_ID";
+    /** 풀 최대 커넥션 */
+    readonly POOL_MAX: "VIBE_DB_POOL_MAX";
+    /** 풀 유휴 타임아웃 */
+    readonly POOL_IDLE_TIMEOUT: "VIBE_DB_POOL_IDLE_TIMEOUT";
+    /** 풀 연결 타임아웃 */
+    readonly POOL_CONNECT_TIMEOUT: "VIBE_DB_POOL_CONNECT_TIMEOUT";
+};
+/**
+ * 기본 풀 설정
+ */
+export declare const DEFAULT_POOL_CONFIG: PoolConfig;
+/**
+ * Rail 타입 가드
+ */
+export declare function isRail(value: unknown): value is Rail;
+/**
+ * Verdict 타입 가드
+ */
+export declare function isVerdict(value: unknown): value is Verdict;
+/**
+ * Severity 타입 가드
+ */
+export declare function isSeverity(value: unknown): value is Severity;
+/**
+ * SsotRunKey 타입 가드
+ */
+export declare function isSsotRunKey(value: unknown): value is SsotRunKey;

package/build/db_sync/types.js

@@ -0,0 +1,76 @@
+/**
+ * db_sync/types.ts
+ *
+ * PostgreSQL Secondary Truth Layer - Type Definitions
+ *
+ * @description
+ * Filesystem SSOT의 파생 데이터를 PostgreSQL에 동기화하기 위한 타입 정의.
+ * 이 모듈은 2-Rail 아키텍처(local/mcp)를 지원합니다.
+ *
+ * @see docs/DEV_SPEC/active/postgresql-secondary-truth/CONTRACT.md
+ */
+// =============================================================================
+// Environment Variable Helpers
+// =============================================================================
+/**
+ * 환경변수 이름 (SSOT)
+ */
+export const DB_SYNC_ENV = {
+    /** DB sync 활성화 (0|1) */
+    ENABLED: "VIBE_DB_SYNC_ENABLED",
+    /** 레일 선택 (local|mcp) */
+    RAIL: "VIBE_DB_RAIL",
+    /** PostgreSQL 접속 URL */
+    URL: "VIBE_DB_URL",
+    /** 명시적 workspace_id */
+    WORKSPACE_ID: "VIBE_DB_WORKSPACE_ID",
+    /** 풀 최대 커넥션 */
+    POOL_MAX: "VIBE_DB_POOL_MAX",
+    /** 풀 유휴 타임아웃 */
+    POOL_IDLE_TIMEOUT: "VIBE_DB_POOL_IDLE_TIMEOUT",
+    /** 풀 연결 타임아웃 */
+    POOL_CONNECT_TIMEOUT: "VIBE_DB_POOL_CONNECT_TIMEOUT",
+};
+/**
+ * 기본 풀 설정
+ */
+export const DEFAULT_POOL_CONFIG = {
+    max: 10,
+    idleTimeoutMillis: 30000,
+    connectionTimeoutMillis: 2000,
+};
+// =============================================================================
+// Type Guards
+// =============================================================================
+/**
+ * Rail 타입 가드
+ */
+export function isRail(value) {
+    return value === "local" || value === "mcp";
+}
+/**
+ * Verdict 타입 가드
+ */
+export function isVerdict(value) {
+    return (value === "GO" ||
+        value === "FIX" ||
+        value === "BLOCK" ||
+        value === "ERROR");
+}
+/**
+ * Severity 타입 가드
+ */
+export function isSeverity(value) {
+    return value === "info" || value === "warn" || value === "error";
+}
+/**
+ * SsotRunKey 타입 가드
+ */
+export function isSsotRunKey(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const obj = value;
+    return (isRail(obj.rail) &&
+        typeof obj.workspace_id === "string" &&
+        typeof obj.run_id === "string");
+}

package/build/db_sync/writer.d.ts

@@ -0,0 +1,111 @@
+/**
+ * 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
+ */
+import type { ClientLike, PoolLike } from "./pool.js";
+import type { SsotRunInput, FileIndexInput, EventInput, GateVerdictInput, RunCardInput, ArtifactInput, PublicRunInput } from "./types.js";
+/**
+ * ssot.run upsert
+ *
+ * @param client DB client
+ * @param run run 데이터
+ *
+ * @description
+ * idempotent: 같은 (rail, workspace_id, run_id)로 여러 번 호출해도 1행만 존재
+ */
+export declare function upsertRun(client: ClientLike | PoolLike, run: SsotRunInput): Promise<void>;
+/**
+ * ssot.file_index upsert (단일 파일)
+ *
+ * @param client DB client
+ * @param file 파일 인덱스 데이터
+ */
+export declare function upsertFileIndex(client: ClientLike | PoolLike, file: FileIndexInput): Promise<void>;
+/**
+ * ssot.file_index batch upsert (여러 파일)
+ *
+ * @param client DB client
+ * @param files 파일 인덱스 배열
+ *
+ * @description
+ * 대량 파일에 대해 단일 트랜잭션으로 처리
+ */
+export declare function upsertFileIndexBatch(client: ClientLike | PoolLike, files: FileIndexInput[]): Promise<void>;
+/**
+ * ssot.event insert
+ *
+ * @param client DB client
+ * @param event 이벤트 데이터
+ * @returns event_id
+ *
+ * @description
+ * 이벤트는 append-only (upsert가 아닌 insert)
+ */
+export declare function insertEvent(client: ClientLike | PoolLike, event: EventInput): Promise<bigint>;
+/**
+ * ssot.gate_verdict upsert
+ *
+ * @param client DB client
+ * @param verdict verdict 데이터
+ */
+export declare function upsertGateVerdict(client: ClientLike | PoolLike, verdict: GateVerdictInput): Promise<void>;
+/**
+ * rm.run_card upsert
+ *
+ * @param client DB client
+ * @param card run card 데이터
+ */
+export declare function upsertRunCard(client: ClientLike | PoolLike, card: RunCardInput): Promise<void>;
+/**
+ * rm.artifact upsert
+ *
+ * @param client DB client
+ * @param artifact artifact 데이터
+ */
+export declare function upsertArtifact(client: ClientLike | PoolLike, artifact: ArtifactInput): Promise<void>;
+/**
+ * pub.public_run upsert
+ *
+ * @param client DB client
+ * @param publicRun public run 데이터
+ *
+ * @description
+ * MCP 서버에서만 사용. pub.sync_public_run() 함수 직접 호출 권장.
+ */
+export declare function upsertPublicRun(client: ClientLike | PoolLike, publicRun: PublicRunInput): Promise<void>;
+/**
+ * pub.sync_public_run 함수 호출
+ *
+ * @param client DB client
+ * @param workspaceId workspace_id
+ * @param runId run_id
+ * @param ownerOrg 테넌트 키
+ * @param isPublic 공개 여부
+ */
+export declare function syncPublicRun(client: ClientLike | PoolLike, workspaceId: string, runId: string, ownerOrg: string, isPublic: boolean): Promise<void>;
+/**
+ * run 삭제 (cascade로 관련 데이터 모두 삭제)
+ *
+ * @param client DB client
+ * @param rail 레일
+ * @param workspaceId workspace_id
+ * @param runId run_id
+ */
+export declare function deleteRun(client: ClientLike | PoolLike, rail: string, workspaceId: string, runId: string): Promise<void>;
+/**
+ * 특정 workspace의 오래된 run 정리
+ *
+ * @param client DB client
+ * @param rail 레일
+ * @param workspaceId workspace_id
+ * @param keepDays 유지할 일수
+ * @returns 삭제된 run 수
+ */
+export declare function cleanupOldRuns(client: ClientLike | PoolLike, rail: string, workspaceId: string, keepDays: number): Promise<number>;