win-aip-contract-sync

WIN AIP Contract Sync

Use when

A WIN backend job endpoint or public DTO must be available in ../aipodcasting.
AIP frontend code needs generated job paths, job types, or DTO types from WIN.
Contract sync, generated AIP types, or lib/aip/contracts/** drift is involved.

win owns contract sources; aipodcasting/lib/aip/contracts/** is generated output.
Run local sync; do not wait for CI or cloud cross-repo sync.
Do not hand-edit generated files under aipodcasting/lib/aip/contracts/**.
Generated job endpoint IDs are path slugs: strip slashes and replace / and - with _. Example: /operations/episodes/retry-ingest becomes operations_episodes_retry_ingest. Verify the final key in aipodcasting/lib/aip/contracts/job-endpoints.ts.
Keep database models internal; expose public DTOs only.
Ask only when frontend fields or UX placement cannot be inferred safely.
Do not commit or push unless the user explicitly asks or repo-local automation handles it.

Inspect repo state:

git -C /Users/dobby/GitHub/win status -sb
git -C /Users/dobby/GitHub/aipodcasting status -sb

Work around unrelated local changes; do not revert them.

For backend changes in win:
- For job endpoints, keep @register_endpoint metadata and request/result schemas contractable.
- For synchronous UI data, define or update a public Pydantic response DTO and set response_model=....
- Add frontend-consumed DTOs to PUBLIC_DTOS in scripts/contracts/export_public_dto_contracts.py.
- Map DB/internal models to DTOs explicitly.
Run generated sync from win:
```
cd /Users/dobby/GitHub/win
scripts/local/sync_aip_contracts.sh
```
The wrapper exports job contracts, clears stale generated DTO output, writes current DTOs, and formats with AIP's Biome config.
If frontend work is needed in aipodcasting:
- Import generated types from lib/aip/contracts/**.
- Submit jobs through the generic AIP job proxy using generated endpoint IDs/paths.
- For synchronous reads or writes, add thin Next.js API proxies to WIN; do not add MongoDB access.
- Keep feature-local filters, form state, and UI-only types outside generated contracts.
Validate:
- Confirm expected generated files exist under ../aipodcasting/lib/aip/contracts/**.
- Run scripts/local/check_aip_contracts_drift.sh when you need a non-mutating stale-contract check.
- Run focused backend tests for changed WIN contract exporters or handlers.
- Run pnpm type-check in ../aipodcasting when frontend TypeScript or contract consumers changed.
- Report git status -sb for both repos.