[ADR-0119] Pin the legacy provider authority inventory

[ohdearquant]

Summary

• check in a schema-versioned, machine-readable inventory of the legacy provider authority
• capture the exact 33-module bootstrap order, 36 endpoint rows (28 API / 8 agentic), 18 canonical providers, 13 aliases, 12 context-window sources, optional-dependency map, public compatibility surfaces, deletion ledger, and migration-document anchors
• add a read-only AST collector plus mutation tests that fail on bootstrap, alias, transport metadata, context order/value, plugin collision, deletion-ledger, and documentation drift
• pin fresh-process runtime behavior, including import/reload side effects, matching and fallback quirks, full endpoint metadata/type references, hash-seed order, and context-window precedence
• characterize the current plugin peer-collision rules: same-provider contributions coexist with first activation winning, while a later cross-provider alias collision is rejected fail-soft

Why

This is the characterization prerequisite for the endpoint-catalog migration tracked by #3336 and its follow-up #3337. The current authority is split across import-time decorators, a fixed bootstrap list, token-budget import probes, plugin activation side effects, compatibility facades, and documentation. Freezing that behavior independently prevents the immutable-catalog migration from silently changing order, aliases, fallback behavior, transport configuration, or plugin collision semantics.

This PR is tests-only and does not change runtime behavior.

Validation

• 51 focused inventory/runtime/plugin tests passed
• the broader provider/service suite passed with the unavailable jsonschema and ollama optional-dependency nodes excluded
• Ruff check and format check passed
• Pyright: 0 errors, 0 warnings on the new collector/contracts
• JSON validation and git diff --check passed
• pre-commit hooks passed during commit
• the original mutation and isolation gaps were falsified and closed

Stacking

This draft targets codex/adr0119-immutable-registry, the immutable Registry prerequisite branch. It should be rebased or retargeted to the default branch after that prerequisite merges.

Closes #3336

Refs-only: #3337

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
lion-studio	Ignored		Aug 17, 2026 10:32am