Release v6.2.2 codex migration prompt hotfix

Author: SeemSeam

CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## v6.2.2 (2026-05-18)
+
+### Codex Managed Home Migration Prompt Hotfix
+
+- **Codex External Migration Prompt Disabled In Managed Homes**: managed Codex `config.toml` now forces `[features].external_migration = false` so managed panes do not stop on an interactive migration prompt.
+- **Inherited Config Preserved**: source-home Codex config, model/API settings, and existing feature flags are still inherited; only the managed-home external migration prompt is disabled.
+- **Fallback Copy Path Hardened**: when TOML parsing is unavailable, the copied managed config still gets a managed `[features]` override for `external_migration = false`.
+
 ## v6.2.1 (2026-05-18)
 
 ### Inherited CCB Config Skill Release

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.1-orange.svg)]()
+[![Version](https://img.shields.io/badge/version-6.2.2-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,10 @@ Build project-local teams with roles, pane layout, provider state, worktree isol
 <details>
 <summary><b>Latest release highlights</b></summary>
 
-- **Inherited `ccb_config` skill added**: Claude and Codex installs now include a CCB-owned skill for designing `.ccb/ccb.config` and team memory.
-- **Inherited skills moved under `inherit_skills/`**: CCB-owned skills are inherited automatically, while optional `useful_tools/` remain user-installable.
-- **Ask guidance is shorter**: CCB injects concise English reply guidance, avoids repeating nested-routing instructions in every ask body, and recognizes more explicit-output requests.
-- **Memory routing is clearer**: `ccb_config` role memory favors direct owner-to-next-owner handoffs and separate root work packages for parallel chains.
+- **Managed Codex no longer stops on migration prompts**: CCB disables Codex `external_migration` only inside managed Codex homes.
+- **Inherited Codex config is preserved**: source-home model, API, and feature settings still carry forward; the managed-home override only prevents the interactive migration prompt.
+- **Fallback config copy is covered**: even when TOML parsing is unavailable, copied managed Codex config receives the external migration override.
+- **Inherited `ccb_config` remains available**: Claude and Codex installs keep the CCB config-design skill introduced in v6.2.1.
 
 See [Release Notes](#release-notes) for the full history.
 
@@ -339,6 +339,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.2</b> - Codex Managed Home Migration Prompt Hotfix</summary>
+
+- Disables `[features].external_migration` inside managed Codex homes so panes do not block on an interactive migration prompt.
+- Preserves inherited Codex source-home config, model/API settings, and other feature flags.
+- Adds coverage for parsed TOML inheritance and fallback copy behavior when TOML parsing is unavailable.
+
+</details>
+
+<details>
 <summary><b>v6.2.1</b> - Inherited CCB Config Skill Release</summary>
 
 - Adds inherited Claude and Codex `ccb_config` skills for designing `.ccb/ccb.config`, choosing agent roles/providers/worktree layout, and updating shared plus per-agent memory.

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.1-orange.svg)]()
+[![Version](https://img.shields.io/badge/version-6.2.2-orange.svg)]()
 [![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)]()
 
 [English](README.md) | **中文**
@@ -74,10 +74,10 @@
 <details>
 <summary><b>最新版本亮点</b></summary>
 
-- **新增继承式 `ccb_config` skill**：Claude 和 Codex 安装现在会继承 CCB 自带的配置设计 skill，用于设计 `.ccb/ccb.config` 和团队记忆。
-- **继承式 skill 统一到 `inherit_skills/`**：CCB 自带 skill 自动继承，`useful_tools/` 保持为用户按需安装的可选工具。
-- **Ask guidance 更短**：CCB 注入简洁英文回复指引，不再给每个 ask body 重复 nested-routing 说明，并识别更多显式完整输出要求。
-- **记忆路由更清晰**：`ccb_config` 角色记忆示例强调 owner-to-next-owner 直接交接，以及并行链路使用独立 root work package。
+- **Managed Codex 不再卡在迁移提示**：CCB 只在托管 Codex home 里禁用 Codex `external_migration`。
+- **保留继承的 Codex 配置**：source-home 的 model、API 和其他 feature 设置仍会继承；managed-home override 只阻止交互式迁移提示。
+- **Fallback config copy 也覆盖**：即使 TOML parser 不可用，复制到 managed Codex home 的配置也会追加 external migration override。
+- **继承式 `ccb_config` 保持可用**：Claude 和 Codex 安装继续包含 v6.2.1 新增的 CCB 配置设计 skill。
 
 完整历史见 [新版本记录](#新版本记录)。
 
@@ -330,6 +330,15 @@ ccb reinstall
 历史说明：下面较旧的发布记录里仍可能出现 `askd`、旧 flag 或已移除命令。这些内容仅作为 changelog 历史保留，不代表当前 CLI 入口。
 
 <details open>
+<summary><b>v6.2.2</b> - Codex Managed Home Migration Prompt Hotfix</summary>
+
+- 在 managed Codex home 内禁用 `[features].external_migration`，避免 pane 被交互式 migration prompt 卡住。
+- 保留继承的 Codex source-home config、model/API 设置和其他 feature flags。
+- 增加 parsed TOML 继承和 TOML parser 不可用时 fallback copy 行为的测试覆盖。
+
+</details>
+
+<details>
 <summary><b>v6.2.1</b> - Inherited CCB Config Skill Release</summary>
 
 - 新增继承式 Claude / Codex `ccb_config` skill，用于设计 `.ccb/ccb.config`、选择 agent 角色/provider/worktree layout，并更新共享和 per-agent memory。

VERSION

@@ -1 +1 @@
-6.2.1
+6.2.2

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.1"
+VERSION = "6.2.2"
 GIT_COMMIT = "release"
 GIT_DATE = "2026-05-11"
 

lib/provider_profiles/codex_home_config.py

@@ -41,6 +41,7 @@
     Path('.agents') / 'skills',
     Path('plugins'),
 )
+_MANAGED_CODEX_DISABLED_FEATURES = ('external_migration',)
 
 
 @dataclass(frozen=True)
@@ -76,7 +77,12 @@ def materialize_codex_home_config(
         _write_codex_api_authority_config(target_config, authority, source_config=source_config)
     elif _inherits_config(profile) and _inherits_api(profile) and _source_config_valid(source_config):
         if source_config.is_file():
-            _sync_file(source_config, target_config)
+            payload = _read_source_config_payload(source_config)
+            if payload:
+                _write_managed_codex_config(target_config, payload)
+            else:
+                _sync_file(source_config, target_config)
+                _append_managed_codex_feature_overrides(target_config)
         else:
             _write_managed_config_stub(target_config)
     else:
@@ -199,6 +205,25 @@ def _write_managed_config_stub(target: Path) -> None:
     target.write_text('# ccb agent-local codex config\n', encoding='utf-8')
 
 
+def _write_managed_codex_config(target: Path, payload: dict[str, object]) -> None:
+    target.parent.mkdir(parents=True, exist_ok=True)
+    sanitized = _disable_interactive_migration_features(payload)
+    target.write_text(_render_toml_document(sanitized), encoding='utf-8')
+
+
+def _append_managed_codex_feature_overrides(target: Path) -> None:
+    if not target.is_file():
+        return
+    try:
+        text = target.read_text(encoding='utf-8')
+    except Exception:
+        return
+    lines = [text.rstrip(), '', '[features]']
+    for feature_name in _MANAGED_CODEX_DISABLED_FEATURES:
+        lines.append(f'{feature_name} = false')
+    target.write_text('\n'.join(lines).lstrip('\n') + '\n', encoding='utf-8')
+
+
 def _managed_codex_config_payload(source_config: Path, *, authority: CodexApiAuthority) -> dict[str, object]:
     payload = {'model_provider': authority.provider_id}
     inherited_payload = _strip_route_authority(_read_source_config_payload(source_config))
@@ -212,7 +237,17 @@ def _managed_codex_config_payload(source_config: Path, *, authority: CodexApiAut
             'base_url': authority.base_url,
         }
     }
-    return payload
+    return _disable_interactive_migration_features(payload)
+
+
+def _disable_interactive_migration_features(payload: dict[str, object]) -> dict[str, object]:
+    sanitized = _clone_mapping(payload)
+    raw_features = sanitized.get('features')
+    features = dict(raw_features) if isinstance(raw_features, dict) else {}
+    for feature_name in _MANAGED_CODEX_DISABLED_FEATURES:
+        features[feature_name] = False
+    sanitized['features'] = features
+    return sanitized
 
 
 def _import_optional_toml_reader():

test/test_provider_profiles.py

@@ -136,6 +136,39 @@ def test_materialize_codex_profile_copies_inherited_assets(tmp_path: Path, monke
     assert (runtime_home / 'sessions').is_dir()
 
 
+def test_materialize_codex_profile_disables_external_migration_prompt(tmp_path: Path, monkeypatch) -> None:
+    project_root = tmp_path / 'repo'
+    source_home = tmp_path / 'system-codex-home'
+    source_home.mkdir(parents=True, exist_ok=True)
+    (source_home / 'config.toml').write_text(
+        '\n'.join(
+            [
+                'model = "gpt-5.5"',
+                '',
+                '[features]',
+                'external_migration = true',
+                'memories = true',
+                '',
+            ]
+        ),
+        encoding='utf-8',
+    )
+    monkeypatch.setenv('CODEX_HOME', str(source_home))
+
+    profile = materialize_provider_profile(
+        layout=PathLayout(project_root),
+        spec=_spec('agent1', provider_profile=ProviderProfileSpec(mode='isolated')),
+        workspace_path=project_root,
+    )
+
+    config_text = (Path(profile.runtime_home or '') / 'config.toml').read_text(encoding='utf-8')
+    assert 'model = "gpt-5.5"' in config_text
+    assert '[features]' in config_text
+    assert 'memories = true' in config_text
+    assert 'external_migration = false' in config_text
+    assert 'external_migration = true' not in config_text
+
+
 def test_materialize_codex_home_config_falls_back_to_marked_copy_when_symlink_fails(tmp_path: Path, monkeypatch) -> None:
     source_home = tmp_path / 'system-codex-home'
     target_home = tmp_path / 'managed-codex-home'

test/test_v2_runtime_launch.py

@@ -1502,7 +1502,9 @@ def test_codex_launcher_build_start_cmd_does_not_require_toml_parser_for_config_
 
     isolated_home = runtime_dir / 'codex-state' / 'home'
     assert f'CODEX_HOME={shlex.quote(str(isolated_home))}' in cmd
-    assert (isolated_home / 'config.toml').read_text(encoding='utf-8') == 'model = "gpt-5"\n'
+    config_text = (isolated_home / 'config.toml').read_text(encoding='utf-8')
+    assert 'model = "gpt-5"' in config_text
+    assert 'external_migration = false' in config_text
     assert (isolated_home / 'skills' / 'demo' / 'SKILL.md').read_text(encoding='utf-8') == 'skill\n'
 
 
@@ -2261,7 +2263,9 @@ def test_codex_launcher_build_start_cmd_refreshes_managed_home_projection(monkey
     _codex_start_cmd(command, spec, runtime_dir, 'sess-refresh-1')
 
     isolated_home = runtime_dir / 'codex-state' / 'home'
-    assert (isolated_home / 'config.toml').read_text(encoding='utf-8') == 'model = "gpt-5"\n'
+    config_text = (isolated_home / 'config.toml').read_text(encoding='utf-8')
+    assert 'model = "gpt-5"' in config_text
+    assert 'external_migration = false' in config_text
     assert (isolated_home / 'auth.json').read_text(encoding='utf-8') == '{"OPENAI_API_KEY":"old-key"}\n'
     assert (isolated_home / '.tmp' / 'plugins.sha').read_text(encoding='utf-8') == 'plugins-sha-v1\n'
     assert (
@@ -2280,7 +2284,9 @@ def test_codex_launcher_build_start_cmd_refreshes_managed_home_projection(monkey
 
     _codex_start_cmd(command, spec, runtime_dir, 'sess-refresh-2')
 
-    assert (isolated_home / 'config.toml').read_text(encoding='utf-8') == 'model = "gpt-5.1"\n'
+    config_text = (isolated_home / 'config.toml').read_text(encoding='utf-8')
+    assert 'model = "gpt-5.1"' in config_text
+    assert 'external_migration = false' in config_text
     assert (isolated_home / 'auth.json').read_text(encoding='utf-8') == '{"OPENAI_API_KEY":"new-key"}\n'
     assert (isolated_home / '.tmp' / 'plugins.sha').read_text(encoding='utf-8') == 'plugins-sha-v2\n'
     marketplace_payload = json.loads(