memleaf 0.2.81__tar.gz → 0.2.82__tar.gz

{memleaf-0.2.81 → memleaf-0.2.82}/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to memleaf are documented here.
 
 ## Unreleased
 
+## 0.2.82 — 2026-09-30
+
+### Hermes installation tool discovery
+
+- Derive the Hermes MCP installation check from the installed server tool
+  declarations instead of a separately maintained tool-count constant. This
+  fixes the 0.2.81 installation rollback after adding `recover_failed_run`.
+- Verify actual stdio tool discovery and Hermes count acceptance/rejection in
+  both installed distributions on every supported CI platform.
+
 ## 0.2.81 — 2026-09-30
 
 ### HTTP failure classification and controlled run recovery

{memleaf-0.2.81/src/memleaf.egg-info → memleaf-0.2.82}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memleaf
-Version: 0.2.81
+Version: 0.2.82
 Summary: A local-first Markdown memory core for AI agents
 Author: memleaf contributors
 License-Expression: MIT
@@ -23,7 +23,7 @@ Dynamic: license-file
 
 [English](README.en.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **版本：0.2.81。**
+> **版本：0.2.82。**
 > 自动提炼和复核共用同一条“未来记忆价值”标准：模型综合未来复用、信息增量、再次读取时的直接可用性和忘记成本，只保留对未来理解、判断或行动有实质影响的最小核心；没有明确价值的信息不提炼，不按具体业务场景硬编码排除。
 > 提炼契约现在只有一份中文语义契约（旧版英文 B3 提示词已删除），首轮、主题选择、候选修复和 `semantic_maintenance` 使用同一套保留价值判断；同一件事只写一次。
 > Core 不再因为归属、日期、任务依据或跨项目而丢弃整条候选：归属缺失会归一到证据里唯一被点名的项目、否则落 `global`；日期只接受能在本候选证据里找到出处、且能锚定成 ISO 的写法（`明天`、`周五`、`月底` 都会被解析），无法解析时只丢掉日期字段，记忆照常写入；未获授权的改归属沿用目标原归属。
@@ -167,12 +167,12 @@ python -m pip install -U memleaf && python -m memleaf install
 4. 激活 `memory.provider=memleaf`；
 5. 通过 Hermes 官方 CLI 配置 memleaf MCP；
 6. 配置 MCP lazy/idle 生命周期；
-7. 验证 MCP Server 能发现 13 个工具；
+7. 验证 MCP Server 能发现当前版本声明的全部工具；
 8. 写入本地 Agent 状态索引。
 
 完成后重启 Hermes。
 
-如果没有检测到 Hermes、无法取得完整模型路由、Provider 激活失败或 MCP 的 13 工具验证失败，安装会明确返回失败，不会把未完成的接入报告为成功。
+如果没有检测到 Hermes、无法取得完整模型路由、Provider 激活失败或 MCP 工具发现验证失败，安装会明确返回失败，不会把未完成的接入报告为成功。
 
 仓库中的 `install.sh` 保留给源码开发、离线源码安装和故障排查；普通 PyPI 用户不需要执行它。
 
@@ -269,7 +269,7 @@ python -m memleaf.mcp_server --vault "$HOME/.memleaf"
 
 不传 `--vault` 时默认使用 `~/.memleaf`；也可以设置 `MEMLEAF_VAULT`。正常情况下不需要手工常驻，Hermes 或 Codex 会按需启动它。stdout 只输出 JSON-RPC，日志不会污染协议通道。
 
-当前提供 13 个工具：
+当前提供以下工具：
 
 | 工具 | 用途 |
 | --- | --- |
@@ -277,6 +277,7 @@ python -m memleaf.mcp_server --vault "$HOME/.memleaf"
 | `context` | 兼容保留的有界轻量目录，不用于自动检索路径 |
 | `scope_catalog` | 返回 Scope、父级和别名，不返回具体记忆正文 |
 | `search` | 返回有界候选目录和 `found`/`no_match` 状态 |
+| `list_todos` | 跨 Scope 按状态和日期筛选并分页列出当前待办 |
 | `read` | 使用当前 `retrieval_id` 分页读取选中的记忆正文 |
 | `process` | 处理完整 inbox 轮次并按准入规则提炼；`background=true` 时异步入队 |
 | `process_status` | 只读查询异步处理 job 状态 |

{memleaf-0.2.81 → memleaf-0.2.82}/README.en.md

@@ -4,7 +4,7 @@
 
 [中文](README.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **Version: 0.2.81.**
+> **Version: 0.2.82.**
 > Automatic extraction and review share one future-value standard: the model weighs likely reuse, information gain, direct usability when read again, and the cost of forgetting. It keeps only the smallest core that can materially help future understanding, decisions, or actions; information without clear value is not extracted, and no business-specific exclusion rule is hard-coded.
 > A single Chinese semantic contract is sent for extraction, topic selection, candidate repair, and `semantic_maintenance`; the older English B3 prompt has been deleted and B3 remains only as a compatibility read format. One topic is written once.
 > Core no longer discards a whole candidate over ownership, dates, task basis or cross-project wording. A missing owner normalizes to the single project named by that candidate's own evidence, otherwise `global`. A deadline is accepted only when it appears in the candidate's own evidence and can be anchored to ISO (`明天`, `周五`, `月底` all resolve); when it cannot, only the date field is dropped and the memory is still written. An unauthorized ownership change keeps the target's existing scope.
@@ -148,12 +148,12 @@ Both installation paths automatically:
 4. Activate `memory.provider=memleaf`.
 5. Configure the memleaf MCP entry through Hermes' official CLI.
 6. Configure MCP lazy/idle lifecycle settings.
-7. Verify that the MCP server exposes all 13 tools.
+7. Verify that the MCP server exposes all tools declared by the installed version.
 8. Record the local Agent integration status.
 
 Restart Hermes after installation.
 
-If Hermes cannot be detected, no complete model route can be configured, Provider activation fails, or the 13-tool MCP verification fails, the installer returns an explicit failure rather than reporting an incomplete integration as successful.
+If Hermes cannot be detected, no complete model route can be configured, Provider activation fails, or MCP tool-discovery verification fails, the installer returns an explicit failure rather than reporting an incomplete integration as successful.
 
 The repository `install.sh` remains for source development, offline source installation, and troubleshooting. Normal PyPI users do not need to run it.
 
@@ -250,7 +250,7 @@ python -m memleaf.mcp_server --vault "$HOME/.memleaf"
 
 Without `--vault`, the server uses `~/.memleaf`; `MEMLEAF_VAULT` can also specify the Vault. In normal use the server does not need to be kept running manually: Hermes or Codex starts it on demand. stdout contains only JSON-RPC messages so logs do not corrupt the protocol stream.
 
-The server currently exposes 13 tools:
+The server exposes the following tools:
 
 | Tool | Purpose |
 | --- | --- |
@@ -262,6 +262,7 @@ The server currently exposes 13 tools:
 | `read` | Read a selected memory body in pages using the current `retrieval_id` |
 | `process` | Process complete inbox turns under the admission rules; `background=true` enqueues a job |
 | `process_status` | Read the status of a background processing job |
+| `recover_failed_run` | Preview and explicitly recover terminal transport failures within the original request budget |
 | `remember` | Create or update memory after an explicit request |
 | `forget_memory` | Delete one memory by exact ID |
 | `forget_about` | Forget an unambiguous topic; return candidates when ambiguous |

{memleaf-0.2.81 → memleaf-0.2.82}/README.md

@@ -4,7 +4,7 @@
 
 [English](README.en.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **版本：0.2.81。**
+> **版本：0.2.82。**
 > 自动提炼和复核共用同一条“未来记忆价值”标准：模型综合未来复用、信息增量、再次读取时的直接可用性和忘记成本，只保留对未来理解、判断或行动有实质影响的最小核心；没有明确价值的信息不提炼，不按具体业务场景硬编码排除。
 > 提炼契约现在只有一份中文语义契约（旧版英文 B3 提示词已删除），首轮、主题选择、候选修复和 `semantic_maintenance` 使用同一套保留价值判断；同一件事只写一次。
 > Core 不再因为归属、日期、任务依据或跨项目而丢弃整条候选：归属缺失会归一到证据里唯一被点名的项目、否则落 `global`；日期只接受能在本候选证据里找到出处、且能锚定成 ISO 的写法（`明天`、`周五`、`月底` 都会被解析），无法解析时只丢掉日期字段，记忆照常写入；未获授权的改归属沿用目标原归属。
@@ -148,12 +148,12 @@ python -m pip install -U memleaf && python -m memleaf install
 4. 激活 `memory.provider=memleaf`；
 5. 通过 Hermes 官方 CLI 配置 memleaf MCP；
 6. 配置 MCP lazy/idle 生命周期；
-7. 验证 MCP Server 能发现 13 个工具；
+7. 验证 MCP Server 能发现当前版本声明的全部工具；
 8. 写入本地 Agent 状态索引。
 
 完成后重启 Hermes。
 
-如果没有检测到 Hermes、无法取得完整模型路由、Provider 激活失败或 MCP 的 13 工具验证失败，安装会明确返回失败，不会把未完成的接入报告为成功。
+如果没有检测到 Hermes、无法取得完整模型路由、Provider 激活失败或 MCP 工具发现验证失败，安装会明确返回失败，不会把未完成的接入报告为成功。
 
 仓库中的 `install.sh` 保留给源码开发、离线源码安装和故障排查；普通 PyPI 用户不需要执行它。
 
@@ -250,7 +250,7 @@ python -m memleaf.mcp_server --vault "$HOME/.memleaf"
 
 不传 `--vault` 时默认使用 `~/.memleaf`；也可以设置 `MEMLEAF_VAULT`。正常情况下不需要手工常驻，Hermes 或 Codex 会按需启动它。stdout 只输出 JSON-RPC，日志不会污染协议通道。
 
-当前提供 13 个工具：
+当前提供以下工具：
 
 | 工具 | 用途 |
 | --- | --- |
@@ -258,6 +258,7 @@ python -m memleaf.mcp_server --vault "$HOME/.memleaf"
 | `context` | 兼容保留的有界轻量目录，不用于自动检索路径 |
 | `scope_catalog` | 返回 Scope、父级和别名，不返回具体记忆正文 |
 | `search` | 返回有界候选目录和 `found`/`no_match` 状态 |
+| `list_todos` | 跨 Scope 按状态和日期筛选并分页列出当前待办 |
 | `read` | 使用当前 `retrieval_id` 分页读取选中的记忆正文 |
 | `process` | 处理完整 inbox 轮次并按准入规则提炼；`background=true` 时异步入队 |
 | `process_status` | 只读查询异步处理 job 状态 |

{memleaf-0.2.81 → memleaf-0.2.82}/docs/hermes-mcp-runtime.md

@@ -152,7 +152,7 @@ Vault. Once changes begin, it snapshots:
 - Hermes `memleaf.json`; and
 - the installed `plugins/memleaf` Provider directory.
 
-If MCP persistence, MCP lifecycle configuration, the 13-tool test, Provider
+If MCP persistence, MCP lifecycle configuration, the declared-tool discovery test, Provider
 copy/version validation, Provider activation, or native-source registration
 fails, those Hermes paths are restored to their pre-install state. Each
 snapshot is restored independently: a failure on one path does not prevent the

{memleaf-0.2.81 → memleaf-0.2.82}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "memleaf"
-version = "0.2.81"
+version = "0.2.82"
 description = "A local-first Markdown memory core for AI agents"
 readme = "README.md"
 requires-python = ">=3.11"

{memleaf-0.2.81 → memleaf-0.2.82}/src/memleaf/__init__.py

@@ -1,6 +1,6 @@
 """Local-first Markdown memory core for AI agents."""
 
-__version__ = "0.2.81"
+__version__ = "0.2.82"
 
 from .config import DEFAULT_CONFIG, default_config, load_config, save_config
 from .frontmatter import FrontmatterError, dump_frontmatter, dump_yaml, load_yaml, parse_frontmatter

{memleaf-0.2.81 → memleaf-0.2.82}/src/memleaf/adapters/hermes.py

@@ -24,8 +24,14 @@ from .base import (
 
 
 _MCP_IDLE_TIMEOUT_SECONDS = 60
-MCP_EXPECTED_TOOL_COUNT = 13
-_MCP_EXPECTED_TOOL_COUNT = MCP_EXPECTED_TOOL_COUNT
+
+
+def expected_mcp_tool_count() -> int:
+    """Read the installed server's declarations instead of a second tool inventory."""
+
+    from ..mcp_server import _TOOLS
+
+    return len(_TOOLS)
 
 
 def hermes_home_for_platform(
@@ -418,7 +424,7 @@ class HermesAdapter:
         self,
         detection: Detection | None = None,
         *,
-        expected_tools: int = MCP_EXPECTED_TOOL_COUNT,
+        expected_tools: int | None = None,
     ) -> bool:
         """Run the official MCP test and require the expected tool count."""
 
@@ -426,7 +432,9 @@ class HermesAdapter:
         executable = detection.executable if detection.detected else None
         if detection.confidence != "high" or not executable:
             return False
-        if isinstance(expected_tools, bool) or expected_tools < 0:
+        if expected_tools is None:
+            expected_tools = expected_mcp_tool_count()
+        if not isinstance(expected_tools, int) or isinstance(expected_tools, bool) or expected_tools < 0:
             return False
         try:
             result = run_argv(

{memleaf-0.2.81 → memleaf-0.2.82}/src/memleaf/hermes_provider/README.md

@@ -61,7 +61,8 @@ mcp_servers:
 
 Use `python -m memleaf install` to configure both entries. The installer writes
 the MCP entry through `hermes config set`, reads `config.yaml` back, and tests
-that all 13 tools are discoverable before it reports success. When two memleaf
+that all tools declared by the installed MCP server are discoverable before it
+reports success. When two memleaf
 virtual environments are present, use `--mcp-runtime current` to migrate to the
 runtime executing the installer or `--mcp-runtime existing` to retain an
 already configured executable after an exact version check. See the

{memleaf-0.2.81 → memleaf-0.2.82}/src/memleaf/hermes_provider/plugin.yaml

@@ -1,5 +1,5 @@
 name: memleaf
-version: 0.2.81
+version: 0.2.82
 description: "Hermes-native external MemoryProvider for local-first Markdown memory shared with the memleaf MCP server."
 hooks:
   - prefetch

{memleaf-0.2.81 → memleaf-0.2.82}/src/memleaf/installer.py

@@ -30,7 +30,7 @@ from .adapters.base import (
 from .adapters.codex import CodexAdapter
 from .adapters.hermes import (
     HermesAdapter,
-    MCP_EXPECTED_TOOL_COUNT,
+    expected_mcp_tool_count,
     hermes_home_for_platform,
 )
 from .cli import _home_from_environment, _prepare_model_route
@@ -1227,10 +1227,11 @@ def install_hermes(
                         vault.root,
                     ),
                 )
-            if not adapter.test_mcp(detection, expected_tools=MCP_EXPECTED_TOOL_COUNT):
+            expected_tools = expected_mcp_tool_count()
+            if not adapter.test_mcp(detection, expected_tools=expected_tools):
                 raise _HermesInstallFailure(
                     stage="mcp_test",
-                    reason=f"Hermes MCP test did not confirm {MCP_EXPECTED_TOOL_COUNT} tools",
+                    reason=f"Hermes MCP test did not confirm {expected_tools} tools",
                     mcp=configured.to_dict(),
                     user_action="Inspect the MCP process error, then rerun the installer.",
                     recovery_commands=[

{memleaf-0.2.81 → memleaf-0.2.82/src/memleaf.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memleaf
-Version: 0.2.81
+Version: 0.2.82
 Summary: A local-first Markdown memory core for AI agents
 Author: memleaf contributors
 License-Expression: MIT
@@ -23,7 +23,7 @@ Dynamic: license-file
 
 [English](README.en.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **版本：0.2.81。**
+> **版本：0.2.82。**
 > 自动提炼和复核共用同一条“未来记忆价值”标准：模型综合未来复用、信息增量、再次读取时的直接可用性和忘记成本，只保留对未来理解、判断或行动有实质影响的最小核心；没有明确价值的信息不提炼，不按具体业务场景硬编码排除。
 > 提炼契约现在只有一份中文语义契约（旧版英文 B3 提示词已删除），首轮、主题选择、候选修复和 `semantic_maintenance` 使用同一套保留价值判断；同一件事只写一次。
 > Core 不再因为归属、日期、任务依据或跨项目而丢弃整条候选：归属缺失会归一到证据里唯一被点名的项目、否则落 `global`；日期只接受能在本候选证据里找到出处、且能锚定成 ISO 的写法（`明天`、`周五`、`月底` 都会被解析），无法解析时只丢掉日期字段，记忆照常写入；未获授权的改归属沿用目标原归属。
@@ -167,12 +167,12 @@ python -m pip install -U memleaf && python -m memleaf install
 4. 激活 `memory.provider=memleaf`；
 5. 通过 Hermes 官方 CLI 配置 memleaf MCP；
 6. 配置 MCP lazy/idle 生命周期；
-7. 验证 MCP Server 能发现 13 个工具；
+7. 验证 MCP Server 能发现当前版本声明的全部工具；
 8. 写入本地 Agent 状态索引。
 
 完成后重启 Hermes。
 
-如果没有检测到 Hermes、无法取得完整模型路由、Provider 激活失败或 MCP 的 13 工具验证失败，安装会明确返回失败，不会把未完成的接入报告为成功。
+如果没有检测到 Hermes、无法取得完整模型路由、Provider 激活失败或 MCP 工具发现验证失败，安装会明确返回失败，不会把未完成的接入报告为成功。
 
 仓库中的 `install.sh` 保留给源码开发、离线源码安装和故障排查；普通 PyPI 用户不需要执行它。
 
@@ -269,7 +269,7 @@ python -m memleaf.mcp_server --vault "$HOME/.memleaf"
 
 不传 `--vault` 时默认使用 `~/.memleaf`；也可以设置 `MEMLEAF_VAULT`。正常情况下不需要手工常驻，Hermes 或 Codex 会按需启动它。stdout 只输出 JSON-RPC，日志不会污染协议通道。
 
-当前提供 13 个工具：
+当前提供以下工具：
 
 | 工具 | 用途 |
 | --- | --- |
@@ -277,6 +277,7 @@ python -m memleaf.mcp_server --vault "$HOME/.memleaf"
 | `context` | 兼容保留的有界轻量目录，不用于自动检索路径 |
 | `scope_catalog` | 返回 Scope、父级和别名，不返回具体记忆正文 |
 | `search` | 返回有界候选目录和 `found`/`no_match` 状态 |
+| `list_todos` | 跨 Scope 按状态和日期筛选并分页列出当前待办 |
 | `read` | 使用当前 `retrieval_id` 分页读取选中的记忆正文 |
 | `process` | 处理完整 inbox 轮次并按准入规则提炼；`background=true` 时异步入队 |
 | `process_status` | 只读查询异步处理 job 状态 |