Skip to content

phase-10-consolidation-reflection.md

Latest commit

 

History

History
105 lines (75 loc) · 7.37 KB

phase-10-consolidation-reflection.md

File metadata and controls

105 lines (75 loc) · 7.37 KB
Raw

阶段 10：巩固与 Reflection

状态：Planned
前置阶段：阶段 9
目标版本：0.11.0
架构依据：§15.3 后台提炼、§16 Outbox 与 Worker、§17.4 周期任务、§24 Provider 边界、§36 阶段 10

阶段目标

交付 Evidence 驱动、固定 Watermark、可重放且可降级的后台认知流水线，将 Observation 窗口转换为经过服务端验证的 Episode、Claim/Relation、Note/Task 候选和 Persona Proposal，而不影响 Canonical 在线写入与召回。

架构约束

  • Provider 输出是不可信候选，不是原始事实；未知 Entity、无 Evidence、越权 Scope 或直接 Core 修改必须拒绝。
  • 每个 Job 固定 Source Watermark 和 Source Revision，提交前重新验证来源仍有效且未 Tombstone。
  • ReflectionRecord 记录输入、模型/Prompt/Policy 版本和候选，不能把自己的输出当新证据循环强化。
  • 网络 Provider 调用不在 SQLite 写事务内，也不阻塞 Observe/Forget/Correct/Task/Persona 读取。
  • Provider 失败进入 Retry/Dead Letter/Circuit Breaker，Recall 通过现有契约降级。

需求追踪

需求 ID 基线要求 工作包 验证门禁
P10-EPISODE-01 固定 Watermark 的有界 Episode Consolidation 10.1 迟到、重复、版本变化和删除来源测试
P10-EXTRACT-01 严格 Schema、Evidence Span 与确定性 Reconciliation 10.2 无来源、冲突、权威和候选状态测试
P10-REFLECT-01 ReflectionRecord 可重放且防止自循环强化 10.3 来源图、重复重放和 Persona Proposal 测试
P10-PROVIDER-01 Provider 最小输入、超时、预算、熔断与输出校验 10.4 故障、注入、配额、泄漏和 Ready 测试
P10-FENCING-01 固定 Source Revision/Watermark 与提交前 Fencing 10.1–10.5 Correct/Forget、旧 Worker 和 Lease 竞争测试
P10-OPERATIONS-01 Dry Run、差异、审计重放与 Dead Letter 管理 10.5 可重复性、幂等、审计和低敏诊断测试

工作包

10.1 Episode Consolidation

  • 以 Agent/Space/Session/时间/主题的有界窗口封闭 Episode，保留 Observation refs 和固定 Watermark。
  • 处理迟到 Observation、Builder 版本变化、重复 Job 和已删除来源。
  • 产生后续 Claim/Relation/Index Outbox，而非事务内联调用所有 Builder。

10.2 提取与协调

  • 为 Claim、Relation、Note/Task Candidate 实现版本化 Prompt、严格 JSON Schema 和 Evidence Span 校验。
  • 对重复、冲突、时效和 Source Authority 做确定性 Reconciliation，冲突事实并存为 Disputed。
  • 普通对话产生的 Task 保持 Proposed；Note/Claim 权威与来源匹配。

10.3 Reflection 与 Persona Evaluation

  • 实现 ReflectionRecord、Evidence Window、候选去重和防自循环标记。
  • Persona Evaluation 只生成 Phase 9 Policy 可处理的结构化 Proposal，不直接发布 Core。
  • 记录删除 Evidence、Stale Base Revision 和 Policy Denied 的稳定原因码。

10.4 Provider 治理

  • 实现 Extraction/Summarization/Reconciliation/Persona Evolution Port 和按 Job Kind 的超时、重试、预算与并发。
  • 输入按 Purpose/Scope/Privacy 最小化，输出执行 Schema、ID、Evidence、长度和值域 Allowlist。
  • 实现熔断、有限 Probe、每日成本预算、积压公平调度和 Dead Letter 管理。

10.5 可重放与运维

  • 支持按固定 Watermark/Builder/Prompt 版本 Dry Run、差异比较和受审计重放。
  • 提供 Job 输入引用、候选/拒绝数量、Lag、Provider outcome 和成本的低敏诊断。
  • 保证重放不重复逻辑资源或提高候选自身的证据权重。

数据、契约与回退策略

  • 增量 Migration 新增 Episode Consolidation State、ReflectionRecord、候选/拒绝记录、Provider Outcome 与版本引用；原始 Provider 响应不作为 Observation 或独立 Evidence。
  • Job Payload 固定 Source Watermark、Source Revision、Builder/Prompt/Policy/Provider Schema Version 和最小 ResourceRefs；新 Worker 读取上一 Payload 版本，旧 Worker 不领取未知 Job Kind。
  • Provider 网络调用完全位于数据库事务之外；提交事务重新校验 Scope/Privacy、Source Revision、Tombstone、Lease Generation 和 Policy，成功后再写 Canonical 结果与后续 Outbox。
  • Prompt、输出 JSON Schema、Reconciliation 和 Provider Model 分别版本化；升级先 Dry Run/差异评审，再小流量启用。候选差异不通过直接修改历史记录处理。
  • 回退可按 Job Kind 关闭 Provider Capability、熔断或切回上一 Prompt/Builder；在线 Canonical API 保持可用。Dead Letter 重放创建新 Outbox ID，保留原任务、版本、原因和审计，不复用过期 Lease。

量化验收基线

  • 相同 Canonical Snapshot、Watermark、Builder/Prompt/Policy 版本和确定性参数连续重放 3 次，候选 ID/指纹、Evidence refs、拒绝原因和差异摘要一致。
  • 无来源、未知 Entity、越权 Scope、任意代码 Trigger、自动 Active Task、直接 Persona Core 修改与自循环 Evidence 每类至少运行 200 个生成案例，非法提交成功数必须为 0。
  • 在 Provider 超时、429/5xx、无效 JSON、超限输出、熔断、预算耗尽和恢复 Probe 下各执行至少 20 轮；Observation、Forget、Correct、Task 转换和 Persona Current 仍满足既有正确性与延迟门禁。
  • Correct/Forget/Source Revision 变化、Lease 过期和 Worker 抢占各至少重复 50 次，过期 Job 的 Canonical 提交成功数必须为 0。
  • Dead Letter 以新 Outbox ID 重放 100 次不产生重复逻辑资源；积压指标必须报告 Job Kind、Lag、Oldest Pending、候选/拒绝数量和成本，且日志泄漏扫描无正文、Secret 或完整 External ID。

退出门禁

  • 相同 Watermark、版本和确定性参数可重放得到同一候选集合/稳定差异说明。
  • 无来源、未知主体、越权 Scope、任意代码 Trigger、Active Task 和 Persona Core 候选被拒绝。
  • Source Revision 过期、Correct/Forget 或 Lease Fencing 后旧 Worker 无法提交。
  • Reflection 自身输出不能作为同一结论的新独立 Evidence。
  • Provider 超时、限流、无效 JSON、熔断和预算耗尽不影响 Canonical 在线功能。
  • Dead Letter 可安全检查和以新 Outbox ID 重放，保留原任务引用与审计。
  • Migration/Job/Prompt/Provider 兼容和回退方案、需求追踪及交付证据已完成评审。

交付证据

  • 代码/变更：待补充
  • Prompt/Provider/Builder 版本：待补充
  • Schema/Migration：待补充
  • 重放/故障/安全报告：待补充
  • 已知限制：待补充

明确不做

  • 不让自由文本模型输出直接修改 Binding、Forget、Task 完成或 Persona Current。
  • 不保存或要求 Chain-of-Thought。
  • 不因后台积压降低在线 Scope、Privacy、Tombstone 或一致性门禁。

交接条件

Core 的 Canonical、召回、Persona、后台巩固与契约能力至此形成完整服务闭环；Phase 11/12 可仅通过发布 SDK/Schema 接入，不复制 Domain Model。