mindforge-memory 6.4.1__tar.gz → 6.4.2__tar.gz

{mindforge_memory-6.4.1/mindforge_memory.egg-info → mindforge_memory-6.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mindforge-memory
-Version: 6.4.1
+Version: 6.4.2
 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.1: no team, no funding, 1,220 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.2: no team, no funding, 1,224 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.1-green.svg)](https://github.com/opok-ops/MindForge/releases)
+[![Version](https://img.shields.io/badge/version-6.4.2-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.1 shipped in nine days (2026-11-01 → 11-09), guarded by **1,224 tests** (1219+4 passed, 1 skipped).
+v6.1.3 – v6.4.2 shipped in nine days (2026-11-01 → 11-09), guarded by **1,224 tests** (all passing).
 
+- **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.
 - **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.
 
 - **v6.4.0 — resident daemon & performance guards** (2026-11-08). New `mindforge daemon` subcommand: line-JSON over stdio, engine resident in a long-lived process — per-request p50 2.5ms vs 400–700ms for CLI subprocess spawning (two orders of magnitude; 2026-11-09 quiet-machine re-bench: 2.5ms vs 401ms p50, ~160×). CI now guards latency (engine in-process thresholds) and daemon 13-step E2E alongside the 16-step CLI E2E guard.
@@ -165,7 +166,7 @@ v6.1.3 – v6.4.1 shipped in nine days (2026-11-01 → 11-09), guarded by **1,22
 
 ```
 ┌──────────────────────────────────────────────────────┐
-│           MindForge v6.4.1            │
+│           MindForge v6.4.2            │
 │  Cognitive Layer  Personality · KnowledgeGraph       │
 │                   MemoryEvolution · FederatedMemory  │
 ├──────────────────────────────────────────────────────┤

{mindforge_memory-6.4.1 → mindforge_memory-6.4.2}/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.1: no team, no funding, 1,220 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.2: no team, no funding, 1,224 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.1-green.svg)](https://github.com/opok-ops/MindForge/releases)
+[![Version](https://img.shields.io/badge/version-6.4.2-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.1 shipped in nine days (2026-11-01 → 11-09), guarded by **1,224 tests** (1219+4 passed, 1 skipped).
+v6.1.3 – v6.4.2 shipped in nine days (2026-11-01 → 11-09), guarded by **1,224 tests** (all passing).
 
+- **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.
 - **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.
 
 - **v6.4.0 — resident daemon & performance guards** (2026-11-08). New `mindforge daemon` subcommand: line-JSON over stdio, engine resident in a long-lived process — per-request p50 2.5ms vs 400–700ms for CLI subprocess spawning (two orders of magnitude; 2026-11-09 quiet-machine re-bench: 2.5ms vs 401ms p50, ~160×). CI now guards latency (engine in-process thresholds) and daemon 13-step E2E alongside the 16-step CLI E2E guard.
@@ -135,7 +136,7 @@ v6.1.3 – v6.4.1 shipped in nine days (2026-11-01 → 11-09), guarded by **1,22
 
 ```
 ┌──────────────────────────────────────────────────────┐
-│           MindForge v6.4.1            │
+│           MindForge v6.4.2            │
 │  Cognitive Layer  Personality · KnowledgeGraph       │
 │                   MemoryEvolution · FederatedMemory  │
 ├──────────────────────────────────────────────────────┤

{mindforge_memory-6.4.1 → mindforge_memory-6.4.2}/mindforge/core/query.py

@@ -380,7 +380,10 @@ class QueryEngine:
 
         def _cached_get(mid: str) -> Optional[Any]:
             if mid not in _entry_cache:
-                _entry_cache[mid] = self.storage.get_memory(mid)
+                # v6.4.2 perf: 批量检索上下文——首访访问计数走挂账，
+                # 由本 search 尾部的 flush_all_access 统一落库。
+                _entry_cache[mid] = self.storage.get_memory(
+                    mid, _batch_access=True)
             return _entry_cache[mid]
 
         # 预过滤：按 categories/layers 筛选 score_map，避免非匹配记忆占据排序位
@@ -470,6 +473,15 @@ class QueryEngine:
             except Exception:
                 pass
 
+        # v6.4.2 perf: 本轮 search 命中的首访访问计数 + 挂账的 search 审计
+        # 在此统一批量落库（executemany + 单次 commit，含审计 INSERT 合并）。
+        # 挂账期上限 = 单次 search 时长，recently_accessed 排序在 search
+        # 返回后即正确；同条记忆 60s 节流窗口内重复命中仍免落库（v5.6.3 契约）。
+        try:
+            self.storage.flush_access()
+        except Exception:
+            pass
+
         elapsed = (time.time() - start) * 1000
         token_estimate = sum(len(c.content) for c in chunks) // 4
 

{mindforge_memory-6.4.1 → mindforge_memory-6.4.2}/mindforge/core/storage.py

@@ -694,6 +694,11 @@ class MemoryCache:
 
 
 # v5.6.3 性能修复：记忆读缓存 TTL（秒）。除写路径主动失效外的兜底，
+# v6.4.2 perf: 枚举降级 memo（行反序列化高频路径）。值域天然有界
+# （枚举成员数 × 类数）；Enum 单例不可变共享安全；跨模块路径加载的
+# 同名类副本身份不同，作为 dict key 天然隔离不串台。
+_ENUM_DOWNGRADE_MEMO: Dict[type, Dict[Any, Any]] = {}
+
 # 任何遗漏的写路径最多造成该窗口内的短时脏读，避免长期脏数据。
 _ENTRY_CACHE_TTL = 30.0
 
@@ -731,6 +736,8 @@ class StorageEngine:
         # v6.2.0 增长治理：搜索审计去抖状态（同词 60s 内只落一条）
         self._search_dedup_lock = threading.Lock()
         self._search_dedup: Dict[str, float] = {}
+        # v6.4.2 perf: search 审计挂账标记（INSERT 已进事务缓冲未 commit）
+        self._search_audit_dirty = False
         self._init_db()
 
     def _get_conn(self) -> sqlite3.Connection:
@@ -1168,7 +1175,23 @@ class StorageEngine:
         v5.5.4 fix: 兼容双重导入路径导致的枚举类不一致问题。
         当 isinstance() 因不同模块路径加载同名枚举而失败时，
         通过 .value / .name 属性匹配来识别。
+
+        v6.4.2 perf: str 输入路径先查 memo（命中即免逐值遍历匹配）；
+        key 含 default，不假设同一 value 恒定同一 default。
         """
+        if isinstance(value, str):
+            memo = _ENUM_DOWNGRADE_MEMO.setdefault(enum_cls, {})
+            hit = memo.get((value, default))
+            if hit is not None:
+                return hit
+            result = StorageEngine._downgrade_enum_slow(value, enum_cls, default)
+            memo[(value, default)] = result
+            return result
+        return StorageEngine._downgrade_enum_slow(value, enum_cls, default)
+
+    @staticmethod
+    def _downgrade_enum_slow(value: Any, enum_cls: type, default: Any) -> Any:
+        """未命中 memo 时的逐值匹配内核（原 _downgrade_enum 逻辑）。"""
         if isinstance(value, enum_cls):
             return value
         # 兼容双重导入：isinstance 失败但 value 有枚举属性时，用 .value 匹配
@@ -1345,7 +1368,8 @@ class StorageEngine:
         return entry
 
     def get_memory(self, memory_id: str,
-                   actor: str = "", session_id: str = "") -> Optional[MemoryEntry]:
+                   actor: str = "", session_id: str = "",
+                   _batch_access: bool = False) -> Optional[MemoryEntry]:
         """获取记忆
 
         v5.5.2: 自动过期检查——若 expires_at > 0 且已过期，自动移入回收站并返回 None。
@@ -1433,7 +1457,8 @@ class StorageEngine:
                 return entry
             return None
 
-        self._update_access(entry, actor, session_id)
+        self._update_access(entry, actor, session_id,
+                            _batch=_batch_access)
         return entry
 
     def get_memories_by_ids(self, memory_ids: List[str]) -> List[Optional[MemoryEntry]]:
@@ -7285,6 +7310,8 @@ class StorageEngine:
 
     def _row_to_entry(self, row: sqlite3.Row) -> MemoryEntry:
         # v5.3.7 修复：tags/metadata 可能已经是 list/dict（非 JSON 字符串）
+        # v6.4.2 perf: 一次构造列名集合，避免每行 5 次 row.keys() 分配 + 线性 in 扫描
+        _rk = set(row.keys())
         raw_tags = row["tags"]
         if isinstance(raw_tags, (list, tuple)):
             tags_val = list(raw_tags)
@@ -7324,11 +7351,11 @@ class StorageEngine:
             consolidation_count=row["consolidation_count"],
             forgetting_score=row["forgetting_score"],
             strength=row["strength"],
-            starred=bool(row["starred"]) if "starred" in row.keys() else False,
-            pinned=bool(row["pinned"]) if "pinned" in row.keys() else False,
-            expires_at=float(row["expires_at"]) if "expires_at" in row.keys() and row["expires_at"] else 0.0,
-            valid_from=float(row["valid_from"]) if "valid_from" in row.keys() and row["valid_from"] else 0.0,
-            valid_to=float(row["valid_to"]) if "valid_to" in row.keys() and row["valid_to"] else 0.0,
+            starred=bool(row["starred"]) if "starred" in _rk else False,
+            pinned=bool(row["pinned"]) if "pinned" in _rk else False,
+            expires_at=float(row["expires_at"]) if "expires_at" in _rk and row["expires_at"] else 0.0,
+            valid_from=float(row["valid_from"]) if "valid_from" in _rk and row["valid_from"] else 0.0,
+            valid_to=float(row["valid_to"]) if "valid_to" in _rk and row["valid_to"] else 0.0,
             metadata=meta_val,
             encrypted=bool(row["encrypted"]),
             ciphertext=row["ciphertext"],
@@ -7336,7 +7363,8 @@ class StorageEngine:
             salt=row["salt"],
         )
 
-    def _update_access(self, entry: MemoryEntry, actor: str, session_id: str):
+    def _update_access(self, entry: MemoryEntry, actor: str, session_id: str,
+                       _batch: bool = False):
         """更新访问计数
 
         v5.1.2：不再每次 get 都写审计日志。
@@ -7352,7 +7380,16 @@ class StorageEngine:
             self._access_pending[entry.id] = (
                 self._access_pending.get(entry.id, 0) + 1)
             last = self._access_last_flush.get(entry.id, 0.0)
-            if last > 0 and now - last < _ACCESS_PERSIST_INTERVAL:
+            if last == 0.0:
+                # v6.4.2 perf: 首访起表。批量检索上下文（_batch=True，如
+                # QueryEngine.search 的结果构建）首访只挂账，由调用方统一
+                # 批量落库（search 尾部 flush_all_access，单次 executemany
+                # + commit）；直连 get_memory 首访仍立即落库（v5.6.3 契约）。
+                self._access_last_flush[entry.id] = now
+                if _batch:
+                    self._maybe_prune_access_locked(now)
+                    return
+            elif now - last < _ACCESS_PERSIST_INTERVAL:
                 self._maybe_prune_access_locked(now)
                 return
             self._flush_access_locked(entry.id, now)
@@ -7420,8 +7457,10 @@ class StorageEngine:
         字典，计数不丢。
         """
         with self._access_lock:
-            if not self._access_pending:
+            audit_dirty = self._search_audit_dirty
+            if not self._access_pending and not audit_dirty:
                 return
+            self._search_audit_dirty = False
             now = time.time()
             pending = self._access_pending
             self._access_pending = {}
@@ -7429,10 +7468,12 @@ class StorageEngine:
         items = [(inc, now, mid) for mid, inc in pending.items()]
         conn = self._get_conn()
         try:
-            conn.executemany("""
-                UPDATE memories SET access_count = access_count + ?, last_accessed_at = ?
-                WHERE id = ?
-            """, items)
+            if items:
+                conn.executemany("""
+                    UPDATE memories SET access_count = access_count + ?, last_accessed_at = ?
+                    WHERE id = ?
+                """, items)
+            # v6.4.2 perf: 挂账的 search 审计 INSERT（若有）随本事务一并提交
             conn.commit()
         except Exception as e:
             with self._access_lock:
@@ -9248,8 +9289,14 @@ class StorageEngine:
             self._search_dedup_lock = threading.Lock()
             self._search_dedup = {}
         try:
+            # v6.4.2 perf: search 审计 INSERT 挂账不 commit，与下一次
+            # flush_access() 的批量 UPDATE 合并成同一次事务提交（IO 慢态
+            # 下 commit ~1ms，search 热路径 100 次 commit → 与挂账合并归零）。
+            # search 审计为非合规数据（v6.2.0 prune 同一分类），崩溃窗口
+            # ≤ 单次 search 时长，可接受；合规类审计不受影响仍即时 commit。
+            self._search_audit_dirty = True
             self._add_audit("search", q, "", "", "INTERNAL",
-                            {"query": q}, commit=True)
+                            {"query": q}, commit=False)
         except Exception as _err:
             logger.warning("record_search 审计写入失败: %s", _err)
 

{mindforge_memory-6.4.1 → mindforge_memory-6.4.2}/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.1"
+__version__: str = "6.4.2"
 
 #: 结构化版本元组，便于比较（如 `VERSION_INFO >= (6, 1, 0)`）
-VERSION_INFO: Tuple[int, int, int] = (6, 4, 1)
+VERSION_INFO: Tuple[int, int, int] = (6, 4, 2)
 
 #: 下一个大版本的目标版本号（供 v6 端口预留引用）
 NEXT_MAJOR_TARGET: str = "7.0.0"

{mindforge_memory-6.4.1 → mindforge_memory-6.4.2/mindforge_memory.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mindforge-memory
-Version: 6.4.1
+Version: 6.4.2
 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.1: no team, no funding, 1,220 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.2: no team, no funding, 1,224 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.1-green.svg)](https://github.com/opok-ops/MindForge/releases)
+[![Version](https://img.shields.io/badge/version-6.4.2-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.1 shipped in nine days (2026-11-01 → 11-09), guarded by **1,224 tests** (1219+4 passed, 1 skipped).
+v6.1.3 – v6.4.2 shipped in nine days (2026-11-01 → 11-09), guarded by **1,224 tests** (all passing).
 
+- **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.
 - **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.
 
 - **v6.4.0 — resident daemon & performance guards** (2026-11-08). New `mindforge daemon` subcommand: line-JSON over stdio, engine resident in a long-lived process — per-request p50 2.5ms vs 400–700ms for CLI subprocess spawning (two orders of magnitude; 2026-11-09 quiet-machine re-bench: 2.5ms vs 401ms p50, ~160×). CI now guards latency (engine in-process thresholds) and daemon 13-step E2E alongside the 16-step CLI E2E guard.
@@ -165,7 +166,7 @@ v6.1.3 – v6.4.1 shipped in nine days (2026-11-01 → 11-09), guarded by **1,22
 
 ```
 ┌──────────────────────────────────────────────────────┐
-│           MindForge v6.4.1            │
+│           MindForge v6.4.2            │
 │  Cognitive Layer  Personality · KnowledgeGraph       │
 │                   MemoryEvolution · FederatedMemory  │
 ├──────────────────────────────────────────────────────┤

{mindforge_memory-6.4.1 → mindforge_memory-6.4.2}/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.1"
+_EXPECTED_VERSION = "6.4.2"
 
 # 本轮修复涉及的、必须与 mindforge/core/version.py 保持一致的源码文件
 _VERSION_TRUTH_FILES = (

{mindforge_memory-6.4.1 → mindforge_memory-6.4.2}/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.1")
-        self.assertEqual(core_version.VERSION_INFO, (6, 4, 1))
+        self.assertEqual(core_version.__version__, "6.4.2")
+        self.assertEqual(core_version.VERSION_INFO, (6, 4, 2))
 
     def test_pyproject_matches_core_version(self):
         # v5.8.13 起 pyproject 不再写死静态版本：

{mindforge_memory-6.4.1 → mindforge_memory-6.4.2}/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.1")
-        self.assertEqual(VERSION_INFO, (6, 4, 1))
+        self.assertEqual(__version__, "6.4.2")
+        self.assertEqual(VERSION_INFO, (6, 4, 2))
 
     def test_json_round_trip_safety_of_preview(self):
         """save_evolution 的预览序列化不得抛（不可 json 化的对象走 str 兜底）。"""