Skip to content

chore(types): schema sync against 3.1.0-beta.3 + drop obsolete handrolled aliases #807

@bokelley

Description

@bokelley

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

  1. Run scripts/sync_schemas.py against 3.1.0-beta.3 and verify the cache is current
  2. Run scripts/generate_types.py and inspect the diff in src/adcp/types/generated_poc/
  3. 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
  4. Update CLAUDE.md's "Import Architecture for Generated Types" section to match reality (stable.py reference is stale)
  5. Confirm ruff check src/, mypy src/adcp/, pytest tests/ -v all pass

Out of scope

Acceptance

  • Schema cache is current against 3.1.0-beta.3
  • Regenerated generated_poc/ either has no diff (already in sync) or the diff is purely additive / matches a documented upstream change
  • At least the FormatId, PackageRequest, and any other stubs called out in CLAUDE.md are evaluated; aliases that now have schemas are removed
  • CLAUDE.md type-architecture section matches the actual file layout
  • All three pre-commit checks pass

Refs

Metadata

Metadata

Assignees

No one assigned

    Labels

    claude-triagedno-triageSkip the Claude triage bot — human or designated agent will handle this issue

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions