sourcecode 1.32.4__py3-none-any.whl → 1.32.5__py3-none-any.whl

sourcecode/__init__.py

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

sourcecode/cache.py

@@ -72,6 +72,11 @@ SCHEMA_VERSION: str = "2"
 #: Bump to invalidate all L1 core caches (independent of snapshot version).
 CORE_SCHEMA_VERSION: str = "1"
 
+#: Bump when analysis logic or output schema changes — NOT on every package release.
+#: This is the stable part of the L1 core cache key.  Package version bumps (patch,
+#: minor) must NOT bump this value unless the cached data format actually changed.
+ANALYZER_CACHE_VERSION: str = "1"
+
 #: Fields eligible for CAS deduplication (applied to top-level JSON dict keys).
 _CAS_FIELDS: frozenset[str] = frozenset([
     "file_paths",
@@ -511,7 +516,7 @@ def _cas_store_blob(cache_d: Path, serialised: str) -> str:
     path = _cas_path(cache_d, blob_hash)
     if not path.exists():
         path.parent.mkdir(parents=True, exist_ok=True)
-        path.write_bytes(gzip.compress(raw, compresslevel=6))
+        _atomic_write(path, gzip.compress(raw, compresslevel=6))
     return blob_hash
 
 
@@ -642,7 +647,11 @@ def _gc(cache_d: Path) -> None:
         # ── Pass 3: total size cap ──────────────────────────────────────────
         if max_size_bytes > 0:
             size_candidates = [p for p in surviving if p.exists()]
+            # Include CAS blobs in the size budget calculation
+            cas_d_sz = _cas_dir(cache_d)
+            cas_files = list(cas_d_sz.glob("*.gz")) if cas_d_sz.exists() else []
             total = sum(p.stat().st_size for p in size_candidates if not p.name.startswith("view-"))
+            total += sum(p.stat().st_size for p in cas_files if p.exists())
             if total > max_size_bytes:
                 # Sort oldest-first; evict core+snapshot files until under budget
                 size_candidates.sort(key=lambda p: p.stat().st_mtime)

sourcecode/cli.py

@@ -208,6 +208,8 @@ _SUBCOMMANDS: frozenset[str] = frozenset(
         "onboard", "modernize", "fix-bug", "review-pr",
         # License
         "activate",
+        # Cache observability
+        "cache",
     }
 )
 
@@ -412,6 +414,9 @@ app.add_typer(telemetry_app, name="telemetry")
 mcp_app = typer.Typer(help="MCP integration: setup, status, serve, remove.", rich_markup_mode="rich")
 app.add_typer(mcp_app, name="mcp")
 
+cache_app = typer.Typer(help="Cache inspection and management.", rich_markup_mode="rich")
+app.add_typer(cache_app, name="cache")
+
 
 def _maybe_ask_consent() -> None:
     """Show first-run consent prompt once, on interactive TTYs only."""
@@ -1064,7 +1069,6 @@ def main(
             # Only cache when target IS the git repo root (not a subdir of one),
             # to avoid polluting sub-project directories used in tests.
             if _git_sha and (target / ".git").exists():
-                from sourcecode import __version__ as _sc_version
                 _excl_key = (
                     ",".join(sorted(e.strip() for e in exclude.split(",") if e.strip()))
                     if exclude else ""
@@ -1072,8 +1076,10 @@ def main(
 
                 # ── Core (analysis) flags: affect which analyzers run + scan config ──
                 # Use effective_depth (not raw depth) so Java auto-adjustment is captured.
+                # acv = ANALYZER_CACHE_VERSION — bumped only when analysis logic/schema
+                # changes, NOT on every package release.  Prevents patch-bump cache wipes.
                 _core_flags_str = (
-                    f"v={_sc_version},"
+                    f"acv={_cache_mod.ANALYZER_CACHE_VERSION},"
                     f"dep={dependencies},gm={graph_modules},"
                     f"docs={docs},fm={full_metrics},sem={semantics},"
                     f"arch={architecture},gc={git_context},em={env_map},"
@@ -4124,6 +4130,70 @@ def mcp_remove(
     typer.echo("  Re-add:  sourcecode mcp init")
 
 
+# ── Cache subcommands ─────────────────────────────────────────────────────────
+
+
+@cache_app.command("status")
+def cache_status_cmd(
+    path: Path = typer.Argument(Path("."), help="Repository path (default: current directory)"),
+    json_output: bool = typer.Option(False, "--json", help="Output as JSON."),
+) -> None:
+    """Show cache statistics for a repository."""
+    from sourcecode import cache as _cm
+    target = Path(path).resolve()
+    stats = _cm.status(target)
+    if json_output:
+        import json as _j
+        typer.echo(_j.dumps(stats, indent=2, ensure_ascii=False))
+    else:
+        typer.echo(f"Cache dir:   {stats['cache_dir']}")
+        typer.echo(f"Cores:       {stats['cores']}")
+        typer.echo(f"Snapshots:   {stats['snapshots']}")
+        typer.echo(f"Views:       {stats['views']}")
+        typer.echo(f"CAS blobs:   {stats['cas_blobs']}")
+        typer.echo(f"Total size:  {stats['total_size_mb']} MB")
+
+
+@cache_app.command("clear")
+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."),
+) -> None:
+    """Delete all cached snapshots for a repository."""
+    from sourcecode import cache as _cm
+    target = Path(path).resolve()
+    if not yes:
+        typer.confirm(f"Delete all cache files for {target}?", abort=True)
+    removed = _cm.clear(target)
+    typer.echo(f"Removed {removed} file(s).")
+
+
+@cache_app.command("warm")
+def cache_warm_cmd(
+    path: Path = typer.Argument(Path("."), help="Repository path to warm (default: current directory)"),
+    compact: bool = typer.Option(True, "--compact/--no-compact", help="Warm compact view (default: on)."),
+    agent: bool = typer.Option(False, "--agent", help="Also warm agent view."),
+) -> None:
+    """Pre-populate the cache by running a fresh analysis."""
+    import subprocess as _sub
+    import sys as _sys
+    target = Path(path).resolve()
+    typer.echo(f"Warming cache for {target} …", err=True)
+    cmd = [_sys.executable, "-m", "sourcecode", str(target)]
+    if compact:
+        cmd.append("--compact")
+    if agent:
+        cmd.append("--agent")
+    result = _sub.run(cmd, capture_output=True, text=True)
+    if result.returncode == 0:
+        typer.echo("Cache warmed.", err=True)
+    else:
+        typer.echo(f"Warm failed (exit {result.returncode}).", err=True)
+        if result.stderr:
+            typer.echo(result.stderr.strip(), err=True)
+        raise typer.Exit(code=result.returncode)
+
+
 # ── Entry point ───────────────────────────────────────────────────────────────
 
 def main_entry() -> None:

sourcecode/ris.py

@@ -329,10 +329,15 @@ def update_ris_api_surface(repo_root: Path, endpoints_data: dict) -> None:
 # ---------------------------------------------------------------------------
 
 def _current_git_head(repo_root: Path) -> str:
-    """Return current HEAD SHA.  Returns '' on any error or non-git directory."""
+    """Return current HEAD short SHA.  Returns '' on any error or non-git directory.
+
+    Uses --short to match the format stored in the RIS and used by cli.py
+    cache key computation — both sides must use the same format or staleness
+    checks will always return True.
+    """
     try:
         result = subprocess.run(
-            ["git", "-C", str(repo_root), "rev-parse", "HEAD"],
+            ["git", "-C", str(repo_root), "rev-parse", "--short", "HEAD"],
             capture_output=True,
             text=True,
             timeout=2,

{sourcecode-1.32.4.dist-info → sourcecode-1.32.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.32.4
+Version: 1.32.5
 Summary: Deterministic codebase context for AI coding agents
 License-File: LICENSE
 Keywords: agents,ai,codebase,context,developer-tools,llm

{sourcecode-1.32.4.dist-info → sourcecode-1.32.5.dist-info}/RECORD

@@ -1,13 +1,13 @@
-sourcecode/__init__.py,sha256=ekW8VutI9sqMXBEN-MSRy8p8fHOhat9jl5sCtrKrygc,103
+sourcecode/__init__.py,sha256=OcIqvxMtCqwdofwolfD8-rpWZk-fh2PbDUp8V3xRur4,103
 sourcecode/adaptive_scanner.py,sha256=XffluXKzJUXrMtjEiAOnSNPZnztdIcts17T9ouHeID0,10521
 sourcecode/architecture_analyzer.py,sha256=qh749a7ykPtGmQI1MR9y6j8TtL_jBdVYFx9YRsLqOMw,44121
 sourcecode/architecture_summary.py,sha256=z34_6v7cSwy98cof2UVciGho7SCrZ93tiqMmq5WNzRQ,20405
 sourcecode/ast_extractor.py,sha256=_btmeOJIe3t-NicF94D5ZAesa2YIJ0_QNExGnbHxGFE,50578
-sourcecode/cache.py,sha256=dvXt8HsU-SyO0a0UXY1n-wt6F2ozGv9VnKR0XydjxCY,27502
+sourcecode/cache.py,sha256=h1BT-9PG_7HK---ZzH0j5u3PN0dz2s6IRAUOjQIPYH4,28055
 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=RdJ1F_sjmqTJ6zcv3eY2Tokg9H5dJe6zSuK3ownUGcA,166617
+sourcecode/cli.py,sha256=-iUcg3FA8K0xgG1xvXJRCF4Xrleyf04QEOJho8bF5mw,169600
 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
@@ -36,7 +36,7 @@ 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=iy1O04SiQ3cFIK5Qn8iHt3fZTiXIgbXvWkjbBG0fTBo,14000
+sourcecode/ris.py,sha256=CqNfiIbzfHZQZx0mWLjyVD4o8u5ZLnbv3Ia7D7gYhQY,14212
 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.32.4.dist-info/METADATA,sha256=SJ09ABP688xA3bbWRuseGyJyVK-mYQmR7CgodrIjmDE,19120
-sourcecode-1.32.4.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-1.32.4.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
-sourcecode-1.32.4.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-1.32.4.dist-info/RECORD,,
+sourcecode-1.32.5.dist-info/METADATA,sha256=kuVwifYAr-Xr4ME4ak-9zWuZqYS-fFMYfFcpx4YJugs,19120
+sourcecode-1.32.5.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-1.32.5.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
+sourcecode-1.32.5.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-1.32.5.dist-info/RECORD,,