@agenr/openclaw-plugin 0.11.3 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,78 @@
 # Changelog
 
+## [0.12.0] - 2026-03-20
+
+### Ingestion Overhaul
+
+- **Unified extraction pipeline.** Consolidated `src/extractor/` and `src/app/extract/` into `src/app/ingest/extraction/`. Removed legacy extraction runtime infrastructure and redundant module exports.
+- **Claim extraction enabled by default.** Structured claims (subject/attribute/predicate/object) are now extracted during ingest without requiring `--claims`. Added embedding validation for extracted entries.
+- **Batch claim extraction.** New batch mode for `backfill-claims` and eval commands processes multiple entries per LLM call.
+- **Within-batch dedup renamed and simplified.** Renamed pre-store dedup to within-batch dedup. Removed the DB-based deduplication layer — online store-time dedup handles cross-batch conflicts.
+- **Token usage tracking.** Threaded `tokenUsageTracker` through the full ingest pipeline for per-run cost reporting.
+- **Per-file and workflow timing breakdowns.** Ingest now reports extraction, queue wait, and store exec timing per file and in the summary. Wall-clock timing alongside cumulative timing shows the benefit of parallel workers.
+- **Per-file project inference.** When `--project` is not specified, each file infers its project from transcript metadata (session project block → cwd detection → label mapping → agent store projects). Matches watcher behavior.
+- **Source classification for ingest entries.** Entries extracted via `ingest` now get `source_class: "cli"` instead of being misclassified as `"watcher"`.
+- **Dedup quality warning tracking.** Expanded valuation negative signals and added tracking for dedup quality warnings in ingest results.
+- **Claim extraction config controls.** Added `claims` and `claimExtractionConcurrency` config fields to normalize ingest result reporting.
+
+### Session Metadata Enrichment
+
+- **Agent-stored entries as extraction seeds.** The OpenClaw adapter now parses successful `agenr_store` tool calls from session files, correlating with tool results to confirm success. These pre-validated entries seed the extraction LLM's "previously extracted" context, preventing duplicate/inferior re-extraction.
+- **Enhanced tool call summaries.** `agenr_store` → `[attempted brain store: decision: "subject" project=X]`, `agenr_recall` → `[recalled from brain: "query" project=X]`, `sessions_spawn` → `[spawned sub-agent: label (mode model=X)]`. Replaces generic one-liners with structured summaries.
+- **Session project parsing.** The OpenClaw adapter extracts `sessionProject` from the injected `current_session_project:` block in the first user message. Three-value semantics: string (authoritative project), null (explicitly none), undefined (not found).
+- **Models used tracking.** Collects all models from session records, model_change records, and assistant messages into `metadata.modelsUsed`.
+- **Project fallback chain.** `resolveFallbackProjectFromMetadata` now checks: session project → cwd detection (gated against configured projects) → session label mapping → agent store projects (unanimous only).
+- **Configured project slug validation.** Detected projects from `cwd` are now gated against configured project slugs. Random git repos (like `~/.openclaw/workspace`) no longer create phantom projects.
+
+### Maintenance Overhaul
+
+- **Removed edge-decay and clusters tasks.** Eliminated cluster scoring and graph-based edge-decay from the maintain workflow.
+- **Removed reflection synthesis.** Removed synthetic recall generation and the reflection synthesis system.
+- **Removed auto-resolve confidence threshold.** Simplified conflict resolution by removing the automatic resolution path.
+- **Deterministic retirement.** Added a deterministic retirement path for clearly stale entries with conflict-based protection for entries under active dispute.
+- **Recall recency grace periods.** Added grace periods to db audit retirement that protect recently-recalled entries from premature retirement.
+- **Configurable forgetting threshold.** Added `forgetting.lowScoreTriggerCount` config field for auto-forgetting trigger and improved retirement field consistency.
+
+### Consolidation Overhaul
+
+- **Migrated consolidation to `src/app/consolidate/`.** Moved from top-level into the app domain with updated documentation.
+- **Post-merge claim normalization.** Consolidation merges now re-extract structured claims and validate subject specificity.
+- **Removed cluster and graph scoring.** Recall scoring no longer uses cluster membership or graph augmentation signals.
+- **Replaced multiplicative recall scoring.** Switched from multiplicative to signal-averaging for recall score composition. Added recall engagement reporting.
+
+### Watcher Improvements
+
+- **OpenClaw watcher demotion policy.** Watcher-extracted entries from OpenClaw sessions get capped importance and temporary expiry with auto-retirement tracking and session metrics reporting.
+- **Source-aware watcher deferral.** Watcher now defers to tool-stored entries for the same session, with tracking and reporting of deferral decisions.
+- **Session key threading.** OpenClaw `session_key` is threaded through the watcher workflow into store options for cross-surface correlation.
+- **Watcher report command.** New `watcher-report` command analyzes tool/watcher overlap, coverage gaps, and readiness for transition from watcher to tool-primary ingestion.
+
+### Store Pipeline
+
+- **Source classification columns.** Added `source_class` and `session_key` columns to the entries table with normalized source classification.
+- **Batch store lookups.** Added batch lookup methods to the store repository with precomputed dedup resolutions.
+- **Entity normalization.** Added entity normalization during ingest extraction with entity hint threading through the dedup workflow.
+- **Per-task context types.** Replaced monolithic `TaskExecutionContext` with per-task context types and type-safe task dispatch in the maintain orchestrator.
+
+### Audit & Diagnostics
+
+- **DB audit command.** New `db audit` command for legacy structural and quality issue cleanup.
+- **Importance inflation audit.** Added per-entry attribution and preview logging for importance inflation detection.
+- **Contradiction blocking tracking.** Added infrastructure for tracking and reporting contradiction blocking decisions.
+- **Shadow threshold telemetry.** Added multi-threshold analysis for contradiction audit shadow thresholds.
+- **Unresolved reference detection.** Improved detection of dead cross-references with weak self-containedness signal in valuation.
+
+### Fixed
+
+- **Vector index rebuild.** Fixed libsql vector index rebuild not populating the shadow table after `DROP INDEX` + `CREATE INDEX`. Added `UPDATE entries SET embedding = embedding` to force re-indexing of existing rows.
+- **`resolveStoreKnownProjects` using paths instead of slugs.** Fixed the function to extract `.project` values from config instead of using directory path keys.
+- **Removed `"workspace"` from `DEFAULT_KNOWN_PROJECTS`.** Prevented phantom project inference from the OpenClaw workspace `.git` directory.
+
+### Dependencies
+
+- Updated `@mariozechner/pi-ai` to 0.60.0.
+- Fixed `streamSimple` import to use package root instead of dist path.
+
 ## [0.11.3] - 2026-03-18
 
 ### Fixed

package/README.md

@@ -253,7 +253,6 @@ This exposes four MCP tools: `agenr_recall`, `agenr_extract`, `agenr_retire`, an
 | `agenr config` | Show and update agenr configuration |
 | `agenr auth` | Authentication status and diagnostics |
 | `agenr ingest <paths...>` | Bulk-ingest files and directories |
-| `agenr synthetic` | Generate synthetic recall signals from existing DB entries (no re-ingest required) |
 | `agenr extract <files...>` | Extract knowledge entries from text files |
 | `agenr store [files...]` | Store entries with semantic dedup |
 | `agenr recall [query]` | Semantic + memory-aware recall. Use `--since`/`--until` for date ranges, `--around` for target-date ranking, `--browse` for temporal mode. |