// Skill text for targeted test runs: the wording that tells Plan, Pathfinder, // Document and the build skills which tests to run and who asks about them. // Run with: node --test scripts/test-skill-test-runs.mjs import test from "node:test"; import assert from "node:assert/strict"; import fs from "node:fs"; import path from "node:path"; import { execFileSync } from "node:child_process"; import { fileURLToPath } from "node:url"; const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), ".."); const src = (...p) => fs.readFileSync(path.join(ROOT, "src", ...p), "utf8"); test("Plan offers the cadence and full-suite answers and checks old drafts for them", () => { const plan = src("plan2code-1-plan.md"); assert.match(plan, /Phase testing\*\*: Targeted per phase.*Dedicated phase only.*None/); assert.match(plan, /Full suite\*\*: Offered at Finalize.*At Phase N.*Never/); assert.match(plan, /Before going on with any existing draft.*Deferred to Plan.*Not discussed.*Full Suite/, "the progress check names a deferred, empty or undiscussed 2.4"); assert.match(plan, /skip testing' writes `None` and `Never`/); assert.match(plan, /Full Suite/, "2.4 carries a Full Suite row"); }); test("Pathfinder hands testing to Plan and no longer gates on it", () => { const dir = path.join(ROOT, "src"); const files = []; for (const entry of fs.readdirSync(dir)) { if (!entry.startsWith("plan2code-0-pathfinder")) continue; const full = path.join(dir, entry); if (fs.statSync(full).isDirectory()) { for (const f of fs.readdirSync(full)) if (f.endsWith(".md")) files.push(path.join(full, f)); } else if (entry.endsWith(".md")) files.push(full); } assert.ok(files.length > 3, "found the Pathfinder prompts"); assert.ok(src("plan2code-0-pathfinder-references", "handoff.md").includes("Deferred to Plan"), "the handoff writes Deferred to Plan"); for (const f of files) { if (path.basename(f) === "handoff.md") continue; assert.doesNotMatch(fs.readFileSync(f, "utf8"), /testing posture|Run after each phase/i, `${path.basename(f)} asks no testing question`); } assert.ok(!src("plan2code-0-pathfinder-scripts", "pathfinder.mjs").includes("CADENCE_RE"), "the gate has no testing cap"); }); test("Document writes Targeted, Quick checks and Full suite lines and reads test-runs.md", () => { const doc = src("plan2code-2-document.md"); for (const line of ["Targeted:", "Quick checks:", "Full suite:", "test-runs.md"]) assert.ok(doc.includes(line), `Document names ${line}`); assert.match(doc, /only to the phase named by "At Phase N"/); assert.match(doc, /no Full Suite row: ask/); }); test("test-runs.md ships in the six skills that run, write or offer tests, and in no other", () => { // npm test has just built skills/; a direct run builds it so the check never reads a stale tree. if (process.env.npm_lifecycle_event !== "test") { execFileSync(process.execPath, [path.join(ROOT, "install.js"), "--build-skills"], { stdio: "ignore" }); } const built = path.join(ROOT, "skills"); const having = fs.readdirSync(built).filter((dir) => fs.existsSync(path.join(built, dir, "references", "test-runs.md"))); assert.deepEqual(having.sort(), [ "plan2code-2-document", "plan2code-3-implement", "plan2code-3-implement-review", "plan2code-4-finalize", "plan2code-quick-task", "plan2code-review", ]); }); test("test-runs.md names no runner as the default and asks when unsure", () => { const rule = src("shared-references", "test-runs.md"); assert.match(rule, /Ask when unsure/); assert.doesNotMatch(rule.replace(/`npm test`/g, ""), /\b(jest|vitest|pytest|mocha|cargo test)\b/i); assert.ok(rule.length < 3200, "the shared rule stays short"); }); test("Implement and Implement + Review say the same targeted rule", () => { const impl = src("plan2code-3-implement.md"); const both = src("plan2code-3-implement-review.md"); for (const text of [impl, both]) { assert.match(text, /after each task (run )?the tests covering what it touched/); assert.match(text, /the phase file's `## Phase Testing` lines plus tests for any other file the phase changed/); assert.match(text, /never the full suite unless the phase file lists a `Full suite:` line/); assert.match(text, /Read `references\/test-runs\.md` before the first test run of a phase/); } assert.doesNotMatch(impl, /Run tests ONLY if/); assert.doesNotMatch(both, /explicitly listed as a phase task/); }); test("Implement's sign-off offers a wider run for shared ground and asks when unsure", () => { const impl = src("plan2code-3-implement.md"); assert.match(impl, /changed shared ground the plan did not foresee/); assert.match(impl, /offer the full suite or a wider set as a choice beside approval/); assert.match(impl, /Unsure whether it is shared ground\? Ask\./); assert.match(src("web-console", "building.md"), /\| Shared ground touched \| `choice` \|/); }); test("Quick Task and Review name the tests covering the changed files", () => { const quick = src("plan2code-quick-task.md"); assert.match(quick, /\[Targeted: the command and the tests covering the changed files\]/); assert.ok(quick.includes("**Write the test first?**"), "the test-first question stays"); assert.ok(quick.includes("references/test-runs.md"), "Quick Task reads the shared rule"); assert.match(src("plan2code-review.md"), /\*\*Verify\*\* -- build and run the tests covering the fixed files \(per `references\/test-runs\.md`/); }); test("Finalize offers the full suite, skips it for Never and records the four outcomes", () => { const fin = src("plan2code-4-finalize.md"); assert.ok(fin.includes("Run the full suite now?"), "Finalize asks the question"); assert.match(fin, /`Never`: skip the offer; record `not planned`/); assert.ok(fin.includes("references/test-runs.md"), "Finalize reads the shared rule"); assert.match(fin, /Never forced/); for (const outcome of ["passed", "failed (N)", "skipped (your choice)", "not planned"]) { assert.ok(fin.includes(outcome), `Finalize records ${outcome}`); } assert.match(fin, /Full suite: \[passed \/ failed \(N\) \/ skipped \(your choice\) \/ not planned\]/, "the summary template carries the line"); assert.doesNotMatch(fin, /Test Validation \(if defined\)/); const notes = src("web-console", "notes", "finalize.md"); assert.match(notes, /`confirm` "Run the full suite" \(`yesLabel` "Run it", `noLabel` "Skip it"/); assert.match(notes, /a failure is the building notes' `choice`/); }); test("test-runs.md says to ask when a check or its tests are unclear", () => { const rule = src("shared-references", "test-runs.md"); assert.match(rule, /which tests cover a file, ask the person\. Never guess/); }); test("Init and Init-update keep a test map beside the single-test command", () => { const init = src("plan2code-init.md"); assert.match(init, /run single test \(and beside it a short \*\*Test map\*\*: `area -> tests or command`/); assert.match(init, /which checks are quick/); const upd = src("plan2code-init-update.md"); assert.match(upd, /\*\*4\. Testing\*\* - .*the test map and quick checks/); assert.match(upd, /\| Testing \| Commands\? Test map and quick checks stale\?/); });