本文件只维护 Core 边界债务、迁移顺序和退出条件。稳定架构以 产品运行时架构为准；Agent Runtime、产品定制和 OpenCode 扩展分别由 运行时设计、 产品定制设计和 OpenCode 扩展兼容设计负责；OpenCode 交付阶段与 退出条件见扩展兼容计划。已完成事实归档在 core-decomposition-completed.md。
- 依赖方向固定为产品入口 / interfaces → assembly → adapters / services / execution → contracts。
- DTO 或端口抽取不等于运行时 owner 已迁移；只有生产入口切换、行为等价成立且旧写入方退出后才算完成。
- 每次只迁移一条端到端调用链，不按目录或类型数量拆 PR。
- 新接口必须有当前生产消费方、版本边界、验证方式和删除条件；空 profile、re-export、测试桩或未来矩阵不算消费方。
- 入口、Remote 和 SDK 的不支持状态必须类型化且可解释，不得静默回到
product-full或本机执行。 - Core 拆解与生态兼容并行演进。任何一条路线不得为了等待另一条路线而预建通用接口。
| 事实 | 当前状态 | 结论 |
|---|---|---|
| 产品能力组装 | DeliveryProfile、ProductAssembler、能力计划、服务可用性和测试已存在 |
这些是可测试的 assembly facts，不代表产品入口已接入 |
| CLI / Desktop / ACP | CLI 与 ACP 已分别提交对应 DeliveryProfile、消费 Runtime Parts/SDK，并选择经过评审的 Core owner feature closure；Desktop 仍启用 bitfun-core/product-full，主交互已消费由现有 owner 构造的窄口径 SDK 接口 |
三个入口仍复用单一 Core runtime owner；完整 Desktop profile 和剩余兼容操作仍需逐项迁移 |
| Server | 当前生产路由只形成 health/info/ping 基线 | 没有插件状态或独立产品组装完整流程 |
| Server / Remote / Web / Mobile Web / SDK profile | 当前为空计划、未接入入口或仅有 preview 测试 | 不得据枚举值宣称产品能力已交付 |
| Agent Runtime SDK | 已有无 bitfun-core 依赖的 v6 preview 接口和 smoke test |
发布边界仍需真实嵌入方证明 |
| 插件运行时 | 现有路径只覆盖 BitFun 原生包和 OpenCode custom tool 静态名称预览 | 不能据通用消息结构或静态候选扩张稳定 ABI |
| Relay | room/device 状态、account/sync 存储、asset store 与 HTTP/WebSocket router 已归属 services/relay-service，standalone 与 embedded 入口同向消费；embedded bind、静态 fallback 和任务生命周期由 Desktop 窄宿主端口持有 |
Cargo metadata 门禁覆盖 workspace、独立 manifest、normal/build/dev 依赖及 optional/target 变体；宿主归位已完成并由生命周期与边界测试保护 |
| CLI CI | 独立 Linux job 运行 CLI test，通用三平台 workspace check 覆盖 CLI 编译；Linux PTY 与 Windows ConPTY 有启动页生命周期及本地确定性流式模型夹具驱动的活动 turn 进程测试，发布归档上传前校验 SHA-256 并解压执行 | 参数/序列化/前置失败和组装已有 focused contract；本地模型 HTTP 403 授权拒绝、流中断后的重试失败、Linux PTY/Windows ConPTY Chat resize/取消、exec Ctrl+C 及 Patch I/O 失败已有分层回归，真实供应商审批交互、macOS 活动 PTY 与 OS 级终端故障注入仍需补齐 |
| 层 | 负责 | 禁止 |
|---|---|---|
| apps / interfaces | 选择唯一入口形态，提交 profile，转换协议或界面数据 | 成为共享运行时归属模块，复制会话/工具/权限逻辑 |
| assembly | 选择能力、提供方和兼容接口，输出类型化 runtime parts | 依赖 app crate，持有平台进程/协议实现，重新解释动态配置 |
| adapters / services | 协议转换、平台 I/O、可复用具体实现 | 反向依赖 assembly 或产品入口 |
| execution | Agent、Tool、命名工作流和 PluginRuntimeClient 的可移植执行语义 |
读取交付形态，依赖 app/adapter 具体实现，或持有 Plugin Host 物理进程 |
| contracts | 稳定 DTO、事实和端口 | 依赖上层或持有运行时行为 |
需要同时被独立应用和嵌入式模式复用的能力，先下沉为 services/adapters owner，再由 app 与 assembly 同向消费。 Relay 已按该规则完成首个修复；后续共享实现仍不得以 app crate 充当下层库。
- relay router、room、存储与 asset-store 已归属
services/relay-service。 - standalone relay app 和嵌入式入口共同依赖该 owner，
assembly/core -> apps/relay-server已删除。 - crate 层级依赖已增加 Cargo metadata 通用检查和反向用例，不再只保护已知 crate 名称。
共享 owner、Cargo 方向和宿主归位的退出条件已满足：standalone 与 embedded 入口共用同一已测试 router，Cargo 图不再包含
assembly → apps；embedded 的 bind、静态 fallback 和任务生命周期由 Desktop 通过 EmbeddedRelayHost 持有。
CLI 是首个入口迁移对象，因为它已有独立产品诉求、显式设计和最小 CI 命令。
当前端到端能力已经完成：入口只提交一次 DeliveryProfile::Cli，通过现有 ProductAssembler 获得计划、服务可用性
和禁用的插件 binding；TUI、Exec、Session 与 Usage 共用一个 CliRuntimeContext。主会话客户端的创建（包括
exec --session-id 和缺失后端会话通过独立固定 ID 方法按原 ID 重建）/列举/删除/恢复、类型化转录、本地分支、用量生成、
会话模型更新、ACP 活动会话模式更新、轮次提交/取消和精确轮次结算均走 Agent Runtime SDK；Desktop 与 Peer Host 的本地工作区准备、
会话文件清单、类型化快照统计和工作区文件回滚通过不属于 SDK 的窄 owner port 复用现有 Core 快照实现；Desktop 保留既有远程空结果，
Peer Host 返回明确不支持错误，历史维护仍留在宿主；
富历史及 Peer Host/ACP 的其余维护等未迁移能力继续集中在一个 Core 兼容接口。Agentic Event Queue 仍是唯一
owner，各入口只建立独立广播订阅，有界兼容队列满载不再阻断广播。TUI 与 Exec 审批均为调用级策略，不写全局
配置；CLI 本地路径不获取具体 PersistenceManager。交互、执行和管理入口分别控制 Peer Host/MCP 生命周期，管理查询不启动
这两类外部服务。结构化输出复用现有 Agent 事件对象；会话 ID 与
存储路径绑定并在删除前校验；TUI 终端恢复由 RAII guard 覆盖错误和 panic 展开路径。
Peer Host 的 Runtime 接入和跨 Relay/Desktop/Web 的协议切换保持独立；本切片不改变其 HostInvoke、身份、确认或 重连语义。
下一步按独立端到端能力推进：
- 继续以真实调用方和行为等价测试逐项缩小 Peer Host 持久化维护兼容面；本地快照窄端口不扩张为远程快照、完整 checkpoint/rewind 或 Runtime SDK 能力，远程分支另行定义身份和存储语义，模型目录与配置仍保留在产品入口。
- ACP 完整历史继续使用单次 Core 兼容恢复；在出现第二个真实消费者及经过授权的附件读取能力前，不为协议回放扩张通用 transcript。模型/模式目录与配置读取、MCP、ACP stdio 和协议转换生命周期继续留在各自现有归属模块。
- 继续按真实故障样例拆分 TUI 副作用边界；当前切片已覆盖本地确定性流式模型夹具驱动的 Linux PTY/Windows ConPTY Chat resize/取消、
execCtrl+C、本地模型 HTTP 403 授权拒绝、流中断后的重试失败、stream-jsonPatch 写入失败和终端恢复错误聚合， 不以大规模重写替代现有回归保护。
当前 assembly 切换条件已经满足：CLI 生产入口消费真实组装结果，目标链路没有第二套状态，独立测试与三平台
编译门禁存在，启动页 PTY/ConPTY 生命周期、Chat resize/取消、exec Ctrl+C、本地模型 403/断流失败最终状态、Patch I/O 失败与发布归档冒烟测试已接入门禁。
CLI-P0 整体退出条件尚未满足；真实供应商审批流、OS 级终端初始化故障注入、兼容接口退出以及 ACP/Desktop 切换仍需分别验收。
- ACP 在 CLI 之后迁移，优先简化协议转换和权限/会话桥接，不把 ACP 生命周期下沉到 Agent Runtime。
- Desktop 最后迁移，因为当前
product-full覆盖最广；按服务簇逐步切换，保留 Tauri 与窗口行为在 app/adapter。 - 每个入口独立提交自己的 profile；禁止 assembly 根据调用栈、feature 或全局状态再次猜测交付形态。
退出条件与 CLI 相同：生产消费、行为等价、单一 owner、旧路径退出和入口级验证缺一不可。
- Server 先从现有 health/info/ping 基线选择一个真实 API 消费方，不预建完整产品 surface。
- Remote 必须在实际工作区执行域完成能力协商，不以本地 provider 代替。
- SDK 只有在外部或仓库内独立嵌入方无需
bitfun-core/product-full即可完成最小 session/turn/event 流程后，才从 preview 晋级。 - 空 capability plan、disabled stub 和单元测试用于保护降级，不构成产品完成证据。
Core 只为插件兼容提供已有 owner 的窄接口：真实工具、类型化 Hook 变换、公开事件、权限请求和诊断。OpenCode 来源发现、执行准备与兼容语义由对应架构设计和适配器 owner 负责；计划只维护交付顺序与退出条件。
首个可执行切片应只完整流程一种 standalone custom tool：真实来源 → worker → 原始校验 → Tool Runtime → 调用结果。 在该切片完成前：
- 不扩张现有通用插件调用与效果 DTO 去承载 Hook、Client 或 TUI；
- 不为未来生态新增公共注册表或多用途 DTO；
- 不把静态名称、
ready或 adapter fixture 当作工具可调用； - 不再引入只有描述符、没有真实执行调用方的通用工作流框架。
- 同步最新
gcwing/main，记录入口、依赖图和生产消费方。 - 选择一个用户可见端到端能力，写清当前 owner、目标 owner、唯一写入方和删除条件。
- 先补行为等价与边界失败用例，再切换生产调用方。
- 删除或固定被替代路径，复核 Remote、错误、取消和恢复语义。
- 运行最小可信验证，再由独立审查者检查过度设计、旧路径残留和能力过度声明。
- PR 明确当前能力、变更后的能力、未覆盖项、用户影响和回退方式。
| 范围 | 最小验证 |
|---|---|
| 文档与仓库边界 | pnpm run check:repo-hygiene，node --test scripts/check-core-boundaries.test.mjs，node scripts/check-core-boundaries.mjs |
| 入口 profile 迁移 | 对应 app 的 check/test、入口级 smoke、profile/服务可用性断言、旧路径等价用例 |
| Relay 共享 owner / Cargo 方向 | standalone 与 embedded focused tests、Cargo 依赖方向失败用例、Desktop 宿主启停/失败回滚/静态缓存行为测试 |
| Agent Runtime / SDK | cargo test -p bitfun-agent-runtime --no-default-features --features agent-runtime --lib，最小 no-bitfun-core 嵌入测试 |
| 插件首个执行切片 | runtime ports、PluginRuntimeClient、生态 adapter、ScriptToolRuntime、Plugin Host 与真实固定 fixture 的端到端调用 |
| CLI | cargo check -p bitfun-cli，cargo test -p bitfun-cli，结构化协议和 package smoke |
出现以下任一情况时，不继续扩接口：
- 只有枚举、空计划、re-export、测试桩或未来矩阵，没有生产消费方；
- assembly 新增 app 依赖，或下层读取 profile/产品入口状态；
- 同一事实在兼容接口与目标 owner 中同时计算或写入；
- 通用消息对象、候选效果或描述符开始承载工具、Hook、Client、TUI 等不同语义；
- Remote 不支持时静默回本机，或 SDK 仍需要
product-full却被描述为独立可用； - 为迁移一次性重写全部 CLI、Desktop 或 Core，而没有可单独验收的端到端能力。