@tekyzinc/gsd-t 2.19.0 → 2.20.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to GSD-T are documented here. Updated with each release.
 
+## [2.20.0] - 2026-02-16
+
+### Added
+- **Playwright Setup in Init**: `gsd-t-init` now installs Playwright, creates `playwright.config.ts`, and sets up E2E test directory for every project. Detects package manager (bun, npm, yarn, pnpm, pip) automatically
+- **Playwright Readiness Guard**: Before any testing command (execute, test-sync, verify, quick, wave, milestone, complete-milestone, debug), checks for `playwright.config.*` and auto-installs if missing. Playwright must always be ready — no deferring to "later"
+
+## [2.19.1] - 2026-02-16
+
+### Changed
+- **Quick**: Now runs the FULL test suite (not just affected tests), requires comprehensive test creation for new/changed code paths including Playwright E2E, and verifies against requirements and contracts. "Quick doesn't mean skip testing."
+
 ## [2.19.0] - 2026-02-16
 
 ### Changed

package/commands/gsd-t-init.md

@@ -174,13 +174,35 @@ After initialization, verify all created documentation is consistent:
 
 ### Skip what's not affected — init creates docs, so most ripple is about consistency verification.
 
-## Step 7.6: Test Verification
+## Step 7.6: Playwright Setup (MANDATORY)
+
+Every GSD-T project must have Playwright ready for E2E testing. If `playwright.config.*` does not exist:
+
+1. **Detect package manager**: Check for `bun.lockb` (bun), `yarn.lock` (yarn), `pnpm-lock.yaml` (pnpm), `package-lock.json` or `package.json` (npm), `requirements.txt`/`pyproject.toml` (Python)
+2. **Install Playwright**:
+   - bun: `bun add -d @playwright/test && bunx playwright install chromium`
+   - npm: `npm install -D @playwright/test && npx playwright install chromium`
+   - yarn: `yarn add -D @playwright/test && yarn playwright install chromium`
+   - pnpm: `pnpm add -D @playwright/test && pnpm exec playwright install chromium`
+   - Python: `pip install playwright && playwright install chromium`
+   - No package manager detected: `npm init -y && npm install -D @playwright/test && npx playwright install chromium`
+3. **Create `playwright.config.ts`** (or `.js` if not using TypeScript) with sensible defaults:
+   - `testDir: './e2e'` (or `./tests/e2e`)
+   - `use: { baseURL: 'http://localhost:3000' }` (adjust based on project)
+   - Chromium only (keep it fast; user can add more browsers later)
+   - Screenshot on failure enabled
+4. **Create the E2E test directory** (`e2e/` or `tests/e2e/`) with a placeholder spec
+5. **Add test script** to `package.json` if it exists: `"test:e2e": "playwright test"`
+
+Skip silently if `playwright.config.*` already exists.
+
+## Step 7.7: Test Verification
 
 After initialization:
 
 1. **If existing code with tests**: Run the full test suite to establish a baseline. Document results in `.gsd-t/progress.md`
-2. **If existing code without tests**: Note the absence — recommend test setup as part of the first milestone
-3. **If greenfield**: No tests to run, but note that test infrastructure should be in Milestone 1
+2. **If existing code without tests**: Playwright is now set up (Step 7.6) — note unit test framework should be added as part of the first milestone
+3. **If greenfield**: Playwright is ready. Note that unit test infrastructure should be added in Milestone 1
 4. **Verify init outputs**: Confirm all created files exist and are non-empty
 
 ## Step 8: Report

package/commands/gsd-t-quick.md

@@ -52,14 +52,23 @@ If `.gsd-t/progress.md` exists, assess what documentation was affected and updat
 
 ### Skip what's not affected — most quick tasks will only touch 1-2 of these.
 
-## Step 5: Test Verification
-
-Before committing, verify the change works:
-
-1. **Update tests**: If the change adds or modifies behavior, update or add tests to cover it
-2. **Run affected tests**: Execute all tests related to the changed files and domain
-3. **Verify passing**: All tests must pass. If any fail, fix before proceeding (up to 2 attempts)
-4. **Run E2E tests**: If the change touched UI, routes, or user flows and an E2E framework exists, run affected specs
-5. **No test framework?**: At minimum, manually verify the change works as expected and document how you verified it in the commit message
+## Step 5: Test & Verify (MANDATORY)
+
+Quick does not mean skip testing. Before committing:
+
+1. **Write/update tests for every new or changed code path**:
+   - Unit tests: happy path + common edge cases + error cases
+   - Playwright E2E specs (if UI/routes/flows/modes changed): create new specs for new functionality, update existing specs for changed behavior
+   - Cover all modes/flags affected by this change
+   - "No feature code without test code" applies to quick tasks too
+2. **Run the FULL test suite** — not just affected tests:
+   - All unit/integration tests
+   - Full Playwright E2E suite (if configured)
+   - Fix any failures before proceeding (up to 2 attempts)
+3. **Verify against requirements**:
+   - Does the change satisfy its intended requirement?
+   - Did the change break any existing functionality? (the full test run catches this)
+   - If a contract exists for the interface touched, does the code still match?
+4. **No test framework?**: Set one up, or at minimum manually verify and document how in the commit message
 
 $ARGUMENTS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekyzinc/gsd-t",
-  "version": "2.19.0",
+  "version": "2.20.0",
   "description": "GSD-T: Contract-Driven Development for Claude Code — 41 slash commands with backlog management, impact analysis, test sync, and milestone archival",
   "author": "Tekyz, Inc.",
   "license": "MIT",

package/templates/CLAUDE-global.md

@@ -191,6 +191,16 @@ If any are missing:
 
 **Exempt commands** (do not trigger auto-init): `gsd-t-init`, `gsd-t-init-scan-setup`, `gsd-t-help`, `gsd-t-version-update`, `gsd-t-version-update-all`, `gsd-t-prompt`, `gsd-t-brainstorm`.
 
+## Playwright Readiness Guard
+
+Before any command that involves testing (`gsd-t-execute`, `gsd-t-test-sync`, `gsd-t-verify`, `gsd-t-quick`, `gsd-t-wave`, `gsd-t-milestone`, `gsd-t-complete-milestone`, `gsd-t-debug`), check if `playwright.config.*` exists in the project. If it does not:
+1. Detect the package manager and install Playwright (`@playwright/test` + chromium)
+2. Create a basic `playwright.config.ts` with sensible defaults
+3. Create the E2E test directory with a placeholder spec
+4. Then continue with the original command
+
+Playwright must always be ready before any testing occurs. Do not skip this check. Do not defer setup to "later."
+
 ## Prime Rule
 KEEP GOING. Only stop for:
 1. Unrecoverable errors after 2 fix attempts