memleaf 0.2.3__tar.gz → 0.2.4__tar.gz

{memleaf-0.2.3 → memleaf-0.2.4}/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to memleaf are documented here.
 
+## 0.2.4 — 2026-09-01
+
+- Give `relative_time` retries explicit, actionable correction instructions so
+  the summarizer recalculates one-off dates from evidence timestamps, removes
+  relative wording, and resolves conflicting parenthesized dates before the
+  strict validator accepts the memory.
+- Preserve the `relative_time` validation detail across the Hermes provider
+  boundary instead of degrading it to `other_schema_violation` in diagnostics.
+
 ## 0.2.3 — 2026-09-01
 
 - Preserve capture event timestamps in extraction prompts and resolve one-off

{memleaf-0.2.3 → memleaf-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memleaf
-Version: 0.2.3
+Version: 0.2.4
 Summary: A local-first Markdown memory core for AI agents
 Author: memleaf contributors
 License-Expression: MIT
@@ -23,8 +23,8 @@ Dynamic: license-file
 
 [English](README.en.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **当前版本：0.2.3。**
-> 核心库、Vault、stdio MCP Server、初始化 CLI、模型路由、提炼流程、受控检索协议和宿主适配器已经实现。memleaf 0.2.3 通过 PyPI 分发。
+> **当前版本：0.2.4。**
+> 核心库、Vault、stdio MCP Server、初始化 CLI、模型路由、提炼流程、受控检索协议和宿主适配器已经实现。memleaf 0.2.4 通过 PyPI 分发。
 > **当前版本支持 Hermes 和 Codex。** Antigravity（反重力）不检测、不安装、不配置。
 
 ## 项目定位

{memleaf-0.2.3 → memleaf-0.2.4}/README.en.md

@@ -4,8 +4,8 @@
 
 [中文](README.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **Version: 0.2.3.**
-> The core library, Vault, stdio MCP server, initialization CLI, model routing, memory extraction, controlled retrieval protocol, and host adapters are implemented. memleaf 0.2.3 is distributed through PyPI.
+> **Version: 0.2.4.**
+> The core library, Vault, stdio MCP server, initialization CLI, model routing, memory extraction, controlled retrieval protocol, and host adapters are implemented. memleaf 0.2.4 is distributed through PyPI.
 > **The current release supports Hermes and Codex.** Antigravity is not detected, installed, or configured.
 
 ## Project scope

{memleaf-0.2.3 → memleaf-0.2.4}/README.md

@@ -4,8 +4,8 @@
 
 [English](README.en.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **当前版本：0.2.3。**
-> 核心库、Vault、stdio MCP Server、初始化 CLI、模型路由、提炼流程、受控检索协议和宿主适配器已经实现。memleaf 0.2.3 通过 PyPI 分发。
+> **当前版本：0.2.4。**
+> 核心库、Vault、stdio MCP Server、初始化 CLI、模型路由、提炼流程、受控检索协议和宿主适配器已经实现。memleaf 0.2.4 通过 PyPI 分发。
 > **当前版本支持 Hermes 和 Codex。** Antigravity（反重力）不检测、不安装、不配置。
 
 ## 项目定位

{memleaf-0.2.3 → memleaf-0.2.4}/pyproject.toml

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

{memleaf-0.2.3 → memleaf-0.2.4}/src/memleaf/__init__.py

@@ -1,6 +1,6 @@
 """Local-first Markdown memory core for AI agents."""
 
-__version__ = "0.2.3"
+__version__ = "0.2.4"
 
 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.3 → memleaf-0.2.4}/src/memleaf/hermes_provider/__init__.py

@@ -85,6 +85,7 @@ _MODEL_VALIDATION_DETAILS = frozenset(
         "reason_too_long",
         "source_shape",
         "todo_fields",
+        "relative_time",
         "other_schema_violation",
     }
 )

{memleaf-0.2.3 → memleaf-0.2.4}/src/memleaf/hermes_provider/plugin.yaml

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

{memleaf-0.2.3 → memleaf-0.2.4}/src/memleaf/processing.py

@@ -30,7 +30,14 @@ from .locking import atomic_write_json, atomic_write_text, read_json
 from .memory_writer import MemoryWriter
 from .models import Memory, utc_now
 from .native_index import NativeIndexer
-from .prompts import JSON_CORRECTION, GATE_SYSTEM, SUMMARIZE_SYSTEM, gate_prompt, summarize_prompt
+from .prompts import (
+    JSON_CORRECTION,
+    RELATIVE_TIME_CORRECTION,
+    GATE_SYSTEM,
+    SUMMARIZE_SYSTEM,
+    gate_prompt,
+    summarize_prompt,
+)
 from .redaction import redact_text
 from .retrieval import candidate_matches_query, filter_by_scope, normalize_term
 from .scope_state import ScopeError, normalize_scopes, register_scope_nodes
@@ -463,6 +470,15 @@ class Processor:
                 return reason
         return None
 
+    @staticmethod
+    def _correction_instruction(error: BaseException) -> Optional[str]:
+        hint = Processor._safe_correction_hint(error)
+        if hint == "relative_time":
+            return RELATIVE_TIME_CORRECTION
+        if hint is not None:
+            return f"Previous output violated: {hint}."
+        return None
+
     def _diagnostic_enabled(self) -> bool:
         try:
             config = self.service.vault.config()
@@ -620,10 +636,10 @@ class Processor:
                 except Exception:
                     pass
                 if self._allows_next_json_attempt(error, attempt_count):
-                    hint = self._safe_correction_hint(error)
                     correction_prompt = prompt + "\n\n" + JSON_CORRECTION
-                    if hint is not None:
-                        correction_prompt += f"\nPrevious output violated: {hint}."
+                    instruction = self._correction_instruction(error)
+                    if instruction is not None:
+                        correction_prompt += f"\n{instruction}"
                     continue
                 raise
             try:

{memleaf-0.2.3 → memleaf-0.2.4}/src/memleaf/prompts.py

@@ -195,6 +195,22 @@ JSON_CORRECTION = (
 )
 
 
+RELATIVE_TIME_CORRECTION = (
+    "Previous output violated: relative_time. Re-read the evidence events and use "
+    "the timestamp of the event supporting each date as the anchor; recompute "
+    "each one-off relative date from that timestamp and the stated weekday "
+    "semantics. In the summary title and body, every one-off calendar date must "
+    "be written only as YYYY-MM-DD: remove forms such as today/tomorrow/yesterday, "
+    "今天/明天/昨天, 本周三/这周三/下周三/上周三, and this/next/last Wednesday. "
+    "If a relative weekday is followed by a parenthesized numeric date and they "
+    "conflict, trust the event timestamp plus the weekday meaning, replace the "
+    "numeric date with the computed YYYY-MM-DD, and remove the relative wording "
+    "and conflicting parenthetical date. Do not guess when no supporting timestamp "
+    "exists; omit or defer the date-dependent detail. Recurring schedules such as "
+    "每天、每周三, or every Wednesday are allowed. Return only the strict JSON object."
+)
+
+
 COMPACT_SYSTEM = """You are memleaf's memory compactor. Return JSON only.
 Merge only the supplied low-priority memories when they express compatible
 information. Return an object with a memories array; [] is a safe no-op.

{memleaf-0.2.3 → memleaf-0.2.4}/src/memleaf.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memleaf
-Version: 0.2.3
+Version: 0.2.4
 Summary: A local-first Markdown memory core for AI agents
 Author: memleaf contributors
 License-Expression: MIT
@@ -23,8 +23,8 @@ Dynamic: license-file
 
 [English](README.en.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **当前版本：0.2.3。**
-> 核心库、Vault、stdio MCP Server、初始化 CLI、模型路由、提炼流程、受控检索协议和宿主适配器已经实现。memleaf 0.2.3 通过 PyPI 分发。
+> **当前版本：0.2.4。**
+> 核心库、Vault、stdio MCP Server、初始化 CLI、模型路由、提炼流程、受控检索协议和宿主适配器已经实现。memleaf 0.2.4 通过 PyPI 分发。
 > **当前版本支持 Hermes 和 Codex。** Antigravity（反重力）不检测、不安装、不配置。
 
 ## 项目定位

{memleaf-0.2.3 → memleaf-0.2.4}/tests/test_hermes_provider.py

@@ -1717,6 +1717,44 @@ class HermesProviderTests(unittest.TestCase):
         self.assertIsNotNone(fields)
         self.assertEqual(fields[4], "invalid_update_target")
 
+    def test_relative_time_validation_detail_is_preserved_and_logged(self) -> None:
+        value = {
+            "isError": True,
+            "structuredContent": {
+                "error": {
+                    "code": "model_invalid_response",
+                    "stage": "summarize",
+                    "validation_reason": "schema_violation",
+                    "validation_detail": "relative_time",
+                    "attempt_count": 3,
+                }
+            },
+        }
+        fields = provider_module._mcp_error_fields(value)
+        self.assertIsNotNone(fields)
+        self.assertEqual(fields[4], "relative_time")
+        error = provider_module._MCPToolError(
+            code="model_invalid_response",
+            stage="summarize",
+            validation_reason="schema_violation",
+            validation_detail="relative_time",
+            attempt_count=3,
+        )
+        self.assertEqual(error.validation_detail, "relative_time")
+
+        provider = self.provider(
+            responses=[
+                {"stored": True},
+                {"stored": True},
+                value,
+            ]
+        )
+        with patch.object(provider_module.logger, "info") as info:
+            provider.sync_turn("visible user", "visible assistant", session_id="relative-time-session")
+        output = "\n".join(call.args[0] % call.args[1:] for call in info.call_args_list)
+        self.assertIn("validation_detail=relative_time", output)
+        self.assertIn("attempt_count=3", output)
+
     def test_capture_failure_skips_process_and_does_not_escape_provider(self) -> None:
         provider = self.provider(responses=[{"stored": True}, RuntimeError("capture unavailable")])
         with patch.object(provider_module.logger, "warning") as warning:

{memleaf-0.2.3 → memleaf-0.2.4}/tests/test_pypi_install.py

@@ -39,7 +39,7 @@ class PyPIInstallTests(unittest.TestCase):
 
             self.assertTrue(target.is_dir())
             self.assertFalse(target.is_symlink())
-            self.assertIn("version: 0.2.3", (target / "plugin.yaml").read_text(encoding="utf-8"))
+            self.assertIn("version: 0.2.4", (target / "plugin.yaml").read_text(encoding="utf-8"))
 
     def test_windows_hermes_paths_follow_official_native_layout(self) -> None:
         with tempfile.TemporaryDirectory(prefix="memleaf-win-paths-") as temporary:

{memleaf-0.2.3 → memleaf-0.2.4}/tests/test_stage_b1.py

@@ -9,7 +9,13 @@ from unittest import mock
 from memleaf import Memleaf
 from memleaf.config import default_config, load_config, save_config
 from memleaf.inbox import complete_turns, parse_inbox
-from memleaf.prompts import GATE_SYSTEM, SUMMARIZE_SYSTEM, gate_prompt, summarize_prompt
+from memleaf.prompts import (
+    GATE_SYSTEM,
+    RELATIVE_TIME_CORRECTION,
+    SUMMARIZE_SYSTEM,
+    gate_prompt,
+    summarize_prompt,
+)
 from memleaf.validation import ModelOutputError
 from memleaf.index import event_key, turn_key
 from memleaf.llm import (
@@ -204,7 +210,11 @@ class StageB1Test(unittest.TestCase):
                 "status": "active",
             }
 
-        responses = [json.dumps(gate), json.dumps(summary("在本周三前完成。")), json.dumps(summary("在2026-09-02前完成。"))]
+        responses = [
+            json.dumps(gate),
+            json.dumps(summary("在本周三（9/3）前完成。")),
+            json.dumps(summary("在2026-09-02前完成。")),
+        ]
         calls = []
 
         def callback(prompt, **kwargs):
@@ -231,6 +241,11 @@ class StageB1Test(unittest.TestCase):
         self.assertEqual(len(calls), 3)
         self.assertEqual([purpose for _, purpose in calls], ["gate", "summarize", "summarize"])
         self.assertIn(anchor, calls[0][0])
+        self.assertIn(RELATIVE_TIME_CORRECTION, calls[2][0])
+        self.assertIn("event supporting each date as the anchor", calls[2][0])
+        self.assertIn("every one-off calendar date must be written only as YYYY-MM-DD", calls[2][0])
+        self.assertIn("parenthesized numeric date", calls[2][0])
+        self.assertIn("trust the event timestamp plus the weekday meaning", calls[2][0])
         self.assertIn("Previous output violated: relative_time.", calls[2][0])
         memory = self.service.read(result["memory_ids"][0])
         self.assertIsNotNone(memory)

{memleaf-0.2.3 → memleaf-0.2.4}/tests/test_stage_c1_mcp.py

@@ -104,7 +104,7 @@ class StageC1MCPTest(unittest.TestCase):
         testcase.assertEqual(result["resultType"], "complete")
         testcase.assertEqual(
             result["_meta"]["io.modelcontextprotocol/serverInfo"],
-            {"name": "memleaf", "version": "0.2.3"},
+            {"name": "memleaf", "version": "0.2.4"},
         )
         return result
 

{memleaf-0.2.3 → memleaf-0.2.4}/tests/test_stage_c3_packaging.py

@@ -24,7 +24,7 @@ class StageC3PackagingTests(unittest.TestCase):
 
     def test_project_metadata_and_version_export(self) -> None:
         self.assertEqual(self.project["name"], "memleaf")
-        self.assertEqual(self.project["version"], "0.2.3")
+        self.assertEqual(self.project["version"], "0.2.4")
         self.assertEqual(self.project["requires-python"], ">=3.11")
         self.assertEqual(self.project["dependencies"], [])
         self.assertEqual(self.project["license"], "MIT")