Skip to content

[VPEX][9] Rename target flags to match spec (--cluster-id, --dry-run, …)#5960

Open
rugpanov wants to merge 1 commit into
dbconnect/09-rename-setup-localfrom
dbconnect/10-flag-renames
Open

[VPEX][9] Rename target flags to match spec (--cluster-id, --dry-run, …)#5960
rugpanov wants to merge 1 commit into
dbconnect/09-rename-setup-localfrom
dbconnect/10-flag-renames

Conversation

@rugpanov

Copy link
Copy Markdown
Contributor

Stacked on #5959 (the command rename).

What

Renames the environments setup-local flags to match the [P0] CLI Changes spec:

Old New
--cluster --cluster-id
--serverless --serverless-version
--job --job-id
--check --dry-run
--constraint-source --constraint-source-url (still hidden)

Changes

  • Flag definitions, GetString/GetBool reads, and the mutually-exclusive group in cmd/environments/sync.go.
  • User-facing flag names in ValidateTargetFlags, noTargetMessage, the E_ENV_UNSUPPORTED hint (constraints.go), and the job-ambiguity errors (compute.go).
  • Internal --check doc comments updated to --dry-run for accuracy.
  • Acceptance scripts + goldens regenerated.

No behavior change beyond the flag spellings; the command stays Hidden.

Testing

go build ./..., lint (0 issues), deadcode clean, libs/localenv + cmd/environments unit tests, acceptance/localenv + acceptance/help regenerated and green.

This pull request and its description were written by Isaac.

Per the [P0] CLI Changes spec, rename the setup-local flags:
- --cluster            → --cluster-id
- --serverless         → --serverless-version
- --job                → --job-id
- --check              → --dry-run
- --constraint-source  → --constraint-source-url (still hidden)

Updates the flag definitions, GetString/GetBool reads, the
mutually-exclusive group, and the user-facing flag names in
ValidateTargetFlags, noTargetMessage, the E_ENV_UNSUPPORTED hint, and the
job-ambiguity errors in compute.go. Internal --check doc comments are
updated to --dry-run for accuracy. Acceptance scripts and goldens
regenerated.

Co-authored-by: Isaac
@rugpanov rugpanov changed the title [VPEX] Rename target flags to match spec (--cluster-id, --dry-run, …) [VPEX][9] Rename target flags to match spec (--cluster-id, --dry-run, …) Jul 17, 2026
@eng-dev-ecosystem-bot

Copy link
Copy Markdown
Collaborator

Integration test report

Commit: 78f2249

Run: 29581143732

Env 💚​RECOVERED 🙈​SKIP ✅​pass 🙈​skip Time
💚​ aws linux 4 4 227 1120 4:52
💚​ aws windows 4 4 229 1118 9:16
💚​ aws-ucws linux 4 4 316 1036 5:45
💚​ aws-ucws windows 4 4 318 1034 9:45
💚​ azure linux 4 4 227 1119 4:53
💚​ azure windows 4 4 229 1117 6:54
💚​ azure-ucws linux 4 4 318 1033 7:14
💚​ azure-ucws windows 4 4 320 1031 10:00
💚​ gcp linux 4 4 226 1121 4:47
💚​ gcp windows 4 4 228 1119 6:47
8 interesting tests: 4 RECOVERED, 4 SKIP
Test Name aws linux aws windows aws-ucws linux aws-ucws windows azure linux azure windows azure-ucws linux azure-ucws windows gcp linux gcp windows
💚​ TestAccept 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R
🙈​ TestAccept/bundle/invariant/no_drift 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S
🙈​ TestAccept/bundle/resources/vector_search_endpoints/drift/recreated_same_name 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S
🙈​ TestAccept/bundle/resources/vector_search_indexes/recreate/embedding_dimension 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S
🙈​ TestAccept/ssh/connection 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S 🙈​S
💚​ TestFetchRepositoryInfoAPI_FromRepo 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R
💚​ TestFetchRepositoryInfoAPI_FromRepo/root 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R
💚​ TestFetchRepositoryInfoAPI_FromRepo/subdir 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R 💚​R
Top 10 slowest tests (at least 2 minutes):
duration env testname
8:49 aws windows TestAccept
8:39 azure-ucws windows TestAccept
8:31 aws-ucws windows TestAccept
6:29 azure windows TestAccept
6:22 gcp windows TestAccept
3:03 aws linux TestAccept
2:57 azure-ucws linux TestAccept
2:57 gcp linux TestAccept
2:56 azure linux TestAccept
2:50 aws-ucws linux TestAccept

@anton-107 anton-107 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed as part of the full stack (#5960#5965). Clean, mechanical rename with matching goldens — the flag definitions, GetString/GetBool reads, the mutually-exclusive group, and every user-facing message/hint move together, and the command stays Hidden. Approving.

One low/nit to fold in (here or in a follow-up):

  • [nit] Stale --check references in test files. This PR's description says the internal --check doc comments were updated to --dry-run, but the test files were never touched: libs/localenv/pipeline_test.go (lines 29, 35, 39, 43, 47, 51, 122, 130, 150, 154, 159, 186) and libs/localenv/constraints_test.go (128, 141) still say --check. Several are t.Error/assert-failure messages (e.g. pipeline_test.go:35 "EnsureAvailable must not be called under --check"), so on failure a developer sees a message referencing a flag that no longer exists.

Reviewed with AI assistance (build + unit tests + adversarial verification against the checked-out top of stack).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants