跳到主要内容

M1 State Confirmation 工程包

⚠️ 占位包 (Step 11 整改包 II-3):本工程包等 M0 收尾 gate 触发起草,当前 status: pending,正文为模板占位 + M1 scope 大纲,不应被工程实施 agent 当作可执行内容读取。

模板来源:Milestone 工程包模板

详见 Step 11 整改包详细方案 Action II-3。

§1 范围与边界

1.1 M0 → M1 演化

承接战略不变量 I-2(用户主权三件套:候选 → 已确认两步契约)。M0 仅实现 stub schema(StateCandidate.state = Pending,不走候选两步路径,详见 m0-walking-skeleton.md §1)。M1 启动后正式落地两步写入。

1.2 M1 implement / stub 边界(占位,起草时填充)

子系统 / 接口M0 状态M1 状态备注
StateCandidatestub schemaimplement(含 Pending/Confirmed/Edited/Expired/Rejected 5 状态全转移)候选两步契约落地
Judgment Record 持久化仅内存 / Mockimplement(SQLite 持久化)用户主权三件套之一
Watchlist 持久化不实现stub schema(M5 implement)推迟到 M5 主动信号
Dynamic Profile 持久化不实现stub schema推迟到 M2

1.3 与 M2 边界

M1 不做:7 任务类型扩展(推迟 M2)、Web UI(推迟 M3)、主动信号(推迟 M5)。

frame 指针(阶段 0 文档矫正 · 2026-06-04):上文「Watchlist 持久化推迟 M5」「主动信号推迟 M5」指的是主动信号的生产级铺面(Channel 投递 / 批量 / cron 真实调度)。架构 §25 已把最小自主循环切片前移到 M2(失效条件触及 → 自主发起一轮复盘,手动 tick 驱动)——它需要一个最小 Watchlist 对象 + Judgment Record 失效条件监控作为状态前提。因此 M2 切片所需的最小 Watchlist / 失效条件触发不被这两条 M5 推迟覆盖;M1 仍可只备状态基础(架构 M1 验收新增项:Judgment Record 带可被未来检查的失效条件字段)。本 pack 里程碑表未重编号(owner 治理连带项),读时以架构 §2 agent 本体不变量 + §25 frame 重定位为准。

1.4 商业信号采集承接(Step 11 III-5 承接)

承接战略白皮书 §15 商业未决(单位经济 / 留存竞争 / L1-L3 商业强度):M1 范围加入"商业信号数据采集 + L1-L3 信号分层"任务,与 §15 三类未决问题挂钩。

M1 起草时必填:商业信号采集字段定义 / 用户分层接入点 / 数据保留协议(与用户主权三件套兼容)。

§2 接口子集

待起草。预期接口:

  • StateCandidate 状态机 5 状态转移
  • JudgmentRecord 持久化 CRUD
  • 候选两步 confirm/edit/reject API

§3 schema

引用 contracts/structured-cognition-result.yaml + contracts/state-machines.yaml

待起草时补 M1 子集 schema_version。

§4 SQLite DDL

待起草时给出 M1 新增 SQLite migration(candidates 表 / judgment_records 表持久化)。

§11 验收 checklist

待起草。预期含:

  • StateCandidate 5 状态转移完整测试
  • candidate → confirmed audit trail 完整
  • candidate edit 行为符合用户主权
  • candidate expire 自动归档

人工 checklist 由人类工作流维护者亲自走(承接 ADR-003 fresh-eyes 二阶 + 每 milestone 至少 1 个 PR gate 人类亲走)。

§15 ADR 引用(namespace prefixed)

承接:

  • arch-rewrite/ADR-001 工程范式(accepted)
  • arch-rewrite/ADR-003 工程实施栈与协作(accepted,含 AI 三方互审协议)
  • arch-rewrite/ADR-007 状态写入两步候选(waiting → M1 启动前 accepted,blocking M1)
  • whitepaper-rewrite/ADR-008 supplement 机制层输出契约扩展(accepted)

M1 起草前置:ADR-007 必须 accepted。承接 Step 10 主控视角 R6 风险(ADR-007 M0 不阻塞但 M1 直接阻塞)。

§17 关联资产


⚠️ 起草启动 checklist(M0 收尾时主控用)

M0 收尾 gate 触发起草任务时,主控按以下顺序:

  1. 确认 ADR-007(arch-rewrite/状态写入两步候选)已 accepted
  2. 复制 Milestone 工程包模板 内容到本文件,替换占位段
  3. 完整起草 §1-§16 实质内容
  4. frontmatter status: pendingdraft
  5. 走 AI 三方互审协议(Claude 主控 + Codex + OOSO)
  6. 用户审 + audit trail 签字段(如触及 P0/P1,由 npm run audit:p0-touch 校验)
  7. npm run verify:kb + npm run audit:cross-section
  8. M1 启动决议 PR 合并