# Next Session Pickup（落仓库 2026-05-13）

> 本文件锚在 repo 里。新 session 起手第一步：读 `docs/STATUS.md` → 本文件 → `AGENTS.md` 必读链路。
> 前任：[`archived/next-session-pickup-2026-05-11-rename-pivot.md`](archived/next-session-pickup-2026-05-11-rename-pivot.md) + [`archived/next-session-pickup-2026-05-12.md`](archived/next-session-pickup-2026-05-12.md)（均已归档 — v0.1.2 publish 闭环 + BRIDGE-MOCKUP-004 tracker 重定义完成）

---

## TL;DR（4 句话）

1. **v0.1.2 已 first actual publish 🎉**：`@nancyzeng0210/tvu-design-system@0.1.2` 实际显示在 [GitHub Packages](https://github.com/NancyZeng0210/TVU-Design-System/packages)（commit `fda9185a` + tag `v0.1.2`, CI run #3 green, Packages 页实物 verified）。v0.1.0/v0.1.1 是 historical failed-publish artifacts（scope mismatch silent fail），no consumer impact。
2. **CANONICAL-010 PopupBox ✅ Resolved 2026-05-12**（commit `a61ee85e`）— 命令式 API + Teleport modal + docs page；BRIDGE-MOCKUP-004 tracker 子项 1/2 ✅。
3. **Design Process Evolution Steps 1-5 ✅ 结构完成**（commit `dce05d0c`）— 新文件（design-process.md / domain-tvu.md / tools/figma-quirks.md）已创建，但 **mockup-conventions.md 内容尚未 thin out**（Step E5 半完成），**AGENTS.md 必读链路未更新**——这是下个 session 的 Rule 整理收尾任务（~1-2h）。
4. **其他下个 session 任务**：INFRA-F29 docs grid card hover（~1h）+ 0.1.3 release cycle（~10min user 操作）。

---

## 1. 2026-05-11 已落地完整 commit chain

| commit | tag | 内容 |
|---|---|---|
| `72fc6bec` | — | CANONICAL-009 audit:design-system 升 strict (7→8) + Tab.vue token 化 + Icon/Logo carrier 白名单 |
| `227964fd` | — | INFRA-F29 docs site grid card hover backlog entry |
| `5e75535f` | — | wrap-up — BRIDGE-MOCKUP-004 baseline 后 backlog 重组（CANONICAL-010/011 派生 + tracker 重定义）+ 复盘 |
| `ff681077` | `v0.1.1` | release v0.1.1（CANONICAL-009 changeset 聚合 + bump）— **failed publish (scope mismatch silent fail)** |
| `fda9185a` | `v0.1.2` | fix(publish): rename @tvu → @nancyzeng0210 — **first actual successful publish** |

**v0.1.0** tag at earlier commit — 也是 failed publish artifact，不删（历史 record）。

**本 session 后 git status 应当是**：
- 本地 = origin/master ✅
- Dirty 文件残留：
  - `figma-data/normalized/tokenized-diff-report.json`（INFRA-F26 known noise）
  - `figma-data/published/icons/manifest.json`（build 副作用 timestamp）
  - 别 session 进行中的若干 file（按 dirty 协议不动）

---

## 2. 新 session 起手 onboarding（按顺序读）

1. **`docs/STATUS.md`**（3min — 当前版本 v0.1.2 + Active 后续工作 + Wrap-up 协议）
2. **本文件**（你正在读，5min）
3. **复盘 2026-05-11 三份**（重要 — 起 sprint 前内化协议补丁）：
   - [`retrospection/2026-05-11-v0-1-publish-flow.md`](../retrospection/2026-05-11-v0-1-publish-flow.md)（v0.1 publish flow + 4 anti-pattern 历史）
   - [`retrospection/2026-05-11-bridge-mockup-004-baseline-assumption-invalid.md`](../retrospection/2026-05-11-bridge-mockup-004-baseline-assumption-invalid.md)（baseline 假设失效 + tracker 范式）
   - [`retrospection/2026-05-11-package-rename-scope-alignment.md`](../retrospection/2026-05-11-package-rename-scope-alignment.md)（**重要** — Packages 页实物 verify 协议盲点）
4. [`AGENTS.md`](../../../AGENTS.md) 必读链路 §1-8（10min）
5. **当前 sprint task** → [`backlog.md`](../backlog.md) CANONICAL-010 entry（5min）

总 onboarding ~28min。

---

## 3. 任务队列（推荐路径）

### ✅ 第 0 步 — CANONICAL-010 PopupBox — **Resolved 2026-05-12**（commit `a61ee85e`）

> 已完成，跳过。

### ✅ 第 1 步 — Design Process Rules 整理收尾 — **Resolved 2026-05-13**（commit `d5461b53`）

**背景**：`dce05d0c`（2026-05-12）完成了 Steps 1-5 的**结构建设**——新文件创建 + 必读链路入口 + M-rules 分类 guide。但以下收尾工作**未完成**：

#### 缺口 A — `mockup-conventions.md` 未 thin out（最重要）

现状：
- `mockup-conventions.md` 仍 675 行，M22 / Pre-Phase 0 / M0 / M21 / M1-M22 **全部还在文件里**
- `design-process.md` + `domain-tvu.md` 已包含这些规则 → **内容重复**
- `Rule Category Guide` 里的 "最终迁移目标（Step 3）" 还未执行

目标状态：
- `mockup-conventions.md` → thin 入口（项目说明 + 必读链路 + **仅 Path A 专属内容**）
  - Path A 专属保留：真源 / 优先级 / 库归属验证 / M0 / M1 / M10（这些是 Figma-only 内容）
  - 通用 process rules（M22 / Pre-Phase 0 / M2 / M6 / M11 / M14 / M15 / M16 / M21）→ 只留指针（"see design-process.md"），删主体
  - TVU 业务规则（M3 / M4 / M5 / M7 / M8 / M9）→ 只留指针（"see domain-tvu.md"），删主体

#### 缺口 B — `AGENTS.md` 必读链路未更新

现状（line 41 + line 233）：
```
docs/internal/mockup-conventions.md — AI 画 mockup 时的硬约束（M1-M20 plan-owner 方法论硬规则）
```

目标状态（mockup 任务额外必读 §7 改为 3 条）：
```
7. docs/internal/design-process.md — 通用 process 规则（M22 / Pre-Phase 0 / M0 / M11 / M14 / M15 / M16 / M21 / M6）
8. docs/internal/domain-tvu.md — TVU 业务规则（M1 / M3-M5 / M7-M10）
9. docs/internal/mockup-conventions.md — Path A 专属（Figma 真源 / 组件取数优先级 / 库归属验证）
   + figma-technical-reference.md（Figma API quirks，实现时查）
```

#### 缺口 C — `STATUS.md` 起手必读链路未更新

"起手必读链路" 第 3-4 步还没提 `design-process.md` 和 `domain-tvu.md`。

#### 执行方式

此任务是**计划主导的文档整理**，执行者（Claude Code 或 Codex）均可直接在本 session 做：
1. 读 `mockup-conventions.md` 全文，识别 Path A 专属 vs 通用 vs TVU 业务规则
2. 删通用规则主体，留 1 行指针 `→ [design-process.md](./design-process.md)`
3. 删 TVU 业务规则主体，留 1 行指针 `→ [domain-tvu.md](./domain-tvu.md)`
4. 更新 `AGENTS.md` §Mockup 任务额外必读（line ~41）+ §SoT 表（line ~233）
5. 更新 `STATUS.md` 起手必读链路第 3-4 步
6. 跑 `grep -r "M[0-9]\{1,2\}" docs/internal/retrospection/ | grep -v "domain-tvu\|design-process\|mockup-conventions"` 确认 cross-ref 不 broken
7. STOP → 等用户审 → 1 commit（message: `docs(rules): thin out mockup-conventions + update AGENTS.md onboarding chain`）

**验收标准**：
- `mockup-conventions.md` < 200 行
- AGENTS.md line ~41 指向 design-process.md / domain-tvu.md / mockup-conventions.md（3 条）
- 无 broken M-code cross-ref

---

### 🥇 第 2 步 — INFRA-F29 Docs grid card hover（~1h，下个 session 起手优先）

按 [`backlog.md`](../backlog.md) INFRA-F29 entry §修复方向 A：

1. 跑 `pnpm dev` 浏览 docs site 列受影响 grid 组件（FigmaMembersGrid + IconPage + 其它）
2. 选 hover token：候选 `--bg-grey-btn-hv`（`Color Type/Background/Hover Grey Button`），dark-mode safe
3. 写 prompt `docs/internal/_prompts/infra-f29-grid-card-hover.prompt.md`
4. Executor 加 scoped CSS `:hover { background: var(--bg-grey-btn-hv); transition: background 0.15s ease; }` + 跑 `pnpm dev` 视觉验
5. 通过后 `pnpm audit:docs-site` 不破即 OK

### 🥈 第 3 步 — 0.1.3 release cycle 演练（user 操作 ~10min）

当 CANONICAL-010 + INFRA-F29 都完，跑 release flow：

```bash
pnpm changeset:status                   # 看 pending changesets
pnpm changeset:version                  # bump 0.1.2 → 0.1.3 + CHANGELOG
git add -A                              # selective add 避开 INFRA-F26 noise
git commit -m "release v0.1.3"
git tag v0.1.3
git push origin master --tags
```

**Verify 目标**（**按协议补丁强制**）：
1. CI workflow `Publish to GitHub Packages` for tag `v0.1.3` 全 green
2. **Packages 页实物**显示 `@nancyzeng0210/tvu-design-system@0.1.3`（**不能跳此步** — 协议盲点修复点 [memory feedback_release-verify-packages-page](.claude memory)）
3. STATUS.md `当前版本` 段更新到 v0.1.3 + 加 Packages URL evidence

---

## 4. Dirty 文件协议

User 多 session 并行；起手 git status 看到的 dirty 文件**默认假设别 session 进行中**，**不主动消化** unless user 明确说："消化这些文件"。

INFRA-F26 known noise（永远 dirty，不动）：
- `figma-data/normalized/tokenized-diff-report.json`
- `figma-data/published/icons/manifest.json`

如发现别 session dirty 多了，onboarding 报告时 explicit 标 "如果别 session 在跑可忽略"。

---

## 5. v0.1.x 其余 backlog（可任意 session 顺手做）

按优先级倒排：

- **CANONICAL-006 Pagination figma alignment refactor** — prompt 已写未 fire
- **CANONICAL-007 Pagination buttons → design system Button**
- **CANONICAL-008 Table+InputNumber Helvetica drift**
- **CANONICAL-004 Progress dark cell 视觉不可见**
- **CANONICAL-002 PromptMessage 不可交互 auto-dismiss**
- **BRIDGE-MOCKUP-001/002/003**（设计师 owner — 等 token / variant / promotion）

---

## 6. v0.2 minor preview

- **CANONICAL-011 Chart 实现**（~6-10h，BRIDGE-MOCKUP-004 tracker 子项 2/2）— 需 dep 选型 propose（chart.js / echarts / @vueuse 等）
- **INFRA-F20** Visual baseline (Playwright)
- **INFRA-F21** Pre-commit hooks (husky + audit gates)
- **INFRA-F24** Docs page theme injection 范式统一
- **INFRA-F25** audit suite formalization
- **INFRA-F26** extract timestamp idempotence

---

## 7. Plan owner closing checklist（每 session wrap-up 必看）

- [ ] STATUS.md "Last updated" 改到今天（hook 兜底）
- [ ] STATUS.md "当前版本" / "已 ship" / "Version Roadmap" 同步
- [ ] STATUS.md "Active 后续工作" 段刷新剩余项数
- [ ] **如本 session 含 release**：
  - [ ] CI workflow green
  - [ ] **Packages 页实物 verified**（不能跳 — 协议盲点 [memory feedback_release-verify-packages-page](.claude memory)）
  - [ ] STATUS.md `当前版本` 段加 Packages URL link as evidence
- [ ] 阶段完成后写 retrospect 到 `docs/internal/retrospection/<date>-<topic>.md`
- [ ] 加新 backlog entry 前 grep 全部已用 ID（[memory feedback_backlog-id-collision](.claude memory)）
- [ ] 决策点 pickup/backlog 已预分析 → 直接文本 propose，不弹窗
- [ ] One-shot prompt，不假分阶段（[memory feedback_one-shot-prompts](.claude memory)）
- [ ] Baseline 实跑后再相信 backlog 估值（差 >2x 触发 STOP 重路线，[memory feedback_baseline-before-plan](.claude memory)）
- [ ] Audit 报警 carrier 组件 → 白名单 + 注释 SOT 来源，不要 refactor SOT 凑工具（[memory feedback_audit-whitelist-vs-sot-refactor](.claude memory)）

---

## 8. 元说明

- **本文件生命周期**：CANONICAL-010 + INFRA-F29 + 0.1.3 release 完成后，挪 `_plans/archived/` 或重写覆盖（保留时间戳后缀）
- **如新 session 决定不按本顺序做**：重写一份覆盖本文件，不要在本文件里改
- **本 handoff 不是 prompt**：是 plan owner 给下个 session 的 onboarding 文档，不直接喂 executor