sourcecode 1.62.0__tar.gz → 1.63.0__tar.gz

{sourcecode-1.62.0 → sourcecode-1.63.0}/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## [1.63.0] — 2026-06-29
+
+### Added — actionable Hibernate rewrite targets (`migrate-check`)
+
+The Hibernate stratification went from **diagnostic** (how many files/occurrences
+per layer) to **actionable** (what to rewrite, where, and to what) so a migration
+agent can consume the output directly without re-parsing the repo. The `hibernate`
+section gains a sub-`schema_version` (now **2.0**); all existing keys preserved.
+
+- **`hibernate.rewrite_targets[]`** — one machine-readable target per call site:
+  `id`, `layer`, `source_file`, `line_start`/`line_end`, `current_pattern`,
+  `current_snippet`, `target_api` (the Hibernate-6 destination), `migration_kind`
+  (`manual_rewrite` / `assisted` / `mechanical` / `review`), `auto_migratable`,
+  `blocking_reason`, `symbol` (enclosing `Class#method`), `module`, `dynamic`.
+  Mapping rules: legacy `org.hibernate.Criteria`/`Restrictions`/`Projections` →
+  `CriteriaBuilder` (manual); `@Type(type=)` → `@Type(value=)`/`@JdbcTypeCode`
+  (mechanical, auto); `@TypeDef`/`@GenericGenerator` → assisted; concatenated HQL →
+  assisted + `runtime-resolved string`; `UserType`/`Interceptor`/`EventListener`/SPI
+  → its H6 contract (manual). Standard JPA annotations emit **no** targets.
+- **Per-layer migration-kind sub-counts** in `risk_matrix` (`manual_count`,
+  `assisted_count`, `mechanical_count`, `review_count`); Criteria adds
+  `static_count` vs `dynamic_count`; SPI adds `userType_rewrite_count` vs
+  `userType_resolvable_count` — so dynamic/reflexive cost is not blended into static.
+- **Honest effort** — each layer carries `effort_range` `{low, high, confidence}`
+  (legacy `estimated_effort` string kept); `hibernate.total_effort_range_days`
+  aggregates them; `hibernate.effort_model` exposes the auditable formula and the
+  caveat that layers may share files (the total is an upper bound, not deduplicated).
+- **`hibernate_readiness` (0–100)** — 4th readiness dimension alongside
+  jakarta/boot3/jdk. It does **not** sink the headline `readiness_score` (Hibernate
+  is an orthogonal rewrite axis), but in a rewrite zone `headline_blocker` is set to
+  `"hibernate_rewrite"` so a reader of "62/100" is not misled.
+- **`hibernate.golden_sql_hotspots[]`** — classes/methods that concentrate dynamic
+  query generation, ranked by reflexive-query volume — where to pin golden-SQL tests.
+
+### Fixed
+
+- `get_migration_readiness` MCP test asserted the pre-1.62 report `schema_version`
+  `1.3`; the v1.62.0 schema bump to `1.4` made it stale. Corrected to `1.4`.
+
 ## [1.62.0] — 2026-06-29
 
 ### Added — Hibernate 5.x → 6.x migration stratification (`migrate-check`)

{sourcecode-1.62.0 → sourcecode-1.63.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.62.0
+Version: 1.63.0
 Summary: Persistent structural context and ultra-fast repeated analysis for AI coding agents
 License-File: LICENSE
 Keywords: agents,ai,codebase,context,developer-tools,llm
@@ -657,6 +657,58 @@ Detects migration blockers across Java source files, Spring XML config files, an
 
 Each finding includes `severity`, `title`, `source_file`, `first_line`, `explanation`, `fix_hint`, `migration_target`, and `openrewrite_recipe` (when an automated recipe exists).
 
+#### Hibernate 5.x → 6.x stratification (the `hibernate` output section)
+
+A Hibernate major upgrade is **not** a single dependency bump for systems that use
+dynamic persistence. `migrate-check` stratifies Hibernate exposure into four
+independent migration domains — never one aggregated score — and emits **actionable,
+machine-readable rewrite targets** so a migration agent can consume the output
+directly instead of re-parsing the repo. Sub-`schema_version`: `2.0`.
+
+**Four layers** (each on its own risk axis):
+
+| Layer | Baseline | Escalates to |
+|-------|----------|--------------|
+| `jpa_annotations` | LOW (namespace handled by jakarta) | HIGH on deprecated `@Type(type=)` / `@TypeDef` / `@GenericGenerator` |
+| `criteria_api` | HIGH (JPA Criteria semantics changed; legacy `org.hibernate.Criteria` removed) | **CRITICAL** when built via reflection / abstraction DAOs (`DynamicEntityDao`, `GenericDao`, `BasicPersistenceModule`) |
+| `hql_string_queries` | MEDIUM (revalidate against H6 parser) | HIGH on string concatenation (SQL shape not statically inferable) |
+| `hibernate_spi_internal` | CRITICAL blocker | `UserType`, `CompositeUserType`, `Interceptor`, `EventListener`, `org.hibernate.engine.spi` |
+
+**Output keys (under `hibernate`):**
+
+- `classification` — `upgrade_zone` / `upgrade_with_care` / `rewrite_zone`. Any of
+  {dynamic Criteria, custom SPI, reflection-built queries, concatenated query
+  strings} forces **`rewrite_zone`** ("HIGH RISK REWRITE ZONE, NOT UPGRADE ZONE").
+- `risk_matrix[]` — per layer: `risk`, `reason`, `effort_range {low, high, confidence}`,
+  `file_count`, `occurrence_count`, migration-kind sub-counts (`manual_count`,
+  `assisted_count`, `mechanical_count`, `review_count`); Criteria adds
+  `static_count` vs `dynamic_count`; SPI adds `userType_rewrite_count` vs
+  `userType_resolvable_count`.
+- `rewrite_targets[]` — one actionable target per call site: `id`, `layer`,
+  `source_file`, `line_start`/`line_end`, `current_pattern`, `current_snippet`,
+  `target_api` (the Hibernate-6 destination), `migration_kind`
+  (`manual_rewrite` / `assisted` / `mechanical` / `review`), `auto_migratable`,
+  `blocking_reason`, `symbol` (enclosing `Class#method`), `module`, `dynamic`.
+- `module_exposure_map` — per Maven/Gradle module: `max_risk`, layers present, and
+  `dynamic-criteria` / `custom-SPI` / `reflection` tags.
+- `critical_call_chains[]` — dynamic query-generation paths (reflection-based DAOs).
+- `golden_sql_hotspots[]` — classes/methods ranked by dynamic-query volume — where
+  to pin golden-SQL behaviour tests before migrating.
+- `total_effort_range_days` + `effort_model` — aggregate range plus the auditable
+  formula (and the caveat that layers may share files, so the total is an upper bound).
+- `stop_conditions_triggered[]`, `risk_separation` (observable vs inferred runtime risk).
+
+The report also exposes **`hibernate_readiness`** (0–100) as a fourth readiness
+dimension alongside `jakarta_readiness` / `boot3_readiness` / `jdk_modernization`.
+Hibernate is an orthogonal rewrite axis, so it does not sink the headline
+`readiness_score`; instead, in a rewrite zone the top-level `headline_blocker` is set
+to `"hibernate_rewrite"` so a reader of the headline score is not misled.
+
+```bash
+# inspect only the Hibernate rewrite targets
+sourcecode migrate-check . --format json | jq '.hibernate.rewrite_targets[]'
+```
+
 ### `rename-class` — Java class rename
 
 ```bash

{sourcecode-1.62.0 → sourcecode-1.63.0}/README.md

@@ -619,6 +619,58 @@ Detects migration blockers across Java source files, Spring XML config files, an
 
 Each finding includes `severity`, `title`, `source_file`, `first_line`, `explanation`, `fix_hint`, `migration_target`, and `openrewrite_recipe` (when an automated recipe exists).
 
+#### Hibernate 5.x → 6.x stratification (the `hibernate` output section)
+
+A Hibernate major upgrade is **not** a single dependency bump for systems that use
+dynamic persistence. `migrate-check` stratifies Hibernate exposure into four
+independent migration domains — never one aggregated score — and emits **actionable,
+machine-readable rewrite targets** so a migration agent can consume the output
+directly instead of re-parsing the repo. Sub-`schema_version`: `2.0`.
+
+**Four layers** (each on its own risk axis):
+
+| Layer | Baseline | Escalates to |
+|-------|----------|--------------|
+| `jpa_annotations` | LOW (namespace handled by jakarta) | HIGH on deprecated `@Type(type=)` / `@TypeDef` / `@GenericGenerator` |
+| `criteria_api` | HIGH (JPA Criteria semantics changed; legacy `org.hibernate.Criteria` removed) | **CRITICAL** when built via reflection / abstraction DAOs (`DynamicEntityDao`, `GenericDao`, `BasicPersistenceModule`) |
+| `hql_string_queries` | MEDIUM (revalidate against H6 parser) | HIGH on string concatenation (SQL shape not statically inferable) |
+| `hibernate_spi_internal` | CRITICAL blocker | `UserType`, `CompositeUserType`, `Interceptor`, `EventListener`, `org.hibernate.engine.spi` |
+
+**Output keys (under `hibernate`):**
+
+- `classification` — `upgrade_zone` / `upgrade_with_care` / `rewrite_zone`. Any of
+  {dynamic Criteria, custom SPI, reflection-built queries, concatenated query
+  strings} forces **`rewrite_zone`** ("HIGH RISK REWRITE ZONE, NOT UPGRADE ZONE").
+- `risk_matrix[]` — per layer: `risk`, `reason`, `effort_range {low, high, confidence}`,
+  `file_count`, `occurrence_count`, migration-kind sub-counts (`manual_count`,
+  `assisted_count`, `mechanical_count`, `review_count`); Criteria adds
+  `static_count` vs `dynamic_count`; SPI adds `userType_rewrite_count` vs
+  `userType_resolvable_count`.
+- `rewrite_targets[]` — one actionable target per call site: `id`, `layer`,
+  `source_file`, `line_start`/`line_end`, `current_pattern`, `current_snippet`,
+  `target_api` (the Hibernate-6 destination), `migration_kind`
+  (`manual_rewrite` / `assisted` / `mechanical` / `review`), `auto_migratable`,
+  `blocking_reason`, `symbol` (enclosing `Class#method`), `module`, `dynamic`.
+- `module_exposure_map` — per Maven/Gradle module: `max_risk`, layers present, and
+  `dynamic-criteria` / `custom-SPI` / `reflection` tags.
+- `critical_call_chains[]` — dynamic query-generation paths (reflection-based DAOs).
+- `golden_sql_hotspots[]` — classes/methods ranked by dynamic-query volume — where
+  to pin golden-SQL behaviour tests before migrating.
+- `total_effort_range_days` + `effort_model` — aggregate range plus the auditable
+  formula (and the caveat that layers may share files, so the total is an upper bound).
+- `stop_conditions_triggered[]`, `risk_separation` (observable vs inferred runtime risk).
+
+The report also exposes **`hibernate_readiness`** (0–100) as a fourth readiness
+dimension alongside `jakarta_readiness` / `boot3_readiness` / `jdk_modernization`.
+Hibernate is an orthogonal rewrite axis, so it does not sink the headline
+`readiness_score`; instead, in a rewrite zone the top-level `headline_blocker` is set
+to `"hibernate_rewrite"` so a reader of the headline score is not misled.
+
+```bash
+# inspect only the Hibernate rewrite targets
+sourcecode migrate-check . --format json | jq '.hibernate.rewrite_targets[]'
+```
+
 ### `rename-class` — Java class rename
 
 ```bash

{sourcecode-1.62.0 → sourcecode-1.63.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sourcecode"
-version = "1.62.0"
+version = "1.63.0"
 description = "Persistent structural context and ultra-fast repeated analysis for AI coding agents"
 readme = "README.md"
 requires-python = ">=3.9"

{sourcecode-1.62.0 → sourcecode-1.63.0}/src/sourcecode/__init__.py

@@ -1,3 +1,3 @@
 """sourcecode — Deterministic codebase context maps for AI coding agents."""
 
-__version__ = "1.62.0"
+__version__ = "1.63.0"

{sourcecode-1.62.0 → sourcecode-1.63.0}/src/sourcecode/cli.py

@@ -4841,9 +4841,12 @@ def migrate_check_cmd(
     \b
     Hibernate 5→6 stratification (in the 'hibernate' output section):
       4 independent layers (JPA annotations / Criteria / HQL / SPI), a per-layer
-      risk matrix, a module exposure map, critical call-chain detection, and an
-      UPGRADE vs REWRITE verdict (dynamic Criteria, custom SPI, reflection-built
-      queries, or concatenated query strings force the REWRITE classification).
+      risk matrix with effort ranges, a module exposure map, critical call-chain
+      detection, golden-SQL hotspots, a hibernate_readiness score, and an UPGRADE
+      vs REWRITE verdict (dynamic Criteria, custom SPI, reflection-built queries,
+      or concatenated query strings force the REWRITE classification).
+      Emits actionable rewrite_targets[] (call-site line ranges → target_api +
+      migration_kind) so a migration agent can consume the output directly.
 
     \b
     Examples: