From 696b95a4971cb8abc9a8b6c8b34cbc2281362b91 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 20 May 2026 08:25:08 +0000 Subject: [PATCH 1/3] docs(branches): document main-branch password field omission in get command The main branch omits POSTGRES_URL and POSTGRES_URL_NON_POOLING because production database credentials are not retrievable via the Management API. Add a note to the Long description so the behavior is visible in both --help output and the auto-generated CLI reference docs. Fixes CLI-1450 --- apps/cli-go/cmd/branches.go | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/apps/cli-go/cmd/branches.go b/apps/cli-go/cmd/branches.go index fee85fccb7..665b60e303 100644 --- a/apps/cli-go/cmd/branches.go +++ b/apps/cli-go/cmd/branches.go @@ -78,7 +78,9 @@ var ( branchGetCmd = &cobra.Command{ Use: "get [name]", Short: "Retrieve details of a preview branch", - Long: "Retrieve details of the specified preview branch.", + Long: `Retrieve details of the specified preview branch. + +Note: For the main branch, password-dependent fields (POSTGRES_URL, POSTGRES_URL_NON_POOLING) are not populated because production database credentials are not retrievable via API.`, Args: cobra.MaximumNArgs(1), RunE: func(cmd *cobra.Command, args []string) error { ctx := cmd.Context() From 4f12a1a117f2b42b46a46883c9890fa93d67fb97 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 20 May 2026 08:28:19 +0000 Subject: [PATCH 2/3] docs(cli): mirror branches get note in legacy TS shell The legacy TypeScript shell is a 1:1 port of the Go CLI and must keep help text in sync. Match the new main-branch password-field note that was added to the Go cobra command. Fixes CLI-1450 --- apps/cli/src/legacy/commands/branches/get/get.command.ts | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/apps/cli/src/legacy/commands/branches/get/get.command.ts b/apps/cli/src/legacy/commands/branches/get/get.command.ts index 059f5ba66f..4d1fa12e30 100644 --- a/apps/cli/src/legacy/commands/branches/get/get.command.ts +++ b/apps/cli/src/legacy/commands/branches/get/get.command.ts @@ -16,7 +16,9 @@ const config = { export type LegacyBranchesGetFlags = CliCommand.Command.Config.Infer; export const legacyBranchesGetCommand = Command.make("get", config).pipe( - Command.withDescription("Retrieve details of the specified preview branch."), + Command.withDescription( + "Retrieve details of the specified preview branch.\n\nNote: For the main branch, password-dependent fields (POSTGRES_URL, POSTGRES_URL_NON_POOLING) are not populated because production database credentials are not retrievable via API.", + ), Command.withShortDescription("Retrieve details of a preview branch"), Command.withHandler((flags) => legacyBranchesGet(flags)), ); From 1e799350b63e4057d7bb0022650e7552daa2704b Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 20 May 2026 08:41:41 +0000 Subject: [PATCH 3/3] fix(cli-go): gofmt alignment after Long raw-string literal Switching Long from a quoted string to a backtick literal changes column alignment; gofmt wants Args: with one space instead of two. --- apps/cli-go/cmd/branches.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/apps/cli-go/cmd/branches.go b/apps/cli-go/cmd/branches.go index 665b60e303..3a77e899a5 100644 --- a/apps/cli-go/cmd/branches.go +++ b/apps/cli-go/cmd/branches.go @@ -81,7 +81,7 @@ var ( Long: `Retrieve details of the specified preview branch. Note: For the main branch, password-dependent fields (POSTGRES_URL, POSTGRES_URL_NON_POOLING) are not populated because production database credentials are not retrievable via API.`, - Args: cobra.MaximumNArgs(1), + Args: cobra.MaximumNArgs(1), RunE: func(cmd *cobra.Command, args []string) error { ctx := cmd.Context() fsys := afero.NewOsFs()