Skip to content

chore: add a petstore codegen spike as the witness for the codegen target surface (#64) - #65

Merged
Wahbeh-Mohammad merged 1 commit into
mvpfrom
64-establish-the-codegen-target-surface-with-a-petstore-example-as-its-witness
Sep 2, 2026
Merged

chore: add a petstore codegen spike as the witness for the codegen target surface (#64)#65
Wahbeh-Mohammad merged 1 commit into
mvpfrom
64-establish-the-codegen-target-surface-with-a-petstore-example-as-its-witness

Conversation

@Wahbeh-Mohammad

Copy link
Copy Markdown
Contributor

Closes #64.

examples/petstore/ is a throwaway spike, not a shipped example: a frozen OpenAPI document byte-identical to the Python witness's, a deterministic generator, a projection-only facade, a hand-written ServiceCore, a regen-diff guard, and a 15-case canary over an in-memory transport covering unary calls, cursor pagination, SSE with a [DONE] sentinel, a merge-patch body's three Tristate states, all three auth-tier outcomes, and both close semantics. The deliverable is examples/petstore/FINDINGS.md, which confirms all five hypothesised gaps — no executor tier, no StatusErrorMap, OperationDescriptor merging its static and per-call halves, the operation auth tier having no source, and FakeTransport being unreachable from the entry point — and records five more found while building, including that Schema<T> is decode-only and that Paginator has no status-mapping hook. It also corrects the plan's isolation claim: four gates ignore examples/, but gts lint . does not, which is why the example carries its own tsconfig.json for eslint's projectService and why the generator formats its output through the same gts/.prettierrc.json the lint rule uses. Nothing under packages/, tests/, scripts/, bunfig.toml, package.json or eslint.config.js is touched, no package depends on the tree, and bun run test collects 164 files before and after — so no changeset, since nothing consumer-facing changed.

Verified with run-ci.mjs --clean --node-floor (19/19 green, Bun pinned to 1.3.14, test:node also on Node 20.3.0), a clean housekeeping probe, and bun test ./examples/petstore at 15/15.

@Wahbeh-Mohammad Wahbeh-Mohammad self-assigned this Sep 2, 2026
@Wahbeh-Mohammad
Wahbeh-Mohammad merged commit 7b26c1c into mvp Sep 2, 2026
3 checks passed
@Wahbeh-Mohammad
Wahbeh-Mohammad deleted the 64-establish-the-codegen-target-surface-with-a-petstore-example-as-its-witness branch September 2, 2026 20:04
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