[Chore-1055] Enforce OpenAPI mirror drift guard

Story 1055Epic None3 files · +53/−3

PR #248 · pramaan-io/pramaan-app · merged 2026-06-07

How it flows

sequenceDiagram
  autonumber
  participant src as pramaan-functions
  participant ci as CI runner
  participant mirror as app mirror
  src->>ci: checkout canonical spec
  ci->>ci: copy into openapi/app-api.json
  ci->>mirror: pnpm codegen → src/gen
  mirror-->>ci: git diff --check
  ci->>ci: pass / fail build

Failure cases jo ab impossible hain

openapi/app-api.json hand-edited
backend spec aur app mirror desync
stale src/gen client merge
silent contract drift in production

mirror synced before codegen

src/gen regenerated every PR

AGENTS.md warns: never hand-edit mirror

root AGENTS.md points to this guard

Files changed (3)

File	±
`.github/workflows/ci.yml` ★	+27 −3
`AGENTS.md` ★	+4
`openapi/AGENTS.md` ★	+22