Skip to content

chore(claude): add slash commands for OAS sync and SDK additions#76

Open
Gabrielpanga wants to merge 1 commit into
masterfrom
chore/claude-oas-sync-commands
Open

chore(claude): add slash commands for OAS sync and SDK additions#76
Gabrielpanga wants to merge 1 commit into
masterfrom
chore/claude-oas-sync-commands

Conversation

@Gabrielpanga
Copy link
Copy Markdown
Member

Summary

Ports the .claude/commands/ pattern already in use on pluggy-node, adapted to this SDK's Java/Maven/Retrofit/Lombok stack. Three commands:

  • sync-api — fetches api.pluggy.ai/oas3.json, diffs it against PluggyApiService and the DTOs under client/request/ + client/response/, and produces a gap report grouped by missing endpoints, missing fields, casing mismatches, and type mismatches.
  • add-model-fields — Java/Lombok templates for adding fields to existing DTOs (@Data @Builder for response, @Value @AllArgsConstructor @Builder for request), with the Gson IDENTITY casing gotcha called out as the highest-impact gap class.
  • add-endpoint — Retrofit endpoint templates (@GET/@POST/@PATCH/@DELETE, @Path/@Query/@QueryMap/@Body) with DTO naming conventions and integration test scaffold.

Catches the same class of gap that PR #71 (missing investment fields) and commit d1befb0 (payeeMCC casing) both surface as bug-driven PRs.

Other changes

  • .gitignore — ignore .claude/settings.local.json (local-only Claude Code config; mirrors pluggy-node)
  • CLAUDE.md — adds a "Claude commands" section pointing to the three commands

Test plan

This PR is documentation/tooling only — no code or build changes. To validate the workflow end-to-end after merge:

  • Open Claude Code in the repo and run /sync-api
  • Verify the OAS fetch succeeds (requires Doppler / Pluggy creds)
  • Verify the gap report is structured and actionable
  • Use /add-model-fields and /add-endpoint on a real gap in a follow-up PR

Follow-up

A separate PR will run /sync-api and propose fixes for the gaps it finds.

Ports the pattern already established in pluggy-node (.claude/commands/)
adapted to this SDK's Java/Maven/Retrofit/Lombok stack:

- sync-api: fetch api.pluggy.ai/oas3.json, diff against PluggyApiService
  + DTOs, produce gap report. Run periodically to catch missing fields
  and casing mismatches before users do.
- add-model-fields: Java/Lombok templates for adding fields, with the
  Gson IDENTITY casing gotcha called out as the highest-impact gap.
- add-endpoint: Retrofit endpoint templates with DTO naming conventions.

Also adds .claude/settings.local.json to .gitignore (local-only file,
mirrors pluggy-node's convention) and points to the new commands from
CLAUDE.md.
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.

1 participant