agenr 0.9.41 → 0.9.43

package/CHANGELOG.md

@@ -1,5 +1,61 @@
 # Changelog
 
+## 0.9.43 (2026-03-02)
+
+### Features
+
+- Embedding-based clustering fallback for orphan entries (#387)
+  - Assigns orphans to nearest existing cluster by embedding similarity
+  - Forms new clusters from orphans with similar embeddings
+  - Configurable similarity threshold (default 0.72), max cluster size (default 50)
+  - New `method` column on clusters table (`co_recall` | `embedding`)
+  - Reports fallback stats in detectAndStoreClusters result
+
+### Bug Fixes
+
+- Replace sigmoid scoring compression with sqrt for better score differentiation (#390)
+  - Old formula squashed all scores into 0.22-0.26 band (0.033 spread)
+  - New sqrt compression gives 0.50-0.67 range (0.17 spread, 5x improvement)
+  - FTS bonus moved from additive post-compression (0.15) to multiplicative pre-compression (1.3x)
+  - Importance/recall blend (70/30) replaces MAX - recall history now always contributes
+- Apply --limit flag to reflection task cluster count (#385)
+- Tighten extraction importance calibration to reduce inflation (#391)
+  - Added stronger downward pressure in calibration text
+  - Rebalanced examples: two 8s lowered to 7, added importance-6 example
+  - Production showed 30.7% of entries at 8+ vs 20% target
+
+### Tests
+
+- 8 new tests for embedding fallback clustering
+- 3 new tests for scoring (spread, FTS proportionality, recall contribution)
+- 1 new test for reflection limit enforcement
+
+## 0.9.42 (2026-03-02)
+
+### Features
+- **Periodic reflection and synthesis** (#269): New `reflection` maintain task that
+  synthesizes clusters of related entries into higher-level reflections using
+  two-step LLM prompting (question generation + synthesis) with a verification pass.
+  Source entries are importance-demoted (not retired) so raw knowledge remains
+  accessible. Co-recall edges are transferred to reflection entries for graph
+  continuity.
+- New entry type: `reflection` for synthesized knowledge
+- New `reflections` table for process metadata
+- Extended `entry_sources` with `action` column for unified provenance tracking
+- New `--full` flag for full-brain reflection (ignores change detection)
+- Configurable: reflection model, verification model, coverage threshold, demotion
+  amount, importance threshold, cluster size minimum
+- Re-synthesis guards: minimum cumulative importance threshold for changed entries
+
+### Bug Fixes
+- Fix parseSynthesisResponse bailing on first JSON candidate instead of trying alternatives
+- Fix verification prompt missing explicit check instructions
+- Fix demoteEntryImportance/retireReflectionEntry using wall clock instead of injected time
+- Fix transferCoRecallEdges silently dropping stronger edges (now uses MAX weight)
+- Fix verification ignoring the verified boolean (only checked coverage_score)
+- Extract shared JSON parsing utilities to reduce duplication
+- Add cluster churn detection for re-synthesis safety
+
 ## 0.9.41 - 2026-03-01
 
 ### Fixed