Release 3.0.8

Author: CodeAbra

CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.0.8] - 2026-08-23
+
+### Fixed
+- `iai-mcp capture-hooks status` relabels the Claude Desktop line to
+  "Claude Desktop MCP tools:" so it no longer implies ambient capture hooks
+  are wired when the check only reflects MCP server registration. Reported
+  by @oscampo (#114).
+- README doctor table now lists all 33 checks, adding `dd` (exact-index
+  coercions) and `ee` (deferred-capture backlog at rest). Reported by
+  @oscampo (#113).
+
 ## [3.0.7] - 2026-08-21
 
 ### Security

README.md

@@ -7,7 +7,7 @@
 <h3 align="center">Give your coding agent a brain that remembers exactly what you said — forever, on your machine.</h3>
 <p align="center"><b>The best open-source personal memory engine for AI coding assistants.</b><br>Pays for itself in tokens: an injected memory pack costs ≈88% less than the agent search it displaces.<br>Every claim ships with the harness that proves it — run the benchmarks yourself.</p>
 
-<p align="center"><a href="https://pypi.org/project/iai-pme/"><img src="https://img.shields.io/pypi/v/iai-pme?style=flat-square&color=1f6feb&label=pypi&v=281" alt="iai-pme on PyPI"></a> <img src="https://img.shields.io/badge/release-v3.0.7-1f6feb?style=flat-square" alt="Release v3.0.7"> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-1f6feb?style=flat-square" alt="License: MIT"></a> <img src="https://img.shields.io/badge/python-3.11%20|%203.12-3776ab?style=flat-square&logo=python&logoColor=white" alt="Python 3.11 | 3.12"> <img src="https://img.shields.io/badge/platform-macOS%20|%20Linux-555?style=flat-square" alt="Platform: macOS and Linux"> <img src="https://img.shields.io/badge/Windows-beta-dbab09?style=flat-square&logo=windows&logoColor=white" alt="Windows: beta"> <img src="https://img.shields.io/badge/engine-Rust%20native-dea584?style=flat-square&logo=rust&logoColor=black" alt="Rust-native engine"></p>
+<p align="center"><a href="https://pypi.org/project/iai-pme/"><img src="https://img.shields.io/pypi/v/iai-pme?style=flat-square&color=1f6feb&label=pypi&v=281" alt="iai-pme on PyPI"></a> <img src="https://img.shields.io/badge/release-v3.0.8-1f6feb?style=flat-square" alt="Release v3.0.7"> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-1f6feb?style=flat-square" alt="License: MIT"></a> <img src="https://img.shields.io/badge/python-3.11%20|%203.12-3776ab?style=flat-square&logo=python&logoColor=white" alt="Python 3.11 | 3.12"> <img src="https://img.shields.io/badge/platform-macOS%20|%20Linux-555?style=flat-square" alt="Platform: macOS and Linux"> <img src="https://img.shields.io/badge/Windows-beta-dbab09?style=flat-square&logo=windows&logoColor=white" alt="Windows: beta"> <img src="https://img.shields.io/badge/engine-Rust%20native-dea584?style=flat-square&logo=rust&logoColor=black" alt="Rust-native engine"></p>
 <p align="center"><img src="https://img.shields.io/badge/LongMemEval%20R%405-0.962-2ea043?style=flat-square" alt="LongMemEval R@5 0.962"> <img src="https://img.shields.io/badge/Rescue%4010-1.000-2ea043?style=flat-square" alt="Rescue@10 1.000"> <img src="https://img.shields.io/badge/memory_pack-%E2%89%8888%25_cheaper_than_search-2ea043?style=flat-square" alt="An injected memory pack costs ≈88% less than the agent search it displaces"> <img src="https://img.shields.io/badge/at%20rest-AES--256--GCM-2ea043?style=flat-square" alt="AES-256-GCM"> <img src="https://img.shields.io/badge/local--only-no%20telemetry-2ea043?style=flat-square" alt="Local only, no telemetry"> <img src="https://img.shields.io/badge/MCP-compatible-8957e5?style=flat-square" alt="MCP compatible"> <a href="https://glama.ai/mcp/servers/CodeAbra/iai-mcp"><img src="https://glama.ai/mcp/servers/CodeAbra/iai-mcp/badges/score.svg" alt="Glama MCP score"></a></p>
 <p align="center"><a href="#quick-start"><b>Quick start</b></a> · <a href="#benchmarks"><b>Benchmarks</b></a> · <a href="#watch-it-think"><b>Dashboard</b></a> · <a href="https://github.com/CodeAbra/iai-personal-memory-engine/discussions"><b>Discussions</b></a> · <a href="./README_zh-CN.md"><b>中文</b></a></p>
 
@@ -461,7 +461,7 @@ iai-mcp    doctor · self-update · daemon {install,start,stop,restart,logs,paus
 
 `entity-backfill` derives `entity:` anchor tags from records captured before anchoring shipped, so names in old turns become matchable; `--refresh` recomputes the whole corpus. `blob-quarantine` tombstones machine-notification blobs that drown real records on any cue sharing their vocabulary. Both are dry-run by default and journal every change when applied.
 
-`doctor` runs 31 checks and repairs: `--apply` prompts before anything touching the store and renames corrupt state aside rather than deleting it; `--auto` is the unattended read-only subset your assistant invokes when the socket is unreachable 10s into a session. `self-update` upgrades the wheel, restarts the daemon and verifies by querying the running engine's version; it refuses source checkouts and leaves the running engine untouched if pip fails.
+`doctor` runs 33 checks and repairs: `--apply` prompts before anything touching the store and renames corrupt state aside rather than deleting it; `--auto` is the unattended read-only subset your assistant invokes when the socket is unreachable 10s into a session. `self-update` upgrades the wheel, restarts the daemon and verifies by querying the running engine's version; it refuses source checkouts and leaves the running engine untouched if pip fails.
 
 ### Deployment surface
 
@@ -647,7 +647,7 @@ config file is something you can read.
 
 ## Doctor
 
-`iai-mcp doctor` runs 31 checks against the local engine, the store, the native engine, and the runtime state. Output is one line per check: PASS, WARN, or FAIL.
+`iai-mcp doctor` runs 33 checks against the local engine, the store, the native engine, and the runtime state. Output is one line per check: PASS, WARN, or FAIL.
 
 It also repairs what it finds. `--apply` walks the repairs it can make and asks before anything that touches your memory; corrupt state files and vector indexes are renamed aside so the engine rebuilds them, never deleted. `--auto` is the unattended subset — no prompts, no killed processes, no changes to the store — and your assistant runs it for you if the engine is still unreachable ten seconds into a session. In practice a stalled engine now fixes itself before you notice it stalled.
 
@@ -658,7 +658,7 @@ iai-mcp doctor
 ```
 
 <details>
-<summary><b>All 31 checks, one line each</b></summary>
+<summary><b>All 33 checks, one line each</b></summary>
 
 What it checks:
 
@@ -686,11 +686,13 @@ What it checks:
 | t | hippo_compacted freshness | Compaction has run recently |
 | u | recall centrality regression | Recall ranking hasn't regressed |
 | v | configured embedder | The embedder the store is configured for is built and produces vectors |
+| dd | exact-index coercions | No non-finite (NaN/inf) vectors have been coerced to zero at the exact-cosine index |
 | w | no permanent-failed captures | No capture is stuck after exhausting its retries |
 | x | timestamps not collapsed | Record timestamps span a real range, not all-identical |
 | y | RSS 24h plateau | Resident memory has settled rather than climbing across the last day |
 | z | AVX2 CPU support | CPU supports the instructions the native libs need |
 | aa | capture-state hygiene | No stale or half-written files left in the capture-state directory |
+| ee | deferred-capture backlog at rest | No undrained events sitting in the deferred-capture spool |
 | bb | nightly insight mint | The nightly pass is actually minting insights, not just running |
 | cc | background liveness | Background sleep steps have completed over the last week |
 | ii | store embed identity | The store's vector-identity stamp matches the embedder the runtime would use |

README_zh-CN.md

@@ -14,7 +14,7 @@
 <p align="center">每一项声明都附带可复现的基准测试脚本。你可以自己跑一遍验证。</p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/release-v3.0.7-1f6feb?style=flat-square" alt="Release v3.0.7">
+  <img src="https://img.shields.io/badge/release-v3.0.8-1f6feb?style=flat-square" alt="Release v3.0.7">
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-1f6feb?style=flat-square" alt="License: MIT"></a>
   <img src="https://img.shields.io/badge/python-3.11%20|%203.12-3776ab?style=flat-square&logo=python&logoColor=white" alt="Python 3.11 | 3.12">
   <img src="https://img.shields.io/badge/platform-macOS%20|%20Linux-555?style=flat-square" alt="Platform: macOS and Linux">
@@ -226,7 +226,7 @@ tail ~/.iai-mcp/logs/capture-$(date -u +%Y-%m-%d).log
 
 - **基准测试细节**（LongMemEval-S 对比 mempalace、Rescue@10、漂移、整合、延迟、内存占用） → [README.md#benchmarks](./README.md#benchmarks)
 - **配置项**（环境变量、调优旋钮） → [README.md#configuration](./README.md#configuration)
-- **Doctor 自检**（31 项健康检查清单） → [README.md#doctor](./README.md#doctor)
+- **Doctor 自检**（33 项健康检查清单） → [README.md#doctor](./README.md#doctor)
 - **故障排查** → [README.md#troubleshooting](./README.md#troubleshooting)
 - **状态与限制** → [README.md#status-and-limitations](./README.md#status-and-limitations)
 - **兼容性**（Claude Code / Codex CLI / Gemini CLI / Cursor CLI / Claude Desktop） → [README.md#compatibility](./README.md#compatibility)

mcp-wrapper/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iai-mcp-wrapper",
-  "version": "3.0.7",
+  "version": "3.0.8",
   "description": "TypeScript MCP wrapper for IAI-MCP Python core",
   "author": "Areg Noya",
   "type": "module",

mcp-wrapper/src/index.ts

@@ -78,7 +78,7 @@ export function buildServer(
   const server = new Server(
     {
       name: "iai-mcp",
-      version: "3.0.7",
+      version: "3.0.8",
     },
     {
       capabilities: { tools: {} },

mcp-wrapper/src/lifecycle.ts

@@ -26,7 +26,7 @@ export const SOCKET_PROBE_DELAY_MS = 2_000;
 
 export const HEARTBEAT_SCHEMA_VERSION = 1;
 
-export const WRAPPER_VERSION = "3.0.7";
+export const WRAPPER_VERSION = "3.0.8";
 
 const LAUNCHCTL_BIN = "/bin/launchctl";
 

plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "iai-memory",
   "displayName": "iai-pme — personal memory engine",
-  "version": "3.0.7",
+  "version": "3.0.8",
   "description": "Persistent local memory for your assistant: every turn captured verbatim, relevant memory injected at session start and before each turn, and fifteen memory tools over MCP. Requires the iai-pme package (pip install iai-pme).",
   "author": {
     "name": "Areg Aramovich Noya",

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "iai-pme"
-version = "3.0.7"
+version = "3.0.8"
 description = "MCP server giving Claude persistent autistic-style memory + learning"
 authors = [{ name = "Areg Noya" }]
 requires-python = ">=3.11,<3.13"

src/iai_mcp/cli/_capture.py

@@ -1183,18 +1183,18 @@ def _installed_state(template, installed) -> str:
 
     desktop_cfg = _cli._claude_desktop_config_path()
     if desktop_cfg is None:
-        desktop_line = "Claude Desktop: not installed"
+        desktop_line = "Claude Desktop MCP tools: not installed"
         desktop_wired = False
     elif not desktop_cfg.exists():
-        desktop_line = f"Claude Desktop: {desktop_cfg} MISSING"
+        desktop_line = f"Claude Desktop MCP tools: {desktop_cfg} MISSING"
         desktop_wired = False
     else:
         try:
             d = _json.loads(desktop_cfg.read_text(encoding="utf-8"))
             desktop_wired = "iai-mcp" in d.get("mcpServers", {})
-            desktop_line = f"Claude Desktop: {desktop_cfg}  {'WIRED' if desktop_wired else 'NOT WIRED'}"
+            desktop_line = f"Claude Desktop MCP tools: {desktop_cfg}  {'WIRED' if desktop_wired else 'NOT WIRED'}"
         except (OSError, ValueError):
-            desktop_line = f"Claude Desktop: {desktop_cfg} (unreadable)"
+            desktop_line = f"Claude Desktop MCP tools: {desktop_cfg} (unreadable)"
             desktop_wired = False
     print(desktop_line)
 
@@ -1208,7 +1208,7 @@ def _installed_state(template, installed) -> str:
 
     if ok and not desktop_problem:
         print(f"\nstatus: ACTIVE — Stop + UserPromptSubmit + SessionStart + per-turn hooks wired "
-              f"(Claude Code{'; Desktop also wired' if desktop_wired else ''})")
+              f"(Claude Code{'; Desktop MCP tools also wired' if desktop_wired else ''})")
         return 0
     msg = []
     if not ok:

tests/test_iai_cli_version.py

@@ -6,7 +6,7 @@
 
 import pytest
 
-EXPECTED_VERSION = "3.0.7"
+EXPECTED_VERSION = "3.0.8"
 
 
 def test_canonical_version_is_expected():