Skip to content

[Clear Room][CR-10] 汇总跨仓迁移指南并建立命名与依赖发布门禁 #185

Closed

Description

@Aias00

当前架构决策:Workflow 独立执行,Graph 抽离为 Loop

用户已确认:Workflow 通过定义创建并独立执行,不依赖 Graph/Loop;非 Workflow Agent 同样独立执行。原 Graph 抽离为独立能力并命名为 Loop,通用身份、预算、运行管理和共享契约不因抽离而成为 Loop 专属。

本节替代早期“Graph 承载 Workflow”或“Graph 名称整体保留”的架构假设;历史路径和类名仍作为问题证据。

设计约束:以收益决定变更,破坏性变更需逐项论证

用户明确:技术独立是目标,改动幅度和破坏性不是目标。合理的现有概念、API、模块和实现可以保留;不能因为来自上游就要求删除、重命名或重写。新 API 包装旧引擎若只是表面换名不能证明技术独立,但也不以“零旧代码”作为验收指标。

每项破坏性变更在实施前必须完成以下决策记录:

  • 具体问题:现状如何影响职责、正确性、扩展性、依赖隔离或使用体验,附代码/用例/测试证据。
  • 方案比较:至少比较保留现状或兼容演进与破坏性调整,说明为何较小改动不足以解决问题。
  • 收益与成本:列出预期收益、受影响 API/消费者/配置/数据/观测、迁移工作量及回归风险;只有收益足以覆盖成本才采用破坏性方案。
  • 迁移与验证:明确目标版本、旧→新映射、升级步骤、必要的兼容期限或不兼容理由、回滚条件及有意义的行为验收。
  • 评审结论:记录采用、保留或推迟及理由;未形成结论前不实施对应破坏性调整。

不为追求与上游形式不同而修改成熟设计,不机械加前缀、迁包、拆模块或替换行业通用术语。技术独立通过自主架构决策、清晰契约、可控依赖和独立演进能力评估;重写仅用于解决已证实且值得付出迁移成本的问题。

本节是后续明确的约束;若下文历史规划含有无条件重写、删除旧路径或仅因上游来源而替换的表述,按本节执行并在设计阶段修订。

目标升级

本任务纳入 ARGI 独立架构与实现重设计:#186 。原有名称与路径仅为现状证据,不要求沿用旧模块或 API。最终验收增加:仅用新 API 的独立应用、旧类型/旧运行时依赖扫描、旧实现删除或有期限的退场清单;命名扫描不能代替技术独立验证。

总览:#180

本任务负责两仓发布收口,各实施任务负责自己的功能回归和局部迁移说明。

交付与验收:

  • 汇总最终保留/改名清单、FQCN/artifact/配置/数据/观测旧→新映射、目标版本与升级顺序。
  • 建立历史自有标识防新增扫描;第三方 SDK、历史 wire 标识、来源与版权记录具有明确理由的例外。
  • 复用中立 API 消费者及生产依赖隔离门禁;验证 Core 与 Extensions BOM/Starter 的组合消费构建。
  • 汇总旧数据 fixture 回归及受影响模块检查结果,明确任何未执行的外部环境验证。
  • 对 examples/website 的受影响路径创建明确后续跟踪并回链;未经处理的发布阻断项不能视为完成。
  • 两张总览中的设计和实施决策均可追溯,候选保留也有明确结论。

门禁设计可在 CR-01 后开始,最终验收等待其余实施任务完成。仅在两仓内实施本任务改动,其他仓库的内容修改由各自跟踪单承担。

依赖与执行边界

本系列的 Clear Room 指从当前职责和行为契约出发设计。目标名称以评审结论为准;允许有证据地保留现状。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions