Skip to content

docs(claude): update Seam B summary for 0.9.0 multi-decoder routing#46

Merged
lesnik512 merged 1 commit into
mainfrom
docs/seam-b-multi-decoder-claudemd
Jun 13, 2026
Merged

docs(claude): update Seam B summary for 0.9.0 multi-decoder routing#46
lesnik512 merged 1 commit into
mainfrom
docs/seam-b-multi-decoder-claudemd

Conversation

@lesnik512

Copy link
Copy Markdown
Member

Summary

Closes the High finding from the 0.9.0 delta audit (planning/audit/2026-06-12-delta-audit.md): CLAUDE.md's Seam B bullet still described the pre-0.9.0 single-decoder contract — a single ResponseDecoder with only decode(content, model) — with no can_decode dispatch, no decoders=[...] list, and no MissingDecoderError pre-flight. An AI agent implementing a custom decoder from that reference ships an interface missing can_decode, which AttributeErrors when the client calls it at dispatch.

Rewritten to match the live 0.9.0 contract and stay consistent with the canonical planning/engineering.md §Seam B (which was already up to date):

  • decoders: Sequence[ResponseDecoder] | None — a list, default resolves against installed extras (pydantic-first)
  • dispatch walks the list; first decoder whose can_decode(model) is True runs decode(...)
  • MissingDecoderError raised before the HTTP call when none claim the model
  • decoder exceptions wrapped as DecodeError at the seam
  • pointer to engineering.md §Seam B for the full contract

Docs-only; one line changed.

Test Plan

  • No code change — CLAUDE.md only
  • Matches planning/engineering.md §Seam B (lines 39–46) and the actual ResponseDecoder protocol / _dispatch_decoder behavior

🤖 Generated with Claude Code

CLAUDE.md's Seam B bullet still described the pre-0.9.0 single-decoder
contract (a single ResponseDecoder, decode(content, model) only) with no
can_decode dispatch, decoders=[...] list, or MissingDecoderError pre-flight.
An agent implementing a decoder from it ships an interface that AttributeErrors
at dispatch. Rewritten to match the live contract and engineering.md §Seam B.

Closes the High finding in planning/audit/2026-06-12-delta-audit.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@lesnik512 lesnik512 merged commit 7111f02 into main Jun 13, 2026
5 checks passed
@lesnik512 lesnik512 deleted the docs/seam-b-multi-decoder-claudemd branch June 13, 2026 08:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant