Repository navigation
Description
当前架构决策:Workflow 独立执行,Graph 抽离为 Loop
用户已确认:Workflow 通过定义创建并独立执行,不依赖 Graph/Loop;非 Workflow Agent 同样独立执行。原 Graph 抽离为独立能力并命名为 Loop,通用身份、预算、运行管理和共享契约不因抽离而成为 Loop 专属。
- Workflow 定义、解析、执行与 Workflow Agent:[Architecture][CR-14] 基于声明式定义独立实现 Workflow 与 Workflow Agent,解耦 Graph/Loop #197。
- Loop 独立能力与命名/依赖迁移:[Architecture][CR-15] 将 Graph 抽离为独立 Loop 能力并完成命名与依赖迁移 #198 。
- Loop 保留图执行语义;它与 Workflow 循环步骤、LoopAgent 和 ReAct 内部循环必须区分。公共类、包、坐标及数据字段按映射迁移,不做无差别替换。
- 可选桥接由 Loop 集成侧依赖中立 Agent 契约;Workflow 不以 Loop 为默认后端。破坏性变更仍逐项论证,历史数据遵守 [Design][CR-02/OPT-05] 明确 checkpoint 协议、类型解耦与历史数据迁移契约 #182。
本节替代早期“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][CR-03] 按领域职责调整图状态与运行编译配置命名 #183
- [Clear Room][CR-04] 梳理 Agent、Studio 与 serializer 包边界并实施获批迁移 #184
- [Clear Room][CR-05] 统一 MCP 注册职责与 registry、registrar、registration 命名 argi-extensions#31
- [Clear Room][CR-06] 分清通用工具观测与 ARMS 适配并统一框架标识 argi-extensions#32
- [Clear Room][CR-07] 明确 Nacos Prompt 配置类命名并校验装配兼容 argi-extensions#33
- [Clear Room][CR-08] 统一聊天记忆契约与存储适配的包层级 argi-extensions#34
- [Clear Room][CR-09] 评估并明确 Document 与 Rerank 契约模块边界 argi-extensions#35
本系列的 Clear Room 指从当前职责和行为契约出发设计。目标名称以评审结论为准;允许有证据地保留现状。
Activity