PostgreSQL을 파일시스템으로 마운트하여 ACID 보장하는 TigerFS

Context

AI Agent의 상태 관리를 위한 공유 저장소 부족 문제 발생. 복잡한 API나 SDK 없이 표준 Unix 도구로 데이터에 접근하려는 요구 증가. 데이터베이스의 신뢰성과 파일시스템의 단순함 사이의 간극 존재.

Technical Solution

• PostgreSQL의 행(Row)과 파일시스템의 파일을 1:1로 매핑하는 가상 파일시스템 구조
• Linux 환경에서는 FUSE, macOS 환경에서는 NFS를 통해 데이터베이스를 디렉토리로 마운트하는 인터페이스 제공
• 파일 생성 및 수정을 데이터베이스 트랜잭션으로 처리하여 완전한 ACID 보장 및 동시성 제어
• 마크다운 문서 등 파일을 디렉토리 구조로 관리하며 원자적 쓰기와 자동 버전 관리를 수행하는 file-first 워크플로우 지원
• 파일시스템 경로의 필터와 정렬 조건을 SQL 쿼리로 변환하여 DB 데이터를 탐색하는 data-first 워크플로우 구현
• .build, .info, .export 등 특수 점 접두사 디렉토리를 통해 메타데이터와 내보내기 기능을 처리하는 설계

Key Takeaway

데이터베이스의 강력한 트랜잭션 모델을 파일시스템 인터페이스로 추상화하여 AI Agent와 개발자의 인터랙션 비용을 최소화하는 설계 전략.