Skip to content

feat(generator): build full SDK generation foundation - #7

Draft
nmorgan-cb wants to merge 5 commits into
mainfrom
toshi/plan-service-generator-upgrade
Draft

feat(generator): build full SDK generation foundation#7
nmorgan-cb wants to merge 5 commits into
mainfrom
toshi/plan-service-generator-upgrade

Conversation

@nmorgan-cb

@nmorgan-cb nmorgan-cb commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Description

Builds the foundation for deterministic, full Prime Java SDK generation from the committed OpenAPI specification.

  • Adds SpecParser, which captures operation IDs, HTTP methods, paths, tags, merged parameters, request/response schemas, numeric 2xx statuses, summaries, and optional SDK naming extensions from apiSpec/prime-public-spec.yaml.
  • Adds immutable SpecModels and OperationBinding metadata for subsequent request, response, service, and factory generation phases.
  • Adds deterministic operation binding derivation, including tag-based service ownership, request omission, pagination, existing Java naming compatibility, and Travel Rule → Transactions routing.
  • Adds validation for exact operation coverage, stable binding order, duplicate Java service methods, and undeclared path parameters.
  • Adds checked-in generator configuration and sparse operation-override boundary.
  • Ignores local docs/ agent-planning artifacts so they do not enter the public repository.

This consolidated PR supersedes the former stacked PRs #8 and #9. It intentionally does not yet replace the existing handwritten DTO/service sources; the parser and binding contract must be accepted before enabling client-surface source replacement.

Generated with Toshi

Type of Change

  • Bug fix
  • New feature
  • Breaking change
  • Dependency update
  • Refactor / cleanup
  • Other (describe below)

Checklist

  • Tests included / updated
  • Changelog updated
  • Version bump if needed

@cb-heimdall

Copy link
Copy Markdown

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@nmorgan-cb
nmorgan-cb force-pushed the toshi/plan-service-generator-upgrade branch from d0671ee to 5e2693d Compare September 2, 2026 17:43
@nmorgan-cb nmorgan-cb changed the title feat(generator): add OpenAPI operation inventory feat(generator): build full SDK generation foundation Sep 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants