sourcecode 1.31.32__py3-none-any.whl → 1.32.1__py3-none-any.whl

sourcecode/__init__.py

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

sourcecode/architecture_analyzer.py

@@ -152,14 +152,15 @@ LAYER_PATTERNS: dict[str, dict[str, list[str]]] = {
 
 # Higher value = wins when score ties
 _PATTERN_PRIORITY: dict[str, int] = {
-    "cqrs":       8,
-    "clean":      7,
-    "onion":      6,
-    "hexagonal":  5,
-    "monorepo":   4,
-    "mvc":        3,
-    "layered":    2,
-    "fullstack":  1,
+    "cqrs":               8,
+    "clean":              7,
+    "onion":              6,
+    "hexagonal":          5,
+    "monorepo":           4,
+    "spring_mvc_layered": 3,
+    "mvc":                3,
+    "layered":            2,
+    "fullstack":          1,
 }
 
 
@@ -248,9 +249,9 @@ class ArchitectureAnalyzer:
         pattern, layers = self._detect_layers(filtered)
         if pattern in (None, "flat", "unknown"):
             if pattern == "flat":
-                limitations.append("Patron de capas no detectado: proyecto con estructura plana")
+                limitations.append("Layer pattern not detected: project has a flat directory structure")
             elif pattern == "unknown":
-                limitations.append("Patron de capas no reconocido: estructura de directorios sin senales claras")
+                limitations.append("Unrecognized layer pattern: directory structure has no clear architectural signals")
 
         # Step 3b: monorepo override — workspace config is hard evidence.
         # Overrides all weak inferred patterns; only truly specialised patterns
@@ -269,7 +270,7 @@ class ArchitectureAnalyzer:
                 pattern = "monorepo"
                 layers = mono_layers
                 limitations.append(
-                    "Workspace config detectado — arquitectura refleja topologia de paquetes"
+                    "Workspace config detected — architecture reflects package topology"
                 )
                 ws_files = [p for p in sm.file_paths if p.split("/")[-1] in _WORKSPACE_CONFIG_FILES]
                 evidence.append({
@@ -570,28 +571,76 @@ class ArchitectureAnalyzer:
                 ))
             return best_pattern, layers
 
-        # 2. Microservices structural detection (before file-naming heuristics)
+        # 2. Spring domain-module detection (petclinic-style: deep common prefix + feature dirs)
+        spring_result = self._detect_spring_domain_modules(source_paths)
+        if spring_result is not None:
+            return spring_result
+
+        # 3. Microservices structural detection (before file-naming heuristics)
         microservices_result = self._detect_microservices(source_paths)
         if microservices_result is not None:
             return microservices_result
 
-        # 3. Functional file-naming heuristic: *_analyzer.py, cli.py, schema.py, …
+        # 5. Functional file-naming heuristic: *_analyzer.py, cli.py, schema.py, …
         func_result = self._detect_layered_functional(source_paths)
         if func_result is not None:
             return func_result
 
-        # 4. Modular sub-package heuristic: ≥2 distinct named sub-packages
+        # 6. Modular sub-package heuristic: ≥2 distinct named sub-packages
         modular_result = self._detect_modular(source_paths)
         if modular_result is not None:
             return modular_result
 
-        # 5. Fallback: flat (shallow) vs truly unknown (deep but unrecognised)
+        # 7. Fallback: flat (shallow) vs truly unknown (deep but unrecognised)
         max_depth = max(
             (len(p.replace("\\", "/").split("/")) - 1 for p in source_paths),
             default=0,
         )
         return ("flat" if max_depth <= 2 else "unknown"), []
 
+    def _detect_spring_domain_modules(
+        self, paths: list[str]
+    ) -> Optional[tuple[str, list[ArchitectureLayer]]]:
+        """Detect Spring Boot domain-organized packages (petclinic-style).
+
+        When all source paths share a deep common package prefix
+        (e.g. src/main/java/org/springframework/samples/petclinic/),
+        strips that prefix and detects feature/domain modules in the remainder.
+        Requires ≥3 distinct domain directories to avoid false positives.
+        """
+        if len(paths) < 6:
+            return None
+
+        parts_list = [p.replace("\\", "/").split("/") for p in paths]
+        min_depth = min(len(p) for p in parts_list)
+        common_depth = 0
+        for i in range(min_depth - 1):
+            seg = parts_list[0][i]
+            if all(pl[i] == seg for pl in parts_list):
+                common_depth = i + 1
+            else:
+                break
+
+        if common_depth < 3:
+            return None
+
+        module_files: dict[str, list[str]] = {}
+        for orig, pl in zip(paths, parts_list):
+            remaining = pl[common_depth:]
+            if remaining and remaining[0] not in _GENERIC_NAMES:
+                module_files.setdefault(remaining[0], []).append(orig)
+
+        meaningful = {k: v for k, v in module_files.items() if len(v) >= 2}
+        if len(meaningful) < 3:
+            return None
+
+        return "spring_mvc_layered", [
+            ArchitectureLayer(
+                name=k, pattern="spring_mvc_layered", files=v, confidence="medium"
+            )
+            for k, v in meaningful.items()
+        ]
+
     def _detect_microservices(
         self, paths: list[str]
     ) -> Optional[tuple[str, list[ArchitectureLayer]]]:

sourcecode/classifier.py

@@ -118,6 +118,10 @@ class TypeClassifier:
         ):
             return "webapp"
 
+        _SERVERSIDE_TEMPLATE_FRAMEWORKS = frozenset({"Thymeleaf", "FreeMarker"})
+        if framework_names & _SERVERSIDE_TEMPLATE_FRAMEWORKS:
+            return "web_mvc"
+
         if framework_names & _API_FRAMEWORKS:
             return "api"
 

sourcecode/cli.py

@@ -781,6 +781,11 @@ def main(
             err=True,
         )
 
+    # Pro gate for --full: removing truncation limits is enterprise-scale functionality.
+    if full:
+        from sourcecode.license import require_feature as _req_full
+        _req_full("--full")
+
     # P0-2 FIX: --compact and --full are mutually exclusive.
     # compact is designed to be a bounded summary; --full removes truncation limits,
     # which contradicts compact's purpose. Use --agent --full for expanded output.
@@ -2672,6 +2677,32 @@ def prepare_context_cmd(
     _pc_budget = _pc_budgets.get(task, BUDGET_EXPLAIN)
     out = _pc_trim(out, _pc_budget, label=task)
 
+    # Free-tier limits: fix-bug (top-5 files) and review-pr (lightweight).
+    # Pro users get the full analysis; free users get enough to see the value.
+    if task in ("fix-bug", "review-pr"):
+        from sourcecode.license import can_use as _tier_can_use
+        if not _tier_can_use(task):
+            _FREE_FILE_LIMIT = 5
+            if task == "fix-bug":
+                _rf = out.get("relevant_files")
+                if isinstance(_rf, list) and len(_rf) > _FREE_FILE_LIMIT:
+                    out["relevant_files"] = _rf[:_FREE_FILE_LIMIT]
+                    out["tier"] = "free"
+                    out["tier_note"] = (
+                        f"Showing top {_FREE_FILE_LIMIT} files. "
+                        "Upgrade to Pro for complete risk-ranked analysis across all files."
+                    )
+            else:  # review-pr
+                for _cap_field in ("runtime_changes", "execution_paths", "review_hotspots", "suggested_review_order"):
+                    _fval = out.get(_cap_field)
+                    if isinstance(_fval, list) and len(_fval) > _FREE_FILE_LIMIT:
+                        out[_cap_field] = _fval[:_FREE_FILE_LIMIT]
+                out["tier"] = "free"
+                out["tier_note"] = (
+                    "Lightweight review. Upgrade to Pro for full blast-radius analysis, "
+                    "complete execution paths, and CI-grade risk scoring."
+                )
+
     if format == "github-comment" and task == "review-pr":
         from sourcecode.pr_comment_renderer import render_github_comment
         _pc_content = render_github_comment(out)
@@ -3373,13 +3404,11 @@ def modernize_cmd(
       sourcecode onboard .         — Architecture overview first
       sourcecode impact <target>   — Verify impact before touching a hotspot
     """
-    from sourcecode.license import require_pro as _require_pro
-    _require_pro("modernize")
-
     import json as _json
     import sys as _sys
     from sourcecode.repository_ir import build_repo_ir, find_java_files, apply_ir_size_limits
     from sourcecode.output_budget import trim_to_budget, BUDGET_ONBOARD
+    from sourcecode.license import can_use as _mod_can_use
 
     root = path.resolve()
     if not root.is_dir():
@@ -3481,52 +3510,73 @@ def modernize_cmd(
         key=lambda s: -len(s.get("members") or []),
     )[:10]
 
-    result = {
-        "workflow": "modernize",
-        "path": str(root),
-        "summary": {
-            "total_classes": len([n for n in graph_nodes if n.get("type") in ("class", "interface")]),
-            "total_subsystems": len(subsystems),
-            "high_coupling_nodes": len(coupling_nodes),
-            "dead_zone_candidates": len(dead_zones),
-        },
-        "hotspot_candidates": hotspots,
-        "high_coupling_nodes": [
-            {"fqn": n["fqn"], "in_degree": n.get("in_degree", 0), "role": n.get("role", "other")}
-            for n in coupling_nodes
-        ],
-        "dead_zone_candidates": [
-            {"fqn": n["fqn"], "type": n.get("type", ""), "role": n.get("role", "other")}
-            for n in dead_zones
-        ],
-        "subsystem_summary": [
-            {
-                "label": s.get("label") or s.get("name") or "",
-                "package_prefix": s.get("package_prefix") or s.get("pkg") or "",
-                "member_count": len(s.get("members") or []),
-            }
-            for s in subsystems[:15]
-        ],
-        "cross_module_tangles": [
-            {
-                "label": s.get("label") or s.get("name") or "",
-                "member_count": len(s.get("members") or []),
-            }
-            for s in tangle_modules
-        ],
-        # BUG-05 fix: don't recommend "Start with hotspot_candidates" when the list is empty.
-        # hotspots filters by role=service/repository/controller; annotation types and
-        # value objects end up in high_coupling_nodes instead.
-        "recommendation": (
-            (
-                "Start with hotspot_candidates (high fan-in = highest blast radius). "
-                if hotspots else
-                "high_coupling_nodes shows the most-referenced classes — start there. "
-            )
-            + "Dead zones are safe to remove or refactor. "
-            + "Cross-module tangles indicate coupling worth decomposing."
-        ),
+    _summary = {
+        "total_classes": len([n for n in graph_nodes if n.get("type") in ("class", "interface")]),
+        "total_subsystems": len(subsystems),
+        "high_coupling_nodes": len(coupling_nodes),
+        "dead_zone_candidates": len(dead_zones),
     }
+    _subsystem_summary = [
+        {
+            "label": s.get("label") or s.get("name") or "",
+            "package_prefix": s.get("package_prefix") or s.get("pkg") or "",
+            "member_count": len(s.get("members") or []),
+        }
+        for s in subsystems[:15]
+    ]
+
+    if not _mod_can_use("modernize"):
+        # Free tier: structural discovery only — no dead zones, tangles, or full refactor list.
+        result = {
+            "workflow": "modernize",
+            "path": str(root),
+            "tier": "free",
+            "tier_note": (
+                "Upgrade to Pro for full analysis: dead zones, dependency tangles, "
+                "refactor candidates ranked by git churn, and complete coupling graphs."
+            ),
+            "summary": _summary,
+            "subsystem_summary": _subsystem_summary,
+            "hotspot_candidates": hotspots[:3],
+            "high_coupling_nodes": [
+                {"fqn": n["fqn"], "in_degree": n.get("in_degree", 0), "role": n.get("role", "other")}
+                for n in coupling_nodes[:3]
+            ],
+        }
+    else:
+        # Pro tier: full analysis.
+        result = {
+            "workflow": "modernize",
+            "path": str(root),
+            "summary": _summary,
+            "hotspot_candidates": hotspots,
+            "high_coupling_nodes": [
+                {"fqn": n["fqn"], "in_degree": n.get("in_degree", 0), "role": n.get("role", "other")}
+                for n in coupling_nodes
+            ],
+            "dead_zone_candidates": [
+                {"fqn": n["fqn"], "type": n.get("type", ""), "role": n.get("role", "other")}
+                for n in dead_zones
+            ],
+            "subsystem_summary": _subsystem_summary,
+            "cross_module_tangles": [
+                {
+                    "label": s.get("label") or s.get("name") or "",
+                    "member_count": len(s.get("members") or []),
+                }
+                for s in tangle_modules
+            ],
+            # BUG-05 fix: don't recommend "Start with hotspot_candidates" when the list is empty.
+            "recommendation": (
+                (
+                    "Start with hotspot_candidates (high fan-in = highest blast radius). "
+                    if hotspots else
+                    "high_coupling_nodes shows the most-referenced classes — start there. "
+                )
+                + "Dead zones are safe to remove or refactor. "
+                + "Cross-module tangles indicate coupling worth decomposing."
+            ),
+        }
 
     result = trim_to_budget(result, BUDGET_ONBOARD, label="modernize")
     output = _json.dumps(result, indent=2, ensure_ascii=False)
@@ -3619,9 +3669,6 @@ def mcp_serve() -> None:
         }
       }
     """
-    from sourcecode.license import require_pro as _require_pro
-    _require_pro("mcp serve")
-
     import logging
     import sys as _sys
 
@@ -3777,7 +3824,7 @@ def mcp_init(
         raise typer.Exit(code=1)
 
     typer.echo("MCP integration active.")
-    typer.echo("  Note:    repo_path debe usar forward slashes: C:/Users/... o /ruta/unix")
+    typer.echo("  Note:    repo_path must use forward slashes: C:/Users/... or /unix/path")
     typer.echo("")
 
     # Post-write: validate config and warn if client not running
@@ -3929,7 +3976,7 @@ def mcp_status() -> None:
     typer.echo(sep)
     typer.echo("  Note:    'configured' and 'running' are checked independently.")
     typer.echo("           A running app still needs restart after first-time config.")
-    typer.echo("  Path:    repo_path debe usar forward slashes: C:/Users/... o /ruta/unix")
+    typer.echo("  Path:    repo_path must use forward slashes: C:/Users/... or /unix/path")
     typer.echo("  Setup:   sourcecode mcp init")
     typer.echo("  Remove:  sourcecode mcp remove")
 

sourcecode/context_summarizer.py

@@ -28,6 +28,7 @@ _STACK_LABELS: dict[str, str] = {
 
 _TYPE_LABELS: dict[str, str] = {
     "api": "REST API",
+    "web_mvc": "Spring MVC web app",
     "webapp": "Web app",
     "fullstack": "Full-stack app",
     "cli": "CLI tool",

sourcecode/dependency_analyzer.py

@@ -1118,7 +1118,7 @@ class DependencyAnalyzer:
         try:
             tree = ET.parse(pom)
         except (ET.ParseError, OSError):
-            return [], ["java: error al parsear pom.xml"]
+            return [], ["java: error parsing pom.xml"]
 
         root_elem = tree.getroot()
         ns_match = re.match(r"\{[^}]+\}", root_elem.tag)
@@ -1217,10 +1217,10 @@ class DependencyAnalyzer:
                 try:
                     content = gradle_file.read_text(encoding="utf-8", errors="replace")
                 except OSError:
-                    return [], [f"gradle: error al leer {filename}"]
+                    return [], [f"gradle: error reading {filename}"]
                 props = self._parse_gradle_properties(root, content)
                 records = self._parse_gradle_dependencies(content, props, filename)
-                return records, ["gradle: sin lockfile compatible; dependencias transitivas no disponibles"]
+                return records, ["gradle: no compatible lockfile found; transitive dependencies unavailable"]
         return [], []
 
     def _parse_gradle_properties(self, root: Path, content: str) -> dict[str, str]:

sourcecode/detectors/java.py

@@ -23,6 +23,7 @@ _MAX_ANNOTATION_ENTRY_POINTS = 1000
 _REST_CONTROLLER_RE = re.compile(r'@RestController\b')
 _MVC_CONTROLLER_RE = re.compile(r'@Controller\b')
 _REQUEST_MAPPING_RE = re.compile(r'@RequestMapping\b')
+_ANY_MAPPING_RE = re.compile(r'@(?:Request|Get|Post|Put|Delete|Patch)Mapping\b')
 _CONTROLLER_ADVICE_RE = re.compile(r'@ControllerAdvice\b')
 _WEB_FILTER_RE = re.compile(r'@WebFilter\b')
 _FILTER_BEAN_RE = re.compile(r'FilterRegistrationBean\b')
@@ -298,6 +299,10 @@ class JavaDetector(AbstractDetector):
             frameworks.append(FrameworkDetection(name="Jakarta EE", source=source))
         if "mybatis" in text:
             frameworks.append(FrameworkDetection(name="MyBatis", source=source))
+        if "thymeleaf" in text:
+            frameworks.append(FrameworkDetection(name="Thymeleaf", source=source))
+        if "freemarker" in text:
+            frameworks.append(FrameworkDetection(name="FreeMarker", source=source))
         if "spring-boot-starter-security" in text or "spring-security-core" in text:
             frameworks.append(FrameworkDetection(name="Spring Security", source=source))
         if "spring-boot-starter-data-jpa" in text or "spring-data-jpa" in text:
@@ -470,7 +475,7 @@ class JavaDetector(AbstractDetector):
                 path=rel_path, stack="java", kind="exception_handler",
                 source="annotation", confidence="medium",
             )]
-        if _MVC_CONTROLLER_RE.search(content) and _REQUEST_MAPPING_RE.search(content):
+        if _MVC_CONTROLLER_RE.search(content) and _ANY_MAPPING_RE.search(content):
             http_path_match = _HTTP_PATH_RE.search(content)
             http_path = http_path_match.group(1) if http_path_match else None
             verb_match = _REQUEST_METHOD_VERB_RE.search(content)

sourcecode/license.py

@@ -3,7 +3,7 @@
 Flow:
   1. Module imported → _init() loads ~/.sourcecode/license.json (if present)
   2. is_pro set globally (True when plan == "pro")
-  3. Pro commands call require_pro(feature_name) at entry — exits 1 if not Pro
+  3. Pro commands call require_feature(feature_name) at entry — exits 1 if not Pro
   4. `sourcecode activate <key>` calls activate_license(key) — validates via
      Edge Function, writes ~/.sourcecode/license.json, exits 0 on success
   5. Cached license is re-validated every 24 h (online); network errors keep
@@ -38,6 +38,53 @@ _LICENSE_DIR: Path = Path.home() / ".sourcecode"
 _LICENSE_FILE: Path = _LICENSE_DIR / "license.json"
 _CACHE_TTL_SECONDS: int = 86400  # 24 hours
 
+# ---------------------------------------------------------------------------
+# Per-feature descriptions for upgrade UX
+# ---------------------------------------------------------------------------
+_FEATURE_INFO: dict[str, dict[str, str]] = {
+    "impact": {
+        "display": "impact",
+        "description": (
+            "Shows blast radius, callers, affected endpoints, and persistence paths in one call."
+        ),
+        "value": "Answers: what breaks if I touch this? The core risk signal before any change.",
+    },
+    "modernize": {
+        "display": "modernize (full)",
+        "description": (
+            "Full analysis: dead zones, refactor candidates, dependency tangles, and coupling ranked by git churn."
+        ),
+        "value": "Prioritizes where to refactor and what is safe to touch.",
+    },
+    "fix-bug": {
+        "display": "fix-bug (full)",
+        "description": "Complete risk-ranked file list with all annotation and structural signals.",
+        "value": "More results means less time scanning the codebase manually.",
+    },
+    "review-pr": {
+        "display": "review-pr (expanded)",
+        "description": "Full PR review: blast radius, all execution paths, security and transaction impact.",
+        "value": "CI-grade review — the complete picture before merging.",
+    },
+    "delta": {
+        "display": "prepare-context delta",
+        "description": "Incremental context: git-changed files with impact propagation.",
+        "value": "Designed for CI/CD pipelines — runs on every PR, flags risk automatically.",
+    },
+    "generate-tests": {
+        "display": "prepare-context generate-tests",
+        "description": "Test gap analysis: finds untested files with coverage recommendations.",
+        "value": "Reduces test debt systematically across the entire codebase.",
+    },
+    "--full": {
+        "display": "--full flag",
+        "description": (
+            "Removes truncation limits on transactional boundaries, DTO mappers, and large result sets."
+        ),
+        "value": "Essential for complete analysis of enterprise-scale codebases.",
+    },
+}
+
 # ---------------------------------------------------------------------------
 # Global license state — loaded once at import time
 # ---------------------------------------------------------------------------
@@ -147,30 +194,74 @@ _init()
 
 
 # ---------------------------------------------------------------------------
-# Enforcement
+# Entitlement helpers
 # ---------------------------------------------------------------------------
 
-def require_pro(feature_name: str) -> None:
-    """Exit with structured JSON error when not Pro.
+def can_use(feature_name: str) -> bool:
+    """Return True if the current plan has access to feature_name.
+
+    Does not trigger revalidation — use require_feature() at command entry
+    points where you want revalidation + gating in one call.
+    """
+    return is_pro
+
+
+def require_feature(feature_name: str) -> None:
+    """Exit with a clean upgrade prompt when feature_name requires Pro.
 
     Re-validates stale cached license before gating (once per 24 h, online).
 
+    Writes human-readable context to stderr (terminal UX) and a JSON error
+    to stdout (backward-compatible machine-readable format).
+
+    Example:
+        from sourcecode.license import require_feature
+        require_feature("impact")
+    """
+    _maybe_revalidate()
+
+    if is_pro:
+        return
+
+    info = _FEATURE_INFO.get(feature_name, {})
+    display = info.get("display", feature_name)
+    description = info.get("description", "")
+    value = info.get("value", "")
+
+    # Human-readable upgrade prompt on stderr
+    lines = [f"\n  '{display}' is a Pro feature."]
+    if description:
+        lines.append(f"  {description}")
+    if value:
+        lines.append(f"  {value}")
+    lines.append("")
+    lines.append("  Upgrade:  sourcecode activate <license_key>")
+    lines.append("")
+    sys.stderr.write("\n".join(lines) + "\n")
+    sys.stderr.flush()
+
+    # JSON on stdout — backward-compatible for CI / MCP consumers
+    payload = {
+        "error": "pro_required",
+        "feature": feature_name,
+        "message": (
+            f"'{display}' requires a Pro license. "
+            "Run: sourcecode activate <license_key>"
+        ),
+    }
+    sys.stdout.write(json.dumps(payload, ensure_ascii=False) + "\n")
+    sys.stdout.flush()
+    sys.exit(1)
+
+
+def require_pro(feature_name: str) -> None:
+    """Backward-compatible alias for require_feature.
+
     Example:
         from sourcecode.license import require_pro
         require_pro("impact")
     """
-    if is_pro:
-        _maybe_revalidate()
-
-    if not is_pro:
-        payload = {
-            "error": "pro_required",
-            "feature": feature_name,
-            "message": "Run: sourcecode activate <license_key>",
-        }
-        sys.stdout.write(json.dumps(payload, ensure_ascii=False) + "\n")
-        sys.stdout.flush()
-        sys.exit(1)
+    require_feature(feature_name)
 
 
 # ---------------------------------------------------------------------------

sourcecode/prepare_context.py

@@ -981,12 +981,18 @@ class TaskContextBuilder:
 
             dep_records, dep_summary = DependencyAnalyzer().analyze(self.root)
             primary_eco = stacks[0].stack if stacks else ""
-            direct = [
+            _direct_raw = [
                 d for d in dep_records
                 if d.scope != "transitive" and d.source in {"manifest", "lockfile"}
                 and (d.role or "unknown") in {"runtime", "parsing", "serialization", "observability", "infra"}
                 and d.scope not in {"dev"}
             ]
+            _seen_dep: set[str] = set()
+            direct = []
+            for _d in _direct_raw:
+                if _d.name not in _seen_dep:
+                    _seen_dep.add(_d.name)
+                    direct.append(_d)
             # Rank by framework centrality: core infra (ORM, Spring) > serialization > other.
             # Penalise vendored tooling (closure-compiler, shaded utilities) so that
             # Hibernate/JPA/Solr appear before minor build-time dependencies.

sourcecode/repository_ir.py

@@ -1697,6 +1697,9 @@ def _canonical_subsystem_pkg(fqn: str) -> str:
     (even if uppercase) to force at least 2-segment grouping.
     """
     _TOP_LEVEL = {"com", "org", "net", "io", "java", "javax"}
+    # Well-known framework namespaces that are not application boundaries;
+    # go one level deeper (depth 5) so callers get the actual app module.
+    _FRAMEWORK_NS = {"springframework", "apache", "eclipse", "google", "jetbrains"}
     parts: list[str] = []
     for segment in fqn.split("."):
         if "#" in segment or (segment and segment[0].isupper()):
@@ -1705,6 +1708,8 @@ def _canonical_subsystem_pkg(fqn: str) -> str:
     if not parts:
         return fqn.rsplit(".", 1)[0] if "." in fqn else fqn
     if parts[0] in _TOP_LEVEL and len(parts) >= 3:
+        if len(parts) >= 5 and len(parts) > 3 and parts[1] in _FRAMEWORK_NS:
+            return ".".join(parts[:5])
         return ".".join(parts[:3])
     # Prevent bare TLD collapse: "org" or "com" alone as subsystem key is meaningless
     # and groups ALL classes under that TLD into a single giant component.
@@ -3338,7 +3343,7 @@ def compute_blast_radius(
             _seen_mapper_fqns.add(fqn)
             _mapper_entry: dict = {
                 "fqn": fqn,
-                "role": role or "mapper",
+                "role": role or ("mapper" if symbol_kind == "mapper_interface" else "repository"),
                 "source_file": node_dict.get("source_file") or "",
             }
             if canonical != fqn:

sourcecode/summarizer.py

@@ -279,6 +279,7 @@ class ProjectSummarizer:
     _TYPE_LABELS: dict[str, str] = {
         "cli": "CLI",
         "api": "API",
+        "web_mvc": "Spring MVC web app",
         "webapp": "Web application",
         "library": "Library",
         "monorepo": "Monorepo",

{sourcecode-1.31.32.dist-info → sourcecode-1.32.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.31.32
+Version: 1.32.1
 Summary: Deterministic codebase context for AI coding agents
 License:                                  Apache License
                                    Version 2.0, January 2004
@@ -225,7 +225,7 @@ Description-Content-Type: text/markdown
 
 **AI-ready change intelligence for Java/Spring enterprise monoliths.**
 
-![Version](https://img.shields.io/badge/version-1.31.32-blue)
+![Version](https://img.shields.io/badge/version-1.32.0-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -263,7 +263,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.31.32
+# sourcecode 1.32.0
 ```
 
 ---

{sourcecode-1.31.32.dist-info → sourcecode-1.32.1.dist-info}/RECORD

@@ -1,20 +1,20 @@
-sourcecode/__init__.py,sha256=FAgcPCebMe_1K921d8TjlfM7T_GMcbLwHvBZvp_uat8,104
+sourcecode/__init__.py,sha256=fI8Cp1YcT6ueuKNKvHveO2gFDtDkSHrDE6DpgADO1i8,103
 sourcecode/adaptive_scanner.py,sha256=XffluXKzJUXrMtjEiAOnSNPZnztdIcts17T9ouHeID0,10521
-sourcecode/architecture_analyzer.py,sha256=Ry3aYT9dc7XuLmWLT5IZ93RkCf_P14Qtew0nGPvUl_8,42184
+sourcecode/architecture_analyzer.py,sha256=qh749a7ykPtGmQI1MR9y6j8TtL_jBdVYFx9YRsLqOMw,44121
 sourcecode/architecture_summary.py,sha256=z34_6v7cSwy98cof2UVciGho7SCrZ93tiqMmq5WNzRQ,20405
 sourcecode/ast_extractor.py,sha256=_btmeOJIe3t-NicF94D5ZAesa2YIJ0_QNExGnbHxGFE,50578
 sourcecode/cache.py,sha256=pBrPdpPrOgpXHHQO670U3aUfVf5N3A3obsTKgiZtN4I,23030
 sourcecode/canonical_ir.py,sha256=_HM3AUmKSdna9u4dCoU6rpgSA6HdF8gzOKZykIUCNGY,23277
-sourcecode/classifier.py,sha256=yWeq6agTjkFa3zuNa-gdVIHtjoBoPoVlJnX-b7tdVJs,7851
-sourcecode/cli.py,sha256=7tkUpZEnXjU_swX1wadkMnfYS0A0p0NvSRZEBIOLLi0,161521
+sourcecode/classifier.py,sha256=2lYoSH3vOTkXZYPU7Go2WIet1-IuNzTWVhc-ULnXtgw,8024
+sourcecode/cli.py,sha256=xV3CKxTAzc1tcEJ6-lfGCuYlBWdLQgxv1-thMzQ3cpk,163863
 sourcecode/code_notes_analyzer.py,sha256=EJemNCNc9Dn-1RZYu-aNbK0ELzmsyC4s6FdHi3XyNEI,9392
 sourcecode/confidence_analyzer.py,sha256=_jckZSxksV-OU38vbkxfVNBnWCtlCq8Vwfg23x1uspA,19054
 sourcecode/context_scorer.py,sha256=QpChSpsmaAYz91rXA4Ue5xzQmNz_ZboZN09YOHScq1U,14679
-sourcecode/context_summarizer.py,sha256=CiQrfBEzun949bWvmLabWoj2HhPn6Lw62ofqnsy0FlQ,6503
+sourcecode/context_summarizer.py,sha256=zlbm8ytdvJToohU108-dwBmEl52xl0gXpf6PZBOW_2A,6540
 sourcecode/contract_model.py,sha256=nRxJKPMs1VHwFTa8AVXhGmaLjti3Lr2sjHDpWgv1bfE,3917
 sourcecode/contract_pipeline.py,sha256=gvTdDniedm_mjq4vaHqnBY2UkQ0s00gtXqzTLILNXHc,28719
 sourcecode/coverage_parser.py,sha256=q0LeZJaX1bnntLu-ImksdBsMlpsVmk_iUfSaB4eaJGo,19702
-sourcecode/dependency_analyzer.py,sha256=Po7GKJnClCkXty0np1B4F1zo_bPeKAtgbehazhXuaBM,56493
+sourcecode/dependency_analyzer.py,sha256=wE7IgXOepfagGdRJX4-u5mhps_kfR2njz2RFgPikFFY,56491
 sourcecode/doc_analyzer.py,sha256=05bjTUbDbmnbajD_cgRnACzS8T7xxBKVX4CjkJlhZg8,24411
 sourcecode/entrypoint_classifier.py,sha256=MTa7yqbeuJ9XPbGCPuvtR9IqY-SN3hoXXyVtb3iXDhs,4316
 sourcecode/env_analyzer.py,sha256=9_q_U_Q1tjiY5FSaeEImSDgToP2uHGrjBAFF7ihJn2I,22204
@@ -22,25 +22,25 @@ sourcecode/file_classifier.py,sha256=QrYm7MlG29HQdAR1WOfpnIIBysAz62c5coz9eQ76meo
 sourcecode/flow_analyzer.py,sha256=dSiuY4w49k29jW_EPXUOND9B5uVbuCA7kjnuHi-pIWA,28781
 sourcecode/git_analyzer.py,sha256=JStxTQXNjBWi_wLdwhsZs9mT-v50cSJIz4Agzn6Kh9I,13362
 sourcecode/graph_analyzer.py,sha256=iUK-7pSV-cvGqqD2hENdYmhnm0wcXFEyK-xnu5ul8OU,62515
-sourcecode/license.py,sha256=oiAxBXHf1mz42rrDKQCPX28W2yaAHvWqaVZuijJGSF8,7902
+sourcecode/license.py,sha256=m5n4PKZ7ZZZ17bpLjIsKwd94PXaIg5iS_2kFNjCV2Og,11378
 sourcecode/mcp_nudge.py,sha256=5ELU_ixzh6uA83NXLOZT8h00OhL53okfQdji3jyKOjg,2917
 sourcecode/metrics_analyzer.py,sha256=m0ENgtqKeBL17kUIK3fmGkgo7UfXBNHxCMj0H_Y5K7c,22750
 sourcecode/output_budget.py,sha256=43307mJEyUPU3MI-QEQoVxrcAvNyUzdzF_SAPgisBQE,6603
 sourcecode/path_filters.py,sha256=ROFRQ8eSLBEMiixK9f45-RO7um4VEEcjoD5AA4I427I,3739
 sourcecode/pr_comment_renderer.py,sha256=smHslxiG14lrytCkq5nFrFu-qTHgA-t-LFYfdrfjz2o,14423
-sourcecode/prepare_context.py,sha256=RM7ka0rduJy8kwGHzLU9if6q7D9ST7tGjOf5LnsdTuw,201451
+sourcecode/prepare_context.py,sha256=TFg8GDJ8kotJtR4rOTAvwQGVNSj0x-Usamy-mtjxeqs,201681
 sourcecode/progress.py,sha256=qn30sWaHOkjTgXsSBmiPkz7Rsbwc5oSlIe6JNEMYp_k,3149
 sourcecode/ranking_engine.py,sha256=ZAucq_YX2KkWUuAZf4P0lhtQ_38vEFnUhuGtSZd1S0E,12970
 sourcecode/redactor.py,sha256=SB4hwIvg8h-hvcqKcDWaZvA-aSyn-at-BIRwa0tUv5E,3227
 sourcecode/relevance_scorer.py,sha256=MYF4FFkveAQps9SmTeTlh6ODiBz2F--_hWNeHMLtUHQ,8405
 sourcecode/repo_classifier.py,sha256=FG1vaWKdWXsWdl-S8hjVMiTqcwgaRXkDyvK4rPcOGtQ,22681
-sourcecode/repository_ir.py,sha256=rga0I9L0K-3kSMTF8R8slBH4Fkwwrh-ut4Y3h6GxLvY,152757
+sourcecode/repository_ir.py,sha256=-NjBQUT7zyya4ng8Hq0-ChoiHZkUif9lr-Q878gmj8M,153163
 sourcecode/runtime_classifier.py,sha256=uTAD6BDCiBLUZEDRfqk718kM4RTT_vAbfkcOI2_Xx58,18432
 sourcecode/scanner.py,sha256=WdOQ78mMzjR1NjmKTlbxdgwinnCTfAhxCVLBEFQiFHU,8899
 sourcecode/schema.py,sha256=aHNXDf8LGyUC8ZDE_VS9kiskC2-Oswhi_WnpdGy6HDw,24897
 sourcecode/semantic_analyzer.py,sha256=TDuC3wzZR2DPm1mgrAg1YSLk2QzJoueS3TZAmyGGpCU,89417
 sourcecode/serializer.py,sha256=3JBvsMDj5pt1RXpi1zJpk5DGWUKbeb2Jl622-kmYWD4,123312
-sourcecode/summarizer.py,sha256=BMHJA0Do4rBnabc1_BxHoETTNb5ew0VqCX_eY3_PdCg,20706
+sourcecode/summarizer.py,sha256=YspHEVeYJVmltq0FMtGZF8kIP3qiR2KLcanGL6Y7uTI,20747
 sourcecode/tree_utils.py,sha256=8GAkIfQAsvtEudIeW1l4ooH_oRtrWR8cpJQJsEa_Pfw,2093
 sourcecode/workspace.py,sha256=X_6NmNnitvT3_38V-JDChydo_sR68s249hLFlrQskU0,8271
 sourcecode/detectors/__init__.py,sha256=A0AACJFF6HWf_RgatNtWu3PUzstcKtIGM9f1PoFcJug,1987
@@ -52,7 +52,7 @@ sourcecode/detectors/elixir.py,sha256=jCpvt5Yi6jvplc80ovRtWh17q-11ZGo9qX7o8b57TJ
 sourcecode/detectors/go.py,sha256=2r66uRQfeTWsqxr4HDhT6vExZErby0t46QXLHVBRv9w,2782
 sourcecode/detectors/heuristic.py,sha256=7cRxrip4yIaggYzZJB6ef8yHKh-gHgiH_pXMFcjlyFU,3723
 sourcecode/detectors/hybrid.py,sha256=IGFRUVsAZ1ooRlFdznCeJAV6vy1yVDx-VyghvLtddXc,9101
-sourcecode/detectors/java.py,sha256=YmmbRChVt_E4yTLfz3jzdNtbCtyQGS4RD7Xt95_rtdg,28979
+sourcecode/detectors/java.py,sha256=BMdDLBe6vzMa8dqNc8cZ6An0OpQmW5oWcJ02ULzHC_Q,29288
 sourcecode/detectors/jvm_ext.py,sha256=EgHJ5W8EE-ZTN9V607mVzohyKgZE8Mc2jCi-DF8RAZU,2616
 sourcecode/detectors/nodejs.py,sha256=Hg3Gmr7yIMJFiLoDwOTk2wtu00wxIs6kZf-oQujTFUA,13187
 sourcecode/detectors/parsers.py,sha256=ugPg8yNUf0Ai1gA7Fnn6wAkYGFjTxRodSP3IeViYJJ4,2290
@@ -78,8 +78,8 @@ sourcecode/telemetry/consent.py,sha256=wLMvGNJeSSyZoNkQXpoUioY6mMv4Qdvuw7S9jAEWn
 sourcecode/telemetry/events.py,sha256=oEvvulfsv5GIDWG2174gSS6tNB95w38AIYiYeifGKlE,2294
 sourcecode/telemetry/filters.py,sha256=Asa71oRl7q3Wt_FMwuufIZJFzSYdgRNKS8LHCIyFeYE,4805
 sourcecode/telemetry/transport.py,sha256=KJeIPCPWMdmbCP3ySGs2iUlia34U6vWne2dZsUezesw,1560
-sourcecode-1.31.32.dist-info/METADATA,sha256=69Ai2xiH7kn4Zmsm-KhGAfTTXtUbmyyy9EgLSSQ9GU4,31103
-sourcecode-1.31.32.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-1.31.32.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
-sourcecode-1.31.32.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-1.31.32.dist-info/RECORD,,
+sourcecode-1.32.1.dist-info/METADATA,sha256=llWp2sPfqGuDQXERl94vF19Sxpktl_zPUyDNDwT4ORM,31100
+sourcecode-1.32.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-1.32.1.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
+sourcecode-1.32.1.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-1.32.1.dist-info/RECORD,,