LTRAC-990: Show custom domain status

[jorgemoya]

What/Why?

Refs LTRAC-990

Adds catalyst domains status <domain> on top of the domain command work from #3070 and #3071. The command fetches one domain, renders the color-coded status, and supports --wait for pending verification.

This PR is stacked after #3071 and should be reviewed/merged after that PR.

Testing

• node_modules/.bin/vitest run src/cli/commands/domains.spec.ts
• node_modules/.bin/tsc --noEmit
• node_modules/.bin/eslint src/cli/commands/domains.ts src/cli/commands/domains.spec.ts --max-warnings 0

Full node_modules/.bin/vitest run --coverage was attempted on #3070, but this local environment fails unrelated existing tests that require api.github.com network access and npm package env vars.

Migration

None.

[changeset-bot]

⚠️ No Changeset found

Latest commit: e28db70

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
catalyst	Ready	Preview, Comment	Jun 29, 2026 8:03pm

[github-actions]

Bundle Size Report

Comparing against baseline from 81b88df (2026-06-29).

No bundle size changes detected.

[jorgemoya]

Tested locally:

~/dev/catalyst/core on  jorgemoya/ltrac-990-cli-show-custom-domain-status [✘!?]
❯ node ../packages/catalyst/dist/cli.js domains status jm-staging-test-v2.catalyst-sandbox-staging.store --api-host api.staging.zone
◢ @bigcommerce/catalyst v1.0.0-alpha.6                                                                                                                   3:36:42 PM

◐ Fetching status for jm-staging-test-v2.catalyst-sandbox-staging.store...                                                                               3:36:42 PM
✔ Domain status fetched.                                                                                                                                3:36:42 PM
jm-staging-test-v2.catalyst-sandbox-staging.store active                                                                                                 3:36:42 PM

~/dev/catalyst/core on  jorgemoya/ltrac-990-cli-show-custom-domain-status [✘!?]
❯ node ../packages/catalyst/dist/cli.js domains status www.example-bc-jm-staging.com --api-host api.staging.zone
◢ @bigcommerce/catalyst v1.0.0-alpha.6                                                                                                                   3:36:58 PM

◐ Fetching status for www.example-bc-jm-staging.com...                                                                                                   3:36:58 PM
✔ Domain status fetched.                                                                                                                                3:36:59 PM
www.example-bc-jm-staging.com unknown           

[github-actions]

Unlighthouse Performance Comparison — Vercel

Comparing PR preview deployment Unlighthouse scores vs production Unlighthouse scores.

Summary Score

Aggregate score across all categories as reported by Unlighthouse.

	Prod Desktop	Prod Mobile	Preview Desktop	Preview Mobile
Score	90	93	92	95

Category Scores

Category	Prod Desktop	Prod Mobile	Preview Desktop	Preview Mobile
Performance	75	86	71	83
Accessibility	95	98	95	91
Best Practices	100	100	100	85
SEO	88	88	88	100

Core Web Vitals

Metric	Prod Desktop	Prod Mobile	Preview Desktop	Preview Mobile
LCP	3.7 s	4.1 s	5.7 s	0.9 s
CLS	0.001	0.001	0.037	0.344
FCP	1.1 s	1.2 s	1.2 s	0.9 s
TBT	20 ms	0 ms	0 ms	0 ms
Max Potential FID	60 ms	40 ms	50 ms	20 ms
Time to Interactive	3.7 s	4.1 s	5.7 s	0.9 s

Full Unlighthouse report →