Skip to content

MEMORY.md

Latest commit

 

History

History
98 lines (74 loc) · 5.07 KB

MEMORY.md

File metadata and controls

98 lines (74 loc) · 5.07 KB
Raw

🧠 MEMORY.md — 활성 운영 규칙 및 미해결 이슈

작성일: 2026-03-15 | 최종 갱신: 2026-03-28 완료된 결정의 상세 이력은 MEMORY-archive.md를 참조하세요.

📌 활성 운영 규칙

데이터 수집/저장 일관성

  1. 새 수집 경로 추가 시 PG+Redis+S3 3중 저장 일관성을 반드시 맞출 것. collect_daily_bars()를 참조 구현으로 삼을 것.
  2. SearchAgent stub 해소 전까지 Strategy S 가중치를 0으로 설정하거나, SearXNG 클라이언트를 직접 연결할 것.
  3. Orchestrator CLI 엔트리포인트에 기본 Runner 4종(A/B/RL/S) 자동 등록 코드를 추가할 것.

2026-03-20 — 모바일 앱 전환 방향 초안

  • 상황 판단: 현재 UI는 소비자용 모바일 앱보다 운영 콘솔에 가깝다. 대시보드, 시스템 헬스, 감사 로그, Data Lake, 모델/에이전트 관리 화면 비중이 높다.
  • 중간 권고: 모바일 앱이 필요하더라도 우선은 Capacitor로 현재 React 웹앱을 래핑하는 방향을 기본값으로 본다.
  • 우선순위: 네이티브 재개발이 필요할 경우, React/TypeScript 자산을 고려해 Flutter보다 React Native를 먼저 검토.
  • 운영 규칙:
    1. 앱 전환 전에는 API 주소, 인증 저장, 브라우저 전용 API를 먼저 추상화할 것.
    2. 웹 운영 콘솔과 모바일 사용자 앱은 동일한 UX 목표로 보지 말 것.
    3. 초기 앱화(V1)에서는 apps/mobile-shell만 추가하고, packages/app-core 추출은 V2 이후.

에이전트 레지스트리

  1. 새 에이전트 추가 시 반드시 agent_registry 테이블에 INSERT할 것. 코드에만 추가하면 모니터링 누락.
  2. agent_id는 agent_registry.agent_id와 정확히 일치해야 한다. 불일치 시 하트비트/상태 매칭 실패.
  3. **비활성화는 soft delete (is_active=FALSE)**로 처리. 하드 삭제 금지.

LLM 프로바이더 정책 (2026-04-13 갱신)

  1. 인증 우선순위: CLI 구독 1순위 → API Key SDK 자동 fallback. CLI 인증 실패(CLIAuthError) 시 내부적으로 SDK로 전환.
  2. Claude: ANTHROPIC_CLI_COMMAND CLI 우선 → ANTHROPIC_API_KEY SDK fallback (_ensure_sdk_client() lazy 초기화).
  3. GPT: Codex CLI 우선 → OPENAI_API_KEY SDK fallback. gpt_client.py __init__에서 CLI 먼저 시도.
  4. Gemini: ~/.config/gcloud/application_default_credentials.json ADC 파일에 의존.
  5. 1분 주기 health 크론잡이 3 프로바이더 인증 상태 감시 → 상태 변경 시만 Telegram 알림.

DB 배치 처리

  1. 새로운 bulk upsert 함수를 만들 때 반드시 executemany()를 사용할 것. for + await execute() 패턴 금지.
  2. 5,000건 이상 배치는 자동 청크 분할됨. executemany() 호출 시 별도 처리 불필요.
  3. 실시간 스트리밍 데이터(틱 등)는 반드시 버퍼링 후 배치 INSERT. 단건 INSERT 금지.
  4. ON CONFLICT (upsert) 멱등성은 항상 유지할 것.

Sentiment → Signal 매핑

  • bullish=BUY, bearish=SELL, neutral/mixed=HOLD
  • confidence < 0.3 → HOLD fallback, sources=0 → confidence ≤ 0.3
  • 리서치 실패 시 항상 HOLD 신호로 fallback

블로그 자동 포스팅 (2026-03-28 추가)

  1. .agent/discussions/*.md 파일 Write/Edit 시 PostToolUse 훅이 자동으로 Blogger에 draft 포스팅.
  2. /post-discussion 슬래시 커맨드 또는 scripts/post_discussion_to_blog.py로 수동 포스팅 가능.
  3. 동일 제목의 글이 이미 있으면 업데이트 (중복 방지).
  4. Blogger 자격 증명은 .env의 BLOGGER_* 변수에 저장.

🔍 미해결 이슈

LLM 프로바이더 Docker 내 실패

  • 상태: 부분 해결 (2026-04-13)
  • Claude/GPT: CLI 실패 시 API Key SDK 자동 fallback 구현 완료. Docker 내 ANTHROPIC_API_KEY/OPENAI_API_KEY 환경변수 설정 시 정상 동작.
  • Gemini: ADC 파일 마운트 필요 (미해결). Docker 환경에서 ~/.config/gcloud/ 볼륨 마운트 또는 GOOGLE_APPLICATION_CREDENTIALS 설정 필요.

SearchAgent 모델 호환성

  • 상태: 미해결
  • 일부 LLM 모델에서 지원 안 될 수 있음. model_used 필드로 추적 중.

📚 현재 아키텍처 요약

Orchestrator
├─ Strategy A (Tournament) → signal_a  [0.30]
├─ Strategy B (Consensus)  → signal_b  [0.30]
├─ Strategy RL (Q-learning) → signal_rl [0.20]
└─ Strategy S (Search)     → signal_s  [0.20]
        │
        └─ blend_signals() → final_signal
  • 주문 권한: PortfolioManagerAgent만 보유
  • 승격 경로: virtual → paper → real (각 단계별 게이트 조건)
  • 데이터 저장: PG + Redis + S3(MinIO) 3중 구조

📋 다음 작업 체크리스트

  • SearXNG 로컬 검색 엔진 통합 (API 제한 극복)
  • SearchAgent 모델 호환성 테스트
  • 프로덕션 환경 배포 및 모니터링
  • 성능 튜닝 (블렌딩 가중치 최적화)
  • QA 잔여 이슈 처리 (C3, H1H4, M1M4)
  • LLM 프로바이더 Docker 내 실패 해결 (Gemini ADC 마운트만 잔여)

Last updated: 2026-04-13