memleaf 0.2.52__tar.gz → 0.2.53__tar.gz

{memleaf-0.2.52 → memleaf-0.2.53}/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to memleaf are documented here.
 
+## 0.2.53 — 2026-09-13
+
+- Keep the memory when only the project name is unproven. A real turn was lost in full because of one word: the user wrote "在弄个记账的小玩意儿，就扔家里那台 N100 上跑，没打算上云", the model named the project `project:记账小玩意儿` -- the user's phrase with 的 removed -- and Core refuses a project scope whose name is not in the candidate's own evidence. That refusal discarded the whole candidate, so the N100 deployment and the no-cloud decision went with the unproven name, leaving three evidence units unresolved and nothing written. The memory was grounded; only the affiliation was not. The claim is now dropped and the memory kept with `global`, which asserts no ownership and loses no source-backed content. The refusal itself is unchanged: Core still never records a project it cannot ground.
+- Name the project from the evidence verbatim, and prefer the shortest term that appears. The same turn showed the model composing a name by editing the user's words, which is the failure mode the grounding rule catches. The contract now says so directly, with the worked example: the thing described as "记账的小玩意儿" is `project:记账`, not `project:记账小玩意儿` and not `project:记账的小玩意儿`. Measured against the live model on the exact captured turn, the composed name is gone and both the with-assistant and user-only variants yield `project:记账`.
+- Make the B3 outcome counters actually surface. `b3_normalization_count` and `b3_candidate_deferred_count` were emitted but were not in the metric allowlist, so they were discarded without a word -- which made the "visible rather than silent" claim in the 0.2.49 and 0.2.50 notes untrue. Both are now recorded, together with `b3_ungrounded_scope_dropped_count` for the fallback above.
+
+Verification for this release used the real model on the captured turn. 118 tests pass with no model call, pinning the grounding rule that caused the loss (a verbatim name passes, the edited name does not), the fallback (a project scope becomes `global`, non-project scopes survive, an empty input still yields a legal scope), and the grounding decision itself. Against the live route, replaying the exact captured turn with and without the assistant's reply now yields `project:记账` in both cases, where before the fix the with-assistant variant yielded the ungrounded composed name. The deferred candidates of that already-processed turn are replayed from the journal rather than re-attempted, so the memory lost by the old code is not recovered by upgrading; the fix applies to turns processed from now on.
+
 ## 0.2.52 — 2026-09-13
 
 - Stop an assistant message from originating a durable claim. A three-sentence acceptance run recorded a project requirement the user never asked for: the user wrote only "我写日志习惯用中文，英文的扫两眼就跳过去了", the assistant replied with its own elaboration ("记账工具的日志……都写成中文；异常堆栈上头再包一层人话"), and the planner stored that elaboration as a project fact. The design allows an assistant reply as a source for *organising what the user already said*, so the rule is now explicit about what that excludes: an assistant message may organise, restate or report what the user's own evidence establishes, may never be the only support for a durable claim, and contributes nothing where it states a decision, requirement, rule, plan, recommendation or added detail of its own -- however definite it sounds. Consequences the assistant derived from a user preference are the assistant's, not the user's, and are not recorded as requirements or project state.

{memleaf-0.2.52/src/memleaf.egg-info → memleaf-0.2.53}/PKG-INFO

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

{memleaf-0.2.52 → memleaf-0.2.53}/README.en.md

@@ -4,7 +4,7 @@
 
 [中文](README.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **Version: 0.2.52.**
+> **Version: 0.2.53.**
 > 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.52 → memleaf-0.2.53}/README.md

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

{memleaf-0.2.52 → memleaf-0.2.53}/pyproject.toml

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

{memleaf-0.2.52 → memleaf-0.2.53}/src/memleaf/__init__.py

@@ -1,6 +1,6 @@
 """Local-first Markdown memory core for AI agents."""
 
-__version__ = "0.2.52"
+__version__ = "0.2.53"
 
 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.52 → memleaf-0.2.53}/src/memleaf/hermes_provider/plugin.yaml

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

{memleaf-0.2.52 → memleaf-0.2.53}/src/memleaf/model_execution.py

@@ -51,6 +51,12 @@ _COVERAGE_DIAGNOSTIC_FIELDS = frozenset({"explanation"})
 _METRIC_EVENT_FIELDS = frozenset({
     "repair_attempted_count", "repair_rejected_semantic_drift_count",
     "parse_accepted_count", "decision_case_normalization_count",
+    # Normalization, deferral and scope fallback are all outcomes a turn can
+    # reach without failing, so they must actually surface in the metrics.  The
+    # first two were emitted but silently dropped here, which made the
+    # "visible rather than silent" claim in their release notes untrue.
+    "b3_normalization_count", "b3_candidate_deferred_count",
+    "b3_ungrounded_scope_dropped_count",
 })
 _THINKING_OBSERVATION_SOURCES = frozenset({
     "request_parameter", "reasoning_tokens", "reasoning_content", "unavailable",
@@ -82,6 +88,9 @@ def _metric_bucket() -> dict[str, Any]:
         "repair_rejected_semantic_drift_count": 0,
         "parse_accepted_count": 0,
         "decision_case_normalization_count": 0,
+        "b3_normalization_count": 0,
+        "b3_candidate_deferred_count": 0,
+        "b3_ungrounded_scope_dropped_count": 0,
         "_first_started": None,
         "_last_finished": None,
     }

{memleaf-0.2.52 → memleaf-0.2.53}/src/memleaf/single_pass_memory_planner.py

@@ -34,6 +34,25 @@ from .validation import ModelOutputError, parse_summarize_output
 from .llm import ModelUnavailable
 
 
+def _drop_ungrounded_project_scopes(scopes: Iterable[Any]) -> list[str]:
+    """Return the scopes that assert no unproven project ownership.
+
+    A project scope is a claimed affiliation and Core refuses one the evidence
+    does not name.  The memory carrying it is usually grounded in full; only the
+    affiliation is unproven, so the claim is dropped rather than the memory.
+    Measured on a real turn, discarding the candidate instead lost
+    "在弄个记账的小玩意儿，跑在 N100，不上云" entirely because the model had
+    named the project "记账小玩意儿" while the user wrote "记账的小玩意儿".
+    """
+
+    kept = [
+        scope
+        for scope in scopes
+        if not (isinstance(scope, str) and scope.startswith("project:"))
+    ]
+    return kept or ["global"]
+
+
 class SinglePassMemoryPlanner(MemoryPlanner):
     """One semantic model call for an ordinary automatic turn."""
 
@@ -430,10 +449,24 @@ class SinglePassMemoryPlanner(MemoryPlanner):
                 validation_scope_registry,
                 authorized_project_scopes,
             ):
-                raise ModelOutputError(
-                    "B3 project scope is not grounded by claimed source",
-                    validation_detail="scope_not_grounded",
-                )
+                # The memory itself is grounded; only the ownership claim is
+                # not.  Discarding the whole candidate over an unproven project
+                # name loses source-backed content the user stated, so the
+                # claim is dropped and the memory is kept unscoped instead.
+                # Nothing is fabricated either way: no ownership is asserted.
+                kept = _drop_ungrounded_project_scopes(scopes)
+                dropped = kept != list(scopes)
+                scopes = kept
+                scope_source = self._derived_scope_source(scopes, scope_background, scope)
+                candidate["scopes"] = scopes
+                candidate["scope_source"] = scope_source
+                if dropped:
+                    event = getattr(self.model, "_record_metric_event", None)
+                    if callable(event):
+                        event(
+                            {"stage": "single_pass", "operation": "single_pass_primary"},
+                            "b3_ungrounded_scope_dropped_count",
+                        )
             if (
                 decision == "UPDATE"
                 and target_memory is not None

{memleaf-0.2.52 → memleaf-0.2.53}/src/memleaf/single_pass_plan.py

@@ -129,7 +129,7 @@ Extract every independently useful long-term memory. Keep independently retrieva
 SCOPES
 Legal values: global | domain:<name> | portfolio:<name> | project:<name> | unscoped. scopes is a nonempty array; at most one project:<name> per memory; unscoped must be the only value, and Core then records insufficient_context.
 When a candidate concerns one distinct project the user is working on -- a type=project memory, or the work, decisions, state or deadlines that belong to that project -- scope it to that project as project:<name>, using the name the evidence itself uses. The project does not need to be registered first; scope_registry only lists what already exists.
-Ground the name in this candidate's own cited evidence, or in a project scope explicitly supplied for this turn. A product, platform, system, vendor, notification source, comparison or implementation context is not ownership by name alone.
+Ground the name in this candidate's own cited evidence, or in a project scope explicitly supplied for this turn. Never edit, translate or combine the evidence's words into a name that does not appear there, and choose the shortest term that does appear and names the project: the thing described as "记账的小玩意儿" is project:记账, not project:记账小玩意儿 and not project:记账的小玩意儿. An ungrounded name is rejected and its memory is deferred instead of written. A product, platform, system, vendor, notification source, comparison or implementation context is not ownership by name alone.
 Use global only for a fact that no single project owns: a standing personal preference, a machine-wide or tool-wide rule, or an environment fact. Never invent, translate or borrow a project name.
 
 DATES

{memleaf-0.2.52 → memleaf-0.2.53/src/memleaf.egg-info}/PKG-INFO

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