chore(cli): migrate @fern-api/cli-v2 to use CliError

[FedeZara]

Description

Migrates @fern-api/cli-v2 (the next-generation CLI package) to use explicit CliError error codes on every failAndThrow / failWithoutThrowing call site.

This is one of the package migration PRs that follow the error classification system introduced in #14749.

Changes Made

Assigned typed error codes across 48+ call sites in packages/cli/cli-v2/src/, covering every command handler and shared utility. Also fixed test files to match the async createTestContext signature and the TaskAbortSignal throw type for validation errors.

Error codes used

Code	Usage
CONFIG_ERROR	Missing config, invalid flags, API not found, multiple APIs without selection
AUTH_ERROR	Authentication failures, keyring unavailability, login/logout/switch errors
NETWORK_ERROR	HTTP/API call failures, docs publishing errors
VALIDATION_ERROR	Schema validation failures, docs/SDK check violations
PARSE_ERROR	Malformed YAML/JSON, invalid workspace definitions
VERSION_ERROR	Generator version incompatibility
ENVIRONMENT_ERROR	Missing prerequisites, directory resolution failures
INTERNAL_ERROR	Unexpected states indicating bugs

Files touched (grouped by area)

• API commands: api/check/, api/compile/, api/merge/, api/split/, api/utils/loadSpec.ts
• Auth commands: auth/login/, auth/logout/, auth/switch/, auth/token/, auth/whoami/
• Docs commands: docs/check/, docs/dev/, docs/preview/, docs/preview/delete/, docs/publish/
• SDK commands: sdk/add/, sdk/check/, sdk/generate/, sdk/preview/, sdk/update/
• Other commands: check/, config/migrate/, init/, org/create/, org/list/
• Context & errors: Context.ts, withContext.ts, TaskContextAdapter.ts, FernYmlEditor.ts, DocsChecker.ts
• Telemetry: TelemetryClient.ts, LifecycleEvent.ts
• Error types: Deleted errors/CliError.ts (replaced by shared @fern-api/task-context CliError), updated ValidationError.ts, SourcedValidationError.ts, KeyringUnavailableError.ts
• Tests: GeneratorPipeline.test.ts, compile.test.ts, TelemetryClient.test.ts, and all test context utilities

Testing

• Existing tests pass (309/309 in cli-v2, excluding e2e)

[FedeZara]

• chore(cli): migrate @fern-api/cli-v2 to use CliError #14992 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[claude]

Claude Code Review

This repository is configured for manual code reviews. Comment @claude review to trigger a review and subscribe this PR to future pushes, or @claude review once for a one-time review.

_{Tip: disable this comment in your organization's Code Review settings.}

[graphite-app]

Error code should be ParseError or ConfigError, not InternalError. This error occurs when a user provides an invalid API spec file without the required top-level keys. Using InternalError suggests a bug in the CLI rather than a user configuration issue.

throw new CliError({
    message:
        `Could not determine API type for "${reference}". ` +
        `File must contain a top-level "openapi" or "asyncapi" key.`,
    code: CliError.Code.ParseError
});

Suggested change

	throw new CliError({
	message:
	`Could not determine API type for "${reference}". ` +
	`File must contain a top-level "openapi" or "asyncapi" key.`,
	code: CliError.Code.InternalError
	});
	throw new CliError({
	message:
	`Could not determine API type for "${reference}". ` +
	`File must contain a top-level "openapi" or "asyncapi" key.`,
	code: CliError.Code.ParseError
	});

Spotted by Graphite



Is this helpful? React 👍 or 👎 to let us know.