memleaf 0.2.42__tar.gz → 0.2.43__tar.gz

{memleaf-0.2.42 → memleaf-0.2.43}/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to memleaf are documented here.
 
+## 0.2.43 — 2026-09-12
+
+- Keep regression tests, live-acceptance helpers, and implementation/release plans in local checkouts rather than the Git tree or source distribution.
+- Narrow hosted CI to package build and installed-command smoke checks while retaining the existing release metadata checks and GitHub/PyPI publication workflow.
+
 ## 0.2.42 — 2026-09-12
 
 - Rework ordinary automatic extraction around the unified `b3-single-pass-v1` planner. The current visible user/assistant turn is the only new-fact evidence; existing local/native memories remain comparison context. One structured model stage decides CREATE / UPDATE / NO_CHANGE / DEFERRED, with deterministic Core validation and at most one bounded format/structure repair.

{memleaf-0.2.42 → memleaf-0.2.43}/MANIFEST.in

@@ -4,9 +4,8 @@ include install.sh
 include install.ps1
 include README.md
 include README.en.md
-include RELEASE_CHECKLIST.md
-include IMPLEMENTATION_PLAN.md
-recursive-include tests *.py
 recursive-include examples *.md *.ndjson *.py
+recursive-exclude examples *_acceptance.py
+prune tests
 
 include docs/*.md

{memleaf-0.2.42 → memleaf-0.2.43}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memleaf
-Version: 0.2.42
+Version: 0.2.43
 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.42。**
+> **版本：0.2.43。**
 > 记忆只从用户与 Agent 的可见对话提炼。Agent 已在回复中整理的事实、项目进展和明确待办可作为来源；邮件、附件、网页和终端等工具原文不进入记忆提炼。模型负责保留原话中的不确定性，现有记忆仅用于比较、去重和更新。Markdown 仍是唯一事实源。
 > **当前版本支持 Hermes 和 Codex。** Antigravity（反重力）不检测、不安装、不配置。
 
@@ -451,17 +451,9 @@ history:
 - 选择 API/云端模型后，模型处理输入会离开本机并发送给该提供方；
 - `context()` 或无宿主绑定的客户端只能获得单页边界，不能宣称具备跨轮硬预算。
 
-## 开发与验证
+## 开发与构建
 
-要求 Python 3.11+。本地运行测试：
-
-```bash
-PYTHONPATH=src python3.11 -m unittest discover -s tests -p 'test_*.py' -v
-python3.11 -m compileall -q src tests examples
-git diff --check
-```
-
-GitHub Actions 覆盖 Linux 与 Windows 的 Python 3.11、3.12、3.13 测试，并验证 wheel/source distribution 构建、源码包测试和 Windows PowerShell 安装器语法。构建发行包需要 `build`：
+要求 Python 3.11+。GitHub Actions 在 Python 3.12 上构建 wheel 和 source distribution，并对安装后的包、命令入口和版本信息做冒烟检查。构建发行包需要 `build`：
 
 ```bash
 python -m pip install build

{memleaf-0.2.42 → memleaf-0.2.43}/README.en.md

@@ -4,7 +4,7 @@
 
 [中文](README.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **Version: 0.2.42.**
+> **Version: 0.2.43.**
 > 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.
 
@@ -434,17 +434,9 @@ Directories are normally created with mode `0700`, and files are stored as plain
 - If an API or cloud model is selected, model-processing input leaves the machine and is sent to that provider.
 - `context()` and clients without a host-bound retrieval turn only have per-page limits; they cannot claim cross-turn hard budgets.
 
-## Development and verification
+## Development and builds
 
-Python 3.11+ is required. Run locally:
-
-```bash
-PYTHONPATH=src python3.11 -m unittest discover -s tests -p 'test_*.py' -v
-python3.11 -m compileall -q src tests examples
-git diff --check
-```
-
-GitHub Actions covers Python 3.11, 3.12, and 3.13 on Linux and Windows, plus wheel/source-distribution builds, source-archive tests, and PowerShell installer syntax validation. Build packages with:
+Python 3.11+ is required. GitHub Actions builds the wheel and source distribution on Python 3.12, then smoke-checks the installed package, CLI entry points, and version commands. Build packages with:
 
 ```bash
 python -m pip install build

{memleaf-0.2.42 → memleaf-0.2.43}/README.md

@@ -4,7 +4,7 @@
 
 [English](README.en.md) · [PyPI](https://pypi.org/project/memleaf/) · [GitHub](https://github.com/miffyblueboo/memleaf)
 
-> **版本：0.2.42。**
+> **版本：0.2.43。**
 > 记忆只从用户与 Agent 的可见对话提炼。Agent 已在回复中整理的事实、项目进展和明确待办可作为来源；邮件、附件、网页和终端等工具原文不进入记忆提炼。模型负责保留原话中的不确定性，现有记忆仅用于比较、去重和更新。Markdown 仍是唯一事实源。
 > **当前版本支持 Hermes 和 Codex。** Antigravity（反重力）不检测、不安装、不配置。
 
@@ -432,17 +432,9 @@ history:
 - 选择 API/云端模型后，模型处理输入会离开本机并发送给该提供方；
 - `context()` 或无宿主绑定的客户端只能获得单页边界，不能宣称具备跨轮硬预算。
 
-## 开发与验证
+## 开发与构建
 
-要求 Python 3.11+。本地运行测试：
-
-```bash
-PYTHONPATH=src python3.11 -m unittest discover -s tests -p 'test_*.py' -v
-python3.11 -m compileall -q src tests examples
-git diff --check
-```
-
-GitHub Actions 覆盖 Linux 与 Windows 的 Python 3.11、3.12、3.13 测试，并验证 wheel/source distribution 构建、源码包测试和 Windows PowerShell 安装器语法。构建发行包需要 `build`：
+要求 Python 3.11+。GitHub Actions 在 Python 3.12 上构建 wheel 和 source distribution，并对安装后的包、命令入口和版本信息做冒烟检查。构建发行包需要 `build`：
 
 ```bash
 python -m pip install build

{memleaf-0.2.42 → memleaf-0.2.43}/docs/general-processing.md

@@ -122,11 +122,15 @@ the preview. There is deliberately no apply-preview command.
 
 ## Verification boundaries
 
+The regression suite and acceptance helpers referenced here are maintained
+locally and are not included in this repository or its source distribution.
+Remote CI validates package construction and installed command entry points only.
+
 Deterministic backends test schema and filesystem behavior, not hosted-model
-accuracy. tests/semantic_fixtures.py adapts prescribed old Gate judgments to the
-quote protocol for update/history/maintenance tests. It does not run in product
-code and is not proof those judgments are semantically sound. New adversarial
-protocol tests choose their quotations explicitly. No model score or absolute
+accuracy. The local-only `tests/semantic_fixtures.py` adapts prescribed old Gate
+judgments to the quote protocol for update/history/maintenance tests. It does
+not run in product code and is not proof those judgments are semantically sound.
+New adversarial protocol tests choose their quotations explicitly. No model score or absolute
 "all languages/all scenarios" accuracy claim is made.
 
 Before release, separately inspect live Model Route behavior on held-out real
@@ -142,20 +146,23 @@ that acceptance.
 Windows processing-owner liveness is queried through a process handle with
 SYNCHRONIZE access, never by sending a signal. Shared-Vault writes use a
 native byte-range lock between processes, not only a Python thread mutex.
-Native child-process tests run on Linux, macOS and Windows.
-
-The full Python suite runs on all three OS families. Only the `install.sh`
-shell-harness class is POSIX-only; Windows retains installation, upgrade,
-PowerShell syntax, host lifecycle and native Codex acceptance. Test launchers
-use native `.cmd` wrappers on Windows. Byte-preservation assertions compare
-actual before/after bytes, including CRLF. POSIX mode-bit checks are conditional:
-Windows file privacy follows the Vault directory's inherited ACLs, and Unix
-`0600` must not be interpreted as proof of a Windows owner-only DACL.
-
-Real-model acceptance requires an explicit model route in repository Actions:
-secret `MEMLEAF_LIVE_MODEL_TOKEN` and variables `MEMLEAF_LIVE_BASE_URL` and
-`MEMLEAF_LIVE_MODEL`. Missing configuration is a blocked acceptance result,
-not a passing semantic test. Never publish based only on deterministic mocks.
+The local-only Python suite is intended to run on all three OS families; remote
+CI does not exercise it. Native child-process tests cover Linux, macOS and
+Windows when run locally.
+
+Only the `install.sh` shell-harness class is POSIX-only; local Windows checks
+cover installation, upgrade, PowerShell syntax, host lifecycle and native Codex
+acceptance. Test launchers use native `.cmd` wrappers on Windows.
+Byte-preservation assertions compare actual before/after bytes, including CRLF.
+POSIX mode-bit checks are conditional: Windows file privacy follows the Vault
+directory's inherited ACLs, and Unix `0600` must not be interpreted as proof of a
+Windows owner-only DACL.
+
+Real-model acceptance requires an explicitly configured model route using
+`MEMLEAF_LIVE_MODEL_TOKEN`, `MEMLEAF_LIVE_BASE_URL`, and `MEMLEAF_LIVE_MODEL`.
+Live acceptance tooling is maintained locally and is not run by remote CI.
+Missing configuration is a blocked acceptance result, not a passing semantic
+test. Never publish based only on deterministic mocks.
 
 ## Capture policy
 

{memleaf-0.2.42 → memleaf-0.2.43}/docs/processing-quality-acceptance.md

@@ -2,6 +2,11 @@
 
 This document defines acceptance for automatic memory extraction without treating one validation layer as proof of another.
 
+The deterministic suite and acceptance helpers described below are maintained
+locally and are not committed or shipped. Remote CI currently validates package
+construction and installed command entry points only; the layers below are not
+automatically exercised by that workflow.
+
 ## Invariants
 
 - Markdown under `knowledge/` remains the active-memory source of truth; `history/` remains historical state.
@@ -45,9 +50,12 @@ Required checks include:
 
 Passing this layer proves only the deterministic contracts under test.
 
-### 2. Cross-platform CI and MCP/background-runtime verification
+### 2. Cross-platform local regression and MCP/background-runtime verification
 
-Run the repository's supported OS matrix and the process-job/MCP tests. Verify that detached worker status exposes the bounded metrics, reruns aggregate metrics safely, and no model call is made while the Vault write lock is held.
+Run the maintained local-only test suite on supported OSes and the
+process-job/MCP tests. Verify that detached worker status exposes the bounded
+metrics, reruns aggregate metrics safely, and no model call is made while the
+Vault write lock is held.
 
 Passing this layer proves the tested runtime paths and platforms. It does not prove that a real model will always extract every business fact.
 

memleaf-0.2.43/examples/README.md

@@ -0,0 +1,19 @@
+# Examples
+
+`basic_usage.py` runs entirely offline. Without `--vault` it creates a
+temporary vault; pass a directory explicitly when you want to inspect the
+generated Markdown after the process exits.
+
+The example shows a lightweight `context()` directory followed by an explicit
+`read_page()` call for the selected entry. Directory results contain no body;
+long bodies can be read in subsequent pages using `next_offset` and `version`.
+
+The `mcp_stdio.ndjson` file contains one legacy initialization request and one
+modern discovery request. Pipe it to the stdio adapter with an explicit vault:
+
+```sh
+python -m memleaf.mcp_server --vault <your-vault> < examples/mcp_stdio.ndjson
+```
+
+The NDJSON file is request-only and intentionally contains no tool call,
+network endpoint, local path, or secret.

{memleaf-0.2.42 → memleaf-0.2.43}/pyproject.toml

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

{memleaf-0.2.42 → memleaf-0.2.43}/src/memleaf/__init__.py

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

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

{memleaf-0.2.42 → memleaf-0.2.43}/src/memleaf.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memleaf
-Version: 0.2.42
+Version: 0.2.43
 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.42。**
+> **版本：0.2.43。**
 > 记忆只从用户与 Agent 的可见对话提炼。Agent 已在回复中整理的事实、项目进展和明确待办可作为来源；邮件、附件、网页和终端等工具原文不进入记忆提炼。模型负责保留原话中的不确定性，现有记忆仅用于比较、去重和更新。Markdown 仍是唯一事实源。
 > **当前版本支持 Hermes 和 Codex。** Antigravity（反重力）不检测、不安装、不配置。
 
@@ -451,17 +451,9 @@ history:
 - 选择 API/云端模型后，模型处理输入会离开本机并发送给该提供方；
 - `context()` 或无宿主绑定的客户端只能获得单页边界，不能宣称具备跨轮硬预算。
 
-## 开发与验证
+## 开发与构建
 
-要求 Python 3.11+。本地运行测试：
-
-```bash
-PYTHONPATH=src python3.11 -m unittest discover -s tests -p 'test_*.py' -v
-python3.11 -m compileall -q src tests examples
-git diff --check
-```
-
-GitHub Actions 覆盖 Linux 与 Windows 的 Python 3.11、3.12、3.13 测试，并验证 wheel/source distribution 构建、源码包测试和 Windows PowerShell 安装器语法。构建发行包需要 `build`：
+要求 Python 3.11+。GitHub Actions 在 Python 3.12 上构建 wheel 和 source distribution，并对安装后的包、命令入口和版本信息做冒烟检查。构建发行包需要 `build`：
 
 ```bash
 python -m pip install build

memleaf-0.2.43/src/memleaf.egg-info/SOURCES.txt

@@ -0,0 +1,109 @@
+CHANGELOG.md
+LICENSE
+MANIFEST.in
+README.en.md
+README.md
+install.ps1
+install.sh
+pyproject.toml
+docs/capture-budget-design.md
+docs/config-migrations.md
+docs/core-refactor.md
+docs/evidence-retention.md
+docs/gate-evidence-boundary.md
+docs/general-processing.md
+docs/hermes-mcp-runtime.md
+docs/processing-quality-acceptance.md
+docs/v0.2.26-processing-status.md
+examples/README.md
+examples/basic_usage.py
+examples/mcp_stdio.ndjson
+src/memleaf/__init__.py
+src/memleaf/__main__.py
+src/memleaf/admission.py
+src/memleaf/batch_review.py
+src/memleaf/budget.py
+src/memleaf/capture.py
+src/memleaf/cli.py
+src/memleaf/compaction.py
+src/memleaf/config.py
+src/memleaf/create_coordinator.py
+src/memleaf/credentials.py
+src/memleaf/evidence_budget.py
+src/memleaf/evidence_policy.py
+src/memleaf/evidence_structure.py
+src/memleaf/evidence_syntax.py
+src/memleaf/extraction_budget.py
+src/memleaf/extraction_capability.py
+src/memleaf/extraction_work_state.py
+src/memleaf/frontmatter.py
+src/memleaf/hermes_runtime.py
+src/memleaf/host_events.py
+src/memleaf/host_runtime.py
+src/memleaf/inbox.py
+src/memleaf/index.py
+src/memleaf/inspection.py
+src/memleaf/installer.py
+src/memleaf/locking.py
+src/memleaf/mcp_server.py
+src/memleaf/memory_commit.py
+src/memleaf/memory_planner.py
+src/memleaf/memory_writer.py
+src/memleaf/model_discovery.py
+src/memleaf/model_execution.py
+src/memleaf/models.py
+src/memleaf/native_index.py
+src/memleaf/native_registration.py
+src/memleaf/parallel_model.py
+src/memleaf/planning_context.py
+src/memleaf/process_common.py
+src/memleaf/process_jobs.py
+src/memleaf/process_journal.py
+src/memleaf/process_owner.py
+src/memleaf/processing.py
+src/memleaf/prompts.py
+src/memleaf/provenance.py
+src/memleaf/recording_policy.py
+src/memleaf/redaction.py
+src/memleaf/retention.py
+src/memleaf/retrieval.py
+src/memleaf/retrieval_gate.py
+src/memleaf/scope_maintenance.py
+src/memleaf/scope_state.py
+src/memleaf/service.py
+src/memleaf/single_pass_memory_planner.py
+src/memleaf/single_pass_plan.py
+src/memleaf/source_policy.py
+src/memleaf/state_layout.py
+src/memleaf/summary_batch.py
+src/memleaf/target_reconciliation.py
+src/memleaf/turn_audit.py
+src/memleaf/turn_plan.py
+src/memleaf/update_coordinator.py
+src/memleaf/update_review.py
+src/memleaf/validation.py
+src/memleaf/vault.py
+src/memleaf.egg-info/PKG-INFO
+src/memleaf.egg-info/SOURCES.txt
+src/memleaf.egg-info/dependency_links.txt
+src/memleaf.egg-info/entry_points.txt
+src/memleaf.egg-info/top_level.txt
+src/memleaf/adapters/__init__.py
+src/memleaf/adapters/antigravity.py
+src/memleaf/adapters/base.py
+src/memleaf/adapters/codex.py
+src/memleaf/adapters/hermes.py
+src/memleaf/hermes_provider/README.md
+src/memleaf/hermes_provider/__init__.py
+src/memleaf/hermes_provider/_mcp_client.py
+src/memleaf/hermes_provider/_provider.py
+src/memleaf/hermes_provider/_shared.py
+src/memleaf/hermes_provider/evidence_budget.py
+src/memleaf/hermes_provider/plugin.yaml
+src/memleaf/llm/__init__.py
+src/memleaf/llm/base.py
+src/memleaf/llm/claude_compatible.py
+src/memleaf/llm/gemini.py
+src/memleaf/llm/openai_compatible.py
+src/memleaf/llm/router.py
+src/memleaf/llm/thinking.py

memleaf-0.2.42/IMPLEMENTATION_PLAN.md

@@ -1,143 +0,0 @@
-# memleaf v0.1 实施计划
-
-基线：历史 v74 设计。`README.md` 与 `README.en.md` 作为对外行为契约；实现不得把 README 中尚未完成的目标描述成已发布能力。
-
-发布范围更新（2026-08-28）：v0.1 仅 Hermes。下文 Codex/反重力适配记录仅为历史，不属于本版安装或验收范围。
-
-2026-08-28 已批准的新检索与维护方案见 [v2 实施计划](V2_IMPLEMENTATION_PLAN.md)。其 Scope-only 注入、每轮 search、按需 read 和候选级维护规则取代下文旧的 3 项目录自动注入方案；旧条目保留为历史验收记录，不代表运行目录已部署新版。
-
-## 实施原则
-
-- Python 3.11+，核心运行时仅使用标准库。
-- `knowledge/` Markdown 是真实数据源；JSON 索引必须可重建。
-- MCP 为薄适配层，业务逻辑只存在于 core。
-- 所有写入采用同目录临时文件、`fsync`、原子替换；并发写通过 vault 锁串行化。
-- 处理成功前不推进轮次水位，不清理 inbox；模型失败必须可重试。
-- `memleaf init` 是一次性安装/配置入口，不引入常驻进程。
-- 保持 v74 计划文档骨架，仅在实现事实发生变化时做最小补充；README 同样只做必要更新。
-- 用户决策（2026-08-25）：推荐源码和运行根固定为 `$HOME/memleaf`，不增加 `work` 层；从其他物理目录运行 `install.sh` 必须安全失败，只有显式设置 `MEMLEAF_INSTALL_ROOT` 才允许隔离测试/开发。
-- 用户决策（2026-08-25）：只有可靠检测到 `hermes` 可执行文件时，才安装并激活官方外部 `MemoryProvider`；未检测到时不创建 Hermes provider 插件或配置，只输出诊断。
-- 用户决策（2026-08-28）：v0.1 命令安装和 `memleaf init` 仅接入 Hermes；Codex、Antigravity 保留兼容代码但不检测、不配置、不扫描模型，`--all` 也不得绕过该边界。
-- 已审核方案（2026-08-27）：自动 `context` 只返回记忆目录（ID、短标题、项目），最多 3 项，整个自动注入不超过 600 字符；不返回正文、来源或正文摘录。MCP `search` 默认返回目录，显式完整查询保留兼容；模型按需 `read`，长正文分段读取。目录曝光不计命中，正文实际读取才计命中；不改变 process 候选提炼、scope、状态更新/history 或 Markdown 存储语义。
-- 用户决策（2026-08-25）：当前只做本地完整测试，不提交、不推送、不发布 Git/PyPI。
-
-## 阶段 A：本地核心纵切
-
-交付：可安装包、vault 初始化、受限 YAML/frontmatter、事件捕获与脱敏、Markdown 记忆 CRUD、索引重建、标签/全文/作用域检索、forget、统计。
-
-建议模块：
-
-```text
-src/memleaf/
-├── __init__.py
-├── config.py
-├── models.py
-├── vault.py
-├── frontmatter.py
-├── redaction.py
-├── locking.py
-├── capture.py
-├── index.py
-├── retrieval.py
-└── service.py
-```
-
-验收：
-
-- 相同 `event_id` 重复 capture 不产生重复事件；同 session 恢复后可追加新轮次。
-- 用户预先声明“不记录”的文本不进入 inbox；常见密钥、Cookie、私钥等在落盘前被脱敏。
-- 标签多命中采用并集，随后按 scope 继承/覆盖过滤；标签无命中时才全文回退。
-- `include_history=false` 不读取历史区；todo 默认仅返回 active。
-- `forget_memory` 精确目标直接删除且不进 history；`forget_about` 含糊时只返回候选，不误删。
-- 手工修改/删除 Markdown 后，`rebuild_index()` 只反映当前文件系统状态。
-- 并发 capture 不丢事件，损坏索引可重建。
-
-## 阶段 B：记忆处理与模型路由
-
-交付：候选提取、逐条 gate、summarize、remember、当前状态更新、history、处理水位、24 小时清理、压缩、Model Router。
-
-建议模块：
-
-```text
-src/memleaf/
-├── prompts.py
-├── processing.py
-├── memory_writer.py
-├── compaction.py
-└── llm/
-    ├── base.py
-    ├── router.py
-    ├── openai_compatible.py
-    ├── claude_compatible.py
-    └── gemini.py
-```
-
-验收：
-
-- 一个完整轮次可生成 0～N 条原子记忆；assistant 未经用户确认的建议不能写成事实。
-- 显式 remember 跳过 worth gate，但仍执行整理、查重和 scope 归属。
-- 同一事实重复处理不重复写；状态变化时旧版本进入 history，新版本成为唯一活跃状态。
-- 任一模型调用、解析、knowledge 写入或索引更新失败时不推进水位、不删除 inbox。
-- 成功轮次经过 24 小时安全期后，仅在下一次自然触发时清理。
-- 达到阈值时只选低优先级约 30% 为候选；原始记忆移入 history，不做机械删除。
-- `api` 模式覆盖 OpenAI-compatible、Claude-compatible、Gemini；新安装按用户决策将密钥直接写入权限为 `0600` 的本地配置，旧 `api_key_env` 仅兼容读取。
-- `host` 使用显式注入的宿主回调；stdio MCP 无宿主回调时返回可诊断的不可用状态，`auto` 仅在已配置 API 时回退，禁止静默选择未知远程模型。
-
-## 阶段 C：MCP、初始化与宿主适配
-
-交付：按需 stdio MCP、一次性 init CLI、Codex/Hermes 探测与配置适配器、兼容保留的 Antigravity 适配器、示例、CI 与打包。
-
-建议模块：
-
-```text
-src/memleaf/
-├── mcp_server.py
-├── cli.py
-└── adapters/
-    ├── base.py
-    ├── codex.py
-    ├── hermes.py
-    └── antigravity.py
-```
-
-MCP tools：`capture`、`context`、`search`、`read`、`process`、`remember`、`forget_memory`、`forget_about`、`rebuild_index`、`stats`。
-
-验收：
-
-- `python -m memleaf.mcp_server` 可通过 stdio 完成 initialize、tools/list、tools/call；stdout 只输出协议消息，日志写 stderr/文件。
-- 每个 MCP tool 只是 core API 的参数校验和结果封装，不复制业务规则。
-- `memleaf init --all --defaults` 可重复执行且不重复写配置。
-- Codex 适配遵循官方当前配置：本地 STDIO server 通过命令启动，配置位于用户级或受信任项目级 `config.toml`；自动修改外部配置前先备份并采用原子写入。
-- Codex/Hermes 只在真机探测结果可靠时自动配置；Antigravity 在 v0.1 不检测、不配置（包括 `--all`），仅保留兼容适配器代码。
-- 构建 wheel/sdist、全量单元测试、MCP 端到端 smoke test 均通过。
-
-## 待办与问题记录：Hermes 重连后自动捕获与提炼中断
-
-- 状态：Hermes 已验证连续多轮自动 capture→process→knowledge 写入；30 秒模型请求超时、gate/summarize 契约与白名单校验诊断、DeepSeek 结构抽取与空内容有限重试自动化修复完成。下一次真实 cron 禁用验收与干净 HOME 安装验收仍待执行；历史缺失轮次不会自动回填。
-- 真实验收曾覆盖首轮 gate+summarize 成功写入，以及后续模型空内容时保留 inbox 和处理水位；当前 `diagnostic_logging=false` 且不会默认创建诊断文件。
-- 现象：`auto_process=true`，首段对话捕获了 5 个完整轮次（10 个事件），但 Hermes 在 14:39、14:41、14:43 完成的后续轮次没有继续写入 inbox；`knowledge/` 和 `history/` 均未生成记忆。
-- 证据：目标 inbox 文件最后更新于 14:30:13；`_index/processed.json` 仍停留在第 1 轮 `processing`，没有成功处理水位；Hermes 日志记录 14:19:59 的 `auto-process failed`。Hermes 自身模型请求均成功，MCP `stats` 入口可用。
-- 初步根因：Hermes provider 的 MCP 超时配置为 5 秒，首轮处理在超时后留下未清理的 processing 标记；随后 UI/provider 重连后的完整可见轮次未恢复自动捕获/处理。当前 provider 对底层 MCP 异常只记录摘要，无法直接区分超时与重连生命周期故障。
-- [x] 修复 MCP 调用超时、失败重试和 processing 标记恢复，确保模型处理较慢时 inbox 与水位仍可安全重试。短请求默认仍为 5 秒，`process` 独立使用默认 300 秒（上限 900 秒）；超时会关闭坏 MCP 子进程，下一次调用重建连接；processing marker 写入 `owner_pid`，死亡 owner 立即恢复，旧 marker 仅保留 10 分钟兼容窗口。
-- [x] 确保 Hermes UI/provider 重连或恢复同一 session 后，每个完整可见轮次仍会捕获并触发自动提炼。`on_turn_start` 的 turn number 与 user+assistant 可见文本短哈希共同组成 turn_id；provider 仅保留有界 user 指纹队列，重复完整轮次复用相同 ID 幂等；`on_session_switch` 只在 reset/rewound 时清理旧会话状态。
-- [x] 增加可诊断日志，记录 capture/process 的阶段、耗时和错误类型，但不得记录对话正文或密钥。覆盖 initialize/stats/capture_user/capture_assistant/process/context，并区分 TimeoutError、MCP tool error 与子进程退出。
-- [x] 修复自动提炼模型调用的内部 HTTP 30 秒超时与不安全错误透传：`llm.request_timeout` 默认 120 秒、范围 1～240 秒；失败按安全 code/stage 透传到 MCP、日志和 processing marker，失败后保留 inbox、不推进水位并可重试。
-- [x] 修复 DeepSeek/OpenAI JSON mode 与 gate/summarize 契约：受支持 provider 使用 JSON mode 和固定 `max_tokens`；DeepSeek gate/summarize 关闭 thinking 以避免结构抽取被推理预算占用，严格契约失败最多重试一次，空内容额外允许第 3 次；最终失败仅透传白名单 `validation_reason`、`attempt_count`，不记录模型原始输出。
-- [x] 对齐 gate/summarize 的类型、scope、todo、证据 event_key 与 reason 约束；失败增加白名单 `validation_detail`，并支持默认关闭、开启后有界 `logs/model-diagnostics.jsonl` 的结构统计诊断，不记录 prompt、正文、字段值、密钥、URL 或异常文本。
-- [x] 按 Hermes lifecycle 同时识别 `platform` 与 `agent_context`：`platform=cron` 以及 `agent_context=cron/flush/subagent` 不召回、不捕获、不执行 process；正常 primary 交互会话保持原行为。
-- [x] 保留已有 Hermes cron 历史数据；上述边界只阻断后续非用户会话污染，不删除或回填既有记录。
-- [x] 连续多轮 Hermes 交互自动 capture→process→knowledge 已由隔离真机会话验证。
-- [ ] 在干净 HOME 完成安装验收，确认上述自动链路无需手工调用 `process`/`remember`。
-- [ ] 用下一次真实 Hermes cron 运行验证其不再触发 context、capture 或 process，且不影响正常交互会话。
-
-阶段自动化曾覆盖完整 unittest、compileall 与 diff 检查，包括慢 process 超时边界、结构化输出重试、模型错误分类、重连、进程恢复、白名单诊断、敏感日志和宿主 Hook 状态。最终发布结论以当前 CI 和发布审计为准。
-
-## 本任务状态：Codex 自动宿主 Hook；Antigravity 兼容代码暂不启用
-
-- [x] 保持 v74 Core API、MCP 与 vault 数据骨架不变；新增共用 host-event 入口，复用 capture/context/process。
-- [x] 可靠检测到 Codex 时由 `init` 默认配置 Hook；配置合并可重复、先备份、原子写入，命令使用安装解释器绝对路径。Hermes 使用其原生 provider/MCP 接入。
-- [x] 保留 Codex/Antigravity 可见内容 host-event 兼容代码；v0.1 `init`/安装不检测、不配置 Antigravity，过滤与幂等逻辑不改变 Core/MCP 骨架。
-- [x] 正常 Stop 同步 process；失败保留 inbox 与待处理状态，Hook 错误不阻塞宿主结束。
-- [x] 使用脱敏合成 fixture 完成定向与全量单元测试；Codex 真机已验证可见捕获、process 与 context 调用链。安装后 Codex 状态先为 `pending_user_review`，用户需打开 `/hooks` 审核；首个合法成功 Hook 后记录 `active`/`trusted`。
-- [x] Antigravity 适配器及其官方 Hook 解析代码继续保留作兼容性测试，但 v0.1 安装不会写入 Antigravity MCP/Hook 配置，也不会声称其已接入。
-- [ ] Codex 非空跨宿主记忆召回专项验收；Antigravity 接入与真实宿主 E2E 延后到后续版本。

memleaf-0.2.42/RELEASE_CHECKLIST.md

@@ -1,97 +0,0 @@
-# 发布检查清单
-
-本文件是 memleaf 的长期发布 SOP，不记录某个具体版本的发布说明。
-
-版本历史统一维护在 `CHANGELOG.md`；GitHub Release 从对应版本的 CHANGELOG
-段落生成。不要再新增 `RELEASE_NOTES_*.md` 文件。
-
-## 1. 版本准备
-
-- [ ] 明确本次版本号与变更范围。
-- [ ] 更新 `pyproject.toml` 的项目版本。
-- [ ] 更新 `src/memleaf/__init__.py` 的 `__version__`。
-- [ ] 更新唯一 Hermes Provider manifest 的版本：
-  `src/memleaf/hermes_provider/plugin.yaml`
-- [ ] 更新所有依赖具体版本号的测试。
-- [ ] 在 `CHANGELOG.md` 顶部新增本版本段落。
-- [ ] 同步 `README.md` 与 `README.en.md` 的当前版本信息。
-- [ ] 不新增单独的版本发布说明 Markdown 文件。
-
-## 2. 自动化验证
-
-- [ ] Linux Python 3.11 / 3.12 / 3.13 完整 unittest 通过。
-- [ ] Windows Python 3.11 / 3.12 / 3.13 安装与集成验收通过。
-- [ ] macOS Python 3.11 / 3.13 Hermes/Codex 宿主与记忆语义验收通过。
-- [ ] Windows 真实 Provider → `memleaf-mcp` stdio 回归通过：
-  `stats`、`scope_catalog`、user/assistant capture、inbox 落盘。
-- [ ] Windows 与 macOS 使用当前受支持 Codex CLI 做真实 `codex mcp add/get` 验收，
-  Unicode/空格路径正常，重复安装为 `already_configured` 且 `changed=false`。
-- [ ] Codex `PreToolUse` 参数重写符合当前 Hook 合同：
-  `permissionDecision=allow` 与 `updatedInput` 同时存在，当前轮 `retrieval_id` 不丢失。
-- [ ] Windows `commandWindows` 不含会触发 Codex 当前 cmd 外层引号缺陷的内嵌双引号；
-  Python/Vault 含空格和中文时，quote-free 命令在原生 `cmd.exe` 执行回归通过。
-- [ ] Codex → Codex、Hermes → Codex、Codex → Hermes 三条共享 Vault 持久记忆闭环全部通过。
-- [ ] Scope Map 仍只注入 Scope/alias/检索协议；`search` 候选严格只返回
-  `memory_id + title`，`read` 才读取选中正文，检索预算与 retrieval gate 保持。
-- [ ] CREATE / UPDATE / NO_CHANGE、history、去重、process 继续由 Core 统一实现，
-  Codex/Hermes Adapter 不复制记忆语义。
-- [ ] wheel 与 sdist 构建通过。
-- [ ] 从 wheel 安装后 `memleaf` / `memleaf-mcp` 入口正常。
-- [ ] 从 sdist 解包后的测试通过。
-- [ ] PowerShell 安装器语法验证通过。
-- [ ] `git diff --check` / compileall 等静态检查无异常。
-
-## 3. Hermes 真实环境重点
-
-- [ ] Hermes 实际 Python 环境加载的是目标 memleaf 版本。
-- [ ] Hermes `plugins/memleaf` Provider 副本也是目标版本。
-- [ ] MemoryProvider 可正常加载；`registered (0 tools)` 属于预期。
-- [ ] 独立 memleaf MCP 注册 11 个工具。
-- [ ] `stats` / `scope_catalog` 无 OSError、WinError 10093、TimeoutError。
-- [ ] 可见轮次能 capture 到 inbox。
-- [ ] process 能将有长期价值的内容提炼到 knowledge。
-- [ ] UPDATE 能复用 active memory ID，并将旧版归档到 history。
-- [ ] 新 Hermes 会话能召回旧会话中的已保存信息。
-
-## 4. 安全与兼容
-
-- [ ] Hermes 脱敏 credential（如 `***`、头尾掩码）不会被当成真实 API key。
-- [ ] 日志与状态输出不泄露真实 API key。
-- [ ] Windows 路径仍支持 `%LOCALAPPDATA%\hermes` 及官方 launcher 布局。
-- [ ] 从旧版本升级时保留已有 Hermes `memleaf.json` 中的自定义 Vault，不静默切换到默认 Vault。
-- [ ] Provider 的 Windows stdio 实现不重新引入 `select.select(pipe)`。
-- [ ] 普通升级/`memleaf install` 不自动配置 Codex；只有显式
-  `memleaf install --host codex` 才修改 Codex memleaf 接入。
-- [ ] Codex 安装前后的 model/model_provider/base_url、sandbox、approval、
-  profiles、已有 MCP 与已有 Hooks 保持；DeepSeek/OpenRouter/自定义 provider 不被改写。
-- [ ] Hermes/Codex 已有 Vault 唯一一致时复用；冲突时 `vault_conflict` fail closed。
-- [ ] Codex 自动提炼只使用独立 memleaf Model Route；没有 Route 时明确返回
-  `processing_status=model_route_required`，不复制 Codex credential、不隐式消耗 Codex 会话模型。
-- [ ] shell、Python 与 PowerShell 安装路径都使用
-  `src/memleaf/hermes_provider` 这一份权威 Provider 源码。
-
-## 5. 正式发布
-
-正式 release commit 的 subject 必须严格为：
-
-```text
-release: vX.Y.Z
-```
-
-然后：
-
-- [ ] push 到 `main`。
-- [ ] CI 全部通过。
-- [ ] CI 从 `pyproject.toml` 读取版本，并确认 commit subject 与版本一致。
-- [ ] CI 从 `CHANGELOG.md` 提取本版本段落创建 GitHub Release。
-- [ ] GitHub Release tag、标题、wheel、sdist、SHA256SUMS 均对应目标版本。
-- [ ] `Publish to PyPI` workflow 使用 Trusted Publishing / OIDC 成功。
-- [ ] PyPI 页面显示目标版本。
-- [ ] 安装命令实际可升级到目标版本。
-
-## 6. 发布后
-
-- [ ] 检查 GitHub Release 显示标题、tag 与正文版本一致。
-- [ ] 检查 PyPI 与 GitHub Release 的版本一致。
-- [ ] 如有真实宿主验收结果，更新 `MAINTAINER_HANDOFF.md` 中的维护证据或注意事项。
-- [ ] 不修改或覆盖已发布的 PyPI 版本；有修复时递增新版本。