sourcecode 1.30.27__py3-none-any.whl → 1.30.28__py3-none-any.whl

sourcecode/__init__.py

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

sourcecode/cli.py

@@ -424,7 +424,7 @@ def main(
     no_redact: bool = typer.Option(
         False,
         "--no-redact",
-        help="Disable secret redaction. Use with caution — output may contain sensitive values.",
+        help="Disable secret redaction of output strings. Note: env var values from the OS are never included in output regardless of this flag (security policy).",
     ),
     version: Optional[bool] = typer.Option(
         None,
@@ -437,7 +437,7 @@ def main(
     depth: int = typer.Option(
         4,
         "--depth",
-        help="File tree traversal depth (default: 4). Java/Maven projects auto-adjust to 12.",
+        help="File tree traversal depth (default: 4). Java/Maven projects auto-adjust to a minimum of 12; values below 12 have no effect on Java projects.",
         min=1,
         max=20,
     ),
@@ -1734,6 +1734,11 @@ def prepare_context_cmd(
         help="Emit per-phase timing to stderr (git scan ms, symptom scoring ms, total ms)",
         hidden=True,
     ),
+    fast: bool = typer.Option(
+        False,
+        "--fast",
+        help="Skip deep analysis (content search, test gap discovery, code annotations). Uses manifest/metadata only. Target: < 6 s.",
+    ),
 ) -> None:
     """Task-specific context for AI coding agents.
 
@@ -1808,9 +1813,14 @@ def prepare_context_cmd(
     if since:
         _phase += f" since {since}"
     _progress.start(_phase)
+    if not fast:
+        import sys as _sys
+        if _sys.stderr.isatty():
+            _sys.stderr.write(f"Analyzing ({task})... (deep scan may take 15–35 s for large codebases)\n")
+            _sys.stderr.flush()
     _t0 = _time.perf_counter()
     try:
-        output = builder.build(task, since=since, symptom=symptom)
+        output = builder.build(task, since=since, symptom=symptom, fast=fast)
     finally:
         _progress.finish()
     _t_total = (_time.perf_counter() - _t0) * 1000
@@ -1960,8 +1970,8 @@ def prepare_context_cmd(
                 _sys.stdout.buffer.write(b"\n")
                 _sys.stdout.buffer.flush()
             if copy:
-                _copy_to_clipboard(_nc_json)
-                typer.echo("✓ copied to clipboard", err=True)
+                if _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
@@ -2082,6 +2092,10 @@ def prepare_context_cmd(
         out["symptom_note"] = output.symptom_note
     if output.symptom_explain:
         out["symptom_explain"] = output.symptom_explain
+    if getattr(output, "symptom_hint", None):
+        out["symptom_hint"] = output.symptom_hint
+    if getattr(output, "warnings", None):
+        out["warnings"] = output.warnings
     if llm_prompt:
         out["llm_prompt"] = builder.render_prompt(output)
 

sourcecode/prepare_context.py

@@ -335,6 +335,7 @@ class TaskOutput:
     related_notes: list[dict] = field(default_factory=list)        # fix-bug + symptom only
     symptom_note: Optional[str] = None                             # fix-bug: cross-layer synonym note
     symptom_explain: Optional[dict] = None                         # fix-bug: structured evidence breakdown
+    symptom_hint: Optional[str] = None                             # fix-bug: redirect hint when term not found in this module
     # delta-specific impact fields
     impact_summary: Optional[str] = None
     affected_modules: list[str] = field(default_factory=list)
@@ -348,6 +349,7 @@ class TaskOutput:
     error_code: Optional[str] = None
     error_message: Optional[str] = None
     error_hints: list[str] = field(default_factory=list)
+    warnings: list[dict] = field(default_factory=list)             # structured warnings (REF_NOT_FOUND, etc.)
     # CI decision state machine — machine-decidable signal
     ci_decision: Optional[str] = None  # "no_changes" | "analysis_success" | "git_ref_error" | "no_git_repo"
     # git baseline resolution metadata
@@ -683,7 +685,7 @@ class TaskContextBuilder:
     def __init__(self, root: Path) -> None:
         self.root = root
 
-    def build(self, task_name: str, *, since: Optional[str] = None, symptom: Optional[str] = None) -> TaskOutput:
+    def build(self, task_name: str, *, since: Optional[str] = None, symptom: Optional[str] = None, fast: bool = False) -> TaskOutput:
         if task_name not in TASKS:
             raise ValueError(
                 f"Unknown task '{task_name}'. Available: {', '.join(TASKS)}"
@@ -880,7 +882,7 @@ class TaskContextBuilder:
         improvement_opportunities: list[str] = []
         cn_notes_for_ranking: list = []
 
-        if spec.enable_code_notes:
+        if spec.enable_code_notes and not fast:
             from dataclasses import asdict
             from sourcecode.code_notes_analyzer import CodeNotesAnalyzer
 
@@ -1317,6 +1319,7 @@ class TaskContextBuilder:
         related_notes: list[dict] = []
         symptom_note: Optional[str] = None
         symptom_explain: Optional[dict] = None
+        symptom_hint: 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)
@@ -1537,9 +1540,30 @@ class TaskContextBuilder:
                     ),
                 }
 
+                # BUG #4: LOW confidence + 0 content matches → clear suspected_areas,
+                # emit actionable redirect instead of unrelated files.
+                if _sx_confidence == "LOW" and not _sx_content:
+                    suspected_areas = []
+                    _is_fe_term = any(kw in _FRONTEND_SYMPTOM_MAP for kw in symptom_keywords)
+                    _root_name = self.root.name
+                    if _is_fe_term:
+                        _fe_redirect = (
+                            f"Term {symptom!r} not found in sources under {_root_name!r}. "
+                            f"This appears to be a frontend symptom. "
+                            f"Try: prepare-context fix-bug . --symptom {symptom!r} "
+                            f"(monorepo root) or target a frontend sub-project directly."
+                        )
+                    else:
+                        _fe_redirect = (
+                            f"Term {symptom!r} not found in sources under {_root_name!r}. "
+                            f"Verify the spelling or try a related term. "
+                            f"If this is a frontend symptom, run against the frontend sub-project."
+                        )
+                    symptom_hint = _fe_redirect
+
         # ── 7. Test gaps (generate-tests only) ────────────────────────────
         test_gaps: list[str] = []
-        if task_name == "generate-tests":
+        if task_name == "generate-tests" and not fast:
             def _normalize_test_stem(stem: str) -> str:
                 # Java: FooTest / FooTests → Foo; TestFoo → Foo
                 if stem.endswith("Tests"):
@@ -1683,6 +1707,8 @@ class TaskContextBuilder:
             resolved_since_ref=_delta_baseline.get("resolved_ref") if task_name == "delta" else None,
             resolution_path=_delta_baseline.get("resolution_path") if task_name == "delta" else None,
             diff_validation_status=_delta_baseline.get("diff_validation_status") if task_name == "delta" else None,
+            warnings=_delta_baseline.get("warnings", []) if task_name == "delta" else [],
+            symptom_hint=symptom_hint if task_name == "fix-bug" else None,
         )
 
     def render_prompt(self, output: TaskOutput) -> str:
@@ -3261,6 +3287,7 @@ class TaskContextBuilder:
                         "resolution_path": "head_minus_1_fallback",
                         "diff_validation_status": "invalid_ref",  # original ref unresolved
                         "error": False,
+                        "warnings": [{"code": "REF_NOT_FOUND", "ref": since, "resolved_to": "HEAD~1"}],
                     }
 
             # All stages failed

sourcecode/serializer.py

@@ -248,6 +248,16 @@ def _compact_git_context(sm: "SourceMap") -> "Optional[dict[str, Any]]":
                 for f, n in _fc.most_common(5)
             ]
             ctx["hotspots_source"] = "recent_commits"
+    if gc.recent_commits:
+        ctx["recent_commits"] = [
+            {
+                "hash": c.hash[:8],
+                "message": (c.message or "")[:80],
+                "date": (c.date or "")[:10],
+                "author": c.author or "",
+            }
+            for c in gc.recent_commits[:5]
+        ]
     return ctx if ctx else None
 
 

{sourcecode-1.30.27.dist-info → sourcecode-1.30.28.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.30.27
+Version: 1.30.28
 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.27-blue)
+![Version](https://img.shields.io/badge/version-1.30.28-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.27
+# sourcecode 1.30.28
 ```
 
 ---

{sourcecode-1.30.27.dist-info → sourcecode-1.30.28.dist-info}/RECORD

@@ -1,10 +1,10 @@
-sourcecode/__init__.py,sha256=dwmvjucHTiWMZcDP2j41KFmIxCmu9Ib5cScfJsnEz_Q,104
+sourcecode/__init__.py,sha256=q-bCo7uGXns3U7O05C-GiuHhFOyvaN-90_kC3JSQMn0,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=xNbK_xwsqdhUbAJT4VieJDitGlhMu_O_Y5xzY8yrc9Q,94497
+sourcecode/cli.py,sha256=NbVyJAEQ4Q0ngkgW_lXyvlDJcD8TTrxZEXY6RIVkBAI,95261
 sourcecode/code_notes_analyzer.py,sha256=y1MJBnPZHYp4i6cQCXUb9ATIyifS_qMQWjw_8lPkpsU,9215
 sourcecode/confidence_analyzer.py,sha256=H9VHYRzZhqMFlSCZffjtsMUGYLnDvrq1g5FjzyQ1hxE,16381
 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=smHslxiG14lrytCkq5nFrFu-qTHgA-t-LFYfdrfjz2o,14423
-sourcecode/prepare_context.py,sha256=4BwSEXUEuWiYaRZ8wPUcClSW5_Pl1BuUGe-VqM9MSPQ,166688
+sourcecode/prepare_context.py,sha256=O3gpZIJLzCH2-9zr91zOP0D4gwHND2BbgBOCplwQXj8,168540
 sourcecode/progress.py,sha256=qn30sWaHOkjTgXsSBmiPkz7Rsbwc5oSlIe6JNEMYp_k,3149
 sourcecode/ranking_engine.py,sha256=ZAucq_YX2KkWUuAZf4P0lhtQ_38vEFnUhuGtSZd1S0E,12970
 sourcecode/redactor.py,sha256=xuGcadGEHaPw4qZXlMDvzMCsr4VOkdp3oBQptHyJk8c,2884
@@ -33,7 +33,7 @@ sourcecode/runtime_classifier.py,sha256=zWX3r3HCKHc-qtIobErOa8aKMmaoPYREtJKvPcBG
 sourcecode/scanner.py,sha256=aM3h9-DCQ3xKpeHpHYdo2vX6T5P95HA_YwZbkAVNwmo,8288
 sourcecode/schema.py,sha256=fj3BZ3IcnNV4j21BFIEvz8Qnw_vZoqIbzzRg-qQ-nd0,24530
 sourcecode/semantic_analyzer.py,sha256=12TwXYkYbDcBdu0heX_EmfPM2EkO8a_r5osf0SaeQbs,88956
-sourcecode/serializer.py,sha256=2Xi7bJUBiwsAGshy1a_CFgrYKudadakFAfKp_Lz2-qI,105749
+sourcecode/serializer.py,sha256=svaLLYyAeAd3ZWsgh0YBwu7RKm00JaKuyz3bQbLipHA,106064
 sourcecode/summarizer.py,sha256=lPlKhMh28nueXkPo2xKeD3DUFYVGRlJMIdY-8TSM-ls,17486
 sourcecode/tree_utils.py,sha256=8GAkIfQAsvtEudIeW1l4ooH_oRtrWR8cpJQJsEa_Pfw,2093
 sourcecode/workspace.py,sha256=X_6NmNnitvT3_38V-JDChydo_sR68s249hLFlrQskU0,8271
@@ -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.27.dist-info/METADATA,sha256=mi09pFkJXE7YELroOo3ewgHjwQp8je7jMFEvR2uiGYo,28956
-sourcecode-1.30.27.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-1.30.27.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
-sourcecode-1.30.27.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-1.30.27.dist-info/RECORD,,
+sourcecode-1.30.28.dist-info/METADATA,sha256=cL4bkJZO4jc-T5k1GtC5OXS99NZLU4bZSl6WxVbo70w,28956
+sourcecode-1.30.28.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-1.30.28.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
+sourcecode-1.30.28.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-1.30.28.dist-info/RECORD,,