# Changelog

## Score

- CAI 54 → 56 (+1.6)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

## Lenses

- Code Health 67 → 87 (+19.1)
- Architecture 100 → 97 (-2.7)
- Maturity 57 → 58 (+1.1)
- Readiness 59 → 59 (+0.0)
- Security 43 → 43 (+0.0)
- Performance 100 → 100 (+0.0)

## Resolved (8)

- Documentation: no project overview (docs/the_black_code_style/index.md)
- Hotspot: src/black/strings.py (src/black/strings.py)
- LineGenerator.visit_default (cognitive 20) (src/black/linegen.py)
- No ADRs found
- Orphaned file (src/blackd/client.py)
- Redundant assertion/checking operations. `assert_stable` and `assert_equivalent` are thin wrappers or aliases for `check_stability_and_equivalence` (or its underlying logic). They expose the same intent (verifying formatting correctness) with different names and slightly different signatures (one takes a single `src` and `dst`, the other takes `src_contents` and `dst_contents` but implies the same comparison). `assert_stable` likely checks idempotency, while `assert_equivalent` checks semantic equivalence, but they are closely related verification steps often used together.
- comments._should_keep_compound_statement_inline (cognitive 16) (src/black/comments.py)
- main.read_version_specifier_from_pyproject (cognitive 17) (action/main.py)

## New (14)

- Edited copy of a member (10 corresponding lines) (src/black/linegen.py)
- Edited copy of a member (11 corresponding lines) (src/black/linegen.py)
- Edited copy of a member (17 corresponding lines) (src/black/linegen.py)
- Edited copy of a member (19 corresponding lines) (scripts/release.py)
- Edited copy of a member (22 corresponding lines) (src/black/trans.py)
- Edited copy of a member (42 corresponding lines) (src/black/trans.py)
- Hotspot: src/black/ranges.py (src/black/ranges.py)
- LineGenerator.visit_STANDALONE_COMMENT (cognitive 19) (src/black/linegen.py)
- LineGenerator.visit_comp_for (cognitive 18) (src/black/linegen.py)
- No ADRs found (pyproject.toml)
- Scattered collaborators
- comments._handle_comment_only_fmt_block (cyclomatic 18) (src/black/comments.py)
- comments._is_kept_as_text (cognitive 22) (src/black/comments.py)
- comments.generate_ignored_nodes (cyclomatic 19) (src/black/comments.py)

## Changes since last survey

- 59 commits — 34 feature/other, 25 fixes

## By area

- (root) — 38 commits
- src/black — 7 commits
- tests/data — 6 commits
- .github/workflows — 5 commits
- docs/contributing — 1 commit
- docs/faq.md — 1 commit
- docs/usage_and_configuration — 1 commit

## Notable commits

- fix: Fix --line-ranges crash on clauses with their body on the same line (#5635)
- fix: Fix --line-ranges not removing selected trailing blank lines (#5654)
- fix: Fix --line-ranges producing invalid code for stacked decorators in 2-space or tab-indented code (#5672)
- fix: Fix B045 loop variable shadowing in `_iter_nameescape_slices` (#5639)
- fix: Fix `# fmt: skip` combined with `# fmt: off` / `# yapf: disable` in the same comment (#5665)
- fix: Fix `# fmt: skip` on a semicolon-separated body on its own line (#5674)
- fix: Fix `# fmt: skip` on the last line of a multi-line conditional expression in brackets (#5647)
- fix: Fix async statements dropped after a comment-only fmt: off/on block (#5678)
- fix: Fix blackd client encoding for custom Content-Type charsets (#5645)
- fix: Fix blackd startup on Windows with more than 61 logical CPUs (#5667)
- fix: Fix crash on `# fmt: off` before the trailing comma in brackets (#5651)
- fix: Fix crash on `# fmt: off` in an f-string with `=` or a t-string (#5653)
- fix: Fix crash on `# fmt: skip` on a nested bracket after `with` or `yield` (#5620)
- fix: Fix crash on `# fmt: skip` on several one-line clauses of a statement (#5675)
- fix: Fix crash on a commented parenthesized assignment target (#5662)
- fix: Fix crash on a multi-line parenthesized tuple target (#5621)
- fix: Fix crash on a skipped async def header with a `...` body (#5671)
- fix: Fix crash on a type: ignore chain with another comment between the ignores (#5618)
- fix: Fix crash on backslash-only lines in code Black leaves as is (#5681)
- fix: Fix crash on fmt: skip after the last base of a skipped class header (#5633)
- …and 39 more
