[crisner1978]

Closes #14.

Summary

The generator pasted JSON-schema objects inside export interface; now it emits TypeScript. /build's 207 and missing[] are still absent from api.auto.dev/openapi, so they live by hand beside the generated file.

 scripts/
 ├── generate.ts            # loads a URL or local spec path, writes the file, prettiers it
+└── openapi-to-ts.ts       # pure OpenAPI → TS converter (tested)
 src/core/
 ├── types.generated.ts     # 4,702 → ~1,400 lines of real types
+└── types.build.ts         # BuildResponse.missing?, BuildPartialResponse (207), BuildCatalog*, isPartialBuild
 src/sdk/index.ts           # build(vin): Promise<AutoDevResponse<BuildResult>>
 src/core/endpoints.ts      # auto_build / CLI description names the 207

-export interface BuildResponse {
-  "additionalProperties": false,
-  "properties": { "build": { "$ref": "#/components/schemas/Build" } },
-  ...
+export interface BuildResponse {
+  build: Build
+}

Callers branch once:

const { data } = await auto.build(vin)
if (isPartialBuild(data)) data.catalog?.availableOptions   // 207: build is null
else data.build.options                                    // 200: data.missing? lists absent fields

Evidence

• Before: types.generated.ts line 687 was a schema blob; build() returned unknown; the MCP description said nothing about the 207.
  After: pnpm typecheck 0 errors; pnpm test 23 files / 154 tests pass, including new test/scripts/openapi-to-ts.test.ts (refs, arrays, maps, enum/const/anyOf, not, JSDoc, Params), a client test that a 207 body passes through as data, a type-level test on build(), and an MCP test that auto_build mentions the 207. Re-running pnpm generate against the live spec reproduces the committed file byte-for-byte.

Merge Danger

Door: two-way. Revert restores the old generator and file; nothing persisted.

Blast Radius: consumers

• build() narrows from AutoDevResponse<unknown> to AutoDevResponse<BuildResult>; code that cast unknown keeps compiling, code that passed it somewhere typed unknown is unaffected.
• The generated param types (ListingsFilters etc.) keep their names; one new OpenrecallsVinParams appears because the live spec now lists it.
• Not published: npm is at 0.1.24 (2026-08-18). Needs pnpm version patch && pnpm publish after merge to reach users.

🤖 Generated with Claude Code