diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md index e921359..11e94e1 100644 --- a/.planning/ROADMAP.md +++ b/.planning/ROADMAP.md @@ -80,8 +80,25 @@ Plans: 2. 移动端点击地图上的可达格时，角色自动寻路移动到该格 3. 寻路正确避开不可通行格（碰撞/障碍/墙体） -**Plans**: TBD +**Plans**: 3 plans **UI hint**: yes +Plans: + +- [ ] 02-01-PLAN.md — 接口草案 + mover.ts:651 缺陷调查 + 回归脚手架 + D-07 用户拍板关卡（checkpoint） +- [ ] 02-02-PLAN.md — L0 坐标回写缺陷修复 + L2 寻路核心（有向图 + 最小损失 + 仅取路径 + 回退策略槽位） +- [ ] 02-03-PLAN.md — L3 接线（逐步/瞬移/回退默认策略/D-08 双语义/打断接管）+ barrel/logger 装配 + 阶段门禁 + +**Wave 1** + +- [ ] 02-01-PLAN.md — 接口草案与拍板关卡（autonomous: false） + +**Wave 2** *(blocked on Wave 1 用户拍板)* + +- [ ] 02-02-PLAN.md — L0 修复 + L2 寻路核心 + +**Wave 3** *(blocked on Wave 2)* + +- [ ] 02-03-PLAN.md — L3 接线与阶段门禁 ### Phase 3: 数据端完成 diff --git a/.planning/phases/02-pathfinding/02-01-PLAN.md b/.planning/phases/02-pathfinding/02-01-PLAN.md new file mode 100644 index 0000000..887399b --- /dev/null +++ b/.planning/phases/02-pathfinding/02-01-PLAN.md @@ -0,0 +1,170 @@ +--- +phase: 02-pathfinding +plan: 01 +type: execute +wave: 1 +depends_on: [] +files_modified: + - .planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md + - packages-user/data-common/src/common/mover.test.ts +autonomous: false +requirements: [PATH-01, PATH-02] +estimate: + tokens: 45000 + raw_tokens: 45000 + tasks: 3 + confidence: low +must_haves: + truths: + - "接口草案文档存在，含完整可拍板的签名清单（寻路系统接口、损失函数、回退策略、通行性谓词类型）与文件归属层提案，生产代码零改动 (D-01, D-02, D-03, D-04, D-05, D-06)" + - "草案显式并列 D-08 OnTouch 派发方案 A（直派 executor，构造 IBlockEventEnv）与方案 B（撞击步，注明对 inPass=0 目标不生效）供用户拍板 (D-08)" + - "草案含打断时序两个选项（stop 后 await 兑现 vs onEnd 回调驱动）与图方向性选项（4 向默认 vs 8 向）(D-10)" + - "草案声明本阶段只交付数据端移动入口，渲染端点击接线属 Phase 4 (D-11)" + - "mover.ts:651 坐标回写条件缺陷（&& 疑为 ||）的调查结论与 go/no-go 问题已呈现在草案中 (D-07)" + - "执行在本计划末尾的 checkpoint 处停止，用户逐项拍板前不开始任何实现任务 (D-07)" + artifacts: + - ".planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md" + - "packages-user/data-common/src/common/mover.test.ts" + key_links: + - "02-02 与 02-03 的全部实现任务依赖本计划 checkpoint 的用户拍板结果；拍板修改由执行者逐字应用" + assumptions: + - "PATH-01（flagged assumption，spec-less probe 未分类）：引擎支持自动寻路——本阶段以数据端寻路系统实现且 Node 可验证，覆盖于 02-02/02-03" + - "PATH-02（flagged assumption，spec-less probe 未分类）：移动端点击地图触发自动寻路——本阶段仅交付数据端移动入口供渲染端调用，点击接线按 D-11 延迟至 Phase 4 渲染适配" + prohibitions: + - "不得为寻路引入任何新 npm 依赖（零依赖约束，Dijkstra 自写约 40 行）" + - "不得把渲染端点击处理接进数据端代码 (D-11)" + - "未经用户拍板不得实现 D-08 OnTouch 派发方案或 mover.ts:651 修复 (D-07)" +--- + + +为寻路系统产出可拍板的接口草案（含全部待决选项），实证确认 L0 mover.ts:651 坐标回写缺陷并铺设其回归测试脚手架，然后在 checkpoint 处停止，等待用户对接口签名、文件归属、P1 修复 go/no-go、D-08 方案 A/B、打断时序与图方向性逐项拍板。 + +Purpose: D-07 明锁「AI 起草 → 用户修改拍板后才实现」；本计划是全阶段唯一的 Wave 1，是后续所有实现计划的闸门。 +Output: 02-INTERFACE-DRAFT.md（草案 + 决策问题清单）、mover.test.ts 回归脚手架（skip 状态）、用户拍板记录。 + + + +@C:/Users/book/.config/opencode/gsd-core/workflows/execute-plan.md +@C:/Users/book/.config/opencode/gsd-core/templates/summary.md + + + +@.planning/PROJECT.md +@.planning/ROADMAP.md +@.planning/STATE.md +@.planning/phases/02-pathfinding/02-CONTEXT.md +@.planning/phases/02-pathfinding/02-RESEARCH.md +@.planning/phases/02-pathfinding/02-PATTERNS.md + +# 草案要引用的既有接口面（只读，不修改） +@packages-user/data-common/src/common/mover.ts +@packages-user/data-common/src/store/types.ts +@packages-user/data-common/src/common/types.ts +@packages-user/data-common/src/event/types.ts +@packages-user/data-base/src/map/types.ts +@packages-user/data-base/src/hero/types.ts +@packages-user/data-state/src/hero/moverImpl.ts +@dev.md + + + + + + Task 1: 起草寻路系统接口草案与决策问题清单 + .planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md + packages-user/data-common/src/common/mover.ts, packages-user/data-common/src/store/types.ts, packages-user/data-common/src/common/types.ts, packages-user/data-common/src/event/types.ts, packages-user/data-base/src/map/types.ts, packages-user/data-base/src/hero/types.ts, packages-user/data-state/src/hero/moverImpl.ts, .planning/phases/02-pathfinding/02-RESEARCH.md, .planning/phases/02-pathfinding/02-PATTERNS.md, dev.md + 创建 02-INTERFACE-DRAFT.md（中文，含 TS 声明代码块），全部命名标注「DRAFT 待拍板」。内容六节： + (1) 接口签名草案——按 dev.md 命名/注释/类型规范书写完整 interface/type 声明：寻路系统主接口（绑定 `IMapLayer` 与 `IObjectMovable` 的 `useXxx()` 注入槽位，per D-03；仅取路径方法 per D-06；逐步/瞬移两种移动方式入口 per D-04；打断入口 per D-10）、损失函数类型（默认每格损失 1，per D-01）、回退策略函数类型（入参为路径及每步到达位置，per D-05）、通行性谓词类型（L2 不 import L3，谓词由 L3 注入，per RESEARCH 分层论证）。绑定面直接引用既有 `IObjectMovable`/`IMapLayer`/`ITileLocator`/`ObjectMoveStep`/`EventTrigger`，勿重定义。 + (2) 文件归属提案——L2 `packages-user/data-system/src/pathfinding/`（types/graph/system/index）+ L3 `packages-user/data-state/src/pathfinding/heroPathfinding.ts`（RESEARCH 建议，用户可改）。 + (3) D-08 两方案并列——方案 A：到达相邻格后直接构造 `IGameEventInvocation`（trigger=`EventTrigger.OnTouch`，heroLocator=相邻格，triggerLocator=目标格），env 构造逐字复刻 moverImpl.ts:206-222 `commonTrigger` 形态调 `executor.execute`；方案 B：追加朝向目标的撞击步复用 hit 链，并注明 P2 结论——`inPass=0` 真 no-pass 格走 `CannotMove`（`cannotEnter` 为空实现），方案 B 对本场景不生效。推荐 A，由用户拍板 (D-08)。 + (4) P1 缺陷调查——逐字引用 mover.ts:651 条件 `this.tile.x !== loc.x && this.tile.y !== loc.y`，给出「正交步永不回写坐标 → 多步寻路自第二步起以陈旧原点计算」的推理链，提出修复为 `||`，列出 go/no-go 问题（若非缺陷须由用户提供替代回写语义）。 + (5) 打断时序两选项——选项 1：`stop()` 后 await 兑现再查新位置起新寻路；选项 2：`onEnd` 回调驱动。注明 mover.start() 移动中返回 null（mover.ts:669-670）与 stop 在当前步完成后兑现的语义约束 (D-10)。 + (6) 图方向性选项——默认仅 4 正交向（与 PassBit 四位掩码一致，moverImpl canPass 对斜向直接放行不做图边）vs 含 8 向；列利弊供拍板。 + 禁止在本任务修改任何 packages/ 或 packages-user/ 下的生产代码；草案是唯一交付物（per D-07，实现待拍板）。 + + if (!(Test-Path ".planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md")) { exit 1 }; $c = Get-Content -Raw ".planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md"; if (!($c -match "IPathfindingSystem")) { exit 1 }; if (!($c -match "方案 A")) { exit 1 }; if (!($c -match "方案 B")) { exit 1 }; if (!($c -match "mover\.ts:651")) { exit 1 } + 命令以退出码 1 结束——草案文件不存在，或正文中找不到 IPathfindingSystem 签名、D-08 方案 A/B 并列、或 mover.ts:651 缺陷引用任一项 + + + - 草案文件存在且含完整 interface/type 声明代码块，覆盖绑定槽位、仅取路径、两种移动方式、打断入口（行为断言） + - D-08 方案 A 与方案 B 同时出现且各有语义说明与推荐标注（行为断言） + - P1 缺陷含逐字代码引用、推理链与 go/no-go 问题（行为断言） + - 生产源码目录无任何本任务改动：`git status --porcelain packages-user packages` 输出为空（CLI 断言） + + 02-INTERFACE-DRAFT.md 完整覆盖六节内容，生产代码零改动。 + + + + Task 2: 铺设 L0 mover 坐标回写回归测试脚手架（skip 状态） + packages-user/data-common/src/common/mover.test.ts + packages-user/data-common/src/common/mover.ts, packages-user/data-system/src/event/eventDispatch.test.ts, packages-user/data-common/src/store/types.ts, dev.md + 新建 L0 回归测试文件，完整编写 4 个用例但以 `it.skip` 状态提交（套件保持绿色，待 02-02 修复后翻绿）：(a) 正交步（仅 x 变化）后 `setPos` 回写 x；(b) 正交步（仅 y 变化）后回写 y；(c) 斜向步后双轴回写；(d) 传送步（`ObjectMoveType.Teleport`）后双轴回写。测试桩逐字复刻 eventDispatch.test.ts:19-33 模式：`vi.hoisted` 内 `vi.stubGlobal('main', { replayChecking: true })` 与 `vi.stubGlobal('location', { origin: 'http://localhost' })`、`Map.prototype.getOrInsertComputed` polyfill、动态 import 被测模块。每个 `it` 前必须有单行中文注释说明覆盖内容（dev.md 硬规则）；CRLF 换行；普通引入无 `import type`。用例构造最小 ObjectMover 子类驱动 `moveProgress` 所需的步骤与钩子，不引入任何新依赖。本任务不改 mover.ts 生产代码——缺陷修复属 02-02，须经用户 go/no-go（D-07）。 + + pnpm exec vitest run "packages-user/data-common/src/common/mover.test.ts" + vitest 输出出现 "failed" 字样或非零退出码；或 4 个用例未以 skipped 状态出现（说明 skip 脚手架写错导致用例实际执行并失败） + + + - 测试文件存在且含 4 个 skip 用例，分别覆盖 x 正交、y 正交、斜向、传送步的坐标回写（行为断言） + - 测试桩包含 main.replayChecking stub、location stub 与 getOrInsertComputed polyfill（行为断言） + - `git status --porcelain packages-user/data-common/src/common/mover.ts` 输出为空——生产代码未被修改（CLI 断言） + + mover.test.ts 以 4 个 skip 用例通过 vitest（0 failed），生产代码零改动。 + + + + Task 3: 用户拍板接口草案与全部待决选项（D-07 关卡） + .planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md + .planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md + 停止执行，向用户逐项呈现并等待拍板（用户可直接编辑草案文件，执行者须逐字应用其修改）： + 1. 接口签名清单——主接口命名、方法签名、注入槽位命名、损失/回退/谓词函数类型签名（D-01…D-06 的接口面）； + 2. 文件归属层——L2/L3 文件放置提案或用户调整； + 3. P1 修复 go/no-go——mover.ts:651 条件是否确认为缺陷并授权改为 `||`（若否，用户提供替代坐标回写语义）； + 4. D-08 OnTouch 派发——方案 A（直派 executor）或方案 B（撞击步）； + 5. 打断时序——stop 后 await 兑现，或 onEnd 回调驱动； + 6. 图方向性——仅 4 正交向，或含 8 向。 + 将用户每项决定（含「按草案原样」）追加记录到草案文件末尾「拍板记录」节。未获全部六项拍板前，不得开始 02-02/02-03 的任何实现任务。 + 寻路系统接口草案（含签名清单、文件归属、D-08 两方案、P1 go/no-go、打断时序、图方向性六项待决事项）已就绪，等待用户逐项拍板 + 阅读 .planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md 全文，对文中六个决策项逐一给出结论（可直接编辑草案文件修改签名/命名/归属，执行者将逐字应用） + 逐项回复六项决策结论（或「按草案原样」），或直接修改草案文件后回复 approved + + $c = Get-Content -Raw ".planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md"; if (!($c -match "拍板记录")) { exit 1 }; if (!($c -match "go/no-go")) { exit 1 }; if (!($c -match "方案 [AB]")) { exit 1 } + 命令以退出码 1 结束——草案文件末尾没有「拍板记录」节，或六项决策中任一项缺少用户的明确结论 + + + - 用户对六项决策（接口签名、文件归属、P1 go/no-go、D-08 方案、打断时序、图方向性）各给出明确结论（人工确认） + - 拍板记录节完整记录每项结论及用户对草案的直接修改（行为断言） + + 六项决策全部经用户拍板并记录在案，02-02/02-03 可依拍板结果执行。 + + + + + +## Trust Boundaries + +| Boundary | Description | +|----------|-------------| +| 地图/存档数据 → 寻路图构建 | 不可信或损坏的地图数据（越界坐标、缺失图层、畸形掩码）将进入图构建与搜索（02-02/02-03 消费） | + +## STRIDE Threat Register + +| Threat ID | Category | Component | Severity | Disposition | Mitigation Plan | +|-----------|----------|-----------|----------|-------------|-----------------| +| T-02-01 | Tampering/DoS | 图构建入口（02-02 graph.ts） | medium | mitigate | 草案中明确边界守卫要求：`IMapLayer.inMap` 守卫 + `isNil` 判空 + 非法输入 logger.warn 数字码后返回空路径（本任务落草案，实现落 02-02） | +| T-02-02 | Tampering | 自定义损失函数（02-02 system.ts） | medium | mitigate | 草案中明确损失值守卫：非有限数/负数 → logger.warn 新码并按默认损失 1 处理（实现落 02-02） | +| T-02-SC | Tampering | npm/pip/cargo installs | low | accept | 本阶段零新依赖（RESEARCH Package Legitimacy Audit：无安装对象），无供应链面 | + + + +- 草案文件存在且六节齐备，D-08 两方案、打断时序、图方向性均已并列呈现 +- mover.test.ts 4 用例 skip 通过，生产代码零改动 +- 「拍板记录」节含全部六项用户结论 + + + +用户在 checkpoint 处完成六项拍板；接口草案与 P1 调查成为 02-02/02-03 的执行依据；本计划全程未修改任何生产代码。 + + + +Create `.planning/phases/02-pathfinding/02-01-SUMMARY.md` when done + diff --git a/.planning/phases/02-pathfinding/02-02-PLAN.md b/.planning/phases/02-pathfinding/02-02-PLAN.md new file mode 100644 index 0000000..6c5b413 --- /dev/null +++ b/.planning/phases/02-pathfinding/02-02-PLAN.md @@ -0,0 +1,173 @@ +--- +phase: 02-pathfinding +plan: 02 +type: execute +wave: 2 +depends_on: ["02-01"] +files_modified: + - packages-user/data-common/src/common/mover.ts + - packages-user/data-common/src/common/mover.test.ts + - packages-user/data-system/src/pathfinding/types.ts + - packages-user/data-system/src/pathfinding/graph.ts + - packages-user/data-system/src/pathfinding/system.ts + - packages-user/data-system/src/pathfinding/index.ts + - packages-user/data-system/src/pathfinding/graph.test.ts + - packages-user/data-system/src/pathfinding/system.test.ts +autonomous: true +requirements: [PATH-01, PATH-02] +estimate: + tokens: 70000 + raw_tokens: 70000 + tasks: 3 + confidence: low +must_haves: + truths: + - "mover.ts:651 坐标回写条件按用户拍板结果修复，L0 回归 4 用例（x 正交/y 正交/斜向/传送）全部翻绿 (D-07)" + - "有向图构建正确：边 = outPass(source) 含方向位且 inPass(dest) 含反向位，单向门 A→B 可行而 B→A 不可行有测试 (D-02)" + - "最小损失搜索满足 D-01：默认每格损失 1，可注入自定义损失函数，返回两点间损失最小路径 (D-01, D-02)" + - "仅取路径 API 存在且不移动任何对象 (D-06)" + - "不可达目标按 D-08 情形 2 返回空数组且不移动 (D-08)" + - "回退策略槽位存在：策略函数接收路径及每步到达位置并决策移动方式（瞬移或退为逐步）(D-04, D-05)" + - "绑定面为 IMapLayer 与 IObjectMovable 注入槽位，L2 未引用 L3 任何符号 (D-03)" + artifacts: + - "packages-user/data-common/src/common/mover.ts" + - "packages-user/data-common/src/common/mover.test.ts" + - "packages-user/data-system/src/pathfinding/types.ts" + - "packages-user/data-system/src/pathfinding/graph.ts" + - "packages-user/data-system/src/pathfinding/system.ts" + - "packages-user/data-system/src/pathfinding/index.ts" + - "packages-user/data-system/src/pathfinding/graph.test.ts" + - "packages-user/data-system/src/pathfinding/system.test.ts" + key_links: + - "graph.ts 消费注入的通行性谓词而非 import L3，谓词复刻 moverImpl canPass 的掩码语义（事件层恒参与，其余层仅 onlyEvents 参与）" + - "system.ts 的损失/回退/谓词槽位由 02-03 的 L3 接线注入" + assumptions: + - "PATH-01（flagged assumption，spec-less probe 未分类）：本计划交付自动寻路的纯计算核心（图构建 + 最小损失搜索 + 仅取路径），Node 可验证" + - "PATH-02（flagged assumption，spec-less probe 未分类）：本计划提供的仅取路径 API 即渲染端 Phase 4 将调用的数据端入口之一，点击接线不在本阶段 (D-11)" + prohibitions: + - "不得为寻路引入任何新 npm 依赖（Dijkstra 自写，零新包）" + - "不得把渲染端点击处理接进数据端代码 (D-11)" + - "接口签名必须与用户拍板后的草案逐字一致，不得自行更名或改层 (D-07)" +--- + + +按用户拍板结果修复 L0 mover.ts:651 坐标回写缺陷并翻绿回归测试，然后在 data-system（L2）落地寻路核心：有向图构建（注入谓词）、最小损失搜索（自定义损失、默认每格 1）、仅取路径 API、D-08 情形 2 空数组语义、回退策略槽位与移动方式决策。 + +Purpose: 这是全部寻路行为的纯逻辑地基——不移动任何对象，可在 Node 下完整验证；L0 缺陷不修则 02-03 的多步逐步移动必然走崩（RESEARCH P1）。 +Output: 修复后的 mover.ts + 绿色 L0 回归；pathfinding/{types,graph,system,index}.ts 及 co-located 测试。 + + + +@C:/Users/book/.config/opencode/gsd-core/workflows/execute-plan.md +@C:/Users/book/.config/opencode/gsd-core/templates/summary.md + + + +@.planning/PROJECT.md +@.planning/ROADMAP.md +@.planning/phases/02-pathfinding/02-CONTEXT.md +@.planning/phases/02-pathfinding/02-RESEARCH.md +@.planning/phases/02-pathfinding/02-PATTERNS.md +@.planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md + +# 草案与拍板记录是本计划的接口事实源 +@packages-user/data-common/src/common/mover.ts +@packages-user/data-common/src/store/types.ts +@packages-user/data-base/src/map/types.ts +@packages-user/data-base/src/map/mapLayer.ts +@packages-user/data-state/src/hero/moverImpl.ts +@packages-user/data-system/src/event/system.ts +@packages-user/data-system/src/combat/mapDamage.ts +@dev.md + + + + + + Task 1: 按拍板结果修复 L0 坐标回写缺陷并翻绿回归测试 + packages-user/data-common/src/common/mover.ts, packages-user/data-common/src/common/mover.test.ts + .planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md, packages-user/data-common/src/common/mover.ts, packages-user/data-common/src/common/mover.test.ts + 依据 02-01 拍板记录执行。若 P1 获 go：将 mover.ts `moveProgress` 内 651 行的回写条件按拍板语义修改（拍板为「确认为缺陷改为 ||」时，条件由两轴同时变化才回写改为任一轴变化即回写；若用户给出其他替代语义，逐字应用之）。移除 02-01 铺设的 4 个回归用例的 skip 标记，使 x 正交/y 正交/斜向/传送步的坐标回写断言全部执行并通过。若用户 no-go 并提供替代回写路径：按用户语义实现替代路径，并按其语义改写回归断言。本任务是本计划唯一触碰 L0 共享代码的改动；除该行条件（或用户指定的替代实现）外不得改动 mover.ts 其他逻辑（`start` 返回 null、`stop` 兑现时机等语义是 02-03 打断机制的依赖事实，per RESEARCH Pitfall 5）。 + + pnpm exec vitest run "packages-user/data-common/src/common/mover.test.ts" + vitest 输出出现 "failed" 字样或非零退出码；或输出出现 "skipped" 计数大于 0（说明 skip 标记未移除，回归未真正执行） + + + - mover.ts 回写条件与拍板记录逐字一致（行为断言） + - 4 个回归用例全部以 passed 状态出现在 vitest 输出（行为断言） + - mover.ts 中除拍板授权的改动外无其他 diff：`git diff packages-user/data-common/src/common/mover.ts` 仅含回写条件一处变更（CLI 断言） + + L0 回归 4/4 绿，多步移动自此能以真实坐标计算后续步骤。 + + + + Task 2: 有向图构建（注入谓词 + 终端节点 + 边界守卫） + packages-user/data-system/src/pathfinding/graph.ts, packages-user/data-system/src/pathfinding/types.ts, packages-user/data-system/src/pathfinding/graph.test.ts + .planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md, packages-user/data-state/src/hero/moverImpl.ts, packages-user/data-base/src/map/mapLayer.ts, packages-user/data-base/src/map/types.ts, packages-user/data-common/src/store/types.ts, packages-user/data-system/src/combat/mapDamage.ts, dev.md + 创建 types.ts 与 graph.ts（签名与命名以拍板草案为唯一事实源，D-07）。types.ts：损失函数、回退策略、通行性谓词的函数类型别名；图节点/邻接的 interface；全部 jsDoc 中文注释、对象类型单独 interface、禁 `import type`（dev.md）。graph.ts：把 `IMapLayer` 转换为有向图——节点为 inMap 内图块；从 A 向方向 d 的边成立当且仅当通行性谓词(source, d, dest) 为真（D-02 有向图要求，单向门由掩码不对称产生）；谓词为 `useXxx()` 注入槽位（PATTERNS Shared Pattern 1 同款），L2 默认实现逐字复刻 moverImpl.ts:85-104 + 107-122 的掩码语义（事件层恒参与判定；其余层仅当 `pass.onlyEvents` 为真参与；方向→PassBit 映射照 moverImpl.ts:40-53 语义），L3 可注入复用 `DefaultHeroMoveTopImpl` 判定的谓词。终端节点：canPass 为真但 `eventPass` 为假的图块标记为仅可作路径终点、不可作中间节点（RESEARCH Pitfall 3）。边界守卫：构建与查询入口统一 `IMapLayer.inMap` + `isNil` 判空，非法输入 `logger.warn` 新码（warn ≥173，本任务在 packages/common/src/logger.json 登记首个本阶段码）后返回空图/空结果。graph.test.ts 用 eventDispatch.test.ts:105-179 的 fixture 模式（TileStore.addTile 位掩码 + FaceManager.register + MapState.fromRaw），必含用例：A→B 可行且 B→A 不可行的单向门（Pitfall 4）、eventPass=false 终端节点、越界坐标守卫告警。禁 import L3 任何符号（防循环依赖）。 + + pnpm exec vitest run "packages-user/data-system/src/pathfinding/graph.test.ts" + vitest 输出出现 "failed" 字样或非零退出码——单向门、终端节点或边界守卫断言未通过 + + + - 单向门用例：同一条边从 A→B 判定可行、从 B→A 判定不可行（行为断言） + - eventPass=false 的可通行图块出现在路径终点时合法、出现在中间节点时被拒绝（行为断言） + - 越界/空数据输入触发 logger.warn 新码并得到空结果而非异常（行为断言） + - graph.ts 与 types.ts 中无任何来自 data-state 的引入：对两文件运行来源断言找不到 data-state 引用语句（源断言） + + 有向图构建在 Node 下全绿，边语义与 canPass 判定同源。 + + + + Task 3: 最小损失搜索 + 仅取路径 API + 回退策略槽位（L2 核心） + packages-user/data-system/src/pathfinding/system.ts, packages-user/data-system/src/pathfinding/types.ts, packages-user/data-system/src/pathfinding/index.ts, packages-user/data-system/src/pathfinding/system.test.ts + .planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md, packages-user/data-system/src/pathfinding/graph.ts, packages-user/data-system/src/event/system.ts, packages-user/data-system/src/combat/mapDamage.ts, packages-user/data-common/src/common/mover.ts, dev.md + 创建 system.ts（`PathfindingSystem` 类，骨架照 GameEventSystem 形态：构造器持 state、可空成员显式类型、`useXxx()` 注入方法，per PATTERNS）与 index.ts barrel（照 event/index.ts 三行形态，并在 data-system/src/index.ts 追加 pathfinding 导出）。实现：(1) 自写 Dijkstra（O(V²)，约 40 行，零依赖）在 Task 2 的有向图上求两点间损失最小路径，满足 D-01/D-02 语义；(2) 损失函数注入槽位，默认每格损失 1（D-01）；损失守卫——函数返回非有限数或负数时 `logger.warn` 新码并按默认损失 1 处理（威胁 T-02-02）；(3) 仅取路径方法：绑定地图与 `IObjectMovable` 后可调用，返回坐标路径数组，不调用任何移动方法（D-06，D-03 绑定槽位）；(4) 不可达语义：目标不可达且不属于「no-pass 目标 + 可达相邻格」情形时返回空数组、不移动（D-08 情形 2；情形 1 的相邻格解析留给 02-03，本任务先暴露图上「目标四邻中存在可达格」的查询以便 L3 判定——具体 API 形态以拍板草案为准）；(5) 回退策略槽位：策略函数入参为完整路径及每步到达位置，返回是否退回逐步方式（D-05）；移动方式决策——策略判回退则走逐步，否则允许瞬移（D-04；瞬移的实际执行在 02-03，本任务只产出决策结果）；每次寻路动态构建图、不缓存（CONTEXT 酌情项默认建议，数据端状态可变）。system.test.ts 覆盖：默认损失 1 的最短路径、自定义损失改变选路（构造「步数少但损失高」的岔路）、不可达返回空数组、回退策略被以（路径，逐步到达位置序列）调用并生效、未绑定地图/对象时 logger.warn + 空结果（mapDamage.ts:169-173 守卫形态）。 + + pnpm exec vitest run "packages-user/data-system/src/pathfinding/system.test.ts" + vitest 输出出现 "failed" 字样或非零退出码——最小损失、自定义损失、空数组语义或回退策略断言未通过 + + + - 默认损失下返回格数最少路径；注入自定义损失后选择损失更小的岔路（行为断言） + - 不可达目标返回空数组且移动对象坐标不变（行为断言） + - 回退策略收到路径与每步到达位置并改变决策结果（行为断言） + - 未绑定依赖时 warn 码输出且返回空结果不抛异常（行为断言） + - `pnpm exec vitest run "packages-user/data-system/src/pathfinding"` 全目录绿（CLI 断言） + + L2 寻路核心在 Node 下全绿：图构建、最小损失、仅取路径、空数组语义、回退决策齐备。 + + + + + +## Trust Boundaries + +| Boundary | Description | +|----------|-------------| +| 地图/存档数据 → 图构建 | 畸形图层/掩码/越界坐标进入 graph.ts | +| 调用方注入的损失函数 → Dijkstra | 非有限/负损失值破坏搜索不变式 | + +## STRIDE Threat Register + +| Threat ID | Category | Component | Severity | Disposition | Mitigation Plan | +|-----------|----------|-----------|----------|-------------|-----------------| +| T-02-01 | Tampering/DoS | graph.ts 构建与查询入口 | medium | mitigate | `IMapLayer.inMap` + `isNil` 守卫，非法输入 logger.warn 新码后返回空图/空路径（Task 2） | +| T-02-02 | Tampering | 自定义损失函数 → Dijkstra | medium | mitigate | 损失值守卫：非有限数/负数 → logger.warn 新码并按默认损失 1 处理（Task 3） | +| T-02-03 | DoS | 搜索迭代规模 | low | mitigate | 图节点受 width×height 网格上限天然约束；Dijkstra 主循环以节点数上界终止，不存在无限循环路径 | +| T-02-SC | Tampering | npm/pip/cargo installs | low | accept | 本计划零新依赖（RESEARCH Package Legitimacy Audit：无安装对象） | + + + +- `pnpm exec vitest run "packages-user/data-common/src/common/mover.test.ts"` 4/4 passed +- `pnpm exec vitest run "packages-user/data-system/src/pathfinding"` 全绿 +- `pnpm check:type 2>&1 | Select-String -Pattern "pathfinding|mover\.ts"` 无输出（Phase 01 同款过滤式类型门，仓库既有诊断不在本计划范围） +- `pnpm check:circular` 输出中不含 pathfinding 相关路径（eventStore 既有循环为 Phase 01 基线，维持不变） + + + +L0 缺陷按拍板修复且有回归护栏；L2 寻路核心全部行为（有向边、单向门、终端节点、最小损失、自定义损失、仅取路径、空数组、回退决策）在 Node 下测试验证通过。 + + + +Create `.planning/phases/02-pathfinding/02-02-SUMMARY.md` when done + diff --git a/.planning/phases/02-pathfinding/02-03-PLAN.md b/.planning/phases/02-pathfinding/02-03-PLAN.md new file mode 100644 index 0000000..c2881d8 --- /dev/null +++ b/.planning/phases/02-pathfinding/02-03-PLAN.md @@ -0,0 +1,173 @@ +--- +phase: 02-pathfinding +plan: 03 +type: execute +wave: 3 +depends_on: ["02-01", "02-02"] +files_modified: + - packages-user/data-state/src/pathfinding/heroPathfinding.ts + - packages-user/data-state/src/pathfinding/heroPathfinding.test.ts + - packages-user/data-state/src/core.ts + - packages-user/data-state/src/index.ts + - packages-user/data-system/src/index.ts + - packages/common/src/logger.json +autonomous: true +requirements: [PATH-01, PATH-02] +estimate: + tokens: 80000 + raw_tokens: 80000 + tasks: 3 + confidence: low +must_haves: + truths: + - "逐步自动寻路端到端可用：路径翻译为 Dir 步骤队列并复用 `DefaultHeroMoveTopImpl` 执行，每步走 enter/leave/hit hooks，途经事件自然触发 (D-09)" + - "瞬移执行可用：决策允许瞬移时经 `ObjectMoveType.Teleport` 到达目标；拍板的回退策略判定需回退时自动退为逐步寻路，默认策略为路径上存在事件即回退 (D-04, D-05)" + - "D-08 情形 1：no-pass 目标存在可达相邻格时，移动到该相邻格、按拍板方案派发目标 OnTouch、勇士面朝目标 (D-08)" + - "自动寻路途中被新寻路调用或显式打断入口打断后，新寻路从最新位置接管 (D-10)" + - "数据端移动入口已在 data-state barrel 导出，Node 冒烟测试可调用；渲染端点击接线不在本阶段 (D-11)" + - "CoreState 构造器完成寻路系统接线（照 useTopImplementation 同处接线模式）(D-09)" + artifacts: + - "packages-user/data-state/src/pathfinding/heroPathfinding.ts" + - "packages-user/data-state/src/pathfinding/heroPathfinding.test.ts" + - "packages-user/data-state/src/core.ts" + - "packages-user/data-state/src/index.ts" + - "packages-user/data-system/src/index.ts" + - "packages/common/src/logger.json" + key_links: + - "heroPathfinding.ts 注入 02-02 的损失/回退/谓词槽位并绑定 hero mover（L3 → L2 合法方向，反向即循环依赖）" + - "D-08 OnTouch 派发走 Phase 1 source-aware 执行链（executor.execute，env 形态复刻 moverImpl commonTrigger）" + - "打断接管经 `IMoverController.stop()`（先停旧再起新，mover.start 移动中返回 null）" + assumptions: + - "PATH-01（flagged assumption，spec-less probe 未分类）：自动寻路以「fixture 地图上勇士沿最小损失路径移动且事件触发」的 Node 测试等效验证" + - "PATH-02（flagged assumption，spec-less probe 未分类）：本计划交付数据端移动入口并在 Node 下冒烟验证；移动端点击触发按 D-11 延迟至 Phase 4 渲染适配验证" + prohibitions: + - "不得为寻路引入任何新 npm 依赖（零依赖约束）" + - "不得把渲染端点击处理接进数据端代码 (D-11)" + - "D-08 OnTouch 派发必须按用户拍板方案实现，不得静默替换 (D-07, D-08)" +--- + + +在 data-state（L3）完成寻路系统的移动执行接线：逐步寻路复用 hero mover 与 Phase 1 事件链、瞬移与默认回退策略、D-08 情形 1 相邻格 + OnTouch + 面朝目标、打断接管，以及 CoreState/barrel 装配、logger 码登记与阶段门禁。 + +Purpose: 让寻路从「算得出」变成「走得通」——勇士真实移动、事件真实触发、输入真实接管；这是 PATH-01 的最终形态与 PATH-02 的数据端入口。 +Output: heroPathfinding.ts + 接线与测试；更新 core.ts、双 barrel、logger.json；全阶段门禁通过。 + + + +@C:/Users/book/.config/opencode/gsd-core/workflows/execute-plan.md +@C:/Users/book/.config/opencode/gsd-core/templates/summary.md + + + +@.planning/PROJECT.md +@.planning/ROADMAP.md +@.planning/phases/02-pathfinding/02-CONTEXT.md +@.planning/phases/02-pathfinding/02-RESEARCH.md +@.planning/phases/02-pathfinding/02-PATTERNS.md +@.planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md +@.planning/phases/02-pathfinding/02-02-SUMMARY.md + +# L2 寻路核心与 L3 既有接线点 +@packages-user/data-system/src/pathfinding/system.ts +@packages-user/data-system/src/pathfinding/types.ts +@packages-user/data-state/src/hero/moverImpl.ts +@packages-user/data-state/src/core.ts +@packages-user/data-state/src/index.ts +@packages-user/data-system/src/index.ts +@packages-user/data-common/src/common/mover.ts +@packages-user/data-base/src/hero/mover.ts +@packages-user/data-base/src/map/types.ts +@packages/common/src/logger.json +@dev.md + + + + + + Task 1: 逐步自动寻路端到端接线（CoreState + 路径翻译 + hero mover 执行） + packages-user/data-state/src/pathfinding/heroPathfinding.ts, packages-user/data-state/src/pathfinding/heroPathfinding.test.ts, packages-user/data-state/src/core.ts, packages-user/data-state/src/index.ts, packages-user/data-system/src/index.ts + .planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md, packages-user/data-state/src/hero/moverImpl.ts, packages-user/data-state/src/core.ts, packages-user/data-base/src/hero/mover.ts, packages-user/data-common/src/common/mover.ts, packages-user/data-system/src/event/eventDispatch.test.ts, dev.md + 创建 L3 `HeroPathfinding` 类（imports 骨架照 moverImpl.ts:1-32：从 `@user/data-system` 引入 L2 寻路系统——此方向合法）。职责：构造时绑定 `IObjectMovable`（hero mover）与 `IMapLayer`（event 层）到 02-02 的 `PathfindingSystem` 注入槽位（D-03）；注入默认通行性谓词（复刻 `DefaultHeroMoveTopImpl` canPass 语义）与回退策略槽位。实现逐步执行：调用寻路系统取得最小损失路径后，将路径翻译为 `ObjectMoveType.Dir` 步骤队列（相邻坐标增量 → `FaceDirection`，每次一步保证 canPass 逐格判定，per RESEARCH Code Examples 语义），经 mover `push` + `start` 启动（D-09）。core.ts 在 `//#endregion 勇士顶层初始化` region 内、`useTopImplementation` 之后新增寻路接线（照 core.ts:235-237 模式）；data-state/src/index.ts 在 `export * from './hero';` 之后追加寻路导出，data-system/src/index.ts 追加 pathfinding 导出（dev.md：不转发导出）。heroPathfinding.test.ts 用 eventDispatch.test.ts:105-179 fixture 模式：勇士在 fixture 地图上自动寻路走两步，断言终点坐标、leave/enter 事件按 Phase 1 source-aware 顺序触发、途经带事件的图块事件被执行。签名与命名以拍板草案为唯一事实源（D-07）。 + + pnpm exec vitest run "packages-user/data-state/src/pathfinding/heroPathfinding.test.ts" + vitest 输出出现 "failed" 字样或非零退出码——勇士未到达目标、事件未按序触发或翻译步骤数与路径不符 + + + - 勇士沿最小损失路径逐步移动并停在目标格，坐标断言通过（行为断言） + - 途经图块的 leave/enter 钩子触发且 env 的 heroLocator 与实际位置一致（行为断言） + - core.ts 含寻路接线且位于勇士顶层初始化 region（源断言） + - 两个 barrel 均导出寻路内容，`pnpm check:type 2>&1 | Select-String -Pattern "heroPathfinding|pathfinding|core\.ts"` 无输出（CLI 断言） + + 勇士能在 fixture 地图上自动寻路移动到指定格，途经事件自然触发——PATH-01 的核心闭环成立。 + + + + Task 2: 瞬移执行 + 默认回退策略 + D-08 情形 1（相邻格 + OnTouch + 面朝） + packages-user/data-state/src/pathfinding/heroPathfinding.ts, packages-user/data-state/src/pathfinding/heroPathfinding.test.ts + .planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md, packages-user/data-state/src/pathfinding/heroPathfinding.ts, packages-user/data-state/src/hero/moverImpl.ts, packages-user/data-common/src/common/mover.ts, packages-user/data-common/src/event/types.ts, packages-user/data-base/src/map/types.ts, .planning/phases/02-pathfinding/02-RESEARCH.md + 扩展 heroPathfinding.ts：(1) 瞬移执行——移动方式决策允许瞬移时以 `ObjectMoveType.Teleport` 步骤到达目标（D-04）；(2) 默认回退策略——按拍板草案实现「路径上存在事件即回退」：沿路径用 moverImpl.ts:169-204 同款方式探测事件（点事件 + 静态/动态图块事件），命中即退为逐步执行（D-05）；策略判不需回退时才瞬移；(3) D-08 情形 1——目标为 no-pass 图块且四邻存在可达格时：寻路至该相邻格并移动到达，按用户拍板方案派发目标 OnTouch（拍板方案 A：直接构造 `IGameEventInvocation`，env 逐字复刻 moverImpl.ts:206-222 `commonTrigger` 形态——state、type 按目标事件来源、trigger=`EventTrigger.OnTouch`、heroLocator=相邻格、triggerLocator=目标格、tile/layer/map 按 env 接口可空语义填实，调 `executor.execute`；拍板方案 B：按用户拍板的替代语义实现）；随后以纯转向步或 `setFaceDir` 使勇士面朝目标（D-08）。测试补充：瞬移在无事件路径上直达目标；路径含事件时默认策略退为逐步且途经事件触发；no-pass 目标带 OnTouch 事件时勇士停于相邻格、面朝目标、mock 事件以 OnTouch 触发且 env.triggerLocator 为目标格（mock 事件照 eventDispatch.test.ts:181-211 addEvent 模式）；无相邻可达格的不可达目标保持空数组不移动（D-08 情形 2 回归）。 + + pnpm exec vitest run "packages-user/data-state/src/pathfinding/heroPathfinding.test.ts" + vitest 输出出现 "failed" 字样或非零退出码——瞬移未直达、事件路径未回退逐步、OnTouch 未按拍板方案触发或面朝方向错误 + + + - 无事件路径瞬移一步到达目标，坐标断言通过（行为断言） + - 含事件路径在默认策略下退为逐步且途经事件触发（行为断言） + - no-pass 目标：勇士位于相邻格、朝向指向目标、OnTouch 事件以拍板方案派发且 triggerLocator 为目标格（行为断言） + - 四邻皆不可达的 no-pass 目标：路径空数组、勇士不动（行为断言） + + D-04/D-05/D-08 全部语义在 L3 落地且测试验证。 + + + + Task 3: 打断接管 + logger 码登记 + 阶段门禁 + packages-user/data-state/src/pathfinding/heroPathfinding.ts, packages-user/data-state/src/pathfinding/heroPathfinding.test.ts, packages/common/src/logger.json + .planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md, packages-user/data-state/src/pathfinding/heroPathfinding.ts, packages-user/data-common/src/common/mover.ts, packages-user/data-base/src/hero/mover.ts, packages/common/src/logger.json, .planning/phases/02-pathfinding/02-RESEARCH.md + 实现打断接管（D-10）：寻路控制器持有当前 `IMoverController` 引用；新寻路调用或显式打断入口到达时，按拍板的时序（stop 后 await 兑现，或 onEnd 回调驱动）停止旧移动，从最新坐标起算并启动新路径——注意 mover.start 移动中返回 null（mover.ts:669-670），必须先完成旧移动的停止再 start；识别 HeroMover.onStepEnd 在 CannotMove/Stop/Hit 时的自然终止，避免对已终止移动重复 stop（RESEARCH Pitfall 5）。在 logger.json 集中登记本阶段全部新码（warn ≥173、error ≥65，与 02-02 已登记码合并查重，RESEARCH Pitfall 7）。测试补充：移动中途发起新寻路，旧路径中止且新路径从最新位置起算到达新目标；显式打断入口等效。最后跑阶段门禁并修复本阶段文件暴露的问题。 + + pnpm exec vitest run "packages-user/data-state/src/pathfinding/heroPathfinding.test.ts"; if ($?) { pnpm check:type 2>&1 | Select-String -Pattern "pathfinding|mover\.ts|core\.ts" } + vitest 输出出现 "failed" 字样，或 Select-String 对本阶段文件输出任何类型诊断行（命中即存在计划内文件的类型错误） + + + - 移动中发起新寻路：旧路径停止、新路径自最新坐标起算并到达新目标（行为断言） + - 显式打断后 mover 处于可再次 start 的干净状态（行为断言） + - logger.json 新码无撞码：warn 新码 ≥173、error 新码 ≥65 且与既有键位不重复（CLI 断言：node 枚举 logger.json 键位核对） + - `pnpm check:circular` 输出不含 pathfinding 相关路径；`pnpm lint:user` 对本阶段文件无报错（CLI 断言） + + 打断接管按拍板时序可用；全量测试绿、循环依赖与 lint 门禁对本阶段文件清洁。 + + + + + +## Trust Boundaries + +| Boundary | Description | +|----------|-------------| +| 地图/存档数据 → OnTouch env 构造 | 目标格/图层可能为空或畸形，进入 `IBlockEventEnv` 构造 | +| 玩家输入时序 → 移动队列 | 打断与新寻路竞态可能使 mover 队列处于不一致状态 | + +## STRIDE Threat Register + +| Threat ID | Category | Component | Severity | Disposition | Mitigation Plan | +|-----------|----------|-----------|----------|-------------|-----------------| +| T-02-04 | Tampering | D-08 OnTouch env 构造 | low | mitigate | env 各字段按 `IBlockEventEnv` 可空语义用 `isNil` 判空填实，非法来源不构造 invocation（Task 2，复刻 commonTrigger 形态） | +| T-02-05 | DoS | 打断接管竞态 | low | mitigate | 单一 controller 所有权：先按拍板时序停旧移动、确认终止后起新路径；识别自然终止避免重复 stop（Task 3） | +| T-02-SC | Tampering | npm/pip/cargo installs | low | accept | 本计划零新依赖（RESEARCH Package Legitimacy Audit：无安装对象） | + + + +- `pnpm exec vitest run "packages-user/data-state/src/pathfinding/heroPathfinding.test.ts"` 全绿 +- `pnpm exec vitest run` 全量通过（Phase 02 + Phase 01 既有测试无回归） +- `pnpm check:type 2>&1 | Select-String -Pattern "pathfinding|mover\.ts|core\.ts"` 无输出 +- `pnpm check:circular` 输出不含 pathfinding 相关路径（eventStore 既有循环维持 Phase 01 基线） +- `pnpm lint:user` 无新报错 + + + +勇士在 fixture 地图上可自动寻路（逐步/瞬移/回退/不可达双语义/打断接管全部符合拍板契约）；数据端入口经 barrel 导出且 Node 可验证；阶段门禁全绿。PATH-01 交付完成，PATH-02 以数据端入口形态交付（点击接线属 Phase 4，per D-11）。 + + + +Create `.planning/phases/02-pathfinding/02-03-SUMMARY.md` when done + diff --git a/.planning/phases/02-pathfinding/02-VALIDATION.md b/.planning/phases/02-pathfinding/02-VALIDATION.md index 2d945a1..e73e544 100644 --- a/.planning/phases/02-pathfinding/02-VALIDATION.md +++ b/.planning/phases/02-pathfinding/02-VALIDATION.md @@ -42,9 +42,15 @@ Type/lint gates (per Phase 01 conventions): `pnpm check:type` (filtered via `Sel | Task ID | Plan | Wave | Requirement | Threat Ref | Secure Behavior | Test Type | Automated Command | File Exists | Status | |---------|------|------|-------------|------------|-----------------|-----------|-------------------|-------------|--------| -| 02-01-01 | 01 | 1 | PATH-01 | — | N/A | unit | `pnpm exec vitest run "packages-user/data-system/src/pathfinding/*.test.ts"` | ❌ W0 | ⬜ pending | -| 02-01-02 | 01 | 1 | PATH-01 | — | N/A | unit (L0 regression) | `pnpm exec vitest run "packages-user/data-common/src/common/mover.test.ts"` | ❌ W0 | ⬜ pending | -| 02-02-01 | 02 | 2 | PATH-01 | — | N/A | unit | `pnpm exec vitest run "packages-user/data-state/src/hero/*.test.ts"` | ❌ W0 | ⬜ pending | +| 02-01-01 | 01 | 1 | PATH-01 | — | N/A | draft-artifact check | `if (!(Test-Path ".planning/phases/02-pathfinding/02-INTERFACE-DRAFT.md")) { exit 1 }; ...`（见 02-01 Task 1 verify） | ❌ W0 | ⬜ pending | +| 02-01-02 | 01 | 1 | PATH-01 | — | N/A | unit (skip scaffold) | `pnpm exec vitest run "packages-user/data-common/src/common/mover.test.ts"` | ❌ W0 | ⬜ pending | +| 02-01-03 | 01 | 1 | PATH-01 | — | — | checkpoint:human-verify | 人工拍板六项决策（无自动命令；拍板记录节断言） | — | ⬜ pending | +| 02-02-01 | 02 | 2 | PATH-01 | T-02-01..03 前置 | L0 回写修复 | unit (L0 regression) | `pnpm exec vitest run "packages-user/data-common/src/common/mover.test.ts"` | ❌ W0 | ⬜ pending | +| 02-02-02 | 02 | 2 | PATH-01 | T-02-01 | inMap/isNil 守卫 + warn 码 | unit | `pnpm exec vitest run "packages-user/data-system/src/pathfinding/graph.test.ts"` | ❌ W0 | ⬜ pending | +| 02-02-03 | 02 | 2 | PATH-01 | T-02-02, T-02-03 | 损失值守卫 + 网格上界 | unit | `pnpm exec vitest run "packages-user/data-system/src/pathfinding/system.test.ts"` | ❌ W0 | ⬜ pending | +| 02-03-01 | 03 | 3 | PATH-01 | — | N/A | unit (e2e slice) | `pnpm exec vitest run "packages-user/data-state/src/pathfinding/heroPathfinding.test.ts"` | ❌ W0 | ⬜ pending | +| 02-03-02 | 03 | 3 | PATH-01, PATH-02 | T-02-04 | OnTouch env 判空填实 | unit | 同上 | ❌ W0 | ⬜ pending | +| 02-03-03 | 03 | 3 | PATH-01 | T-02-05 | 打断接管时序 | unit + gates | 同上; `pnpm check:type 2>&1 \| Select-String -Pattern "pathfinding\|mover\.ts\|core\.ts"` | ❌ W0 | ⬜ pending | *Status: ⬜ pending · ✅ green · ❌ red · ⚠️ flaky*