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-tools-error-mapper.ts

@@ -0,0 +1,28 @@
+import { GSDError, exitCodeFor } from './errors.js';
+import { GSDToolsError } from './gsd-tools-error.js';
+
+/**
+ * Module owning projection of internal errors to GSDToolsError contract.
+ */
+export function toGSDToolsError(command: string, args: string[], err: unknown): GSDToolsError {
+  if (err instanceof GSDError) {
+    return new GSDToolsError(
+      err.message,
+      command,
+      args,
+      exitCodeFor(err.classification),
+      '',
+      { cause: err },
+    );
+  }
+
+  const msg = err instanceof Error ? err.message : String(err);
+  return new GSDToolsError(
+    msg,
+    command,
+    args,
+    1,
+    '',
+    err instanceof Error ? { cause: err } : undefined,
+  );
+}