sourcecode 1.8.0__tar.gz → 1.10.0__tar.gz

{sourcecode-1.8.0 → sourcecode-1.10.0}/PKG-INFO

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

{sourcecode-1.8.0 → sourcecode-1.10.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sourcecode"
-version = "1.8.0"
+version = "1.10.0"
 description = "Deterministic codebase context for AI coding agents"
 readme = "README.md"
 requires-python = ">=3.9"

{sourcecode-1.8.0 → sourcecode-1.10.0}/src/sourcecode/__init__.py

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

{sourcecode-1.8.0 → sourcecode-1.10.0}/src/sourcecode/cli.py

@@ -1485,7 +1485,17 @@ def main(
         if _is_contract_mode and sm.file_contracts:
             from sourcecode.serializer import _serialize_contract_minimal
             data.pop("file_relevance", None)
-            data["contracts"] = [_serialize_contract_minimal(c) for c in sm.file_contracts]
+            _MAX_AGENT_CONTRACTS = 10
+            _all_contracts = sm.file_contracts
+            _sorted = sorted(_all_contracts, key=lambda c: getattr(c, "relevance_score", 0.0), reverse=True)
+            _sampled = _sorted[:_MAX_AGENT_CONTRACTS]
+            _total_contracts = len(_all_contracts)
+            data["contracts"] = [_serialize_contract_minimal(c) for c in _sampled]
+            data["contracts_meta"] = {
+                "total": _total_contracts,
+                "shown": len(_sampled),
+                "truncated": _total_contracts > _MAX_AGENT_CONTRACTS,
+            }
             if sm.contract_summary is not None:
                 cs = sm.contract_summary
                 data["contract_summary"] = {

{sourcecode-1.8.0 → sourcecode-1.10.0}/src/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:
@@ -958,7 +971,13 @@ def agent_view(sm: SourceMap) -> dict[str, Any]:
             "sections": _section_confidence(sm),
         }
         if cs.hard_signals:
-            conf["hard_signals"] = cs.hard_signals
+            _MAX_HARD_SIGNALS = 20
+            _hs = cs.hard_signals
+            _hs_total = len(_hs)
+            conf["hard_signals"] = _hs[:_MAX_HARD_SIGNALS]
+            if _hs_total > _MAX_HARD_SIGNALS:
+                conf["hard_signals_truncated"] = True
+                conf["hard_signals_total"] = _hs_total
         if cs.soft_signals:
             conf["soft_signals"] = cs.soft_signals
         if cs.ignored_signals:
@@ -1224,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)
@@ -1581,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)
@@ -1640,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: