Fix url --help to show <url> as argument, not [parse]

[jeremy]

Summary

• Remove [parse] from the url command's Use field so help reads url <url> instead of url [parse] <url>
• The parse subcommand now appears only in the COMMANDS section where it belongs
• Update unit test assertion and strengthen e2e test to assert <url> present and [parse] absent

Test plan

• go run ./cmd/basecamp url --help shows <url>, not [parse]; parse listed under COMMANDS
• go test ./internal/commands -run TestURLCmdCreation passes
• All unit tests pass
• All 290 e2e tests pass

---

Summary by cubic

Fixes the basecamp url help to show url <url> (not url [parse] <url>) and list parse only under COMMANDS. Drops [parse] from the command’s Use, updates e2e/url.bats and unit test assertions, and refreshes .surface-breaking to reflect url <url>.

^{Written for commit fd2d31b. Summary will update on new commits.}

[github-actions]

⚠️ Potential breaking changes detected:

• Removal of 'parse' from the CLI command 'url [parse] ' changes how the command is called. This impacts users and scripts that relied on 'url parse ' as a valid invocation.

Review carefully before merging. Consider a major version bump.

[Copilot]

Pull request overview

Updates the basecamp url command help output to present <url> as the required argument and avoid describing parse as an optional positional token, aligning help text with the intended subcommand structure.

Changes:

• Update url command Use string to url <url> so --help no longer shows [parse].
• Update unit test to assert the new Use value.
• Tighten e2e help assertions to require <url> and forbid [parse].

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
internal/commands/url.go	Adjusts Cobra command Use to remove [parse] from top-level url usage.
internal/commands/url_test.go	Updates unit test expectation for cmd.Use.
e2e/url.bats	Updates help-output assertions to enforce <url> presence and [parse] absence.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[cubic-dev-ai]

No issues found across 3 files

[Copilot]

Pull request overview

This PR updates the basecamp url command’s help/usage so it correctly documents the primary invocation as url <url> and keeps parse represented as a subcommand (rather than an “[parse]” positional placeholder), aligning the CLI help output with Cobra subcommand structure.

Changes:

• Update url command Use from url [parse] <url> to url <url>.
• Update unit test to match the new Use string.
• Strengthen the e2e help test to assert <url> is present and [parse] is absent; update .surface-breaking to acknowledge the surface removal of the old arg signature.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File	Description
internal/commands/url.go	Adjusts the url command usage string so help shows url <url> and no longer implies [parse] as a positional argument.
internal/commands/url_test.go	Updates the command creation test to assert the new Use value.
e2e/url.bats	Adds assertions ensuring url --help includes <url> and does not include [parse], while still verifying parse appears in help output.
.surface-breaking	Acknowledges the removal of the prior url arg surface entries (from --help --agent snapshots) caused by the usage change.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.