baa-conductor

BAA_ARTIFACT_CENTER_REQUIREMENTS.md

 1# BAA Artifact Center 与 Delivery Plan Core 需求
 2
 3## 状态
 4
 5- `已完成（T-S032，2026-03-27）`
 6- 优先级：`high`
 7- 记录时间：`2026-03-27`
 8
 9## 关联文档
10
11- [BAA_INSTRUCTION_SYSTEM.md](/Users/george/code/baa-conductor/plans/BAA_INSTRUCTION_SYSTEM.md)
12- [BAA_INSTRUCTION_CENTER_REQUIREMENTS.md](/Users/george/code/baa-conductor/plans/archive/BAA_INSTRUCTION_CENTER_REQUIREMENTS.md)
13- [06-integration-with-current-baa-conductor.md](/Users/george/code/baa-conductor/docs/baa-instruction-system-v5/docs/06-integration-with-current-baa-conductor.md)
14- [07-rollout-plan.md](/Users/george/code/baa-conductor/docs/baa-instruction-system-v5/docs/07-rollout-plan.md)
15
16## 背景
17
18当前 repo 已经具备：
19
20- `instructions/` Phase 1 最小执行闭环
21- `browser.final_message` raw relay
22
23但在立项前，执行结果仍停留在“直接返回原始结果摘要”的阶段，缺少 v5 明确要求的：
24
25- artifact materialization
26- manifest / index text
27- delivery plan
28
29如果不把这层建起来，后续大结果、并发多结果和薄插件上传/注入都没有稳定交付模型。
30
31## 核心结论
32
33- artifact center 应放在 conductor，不放在插件
34- 首版先完成 service-side core：
35  - artifact materializer
36  - manifest builder
37  - delivery plan builder
38- 首版允许完全用 synthetic execution result / fixture 驱动，不阻塞于 live browser final message 接线
39- 插件上传 / 下载 / 注入执行可留到后续任务，不强行并进本张卡
40
41## 首版范围
42
43- `apps/conductor-daemon/src/artifacts/` 新模块
44- 执行结果到 artifact 的转换规则
45- manifest / index text 生成
46- delivery plan 数据结构与最小生成逻辑
47- 自动化测试与文档回写
48
49## 当前落地摘要
50
51- `apps/conductor-daemon/src/artifacts/` 已新增：
52  - `types.ts`
53  - `materialize.ts`
54  - `manifest.ts`
55  - `delivery-plan.ts`
56- 当前最小支持结果类型：
57  - `exec`
58  - `files/read`
59  - `files/write`
60  - `describe` / `describe/business` / `describe/control`
61  - `status`
62- synthetic execution result 已补自动化覆盖：
63  - `exec` 产出 artifact + manifest + delivery plan
64  - `files/read` 小结果 / 大结果有不同 delivery 策略
65  - 多结果排序稳定，缺少可选字段不会让整批 materialize 崩掉
66- 后续 `T-S034` 已补齐：
67  - Firefox 插件最小 upload 执行
68  - upload receipt barrier
69  - 浏览器侧 inject / send 主链
70
71## 建议最小支持的结果类型
72
73- `exec` 的 stdout / stderr 文本
74- `files/read` 的文本内容
75- `files/write` / `describe` / `status` 的结构化摘要
76
77## 当前明确不要求
78
79- 不要求这张卡里实现 Firefox 插件 upload / download
80- 不要求这张卡里实现 receipt barrier
81- 不要求这张卡里完成自动注入 / 自动发送
82- 不要求这张卡里接多节点 / 逻辑 target / 任务池
83
84## 验收条件
85
86- synthetic execution results 能稳定 materialize 为 artifacts
87- manifest 和 index text 稳定、可审计
88- delivery plan 结构可稳定生成，且对大结果不会退化成整段直接塞聊天
89- 文档已同步到 `plans/`、`tasks/` 和必要的 `docs/baa-instruction-system-v5/`
90
91## 当前预期残余边界
92
93- 首版 delivery plan 与交付当前仍面向单节点、本地 `download_url` 和单客户端单轮场景
94- artifact payload 当前通过本地 `download_url` 以 base64 JSON 形式提供，适合当前 text/json 类产物；大二进制和 download 闭环还没做
95- execution journal 只保留最近窗口，不扩成无限历史审计
96- 当前 live instruction ingest 路径已经把执行结果接到 artifact / upload / inject / send，但仍只覆盖 Phase 1 精确 target，不扩到跨节点或完整 task/run 编排