flowchart LR
    A["🧠 AI에게 무언가를<br/>말합니다"] --> B["지속 가능한<br/>사실 추출"]
    B --> C["중복 제거 + 임베딩<br/>+ 그래프 연결"]
    C --> D[("메모리<br/>저장소")]
    D -->|"관련 사실이 쌓이면"| E["✨ 통합<br/>N → 1 요약"]
    D -->|"오래되고 사용되지 않음"| F["📉 감쇠<br/>+ 가지치기"]
    D -->|"새 세션"| G["♻️ 회상<br/>하이브리드 + 그래프"]
    E --> D
    G --> H["🤖 에이전트가<br/>중단된 지점부터<br/>계속합니다"]
    style D fill:#0a2540,stroke:#19cdff,color:#fff
    style E fill:#0c2b3a,stroke:#5eead4,color:#fff
    style H fill:#0c2b3a,stroke:#19cdff,color:#fff

xychart-beta
    title "Recall@5 · LoCoMo-10 (높을수록 좋음)"
    x-axis ["Mem0", "Zep Cloud", "Supermemory", "YourMemory"]
    y-axis "Recall@5 백분율" 0 --> 70
    bar [18, 28, 31, 59]

pip install yourmemory
yourmemory-register <your-token>
yourmemory-setup

# macOS / Linux — 다운로드, 압축 해제, 실행
tar -xzf yourmemory-macos-arm64.tar.gz
./yourmemory-macos-arm64 register <your-token>
./yourmemory-macos-arm64 setup
./yourmemory-macos-arm64            # 서버 시작

flowchart LR
    subgraph before [관련 사실들이 쌓임]
        A1["Railway uses Nixpacks"]
        A2["Railway on Pro plan"]
        A3["Railway env vars hold<br/>the Postgres URL"]
        A4["Deploys on Railway<br/>with Postgres"]
    end
    before --> C{"클러스터 +<br/>LLM 요약"}
    C --> S["✨ 요약<br/>Deploys on Railway (Pro,<br/>Nixpacks) with Postgres<br/>via env vars"]
    C -.->|"보관됨, 복구 가능"| ARC[("아카이브")]
    style S fill:#0a2540,stroke:#5eead4,color:#fff
    style C fill:#0c2b3a,stroke:#19cdff,color:#fff

effective_λ  = base_λ × (1 - importance × 0.8)
strength     = clamp(importance × e^(-effective_λ × active_days) × (1 + recall_count × 0.2), 0, 1)

flowchart LR
    Q["질의"] --> R1["Vector + BM25<br/>하이브리드 검색"]
    R1 --> R2["그래프 확장<br/>(당신이 묻는 것을 잊은 것)"]
    R2 --> S["유사도 × 강도<br/>순위화"]
    S --> OUT["🎯 순위화된 메모리"]
    style OUT fill:#0a2540,stroke:#19cdff,color:#fff

flowchart LR
    E0["GENESIS"] --> E1
    subgraph E1 [이벤트 1]
        H1["row_hash =<br/>sha256(prev + data)"]
    end
    E1 --> E2
    subgraph E2 [이벤트 2]
        H2["row_hash =<br/>sha256(#1.hash + data)"]
    end
    E2 --> E3
    subgraph E3 [이벤트 3]
        H3["row_hash =<br/>sha256(#2.hash + data)"]
    end
    E3 --> V{"GET /audit/verify"}
    V -->|체인 손상 없음| OK["✅ 확인됨"]
    V -->|행 변경됨| BAD["❌ 해당 행에서<br/>체인 끊어짐"]
    style OK fill:#0a2540,stroke:#5eead4,color:#fff
    style BAD fill:#3a0c14,stroke:#fb7185,color:#fff

GET  /audit            # 추적 탐색 (사용자 / 액션 / 작업으로 필터)
GET  /audit/verify     # 체인이 변조되지 않았는지 암호학적으로 확인
POST /audit/prune      # 보존 기반 정리 (최소 90일, 절대 낮추지 않음)

flowchart TB
    P(("🧠 팀 풀<br/>공유 메모리"))
    A["Alice의 에이전트"] <-->|공유| P
    B["Bob의 에이전트"] <-->|공유| P
    C["Carol의 에이전트"] <-->|공유| P
    A -. 비공개 .-> AP["🔒 Alice 전용"]
    B -. 비공개 .-> BP["🔒 Bob 전용"]
    style P fill:#0a2540,stroke:#19cdff,color:#fff
    style AP fill:#0c1424,stroke:#5a6b80,color:#8294a8
    style BP fill:#0c1424,stroke:#5a6b80,color:#8294a8

POST   /pools                          # 풀 생성
POST   /pools/{id}/members             # 멤버 추가 (역할 포함)
POST   /pools/{id}/memories            # 공유 메모리 기여
POST   /pools/{id}/retrieve            # 풀 전체에서 회상

http://localhost:3033/graph?memoryId=42&userId=alex&depth=2

# 공간 컨텍스트와 함께 저장
store_memory(
    "Alex는 Python에서 탭보다 공백을 선호합니다",
    importance=0.9, category="fact",
    context_paths=["/projects/backend"],
)

# 다음 세션 — 해당 디렉토리에서 작업할 때 공간 부스트 작동
recall_memory("Python 서식", current_path="/projects/backend")
# → {"content": "Alex는 Python에서 탭보다 공백을 선호합니다", "strength": 0.87}

yourmemory ask "이 프로젝트는 어떤 데이터베이스를 사용하나요"
# → YourMemory는 로컬에서 DuckDB를, 프로덕션에서 Postgres를 사용합니다.

yourmemory ask "kubernetes 배포를 어떻게 수정하나요"
# → LLM 없이 답변하기에 충분한 메모리 컨텍스트가 없습니다.

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-ant-...",
    base_url="http://localhost:3033/proxy/anthropic",
    default_headers={"X-YourMemory-User": "alex"},  # 사용자별 메모리
)

# 메모리가 자동으로 주입됩니다 — 다른 변경 사항 없음
response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "내가 사용하는 데이터베이스는 무엇인가요?"}],
)

flowchart LR
    C["AI 클라이언트<br/>Claude · Cursor · 모든 MCP"] <--> Y["🧠 YourMemory"]
    Y --> M[("메모리<br/>저장소")]
    Y --> A[("감사<br/>원장")]
    style Y fill:#0a2540,stroke:#19cdff,color:#fff
    style M fill:#0c1a2c,stroke:#5eead4,color:#fff
    style A fill:#0c1a2c,stroke:#5eead4,color:#fff

pkill -f yourmemory 2>/dev/null || true
rm -f ~/.yourmemory/memories.duckdb.wal ~/.yourmemory/memories.duckdb.lock 2>/dev/null || true
# 클라이언트 재시작