@tekyzinc/gsd-t 2.9.0 → 2.10.1

package/CHANGELOG.md

@@ -0,0 +1,118 @@
+# Changelog
+
+All notable changes to GSD-T are documented here. Updated with each release.
+
+## [2.10.1] - 2026-02-10
+
+### Added
+- Automatic update check — CLI queries npm registry (cached 24h, background refresh) and shows a notice box with update commands when a newer version is available
+
+## [2.10.0] - 2026-02-10
+
+### Added
+- `CHANGELOG.md` release notes document with full version history
+- `changelog` CLI subcommand — opens changelog in the browser (`gsd-t changelog`)
+- Clickable version links in CLI output (OSC 8 hyperlinks to changelog)
+- `checkin` command now auto-updates CHANGELOG.md on every version bump
+- `update-all` now creates CHANGELOG.md for registered projects that don't have one
+
+## [2.9.0] - 2026-02-10
+
+### Added
+- `gsd-t-setup` command — generates or restructures project CLAUDE.md by scanning codebase, detecting tech stack/conventions, and removing global duplicates
+
+## [2.8.1] - 2026-02-10
+
+### Added
+- Workflow Preferences section in global and project CLAUDE.md templates (Research Policy, Phase Flow defaults with per-project override support)
+
+## [2.8.0] - 2026-02-10
+
+### Added
+- Backlog management system: 7 new commands (`backlog-add`, `backlog-list`, `backlog-move`, `backlog-edit`, `backlog-remove`, `backlog-promote`, `backlog-settings`)
+- 2 new templates (`backlog.md`, `backlog-settings.md`)
+- Backlog initialization in `gsd-t-init` with auto-category derivation
+- Backlog summary in `gsd-t-status` report
+- Backlog section in `gsd-t-help`
+
+### Changed
+- Updated `gsd-t-init`, `gsd-t-status`, `gsd-t-help`, CLAUDE-global template, README with backlog integration
+
+## [2.7.0] - 2026-02-09
+
+### Added
+- `update-all` CLI command — updates global install + all registered project CLAUDE.md files
+- `register` CLI command — manually register a project in the GSD-T project registry
+- Auto-registration on `gsd-t init`
+- Project registry at `~/.claude/.gsd-t-projects`
+
+## [2.6.0] - 2026-02-09
+
+### Added
+- Destructive Action Guard — mandatory safeguard requiring explicit user approval before destructive or structural changes (schema drops, architecture replacements, module removal)
+- Guard enforced in global CLAUDE.md, project template, and all execution commands
+
+## [2.5.0] - 2026-02-09
+
+### Changed
+- Audited all 27 command files — added Document Ripple and Test Verification steps to 15 commands that were missing them
+- All code-modifying commands now enforce doc updates and test runs before completion
+
+## [2.4.0] - 2026-02-09
+
+### Added
+- Automatic version bumping in `checkin` command — determines patch/minor/major from change type
+
+## [2.3.0] - 2026-02-09
+
+### Added
+- Branch Guard — prevents commits on wrong branch by checking `Expected branch` in CLAUDE.md
+
+## [2.2.1] - 2026-02-09
+
+### Fixed
+- `gsd-t-discuss` now stops for user review when manually invoked (was auto-continuing even in manual mode)
+
+## [2.2.0] - 2026-02-09
+
+### Added
+- E2E test support in `test-sync`, `verify`, and `execute` commands
+
+## [2.1.0] - 2026-02-09
+
+### Added
+- `gsd-t-populate` command — auto-populate living docs from existing codebase
+- Semantic versioning system tracked in `progress.md`
+- Auto-update README on version changes
+
+## [2.0.2] - 2026-02-07
+
+### Changed
+- `gsd-t-init` now creates all 4 living document templates (`requirements.md`, `architecture.md`, `workflows.md`, `infrastructure.md`)
+- `gsd-t-scan` cross-populates findings into living docs
+
+## [2.0.1] - 2026-02-07
+
+### Fixed
+- Added `gsd-t-brainstorm` to all 4 reference files (README, GSD-T-README, CLAUDE-global, gsd-t-help)
+- Fixed workflow diagram alignment
+
+## [2.0.0] - 2026-02-07
+
+### Added
+- Renamed package to `@tekyzinc/gsd-t`
+- `gsd-t-brainstorm` command — creative exploration, rethinking, and idea generation
+- Initialized GSD-T state (`.gsd-t/` directory) on itself
+
+### Changed
+- Complete framework rewrite from GSD to GSD-T (contract-driven development)
+- npm package with CLI installer (`bin/gsd-t.js`)
+- 6 CLI subcommands: install, update, init, status, doctor, uninstall
+
+## [1.0.0] - 2026-02-07
+
+### Added
+- Initial GSD-T framework implementation
+- Full milestone workflow: partition, discuss, plan, impact, execute, test-sync, integrate, verify, complete
+- Agent Teams support for parallel execution
+- Living documents system (requirements, architecture, workflows, infrastructure)

package/README.md

@@ -72,6 +72,7 @@ npx @tekyzinc/gsd-t init [name]    # Scaffold GSD-T project (auto-registers)
 npx @tekyzinc/gsd-t register       # Register current directory as a GSD-T project
 npx @tekyzinc/gsd-t status         # Check installation + version
 npx @tekyzinc/gsd-t doctor         # Diagnose common issues
+npx @tekyzinc/gsd-t changelog      # Open changelog in the browser
 npx @tekyzinc/gsd-t uninstall      # Remove commands (keeps project files)
 ```
 

package/bin/gsd-t.js

@@ -12,11 +12,13 @@
  *   npx @tekyzinc/gsd-t status      — Show what's installed and check for updates
  *   npx @tekyzinc/gsd-t uninstall   — Remove GSD-T commands (leaves project files alone)
  *   npx @tekyzinc/gsd-t doctor      — Diagnose common issues
+ *   npx @tekyzinc/gsd-t changelog   — Open changelog in the browser
  */
 
 const fs = require("fs");
 const path = require("path");
 const os = require("os");
+const { execSync } = require("child_process");
 
 // ─── Configuration ───────────────────────────────────────────────────────────
 
@@ -26,6 +28,7 @@ const GLOBAL_CLAUDE_MD = path.join(CLAUDE_DIR, "CLAUDE.md");
 const SETTINGS_JSON = path.join(CLAUDE_DIR, "settings.json");
 const VERSION_FILE = path.join(CLAUDE_DIR, ".gsd-t-version");
 const PROJECTS_FILE = path.join(CLAUDE_DIR, ".gsd-t-projects");
+const UPDATE_CHECK_FILE = path.join(CLAUDE_DIR, ".gsd-t-update-check");
 
 // Where our package files live (relative to this script)
 const PKG_ROOT = path.resolve(__dirname, "..");
@@ -35,6 +38,7 @@ const PKG_EXAMPLES = path.join(PKG_ROOT, "examples");
 
 // Read our version from package.json
 const PKG_VERSION = require(path.join(PKG_ROOT, "package.json")).version;
+const CHANGELOG_URL = "https://github.com/Tekyz-Inc/get-stuff-done-teams/blob/main/CHANGELOG.md";
 
 // ─── Helpers ─────────────────────────────────────────────────────────────────
 
@@ -64,6 +68,12 @@ function info(msg) {
 function heading(msg) {
   console.log(`\n${BOLD}${msg}${RESET}`);
 }
+function link(text, url) {
+  return `\x1b]8;;${url}\x07${text}\x1b]8;;\x07`;
+}
+function versionLink(ver) {
+  return link(`v${ver || PKG_VERSION}`, CHANGELOG_URL);
+}
 
 function ensureDir(dir) {
   if (!fs.existsSync(dir)) {
@@ -140,7 +150,7 @@ function doInstall(opts = {}) {
   const isUpdate = opts.update || false;
   const verb = isUpdate ? "Updating" : "Installing";
 
-  heading(`${verb} GSD-T v${PKG_VERSION}`);
+  heading(`${verb} GSD-T ${versionLink()}`);
   log("");
 
   // 1. Create ~/.claude/commands/ if needed
@@ -224,7 +234,7 @@ function doInstall(opts = {}) {
   log("");
   log(`  Commands: ${gsdtCommands.length} GSD-T + ${utilityCommands.length} utility commands in ~/.claude/commands/`);
   log(`  Config:   ~/.claude/CLAUDE.md`);
-  log(`  Version:  ${PKG_VERSION}`);
+  log(`  Version:  ${versionLink()}`);
   log("");
   log(`${BOLD}Quick Start:${RESET}`);
   log(`  ${DIM}$${RESET} cd your-project`);
@@ -245,7 +255,7 @@ function doUpdate() {
   const installedVersion = getInstalledVersion();
 
   if (installedVersion === PKG_VERSION) {
-    heading(`GSD-T v${PKG_VERSION}`);
+    heading(`GSD-T ${versionLink()}`);
     info("Already up to date!");
     log("");
     log("  To force a reinstall, run:");
@@ -255,7 +265,7 @@ function doUpdate() {
   }
 
   if (installedVersion) {
-    heading(`Updating GSD-T: v${installedVersion} → v${PKG_VERSION}`);
+    heading(`Updating GSD-T: ${versionLink(installedVersion)} → ${versionLink()}`);
   }
 
   doInstall({ update: true });
@@ -372,12 +382,12 @@ function doStatus() {
   // Installed version
   const installedVersion = getInstalledVersion();
   if (installedVersion) {
-    success(`Installed version: ${installedVersion}`);
+    success(`Installed version: ${versionLink(installedVersion)}`);
     if (installedVersion !== PKG_VERSION) {
-      warn(`Latest version: ${PKG_VERSION}`);
+      warn(`Latest version: ${versionLink()}`);
       info(`Run 'npx @tekyzinc/gsd-t update' to update`);
     } else {
-      success(`Up to date (latest: ${PKG_VERSION})`);
+      success(`Up to date (latest: ${versionLink()})`);
     }
   } else {
     error("GSD-T not installed");
@@ -502,7 +512,7 @@ function doUpdateAll() {
   if (installedVersion !== PKG_VERSION) {
     doInstall({ update: true });
   } else {
-    heading(`GSD-T v${PKG_VERSION}`);
+    heading(`GSD-T ${versionLink()}`);
     success("Global commands already up to date");
   }
 
@@ -531,6 +541,7 @@ function doUpdateAll() {
   for (const projectDir of projects) {
     const projectName = path.basename(projectDir);
     const claudeMd = path.join(projectDir, "CLAUDE.md");
+    let projectUpdated = false;
 
     // Check project still exists
     if (!fs.existsSync(projectDir)) {
@@ -548,56 +559,77 @@ function doUpdateAll() {
     const content = fs.readFileSync(claudeMd, "utf8");
 
     // Check if the project CLAUDE.md needs the Destructive Action Guard
-    if (content.includes("Destructive Action Guard")) {
-      info(`${projectName} — already up to date`);
-      skipped++;
-      continue;
+    if (!content.includes("Destructive Action Guard")) {
+      const guardSection = [
+        "",
+        "",
+        "# Destructive Action Guard (MANDATORY)",
+        "",
+        "**NEVER perform destructive or structural changes without explicit user approval.** This applies at ALL autonomy levels.",
+        "",
+        "Before any of these actions, STOP and ask the user:",
+        "- DROP TABLE, DROP COLUMN, DROP INDEX, TRUNCATE, DELETE without WHERE",
+        "- Renaming or removing database tables or columns",
+        "- Schema migrations that lose data or break existing queries",
+        "- Replacing an existing architecture pattern (e.g., normalized → denormalized)",
+        "- Removing or replacing existing files/modules that contain working functionality",
+        "- Changing ORM models in ways that conflict with the existing database schema",
+        "- Removing API endpoints or changing response shapes that existing clients depend on",
+        "- Any change that would require other parts of the system to be rewritten",
+        "",
+        '**Rule: "Adapt new code to existing structures, not the other way around."**',
+        "",
+      ].join("\n");
+
+      let newContent;
+      const preCommitMatch = content.match(/\n(#{1,3} Pre-Commit Gate)/);
+      const dontDoMatch = content.match(/\n(#{1,3} Don't Do These Things)/);
+
+      if (preCommitMatch) {
+        newContent = content.replace(
+          "\n" + preCommitMatch[1],
+          guardSection + "\n" + preCommitMatch[1]
+        );
+      } else if (dontDoMatch) {
+        newContent = content.replace(
+          "\n" + dontDoMatch[1],
+          guardSection + "\n" + dontDoMatch[1]
+        );
+      } else {
+        newContent = content + guardSection;
+      }
+
+      fs.writeFileSync(claudeMd, newContent);
+      success(`${projectName} — added Destructive Action Guard`);
+      projectUpdated = true;
     }
 
-    // Add the Destructive Action Guard section
-    const guardSection = [
-      "",
-      "",
-      "# Destructive Action Guard (MANDATORY)",
-      "",
-      "**NEVER perform destructive or structural changes without explicit user approval.** This applies at ALL autonomy levels.",
-      "",
-      "Before any of these actions, STOP and ask the user:",
-      "- DROP TABLE, DROP COLUMN, DROP INDEX, TRUNCATE, DELETE without WHERE",
-      "- Renaming or removing database tables or columns",
-      "- Schema migrations that lose data or break existing queries",
-      "- Replacing an existing architecture pattern (e.g., normalized → denormalized)",
-      "- Removing or replacing existing files/modules that contain working functionality",
-      "- Changing ORM models in ways that conflict with the existing database schema",
-      "- Removing API endpoints or changing response shapes that existing clients depend on",
-      "- Any change that would require other parts of the system to be rewritten",
-      "",
-      '**Rule: "Adapt new code to existing structures, not the other way around."**',
-      "",
-    ].join("\n");
-
-    let newContent;
-    // Match headings at any level (# or ## or ###)
-    const preCommitMatch = content.match(/\n(#{1,3} Pre-Commit Gate)/);
-    const dontDoMatch = content.match(/\n(#{1,3} Don't Do These Things)/);
-
-    if (preCommitMatch) {
-      newContent = content.replace(
-        "\n" + preCommitMatch[1],
-        guardSection + "\n" + preCommitMatch[1]
-      );
-    } else if (dontDoMatch) {
-      newContent = content.replace(
-        "\n" + dontDoMatch[1],
-        guardSection + "\n" + dontDoMatch[1]
-      );
-    } else {
-      newContent = content + guardSection;
+    // Create CHANGELOG.md if it doesn't exist
+    const changelogPath = path.join(projectDir, "CHANGELOG.md");
+    if (!fs.existsSync(changelogPath)) {
+      const today = new Date().toISOString().split("T")[0];
+      const changelogContent = [
+        "# Changelog",
+        "",
+        "All notable changes to this project are documented here.",
+        "",
+        `## [0.1.0] - ${today}`,
+        "",
+        "### Added",
+        "- Initial changelog created by GSD-T",
+        "",
+      ].join("\n");
+      fs.writeFileSync(changelogPath, changelogContent);
+      success(`${projectName} — created CHANGELOG.md`);
+      projectUpdated = true;
     }
 
-    fs.writeFileSync(claudeMd, newContent);
-    success(`${projectName} — updated CLAUDE.md`);
-    updated++;
+    if (projectUpdated) {
+      updated++;
+    } else {
+      info(`${projectName} — already up to date`);
+      skipped++;
+    }
   }
 
   // Summary
@@ -628,7 +660,6 @@ function doDoctor() {
   }
 
   // 2. Claude Code installed?
-  const { execSync } = require("child_process");
   try {
     const claudeVersion = execSync("claude --version 2>&1", { encoding: "utf8" }).trim();
     success(`Claude Code: ${claudeVersion}`);
@@ -746,6 +777,75 @@ function doRegister() {
   log("");
 }
 
+function checkForUpdates() {
+  // Skip check for update/install/update-all (they handle it themselves)
+  const skipCommands = ["install", "update", "update-all", "--version", "-v"];
+  if (skipCommands.includes(command)) return;
+
+  // Read cache (sync, fast)
+  let cached = null;
+  try {
+    if (fs.existsSync(UPDATE_CHECK_FILE)) {
+      cached = JSON.parse(fs.readFileSync(UPDATE_CHECK_FILE, "utf8"));
+    }
+  } catch { /* ignore corrupt cache */ }
+
+  // Show notice from cache if newer version is known
+  if (cached && cached.latest && cached.latest !== PKG_VERSION) {
+    showUpdateNotice(cached.latest);
+  }
+
+  // Refresh cache in background if stale (older than 24h) or missing
+  const isStale = !cached || (Date.now() - cached.timestamp) > 86400000;
+  if (isStale) {
+    const script = `
+      const https = require("https");
+      const fs = require("fs");
+      https.get("https://registry.npmjs.org/@tekyzinc/gsd-t/latest",
+        { timeout: 5000 }, (res) => {
+        let d = "";
+        res.on("data", (c) => d += c);
+        res.on("end", () => {
+          try {
+            const v = JSON.parse(d).version;
+            fs.writeFileSync(${JSON.stringify(UPDATE_CHECK_FILE)},
+              JSON.stringify({ latest: v, timestamp: Date.now() }));
+          } catch {}
+        });
+      }).on("error", () => {});
+    `.replace(/\n/g, "");
+    const { spawn } = require("child_process");
+    const child = spawn(process.execPath, ["-e", script], {
+      detached: true,
+      stdio: "ignore",
+    });
+    child.unref();
+  }
+}
+
+function showUpdateNotice(latest) {
+  log("");
+  log(`  ${YELLOW}╭──────────────────────────────────────────────╮${RESET}`);
+  log(`  ${YELLOW}│${RESET}  Update available: ${DIM}${PKG_VERSION}${RESET} → ${GREEN}${latest}${RESET}            ${YELLOW}│${RESET}`);
+  log(`  ${YELLOW}│${RESET}  Run: ${CYAN}npm update -g @tekyzinc/gsd-t${RESET}         ${YELLOW}│${RESET}`);
+  log(`  ${YELLOW}│${RESET}  Then: ${CYAN}gsd-t update-all${RESET}                     ${YELLOW}│${RESET}`);
+  log(`  ${YELLOW}│${RESET}  Changelog: ${CYAN}gsd-t changelog${RESET}                  ${YELLOW}│${RESET}`);
+  log(`  ${YELLOW}╰──────────────────────────────────────────────╯${RESET}`);
+}
+
+function doChangelog() {
+  const openCmd =
+    process.platform === "win32" ? "start" :
+    process.platform === "darwin" ? "open" : "xdg-open";
+  try {
+    execSync(`${openCmd} ${CHANGELOG_URL}`, { stdio: "ignore" });
+    success(`Opened changelog in browser`);
+  } catch {
+    // Fallback: print the URL
+    log(`\n  ${CHANGELOG_URL}\n`);
+  }
+}
+
 function showHelp() {
   log("");
   log(`${BOLD}GSD-T${RESET} — Contract-Driven Development for Claude Code`);
@@ -762,6 +862,7 @@ function showHelp() {
   log(`  ${CYAN}status${RESET}         Show installation status + check for updates`);
   log(`  ${CYAN}uninstall${RESET}      Remove GSD-T commands (keeps project files)`);
   log(`  ${CYAN}doctor${RESET}         Diagnose common issues`);
+  log(`  ${CYAN}changelog${RESET}      Open changelog in the browser`);
   log(`  ${CYAN}help${RESET}           Show this help`);
   log("");
   log(`${BOLD}Examples:${RESET}`);
@@ -807,6 +908,9 @@ switch (command) {
   case "doctor":
     doDoctor();
     break;
+  case "changelog":
+    doChangelog();
+    break;
   case "help":
   case "--help":
   case "-h":
@@ -821,3 +925,5 @@ switch (command) {
     showHelp();
     process.exit(1);
 }
+
+checkForUpdates();

package/commands/checkin.md

@@ -20,11 +20,18 @@ Automatically stage, commit, and push all updated files to GitHub with automatic
 8. Update the version in `package.json`
 9. If `.gsd-t/progress.md` exists, check for a `## Version` line and update it (or add one after the `## Date` line)
 
+### Release Notes
+
+10. If `CHANGELOG.md` exists in the project root, prepend an entry for this version:
+    - Use the format: `## [X.Y.Z] - YYYY-MM-DD` followed by `### Added`, `### Changed`, `### Fixed`, or `### Removed` subsections as appropriate
+    - Summarize the changes in 1-3 bullet points per subsection
+    - Place the new entry directly after the file header (before any existing version entries)
+
 ### Commit and Push
 
-10. Stage all changes (including the version bump) with `git add -A`
-11. Create a commit with a descriptive message summarizing the changes. Include `(vX.Y.Z)` at the end of the first line. Example: `fix: resolve branch guard edge case (v2.3.1)`
-12. Push to origin with `git push`
-13. Confirm success to the user, including the old → new version
+11. Stage all changes (including the version bump and changelog) with `git add -A`
+12. Create a commit with a descriptive message summarizing the changes. Include `(vX.Y.Z)` at the end of the first line. Example: `fix: resolve branch guard edge case (v2.3.1)`
+13. Push to origin with `git push`
+14. Confirm success to the user, including the old → new version
 
 Use the standard commit message format with Co-Authored-By line.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekyzinc/gsd-t",
-  "version": "2.9.0",
+  "version": "2.10.1",
   "description": "GSD-T: Contract-Driven Development for Claude Code — 35 slash commands with backlog management, impact analysis, test sync, and milestone archival",
   "author": "Tekyz, Inc.",
   "license": "MIT",
@@ -25,7 +25,8 @@
     "commands/",
     "templates/",
     "examples/",
-    "docs/"
+    "docs/",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=16.0.0"