LTRAC-989: List custom domain statuses

[jorgemoya]

What/Why?

Refs LTRAC-989

Adds catalyst domains list on top of the shared domain command/API client from #3070. The command resolves existing CLI credentials/project config, supports optional --domain and --status filters, and renders color-coded domain statuses with an explicit empty state.

This PR is stacked after #3070 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 src/cli/lib/domains.ts tests/mocks/handlers.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.

[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

[changeset-bot]

⚠️ No Changeset found

Latest commit: 6e7b435

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

[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-988-cli-add-custom-domain-command [✘!?] took 3s
❯ node ../packages/catalyst/dist/cli.js domains list  --api-host api.staging.zone
◢ @bigcommerce/catalyst v1.0.0-alpha.6                                                                                                                   3:34:47 PM

◐ Fetching domains...                                                                                                                                    3:34:47 PM
✔ Domains fetched.                                                                                                                                      3:34:49 PM
jm-staging-test-v2.catalyst-sandbox-staging.store active                                                                                                 3:34:49 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	92	92	95

Category Scores

Category	Prod Desktop	Prod Mobile	Preview Desktop	Preview Mobile
Performance	72	80	77	79
Accessibility	95	98	95	92
Best Practices	100	100	100	100
SEO	88	88	100	100

Core Web Vitals

Metric	Prod Desktop	Prod Mobile	Preview Desktop	Preview Mobile
LCP	4.8 s	5.5 s	3.4 s	5.5 s
CLS	0.039	0	0.001	0
FCP	1.1 s	1.2 s	1.2 s	1.1 s
TBT	0 ms	0 ms	0 ms	0 ms
Max Potential FID	50 ms	40 ms	50 ms	50 ms
Time to Interactive	4.8 s	5.5 s	3.4 s	6.6 s

Full Unlighthouse report →