@tekyzinc/gsd-t 2.20.1 → 2.20.3

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to GSD-T are documented here. Updated with each release.
 
+## [2.20.3] - 2026-02-16
+
+### Added
+- **Playwright Cleanup**: After Playwright tests finish, kill any app/server processes that were started for the tests. Prevents orphaned dev servers from lingering after test runs
+
+## [2.20.2] - 2026-02-16
+
+### Added
+- **CLI health checks**: `update-all` and `doctor` now check all projects for missing Playwright and Swagger/OpenAPI
+- Smart API detection: scans `package.json`, `requirements.txt`, `pyproject.toml` for API frameworks (Express, Fastify, Hono, Django, FastAPI, etc.)
+- Swagger detection: checks for spec files (`openapi.json/yaml`, `swagger.json/yaml`) and swagger packages in dependencies
+- Health summary in `update-all` shows counts of missing Playwright and Swagger across all registered projects
+
 ## [2.20.1] - 2026-02-16
 
 ### Added

package/bin/gsd-t.js

@@ -90,6 +90,70 @@ function copyFile(src, dest, label) {
   success(label || path.basename(dest));
 }
 
+function hasPlaywright(projectDir) {
+  const configs = ["playwright.config.ts", "playwright.config.js", "playwright.config.mjs"];
+  return configs.some((f) => fs.existsSync(path.join(projectDir, f)));
+}
+
+function hasSwagger(projectDir) {
+  // Check for OpenAPI/Swagger spec files
+  const specFiles = [
+    "swagger.json", "swagger.yaml", "swagger.yml",
+    "openapi.json", "openapi.yaml", "openapi.yml",
+  ];
+  if (specFiles.some((f) => fs.existsSync(path.join(projectDir, f)))) return true;
+
+  // Check package.json for swagger dependencies
+  const pkgPath = path.join(projectDir, "package.json");
+  if (fs.existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+      const allDeps = Object.keys(pkg.dependencies || {}).concat(Object.keys(pkg.devDependencies || {}));
+      const swaggerPkgs = ["swagger-jsdoc", "swagger-ui-express", "@fastify/swagger", "@nestjs/swagger", "swagger-ui", "express-openapi-validator"];
+      if (swaggerPkgs.some((p) => allDeps.includes(p))) return true;
+    } catch { /* ignore */ }
+  }
+
+  // Check for Python FastAPI (has built-in OpenAPI)
+  const pyFiles = ["requirements.txt", "pyproject.toml"];
+  for (const f of pyFiles) {
+    const fp = path.join(projectDir, f);
+    if (fs.existsSync(fp)) {
+      try {
+        const content = fs.readFileSync(fp, "utf8");
+        if (content.includes("fastapi")) return true;
+      } catch { /* ignore */ }
+    }
+  }
+
+  return false;
+}
+
+function hasApi(projectDir) {
+  // Quick check: does this project likely have API endpoints?
+  const pkgPath = path.join(projectDir, "package.json");
+  if (fs.existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+      const allDeps = Object.keys(pkg.dependencies || {}).concat(Object.keys(pkg.devDependencies || {}));
+      const apiFrameworks = ["express", "fastify", "hono", "koa", "hapi", "@nestjs/core", "next"];
+      if (apiFrameworks.some((p) => allDeps.includes(p))) return true;
+    } catch { /* ignore */ }
+  }
+  // Check for Python API frameworks
+  const pyFiles = ["requirements.txt", "pyproject.toml"];
+  for (const f of pyFiles) {
+    const fp = path.join(projectDir, f);
+    if (fs.existsSync(fp)) {
+      try {
+        const content = fs.readFileSync(fp, "utf8");
+        if (content.includes("fastapi") || content.includes("flask") || content.includes("django")) return true;
+      } catch { /* ignore */ }
+    }
+  }
+  return false;
+}
+
 function getInstalledVersion() {
   try {
     return fs.readFileSync(VERSION_FILE, "utf8").trim();
@@ -716,6 +780,37 @@ function doUpdateAll() {
     }
   }
 
+  // Health check: Playwright and Swagger across all projects
+  heading("Project Health");
+  let playwrightMissing = [];
+  let swaggerMissing = [];
+
+  for (const projectDir of projects) {
+    if (!fs.existsSync(projectDir)) continue;
+    const name = path.basename(projectDir);
+
+    if (!hasPlaywright(projectDir)) {
+      playwrightMissing.push(name);
+    }
+
+    if (hasApi(projectDir) && !hasSwagger(projectDir)) {
+      swaggerMissing.push(name);
+    }
+  }
+
+  if (playwrightMissing.length === 0 && swaggerMissing.length === 0) {
+    success("All projects have Playwright and Swagger configured");
+  } else {
+    if (playwrightMissing.length > 0) {
+      warn(`Playwright missing: ${playwrightMissing.join(", ")}`);
+      info("Playwright will be auto-installed when you run a GSD-T command in each project");
+    }
+    if (swaggerMissing.length > 0) {
+      warn(`Swagger/OpenAPI missing (API detected): ${swaggerMissing.join(", ")}`);
+      info("Swagger will be auto-configured when an API endpoint is created or modified");
+    }
+  }
+
   // Summary
   log("");
   heading("Update All Complete");
@@ -725,6 +820,12 @@ function doUpdateAll() {
   if (missing > 0) {
     log(`  Not found:           ${missing}`);
   }
+  if (playwrightMissing.length > 0) {
+    log(`  Missing Playwright:  ${playwrightMissing.length}`);
+  }
+  if (swaggerMissing.length > 0) {
+    log(`  Missing Swagger:     ${swaggerMissing.length}`);
+  }
   log("");
 }
 
@@ -804,7 +905,30 @@ function doDoctor() {
     info("No settings.json (not required)");
   }
 
-  // 7. Check for encoding issues in command files
+  // 7. Playwright check (current project)
+  const cwd = process.cwd();
+  if (hasPlaywright(cwd)) {
+    success("Playwright configured");
+  } else {
+    warn("Playwright not configured in this project");
+    info("Will be auto-installed when you run a GSD-T testing command");
+    issues++;
+  }
+
+  // 8. Swagger/OpenAPI check (current project)
+  if (hasApi(cwd)) {
+    if (hasSwagger(cwd)) {
+      success("Swagger/OpenAPI configured");
+    } else {
+      warn("API framework detected but no Swagger/OpenAPI spec found");
+      info("Will be auto-configured when an API endpoint is created or modified");
+      issues++;
+    }
+  } else {
+    info("No API framework detected (Swagger check skipped)");
+  }
+
+  // 9. Check for encoding issues in command files
   let encodingIssues = 0;
   for (const file of installed) {
     const content = fs.readFileSync(path.join(COMMANDS_DIR, file), "utf8");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekyzinc/gsd-t",
-  "version": "2.20.1",
+  "version": "2.20.3",
   "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

@@ -201,6 +201,15 @@ Before any command that involves testing (`gsd-t-execute`, `gsd-t-test-sync`, `g
 
 Playwright must always be ready before any testing occurs. Do not skip this check. Do not defer setup to "later."
 
+### Playwright Cleanup
+
+After Playwright tests finish (pass or fail), **kill any app/server processes that were started for the tests**. Playwright often launches a dev server (via `webServer` config or manually). These processes must not be left running:
+1. Check for any dev server processes spawned during the test run
+2. Kill them (e.g., `npx kill-port`, or terminate the process directly)
+3. Verify the port is free before proceeding
+
+This applies everywhere Playwright tests are executed: execute, test-sync, verify, quick, wave, debug, complete-milestone, and integrate.
+
 ## API Documentation Guard (Swagger/OpenAPI)
 
 **Every API endpoint MUST be documented in a Swagger/OpenAPI spec. No exceptions.**