# Changelog

## Score

- CAI 67 → 68 (+0.5)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

## Lenses

- Code Health 98 → 96 (-1.6)
- Architecture 86 → 96 (+10.3)
- Maturity 64 → 65 (+1.3)
- Readiness 59 → 59 (+0.1)
- Security 81 → 77 (-4.3)

## Resolved (7)

- Duplicated block (6 lines × 8) (lib/kafka_ex/protocol/kayrock/offset_fetch/any_request_impl.ex)
- Leaked secret: hardcoded-credential (lib/kafka_ex/auth/config.ex)
- Off-boarding risk: anonymized user #1
- Orphaned file (lib/kafka_ex/consumer/gen_consumer_supervisor.ex)
- Outdated: ezstd
- Outdated: kayrock
- Projects may be oversized for their cohesion

## New (37)

- Change coupling: api.ex ↔ response_parser.ex (lib/kafka_ex/api.ex)
- Change coupling: request_builder.ex ↔ response_parser.ex (lib/kafka_ex/client/request_builder.ex)
- ConsumerProtocolManager.validate (cognitive 16) (lib/kafka_ex/consumer/consumer_group/consumer_protocol_manager.ex)
- ConsumerProtocolManager.validate (cyclomatic 16) (lib/kafka_ex/consumer/consumer_group/consumer_protocol_manager.ex)
- Duplicated block (6 lines × 7) (lib/kafka_ex/protocol/kayrock/offset_fetch/v0_request_impl.ex)
- Edited copies of one member (3 members, 10+ corresponding lines) (lib/kafka_ex/client/client.ex)
- Edited copies of one member (3 members, 20+ corresponding lines) (lib/kafka_ex/client/request_builder.ex)
- Edited copies of one member (3 members, 8+ corresponding lines) (lib/kafka_ex/messages/record_metadata.ex)
- Edited copies of one member (4 members, 4+ corresponding lines) (lib/kafka_ex/protocol/kayrock/fetch/v0_request_impl.ex)
- Edited copies of one member (4 members, 5+ corresponding lines) (lib/kafka_ex/api.ex)
- Edited copies of one member (5 members, 9+ corresponding lines) (lib/kafka_ex/protocol/kayrock/offset_commit/request_helpers.ex)
- Edited copies of one member (7 members, 8+ corresponding lines) (lib/kafka_ex/client/client.ex)
- Edited copy of a member (12 corresponding lines) (lib/kafka_ex/protocol/kayrock/create_topics/request_helpers.ex)
- Edited copy of a member (12 corresponding lines) (lib/kafka_ex/protocol/kayrock/join_group/request_helpers.ex)
- Edited copy of a member (18 corresponding lines) (lib/kafka_ex/client/client.ex)
- Edited copy of a member (23 corresponding lines) (lib/kafka_ex/protocol/kayrock/list_offsets/any_request_impl.ex)
- Edited copy of a member (4 corresponding lines) (lib/kafka_ex/protocol/kayrock/heartbeat/response_helpers.ex)
- Edited copy of a member (5 corresponding lines) (lib/kafka_ex/protocol/kayrock/heartbeat/request_helpers.ex)
- Edited copy of a member (7 corresponding lines) (lib/kafka_ex/client/client.ex)
- Edited copy of a member (7 corresponding lines) (lib/kafka_ex/protocol/kayrock/create_topics/any_request_impl.ex)
- …and 17 more

## Changes since last survey

- 39 commits — 27 feature/other, 12 fixes

## By area

- lib/kafka_ex — 21 commits
- (root) — 11 commits
- .github/workflows — 2 commits
- test/kafka4 — 2 commits
- test/kafka_ex — 2 commits
- test/chaos — 1 commit

## Notable commits

- fix: fix(api): reuse one member id across join retries; report the id sent
- fix: fix(api): validate every heartbeat field; return errors instead of raising
- fix: fix(api): validate heartbeat input before the client builds it; expose generate_member_id/0
- fix: fix(client): reject malformed topic ids and member options instead of crashing
- fix: fix(consumer_group): derive generation reset from Retry; reset member_id on :group_id_not_found
- fix: fix(metadata): keep the client's cache on a targeted lookup; report by-id auth failures
- fix: fix(metadata): report unknown topic ids from a by-id lookup
- fix: fix(network): report a peer-closed socket as :closed, not :einval
- fix: fix(offsets): never fail or resend on an unknown topic id
- fix: fix(offsets): send a nil member_id/generation_id as unset instead of crashing the client
- fix: fix(optional_deps): accept the stdlib :zstd module for required_compression (#618)
- fix: fix(protocol): tell a missing topic-name resolver apart from an unknown topic id
- change: build: depend on Kayrock master for the Kafka 4.4.0 protocol structs
- change: chore: prepare release v1.2.0 (#613)
- change: ci(kafka4): also run the Kafka 4 suite against apache/kafka 4.2.2 (#614)
- change: ci: run the Kafka 4.4 integration suite (mix test.kafka4)
- change: docs(api): spec metadata/2,3 errors as atom | KafkaEx.Client.Error
- change: docs(changelog): note :group_id_not_found for direct commit_offset callers
- change: docs(changelog): note KIP-848-era API versions and topic ids
- change: docs(changelog): note the KIP-848 consumer group protocol APIs
- …and 19 more
