@kiyeonjeon21/datacontext 0.3.1 → 0.3.3

package/docs/KNOWLEDGE_TYPES.md

@@ -0,0 +1,261 @@
+# Knowledge Types Guide
+
+> DataContext의 지식 유형 정리 및 사용 가이드
+
+## Overview
+
+DataContext는 4가지 유형의 지식을 관리합니다:
+
+| 유형 | 목적 | 자동 적용 | AI 참조 |
+|------|------|:--------:|:-------:|
+| **Table Description** | 테이블/컬럼 설명 | ❌ | ✅ |
+| **Business Glossary** | 용어 → SQL 번역 | ❌ | ✅ |
+| **Business Rule** | 자동 적용 필터 | ✅ | ✅ |
+| **Query Example** | 검증된 SQL 패턴 | ❌ | ✅ |
+
+---
+
+## 1. Table Description (테이블 설명)
+
+**목적:** 테이블과 컬럼의 비즈니스 의미 설명
+
+**사용 시점:** AI가 스키마를 이해할 때
+
+**예시:**
+```yaml
+table: users
+description: "고객 계정 정보를 저장하는 테이블"
+columns:
+  - name: status
+    description: "계정 상태 (0=비활성, 1=활성, 2=정지)"
+  - name: created_at
+    description: "계정 생성 일시"
+```
+
+**관리 방법:**
+- `datacontext harvest` - DB 코멘트에서 자동 수집
+- `datacontext describe` - 수동 추가/수정
+
+---
+
+## 2. Business Glossary (용어 사전) ⭐
+
+**목적:** 도메인 용어를 SQL 조건으로 번역
+
+**사용 시점:** AI가 자연어 쿼리를 SQL로 변환할 때
+
+**핵심 특징:**
+- **선택적 적용** - AI가 컨텍스트에 맞게 판단
+- **번역 도우미** - "활성 사용자"라고 하면 AI가 `status = 1` 사용
+- **동의어 지원** - "active user", "활성화된 사용자" 모두 같은 의미
+
+**예시:**
+```yaml
+term: "활성 사용자"
+synonyms: ["active user", "활성화된 사용자"]
+definition: "status 컬럼이 1인 사용자"
+sqlExpression: "status = 1"
+appliesTo:
+  tables: ["users"]
+category: status
+```
+
+**사용 시나리오:**
+```
+사용자: "활성 사용자 목록 보여줘"
+AI: SELECT * FROM users WHERE status = 1;  -- Glossary 참조
+```
+
+**관리 방법:**
+- `datacontext glossary add "활성 사용자" "status가 1인 사용자" --sql "status = 1"`
+- `datacontext glossary generate "활성=status 1, VIP=주문 10건 이상"`
+
+---
+
+## 3. Business Rule (비즈니스 룰) ⚠️
+
+**목적:** 모든 쿼리에 자동으로 적용되는 필터/제약
+
+**사용 시점:** 쿼리 실행 전 시스템이 자동 적용
+
+**핵심 특징:**
+- **강제 적용** - 사용자가 명시하지 않아도 항상 추가
+- **보안/무결성** - Soft delete, Tenant isolation 등
+- **우선순위** - 여러 룰이 있으면 priority 순으로 적용
+
+**예시:**
+```yaml
+name: "soft_delete_filter"
+description: "삭제된 레코드 제외 (deleted_at IS NULL)"
+condition: "deleted_at IS NULL"
+appliesTo:
+  tables: ["users", "orders", "products"]
+isActive: true
+priority: 100
+```
+
+**사용 시나리오:**
+```
+사용자: "SELECT * FROM users"
+시스템 적용 후: "SELECT * FROM users WHERE deleted_at IS NULL"
+```
+
+**관리 방법:**
+- VS Code: `DataContext: Add Business Rule`
+- CLI: 현재 미구현 (향후 추가)
+
+---
+
+## 4. Query Example (쿼리 예시)
+
+**목적:** 검증된 SQL 패턴 저장
+
+**사용 시점:** AI가 유사한 쿼리 생성 시 참조
+
+**예시:**
+```yaml
+intent: "최근 30일 주문 총액 조회"
+sql: |
+  SELECT 
+    user_id,
+    SUM(total_amount) as total_spent
+  FROM orders
+  WHERE created_at >= CURRENT_DATE - INTERVAL '30 days'
+  GROUP BY user_id
+tables: ["orders"]
+isVerified: true
+```
+
+**관리 방법:**
+- VS Code: `DataContext: Add Query Example`
+- 피드백에서 자동 생성 (성공한 쿼리)
+
+---
+
+## Glossary vs Rule: 언제 무엇을 사용?
+
+### Glossary 사용 (용어 번역)
+
+✅ 도메인 특화 용어가 있을 때
+✅ 사용자가 자연어로 요청할 때
+✅ 같은 개념에 여러 표현이 있을 때
+
+**예시:**
+- "활성 사용자", "VIP 고객", "최근 주문"
+- 마케팅 용어, 비즈니스 지표
+
+### Rule 사용 (자동 적용 필터)
+
+✅ 항상 적용해야 하는 조건
+✅ 보안/무결성 관련
+✅ 사용자가 잊어버려도 적용되어야 함
+
+**예시:**
+- Soft delete 필터 (`deleted_at IS NULL`)
+- Tenant isolation (`tenant_id = ?`)
+- 권한 기반 필터 (`is_public = true OR owner_id = ?`)
+
+---
+
+## 스케일 대응 전략
+
+### 테이블이 많아질 때
+
+1. **태그로 그룹화**
+   ```yaml
+   table: user_preferences
+   tags: ["user", "settings"]
+   ```
+
+2. **스키마별 분리**
+   ```
+   knowledge/
+   ├── public/     # public schema
+   ├── analytics/  # analytics schema
+   └── admin/      # admin schema
+   ```
+
+### DB가 여러 개일 때
+
+1. **DB별 Knowledge 분리**
+   ```
+   .datacontext/
+   ├── users-db/
+   │   └── knowledge.json
+   ├── orders-db/
+   │   └── knowledge.json
+   └── analytics-db/
+       └── knowledge.json
+   ```
+
+2. **Cross-DB Glossary**
+   ```yaml
+   term: "고객"
+   appliesTo:
+     databases:
+       - name: users-db
+         tables: ["users"]
+       - name: orders-db
+         tables: ["customers"]
+   ```
+
+### 용어가 많아질 때
+
+1. **카테고리 활용**
+   - `status`: 상태 관련 (활성, 비활성, 정지)
+   - `time`: 시간 관련 (최근, 이번달, 지난주)
+   - `money`: 금액 관련 (매출, 비용, 이익)
+   - `entity`: 엔티티 타입 (고객, 상품, 주문)
+   - `metric`: 지표 (전환율, 이탈률)
+
+2. **검색 및 자동완성**
+   ```bash
+   datacontext glossary search "사용자"
+   # → 활성 사용자, 신규 사용자, VIP 사용자, ...
+   ```
+
+---
+
+## 권장 워크플로우
+
+### 1단계: 기본 설정 (처음 연결 시)
+
+```bash
+# DB 메타데이터 수집
+datacontext harvest
+
+# 기본 Soft Delete 룰 추가 (해당되는 경우)
+# VS Code: DataContext: Add Business Rule
+```
+
+### 2단계: 도메인 용어 추가 (점진적)
+
+```bash
+# 자주 사용하는 용어부터
+datacontext glossary add "활성 사용자" "status가 1인 사용자" --sql "status = 1"
+datacontext glossary add "최근 주문" "30일 이내 주문" --sql "created_at > now() - interval '30 days'"
+
+# 또는 AI로 일괄 생성
+datacontext glossary generate "활성=status 1, VIP=order 10건 이상, 신규=created_at 7일 이내"
+```
+
+### 3단계: 사용하면서 개선
+
+```bash
+# 쿼리 피드백 기록 (자동)
+# 자주 수정되는 패턴 → Rule 또는 Glossary 추가
+
+# 성공한 쿼리 → Query Example로 저장
+```
+
+---
+
+## 요약
+
+| 질문 | 답 |
+|------|-----|
+| "AI가 용어를 이해하게 하고 싶다" | → **Glossary** |
+| "모든 쿼리에 조건을 자동 추가하고 싶다" | → **Rule** |
+| "테이블 의미를 설명하고 싶다" | → **Table Description** |
+| "좋은 쿼리 패턴을 저장하고 싶다" | → **Query Example** |
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kiyeonjeon21/datacontext",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "AI-native database context layer - Make AI understand your data better",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/scripts/create-sqlite-testdb.sh

@@ -0,0 +1,75 @@
+#!/bin/bash
+# Create SQLite test database with sample data
+
+set -e
+
+DB_PATH="${1:-./test-sqlite.db}"
+
+echo "Creating SQLite test database at: $DB_PATH"
+
+# Remove existing
+rm -f "$DB_PATH"
+
+# Create database and tables
+sqlite3 "$DB_PATH" << 'EOF'
+-- Users table
+CREATE TABLE users (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL,
+    email TEXT UNIQUE NOT NULL,
+    status INTEGER DEFAULT 1,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+    deleted_at DATETIME
+);
+
+-- Products table
+CREATE TABLE products (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    name TEXT NOT NULL,
+    price REAL NOT NULL,
+    inventory INTEGER DEFAULT 0,
+    category TEXT,
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Orders table
+CREATE TABLE orders (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    user_id INTEGER REFERENCES users(id),
+    product_id INTEGER REFERENCES products(id),
+    quantity INTEGER NOT NULL,
+    total_amount REAL NOT NULL,
+    status TEXT DEFAULT 'pending',
+    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Insert sample data
+INSERT INTO users (name, email, status) VALUES
+    ('Alice', 'alice@example.com', 1),
+    ('Bob', 'bob@example.com', 1),
+    ('Charlie', 'charlie@example.com', 0),
+    ('Diana', 'diana@example.com', 2);
+
+INSERT INTO products (name, price, inventory, category) VALUES
+    ('Laptop', 999.99, 50, 'electronics'),
+    ('Mouse', 29.99, 200, 'electronics'),
+    ('Keyboard', 79.99, 100, 'electronics'),
+    ('Desk Chair', 299.99, 30, 'furniture');
+
+INSERT INTO orders (user_id, product_id, quantity, total_amount, status) VALUES
+    (1, 1, 1, 999.99, 'delivered'),
+    (1, 2, 2, 59.98, 'delivered'),
+    (2, 3, 1, 79.99, 'shipped'),
+    (2, 4, 1, 299.99, 'pending');
+
+SELECT 'SQLite test database created!' as result;
+.tables
+EOF
+
+echo ""
+echo "Database created: $DB_PATH"
+echo ""
+echo "To start DataContext server:"
+echo "  npx @kiyeonjeon21/datacontext serve sqlite:$DB_PATH --port 3000"
+echo ""
+

package/scripts/test-databases.sh

@@ -0,0 +1,324 @@
+#!/bin/bash
+# Test Databases Setup Script
+# Uses Podman to run PostgreSQL, MySQL, and MariaDB for testing
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo -e "${GREEN}=== DataContext Database Test Environment ===${NC}"
+
+# Check if podman is available
+if ! command -v podman &> /dev/null; then
+    echo -e "${RED}Error: podman is not installed${NC}"
+    echo "Install with: brew install podman"
+    exit 1
+fi
+
+# Configuration
+POSTGRES_PORT=5433
+MYSQL_PORT=3307
+MARIADB_PORT=3308
+NETWORK_NAME="datacontext-test"
+
+# Create network if not exists
+podman network exists $NETWORK_NAME 2>/dev/null || podman network create $NETWORK_NAME
+
+# Function to start PostgreSQL
+start_postgres() {
+    echo -e "\n${YELLOW}Starting PostgreSQL...${NC}"
+    
+    # Stop if running
+    podman rm -f datacontext-postgres 2>/dev/null || true
+    
+    podman run -d \
+        --name datacontext-postgres \
+        --network $NETWORK_NAME \
+        -e POSTGRES_USER=postgres \
+        -e POSTGRES_PASSWORD=postgres \
+        -e POSTGRES_DB=datacontext_test \
+        -p $POSTGRES_PORT:5432 \
+        postgres:15-alpine
+    
+    echo -e "${GREEN}PostgreSQL started on port $POSTGRES_PORT${NC}"
+    echo "Connection: postgres://postgres:postgres@localhost:$POSTGRES_PORT/datacontext_test"
+}
+
+# Function to start MySQL
+start_mysql() {
+    echo -e "\n${YELLOW}Starting MySQL...${NC}"
+    
+    # Stop if running
+    podman rm -f datacontext-mysql 2>/dev/null || true
+    
+    podman run -d \
+        --name datacontext-mysql \
+        --network $NETWORK_NAME \
+        -e MYSQL_ROOT_PASSWORD=mysql \
+        -e MYSQL_DATABASE=datacontext_test \
+        -e MYSQL_USER=mysql \
+        -e MYSQL_PASSWORD=mysql \
+        -p $MYSQL_PORT:3306 \
+        mysql:8.0
+    
+    echo -e "${GREEN}MySQL started on port $MYSQL_PORT${NC}"
+    echo "Connection: mysql://mysql:mysql@localhost:$MYSQL_PORT/datacontext_test"
+}
+
+# Function to start MariaDB
+start_mariadb() {
+    echo -e "\n${YELLOW}Starting MariaDB...${NC}"
+    
+    # Stop if running
+    podman rm -f datacontext-mariadb 2>/dev/null || true
+    
+    podman run -d \
+        --name datacontext-mariadb \
+        --network $NETWORK_NAME \
+        -e MARIADB_ROOT_PASSWORD=mariadb \
+        -e MARIADB_DATABASE=datacontext_test \
+        -e MARIADB_USER=mariadb \
+        -e MARIADB_PASSWORD=mariadb \
+        -p $MARIADB_PORT:3306 \
+        mariadb:10.11
+    
+    echo -e "${GREEN}MariaDB started on port $MARIADB_PORT${NC}"
+    echo "Connection: mysql://mariadb:mariadb@localhost:$MARIADB_PORT/datacontext_test"
+}
+
+# Function to wait for DB
+wait_for_db() {
+    local name=$1
+    local port=$2
+    local max_attempts=30
+    local attempt=0
+    
+    echo -e "${YELLOW}Waiting for $name to be ready...${NC}"
+    
+    while [ $attempt -lt $max_attempts ]; do
+        if podman exec $name echo "SELECT 1" 2>/dev/null; then
+            echo -e "${GREEN}$name is ready!${NC}"
+            return 0
+        fi
+        attempt=$((attempt + 1))
+        sleep 1
+    done
+    
+    echo -e "${RED}$name failed to start${NC}"
+    return 1
+}
+
+# Function to create test data
+create_test_data() {
+    local db_type=$1
+    local container=$2
+    
+    echo -e "\n${YELLOW}Creating test data for $db_type...${NC}"
+    
+    case $db_type in
+        postgres)
+            podman exec -i $container psql -U postgres -d datacontext_test << 'EOF'
+-- Users table
+CREATE TABLE IF NOT EXISTS users (
+    id SERIAL PRIMARY KEY,
+    name VARCHAR(100) NOT NULL,
+    email VARCHAR(255) UNIQUE NOT NULL,
+    status INTEGER DEFAULT 1,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    deleted_at TIMESTAMP
+);
+
+COMMENT ON TABLE users IS 'User accounts table';
+COMMENT ON COLUMN users.status IS 'Account status: 0=inactive, 1=active, 2=suspended';
+
+-- Products table
+CREATE TABLE IF NOT EXISTS products (
+    id SERIAL PRIMARY KEY,
+    name VARCHAR(200) NOT NULL,
+    price DECIMAL(10,2) NOT NULL,
+    inventory INTEGER DEFAULT 0,
+    category VARCHAR(50),
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+COMMENT ON TABLE products IS 'Product catalog';
+
+-- Orders table
+CREATE TABLE IF NOT EXISTS orders (
+    id SERIAL PRIMARY KEY,
+    user_id INTEGER REFERENCES users(id),
+    product_id INTEGER REFERENCES products(id),
+    quantity INTEGER NOT NULL,
+    total_amount DECIMAL(10,2) NOT NULL,
+    status VARCHAR(20) DEFAULT 'pending',
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+COMMENT ON TABLE orders IS 'Customer orders';
+COMMENT ON COLUMN orders.status IS 'Order status: pending, paid, shipped, delivered, cancelled';
+
+-- Insert sample data
+INSERT INTO users (name, email, status) VALUES
+    ('Alice', 'alice@example.com', 1),
+    ('Bob', 'bob@example.com', 1),
+    ('Charlie', 'charlie@example.com', 0),
+    ('Diana', 'diana@example.com', 2)
+ON CONFLICT DO NOTHING;
+
+INSERT INTO products (name, price, inventory, category) VALUES
+    ('Laptop', 999.99, 50, 'electronics'),
+    ('Mouse', 29.99, 200, 'electronics'),
+    ('Keyboard', 79.99, 100, 'electronics'),
+    ('Desk Chair', 299.99, 30, 'furniture')
+ON CONFLICT DO NOTHING;
+
+INSERT INTO orders (user_id, product_id, quantity, total_amount, status) VALUES
+    (1, 1, 1, 999.99, 'delivered'),
+    (1, 2, 2, 59.98, 'delivered'),
+    (2, 3, 1, 79.99, 'shipped'),
+    (2, 4, 1, 299.99, 'pending')
+ON CONFLICT DO NOTHING;
+
+SELECT 'PostgreSQL test data created!' as result;
+EOF
+            ;;
+        
+        mysql)
+            sleep 10  # MySQL takes longer to start
+            podman exec -i $container mysql -umysql -pmysql datacontext_test << 'EOF'
+-- Users table
+CREATE TABLE IF NOT EXISTS users (
+    id INT AUTO_INCREMENT PRIMARY KEY,
+    name VARCHAR(100) NOT NULL,
+    email VARCHAR(255) UNIQUE NOT NULL,
+    status INT DEFAULT 1,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    deleted_at TIMESTAMP NULL
+) COMMENT='User accounts table';
+
+-- Products table  
+CREATE TABLE IF NOT EXISTS products (
+    id INT AUTO_INCREMENT PRIMARY KEY,
+    name VARCHAR(200) NOT NULL,
+    price DECIMAL(10,2) NOT NULL,
+    inventory INT DEFAULT 0,
+    category VARCHAR(50),
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+) COMMENT='Product catalog';
+
+-- Orders table
+CREATE TABLE IF NOT EXISTS orders (
+    id INT AUTO_INCREMENT PRIMARY KEY,
+    user_id INT,
+    product_id INT,
+    quantity INT NOT NULL,
+    total_amount DECIMAL(10,2) NOT NULL,
+    status VARCHAR(20) DEFAULT 'pending',
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (user_id) REFERENCES users(id),
+    FOREIGN KEY (product_id) REFERENCES products(id)
+) COMMENT='Customer orders';
+
+-- Insert sample data
+INSERT IGNORE INTO users (name, email, status) VALUES
+    ('Alice', 'alice@example.com', 1),
+    ('Bob', 'bob@example.com', 1),
+    ('Charlie', 'charlie@example.com', 0),
+    ('Diana', 'diana@example.com', 2);
+
+INSERT IGNORE INTO products (name, price, inventory, category) VALUES
+    ('Laptop', 999.99, 50, 'electronics'),
+    ('Mouse', 29.99, 200, 'electronics'),
+    ('Keyboard', 79.99, 100, 'electronics'),
+    ('Desk Chair', 299.99, 30, 'furniture');
+
+INSERT IGNORE INTO orders (user_id, product_id, quantity, total_amount, status) VALUES
+    (1, 1, 1, 999.99, 'delivered'),
+    (1, 2, 2, 59.98, 'delivered'),
+    (2, 3, 1, 79.99, 'shipped'),
+    (2, 4, 1, 299.99, 'pending');
+
+SELECT 'MySQL test data created!' as result;
+EOF
+            ;;
+    esac
+    
+    echo -e "${GREEN}Test data created for $db_type${NC}"
+}
+
+# Function to stop all
+stop_all() {
+    echo -e "\n${YELLOW}Stopping all test databases...${NC}"
+    podman rm -f datacontext-postgres datacontext-mysql datacontext-mariadb 2>/dev/null || true
+    echo -e "${GREEN}All databases stopped${NC}"
+}
+
+# Function to show status
+show_status() {
+    echo -e "\n${GREEN}=== Database Status ===${NC}"
+    podman ps --filter "name=datacontext-" --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"
+}
+
+# Function to show connection strings
+show_connections() {
+    echo -e "\n${GREEN}=== Connection Strings ===${NC}"
+    echo ""
+    echo -e "${YELLOW}PostgreSQL:${NC}"
+    echo "  postgres://postgres:postgres@localhost:$POSTGRES_PORT/datacontext_test"
+    echo ""
+    echo -e "${YELLOW}MySQL:${NC}"
+    echo "  mysql://mysql:mysql@localhost:$MYSQL_PORT/datacontext_test"
+    echo ""
+    echo -e "${YELLOW}MariaDB:${NC}"
+    echo "  mysql://mariadb:mariadb@localhost:$MARIADB_PORT/datacontext_test"
+    echo ""
+    echo -e "${GREEN}=== DataContext Commands ===${NC}"
+    echo ""
+    echo "# Start servers"
+    echo "npx @kiyeonjeon21/datacontext serve postgres://postgres:postgres@localhost:$POSTGRES_PORT/datacontext_test --port 3000"
+    echo "npx @kiyeonjeon21/datacontext serve mysql://mysql:mysql@localhost:$MYSQL_PORT/datacontext_test --port 3001"
+    echo ""
+}
+
+# Parse arguments
+case "${1:-start}" in
+    start)
+        start_postgres
+        start_mysql
+        sleep 15  # Wait for DBs to be ready
+        create_test_data postgres datacontext-postgres
+        create_test_data mysql datacontext-mysql
+        show_status
+        show_connections
+        ;;
+    postgres)
+        start_postgres
+        sleep 5
+        create_test_data postgres datacontext-postgres
+        show_connections
+        ;;
+    mysql)
+        start_mysql
+        sleep 15
+        create_test_data mysql datacontext-mysql
+        show_connections
+        ;;
+    stop)
+        stop_all
+        ;;
+    status)
+        show_status
+        show_connections
+        ;;
+    *)
+        echo "Usage: $0 {start|postgres|mysql|stop|status}"
+        exit 1
+        ;;
+esac
+
+echo -e "\n${GREEN}Done!${NC}"
+

package/src/adapters/sqlite.ts

@@ -11,6 +11,8 @@
  */
 
 import Database from 'better-sqlite3';
+import { existsSync, mkdirSync } from 'fs';
+import { dirname, resolve } from 'path';
 import type { DatabaseAdapter, QueryResult, ConnectionConfig } from './base.js';
 import type { SchemaInfo, TableInfo, ColumnInfo, IndexInfo, ForeignKeyInfo } from '../schema/types.js';
 import { hashSchema } from '../knowledge/schema-hash.js';
@@ -41,6 +43,20 @@ export class SQLiteAdapter implements DatabaseAdapter {
     }
 
     try {
+      // Resolve relative paths to absolute
+      let resolvedPath = this.filePath;
+      if (this.filePath !== ':memory:') {
+        resolvedPath = resolve(process.cwd(), this.filePath);
+        
+        // Ensure parent directory exists
+        const dir = dirname(resolvedPath);
+        if (!existsSync(dir)) {
+          mkdirSync(dir, { recursive: true });
+        }
+        
+        this.filePath = resolvedPath;
+      }
+      
       this.db = new Database(this.filePath, { readonly: false });
       // Enable foreign keys
       this.db.pragma('foreign_keys = ON');