Skip to content

feat: add api catalog discovery with list, describe, and search subco…#9

Merged
wcole1-godaddy merged 5 commits intomainfrom
feat/api-catalog-discovery
Feb 26, 2026
Merged

feat: add api catalog discovery with list, describe, and search subco…#9
wcole1-godaddy merged 5 commits intomainfrom
feat/api-catalog-discovery

Conversation

@wcole1-godaddy
Copy link
Contributor

…mmands

Refactor 'godaddy api' from a single raw-request command into a parent command with discovery subcommands so agents can explore API endpoints before making requests.

New subcommands:

  • godaddy api list [--domain ] - browse API domains and endpoints
  • godaddy api describe - full schema detail
  • godaddy api search - keyword search across all endpoints
  • godaddy api call - the original raw request behavior

Build-time pipeline:

  • scripts/generate-api-catalog.ts reads OpenAPI specs from spec submodules (starting with location.addresses-specification), resolves all external $ref URLs recursively, and outputs self-contained JSON catalog files that esbuild inlines into the bundle.

The catalog loader (src/cli/schemas/api/index.ts) uses Effect throughout: Effect.succeed, Effect.sync, Effect.gen, and Option for all public APIs.

…mmands

Refactor 'godaddy api' from a single raw-request command into a parent
command with discovery subcommands so agents can explore API endpoints
before making requests.

New subcommands:
- godaddy api list [--domain <name>] - browse API domains and endpoints
- godaddy api describe <operationId-or-path> - full schema detail
- godaddy api search <query> - keyword search across all endpoints
- godaddy api call <endpoint> - the original raw request behavior

Build-time pipeline:
- scripts/generate-api-catalog.ts reads OpenAPI specs from spec
  submodules (starting with location.addresses-specification), resolves
  all external $ref URLs recursively, and outputs self-contained JSON
  catalog files that esbuild inlines into the bundle.

The catalog loader (src/cli/schemas/api/index.ts) uses Effect throughout:
Effect.succeed, Effect.sync, Effect.gen, and Option for all public APIs.
@wcole1-godaddy wcole1-godaddy force-pushed the feat/api-catalog-discovery branch from a128c2e to c897e01 Compare February 26, 2026 02:45
@wcole1-godaddy wcole1-godaddy merged commit f853a4f into main Feb 26, 2026
3 checks passed
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