Skip to content

v2.19.0

Choose a tag to compare

@github-actions github-actions released this 07 Apr 13:42

Temporal Knowledge, Contradiction Detection, Agent Diaries & Cross-Session Search

Added — Knowledge Intelligence

  • Temporal facts — All facts now track valid_from/valid_until timestamps. When a high-confidence fact changes, the old value is archived (not deleted) with full history
  • Contradiction detectionctx_knowledge(action=remember) automatically detects when a new fact conflicts with an existing high-confidence fact, reporting severity (low/medium/high) and resolution
  • Confirmation tracking — Facts that are re-asserted gain increasing confirmation_count, boosting their reliability score
  • Knowledge roomsctx_knowledge(action=rooms) lists all knowledge categories (rooms) with fact counts, providing a MemPalace-like structured overview
  • Timeline viewctx_knowledge(action=timeline, category="...") shows the full version history of facts in a category, including archived values with validity ranges
  • Cross-session searchctx_knowledge(action=search, query="...") searches across ALL projects and ALL past sessions for matching facts, findings, and decisions
  • Wake-up briefingctx_knowledge(action=wakeup) returns a compact AAAK-formatted briefing of the most important project facts
  • AAAK format — Compact knowledge representation (CATEGORY:key=value★★★|key2=value2★★) used in LLM instructions instead of verbose prose, saving ~60% tokens

Added — Agent Diaries

  • Persistent agent diariesctx_agent(action=diary, category=discovery|decision|blocker|progress|insight) logs structured entries that persist across sessions at ~/.lean-ctx/agents/diaries/
  • Diary recallctx_agent(action=recall_diary) shows the 10 most recent diary entries for an agent with timestamps and context
  • Diary listingctx_agent(action=diaries) lists all agent diaries across the system with entry counts and last-updated times

Added — Wake-Up Context

  • ctx_overview wake-up briefingctx_overview now automatically includes a compact briefing at session start: top project facts (AAAK), last task, recent decisions, and active agents — zero configuration needed

Changed

  • Knowledge block in LLM instructions now uses AAAK compact format instead of verbose prose, reducing knowledge injection tokens by ~60%
  • MCP tool descriptions updated for ctx_knowledge (12 actions) and ctx_agent (11 actions) to document all new capabilities

Upgrade

cargo install lean-ctx          # or
npm update -g lean-ctx-bin      # or
brew upgrade lean-ctx

Full Changelog: v2.19.0...v2.19.0