memind/docs/regression-guards

回归守卫索引

本目录记录已验证、不可轻易回退的行为。适用于 Codex、Cloud、Cursor 及任何人工作前的自检。

文档

文档	保护内容
mindspace-publish-and-chat-finish.md	① edit_file 覆盖 public/*.html ② Finish 后聊天不清空、不暴露 agent 内部前缀
mindspace-remote-page-sync-and-thumbnail.md	① remote 模式 public HTML 入库 sync ② storage 缺失时缩略图/读页回退 workspace HTML
page-data-delivery-contract.md	数据集注册、绑定、真实 page UUID 与交付验收
h5-session-stream-replay.md	Portal/Goose SSE 游标映射、断线续播与 Finish 终态恢复

自动化

npm run verify:mindspace-publish-guards        # 推荐：改相关代码后
npm run verify:mindspace-publish-guards:full   # 发 Portal runtime 后
npm run verify:h5-session-patches              # H5 会话、Agent Run 与 SSE 续播

新增守卫时

1. 在本目录添加说明 md（症状 + 必须保留的行为 + checklist）
2. 添加/扩展 *.test.mjs 并接入 npm test
3. 在 scripts/verify-*.mjs 增加源码片段检查（如适用）
4. 更新根目录 AGENTS.md 索引
5. （可选）在 .cursor/rules/ 添加对应 .mdc 供 Cursor 自动提示

工具可见性

机制	Cursor	Codex / Cloud / 其它
本目录 + AGENTS.md	✅	✅（需读仓库文件）
npm run verify:*	✅	✅
npm test	✅	✅
发版脚本门禁	✅	✅
.cursor/rules/*.mdc	✅ 自动	❌ 不自动

其它 AI 工具不会自动读 Cursor 规则；请以 AGENTS.md 与本目录为准。