zizi-al/oh-my-muse
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
312 Commits 6 Branches 1 Tag
Commit Graph

21 Commits

Author SHA1 Message Date
lili
40d4bdb527 docs(design-docs): 清理对从未创建的 doc/dev/* 的全部引用(消除幽灵权威归属) 
断链扫描发现 design-docs 把整套 doc/dev/00..09(路线图/阶段/IA验收门禁/真实现状差距)当 SSOT/门禁权威反复引用约 16 处,但该套文档 git 全历史从未创建 → 读者按图索骥全 404。职责实已被现有文档承担,逐处改指或墓碑标注:路线图/阶段→进度总账;验收门禁→覆盖 JSON+verification 规则;真实现状差距→项目功能与进度总览;产品形态→产品/架构分册;RAGFlow 落地→muse-module-knowledge。

改动:00-文档大纲(SSOT归属/角色导航再读列断链/专题-03描述/职责表/单一归属 共5处 + v6→v7);内容映射表(dev路线图块/产品形态行/个人中心/Sa-Token/IA-0~3门禁/IA gate 共~11处 + v6→v7);架构-03 ADR(参考落地2处 + v9→v10)。

验证:断链扫描 3→1(唯一剩 dev-baseline 历史区格式占位符,无害);design-docs 残留 doc/dev 仅墓碑文字标注,0 可点击断链。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 09:38:12 -07:00
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
ba6e5f1745 docs(design): 登记对象存储字节代理交付 + 失败关闭安全姿态 (U8) 
- 架构-02(权威):细化 Download Credential/Export Package 不变式——租户/用户命名空间隔离、稳定存储路径字节代理、不签发签名 URL、避免 IDOR。
- 架构-03:新增 ADR-019(稳定路径字节代理 + SSRF 白名单 + 服务端权威 scanStatus 失败关闭 + 账户导出脱敏),更新 §3 结论。
- 后端-03 §6/§9/§12 + 后端-05 §4.9/§4.10:导入预检 SSRF/scanStatus、下载字节代理、账户脱敏的流程与契约姿态,均引用 架构-02/ADR-019,不重复定义。
- 4 文档版本号递增至 2026-06-19。无 V24 迁移(列已齐)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-19 00:57:10 -07:00
lili
cb57b88866 docs(sse): 前端/后端 SSE 契约反向对齐 sse.ts 真实实现 
studio src/lib/sse.ts 已是真实实现(connectAIStream/connectEventStream 双函数 +
fetch/ReadableStream + 按 event: 行分发),但三处正式文档仍停留在虚构契约,故反向对齐(反假绿):
- 前端-01 v6→v7:AI 流改两步(POST /ai/tasks 创建→GET /ai/tasks/{taskId}/stream 建流);
  事件流路径 /events/stream→/events;明确按 SSE event: 行分发。
- 后端-05 v8→v9:补 GET /ai/tasks/{taskId}/stream 端点 + SSE 事件契约表
  (chunk/quality_check/done/error 及各 payload);记 done 的 taskId/suggestionId
  后端 Long 序列化为 JSON 数字、与候选 uuid 字符串契约不一致(待后端统一,前端已在解析边界 String 归一)。
- dev-baseline/muse-studio/CLAUDE.md:SSE 章节由虚构 useAIStream/useEventStream hook
  改写为真实双函数 + 线格式 + 约束(AI 流不重连、事件流指数退避 1/2/5/10s、AbortController 关闭、无凭证 fail-closed)。
- sse.ts:onDone 注释补 WHY string(Long→JSON number→String 归一)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-16 02:55:24 -07:00
lili
e181669197 chore(agent-infra): 建立 agent 开发基建、清理历史 churn 并以 BC 违例整改验证 
本会话三部分交付,均经 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>
 2026-06-14 04:38:07 -07:00
zizi
9df67b2794 docs(admin): 校准管理端契约边界 2026-05-24 20:37:57 +08:00
zizi
33aad93bef 提交全维度文档review后的22项架构决策落地 
基于产品/架构/流程/前端/后端五维度并行review，澄清并落地22项关键决策：

架构层：Governance按消费者归属拆散、MetaSchema独立模块、
Source传播改为事件驱动自治、去掉Candidate Decision Envelope
和needs_recheck中间状态、Neo4j决策为依赖RAGFlow GraphRAG

后端层：Entitlement统一为可变表+审计日志、API版本策略采用
X-API-Version Header、知识实体唯一键加scope字段

前端层：SSE实时通信（AI stream独立+事件统一）、正文持久化
IndexedDB安全网、Block粒度为场景/小节级

产品层：范围不变UX解决复杂度、知识确认默认自动+冲突时人工
 2026-05-24 04:28:52 +08:00
zizi
9eacebb630 提交四仓工程架构索引 2026-05-24 01:41:23 +08:00
zizi
e50aa02b41 提交整体设计文档一致性修复 2026-05-24 01:14:34 +08:00
zizi
8d7b47b468 提交前后端架构阶段文档 2026-05-23 23:55:00 +08:00
zizi
4ba1257b7f 提交专题阶段文档 2026-05-23 21:20:25 +08:00
zizi
cb568cee5c 提交架构阶段文档 2026-05-23 19:07:52 +08:00
zizi
ab4deeb994 提交流程四分册与引用迁移 2026-05-23 17:55:05 +08:00
zizi
b47f39c6bd 提交产品03用户旅程文档 2026-05-23 15:04:46 +08:00
zizi
fcb14bc62f 提交产品02E至02G详细规格与原型 2026-05-23 13:15:52 +08:00
zizi
92a285db96 修复产品02A至02D评审问题 2026-05-22 23:18:03 +08:00
zizi
2b48abc11a 提交产品02A至02D详细规格与原型 2026-05-22 21:58:10 +08:00
zizi
97c4fab3bc 提交产品02B管理员控制台规格与原型 2026-05-22 16:15:58 +08:00
zizi
4896a53c2e 更新产品01产品定位与核心价值 2026-05-22 03:32:45 +08:00
zizi
a40411cfad 添加生成质量门控与创作健康度设计方案及产品形态阶段化重设计计划 2026-05-22 01:27:28 +08:00
zizi
0d0e1d4473 添加产品设计文档 
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-05-20 10:38:31 +08:00