memento-mcp-server 0.1.0

package/scripts/restore-legacy.ps1

@@ -0,0 +1,60 @@
+# Legacy 서버 복원 스크립트
+# 백업에서 Legacy 버전을 복원합니다
+Write-Host "🔄 Legacy 서버 복원 중..." -ForegroundColor Yellow
+
+# 백업 디렉토리 확인
+$backupDir = Get-ChildItem -Path "backup" -Directory | Where-Object { $_.Name -like "legacy-removal-*" } | Sort-Object LastWriteTime -Descending | Select-Object -First 1
+
+if (-not $backupDir) {
+    Write-Host "❌ Legacy 백업을 찾을 수 없습니다." -ForegroundColor Red
+    Write-Host "💡 backup/legacy-removal-* 디렉토리를 확인해주세요." -ForegroundColor Yellow
+    exit 1
+}
+
+Write-Host "📦 백업 디렉토리 발견: $($backupDir.Name)" -ForegroundColor Blue
+
+# 1. 현재 http-server.ts를 백업
+if (Test-Path "src/server/http-server.ts") {
+    Write-Host "📦 현재 서버를 백업 중..." -ForegroundColor Blue
+    $timestamp = Get-Date -Format "yyyyMMdd-HHmmss"
+    Copy-Item "src/server/http-server.ts" "src/server/http-server-backup-$timestamp.ts"
+    Write-Host "✅ 현재 서버 백업 완료: http-server-backup-$timestamp.ts" -ForegroundColor Green
+}
+
+# 2. Legacy 서버 복원
+if (Test-Path "$($backupDir.FullName)/http-server-legacy.ts") {
+    Write-Host "🔄 Legacy 서버 복원 중..." -ForegroundColor Blue
+    Copy-Item "$($backupDir.FullName)/http-server-legacy.ts" "src/server/http-server.ts"
+    Write-Host "✅ Legacy 서버 복원 완료" -ForegroundColor Green
+} else {
+    Write-Host "❌ Legacy 서버 파일을 찾을 수 없습니다." -ForegroundColor Red
+    exit 1
+}
+
+# 3. 빌드
+Write-Host "🔨 애플리케이션 빌드 중..." -ForegroundColor Blue
+npm run build
+
+if ($LASTEXITCODE -eq 0) {
+    Write-Host "✅ 빌드 성공" -ForegroundColor Green
+} else {
+    Write-Host "❌ 빌드 실패" -ForegroundColor Red
+    exit 1
+}
+
+# 4. Docker 컨테이너 재시작
+Write-Host "🐳 Docker 컨테이너 재시작 중..." -ForegroundColor Blue
+docker-compose down
+docker-compose up -d
+
+if ($LASTEXITCODE -eq 0) {
+    Write-Host "✅ Docker 컨테이너 재시작 완료" -ForegroundColor Green
+    Write-Host "🌐 서버 주소: http://localhost:9001" -ForegroundColor Cyan
+    Write-Host "❤️  헬스 체크: http://localhost:9001/health" -ForegroundColor Cyan
+} else {
+    Write-Host "❌ Docker 컨테이너 재시작 실패" -ForegroundColor Red
+    exit 1
+}
+
+Write-Host "🎉 Legacy 서버 복원 완료!" -ForegroundColor Green
+Write-Host "💡 필요시 현재 서버는 http-server-backup-$timestamp.ts에서 복원할 수 있습니다." -ForegroundColor Yellow

package/scripts/restore-legacy.sh

@@ -0,0 +1,62 @@
+#!/bin/bash
+
+# Legacy 서버 복원 스크립트
+# 백업에서 Legacy 버전을 복원합니다
+echo "🔄 Legacy 서버 복원 중..."
+
+# 백업 디렉토리 확인
+BACKUP_DIR=$(ls -t backup/legacy-removal-* 2>/dev/null | head -1)
+
+if [ -z "$BACKUP_DIR" ]; then
+    echo "❌ Legacy 백업을 찾을 수 없습니다."
+    echo "💡 backup/legacy-removal-* 디렉토리를 확인해주세요."
+    exit 1
+fi
+
+echo "📦 백업 디렉토리 발견: $BACKUP_DIR"
+
+# 1. 현재 http-server.ts를 백업
+if [ -f "src/server/http-server.ts" ]; then
+    echo "📦 현재 서버를 백업 중..."
+    TIMESTAMP=$(date +"%Y%m%d-%H%M%S")
+    cp "src/server/http-server.ts" "src/server/http-server-backup-$TIMESTAMP.ts"
+    echo "✅ 현재 서버 백업 완료: http-server-backup-$TIMESTAMP.ts"
+fi
+
+# 2. Legacy 서버 복원
+if [ -f "$BACKUP_DIR/http-server-legacy.ts" ]; then
+    echo "🔄 Legacy 서버 복원 중..."
+    cp "$BACKUP_DIR/http-server-legacy.ts" "src/server/http-server.ts"
+    echo "✅ Legacy 서버 복원 완료"
+else
+    echo "❌ Legacy 서버 파일을 찾을 수 없습니다."
+    exit 1
+fi
+
+# 3. 빌드
+echo "🔨 애플리케이션 빌드 중..."
+npm run build
+
+if [ $? -eq 0 ]; then
+    echo "✅ 빌드 성공"
+else
+    echo "❌ 빌드 실패"
+    exit 1
+fi
+
+# 4. Docker 컨테이너 재시작
+echo "🐳 Docker 컨테이너 재시작 중..."
+docker-compose down
+docker-compose up -d
+
+if [ $? -eq 0 ]; then
+    echo "✅ Docker 컨테이너 재시작 완료"
+    echo "🌐 서버 주소: http://localhost:9001"
+    echo "❤️  헬스 체크: http://localhost:9001/health"
+else
+    echo "❌ Docker 컨테이너 재시작 실패"
+    exit 1
+fi
+
+echo "🎉 Legacy 서버 복원 완료!"
+echo "💡 필요시 현재 서버는 http-server-backup-$TIMESTAMP.ts에서 복원할 수 있습니다."

package/scripts/run-migration.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+
+import Database from 'better-sqlite3';
+import { join } from 'path';
+import { existsSync, copyFileSync } from 'fs';
+
+const dbPath = join(process.cwd(), 'data', 'memory.db');
+const backupPath = join(process.cwd(), 'data', `memory-backup-${Date.now()}.db`);
+
+console.log('🚀 임베딩 데이터 마이그레이션 시작...');
+
+try {
+  // 1. 백업 생성
+  console.log('💾 백업 생성 중...');
+  copyFileSync(dbPath, backupPath);
+  console.log(`✅ 백업 생성 완료: ${backupPath}`);
+  
+  const db = new Database(dbPath);
+  
+  // 2. 새로운 컬럼 추가
+  console.log('📝 새로운 컬럼 추가 중...');
+  
+  try {
+    db.exec('ALTER TABLE memory_embedding ADD COLUMN embedding_provider TEXT');
+    console.log('✅ embedding_provider 컬럼 추가');
+  } catch (error) {
+    if (error.message.includes('duplicate column name')) {
+      console.log('ℹ️ embedding_provider 컬럼이 이미 존재합니다');
+    } else {
+      throw error;
+    }
+  }
+  
+  try {
+    db.exec('ALTER TABLE memory_embedding ADD COLUMN dimensions INTEGER');
+    console.log('✅ dimensions 컬럼 추가');
+  } catch (error) {
+    if (error.message.includes('duplicate column name')) {
+      console.log('ℹ️ dimensions 컬럼이 이미 존재합니다');
+    } else {
+      throw error;
+    }
+  }
+  
+  try {
+    db.exec('ALTER TABLE memory_embedding ADD COLUMN created_by TEXT DEFAULT "migration"');
+    console.log('✅ created_by 컬럼 추가');
+  } catch (error) {
+    if (error.message.includes('duplicate column name')) {
+      console.log('ℹ️ created_by 컬럼이 이미 존재합니다');
+    } else {
+      throw error;
+    }
+  }
+  
+  // 3. 기존 데이터 업데이트
+  console.log('🔄 기존 데이터 업데이트 중...');
+  
+  const updateResult = db.prepare(`
+    UPDATE memory_embedding 
+    SET 
+      embedding_provider = CASE 
+        WHEN model = 'lightweight-hybrid' THEN 'tfidf'
+        WHEN model IS NULL OR model = '' THEN 'tfidf'
+        ELSE 'unknown'
+      END,
+      dimensions = dim,
+      created_by = 'legacy'
+    WHERE embedding_provider IS NULL
+  `).run();
+  
+  console.log(`✅ ${updateResult.changes}개 레코드 업데이트 완료`);
+  
+  // 4. 인덱스 추가
+  console.log('📝 인덱스 추가 중...');
+  
+  db.exec('CREATE INDEX IF NOT EXISTS idx_memory_embedding_provider ON memory_embedding(embedding_provider)');
+  db.exec('CREATE INDEX IF NOT EXISTS idx_memory_embedding_dimensions ON memory_embedding(dimensions)');
+  db.exec('CREATE INDEX IF NOT EXISTS idx_memory_embedding_created_by ON memory_embedding(created_by)');
+  
+  console.log('✅ 인덱스 추가 완료');
+  
+  // 5. 검증
+  console.log('🔍 마이그레이션 검증 중...');
+  
+  const validation = db.prepare(`
+    SELECT 
+      COUNT(*) as total,
+      COUNT(CASE WHEN embedding_provider IS NOT NULL THEN 1 END) as with_provider,
+      COUNT(CASE WHEN dimensions IS NOT NULL THEN 1 END) as with_dimensions,
+      COUNT(CASE WHEN created_by IS NOT NULL THEN 1 END) as with_created_by
+    FROM memory_embedding
+  `).get();
+  
+  console.log('📊 검증 결과:');
+  console.table(validation);
+  
+  // 6. 최종 결과 확인
+  const finalAnalysis = db.prepare(`
+    SELECT 
+      embedding_provider,
+      dimensions,
+      COUNT(*) as count
+    FROM memory_embedding 
+    GROUP BY embedding_provider, dimensions
+    ORDER BY count DESC
+  `).all();
+  
+  console.log('\n📊 최종 데이터 분포:');
+  console.table(finalAnalysis);
+  
+  db.close();
+  
+  console.log('\n🎉 마이그레이션 완료!');
+  console.log(`💾 백업 파일: ${backupPath}`);
+  console.log('🔄 롤백이 필요한 경우: cp ' + backupPath + ' ' + dbPath);
+  
+} catch (error) {
+  console.error('❌ 마이그레이션 실패:', error.message);
+  console.log(`🔄 백업에서 복원하려면: cp ${backupPath} ${dbPath}`);
+  process.exit(1);
+}

package/scripts/safe-migration.js

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+
+import Database from 'better-sqlite3';
+import { join } from 'path';
+import { existsSync, copyFileSync } from 'fs';
+
+const dbPath = join(process.cwd(), 'data', 'memory.db');
+const tempDbPath = join(process.cwd(), 'data', 'memory-temp.db');
+
+console.log('🛡️ 안전한 마이그레이션 시작...');
+
+try {
+  // 1. 원본 데이터베이스 백업
+  console.log('💾 원본 데이터베이스 백업 중...');
+  const backupPath = join(process.cwd(), 'data', `memory-backup-${Date.now()}.db`);
+  copyFileSync(dbPath, backupPath);
+  console.log(`✅ 백업 생성: ${backupPath}`);
+  
+  // 2. 임시 데이터베이스 생성 (sqlite-vec 없이)
+  console.log('📝 임시 데이터베이스 생성 중...');
+  const tempDb = new Database(tempDbPath);
+  
+  // 3. 스키마 복사 (vec0 관련 부분 제외)
+  console.log('📋 스키마 복사 중...');
+  tempDb.exec(`
+    CREATE TABLE memory_item (
+      id TEXT PRIMARY KEY,
+      type TEXT CHECK (type IN ('working','episodic','semantic','procedural')) NOT NULL,
+      content TEXT NOT NULL,
+      importance REAL CHECK (importance >= 0 AND importance <= 1) DEFAULT 0.5,
+      privacy_scope TEXT CHECK (privacy_scope IN ('private','team','public')) DEFAULT 'private',
+      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+      last_accessed TIMESTAMP,
+      pinned BOOLEAN DEFAULT FALSE,
+      tags TEXT,
+      source TEXT,
+      view_count INTEGER DEFAULT 0,
+      cite_count INTEGER DEFAULT 0,
+      edit_count INTEGER DEFAULT 0
+    );
+  `);
+  
+  tempDb.exec(`
+    CREATE TABLE memory_embedding (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      memory_id TEXT NOT NULL,
+      embedding TEXT NOT NULL,
+      dim INTEGER NOT NULL,
+      model TEXT,
+      created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+      embedding_provider TEXT,
+      dimensions INTEGER,
+      created_by TEXT DEFAULT 'migration',
+      FOREIGN KEY (memory_id) REFERENCES memory_item(id) ON DELETE CASCADE,
+      UNIQUE(memory_id)
+    );
+  `);
+  
+  // 4. 데이터 복사
+  console.log('📊 데이터 복사 중...');
+  
+  // 원본 데이터베이스 연결
+  tempDb.exec(`ATTACH DATABASE '${dbPath}' AS source`);
+  
+  // memory_item 데이터 복사
+  tempDb.exec(`INSERT INTO memory_item SELECT * FROM source.memory_item`);
+  
+  // memory_embedding 데이터 복사 및 업데이트
+  tempDb.exec(`
+    INSERT INTO memory_embedding (memory_id, embedding, dim, model, created_at, embedding_provider, dimensions, created_by)
+    SELECT 
+      memory_id,
+      embedding,
+      dim,
+      model,
+      created_at,
+      CASE 
+        WHEN model = 'lightweight-hybrid' THEN 'tfidf'
+        WHEN model IS NULL OR model = '' THEN 'tfidf'
+        ELSE 'unknown'
+      END as embedding_provider,
+      dim as dimensions,
+      'legacy' as created_by
+    FROM source.memory_embedding
+  `);
+  
+  tempDb.exec('DETACH DATABASE source');
+  
+  console.log('✅ 데이터 복사 완료');
+  
+  // 5. 인덱스 생성
+  console.log('📝 인덱스 생성 중...');
+  tempDb.exec('CREATE INDEX IF NOT EXISTS idx_memory_embedding_provider ON memory_embedding(embedding_provider)');
+  tempDb.exec('CREATE INDEX IF NOT EXISTS idx_memory_embedding_dimensions ON memory_embedding(dimensions)');
+  tempDb.exec('CREATE INDEX IF NOT EXISTS idx_memory_embedding_created_by ON memory_embedding(created_by)');
+  
+  tempDb.close();
+  
+  // 6. 원본 데이터베이스 교체
+  console.log('🔄 데이터베이스 교체 중...');
+  copyFileSync(tempDbPath, dbPath);
+  
+  // 7. 임시 파일 정리
+  if (existsSync(tempDbPath)) {
+    const fs = require('fs');
+    fs.unlinkSync(tempDbPath);
+  }
+  
+  // 8. 검증
+  console.log('🔍 마이그레이션 검증 중...');
+  const db = new Database(dbPath);
+  
+  const validation = db.prepare(`
+    SELECT 
+      COUNT(*) as total,
+      COUNT(CASE WHEN embedding_provider IS NOT NULL THEN 1 END) as with_provider,
+      COUNT(CASE WHEN dimensions IS NOT NULL THEN 1 END) as with_dimensions,
+      COUNT(CASE WHEN created_by IS NOT NULL THEN 1 END) as with_created_by
+    FROM memory_embedding
+  `).get();
+  
+  console.log('📊 검증 결과:');
+  console.table(validation);
+  
+  const finalAnalysis = db.prepare(`
+    SELECT 
+      embedding_provider,
+      dimensions,
+      COUNT(*) as count
+    FROM memory_embedding 
+    GROUP BY embedding_provider, dimensions
+    ORDER BY count DESC
+  `).all();
+  
+  console.log('\n📊 최종 데이터 분포:');
+  console.table(finalAnalysis);
+  
+  db.close();
+  
+  console.log('\n🎉 마이그레이션 완료!');
+  console.log(`💾 백업 파일: ${backupPath}`);
+  console.log('🔄 롤백이 필요한 경우: cp ' + backupPath + ' ' + dbPath);
+  
+} catch (error) {
+  console.error('❌ 마이그레이션 실패:', error.message);
+  if (typeof backupPath !== 'undefined') {
+    console.log(`🔄 백업에서 복원하려면: cp ${backupPath} ${dbPath}`);
+  }
+  process.exit(1);
+}

package/scripts/simple-migrate.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+
+import Database from 'better-sqlite3';
+import { join } from 'path';
+
+const dbPath = join(process.cwd(), 'data', 'memory.db');
+
+console.log('🔍 임베딩 데이터 분석 중...');
+
+try {
+  const db = new Database(dbPath);
+  
+  // 기존 데이터 분석
+  const analysis = db.prepare(`
+    SELECT 
+      dim,
+      model,
+      COUNT(*) as count
+    FROM memory_embedding 
+    GROUP BY dim, model
+    ORDER BY count DESC
+  `).all();
+  
+  console.log('📊 기존 데이터 분석 결과:');
+  console.table(analysis);
+  
+  // 전체 통계
+  const total = db.prepare('SELECT COUNT(*) as total FROM memory_embedding').get();
+  console.log(`\n📈 총 임베딩 수: ${total.total}`);
+  
+  // 스키마 확인
+  const schema = db.prepare("PRAGMA table_info(memory_embedding)").all();
+  console.log('\n📋 현재 테이블 구조:');
+  console.table(schema);
+  
+  db.close();
+  
+} catch (error) {
+  console.error('❌ 오류 발생:', error.message);
+  process.exit(1);
+}

package/scripts/simple-update.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+
+import Database from 'better-sqlite3';
+import { join } from 'path';
+import { existsSync, copyFileSync } from 'fs';
+
+const dbPath = join(process.cwd(), 'data', 'memory.db');
+
+console.log('🔧 간단한 데이터 업데이트 시작...');
+
+try {
+  // 1. 백업 생성
+  const backupPath = join(process.cwd(), 'data', `memory-backup-${Date.now()}.db`);
+  copyFileSync(dbPath, backupPath);
+  console.log(`✅ 백업 생성: ${backupPath}`);
+  
+  // 2. 데이터베이스 연결 (sqlite-vec 없이)
+  const db = new Database(dbPath);
+  
+  // 3. 현재 상태 확인
+  console.log('📊 현재 상태 확인...');
+  const currentSchema = db.prepare("PRAGMA table_info(memory_embedding)").all();
+  console.log('현재 테이블 구조:');
+  console.table(currentSchema);
+  
+  // 4. 컬럼 추가 (이미 있는 경우 무시)
+  console.log('📝 컬럼 추가 중...');
+  
+  try {
+    db.exec('ALTER TABLE memory_embedding ADD COLUMN embedding_provider TEXT');
+    console.log('✅ embedding_provider 컬럼 추가');
+  } catch (error) {
+    if (error.message.includes('duplicate column name')) {
+      console.log('ℹ️ embedding_provider 컬럼이 이미 존재합니다');
+    } else {
+      console.warn('⚠️ embedding_provider 컬럼 추가 실패:', error.message);
+    }
+  }
+  
+  try {
+    db.exec('ALTER TABLE memory_embedding ADD COLUMN dimensions INTEGER');
+    console.log('✅ dimensions 컬럼 추가');
+  } catch (error) {
+    if (error.message.includes('duplicate column name')) {
+      console.log('ℹ️ dimensions 컬럼이 이미 존재합니다');
+    } else {
+      console.warn('⚠️ dimensions 컬럼 추가 실패:', error.message);
+    }
+  }
+  
+  try {
+    db.exec('ALTER TABLE memory_embedding ADD COLUMN created_by TEXT DEFAULT "migration"');
+    console.log('✅ created_by 컬럼 추가');
+  } catch (error) {
+    if (error.message.includes('duplicate column name')) {
+      console.log('ℹ️ created_by 컬럼이 이미 존재합니다');
+    } else {
+      console.warn('⚠️ created_by 컬럼 추가 실패:', error.message);
+    }
+  }
+  
+  // 5. 데이터 업데이트
+  console.log('🔄 데이터 업데이트 중...');
+  
+  const updateResult = db.prepare(`
+    UPDATE memory_embedding 
+    SET 
+      embedding_provider = CASE 
+        WHEN model = 'lightweight-hybrid' THEN 'tfidf'
+        WHEN model IS NULL OR model = '' THEN 'tfidf'
+        ELSE 'unknown'
+      END,
+      dimensions = dim,
+      created_by = 'legacy'
+    WHERE embedding_provider IS NULL
+  `).run();
+  
+  console.log(`✅ ${updateResult.changes}개 레코드 업데이트 완료`);
+  
+  // 6. 인덱스 추가
+  console.log('📝 인덱스 추가 중...');
+  db.exec('CREATE INDEX IF NOT EXISTS idx_memory_embedding_provider ON memory_embedding(embedding_provider)');
+  db.exec('CREATE INDEX IF NOT EXISTS idx_memory_embedding_dimensions ON memory_embedding(dimensions)');
+  db.exec('CREATE INDEX IF NOT EXISTS idx_memory_embedding_created_by ON memory_embedding(created_by)');
+  console.log('✅ 인덱스 추가 완료');
+  
+  // 7. 검증
+  console.log('🔍 검증 중...');
+  const validation = db.prepare(`
+    SELECT 
+      COUNT(*) as total,
+      COUNT(CASE WHEN embedding_provider IS NOT NULL THEN 1 END) as with_provider,
+      COUNT(CASE WHEN dimensions IS NOT NULL THEN 1 END) as with_dimensions,
+      COUNT(CASE WHEN created_by IS NOT NULL THEN 1 END) as with_created_by
+    FROM memory_embedding
+  `).get();
+  
+  console.log('📊 검증 결과:');
+  console.table(validation);
+  
+  const finalAnalysis = db.prepare(`
+    SELECT 
+      embedding_provider,
+      dimensions,
+      COUNT(*) as count
+    FROM memory_embedding 
+    GROUP BY embedding_provider, dimensions
+    ORDER BY count DESC
+  `).all();
+  
+  console.log('\n📊 최종 데이터 분포:');
+  console.table(finalAnalysis);
+  
+  db.close();
+  
+  console.log('\n🎉 업데이트 완료!');
+  console.log(`💾 백업 파일: ${backupPath}`);
+  console.log('🔄 롤백이 필요한 경우: cp ' + backupPath + ' ' + dbPath);
+  
+} catch (error) {
+  console.error('❌ 업데이트 실패:', error.message);
+  process.exit(1);
+}

package/scripts/start-container.sh

@@ -0,0 +1,10 @@
+#!/bin/sh
+
+# 데이터 디렉토리 권한 설정
+echo "🔧 데이터 디렉토리 권한 설정 중..."
+chmod -R 755 /app/data
+chown -R memento:nodejs /app/data
+
+# HTTP 서버 시작
+echo "🚀 Memento HTTP 서버 시작 중..."
+exec node dist/server/http-server.js