Release v6.2.5 Claude memory de-duplication

Author: SeemSeam

CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## v6.2.5 (2026-05-19)
+
+### Claude Managed Memory De-Duplication Hotfix
+
+- **Claude Project Memory De-Duplicated**: managed `.claude/CLAUDE.md` bundles no longer copy the project-level `CLAUDE.md`, allowing Claude to load it natively from the working directory.
+- **Managed Memory Sources Preserved**: provider user memory from real `~/.claude/CLAUDE.md`, `.ccb/ccb_memory.md`, and per-agent `.ccb/agents/<agent>/memory.md` still project into the managed Claude home.
+- **Project Memory Loader Flag Added**: `load_memory_sources(..., include_provider_native_project=False)` can now skip provider-native project memory while the default behavior still includes it for existing callers.
+
 ## v6.2.4 (2026-05-18)
 
 ### Codex Managed Config TOML Hotfix

README.md

@@ -7,7 +7,7 @@
   <img src="https://img.shields.io/badge/Every_Model_Controllable-CF1322?style=for-the-badge" alt="Every Model Controllable">
 </p>
 
-[![Version](https://img.shields.io/badge/version-6.2.4-orange.svg)]()
+[![Version](https://img.shields.io/badge/version-6.2.5-orange.svg)]()
 [![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)]()
 
 **English** | [Chinese](README_zh.md)
@@ -74,10 +74,9 @@ Build project-local teams with roles, pane layout, provider state, worktree isol
 <details>
 <summary><b>Latest release highlights</b></summary>
 
-- **Codex managed config handles rich TOML**: inherited `config.toml` with inline table arrays now renders cleanly instead of failing on parsed dict values.
-- **Fallback config copy avoids duplicate features sections**: managed Codex homes update existing `[features]` blocks and stop at `[[array_of_tables]]` boundaries when no TOML parser is available.
-- **Installers provision TOML parsing when needed**: Linux/macOS and Windows installers auto-install `tomli>=2.0.0` when no TOML reader exists, with `CCB_INSTALL_TOMLI=0` available to skip.
-- **Managed venv setup installs dependencies in the right scope**: release installs add `tomli` inside the managed venv before optional watchdog setup.
+- **Claude managed memory avoids duplicate project rules**: managed `.claude/CLAUDE.md` no longer copies project-level `CLAUDE.md`; Claude continues loading that file natively from the working directory.
+- **Managed Claude memory keeps the right inherited sources**: real `~/.claude/CLAUDE.md`, `.ccb/ccb_memory.md`, and per-agent `.ccb/agents/<agent>/memory.md` still project into the managed bundle.
+- **Memory source loading is now controllable**: `load_memory_sources(..., include_provider_native_project=False)` can skip provider-native project memory while existing callers keep the default include behavior.
 
 See [Release Notes](#release-notes) for the full history.
 
@@ -339,6 +338,15 @@ Thanks to the [Linux.do community](https://linux.do) for testing, feedback, and
 Historical note: older release notes below may mention `askd`, legacy flags, or removed commands. Those references are kept only as changelog history and do not redefine the current CLI surface.
 
 <details open>
+<summary><b>v6.2.5</b> - Claude Managed Memory De-Duplication Hotfix</summary>
+
+- Stops copying project-level `CLAUDE.md` into managed `.claude/CLAUDE.md`, so Claude reads it once from the working directory.
+- Keeps provider user memory, CCB shared project memory, and per-agent private memory in the managed Claude bundle.
+- Adds an opt-out flag for provider-native project memory in `load_memory_sources` while preserving default behavior for other callers.
+
+</details>
+
+<details>
 <summary><b>v6.2.4</b> - Codex Managed Config TOML Hotfix</summary>
 
 - Renders dict values as inline TOML tables so inherited Codex configs with inline table arrays no longer crash during managed-home projection.

README_zh.md

@@ -7,7 +7,7 @@
   <img src="https://img.shields.io/badge/模型皆可控-CF1322?style=for-the-badge" alt="模型皆可控">
 </p>
 
-[![Version](https://img.shields.io/badge/version-6.2.4-orange.svg)]()
+[![Version](https://img.shields.io/badge/version-6.2.5-orange.svg)]()
 [![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)]()
 
 [English](README.md) | **中文**
@@ -74,10 +74,9 @@
 <details>
 <summary><b>最新版本亮点</b></summary>
 
-- **Codex managed config 支持更复杂 TOML**：继承的 `config.toml` 含 inline table array 时会正常渲染，不再因为 parsed dict value 报错。
-- **Fallback config copy 不再重复追加 features 段**：没有 TOML parser 时会原位更新已有 `[features]`，并正确识别 `[table]` 与 `[[array_of_tables]]` 边界。
-- **安装器会按需补 TOML parser**：Linux/macOS 和 Windows 安装器在没有 TOML reader 时自动安装 `tomli>=2.0.0`，也可用 `CCB_INSTALL_TOMLI=0` 跳过。
-- **Managed venv 依赖安装作用域正确**：release 安装会先在 managed venv 内安装 `tomli`，再处理可选 watchdog。
+- **Claude managed memory 不再重复项目规则**：managed `.claude/CLAUDE.md` 不再复制项目级 `CLAUDE.md`；Claude 仍会从工作目录原生读取它。
+- **Managed Claude memory 保留正确继承源**：真实 `~/.claude/CLAUDE.md`、`.ccb/ccb_memory.md` 和每个 agent 的 `.ccb/agents/<agent>/memory.md` 仍会进入 managed bundle。
+- **Memory source 加入可控开关**：`load_memory_sources(..., include_provider_native_project=False)` 可跳过 provider-native project memory，默认行为仍保持包含。
 
 完整历史见 [新版本记录](#新版本记录)。
 
@@ -330,6 +329,15 @@ ccb reinstall
 历史说明：下面较旧的发布记录里仍可能出现 `askd`、旧 flag 或已移除命令。这些内容仅作为 changelog 历史保留，不代表当前 CLI 入口。
 
 <details open>
+<summary><b>v6.2.5</b> - Claude Managed Memory De-Duplication Hotfix</summary>
+
+- 不再把项目级 `CLAUDE.md` 复制进 managed `.claude/CLAUDE.md`，让 Claude 只从工作目录读取一次。
+- managed Claude bundle 仍保留 provider user memory、CCB shared project memory 和 agent private memory。
+- `load_memory_sources` 增加 provider-native project memory 的 opt-out 开关，同时保留其他调用方默认包含的行为。
+
+</details>
+
+<details>
 <summary><b>v6.2.4</b> - Codex Managed Config TOML Hotfix</summary>
 
 - 将 dict value 渲染为 inline TOML table，避免继承含 inline table array 的 Codex config 时 managed-home projection 崩溃。

VERSION

@@ -1 +1 @@
-6.2.4
+6.2.5

ccb

@@ -21,7 +21,7 @@ backend_env = get_backend_env()
 if backend_env and not os.environ.get("CCB_BACKEND_ENV"):
     os.environ["CCB_BACKEND_ENV"] = backend_env
 
-VERSION = "6.2.4"
+VERSION = "6.2.5"
 GIT_COMMIT = "release"
 GIT_DATE = "2026-05-11"
 

lib/project_memory/sources.py

@@ -36,6 +36,7 @@ def load_memory_sources(
     provider: str,
     extra_sources: tuple[ProjectMemorySource, ...] = (),
     include_missing: bool = True,
+    include_provider_native_project: bool = True,
 ) -> tuple[ProjectMemorySource, ...]:
     layout = _layout(project_root_or_layout)
     sources: list[ProjectMemorySource] = []
@@ -49,7 +50,7 @@ def load_memory_sources(
         )
     )
 
-    provider_path = provider_native_memory_path(layout, provider)
+    provider_path = provider_native_memory_path(layout, provider) if include_provider_native_project else None
     if provider_path is not None:
         provider_source = _read_source(
             kind='provider_native_project',

lib/provider_backends/claude/launcher_runtime/home.py

@@ -281,6 +281,7 @@ def _materialize_claude_memory(
             agent_name=agent_name,
             provider='claude',
             extra_sources=extra_sources,
+            include_provider_native_project=False,
         )
         warnings.extend(source.warning for source in sources if source.warning)
         rendered = render_memory_bundle(

test/test_project_memory.py

@@ -113,6 +113,31 @@ def test_load_memory_sources_reads_from_project_root_not_workspace(tmp_path: Pat
     assert 'workspace-only memory' not in ''.join(content_by_kind.values())
 
 
+def test_load_memory_sources_can_skip_provider_native_project_memory(tmp_path: Path) -> None:
+    project_root = tmp_path / 'repo'
+    project_root.mkdir()
+    _write_project_memory(project_root, 'shared memory\n')
+    (project_root / 'CLAUDE.md').write_text('project claude memory\n', encoding='utf-8')
+    agent_private_memory_path(project_root, 'Agent1').parent.mkdir(parents=True)
+    agent_private_memory_path(project_root, 'Agent1').write_text('private memory\n', encoding='utf-8')
+
+    default_sources = load_memory_sources(project_root, agent_name='Agent1', provider='claude')
+    skipped_sources = load_memory_sources(
+        project_root,
+        agent_name='Agent1',
+        provider='claude',
+        include_provider_native_project=False,
+    )
+
+    assert [source.kind for source in default_sources] == [
+        'ccb_shared',
+        'provider_native_project',
+        'agent_private',
+    ]
+    assert [source.kind for source in skipped_sources] == ['ccb_shared', 'agent_private']
+    assert 'project claude memory' not in ''.join(source.content for source in skipped_sources)
+
+
 def test_materialize_runtime_memory_bundle_writes_generated_bundle(tmp_path: Path) -> None:
     project_root = tmp_path / 'repo'
     workspace = tmp_path / 'worktree'

test/test_provider_hook_settings.py

@@ -190,7 +190,7 @@ def test_prepare_provider_workspace_materializes_claude_memory_bundle_before_hoo
     assert text.startswith('# CCB Managed Agent Memory')
     assert 'system claude memory' in text
     assert 'shared ccb memory' in text
-    assert 'project claude memory' in text
+    assert 'project claude memory' not in text
     assert 'agent private memory' in text
 
 

test/test_provider_profiles.py

@@ -1751,8 +1751,8 @@ def test_materialize_claude_home_config_writes_project_memory_bundle(tmp_path: P
     assert 'user claude memory' in text
     assert '## CCB Shared Project Memory' in text
     assert 'shared ask memory' in text
-    assert '## Provider-Native Project Memory' in text
-    assert 'project claude memory' in text
+    assert '## Provider-Native Project Memory' not in text
+    assert 'project claude memory' not in text
     assert '## Agent Private Memory' in text
     assert 'reviewer private memory' in text