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>
2.5 KiB
2.5 KiB
knowledge:模块真实现状基线(指针)
真实现状的权威 SSOT:
docs/agent-specs/2026-06-13-项目目标与模块现状基线.md(逐模块证据)+2026-06-13-目标达成对抗复盘.md(失控根因)。本文件只做导航 + 关键结论蒸馏;冲突时以代码与覆盖率台账为准。
关键结论(蒸馏,2026-06-13 只读判断,未实跑 mvn/npm)
- 后端不是空壳:9 BC 后端普遍是真实业务逻辑(幂等 / 乐观锁 / 审计 / Shadow→Canonical 硬闸门 / 真实 HTTP 外部集成)。覆盖率台账 233 operation:147 completed / 86 needs_verification;catch_all / generic_persistence / sse_placeholder / missing / blocked 全为 0。逐域 operation:account 33 / ai 41 / content 51 / events 1 / knowledge 59 / market 32 / meta 16。
- “completed” = 覆盖率门禁批准状态(需 HTTP 入口 + 真实 PostgreSQL + Flyway + 证据),≠ 端到端可用;历史“完成”声称是低报而非高报。
- 三大真实缺口:
- 前端 muse-studio 严重滞后:AI 候选闭环断链、知识库 / 市场生产侧 UI 缺失、个人中心约 21% 端面且跑 MSW mock——objective“先审后入”在用户可见层当前不可用。
- 跨 BC facade 多为
Unavailable占位:meta impact-preview、account 投影等仅 fail-closed 占位 → 运行期返回*_UNAVAILABLE(meta 写链路、account 约 21/33 端面运行期降级)。 - 机械门禁缺口:原 ADR“AI 授权包级隔离 + ArchUnit”全仓 0 规则;gateway 路由未接任何 Muse BC 且留死路由。
- 整体只读评估 ≈ 76%(后端高 / 内部验证门禁中 / 前端低 / 跨 BC 集成与机械门禁低)。
订正与进展(随基建推进更新 —— 复利留痕)
- A1/R6 订正:基线 §1.1“本仓不承载运行时代码”与磁盘事实矛盾——本仓是 monorepo,物理承载
muse-cloud/muse-admin/muse-studio代码 + CI;以../../AGENTS.md为准。 - 缺口 3 已部分补齐(基建复利):
- BC 边界 ArchUnit 门 →
../rules/bc-boundaries.md(已验证绿)。 - 契约先行门(Flyway 卫生 + OpenAPI 结构)→
../rules/contract-first.md(已验证绿)。 - CI 真跑测试 + JDK21 + 门禁去硬编码 → P0(见
../rules/verification-and-anti-false-green.md)。
- BC 边界 ArchUnit 门 →