memleaf 0.2.11__tar.gz → 0.2.13__tar.gz

{memleaf-0.2.11 → memleaf-0.2.13}/CHANGELOG.md

@@ -2,6 +2,31 @@
 
 All notable changes to memleaf are documented here.
 
+## 0.2.13 — 2026-09-02
+
+- Preserve the full active project-plan body, stable title, and retrieval
+  metadata when a customer suggestion only adds constraints; explicit
+  replacements continue to replace conflicting state normally.
+- Reject attachment, document, presentation, material, and issue-list items
+  described only by transport metadata or a generic follow-up at both the gate
+  and summary boundaries.
+- Keep concrete attachment-backed actions eligible when they include a
+  remediation, owner, deadline, delivery rule, deployment, or migration.
+
+## 0.2.12 — 2026-09-02
+
+- Remove empty ASCII or Chinese parentheses left after an absolute date is
+  normalized, so permanent memory never stores values such as
+  `2026-09-03（）`.
+- Reconcile a same-scoped implementation-plan candidate with its unique active
+  project-plan memory even when the model labels the candidate as a fact or
+  omits `update_memory_id`; preserve the target's immutable type and history.
+- Exclude sent-mail, attachment, archive, and meeting records from automatic
+  plan-target inference, and defer instead of guessing when multiple project
+  plan targets remain.
+- Reject combined mailbox or daily-report count/status digests as permanent
+  memory while keeping separately emitted atomic actions eligible.
+
 ## 0.2.11 — 2026-09-02
 
 - Document one complete macOS/Linux upgrade command that upgrades the core

{memleaf-0.2.11/src/memleaf.egg-info → memleaf-0.2.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memleaf
-Version: 0.2.11
+Version: 0.2.13
 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.11。**
-> 核心库、Vault、stdio MCP Server、初始化 CLI、模型路由、提炼流程、受控检索协议和宿主适配器已经实现。memleaf 0.2.11 通过 PyPI 分发。
+> **当前版本：0.2.13。**
+> 核心库、Vault、stdio MCP Server、初始化 CLI、模型路由、提炼流程、受控检索协议和宿主适配器已经实现。memleaf 0.2.13 通过 PyPI 分发。
 > **当前版本支持 Hermes 和 Codex。** Antigravity（反重力）不检测、不安装、不配置。
 
 ## 项目定位

{memleaf-0.2.11 → memleaf-0.2.13}/README.en.md

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

{memleaf-0.2.11 → memleaf-0.2.13}/README.md

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

{memleaf-0.2.11 → memleaf-0.2.13}/pyproject.toml

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

{memleaf-0.2.11 → memleaf-0.2.13}/src/memleaf/__init__.py

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

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

{memleaf-0.2.11 → memleaf-0.2.13}/src/memleaf/processing.py

@@ -64,6 +64,8 @@ from .validation import (
     parse_strict_json,
     parse_summarize_output,
     normalize_relative_calendar_text,
+    is_aggregate_operational_text,
+    is_attachment_followup_only_text,
 )
 from .vault import safe_component
 
@@ -1682,6 +1684,160 @@ class Processor:
         # parser has already limited the target to an active related memory.
         return candidate_scope_source in {"user", "session_context"}
 
+    @staticmethod
+    def _project_scope_keys(scopes: Any) -> set[str]:
+        if not isinstance(scopes, list):
+            return set()
+        return {
+            scope.casefold()
+            for scope in scopes
+            if isinstance(scope, str) and scope.startswith("project:")
+        }
+
+    @staticmethod
+    def _is_project_plan_title(value: Any) -> bool:
+        text = normalize_term(value) if isinstance(value, str) else ""
+        return any(
+            marker in text
+            for marker in ("实施计划", "项目计划", "implementation plan", "project plan")
+        )
+
+    @staticmethod
+    def _is_adjacent_plan_record(value: Any) -> bool:
+        text = normalize_term(value) if isinstance(value, str) else ""
+        return any(
+            marker in text
+            for marker in (
+                "已发送", "发送", "邮件", "附件", "存档", "会议", "启动会", "纪要",
+                "sent", "email", "mail", "attachment", "archive", "meeting", "minutes",
+            )
+        )
+
+    @classmethod
+    def _merge_additive_project_plan_update(
+        cls,
+        candidate: Mapping[str, Any],
+        summary: Mapping[str, Any],
+        target: Memory | None,
+    ) -> dict[str, Any]:
+        """Preserve a full active plan when current evidence only adds constraints."""
+
+        result = dict(summary)
+        if (
+            target is None
+            or target.type != "project"
+            or not cls._is_project_plan_title(target.title)
+        ):
+            return result
+        candidate_text = str(candidate.get("memory", "")).casefold()
+        additive_markers = (
+            "建议", "补充", "增加", "新增", "追加", "还需", "同时", "纳入", "完善",
+            "suggest", "propose", "additional", "add ", "include",
+        )
+        replacement_markers = (
+            "改为", "变更为", "替换", "取消", "删除", "不再", "更新为", "调整为", "推迟至", "提前至",
+            "replace", "changed to", "no longer", "cancel", "remove", "instead", "moved to",
+        )
+        if not any(marker in candidate_text for marker in additive_markers):
+            return result
+        if any(marker in candidate_text for marker in replacement_markers):
+            return result
+
+        old_body = target.body.strip()
+        new_body = str(result.get("body", "")).strip()
+        normalized_old = " ".join(old_body.casefold().split())
+        normalized_new = " ".join(new_body.casefold().split())
+        if old_body and normalized_old not in normalized_new:
+            result["body"] = f"{old_body}\n\n{new_body}" if new_body else old_body
+        result["title"] = target.title
+        for field in ("tags", "aliases", "keywords"):
+            merged: list[str] = []
+            for value in list(getattr(target, field)) + list(result.get(field, [])):
+                if isinstance(value, str) and value not in merged:
+                    merged.append(value)
+            if merged or field in result:
+                result[field] = merged
+        return result
+
+    def _infer_update_target(
+        self,
+        candidate: Mapping[str, Any],
+        related: Iterable[Mapping[str, Any]],
+    ) -> dict[str, Any]:
+        """Reuse one unambiguously matching project plan/constraint memory.
+
+        The gate remains authoritative when it names a target.  This narrow
+        fallback handles a common model omission: a project-plan candidate is
+        emitted as a new ``fact`` without ``update_memory_id`` even though the
+        same scoped plan is already active.  The active target's type is the
+        canonical type; it is copied before summary validation so the target
+        type invariant remains enforced.
+        """
+
+        result = dict(candidate)
+        if (
+            not result.get("worth")
+            or result.get("duplicate")
+            or any(result.get(field) for field in ("duplicate_memory_id", "update_memory_id"))
+            or not isinstance(result.get("memory"), str)
+        ):
+            return result
+        if result.get("type") not in {"fact", "project"}:
+            return result
+        if not self._is_project_plan_title(result["memory"]):
+            return result
+        project_keys = self._project_scope_keys(result.get("scopes"))
+        if len(project_keys) != 1:
+            return result
+
+        project_matches: list[Memory] = []
+        fact_matches: list[Memory] = []
+        seen: set[str] = set()
+        for item in related:
+            if not isinstance(item, Mapping) or item.get("native") is True:
+                continue
+            memory_id = item.get("memory_id")
+            item_type = item.get("type")
+            item_scopes = item.get("scopes")
+            if (
+                not isinstance(memory_id, str)
+                or not isinstance(item_type, str)
+                or item_type not in {"fact", "project"}
+                or self._project_scope_keys(item_scopes) != project_keys
+                or memory_id.casefold() in seen
+                or not self._is_project_plan_title(item.get("title"))
+                or self._is_adjacent_plan_record(item.get("title"))
+            ):
+                continue
+            try:
+                target = Memory.from_mapping(item)
+            except (TypeError, ValueError):
+                continue
+            seen.add(memory_id.casefold())
+            if target.type == "project":
+                project_matches.append(target)
+            else:
+                fact_matches.append(target)
+
+        # Prefer a project target over a same-topic fact.  If there are
+        # multiple project targets, defer rather than creating a sibling by
+        # guessing; the same conservative rule applies when only multiple
+        # durable fact targets remain.
+        if len(project_matches) > 1 or (not project_matches and len(fact_matches) > 1):
+            result["_defer_reason"] = "ambiguous_update_target"
+            return result
+        if project_matches:
+            target = project_matches[0]
+        elif len(fact_matches) == 1:
+            target = fact_matches[0]
+        else:
+            return result
+        result["update_memory_id"] = target.memory_id
+        # The update target's type is immutable.  Correct a model's fact-vs-
+        # project label only after the same-use target was identified.
+        result["type"] = target.type
+        return result
+
     def _defer_candidate(
         self,
         turn_ref: tuple[str, str, str],
@@ -2026,6 +2182,13 @@ class Processor:
         requests: list[dict[str, Any]] = []
         observed_scopes: list[str] = []
         for candidate in gate["candidates"]:
+            # A combined mailbox/daily digest is not an atomic memory.  If a
+            # concrete action was worth retaining, the gate must emit it as
+            # its own candidate; the aggregate shell itself is NO_CHANGE.
+            if candidate.get("worth") and is_aggregate_operational_text(candidate.get("memory")):
+                continue
+            if candidate.get("worth") and is_attachment_followup_only_text(candidate.get("memory")):
+                continue
             candidate_scopes = list(candidate["scopes"])
             # An automatic candidate with no reliable project attribution is
             # retained as a retryable inbox turn, never silently promoted to
@@ -2075,6 +2238,11 @@ class Processor:
                 priority_only=scope_directory is not None,
                 scope_records=scoped_records if scope_directory is not None else None,
             )
+            candidate = self._infer_update_target(candidate, candidate_related)
+            defer_reason = candidate.pop("_defer_reason", None)
+            if defer_reason:
+                self._defer_candidate(turn_ref, candidate, defer_reason)
+                continue
             candidate_native_ids = [item["native_id"] for item in candidate_native_refs]
             candidate_memory_ids = [
                 item["memory_id"]
@@ -2203,6 +2371,10 @@ class Processor:
                 continue
             if summary.get("decision") == NO_CHANGE_DECISION:
                 continue
+            if is_attachment_followup_only_text(
+                f"{summary.get('title', '')}\n{summary.get('body', '')}"
+            ):
+                continue
             if gate_update_target is not None:
                 summary_update_target = summary.get("update_memory_id")
                 if summary_update_target is None:
@@ -2219,6 +2391,8 @@ class Processor:
                 else:
                     summary = dict(summary)
                     summary["update_memory_id"] = gate_update_target
+                target = self.service.read(gate_update_target, include_history=False)
+                summary = self._merge_additive_project_plan_update(candidate, summary, target)
             if summary["scopes"] == ["unscoped"] or summary.get("scope_source") == "insufficient_context":
                 self._defer_candidate(
                     turn_ref,

{memleaf-0.2.11 → memleaf-0.2.13}/src/memleaf/prompts.py

@@ -115,6 +115,10 @@ independent future use, set worth=false. A one-off meeting with no durable
 decision or commitment, a request awaiting PM acceptance, and pending feedback
 or another intermediate status normally have worth=false. Keep an independent
 project risk or concrete future action even when it came from a digest.
+A PPT, attachment, material, document, or issue-list item described only as
+"needs follow-up/review/processing" has no independent action and normally has
+worth=false; keep it only when the evidence supplies a concrete remediation,
+owner, deadline, delivery rule, migration, or durable conclusion.
 An intermediate state such as a draft awaiting confirmation, preparation/
 processing status, temporary error, repeated confirmation, or unconfirmed
 suggestion normally has no independent future use and is worth=false. Keep one
@@ -141,6 +145,16 @@ the current turn adds no confirmed change, use worth=false and do not create a
 sibling. If a customer or user proposes a new change without confirmation of
 implementation, preserve it as requested/proposed/pending and never state that
 it is already implemented.
+When a candidate names a project plan or project constraint already represented
+by one same-scoped active memory, prefer that exact active memory as
+update_memory_id, even when the candidate's initial type label is fact; the
+active target type is immutable and must be copied. Never create a sibling for
+the same future question/action. Prefer the durable project-plan target over
+same-topic sent-mail, attachment/archive, or meeting records; if multiple
+same-use project targets remain, do not guess an update target. A candidate
+that still combines a mailbox or daily digest shell with counts/statuses is not
+atomic: set worth=false for the aggregate, and emit any independent concrete
+action as a separate candidate.
 Return no prose, markdown fences, comments, or trailing text."""
 
 
@@ -172,7 +186,8 @@ still has a concrete future-use fact or action. If not, return exactly
 {"decision":"NO_CHANGE"}; this is the only no-write summary response. Use it
 for temporary delegation, waiting for feedback, a one-off meeting arrangement with
 no durable outcome/decision/project constraint, or a subject/attachment-only item
-without a concrete impact or conclusion.
+without a concrete impact or conclusion. Attachment sizes, mail/message IDs,
+and a generic "needs follow-up" phrase do not create such an impact.
 Explicit remember mode never permits NO_CHANGE and must return the normal summary
 object. When producing a normal automatic summary, copy the gate candidate's
 scopes exactly. scope_source may be omitted to inherit the gate value, but an
@@ -243,6 +258,13 @@ surrounding diagnosis into a memory. If a user-confirmed future-use
 preference, identity, constraint, project risk, or durable lesson appears in
 the same evidence, summarize only that future-use topic. In explicit remember mode,
 summarize only the requested object and do not append tool/test diagnostics.
+If the gate candidate points to a same-scoped existing plan or constraint,
+update that exact target and retain its still-valid content; do not create a
+new sibling merely because the gate called it a fact. Prefer a durable project
+plan target over same-topic sent-mail, attachment/archive, or meeting records;
+the target type remains immutable. Never summarize a combined mailbox/daily
+digest shell with counts or statuses; return NO_CHANGE for that aggregate,
+while a separate atomic future-use action may still be summarized.
 Return no prose, markdown fences, comments, or trailing text."""
 
 

{memleaf-0.2.11 → memleaf-0.2.13}/src/memleaf/validation.py

@@ -104,6 +104,10 @@ _ISO_CALENDAR_DATE = re.compile(
     r"(?<![A-Za-z\d./-])\d{4}-(?:0?[1-9]|1[0-2])-(?:0?[1-9]|[12]\d|3[01])"
     r"(?![A-Za-z\d./-])"
 )
+_EMPTY_ISO_DATE_PARENTHESIS = re.compile(
+    r"(?P<date>\d{4}-(?:0?[1-9]|1[0-2])-(?:0?[1-9]|[12]\d|3[01]))"
+    r"[ \t]*(?:\([ \t]*[)）]|（[ \t]*[)）])"
+)
 _DUPLICATE_ISO_DATE = re.compile(
     r"(?P<date>\d{4}-\d{2}-\d{2})"
     r"\s*[,，、:]?\s*(?:(?:就是|即|即为|即是|也就是|是|为)|[/／])\s*"
@@ -275,6 +279,14 @@ def _collapse_duplicate_calendar_dates(value: str) -> str:
     return value
 
 
+def _strip_empty_iso_date_parenthesis(value: str) -> str:
+    """Remove empty ASCII/Chinese parentheses attached to an ISO date."""
+
+    if not isinstance(value, str):
+        return value
+    return _EMPTY_ISO_DATE_PARENTHESIS.sub(r"\g<date>", value)
+
+
 def _normalize_relative_calendar_text(
     text: str,
     anchor: Any,
@@ -328,6 +340,7 @@ def _normalize_relative_calendar_text(
     normalized = _RELATIVE_CALENDAR_EXPRESSION.sub(replace_token, text)
     if relative_replaced:
         normalized = _collapse_duplicate_calendar_dates(normalized)
+    normalized = _strip_empty_iso_date_parenthesis(normalized)
     return normalized, safe
 
 
@@ -345,6 +358,82 @@ def normalize_relative_calendar_text(text: str, anchor: Any) -> str | None:
     return normalized if safe else None
 
 
+_AGGREGATE_DIGEST_MARKERS = (
+    "日报",
+    "汇总",
+    "巡检",
+    "收件箱",
+    "邮箱巡检",
+    "daily report",
+    "digest",
+    "watchlist",
+    "mailbox sweep",
+    "inbox sweep",
+)
+_AGGREGATE_COUNT = re.compile(
+    r"(?:\d+\s*(?:条|项|个|件|封|tasks?|items?)|(?:完成|待受理|派发|新增|逾期)\s*\d+)"
+    r"|(?:completed|pending|assigned|new|overdue)\s*[:：]?\s*\d+",
+    re.IGNORECASE,
+)
+
+
+def is_aggregate_operational_text(value: Any) -> bool:
+    """Recognize a combined operational digest, not one concrete work item.
+
+    This deliberately requires multiple aggregate signals.  A single overdue
+    task reported by a daily scan remains eligible for the model's normal
+    future-use decision; a multi-count sweep must be split before persistence.
+    """
+
+    if not isinstance(value, str):
+        return False
+    folded = value.casefold()
+    if not any(marker in folded for marker in _AGGREGATE_DIGEST_MARKERS):
+        return False
+    count_signals = len(_AGGREGATE_COUNT.findall(value))
+    separator_count = len(re.findall(r"[;；]|[—-].*[;；]", value))
+    return count_signals >= 2 or (count_signals >= 1 and separator_count >= 1)
+
+
+_ATTACHMENT_SUBJECT_MARKERS = (
+    "附件", "材料", "文档", "问题清单", "ppt", "slides", "deck", "attachment", "checklist",
+)
+_GENERIC_FOLLOWUP_MARKERS = (
+    "待跟进", "需跟进", "需要跟进", "待处理", "需处理", "需要处理", "请查看", "看下",
+    "follow up", "follow-up", "needs review", "to review",
+)
+_CONCRETE_ATTACHMENT_ACTION_MARKERS = (
+    "迁移", "部署", "修复", "整改", "逐项", "发送给", "发给", "抄送", "提交", "回复", "确认",
+    "负责人", "禁止", "必须", "以后", "归档至", "保存至", "migrate", "deploy", "fix",
+    "remediate", "send to", "cc ", "owner", "must",
+)
+_TRANSPORT_DETAIL = re.compile(
+    r"(?:\d+(?:\.\d+)?\s*(?:kb|mb|gb|字节)|(?:邮件|mail|message)\s*(?:id\s*[=:：]?\s*)?#?\d+)",
+    re.IGNORECASE,
+)
+_CONCRETE_DEADLINE = re.compile(
+    r"(?:截至|截止|在|by|before)\s*\d{4}-\d{2}-\d{2}|\d{4}-\d{2}-\d{2}\s*(?:前|之前|截止)",
+    re.IGNORECASE,
+)
+
+
+def is_attachment_followup_only_text(value: Any) -> bool:
+    """Return true for an attachment subject with no reusable concrete action."""
+
+    if not isinstance(value, str):
+        return False
+    folded = value.casefold()
+    if not any(marker in folded for marker in _ATTACHMENT_SUBJECT_MARKERS):
+        return False
+    if any(marker in folded for marker in _CONCRETE_ATTACHMENT_ACTION_MARKERS):
+        return False
+    if _CONCRETE_DEADLINE.search(value):
+        return False
+    return any(marker in folded for marker in _GENERIC_FOLLOWUP_MARKERS) or bool(
+        _TRANSPORT_DETAIL.search(value)
+    )
+
+
 def _reject_constant(value: str) -> None:
     raise ModelOutputError("non-finite JSON number is not allowed", validation_reason="invalid_json")
 
@@ -1022,6 +1111,9 @@ def validate_summarize_output(
     }
     _require_keys(value, {"title", "body", "tags", "type", "scopes", "sources"}, allowed)
     item = dict(value)
+    for field in ("title", "body"):
+        if isinstance(item.get(field), str):
+            item[field] = _strip_empty_iso_date_parenthesis(item[field])
     _string(item["title"], "title")
     _string(item["body"], "body", multiline=True)
     _reject_relative_calendar_expression(item)
@@ -1281,6 +1373,8 @@ __all__ = [
     "parse_gate_output",
     "parse_compact_output",
     "parse_strict_json",
+    "is_aggregate_operational_text",
+    "is_attachment_followup_only_text",
     "normalize_relative_calendar_text",
     "parse_summarize_output",
     "parse_summary_output",

{memleaf-0.2.11 → memleaf-0.2.13/src/memleaf.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memleaf
-Version: 0.2.11
+Version: 0.2.13
 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.11。**
-> 核心库、Vault、stdio MCP Server、初始化 CLI、模型路由、提炼流程、受控检索协议和宿主适配器已经实现。memleaf 0.2.11 通过 PyPI 分发。
+> **当前版本：0.2.13。**
+> 核心库、Vault、stdio MCP Server、初始化 CLI、模型路由、提炼流程、受控检索协议和宿主适配器已经实现。memleaf 0.2.13 通过 PyPI 分发。
 > **当前版本支持 Hermes 和 Codex。** Antigravity（反重力）不检测、不安装、不配置。
 
 ## 项目定位