sourcecode 1.35.16__py3-none-any.whl → 1.35.17__py3-none-any.whl

sourcecode/__init__.py

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

sourcecode/cli.py

@@ -197,9 +197,13 @@ Cold scan: 2–10s depending on repo size. Warm cache: 0.3–0.6s.
   [dim]modernize (full)                    dead zones, tangles, full coupling[/dim]
   [dim]fix-bug (full)                      complete risk-ranked file list[/dim]
   [dim]review-pr (expanded)               CI-grade PR review[/dim]
-  [dim]prepare-context delta               incremental context for CI/CD[/dim]
+  [dim]prepare-context delta               incremental context for CI/CD (30 free runs/repo)[/dim]
   [dim]prepare-context generate-tests      test gap analysis[/dim]
-  [dim]--full                              removes all truncation limits[/dim]
+  [dim]--full                              removes all truncation limits (free up to 500 files)[/dim]
+  [dim]--rank-by git-churn                 file volatility ranking via git history[/dim]
+  [dim]rich exports (HTML/PDF/CI)          structured reports for CI and stakeholders[/dim]
+  [dim]multi-repo analysis                 cross-repository blast radius[/dim]
+  [dim]team snapshots                      shared org-level cache[/dim]
 
   [dim cyan]→ sourcecode activate <key>[/dim cyan]
 """
@@ -573,7 +577,8 @@ GRAPH_EDGE_CHOICES = {"imports", "calls", "contains", "extends"}
 DOCS_DEPTH_CHOICES = ["module", "symbols", "full"]
 
 # ── Module-level constants ─────────────────────────────────────────────────────
-_FREE_TIER_NODE_CAP: int = 10  # semantic cap for graph nodes and semantic symbols in free tier
+_FREE_TIER_NODE_CAP: int = 50  # semantic cap for graph nodes and semantic symbols in free tier
+_FREE_FULL_FILE_THRESHOLD: int = 500  # Java source files; above this --full requires Pro
 _JAVA_MIN_SCAN_DEPTH: int = 12  # Maven src/main/java/<pkg>/<module>/File depth floor
 _JVM_STACKS: frozenset[str] = frozenset({"java", "kotlin", "scala", "groovy"})
 _IMPACT_PRIORITY_THRESHOLDS: list[tuple[float, str]] = [
@@ -878,6 +883,11 @@ def main(
         )
         raise typer.Exit(code=2)  # FIX-P2-7: arg validation → exit 2
 
+    # Pro gate for --rank-by git-churn: git history analysis is a Pro feature.
+    if rank_by == "git-churn":
+        from sourcecode.license import require_feature as _req_git_history
+        _req_git_history("git-history")
+
     if symbol is not None and not symbol.strip():
         _emit_error_json(
             INVALID_INPUT_CODE,
@@ -911,10 +921,21 @@ def main(
         )
         raise typer.Exit(code=2)  # FIX-P2-7: arg validation → exit 2
 
-    # Pro gate for --full: removing truncation limits is enterprise-scale functionality.
+    # Pro gate for --full: free tier allowed up to _FREE_FULL_FILE_THRESHOLD Java files.
     if full:
-        from sourcecode.license import require_feature as _req_full
-        _req_full("--full")
+        from sourcecode.license import is_pro as _full_is_pro
+        if not _full_is_pro:
+            from itertools import islice as _islice
+            _full_check_path = Path(_get_detected_path()).resolve()
+            _java_count = sum(
+                1 for _ in _islice(
+                    (p for p in _full_check_path.rglob("*.java") if ".git" not in p.parts),
+                    _FREE_FULL_FILE_THRESHOLD + 1,
+                )
+            )
+            if _java_count > _FREE_FULL_FILE_THRESHOLD:
+                from sourcecode.license import require_feature as _req_full
+                _req_full("--full")
 
     # P0-2 FIX: --compact and --full are mutually exclusive.
     # compact is designed to be a bounded summary; --full removes truncation limits,
@@ -2633,14 +2654,34 @@ def prepare_context_cmd(
         )
         raise typer.Exit(code=1)
 
-    # Pro gate: generate-tests and delta require an active Pro license.
-    _PRO_TASKS: frozenset[str] = frozenset({"generate-tests", "delta"})
-    if task in _PRO_TASKS:
+    # Pro gate: generate-tests requires Pro. delta allows 30 free runs per repo.
+    if task == "generate-tests":
         from sourcecode.license import require_feature as _require_feature
-        _extra: dict = {}
-        if task == "delta":
-            _extra["free_tier_alternative"] = "sourcecode prepare-context review-pr --since <ref>"
-        _require_feature(task, extra_fields=_extra if _extra else None)
+        _require_feature("generate-tests")
+    elif task == "delta":
+        from sourcecode.license import is_pro as _delta_is_pro
+        if not _delta_is_pro:
+            from sourcecode.license import check_delta_free_tier as _check_delta
+            _delta_allowed, _delta_used, _delta_remaining = _check_delta(str(path.resolve()))
+            if not _delta_allowed:
+                from sourcecode.license import require_feature as _require_feature_delta
+                _require_feature_delta(
+                    "delta",
+                    extra_fields={
+                        "free_tier_note": (
+                            f"Free quota of {30} delta runs per repository exhausted."
+                        ),
+                        "free_tier_alternative": "sourcecode prepare-context review-pr --since <ref>",
+                    },
+                )
+            # Within quota: emit a header note so CI logs show remaining runs.
+            elif _delta_remaining <= 5:
+                import sys as _sys_delta
+                _sys_delta.stderr.write(
+                    f"[sourcecode] delta free tier: {_delta_remaining} run(s) remaining"
+                    f" (used {_delta_used}/{30}). Upgrade to Pro for unlimited CI runs.\n"
+                )
+                _sys_delta.stderr.flush()
 
     # Validate --format: only "json" and "github-comment" are valid for prepare-context.
     # "yaml" is intentionally NOT supported here (use main command for yaml output).

sourcecode/license.py

@@ -41,7 +41,9 @@ if _SUPABASE_URL != _DEFAULT_SUPABASE_URL:
 
 _LICENSE_DIR: Path = Path.home() / ".sourcecode"
 _LICENSE_FILE: Path = _LICENSE_DIR / "license.json"
+_DELTA_RUNS_FILE: Path = _LICENSE_DIR / "delta_runs.json"
 _CACHE_TTL_SECONDS: int = 86400  # 24 hours
+_DELTA_FREE_LIMIT: int = 30
 _LICENSE_KEY_RE = re.compile(r"^[A-Za-z0-9_\-]{1,200}$")
 
 # ---------------------------------------------------------------------------
@@ -83,12 +85,37 @@ _FEATURE_INFO: dict[str, dict[str, str]] = {
         "value": "Reduces test debt systematically across the entire codebase.",
     },
     "--full": {
-        "display": "--full flag",
+        "display": "--full flag (large repos)",
         "description": (
             "Removes truncation limits on transactional boundaries, DTO mappers, and large result sets."
+            " Free tier may use --full on repositories under 500 Java source files."
         ),
         "value": "Essential for complete analysis of enterprise-scale codebases.",
     },
+    "git-history": {
+        "display": "git history analysis",
+        "description": (
+            "Churn ranking, commit frequency per file, volatility signals over 90-day window."
+        ),
+        "value": "Identifies which files change most — the highest-risk targets in any refactor.",
+    },
+    "multi-repo": {
+        "display": "multi-repo analysis",
+        "description": (
+            "Cross-repository dependency graphs, shared module impact, and org-level blast radius."
+        ),
+        "value": "Required for microservices and monorepo architectures.",
+    },
+    "export-rich": {
+        "display": "rich exports (HTML/PDF/CI)",
+        "description": "Structured HTML reports, PDF exports, and CI-consumable risk summaries.",
+        "value": "Embed analysis into your CI pipeline or share with non-CLI stakeholders.",
+    },
+    "team-snapshots": {
+        "display": "team snapshot sharing",
+        "description": "Shared org-level snapshots and multi-user cache access.",
+        "value": "Eliminates cold-cache overhead across the entire engineering team.",
+    },
 }
 
 # ---------------------------------------------------------------------------
@@ -113,6 +140,40 @@ def _write_license_file(data: dict) -> None:
         raise
 
 
+def _read_delta_runs() -> dict:
+    try:
+        if _DELTA_RUNS_FILE.exists():
+            return json.loads(_DELTA_RUNS_FILE.read_text(encoding="utf-8"))
+    except Exception:
+        pass
+    return {}
+
+
+def check_delta_free_tier(repo_path: str) -> "tuple[bool, int, int]":
+    """Check and consume one delta free-tier run for repo_path.
+
+    Returns (allowed, runs_used, runs_remaining).
+    When allowed=True the run count is incremented atomically.
+    When allowed=False the quota is exhausted — caller should gate to Pro.
+    """
+    import hashlib
+    key = hashlib.sha256(str(Path(repo_path).resolve()).encode()).hexdigest()[:16]
+    runs = _read_delta_runs()
+    used = int(runs.get(key, 0))
+    if used >= _DELTA_FREE_LIMIT:
+        return False, used, 0
+    new_used = used + 1
+    runs[key] = new_used
+    try:
+        _LICENSE_DIR.mkdir(parents=True, exist_ok=True)
+        tmp = _DELTA_RUNS_FILE.with_suffix(".tmp")
+        tmp.write_text(json.dumps(runs, indent=2, ensure_ascii=False), encoding="utf-8")
+        tmp.replace(_DELTA_RUNS_FILE)
+    except Exception:
+        pass
+    return True, new_used, max(0, _DELTA_FREE_LIMIT - new_used)
+
+
 def _load_license_file() -> Optional[dict]:
     """Read ~/.sourcecode/license.json. Returns parsed dict or None."""
     try:

{sourcecode-1.35.16.dist-info → sourcecode-1.35.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.35.16
+Version: 1.35.17
 Summary: Persistent structural context and ultra-fast repeated analysis for AI coding agents
 License-File: LICENSE
 Keywords: agents,ai,codebase,context,developer-tools,llm

{sourcecode-1.35.16.dist-info → sourcecode-1.35.17.dist-info}/RECORD

@@ -1,4 +1,4 @@
-sourcecode/__init__.py,sha256=jc7t99MAOVoZuqPXgeqrR2Amq4B-LnZtcO_-sTvoMSo,104
+sourcecode/__init__.py,sha256=5WWLHrnlJwQHZyPIM9VKQoB5GUOYgv95o6WN75zBV60,104
 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/canonical_ir.py,sha256=uwpwCnJxMh_eiIVg4cOLv7-aZthvmDFcG4azCOycLkw,24281
 sourcecode/cir_graphs.py,sha256=rZi8JV4ZrAa2WSCeyNa4JIEKQ_yZzDZTsrvVz2KfuKA,8919
 sourcecode/classifier.py,sha256=2lYoSH3vOTkXZYPU7Go2WIet1-IuNzTWVhc-ULnXtgw,8024
-sourcecode/cli.py,sha256=uQXXwKp1qnviXG-Qgnl34_5ioPeKPuXLDh7IXXZ3aaA,224568
+sourcecode/cli.py,sha256=eMcUIP_tUpij-4lgrtXIU0bvVOFVbKzILsdFPEdGE0E,226810
 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
@@ -26,7 +26,7 @@ sourcecode/flow_analyzer.py,sha256=dSiuY4w49k29jW_EPXUOND9B5uVbuCA7kjnuHi-pIWA,2
 sourcecode/fqn_utils.py,sha256=XLU7zDkNBXz_RZkIUNfpPmp1nekWtqP-fxV92tDV1vg,2158
 sourcecode/git_analyzer.py,sha256=JStxTQXNjBWi_wLdwhsZs9mT-v50cSJIz4Agzn6Kh9I,13362
 sourcecode/graph_analyzer.py,sha256=DHR8fY69oU_Pi4SYaWboX6EoEFrctQKB9dsjpqwGMzw,62403
-sourcecode/license.py,sha256=-sPY4VuSYSe5dZyy7uFoWn9tHFcKlQkhZU0kgbwypo8,12499
+sourcecode/license.py,sha256=1nr-uhgtiMUCMH7Ff-tSD8EDXmUNQsNiRiMcIbdCqUY,14940
 sourcecode/mcp_nudge.py,sha256=5ELU_ixzh6uA83NXLOZT8h00OhL53okfQdji3jyKOjg,2917
 sourcecode/metrics_analyzer.py,sha256=m0ENgtqKeBL17kUIK3fmGkgo7UfXBNHxCMj0H_Y5K7c,22750
 sourcecode/output_budget.py,sha256=Js9yUlfQtPhqBl9R6wn_9UHVjjJc3GtLcqyfjf5t50Q,9869
@@ -93,8 +93,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=QSslxIwij8YkRWcVvxykODDrkiN_GAAEu3dUP7KIWeE,1651
-sourcecode-1.35.16.dist-info/METADATA,sha256=LkCx5nRHlMV_wsznbY9xRh0muC06f_qtM6K9aHP2WbM,21297
-sourcecode-1.35.16.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-1.35.16.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
-sourcecode-1.35.16.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-1.35.16.dist-info/RECORD,,
+sourcecode-1.35.17.dist-info/METADATA,sha256=yxu3wNqg3zjWzv1AodVb0wv0eQhrmm7dAWzM2LfI_4s,21297
+sourcecode-1.35.17.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-1.35.17.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
+sourcecode-1.35.17.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-1.35.17.dist-info/RECORD,,