gsd-pi 2.78.0 → 2.78.1-dev.8a893322c

package/dist/worktree-status-banner.js

@@ -0,0 +1,132 @@
+// GSD worktree startup banner
+import { execFileSync } from 'node:child_process';
+import { existsSync, realpathSync } from 'node:fs';
+import { join, resolve, sep } from 'node:path';
+import chalk from 'chalk';
+function normalizePath(path) {
+    const normalized = path
+        .replaceAll('\\', '/')
+        .replace(/^\/\/\?\//, '')
+        .replace(/\/+$/, '');
+    return process.platform === 'win32' ? normalized.toLowerCase() : normalized;
+}
+function gitExec(basePath, args) {
+    try {
+        return execFileSync('git', args, {
+            cwd: basePath,
+            stdio: ['ignore', 'pipe', 'ignore'],
+            encoding: 'utf-8',
+            env: { ...process.env, GIT_TERMINAL_PROMPT: '0', GCM_INTERACTIVE: 'Never' },
+        }).trim();
+    }
+    catch {
+        return '';
+    }
+}
+function parseWorktreeList(output) {
+    if (!output)
+        return [];
+    const entries = [];
+    const blocks = output.replaceAll('\r\n', '\n').split('\n\n').filter(Boolean);
+    for (const block of blocks) {
+        const lines = block.split('\n');
+        const wtLine = lines.find((line) => line.startsWith('worktree '));
+        const branchLine = lines.find((line) => line.startsWith('branch '));
+        if (!wtLine)
+            continue;
+        entries.push({
+            path: wtLine.replace('worktree ', ''),
+            branch: branchLine ? branchLine.replace('branch refs/heads/', '') : '',
+            isBare: lines.some((line) => line === 'bare'),
+        });
+    }
+    return entries;
+}
+function existingPathVariants(path) {
+    const variants = [resolve(path)];
+    if (existsSync(path)) {
+        try {
+            variants.push(realpathSync(path));
+        }
+        catch {
+            // Best effort only; the unresolved path is still useful for matching.
+        }
+    }
+    return [...new Set(variants.map(normalizePath))];
+}
+function findGsdWorktrees(basePath, entries) {
+    const roots = existingPathVariants(join(basePath, '.gsd', 'worktrees'));
+    const worktrees = [];
+    for (const entry of entries) {
+        if (entry.isBare || !entry.branch)
+            continue;
+        const branchWorktreeName = entry.branch.startsWith('worktree/')
+            ? entry.branch.slice('worktree/'.length)
+            : entry.branch.startsWith('milestone/')
+                ? entry.branch.slice('milestone/'.length)
+                : null;
+        const entryVariants = existingPathVariants(entry.path);
+        const matchedRoot = roots.find((root) => entryVariants.some((variant) => variant.startsWith(`${root}/`) || variant.startsWith(`${root}${sep}`)));
+        const matchesBranchLeaf = branchWorktreeName
+            ? entryVariants.some((variant) => variant.split('/').pop() === branchWorktreeName)
+            : false;
+        if (!matchedRoot && !matchesBranchLeaf)
+            continue;
+        const matchedPath = matchedRoot
+            ? entryVariants.find((variant) => variant.startsWith(`${matchedRoot}/`) || variant.startsWith(`${matchedRoot}${sep}`))
+            : undefined;
+        let name = matchedRoot && matchedPath ? matchedPath.slice(matchedRoot.length + 1) : '';
+        if ((!name || name.includes('/')) && branchWorktreeName && matchesBranchLeaf) {
+            name = branchWorktreeName;
+        }
+        if (!name || name.includes('/'))
+            continue;
+        worktrees.push({ name, branch: entry.branch });
+    }
+    return worktrees;
+}
+function detectMainBranch(basePath) {
+    const symbolic = gitExec(basePath, ['symbolic-ref', 'refs/remotes/origin/HEAD']);
+    const remoteMatch = symbolic.match(/refs\/remotes\/origin\/(.+)$/);
+    if (remoteMatch?.[1])
+        return remoteMatch[1];
+    if (gitExec(basePath, ['show-ref', '--verify', 'refs/heads/main']))
+        return 'main';
+    if (gitExec(basePath, ['show-ref', '--verify', 'refs/heads/master']))
+        return 'master';
+    return gitExec(basePath, ['branch', '--show-current']);
+}
+function branchHasChanges(basePath, mainBranch, branch) {
+    try {
+        execFileSync('git', ['diff', '--quiet', mainBranch, branch], {
+            cwd: basePath,
+            stdio: ['ignore', 'ignore', 'ignore'],
+            env: { ...process.env, GIT_TERMINAL_PROMPT: '0', GCM_INTERACTIVE: 'Never' },
+        });
+        return false;
+    }
+    catch {
+        return true;
+    }
+}
+export function showWorktreeStatusBanner(basePath) {
+    const worktreesDir = join(basePath, '.gsd', 'worktrees');
+    if (!existsSync(worktreesDir))
+        return;
+    const entries = parseWorktreeList(gitExec(basePath, ['worktree', 'list', '--porcelain']));
+    const worktrees = findGsdWorktrees(basePath, entries);
+    if (worktrees.length === 0)
+        return;
+    const mainBranch = detectMainBranch(basePath);
+    if (!mainBranch)
+        return;
+    const withChanges = worktrees.filter((worktree) => branchHasChanges(basePath, mainBranch, worktree.branch));
+    if (withChanges.length === 0)
+        return;
+    const names = withChanges.map((worktree) => chalk.cyan(worktree.name)).join(', ');
+    process.stderr.write(chalk.dim('[gsd] ') +
+        chalk.yellow(`${withChanges.length} worktree${withChanges.length === 1 ? '' : 's'} with unmerged changes: `) +
+        names + '\n' +
+        chalk.dim('[gsd] ') +
+        chalk.dim('Resume: gsd -w <name>  |  Merge: gsd worktree merge <name>  |  List: gsd worktree list\n\n'));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd-pi",
-  "version": "2.78.0",
+  "version": "2.78.1-dev.8a893322c",
   "description": "GSD — Get Shit Done coding agent",
   "license": "MIT",
   "repository": {
@@ -128,7 +128,6 @@
     "playwright": "^1.58.2",
     "proper-lockfile": "^4.1.2",
     "proxy-agent": "^6.5.0",
-    "semver": "^7.7.4",
     "sharp": "^0.34.5",
     "sql.js": "^1.14.1",
     "strip-ansi": "^7.1.0",
@@ -138,7 +137,6 @@
   "devDependencies": {
     "@types/node": "^24.12.0",
     "@types/picomatch": "^4.0.2",
-    "@types/semver": "^7.7.1",
     "c8": "^11.0.0",
     "esbuild": "^0.25.12",
     "jiti": "^2.6.1",

package/packages/daemon/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gsd-build/daemon",
-  "version": "2.78.0",
+  "version": "2.78.1",
   "description": "GSD daemon — background process for project monitoring and Discord integration",
   "license": "MIT",
   "repository": {
@@ -29,7 +29,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.52.0",
-    "@gsd-build/rpc-client": "^2.78.0",
+    "@gsd-build/rpc-client": "^2.78.1",
     "discord.js": "^14.25.1",
     "yaml": "^2.8.0",
     "zod": "^3.24.0"

package/packages/mcp-server/dist/alias-telemetry.d.ts

@@ -0,0 +1,8 @@
+/** JSONL `event` field. Namespaced for `grep deprecation`. */
+export declare const ALIAS_USAGE_EVENT: "deprecation.mcp_alias_used";
+/**
+ * Emit a single-line JSONL record signaling that an alias tool was invoked.
+ * Failures are swallowed — telemetry must never break MCP request handling.
+ */
+export declare function logAliasUsage(alias: string, canonical: string): void;
+//# sourceMappingURL=alias-telemetry.d.ts.map

package/packages/mcp-server/dist/alias-telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias-telemetry.d.ts","sourceRoot":"","sources":["../src/alias-telemetry.ts"],"names":[],"mappings":"AAUA,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,EAAG,4BAAqC,CAAC;AAEvE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAYpE"}

package/packages/mcp-server/dist/alias-telemetry.js

@@ -0,0 +1,30 @@
+// @gsd-build/mcp-server + alias-telemetry — usage telemetry on the 11 alias
+// `gsd_*` tools. Step 1 of a two-step deprecation (#5031). Always-on so we
+// actually capture data during the window. Single JSON line per invocation
+// to stderr — negligible overhead vs. the MCP request handler itself.
+//
+// Capture pattern: `<mcp-server-launch> 2>> alias-usage.jsonl`. After a
+// long-enough window with zero entries, the alias tools can be removed in
+// a follow-up PR. Filter with `grep deprecation` — the `event` field is
+// namespaced for that purpose.
+/** JSONL `event` field. Namespaced for `grep deprecation`. */
+export const ALIAS_USAGE_EVENT = "deprecation.mcp_alias_used";
+/**
+ * Emit a single-line JSONL record signaling that an alias tool was invoked.
+ * Failures are swallowed — telemetry must never break MCP request handling.
+ */
+export function logAliasUsage(alias, canonical) {
+    try {
+        const record = {
+            event: ALIAS_USAGE_EVENT,
+            ts: Date.now(),
+            alias,
+            canonical,
+        };
+        process.stderr.write(`${JSON.stringify(record)}\n`);
+    }
+    catch {
+        // swallow — telemetry must never break the request handler
+    }
+}
+//# sourceMappingURL=alias-telemetry.js.map

package/packages/mcp-server/dist/alias-telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias-telemetry.js","sourceRoot":"","sources":["../src/alias-telemetry.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,2EAA2E;AAC3E,2EAA2E;AAC3E,sEAAsE;AACtE,EAAE;AACF,wEAAwE;AACxE,0EAA0E;AAC1E,wEAAwE;AACxE,+BAA+B;AAE/B,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,4BAAqC,CAAC;AAEvE;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,SAAiB;IAC7D,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG;YACd,KAAK,EAAE,iBAAiB;YACxB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,KAAK;YACL,SAAS;SACT,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACR,2DAA2D;IAC5D,CAAC;AACF,CAAC","sourcesContent":["// @gsd-build/mcp-server + alias-telemetry — usage telemetry on the 11 alias\n// `gsd_*` tools. Step 1 of a two-step deprecation (#5031). Always-on so we\n// actually capture data during the window. Single JSON line per invocation\n// to stderr — negligible overhead vs. the MCP request handler itself.\n//\n// Capture pattern: `<mcp-server-launch> 2>> alias-usage.jsonl`. After a\n// long-enough window with zero entries, the alias tools can be removed in\n// a follow-up PR. Filter with `grep deprecation` — the `event` field is\n// namespaced for that purpose.\n\n/** JSONL `event` field. Namespaced for `grep deprecation`. */\nexport const ALIAS_USAGE_EVENT = \"deprecation.mcp_alias_used\" as const;\n\n/**\n * Emit a single-line JSONL record signaling that an alias tool was invoked.\n * Failures are swallowed — telemetry must never break MCP request handling.\n */\nexport function logAliasUsage(alias: string, canonical: string): void {\n\ttry {\n\t\tconst record = {\n\t\t\tevent: ALIAS_USAGE_EVENT,\n\t\t\tts: Date.now(),\n\t\t\talias,\n\t\t\tcanonical,\n\t\t};\n\t\tprocess.stderr.write(`${JSON.stringify(record)}\\n`);\n\t} catch {\n\t\t// swallow — telemetry must never break the request handler\n\t}\n}\n"]}

package/packages/mcp-server/dist/workflow-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-tools.d.ts","sourceRoot":"","sources":["../src/workflow-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgSH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CA+BnG;AAkID,4CAA4C;AAC5C,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBrE;AA6FD,UAAU,aAAa;IACrB,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAC3D,OAAO,CAAC;CACZ;AAED,eAAO,MAAM,mBAAmB,6tBAoCtB,CAAC;AA+nBX,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CA6kBjE"}
+{"version":3,"file":"workflow-tools.d.ts","sourceRoot":"","sources":["../src/workflow-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkSH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CA+BnG;AAkID,4CAA4C;AAC5C,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBrE;AA6FD,UAAU,aAAa;IACrB,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAC3D,OAAO,CAAC;CACZ;AAED,eAAO,MAAM,mBAAmB,6tBAoCtB,CAAC;AAysBX,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAoiBjE"}

package/packages/mcp-server/dist/workflow-tools.js

@@ -5,6 +5,7 @@ import { existsSync, realpathSync } from "node:fs";
 import { isAbsolute, join, relative, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { z } from "zod";
+import { logAliasUsage } from "./alias-telemetry.js";
 let workflowToolExecutorsPromise = null;
 let workflowExecutionQueue = Promise.resolve();
 let workflowWriteGatePromise = null;
@@ -482,6 +483,66 @@ async function ensureMilestoneDbRow(milestoneId) {
         // Ignore pre-existing rows or transient DB availability issues.
     }
 }
+async function findDatabaseMilestoneIds() {
+    try {
+        const { getAllMilestones } = await importLocalModule("../../../src/resources/extensions/gsd/gsd-db.js");
+        return (getAllMilestones?.() ?? [])
+            .map((milestone) => {
+            const id = milestone?.id;
+            return typeof id === "string" ? id : null;
+        })
+            .filter((id) => id !== null);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Fix #4996: Shared helper for both gsd_milestone_generate_id and
+ * gsd_generate_milestone_id. Reuses the lowest reusable ghost milestone ID
+ * (a disk-only stub with no DB row, no worktree, no content files) before
+ * falling back to max+1. Uses the stricter `isReusableGhostMilestone` —
+ * not `isGhostMilestone` — to avoid racing with in-flight queued DB rows
+ * from an earlier call to this same tool.
+ */
+async function generateOrReuseMilestoneId(projectDir) {
+    const { claimReservedId, findMilestoneIds, getReservedMilestoneIds, nextMilestoneId, milestoneIdSort, } = await importLocalModule("../../../src/resources/extensions/gsd/milestone-ids.js");
+    const reserved = claimReservedId();
+    if (reserved) {
+        await ensureMilestoneDbRow(reserved);
+        return reserved;
+    }
+    const allIds = [
+        ...new Set([
+            ...findMilestoneIds(projectDir),
+            ...getReservedMilestoneIds(),
+            ...(await findDatabaseMilestoneIds()),
+        ]),
+    ];
+    // Attempt ghost-ID reuse before falling back to max+1.
+    const { isReusableGhostMilestone } = await importLocalModule("../../../src/resources/extensions/gsd/state.js");
+    const sorted = [...allIds].sort(milestoneIdSort);
+    for (const candidate of sorted) {
+        if (isReusableGhostMilestone(projectDir, candidate)) {
+            await ensureMilestoneDbRow(candidate);
+            return candidate;
+        }
+    }
+    const prefsMod = await importLocalModule("../../../src/resources/extensions/gsd/preferences.js").catch(() => null);
+    // Graceful degradation: a corrupt preferences file should not crash
+    // milestone-id generation. Fall back to non-unique IDs if anything
+    // throws here — matches the pre-fix behavior for missing prefs.
+    let uniqueEnabled = false;
+    try {
+        uniqueEnabled = !!prefsMod?.loadEffectiveGSDPreferences?.(projectDir)?.preferences?.unique_milestone_ids;
+    }
+    catch {
+        uniqueEnabled = false;
+    }
+    const nextId = nextMilestoneId(allIds, uniqueEnabled);
+    await ensureMilestoneDbRow(nextId);
+    return nextId;
+}
 // projectDir is optional. When omitted, the server uses process.cwd(). This
 // prevents the agent from burning tokens reasoning about which absolute path
 // to pass (git root vs worktree vs symlink-resolved external state layout) —
@@ -859,6 +920,7 @@ export function registerWorkflowTools(server) {
         return { content: [{ type: "text", text: `Saved decision ${result.id}` }] };
     });
     server.tool("gsd_save_decision", "Alias for gsd_decision_save. Record a project decision to the GSD database and regenerate DECISIONS.md.", decisionSaveParams, async (args) => {
+        logAliasUsage("gsd_save_decision", "gsd_decision_save");
         const parsed = parseWorkflowArgs(decisionSaveSchema, args);
         const { projectDir, ...params } = parsed;
         await enforceWorkflowWriteGate("gsd_decision_save", projectDir);
@@ -879,6 +941,7 @@ export function registerWorkflowTools(server) {
         return { content: [{ type: "text", text: `Updated requirement ${id}` }] };
     });
     server.tool("gsd_update_requirement", "Alias for gsd_requirement_update. Update an existing requirement in the GSD database and regenerate REQUIREMENTS.md.", requirementUpdateParams, async (args) => {
+        logAliasUsage("gsd_update_requirement", "gsd_requirement_update");
         const parsed = parseWorkflowArgs(requirementUpdateSchema, args);
         const { projectDir, id, ...updates } = parsed;
         await enforceWorkflowWriteGate("gsd_requirement_update", projectDir);
@@ -899,6 +962,7 @@ export function registerWorkflowTools(server) {
         return { content: [{ type: "text", text: `Saved requirement ${result.id}` }] };
     });
     server.tool("gsd_save_requirement", "Alias for gsd_requirement_save. Record a new requirement to the GSD database and regenerate REQUIREMENTS.md.", requirementSaveParams, async (args) => {
+        logAliasUsage("gsd_save_requirement", "gsd_requirement_save");
         const parsed = parseWorkflowArgs(requirementSaveSchema, args);
         const { projectDir, ...params } = parsed;
         await enforceWorkflowWriteGate("gsd_requirement_save", projectDir);
@@ -911,57 +975,14 @@ export function registerWorkflowTools(server) {
     server.tool("gsd_milestone_generate_id", "Generate the next milestone ID for a new GSD milestone.", milestoneGenerateIdParams, async (args) => {
         const { projectDir } = parseWorkflowArgs(milestoneGenerateIdSchema, args);
         await enforceWorkflowWriteGate("gsd_milestone_generate_id", projectDir);
-        const id = await runSerializedWorkflowDbOperation(projectDir, async () => {
-            const { claimReservedId, findMilestoneIds, getReservedMilestoneIds, nextMilestoneId, } = await importLocalModule("../../../src/resources/extensions/gsd/milestone-ids.js");
-            const reserved = claimReservedId();
-            if (reserved) {
-                await ensureMilestoneDbRow(reserved);
-                return reserved;
-            }
-            const allIds = [...new Set([...findMilestoneIds(projectDir), ...getReservedMilestoneIds()])];
-            const prefsMod = await importLocalModule("../../../src/resources/extensions/gsd/preferences.js").catch(() => null);
-            // Graceful degradation: a corrupt preferences file should not crash
-            // milestone-id generation. Fall back to non-unique IDs if anything
-            // throws here — matches the pre-fix behavior for missing prefs.
-            let uniqueEnabled = false;
-            try {
-                uniqueEnabled = !!prefsMod?.loadEffectiveGSDPreferences?.()?.preferences?.unique_milestone_ids;
-            }
-            catch {
-                uniqueEnabled = false;
-            }
-            const nextId = nextMilestoneId(allIds, uniqueEnabled);
-            await ensureMilestoneDbRow(nextId);
-            return nextId;
-        });
+        const id = await runSerializedWorkflowDbOperation(projectDir, () => generateOrReuseMilestoneId(projectDir));
         return { content: [{ type: "text", text: id }] };
     });
     server.tool("gsd_generate_milestone_id", "Alias for gsd_milestone_generate_id. Generate the next milestone ID for a new GSD milestone.", milestoneGenerateIdParams, async (args) => {
+        logAliasUsage("gsd_generate_milestone_id", "gsd_milestone_generate_id");
         const { projectDir } = parseWorkflowArgs(milestoneGenerateIdSchema, args);
         await enforceWorkflowWriteGate("gsd_milestone_generate_id", projectDir);
-        const id = await runSerializedWorkflowDbOperation(projectDir, async () => {
-            const { claimReservedId, findMilestoneIds, getReservedMilestoneIds, nextMilestoneId, } = await importLocalModule("../../../src/resources/extensions/gsd/milestone-ids.js");
-            const reserved = claimReservedId();
-            if (reserved) {
-                await ensureMilestoneDbRow(reserved);
-                return reserved;
-            }
-            const allIds = [...new Set([...findMilestoneIds(projectDir), ...getReservedMilestoneIds()])];
-            const prefsMod = await importLocalModule("../../../src/resources/extensions/gsd/preferences.js").catch(() => null);
-            // Graceful degradation: a corrupt preferences file should not crash
-            // milestone-id generation. Fall back to non-unique IDs if anything
-            // throws here — matches the pre-fix behavior for missing prefs.
-            let uniqueEnabled = false;
-            try {
-                uniqueEnabled = !!prefsMod?.loadEffectiveGSDPreferences?.()?.preferences?.unique_milestone_ids;
-            }
-            catch {
-                uniqueEnabled = false;
-            }
-            const nextId = nextMilestoneId(allIds, uniqueEnabled);
-            await ensureMilestoneDbRow(nextId);
-            return nextId;
-        });
+        const id = await runSerializedWorkflowDbOperation(projectDir, () => generateOrReuseMilestoneId(projectDir));
         return { content: [{ type: "text", text: id }] };
     });
     server.tool("gsd_plan_milestone", "Write milestone planning state to the GSD database and render ROADMAP.md from DB.", planMilestoneParams, async (args) => {
@@ -994,6 +1015,7 @@ export function registerWorkflowTools(server) {
         };
     });
     server.tool("gsd_task_plan", "Alias for gsd_plan_task. Write task planning state to the GSD database and render tasks/T##-PLAN.md from DB.", planTaskParams, async (args) => {
+        logAliasUsage("gsd_task_plan", "gsd_plan_task");
         const parsed = parseWorkflowArgs(planTaskSchema, args);
         const { projectDir, ...params } = parsed;
         await enforceWorkflowWriteGate("gsd_plan_task", projectDir, params.milestoneId);
@@ -1013,6 +1035,7 @@ export function registerWorkflowTools(server) {
         return handleReplanSlice(parsed.projectDir, parsed);
     });
     server.tool("gsd_slice_replan", "Alias for gsd_replan_slice. Replan a slice after a blocker is discovered.", replanSliceParams, async (args) => {
+        logAliasUsage("gsd_slice_replan", "gsd_replan_slice");
         const parsed = parseWorkflowArgs(replanSliceSchema, args);
         return handleReplanSlice(parsed.projectDir, parsed);
     });
@@ -1021,6 +1044,7 @@ export function registerWorkflowTools(server) {
         return handleSliceComplete(parsed.projectDir, parsed);
     });
     server.tool("gsd_complete_slice", "Alias for gsd_slice_complete. Record a completed slice to the GSD database and render summary/UAT artifacts.", sliceCompleteParams, async (args) => {
+        logAliasUsage("gsd_complete_slice", "gsd_slice_complete");
         const parsed = parseWorkflowArgs(sliceCompleteSchema, args);
         return handleSliceComplete(parsed.projectDir, parsed);
     });
@@ -1053,6 +1077,7 @@ export function registerWorkflowTools(server) {
         return handleCompleteMilestone(parsed.projectDir, parsed);
     });
     server.tool("gsd_milestone_complete", "Alias for gsd_complete_milestone. Record a completed milestone to the GSD database and render its SUMMARY.md.", completeMilestoneParams, async (args) => {
+        logAliasUsage("gsd_milestone_complete", "gsd_complete_milestone");
         const parsed = parseWorkflowArgs(completeMilestoneSchema, args);
         return handleCompleteMilestone(parsed.projectDir, parsed);
     });
@@ -1061,6 +1086,7 @@ export function registerWorkflowTools(server) {
         return handleValidateMilestone(parsed.projectDir, parsed);
     });
     server.tool("gsd_milestone_validate", "Alias for gsd_validate_milestone. Validate a milestone and render VALIDATION.md.", validateMilestoneParams, async (args) => {
+        logAliasUsage("gsd_milestone_validate", "gsd_validate_milestone");
         const parsed = parseWorkflowArgs(validateMilestoneSchema, args);
         return handleValidateMilestone(parsed.projectDir, parsed);
     });
@@ -1069,6 +1095,7 @@ export function registerWorkflowTools(server) {
         return handleReassessRoadmap(parsed.projectDir, parsed);
     });
     server.tool("gsd_roadmap_reassess", "Alias for gsd_reassess_roadmap. Reassess a roadmap after slice completion.", reassessRoadmapParams, async (args) => {
+        logAliasUsage("gsd_roadmap_reassess", "gsd_reassess_roadmap");
         const parsed = parseWorkflowArgs(reassessRoadmapSchema, args);
         return handleReassessRoadmap(parsed.projectDir, parsed);
     });
@@ -1093,6 +1120,7 @@ export function registerWorkflowTools(server) {
         return handleTaskComplete(projectDir, taskArgs);
     });
     server.tool("gsd_complete_task", "Alias for gsd_task_complete. Record a completed task to the GSD database and render its SUMMARY.md.", taskCompleteParams, async (args) => {
+        logAliasUsage("gsd_complete_task", "gsd_task_complete");
         const parsed = parseWorkflowArgs(taskCompleteSchema, args);
         const { projectDir, ...taskArgs } = parsed;
         return handleTaskComplete(projectDir, taskArgs);