memleaf 0.2.45__tar.gz → 0.2.46__tar.gz

{memleaf-0.2.45 → memleaf-0.2.46}/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to memleaf are documented here.
 
+## 0.2.46 — 2026-09-12
+
+- Restore the host protocol literals that v0.2.45 dropped from the API-route protocol table. `anthropic_messages`, `chat_completions`, `chat`, `google` and `generate_content` resolve again. v0.2.45 replaced the previous tolerant mapping with an exact table that omitted every canonical Hermes `api_mode` value, so a Hermes custom provider that used to resolve to a protocol began resolving to none and was reported as `missing provider, base URL, protocol, or model`. Substring and model-name matching stay removed: only exact host-contract literals are accepted, and an unknown protocol still fails closed.
+- Stop `memleaf install --host hermes` from aborting when model-route discovery finds nothing. Installation now continues and reports `processing_status: model_route_required` with an explicit user action, matching the Codex installer policy. Previously the install returned `stage: model_route` before touching the provider, which left the core package upgraded while the Hermes provider stayed on its previous version. The provider and MCP surface do not need a model route for capture or retrieval, so a missing route is a deferred configuration step rather than an installation failure.
+- Add `install --no-model-discovery` so an upgrade can skip host model discovery while still preserving an existing memleaf route, matching the `init` flag that already existed. Discovery remains enabled by default, so an installation that already succeeds is unaffected.
+- Verification for this release used synthetic Hermes-shaped routes, a temporary Vault and mocked host calls only: 18 focused tests cover the restored protocol literals, rejection of still-unknown protocols, discovery of a Hermes-shaped custom provider, the degraded-install decision, the new CLI flag, and an end-to-end assertion that `install_hermes` walks past a failed model route. No real provider call was made and no production Vault, Hermes configuration or session was read or written. A real Windows Hermes install and a real macOS Hermes install remain unverified by this release, and the manual model-route configuration step is still required on a host whose credentials the host CLI only reports masked.
+
 ## 0.2.45 — 2026-09-12
 
 - Repair the `b3-single-pass-v1` automatic extraction contract so model output is constrained by the same CREATE / UPDATE / NO_CHANGE / DEFERRED fields, evidence shapes, no-memory/defer reasons, target rules and lookup-completeness checks that Core validates. Pure ASCII decision-case differences are normalized locally; unknown decisions and missing semantic fields still fail closed.

{memleaf-0.2.45/src/memleaf.egg-info → memleaf-0.2.46}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memleaf
-Version: 0.2.45
+Version: 0.2.46
 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.45。**
+> **版本：0.2.46。**
 > 记忆只从用户与 Agent 的可见对话提炼。Agent 已在回复中整理的事实、项目进展和明确待办可作为来源；邮件、附件、网页和终端等工具原文不进入记忆提炼。模型负责保留原话中的不确定性，现有记忆仅用于比较、去重和更新。Markdown 仍是唯一事实源。
 > **当前版本支持 Hermes 和 Codex。** Antigravity（反重力）不检测、不安装、不配置。
 

{memleaf-0.2.45 → memleaf-0.2.46}/README.en.md

@@ -4,7 +4,7 @@
 
 [中文](README.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **Version: 0.2.45.**
+> **Version: 0.2.46.**
 > Automatic extraction now uses only the current turn's visible user input and final assistant reply. Raw tool output, attachments, web/file/terminal payloads and legacy tool-evidence bodies are not new source evidence; existing or retrieved memory remains comparison context rather than source authority. Background processing is persisted as a local job and can be checked through the read-only `process_status` MCP tool; failed work remains retryable and fail closed. The release also tightens source/date grounding, target reconciliation, duplicate/no-op handling and semantic review before writes. Markdown remains the sole source of truth with no SQLite runtime dependency. Acceptance covers deterministic regression suites and synthetic inputs; it does not claim real-mail or customer-business acceptance.
 > **The current release supports Hermes and Codex.** Antigravity is not detected, installed, or configured.
 

{memleaf-0.2.45 → memleaf-0.2.46}/README.md

@@ -4,7 +4,7 @@
 
 [English](README.en.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **版本：0.2.45。**
+> **版本：0.2.46。**
 > 记忆只从用户与 Agent 的可见对话提炼。Agent 已在回复中整理的事实、项目进展和明确待办可作为来源；邮件、附件、网页和终端等工具原文不进入记忆提炼。模型负责保留原话中的不确定性，现有记忆仅用于比较、去重和更新。Markdown 仍是唯一事实源。
 > **当前版本支持 Hermes 和 Codex。** Antigravity（反重力）不检测、不安装、不配置。
 

{memleaf-0.2.45 → memleaf-0.2.46}/pyproject.toml

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

{memleaf-0.2.45 → memleaf-0.2.46}/src/memleaf/__init__.py

@@ -1,6 +1,6 @@
 """Local-first Markdown memory core for AI agents."""
 
-__version__ = "0.2.45"
+__version__ = "0.2.46"
 
 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.45 → memleaf-0.2.46}/src/memleaf/cli.py

@@ -77,6 +77,14 @@ def build_parser() -> argparse.ArgumentParser:
             "this installation (current), or retain a version-matched configured runtime (existing)"
         ),
     )
+    install.add_argument(
+        "--no-model-discovery",
+        action="store_true",
+        help=(
+            "Hermes only: skip host model discovery; an existing memleaf route is "
+            "still preserved and the install continues either way"
+        ),
+    )
     install.add_argument("--json", action="store_true", help="emit one JSON result")
     audit = commands.add_parser("audit", help="inspect an existing Vault without changing it")
     audit.add_argument("--vault", type=Path, default=None)
@@ -232,6 +240,8 @@ def main(argv: Sequence[str] | None = None) -> int:
                 install_kwargs = {"vault_path": args.vault}
                 if args.mcp_runtime != "auto":
                     install_kwargs["mcp_runtime"] = args.mcp_runtime
+                if args.no_model_discovery:
+                    install_kwargs["skip_model_discovery"] = True
                 output = install_hermes(**install_kwargs)
         elif args.command in {"audit", "process"}:
             from .inspection import audit_vault, existing_root, preview_process
@@ -302,8 +312,12 @@ def main(argv: Sequence[str] | None = None) -> int:
                 print("Restart Hermes to use memleaf.")
             elif output.get("user_action_required"):
                 print(f"Codex action required: {output.get('user_action')}")
-            if output.get("model", {}).get("status") == "not_configured":
-                print("Configure a memleaf model route before using automatic processing.")
+            if output.get("processing_status") == "model_route_required":
+                print(
+                    "Automatic memory extraction needs a memleaf model route before it can run. "
+                    "Set llm.provider/family/protocol/base_url/model/key in the Vault config.yaml, "
+                    "or rerun `memleaf init` from an interactive terminal."
+                )
         else:
             _print_install_failure(output, host=args.host)
         return 0 if output.get("status") in {"configured", "already_configured"} else 2

{memleaf-0.2.45 → memleaf-0.2.46}/src/memleaf/hermes_provider/plugin.yaml

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

{memleaf-0.2.45 → memleaf-0.2.46}/src/memleaf/installer.py

@@ -15,7 +15,7 @@ import subprocess
 import sys
 import sysconfig
 import tempfile
-from typing import Any
+from typing import Any, Mapping
 
 from . import __version__
 from .adapters.base import (
@@ -754,10 +754,33 @@ def _failure_result(
     return result
 
 
+def _model_route_outcome(model: Any) -> tuple[bool, str, str | None]:
+    """Decide how one host installation reports its model route.
+
+    A missing model route must never block installing the host integration.
+    The provider/MCP surface still serves capture and retrieval without one,
+    so installation continues and reports ``model_route_required`` until a
+    route is configured.  This is the documented Codex policy, and applying it
+    to Hermes keeps the two hosts consistent instead of aborting the install
+    and leaving core and provider versions out of step.
+    """
+
+    if isinstance(model, Mapping) and model.get("status") in {"configured", "already_configured"}:
+        return True, "ready", None
+    return (
+        False,
+        "model_route_required",
+        "Configure an independent memleaf Model Route for this Vault before relying on "
+        "automatic memory extraction. Host model/provider settings are intentionally "
+        "not used or modified.",
+    )
+
+
 def install_hermes(
     *,
     vault_path: Path | None = None,
     mcp_runtime: str = "auto",
+    skip_model_discovery: bool = False,
 ) -> dict[str, Any]:
     """Install memleaf for Hermes with runtime preflight and host rollback.
 
@@ -870,18 +893,14 @@ def install_hermes(
         home=home,
         dry_run=False,
         non_interactive=not sys.stdin.isatty(),
-        skip_discovery=False,
+        skip_discovery=skip_model_discovery,
     )
-    if model.get("status") == "failure":
-        return _failure_result(
-            stage="model_route",
-            reason="model route is not configured",
-            core_version=core_version,
-            vault=vault.root,
-            vault_source=vault_source,
-            model=model,
-            mcp_runtime=runtime_details,
-        )
+    # A missing route degrades the installation instead of aborting it: the
+    # Hermes provider and MCP surface do not need a model route, and stopping
+    # here used to leave core and provider versions out of step.
+    model_ready, processing_status, model_action = _model_route_outcome(model)
+    # ``model_ready`` is reported through ``processing_status`` below; the host
+    # integration itself is configured either way.
 
     provider_target = hermes_home / "plugins" / "memleaf"
     provider_config = hermes_home / "memleaf.json"
@@ -1079,6 +1098,9 @@ def install_hermes(
         "model": model,
         "native_sources": native_registration,
         "capture": capture_policy_status(vault.config()),
+        "processing_status": processing_status,
+        "user_action_required": bool(model_action),
+        "user_action": model_action,
     }
 
 

{memleaf-0.2.45 → memleaf-0.2.46}/src/memleaf/model_capabilities.py

@@ -36,13 +36,23 @@ _LEGACY_PROVIDER_PROTOCOL = {
     "google": "gemini",
 }
 
+# Exact protocol identities, including the canonical ``api_mode`` literals a
+# Hermes configuration actually stores (``chat_completions`` and
+# ``anthropic_messages``).  These are host-contract literals, not fuzzy
+# guesses: substring and model-name matching stay removed so a custom alias can
+# never authorize a protocol it does not name.
 _PROTOCOL_ALIASES = {
     "openai": "openai",
     "openai-compatible": "openai",
     "openai_compatible": "openai",
+    "chat_completions": "openai",
+    "chat": "openai",
     "claude": "claude",
     "anthropic": "claude",
+    "anthropic_messages": "claude",
     "gemini": "gemini",
+    "google": "gemini",
+    "generate_content": "gemini",
 }
 
 

{memleaf-0.2.45 → memleaf-0.2.46/src/memleaf.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memleaf
-Version: 0.2.45
+Version: 0.2.46
 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.45。**
+> **版本：0.2.46。**
 > 记忆只从用户与 Agent 的可见对话提炼。Agent 已在回复中整理的事实、项目进展和明确待办可作为来源；邮件、附件、网页和终端等工具原文不进入记忆提炼。模型负责保留原话中的不确定性，现有记忆仅用于比较、去重和更新。Markdown 仍是唯一事实源。
 > **当前版本支持 Hermes 和 Codex。** Antigravity（反重力）不检测、不安装、不配置。