sourcecode 1.31.6__py3-none-any.whl → 1.31.7__py3-none-any.whl

sourcecode/__init__.py

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

sourcecode/cli.py

@@ -2495,6 +2495,10 @@ def _extract_java_endpoints(root: "Path") -> "dict[str, Any]":
 
     endpoints: list[dict] = []
     seen: set[tuple] = set()
+    # Fix 1: inheritance projection — tracks class data so controllers with ONLY
+    # inherited endpoints (no own @RequestMapping methods) are not silently dropped.
+    _class_info: dict[str, dict] = {}
+    _EXTENDS_RE_LOCAL = _re.compile(r'\bextends\s+(\w+)')
 
     from sourcecode.path_filters import is_test_path as _is_test_path
 
@@ -2579,14 +2583,18 @@ def _extract_java_endpoints(root: "Path") -> "dict[str, Any]":
         # Extract class-level base path and locate class body start
         lines = content.splitlines()
 
-        # First pass: find class/interface declaration line index
+        # First pass: find class/interface declaration line index and extends clause.
         class_body_start = 0
+        extends_class_name: Optional[str] = None
         for i, line in enumerate(lines):
             stripped_l = line.strip()
             if (not stripped_l.startswith("//") and not stripped_l.startswith("*")
                     and ("class " in stripped_l or "interface " in stripped_l)
                     and _CLASS_RE.search(stripped_l)):
                 class_body_start = i + 1
+                _ext_m = _EXTENDS_RE_LOCAL.search(stripped_l)
+                if _ext_m:
+                    extends_class_name = _ext_m.group(1)
                 break
 
         # Second pass: extract class-level @RequestMapping path (only before class body).
@@ -2656,6 +2664,7 @@ def _extract_java_endpoints(root: "Path") -> "dict[str, Any]":
         pending_annotations: list[tuple[str, str]] = []  # (http_verb, path_suffix)
         pending_filtro: Optional[str] = None
         in_block_comment = False
+        file_own_endpoints: list[tuple] = []  # (http_verb, path_suffix, handler, filtro)
 
         for i in range(class_body_start, len(lines)):
             line = lines[i]
@@ -2708,6 +2717,7 @@ def _extract_java_endpoints(root: "Path") -> "dict[str, Any]":
                 handler = mm.group(1) if mm else ""
                 if handler and not handler.startswith("class"):
                     for http_verb, path_suffix in pending_annotations:
+                        file_own_endpoints.append((http_verb, path_suffix, handler, pending_filtro))
                         for _cb in class_bases:  # Bug #1B: one endpoint per class prefix
                             full_path = (_cb + "/" + path_suffix).replace("//", "/").rstrip("/") or "/"
                             if not full_path.startswith("/"):
@@ -2733,6 +2743,50 @@ def _extract_java_endpoints(root: "Path") -> "dict[str, Any]":
                 pending_annotations = []
                 pending_filtro = None
 
+        # Store per-class data for inheritance projection
+        _class_info[class_name] = {
+            "base_paths": class_bases,
+            "extends_class": extends_class_name,
+            "own_endpoints": file_own_endpoints,
+        }
+
+    # Fix 1: Inheritance projection — controllers whose methods are 100% inherited from a
+    # base class emit 0 endpoints above because no method-level annotations exist in their
+    # file. Walk the inheritance chain and project parent suffixes with the child's base path.
+    for _cls, _data in _class_info.items():
+        if _data["own_endpoints"]:
+            continue
+        _bases = _data["base_paths"]
+        if not _bases or _bases == [""]:
+            continue
+        _chain = _data.get("extends_class")
+        _visited: set[str] = {_cls}
+        while _chain and _chain not in _visited:
+            _visited.add(_chain)
+            _parent = _class_info.get(_chain)
+            if not _parent:
+                break
+            if _parent["own_endpoints"]:
+                for _verb, _suffix, _handler, _filtro in _parent["own_endpoints"]:
+                    for _cb in _bases:
+                        _fp = (_cb + "/" + _suffix).replace("//", "/").rstrip("/") or "/"
+                        if not _fp.startswith("/"):
+                            _fp = "/" + _fp
+                        _key = (_cls, _handler, _verb, _cb)
+                        if _key not in seen:
+                            seen.add(_key)
+                            _entry: dict[str, Any] = {
+                                "method": _verb,
+                                "path": _fp,
+                                "controller": _cls,
+                                "handler": _handler,
+                            }
+                            if _filtro:
+                                _entry["required_permission"] = _filtro
+                            endpoints.append(_entry)
+                break
+            _chain = _parent.get("extends_class")
+
     endpoints.sort(key=lambda e: (e.get("controller", ""), e.get("path", "")))
     undocumented = sum(1 for e in endpoints if "required_permission" not in e)
 

sourcecode/repository_ir.py

@@ -178,8 +178,11 @@ _SPRING_OTHER: frozenset[str] = frozenset({
     "@PutMapping", "@DeleteMapping", "@PatchMapping", "@Autowired",
     "@Inject", "@Value", "@Qualifier", "@EnableWebSecurity",
     "@SpringBootApplication", "@EnableAutoConfiguration",
+    "@EventListener", "@Async", "@Scheduled", "@Cacheable", "@CacheEvict",
 })
 
+_PUBLISH_EVENT_RE = re.compile(r'\.publishEvent\s*\(\s*new\s+(\w+)\s*[(\{]')
+
 _HTTP_METHOD_MAP: dict[str, str] = {
     "@GetMapping": "GET",
     "@PostMapping": "POST",
@@ -787,6 +790,33 @@ def _build_relations(
                     evidence={"type": "structural", "value": f"member of {enclosing}"},
                 ))
 
+    # Fix 5: Event flow edges — publishEvent publishers and @EventListener subscribers.
+    # listens_to_event: method with @EventListener → resolved event parameter type(s).
+    for sym in symbols:
+        if sym.type == "method" and "@EventListener" in sym.annotations:
+            for imp_fqn in sym.imports_used:
+                edges.append(RelationEdge(
+                    from_symbol=sym.symbol,
+                    to_symbol=imp_fqn,
+                    type="listens_to_event",
+                    confidence="high",
+                    evidence={"type": "annotation", "value": "@EventListener"},
+                ))
+
+    # publishes_event: class that calls publishEvent(new XxxEvent(...)) → event type FQN.
+    _class_syms = [s for s in symbols if s.type in ("class", "interface") and "#" not in s.symbol]
+    for m in _PUBLISH_EVENT_RE.finditer(source):
+        event_simple = m.group(1)
+        event_fqn = import_map.get(event_simple, event_simple)
+        for cls_sym in _class_syms:
+            edges.append(RelationEdge(
+                from_symbol=cls_sym.symbol,
+                to_symbol=event_fqn,
+                type="publishes_event",
+                confidence="medium",
+                evidence={"type": "method_call", "value": f"publishEvent(new {event_simple})"},
+            ))
+
     seen: set[tuple[str, str, str]] = set()
     unique: list[RelationEdge] = []
     for e in edges:
@@ -1190,6 +1220,8 @@ _EDGE_REASON_TEMPLATES: dict[str, str] = {
     "contained_in": "{from_sym} is a member of {to_sym}",
     "annotated_with": "{from_sym} is annotated with {to_sym}",
     "mapped_to": "Route {to_sym} depends on {from_sym}",
+    "publishes_event": "{from_sym} publishes event {to_sym}",
+    "listens_to_event": "{from_sym} listens for event {to_sym}",
 }
 
 # Edge types to exclude from reverse impact traversal (too noisy / non-dependency semantics)
@@ -1526,13 +1558,43 @@ def _assemble(
         },
         "subsystems": subsystems,
         "change_set": change_set_out,
-        "route_surface": route_diffs or [],
+        "route_surface": _build_route_surface(sorted_syms, route_diffs),
         "audit": {
             "dropped_fields": dropped_fields,
         },
     }
 
 
+# ---------------------------------------------------------------------------
+# Route surface helper (Fix 4)
+# ---------------------------------------------------------------------------
+
+def _build_route_surface(symbols: list[SymbolRecord], route_diffs: Optional[list[dict]]) -> list[dict]:
+    """Return route surface: diffs when --since provided, else static snapshot of all endpoints."""
+    if route_diffs:
+        return route_diffs
+    routes: list[dict] = []
+    for sym in symbols:
+        if sym.symbol_kind != "endpoint":
+            continue
+        ann_name = next((a for a in sym.annotations if a in _ENDPOINT_ANNOTATIONS), None)
+        if not ann_name:
+            continue
+        args = sym.annotation_values.get(ann_name, "")
+        path = _parse_route_path(args)
+        method = _parse_route_http_method(ann_name, args)
+        if not path and not method:
+            continue
+        routes.append({
+            "symbol": sym.symbol,
+            "controller": _enclosing_class(sym.symbol),
+            "path": path,
+            "method": method or "GET",
+            "stable_id": sym.stable_id,
+        })
+    return sorted(routes, key=lambda r: (r["controller"], r["path"]))
+
+
 # ---------------------------------------------------------------------------
 # Public API
 # ---------------------------------------------------------------------------
@@ -1675,7 +1737,17 @@ def apply_ir_size_limits(
                 "remove --summary-only to restore full graph"
             ),
         }
-        out["reverse_graph"] = {}
+        # Fix 3: keep bounded reverse graph instead of wiping it.
+        full_rg: dict = ir.get("reverse_graph") or {}
+        if full_rg:
+            _rg_sorted = sorted(
+                full_rg.items(),
+                key=lambda x: sum(len(v) for v in x[1].values()),
+                reverse=True,
+            )
+            out["reverse_graph"] = dict(_rg_sorted[:50])
+        else:
+            out["reverse_graph"] = {}
         out["impact"] = {
             "global_score": (ir.get("impact") or {}).get("global_score", 0),
             "ranked_nodes": ranked[:20],
@@ -1703,10 +1775,19 @@ def apply_ir_size_limits(
 
     if kept_fqns is not None or max_edges is not None:
         if kept_fqns is not None:
-            # Priority: edges where both endpoints are kept nodes
-            priority = [e for e in edges if e["from"] in kept_fqns and e["to"] in kept_fqns]
-            rest = [e for e in edges if not (e["from"] in kept_fqns and e["to"] in kept_fqns)]
-            edges = priority + rest
+            # Fix 2: type-aware priority so semantic edges survive node truncation.
+            # Annotation strings (@Service etc.) and field FQNs are never in kept_fqns,
+            # so "both endpoints kept" drops all injects/annotated_with edges.
+            _SEMANTIC_TYPES = frozenset({"extends", "implements", "injects",
+                                         "publishes_event", "listens_to_event"})
+            _ANNOTATION_TYPES = frozenset({"annotated_with"})
+            tier1 = [e for e in edges if e["from"] in kept_fqns and e["type"] in _SEMANTIC_TYPES]
+            tier2 = [e for e in edges if e["from"] in kept_fqns and e["type"] in _ANNOTATION_TYPES]
+            tier3 = [e for e in edges
+                     if e["from"] in kept_fqns and e["to"] in kept_fqns and e["type"] == "imports"]
+            _seen_e = {(e["from"], e["to"], e["type"]) for e in tier1 + tier2 + tier3}
+            tier4 = [e for e in edges if (e["from"], e["to"], e["type"]) not in _seen_e]
+            edges = tier1 + tier2 + tier3 + tier4
         if max_edges is not None:
             edges = edges[:max_edges]
 

{sourcecode-1.31.6.dist-info → sourcecode-1.31.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.31.6
+Version: 1.31.7
 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
 
 **Deterministic, behavior-aware codebase context for AI agents and PR review.**
 
-![Version](https://img.shields.io/badge/version-1.31.6-blue)
+![Version](https://img.shields.io/badge/version-1.31.7-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -261,7 +261,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.31.6
+# sourcecode 1.31.7
 ```
 
 ---

{sourcecode-1.31.6.dist-info → sourcecode-1.31.7.dist-info}/RECORD

@@ -1,10 +1,10 @@
-sourcecode/__init__.py,sha256=YtkXxLCwI2P3youz8qWDCC8rLLuveg8_p3Rw5TwvrXs,103
+sourcecode/__init__.py,sha256=8R-nJsTbK4mRxB0Ix8W0xEdhYCBpK8R-2dyS_nBxiDc,103
 sourcecode/adaptive_scanner.py,sha256=XffluXKzJUXrMtjEiAOnSNPZnztdIcts17T9ouHeID0,10521
 sourcecode/architecture_analyzer.py,sha256=MyBa0Hf5HmkudZQDLKrjcWDKETXETXl0mQX1swtTwAA,39091
 sourcecode/architecture_summary.py,sha256=z34_6v7cSwy98cof2UVciGho7SCrZ93tiqMmq5WNzRQ,20405
 sourcecode/ast_extractor.py,sha256=XgrZg2DcWcUm9r87cRG3KGO7IK2TIL_N-CvhSbUmmh4,49901
 sourcecode/classifier.py,sha256=-0t0HLc9L9UleMLfclfLM3AXhBjUb_AYyBPDbvgWtac,7755
-sourcecode/cli.py,sha256=lAqlKvLs3nrHKCM6RfsvQr1O_jWi3WOcdjhhlE8fmyg,129082
+sourcecode/cli.py,sha256=L0KDRruMogpw9kq7trZ7dmWQuFC746GIEN1oym6LmCE,131802
 sourcecode/code_notes_analyzer.py,sha256=EJemNCNc9Dn-1RZYu-aNbK0ELzmsyC4s6FdHi3XyNEI,9392
 sourcecode/confidence_analyzer.py,sha256=ZUn-Nywi5TEQcuozqK_vfOyPT-a1dYYO42elAtVFV-k,16412
 sourcecode/context_scorer.py,sha256=QpChSpsmaAYz91rXA4Ue5xzQmNz_ZboZN09YOHScq1U,14679
@@ -29,7 +29,7 @@ sourcecode/ranking_engine.py,sha256=ZAucq_YX2KkWUuAZf4P0lhtQ_38vEFnUhuGtSZd1S0E,
 sourcecode/redactor.py,sha256=xuGcadGEHaPw4qZXlMDvzMCsr4VOkdp3oBQptHyJk8c,2884
 sourcecode/relevance_scorer.py,sha256=MYF4FFkveAQps9SmTeTlh6ODiBz2F--_hWNeHMLtUHQ,8405
 sourcecode/repo_classifier.py,sha256=FG1vaWKdWXsWdl-S8hjVMiTqcwgaRXkDyvK4rPcOGtQ,22681
-sourcecode/repository_ir.py,sha256=KH5EehbjOh8ZwwTHcbzrAHiKDoquO49wgSvCX4bVq5k,64391
+sourcecode/repository_ir.py,sha256=fLt33wadCMY77jd34YwkYbUT5TyNu2G0LX0x76Krsvo,68348
 sourcecode/runtime_classifier.py,sha256=zWX3r3HCKHc-qtIobErOa8aKMmaoPYREtJKvPcBGPjQ,14792
 sourcecode/scanner.py,sha256=WdOQ78mMzjR1NjmKTlbxdgwinnCTfAhxCVLBEFQiFHU,8899
 sourcecode/schema.py,sha256=fj3BZ3IcnNV4j21BFIEvz8Qnw_vZoqIbzzRg-qQ-nd0,24530
@@ -73,8 +73,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.6.dist-info/METADATA,sha256=aKMdH4KYx2KrZ1rx8Ylo73TwfocQ5szGN1U3CDUn_tM,29083
-sourcecode-1.31.6.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-1.31.6.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
-sourcecode-1.31.6.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-1.31.6.dist-info/RECORD,,
+sourcecode-1.31.7.dist-info/METADATA,sha256=O08_eBOxRxeDd8UkUKyIrW6haJHuQvAddgiFAEma0dQ,29083
+sourcecode-1.31.7.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-1.31.7.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
+sourcecode-1.31.7.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-1.31.7.dist-info/RECORD,,