sourcecode 1.32.4__py3-none-any.whl → 1.32.6__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.6"

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",
     }
 )
 
@@ -382,6 +384,18 @@ def _get_command_with_preprocessing(typer_instance: Any) -> Any:
     # Refresh help text at invocation time so it reflects current license state.
     cmd.help = _build_help_text()
 
+    # Add [Pro] badge to Pro-gated option help strings for free-tier users.
+    try:
+        from sourcecode.license import is_pro as _lp_is_pro
+    except Exception:
+        _lp_is_pro = False
+    if not _lp_is_pro:
+        _PRO_OPTS = {"full"}
+        for _param in cmd.params:
+            if getattr(_param, "name", None) in _PRO_OPTS and getattr(_param, "help", None):
+                if "[Pro]" not in _param.help:
+                    _param.help = _param.help + "  [dim][Pro][/dim]"
+
     _orig_cmd_main = cmd.main
 
     def _cmd_main(args: Optional[list[str]] = None, **kwargs: Any) -> Any:
@@ -412,6 +426,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 +1081,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 +1088,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},"
@@ -1436,12 +1454,23 @@ def main(
         if dependency_analyzer is not None
         else None
     )
+    # Free-tier node cap: limit graph size to 10 nodes unless Pro.
+    _effective_max_nodes = max_nodes
+    try:
+        from sourcecode.license import is_pro as _lp_is_pro_gm
+    except Exception:
+        _lp_is_pro_gm = False
+    _FREE_NODE_CAP = 10
+    if not _lp_is_pro_gm and graph_analyzer is not None:
+        if _effective_max_nodes is None or _effective_max_nodes > _FREE_NODE_CAP:
+            _effective_max_nodes = _FREE_NODE_CAP
+
     module_graph = (
         graph_analyzer.merge_graphs(
             module_graphs,
             detail=graph_detail_typed,
             edge_kinds=parsed_graph_edges,
-            max_nodes=max_nodes,
+            max_nodes=_effective_max_nodes,
             entry_points=entry_points,
         )
         if graph_analyzer is not None
@@ -1561,6 +1590,15 @@ def main(
                 semantic_summary=sem_sum,
             )
 
+    # Free-tier node cap for --semantics: limit semantic_symbols to 10 unless Pro.
+    if semantic_analyzer is not None and sm.semantic_symbols:
+        try:
+            from sourcecode.license import is_pro as _lp_is_pro_sem
+        except Exception:
+            _lp_is_pro_sem = False
+        if not _lp_is_pro_sem and len(sm.semantic_symbols) > _FREE_NODE_CAP:
+            sm = replace(sm, semantic_symbols=sm.semantic_symbols[:_FREE_NODE_CAP])
+
     # Runtime architecture — classify workspace packages for structural summaries
     if workspace_analysis.workspaces:
         from sourcecode.runtime_classifier import RuntimeClassifier
@@ -4124,6 +4162,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/license.py

@@ -248,6 +248,7 @@ def require_feature(feature_name: str) -> None:
             f"'{display}' requires a Pro license. "
             "Run: sourcecode activate <license_key>"
         ),
+        "upgrade_hint": "sourcecode activate <license_key>",
     }
     sys.stdout.write(json.dumps(payload, ensure_ascii=False) + "\n")
     sys.stdout.flush()

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.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.32.4
+Version: 1.32.6
 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.6.dist-info}/RECORD

@@ -1,13 +1,13 @@
-sourcecode/__init__.py,sha256=ekW8VutI9sqMXBEN-MSRy8p8fHOhat9jl5sCtrKrygc,103
+sourcecode/__init__.py,sha256=KgyhBn2jfjwXzdBpdStMZoNfqCUlHHAwk1wuU3Nez1M,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=PJbs8ltIdsBmedJlBJ6HG9UCRBLDtUhG_eIqyazP_sU,170992
 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
@@ -23,7 +23,7 @@ sourcecode/file_classifier.py,sha256=QrYm7MlG29HQdAR1WOfpnIIBysAz62c5coz9eQ76meo
 sourcecode/flow_analyzer.py,sha256=dSiuY4w49k29jW_EPXUOND9B5uVbuCA7kjnuHi-pIWA,28781
 sourcecode/git_analyzer.py,sha256=JStxTQXNjBWi_wLdwhsZs9mT-v50cSJIz4Agzn6Kh9I,13362
 sourcecode/graph_analyzer.py,sha256=iUK-7pSV-cvGqqD2hENdYmhnm0wcXFEyK-xnu5ul8OU,62515
-sourcecode/license.py,sha256=m5n4PKZ7ZZZ17bpLjIsKwd94PXaIg5iS_2kFNjCV2Og,11378
+sourcecode/license.py,sha256=cz6FIqo8QjPeLmXiBWoo256gfqsotgbHHgMMEwR5pjw,11439
 sourcecode/mcp_nudge.py,sha256=5ELU_ixzh6uA83NXLOZT8h00OhL53okfQdji3jyKOjg,2917
 sourcecode/metrics_analyzer.py,sha256=m0ENgtqKeBL17kUIK3fmGkgo7UfXBNHxCMj0H_Y5K7c,22750
 sourcecode/output_budget.py,sha256=43307mJEyUPU3MI-QEQoVxrcAvNyUzdzF_SAPgisBQE,6603
@@ -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.6.dist-info/METADATA,sha256=Aa7pmdWB0T8LkQYd6rihJOQQwE1Ts_nJ7AHUyYT2gF0,19120
+sourcecode-1.32.6.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-1.32.6.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
+sourcecode-1.32.6.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-1.32.6.dist-info/RECORD,,