sourcecode 1.19.0__tar.gz → 1.20.0__tar.gz

{sourcecode-1.19.0 → sourcecode-1.20.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.19.0
+Version: 1.20.0
 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
 
 **Compressed AI-ready context for Java/Spring enterprise codebases.**
 
-![Version](https://img.shields.io/badge/version-1.19.0-blue)
+![Version](https://img.shields.io/badge/version-1.20.0-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -255,7 +255,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.19.0
+# sourcecode 1.20.0
 ```
 
 ---

{sourcecode-1.19.0 → sourcecode-1.20.0}/README.md

@@ -2,7 +2,7 @@
 
 **Compressed AI-ready context for Java/Spring enterprise codebases.**
 
-![Version](https://img.shields.io/badge/version-1.19.0-blue)
+![Version](https://img.shields.io/badge/version-1.20.0-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -36,7 +36,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.19.0
+# sourcecode 1.20.0
 ```
 
 ---

{sourcecode-1.19.0 → sourcecode-1.20.0}/pyproject.toml

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

{sourcecode-1.19.0 → sourcecode-1.20.0}/src/sourcecode/__init__.py

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

{sourcecode-1.19.0 → sourcecode-1.20.0}/src/sourcecode/cli.py

@@ -1777,6 +1777,8 @@ def prepare_context_cmd(
         out["symptom"] = output.symptom
     if output.related_notes:
         out["related_notes"] = output.related_notes
+    if output.symptom_note:
+        out["symptom_note"] = output.symptom_note
     if llm_prompt:
         out["llm_prompt"] = builder.render_prompt(output)
 

{sourcecode-1.19.0 → sourcecode-1.20.0}/src/sourcecode/prepare_context.py

@@ -323,6 +323,7 @@ class TaskOutput:
     affected_entry_points: list[str] = field(default_factory=list) # delta task only
     symptom: Optional[str] = None                                  # fix-bug only
     related_notes: list[dict] = field(default_factory=list)        # fix-bug + symptom only
+    symptom_note: Optional[str] = None                             # fix-bug: cross-layer synonym note
 
 
 # ─────────────────────────────────────────────────────────────────────────────
@@ -382,6 +383,22 @@ _ALL_EXTENSIONS: frozenset[str] = _SOURCE_EXTENSIONS | frozenset({
     ".md", ".toml", ".yaml", ".yml", ".json", ".xml",
 })
 
+# Maps frontend symptom keywords → backend terms likely to contain the root cause.
+# Used to boost service/interceptor files when the symptom is UI-only.
+_FRONTEND_SYMPTOM_MAP: dict[str, list[str]] = {
+    "spinner":  ["loading", "setloading", "finalize", "httpinterceptor", "interceptor", "service"],
+    "loading":  ["loading", "setloading", "finalize", "httpinterceptor", "interceptor", "service"],
+    "login":    ["authcontroller", "securityconfig", "filterconfig", "jwtfilter", "auth", "authentication"],
+    "logout":   ["authcontroller", "securityconfig", "jwtfilter", "auth", "session"],
+    "dropdown": ["getmapping", "findall", "obtenertodos", "listall", "findby"],
+    "modal":    ["controller", "getmapping", "findby", "search"],
+    "popup":    ["controller", "getmapping", "findby", "search"],
+    "table":    ["paginated", "findby", "search", "getmapping", "listall"],
+    "grid":     ["paginated", "findby", "search", "getmapping"],
+    "button":   ["postmapping", "putmapping", "deletemapping", "controller", "service"],
+    "form":     ["postmapping", "putmapping", "controller", "service", "dto"],
+}
+
 
 class TaskContextBuilder:
     def __init__(self, root: Path) -> None:
@@ -635,6 +652,7 @@ class TaskContextBuilder:
         # ── 6b. Symptom keyword boost + related notes (fix-bug + --symptom) ──
         symptom_keywords: list[str] = []
         related_notes: list[dict] = []
+        symptom_note: Optional[str] = None
         if task_name == "fix-bug" and symptom:
             import re as _re
             _camel_expanded = _re.sub(r'([a-z])([A-Z])', r'\1 \2', symptom)
@@ -708,6 +726,41 @@ class TaskContextBuilder:
                     ))
                 relevant_files = sorted(_content_boosted, key=lambda rf: -rf.score)
 
+                # Cross-layer synonym boost: frontend keywords → backend equivalents
+                _synonym_note: Optional[str] = None
+                _frontend_kws = [kw for kw in symptom_keywords if kw in _FRONTEND_SYMPTOM_MAP]
+                if _frontend_kws:
+                    _backend_terms: list[str] = []
+                    for _fkw in _frontend_kws:
+                        _backend_terms.extend(_FRONTEND_SYMPTOM_MAP[_fkw])
+                    _backend_terms_set = list(dict.fromkeys(_backend_terms))  # dedup, preserve order
+                    _synonym_boosted: list[RelevantFile] = []
+                    for _rf in relevant_files:
+                        _extra_syn = 0.0
+                        if Path(_rf.path).suffix.lower() in _src_exts:
+                            try:
+                                _lines_syn = (self.root / _rf.path).read_text(
+                                    encoding="utf-8", errors="replace"
+                                ).splitlines()[:300]
+                                _body_syn = "\n".join(_lines_syn).lower()
+                                _hits_syn = sum(_body_syn.count(t) for t in _backend_terms_set)
+                                _extra_syn = min(0.20, _hits_syn * 0.02)
+                            except OSError:
+                                pass
+                        _synonym_boosted.append(RelevantFile(
+                            path=_rf.path,
+                            role=_rf.role,
+                            score=round(min(_rf.score + _extra_syn, 1.0), 2),
+                            reason=_rf.reason + (f", synonym-match backend (+{_extra_syn:.2f})" if _extra_syn > 0 else ""),
+                            why=_rf.why,
+                        ))
+                    relevant_files = sorted(_synonym_boosted, key=lambda rf: -rf.score)
+                    _synonym_note = (
+                        f"Frontend concept detected ({', '.join(_frontend_kws)}). "
+                        "Boosted backend service-layer and interceptor files as likely root cause."
+                    )
+                    symptom_note = _synonym_note
+
         # ── 7. Test gaps (generate-tests only) ────────────────────────────
         test_gaps: list[str] = []
         if task_name == "generate-tests":
@@ -788,6 +841,7 @@ class TaskContextBuilder:
             affected_entry_points=affected_entry_points,
             symptom=symptom if task_name == "fix-bug" and symptom else None,
             related_notes=related_notes,
+            symptom_note=symptom_note,
         )
 
     def render_prompt(self, output: TaskOutput) -> str:

{sourcecode-1.19.0 → sourcecode-1.20.0}/src/sourcecode/serializer.py

@@ -356,6 +356,7 @@ def _mybatis_pairing(sm: "SourceMap", *, full: bool = False) -> "Optional[dict[s
         result["dto_mappers_total"] = _total_dto
         if _total_dto > 10 and not full:
             result["dto_mappers_truncated"] = True
+            result["dto_mappers_warning"] = f"Showing 10/{_total_dto} mappers. Use --full to see all."
     return result
 
 
@@ -894,6 +895,41 @@ def _serialize_file_metric(m: Any) -> dict[str, Any]:
     return d
 
 
+def _confidence_reasons(sm: SourceMap) -> dict[str, list[str]]:
+    """Actionable reasons explaining low-confidence sections.
+
+    If a section is 'low' with no derivable reasons, the caller should
+    upgrade it to 'high' (the low rating was overly conservative).
+    """
+    reasons: dict[str, list[str]] = {}
+
+    arch = sm.architecture
+    if arch and arch.requested and arch.confidence == "low":
+        arch_reasons: list[str] = []
+        for lim in (arch.limitations or []):
+            if lim:
+                arch_reasons.append(lim)
+        if sm.analysis_gaps:
+            for gap in sm.analysis_gaps:
+                if gap.area in ("api_contract", "architecture", "documentation"):
+                    arch_reasons.append(gap.reason)
+        else:
+            _has_openapi = any(
+                p.endswith(("openapi.yaml", "openapi.yml", "openapi.json", "swagger.yaml", "swagger.json"))
+                or "swagger" in p.lower() or "springdoc" in p.lower()
+                for p in sm.file_paths
+            )
+            if not _has_openapi:
+                arch_reasons.append("No OpenAPI/Swagger spec found — API surface unverifiable")
+        if arch.bounded_contexts:
+            bc_count = len(arch.bounded_contexts)
+            arch_reasons.append(f"bounded_contexts detected: {bc_count}")
+        if arch_reasons:
+            reasons["architecture"] = arch_reasons
+
+    return reasons
+
+
 def _section_confidence(sm: SourceMap) -> dict[str, str]:
     cs = sm.confidence_summary
     dep_conf = "low"
@@ -1481,9 +1517,16 @@ def agent_view(sm: SourceMap, *, full: bool = False) -> dict[str, Any]:
     result["architecture"] = _architecture_context(sm)
 
     # ── 3a. File relevance: evidence-backed, high-signal only ────────────────
-    relevant_files = _file_relevance(sm)
+    _FR_AGENT_CAP = 20
+    _total_paths = len(sm.file_paths)
+    relevant_files = _file_relevance(sm, limit=_FR_AGENT_CAP if not full else _total_paths)
     if relevant_files:
         result["file_relevance"] = relevant_files
+        if not full and _total_paths > _FR_AGENT_CAP:
+            result["file_relevance_hint"] = (
+                f"Showing top {_FR_AGENT_CAP}/{_total_paths} files by score. "
+                "Use --full to see all."
+            )
 
     # ── 3b. Monorepo package roles (when available), capped ──────────────────
     if sm.monorepo_packages:
@@ -1638,6 +1681,16 @@ def agent_view(sm: SourceMap, *, full: bool = False) -> dict[str, Any]:
             conf["anomalies"] = cs.anomalies
         result["confidence_summary"] = conf
 
+    # ── 6a. Confidence reasons: explain any low-confidence section ────────────
+    _conf_reasons = _confidence_reasons(sm)
+    if _conf_reasons:
+        result["confidence_reasons"] = _conf_reasons
+    elif (sm.architecture and sm.architecture.requested
+          and sm.architecture.confidence == "low"
+          and "confidence_summary" in result):
+        # No reasons found → low was overly conservative; upgrade to high
+        result["confidence_summary"].setdefault("sections", {})["architecture"] = "high"
+
     # ── 7. Analysis gaps ──────────────────────────────────────────────────────
     analysis_gaps: list[dict[str, Any]] = []