e181669197
本会话三部分交付,均经 JDK21 真实构建验证(非退出码,读 BUILD SUCCESS + Tests run):
1) Agent 开发基建(机械门禁优先)
- 入口与中枢:AGENTS.md、.agents/{knowledge,rules,skills,workflows}、CLAUDE.md 订正
- 订正 .gitignore:移除对 .agent/.agents 的忽略——它们是版本化 agent 基建,须入库(此前被忽略致克隆即缺)
- 机械门禁:CI 真跑测试(maven.yml JDK21、去 -Dmaven.test.skip)、覆盖台账去硬编码、
BC 边界 ArchUnit 门(BcBoundaryArchTest)、契约先行门(ContractFirstGateTest:Flyway 卫生 + OpenAPI 结构)
- 单一进度源 docs/mvp/进度总账.md + 7 个 BC per-module .agent + mise.toml(锁 JDK21)
- P1 增量:AiSuggestionMergeProjectionFacade(Gap A)、ContentSourceServiceImpl 事务化 outbox 回流(Gap B)
2) 过期历史文档清理(97 份 churn,git 可恢复)
- 删 docs/memorys(34)、agent-specs 审阅/执行版+迁移review(34)、superpowers/plans+specs(25)、
design-docs/临时+memorys(4);保留 superpowers/reports/coverage(门禁依赖)
- 唯一干货蒸馏入 .agents/knowledge/external-deps-and-gotchas.md;订正大纲/映射表/基线悬空引用
3) P1 harness 验证:消除已登记 BC 违例 ContentMuseWorkOwnerFacade
- content-api 新增只读端口 MuseContentWorkOwnerApi + content-server 实现(读自有 DAL);
AI 适配器改消费该端口、移除全部 content.dal 依赖,AI 业务规则与 4 消费者不变
- 删除 ArchUnit 豁免 → 门禁收紧(反向红 31 例 / 正向绿;适配器单测 13/0F、端口实现 7/0F)
注:muse-studio/src(SSE 相关 4 文件)与 muse-module-ai/pom.xml(移除孤儿 contract-server)
为本会话之前已存在的未提交改动,非本次工作,未纳入本提交。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
5.4 KiB
5.4 KiB
Muse 进度总账(单一进度源)
本文件是项目进度的唯一 SSOT。进度更新只进本文件 + 各模块
.agent;不再新增“状态推进 / 收口 / completedApproval”过程文档(过程文档 churn 是失控根因之一,见 对抗复盘)。 模块真实现状的权威基线见 现状基线 spec;本文件只记“进度”,不重复其证据细节。
一、Agent 开发基建(本轮交付,机械门禁优先)
| 砖 | 内容 | 状态 | 机械证据 / 落点 |
|---|---|---|---|
| P0 | CI 真跑测试(JDK21、去 -Dmaven.test.skip)+ 覆盖台账去硬编码 + P0 冻结令 |
✅ | .github/workflows/maven.yml、P1rApiCoverageReportTest、脊柱规则 |
| ① | BC 边界 ArchUnit 门(AI 不得直连他域 DAL) | ✅ 已验证绿 | BcBoundaryArchTest(Tests run 1/0F);bc-boundaries |
| ② | 契约先行门(Flyway 迁移卫生 + OpenAPI 结构;原地 SSOT) | ✅ 已验证绿 | ContractFirstGateTest(Tests run 2/0F);contract-first |
| ③ | knowledge 蒸馏(定位架构 / 现状基线指针 / 决策) | ✅ | .agents/knowledge/ |
| ④ | skills(黄金旅程“完成”定义 / 新增 BC 模块) | ✅ | .agents/skills/ |
| ⑤ | workflow(AI 开发协议元流程) | ✅ | .agents/workflows/ai-development-protocol.md |
| ⑥ | 进度总账(本文件)+ per-module .agent |
✅ | 本文件 + muse-cloud/muse-module-*/.agent |
后续基建 TODO(非阻塞):openapi-diff 破坏性变更 CI(就绪片段见 contract-first §四)、docs/dev-baseline/global/* 收敛进 .agents/rules/(engineering-conventions、security-and-reliability)、BC 边界门扩到其它方向。
二、产品 / 模块进度(指针,勿在此重复细节)
- 各模块目标 / 边界 / out-of-scope / 现状 / TODO → 见对应
muse-cloud/muse-module-*/.agent。 - 真实完成度与逐项证据 → 见 现状基线 spec §四/§五。
- 接口完成台账(门禁批准口径,≠端到端可用)→
P1rApiCoverageReportTest+docs/superpowers/reports/p1r-api-coverage.json。
| BC 模块 | 只读评估 | .agent |
|---|---|---|
| AI 编排 (ai) | 72% | .agent |
| 作品/编辑器 (content) | 82% | .agent |
| 知识库 (knowledge) | 72% | .agent |
| 市场 (market) | 82% | .agent |
| 元治理/MetaSchema (meta) | 82% | .agent |
| 事件/SSE (events) | 88% | .agent |
| 账户/个人中心 (account→member) | 68% | .agent |
整体只读评估 ≈ 76%:后端实现高、内部验证门禁中、前端用户端低、跨 BC 集成与机械门禁低(机械门禁项本轮已补 BC + 契约门)。
三、最大共性风险(跨模块,来自基线)
- 前端 muse-studio 严重滞后:AI 候选闭环断链、知识库/市场生产侧 UI 缺失、个人中心约 21% 面跑 MSW——“先审后入”在用户可见层当前不可用。
- 跨 BC facade 多为
Unavailable占位 → 运行期*_UNAVAILABLE。 - gateway 路由未接任何 Muse BC + 死路由:若误以网关为真实入口部署,Muse BC 全部 404。
四、历史交付时间线(过程文档已清理,留此精简记录)
2026-06-14 共清理约 97 份过程 churn(
docs/memorys34、agent-specs审阅/执行版+迁移review 34、design-docs/临时2、design-docs/memorys2、superpowers/plans14 +specs11;保留superpowers/reports/coverage——被门禁引用)。唯一操作干货蒸馏入.agents/knowledge/external-deps-and-gotchas.md;均 git 可恢复,完整历史在 git。
2026-05-24 muse-studio 脚手架+基础设施(Vite/React/TS6.0/MSW/IndexedDB)
2026-05-24 muse-studio 写作台+AI 协作(Tiptap + Coarse-to-Fine Diff + SSE 采纳)
2026-05-25 muse-cloud 后端 P1(yudao-cloud fork + 业务模块骨架)
2026-05-25 muse-admin 管理端(Vben fork:MetaSchema/治理/审计)
2026-05-26 P1R-0 基线门禁(OpenAPI 233 operation 覆盖矩阵)
2026-05-27→28 P1R-1/2 Content / Meta 真实 API
2026-05-31 P1R-4 AI 真实 API + task SSE 退占位(V12/V13)
2026-06-02 P1R-4/5 外部验收:New-API(MiniMax-M2.5)+ RAGFlow live 跑通
2026-06-05 P1R-6 Market 真实 API;P1R-7a Events SSE
2026-06-06→08 P1R-7b~7f Source Owner Propagation 五切片(V17–V21 outbox)
2026-06-09→13 Events/Meta/Account/Market/Content 分批 completed approval(coverage→147/233)
2026-06-13 现状基线 + 对抗复盘(诊断"假绿")+ P0 止血(CI 真跑测试/JDK21/去硬编码)
2026-06-14 Agent 开发基建六砖(BC 门 + 契约门 + .agents 中枢 + 单一总账)+ 历史文档清理
2026-06-14 P1 harness 验证:消除 BC 违例 ContentMuseWorkOwnerFacade(content-api 端口 + AI 改消费)→ ArchUnit 豁免删除、门禁收紧(反向红 31 例 / 正向绿;13+7 单测)