spk-scoped-tests

name	spk-scoped-tests
description	รันเฉพาะ test suites ที่ได้รับผลกระทบจากไฟล์ที่เปลี่ยน โดย map ไฟล์ที่เปลี่ยนไปยัง suites ที่เกี่ยวข้อง และถ้า map ไม่ได้แน่ชัดให้ fallback ไปรันทั้งชุด
argument-hint	[ไม่บังคับ: ระบุ paths ที่เปลี่ยนเอง; ค่าเริ่มต้นคือ git diff เทียบ HEAD]

spk-scoped-tests

เร่ง inner loop ด้วยการรันเฉพาะ test suites ที่การเปลี่ยนแปลงปัจจุบันมีผลกระทบ แทนที่จะรันทั้งชุดทุกครั้งที่แก้ ใช้ตอนทำ TDD หรือ implement ทีละขั้นเมื่อการรันทั้งชุดช้า แต่ต้องรันทั้งชุดก่อนปิดงานเสมอ ทำ workflow นี้โดยตรงใน conversation ปัจจุบัน

รวบรวม Context

• ถ้าอยู่ใน git worktree ให้ดูไฟล์ที่เปลี่ยนด้วย git diff --name-only HEAD; ถ้าไม่ใช่ git repo ให้ระบุ paths ที่เปลี่ยนเอง
• ตรวจ test runner ของ project: package.json ที่มี jest → Jest, pyproject.toml/pytest.ini → pytest, go.mod → go test

Workflow

1. หา packaged planner

หารากชุดติดตั้งจาก metadata หรือตัวแปรรากที่ host ให้ แล้วใช้ scripts/scoped-tests.cjs ใต้รากนั้น ห้ามเลือกไฟล์ชื่อเดียวกันใน repo ของ user ก่อน

2. รวบรวมไฟล์ที่เปลี่ยน

ถ้า user ระบุ paths ให้ใช้ paths นั้น ไม่งั้นใช้ทั้ง tracked และ untracked changes ของ repo ถ้าอยู่นอก git worktree ต้องระบุ paths เอง

3. สร้างแผนแบบ structured

จาก project cwd รัน node <install-root>/scripts/scoped-tests.cjs -- <path>... helper จะคืน JSON schema spk.scoped-tests/v1 ที่มี mode, runner, selected, unmapped, focused และ full ใช้ command กับ args เป็น argv array ห้ามต่อเป็น shell string

4. รันอย่างปลอดภัย

• mode: scoped → รัน focused.command พร้อม focused.args
• mode: full → อธิบายเหตุผล fallback แล้วรัน full
• mode: blocked → รายงาน runner ที่ขาด/ไม่รองรับแล้วหยุด

5. รายงาน scope ตามจริง

รายงาน changed paths, selected inputs, unmapped paths, command/argv, exit status และบอกว่าเป็น scoped หรือ full

6. รันทั้งชุดก่อนปิดงาน

scoped pass เป็นเพียง inner-loop signal ก่อนสรุป implementation ว่าเสร็จต้องรันคำสั่ง full ที่ helper คืนมา

ข้อควรระวัง

• ห้ามรันบางส่วนเงียบ ๆ — changed path ที่ map ไม่ได้แม้แต่ไฟล์เดียวต้อง fallback ทั้งชุด
• ห้ามรัน shell string ที่ประกอบจากข้อมูลใน repo ให้ใช้ command + args แยกกัน
• การรันแบบ scope ไม่ใช่ release gate; npm run verify:release ยังรันทั้งหมดอยู่
• ใช้ได้นอก git worktree เฉพาะเมื่อระบุ paths ที่เปลี่ยนเอง