Commit Graph
8 Commits
Author SHA1 Message Date
poimenandrock fb61de6b47 feat: LLM entity + fact extraction pipeline (Zep paper alignment) (#48)
CI / CI (push) Successful in 12m9s
Deploy / Tag & Push Latest (push) Failing after 41s
DB Migration / Run Migrations (push) Failing after 18s
## Changes

### Entity Extraction
- Switch from WikiLinkFallbackExtractor to LlmEntityExtractor when LLM_ENDPOINT set
- `clean_llm_response()`: strips `<think>` tags, markdown fences, extracts JSON
- Handle array responses (Ollama returns `[...]` not `{entities: [...]}`)
- EntityType custom Deserialize: unknown variants → Unknown (no crash)
- Increase timeout 30s→90s, max_tokens 500→1500 for reasoning models
- Graceful reflection fallback: keep entities if verification fails

### Fact Extraction (NEW)
- LlmFactExtractor: LLM-based relationship extraction between entity pairs
- Validates source/target against known entity list (drops hallucinated edges)
- Same robust JSON cleaning for reasoning models + Ollama
- IngestWorker auto-selects LLM vs Simple based on LLM_ENDPOINT env

### K8s Deployment
- Add `command: ["/app/mem"]` (fix args replacing CMD)
- Add LLM_ENDPOINT, LLM_MODEL env vars for in-cluster LLM

## E2E Tested (local Ollama qwen2.5:3b)
- 12 entities extracted (person, tool, concept, organization)
- 5 edges with relationships and facts
- 781 tests pass

## Zep Paper Alignment (§2.2)
- Entity extraction + resolution (§2.2.1)
- Fact extraction between entity pairs (§2.2.2)
- Temporal edge invalidation ready (t_valid/t_invalid schema)
- Reflection verification (§2.2.1, graceful fallback)

---------

Co-authored-by: rock <[email protected]>
Reviewed-on: #48
Co-authored-by: poimen <[email protected]>
2026-09-11 01:11:15 +00:00
Story Crater Bot d4b70dae0c chore: Remove CLAUDE.md from tracking, add to .gitignore
CLAUDE.md is session memory, not service-driven documentation.
Should not be committed to the repository.
2026-08-27 13:40:59 -07:00
Story Crater Bot 0fa9ba2801 docs: Update CLAUDE.md with M3.5.10 JWT auth completion 2026-08-27 13:20:57 -07:00
Story Crater Bot 0c3c14119e docs: Update deployment status after push to cluster (ArgoCD synced) 2026-08-26 13:59:08 -07:00
Story Crater Bot c4fdf36e5f Implement M4.1: Skill draft command + 10 tests (229 total) 2026-08-26 13:50:22 -07:00
Story Crater Bot f05565edd0 Implement M3.5.7: Rate limiting + idempotency (20 tests) 2026-08-26 13:35:50 -07:00
Story Crater Bot 2347d785db Add ArgoCD Application for auto-deployment (poimen-memory-app) 2026-08-23 09:46:58 -07:00
Story Crater Bot d365b35617 Session summary: M3.6.1 complete (196 tests, heading-boundary chunking) 2026-08-23 09:43:37 -07:00