sourcecode 1.35.8__py3-none-any.whl → 1.35.10__py3-none-any.whl

sourcecode/__init__.py

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

sourcecode/file_classifier.py

@@ -83,18 +83,30 @@ _DEF_RE = re.compile(r"\b(class|def|function|const|export\s+class|interface|type
 _JAVA_ANNOTATION_RE = re.compile(
     r'@(RestController|Controller|Service|Repository|Mapper|Entity|Data|Configuration'
     r'|EnableWebSecurity|ControllerAdvice|Transactional'
+    r'|RequestMapping|GetMapping|PostMapping|PutMapping|DeleteMapping|PatchMapping'  # HTTP mappings
     r'|Path|Provider'  # JAX-RS
     r'|ApplicationScoped|RequestScoped|SessionScoped|Singleton|Dependent'  # CDI
     r'|Inject|Named'  # CDI DI
     r')\b'
 )
 
+# Handler-count regex — method-level only (Get/Post/Put/Delete/Patch, not class-level RequestMapping)
+_HANDLER_MAPPING_RE = re.compile(r'@(Get|Post|Put|Delete|Patch)Mapping\b')
+
 # (annotation_set, category, relevance, why_template)
 # Checked in priority order; first match wins.
+# @Controller rules use 0.80 base; _count_handlers() bonus in classify() differentiates
+# by HTTP handler count. @RestController stays at 0.90 (no boost — already high tier).
 _JAVA_STEREOTYPE_RULES: list[tuple[frozenset, str, float, str]] = [
     (frozenset({"EnableWebSecurity"}),               "security",          0.85, "Spring Security configuration"),
     (frozenset({"RestController"}),                  "api_endpoint",      0.90, "Spring REST controller — defines HTTP API surface"),
     (frozenset({"Controller", "RequestMapping"}),    "api_endpoint",      0.80, "Spring MVC controller"),
+    (frozenset({"Controller", "GetMapping"}),        "api_endpoint",      0.80, "Spring MVC controller"),
+    (frozenset({"Controller", "PostMapping"}),       "api_endpoint",      0.80, "Spring MVC controller"),
+    (frozenset({"Controller", "PutMapping"}),        "api_endpoint",      0.80, "Spring MVC controller"),
+    (frozenset({"Controller", "DeleteMapping"}),     "api_endpoint",      0.80, "Spring MVC controller"),
+    (frozenset({"Controller", "PatchMapping"}),      "api_endpoint",      0.80, "Spring MVC controller"),
+    (frozenset({"Controller"}),                      "api_endpoint",      0.72, "Spring MVC controller"),
     (frozenset({"ControllerAdvice"}),                "exception_handler", 0.75, "Spring @ControllerAdvice — cross-cutting exception handling"),
     # JAX-RS
     (frozenset({"Path"}),                            "api_endpoint",      0.85, "JAX-RS resource — defines REST endpoint surface"),
@@ -178,15 +190,27 @@ class FileClassifier:
         if norm in self.cli_entry_paths:
             return FileClassification(norm, "cli_entrypoint", "high", 1.0, "declared production CLI entrypoint", ["entry_points"])
 
-        if norm in self.production_entry_paths:
-            return FileClassification(norm, "runtime_core", "high", 0.95, "declared production runtime entrypoint", ["entry_points"])
-
-        # Java Spring stereotype detection (Java/Kotlin files only)
+        # Java Spring stereotype detection runs BEFORE the generic entrypoint fallback
+        # so that controllers and services keep their content-based category and relevance
+        # rather than collapsing to runtime_core/0.95 for every declared entry point.
         if suffix in {".java", ".kt"}:
             java_class = self._classify_java_stereotype(norm, content)
             if java_class is not None:
+                if java_class.category == "api_endpoint" and java_class.relevance < 0.85:
+                    # Boost @Controller-tier (base 0.72–0.80) by handler count so controllers
+                    # with more HTTP handlers rank above single-endpoint system controllers.
+                    # @RestController (0.90) and JAX-RS Path (0.85) are already high-tier — skip.
+                    h = self._count_handlers(content)
+                    if h > 0:
+                        bonus = min(h * 0.03, 0.12)
+                        java_class.relevance = round(min(0.95, java_class.relevance + bonus), 3)
+                if norm in self.production_entry_paths and "entry_points" not in java_class.evidence:
+                    java_class.evidence = list(java_class.evidence) + ["entry_points"]
                 return java_class
 
+        if norm in self.production_entry_paths:
+            return FileClassification(norm, "runtime_core", "high", 0.95, "declared production runtime entrypoint", ["entry_points"])
+
         # Fix 4: call _matched_imports once per category instead of twice
         # (_has_any_import was calling _matched_imports and discarding the result,
         # then the caller invoked it again to get the evidence — halving throughput).
@@ -262,6 +286,10 @@ class FileClassifier:
             return True
         return "@dataclass" in content or "pydantic" in content.lower()
 
+    def _count_handlers(self, content: str) -> int:
+        """Count method-level HTTP handler annotations as proxy for controller complexity."""
+        return len(_HANDLER_MAPPING_RE.findall(content))
+
     def _sample(self, imports: list[str]) -> list[str]:
         return [f"import:{imp}" for imp in imports[:4]]
 

sourcecode/mcp/registry.py

@@ -758,9 +758,17 @@ include_all: return full test_gaps list without truncating to top 20.
 Deterministic symbol-level IR summary for Java repositories. Java only.
 
 Maps to: sourcecode repo-ir <repo_path> --summary-only
-Returns: reverse_graph (top 10 hubs), route_surface (top 50 endpoints),
+Returns: reverse_graph, route_surface (top 50 endpoints),
          subsystems (top 15), impact, analysis. Full graph nodes/edges omitted.
 
+reverse_graph: dict[class_FQN → {"contained_in": [method_FQNs], ...}]
+  Top 10 most-referenced (highest in-degree) classes in the dependency graph.
+  Keys are fully-qualified class names. Iterate with:
+    for fqn, data in result["reverse_graph"].items(): ...
+route_surface: list of endpoint dicts (method, path, handler, security).
+subsystems: list of detected subsystem cluster dicts.
+analysis: metadata — total_classes, total_edges, analysis_ms.
+
 Output is bounded to ~100 KB for LLM safety. For full IR (can exceed 10 MB
 on large repos), use the CLI: sourcecode repo-ir <path> --output ir.json
 Use get_compact_context or get_agent_context for non-Java repos.
@@ -1234,6 +1242,9 @@ _MCP_HIDDEN_CANONICAL_TOOLS: frozenset[str] = frozenset({
     "telemetry_status",
     "telemetry_enable",
     "telemetry_disable",
+    # Human admin actions — not agent actions
+    "activate",    # Pro license key activation; human admin only, not an agent operation
+    "config",      # returns plain-text config dump (not JSON); version via `version`, telemetry via `telemetry`
 })
 
 

sourcecode/serializer.py

@@ -954,12 +954,19 @@ def _file_relevance(sm: SourceMap, *, limit: int = _FILE_RELEVANCE_LIMIT) -> lis
             runtime_impact, dep_centrality, fw_signal, change_sev, test_risk
         )
 
-        # T1 override: confirmed production entrypoints → 0.92–1.00.
-        # Only runtime_core / cli_entrypoint categories justify scores ≥ 0.92.
+        # T1 override: confirmed production entrypoints use content-evidence relevance as score.
+        # runtime_core/cli_entrypoint: 0.92 floor (bootstrap + non-Java entries).
+        # api_endpoint/security/exception_handler: stereotype relevance directly (0.70 floor)
+        # so that controllers differentiate by annotation table + handler-count bonus rather
+        # than collapsing to a flat 0.95.
         if path in entry_paths and cat in ("runtime_core", "cli_entrypoint"):
             score_val = round(
                 min(1.0, max(0.92, file_class.relevance if file_class else 0.92)), 3
             )
+        elif path in entry_paths and cat in ("api_endpoint", "security", "exception_handler"):
+            score_val = round(
+                min(1.0, max(0.70, file_class.relevance if file_class else 0.75)), 3
+            )
         else:
             score_val = round(formula_raw, 3)
 

{sourcecode-1.35.8.dist-info → sourcecode-1.35.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.35.8
+Version: 1.35.10
 Summary: Persistent structural context and ultra-fast repeated analysis for AI coding agents
 License-File: LICENSE
 Keywords: agents,ai,codebase,context,developer-tools,llm
@@ -39,7 +39,7 @@ Description-Content-Type: text/markdown
 
 **Persistent structural context and ultra-fast repeated analysis for AI coding agents.**
 
-![Version](https://img.shields.io/badge/version-1.35.5-blue)
+![Version](https://img.shields.io/badge/version-1.35.10-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -113,7 +113,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.35.5
+# sourcecode 1.35.10
 ```
 
 ---

{sourcecode-1.35.8.dist-info → sourcecode-1.35.10.dist-info}/RECORD

@@ -1,4 +1,4 @@
-sourcecode/__init__.py,sha256=4pSX2tiJdyiu03u0G_n4-Ww2ajE_E7piY8T-20n_IDM,103
+sourcecode/__init__.py,sha256=QOiKKrOaBjN4YCa2-cbvf5ufIHCdH1ihh91pDHwXH54,104
 sourcecode/adaptive_scanner.py,sha256=XffluXKzJUXrMtjEiAOnSNPZnztdIcts17T9ouHeID0,10521
 sourcecode/architecture_analyzer.py,sha256=qh749a7ykPtGmQI1MR9y6j8TtL_jBdVYFx9YRsLqOMw,44121
 sourcecode/architecture_summary.py,sha256=z34_6v7cSwy98cof2UVciGho7SCrZ93tiqMmq5WNzRQ,20405
@@ -20,7 +20,7 @@ sourcecode/doc_analyzer.py,sha256=05bjTUbDbmnbajD_cgRnACzS8T7xxBKVX4CjkJlhZg8,24
 sourcecode/entrypoint_classifier.py,sha256=jhTYlyqDJH2AtdEcLVaRU3lYRTJuF8DkxVzl4-W3zWE,5322
 sourcecode/env_analyzer.py,sha256=aNTyYgQk5noJDfJU6FmasmESOHfiomyJw5EvZqjy6qc,22213
 sourcecode/error_schema.py,sha256=uwosfNaSujtYm11_732Hu92z5ITV040fQDaIyefSvR4,1683
-sourcecode/file_classifier.py,sha256=PhvKBzd_kx9fKKkSQRvV14I9bZFnQYLjG30CUsN9gJc,13019
+sourcecode/file_classifier.py,sha256=A0fEABqtfVu1MfoaxnPAvGpZgneGgVXlJDhT74NYXxE,15314
 sourcecode/flow_analyzer.py,sha256=dSiuY4w49k29jW_EPXUOND9B5uVbuCA7kjnuHi-pIWA,28781
 sourcecode/git_analyzer.py,sha256=JStxTQXNjBWi_wLdwhsZs9mT-v50cSJIz4Agzn6Kh9I,13362
 sourcecode/graph_analyzer.py,sha256=DHR8fY69oU_Pi4SYaWboX6EoEFrctQKB9dsjpqwGMzw,62403
@@ -42,7 +42,7 @@ sourcecode/runtime_classifier.py,sha256=uTAD6BDCiBLUZEDRfqk718kM4RTT_vAbfkcOI2_X
 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=ooNZW2_fqx__BXII25eAWq-BomodvqQ6opUT_niQYCA,123403
+sourcecode/serializer.py,sha256=JNIXflVkVd2WvO-nwclECdPZgHmrLgIzoBOPAGTqWzY,123882
 sourcecode/spring_event_topology.py,sha256=LvGv5RXtU_O-fVB_OO9eDD2UmZM72Jn2oUHgOo50Qm0,17157
 sourcecode/spring_findings.py,sha256=8V91iHOg9hFgg6tLLl4FSsgrF-dBqOcO2s-K5sD_goA,5417
 sourcecode/spring_impact.py,sha256=vb_cOk9dFU7YcGPeqivFcpS4OYSETT72oJYn4WC5al0,33266
@@ -76,7 +76,7 @@ sourcecode/detectors/terraform.py,sha256=cxORPR_zVLOJpHlh4e9JnFpkQsn_UnqMMom5yG6
 sourcecode/detectors/tooling.py,sha256=8CKbtxwQoABP-WyBRNmdAmHDOvAH57AR1cF4UKuWEdQ,2074
 sourcecode/mcp/__init__.py,sha256=XU4HfRGbdid8wdUA0x_4f7uKZD1z3mv_XUY_WU_T9Mw,179
 sourcecode/mcp/orchestrator.py,sha256=BMi1D6liJHI3DXiaC8yeBLLP0wXajpCP3-vnRGqrvnw,26850
-sourcecode/mcp/registry.py,sha256=r6YBd9OZoQ4nwg2roQkt6dAAO__e8REtPn--WKLUYIY,60206
+sourcecode/mcp/registry.py,sha256=Z-deZiVowoYbYhi39ScBIgJ2y4mpQintmjifBr9hk4M,60897
 sourcecode/mcp/runner.py,sha256=-Dp2qPGRkfNTVen6bKh7WtzQqpcEtsrXoiuajvshlKk,2866
 sourcecode/mcp/server.py,sha256=lBSQCw3yFe8rZHp2GGVcfua0EJUYZmsIUbvA4GIJv9s,52210
 sourcecode/mcp/onboarding/__init__.py,sha256=sj2PWqEBmMc4zBNkomg89WtL0M6S7A9yb7_wAuSWNP4,66
@@ -90,8 +90,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.35.8.dist-info/METADATA,sha256=LJSPDerXZXrHOmZrrgWCeQJme4iEyM7ePFxC4t3gDh4,21263
-sourcecode-1.35.8.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-1.35.8.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
-sourcecode-1.35.8.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-1.35.8.dist-info/RECORD,,
+sourcecode-1.35.10.dist-info/METADATA,sha256=yWc8FeRSSMPWi8pQpbkvAEMIL7X55CgiO4jM5jk-0j4,21266
+sourcecode-1.35.10.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-1.35.10.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
+sourcecode-1.35.10.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-1.35.10.dist-info/RECORD,,