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

sourcecode/__init__.py

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

sourcecode/cli.py

@@ -401,7 +401,7 @@ def main(
         help=(
             "High-signal summary (typically 1000–3000 tokens depending on repo size): "
             "stacks, entry points, dependency summary, confidence, and gaps. "
-            "Includes security_surface, mybatis, and transactional_boundaries for Java projects. "
+            "Includes security_surface (when @M3FiltroSeguridad detected), mybatis (when MyBatis framework detected), and transactional_boundaries for Java projects. "
             "Use --agent for maximum signal or --slim (when available) for minimal token footprint."
         ),
     ),
@@ -2418,14 +2418,20 @@ def repo_ir_cmd(
 
     if output_path:
         output_path.write_text(output, encoding="utf-8")
-        n_nodes = len((ir.get("graph") or {}).get("nodes") or [])
-        n_edges = len((ir.get("graph") or {}).get("edges") or [])
         size_kb = len(output.encode("utf-8")) // 1024
-        typer.echo(
-            f"IR written to {output_path} "
-            f"({size_kb}KB, {n_nodes} nodes, {n_edges} edges)",
-            err=True,
-        )
+        if summary_only:
+            typer.echo(
+                f"IR written to {output_path} ({size_kb}KB, graph omitted by --summary-only)",
+                err=True,
+            )
+        else:
+            n_nodes = len((ir.get("graph") or {}).get("nodes") or [])
+            n_edges = len((ir.get("graph") or {}).get("edges") or [])
+            typer.echo(
+                f"IR written to {output_path} "
+                f"({size_kb}KB, {n_nodes} nodes, {n_edges} edges)",
+                err=True,
+            )
     else:
         try:
             _sys.stdout.buffer.write(output.encode("utf-8"))
@@ -2462,7 +2468,11 @@ def _extract_java_endpoints(root: "Path") -> "dict[str, Any]":
         r'@(Get|Post|Put|Delete|Patch|Request)Mapping\s*'
         r'(?:\(\s*(?:value\s*=\s*)?(?:"([^"]*)"|\{[^}]*\}|[^)]*)\s*\))?',
     )
-    _CLASS_RE = _re.compile(r'(?:class|interface)\s+(\w+)')
+    _CLASS_RE = _re.compile(
+        r'^[ \t]*(?:(?:public|protected|private|abstract|final|@\w+)\s+)*'
+        r'(?:class|interface)\s+(\w+)',
+        _re.MULTILINE,
+    )
     _METHOD_RE = _re.compile(
         r'(?:public|protected|private)\s+\S+\s+(\w+)\s*\(',
     )
@@ -2486,22 +2496,76 @@ def _extract_java_endpoints(root: "Path") -> "dict[str, Any]":
     endpoints: list[dict] = []
     seen: set[tuple] = set()
 
+    from sourcecode.path_filters import is_test_path as _is_test_path
+
     java_files = [
         p for p in root.rglob("*.java")
-        if "/test/" not in str(p).replace("\\", "/")
-        and "/tests/" not in str(p).replace("\\", "/")
+        if not _is_test_path(str(p).replace("\\", "/"))
         and "target/" not in str(p).replace("\\", "/")
     ]
 
+    # ── Meta-annotation index ─────────────────────────────────────────────────
+    # First pass: find @interface declarations and the annotations they carry.
+    # This lets us detect controllers annotated with framework wrappers like
+    # @FrameworkController that itself carries @Controller.
+    #
+    # Index maps annotation simple name → set of annotation names it is
+    # annotated with (one level; resolution is done recursively below).
+    _ANN_DECL_RE = _re.compile(r'public\s+@interface\s+(\w+)')
+    _ANN_USE_RE = _re.compile(r'@(\w+)')
+
+    _meta_index: dict[str, set[str]] = {}
+    for _jf in java_files:
+        _raw: str
+        try:
+            _raw = _jf.read_text(encoding="utf-8", errors="replace")
+        except OSError:
+            continue
+        if "@interface" not in _raw:
+            continue
+        _decl_m = _ANN_DECL_RE.search(_raw)
+        if not _decl_m:
+            continue
+        _ann_name = _decl_m.group(1)
+        # Collect annotations appearing in the header (before the @interface line)
+        _header = _raw[: _decl_m.start()]
+        _meta_anns: set[str] = {
+            m for m in _ANN_USE_RE.findall(_header)
+            if m not in ("interface", "interface")  # strip keywords; annotation names only
+        }
+        _meta_index[_ann_name] = _meta_anns
+
+    _CONTROLLER_CORE = frozenset({"Controller", "RestController"})
+
+    def _resolves_to_controller(name: str, visited: "set[str]") -> bool:
+        """Return True when annotation *name* transitively carries @Controller/@RestController."""
+        if name in _CONTROLLER_CORE:
+            return True
+        if name in visited:
+            return False
+        visited.add(name)
+        for parent in _meta_index.get(name, ()):
+            if _resolves_to_controller(parent, visited):
+                return True
+        return False
+
     for java_file in java_files:
         try:
             content = java_file.read_text(encoding="utf-8", errors="replace")
         except OSError:
             continue
 
-        # Only process files with REST controller or mapping annotations
-        if not any(x in content for x in ("@RestController", "@Controller", "@RequestMapping")):
-            continue
+        # Process files with direct controller/mapping annotations OR
+        # with custom annotations that transitively resolve to @Controller/@RestController.
+        _has_direct = any(x in content for x in ("@RestController", "@Controller", "@RequestMapping"))
+        if not _has_direct:
+            # Quick meta-annotation check: extract class-level annotation names
+            # (first 60 lines — before the class body opens) and resolve them.
+            _header_lines = content.splitlines()[:60]
+            _header_text = "\n".join(_header_lines)
+            _file_anns = set(_ANN_USE_RE.findall(_header_text))
+            if not any(_resolves_to_controller(a, set()) for a in _file_anns):
+                continue
 
         try:
             rel_path = str(java_file.relative_to(root)).replace("\\", "/")
@@ -2540,7 +2604,45 @@ def _extract_java_endpoints(root: "Path") -> "dict[str, Any]":
                 if "class " in block or "interface " in block:
                     path_m = _CLASS_PATH_RE.search(block)
                     if path_m:
-                        class_bases = [path_m.group(1).rstrip("/")]
+                        captured = path_m.group(1).rstrip("/")
+                        # Handle string concat: @RequestMapping("lit" + ClassName.CONST)
+                        _CONCAT_CONST_RE = _re.compile(
+                            r'@RequestMapping\s*\(\s*(?:value\s*=\s*)?'
+                            r'["\']([^"\']*)["\'\s]*\+\s*(\w+)\.(\w+)'
+                        )
+                        cc_m = _CONCAT_CONST_RE.search(block)
+                        if cc_m:
+                            prefix_lit = cc_m.group(1)
+                            c_class = cc_m.group(2)
+                            c_field = cc_m.group(3)
+                            _SVAL_RE = _re.compile(
+                                r'static\s+final\s+String\s+'
+                                + _re.escape(c_field)
+                                + r'\s*=\s*"([^"]+)"'
+                            )
+                            resolved = None
+                            m_cur = _SVAL_RE.search(content)
+                            if m_cur:
+                                resolved = m_cur.group(1)
+                            else:
+                                for _jf in java_files:
+                                    if _jf.stem == c_class:
+                                        try:
+                                            _jf_txt = _jf.read_text(
+                                                encoding="utf-8", errors="replace"
+                                            )
+                                            m_jf = _SVAL_RE.search(_jf_txt)
+                                            if m_jf:
+                                                resolved = m_jf.group(1)
+                                                break
+                                        except OSError:
+                                            pass
+                            if resolved is not None:
+                                class_bases = [(prefix_lit + resolved).rstrip("/")]
+                            else:
+                                class_bases = [captured] if captured else [""]
+                        else:
+                            class_bases = [captured] if captured else [""]
                     else:
                         arr_m = _CLASS_ARRAY_PATH_RE.search(block)
                         if arr_m:

sourcecode/code_notes_analyzer.py

@@ -20,7 +20,8 @@ _SYMBOL_LOOKBACK = 25  # líneas hacia atrás para encontrar el símbolo envolve
 _SKIP_DIRS = {
     "node_modules", ".git", "__pycache__", ".venv", "venv",
     ".mypy_cache", "dist", "build", ".tox", ".eggs",
-    ".next", ".nuxt", ".output", "vendor", "coverage",
+    ".next", ".nuxt", ".output", "vendor", "vendors", "coverage",
+    "third_party", "thirdparty",
 }
 
 _CODE_EXTENSIONS = {
@@ -255,4 +256,6 @@ class CodeNotesAnalyzer:
                 # here was redundant and caused files to be silently skipped when
                 # traversal order varied (different files filled the quota first).
                 if suffix in _CODE_EXTENSIONS:
-                    _scan_source_file(entry, rel, notes, total_count)
+                    from sourcecode.path_filters import is_vendor_path as _is_vendor
+                    if not _is_vendor(rel):
+                        _scan_source_file(entry, rel, notes, total_count)

sourcecode/detectors/heuristic.py

@@ -59,8 +59,13 @@ class HeuristicDetector(AbstractDetector):
         paths = flatten_file_tree(context.file_tree)
         counts: Counter[str] = Counter()
         for path in paths:
-            if path.startswith("."):
+            if path.startswith(".") or _is_auxiliary_path(path):
                 continue
+            # Skip JS/TS files bundled as Java static resources (not Node.js source)
+            if path.endswith((".js", ".ts", ".tsx", ".jsx", ".mjs")):
+                _np = path.replace("\\", "/")
+                if "src/main/resources/" in _np or "src/main/webapp/" in _np:
+                    continue
             for extension, stack in _EXTENSION_MAP.items():
                 if path.endswith(extension):
                     counts[stack] += 1

sourcecode/detectors/java.py

@@ -295,9 +295,13 @@ class JavaDetector(AbstractDetector):
         self._augment_deep_java_controllers(context, all_java)
 
         # 1. @SpringBootApplication entry: Application.java / Main.java by name
+        # Exclude test trees: test helpers like AdminApplication.java in
+        # integration/src/test/java/ must not be treated as production entrypoints.
+        from sourcecode.path_filters import is_test_path as _is_test_path
         app_candidates = [
             p for p in all_java
             if p.endswith(("Application.java", "Main.java"))
+            and not _is_test_path(p)
         ]
         entry_points: list[EntryPoint] = [
             EntryPoint(path=p, stack="java", kind="application", source="manifest")
@@ -307,7 +311,7 @@ class JavaDetector(AbstractDetector):
         # 2. Annotation-based scan: @RestController, @WebFilter, FilterRegistrationBean
         # Prioritize Controller-named files so all REST controllers are detected
         # even in large codebases where total files > _MAX_JAVA_ENTRY_SCAN.
-        _non_test = [p for p in all_java if "/test/" not in p and "/tests/" not in p]
+        _non_test = [p for p in all_java if not _is_test_path(p)]
         _ctrl_files = [p for p in _non_test if "Controller" in p]
         _other_files = [p for p in _non_test if "Controller" not in p]
         scan_candidates = _ctrl_files + _other_files[:max(0, _MAX_JAVA_ENTRY_SCAN - len(_ctrl_files))]

sourcecode/path_filters.py

@@ -0,0 +1,124 @@
+"""Shared path classification helpers used across all tools.
+
+Centralises test-path and vendor-path detection so each tool does not
+duplicate — and diverge — these heuristics.
+"""
+from __future__ import annotations
+
+_TEST_SEGMENTS = frozenset({
+    "test", "tests", "spec", "specs",
+    "test-helpers", "test_helpers", "testfixtures",
+    "it",          # integration-tests short name
+    "integrationtest", "integrationtests",
+})
+
+_VENDOR_SEGMENTS = frozenset({
+    "vendor", "vendors",
+    "third_party", "thirdparty",
+    "node_modules",
+    "external", "externals",
+    "contrib",
+})
+
+# lib/libs are vendor only for web-asset extensions.
+# Java/Kotlin/Python source in a package named "lib" is NOT vendor.
+_LIB_SEGMENTS = frozenset({"lib", "libs"})
+_WEB_ASSET_EXTS = frozenset({
+    ".js", ".jsx", ".mjs", ".cjs",
+    ".ts", ".tsx",
+    ".css", ".less", ".scss", ".sass",
+    ".json", ".map",
+})
+
+_VENDOR_PATH_FRAGMENTS = (
+    "/vendor/", "/vendors/",
+    "/third_party/", "/thirdparty/",
+    "/node_modules/",
+    "/external/", "/externals/",
+    "/contrib/",
+)
+
+_JAVA_TEST_ROOTS = (
+    "/src/test/",
+    "\\src\\test\\",
+)
+
+
+def is_test_path(path: str) -> bool:
+    """Return True when *path* is part of a test tree, not production code.
+
+    Handles:
+      - Standard Maven/Gradle layout  (src/test/java/…)
+      - Common naming conventions     (/tests/, /spec/, /it/)
+      - Java file name conventions    (FooTest.java, TestFoo.java)
+      - Python conventions            (test_foo.py, foo_test.py)
+      - JS/TS conventions             (foo.test.ts, foo.spec.ts)
+    """
+    norm = path.replace("\\", "/").lower()
+
+    # Maven/Gradle standard test root (fast path)
+    if "/src/test/" in norm:
+        return True
+
+    # Segment-based check – any directory component is a test segment
+    parts = norm.split("/")
+    for part in parts[:-1]:  # skip filename itself
+        bare = part.rstrip("/")
+        if bare in _TEST_SEGMENTS:
+            return True
+
+    # File-name conventions
+    name = parts[-1]
+    if (
+        name.startswith("test_")
+        or name.endswith("_test.py")
+        or name.endswith(".test.ts")
+        or name.endswith(".test.js")
+        or name.endswith(".spec.ts")
+        or name.endswith(".spec.js")
+        or (name.endswith("test.java") and name != "test.java")
+        or name.endswith("tests.java")
+        or (name.startswith("test") and name.endswith(".java") and len(name) > 9)
+    ):
+        return True
+
+    return False
+
+
+def is_vendor_path(path: str) -> bool:
+    """Return True when *path* is inside a vendored / third-party directory.
+
+    Handles:
+      - /vendor/, /vendors/, /third_party/, /node_modules/
+      - /lib/, /libs/ containing web assets (NOT JVM/Python source — those may
+        legitimately use "lib" as a package name)
+      - Minified JS/CSS files anywhere (*.min.js, *.min.css)
+    """
+    norm = path.replace("\\", "/").lower()
+
+    # Minified files are always vendor regardless of directory
+    if norm.endswith(".min.js") or norm.endswith(".min.css"):
+        return True
+
+    # Fast fragment check for unambiguous vendor directories
+    for frag in _VENDOR_PATH_FRAGMENTS:
+        if frag in norm:
+            return True
+
+    parts = norm.split("/")
+    dir_parts = parts[:-1]  # exclude filename
+
+    # Unambiguous vendor directory names
+    for part in dir_parts:
+        if part in _VENDOR_SEGMENTS:
+            return True
+
+    # lib/libs: vendor only for web-asset file types, not JVM/Python source
+    filename = parts[-1]
+    ext = "." + filename.rsplit(".", 1)[-1] if "." in filename else ""
+    if ext in _WEB_ASSET_EXTS:
+        for part in dir_parts:
+            if part in _LIB_SEGMENTS:
+                return True
+
+    return False

sourcecode/prepare_context.py

@@ -310,7 +310,8 @@ class RelevantFile:
     role: str    # entrypoint | source | test
     score: float
     reason: str
-    why: str = ""  # why this file matters for the specific task
+    why: str = ""                # why this file matters for the specific task
+    tier: Optional[str] = None   # fix-bug only: high | medium | low
 
 
 @dataclass
@@ -974,7 +975,33 @@ class TaskContextBuilder:
                 and (d.role or "unknown") in {"runtime", "parsing", "serialization", "observability", "infra"}
                 and d.scope not in {"dev"}
             ]
-            direct.sort(key=lambda d: (0 if d.ecosystem == primary_eco else 1, d.name.lower()))
+            # 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.
+            _HIGH_SIGNAL_FRAGMENTS = (
+                "hibernate", "jpa", "spring-core", "spring-context", "spring-web",
+                "spring-boot", "spring-security", "spring-data",
+                "solr", "elasticsearch", "kafka", "redis",
+                "jackson", "gson",
+                "mybatis", "druid", "datasource",
+                "tomcat", "undertow", "netty",
+                "slf4j", "logback", "log4j",
+            )
+            _LOW_SIGNAL_FRAGMENTS = (
+                "closure-compiler", "closure-library",
+                "google-closure", "rhino",
+                "guava-gwt",
+            )
+
+            def _dep_rank(d: Any) -> tuple:
+                art = (d.name or "").lower()
+                eco_match = 0 if d.ecosystem == primary_eco else 1
+                is_high = any(frag in art for frag in _HIGH_SIGNAL_FRAGMENTS)
+                is_low = any(frag in art for frag in _LOW_SIGNAL_FRAGMENTS)
+                infra_score = 0 if is_high else (2 if is_low else 1)
+                return (eco_match, infra_score, art)
+
+            direct.sort(key=_dep_rank)
             _SKIP_DEP_KEYS = {"parent", "workspace", "resolved_version", "manifest_path"}
             key_dependencies = [
                 {k: v for k, v in asdict(d).items() if v is not None and k not in _SKIP_DEP_KEYS}
@@ -1182,6 +1209,7 @@ class TaskContextBuilder:
                 uncommitted_files=uncommitted_files,
                 code_notes=cn_notes_for_ranking if cn_notes_for_ranking else None,
                 delta_files=None,
+                symptom=symptom if task_name == "fix-bug" else None,
             )
 
         # ── 6b. review-pr: derive PR-specific impact sections from delta analysis ──
@@ -2025,6 +2053,7 @@ class TaskContextBuilder:
         uncommitted_files: Optional[set[str]] = None,
         code_notes: Optional[list] = None,
         delta_files: Optional[set[str]] = None,
+        symptom: Optional[str] = None,
     ) -> list[RelevantFile]:
         from sourcecode.ranking_engine import RankingEngine
         from sourcecode.file_classifier import FileClassifier
@@ -2043,6 +2072,11 @@ class TaskContextBuilder:
         _annotated_files: set[str] = set()
         _dominant_stack = ""
         _recently_changed_stacks: set[str] = set()
+        # Query-aware signals extracted from symptom (class names, exception types, tokens)
+        _symptom_class_names: set[str] = set()    # CamelCase class names
+        _symptom_exception_types: set[str] = set() # *Exception / *Error tokens
+        _symptom_tokens: set[str] = set()          # all lowercase tokens
+
         if task_name == "fix-bug":
             _bug_kinds = {"FIXME", "BUG", "HACK", "XXX"}
             for _n in (code_notes or []):
@@ -2068,6 +2102,19 @@ class TaskContextBuilder:
                 _dominant_stack = _stk_counts.most_common(1)[0][0]
                 _recently_changed_stacks = set(_stk_counts.keys())
 
+            # Extract structured signals from symptom text for AND-weighted ranking
+            if symptom:
+                import re as _re_bug
+                _camel_re = _re_bug.compile(r'\b([A-Z][a-zA-Z0-9]+)\b')
+                for _tok in _camel_re.findall(symptom):
+                    if _tok.endswith(("Exception", "Error", "Throwable")):
+                        _symptom_exception_types.add(_tok)
+                    else:
+                        _symptom_class_names.add(_tok)
+                _symptom_tokens = {
+                    w.lower() for w in _re_bug.split(r'[\s\W]+', symptom) if len(w) > 2
+                }
+
         scored: list[tuple[float, str, RelevantFile]] = []
 
         # For delta task, score only files changed in the specified git range.
@@ -2117,6 +2164,64 @@ class TaskContextBuilder:
             _fix_bug_why = ""
             if task_name == "fix-bug":
                 _why_parts: list[str] = []
+
+                # ── Query-aware AND-weighted signals (symptom-derived) ──
+                # These intentionally outweigh git-recency signals so that
+                # OrderServiceImpl.java ranks top-3 regardless of churn history.
+                if _symptom_class_names or _symptom_exception_types:
+                    _stem = Path(path).stem
+                    _stem_lower = _stem.lower()
+                    _matched_class = next(
+                        (c for c in _symptom_class_names if _stem_lower == c.lower()),
+                        None,
+                    )
+                    _matched_exc = next(
+                        (e for e in _symptom_exception_types if _stem_lower == e.lower()),
+                        None,
+                    )
+                    _impl_match = next(
+                        (c for c in _symptom_class_names
+                         if _stem_lower in (c.lower() + "impl", c.lower() + "service",
+                                            c.lower() + "serviceimpl", c.lower() + "helper")),
+                        None,
+                    )
+                    if _matched_class:
+                        content_boost += 3.0
+                        _why_parts.append(f"exact class match: {_stem} (+3.0)")
+                    elif _matched_exc:
+                        content_boost += 2.0
+                        _why_parts.append(f"exception class match: {_stem} (+2.0)")
+                    elif _impl_match:
+                        content_boost += 2.5
+                        _why_parts.append(f"class impl match: {_stem} (+2.5)")
+                    else:
+                        # Symbol appears anywhere in path (package adjacency)
+                        _path_class_hit = next(
+                            (c for c in _symptom_class_names if c.lower() in path_lower),
+                            None,
+                        )
+                        if _path_class_hit:
+                            content_boost += 1.0
+                            _why_parts.append(f"symbol in path: {_path_class_hit} (+1.0)")
+                        elif any(e.lower() in path_lower for e in _symptom_exception_types):
+                            content_boost += 0.8
+                            _why_parts.append("exception type in path (+0.8)")
+
+                # AND-weighted token intersection — multiple matching tokens >> single
+                if _symptom_tokens:
+                    _path_parts = set(path_lower.replace("/", " ").replace(".", " ").replace("_", " ").split())
+                    _intersection = _symptom_tokens & _path_parts
+                    _n_match = len(_intersection)
+                    if _n_match >= 3:
+                        _tok_boost = min(1.2, _n_match * 0.25)
+                        content_boost += _tok_boost
+                        _why_parts.append(f"token AND match ({_n_match} terms: {sorted(_intersection)[:3]}) (+{_tok_boost:.2f})")
+                    elif _n_match == 2:
+                        content_boost += 0.4
+                        _why_parts.append(f"token AND match (2 terms: {sorted(_intersection)}) (+0.40)")
+                    # Single-token match: no boost — avoids OR explosion
+
+                # ── Git / annotation signals ──
                 if path in _uncommitted:
                     content_boost += 0.40
                     _why_parts.append("uncommitted change (+0.40)")
@@ -2203,7 +2308,7 @@ class TaskContextBuilder:
             }
             _repo_size = len(all_paths)
             _task_budget = {
-                "fix-bug": max(20, min(40, _repo_size // 80)),
+                "fix-bug": 30,  # hard cap — prevents token explosion on large repos
                 "onboard": max(15, min(25, _repo_size // 150)),
                 "explain": max(10, min(20, _repo_size // 200)),
                 "generate-tests": max(20, min(35, _repo_size // 100)),
@@ -2271,7 +2376,21 @@ class TaskContextBuilder:
                             _covered.add(_layer)
                             _missing.discard(_layer)
 
-            return [_rf_map[p] for p in _selected if p in _rf_map]
+            result = [_rf_map[p] for p in _selected if p in _rf_map]
+
+            # Assign fix-bug tiers based on raw score (pre-normalised total)
+            if task_name == "fix-bug":
+                _score_lookup = {path: total for total, path, _ in scored}
+                for _rf in result:
+                    _s = _score_lookup.get(_rf.path, 0.0)
+                    if _s >= 4.0:
+                        _rf.tier = "high"
+                    elif _s >= 1.5:
+                        _rf.tier = "medium"
+                    else:
+                        _rf.tier = "low"
+
+            return result
         except Exception:
             return [f for _, _, f in scored[:15]]
 

sourcecode/serializer.py

@@ -409,7 +409,10 @@ def _spring_profiles_context(sm: "SourceMap") -> "Optional[dict[str, Any]]":
         else:
             matches = [
                 p for p in sm.file_paths
-                if pfx in Path(p).stem.lower() and p.endswith(".java")
+                if (Path(p).stem.lower() == pfx
+                    or Path(p).stem.lower().startswith(pfx + "-")
+                    or Path(p).stem.lower().endswith("-" + pfx))
+                and p.endswith(".java")
             ]
         if matches:
             per_profile[profile] = [Path(p).name for p in matches[:5]]
@@ -534,6 +537,8 @@ def _bootstrap_structured(eps: list) -> "Optional[dict[str, Any]]":
 
     for ep in eps:
         path = getattr(ep, "path", "")
+        if "/test/" in path or "/tests/" in path:
+            continue
         kind = getattr(ep, "kind", "")
         stem = _Path(path).stem
 
@@ -587,8 +592,9 @@ def _bootstrap_structured(eps: list) -> "Optional[dict[str, Any]]":
                 module_names.append(module)
 
         _ctrl_note = (
-            f"{controller_methods} @RequestMapping methods across "
+            f"{controller_methods} detected entry-point methods across "
             f"{controller_classes} controller classes"
+            f" (use 'sourcecode endpoints' for full surface)"
         )
         if len(module_names) > 30:
             # Group by first path segment under ddd/ (inferred domain area)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.31.4
+Version: 1.31.6
 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.4-blue)
+![Version](https://img.shields.io/badge/version-1.31.6-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.4
+# sourcecode 1.31.6
 ```
 
 ---

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

@@ -1,11 +1,11 @@
-sourcecode/__init__.py,sha256=P8MbrmTVGyjN1Uy_38VxYTdrjIoEPOf9I4Xn71cCRs8,103
+sourcecode/__init__.py,sha256=YtkXxLCwI2P3youz8qWDCC8rLLuveg8_p3Rw5TwvrXs,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=dcHIYDvDpcIzbExxKuemtElk3RClLRWaaO2RU9R8Hoc,123945
-sourcecode/code_notes_analyzer.py,sha256=y1MJBnPZHYp4i6cQCXUb9ATIyifS_qMQWjw_8lPkpsU,9215
+sourcecode/cli.py,sha256=lAqlKvLs3nrHKCM6RfsvQr1O_jWi3WOcdjhhlE8fmyg,129082
+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
 sourcecode/context_summarizer.py,sha256=CiQrfBEzun949bWvmLabWoj2HhPn6Lw62ofqnsy0FlQ,6503
@@ -21,8 +21,9 @@ sourcecode/flow_analyzer.py,sha256=dSiuY4w49k29jW_EPXUOND9B5uVbuCA7kjnuHi-pIWA,2
 sourcecode/git_analyzer.py,sha256=0Gyj-vMpIIN4nfriKXVRouNYBeJ59s6pQDX2Xu9Pq-U,13177
 sourcecode/graph_analyzer.py,sha256=iUK-7pSV-cvGqqD2hENdYmhnm0wcXFEyK-xnu5ul8OU,62515
 sourcecode/metrics_analyzer.py,sha256=m0ENgtqKeBL17kUIK3fmGkgo7UfXBNHxCMj0H_Y5K7c,22750
+sourcecode/path_filters.py,sha256=ROFRQ8eSLBEMiixK9f45-RO7um4VEEcjoD5AA4I427I,3739
 sourcecode/pr_comment_renderer.py,sha256=smHslxiG14lrytCkq5nFrFu-qTHgA-t-LFYfdrfjz2o,14423
-sourcecode/prepare_context.py,sha256=Eid3Wmh4lmtr20pmobcCU0yzjRXhFql2rEmfGUgkFpU,183214
+sourcecode/prepare_context.py,sha256=-9kTYuPhwr79mF6lNe9tI7glGAU_d84GyVurHceGroo,189427
 sourcecode/progress.py,sha256=qn30sWaHOkjTgXsSBmiPkz7Rsbwc5oSlIe6JNEMYp_k,3149
 sourcecode/ranking_engine.py,sha256=ZAucq_YX2KkWUuAZf4P0lhtQ_38vEFnUhuGtSZd1S0E,12970
 sourcecode/redactor.py,sha256=xuGcadGEHaPw4qZXlMDvzMCsr4VOkdp3oBQptHyJk8c,2884
@@ -33,7 +34,7 @@ sourcecode/runtime_classifier.py,sha256=zWX3r3HCKHc-qtIobErOa8aKMmaoPYREtJKvPcBG
 sourcecode/scanner.py,sha256=WdOQ78mMzjR1NjmKTlbxdgwinnCTfAhxCVLBEFQiFHU,8899
 sourcecode/schema.py,sha256=fj3BZ3IcnNV4j21BFIEvz8Qnw_vZoqIbzzRg-qQ-nd0,24530
 sourcecode/semantic_analyzer.py,sha256=12TwXYkYbDcBdu0heX_EmfPM2EkO8a_r5osf0SaeQbs,88956
-sourcecode/serializer.py,sha256=KHVqwUK53axF10detPzqgmIY2P31rjLLJ_9T9Eyqp-E,111647
+sourcecode/serializer.py,sha256=1y9DAkH2aBzlsmkHcSSc-t72_4fv9RZIuG4uhhGG5QE,111933
 sourcecode/summarizer.py,sha256=lPlKhMh28nueXkPo2xKeD3DUFYVGRlJMIdY-8TSM-ls,17486
 sourcecode/tree_utils.py,sha256=8GAkIfQAsvtEudIeW1l4ooH_oRtrWR8cpJQJsEa_Pfw,2093
 sourcecode/workspace.py,sha256=X_6NmNnitvT3_38V-JDChydo_sR68s249hLFlrQskU0,8271
@@ -44,9 +45,9 @@ sourcecode/detectors/dart.py,sha256=QbqaL5v18-_ort75HihVBt8MsKUfOcFDF8IpWFLiXpI,
 sourcecode/detectors/dotnet.py,sha256=oi8zq3AfUItlK3h_qM81vOe1ZVTIU9LBKIlIrRDuqOs,6864
 sourcecode/detectors/elixir.py,sha256=jCpvt5Yi6jvplc80ovRtWh17q-11ZGo9qX7o8b57TJE,1713
 sourcecode/detectors/go.py,sha256=2r66uRQfeTWsqxr4HDhT6vExZErby0t46QXLHVBRv9w,2782
-sourcecode/detectors/heuristic.py,sha256=bCqqgbHavl4Sse3dqT8mwmo1wAdgeJr7VyXOmfClLKo,3387
+sourcecode/detectors/heuristic.py,sha256=7cRxrip4yIaggYzZJB6ef8yHKh-gHgiH_pXMFcjlyFU,3723
 sourcecode/detectors/hybrid.py,sha256=IGFRUVsAZ1ooRlFdznCeJAV6vy1yVDx-VyghvLtddXc,9101
-sourcecode/detectors/java.py,sha256=ldvaDZJADAKslOpS5qJ0bxexgeY6h_4Yx4NCtHio7J8,24203
+sourcecode/detectors/java.py,sha256=O2JdznVYv5364GSQExksYLsAi0pvDUW9ZowpsL0xLgM,24451
 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
@@ -72,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.4.dist-info/METADATA,sha256=JZXcuZYPozOjtbIY_xnVgUNwMF1aEU12mV4m2T__E1A,29083
-sourcecode-1.31.4.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-1.31.4.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
-sourcecode-1.31.4.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-1.31.4.dist-info/RECORD,,
+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,,