# Changelog

## Score

- CAI 66 → 69 (+2.8)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.

## Lenses

- Code Health 69 → 69 (+0.1)
- Architecture 99 → 99 (+0.1)
- Maturity 59 → 65 (+5.9)
- Readiness 67 → 67 (+0.1)
- Security 81 → 81 (+0.0)

## Resolved (33)

- Ambiguous redundancy. While the parameter types differ (Class vs Type), the method name `get` is overloaded in a way that often leads to confusion with `TypeToken`'s primary purpose of capturing generic types. More critically, `TypeToken` has a constructor that takes a Type, and static factory methods that do similar things. However, the most glaring inconsistency is between `TypeToken.get(Class)` and `TypeToken.get(Type)` which return different generic bounds (T vs ?) for conceptually similar 'creation' operations, whereas `TypeToken` is typically instantiated via constructor. A more consistent API would likely unify creation or use distinct names like `forClass` and `forType`.
- Duplicate operation with different names. `parse` and `parseReader` perform the exact same function (parsing a JsonReader into a JsonElement).
- Duplicate operation with different names. `parse` and `parseReader` perform the exact same function (parsing a Reader into a JsonElement).
- Duplicate operation with different names. `parse` and `parseString` perform the exact same function (parsing a String into a JsonElement).
- Duplicated block (10 lines × 2) (extras/src/main/java/com/google/gson/typeadapters/UtcDateTypeAdapter.java)
- Duplicated block (11 lines × 2) (extras/src/main/java/com/google/gson/typeadapters/UtcDateTypeAdapter.java)
- Duplicated block (11 lines × 2) (metrics/src/main/java/com/google/gson/metrics/BagOfPrimitivesDeserializationBenchmark.java)
- Inconsistent parameter types for equivalent operations. `TypeToken<T>` is essentially a wrapper around `Type` (specifically `Type` that captures generic type arguments). Passing a `TypeToken` vs a raw `Type` to `fromJson` results in different runtime behavior (generic type capture vs raw type), but the method names are identical. This forces users to understand the subtle difference between `Type` and `TypeToken` to choose the correct overload, which is a common source of error.
- Near-duplicate member pair (33 shared lines) (extras/src/main/java/com/google/gson/typeadapters/UtcDateTypeAdapter.java)
- No ADRs found
- No assertions: testCollectionOfEnumsDeserialization (gson/src/test/java/com/google/gson/functional/EnumTest.java)
- No assertions: testCustomCollectionCreation (gson/src/test/java/com/google/gson/internal/ConstructorConstructorTest.java)
- No assertions: testCustomMapCreation (gson/src/test/java/com/google/gson/internal/ConstructorConstructorTest.java)
- No assertions: testDateSerializationWithDateStyle (gson/src/test/java/com/google/gson/functional/DefaultTypeAdaptersTest.java)
- No assertions: testDefaultSqlDateDeserialization (gson/src/test/java/com/google/gson/internal/sql/SqlTypesGsonTest.java)
- No assertions: testDefaultSqlTimeDeserialization (gson/src/test/java/com/google/gson/internal/sql/SqlTypesGsonTest.java)
- No assertions: testDefaultSqlTimestampDeserialization (gson/src/test/java/com/google/gson/internal/sql/SqlTypesGsonTest.java)
- No assertions: testEqualsAcrossTypes (gson/src/test/java/com/google/gson/JsonPrimitiveTest.java)
- No assertions: testEqualsAndHashCode (gson/src/test/java/com/google/gson/internal/LinkedTreeMapTest.java)
- No assertions: testEqualsAndHashCodeAcrossNumberTypes (gson/src/test/java/com/google/gson/JsonPrimitiveTest.java)
- …and 13 more

## New (31)

- Edited copies of one member (3 members, 19+ corresponding lines) (test-shrinker/src/main/java/com/example/Main.java)
- Edited copies of one member (3 members, 20+ corresponding lines) (gson/src/main/java/com/google/gson/internal/bind/JdkOptionalTypeAdapters.java)
- Edited copies of one member (3 members, 22+ corresponding lines) (gson/src/main/java/com/google/gson/internal/bind/JsonTreeReader.java)
- Edited copies of one member (4 members, 22+ corresponding lines) (gson/src/main/java/com/google/gson/internal/bind/JavaTimeTypeAdapters.java)
- Edited copies of one member (4 members, 39+ corresponding lines) (gson/src/main/java/com/google/gson/internal/bind/JavaTimeTypeAdapters.java)
- Edited copies of one member (5 members, 13+ corresponding lines) (gson/src/main/java/com/google/gson/internal/bind/TypeAdapters.java)
- Edited copies of one member (6 members, 8+ corresponding lines) (test-shrinker/src/main/java/com/example/Main.java)
- Edited copy of a member (10 corresponding lines) (gson/src/main/java/com/google/gson/internal/bind/NumberTypeAdapter.java)
- Edited copy of a member (11 corresponding lines) (gson/src/main/java/com/google/gson/internal/bind/JsonTreeWriter.java)
- Edited copy of a member (11 corresponding lines) (gson/src/main/java/com/google/gson/internal/bind/TypeAdapters.java)
- Edited copy of a member (12 corresponding lines) (gson/src/main/java/com/google/gson/internal/reflect/ReflectionHelper.java)
- Edited copy of a member (13 corresponding lines) (gson/src/main/java/com/google/gson/stream/JsonReader.java)
- Edited copy of a member (19 corresponding lines) (gson/src/main/java/com/google/gson/internal/bind/TypeAdapters.java)
- Edited copy of a member (19 corresponding lines) (gson/src/main/java/com/google/gson/internal/bind/TypeAdapters.java)
- Edited copy of a member (19 corresponding lines) (gson/src/main/java/com/google/gson/internal/sql/SqlDateTypeAdapter.java)
- Edited copy of a member (21 corresponding lines) (gson/src/main/java/com/google/gson/internal/bind/CollectionTypeAdapterFactory.java)
- Edited copy of a member (23 corresponding lines) (gson/src/main/java/com/google/gson/internal/LinkedTreeMap.java)
- Edited copy of a member (23 corresponding lines) (proto/src/main/java/com/google/gson/protobuf/LegacyProtoTypeAdapterFactory.java)
- Edited copy of a member (25 corresponding lines) (extras/src/main/java/com/google/gson/typeadapters/UtcDateTypeAdapter.java)
- Edited copy of a member (28 corresponding lines) (gson/src/main/java/com/google/gson/Gson.java)
- …and 11 more

## Changes since last survey

- 12 commits — 11 feature/other, 1 fixes

## By area

- gson/src — 5 commits
- (repo) — 4 commits
- (root) — 1 commit
- .github/workflows — 1 commit
- gson/pom.xml — 1 commit

## Notable commits

- fix: Merge pull request #3157 from wozhenbang2004/fix/json-array-sublist-clear
- change: Add built-in TypeAdapterFactory support for java.util.Optional*
- change: Add tests for clearing sublists in JsonArrayTest clearing JsonArray sublist views
- change: Address review comment
- change: Address review comments
- change: Avoid quadratic clearing in JsonArray sublists
- change: Bump the github-actions group with 7 updates (#3159)
- change: Bump the maven group across 2 directories with 1 update
- change: Merge pull request #3155 from google/release
- change: Merge pull request #3161 from google/dependabot/maven/gson/maven-7667e75bf7
- change: Merge pull request #3162 from cushon/optional
- change: Merge pull request #3164 from google/dependabot/maven/maven-3b846bd855
