sourcecode 1.33.3__tar.gz → 1.33.4__tar.gz

{sourcecode-1.33.3 → sourcecode-1.33.4}/PKG-INFO

@@ -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 → sourcecode-1.33.4}/README.md

@@ -2,7 +2,7 @@
 
 **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)
 
 ---
@@ -76,7 +76,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.33.3
+# sourcecode 1.33.4
 ```
 
 ---

{sourcecode-1.33.3 → sourcecode-1.33.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sourcecode"
-version = "1.33.3"
+version = "1.33.4"
 description = "Persistent structural context and ultra-fast repeated analysis for AI coding agents"
 readme = "README.md"
 requires-python = ">=3.9"

{sourcecode-1.33.3 → sourcecode-1.33.4}/src/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-1.33.3 → sourcecode-1.33.4}/src/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-1.33.3 → sourcecode-1.33.4}/src/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-1.33.3 → sourcecode-1.33.4}/src/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"] = (