@tekyzinc/gsd-t 2.10.0 → 2.10.2

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to GSD-T are documented here. Updated with each release.
 
+## [2.10.2] - 2026-02-11
+
+### Added
+- Version update check in `gsd-t-status` slash command — works inside Claude Code and ClaudeWebCLI sessions, not just the CLI binary
+
+### Fixed
+- Normalized `repository.url` in package.json (`git+https://` prefix)
+
+## [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

package/bin/gsd-t.js

@@ -28,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, "..");
@@ -776,6 +777,62 @@ 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" :
@@ -868,3 +925,5 @@ switch (command) {
     showHelp();
     process.exit(1);
 }
+
+checkForUpdates();

package/commands/gsd-t-status.md

@@ -40,4 +40,20 @@ If `.gsd-t/backlog.md` exists, read and parse it. Show total count and top 3 ite
 If there are blockers or issues, highlight them.
 If the user provides $ARGUMENTS, focus the status on that specific domain or aspect.
 
+## Version Check
+
+After displaying the project status, check for GSD-T updates:
+
+1. Read `~/.claude/.gsd-t-version` to get the installed version
+2. Read `~/.claude/.gsd-t-update-check` (JSON with `latest` and `timestamp` fields) to get the latest known version
+3. If the file doesn't exist or is unreadable, run `gsd-t status` (CLI) in the background to trigger a cache refresh, and skip the notice
+4. If `latest` is newer than the installed version, append to the report:
+
+```
+⬆️  GSD-T update available: {installed} → {latest}
+   Run: npm update -g @tekyzinc/gsd-t && gsd-t update-all
+```
+
+5. If versions match, skip — don't show anything
+
 $ARGUMENTS

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@tekyzinc/gsd-t",
-  "version": "2.10.0",
+  "version": "2.10.2",
   "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",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Tekyz-Inc/get-stuff-done-teams.git"
+    "url": "git+https://github.com/Tekyz-Inc/get-stuff-done-teams.git"
   },
   "homepage": "https://github.com/Tekyz-Inc/get-stuff-done-teams#readme",
   "keywords": [