@tekyzinc/gsd-t 2.11.3 → 2.11.5

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to GSD-T are documented here. Updated with each release.
 
+## [2.11.5] - 2026-02-12
+
+### Added
+- SessionStart hook script (`~/.claude/scripts/gsd-t-update-check.js`) for automatic update notifications in Claude Code sessions
+- "Update Notices" instruction in global CLAUDE.md template — Claude relays update notices to the user on first response
+
+## [2.11.4] - 2026-02-12
+
+### Fixed
+- First-run update check now fetches synchronously when no cache exists — notification shows immediately instead of requiring a second run
+
 ## [2.11.3] - 2026-02-12
 
 ### Changed

package/bin/gsd-t.js

@@ -805,9 +805,25 @@ function checkForUpdates() {
     showUpdateNotice(cached.latest);
   }
 
-  // Refresh cache in background if stale (older than 1h) or missing
   const isStale = !cached || (Date.now() - cached.timestamp) > 3600000;
-  if (isStale) {
+
+  if (!cached && isStale) {
+    // No cache at all — fetch synchronously so first run shows notification
+    try {
+      const result = execSync(
+        `${process.execPath} -e "const h=require('https');h.get('https://registry.npmjs.org/@tekyzinc/gsd-t/latest',{timeout:5000},(r)=>{let d='';r.on('data',(c)=>d+=c);r.on('end',()=>{try{process.stdout.write(JSON.parse(d).version)}catch{}})}).on('error',()=>{})"`,
+        { timeout: 8000, encoding: "utf8" }
+      ).trim();
+      if (result) {
+        fs.writeFileSync(UPDATE_CHECK_FILE,
+          JSON.stringify({ latest: result, timestamp: Date.now() }));
+        if (isNewerVersion(result, PKG_VERSION)) {
+          showUpdateNotice(result);
+        }
+      }
+    } catch { /* timeout or network error — skip */ }
+  } else if (isStale) {
+    // Cache exists but stale — refresh in background (non-blocking)
     const script = `
       const https = require("https");
       const fs = require("fs");

package/package.json

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

package/templates/CLAUDE-global.md

@@ -149,6 +149,15 @@ Even in development, the user may have:
 
 # Autonomous Execution Rules
 
+## Update Notices
+
+If a `[GSD-T UPDATE]` message appears in session startup context, show it to the user in your first response. Format it as:
+
+```
+⬆️  GSD-T update available: {installed} → {latest}
+   Run: npm update -g @tekyzinc/gsd-t && gsd-t update-all
+```
+
 ## Conversation vs. Work
 
 Only execute GSD-T workflow behavior when a `/gsd-t-*` command is invoked or when actively mid-phase (resumed via `/gsd-t-resume`). **Plain text messages — especially questions — should be answered conversationally.** Do not launch into workflow execution, file reading, or phase advancement from a question or comment. If the user wants work done, they will invoke a command.