@tekyzinc/gsd-t 2.30.10 → 2.31.11

package/README.md

@@ -94,6 +94,7 @@ This will replace changed command files, back up your CLAUDE.md if customized, a
 | Command | Purpose | Auto |
 |---------|---------|------|
 | `/user:gsd {request}` | Describe what you need → auto-routes to the right command | Manual |
+| _(any plain text)_ | Auto-routed via UserPromptSubmit hook — no leading `/` needed | Auto |
 
 ### Help & Onboarding
 

package/bin/gsd-t.js

@@ -456,6 +456,66 @@ function configureUpdateCheckHook(scriptPath) {
   }
 }
 
+// ─── Auto-Route Hook ─────────────────────────────────────────────────────────
+
+const AUTO_ROUTE_SCRIPT = "gsd-t-auto-route.js";
+
+function installAutoRoute() {
+  ensureDir(SCRIPTS_DIR);
+
+  const src = path.join(PKG_SCRIPTS, AUTO_ROUTE_SCRIPT);
+  const dest = path.join(SCRIPTS_DIR, AUTO_ROUTE_SCRIPT);
+
+  if (!fs.existsSync(src)) {
+    warn("Auto-route script not found in package — skipping");
+    return;
+  }
+
+  const srcContent = fs.readFileSync(src, "utf8");
+  const destContent = fs.existsSync(dest) ? fs.readFileSync(dest, "utf8") : "";
+
+  if (normalizeEol(srcContent) !== normalizeEol(destContent)) {
+    copyFile(src, dest, AUTO_ROUTE_SCRIPT);
+  } else {
+    info("Auto-route script unchanged");
+  }
+
+  configureAutoRouteHook(dest);
+}
+
+function configureAutoRouteHook(scriptPath) {
+  const parsed = readSettingsJson();
+  if (parsed === null && fs.existsSync(SETTINGS_JSON)) {
+    warn("settings.json has invalid JSON — cannot configure auto-route hook");
+    return;
+  }
+  const settings = parsed || {};
+  if (!settings.hooks) settings.hooks = {};
+  if (!settings.hooks.UserPromptSubmit) settings.hooks.UserPromptSubmit = [];
+
+  const cmd = `node "${scriptPath.replace(/\\/g, "\\\\")}"`;
+  const hasAutoRoute = settings.hooks.UserPromptSubmit.some((entry) =>
+    entry.hooks && entry.hooks.some((h) => h.command && h.command.includes(AUTO_ROUTE_SCRIPT))
+  );
+
+  if (hasAutoRoute) {
+    info("Auto-route hook already configured");
+    return;
+  }
+
+  settings.hooks.UserPromptSubmit.push({
+    matcher: "",
+    hooks: [{ type: "command", command: cmd }],
+  });
+
+  if (!isSymlink(SETTINGS_JSON)) {
+    fs.writeFileSync(SETTINGS_JSON, JSON.stringify(settings, null, 2));
+    success("Auto-route hook configured in settings.json");
+  } else {
+    warn("Skipping settings.json write — target is a symlink");
+  }
+}
+
 // ─── Utility Scripts ─────────────────────────────────────────────────────────
 
 const UTILITY_SCRIPTS = ["gsd-t-tools.js", "gsd-t-statusline.js"];
@@ -597,6 +657,9 @@ function doInstall(opts = {}) {
   heading("Update Check (Session Start)");
   installUpdateCheck();
 
+  heading("Auto-Route (UserPromptSubmit)");
+  installAutoRoute();
+
   heading("Utility Scripts");
   installUtilityScripts();
   saveInstalledVersion();

package/commands/gsd-t-help.md

@@ -135,11 +135,13 @@ Use these when user asks for help on a specific command:
 
 ### gsd (smart router)
 - **Summary**: Describe what you need in plain language — auto-routes to the right GSD-T command using semantic evaluation
-- **Auto-invoked**: No
+- **Auto-invoked**: Yes — via UserPromptSubmit hook when prompt does not start with `/`
 - **Files**: Reads `CLAUDE.md`, `.gsd-t/progress.md`, command summaries from `gsd-t-help`
 - **How it works**: Evaluates your request against every command's purpose and "Use when" criteria. Commands that match get shortlisted, best fit is selected. Shows runner-up when close.
+- **Auto-route**: After `gsd-t install`, any plain text message (no leading `/`) is automatically routed through `/gsd`. Slash commands pass through unchanged. Binary detection — no heuristics.
 - **Use when**: You don't want to remember which command to use — just describe what you want
 - **Examples**: `/user:gsd Fix the login bug`, `/user:gsd Add dark mode`, `/user:gsd Scan for tech debt`
+- **Auto-route examples**: `Fix the login bug` (no slash needed), `Add dark mode`, `Scan for tech debt`
 
 ### prompt
 - **Summary**: Help formulate project/feature/milestone prompts through guided questions

package/docs/GSD-T-README.md

@@ -63,6 +63,7 @@ GSD-T reads all state files and tells you exactly where you left off.
 | Command | Purpose | Auto |
 |---------|---------|------|
 | `/user:gsd {request}` | Describe what you need → auto-routes to the right command | Manual |
+| _(any plain text)_ | Auto-routed via UserPromptSubmit hook — no leading `/` needed | Auto |
 
 ### Help & Onboarding
 

package/package.json

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

package/scripts/gsd-t-auto-route.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+/**
+ * GSD-T UserPromptSubmit hook — auto-routes plain text prompts through /gsd.
+ *
+ * Receives JSON on stdin: { "prompt": "...", "cwd": "...", "session_id": "..." }
+ * Outputs to stdout: injected as system context before Claude processes the prompt.
+ *
+ * Logic:
+ *   - Not a GSD-T project (no .gsd-t/progress.md in cwd) → exit silently
+ *   - Prompt starts with "/" → exit silently (user typed a command, pass through)
+ *   - Prompt is plain text → emit [GSD-T AUTO-ROUTE] signal so Claude routes via /gsd
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+let input = "";
+process.stdin.setEncoding("utf8");
+process.stdin.on("data", (chunk) => { input += chunk; });
+process.stdin.on("end", () => {
+  try {
+    const data = JSON.parse(input);
+    // Guard: only activate in GSD-T projects
+    const cwd = typeof data.cwd === "string" ? data.cwd : process.cwd();
+    if (!fs.existsSync(path.join(cwd, ".gsd-t", "progress.md"))) process.exit(0);
+    const prompt = (typeof data.prompt === "string" ? data.prompt : "").trimStart();
+    if (prompt.startsWith("/")) process.exit(0); // slash command — pass through
+    if (!prompt) process.exit(0);                // empty prompt — pass through
+    // Plain text prompt in a GSD-T project — inject routing signal
+    process.stdout.write(
+      "[GSD-T AUTO-ROUTE] The user typed a plain text message (no leading /). " +
+      "Route it automatically through the /gsd smart router — execute the /user:gsd " +
+      "command with the user's full message as the argument."
+    );
+  } catch {
+    // JSON parse error or any other failure — never block the prompt
+  }
+  process.exit(0);
+});

package/templates/CLAUDE-global.md

@@ -191,6 +191,8 @@ On session start, a version check hook auto-updates GSD-T and outputs a status m
 
 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.
 
+**Exception — Auto-Route signal**: When `[GSD-T AUTO-ROUTE]` appears in your context (injected by the UserPromptSubmit hook), the user's plain text message should be treated as a `/user:gsd {message}` invocation. Execute the `/gsd` smart router with the user's full message as the argument instead of replying conversationally. The hook only fires in GSD-T projects (directories containing `.gsd-t/progress.md`) — it silently passes through in all other directories.
+
 ## Auto-Init Guard
 
 Before executing any GSD-T workflow command, check if **any** of these files are missing in the current project: