feat(budgets): add budgets and budget-categories commands

[dgilperez]

Part of #11 (P1).

Adds CLI coverage for /api/v1/budgets and /api/v1/budget_categories, both of which Sure exposes as read-only resources.

Commands

• budgets list [--start-date Y-M-D] [--end-date Y-M-D] — mirrors the upstream apply_filters (start_date >=, end_date <=).
• budgets show <id>
• budget-categories list [--budget-id UUID] [--category-id UUID] [--start-date Y-M-D] [--end-date Y-M-D] — full upstream filter set.
• budget-categories show <id>

Path escaping on the show routes. Args: cobra.NoArgs on the list subcommands.

Verification

• Endpoints confirmed in we-promise/sure config/routes.rb api/v1 namespace.
• Filter list matches the controllers' apply_filters (budgets_controller.rb, budget_categories_controller.rb).
• go build ./... + go test ./cmd/sure-cli/root/... green.

Summary by CodeRabbit

Release Notes

• New Features
  • Added budgets command with list and show subcommands for viewing budget information
  • Added budget-categories command with list and show subcommands for managing budget categories
  • Both commands support date range filtering, pagination, and ID-based filtering
  • Updated documentation with budget management usage examples

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

This PR adds two new CLI command groups—budgets and budget-categories—to the sure-cli tool. Each command supports list and show operations with pagination, optional date filtering, and resource ID lookups, fully wired into the root command, tested, and documented.

Changes

Budgets CLI Commands

Layer / File(s)	Summary
Budget command implementations cmd/sure-cli/root/budgets_cmds.go	newBudgetsCmd() and newBudgetCategoriesCmd() define Cobra command trees. Both include list (with pagination, optional start/end-date, and budget/category ID filters) and show <id> subcommands that construct query URLs and issue GET requests to the REST API.
Command registration and tests cmd/sure-cli/root/root.go, cmd/sure-cli/root/budgets_cmds_test.go	Root command registers both new command builders. Three tests validate command structure (subcommand resolution, Args validators), flag definitions (pagination, dates, IDs), and command path resolution from root to leaf.
Usage documentation README.md	Usage section adds examples for budgets list/show and budget-categories list/show commands.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 A budgets command hops into view,
With list and show, both shiny and new,
Dates and filters in tow,
Tests passing—here we go!
Documentation complete, the feature is true. 🎉

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and accurately summarizes the main change: adding two new CLI commands (budgets and budget-categories) with their subcommands for read-only API endpoint coverage.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/cli-budgets-cmds

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}