fix(errors): use ResolutionError for org-not-found in buildOrgFailureError

ContextError means the user omitted a required value ("Organization is
required."), but buildOrgFailureError is reached when the org slug was
provided and returned a 404. Switch to ResolutionError so the message
reads "Organization 'my-org' not found." which matches the actual
scenario. Also drops the leaked internal detail about listTeams status.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: betegon

src/lib/resolve-team.ts

@@ -7,7 +7,7 @@
 
 import type { SentryTeam } from "../types/index.js";
 import { listOrganizations, listTeams } from "./api-client.js";
-import { ApiError, CliError, ContextError } from "./errors.js";
+import { ApiError, CliError, ContextError, ResolutionError } from "./errors.js";
 import { getSentryBaseUrl } from "./sentry-urls.js";
 
 /**
@@ -55,6 +55,7 @@ export type ResolveTeamOptions = {
  * @param options - Resolution options (team flag, usage hint, detection source)
  * @returns Team slug to use
  * @throws {ContextError} When team cannot be resolved
+ * @throws {ResolutionError} When org slug returns 404
  */
 export async function resolveTeam(
   orgSlug: string,
@@ -117,26 +118,25 @@ export async function resolveTeam(
  */
 async function buildOrgFailureError(
   orgSlug: string,
-  error: ApiError,
+  _error: ApiError,
   options: ResolveTeamOptions
 ): Promise<never> {
   const orgHint = await fetchOrgListHint(
     `Specify org explicitly: ${options.usageHint}`
   );
 
-  const alternatives = [
-    `Could not list teams for org '${orgSlug}' (${error.status})`,
-  ];
+  const suggestions: string[] = [];
   if (options.detectedFrom) {
-    alternatives.push(
+    suggestions.push(
       `Org '${orgSlug}' was auto-detected from ${options.detectedFrom}`
     );
   }
-  alternatives.push(orgHint);
+  suggestions.push(orgHint);
 
-  throw new ContextError(
-    "Organization",
+  throw new ResolutionError(
+    `Organization '${orgSlug}'`,
+    "not found",
     `${options.usageHint} --team <team-slug>`,
-    alternatives
+    suggestions
   );
 }

test/commands/project/create.test.ts

@@ -18,7 +18,7 @@ import {
 import { createCommand } from "../../../src/commands/project/create.js";
 // biome-ignore lint/performance/noNamespaceImport: needed for spyOn mocking
 import * as apiClient from "../../../src/lib/api-client.js";
-import { ApiError, CliError, ContextError } from "../../../src/lib/errors.js";
+import { ApiError, CliError, ContextError, ResolutionError } from "../../../src/lib/errors.js";
 // biome-ignore lint/performance/noNamespaceImport: needed for spyOn mocking
 import * as resolveTarget from "../../../src/lib/resolve-target.js";
 import type { SentryProject, SentryTeam } from "../../../src/types/index.js";
@@ -505,9 +505,9 @@ describe("project create", () => {
     const err = await func
       .call(context, { json: false }, "my-app", "node")
       .catch((e: Error) => e);
-    expect(err).toBeInstanceOf(ContextError);
+    expect(err).toBeInstanceOf(ResolutionError);
     expect(err.message).toContain("acme-corp");
-    expect(err.message).toContain("404");
+    expect(err.message).toContain("not found");
     // Should show the user's actual orgs to help them pick the right one
     expect(err.message).toContain("Your organizations");
     expect(err.message).toContain("other-org");
@@ -528,7 +528,7 @@ describe("project create", () => {
     const err = await func
       .call(context, { json: false }, "my-app", "node")
       .catch((e: Error) => e);
-    expect(err).toBeInstanceOf(ContextError);
+    expect(err).toBeInstanceOf(ResolutionError);
     expect(err.message).toContain("auto-detected from test/mocks/routes.ts");
     expect(err.message).toContain("123");
     expect(err.message).toContain("Your organizations");