搜索文档

浏览 Awaken Workforce 文档
Docs/Awaken Workforcev0.1.0/内部机制/贡献与扩展贡献与扩展 Awaken Workforce
提示·你正在阅读发布前文档(v0.1.0)。接口与行为在稳定发布前仍可能变化。

内部机制 · 贡献与扩展

贡献与扩展 Awaken Workforce

本页内容

选择权威 bounded context,复用既有端口,并保持 Workforce 可机械验证的不变量。

扩展 Awaken Workforce 时,应修改行为的唯一权威所有者。不要建立第二套 Resource、Workflow、 Agent、event append、authorization 或执行机制。

静态所有权

变更权威所有者扩展接缝
领域规则或对象purpose-named domain crate该 context 拥有的 command/repository port 与 fact
Lease、wake、provision、execution、egressruntime crate窄机制端口
Persistence、IAM、MCP、Pack distributionadapter crate领域定义的端口或 ACL
HTTP、进程拓扑、backend selectionapp crate对下层组件的装配
Agent 执行Awaken,通过 awaken-flow-runtime唯一 Runtime ACL,不能增加并行 executor

依赖向下:lib → domain → runtime → adapter → app。App 可以组合下层;下层不能从上层 引入产品、传输或持久化词汇。

变更流程

  1. 阅读源码仓的 architecture overview、invariant registry 与该需求的 coverage owner。
  2. 搜索代码、测试、public API snapshot 和 ADR,确认是否已有机制。
  3. 扩展权威实现并迁移全部 caller;继续之前先移除竞争路径。
  4. 只有出现争议选择、跨 crate 影响或不变量影响时才新增或修订 ADR。
  5. 每条新 guardrail 都要命名 enforcer 与 validation。
  6. 有意改变公共 API 时同步更新 public API snapshot。
  7. 运行 scripts/ci/check-docs.shscripts/ci/check-all.sh

动态写入路径

flowchart TD
  Command[已授权 command] --> Validate[Owner 校验 expected version]
  Validate --> Stage[Unit of work 暂存 owner facts]
  Stage --> Commit[唯一 append mechanism 提交]
  Commit --> Replay[Projection 重放已提交事实]
  Replay --> Reaction[Runtime reaction 可以调度工作]
  Reaction --> Effect[Adapter 执行 lease-fenced 外部副作用]

提交前失败不会产生部分领域真相。Live effect 按机制使用 lease、idempotency、 reconciliation 或 checkpoint;retry 不能发明第二次业务决策。

架构与词汇Workforce–Awaken 执行所有权测试 Domain Pack开始。源码仓 ADR 与 invariant registry 仍是设计权威;本页只是贡献入口,不复制架构语料。