[Spike-1054] Decide proxy-layer codegen approach

Story 1054Epic None1 files · +341/−0

PR #247 · pramaan-io/pramaan-app · merged 2026-06-06

How it flows

sequenceDiagram
  autonumber
  participant spike as Spike notes
  participant adr as ADR (pramaan-docs)
  participant rollout as Story-1049
  spike->>spike: A/B/C options compared
  spike->>spike: Option B recommended
  spike->>adr: ADR stub drafted
  adr->>rollout: Split ticket plan
  rollout->>rollout: Resource-by-resource rollout

proxy-layer-codegen-spike.md · +341 — new methods

Method	in → out	what it does
`seen`	`(class)`

What changed, file by file

docs/notes/proxy-layer-codegen-spike.md+341

Spike notes comparing three proxy codegen options and recommending Option B (OpenAPI generation with gateway assertContract), with a pramaan-docs ADR stub and Story-1049 rollout plan.

new class	signature
`seen`	`(class)`

New fields: Status : Proposed

Nothing in production moves

src/gen directory untouched
OpenAPI specs untouched
No route handler changes
HR-20 visual verification: N/A
No new generated code on merge

Zero production diff

No runtime risk

Walkthrough N/A — spike type

Decision locked in writing

Story-1049 will do the building

ADR stub awaits pramaan-docs

Files changed (1)

File	±
`docs/notes/proxy-layer-codegen-spike.md` ★	+341