sourcecode 1.30.21__py3-none-any.whl → 1.30.22__py3-none-any.whl

sourcecode/__init__.py

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

sourcecode/cli.py

@@ -1610,11 +1610,10 @@ def _serialize_relevant_file(f: Any) -> dict:
     d = {k: v for k, v in _asdict(f).items() if v != "" and v is not None}
     reason = d.pop("reason", "") or ""
     why = d.pop("why", "") or ""
+    d.pop("score", None)  # score removed from public output (internal ranking only)
     explanation = _make_explanation(reason, why)
     if explanation:
         d["explanation"] = explanation
-    if reason:
-        d["reason"] = reason
     return d
 
 
@@ -1882,9 +1881,14 @@ def prepare_context_cmd(
     def _task_include(field: str) -> bool:
         return _content_filter.get(field, True)
 
+    _run_id = hashlib.sha256(
+        f"{task}:{target}:{since or ''}:{format or ''}:{symptom or ''}".encode()
+    ).hexdigest()[:16]
+
     out: dict[str, Any] = {
         "task": output.task,
         "goal": output.goal,
+        "run_id": _run_id,
     }
     if _task_include("project_summary"):
         out["project_summary"] = output.project_summary
@@ -1935,6 +1939,30 @@ def prepare_context_cmd(
                 _sys.stdout.buffer.write(b"\n")
                 _sys.stdout.buffer.flush()
             raise typer.Exit(code=1)
+        if output.ci_decision == "no_changes":
+            # Early exit: no diff — emit minimal JSON without any analysis fields.
+            # Prevents no_changes from ever being serialized alongside relevant_files > 0.
+            _nc_out: dict[str, Any] = {
+                "task": output.task,
+                "ci_decision": "no_changes",
+                "summary": "No changes detected",
+            }
+            if output.since:
+                _nc_out["since"] = output.since
+            if output.analysis_scope:
+                _nc_out["analysis_scope"] = output.analysis_scope
+            _nc_json = json.dumps(_nc_out, indent=2, ensure_ascii=False)
+            if output_path is not None:
+                output_path.write_text(_nc_json, encoding="utf-8")
+            else:
+                import sys as _sys
+                _sys.stdout.buffer.write(_nc_json.encode("utf-8"))
+                _sys.stdout.buffer.write(b"\n")
+                _sys.stdout.buffer.flush()
+            if copy:
+                _copy_to_clipboard(_nc_json)
+                typer.echo("✓ copied to clipboard", err=True)
+            raise typer.Exit()
         if output.ci_decision:
             out["ci_decision"] = output.ci_decision
         if output.since:

sourcecode/prepare_context.py

@@ -377,6 +377,25 @@ class TaskOutput:
     analysis_scope: dict = field(default_factory=dict)
 
 
+@dataclass
+class CanonicalAnalysisIR:
+    """Shared intermediate representation produced by _build_delta_impact.
+
+    Both delta and review-pr derive their task-specific output from this IR.
+    Never recalculate logic per command — render views from this single object.
+    """
+    relevant_files: list[RelevantFile]
+    impact_summary: str
+    affected_modules: list[str]
+    risk_areas: list[dict]
+    why_these_files: dict[str, str]
+    analysis_gaps: list[str]
+    system_impact: dict
+    change_type: list[str]
+    dependency_graph_summary: dict
+    impact_score_per_file: dict
+
+
 # ─────────────────────────────────────────────────────────────────────────────
 # Builder
 # ─────────────────────────────────────────────────────────────────────────────
@@ -934,7 +953,8 @@ class TaskContextBuilder:
         test_set = {p for p in all_paths if self._is_test(p)}
         source_set = {p for p in all_paths if not self._is_test(p) and self._is_source(p)}
 
-        # Delta uses a dedicated impact-analysis path — never the generic ranker.
+        # Delta and review-pr share CanonicalAnalysisIR — computed once, rendered per task.
+        _ir: Optional[CanonicalAnalysisIR] = None
         _delta_impact_summary: Optional[str] = None
         _delta_affected_modules: list[str] = []
         _delta_risk_areas: list[dict] = []
@@ -947,23 +967,22 @@ class TaskContextBuilder:
 
         if task_name in ("delta", "review-pr"):
             _delta_changed_list: list[str] = sorted(_delta_files) if _delta_files else []
-            (
-                relevant_files,
-                _delta_impact_summary,
-                _delta_affected_modules,
-                _delta_risk_areas,
-                _delta_why,
-                _delta_analysis_gaps,
-                _delta_system_impact,
-                _delta_change_type,
-                _delta_dep_graph_summary,
-                _delta_impact_score_per_file,
-            ) = self._build_delta_impact(
+            _ir = self._build_delta_impact(
                 changed_files=_delta_changed_list,
                 all_paths=all_paths,
                 entry_points=entry_points,
                 since=since,
             )
+            relevant_files = _ir.relevant_files
+            _delta_impact_summary = _ir.impact_summary
+            _delta_affected_modules = _ir.affected_modules
+            _delta_risk_areas = _ir.risk_areas
+            _delta_why = _ir.why_these_files
+            _delta_analysis_gaps = _ir.analysis_gaps
+            _delta_system_impact = _ir.system_impact
+            _delta_change_type = _ir.change_type
+            _delta_dep_graph_summary = _ir.dependency_graph_summary
+            _delta_impact_score_per_file = _ir.impact_score_per_file
         else:
             relevant_files = self._rank_files(
                 task_name, spec, all_paths, entry_set, test_set,
@@ -2297,13 +2316,10 @@ class TaskContextBuilder:
         all_paths: list[str],
         entry_points: list,
         since: Optional[str],
-    ) -> tuple[list[RelevantFile], str, list[str], list[dict[str, Any]], dict[str, str], list[str]]:
+    ) -> "CanonicalAnalysisIR":
         """Build incremental impact analysis for changed files.
 
-        Returns:
-            (relevant_files, impact_summary, affected_modules, risk_areas,
-             why_these_files, analysis_gaps)
-
+        Returns CanonicalAnalysisIR — the shared IR consumed by delta and review-pr views.
         Changed files are always included in relevant_files (never dropped by score).
         Related files are expanded type-aware: controller→service→repository→mapper chain.
         Scoring is hierarchical by artifact_type, not by heuristic impact_level.
@@ -2471,6 +2487,18 @@ class TaskContextBuilder:
                 return "data_access"
             if atype == "service":
                 return "service"   # annotation-confirmed — not "core_service" (overclaim)
+            # Name-pattern heuristics — only when atype alone gave no verdict.
+            # These are INFERRED (LOW CONFIDENCE) — stem match, not annotation evidence.
+            if any(kw in stem_lower for kw in ("validator", "validation")):
+                return "validation_component"
+            if any(kw in stem_lower for kw in ("controller", "resource", "endpoint", "rest")):
+                return "external_interface"
+            if any(kw in stem_lower for kw in ("service", "svc", "usecase", "facade")):
+                return "service"
+            if any(kw in stem_lower for kw in ("repository", "repo", "dao", "store")):
+                return "data_access"
+            if any(kw in stem_lower for kw in ("config", "configuration", "settings", "properties")):
+                return "configuration"
             return "unclassified"   # no role claim without evidence
 
         def _structured_why(path: str, atype: str, module: str, role: str, risk_areas: list[str], cls_confidence: str = "low") -> str:
@@ -2491,17 +2519,17 @@ class TaskContextBuilder:
             return " | ".join(parts)
 
         if not changed_files:
-            return (
-                [],
-                "No changes detected — verify the git ref passed to --since",
-                [],
-                [],
-                {},
-                ["No changed files found. Check that --since ref exists and the diff is non-empty."],
-                {},   # system_impact
-                [],   # change_type
-                {"edges": [], "propagation_depth": 0},  # dependency_graph_summary
-                {},   # impact_score_per_file
+            return CanonicalAnalysisIR(
+                relevant_files=[],
+                impact_summary="No changes detected — verify the git ref passed to --since",
+                affected_modules=[],
+                risk_areas=[],
+                why_these_files={},
+                analysis_gaps=["No changed files found. Check that --since ref exists and the diff is non-empty."],
+                system_impact={},
+                change_type=[],
+                dependency_graph_summary={"edges": [], "propagation_depth": 0},
+                impact_score_per_file={},
             )
 
         ep_paths = {ep.path for ep in entry_points}
@@ -3026,17 +3054,17 @@ class TaskContextBuilder:
                 " — related file expansion uses directory proximity only"
             )
 
-        return (
-            relevant,
-            impact_summary,
-            sorted(affected_modules_set),
-            risk_areas_out,
-            why,
-            analysis_gaps,
-            system_impact,
-            aggregate_change_type,
-            dependency_graph_summary,
-            impact_score_per_file,
+        return CanonicalAnalysisIR(
+            relevant_files=relevant,
+            impact_summary=impact_summary,
+            affected_modules=sorted(affected_modules_set),
+            risk_areas=risk_areas_out,
+            why_these_files=why,
+            analysis_gaps=analysis_gaps,
+            system_impact=system_impact,
+            change_type=aggregate_change_type,
+            dependency_graph_summary=dependency_graph_summary,
+            impact_score_per_file=impact_score_per_file,
         )
 
     def _resolve_git_baseline(self, since: Optional[str]) -> dict[str, Any]:

{sourcecode-1.30.21.dist-info → sourcecode-1.30.22.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.30.21
+Version: 1.30.22
 Summary: Deterministic codebase context for AI coding agents
 License:                                  Apache License
                                    Version 2.0, January 2004
@@ -221,7 +221,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.30.21-blue)
+![Version](https://img.shields.io/badge/version-1.30.22-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -257,7 +257,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.30.21
+# sourcecode 1.30.22
 ```
 
 ---

{sourcecode-1.30.21.dist-info → sourcecode-1.30.22.dist-info}/RECORD

@@ -1,10 +1,10 @@
-sourcecode/__init__.py,sha256=q8jMIivc3FsE3hSo5FGkuHpx1X3y13jtp2XDM4rluM4,104
+sourcecode/__init__.py,sha256=d5lEITIIf1zIOm689tAJlsrD77TynMzXXXt1H2tvxjk,104
 sourcecode/adaptive_scanner.py,sha256=RTNExwWPXzjgLaRueT7UuxkPj5ZEToWjGbx1j0LSZ9E,10250
 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=pYve2J1LqtYssU3lYLMDz18PT-CjN5c18QYE7R_IG1Q,7507
-sourcecode/cli.py,sha256=D0Rrmvv9FYEi7nSWdM3FHeuyBCHcag8mD4yNDwuVGd8,91828
+sourcecode/cli.py,sha256=MhXLytfQdGp4L25c6gbhfJyeL5R11ox-wGo-wrO5Ph8,93201
 sourcecode/code_notes_analyzer.py,sha256=y1MJBnPZHYp4i6cQCXUb9ATIyifS_qMQWjw_8lPkpsU,9215
 sourcecode/confidence_analyzer.py,sha256=xw_Jv8pAd0wd8t2vvQlorw8Ih0rSF3YCoFS8K-_4aXg,15762
 sourcecode/context_scorer.py,sha256=QpChSpsmaAYz91rXA4Ue5xzQmNz_ZboZN09YOHScq1U,14679
@@ -22,7 +22,7 @@ sourcecode/git_analyzer.py,sha256=0Gyj-vMpIIN4nfriKXVRouNYBeJ59s6pQDX2Xu9Pq-U,13
 sourcecode/graph_analyzer.py,sha256=iUK-7pSV-cvGqqD2hENdYmhnm0wcXFEyK-xnu5ul8OU,62515
 sourcecode/metrics_analyzer.py,sha256=m0ENgtqKeBL17kUIK3fmGkgo7UfXBNHxCMj0H_Y5K7c,22750
 sourcecode/pr_comment_renderer.py,sha256=k5pCIP6iBNwy5UYPxu47CAq-62j4E9QZZOPyL3trH80,14799
-sourcecode/prepare_context.py,sha256=9cmlukZkTgce3d42c9sostGFjtuHf1jpo-s5cXKvVtY,158688
+sourcecode/prepare_context.py,sha256=g36iiJ_7XnDR1-M68vp0Pyb9v_n387G8JdcxXYj0TSI,160472
 sourcecode/progress.py,sha256=qn30sWaHOkjTgXsSBmiPkz7Rsbwc5oSlIe6JNEMYp_k,3149
 sourcecode/ranking_engine.py,sha256=virVglafZufioHpZpwktjMvUiL0TZELWQCQnQNV8dFo,9360
 sourcecode/redactor.py,sha256=xuGcadGEHaPw4qZXlMDvzMCsr4VOkdp3oBQptHyJk8c,2884
@@ -64,8 +64,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.30.21.dist-info/METADATA,sha256=lKGIEFslU42ts1gVizSK-CXaV5aWeVER95SXkboUCCc,28956
-sourcecode-1.30.21.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-1.30.21.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
-sourcecode-1.30.21.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-1.30.21.dist-info/RECORD,,
+sourcecode-1.30.22.dist-info/METADATA,sha256=01gxhfG0_4V4qosEA-V3HnFungaPYvRLR2wTs3aVsz0,28956
+sourcecode-1.30.22.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-1.30.22.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
+sourcecode-1.30.22.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-1.30.22.dist-info/RECORD,,