genopenapispecs

Overview ¶

genopenapispecs is a filter: it reads an OpenAPI document (JSON or YAML) on stdin and writes the normalized specs JSON on stdout. The specs file is the intermediate representation; this tool owns parsing the OpenAPI document deterministically, while the feature-scaffolding skills own the shape of the generated code. It captures only what those skills need - functions, webs, type definitions, the remote API base URL, and the authentication scheme. The microservice's hostname is decided when it is scaffolded, not here.

The tool never accesses the network. Fetching a document from a URL is the caller's responsibility (the importer skill has the agent do it); the tool only transforms what arrives on stdin.

Usage:

genopenapispecs [-base-url URL] < openapi.json > openapispecs.json