feat(parity): Wave E — settings persistence, exit_plan_mode, --fork-session, fallback signature strip, hermetic tests (v1.30.0)

[sweetcornna]

Wave E — claude-code parity 小批量五连 (v1.30.0)

Gap ledger Wave E,五项独立小改动打包成一个 PR(每项都有自己的 TDD 红→绿轨迹)。

E1 — 分层权限设置持久化 + 控制台 persist 答案

问题:PermissionGate.from_layered_sources 零生产调用方——所有部署只从 env 建 gate,durable 规则只能写环境变量;控制台 "always" 授权随会话蒸发。

• 新模块 corlinman_agent.permission_settings:build_permission_gate() 按 <data_dir>/settings.json(用户层)→ <项目>/.corlinman/settings.local.json(项目层)→ CORLINMAN_AGENT_PERMISSIONS env(最终话语权)叠层;mode/strict 同 precedence;无设置文件时与旧 from_env() 字节等价(含 first-match-wins 默认)。坏文件/坏块跳过不崩溃。
• ApprovalGate + servicer 默认 gate 构造切到新加载器。
• 控制台审批新增第三答案 p/persist:等同 always 并经 persist_allow_rule 原子写入(tmp+rename、幂等)用户层 settings;persist 钩子失败降级为会话级授权而非拒绝。a 保持会话级(Codex Console permission surface: /permissions, /plan, --permission-mode + interactive approval (v1.23.0) #104——授权不越上下文边界)。

E2 — exit_plan_mode 内置工具

plan mode 拒掉全部 mutating 工具,此前只能人肉 /permissions 放行。现在模型计划就绪自己调用:

• plan → default 翻转 + 交互审批缓存重置(两个 resolver 来源——set_approval_resolver 与 app_state.approval_resolver——都重置);非 plan mode 干净 no-op;可选 plan 摘要回显。
• 二阶边缘预堵(本 parity 程序的教训:权限面每修一处开一个二阶边缘):权限 mode 是 servicer 级全局的,plan 模式下 spawn 工具不属 mutating、子代理可被派生——child executor 现在与递归 spawn / 后台 shell 同款拒绝子代理调用 exit_plan_mode,只有顶层回合能结束 plan mode。
• skill allowed-tools 控制工具直通名单加入本工具,防 skill 把模型困死在 plan mode。

E3 — --fork-session

• AgentJournal.fork_session:仅复制 completed 回合、按时间序、消息/tool_calls 保真;in_progress(在别处直播)与 errored(T4.4 面包屑)不复制;单回合损坏 log+跳过;源会话全程只读。Postgres 后端 list_session_turns 为 stub → 干净降级 0-turn fork(docstring 注明,含 limit 截断语义)。
• 控制台 --fork-session:恢复前铸新 console:<id> key 并 fork,原会话零污染;attach 模式回显不支持说明后继续不 fork。

E4 — fallback 跨模型 thinking 签名剥离

thinking 块签名按模型铸造;OpenAI 兼容入口带入的客户端历史在 model-not-found / 持续过载两条 fallback 分支切模型重放时会把可恢复错误变成硬 400。两条分支重放前剥 thinking/redacted_thinking 块与 signature 键(纯 thinking 内容折叠为 "")。

E5 — 测试封闭性

根 conftest.py autouse fixture 对非 live 测试清洗 ANTHROPIC_BASE_URL + 6 个代理变量——宿主泄漏的路由 env 曾把 respx-mock 的 provider 套件重路由到真网络造成假失败。live_llm/live_transport 不受影响;测试自身 monkeypatch.setenv 仍生效。

验证

• ruff / mypy(595 files)/ lint-imports 全绿
• pytest 非 live 全量:6708 passed, 4 skipped
• ui typecheck + lint + build 全绿;gen-proto.sh diff-clean
• 新增测试 30+:13(settings 分层/持久化)+ 8(console 审批含 persist 契约)+ 6(exit_plan_mode 含子代理拒绝、app_state resolver 重置)+ 10(journal fork + console fork)+ 3(签名剥离)+ 2(封闭性契约)

备注

• 与其他在途 wave PR(fix(security): W8 multi-tenant session isolation (critical, hunt-51) #114–feat(observability): #108 residuals — always-on subagent registry feed + resume user bubble + crashed-turn replay #118)一样独立自 main 分支;pyproject.toml 版本与 CHANGELOG.md 头部预计有琐碎合并冲突(各 wave 均 bump),合并时按序取最高版本即可。
• 实现由 Opus 子代理在任务书约束下完成,经三路对抗审查(全部 pass)+ 主模型逐 diff 复核;审查发现的子代理 exit_plan_mode 二阶边缘与双 resolver 重置缺口已在本 PR 内预堵。