Treat runtime validators, not TypeScript annotations, as the source of truth…

Treat runtime validators, not TypeScript annotations, as the source of truth: expect drift between runtime validators (type guards) and inferred TypeScript types. Generate JSON Schema and TypeScript types from the validator, and add CI checks that prove the validator and generated types still agree. Make CI fail the build on any divergence so you stop shipping type promises that break at runtime.