agenr 0.9.46 → 0.9.49

package/CHANGELOG.md

@@ -1,5 +1,61 @@
 # Changelog
 
+## 0.9.49 (2026-03-02)
+
+### Features
+
+- Stale reflection detection and invalidation during maintain (#418)
+  - New `stale-reflections` maintain task runs before reflection synthesis
+  - Detects reflections with >50% retired or updated source entries
+  - Retires stale reflections automatically, freeing clusters for re-synthesis
+  - Pure DB queries (no LLM required), respects --dry-run and --apply flags
+  - New DB helpers: getActiveReflections, getSourceEntryStalenessCounts
+
+### Bug Fixes
+
+- Stronger reflection demotion in recall scoring (#410)
+  - Default REFLECTION_DEMOTION lowered from 0.85 to 0.70
+  - Cluster bonus no longer applied to reflection entries (breaks circular boost)
+  - Reflection entries excluded from cluster peer expansion
+- Break recall scoring feedback loop (#414)
+  - recallStrength capped at 0.5 (was 1.0) to prevent recall from dominating scores
+  - Removed RECALL_MILESTONES automatic importance promotion (counts 3, 10, 25)
+  - Importance now only changes via explicit updates or re-extraction
+
+### Tests
+
+- 5 new stale-reflections task tests (retired/updated majority, healthy, dry-run, no sources)
+- 3 new DB-layer tests for staleness detection helpers
+- 2 new cluster bonus tests for reflection skip behavior
+- Updated recall scoring tests for new defaults and removed milestones
+- Updated maintain task ordering tests for new stale-reflections task
+
+## 0.9.48 (2026-03-02)
+
+### Features
+
+- Reflections now inherit and synthesize tags from their source entries (#388)
+  - Tags appearing on 2+ source entries are included (all tags for small clusters)
+  - "reflection" tag always prepended for identifiability
+  - Capped at 10 tags per reflection, sorted by frequency
+  - Fixes FTS/tag-based recall blindness for all reflection entries
+
+### Bug Fixes
+
+- Cap freshness bonus at 1.0 for reflection entries to prevent synthesized
+  summaries from crowding out raw entries in recall results (#410)
+
+### Tests
+
+- 8 new tests for reflection tag inheritance (DB queries + task integration)
+
+## 0.9.47 (2026-03-02)
+
+### Bug Fixes
+
+- Added reflection type demotion in recall scoring (default 0.85x) to prevent reflections from crowding out specific raw entries in recall results
+- Added `scoring.reflectionDemotion` config knob (range 0-1) with normalization and recall score breakdown visibility
+
 ## 0.9.46 (2026-03-02)
 
 ### Improvements