Why
The 3.1.0-beta.3 schema cache now contains 663 schema files. Several types in src/adcp/types/ were handrolled in the 3.0.x era because upstream didn't provide a schema — many of those gaps are now filled. Cleaning these up before #741 lands gives canonical-formats a clean type baseline to extend instead of one littered with FormatId = str-style stubs.
This is a baseline-hygiene PR. No semantic changes — just regenerate from current schemas, drop aliases whose target type is now generated upstream, and update CLAUDE.md to match the actual type-module layout (it still references a stable.py that no longer exists).
Scope
- Run
scripts/sync_schemas.py against 3.1.0-beta.3 and verify the cache is current
- Run
scripts/generate_types.py and inspect the diff in src/adcp/types/generated_poc/
- Audit
src/adcp/types/aliases.py and any _forward_compat.py / _ergonomic.py entries — delete aliases whose target type now has a real generated schema
- Update CLAUDE.md's "Import Architecture for Generated Types" section to match reality (stable.py reference is stale)
- Confirm
ruff check src/, mypy src/adcp/, pytest tests/ -v all pass
Out of scope
Acceptance
Refs
Why
The 3.1.0-beta.3 schema cache now contains 663 schema files. Several types in
src/adcp/types/were handrolled in the 3.0.x era because upstream didn't provide a schema — many of those gaps are now filled. Cleaning these up before #741 lands gives canonical-formats a clean type baseline to extend instead of one littered withFormatId = str-style stubs.This is a baseline-hygiene PR. No semantic changes — just regenerate from current schemas, drop aliases whose target type is now generated upstream, and update CLAUDE.md to match the actual type-module layout (it still references a
stable.pythat no longer exists).Scope
scripts/sync_schemas.pyagainst3.1.0-beta.3and verify the cache is currentscripts/generate_types.pyand inspect the diff insrc/adcp/types/generated_poc/src/adcp/types/aliases.pyand any_forward_compat.py/_ergonomic.pyentries — delete aliases whose target type now has a real generated schemaruff check src/,mypy src/adcp/,pytest tests/ -vall passOut of scope
Acceptance
3.1.0-beta.3generated_poc/either has no diff (already in sync) or the diff is purely additive / matches a documented upstream changeFormatId,PackageRequest, and any other stubs called out in CLAUDE.md are evaluated; aliases that now have schemas are removedRefs