sourcecode 1.9.0__py3-none-any.whl → 1.10.0__py3-none-any.whl

sourcecode/__init__.py

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

sourcecode/serializer.py

@@ -38,6 +38,19 @@ _MONOREPO_PKGS_CAP = 8       # max workspace/runtime packages shown
 _KEY_DEPS_CAP = 50           # max key dependencies shown
 _CODE_NOTES_CAP = 15         # max code notes in default output
 _ENV_MAP_CAP = 15            # max env var entries in default output
+_MAX_DEFAULT_CONTRACTS = 20  # max contracts in default/standard contract output
+_MAX_HARD_SIGNALS_DEFAULT = 20  # max hard_signals entries in default output
+
+
+def _cap_contracts_for_output(
+    contracts: list[Any],
+    max_count: int = _MAX_DEFAULT_CONTRACTS,
+) -> tuple[list[Any], dict[str, Any]]:
+    """Sort contracts by relevance_score desc, cap to max_count, return (sampled, meta)."""
+    total = len(contracts)
+    sampled = sorted(contracts, key=lambda c: getattr(c, "relevance_score", 0.0), reverse=True)[:max_count]
+    meta: dict[str, Any] = {"total": total, "shown": len(sampled), "truncated": total > max_count}
+    return sampled, meta
 
 
 def to_json(sm: SourceMap | dict[str, Any], indent: int = 2) -> str:
@@ -1230,13 +1243,11 @@ def _contract_view_minimal(
     if getattr(sm, "app_server_hint", None):
         result["app_server_hint"] = sm.app_server_hint
 
-    # Per-file contracts
+    # Per-file contracts — capped to avoid token bloat on large projects
     if contracts:
-        serialized: list[dict[str, Any]] = []
-        for c in contracts:
-            item = _serialize_contract_minimal(c)
-            serialized.append(item)
-        result["contracts"] = serialized
+        _capped, _meta = _cap_contracts_for_output(contracts)
+        result["contracts"] = [_serialize_contract_minimal(c) for c in _capped]
+        result["contracts_meta"] = _meta
 
     # Optional analysis sections — included when the analyzer explicitly ran
     # (user passed --dependencies, --env-map, --code-notes, --git-context)
@@ -1587,10 +1598,11 @@ def _contract_view_standard(
             "stack": sm.confidence_summary.stack_confidence,
         }
 
-    # Per-file contracts (full detail)
+    # Per-file contracts (full detail) — capped to avoid token bloat on large projects
     if contracts:
+        _capped, _meta = _cap_contracts_for_output(contracts)
         serialized: list[dict[str, Any]] = []
-        for c in contracts:
+        for c in _capped:
             if getattr(c, "language", None) == "mybatis-xml":
                 item = _serialize_contract_mybatis_xml(c)
                 item["relevance_score"] = round(c.relevance_score, 3)
@@ -1646,6 +1658,7 @@ def _contract_view_standard(
             item["method"] = c.extraction_method
             serialized.append(item)
         result["contracts"] = serialized
+        result["contracts_meta"] = _meta
 
     # Optional analysis sections (deep mode or when analyzers ran)
     if include_optional:

{sourcecode-1.9.0.dist-info → sourcecode-1.10.0.dist-info}/METADATA

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

{sourcecode-1.9.0.dist-info → sourcecode-1.10.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-sourcecode/__init__.py,sha256=7vT9zGHBIzJnrOurwpOa5S9QoTVH_lpybnxNKWeq4Kg,102
+sourcecode/__init__.py,sha256=GIBn7xub4gRHF7c7fnnLnviXbqQHlPBBIqawhO-HQKQ,103
 sourcecode/adaptive_scanner.py,sha256=RTNExwWPXzjgLaRueT7UuxkPj5ZEToWjGbx1j0LSZ9E,10250
 sourcecode/architecture_analyzer.py,sha256=oPmGPf9_p6y8Z7SIGHEu57nVYwxycIovDzBvlHl-l5k,32557
 sourcecode/architecture_summary.py,sha256=J9yoLgh8wXwIRrT6q6JooB6PekivbOEYpJz4BUXdalk,20545
@@ -30,7 +30,7 @@ sourcecode/runtime_classifier.py,sha256=zWX3r3HCKHc-qtIobErOa8aKMmaoPYREtJKvPcBG
 sourcecode/scanner.py,sha256=aM3h9-DCQ3xKpeHpHYdo2vX6T5P95HA_YwZbkAVNwmo,8288
 sourcecode/schema.py,sha256=rNxpDUgOfvJDzz6DKitL-5_0UAh0YomNwTsSSe8PafY,24066
 sourcecode/semantic_analyzer.py,sha256=12TwXYkYbDcBdu0heX_EmfPM2EkO8a_r5osf0SaeQbs,88956
-sourcecode/serializer.py,sha256=LQuAb2YNkNhckuT9fYNCrRe3TV_BJkPlgbb85Cwsyoo,70001
+sourcecode/serializer.py,sha256=ZcMh8p3XMmdSexHxR8AsmA8TjOFCKbXXxnJI8TCSFwY,70836
 sourcecode/summarizer.py,sha256=ZuzIdm3t8A-d5MuQL0TSNLrd-L0IQIuguIxeNXMNJf8,16070
 sourcecode/tree_utils.py,sha256=Fj9OIuUksBvgibNd3feog0sMDjVypJzPexp5lvMoYWI,1424
 sourcecode/workspace.py,sha256=X_6NmNnitvT3_38V-JDChydo_sR68s249hLFlrQskU0,8271
@@ -61,8 +61,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.9.0.dist-info/METADATA,sha256=lyqhpfo9LG4IjfyXZ8QBhqfTncocJBA7_cKPKO3PEP4,20411
-sourcecode-1.9.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-1.9.0.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
-sourcecode-1.9.0.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-1.9.0.dist-info/RECORD,,
+sourcecode-1.10.0.dist-info/METADATA,sha256=96dUJ1T_kbtCJS-5VGvdaUCvHlJNAJmTu7MFhmLkOVM,20412
+sourcecode-1.10.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-1.10.0.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
+sourcecode-1.10.0.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-1.10.0.dist-info/RECORD,,