sourcecode 0.44.0__py3-none-any.whl → 0.45.0__py3-none-any.whl

sourcecode/__init__.py

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

sourcecode/cli.py

@@ -660,6 +660,21 @@ def main(
         )
         raise typer.Exit(code=1)
 
+    if symbol and mode not in ("contract", "standard"):
+        typer.echo(
+            f"Error: --symbol requires --mode contract or standard (got '{mode}'). "
+            "Symbol search uses the contract pipeline which does not run in raw mode.",
+            err=True,
+        )
+        raise typer.Exit(code=1)
+
+    if entrypoints_only and mode not in ("contract", "standard"):
+        typer.echo(
+            f"Error: --entrypoints-only requires --mode contract or standard (got '{mode}').",
+            err=True,
+        )
+        raise typer.Exit(code=1)
+
     if dependency_depth > 0:
         typer.echo(
             f"[warning] --dependency-depth {dependency_depth} has no effect: "
@@ -1257,7 +1272,13 @@ def main(
             eco_order = 0 if d.ecosystem == primary_ecosystem else 1
             return (role_order, eco_order, d.name.lower())
 
-        sm.key_dependencies = sorted(direct_deps, key=_dep_sort_key)[:15]
+        _seen_dep_names: set[str] = set()
+        _deduped_deps: list[Any] = []
+        for d in sorted(direct_deps, key=_dep_sort_key):
+            if d.name not in _seen_dep_names:
+                _seen_dep_names.add(d.name)
+                _deduped_deps.append(d)
+        sm.key_dependencies = _deduped_deps[:15]
 
     # LQN-02: deterministic NL summary
     sm.project_summary = ProjectSummarizer(target).generate(sm)
@@ -1356,32 +1377,58 @@ def main(
     _is_contract_mode = mode in ("contract", "standard")
     if _is_contract_mode:
         from sourcecode.contract_pipeline import ContractPipeline
+        from sourcecode.contract_model import ContractSummary as _ContractSummary
         _cp = ContractPipeline()
-        _contracts, _contract_summary = _cp.run(
-            target,
-            sm.file_paths,
-            entry_points=sm.entry_points,
-            monorepo_packages=sm.monorepo_packages,
-            mode=mode,
-            rank_by=rank_by,  # type: ignore[arg-type]
-            max_symbols=max_symbols,
-            dependency_depth=dependency_depth,
-            entrypoints_only=entrypoints_only,
-            changed_only=changed_only,
-            symbol=symbol,
-            compress_types=compress_types,
-            max_importers=max_importers,
-            semantic_calls=sm.semantic_calls or None,
-            code_notes=sm.code_notes or None,
-        )
+        try:
+            _contracts, _contract_summary = _cp.run(
+                target,
+                sm.file_paths,
+                entry_points=sm.entry_points,
+                monorepo_packages=sm.monorepo_packages,
+                mode=mode,
+                rank_by=rank_by,  # type: ignore[arg-type]
+                max_symbols=max_symbols,
+                dependency_depth=dependency_depth,
+                entrypoints_only=entrypoints_only,
+                changed_only=changed_only,
+                symbol=symbol,
+                compress_types=compress_types,
+                max_importers=max_importers,
+                semantic_calls=sm.semantic_calls or None,
+                code_notes=sm.code_notes or None,
+            )
+        except Exception as _exc:
+            typer.echo(f"[error] contract pipeline failed: {_exc}", err=True)
+            _contracts = []
+            _contract_summary = _ContractSummary(
+                mode=mode,
+                total_files=0,
+                extracted_files=0,
+                filtered_files=0,
+                method_breakdown={},
+                ranked_by=rank_by,
+                limitations=[f"pipeline_error: {type(_exc).__name__}"],
+            )
         sm = _replace(sm, file_contracts=_contracts, contract_summary=_contract_summary)
         if symbol is not None and len(_contracts) == 0:
-            typer.echo(
-                f"[warning] --symbol '{symbol}' matched 0 files. "
-                "The symbol may not exist at the current --depth, or the name may differ in case. "
-                "Try --depth 8 or verify the symbol name.",
-                err=True,
-            )
+            _jvm_stacks = {"java", "kotlin", "scala", "groovy"}
+            _is_jvm_repo = any(s.stack in _jvm_stacks for s in sm.stacks)
+            if _is_jvm_repo:
+                typer.echo(
+                    f"[warning] --symbol '{symbol}' matched 0 files. "
+                    "Per-file AST extraction is not available for Java/JVM repos — "
+                    "symbol search works only with Python, TypeScript, and JavaScript. "
+                    "Use --git-context or --code-notes for JVM navigation.",
+                    err=True,
+                )
+            else:
+                typer.echo(
+                    f"[warning] --symbol '{symbol}' matched 0 files. "
+                    "The symbol may not exist, the name may differ in case, "
+                    "or the file may be outside the scanned depth. "
+                    "Try --depth 8 or verify the symbol name.",
+                    err=True,
+                )
         if agent:
             typer.echo(f"[contract] {len(_contracts)} files extracted ({_contract_summary.method_breakdown})", err=True)
 

sourcecode/contract_pipeline.py

@@ -241,7 +241,9 @@ class ContractPipeline:
             contracts.append(contract)
             method_counts[contract.extraction_method] += 1
 
-        if not self._extractor.has_tree_sitter():
+        _js_ts_languages = {"typescript", "javascript", "tsx", "jsx"}
+        _has_js_ts = any(c.language in _js_ts_languages for c in contracts)
+        if _has_js_ts and not self._extractor.has_tree_sitter():
             limitations.append(
                 "tree_sitter_unavailable: JS/TS extraction uses heuristics. "
                 "Install with: pip install 'sourcecode[ast]'"

sourcecode/detectors/heuristic.py

@@ -66,6 +66,13 @@ class HeuristicDetector(AbstractDetector):
                     counts[stack] += 1
                     break
 
+        # Suppress minority stacks: if a language appears in fewer than 3 files
+        # AND represents less than 10% of detected source files, it is likely
+        # noise (stray config files, vendored snippets) rather than a real stack.
+        # Always emit the dominant language regardless of absolute count.
+        total_detected = sum(counts.values())
+        _ABS_MIN = 3
+        _REL_MIN = 0.10
         stacks = [
             StackDetection(
                 stack=stack,
@@ -73,7 +80,8 @@ class HeuristicDetector(AbstractDetector):
                 confidence="low",
                 manifests=[],
             )
-            for stack, _count in counts.most_common()
+            for stack, count in counts.most_common()
+            if count >= _ABS_MIN or (total_detected > 0 and count / total_detected >= _REL_MIN)
         ]
 
         entry_points: list[EntryPoint] = []

sourcecode/env_analyzer.py

@@ -11,8 +11,8 @@ _MAX_FILE_SIZE = 512 * 1024  # 512 KB
 
 _SKIP_DIRS = {
     "node_modules", ".git", "__pycache__", ".venv", "venv",
-    ".mypy_cache", "dist", "build", ".tox", ".eggs", "coverage",
-    ".next", ".nuxt", ".output", "vendor",
+    ".mypy_cache", "dist", "build", "target", ".gradle",
+    ".tox", ".eggs", "coverage", ".next", ".nuxt", ".output", "vendor",
 }
 
 _CODE_EXTENSIONS = {

sourcecode/serializer.py

@@ -121,10 +121,16 @@ def _dependency_groups(sm: SourceMap) -> dict[str, list[dict[str, Any]]]:
 
         if role in _PRODUCTION_DEP_ROLES and scope not in {"dev"}:
             groups["production_dependencies"].append(item)
+            _jvm_ecosystems = {"maven", "gradle", "java", "kotlin", "scala", "groovy"}
             if dep.source == "manifest" and name_key not in import_index:
-                suspect = dict(item)
-                suspect["reason"] = "declared as production dependency but no static import observed"
-                groups["suspicious_dependencies"].append(suspect)
+                if dep.ecosystem in _jvm_ecosystems:
+                    # Static import check unsupported for JVM: import index only covers
+                    # Python/JS/TS. Flagging JVM deps as suspicious produces only false positives.
+                    pass
+                else:
+                    suspect = dict(item)
+                    suspect["reason"] = "declared as production dependency but no static import observed"
+                    groups["suspicious_dependencies"].append(suspect)
         elif role in _TEST_DEP_ROLES:
             groups["test_utilities"].append(item)
         elif role in _BUILD_DEP_ROLES:

{sourcecode-0.44.0.dist-info → sourcecode-0.45.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 0.44.0
+Version: 0.45.0
 Summary: Deterministic codebase context for AI coding agents
 License:                                  Apache License
                                    Version 2.0, January 2004

{sourcecode-0.44.0.dist-info → sourcecode-0.45.0.dist-info}/RECORD

@@ -1,21 +1,21 @@
-sourcecode/__init__.py,sha256=2Lz--0KUPsKNbk6_eT1ko8NRsFtoDHnAHBo9uNtCIDo,103
+sourcecode/__init__.py,sha256=GGAUffktLLZY15PHqWZ0id9C28zA6fs7XQ7oxyKmNT0,103
 sourcecode/adaptive_scanner.py,sha256=6dh34C2qZXyRbw-8xBhbEwDdXanM6CRFRWayVoYITnA,10190
 sourcecode/architecture_analyzer.py,sha256=O4AXc7l_WTzIXrcAzstqZy-TGKNaFa6p3MzpgVjaO8g,27749
 sourcecode/architecture_summary.py,sha256=rSY5MRiaz4N1YdG0pqDTDuFjSN7PO_Zplx-dtNzv2Yo,19985
 sourcecode/ast_extractor.py,sha256=0OHQwTUBBc9lmqPLryVeB1z8dGIC6NhLlar800CD9oI,41129
 sourcecode/classifier.py,sha256=GKTMN8qKZX7ponSwDJfN08RrasI4CVpq1_gFBgEopps,7093
-sourcecode/cli.py,sha256=ON1YG8WzJ0Nb-zmlf65AzAgyCqkL1iiprJo2jwz6Pqk,68885
+sourcecode/cli.py,sha256=pjBq-ZIWqoBbESWorW2d0kIGtkby9urt_38ACCKqK1Q,71026
 sourcecode/code_notes_analyzer.py,sha256=rRd8bFYV0krjlxxQV0wenwE9K7pVpUQSR7KvSvUQKw4,9226
 sourcecode/confidence_analyzer.py,sha256=HxJMPLI5ulqtkncnv98W4iVO6yMbpQo87VuxiuNbDmY,12167
 sourcecode/context_scorer.py,sha256=nhppAo80fblAqcB9Ns0iQd21TZUrl2mQMo_xzPgavRE,14679
 sourcecode/context_summarizer.py,sha256=CiQrfBEzun949bWvmLabWoj2HhPn6Lw62ofqnsy0FlQ,6503
 sourcecode/contract_model.py,sha256=gCf9-Kj0G7l0lvRTAcRfFAfMgs1Rpizv4mKovQLYUkw,3434
-sourcecode/contract_pipeline.py,sha256=C3TJycL7pMRku7HQ5YbNFXxEZywtPQm8YaASRbYjs2g,24454
+sourcecode/contract_pipeline.py,sha256=wWkm0_zScUy-Q-mrAG57qysYxjNPOybjObxpwp859e0,24615
 sourcecode/coverage_parser.py,sha256=q0LeZJaX1bnntLu-ImksdBsMlpsVmk_iUfSaB4eaJGo,19702
 sourcecode/dependency_analyzer.py,sha256=Exq0BfInvfS5iAg9xAr6WI2uPNuotkIudTKcYJcRhB8,52757
 sourcecode/doc_analyzer.py,sha256=TttdS7mndKQhyJCfJnnAsyGCJrf-TIL7oXxDlTLUFKE,21248
 sourcecode/entrypoint_classifier.py,sha256=a69dMGyxCTd_LOm3oqj-EXWpRmbmeujN7T1mr2eJ1as,3877
-sourcecode/env_analyzer.py,sha256=NFV4PSeBH5GEONOIo2SY5iJRXuuqhAOlRDtTZMqOZTI,18452
+sourcecode/env_analyzer.py,sha256=YXlaxFBuf-ladWmb3iLCNMN-rKhP2JuqAIDwZdiIZHQ,18473
 sourcecode/file_classifier.py,sha256=_KfFIIolharaIxbSTrCkaWauQIqNHCyor_n47RGyDh8,8577
 sourcecode/git_analyzer.py,sha256=PD3eNWydznQ6KLNpxGzBqizIHoPIKevfwz9Xyf_pDt4,11600
 sourcecode/graph_analyzer.py,sha256=hMOsLLz9B0UnQ4xwbHdgr3bFvqpw0bQ8kN-xmEn3Krk,64156
@@ -29,7 +29,7 @@ sourcecode/runtime_classifier.py,sha256=zWX3r3HCKHc-qtIobErOa8aKMmaoPYREtJKvPcBG
 sourcecode/scanner.py,sha256=aM3h9-DCQ3xKpeHpHYdo2vX6T5P95HA_YwZbkAVNwmo,8288
 sourcecode/schema.py,sha256=ofEge9hTWHOTjeWt7ceCDQWzP-uhhenrYX2usjW2KVU,22759
 sourcecode/semantic_analyzer.py,sha256=16EFTgM7ooW0m5gNUKOlTSn7IEMLSzKmzQn-cWaSqjs,82604
-sourcecode/serializer.py,sha256=uDYSGjNjyrI2Qqvq23dl0owfi7zUVo8bwHBJ2RlGdz8,58975
+sourcecode/serializer.py,sha256=CBK_i1joiNl8aCjFgnyIMrEFhAVCAk_ltfOqot2yVC4,59361
 sourcecode/summarizer.py,sha256=ZuzIdm3t8A-d5MuQL0TSNLrd-L0IQIuguIxeNXMNJf8,16070
 sourcecode/tree_utils.py,sha256=Fj9OIuUksBvgibNd3feog0sMDjVypJzPexp5lvMoYWI,1424
 sourcecode/workspace.py,sha256=fQlVoNx8S-fSHpKoJ0JBvEHCFkxszH0KZVJed1i3TRk,6845
@@ -40,7 +40,7 @@ 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=Hab_Uiuxtq-WBs_wCnzETBS5hhaxeEtf-GOGMH63cv0,2887
+sourcecode/detectors/heuristic.py,sha256=bCqqgbHavl4Sse3dqT8mwmo1wAdgeJr7VyXOmfClLKo,3387
 sourcecode/detectors/hybrid.py,sha256=IGFRUVsAZ1ooRlFdznCeJAV6vy1yVDx-VyghvLtddXc,9101
 sourcecode/detectors/java.py,sha256=cZvB13cqJ76zHDncEG-TOCuK8gJjJN2mZGS2DGEcZy8,7715
 sourcecode/detectors/jvm_ext.py,sha256=EgHJ5W8EE-ZTN9V607mVzohyKgZE8Mc2jCi-DF8RAZU,2616
@@ -60,8 +60,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-0.44.0.dist-info/METADATA,sha256=pxp0MxePWfJw419_NjcL3P8C2Rk4yjH9JqIKMyDuVqo,25209
-sourcecode-0.44.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-0.44.0.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
-sourcecode-0.44.0.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-0.44.0.dist-info/RECORD,,
+sourcecode-0.45.0.dist-info/METADATA,sha256=KxuymZTpmCBseOiKT5iavKPp7S2zJaYxpB11QEQqnjk,25209
+sourcecode-0.45.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-0.45.0.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
+sourcecode-0.45.0.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-0.45.0.dist-info/RECORD,,