更新换行算法和APP-PUSH

spec_kit/Text Wrap/modules/golden-tests/plan.md

@@ -0,0 +1,57 @@
+# golden-tests（技术计划）
+
+## 1. 计划目标
+
+建立可持续回归体系，覆盖：
+
+- **Golden Cases**：固定输入 → 固定输出（lines/wrappedText/meta），作为“可治理基线”
+- **性质测试（property tests）**：
+  - 确定性：同输入多次调用输出一致
+  - 近似单调性：availableWidth 变小不会让任一行变得更宽（同测量口径下）
+  - maxLines 不变差：maxLines 增加时至少不从可解变 overflow
+
+本模块产出测试数据与测试规则，不产出业务功能。
+
+## 2. 约束与策略
+
+### 2.1 测量可控
+
+- APP：使用稳定的测量 mock（例如 `width = text.length`）保证 CI 可运行
+- WIDGET：使用固定 profile 或 `widthMode=APPROX`（单位为 tokenCount/graphemeCount）
+
+### 2.2 Golden 的组织方式
+
+- 采用 TS fixture（便于类型校验与可读性）
+- Golden case 至少包含：
+  - `text/lang/context/availableWidth/maxLines/overflowMode/lineMode/configVersion`
+  - 期望：`expected.lines/expected.wrappedText`（可选 meta 断言）
+
+### 2.3 覆盖面（首版）
+
+首版优先覆盖“易回归且高价值”的样例集：
+
+- EN/TC 各若干条：短/长、含标点/无标点、含 emoji、含 shift/accum/self、极窄宽度
+
+> 说明：文档建议每种语言 20 条；首版先落最小可运行集合，后续迭代扩充但保持可解释与版本化。
+
+## 3. 测试实现结构（客户端）
+
+- `client/src/features/textWrap/golden/fixtures.ts`（Golden cases）
+- `client/src/features/textWrap/golden/__tests__/golden.test.ts`
+  - Golden 断言（lines/wrappedText）
+  - 性质测试（determinism/monotonic/maxLines）
+
+测试内暂时使用“测试版 wrapTextHarness”把已实现模块串起来：
+
+- normalize/tokenize（EN=tokenizeEN，TC=segmentGraphemes）
+- generateBreakpoints
+- search-engine-app / search-engine-widget
+
+待 integration 模块产出正式 `wrapText()` 后，再把测试入口切到正式函数（不改变期望数据）。
+
+## 4. 完成定义（DoD）
+
+- Golden fixtures + 测试可在 CI 一键运行
+- 至少包含 EN/TC 的基础样例与 3 类性质测试
+- overview 更新记录变更文件
+