refactor: deepen GSDTools query execution seams (#3085)

* refactor: deepen gsdtools query execution seams

* docs: add changeset for query seam deepening

* docs: fix changeset summary text

* fix: address coderabbit query seam findings

* test: address remaining coderabbit findings and notes

* refactor: use internal gsdtools error type import

sdk/src/query-gsd-tools-path.ts

@@ -0,0 +1,24 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+
+const BUNDLED_GSD_TOOLS_PATH = fileURLToPath(
+  new URL('../../get-shit-done/bin/gsd-tools.cjs', import.meta.url),
+);
+
+/**
+ * Resolve gsd-tools.cjs path.
+ * Probe order: SDK-bundled repo copy → project/.claude/get-shit-done → ~/.claude/get-shit-done
+ */
+export function resolveGsdToolsPath(projectDir: string): string {
+  const candidates = [
+    BUNDLED_GSD_TOOLS_PATH,
+    join(projectDir, '.claude', 'get-shit-done', 'bin', 'gsd-tools.cjs'),
+    join(homedir(), '.claude', 'get-shit-done', 'bin', 'gsd-tools.cjs'),
+  ];
+
+  return candidates.find(candidate => existsSync(candidate)) ?? candidates[candidates.length - 1]!;
+}
+
+export { BUNDLED_GSD_TOOLS_PATH };