@tekyzinc/gsd-t 2.24.6 → 2.24.8

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to GSD-T are documented here. Updated with each release.
 
+## [2.24.8] - 2026-02-18
+
+### Fixed
+- **CLAUDE.md update no longer overwrites user content**: Installer now uses marker-based merging (`<!-- GSD-T:START -->` / `<!-- GSD-T:END -->`). Updates only replace the GSD-T section between markers, preserving all user customizations. Existing installs without markers are auto-migrated. Backup still created for reference
+
+## [2.24.7] - 2026-02-18
+
+### Changed
+- **Next Command Hint redesigned**: Replaced plain `Next →` text with GSD-style "Next Up" visual block — divider lines, `▶ Next Up` header, phase name with description, command in backticks, and alternatives section. Format designed to trigger Claude Code's prompt suggestion engine, making the next command appear as ghost text in the user's input field
+
 ## [2.24.6] - 2026-02-18
 
 ### Added

package/bin/gsd-t.js

@@ -483,47 +483,80 @@ function installCommands(isUpdate) {
   return { gsdtCommands, utilityCommands };
 }
 
+const GSDT_START = "<!-- GSD-T:START";
+const GSDT_END = "<!-- GSD-T:END";
+
 function installGlobalClaudeMd(isUpdate) {
   heading("Global CLAUDE.md");
   const globalSrc = path.join(PKG_TEMPLATES, "CLAUDE-global.md");
 
   if (!fs.existsSync(GLOBAL_CLAUDE_MD)) {
-    copyFile(globalSrc, GLOBAL_CLAUDE_MD, "CLAUDE.md installed → ~/.claude/CLAUDE.md");
+    copyFile(globalSrc, GLOBAL_CLAUDE_MD, "CLAUDE.md installed");
+    return;
+  }
+
+  if (isSymlink(GLOBAL_CLAUDE_MD)) {
+    warn("Skipping CLAUDE.md — target is a symlink");
     return;
   }
 
   const existing = fs.readFileSync(GLOBAL_CLAUDE_MD, "utf8");
-  if (existing.includes("GSD-T: Contract-Driven Development")) {
-    updateExistingGlobalClaudeMd(globalSrc, existing, isUpdate);
+  const template = fs.readFileSync(globalSrc, "utf8");
+
+  if (existing.includes(GSDT_START)) {
+    mergeGsdtSection(existing, template, isUpdate);
+  } else if (existing.includes("GSD-T: Contract-Driven Development")) {
+    migrateToMarkers(existing, template);
   } else {
-    appendGsdtToClaudeMd(globalSrc);
+    appendGsdtToClaudeMd(template);
   }
 }
 
-function updateExistingGlobalClaudeMd(globalSrc, existing, isUpdate) {
+function mergeGsdtSection(existing, template, isUpdate) {
   if (!isUpdate) {
-    info("CLAUDE.md already contains GSD-T config — skipping");
-    info("Run 'gsd-t update' to overwrite with latest version");
+    info("CLAUDE.md already contains GSD-T config");
     return;
   }
-  const template = fs.readFileSync(globalSrc, "utf8");
-  if (normalizeEol(existing) === normalizeEol(template)) {
-    copyFile(globalSrc, GLOBAL_CLAUDE_MD, "CLAUDE.md updated (no customizations detected)");
+  const startIdx = existing.indexOf(GSDT_START);
+  const endMarkerIdx = existing.indexOf(GSDT_END);
+  if (startIdx === -1 || endMarkerIdx === -1) {
+    warn("GSD-T markers incomplete — appending fresh copy");
+    appendGsdtToClaudeMd(template);
     return;
   }
+  const endLineEnd = existing.indexOf("\n", endMarkerIdx);
+  const endIdx = endLineEnd === -1 ? existing.length : endLineEnd + 1;
+  const before = existing.substring(0, startIdx);
+  const after = existing.substring(endIdx);
+  const merged = before + template.trimEnd() + "\n" + after;
+  if (normalizeEol(merged) === normalizeEol(existing)) {
+    info("CLAUDE.md GSD-T section already up to date");
+    return;
+  }
+  const backupPath = GLOBAL_CLAUDE_MD + ".backup-" + Date.now();
+  fs.copyFileSync(GLOBAL_CLAUDE_MD, backupPath);
+  fs.writeFileSync(GLOBAL_CLAUDE_MD, merged);
+  success("CLAUDE.md GSD-T section updated (custom content preserved)");
+}
+
+function migrateToMarkers(existing, template) {
   const backupPath = GLOBAL_CLAUDE_MD + ".backup-" + Date.now();
-  if (!isSymlink(backupPath)) fs.copyFileSync(GLOBAL_CLAUDE_MD, backupPath);
-  else warn("Skipping backup — target is a symlink");
-  copyFile(globalSrc, GLOBAL_CLAUDE_MD, "CLAUDE.md updated");
-  warn(`Previous version backed up to ${path.basename(backupPath)}`);
-  info("Review the backup if you had custom additions to merge back in.");
-}
-
-function appendGsdtToClaudeMd(globalSrc) {
-  if (isSymlink(GLOBAL_CLAUDE_MD)) { warn("Skipping CLAUDE.md append — target is a symlink"); return; }
-  const gsdtContent = fs.readFileSync(globalSrc, "utf8");
-  const separator = "\n\n# ─── GSD-T Section (added by installer) ───\n\n";
-  fs.appendFileSync(GLOBAL_CLAUDE_MD, separator + gsdtContent);
+  fs.copyFileSync(GLOBAL_CLAUDE_MD, backupPath);
+  const sepIdx = existing.indexOf("# ─── GSD-T Section");
+  if (sepIdx !== -1) {
+    const before = existing.substring(0, sepIdx);
+    const merged = before + template.trimEnd() + "\n";
+    fs.writeFileSync(GLOBAL_CLAUDE_MD, merged);
+  } else {
+    fs.writeFileSync(GLOBAL_CLAUDE_MD, template);
+  }
+  success("CLAUDE.md migrated to marker-based format");
+  info("Backup saved: " + path.basename(backupPath));
+}
+
+function appendGsdtToClaudeMd(template) {
+  const separator = "\n\n";
+  fs.appendFileSync(GLOBAL_CLAUDE_MD, separator + template.trimEnd() + "\n");
   success("GSD-T config appended to existing CLAUDE.md");
   info("Your existing content was preserved.");
 }
@@ -1317,7 +1350,8 @@ module.exports = {
   checkDoctorClaudeMd,
   checkDoctorSettings,
   checkDoctorEncoding,
-  updateExistingGlobalClaudeMd,
+  mergeGsdtSection,
+  migrateToMarkers,
   appendGsdtToClaudeMd,
   readSettingsJson,
   readUpdateCache,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekyzinc/gsd-t",
-  "version": "2.24.6",
+  "version": "2.24.8",
   "description": "GSD-T: Contract-Driven Development for Claude Code — 43 slash commands with backlog management, impact analysis, test sync, and milestone archival",
   "author": "Tekyz, Inc.",
   "license": "MIT",

package/templates/CLAUDE-global.md

@@ -1,3 +1,4 @@
+<!-- GSD-T:START — Do not remove this marker. Content between START/END is managed by gsd-t update. -->
 # Prime Directives
 
 1. SIMPLICITY ABOVE ALL. Every change should be minimal and impact as little code as possible. No massive refactors.
@@ -361,33 +362,51 @@ If in doubt, skip research and proceed — research if execution reveals gaps.
 
 ### Next Command Hint
 
-When a GSD-T command completes (and does NOT auto-advance to the next phase), display a hint showing the recommended next command. Format:
+When a GSD-T command completes (and does NOT auto-advance to the next phase), display a "Next Up" block at the very end of your response. This format is designed to trigger Claude Code's prompt suggestion engine — making the next command appear as ghost text in the user's input field.
+
+**MANDATORY format** — use this exact structure:
+
+```
+───────────────────────────────────────────────────────────────
+
+## ▶ Next Up
+
+**{Phase Name}** — {one-line description of what happens next}
+
+`/user:gsd-t-{command}`
+
+───────────────────────────────────────────────────────────────
+```
+
+If there are alternative commands that also make sense, add them:
 
 ```
-Next → /user:gsd-t-{command}
+**Also available:**
+- `/user:gsd-t-{alt-1}` — {description}
+- `/user:gsd-t-{alt-2}` — {description}
 ```
 
 Successor mapping:
-| Completed | Next |
-|-----------|------|
-| `project` | `gsd-t-milestone` |
-| `feature` | `gsd-t-milestone` |
-| `milestone` | `gsd-t-partition` |
-| `partition` | `gsd-t-plan` (or `gsd-t-discuss` if complex) |
-| `discuss` | `gsd-t-plan` |
-| `plan` | `gsd-t-execute` (or `gsd-t-impact` if risky) |
-| `impact` | `gsd-t-execute` |
-| `execute` | `gsd-t-test-sync` |
-| `test-sync` | `gsd-t-verify` (or `gsd-t-integrate` if multi-domain) |
-| `integrate` | `gsd-t-verify` |
-| `verify` | `gsd-t-complete-milestone` |
-| `complete-milestone` | `gsd-t-status` |
-| `scan` | `gsd-t-promote-debt` or `gsd-t-milestone` |
-| `init` | `gsd-t-scan` or `gsd-t-milestone` |
-| `init-scan-setup` | `gsd-t-milestone` |
-| `gap-analysis` | `gsd-t-milestone` or `gsd-t-feature` |
-| `populate` | `gsd-t-status` |
-| `setup` | `gsd-t-status` |
+| Completed | Next | Also available |
+|-----------|------|----------------|
+| `project` | `milestone` | |
+| `feature` | `milestone` | |
+| `milestone` | `partition` | |
+| `partition` | `plan` | `discuss` (if complex) |
+| `discuss` | `plan` | |
+| `plan` | `execute` | `impact` (if risky) |
+| `impact` | `execute` | |
+| `execute` | `test-sync` | |
+| `test-sync` | `verify` | `integrate` (if multi-domain) |
+| `integrate` | `verify` | |
+| `verify` | `complete-milestone` | |
+| `complete-milestone` | `status` | |
+| `scan` | `promote-debt` | `milestone` |
+| `init` | `scan` | `milestone` |
+| `init-scan-setup` | `milestone` | |
+| `gap-analysis` | `milestone` | `feature` |
+| `populate` | `status` | |
+| `setup` | `status` | |
 
 Commands with no successor (standalone): `quick`, `debug`, `brainstorm`, `status`, `help`, `resume`, `prompt`, `log`, backlog commands.
 
@@ -438,3 +457,4 @@ When resuming work (new session or after /clear):
 6. Continue from current task — don't restart the phase
 
 **CRITICAL: Do NOT research how the system works. The docs tell you. Read them.**
+<!-- GSD-T:END — Do not remove this marker. -->