refactor: delete server-agent.ts (905 lines)

Remove server recommendation consultation system:
- 30-year expert AI persona
- Session-based information gathering
- Brave Search / Context7 tool integration
- Automatic spec inference

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

docs/plans/2026-02-05-conversation-storage-design.md

@@ -0,0 +1,180 @@
+# 대화 저장 시스템 리팩토링 설계
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** 기존 요약 기반 대화 저장을 전체 대화 기록 보존 시스템으로 전환
+
+**Architecture:** 사용자별 동적 테이블 생성 + 메타 테이블 관리 + 6개월 후 아카이브
+
+**Tech Stack:** Cloudflare Workers, D1 SQLite, OpenAI GPT-4o-mini
+
+---
+
+## 1. 데이터베이스 구조
+
+### 메타 테이블 (`conversation_tables`)
+```sql
+CREATE TABLE conversation_tables (
+  telegram_id TEXT PRIMARY KEY,
+  table_name TEXT NOT NULL,           -- conv_123456789
+  message_count INTEGER DEFAULT 0,
+  last_message_at DATETIME,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX idx_conv_tables_last_msg ON conversation_tables(last_message_at DESC);
+```
+
+### 동적 사용자 테이블 (`conv_{telegram_id}`)
+```sql
+CREATE TABLE conv_{telegram_id} (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  role TEXT NOT NULL CHECK(role IN ('user', 'assistant')),
+  content TEXT NOT NULL,
+  tool_calls TEXT,      -- JSON: [{name, arguments, id}]
+  tool_results TEXT,    -- JSON: [{tool_call_id, result}]
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX idx_conv_{telegram_id}_created ON conv_{telegram_id}(created_at DESC);
+```
+
+### 기존 테이블 변경
+- `message_buffer`: 마이그레이션 후 삭제
+- `summaries`: 유지 (아카이브 요약 저장용)
+
+---
+
+## 2. 서비스 구조
+
+### ConversationService (`src/services/conversation-service.ts`)
+
+```typescript
+interface ConversationMessage {
+  id?: number;
+  role: 'user' | 'assistant';
+  content: string;
+  tool_calls?: string;    // JSON
+  tool_results?: string;  // JSON
+  created_at?: string;
+}
+
+// 테이블 생성/확인
+export async function ensureConversationTable(db: D1Database, telegramId: string): Promise<string>
+
+// 메시지 저장
+export async function saveMessage(db: D1Database, telegramId: string, message: ConversationMessage): Promise<void>
+
+// 최근 메시지 조회
+export async function getRecentMessages(db: D1Database, telegramId: string, limit: number): Promise<ConversationMessage[]>
+
+// 키워드 검색
+export async function searchRelevantMessages(db: D1Database, telegramId: string, keywords: string[], limit: number): Promise<ConversationMessage[]>
+
+// 스마트 컨텍스트 (최근 20개 + 관련 10개)
+export async function getSmartContext(db: D1Database, telegramId: string, currentMessage: string): Promise<ConversationMessage[]>
+
+// 통계 조회
+export async function getConversationStats(db: D1Database, telegramId: string): Promise<ConversationStats>
+```
+
+### ArchiveService (`src/services/archive-service.ts`)
+
+```typescript
+// 전체 아카이브 (Cron)
+export async function archiveOldConversations(env: Env): Promise<ArchiveResult>
+
+// 사용자별 아카이브
+export async function archiveUserConversations(env: Env, telegramId: string, olderThanDays: number): Promise<number>
+
+// 아카이브 요약 생성
+export async function generateArchiveSummary(env: Env, messages: ConversationMessage[]): Promise<string>
+```
+
+---
+
+## 3. 아카이브 정책
+
+- **트리거**: 6개월(180일) 이상 된 대화
+- **주기**: 매일 UTC 15:00 (KST 00:00)
+- **단위**: 100개 메시지씩 요약
+- **저장**: summaries 테이블에 기간 정보 포함
+
+### 아카이브 프로세스
+```
+1. conversation_tables 순회
+2. 각 conv_{id}에서 180일 이상 된 메시지 조회
+3. 100개 단위로 AI 요약 생성
+4. summaries에 저장: "[2024-01-01 ~ 2024-06-30 아카이브] 요약내용..."
+5. 원본 메시지 삭제
+6. message_count 업데이트
+```
+
+---
+
+## 4. AI 컨텍스트 구성
+
+### 스마트 컨텍스트 알고리즘
+```
+1. 최근 20개 메시지 가져오기
+2. 현재 메시지에서 키워드 추출 (명사, 2글자 이상, 최대 5개)
+3. 키워드로 과거 대화 검색 (LIKE %keyword%)
+4. 관련 대화 최대 10개 추가
+5. 중복 제거 + 시간순 정렬
+6. 아카이브 요약도 컨텍스트에 포함
+```
+
+### 키워드 추출
+- 불용어 제외: 은, 는, 이, 가, 을, 를, 에, 도, 로, 의, 와, 과
+- 최소 2글자 이상
+- 최대 5개 키워드
+
+---
+
+## 5. 사용자 명령어
+
+| 명령어 | 설명 |
+|--------|------|
+| `/history` | 최근 20개 대화 조회 |
+| `/history N` | 최근 N개 대화 조회 |
+| `/search 키워드` | 키워드로 대화 검색 |
+| `/stats` | 대화 통계 (총 메시지, 첫 대화일 등) |
+
+---
+
+## 6. 마이그레이션 계획
+
+### Step 1: 스키마 생성
+- `conversation_tables` 메타 테이블 생성
+
+### Step 2: 데이터 이동
+- 기존 `message_buffer` 데이터 → 각 사용자 `conv_{id}` 테이블로 이동
+- 기존 사용자 목록 기반으로 테이블 생성
+
+### Step 3: 코드 배포
+- conversation-service.ts 추가
+- archive-service.ts 추가
+- summary-service.ts 수정
+- index.ts 수정
+- commands.ts 수정
+
+### Step 4: 정리
+- message_buffer 테이블 삭제 (검증 후)
+
+---
+
+## 7. 파일 변경 목록
+
+### 신규 파일
+- `src/services/conversation-service.ts`
+- `src/services/archive-service.ts`
+- `migrations/008_conversation_tables.sql`
+
+### 수정 파일
+- `src/summary-service.ts` - getSmartContext 사용으로 변경
+- `src/index.ts` - saveMessage 호출로 변경
+- `src/commands.ts` - /history, /search, /stats 추가
+- `src/types.ts` - ConversationMessage 타입 추가
+
+### 삭제 (마이그레이션 후)
+- `message_buffer` 테이블 관련 코드

docs/plans/2026-02-05-remove-server-recommendation.md

@@ -0,0 +1,533 @@
+# 서버 추천 기능 제거 Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
+
+**Goal:** 서버 추천/상담 기능을 제거하고, 서버 관리 기능(목록, 시작/중지, 삭제 등)만 유지
+
+**Architecture:** 진입점(openai-service.ts, message-handler.ts)에서 상담 세션 분기 제거 → server-agent.ts 삭제 → server-tool.ts에서 추천 관련 action 제거 → types.ts 정리 → constants 정리 → DB 마이그레이션
+
+**Tech Stack:** TypeScript, Cloudflare Workers, D1 SQLite
+
+---
+
+## Task 1: openai-service.ts - 서버 상담 세션 분기 제거
+
+**Files:**
+- Modify: `src/openai-service.ts:9` (import), `src/openai-service.ts:211-250` (session check)
+
+**Step 1: import 제거**
+
+```typescript
+// 제거할 라인 (줄 9)
+import { hasServerSession, processServerConsultation } from './agents/server-agent';
+```
+
+**Step 2: 서버 상담 세션 체크 블록 제거**
+
+줄 211-250의 서버 세션 체크 블록 전체 삭제:
+```typescript
+// 이 전체 블록 삭제 (줄 211-250 근처)
+// Check if server consultation session is active
+if (telegramUserId && env.DB) {
+  try {
+    const hasSession = await hasServerSession(env.DB, telegramUserId);
+
+    if (hasSession) {
+      logger.info('Active server session detected, routing to consultation', {
+        userId: telegramUserId
+      });
+
+      // Create callback for intermediate messages
+      let sendIntermediateMessage: ((message: string) => Promise<void>) | undefined;
+      if (chatIdStr) {
+        sendIntermediateMessage = async (message: string) => {
+          logger.info('Sending intermediate message', { chatId: chatIdStr, messagePreview: message.substring(0, 50) });
+          await sendMessage(env.BOT_TOKEN, parseInt(chatIdStr), message);
+          logger.info('Intermediate message sent successfully', { chatId: chatIdStr });
+        };
+      }
+
+      const result = await processServerConsultation(
+        env.DB,
+        telegramUserId,
+        userMessage,
+        env,
+        { sendIntermediateMessage }
+      );
+
+      // PASSTHROUGH: 무관한 메시지는 일반 처리로 전환
+      if (result !== '__PASSTHROUGH__') {
+        return result;
+      }
+      // Continue to normal flow below
+    }
+  } catch (error) {
+    logger.error('Session check failed, continuing with normal flow', error as Error, {
+      telegramUserId
+    });
+    // Continue with normal flow if session check fails
+  }
+  // ... (troubleshoot, domain, deposit, ddos 세션 체크는 유지)
+```
+
+**Step 3: 타입체크**
+
+Run: `cd /Users/kaffa/Projects/bots/telegram-bot-workers && npm run typecheck`
+Expected: 서버 세션 관련 에러들 발생 (다음 태스크에서 해결)
+
+**Step 4: Commit**
+
+```bash
+git add src/openai-service.ts
+git commit -m "refactor: remove server consultation session routing from openai-service
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"
+```
+
+---
+
+## Task 2: message-handler.ts - 서버 신청 관련 코드 정리
+
+**Files:**
+- Modify: `src/routes/handlers/message-handler.ts:117-218`
+
+**Step 1: "신청" 처리에서 서버 세션 의존 코드 제거**
+
+줄 117-218의 서버 신청 확인 처리 블록 전체 삭제 (서버 관리는 manage_server 도구로 직접 처리):
+
+```typescript
+// 이 전체 블록 삭제 (줄 117-218)
+// 7. 서버 신청 확인 처리 (텍스트 기반) - Queue 기반
+if (text.trim() === '신청') {
+  if (orderSessionData) {
+    // ... 전체 블록
+  }
+}
+```
+
+**Step 2: orderSessionKey 변수 및 Promise.all에서 제거**
+
+```typescript
+// 변경 전 (줄 60-66)
+const deleteSessionKey = `delete_confirm:${telegramUserId}`;
+const orderSessionKey = `server_order_confirm:${telegramUserId}`;
+
+const [deleteSessionData, orderSessionData] = await Promise.all([
+  env.SESSION_KV.get(deleteSessionKey),
+  env.SESSION_KV.get(orderSessionKey),
+]);
+
+// 변경 후
+const deleteSessionKey = `delete_confirm:${telegramUserId}`;
+
+const deleteSessionData = await env.SESSION_KV.get(deleteSessionKey);
+```
+
+**Step 3: 타입체크**
+
+Run: `cd /Users/kaffa/Projects/bots/telegram-bot-workers && npm run typecheck`
+Expected: PASS 또는 server-agent 관련 에러
+
+**Step 4: Commit**
+
+```bash
+git add src/routes/handlers/message-handler.ts
+git commit -m "refactor: remove server order confirmation from message-handler
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"
+```
+
+---
+
+## Task 3: server-agent.ts 파일 삭제
+
+**Files:**
+- Delete: `src/agents/server-agent.ts`
+
+**Step 1: 파일 삭제**
+
+```bash
+rm src/agents/server-agent.ts
+```
+
+**Step 2: 타입체크**
+
+Run: `cd /Users/kaffa/Projects/bots/telegram-bot-workers && npm run typecheck`
+Expected: server-tool.ts에서 import 에러 발생 (다음 태스크에서 해결)
+
+**Step 3: Commit**
+
+```bash
+git add -A
+git commit -m "refactor: delete server-agent.ts (905 lines)
+
+Remove server recommendation consultation system:
+- 30-year expert AI persona
+- Session-based information gathering
+- Brave Search / Context7 tool integration
+- Automatic spec inference
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"
+```
+
+---
+
+## Task 4: server-tool.ts - 추천 관련 action 제거
+
+**Files:**
+- Modify: `src/tools/server-tool.ts`
+
+**Step 1: 추천 관련 함수 제거**
+
+다음 함수들 삭제:
+- `getRecommendationData()` (줄 332-374)
+- `formatRecommendations()` (줄 378-431)
+- `estimateCdnCacheHitRate()` (줄 42-66)
+- `CDN_CACHE_HIT_RATES` 상수 (줄 24-31)
+
+**Step 2: manageServerTool 정의에서 추천 관련 enum 값 제거**
+
+```typescript
+// 변경 전 (줄 96-99)
+action: {
+  type: 'string',
+  enum: ['recommend', 'order', 'list', 'info', 'delete', 'images', 'start', 'stop', 'reboot',
+         'start_consultation', 'continue_consultation', 'cancel_consultation', 'rename'],
+  description: '...',
+}
+
+// 변경 후
+action: {
+  type: 'string',
+  enum: ['order', 'list', 'info', 'delete', 'images', 'start', 'stop', 'reboot', 'rename'],
+  description: 'start: 서버 시작, stop: 서버 중지, reboot: 서버 재시작, delete: 서버 삭제, list: 내 서버 목록, info: 서버 상세, order: 서버 주문, rename: 이름 변경, images: OS 이미지 목록',
+}
+```
+
+**Step 3: 추천 관련 파라미터 제거**
+
+manageServerTool.function.parameters.properties에서 제거:
+- `tech_stack`
+- `expected_users`
+- `use_case`
+- `traffic_pattern`
+- `region_preference`
+- `budget_limit`
+- `lang`
+- `message`
+
+**Step 4: executeServerAction에서 추천 관련 case 제거**
+
+삭제할 case들:
+- `case 'start_consultation':` (줄 665-678)
+- `case 'continue_consultation':` (줄 680-697)
+- `case 'cancel_consultation':` (줄 699-717)
+- `case 'recommend':` (줄 719-825)
+
+**Step 5: executeServerAction에서 server-agent import 제거**
+
+```typescript
+// 삭제할 dynamic import (case 'continue_consultation' 내부)
+const { processServerConsultation } = await import('../agents/server-agent');
+
+// 삭제할 dynamic import (case 'cancel_consultation' 내부)
+const { ServerSessionManager } = await import('../utils/session-manager');
+const { getSessionConfig } = await import('../constants/agent-config');
+```
+
+**Step 6: 타입체크**
+
+Run: `cd /Users/kaffa/Projects/bots/telegram-bot-workers && npm run typecheck`
+Expected: PASS
+
+**Step 7: Commit**
+
+```bash
+git add src/tools/server-tool.ts
+git commit -m "refactor: remove recommendation actions from server-tool
+
+Removed:
+- start_consultation, continue_consultation, cancel_consultation, recommend actions
+- getRecommendationData(), formatRecommendations()
+- CDN cache hit rate estimation
+- Recommendation-related parameters (tech_stack, expected_users, etc.)
+
+Retained:
+- order, list, info, delete, images, start, stop, reboot, rename actions
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"
+```
+
+---
+
+## Task 5: types.ts - 서버 세션 관련 타입 제거
+
+**Files:**
+- Modify: `src/types.ts`
+
+**Step 1: ServerSession 관련 타입 제거**
+
+삭제할 타입들:
+- `ServerSessionStatus` (줄 248-253)
+- `ServerSession` (줄 256-293)
+
+**Step 2: ManageServerArgs에서 추천 관련 필드 제거**
+
+```typescript
+// 변경 전 (줄 212-239)
+export interface ManageServerArgs {
+  action:
+    | "recommend"
+    | "order"
+    | "start"
+    | "stop"
+    | "delete"
+    | "list"
+    | "info"
+    | "images"
+    | "start_consultation"
+    | "continue_consultation"
+    | "cancel_consultation";
+  tech_stack?: string[];
+  expected_users?: number;
+  use_case?: string;
+  traffic_pattern?: string;
+  region_preference?: string[];
+  budget_limit?: number;
+  lang?: string;
+  // ... 나머지
+}
+
+// 변경 후
+export interface ManageServerArgs {
+  action:
+    | "order"
+    | "start"
+    | "stop"
+    | "delete"
+    | "list"
+    | "info"
+    | "images"
+    | "reboot"
+    | "rename";
+  server_id?: string;
+  region_code?: string;
+  label?: string;
+  pricing_id?: number;
+  order_id?: number;
+  new_label?: string;
+  image?: string;
+}
+```
+
+**Step 3: 타입체크**
+
+Run: `cd /Users/kaffa/Projects/bots/telegram-bot-workers && npm run typecheck`
+Expected: PASS
+
+**Step 4: Commit**
+
+```bash
+git add src/types.ts
+git commit -m "refactor: remove ServerSession types from types.ts
+
+Removed:
+- ServerSessionStatus type
+- ServerSession interface
+- Recommendation-related fields from ManageServerArgs
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"
+```
+
+---
+
+## Task 6: constants/index.ts - SERVER_CONSULTATION_STATUS 제거
+
+**Files:**
+- Modify: `src/constants/index.ts`
+
+**Step 1: SERVER_CONSULTATION_STATUS 상수 제거**
+
+```typescript
+// 삭제 (줄 157-162)
+export const SERVER_CONSULTATION_STATUS = {
+  GATHERING: 'gathering',
+  RECOMMENDING: 'recommending',
+  SELECTING: 'selecting',
+  COMPLETED: 'completed',
+} as const;
+```
+
+**Step 2: 타입 export 제거**
+
+```typescript
+// 삭제 (줄 220)
+export type ServerConsultationStatus = typeof SERVER_CONSULTATION_STATUS[keyof typeof SERVER_CONSULTATION_STATUS];
+```
+
+**Step 3: 타입체크**
+
+Run: `cd /Users/kaffa/Projects/bots/telegram-bot-workers && npm run typecheck`
+Expected: PASS
+
+**Step 4: Commit**
+
+```bash
+git add src/constants/index.ts
+git commit -m "refactor: remove SERVER_CONSULTATION_STATUS from constants
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"
+```
+
+---
+
+## Task 7: commands.ts - /server 명령어 응답 수정
+
+**Files:**
+- Modify: `src/commands.ts:268-274`
+
+**Step 1: "서버 추천" 안내 문구 제거**
+
+```typescript
+// 변경 전 (줄 268-274)
+if (servers.length === 0) {
+  return `🖥️ <b>내 서버</b>
+
+보유한 서버가 없습니다.
+
+"서버 추천" 또는 "서버 신청"으로 시작하세요!`;
+}
+
+// 변경 후
+if (servers.length === 0) {
+  return `🖥️ <b>내 서버</b>
+
+보유한 서버가 없습니다.`;
+}
+```
+
+**Step 2: 타입체크**
+
+Run: `cd /Users/kaffa/Projects/bots/telegram-bot-workers && npm run typecheck`
+Expected: PASS
+
+**Step 3: Commit**
+
+```bash
+git add src/commands.ts
+git commit -m "refactor: update /server command to remove recommendation guide
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"
+```
+
+---
+
+## Task 8: D1 마이그레이션 - server_sessions 테이블 DROP
+
+**Files:**
+- Create: `migrations/006_drop_server_sessions.sql`
+- Modify: `schema.sql` (server_sessions 정의 제거)
+
+**Step 1: 마이그레이션 파일 생성**
+
+```sql
+-- migrations/006_drop_server_sessions.sql
+-- Drop server consultation sessions table
+-- This table was used for server recommendation consultation feature which is now removed
+
+DROP TABLE IF EXISTS server_sessions;
+DROP INDEX IF EXISTS idx_server_sessions_expires;
+```
+
+**Step 2: schema.sql에서 server_sessions 제거**
+
+```sql
+-- 삭제할 부분 (줄 89-99)
+-- 서버 상담 세션 테이블
+CREATE TABLE IF NOT EXISTS server_sessions (
+  user_id TEXT PRIMARY KEY,
+  status TEXT NOT NULL CHECK(status IN ('gathering', 'recommending', 'selecting', 'ordering', 'completed')),
+  collected_info TEXT,
+  last_recommendation TEXT,
+  messages TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  expires_at INTEGER NOT NULL
+);
+
+-- 인덱스도 삭제 (줄 156)
+CREATE INDEX IF NOT EXISTS idx_server_sessions_expires ON server_sessions(expires_at);
+```
+
+**Step 3: 로컬 마이그레이션 테스트**
+
+Run: `cd /Users/kaffa/Projects/bots/telegram-bot-workers && wrangler d1 execute telegram-conversations --local --file=migrations/006_drop_server_sessions.sql`
+Expected: 성공
+
+**Step 4: Commit**
+
+```bash
+git add migrations/006_drop_server_sessions.sql schema.sql
+git commit -m "refactor: drop server_sessions table
+
+Add migration to remove server consultation sessions table.
+Update schema.sql to remove table definition.
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"
+```
+
+---
+
+## Task 9: 최종 검증
+
+**Step 1: 타입체크**
+
+Run: `cd /Users/kaffa/Projects/bots/telegram-bot-workers && npm run typecheck`
+Expected: PASS (에러 0개)
+
+**Step 2: 빌드**
+
+Run: `cd /Users/kaffa/Projects/bots/telegram-bot-workers && npm run build`
+Expected: PASS
+
+**Step 3: 테스트**
+
+Run: `cd /Users/kaffa/Projects/bots/telegram-bot-workers && npm test`
+Expected: PASS (또는 서버 추천 관련 테스트만 실패)
+
+**Step 4: 로컬 서버 테스트**
+
+Run: `cd /Users/kaffa/Projects/bots/telegram-bot-workers && npm run dev`
+
+테스트 항목:
+1. `/server` 명령어 - 서버 목록 표시 확인
+2. "서버 추천해줘" 입력 - 상담 시작 안 됨 확인 (일반 AI 응답)
+3. 서버 시작/중지/삭제 (기존 서버 있는 경우)
+
+**Step 5: 최종 커밋 (선택)**
+
+```bash
+git add -A
+git commit -m "chore: final cleanup after server recommendation removal
+
+Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"
+```
+
+---
+
+## Summary
+
+| Task | 파일 | 변경 내용 |
+|------|------|----------|
+| 1 | openai-service.ts | 서버 세션 import 및 라우팅 제거 |
+| 2 | message-handler.ts | "신청" 처리 블록 제거 |
+| 3 | server-agent.ts | 파일 삭제 (905줄) |
+| 4 | server-tool.ts | 추천 action 4개 + 헬퍼 함수 제거 |
+| 5 | types.ts | ServerSession 타입 제거 |
+| 6 | constants/index.ts | SERVER_CONSULTATION_STATUS 제거 |
+| 7 | commands.ts | /server 안내 문구 수정 |
+| 8 | schema.sql + migration | server_sessions 테이블 DROP |
+| 9 | - | 최종 검증 |
+
+**예상 제거 라인:** ~1,200줄
+**유지 기능:** 서버 관리 (list, info, start, stop, reboot, delete, rename, order, images)