[somanshreddy]

Description

Runs make generate against the real HeyGen OpenAPI spec to produce command specs for all CLI-visible v3 endpoints.

What gets generated: One Go file per group in gen/, each containing command.Spec struct literals. Plus gen/registry.go with the Groups map. These are the data definitions — zero logic. The builder (PR #18) and runtime (PR #20) handle execution.

Groups generated (10):

• video (4 commands), avatar (6), voice (2), video-agent (7)
• video-translate (12), webhook (7), asset (1), user (1), overdub (5)

Also in this PR:

• codegen/examples/overdub.yaml — examples for the new overdub endpoints
• Grouper tweak: singleton GET endpoints (like GET /v3/user/me) use get verb instead of list, detected from the operation summary. This is the one heuristic in the naming algorithm — documented with an inline comment.
• Test spec and examples updated for the user me get pattern

Reviewer note: ~1800 lines but ~1700 are generated boilerplate in gen/. Review the template output by spot-checking 2-3 files, not line-by-line.

Testing

All codegen golden tests pass. Generated code compiles.

Files

• gen/*.go — generated command specs (10 files + registry)
• codegen/examples/overdub.yaml — examples for overdub endpoints
• codegen/grouper.go — singleton GET heuristic
• codegen/grouper_test.go — test for user me get
• codegen/testdata/test_spec.yaml — user endpoint added
• codegen/testdata/test_examples.yaml — user example added

[somanshreddy]

• chore(cmd): remove hand-written video commands (PRINFRA-121) #21
• feat(cmd): cut over root to generated commands (PRINFRA-121) #20
• feat(codegen): generate initial command specs from OpenAPI (PRINFRA-121) #19 👈 (View in Graphite)
• fix(cmd): register generated commands as nested Cobra paths (PRINFRA-121) #18
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[linear]

PRINFRA-121 CLI M1: OpenAPI codegen pipeline

Build the code generation pipeline that reads openapi/external-api.json and produces CommandSpec structs.

Scope

• Go program in codegen/ using text/template
• Parse OpenAPI spec, filter to v3 endpoints only
• Generate CommandSpec data structs in gen/ (zero logic)
• overrides.yaml for:
  • Positional arg promotion (prompt, text, file)
  • Command group naming (video-translations → translate, webhooks/endpoints → webhook)
  • Help examples per command
• make generate SPEC=... target
• Nested path collapsing (e.g., /webhooks/endpoints/{id}/rotate-secret → webhook rotate-secret)
• Golden file tests for codegen output stability
• Generate all ~30 commands, wire into Cobra at startup

Mapping Rules

• OpenAPI tag → command group
• POST → create, GET (list) → list, GET (by id) → get, DELETE → delete, PATCH → update
• Path params → positional args, query params → flags, body fields → flags
• overrides.yaml exceptions for positional promotion and group naming

Acceptance Criteria

• make generate produces compilable CommandSpec files for all v3 endpoints
• Adding a new endpoint to spec + re-running codegen produces new command
• Generated help text includes descriptions and examples
• Golden file tests pass
• Override validation: make generate fails if overrides reference non-existent endpoints

[somanshreddy]

Merge activity

• Apr 2, 12:01 AM UTC: A user started a stack merge that includes this pull request via Graphite.
• Apr 2, 12:02 AM UTC: Graphite rebased this pull request as part of a merge.
• Apr 2, 12:04 AM UTC: @somanshreddy merged this pull request with Graphite.