# 历史分支处置登记

本文件记录已经完成迁移、但仍可能因为 Git 拓扑或遗留 worktree 被误判为“尚未进入 `main`”的分支。
它是分支复用、合并、cherry-pick 和清理前的必查清单。

## 处置规则

- 标记为“禁止再次引用”的分支只允许用于只读历史追溯。
- 不得从这类分支继续开发，不得 merge、cherry-pick、打包或发布。
- 不得把旧 worktree 中的未提交文件直接覆盖到当前主线；应先与最新 `origin/main` 逐文件比较。
- 若确需恢复历史代码，必须重新评估当前 `main`，在最新主线上建立新分支，并重新执行对应测试和 verify。

## `codex/product-quality-p0`

**状态：禁止再次引用。功能已进入 `main`，该分支不是待合并开发分支。**

审计日期：2026-07-17
历史分支基线：`6ef3ea8`
历史分支 HEAD：`ebfdc21`
审计时相对 `main`：分支侧 6 个提交、主线侧 53 个提交

### 原始用途

该分支用于 Memind 产品质量 P0 审计与修复，内容包括：

- 修复用户可见的聊天 routing/skill 前缀、旧 Page Data prompt 和部分 MindSpace/语音交互问题。
- 修复页面发布确认状态与过期未确认页面的 `owner_only` 回退。
- 将 `src/api/client.ts` 拆分为 MindSpace、发布、Page Data、Agent Jobs 等模块。
- 在 worktree 中继续处理聊天 Finish 顺序、消息按 ID 合并和发布 HTML 的预览 CSP 清理。

### 已进入 `main` 的提交

原分支提交已经在更新后的主线基线上重新落地，不能因为 commit hash 不同而再次引用：

| 原分支提交 | `main` 对应提交 | 内容 |
|---|---|---|
| `f7a9c21` | `77f1ea8` | 产品交互加固 |
| `db17691` | `f2d0c99` | 旧 prompt 与发布确认兼容 |
| `ad3c5bf` | `f6dcf5b` | MindSpace API 模块拆分 |
| `3504ee0` | `8ac159a` | 发布 API 模块拆分 |
| `456ec54` | `ddb3a33` | Page Data API 模块拆分 |
| `ebfdc21` | `6250b59` | Agent Jobs API 模块拆分 |

`456ec54` 与 `ddb3a33` 的 patch-id 不同，是因为主线重新落地时原有 Page Data 路径已经从
`/page-data` 更新为 `/admin/page-data`。两边最终的 `src/api/page-data.ts` 内容一致；
`ddb3a33` 是适配更新后主线的正确落点，不是遗漏提交。

### 遗留 worktree 的五文件修改

`/Users/john/Project/Memind-product-quality-p0` 曾保留以下五个未提交文件：

- `chat-finish-sync.mjs`
- `chat-finish-sync.test.mjs`
- `mindspace-public-delivery.mjs`
- `mindspace-public-delivery.test.mjs`
- `src/utils/message.ts`

这些修改已在 `933466c`（`fix: preserve chat order and published page scripts`）进入 `main`。
2026-07-17 复核结果：其中四个 worktree 文件与 `main` 字节级一致；
`chat-finish-sync.test.mjs` 的 `main` 版本额外包含两组回归测试，因此主线版本更完整。

### 最终处置

- 不要 merge `codex/product-quality-p0`。
- 不要 cherry-pick 该分支的 6 个提交。
- 不要从其脏 worktree 复制上述五个文件覆盖主线。
- 不要从该分支或 worktree 构建任何 runtime/artifact。
- 后续开发必须从最新 `origin/main` 新建分支。

该分支及 worktree 是否删除，属于独立清理动作；删除前仍需用户明确批准。