# Backlog — 延后任务 / 技术债 / 已知 bug

> **项目级真源**。所有 AI 工具（plan owner / executor）在新 session onboarding 时**必读**这个文件，识别：
>
> 1. 当前任务路径上是否需要顺手处理某条 backlog
> 2. 某条 backlog 的"触发查看"条件是否被当前任务命中
>
> 维护规则：
>
> - 完成的条目**直接删除**（具体改动在 git 历史，重要复盘在 `retrospection/`，高层摘要在 `STATUS.md` "已 ship" 段）
> - 新增条目按类别 prefix 编号：
>   - `CANONICAL-*`：canonical 层 bug / 视觉 / API
>   - `BRIDGE-*`：bridge layer (T2/T4) 任务 / 工作流
>   - `EXTRACT-*`：figma-sync extract pipeline 问题
>   - `META-*`：跨工具 / 元规则 / 协作机制
>   - `INFRA-*`：tsconfig / build / typecheck 等基础设施
> - 每条 entry 必须含：发现时间 + 触发查看条件 + 阻塞关系（避免 backlog 退化为"永远的未来 TODO"）

---

## Active

### BRIDGE-MOCKUP-002: TVU 库 `icon/Arrow/Sorting` 需补 Ascending / Descending variants

- **优先级**：Low（mockup 缺 sort indicator default state 视觉）
- **发现时间**：2026-05-09（MicroApps mockup table header 想给 State 列默认 desc sort 但库 sort icon 是单 component 无 variant）
- **现状**：
  - `icon/Arrow/Sorting` (key `36c09416aa4fef6c139b05dd9e4683884acbeea7`) 是单 COMPONENT，**不是 component_set**
  - 无 `Sort Ascending` / `Sort Descending` variant 表达"当前列已按何方向排序"
  - mockup 中所有 sort icon 都是 inactive 中性态，不能展示 default sort UX
- **建议**：
  - 改造为 component_set，加 variant property `direction: none | asc | desc`
  - 或新增独立 component `icon/Arrow/Sort Ascending` + `icon/Arrow/Sort Descending`
- **触发查看条件**：任何 table-heavy mockup 需要展示当前 sort 状态
- **阻塞关系**：不阻塞；mockup 交付时 sort indicator 用 default neutral icon 占位即可
- **关联**：[`docs/internal/retrospection/2026-05-09-microapps-mockup-retrospect.md`](retrospection/2026-05-09-microapps-mockup-retrospect.md)

---

### BRIDGE-DESIGN-REVIEW: Off-scale figma 值（设计师 review backlog）

- **优先级**：Low（不影响 v0.1 alignment 主流程，长期 design quality 维护）
- **发现时间**：2026-05-07（Phase X.2 audit value sub-type 分类识别）
- **现状**:
  - figma 真源中存在与 design system spacing scale (4/8/12/16/24/32/40/56) 不对齐的 px 值
  - 类型 C "off-scale": 奇数 px (11px / 9px / 13px) / scale 倍数外
  - audit `value-figma-only` finding 自动标 sub-type C
- **典型例子**(audit report 实证):
  - Notification: 264px / 392px / 70px / 10px
  - Pagination: 80px (Simple `<>` row)
- **建议处理**:
  - off-scale 值入本 backlog → 设计师 review 决定:
    - **设计意图** → 加 domain token (`--<component>-<role>-<dim>`)
    - **设计 bug** → figma 改齐 design system scale
- **触发查看条件**:
  - audit value-figma-only finding sub-type "C off-scale" 命中 → component 名累积入本 entry
  - 累积每周 design review
- **阻塞关系**: 不阻塞 Phase X

---


### INFRA-F21 v2/v3/v4: Pre-commit hook 余下增强

- **优先级**：Low（v1 已 done v0.2.0，余下增强非阻塞）
- **背景**：v1 完成 git pre-commit hook (vue-tsc / vitest / figma-data block)；v2-v4 是 deferred enhancements
- **v2**：alignment audit error 数不升 gate（**前置依赖**：F25 audit baseline 机制）
- **v3**：lint-staged + prettier + eslint（**前置依赖**：user code-style 决策）
- **v4**：Claude Code session-level L0 PostToolUse hook (hex literal warn / figma-data warn) — out-of-repo update-config 范围
- **阻塞关系**：v2 依赖 F25；v3 依赖 code-style 决策；v4 不属本 repo
- **关联完成历史**：commit 0d9332b6 (v1) — 详见 [retrospect 2026-05-13-v020-release](retrospection/2026-05-13-v020-release-and-infra-f30.md)

---

### INFRA-F25 docs-page-bg-contrast audit（仅剩 1 项）

- **优先级**：Medium
- **背景**：F25 audit suite 共 5 项；4 项已 done 进 prepublishOnly（`audit:icon-fill-currentcolor` / `audit:component-no-inline-svg` / `audit:no-hardcoded-design-tokens` / `export-icons.mjs currentColor generator` ）。剩 `audit:docs-page-bg-contrast` 一项 — 与 a11y-token-contrast 部分重叠，可合并或独立。
- **触发查看条件**：用户在新 session 说"开 F25-bg-contrast"，或 contrast cleanup（v0.7.0）阶段顺路实现
- **阻塞关系**：不阻塞

---

## 元说明

- 本文件**不是** v2 plan 的延伸——v2 plan 是 roadmap（路线 / 轨道 / 里程碑），backlog 是**已知问题清单**（可以独立排期）
- 当前散落在 retrospection 多份 `.md` 的"待办"段（如 [t4-spike-validated.md](retrospection/2026-04-30-t4-spike-validated.md) 的"隐性风险扫描"段）**未** consolidate 进本文件——**后续可单独决策是否迁移**
- 已加入 [AGENTS.md 必读链路](../../AGENTS.md) 第 6 项 + Quick Reference（commit 同步）