sourcecode 0.48.0__py3-none-any.whl → 1.0.0__py3-none-any.whl

sourcecode/__init__.py

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

sourcecode/cli.py

@@ -1445,8 +1445,10 @@ def main(
         data = agent_view(sm)
         # When contract pipeline ran (mode=contract, no legacy flags), include
         # per-file contracts in agent output so agents get structural context.
+        # Remove file_relevance — contracts cover this signal with more detail.
         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]
             if sm.contract_summary is not None:
                 cs = sm.contract_summary

sourcecode/contract_pipeline.py

@@ -27,8 +27,8 @@ from sourcecode.schema import EntryPoint, MonorepoPackageInfo
 # ---------------------------------------------------------------------------
 
 _MAX_FILES = 500          # hard cap on files extracted per run
-_MAX_CONTRACTS = 25       # default top-N output cap — omit rather than flood
-_MIN_CONTRACT_SCORE = 0.10  # drop contracts below this relevance threshold
+_MAX_CONTRACTS = 15       # default top-N output cap — omit rather than flood
+_MIN_CONTRACT_SCORE = 0.15  # drop contracts below this relevance threshold
 _SRC_EXTENSIONS: frozenset[str] = frozenset(_LANGUAGE_MAP.keys())
 
 

sourcecode/serializer.py

@@ -350,49 +350,72 @@ def _section_confidence(sm: SourceMap) -> dict[str, str]:
 
 
 def compact_view(sm: SourceMap, *, no_tree: bool = False) -> dict[str, Any]:
-    """Context package ready for prompt or handoff (~600-800 tokens).
+    """Context package ready for prompt or handoff (~300-500 tokens).
 
     Answers: what it is, where it enters, what depends on what,
     what signals matter, and what uncertainty exists.
 
     Includes: project_type, project_summary, architecture_summary,
-    stacks, entry_points, dependency_summary + key_dependencies (when analyzed),
+    stacks (minimal), entry_points (path+kind only), key_dependencies (name+version+role),
     env_summary (when analyzed), code_notes_summary (when analyzed),
-    confidence_summary, anomalies, analysis_gaps.
+    confidence (overall only), analysis_gaps.
 
-    Excludes: file_tree, raw dependency lists, docs, module_graph.
-    Empty sections are explained when relevant.
+    Excludes: file_tree, raw dependency lists, docs, module_graph, verbose metadata.
     """
-    dep_summary_dict: Any = None
+    # Key dependencies — name + version + role only (no ecosystem, source, manifests)
     key_deps: Any = None
     if sm.dependency_summary is not None and sm.dependency_summary.requested:
-        dep_summary_dict = asdict(sm.dependency_summary)
-        dep_summary_dict.pop("dependencies", None)
         key_deps = [
-            asdict(d) for d in sm.key_dependencies
+            {
+                "name": d.name,
+                **({"version": d.declared_version} if d.declared_version else {}),
+                **({"role": d.role} if d.role and d.role != "runtime" else {}),
+            }
+            for d in sm.key_dependencies
             if (d.role or "unknown") in _PRODUCTION_DEP_ROLES and d.scope not in {"dev"}
         ][:_KEY_DEPS_CAP]
-    elif sm.dependency_summary is None or not sm.dependency_summary.requested:
-        dep_summary_dict = None  # "not analyzed" — agent should add --dependencies
 
+    # Dependency summary — requested flag + count + source only
+    dep_summary_dict: Any = None
+    if sm.dependency_summary is not None and sm.dependency_summary.requested:
+        ds = sm.dependency_summary
+        dep_summary_dict = {
+            "requested": True,
+            "total_count": ds.total_count,
+            "direct": ds.direct_count,
+            **({"sources": ds.sources} if ds.sources else {}),
+        }
+
+    # Env map — key + required + category only (drop type_hint, files list)
     env_summary_dict: Any = None
     env_map_items: Any = None
     if sm.env_summary is not None and sm.env_summary.requested:
-        env_summary_dict = asdict(sm.env_summary)
+        env_summary_dict = {
+            "total": sm.env_summary.total,
+            "required": sm.env_summary.required_count,
+            **({"categories": sm.env_summary.categories} if sm.env_summary.categories else {}),
+        }
         if sm.env_map:
             _sorted_env = sorted(
                 sm.env_map,
                 key=lambda e: (not getattr(e, "required", False), getattr(e, "key", "")),
             )
             env_map_items = [
-                {k: v for k, v in asdict(e).items() if v is not None and v != "" and v != []}
+                {
+                    "key": getattr(e, "key", ""),
+                    **({"required": True} if getattr(e, "required", False) else {}),
+                    **({"category": getattr(e, "category", None)} if getattr(e, "category", None) else {}),
+                }
                 for e in _sorted_env[:_ENV_MAP_CAP]
             ]
 
+    # Code notes — kind + path + line + truncated text only
     code_notes_summary_dict: Any = None
     code_notes_items: Any = None
     if sm.code_notes_summary is not None and sm.code_notes_summary.requested:
-        code_notes_summary_dict = asdict(sm.code_notes_summary)
+        cn = sm.code_notes_summary
+        by_kind = {k: v for k, v in cn.by_kind.items() if v > 0}
+        code_notes_summary_dict = {"total": cn.total, **({"by_kind": by_kind} if by_kind else {})}
         if sm.code_notes:
             _SEVERITY_ORDER = {"BUG": 0, "FIXME": 1, "DEPRECATED": 2, "TODO": 3, "HACK": 4, "WARNING": 5}
             _sorted_notes = sorted(
@@ -400,43 +423,62 @@ def compact_view(sm: SourceMap, *, no_tree: bool = False) -> dict[str, Any]:
                 key=lambda n: (_SEVERITY_ORDER.get(getattr(n, "kind", "").upper(), 9), getattr(n, "path", "")),
             )
             code_notes_items = [
-                {k: v for k, v in asdict(n).items() if v is not None}
+                {
+                    "kind": getattr(n, "kind", ""),
+                    "path": getattr(n, "path", ""),
+                    "line": getattr(n, "line", None),
+                    **({"text": getattr(n, "text", "")[:60]} if getattr(n, "text", "") else {}),
+                }
                 for n in _sorted_notes[:_CODE_NOTES_CAP]
             ]
 
-    # Entry points: production runtime only, capped.
-    # Development entries shown separately; auxiliary omitted from compact view.
+    # Entry points — path + kind + confidence only
     ep_groups = _entry_point_groups(sm.entry_points)
-    entry_points_compact = ep_groups["production"][:_EP_PRODUCTION_CAP]
-    if not entry_points_compact:
-        entry_points_compact = []  # truth signal: no production runtime detected
+    entry_points_compact = [
+        {
+            "path": ep["path"],
+            **({"kind": ep["kind"]} if ep.get("kind") else {}),
+            **({"confidence": ep["confidence"]} if ep.get("confidence") else {}),
+        }
+        for ep in ep_groups["production"][:_EP_PRODUCTION_CAP]
+    ]
 
-    # Confidence summary
+    # Stacks — name + method + confidence + frameworks (names only)
+    stacks_compact = [
+        {
+            "stack": s.stack,
+            "detection_method": s.detection_method,
+            "confidence": s.confidence,
+            **({"primary": True} if s.primary else {}),
+            **({"frameworks": [f.name for f in s.frameworks]} if s.frameworks else {}),
+            **({"package_manager": s.package_manager} if s.package_manager else {}),
+        }
+        for s in sm.stacks
+    ]
+
+    # Confidence — overall only + anomalies
     conf_dict: Any = None
-    anomalies: Any = None
     if sm.confidence_summary is not None:
-        conf_dict = asdict(sm.confidence_summary)
-        if sm.confidence_summary.anomalies:
-            anomalies = sm.confidence_summary.anomalies
+        cs = sm.confidence_summary
+        conf_dict = {"overall": cs.overall, "stack": cs.stack_confidence, "entry_points": cs.entry_point_confidence}
+        if cs.anomalies:
+            conf_dict["anomalies"] = cs.anomalies
 
     # Analysis gaps
     gaps_list: Any = None
     if sm.analysis_gaps:
-        gaps_list = [asdict(g) for g in sm.analysis_gaps]
-
-    context_summary_dict: Any = None
-    if sm.context_summary is not None and sm.context_summary.requested:
-        context_summary_dict = asdict(sm.context_summary)
+        gaps_list = [
+            {"area": g.area, "reason": g.reason, "impact": g.impact}
+            for g in sm.analysis_gaps
+        ]
 
     result: dict[str, Any] = {
         "schema_version": sm.metadata.schema_version,
         "project_type": sm.project_type,
         "project_summary": sm.project_summary,
         "architecture_summary": sm.architecture_summary,
-        "context_summary": context_summary_dict,
-        "stacks": [asdict(stack) for stack in sm.stacks],
+        "stacks": stacks_compact,
         "entry_points": entry_points_compact,
-        "development_entry_points": (ep_groups["development"][:_EP_DEV_CAP] or None),
         "dependency_summary": dep_summary_dict,
         "key_dependencies": key_deps,
         "env_summary": env_summary_dict,
@@ -444,14 +486,10 @@ def compact_view(sm: SourceMap, *, no_tree: bool = False) -> dict[str, Any]:
         "code_notes_summary": code_notes_summary_dict,
         "code_notes": code_notes_items,
         "confidence_summary": conf_dict,
-        "anomalies": anomalies,
         "analysis_gaps": gaps_list,
     }
-    # Strip keys that are fully None and not informative
-    return {k: v for k, v in result.items() if v is not None or k in (
-        "project_type", "project_summary", "architecture_summary",
-        "dependency_summary", "confidence_summary",
-    )}
+    _always_include = {"project_type", "project_summary", "architecture_summary", "dependency_summary"}
+    return {k: v for k, v in result.items() if v is not None or k in _always_include}
 
 
 def normalize_source_map(sm: SourceMap) -> SourceMap:
@@ -1130,9 +1168,6 @@ def _contract_view_minimal(
         "project": project,
     }
 
-    if sm.metadata.traversal_topology:
-        result["traversal"] = sm.metadata.traversal_topology
-
     # Per-file contracts
     if contracts:
         serialized: list[dict[str, Any]] = []
@@ -1310,6 +1345,10 @@ def _compress_sig(name: str, sig: str, max_len: int = 100) -> str:
     return full
 
 
+_MAX_FN_PER_CONTRACT = 5   # max function signatures per contract (token budget)
+_MAX_SIG_LEN = 60          # max chars per compressed signature
+
+
 def _serialize_contract_minimal(c: Any) -> dict[str, Any]:
     """Serialize one FileContract to minimal format."""
     item: dict[str, Any] = {"path": c.path, "role": c.role}
@@ -1317,38 +1356,47 @@ def _serialize_contract_minimal(c: Any) -> dict[str, Any]:
     if c.is_changed:
         item["changed"] = True
 
-    # Exports: flat string for functions/unknown, {name,k} for others
-    # When all exports are same non-function kind, group them
-    if c.exports:
-        exs: list[Any] = []
-        kinds = {e.kind for e in c.exports}
-        if len(kinds) == 1 and "function" not in kinds and "unknown" not in kinds:
-            # All same non-function kind — compact: {"k": "class", "names": [...]}
-            only_kind = next(iter(kinds))
-            exs = [{"k": only_kind, "names": sorted(e.name for e in c.exports)}]
-        else:
-            for e in sorted(c.exports, key=lambda e: e.name):
-                if e.kind in ("function", "unknown"):
-                    exs.append(e.name)
-                else:
-                    exs.append({"name": e.name, "k": e.kind})
-        item["exports"] = exs
-
-    # External deps (non-stdlib already filtered in extractor)
-    if c.dependencies:
-        item["deps"] = sorted(c.dependencies)
-
-    # Exported function signatures — compressed
+    # Exported function signatures — compressed, capped
     exported_names = {e.name for e in c.exports}
+    fn_names_in_sigs: set[str] = set()
     if c.functions:
         fns = []
         for f in sorted(c.functions, key=lambda f: f.name):
             if not (f.exported or f.name in exported_names):
                 continue
-            fns.append(_compress_sig(f.name, f.signature))
+            fns.append(_compress_sig(f.name, f.signature, max_len=_MAX_SIG_LEN))
+            fn_names_in_sigs.add(f.name)
+            if len(fns) >= _MAX_FN_PER_CONTRACT:
+                break
         if fns:
             item["fn"] = fns
 
+    # Exports: omit function names already shown in fn; keep non-function exports
+    if c.exports:
+        exs: list[Any] = []
+        non_fn_exports = [e for e in c.exports if e.kind not in ("function", "unknown")]
+        fn_exports_not_in_sig = [
+            e for e in c.exports
+            if e.kind in ("function", "unknown") and e.name not in fn_names_in_sigs
+        ]
+        remaining = non_fn_exports + fn_exports_not_in_sig
+        if remaining:
+            kinds = {e.kind for e in remaining}
+            if len(kinds) == 1 and "function" not in kinds and "unknown" not in kinds:
+                only_kind = next(iter(kinds))
+                exs = [{"k": only_kind, "names": sorted(e.name for e in remaining)}]
+            else:
+                for e in sorted(remaining, key=lambda e: e.name):
+                    if e.kind in ("function", "unknown"):
+                        exs.append(e.name)
+                    else:
+                        exs.append({"name": e.name, "k": e.kind})
+            item["exports"] = exs
+
+    # External deps (non-stdlib already filtered in extractor)
+    if c.dependencies:
+        item["deps"] = sorted(c.dependencies)
+
     # Types: skip if fully covered by exports (avoids duplication in model files)
     if c.types:
         export_names_set = {e.name for e in c.exports}
@@ -1363,12 +1411,6 @@ def _serialize_contract_minimal(c: Any) -> dict[str, Any]:
     if c.hooks_used:
         item["hooks"] = c.hooks_used
 
-    # Ranking signals: why this file was ranked here
-    if getattr(c, "ranking_reasons", None):
-        non_trivial = [r for r in c.ranking_reasons if r not in ("source file", "noise")]
-        if non_trivial:
-            item["why"] = non_trivial
-
     return item
 
 

{sourcecode-0.48.0.dist-info → sourcecode-1.0.0.dist-info}/METADATA

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

{sourcecode-0.48.0.dist-info → sourcecode-1.0.0.dist-info}/RECORD

@@ -1,16 +1,16 @@
-sourcecode/__init__.py,sha256=eHhCx5iLdI9jgLRDyF8PiWmNdiWkspKJ_HwyUbcfVP0,103
+sourcecode/__init__.py,sha256=ZYQhk-Q7wjL_jfJS398d9Y2BPlzoHCjDAh6exi9L7JI,102
 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=BC83AWW3oSIWcQM8IPN0tU-1bSb2NyhkMS_Fyi3bRRc,71887
+sourcecode/cli.py,sha256=YusMOF5OfihL3nBw66LcANRFSiVHugPrXE0vPIycjLQ,72016
 sourcecode/code_notes_analyzer.py,sha256=rRd8bFYV0krjlxxQV0wenwE9K7pVpUQSR7KvSvUQKw4,9226
 sourcecode/confidence_analyzer.py,sha256=HxJMPLI5ulqtkncnv98W4iVO6yMbpQo87VuxiuNbDmY,12167
 sourcecode/context_scorer.py,sha256=QpChSpsmaAYz91rXA4Ue5xzQmNz_ZboZN09YOHScq1U,14679
 sourcecode/context_summarizer.py,sha256=CiQrfBEzun949bWvmLabWoj2HhPn6Lw62ofqnsy0FlQ,6503
 sourcecode/contract_model.py,sha256=gCf9-Kj0G7l0lvRTAcRfFAfMgs1Rpizv4mKovQLYUkw,3434
-sourcecode/contract_pipeline.py,sha256=Ua48J97RO6xUvpvZSAFJ27W4-Q5K9dJrzIo-dDEugIQ,25686
+sourcecode/contract_pipeline.py,sha256=eann6PZJ8Bg2zavaOhmfN_oy9rMWNSkKPDW68rRZV8E,25686
 sourcecode/coverage_parser.py,sha256=q0LeZJaX1bnntLu-ImksdBsMlpsVmk_iUfSaB4eaJGo,19702
 sourcecode/dependency_analyzer.py,sha256=Exq0BfInvfS5iAg9xAr6WI2uPNuotkIudTKcYJcRhB8,52757
 sourcecode/doc_analyzer.py,sha256=TttdS7mndKQhyJCfJnnAsyGCJrf-TIL7oXxDlTLUFKE,21248
@@ -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=xMUcQjdcUfVJ9U2nWfo_IAw5X3M_cnM5rkJiIzIiZ6s,62626
+sourcecode/serializer.py,sha256=Il-gUEVmVNOX3uA7A9HHf8n64ZoHSC9AqW5qaVTZUBs,64362
 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
@@ -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.48.0.dist-info/METADATA,sha256=CFDL7EnHtt8gWbDzuhQ10QO5z9KIFgM1pOv7O3m48mg,25209
-sourcecode-0.48.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-0.48.0.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
-sourcecode-0.48.0.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-0.48.0.dist-info/RECORD,,
+sourcecode-1.0.0.dist-info/METADATA,sha256=E8Jq944wOl_8nMXiZPj0T75q2WKWd1SjXwGQrKnXbhM,25208
+sourcecode-1.0.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-1.0.0.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
+sourcecode-1.0.0.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-1.0.0.dist-info/RECORD,,