RFC-0002: Action Bus 治理边界与生命周期审计¶
摘要 (Summary)¶
把现有「SuggestedAction → AuthorizedAction → executor」的隐式管线,收敛为一个显式的动作治理状态机:模型的不可信 SuggestedAction 在边界处被 core 包装为治理 envelope ActionProposal,经本地 schema / 策略校验后,由 aios-core 状态机唯一构造出可执行的 AuthorizedAction(私有字段、不可跨 crate 伪造),每一步状态迁移都落一条带确定性坐标 ActionCoord 的 AuditRecord,且每个动作必有且仅有一个终态审计。落地范围对应 issue #4(类型治理边界)、#5(生命周期 + 终态审计覆盖)、#8(OfflineAdapter 执行闭环)。务实 P0:Capability 拒绝是真实终态;Budget/调度机制、privacy 终态当前无可实现支撑,故不引入对应 variant(已在「范围与 issue 验收对齐」声明)。
动机 (Motivation)¶
当前实现已能跑通最小闭环,但存在三个结构性缺口(对照 Action_Bus_设计参考 与 DiPECS参考建议):
- 治理边界靠约定而非类型。
AuthorizedAction只是SuggestedAction的包装,二者可隐式互转;没有类型层面阻止「planner 输出直接进 adapter」的路径(#4)。 - 没有可回放的生命周期。窗口处理只产出聚合的 trace JSON,单个 action 从 proposed 到终态的状态迁移不可见,也没有「每个动作必有唯一终态审计」的保证(#5)。
- 执行层是直连 stub。
DefaultActionExecutor直接tracing::info!,没有一个纯离线、确定性、可单测、能被 replay 锁定的 adapter 抽象(#8)。
这三点正是设计文档所谓「syscall governance layer」的最小内核。补上之后,aios-cli replay 的每一条动作都会有完整、确定的审计轨迹——项目从「愿景」变「可证明的 runtime 原型」。
设计评估 (Evaluation)¶
- 不推倒现有管线。
PrivacyAirGap/DecisionRouter/PolicyEngine/ 窗口聚合都保留,新状态机包住PolicyEngine,而不是替换它。 - 不破坏 golden trace。现有
ReplayResult三层校验(脱敏/策略/执行)语义不变;新增的AuditRecord流是叠加的可观测层,golden hash 的输入按需扩展而非重定义。 - 贴合真实的 5 个 action 类型。不强行套用文档里 11 种
ActionType的宏大枚举;EffectClass按现有动作的真实副作用分级。 - 务实裁剪,但区分「裁实现」与「裁验收」。Capability 检查已是真实路径(
PolicyEngine已有RiskExceedsCapability/ActionCapabilityDenied),故DeniedByCapability是真实可达终态。Budget 在现有代码中无任何机制,故ActionState不引入DeniedByBudgetvariant(不留不可达死代码)——这一裁剪会改动 issue #5 的验收勾选,已在「范围与 issue 验收对齐」一节显式声明并同步 issue,不悄悄缩范围。
抽象边界取舍原则 (Abstraction Boundary Principle)¶
本 RFC 不追求「一次设计到位」,也不是「能跑就行」。两者都是伪命题。真正的判据只有一条:
某个抽象如果做错,纠正的代价有多大?
据此把抽象分两类,区别对待:
现在就钉死(错了会「拔不出来」)¶
渗透进每一个调用点、一旦长歪事后极难回收的抽象。本 RFC 只有两个:
- 类型治理边界(
ActionProposalvsAuthorizedAction)。它是项目的核心论点「模型只提议、本地才授权」。一旦放任「建议直接进 executor」的代码路径出现,后续每个调用方都会复制这条捷径,再回头收紧就是全仓手术。 - 生命周期 + 终态审计骨架(
ActionState/AuditRecord)。「每个动作恰好一条终态审计」这条不变量必须从第一行代码就成立,否则审计是补不全的——漏掉的迁移无法事后重建。
现在留口、不实现(错了只是「局部返工」)¶
挂在状态机中间的叶子能力,未来插入不影响既有调用方:
- Budget / Scheduler:本 RFC 不引入对应
ActionStatevariant,只在设计上留扩展点(注意:Capability 不在此列——它在PolicyEngine中已是真实实现路径,对应DeniedByCapability真实终态,详见 §2.1)。 - 理由:现有动作集仅 5 种、全是本地低风险动作,撑不起租约/调度评分这类机制。在信息最少时设计它们,第一版几乎必错;等真实负载(高风险动作、真机 adapter)出现再做,代价是局部插桩,而非重构。
一句话标尺:拔不出来的抽象现在做对,拔得出来的抽象等需求来了再做。 后续 PR 评审遇到「要不要现在就抽象 X」时,用这把尺子量。
设计方案 (Design)¶
1. 类型治理边界(issue #4,aios-spec + aios-core)¶
核心原则:不可信输入与可执行动作是两个不能隐式互转的类型,且「不可伪造」必须由编译器跨 crate 强制,而非靠约定。
1.1 类型归属(解决「私有字段又要跨 crate 构造」的矛盾)¶
reviewer 指出的硬伤:若 AuthorizedAction 留在 aios-spec 且字段私有,aios-core 反而无法构造它;若字段 pub,任何 crate 都能 struct-literal 手搓,不可伪造性失效。结论是构造器必须和类型同处一个 crate,所以按「谁是唯一生产者,类型就放谁那」重新归属:
ActionProposal(不可信侧)+ 所有协议数据类型(EffectClass/ActionState/AuditRecord/ActionOutcome/AdapterError)→ 留在aios-spec,是协议单一真相。AuthorizedAction(可执行侧)→ 从aios-spec移到aios-core::governance,字段私有,唯一构造器pub(crate),只能被同 crate 的ActionLifecycle在策略通过后调用。ActionAdaptertrait 跟随AuthorizedAction也定义在能看到该类型的层;aios-action新增对aios-core的依赖(core不依赖action,无环),其 adapter 只能接收 core 递来的AuthorizedAction,无法自行构造。
这是对「
aios-spec是协议唯一真相」的有意偏离:不可伪造性是一条逻辑不变量,必须和产生它的逻辑(状态机)放在一起才能由编译器保证。spec 仍持有全部线缆类型(proposal/audit/outcome);移走的只有那个「凭证」类型本身。替代方案(spec 内 sealed-trait + 见证 token)能把类型留在 spec,但构造器仍得在 core,徒增样板,见替代方案 D。
// aios-spec —— 不可信侧治理 envelope。core 在边界处为不可信的 SuggestedAction
// 建立(填入确定性 coord + 推导 effect);裹的 action 字段本身不可信。全 pub、可反序列化。
pub struct ActionProposal {
pub intent_id: String, // runtime 关联用(含随机 UUID),不进 canonical hash
pub coord: ActionCoord, // 确定性坐标,进 canonical hash(见 §2.4)
pub action: SuggestedAction, // 现有类型,不动
pub effect: EffectClass, // 由 core 可信侧推导填入(见 §1.2),非外部输入
pub proposed_at_ms: i64,
}
// 确定性动作坐标:不含 UUID/wall-clock,纯位置量,单次 run 内唯一且 replay 间稳定。
pub struct ActionCoord {
pub window_ordinal: u32, // 窗口在 replay 序列中的确定性序号(跨窗口去碰撞)
pub intent_ordinal: u32, // intent 在 batch.intents 中的下标
pub action_ordinal: u32, // action 在 intent.suggested_actions 中的下标
}
// aios-core::governance —— 可执行侧。字段私有,唯一构造路径是状态机。
pub struct AuthorizedAction {
intent_id: String, // runtime 关联(volatile)
coord: ActionCoord, // 确定性坐标
action: SuggestedAction,
effect: EffectClass,
authorized_at_ms: i64,
}
impl AuthorizedAction {
// pub(crate):仅 ActionLifecycle 在 PolicyChecked 后可调用,外部 crate 无法手搓。
pub(crate) fn seal(proposal: &ActionProposal, authorized_at_ms: i64) -> Self { /* ... */ }
// 只读 getter 对外暴露,adapter 据此执行;但无法反向构造。
pub fn action(&self) -> &SuggestedAction { &self.action }
pub fn effect(&self) -> EffectClass { self.effect }
pub fn coord(&self) -> ActionCoord { self.coord }
}
AuthorizedAction不实现Deserialize——否则任何 crate 反序列化即可绕过状态机伪造一个可执行动作。Android bridge 仍可Serialize它发往手机(只读方向安全),但不能Deserialize反向构造,见风险节。- adapter 侧只拿到
&AuthorizedAction、只能调 getter;aios-action无pub构造器可用 → 「planner 输出直接进 adapter」在类型层不可表达。
1.2 effect 由可信侧推导¶
effect 不是 proposal 的「输入字段」而是 core 在建 proposal 时按 action_type 计算的派生量(reviewer 第 2 点)。EffectClass(按现有 5 个动作的真实副作用分级,不照搬文档 6 级):
| ActionType | EffectClass |
|---|---|
NoOp | PureRead |
PrefetchFile | LocalCacheWrite |
PreWarmProcess / KeepAlive / ReleaseMemory | LocalStateChange |
KeepAlive归LocalStateChange:它改变进程存活与资源占用,副作用强于单纯缓存写(采纳 reviewer 建议)。- schema 校验拒绝:缺失必需 target(
PreWarmProcess)、未知 action type(serde 天然拒绝)、risk/effect 非法组合(如PureRead配High)。 RiskLevel维持现有三级(Low/Medium/High),不加Critical——现有动作集没有特权动作,加了是死代码。
2. 生命周期状态机与终态审计(issue #5,aios-spec + aios-core)¶
2.1 状态枚举(精简版,9 态)¶
按 DiPECS 真实管线裁剪文档的 18 态。只保留当前可达的状态,不引入任何不可达的死 variant(budget/调度类终态延后到机制存在时的后续 RFC;privacy 终态延后到 typed target 存在时,见下):
pub enum ActionState {
// 正常路径
Proposed,
SchemaValidated,
PolicyChecked,
Dispatched,
Succeeded, // 终态
// 拒绝/失败终态(均当前可达)
RejectedInvalidSchema, // 终态
DeniedByCapability, // 终态:PolicyEngine 的 RiskExceedsCapability/ActionCapabilityDenied
DeniedByPolicy, // 终态:风险超配置 / 置信度过低 / target 不在上下文
Failed, // 终态:adapter Err
}
裁剪与保留的依据(回应 reviewer 第 5 点,逐项对齐 issue #5 状态建议):
- 保留
DeniedByCapability:现有PolicyEngine已有RiskExceedsCapability/ActionCapabilityDenied,是真实可达的拒绝路径,必须有独立终态,不能并进DeniedByPolicy。 - 去掉
RedactionChecked/RejectedPrivacyViolation(reviewer 第 4 轮第 3 点):当前没有可实现的 privacy predicate。SuggestedAction.target是裸Option<String>,不携带来源/脱敏证明;PrivacyAirGap原样保留 package name(privacy_airgap.rs:144-158,189-204);唯一相关检查是 target 是否在KnownTargets中,失败已归TargetNotInContext/DeniedByPolicy(policy_engine.rs:262-293)。无法区分「未脱敏 target」与「合法但不在上下文的字符串」,故该终态当前不可测。移出本 RFC,留在 issue #5,待引入 typedResourceTarget+ provenance/opaque sanitized ID 后的后续 RFC 再做。 - 去掉
Running:OfflineAdapter 的execute是同步纯函数,Dispatched → Succeeded/Failed之间无可观测的运行态。 DeniedByBudget/BudgetReserved/Scheduled:现有代码无任何 budget/调度机制,故本 RFC 的ActionState枚举不引入这些 variant(避免不可达的死 variant)——预算/调度终态留给「机制存在时的后续 RFC」。这一项使 issue #5「预算拒绝有对应终态」暂不勾选,已在「范围与 issue 验收对齐」声明。- 去掉
Retrying/RolledBack/Expired/Cancelled:无重试/回滚/超时/取消语义,纯死代码。
2.2 状态机:ActionLifecycle(core 新模块 action_lifecycle.rs)¶
这是唯一的 Action Bus 内核,内部持有并调用 PolicyEngine——不是「PolicyEngine 之后再过一遍」(消除 reviewer 第 3 点的双管线/重复执行)。输入是现有 PolicyEngine 真实需要的整批上下文,而非裸 proposal;window_ordinal 由调用方显式传入(reviewer 第 4 轮第 2 点),不靠 &self 内部计数器:
impl ActionLifecycle {
// 唯一入口。batch/capability/ctx 与现有 PolicyEngine.evaluate_batch_with_context
// 对齐;window_ordinal 由调用方(replay/daemon 驱动循环)显式传入,
// 状态机保持纯函数、无隐藏可变状态。
pub fn run(
&self, // 内部持有 &PolicyEngine 与 &dyn ActionAdapter(不可变)
window_ordinal: u32, // 驱动循环按窗口处理顺序赋号,组装 ActionCoord
batch: &IntentBatch,
capability: &CapabilityLevel,
ctx: &StructuredContext,
) -> Vec<AuditRecord> { /* 每个 (intent, ordinal, suggested_action) 产出恰好一条 */ }
}
coord的唯一性范围:ActionCoord只在单次 replay/run(即一段连续的窗口序列)内全局唯一,是 canonical replay 坐标,不是跨进程的运行时全局主键。window_ordinal由该次 run 的驱动循环从 0 单调赋号——同一条 trace 重放永远得到同一串坐标(确定性)。- 不把 canonical coord 当运行时全局 ID:daemon 的 append-only runtime trace 跨进程重启会从 0 重置
window_ordinal。若后续需要「跨重启唯一」的运行时标识,另加 volatilesession_id/runtime_action_id(含启动随机量),与intent_id同列入VOLATILE_KEYS剥离、不进 hash——绝不污染 canonical replay 坐标。
每条 (intent, ordinal, suggested_action) 在边界处被 core 炸开为一个 ActionProposal(生成确定性坐标、推导 effect),然后单独走状态机:
SuggestedAction (来自 Intent.suggested_actions[ordinal])
→ core 建 ActionProposal (坐标 = (window_ordinal, intent_ordinal, action_ordinal), 推导 effect)
→ Proposed
→ SchemaValidated (validate: target/effect/risk 组合) ─┬─ 失败 → RejectedInvalidSchema (终态)
→ PolicyChecked (消费 PolicyActionDecision) ─┼─ 能力不足 → DeniedByCapability (终态)
─┼─ 其他拒绝 → DeniedByPolicy (终态)
→ AuthorizedAction::seal(...) ← 唯一构造点(只有 lifecycle,不是 PolicyEngine)
→ Dispatched (交给唯一的 dispatch 抽象 ActionAdapter)
→ Succeeded (终态) └─ adapter Err → Failed (终态)
privacy 终态(
RedactionChecked/RejectedPrivacyViolation)已移出本 RFC,理由见 §2.1——当前无可实现的 privacy predicate,留待 typedResourceTarget引入后的后续 RFC。
- 唯一 dispatch 抽象:
ActionLifecycle持有一个&dyn ActionAdapter。DefaultActionExecutor(含 Android bridge)和OfflineAdapter都实现这同一个 trait,运行时二选一注入。一个AuthorizedAction只会被 dispatch 一次,不存在「旧 executor 路径 + 新状态机」并行重复执行——旧的ActionExecutor::execute直连路径在 daemon/cli 中被状态机取代。
2.2.1 PolicyEngine 契约改造:从「构造授权」到「逐 action 裁决」¶
reviewer 第 2 轮第 2 点:现状 PolicyEngine.evaluate_* 返回 Vec<AuthorizedAction>(即 PolicyEngine 自己在构造授权凭证),与「lifecycle 唯一 seal」直接冲突;且 PolicyDecision.action_denials: Vec<DenialReason> 无 ordinal,混合通过/拒绝时拒绝原因无法映射回具体 action,「每 proposal 一条正确终态」不成立。
改造(落到 aios-core::policy_engine):
// PolicyEngine 不再产出 AuthorizedAction,只产出逐 action 的裁决。
pub struct PolicyActionDecision {
pub intent_ordinal: u32,
pub action_ordinal: u32,
pub verdict: PolicyVerdict, // Approved | Denied(DenialReason)
}
// intent 级拒绝(risk/confidence/capability 不满足)展开为该 intent
// 每个 action_ordinal 各一条 Denied,verdict 携带对应 DenialReason。
PolicyEngine的职责收敛为「裁决」:遍历intent.suggested_actions时带 enumerate 下标,每条产出一个PolicyActionDecision,approve/deny 都带(intent_ordinal, action_ordinal)。PolicyActionDecision只承载 batch 内的二元下标;window_ordinal不在 PolicyEngine 视野内,由ActionLifecycle在窗口边界用驱动循环的窗口序号补齐,组装成完整三元ActionCoord(见 §2.4)。AuthorizedAction的构造从policy_engine.rs移除;唯一seal点是ActionLifecycle在消费到verdict == Approved的 proposal 时。这样「谁授权」与「谁裁决」分离:PolicyEngine 裁决、lifecycle 授权。action_denials: Vec<DenialReason>(无 ordinal)被Vec<PolicyActionDecision>取代;现有PolicyDecision的调用方(daemon/cli/测试)随之改。risk/confidence 仍读自Intent,不进 proposal。
2.3 审计记录与强制规则¶
pub struct AuditRecord {
pub coord: ActionCoord, // 确定性主键 (window_ordinal, intent_ordinal, action_ordinal),进 hash,见 §2.4
pub intent_id: String, // 运行时关联(volatile:含 UUID,canonical 投影剥离,不进 hash)
pub action_type: ActionType,
pub target: Option<String>,
pub effect: EffectClass,
pub transitions: Vec<ActionState>, // 完整迁移序列
pub terminal: ActionState, // 终态 (冗余但便于查询/golden)
pub outcome: Option<ActionOutcomeSummary>, // 成功时写入 adapter outcome 的确定性摘要,进 hash(见下)
pub denial_reason: Option<DenialReason>, // 复用现有枚举
pub error: Option<String>,
}
outcome字段(reviewer 第 6 轮第 1 点):ActionAdapter::execute返回ActionOutcome,但若审计只记(coord, terminal, transitions),两次都Succeeded但模拟结果不同时审计与 hash 完全看不出来,违反 issue #8 的「执行结果可写入 audit log」「replay outcome 稳定」。故成功路径把 adapter outcome 投影为确定性ActionOutcomeSummary(不含 wall-clock/随机)写入outcome,并纳入audit_hash;失败路径outcome=None、信息走error。
强制不变量(用单测 + 终态覆盖测试钉死):
- 每个
ActionProposal(即每个coord)产出恰好一条AuditRecord,且terminal必为终态之一。 - 成功路径记录完整迁移序列
[Proposed, …, Succeeded],且outcome为Some(确定性摘要)。 - 四类终态(schema / capability / policy / failed)各有对应记录,互不混淆(privacy 终态延后,见 §2.1)。
- 全程不 panic:所有错误走结构化
LifecycleError/DenialReason/AdapterError。 - outcome 确定性:重复 replay 同一 trace,
outcome逐字段相等;outcome 内容漂移必然改变audit_hash(新增回归测试钉死)。
2.4 稳定动作标识:确定性 ActionCoord vs 运行时 intent_id¶
reviewer 第 2 轮第 1 点:一条 Intent 可含多条甚至重复的 suggested action,需稳定标识证明「每个 proposal 恰好一条终态审计」;但不能把随机 intent_id(Uuid::new_v4())嵌进主键再纳入 hash——现有 canonical audit 正是靠按 key 剥离 intent_id 才保证三次回放 hash 一致,UUID 一旦进 hash 即回归。reviewer 第 3 轮第 1 点:(intent_ordinal, action_ordinal) 只在单个 batch 内唯一,replay 跨多个窗口时第二个窗口的 (0,0) 会与第一个碰撞,主键失效。
方案:运行时标识与 canonical 标识分离,且坐标含窗口序号保证全局唯一。
- canonical 主键
coord: ActionCoord = (window_ordinal, intent_ordinal, action_ordinal):窗口在 replay 序列中的确定性序号 + intent 在batch.intents中的下标 + action 在intent.suggested_actions中的下标。window_ordinal由 replay 驱动循环按窗口处理顺序单调赋号(确定性、无 wall-clock、无 UUID),跨窗口全局唯一,重复 action 也能区分。它是AuditRecord的主键,纳入audit_hash。 - 运行时关联
intent_id: String:仍保留在AuditRecord里供日志/调试关联真实 intent,但它含 UUID,属 volatile——canonicalize把intent_id加入VOLATILE_KEYS一并剥离,不进 hash(与现有event_id/window_id同等处理)。 coord贯穿ActionProposal→AuthorizedAction→ActionOutcome→AuditRecord。- 「恰好一条终态审计」的测试按
coord分组断言:每个 coord 出现且仅出现一次、且为终态。测试场景必须含至少两个窗口、且两窗口出现重复(intent_ordinal, action_ordinal),证明window_ordinal消除碰撞、全局主键成立。 - 新增确定性回归:扩展现有
audit_hash_is_stable_across_repeated_runs,断言「三次相同 replay 的 action audit hash 完全一致」,钉死 UUID 不泄漏进 hash。
3. OfflineAdapter 执行闭环(issue #8,aios-action)¶
新增一个纯离线、确定性的 adapter。它与现有 DefaultActionExecutor(含 Android bridge)实现同一个 ActionAdapter dispatch trait,运行时二选一注入状态机——这就是 §2.2 说的「唯一 dispatch 抽象」,两条执行路径收敛于此,不并行。
// 定义在能看到私有 AuthorizedAction 的层(随 AuthorizedAction,见 §1.1)。
pub trait ActionAdapter {
fn name(&self) -> &'static str;
fn execute(&self, authorized: &AuthorizedAction) -> Result<ActionOutcome, AdapterError>;
}
pub struct OfflineAdapter { /* Arc<Mutex<SimulatedState>> */ }
// DefaultActionExecutor 改为 impl 同一个 trait,复用现有 Android bridge 转发逻辑。
- 支持动作(映射到现有 5 类 + 模拟语义):
NoOp、PreWarmProcess→SimulatePrewarm、PrefetchFile→SimulateCache、KeepAlive、ReleaseMemory。ActionType是封闭 5-variant 枚举,OfflineAdapter 完整覆盖全部 variant。 - 不访问真实系统 / 网络 / Android;输出 deterministic
ActionOutcome(不含 wall-clock、不含随机 latency——latency 由上层注入或固定 0)。 - 非法/未知动作归 schema 阶段,不设
AdapterError::Unsupported(reviewer 第 6 轮第 2 点):ActionType封闭且 adapter 全覆盖,安全 Rust 中「adapter 收到不认识的 variant」不可达,留Unsupported是测不到的死路径。未知action_type(如反序列化到不存在的字符串)在更早的 schema/反序列化阶段就失败,归RejectedInvalidSchema(已有可达终态)。AdapterError仍保留,但只表达真实执行失败(模拟资源不可用等)→ 状态机落Failed。 - adapter 失败 → 状态机落
Failed终态,窗口继续处理后续动作。
范围与 issue 验收对齐(回应 reviewer 第 5 点)¶
本 RFC 有意调整了 issue 的部分验收范围,在此显式声明哪些会被关闭、哪些延后,不悄悄缩范围:
- issue #4:全部验收项本 RFC 覆盖(类型分离、adapter 只收
AuthorizedAction、schema 拒绝、serde roundtrip、非法 action 测试)。其中「ResourceBudget、带副作用 action 的 budget」降级为字段占位不校验——需在 issue #4 补注说明。可关闭(带范围注记)。 - issue #5:覆盖 schema/capability/policy/failed 四类终态 + 「恰好一条终态审计」+ 不 panic。不覆盖:(a)「隐私违规有对应终态」——当前无可实现的 privacy predicate(
target是裸String,无来源/脱敏证明),RejectedPrivacyViolation延后到 typedResourceTarget引入后的后续 RFC;(b)「预算拒绝有对应终态」(ActionState不引入DeniedByBudget)与Scheduled/BudgetReserved/Expired/Cancelled(均无机制支撑)。→ 在 issue #5 勾掉已完成项,对未做项注明承接的后续 RFC,该 issue 不由本 PR 完全关闭。 - issue #8:验收项覆盖,但「unsupported action 有明确错误类型」一项改判(reviewer 第 6 轮第 2 点):
ActionType封闭、adapter 全覆盖,adapter 级Unsupported不可达。该验收重释为「非法/未知action_type在 schema/反序列化阶段被拒,归RejectedInvalidSchema」——语义等价(非法动作不会被执行),且可测。需在 issue #8 补注此重释。「执行结果可写入 audit log / replay outcome 稳定」由新增AuditRecord.outcome+ 纳入 hash 满足。可关闭(带此重释注记)。
准则:裁实现可以,裁验收必须留痕。任何被本 RFC 推迟的验收项,都会在对应 issue 上注明,并指向承接它的未来工作,避免「RFC 宣称覆盖、issue 却没人关」的悬空。
4. 集成点¶
- daemon
pipeline.rs:process_window不再「先 PolicyEngine 再 executor」两段式。改为构造一个ActionLifecycle(注入PolicyEngine+ 选定的ActionAdapter),对每个窗口调用lifecycle.run(window_ordinal, batch, capability, ctx)一次(window_ordinal由处理循环单调赋号),拿回Vec<AuditRecord>写入 runtime trace JSON(新增"audit"字段)。策略检查与 dispatch 都在 lifecycle 内部,只发生一次。跨进程重启window_ordinal从 0 重置——这是 canonical replay 坐标的预期语义,跨重启唯一性若需要由 volatilesession_id承担(§2.2)。 - cli
replay:注入OfflineAdapter作为ActionAdapter,同样按 replay 窗口序列调lifecycle.run(window_ordinal, ...)收集AuditRecord;summary 新增Audit records计数;audit_hash输入扩展为包含按coord排序的(coord, terminal, transitions, outcome)(确定性来源:state machine 纯函数 + OfflineAdapter 的确定性 outcome;intent_id经VOLATILE_KEYS剥离不进 hash)。 - 取代而非并存:旧的「
PolicyEngine.evaluate_*→DefaultActionExecutor::execute」直连调用在 daemon/cli 中被ActionLifecycle取代。DefaultActionExecutor不删,但改为impl ActionAdapter后由 lifecycle 统一驱动,避免两条路径重复执行同一动作。 - 收束 seal 旁路(务实信任边界)(reviewer 第 3–5 轮):起点是 CLI
SendAuthorizedAction和 Android socket/UI 能把任意带auth_token的 JSON 直接交给dispatchAuthorizedActionJson执行(AuthorizedActionSocketServer.kt:145-172、MainActivity.kt:365-399)。信任模型(P0):auth_token认证「调用方可信」;持有本机 socket token 的本地操作者纳入 P0 信任边界——不追求跨进程「payload 经 lifecycle seal」的强防伪(HMAC/签名/nonce 对原型是过度防御,已与 reviewer 达成一致)。在此前提下收束而非全封: - 常规管线唯一经 lifecycle:daemon/CLI 的正常动作路径只经
ActionLifecycle→DefaultActionExecutor(impl ActionAdapter,内部把AuthorizedAction序列化经 socket 转发)。release 保留 socket 的dispatchAuthorizedActionJson接收入口——它正是合法 bridge 的落点,不能 gate 掉(这是上一轮自相矛盾处:gate 掉它会同时切断生产 bridge)。 - CLI raw-send 改诊断:
SendAuthorizedAction改为 ping/health-check(独立消息类型,socket 端不 dispatch 动作),android_bridge.rs::load_payload的manual-prefetch构造删除。通用 CLI 不再提供「手搓 AuthorizedAction 发执行端」的口子。 - 只 gate Android UI 手动按钮:
MainActivity的「Run AuthorizedAction Now / Via Service」属开发期手动触发,gate 到 debug build(debug source set/flavor 移除代码,而非仅运行时BuildConfig.DEBUG分支)。socket dispatch 入口本身不动。 - threat model 表述:「常规 daemon/CLI 管线必须经过 lifecycle;持 token 的本地诊断操作者属于显式可信例外」——不写「release 无任何绕过路径」(在务实信任模型下既不必要也不准确)。迁移计划第 4 步加测试:常规 CLI/daemon 路径无「绕过 lifecycle 构造 AuthorizedAction」的公开 API;UI 手动执行入口在 release source set 不存在。
5. 已定决策:审计轨迹纳入 audit_hash¶
决策:
audit_hash的输入扩展为包含每个动作的终态序列,而非让审计流旁路 hash。
权衡:
- 纳入(采纳):审计轨迹成为确定性证明的一部分——「同输入 → 同迁移序列 → 同终态」被 golden 测试钉死。代价是一次性刷新 #6 的 golden hash 基线。
- 旁路(否决):golden 测试零改动,但回放无法证明审计轨迹的确定性,留下「审计可能不稳定却测不出来」的盲区。
理由:审计轨迹本就应当是确定性的一部分——一个动作每次回放走过的状态、落到的终态若会漂移,审计就失去了可信度。把它锁进 hash 才是这套治理层的意义所在。基线刷新是可控的一次性成本(同 PR 完成 + PR 描述说明 hash 输入扩展)。
影响面 (Impact)¶
- 涉及的模块:
aios-spec(新增ActionProposal/EffectClass/ActionState/AuditRecord(含outcome)/ActionOutcome/ActionOutcomeSummary/AdapterError;移出AuthorizedAction)、aios-core(接收AuthorizedAction+ActionAdaptertrait,新增governance与action_lifecycle.rs)、aios-action(新增OfflineAdapter,DefaultActionExecutor改impl ActionAdapter,新增对aios-core的依赖)、aios-daemon/aios-cli(改用ActionLifecycle单管线,接审计流)。 - 接口变更:
AuthorizedAction移到 core、字段私有、加effect/coord、唯一构造器pub(crate) seal——会触及所有现有构造点(policy_engine 返回值、测试、Android bridge payload)。ActionExecutortrait(spec)被ActionAdapter取代为 dispatch 抽象。 - 依赖图变更:新增
aios-action → aios-core边。已确认aios-core不依赖aios-action,无环;spec → core → action仍单向。 - 向后兼容性:现有 golden trace 的脱敏/策略/执行三层语义不变;
audit_hash输入扩展属于有意的确定性升级,需同步刷新 golden 基线(一次性)。
风险与缓解 (Risks)¶
- 风险:
AuthorizedAction移出 spec 触及面大。缓解:这是 reviewer 第 1 点要求的「可编译的所有权方案」——不可伪造性无法在 spec 内跨 crate 实现。改动集中在构造点,由编译器全量暴露,无静默遗漏。 - 风险:收紧
AuthorizedAction构造破坏 Android bridge 序列化。缓解:bridge payload 仍Serialize(只读发出方向安全),只禁止Deserialize反向构造可执行动作;编译期 + 单测双重保证。 - 已知成本:audit_hash 基线变更影响 #6 golden 测试(已采纳「纳入」方案,见设计第 5 节)。处理:在同一 PR 内刷新基线,并在 PR 描述说明 hash 输入的扩展。
- 风险:范围与 issue 验收不一致。缓解:见「范围与 issue 验收对齐」一节——被推迟的验收项(budget 终态等)已逐条声明并将在对应 issue 留痕,#5 不由本 PR 完全关闭。
替代方案 (Alternatives)¶
方案 A:全量实现设计文档的 Action Bus(Capability + Budget + Scheduler + 18 态)¶
体量大、需多分支多周,且会重写现有精简管线和 golden 测试。当前动作集(5 类)撑不起这套机制,多数会是死代码。不采用。
方案 B:只加 AuditRecord,不做类型分离¶
最省事,但留下「planner 输出直接进 adapter」的类型漏洞——正是 #4 要堵的核心安全边界。不采用。
方案 C:把状态机放进 aios-action 而非 aios-core¶
违反 spec → core → action 单向依赖:治理决策(policy/redaction)属于 core,adapter 只负责执行。不采用。
方案 D:AuthorizedAction 留在 spec,用 sealed-trait + 见证 token 保不可伪造¶
可让类型留在 spec:定义一个 mod sealed 私有 trait 作为构造见证,仅 core 能产生。但构造器逻辑仍必须在 core,spec 侧只剩一个无法独立构造的空壳,徒增 sealed 样板与一层间接。收益(类型留在 spec)不抵成本,不采用,改用方案:直接把类型移到唯一生产者所在的 core(§1.1)。
迁移计划 (Migration Plan)¶
aios-spec:加ActionProposal/EffectClass/ActionState/AuditRecord(含outcome)/ActionOutcome/ActionOutcomeSummary/AdapterError;移出AuthorizedAction。跑通 serde roundtrip 与非法action_type反序列化拒绝测试(归 schema 阶段)。aios-core:新建governance(落AuthorizedAction私有字段 +seal+ActionAdaptertrait)+action_lifecycle.rs状态机;改PolicyEngine调用方拿新类型。PolicyActionDecision只带 batch 内(intent_ordinal, action_ordinal),window_ordinal由 lifecycle 在窗口边界补齐组装成完整ActionCoord。状态机单测 + 终态覆盖 + 「每coord恰好一条终态审计」测试(含两个窗口、重复 ordinal 场景,证明全局主键不碰撞)。aios-action:加aios-core依赖;OfflineAdapter+DefaultActionExecutor都impl ActionAdapter;每动作单测 + 成功outcome摘要确定性测试 + adapter 真实失败→Failed测试(不再有 unsupported-variant 测试,理由见 §3)。aios-daemon/aios-cli:换成ActionLifecycle单管线(run显式传window_ordinal),接审计流,刷新 golden 基线;收束 seal 旁路——CLISendAuthorizedAction改为不执行动作的 ping/health-check(见 §4),Android UI 手动执行按钮移到 debug source set;release 保留 socketdispatchAuthorizedActionJson供DefaultActionExecutor转发。加测试:常规 CLI/daemon 路径无「绕过 lifecycle 构造 AuthorizedAction」的公开 API。replay的audit_hash加「三次回放 hash 一致」+「两窗口重复 ordinal 无碰撞」+「outcome 漂移改变 hash」回归。- 全量
cargo test --workspace+cargo clippy -- -D warnings通过。 - 在 issue #4/#5/#8 按「范围与 issue 验收对齐」勾选/留痕;#5 注明延后项。
参考 (References)¶
docs/src/refs/papers/Action_Bus_设计参考.pdf— Action Bus 完整设计(本 RFC 的务实裁剪来源)。docs/src/refs/papers/DiPECS参考建议.pdf— P0 最小闭环建议。- Issues #4 / #5 / #8 — 本 RFC 的验收标准来源。
- RFC-0001 — 分层采集与决策路由(本 RFC 在其管线上叠加治理层)。