# Next Session Pickup — 2026-05-11 Rename Pivot

> **取代** [`next-session-pickup-2026-05-12.md`](./next-session-pickup-2026-05-12.md)（假设 v0.1.1 ship 成功，已失效）。
> **起手按 STATUS.md 必读链路**：本文件 → AGENTS.md → backlog 当前条目。
> **新 session 是 review/verify 角色**，不直接执行——两个 task 在并行别 session 执行中。

---

## TL;DR（3 句）

1. **v0.1.0 / v0.1.1 实际从未 publish 成功** —— scope mismatch（`@tvu` vs owner `NancyZeng0210`），Packages 页全空。协议盲点：之前 wrap-up 没 verify Packages 页，纯靠 tag pushed + commit msg "🎉" 信号被骗 1-2 周。
2. **正在 pivot：改包名 → `@nancyzeng0210/tvu-design-system`，重发为 v0.1.2 patch** —— CANONICAL-009 session 执行 16 文件 rename + B-H 步骤。
3. **MicroApps Console session 并行**：在画 Cost per Token Trend mockup（Pre-TVU 产品的 US-3 增量 + M21/R6 实战检验）。

---

## 任务 1 — v0.1.2 Rename Publish

**Owner**: CANONICAL-009 session（plan-owner 角色）+ Codex executor
**当前状态**: 已发送完整 B-H 执行指令，等 grep verify + rename execution + CI PASS + Packages verify

**Rename 影响文件清单（16 必改）**:

| 类别 | 文件 |
|---|---|
| Code/Config | `package.json`（name 字段）/ `.github/workflows/publish.yml:29`（scope）/ `src/components/Badge/Badge.figma.ts:8`（Code Connect 字符串）|
| 用户文档 | `README.md`（9 处）/ `docs/GETTING_STARTED.md`（7 处）/ `docs/RELEASING.md`（4 处）|
| 项目元 docs | `docs/STATUS.md` / `docs/PROJECT_GOAL.md` / `docs/PROJECT_MAP.md` / `docs/internal/backlog.md`（NPM-001/002 install 描述） |
| Docs site usage | `playground/docs/pages/{TopBar,Button,Pagination,Table,Slider,Icon}Page.vue` |
| CHANGELOG | 新增 `[0.1.2]` entry（**不动** `[0.1.0]` 历史段） |

**不动清单（historical artifacts）**:
- `docs/internal/retrospection/*` — 历史复盘快照
- `docs/internal/_prompts/*.prompt.md` — 已 fire prompt artifact
- `docs/internal/_plans/archived/*` — 归档 pickup
- `docs/internal/long-term-plan-v2-2026-04-29.md` — 历史 plan

**v0.1.0 / v0.1.1 tag 保留**作为 failed publish 历史 artifact（不删）。

**Verify 步骤（CI 完成后必做，**协议盲点修复点**）**:

1. https://github.com/NancyZeng0210/TVU-Design-System/actions — CI green ✓
2. https://github.com/NancyZeng0210/TVU-Design-System/packages — **实际显示** `@nancyzeng0210/tvu-design-system@0.1.2`
3. **❌ 不能跳第 2 步**（这是 v0.1.0/0.1.1 错判的根因）

**Retrospect 落点**: `docs/internal/retrospection/2026-05-11-package-rename-scope-alignment.md`
关键 5 段：失败诊断 / 协议盲点 / 修复 / Memory（`feedback_release-verify-packages-page.md`）/ Meta lesson。

**协议补丁（PASS 后落 STATUS.md + R5）**:
- STATUS.md wrap-up checklist 加："release tag pushed + CI PASS 后必须 verify Packages 页实际显示包，不能只看 CI green"
- R5 §7 ledger 加列 "Packages 页 verified"
- code-conventions R5 加 mandatory step: release 类任务 wrap-up 必含 packages page link as evidence

---

## 任务 2 — Cost per Token Trend Mockup

**Owner**: MicroApps Console session（在 consumer product cwd）
**当前状态**: 准备开始 Step 1 build（clone sibling 1641:2213 → 改 target page 1749:93 → 设 placeholder shimmer）

**关键决策已拍板**（不重 ask）:
- 配色：**(b) dark theme rebuild**（sibling 视觉合同是 dark）
- 标题位置：**顶部**（M14 优先级 > M21 在 element 位置维度）
- Tab/square 标签：**"Annual YTD" / "30-day YOY"**
- 新菜单 "Cost per Token"：**顶级 menu item pos4 (i)**（已 implicit 决定，待 verify sibling Top bar 范式 confirm）

**关键决策 pending**（next propose 等 confirm）:
- Top bar 顶级 menu items 现有清单 propose（AI 该 explicit list 出来再 confirm (i)/(ii)）
- 新 menu item "Cost per Token" 视觉风格 verify：sibling 现有 menu items 是不是 library Menu instance（若是 → 用 library Menu，若 detached → mirror sibling 自画 style）

**已 commit（TVU repo 端）**:
- `3060d296` 加 **M21**（mockup）+ **R6**（code）—— US-3 增量优先复用 local
- 含 sub-clause: pre-design-system 时代 page 违反 M1/M2/M4/R0-R3 ≠ "local 有 bug" 例外

**M21/R6 关键边界**（reference page 红线）:

| Reference / sibling page 在 US-3 scope 下 | 该用法 |
|---|---|
| 视觉合同来源 | ✅ mirror |
| Pattern / layout 复用 source | ✅ instance / mirror |
| Audit 目标 | ❌ 不审查它合不合 TVU |
| Fix 目标 | ❌ 不 propose 修改它 |
| anti-pattern 发现处 | ⚪ 记 backlog 作 legacy debt，**不在本任务 fix** |

**Vintage 区分**（user 显式细化）:
- 新产品 → TVU 合规（M2）
- 原产品新功能（pre-TVU 时代）→ 优先现有设计 mirror（M21），欠缺的用 TVU 拓展
- "欠缺" 指 sibling 不存在的元素；menu item 这种 sibling 已有的不算"欠缺"

---

## 起手必读链路（新 session 按此跑）

1. **本文件**（3min）—— 当前两 task 状态
2. [`docs/STATUS.md`](../../STATUS.md)（3min —— 全局状态）
3. [`docs/PROJECT_GOAL.md`](../../PROJECT_GOAL.md)（5min）
4. [`AGENTS.md`](../../../AGENTS.md) 必读链路 §1-8（10min）
5. 任务 1 上下文 → [`backlog.md`](../backlog.md) CANONICAL-009 entry + 最新 retrospect
6. 任务 2 上下文 → MicroApps Console handoff（在 consumer product cwd 下，等会 user 告诉路径）

---

## 协议测试结果汇总（截至 2026-05-11）

到目前为止协议已 e2e 跑通 + 暴露 1 个真实盲点 + 自纠完成：

| 协议机制 | 实战证据 |
|---|---|
| STATUS.md 起手必读 | ✅ 新 session 第一份读 |
| 5 步 onboarding 链路 | ✅ 自主跑完 |
| Convention Priority P0-P3 | ✅ M21 与 M2/M14 disambiguate 用上 |
| Pre-Phase 0 US-3 跳过 | ✅ Cost per Token Trend 直接进 build |
| Lazy Reference 三阶段 | ✅ catalog grep + figma probe 按需 |
| M21/R6 实战诞生 | ✅ probe 实证 + sub-clause 细化 |
| Retrospect 触发分级 | ✅ 多份 2026-05-11 产出 |
| AI 自纠 | ✅ 配色 (a)→(b) / 撤回 "detached anti-pattern" 判断 |
| AI 主动 propose 协议改进 | ✅ "M21 sub-clause defer commit 不打断 build" |
| SessionEnd hook | ✅ 设置完成 |
| **release verify Packages page** | ❌ **盲点已暴露 → 修复中（任务 1）** |

---

## 新 session 角色说明

**你是 plan-owner / review 角色**，不是 executor：

- ✅ 读两个 task 的状态报告
- ✅ 评估 AI 提出的决策 / propose
- ✅ 给出 OK / 微调 / 否决回应
- ✅ verify CI / Packages page 实际状态
- ✅ wrap up 时按协议更新 STATUS.md / 写 retrospect
- ❌ 不直接执行 rename / 不直接 build mockup（那是 executor session 的事）

**用户会贴别 session 的 reply 给你审**，你输出可粘贴的 review 文案让用户中转。

---

## 元说明

- **本文件生命周期**：任务 1 PASS + 任务 2 Cost per Token Trend page 完工后归档到 `_plans/archived/`
- **若新 session 决定改路线**：在新 session 重写覆盖本文件（保留 timestamp 后缀），不要在本文件里改
- **dirty 文件协议**：检查 `git status`；若 `figma-data/normalized/tokenized-diff-report.json` dirty 那是 INFRA-F26 known issue 不动