mindforge-memory 6.4.3__tar.gz → 6.4.5__tar.gz

{mindforge_memory-6.4.3/mindforge_memory.egg-info → mindforge_memory-6.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mindforge-memory
-Version: 6.4.3
+Version: 6.4.5
 Summary: AI Agent 终身记忆系统 - 四层记忆架构 · 知识图谱 · 多模态支持
 License: MIT
 Project-URL: Homepage, https://github.com/opok-ops/MindForge
@@ -36,11 +36,11 @@ Dynamic: license-file
 
 MindForge gives AI agents a persistent, structured long-term memory: a four-tier lifecycle model, knowledge graphs, hybrid retrieval, end-to-end encryption, and MCP / CLI / REST interfaces. All data stays on your machine.
 
-> **The story** — one developer, seven months, from v1.0 (March 2026) to v6.4.3: no team, no funding, 1,227 passing tests. [Read the journey →](https://opok-ops.github.io/MindForge/#developer)
+> **The story** — one developer, seven months, from v1.0 (March 2026) to v6.4.5: no team, no funding, 1,232 passing tests. [Read the journey →](https://opok-ops.github.io/MindForge/#developer)
 
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-6.4.3-green.svg)](https://github.com/opok-ops/MindForge/releases)
+[![Version](https://img.shields.io/badge/version-6.4.5-green.svg)](https://github.com/opok-ops/MindForge/releases)
 [![Stars](https://img.shields.io/github/stars/opok-ops/MindForge.svg)](https://github.com/opok-ops/MindForge/stargazers)
 [![Forks](https://img.shields.io/github/forks/opok-ops/MindForge.svg)](https://github.com/opok-ops/MindForge/forks)
 [![Open Issues](https://img.shields.io/github/issues/opok-ops/MindForge.svg)](https://github.com/opok-ops/MindForge/issues)
@@ -96,8 +96,9 @@ MindForge stats
 
 ## What's New
 
-v6.1.3 – v6.4.3 shipped in ten days (2026-11-01 → 11-10), guarded by **1,228 tests** (1,227 passing, 1 environment-skipped).
+v6.1.3 – v6.4.5 shipped in ten days (2026-11-01 → 11-10; two same-day releases), guarded by **1,233 tests** (1,232 passing, 1 environment-skipped).
 
+- **v6.4.5 — audit-driven fixes** (2026-11-10; v6.4.4 skipped by maintainer decision). Two inverse doc-code inconsistencies (v6.4.3 fixed "claimed but not done"; this one fixes "done but not tracked"): `connectors.py` outgoing HTTP User-Agent was hardcoded `MindForge-Connector/5.8.9` — lying about the version to every target site since the 5.8.9 era (`event_bus.py` fixed the same disease in v5.6.8; this one slipped through). Now dynamic from the single version truth. Website "core modules" count was stale (17 in prose, 15 in stat card, 31 measured) — both fixed to the measured 31; MCP tool count 87 verified exact, untouched. Audit archive (not a defect): WAL auto-checkpoint verified healthy under daemon-like load — 4 rounds × 400 mixed ops, WAL converged at ~4.1MB (default 1000-page threshold), TRUNCATE resets to zero. 5 new guards in `tests/test_v645_fixes.py`.
 - **v6.4.3 — documentation-code consistency fix** (2026-11-10). Pre-release audit found that v6.4.2's claimed first cut — WAL + `synchronous=NORMAL` — **never landed in code**: `_get_conn()` set only `journal_mode=WAL`, leaving `synchronous` at SQLite's default FULL. The 2.1× search gain was real, but carried entirely by the other four cuts — real numbers, misattributed cause. This release adds `PRAGMA synchronous=NORMAL` on the WAL branch (per-connection, cross-thread; network-FS DELETE fallback stays FULL by design). Same-machine A/B on SSD shows no statistically significant latency delta (search p50 1.8 → 1.8ms — fsync is ~0.1ms-scale here); the benefit targets slow disks and IO-saturated containers, and more importantly makes the documented power-loss semantics (un-checkpointed access counts / search audits may be lost; compliance audits still commit immediately) actually hold. 4 new guard tests in `tests/test_v643_fixes.py`.
 - **v6.4.2 — tens-of-thousands-chars latency: another 2×** (2026-11-09). Same-machine A/B benchmark (400 memories / ~47k chars, 3 runs each): **search p50 6.3→3.0ms (2.1×), p95 11.7→4.2ms (2.8×)**; 24k-char library p50 2.5ms; fast machine state 1.8ms. Five surgical cuts: WAL + `synchronous=NORMAL` (commits skip per-write fsync), enum-downgrade memo, `row.keys()` set reuse, first-visit access-count batching merged into one `flush_access()` transaction per search, and search-audit INSERT folded into the same commit. The v5.6.3 throttle contract and v5.5.4 `recently_accessed` semantics are pinned by 23 contract tests — all green. Compliance-grade audits still commit immediately. *(Note: the `synchronous=NORMAL` cut landed in v6.4.3 — see above.)*
 - **v6.4.1 — million-character millisecond search** (2026-11-09). Scale benchmark (8,000 memories / ~990k chars) exposed a fuzzy-fallback long tail: search p95 881ms. Root causes: SequenceMatcher wasted on mathematically-impossible matches (ratio = 2M/(m+n), M ≤ m, so n ≥ 4m can never pass 0.4) + a ~50μs/entry Python full-scan tax. Fixed with a math-capped prune + SQLite-level candidate pre-filtering: **search p95 881→30.7ms (28×)**, add p50 2.6ms flat at 10k-scale. New `scripts/bench_scale.py` + CI scale guard (3000 memories, millisecond contract) + 4 behavior-level regression tests pin the semantics.
@@ -167,7 +168,7 @@ v6.1.3 – v6.4.3 shipped in ten days (2026-11-01 → 11-10), guarded by **1,228
 
 ```
 ┌──────────────────────────────────────────────────────┐
-│           MindForge v6.4.3            │
+│           MindForge v6.4.5            │
 │  Cognitive Layer  Personality · KnowledgeGraph       │
 │                   MemoryEvolution · FederatedMemory  │
 ├──────────────────────────────────────────────────────┤

{mindforge_memory-6.4.3 → mindforge_memory-6.4.5}/README.md

@@ -6,11 +6,11 @@
 
 MindForge gives AI agents a persistent, structured long-term memory: a four-tier lifecycle model, knowledge graphs, hybrid retrieval, end-to-end encryption, and MCP / CLI / REST interfaces. All data stays on your machine.
 
-> **The story** — one developer, seven months, from v1.0 (March 2026) to v6.4.3: no team, no funding, 1,227 passing tests. [Read the journey →](https://opok-ops.github.io/MindForge/#developer)
+> **The story** — one developer, seven months, from v1.0 (March 2026) to v6.4.5: no team, no funding, 1,232 passing tests. [Read the journey →](https://opok-ops.github.io/MindForge/#developer)
 
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-6.4.3-green.svg)](https://github.com/opok-ops/MindForge/releases)
+[![Version](https://img.shields.io/badge/version-6.4.5-green.svg)](https://github.com/opok-ops/MindForge/releases)
 [![Stars](https://img.shields.io/github/stars/opok-ops/MindForge.svg)](https://github.com/opok-ops/MindForge/stargazers)
 [![Forks](https://img.shields.io/github/forks/opok-ops/MindForge.svg)](https://github.com/opok-ops/MindForge/forks)
 [![Open Issues](https://img.shields.io/github/issues/opok-ops/MindForge.svg)](https://github.com/opok-ops/MindForge/issues)
@@ -66,8 +66,9 @@ MindForge stats
 
 ## What's New
 
-v6.1.3 – v6.4.3 shipped in ten days (2026-11-01 → 11-10), guarded by **1,228 tests** (1,227 passing, 1 environment-skipped).
+v6.1.3 – v6.4.5 shipped in ten days (2026-11-01 → 11-10; two same-day releases), guarded by **1,233 tests** (1,232 passing, 1 environment-skipped).
 
+- **v6.4.5 — audit-driven fixes** (2026-11-10; v6.4.4 skipped by maintainer decision). Two inverse doc-code inconsistencies (v6.4.3 fixed "claimed but not done"; this one fixes "done but not tracked"): `connectors.py` outgoing HTTP User-Agent was hardcoded `MindForge-Connector/5.8.9` — lying about the version to every target site since the 5.8.9 era (`event_bus.py` fixed the same disease in v5.6.8; this one slipped through). Now dynamic from the single version truth. Website "core modules" count was stale (17 in prose, 15 in stat card, 31 measured) — both fixed to the measured 31; MCP tool count 87 verified exact, untouched. Audit archive (not a defect): WAL auto-checkpoint verified healthy under daemon-like load — 4 rounds × 400 mixed ops, WAL converged at ~4.1MB (default 1000-page threshold), TRUNCATE resets to zero. 5 new guards in `tests/test_v645_fixes.py`.
 - **v6.4.3 — documentation-code consistency fix** (2026-11-10). Pre-release audit found that v6.4.2's claimed first cut — WAL + `synchronous=NORMAL` — **never landed in code**: `_get_conn()` set only `journal_mode=WAL`, leaving `synchronous` at SQLite's default FULL. The 2.1× search gain was real, but carried entirely by the other four cuts — real numbers, misattributed cause. This release adds `PRAGMA synchronous=NORMAL` on the WAL branch (per-connection, cross-thread; network-FS DELETE fallback stays FULL by design). Same-machine A/B on SSD shows no statistically significant latency delta (search p50 1.8 → 1.8ms — fsync is ~0.1ms-scale here); the benefit targets slow disks and IO-saturated containers, and more importantly makes the documented power-loss semantics (un-checkpointed access counts / search audits may be lost; compliance audits still commit immediately) actually hold. 4 new guard tests in `tests/test_v643_fixes.py`.
 - **v6.4.2 — tens-of-thousands-chars latency: another 2×** (2026-11-09). Same-machine A/B benchmark (400 memories / ~47k chars, 3 runs each): **search p50 6.3→3.0ms (2.1×), p95 11.7→4.2ms (2.8×)**; 24k-char library p50 2.5ms; fast machine state 1.8ms. Five surgical cuts: WAL + `synchronous=NORMAL` (commits skip per-write fsync), enum-downgrade memo, `row.keys()` set reuse, first-visit access-count batching merged into one `flush_access()` transaction per search, and search-audit INSERT folded into the same commit. The v5.6.3 throttle contract and v5.5.4 `recently_accessed` semantics are pinned by 23 contract tests — all green. Compliance-grade audits still commit immediately. *(Note: the `synchronous=NORMAL` cut landed in v6.4.3 — see above.)*
 - **v6.4.1 — million-character millisecond search** (2026-11-09). Scale benchmark (8,000 memories / ~990k chars) exposed a fuzzy-fallback long tail: search p95 881ms. Root causes: SequenceMatcher wasted on mathematically-impossible matches (ratio = 2M/(m+n), M ≤ m, so n ≥ 4m can never pass 0.4) + a ~50μs/entry Python full-scan tax. Fixed with a math-capped prune + SQLite-level candidate pre-filtering: **search p95 881→30.7ms (28×)**, add p50 2.6ms flat at 10k-scale. New `scripts/bench_scale.py` + CI scale guard (3000 memories, millisecond contract) + 4 behavior-level regression tests pin the semantics.
@@ -137,7 +138,7 @@ v6.1.3 – v6.4.3 shipped in ten days (2026-11-01 → 11-10), guarded by **1,228
 
 ```
 ┌──────────────────────────────────────────────────────┐
-│           MindForge v6.4.3            │
+│           MindForge v6.4.5            │
 │  Cognitive Layer  Personality · KnowledgeGraph       │
 │                   MemoryEvolution · FederatedMemory  │
 ├──────────────────────────────────────────────────────┤

{mindforge_memory-6.4.3 → mindforge_memory-6.4.5}/mindforge/core/version.py

@@ -20,10 +20,10 @@ core/mindforge.py、cli/main.py、mcp/server.py），每处都带一份硬编码
 from typing import Tuple
 
 #: 当前发布版本（唯一真值）
-__version__: str = "6.4.3"
+__version__: str = "6.4.5"
 
 #: 结构化版本元组，便于比较（如 `VERSION_INFO >= (6, 1, 0)`）
-VERSION_INFO: Tuple[int, int, int] = (6, 4, 3)
+VERSION_INFO: Tuple[int, int, int] = (6, 4, 5)
 
 #: 下一个大版本的目标版本号（供 v6 端口预留引用）
 NEXT_MAJOR_TARGET: str = "7.0.0"

{mindforge_memory-6.4.3 → mindforge_memory-6.4.5}/mindforge/modules/connectors.py

@@ -18,6 +18,10 @@ import ipaddress
 import ssl
 import urllib.parse
 import urllib.request
+
+# v6.4.5: User-Agent 版本动态化（唯一真值 mindforge/core/version.py）。
+# version.py 仅依赖 typing，无循环导入风险。
+from mindforge.core.version import __version__
 from abc import ABC, abstractmethod
 from typing import Any, Dict, List, Optional, Type
 
@@ -308,7 +312,11 @@ class UrlConnector(BaseConnector):
             _FixedIPHTTPSHandler(fixed_ip),
         )
         req = urllib.request.Request(
-            source, headers={"User-Agent": "MindForge-Connector/5.8.9"})
+            # v6.4.5 fix: 此前硬编码 "MindForge-Connector/5.8.9"（5.8.9 时代
+            # 写死后再未跟上），对外请求谎报版本。改为动态引用唯一真值
+            # mindforge/core/version.py（与 event_bus.py / cli URL Importer
+            # 同款模式，v5.6.8 起已验证）。
+            source, headers={"User-Agent": f"MindForge-Connector/{__version__}"})
         with opener.open(req, timeout=kwargs.get("timeout", 15)) as resp:
             content_type = resp.headers.get("Content-Type", "")
             data = _read_limited(resp)

{mindforge_memory-6.4.3 → mindforge_memory-6.4.5/mindforge_memory.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mindforge-memory
-Version: 6.4.3
+Version: 6.4.5
 Summary: AI Agent 终身记忆系统 - 四层记忆架构 · 知识图谱 · 多模态支持
 License: MIT
 Project-URL: Homepage, https://github.com/opok-ops/MindForge
@@ -36,11 +36,11 @@ Dynamic: license-file
 
 MindForge gives AI agents a persistent, structured long-term memory: a four-tier lifecycle model, knowledge graphs, hybrid retrieval, end-to-end encryption, and MCP / CLI / REST interfaces. All data stays on your machine.
 
-> **The story** — one developer, seven months, from v1.0 (March 2026) to v6.4.3: no team, no funding, 1,227 passing tests. [Read the journey →](https://opok-ops.github.io/MindForge/#developer)
+> **The story** — one developer, seven months, from v1.0 (March 2026) to v6.4.5: no team, no funding, 1,232 passing tests. [Read the journey →](https://opok-ops.github.io/MindForge/#developer)
 
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-6.4.3-green.svg)](https://github.com/opok-ops/MindForge/releases)
+[![Version](https://img.shields.io/badge/version-6.4.5-green.svg)](https://github.com/opok-ops/MindForge/releases)
 [![Stars](https://img.shields.io/github/stars/opok-ops/MindForge.svg)](https://github.com/opok-ops/MindForge/stargazers)
 [![Forks](https://img.shields.io/github/forks/opok-ops/MindForge.svg)](https://github.com/opok-ops/MindForge/forks)
 [![Open Issues](https://img.shields.io/github/issues/opok-ops/MindForge.svg)](https://github.com/opok-ops/MindForge/issues)
@@ -96,8 +96,9 @@ MindForge stats
 
 ## What's New
 
-v6.1.3 – v6.4.3 shipped in ten days (2026-11-01 → 11-10), guarded by **1,228 tests** (1,227 passing, 1 environment-skipped).
+v6.1.3 – v6.4.5 shipped in ten days (2026-11-01 → 11-10; two same-day releases), guarded by **1,233 tests** (1,232 passing, 1 environment-skipped).
 
+- **v6.4.5 — audit-driven fixes** (2026-11-10; v6.4.4 skipped by maintainer decision). Two inverse doc-code inconsistencies (v6.4.3 fixed "claimed but not done"; this one fixes "done but not tracked"): `connectors.py` outgoing HTTP User-Agent was hardcoded `MindForge-Connector/5.8.9` — lying about the version to every target site since the 5.8.9 era (`event_bus.py` fixed the same disease in v5.6.8; this one slipped through). Now dynamic from the single version truth. Website "core modules" count was stale (17 in prose, 15 in stat card, 31 measured) — both fixed to the measured 31; MCP tool count 87 verified exact, untouched. Audit archive (not a defect): WAL auto-checkpoint verified healthy under daemon-like load — 4 rounds × 400 mixed ops, WAL converged at ~4.1MB (default 1000-page threshold), TRUNCATE resets to zero. 5 new guards in `tests/test_v645_fixes.py`.
 - **v6.4.3 — documentation-code consistency fix** (2026-11-10). Pre-release audit found that v6.4.2's claimed first cut — WAL + `synchronous=NORMAL` — **never landed in code**: `_get_conn()` set only `journal_mode=WAL`, leaving `synchronous` at SQLite's default FULL. The 2.1× search gain was real, but carried entirely by the other four cuts — real numbers, misattributed cause. This release adds `PRAGMA synchronous=NORMAL` on the WAL branch (per-connection, cross-thread; network-FS DELETE fallback stays FULL by design). Same-machine A/B on SSD shows no statistically significant latency delta (search p50 1.8 → 1.8ms — fsync is ~0.1ms-scale here); the benefit targets slow disks and IO-saturated containers, and more importantly makes the documented power-loss semantics (un-checkpointed access counts / search audits may be lost; compliance audits still commit immediately) actually hold. 4 new guard tests in `tests/test_v643_fixes.py`.
 - **v6.4.2 — tens-of-thousands-chars latency: another 2×** (2026-11-09). Same-machine A/B benchmark (400 memories / ~47k chars, 3 runs each): **search p50 6.3→3.0ms (2.1×), p95 11.7→4.2ms (2.8×)**; 24k-char library p50 2.5ms; fast machine state 1.8ms. Five surgical cuts: WAL + `synchronous=NORMAL` (commits skip per-write fsync), enum-downgrade memo, `row.keys()` set reuse, first-visit access-count batching merged into one `flush_access()` transaction per search, and search-audit INSERT folded into the same commit. The v5.6.3 throttle contract and v5.5.4 `recently_accessed` semantics are pinned by 23 contract tests — all green. Compliance-grade audits still commit immediately. *(Note: the `synchronous=NORMAL` cut landed in v6.4.3 — see above.)*
 - **v6.4.1 — million-character millisecond search** (2026-11-09). Scale benchmark (8,000 memories / ~990k chars) exposed a fuzzy-fallback long tail: search p95 881ms. Root causes: SequenceMatcher wasted on mathematically-impossible matches (ratio = 2M/(m+n), M ≤ m, so n ≥ 4m can never pass 0.4) + a ~50μs/entry Python full-scan tax. Fixed with a math-capped prune + SQLite-level candidate pre-filtering: **search p95 881→30.7ms (28×)**, add p50 2.6ms flat at 10k-scale. New `scripts/bench_scale.py` + CI scale guard (3000 memories, millisecond contract) + 4 behavior-level regression tests pin the semantics.
@@ -167,7 +168,7 @@ v6.1.3 – v6.4.3 shipped in ten days (2026-11-01 → 11-10), guarded by **1,228
 
 ```
 ┌──────────────────────────────────────────────────────┐
-│           MindForge v6.4.3            │
+│           MindForge v6.4.5            │
 │  Cognitive Layer  Personality · KnowledgeGraph       │
 │                   MemoryEvolution · FederatedMemory  │
 ├──────────────────────────────────────────────────────┤

{mindforge_memory-6.4.3 → mindforge_memory-6.4.5}/mindforge_memory.egg-info/SOURCES.txt

@@ -132,4 +132,5 @@ tests/test_v635_features.py
 tests/test_v635_integration.py
 tests/test_v636_fixes.py
 tests/test_v643_fixes.py
+tests/test_v645_fixes.py
 tests/test_v6_ports.py

{mindforge_memory-6.4.3 → mindforge_memory-6.4.5}/tests/test_v568_fixes.py

@@ -39,7 +39,7 @@ import mindforge.core.version as core_version
 
 
 _REPO = Path(__file__).resolve().parent.parent
-_EXPECTED_VERSION = "6.4.3"
+_EXPECTED_VERSION = "6.4.5"
 
 # 本轮修复涉及的、必须与 mindforge/core/version.py 保持一致的源码文件
 _VERSION_TRUTH_FILES = (

{mindforge_memory-6.4.3 → mindforge_memory-6.4.5}/tests/test_v575_release_consistency.py

@@ -40,8 +40,8 @@ class TestVersionTruth(unittest.TestCase):
     def test_core_version_matches_release(self):
         # 版本推进时必须一并更新此处的钉值（与 test_v568_fixes 的
         # _EXPECTED_VERSION 同一约定：让「忘记 bump 版本」在测试里显形）。
-        self.assertEqual(core_version.__version__, "6.4.3")
-        self.assertEqual(core_version.VERSION_INFO, (6, 4, 3))
+        self.assertEqual(core_version.__version__, "6.4.5")
+        self.assertEqual(core_version.VERSION_INFO, (6, 4, 5))
 
     def test_pyproject_matches_core_version(self):
         # v5.8.13 起 pyproject 不再写死静态版本：

{mindforge_memory-6.4.3 → mindforge_memory-6.4.5}/tests/test_v612_fixes.py

@@ -662,8 +662,8 @@ class TestVersionConsistency(unittest.TestCase):
     def test_version_is_612(self):
         from mindforge.core.version import VERSION_INFO, __version__
         # v6.1.3：版本钉值随发版推进更新（历史方法名保留）
-        self.assertEqual(__version__, "6.4.3")
-        self.assertEqual(VERSION_INFO, (6, 4, 3))
+        self.assertEqual(__version__, "6.4.5")
+        self.assertEqual(VERSION_INFO, (6, 4, 5))
 
     def test_json_round_trip_safety_of_preview(self):
         """save_evolution 的预览序列化不得抛（不可 json 化的对象走 str 兜底）。"""

{mindforge_memory-6.4.3 → mindforge_memory-6.4.5}/tests/test_v643_fixes.py

@@ -89,10 +89,12 @@ class TestSynchronousNormalGuard(_WALCase):
 
 
 class TestVersionBump(unittest.TestCase):
-    """版本钉值：忘记 bump 时在此显形（与 v568/v575/v612 守卫同一约定）。"""
+    """版本钉值：忘记 bump 时在此显形（与 v568/v575/v612 守卫同一约定）。
+    v6.4.5 教训：每版 fixes 文件的版本断言在后续发版都要一并 bump——
+    钉点集合随版本数递增，发版链清单必须扫全部 test_v*fixes.py。"""
 
-    def test_version_is_643(self):
-        self.assertEqual(__version__, "6.4.3")
+    def test_version_is_current(self):
+        self.assertEqual(__version__, "6.4.5")
 
 
 if __name__ == "__main__":

mindforge_memory-6.4.5/tests/test_v645_fixes.py

@@ -0,0 +1,108 @@
+"""
+MindForge v6.4.5 回归测试
+
+覆盖发版前审计发现的两类缺陷（2026-11-10）：
+
+  - Bug-A（P1）: connectors.py 对外请求的 User-Agent 硬编码为
+    "MindForge-Connector/5.8.9"——5.8.9 时代写死后未跟上，v6.x 连发
+    20+ 版本一直在对外谎报版本（event_bus.py v5.6.8 修过同款病，
+    此处漏网）。修复：动态引用 mindforge/core/version.py 唯一真值。
+  - Bug-B（P2，数据过时）: 官网「核心模块」数正文 17 / 统计卡 15，
+    实测 mindforge/modules/ 为 31 个模块文件——两处口径双双过时且
+    互相矛盾。修正为实测 31，并由本守卫钉住（website 数字必须等于
+    modules/ 实测文件数，防再漂移）。
+
+审计存档（非缺陷）：WAL auto-checkpoint 行为验证——四轮 × 400 次
+混合操作（add+search），WAL 稳定收敛于 ~4.1MB（默认 1000 页阈值），
+无无限膨胀；主动 TRUNCATE 可归零。daemon 长连接场景健康。
+"""
+
+import os
+import re
+import sys
+import unittest
+from pathlib import Path
+
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+_REPO = Path(__file__).resolve().parent.parent
+
+from mindforge.core.version import __version__
+
+
+class TestUserAgentVersionTruth(unittest.TestCase):
+    """对外 User-Agent 的版本必须动态引用唯一真值，不得硬编码。"""
+
+    def test_connector_ua_is_dynamic(self):
+        t = (_REPO / "mindforge" / "modules" / "connectors.py").read_text(
+            encoding="utf-8")
+        # 修复后的形态：f-string 引用 __version__
+        self.assertIn('f"MindForge-Connector/{__version__}"', t,
+                      "connectors UA 应动态引用 __version__")
+        # 病灶形态必须消失：任何带版本号的硬编码 UA
+        bad = re.findall(r'User-Agent[^)]*?/[0-9]+\.[0-9]+\.[0-9]+', t)
+        self.assertEqual(bad, [], f"发现硬编码版本 UA: {bad}")
+        # import 必须存在（防 f-string 引用悬空）
+        self.assertIn("from mindforge.core.version import __version__", t)
+
+    def test_no_stale_version_in_runtime_ua(self):
+        """全包扫描：运行时 UA/标识字符串不得携带过时版本字面量。"""
+        pat = re.compile(r'MindForge[-A-Za-z]*/(?:\d+\.\d+\.\d+)')
+        for py in (_REPO / "mindforge").rglob("*.py"):
+            hits = pat.findall(py.read_text(encoding="utf-8"))
+            # 允许出现的位置：注释里的历史说明（v6.4.5 fix 注释提及旧值）
+            for line_no, line in enumerate(
+                    py.read_text(encoding="utf-8").splitlines(), 1):
+                if pat.search(line) and "v6.4.5 fix" not in line:
+                    # schema 标识（mindforge-knowledge-graph/1.0）为协议
+                    # 格式版本，非产品版本，豁免。
+                    if "knowledge-graph" in line:
+                        continue
+                    self.fail(
+                        f"{py.name}:{line_no} 疑似硬编码版本 UA: {line.strip()}")
+
+
+class TestWebsiteModuleCountTruth(unittest.TestCase):
+    """官网「核心模块」数 = mindforge/modules/ 实测文件数（防再过时）。"""
+
+    def _modules_count(self) -> int:
+        return len([p for p in (_REPO / "mindforge" / "modules").glob("*.py")
+                    if not p.name.startswith("_")])
+
+    def test_website_module_count_matches_reality(self):
+        want = str(self._modules_count())
+        index = (_REPO / "website" / "index.html").read_text(encoding="utf-8")
+        spots = {
+            "正文": re.findall(r'(\d+) 个核心模块', index),
+            "统计卡": re.findall(
+                r'class="about-stat"><b>(\d+)</b><span>核心模块<', index),
+        }
+        for k, v in spots.items():
+            self.assertEqual(len(v), 1, f"官网「{k}」核心模块数不唯一: {v}")
+            self.assertEqual(v[0], want,
+                f"官网「{k}」={v[0]}，实测 modules/={want}")
+
+    def test_website_mcp_tool_count_matches_reality(self):
+        """MCP 工具数守卫（87 实测口径；import server 拿 TOOL_SCHEMAS）。"""
+        try:
+            from mindforge.mcp.server import TOOL_SCHEMAS
+        except Exception as exc:  # pragma: no cover
+            self.skipTest(f"server 模块不可导入: {exc}")
+        want = str(len(TOOL_SCHEMAS))
+        index = (_REPO / "website" / "index.html").read_text(encoding="utf-8")
+        hits = re.findall(r'(\d+) 个? ?MCP 工具|(\d+) MCP tools', index)
+        flat = [x for pair in hits for x in pair if x]
+        self.assertTrue(flat, "官网未声明 MCP 工具数")
+        for v in flat:
+            self.assertEqual(v, want, f"官网 MCP 工具数 {v} ≠ 实测 {want}")
+
+
+class TestVersionBump(unittest.TestCase):
+    """版本钉值：忘记 bump 时在此显形。"""
+
+    def test_version_is_645(self):
+        self.assertEqual(__version__, "6.4.5")
+
+
+if __name__ == "__main__":
+    unittest.main()