template/.planning/phases/02-pathfinding/02-VALIDATION.md

phase	slug	status	nyquist_compliant	wave_0_complete	created
02	pathfinding	draft	false	false	2026-09-09

Phase 02 — Validation Strategy

Per-phase validation contract for feedback sampling during execution.

---

Test Infrastructure

Property	Value
Framework	vitest (existing, root pnpm test)
Config file	existing vitest config (repo root)
Quick run command	pnpm exec vitest run <changed-test-file>
Full suite command	pnpm test
Estimated runtime	~10–60 seconds

Type/lint gates (per Phase 01 conventions): pnpm check:type (filtered via Select-String), pnpm check:circular, pnpm lint:user / pnpm lint:custom.

---

Sampling Rate

• After every task commit: Run focused vitest file(s) for the touched package
• After every plan wave: Run pnpm test plus pnpm check:circular
• Before /gsd-verify-work: Full suite must be green
• Max feedback latency: ~60 seconds

---

Per-Task Verification Map

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	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

Exact task IDs/commands to be finalized by the planner; table above is the seeded skeleton from RESEARCH.md findings (pathfinding unit tests in data-system, L0 mover regression in data-common, hero wiring in data-state).

---

Wave 0 Requirements

• packages-user/data-system/src/pathfinding/*.test.ts — stubs for PATH-01 (graph build, min-loss path, unreachable semantics)
• packages-user/data-common/src/common/mover.test.ts — L0 moveProgress coordinate-writeback regression (Pitfall P1)
• No framework install needed — vitest already configured

---

Manual-Only Verifications

Behavior	Requirement	Why Manual	Test Instructions
打断时序手感（stop 后 await vs onEnd 回调）	PATH-01	接口语义经用户拍板后仍需实际操作确认手感	在自动寻路中按键打断，确认停下时机符合拍板契约
移动端点击触发寻路	PATH-02	渲染端接线属 Phase 4	本阶段仅验证数据端入口 API 可被调用；点击接线在 Phase 4 验证

---

Validation Sign-Off

• All tasks have <automated> verify or Wave 0 dependencies
• Sampling continuity: no 3 consecutive tasks without automated verify
• Wave 0 covers all MISSING references
• No watch-mode flags
• Feedback latency < 60s
• nyquist_compliant: true set in frontmatter

Approval: pending