From 59e3dc2320532ae675495dc2f843fd8d7b5760da Mon Sep 17 00:00:00 2001 From: que01 Date: Mon, 31 Aug 2026 15:04:23 +0800 Subject: [PATCH] chore(task): narrow range validation to the kinds still affected MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The silently-inert case is fixed for crosswalk inset, so this task is down to the edge-offset case and the missing server-side check. Records the reusable shape — ceilings derived from geometry rather than declared as constants — and the trap that cost a round: two directional roads of one segment can meet at a junction serving different objects, so taking the first match publishes one road's bound on the other's handle. Co-Authored-By: Claude Opus 5 (1M context) --- .../tasks/08-31-constraint-range-validation/prd.md | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/.trellis/tasks/08-31-constraint-range-validation/prd.md b/.trellis/tasks/08-31-constraint-range-validation/prd.md index 276d0e8..3128cc2 100644 --- a/.trellis/tasks/08-31-constraint-range-validation/prd.md +++ b/.trellis/tasks/08-31-constraint-range-validation/prd.md @@ -10,9 +10,19 @@ 2. **过松且静默无效**——比上一种更糟,因为没有任何反馈。`junction-crosswalk-inset` 声明 `[0, 8]`,实测 `0 → 3.2` 线性响应,`3.2 → 8` **位移增量全为 0**。成因是 `crossingJunctionInset()` 中 `targetDistance = max(0, cutbackMeters - inset)` 在 inset 达到 `cutbackMeters` 后触底,外加 `CROSSWALK_MAX_JUNCTION_INSET_METERS = 4` 的封顶。声明范围里约 60% 是死区。 3. **无校验**——求解器不检查 manifest 的 `min`/`max`,范围目前仅由客户端夹值实际约束。 -第 2 种最需要优先修:手柄在死区里拖动毫无反应,与「控件坏了」无法区分, +> **第 2 种已于 2026-08-31 在 `08-28-crosswalk-element-editor` 中修复。** +> `src/compile/crossing-approach.js` 的 `effectiveCrosswalkInsetMax()` 按 +> `cutback - max(0, junctionDistance - 4)` 发布真实上界,8 组实测全部吻合, +> 且 fixture 证明几何字节不变。 +> +> 本任务因此**只需覆盖其余 kind**——尤其是第 1 种(外缘偏移)。 +> 那次修复也给出了可复用的形态:**上界由几何推导,不是常量**; +> 以及一个易犯的坑:一条 segment 的两条方向道路可能在同一路口服务不同对象, +> 取第一个匹配会把 A 的上界发到 B 的手柄上。 + +第 1 种仍待处理:手柄在死区里拖动毫无反应或直接报错,与「控件坏了」难以区分, 正是 `flag.ts` 为 `profile.interval` 立下的那条规矩要避免的情形 -(「一个拖了没效果的控件比没有控件更糟」),只是它发生在量程的上半段而非整个控件。 +(「一个拖了没效果的控件比没有控件更糟」),只是它发生在量程的一段而非整个控件。 ## 已确认的事实