@tekyzinc/gsd-t 2.20.0 → 2.20.2

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to GSD-T are documented here. Updated with each release.
 
+## [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
+- **API Documentation Guard (Swagger/OpenAPI)**: Every API endpoint must be documented in Swagger/OpenAPI spec — no exceptions. Auto-detects framework and installs appropriate Swagger integration. Swagger URL must be published in CLAUDE.md, README.md, and docs/infrastructure.md
+- Pre-Commit Gate now checks for Swagger spec updates on any API endpoint change
+
 ## [2.20.0] - 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.0",
+  "version": "2.20.2",
   "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,25 @@ 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."
 
+## API Documentation Guard (Swagger/OpenAPI)
+
+**Every API endpoint MUST be documented in a Swagger/OpenAPI spec. No exceptions.**
+
+When any GSD-T command creates or modifies an API endpoint:
+1. **If no Swagger/OpenAPI spec exists**: Set one up immediately
+   - Detect the framework (Express, Fastify, Hono, Django, FastAPI, etc.)
+   - Install the appropriate Swagger integration (e.g., `swagger-jsdoc` + `swagger-ui-express`, `@fastify/swagger`, FastAPI's built-in OpenAPI)
+   - Create the OpenAPI spec file or configure auto-generation from code
+   - Add a `/docs` or `/api-docs` route serving the Swagger UI
+2. **Update the spec**: Every new or changed endpoint must be reflected in the Swagger/OpenAPI spec — routes, request/response schemas, auth requirements, error responses
+3. **Publish the Swagger URL**: The Swagger/API docs URL MUST appear in:
+   - `CLAUDE.md` — under Documentation or Infrastructure section
+   - `README.md` — under API section or Getting Started
+   - `docs/infrastructure.md` — under API documentation
+4. **Verify**: After any API change, confirm the Swagger UI loads and reflects the current endpoints
+
+This applies during: `gsd-t-execute`, `gsd-t-quick`, `gsd-t-integrate`, `gsd-t-wave`, and any command that touches API code.
+
 ## Prime Rule
 KEEP GOING. Only stop for:
 1. Unrecoverable errors after 2 fix attempts
@@ -219,8 +238,10 @@ BEFORE EVERY COMMIT:
   │     Compare against "Expected branch" in project CLAUDE.md
   │     WRONG BRANCH → STOP. Do NOT commit. Switch to the correct branch first.
   │     No guard set → Proceed (but warn user to set one)
-  ├── Did I change an API endpoint or response shape?
+  ├── Did I create or change an API endpoint or response shape?
   │     YES → Update .gsd-t/contracts/api-contract.md
+  │     YES → Update Swagger/OpenAPI spec (see API Documentation Guard below)
+  │     YES → Verify Swagger URL is in CLAUDE.md and README.md
   ├── Did I change the database schema?
   │     YES → Update .gsd-t/contracts/schema-contract.md AND docs/schema.md
   ├── Did I add/change a UI component interface?