3 Commits

Author SHA1 Message Date
lili
329db944ff docs: 进度口径收敛到机械唯一源——修正三套矛盾数字(147/100→233/233) + 现状基线降级
排查发现进度数字三套互相矛盾:总览/现状基线/主台账历史段=147/86、agent-specs=100/127、module-reality=233/0。核机械真值:覆盖 JSON summary=233/233 completed/0 needs(每 op 带 testFiles 证据 + P1rApiCoverageReportTest 校验 summary 自算防手工拨)。⚠️ JSON generatedAt=2026-05-25 未随内容刷新(手工维护痕迹),已在文档标注以 summary+testFiles 为准。

修正:① 总览(我上轮新建,误抄过时台账)147/233→233/233、各域 full、接口门≠端到端两口径分清、定位为人读封面(权威以台账/JSON为准);② 主台账 头部加机械源口径声明(233/0)+门禁中→满+验收债标已清零;③ 现状基线降级为 2026-06-13 历史快照(顶部时效横幅+性质去SSOT);④ AGENTS序2/module-reality 改引用;⑤ agent-specs/.agent 注记历史数字;⑥ meta-schema review 回指 execution v0.2 已证伪地基(待决策提案);⑦ design-docs/00 加'设计≠进度';⑧ dev-baseline 申明旧 SSOT 自称失效。

确立单一真实源:设计=design-docs;进度=进度总账(叙述)+覆盖JSON(机械);人读=项目功能与进度总览(封面)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 05:32:32 -07:00
lili
60586115e3 docs(spec): meta-schema 用量投影执行版(决策确认全5维度+字段级+全真实) + 评审版决策记录
据 grounding(2026-06-20)对 5 维度定性:Planning 真实字段级消费者(字段用量隐含 contentPayload,补 schema_key 即可,无需新快照表);Work/KnowledgeProjection 实证零 schema→已验证真实0贡献者;AIContext/Export 消费侧零持久化→P3 定性。架构:Meta 算破坏字段集 + 各 BC 贡献者只查本域计数(守 BC 边界),聚合器 all-real 门。含 Flyway 迁移/回填/分阶段/每维度真实 PG IT/回滚。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 00:18:30 -07:00
lili
d6fc1994e6 docs(meta): meta-schema 用量投影评审版设计(Pull + 按 BC 拆贡献者端口,待确认)
承进度总账 §五A(MetaImpactFacade 置后判定)。基于本会话只读 grounding 调查
(有出处)产出评审版设计,供人类做架构决策——本提交不实现任何代码。

核心结论:
- 根因证实:消费方未持久化 schema 用量(仅 Content planning 存 schema_version、
  无 schema_key;Knowledge/AI 不存)→ MetaImpactFacade 只能诚实 fail-closed
- 架构订正:现 MetaImpactFacade 单接口返 5 维度=单实现者须懂 5 BC 数据、违
  BcBoundaryArchTest 边界门;须拆为 meta-api 定义贡献者端口、各 owner BC 提供适配器
- 推荐 Pull(按需查询贡献者)而非 Push(事件投影):impact preview 低频 admin +
  gate destructive 治理动作、要准确,Pull 无投影漂移/回填/一致性窗口
- 分阶段:P0 端口就位→P1 Content 真实化→P2+ 其余维度;未做维度诚实 unknown 不伪造
- 5 个 open items 待人类定夺(尤:Knowledge/AI 是否真消费 schema、fail-closed 粒度)

台账 §五A 注册指针。待确认方向后再写主 spec + 执行版(数据契约/迁移/IT 验收)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 14:33:15 -07:00