fix(cli): distinguish local vs. remote connection-refused hints (CLI-1995)

[annabkr]

Summary

The Go implementation's SetConnectSuggestion has no local vs. remote distinction, so a refused --local connection (Postgres/Docker not running) inherited the same hint as an actual network-restricted remote connection, directing the user to their project's settings dashboard.

This is a dead end for a local user, since there's nothing to fix on the dashboard.

Changes

• Add LEGACY_SUGGEST_LOCAL_STACK message and thread an isLocal flag through legacyConnectSuggestion so a refused local connection now suggests starting Docker (supabase start) instead.
• Split the single "connection refused" branch:
  • ECONNREFUSED/"connection refused" now branches on ctx.isLocal
  • "Address not in tenant allow_list" is only ever from the remote pooler so the previous message stays unconditionally.
• Ensure unit and integration test coverage

Before (running with --local)

Connecting to local database...
failed to connect to postgres: failed to connect to `host=127.0.0.1 user=x database=y`: dial error (connect ECONNREFUSED 127.0.0.1:54322)
Make sure your local IP is allowed in Network Restrictions and Network Bans. $remoteProjectSettingsUrl

After (running with --local)

Connecting to local database...
failed to connect to postgres: failed to connect to `host=127.0.0.1 user=x database=y`: dial error (connect ECONNREFUSED 127.0.0.1:54322)
Make sure Docker is running, then run: supabase start

Linked issue

Closes CLI-1995

• I'm a Supabase maintainer

Checklist

• The PR title follows Conventional Commits (e.g. fix(cli): …).
• Tests added or updated for the change.
• pnpm check:all and pnpm test pass for the workspace(s) I touched.

I also ran the compiled legacy binary and validated the --linked and --local paths.

[annabkr]

@codex review

[chatgpt-codex-connector]

Codex Review: Didn't find any major issues. Hooray!

Reviewed commit: 9039d2e099

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[kanadgupta]

Small nit below otherwise looks good to me! Will defer to @Coly010 for final merge

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9039d2e099

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[github-actions]

Supabase CLI preview

npx --yes https://pkg.pr.new/supabase/cli/supabase@195a7f91a00fa6728439cc09bb6ff08adcc2b711

Preview package for commit 195a7f9.

[Coly010]

Looks great! Thank you :)