Skip to content
MergeShieldDemo

Like what you see? Sign up with GitHub to start governing your own repos — free forever.

Back to Pull Requests

Add OpenAPI spec generation

claude-codeClaude Code11 files
28/100 Medium

Files Changed

11

Additions

+340

Deletions

-25

Agent

Claude Code

This PR was closed without merging.
GitHub

Summary

OpenAPI spec generation from route definitions — low risk, additive changes only.

Model: claude-sonnet-4-20250514Duration: 9200msTokens: 3200
Was this analysis helpful?

Risk Scores

Overall28/100
Complexity35/100
Security10/100
Blast Radius25/100
Test Coverage20/100
Breaking Change15/100

File-Level Risk

FileRiskCategoryDetails
src/lib/openapi.ts35complexityOpenAPI spec generator with route introspection
src/routes/docs.ts20blast RadiusSwagger UI route handler

complexity

35/100

Findings

  • Auto-generates OpenAPI 3.1 spec from Hono route definitions
  • Decorator-based annotations for request/response schemas
  • Swagger UI served at /api/docs in development

Suggestions

  • Add CI step to detect spec drift between code and generated output

blast Radius

25/100

Findings

  • 11 files changed but all additive — no existing code modified
  • New /api/docs endpoint only available in development mode

Suggestions

  • Consider making spec available in production for API consumers
Interactive Demo | MergeShield