refactor(init): route wizard errors through framework error pipeline

Replace direct `process.exitCode = 1` in wizard-runner.ts with thrown
WizardError instances so errors flow through Stricli's error handler,
gaining Sentry telemetry capture and consistent formatting. WizardError
carries a `rendered` flag so clack-displayed errors are not duplicated.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: betegon

src/app.ts

@@ -51,6 +51,7 @@ import {
   getExitCode,
   OutputError,
   stringifyUnknown,
+  WizardError,
 } from "./lib/errors.js";
 import { error as errorColor, warning } from "./lib/formatters/colors.js";
 import { isRouteMap, type RouteMap } from "./lib/introspect.js";
@@ -324,6 +325,11 @@ const customText: ApplicationText = {
     Sentry.captureException(exc);
 
     if (exc instanceof CliError) {
+      // WizardError with rendered=true: clack already displayed the error.
+      // Return empty string to avoid double output, exit code flows through.
+      if (exc instanceof WizardError && exc.rendered) {
+        return "";
+      }
       const prefix = ansiColor ? errorColor("Error:") : "Error:";
       return `${prefix} ${exc.format()}`;
     }

src/lib/errors.ts

@@ -476,6 +476,21 @@ export class TimeoutError extends CliError {
   }
 }
 
+/**
+ * Error thrown by the init wizard when it has already displayed
+ * the error via clack UI. The `rendered` flag tells the framework
+ * error handler to skip its own formatting.
+ */
+export class WizardError extends CliError {
+  readonly rendered: boolean;
+
+  constructor(message: string, options?: { rendered?: boolean }) {
+    super(message);
+    this.name = "WizardError";
+    this.rendered = options?.rendered ?? true;
+  }
+}
+
 // Error Utilities
 
 /**

src/lib/init/wizard-runner.ts

@@ -23,6 +23,7 @@ import type { SentryTeam } from "../../types/index.js";
 import { createTeam, listTeams } from "../api-client.js";
 import { formatBanner } from "../banner.js";
 import { CLI_VERSION } from "../constants.js";
+import { WizardError } from "../errors.js";
 import { getAuthToken } from "../db/auth.js";
 import { terminalLink } from "../formatters/colors.js";
 import { getSentryBaseUrl } from "../sentry-urls.js";
@@ -326,11 +327,10 @@ async function preamble(
   dryRun: boolean
 ): Promise<boolean> {
   if (!(yes || process.stdin.isTTY)) {
-    process.stderr.write(
-      "Error: Interactive mode requires a terminal. Use --yes for non-interactive mode.\n"
+    throw new WizardError(
+      "Interactive mode requires a terminal. Use --yes for non-interactive mode.",
+      { rendered: false }
     );
-    process.exitCode = 1;
-    return false;
   }
 
   process.stderr.write(`\n${formatBanner()}\n\n`);
@@ -450,14 +450,12 @@ async function resolvePreSpinnerOptions(
       }
       log.error(errorMessage(err));
       cancel("Setup failed.");
-      process.exitCode = 1;
-      return null;
+      throw new WizardError(errorMessage(err));
     }
     if (typeof orgResult !== "string") {
       log.error(orgResult.error ?? "Failed to resolve organization.");
       cancel("Setup failed.");
-      process.exitCode = 1;
-      return null;
+      throw new WizardError(orgResult.error ?? "Failed to resolve organization.");
     }
     opts = { ...opts, org: orgResult };
   }
@@ -524,8 +522,7 @@ async function resolvePreSpinnerOptions(
               `Create one at ${terminalLink(teamsUrl)} and run sentry init again.`
           );
           cancel("Setup failed.");
-          process.exitCode = 1;
-          return null;
+          throw new WizardError("No teams in your organization.");
         }
       } else if (teams.length === 1) {
         opts = { ...opts, team: (teams[0] as SentryTeam).slug };
@@ -641,8 +638,7 @@ export async function runWizard(initialOptions: WizardOptions): Promise<void> {
     spinState.running = false;
     log.error(errorMessage(err));
     cancel("Setup failed");
-    process.exitCode = 1;
-    return;
+    throw new WizardError(errorMessage(err));
   }
 
   const stepPhases = new Map<string, number>();
@@ -659,8 +655,7 @@ export async function runWizard(initialOptions: WizardOptions): Promise<void> {
         spinState.running = false;
         log.error(`No suspend payload found for step "${stepId}"`);
         cancel("Setup failed");
-        process.exitCode = 1;
-        return;
+        throw new WizardError(`No suspend payload found for step "${stepId}"`);
       }
 
       const resumeData = await handleSuspendedStep(
@@ -701,8 +696,7 @@ export async function runWizard(initialOptions: WizardOptions): Promise<void> {
     }
     log.error(errorMessage(err));
     cancel("Setup failed");
-    process.exitCode = 1;
-    return;
+    throw new WizardError(errorMessage(err));
   }
 
   handleFinalResult(result, spin, spinState);
@@ -721,7 +715,7 @@ function handleFinalResult(
       spinState.running = false;
     }
     formatError(result);
-    process.exitCode = 1;
+    throw new WizardError("Workflow returned an error");
   } else {
     if (spinState.running) {
       spin.stop("Done");