Add examples to api command and subcommands

[jeremy]

Summary

• Adds Example field to the api parent command and all four subcommands (get, post, put, delete)
• Examples surface in --help output and in missingArg/noChanges machine-mode error hints

Context

DHH feedback card 9660578055 — the api command was unclear without concrete examples showing what paths and payloads look like.

Test plan

• bin/ci passes
• basecamp api -h / basecamp api get -h show examples

---

Summary by cubic

Add concrete examples to the api command and its get, post, put, and delete subcommands. Examples now show common paths, absolute URLs, and -d payloads in --help and error hints to make raw API usage clearer.

• New Features
  • Added Example strings to the parent api command and all subcommands.
  • Examples appear in --help and in missingArg/noChanges machine-mode hints.

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

[cubic-dev-ai]

No issues found across 1 file

[Copilot]

Pull request overview

This PR improves the usability of the basecamp api CLI command by adding concrete, copy/paste-ready examples to the parent api command and each HTTP-verb subcommand, making the raw API interface easier to understand from --help and from machine-mode usage hints.

Changes:

• Add Example text for basecamp api (parent) to show common GET/POST usage.
• Add Example text for basecamp api get|post|put|delete to demonstrate paths, full URLs, and JSON payload usage.
• Ensure agent/machine-mode missingArg hints can include a meaningful first example line for post/put when --data is missing.

---

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