跟踪 core runtime 架构拆解闭环

[limityan]

1. 背景

Core runtime 拆解已从低风险 contract / facade 抽取进入 owner 迁移阶段。本 Issue 用于跟踪 #964 之后的整体架构闭环，确保后续实现按分层、边界和验证策略推进，而不是退化为零散 API 增量或只增加 crate 的表面重构。

关联文档：

• docs/architecture/core-decomposition.md：事实架构、目标分层、接口与实现分离、Product Assembly 注册模型和主要风险。
• docs/architecture/agent-runtime-services-design.md：Agent Runtime SDK、Runtime Services、Tool Runtime、Harness、Product Capabilities、typed service injection、Remote ports、hooks/events 和验证策略。
• docs/plans/core-decomposition-plan.md：活跃迁移节奏、剩余 owner 队列、crate 创建准入、暂停条件和验证矩阵。
• docs/plans/core-decomposition-completed.md：已完成内容归档，避免活跃计划继续膨胀为流水账。

2. 总体目标

将 bitfun-core 逐步收敛为 compatibility facade 和 product assembly point。目标依赖方向为：

Product Surfaces -> Product Assembly / Capabilities -> Harness / Tool Runtime / Agent Runtime SDK -> Runtime Services -> Stable Contracts / External providers

重构目标不是增加 crate 数量。每个新增或扩展 owner 边界都必须同时满足：迁移或简化现有 core 路径、降低 concrete dependency 压力、保持旧路径兼容、可被 focused tests 和 boundary checks 验证。

3. 当前里程碑状态

里程碑	状态	当前说明
架构与执行计划基线	已建立	#964 建立事实架构、目标分层、风险和执行计划；后续只维护活跃计划与完成归档。
Runtime Services foundation	已建立	typed service bundle、provider registry、capability availability、fake provider 和 Remote port 边界已具备基础保护。
Tool / Product-domain 低风险 owner closure	已推进	portable facts、manifest/catalog、permission/result 纯策略和部分 product-domain boundary 已迁移；concrete IO 仍需按 owner 主题继续收敛。
Agent Runtime SDK owner baseline	进行中	scheduler/background delivery 已迁移；#1014 将 thread goal runtime decision owner 迁入 bitfun-agent-runtime，core 保留 metadata/tool/scheduler delivery adapter。
高风险 runtime 深迁移	待继续	concrete scheduler lifecycle、prompt loop、subagent registry facts/visibility、remote/product IO、Harness concrete execution 仍需按受保护 owner 主题推进。
Feature / build-benefit evaluation	待后置	只有 owner 边界稳定后才评估 feature matrix、no-default profile、构建收益和交付形态调整。

4. 活跃实施队列

1. Agent Runtime SDK owner closure

   • 已迁移 scheduler/background delivery 和 thread goal runtime decisions。
   • 剩余重点是 mode-scoped subagent visibility、agent registry facts、queue/preempt/cancel policy，以及可证明等价后的 concrete scheduler lifecycle。

2. Harness / Product Capability boundary

   • 为 Deep Review、DeepResearch、MiniApp 等 workflow 建立 provider contract。
   • Hook 必须具备顺序、timeout、错误策略和旧路径等价保护。

3. Product-domain / Tool concrete owner closure

   • MiniApp、function-agent、tool execution、workspace/file/result materialization 等 concrete IO 必须通过最小 port/provider 迁移。
   • 不允许 domain crate 重新吸收 filesystem、Git、AI、process、platform handle 等 concrete dependency。

4. Feature / delivery-shape evaluation

   • 在 owner 边界稳定后，用 cargo metadata / cargo tree / check profile 数据证明收益。
   • default features、release shape、构建脚本和产品能力裁剪必须单独评审。

5. 风险与质量门禁

风险	门禁
只新增抽象、不迁移逻辑，导致代码膨胀	owner PR 必须迁移、删除或显著简化旧路径；否则不得作为架构拆解 PR 合入。
用户可见行为、权限、工具曝光或 session 生命周期漂移	保留旧路径 facade，新增 focused regression；任何行为变更必须单独评审。
concrete dependency 回流到 Runtime / Tool / Harness 层	boundary check、cargo tree 和 crate AGENTS 必须覆盖新边界。
scheduler、subagent、hook、permission 等高风险路径时序漂移	先迁移 facts / decisions，再迁移 lifecycle；无法证明等价时暂停 PR。
为追求构建收益提前调整 feature 或交付形态	构建收益评估后置；runtime owner PR 不混入 default feature 或 release shape 变更。

6. Issue 生命周期

• 本 Issue 在完整架构迁移达到完成标准前保持打开。
• 单个实现 PR 合入时不要关闭本 Issue，只更新对应范围、状态、风险和剩余工作。
• 如果关联 PR 改变迁移顺序、范围边界、风险评估、验证策略或完成标准，需要同步更新本 Issue 和相关架构 / 计划文档。
• 已完成事实持续归档到 completed 文档；活跃计划只保留当前方向、剩余工作和必要门禁。

[limityan]

PR1 已提交：#975

本次状态更新：

• 已完成 Product Assembly / Runtime Services Foundation 的基础实现：新增 bitfun-runtime-services、typed builder、provider registry、capability availability、fake provider 和 focused tests。
• 已把后续迁移计划收敛为 PR1-PR7，并在 docs/plans/core-decomposition-plan.md 中细化 PR1 的实施门禁。
• 当前没有迁移 concrete runtime owner，不改变产品行为、默认能力集合、权限语义、工具曝光、事件语义、session 生命周期或构建脚本。
• 设计说明：bitfun-runtime-services 当前保持最小依赖，仅依赖 bitfun-runtime-ports、async-trait、thiserror；bitfun-core-types / bitfun-events 保留为后续 service DTO 或 event contract 需要时才引入的允许依赖，避免 PR1 提前扩大依赖面。
• 对抗性审查中发现并修复了 provider capability mismatch 风险；builder 现在会拒绝字段类型正确但 port 自报 capability 错误的注入。

已验证：

• cargo test -p bitfun-runtime-services
• cargo test -p bitfun-runtime-ports
• node scripts/check-core-boundaries.mjs
• pnpm run check:repo-hygiene
• git diff --check gcwing/main..HEAD
• cargo check -p bitfun-core --features product-full
• cargo check --workspace

下一阶段仍按计划进入 PR2：Service / Agent Remote Runtime Owner。该 Issue 继续保持打开，后续根据关联 PR 更新迁移状态和计划调整。

[limityan]

PR2 + PR3 合并实现已提交：#978

本次进展：

• PR2：remote workspace/session/file-projection 的稳定 owner contract 已迁入 bitfun-runtime-ports，bitfun-services-integrations::remote_connect 保留旧路径 re-export；具体 SSH / relay / terminal pre-warm / session restore / scheduler submit 仍留在 core。
• PR3：新增 bitfun-agent-runtime，当前只承接 scheduler/background delivery 的纯决策；concrete scheduler lifecycle、session manager、prompt loop、subagent registry 和 post-turn hook 未外移。
• 已同步更新 plan、架构文档、AGENTS 边界说明和 scripts/check-core-boundaries.mjs，避免把未完成迁移误描述为已完成。

风险与保护：

• 未修改产品命令、UI、默认 feature、release / fast build 脚本或产品能力集合。
• 提交前已按第三方对抗视角检查依赖方向、旧路径兼容、行为等价、性能额外开销和文档一致性；发现并修复了 background delivery action 暴露无意义 submission policy 的 API 风险。
• GitHub Actions CI run #1859 已通过：Frontend Build、Windows / Ubuntu / macOS Rust checks 全部成功。
• 本 issue 保持 open，后续会继续按关联 PR 更新迁移状态，不在 refactor: add runtime owner boundaries #978 合并时关闭。

验证命令已在 PR 描述中列出。

[limityan]

PR4 已提交：#989。

本次完成范围：

• 新增 bitfun-harness，作为 Harness Layer 的 provider-neutral contract crate，承接 workflow descriptor、route plan、outcome/error 和 registry wiring。
• 在 bitfun-core::agentic::harness 注册 Deep Review、DeepResearch、MiniApp 三个 legacy-facade provider，满足至少两个 workflow 可通过 provider contract 表达的 PR4 准入。
• 将 bitfun-harness 纳入 boundary check，禁止依赖 bitfun-core、具体 service crate、product-domain implementation、AI adapter、transport、Tauri、Git/MCP/image/WebSocket runtime deps、CLI/TUI 或 concrete tool pack。
• 更新架构、详细设计、执行计划、已完成归档和 AGENTS 文档，明确 PR4 只完成 contract / registry boundary。

明确未完成边界：

• Deep Review、DeepResearch、MiniApp 的 concrete workflow execution 未迁移。
• legacy_facade provider 只生成旧路径 route plan，execute 仍返回 unsupported；这用于防止误判为执行语义已外移。
• Product command registry、capability pack、Harness 对 Tool Runtime / Runtime Services 的实际 orchestration 仍属于后续迁移。

验证：

• cargo test -p bitfun-harness
• cargo test -p bitfun-core --features product-full product_harness
• node scripts/check-core-boundaries.mjs
• pnpm run check:repo-hygiene
• cargo check --workspace
• git diff --check gcwing/main...HEAD

该 issue 继续保持打开，等待后续 Product-Domain Runtime、Tool Runtime、Feature / Build-Benefit Evaluation，以及单独保护后的 Harness execution / Product Capability pack 迁移。

[limityan]

PR5 已提交：#991

本次完成内容：

• 在 bitfun-product-domains 中补齐 MiniApp / function-agent typed runtime service view。
• MiniApp dependency install 已通过 runtime port 路由，保留 worker process、pool.stop、state persistence、事件发送等旧路径语义。
• function-agent Git/AI facade 改为通过 service view 组装，concrete Git command、AI provider acquisition、AI transport error mapping 仍在 core adapter。
• 更新了 boundary check、架构文档、执行计划和 product-domains AGENTS 文档，明确 PR5 的完成边界。

仍未关闭的后续边界：

• MiniApp filesystem IO、worker process、host dispatch、builtin asset seed / marker IO 仍在 core / app adapter。
• function-agent Git/AI concrete adapter 与 provider acquisition 仍在 core。
• 后续重点仍是 Tool Runtime owner、Feature / Build-Benefit Evaluation，以及需要单独保护的更深 Product-Domain concrete provider 或 Harness execution / Product Capability pack 迁移。

本 issue 继续保持打开，等完整架构迁移闭环后再关闭。

[limityan]

更新 #991：本次 PR 已重做为文档纠偏，不再提交 Product-Domain runtime service-view 代码。

关键变化：

• 移除本轮“只新增 service view / facade / boundary 锚点”的代码尝试，不将其计入 PR5 完成。
• 明确新增抽象的准入标准：必须同时删除、迁移或显著简化既有代码路径，否则只能作为计划说明，不能算 runtime owner 迁移。
• 主计划收敛为剩余 PR5-PR7：Product-Domain Runtime 实迁移复核、Tool Runtime 真实 owner 迁移、Feature / Build-Benefit Closure。
• Product-Domain Runtime 需要先证明可迁移的完整 owner 候选；若无法减少旧路径复杂度，应明确跳过代码迁移。

该 issue 保持打开，后续会继续按关联 PR 更新迁移状态、风险和计划变化。

[limityan]

?? #991???????????? PR5 ????????

???????

• MiniApp dependency install ??????? MiniAppRuntimeFacade::install_deps ?? app load?runtime port install???? deps runtime state ????
• desktop worker preflight ??? install ?????? MiniAppManager::install_deps_with_runtime ???????? desktop ???? install/state transition ???
• ???????PR5 ???? MiniApp dependency install ????????? Product-Domain concrete runtime ?????

?????worker process?PathManager?host dispatch?builtin asset IO?import/sync/recompile/rollback concrete IO?function-agent Git/AI adapter ? provider acquisition ???????? PR ?????

??????product-domain facade tests?core manager focused test?desktop compile?core boundary check?repo hygiene ? diff check???????????? Tool Runtime ?? owner ??? Feature / Build-Benefit closure?Product-Domain concrete ????????????????????????

[limityan]

???#991 ?????????????/?????????????????? MiniApp dependency install facade ?????? PR ????

?? #991 ?????

• ? Tool Runtime ? deterministic execution admission gate ??? bitfun-agent-tools?
• bitfun-agent-tools ???? tool-call loop history / block message?allowed-list gate?runtime restriction gate?collapsed-tool admission gate?
• bitfun-core tool pipeline ??????????????????????????????????????????registry lookup?input validation?confirmation?????? hook?
• boundary check ?????? core ??????? provider-neutral execution admission gate??????? core ?? collapsed unlock state ???
• ?????????????? Tool Runtime ???

?????

• cargo test -p bitfun-core --features product-full agentic::tools::pipeline::tool_pipeline::tests -- --nocapture
• cargo check -p bitfun-core --features product-full
• cargo test -p bitfun-agent-tools
• node scripts/check-core-boundaries.mjs
• pnpm run check:repo-hygiene
• git diff --check gcwing/main..HEAD

???????????? owner ?????ToolUseContext concrete service handles?product registry materialization?GetToolSpecTool concrete adapter?snapshot wrapper?collapsed unlock persistence??? IO tools?Product-Domain concrete runtime?Feature / Build-Benefit Evaluation?