sourcecode 1.33.3__py3-none-any.whl → 1.33.4__py3-none-any.whl

sourcecode/__init__.py

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

sourcecode/cli.py

@@ -658,7 +658,6 @@ def main(
     env_map: bool = typer.Option(
         False,
         "--env-map",
-        hidden=True,
         help="Map environment variables referenced across the codebase.",
     ),
     code_notes: bool = typer.Option(
@@ -1880,8 +1879,9 @@ def main(
             if _gc_early and not (_bad_gc & set(_gc_early.limitations)):
                 _uc = _gc_early.uncommitted_changes
                 if _uc:
-                    # WORKTREE_UNSTAGED + WORKTREE_STAGED only; untracked excluded
-                    _allowed_changed_files = set(_uc.staged) | set(_uc.unstaged)
+                    # Include untracked (new files not yet staged) so new source files
+                    # are analyzed under --changed-only, not silently treated as "clean".
+                    _allowed_changed_files = set(_uc.staged) | set(_uc.unstaged) | set(_uc.untracked)
                 if not _allowed_changed_files:
                     # Git is available and confirms no uncommitted changes.
                     # Do NOT fall back to a full scan — that would silently produce
@@ -1900,10 +1900,10 @@ def main(
             changed_only = False
         if _git_confirmed_clean:
             _nc_payload = json.dumps({
-                "status": "working_tree_clean",
-                "no_changes": True,
                 "changed_files": [],
-                "message": "No uncommitted changes detected — working tree is clean.",
+                "message": "no uncommitted changes detected",
+                "analysis_scope": "empty",
+                "_meta": {"changed_only": True},
             }, ensure_ascii=False)
             write_output(_nc_payload, output=output)
             raise typer.Exit()
@@ -2626,7 +2626,14 @@ def prepare_context_cmd(
     if _task_include("improvement_opportunities") and output.improvement_opportunities:
         out["improvement_opportunities"] = output.improvement_opportunities
     if _task_include("test_gaps") and output.test_gaps:
-        out["test_gaps"] = output.test_gaps
+        # Emit both the canonical name (untested_sources) and the compat alias (test_gaps)
+        # so agents can use either. untested_sources is the correct semantic name.
+        out["untested_sources"] = output.test_gaps
+        out["test_gaps"] = output.test_gaps  # backward compat alias
+        if task == "generate-tests":
+            _et_count = getattr(output, "existing_test_count", None)
+            if _et_count is not None:
+                out["existing_test_count"] = _et_count
     # P0-2: fast-mode truncation transparency — always emit when truncated, even if test_gaps is []
     # Use `is True` (strict) so MagicMock objects in tests don't trigger this branch.
     if getattr(output, "truncated", False) is True:
@@ -3543,6 +3550,12 @@ def fix_bug_cmd(
       sourcecode impact <target>   — Propagate impact from a specific class
       sourcecode onboard .         — Full architecture context first
     """
+    if not symptom:
+        typer.echo(
+            "[fix-bug] Results are significantly better with --symptom. "
+            "Example: --symptom 'NullPointerException in PaymentService'",
+            err=True,
+        )
     ctx.invoke(
         prepare_context_cmd,
         task="fix-bug",
@@ -4298,19 +4311,21 @@ def cache_status_cmd(
 def cache_clear_cmd(
     path: Path = typer.Argument(Path("."), help="Repository path (default: current directory)"),
     yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation prompt."),
-    include_ris: bool = typer.Option(False, "--include-ris", help="Also delete the RIS snapshot (ris.json.gz). By default, RIS is preserved across clears."),
+    include_ris: bool = typer.Option(False, "--include-ris", hidden=True, help="Alias for --all. Preserved for backward compatibility."),
+    all_: bool = typer.Option(False, "--all", help="Also delete the RIS snapshot (ris.json.gz). By default, RIS is preserved across clears."),
 ) -> None:
     """Delete cached snapshots for a repository.
 
     By default, RIS (ris.json.gz) is preserved — it is the persistent structural
-    index used for cold-start bootstrapping.  Use --include-ris to also clear it.
+    index used for cold-start bootstrapping.  Use --all to also clear it.
     """
     from sourcecode import cache as _cm
     target = Path(path).resolve()
+    _clear_ris = include_ris or all_
     if not yes:
-        _ris_note = " (including RIS)" if include_ris else " (RIS preserved — use --include-ris to also clear it)"
+        _ris_note = " (including RIS)" if _clear_ris else " (RIS preserved — use --all to also clear it)"
         typer.confirm(f"Delete all cache files for {target}{_ris_note}?", abort=True)
-    removed = _cm.clear(target, clear_ris=include_ris)
+    removed = _cm.clear(target, clear_ris=_clear_ris)
     typer.echo(f"Removed {removed} file(s).")
 
 

sourcecode/prepare_context.py

@@ -391,6 +391,8 @@ class TaskOutput:
     # P0-2: fast-mode truncation transparency
     truncated: bool = False
     truncated_reason: Optional[str] = None
+    # generate-tests: count of existing test files found (complements untested_sources)
+    existing_test_count: Optional[int] = None
 
 
 @dataclass
@@ -2237,6 +2239,8 @@ class TaskContextBuilder:
             # P0-2: fast-mode truncation transparency
             truncated=_fast_truncated,
             truncated_reason=_fast_truncated_reason,
+            # generate-tests: count of test files found alongside untested_sources
+            existing_test_count=len(test_set) if task_name == "generate-tests" else None,
         )
 
     def render_prompt(self, output: TaskOutput) -> str:

sourcecode/ris.py

@@ -393,12 +393,40 @@ def get_cold_start_context(repo_root: Path) -> dict:
         # An empty list does NOT mean "no endpoints exist" — it means the endpoint
         # index has not been built yet.  Agents must call get_endpoints to populate.
         _api_complete = not _is_java or bool(endpoints)
+
+        # Build structural validation for Java/Spring repos.
+        # Detects when the RIS snapshot is structurally incomplete (controllers found
+        # but endpoint index was never built), so agents can decide whether to rebuild.
+        _controllers_in_map = ris.structural_map.get("controllers", [])
+        _controllers_in_api = ris.api_surface.get("controllers_index", [])
+        _controllers_found = len(_controllers_in_map) or len(_controllers_in_api)
+        _endpoints_found = len(endpoints)
+        # Spring is detected when controllers exist in structural map or api surface.
+        _spring_detected = bool(_controllers_found) or bool(_controllers_in_api)
+        _validation_status = (
+            "incomplete_snapshot"
+            if _is_java and _spring_detected and _endpoints_found == 0
+            else "valid"
+        )
+        _validation: dict = {
+            "spring_detected": _spring_detected,
+            "controllers_found": _controllers_found,
+            "endpoints_found": _endpoints_found,
+            "status": _validation_status,
+        }
+
+        # When the snapshot is structurally incomplete, downgrade status so agents
+        # don't assume cold_start_ready when critical sections are missing.
+        _status_base = "cold_start_stale" if stale else "cold_start_ready"
+        if _validation_status == "incomplete_snapshot" and not stale:
+            _status_base = "cold_start_incomplete"
+
         result: dict = {
-            "status": "cold_start_stale" if stale else "cold_start_ready",
+            "status": _status_base,
             "repo_id": ris.repo_id,
             "git_head": ris.git_head,
             "current_git_head": current_head,
-            "stale": stale,
+            "stale": stale or (_validation_status == "incomplete_snapshot"),
             "has_uncommitted_changes": uncommitted,
             "last_updated_at": ris.last_updated_at,
             "cache_source": "RIS",
@@ -408,6 +436,7 @@ def get_cold_start_context(repo_root: Path) -> dict:
             "entrypoints": ris.structural_map.get("entrypoints", []),
             "endpoints": endpoints,
             "hotspots": ris.git_context_snapshot.get("hotspots", []),
+            "validation": _validation,
         }
         if not endpoints and _is_java:
             result["endpoints_hint"] = (

{sourcecode-1.33.3.dist-info → sourcecode-1.33.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.33.3
+Version: 1.33.4
 Summary: Persistent structural context and ultra-fast repeated analysis for AI coding agents
 License-File: LICENSE
 Keywords: agents,ai,codebase,context,developer-tools,llm
@@ -39,7 +39,7 @@ Description-Content-Type: text/markdown
 
 **Persistent structural context and ultra-fast repeated analysis for AI coding agents.**
 
-![Version](https://img.shields.io/badge/version-1.33.3-blue)
+![Version](https://img.shields.io/badge/version-1.33.4-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -113,7 +113,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.33.3
+# sourcecode 1.33.4
 ```
 
 ---

{sourcecode-1.33.3.dist-info → sourcecode-1.33.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-sourcecode/__init__.py,sha256=qhL6fTfXMRERDWiwrW3g08_u6w-wnYzM6RnzJHpyq2M,103
+sourcecode/__init__.py,sha256=oG8RdsJRmrxoLhAnBA3rq7bWu7SPvQTfWedYeipB42k,103
 sourcecode/adaptive_scanner.py,sha256=XffluXKzJUXrMtjEiAOnSNPZnztdIcts17T9ouHeID0,10521
 sourcecode/architecture_analyzer.py,sha256=qh749a7ykPtGmQI1MR9y6j8TtL_jBdVYFx9YRsLqOMw,44121
 sourcecode/architecture_summary.py,sha256=z34_6v7cSwy98cof2UVciGho7SCrZ93tiqMmq5WNzRQ,20405
@@ -7,7 +7,7 @@ sourcecode/cache.py,sha256=wAyPrXN5DqiGivnMpeEuun2xHDKfBer2_oBsh6kj_vc,30447
 sourcecode/cache.tmp_new,sha256=-IvV7CojiZjqeKMln1m-lqI0QVA2uFGWmYir4XRFOUk,27970
 sourcecode/canonical_ir.py,sha256=_HM3AUmKSdna9u4dCoU6rpgSA6HdF8gzOKZykIUCNGY,23277
 sourcecode/classifier.py,sha256=2lYoSH3vOTkXZYPU7Go2WIet1-IuNzTWVhc-ULnXtgw,8024
-sourcecode/cli.py,sha256=ithP9KPwvJsoSH1nOPYw6LDXQqHa5sIP6Xpt8G1MgK8,180063
+sourcecode/cli.py,sha256=K2FT1wLNZuG_-9nKSOGdYbk-5GQkn4u7C2NR6IxdePY,180950
 sourcecode/code_notes_analyzer.py,sha256=EJemNCNc9Dn-1RZYu-aNbK0ELzmsyC4s6FdHi3XyNEI,9392
 sourcecode/confidence_analyzer.py,sha256=_jckZSxksV-OU38vbkxfVNBnWCtlCq8Vwfg23x1uspA,19054
 sourcecode/context_scorer.py,sha256=QpChSpsmaAYz91rXA4Ue5xzQmNz_ZboZN09YOHScq1U,14679
@@ -29,14 +29,14 @@ sourcecode/metrics_analyzer.py,sha256=m0ENgtqKeBL17kUIK3fmGkgo7UfXBNHxCMj0H_Y5K7
 sourcecode/output_budget.py,sha256=43307mJEyUPU3MI-QEQoVxrcAvNyUzdzF_SAPgisBQE,6603
 sourcecode/path_filters.py,sha256=ROFRQ8eSLBEMiixK9f45-RO7um4VEEcjoD5AA4I427I,3739
 sourcecode/pr_comment_renderer.py,sha256=smHslxiG14lrytCkq5nFrFu-qTHgA-t-LFYfdrfjz2o,14423
-sourcecode/prepare_context.py,sha256=uZo0r7QBXUmQdfTp3w_A1XI-OzFAlcoH7F76_p7IQjo,205311
+sourcecode/prepare_context.py,sha256=aL4WS62wozw9iG_v3UrU00Qc7lGgckUB5RY5ApPblo8,205618
 sourcecode/progress.py,sha256=qn30sWaHOkjTgXsSBmiPkz7Rsbwc5oSlIe6JNEMYp_k,3149
 sourcecode/ranking_engine.py,sha256=ZAucq_YX2KkWUuAZf4P0lhtQ_38vEFnUhuGtSZd1S0E,12970
 sourcecode/redactor.py,sha256=SB4hwIvg8h-hvcqKcDWaZvA-aSyn-at-BIRwa0tUv5E,3227
 sourcecode/relevance_scorer.py,sha256=MYF4FFkveAQps9SmTeTlh6ODiBz2F--_hWNeHMLtUHQ,8405
 sourcecode/repo_classifier.py,sha256=FG1vaWKdWXsWdl-S8hjVMiTqcwgaRXkDyvK4rPcOGtQ,22681
 sourcecode/repository_ir.py,sha256=-NjBQUT7zyya4ng8Hq0-ChoiHZkUif9lr-Q878gmj8M,153163
-sourcecode/ris.py,sha256=G89xhjg-JAQXsi4ox2Z3HGwWiOd6sWNPQqWRbUT-MPk,15927
+sourcecode/ris.py,sha256=vkIe_v-jjceeb0Adhn-Kw5eFXE_nIkGHflOnQYPycTk,17411
 sourcecode/runtime_classifier.py,sha256=uTAD6BDCiBLUZEDRfqk718kM4RTT_vAbfkcOI2_Xx58,18432
 sourcecode/scanner.py,sha256=WdOQ78mMzjR1NjmKTlbxdgwinnCTfAhxCVLBEFQiFHU,8899
 sourcecode/schema.py,sha256=aHNXDf8LGyUC8ZDE_VS9kiskC2-Oswhi_WnpdGy6HDw,24897
@@ -80,8 +80,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.33.3.dist-info/METADATA,sha256=2PnPfTRRy6IDMJajZkRqfE8M_j0HJjYjOVuwRBlKfYg,16440
-sourcecode-1.33.3.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-1.33.3.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
-sourcecode-1.33.3.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-1.33.3.dist-info/RECORD,,
+sourcecode-1.33.4.dist-info/METADATA,sha256=Q9XlsPNiuahPxhrDZUU8OqtH1U_DH77rv22bnvblazA,16440
+sourcecode-1.33.4.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-1.33.4.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
+sourcecode-1.33.4.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-1.33.4.dist-info/RECORD,,