mcp-agents-memory 0.9.6 → 0.9.10

package/.env.example

@@ -110,3 +110,32 @@ FORGETTING_ENABLED=false
 FORGETTING_WARMUP_MIN=30
 FORGETTING_INTERVAL_MIN=1440
 FORGET_THRESHOLD=0.5
+
+# Project Alias Promoter (Stage 2) — cold path alias suggestions; default OFF, auto-apply requires explicit opt-in.
+PROJECT_ALIAS_PROMOTER_ENABLED=false
+PROJECT_ALIAS_PROMOTER_INTERVAL_HOURS=24
+PROJECT_ALIAS_AUTO_APPLY=false
+
+# ─────────────────────────────────────────────────────────────
+# Local LLM (ollama) — API 비용 없이 추론 가능한 역할에 적용
+# 대상: AMD RX 6800 XT (gfx1030, 16GB VRAM) + ROCm 7.1
+#
+# 설치:  bash scripts/setup_local_llm.sh
+# 벤치:  npx tsx scripts/bench_local_tagger.ts
+# ─────────────────────────────────────────────────────────────
+
+# ollama 서버 주소 (기본: localhost:11434)
+# LOCAL_LLM_BASE_URL=http://localhost:11434/v1
+
+# 태거를 로컬 모델로 교체 (기본: xai/grok)
+# 벤치 PASS 모델: qwen2.5:7b (100% JSON 성공, avg 754ms)
+# qwen3.x 계열은 ollama에서 thinking 비활성화 불가 → content 빈 버그 있음
+# TAGGER_PROVIDER=local
+# TAGGER_MODEL=qwen2.5:7b
+
+# 라이브러리언을 로컬 모델로 교체 (Librarian v2 구현 후 활성화)
+# LIBRARIAN_PROVIDER=local
+# LIBRARIAN_MODEL=qwen3.6:35b-a3b
+
+# 로컬 모델 실패 시 grok으로 자동 fallback (기본: true)
+# LOCAL_GROK_FALLBACK=true

package/README.md

@@ -109,7 +109,11 @@ search_memory({
   query?: string,        // 의미 검색 (vector + ILIKE fallback)
   p_tag?: string,        // 특정 프로젝트로 한정
   date_range?: string,   // 기간 한정 (예: "2026-04-29..", "last_week")
-  role?: 'user' | 'assistant',  // form 발화만 / assistant 발화만 (기본 둘 다)
+  role?: 'user' | 'assistant',  // user 발화만 / assistant 발화만 (기본 둘 다)
+  agent_platform?: string,      // 플랫폼 한정 (예: 'claude-code'). 생략 또는 '*' = 전 플랫폼
+  device_scope?: 'local' | 'global',  // 'global'(기본)=전 기기 / 'local'=현재 기기(pinned은 기기 무관)
+  limit?: number,        // 최대 결과 수 (기본 10, 최대 50)
+  include_archived?: boolean,   // archived 메모리 포함 (기본 false)
 })
 ```
 
@@ -139,7 +143,7 @@ manage_knowledge({
 | **Tagger (Cold Path)** | Google `gemini-2.5-flash` (predefined + dynamic) |
 | **검색 fallback** | PostgreSQL `ILIKE` (cosine 임계값 미만 시) |
 | **DB** | PostgreSQL + pgvector |
-| **Librarian (memory → user)** | TBD (form vision 결정 후) |
+| **Librarian (memory → user)** | local `qwen3.6:35b-a3b` (Q4_K_M, ollama) — 30 메시지 + 24h 게이트 |
 | **Skill 시스템** | TBD (다음 라운드) |
 
 ---
@@ -192,7 +196,7 @@ AGENT_KEY=...                      # 옵션, multi-persona 구분용
 | Librarian 구현 (memory → user.core/sub_profile promote) | ✅ Done |
 | MCP Tools (`search_memory` + `manage_knowledge`) | ✅ Done |
 | Migration (legacy ~3582 row → archive 보존 + 재임베딩) | ✅ Done |
-| 핵심 정체성 promote (user.core_profile / sub_profile) | ✅ Done — Librarian draft + form review |
+| 핵심 정체성 promote (user.core_profile / sub_profile) | ✅ Done — Librarian v2 (gate + null guard + JSON-in-string guard, qwen3.6:35b-a3b) |
 | Skill 트랙 정리 | ⏳ form 결정 보류, 차후 |
 
 ---
@@ -201,7 +205,7 @@ AGENT_KEY=...                      # 옵션, multi-persona 구분용
 
 - [`RESPEC.md`](./RESPEC.md) — 현재 vision + 회의 결정사항 + 구현 detail (단일 진실 원천)
 - [`SPEC.md`](./SPEC.md) — 구 SPEC (v0.x 역사 보존, 일부 §3.4 Memory Tier가 본 vision의 원형)
-- [`PROBLEMS.md`](./PROBLEMS.md) — 현재 진행 중 cleanup 단계 / 진단 결과
+- [`DEVLOG.md`](./DEVLOG.md) — 운영 이슈, 관찰 로그, 아이디어 적립
 
 ---
 

package/RESPEC.md

@@ -128,9 +128,13 @@ Tokens $0.50/ 1M tokens
 
 
 
-**Librarian**
+**Librarian** ✅ v2 완성 (2026-05-22)
 
 - memory table 에서 필요한 user 테이블용 정보를 선별해서 user 테이블에 저장
+- 모델: `qwen3.6:35b-a3b` (local/ollama, Q4_K_M) — thinking 허용, max_tokens=32768
+- 게이트: `LIBRARIAN_ENABLED=true` + 30 새 메시지 + 24h 쿨다운
+- 실패 방어: attempt 시 `last_run_at` 즉시 기록 (hammer 방지), null guard, JSON-in-string guard
+- Cold Path worker tick마다 `maybeRunLibrarian()` 호출 (migration 023)