sourcecode 1.31.32__py3-none-any.whl → 1.32.0__py3-none-any.whl

sourcecode/__init__.py

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

sourcecode/cli.py

@@ -781,6 +781,11 @@ def main(
             err=True,
         )
 
+    # Pro gate for --full: removing truncation limits is enterprise-scale functionality.
+    if full:
+        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,
     # which contradicts compact's purpose. Use --agent --full for expanded output.
@@ -2672,6 +2677,32 @@ def prepare_context_cmd(
     _pc_budget = _pc_budgets.get(task, BUDGET_EXPLAIN)
     out = _pc_trim(out, _pc_budget, label=task)
 
+    # Free-tier limits: fix-bug (top-5 files) and review-pr (lightweight).
+    # Pro users get the full analysis; free users get enough to see the value.
+    if task in ("fix-bug", "review-pr"):
+        from sourcecode.license import can_use as _tier_can_use
+        if not _tier_can_use(task):
+            _FREE_FILE_LIMIT = 5
+            if task == "fix-bug":
+                _rf = out.get("relevant_files")
+                if isinstance(_rf, list) and len(_rf) > _FREE_FILE_LIMIT:
+                    out["relevant_files"] = _rf[:_FREE_FILE_LIMIT]
+                    out["tier"] = "free"
+                    out["tier_note"] = (
+                        f"Showing top {_FREE_FILE_LIMIT} files. "
+                        "Upgrade to Pro for complete risk-ranked analysis across all files."
+                    )
+            else:  # review-pr
+                for _cap_field in ("runtime_changes", "execution_paths", "review_hotspots", "suggested_review_order"):
+                    _fval = out.get(_cap_field)
+                    if isinstance(_fval, list) and len(_fval) > _FREE_FILE_LIMIT:
+                        out[_cap_field] = _fval[:_FREE_FILE_LIMIT]
+                out["tier"] = "free"
+                out["tier_note"] = (
+                    "Lightweight review. Upgrade to Pro for full blast-radius analysis, "
+                    "complete execution paths, and CI-grade risk scoring."
+                )
+
     if format == "github-comment" and task == "review-pr":
         from sourcecode.pr_comment_renderer import render_github_comment
         _pc_content = render_github_comment(out)
@@ -3373,13 +3404,11 @@ def modernize_cmd(
       sourcecode onboard .         — Architecture overview first
       sourcecode impact <target>   — Verify impact before touching a hotspot
     """
-    from sourcecode.license import require_pro as _require_pro
-    _require_pro("modernize")
-
     import json as _json
     import sys as _sys
     from sourcecode.repository_ir import build_repo_ir, find_java_files, apply_ir_size_limits
     from sourcecode.output_budget import trim_to_budget, BUDGET_ONBOARD
+    from sourcecode.license import can_use as _mod_can_use
 
     root = path.resolve()
     if not root.is_dir():
@@ -3481,52 +3510,73 @@ def modernize_cmd(
         key=lambda s: -len(s.get("members") or []),
     )[:10]
 
-    result = {
-        "workflow": "modernize",
-        "path": str(root),
-        "summary": {
-            "total_classes": len([n for n in graph_nodes if n.get("type") in ("class", "interface")]),
-            "total_subsystems": len(subsystems),
-            "high_coupling_nodes": len(coupling_nodes),
-            "dead_zone_candidates": len(dead_zones),
-        },
-        "hotspot_candidates": hotspots,
-        "high_coupling_nodes": [
-            {"fqn": n["fqn"], "in_degree": n.get("in_degree", 0), "role": n.get("role", "other")}
-            for n in coupling_nodes
-        ],
-        "dead_zone_candidates": [
-            {"fqn": n["fqn"], "type": n.get("type", ""), "role": n.get("role", "other")}
-            for n in dead_zones
-        ],
-        "subsystem_summary": [
-            {
-                "label": s.get("label") or s.get("name") or "",
-                "package_prefix": s.get("package_prefix") or s.get("pkg") or "",
-                "member_count": len(s.get("members") or []),
-            }
-            for s in subsystems[:15]
-        ],
-        "cross_module_tangles": [
-            {
-                "label": s.get("label") or s.get("name") or "",
-                "member_count": len(s.get("members") or []),
-            }
-            for s in tangle_modules
-        ],
-        # BUG-05 fix: don't recommend "Start with hotspot_candidates" when the list is empty.
-        # hotspots filters by role=service/repository/controller; annotation types and
-        # value objects end up in high_coupling_nodes instead.
-        "recommendation": (
-            (
-                "Start with hotspot_candidates (high fan-in = highest blast radius). "
-                if hotspots else
-                "high_coupling_nodes shows the most-referenced classes — start there. "
-            )
-            + "Dead zones are safe to remove or refactor. "
-            + "Cross-module tangles indicate coupling worth decomposing."
-        ),
+    _summary = {
+        "total_classes": len([n for n in graph_nodes if n.get("type") in ("class", "interface")]),
+        "total_subsystems": len(subsystems),
+        "high_coupling_nodes": len(coupling_nodes),
+        "dead_zone_candidates": len(dead_zones),
     }
+    _subsystem_summary = [
+        {
+            "label": s.get("label") or s.get("name") or "",
+            "package_prefix": s.get("package_prefix") or s.get("pkg") or "",
+            "member_count": len(s.get("members") or []),
+        }
+        for s in subsystems[:15]
+    ]
+
+    if not _mod_can_use("modernize"):
+        # Free tier: structural discovery only — no dead zones, tangles, or full refactor list.
+        result = {
+            "workflow": "modernize",
+            "path": str(root),
+            "tier": "free",
+            "tier_note": (
+                "Upgrade to Pro for full analysis: dead zones, dependency tangles, "
+                "refactor candidates ranked by git churn, and complete coupling graphs."
+            ),
+            "summary": _summary,
+            "subsystem_summary": _subsystem_summary,
+            "hotspot_candidates": hotspots[:3],
+            "high_coupling_nodes": [
+                {"fqn": n["fqn"], "in_degree": n.get("in_degree", 0), "role": n.get("role", "other")}
+                for n in coupling_nodes[:3]
+            ],
+        }
+    else:
+        # Pro tier: full analysis.
+        result = {
+            "workflow": "modernize",
+            "path": str(root),
+            "summary": _summary,
+            "hotspot_candidates": hotspots,
+            "high_coupling_nodes": [
+                {"fqn": n["fqn"], "in_degree": n.get("in_degree", 0), "role": n.get("role", "other")}
+                for n in coupling_nodes
+            ],
+            "dead_zone_candidates": [
+                {"fqn": n["fqn"], "type": n.get("type", ""), "role": n.get("role", "other")}
+                for n in dead_zones
+            ],
+            "subsystem_summary": _subsystem_summary,
+            "cross_module_tangles": [
+                {
+                    "label": s.get("label") or s.get("name") or "",
+                    "member_count": len(s.get("members") or []),
+                }
+                for s in tangle_modules
+            ],
+            # BUG-05 fix: don't recommend "Start with hotspot_candidates" when the list is empty.
+            "recommendation": (
+                (
+                    "Start with hotspot_candidates (high fan-in = highest blast radius). "
+                    if hotspots else
+                    "high_coupling_nodes shows the most-referenced classes — start there. "
+                )
+                + "Dead zones are safe to remove or refactor. "
+                + "Cross-module tangles indicate coupling worth decomposing."
+            ),
+        }
 
     result = trim_to_budget(result, BUDGET_ONBOARD, label="modernize")
     output = _json.dumps(result, indent=2, ensure_ascii=False)
@@ -3619,9 +3669,6 @@ def mcp_serve() -> None:
         }
       }
     """
-    from sourcecode.license import require_pro as _require_pro
-    _require_pro("mcp serve")
-
     import logging
     import sys as _sys
 

sourcecode/license.py

@@ -3,7 +3,7 @@
 Flow:
   1. Module imported → _init() loads ~/.sourcecode/license.json (if present)
   2. is_pro set globally (True when plan == "pro")
-  3. Pro commands call require_pro(feature_name) at entry — exits 1 if not Pro
+  3. Pro commands call require_feature(feature_name) at entry — exits 1 if not Pro
   4. `sourcecode activate <key>` calls activate_license(key) — validates via
      Edge Function, writes ~/.sourcecode/license.json, exits 0 on success
   5. Cached license is re-validated every 24 h (online); network errors keep
@@ -38,6 +38,53 @@ _LICENSE_DIR: Path = Path.home() / ".sourcecode"
 _LICENSE_FILE: Path = _LICENSE_DIR / "license.json"
 _CACHE_TTL_SECONDS: int = 86400  # 24 hours
 
+# ---------------------------------------------------------------------------
+# Per-feature descriptions for upgrade UX
+# ---------------------------------------------------------------------------
+_FEATURE_INFO: dict[str, dict[str, str]] = {
+    "impact": {
+        "display": "impact",
+        "description": (
+            "Shows blast radius, callers, affected endpoints, and persistence paths in one call."
+        ),
+        "value": "Answers: what breaks if I touch this? The core risk signal before any change.",
+    },
+    "modernize": {
+        "display": "modernize (full)",
+        "description": (
+            "Full analysis: dead zones, refactor candidates, dependency tangles, and coupling ranked by git churn."
+        ),
+        "value": "Prioritizes where to refactor and what is safe to touch.",
+    },
+    "fix-bug": {
+        "display": "fix-bug (full)",
+        "description": "Complete risk-ranked file list with all annotation and structural signals.",
+        "value": "More results means less time scanning the codebase manually.",
+    },
+    "review-pr": {
+        "display": "review-pr (expanded)",
+        "description": "Full PR review: blast radius, all execution paths, security and transaction impact.",
+        "value": "CI-grade review — the complete picture before merging.",
+    },
+    "delta": {
+        "display": "prepare-context delta",
+        "description": "Incremental context: git-changed files with impact propagation.",
+        "value": "Designed for CI/CD pipelines — runs on every PR, flags risk automatically.",
+    },
+    "generate-tests": {
+        "display": "prepare-context generate-tests",
+        "description": "Test gap analysis: finds untested files with coverage recommendations.",
+        "value": "Reduces test debt systematically across the entire codebase.",
+    },
+    "--full": {
+        "display": "--full flag",
+        "description": (
+            "Removes truncation limits on transactional boundaries, DTO mappers, and large result sets."
+        ),
+        "value": "Essential for complete analysis of enterprise-scale codebases.",
+    },
+}
+
 # ---------------------------------------------------------------------------
 # Global license state — loaded once at import time
 # ---------------------------------------------------------------------------
@@ -147,30 +194,74 @@ _init()
 
 
 # ---------------------------------------------------------------------------
-# Enforcement
+# Entitlement helpers
 # ---------------------------------------------------------------------------
 
-def require_pro(feature_name: str) -> None:
-    """Exit with structured JSON error when not Pro.
+def can_use(feature_name: str) -> bool:
+    """Return True if the current plan has access to feature_name.
+
+    Does not trigger revalidation — use require_feature() at command entry
+    points where you want revalidation + gating in one call.
+    """
+    return is_pro
+
+
+def require_feature(feature_name: str) -> None:
+    """Exit with a clean upgrade prompt when feature_name requires Pro.
 
     Re-validates stale cached license before gating (once per 24 h, online).
 
+    Writes human-readable context to stderr (terminal UX) and a JSON error
+    to stdout (backward-compatible machine-readable format).
+
+    Example:
+        from sourcecode.license import require_feature
+        require_feature("impact")
+    """
+    _maybe_revalidate()
+
+    if is_pro:
+        return
+
+    info = _FEATURE_INFO.get(feature_name, {})
+    display = info.get("display", feature_name)
+    description = info.get("description", "")
+    value = info.get("value", "")
+
+    # Human-readable upgrade prompt on stderr
+    lines = [f"\n  '{display}' is a Pro feature."]
+    if description:
+        lines.append(f"  {description}")
+    if value:
+        lines.append(f"  {value}")
+    lines.append("")
+    lines.append("  Upgrade:  sourcecode activate <license_key>")
+    lines.append("")
+    sys.stderr.write("\n".join(lines) + "\n")
+    sys.stderr.flush()
+
+    # JSON on stdout — backward-compatible for CI / MCP consumers
+    payload = {
+        "error": "pro_required",
+        "feature": feature_name,
+        "message": (
+            f"'{display}' requires a Pro license. "
+            "Run: sourcecode activate <license_key>"
+        ),
+    }
+    sys.stdout.write(json.dumps(payload, ensure_ascii=False) + "\n")
+    sys.stdout.flush()
+    sys.exit(1)
+
+
+def require_pro(feature_name: str) -> None:
+    """Backward-compatible alias for require_feature.
+
     Example:
         from sourcecode.license import require_pro
         require_pro("impact")
     """
-    if is_pro:
-        _maybe_revalidate()
-
-    if not is_pro:
-        payload = {
-            "error": "pro_required",
-            "feature": feature_name,
-            "message": "Run: sourcecode activate <license_key>",
-        }
-        sys.stdout.write(json.dumps(payload, ensure_ascii=False) + "\n")
-        sys.stdout.flush()
-        sys.exit(1)
+    require_feature(feature_name)
 
 
 # ---------------------------------------------------------------------------

{sourcecode-1.31.32.dist-info → sourcecode-1.32.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.31.32
+Version: 1.32.0
 Summary: Deterministic codebase context for AI coding agents
 License:                                  Apache License
                                    Version 2.0, January 2004
@@ -225,7 +225,7 @@ Description-Content-Type: text/markdown
 
 **AI-ready change intelligence for Java/Spring enterprise monoliths.**
 
-![Version](https://img.shields.io/badge/version-1.31.32-blue)
+![Version](https://img.shields.io/badge/version-1.32.0-blue)
 ![Python](https://img.shields.io/badge/python-3.10%2B-green)
 
 ---
@@ -263,7 +263,7 @@ pipx install sourcecode
 
 ```bash
 sourcecode version
-# sourcecode 1.31.32
+# sourcecode 1.32.0
 ```
 
 ---

{sourcecode-1.31.32.dist-info → sourcecode-1.32.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-sourcecode/__init__.py,sha256=FAgcPCebMe_1K921d8TjlfM7T_GMcbLwHvBZvp_uat8,104
+sourcecode/__init__.py,sha256=1pcmq6UuzqBpI1Q4E_5ukKd_IJ8s8CN4xrW1_EyV0Gw,103
 sourcecode/adaptive_scanner.py,sha256=XffluXKzJUXrMtjEiAOnSNPZnztdIcts17T9ouHeID0,10521
 sourcecode/architecture_analyzer.py,sha256=Ry3aYT9dc7XuLmWLT5IZ93RkCf_P14Qtew0nGPvUl_8,42184
 sourcecode/architecture_summary.py,sha256=z34_6v7cSwy98cof2UVciGho7SCrZ93tiqMmq5WNzRQ,20405
@@ -6,7 +6,7 @@ sourcecode/ast_extractor.py,sha256=_btmeOJIe3t-NicF94D5ZAesa2YIJ0_QNExGnbHxGFE,5
 sourcecode/cache.py,sha256=pBrPdpPrOgpXHHQO670U3aUfVf5N3A3obsTKgiZtN4I,23030
 sourcecode/canonical_ir.py,sha256=_HM3AUmKSdna9u4dCoU6rpgSA6HdF8gzOKZykIUCNGY,23277
 sourcecode/classifier.py,sha256=yWeq6agTjkFa3zuNa-gdVIHtjoBoPoVlJnX-b7tdVJs,7851
-sourcecode/cli.py,sha256=7tkUpZEnXjU_swX1wadkMnfYS0A0p0NvSRZEBIOLLi0,161521
+sourcecode/cli.py,sha256=7GfBpmy2_6lUbuNz8zft4Vof-WOeGnzpeSNwxzDQndM,163863
 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
@@ -22,7 +22,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=oiAxBXHf1mz42rrDKQCPX28W2yaAHvWqaVZuijJGSF8,7902
+sourcecode/license.py,sha256=m5n4PKZ7ZZZ17bpLjIsKwd94PXaIg5iS_2kFNjCV2Og,11378
 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
@@ -78,8 +78,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.31.32.dist-info/METADATA,sha256=69Ai2xiH7kn4Zmsm-KhGAfTTXtUbmyyy9EgLSSQ9GU4,31103
-sourcecode-1.31.32.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-1.31.32.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
-sourcecode-1.31.32.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-1.31.32.dist-info/RECORD,,
+sourcecode-1.32.0.dist-info/METADATA,sha256=FHXYjifmhRxjdL38qMdsKuEz9_H2nJIrodG2c7R2LHM,31100
+sourcecode-1.32.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-1.32.0.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
+sourcecode-1.32.0.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-1.32.0.dist-info/RECORD,,