sourcecode 3.2.2__py3-none-any.whl → 3.3.0__py3-none-any.whl

sourcecode/__init__.py

@@ -4,4 +4,4 @@ ASK Engine is the product. ``ask`` is the canonical CLI command; ``sourcecode``
 the legacy compatibility alias and the Python/PyPI package name. See
 docs/PRODUCT_IDENTITY.md (normative)."""
 
-__version__ = "3.2.2"
+__version__ = "3.3.0"

sourcecode/cli.py

@@ -8105,47 +8105,44 @@ def auth_status_cmd() -> None:
     """Show current authentication and plan status."""
     import json as _json
     try:
-        from sourcecode.license import (
-            _PRO_UNLOCK_ALL as _unlock,
-            _license_data as _ld,
-            is_pro as _ip,
-        )
+        from sourcecode.license import _license_data as _ld, entitlement as _entitlement
+        _ent = _entitlement()
     except Exception:
         _ld = None
-        _ip = False
-        _unlock = False
-
-    # While the early-adoption unlock is on, every Pro command runs. Reporting
-    # `pro: false` here contradicted the --help header and the commands' own
-    # behaviour: the status has to describe the gating that is actually in force,
-    # not the credential that happens to be absent.
-    _gating = {
-        "pro_gating": "disabled" if _unlock else "enabled",
-        "pro_effective": bool(_ip or _unlock),
-    }
-    if _unlock:
-        _gating["pro_reason"] = "early-adoption unlock: Pro commands run without a license"
-
-    if not _ld:
-        out: dict = {
-            "status": "unauthenticated",
-            "pro": bool(_unlock),
-            **_gating,
+        _ent = {
+            "entitlement": "free", "source": "free_tier", "authenticated": False,
+            "paywall_active": True, "when_it_changes": "", "free_repo_java_file_limit": None,
         }
-        sys.stdout.write(_json.dumps(out, ensure_ascii=False) + "\n")
-        sys.stdout.flush()
-        return
 
-    out = {
-        "status": "authenticated",
-        "auth_method": _ld.get("auth_method", "license_key"),
-        "email": _ld.get("email", ""),
-        "plan": _ld.get("plan", "unknown"),
-        "plan_status": _ld.get("status", "unknown"),
-        "pro": _ip,
-        "validated_at": _ld.get("validated_at") or _ld.get("activated_at") or "",
-        **_gating,
+    # P-2: one authority (`license.entitlement`) answers "what runs here, and why".
+    # The legacy keys below are *derived* from it rather than computed a second
+    # time — that is what stops `{"status": "unauthenticated", "pro": true}` from
+    # reappearing. They are deprecated and will be removed in a future major.
+    _pro = _ent["entitlement"] == "pro"
+    _legacy = {
+        "pro": _pro,
+        "pro_effective": _pro,
+        "pro_gating": "enabled" if _ent["paywall_active"] else "disabled",
     }
+    if _ent["source"] == "early_adoption_unlock":
+        _legacy["pro_reason"] = "early-adoption unlock: Pro commands run without a license"
+
+    out: dict = {
+        "status": "authenticated" if _ent["authenticated"] else "unauthenticated",
+        **_ent,
+        **_legacy,
+        "deprecated_fields": ["pro", "pro_effective", "pro_gating", "pro_reason"],
+    }
+    if _ld:
+        out.update({
+            "auth_method": _ld.get("auth_method", "license_key"),
+            "email": _ld.get("email", ""),
+            "plan": _ld.get("plan", "unknown"),
+            # The authority reads a missing status as active, so reporting
+            # "unknown" here would contradict the entitlement in the same object.
+            "plan_status": _ld.get("status", "active"),
+            "validated_at": _ld.get("validated_at") or _ld.get("activated_at") or "",
+        })
     sys.stdout.write(_json.dumps(out, indent=2, ensure_ascii=False) + "\n")
     sys.stdout.flush()
 

sourcecode/license.py

@@ -376,16 +376,78 @@ def _maybe_revalidate() -> None:
         pass
 
 
-def _init() -> None:
-    global _license_data, is_pro
-    _license_data = _load_license_file()
-    is_pro = (
+def entitlement() -> dict:
+    """The one answer to "what runs here today, and why" (P-2).
+
+    `auth status` used to publish four fields about this — `status`, `pro`,
+    `pro_gating`, `pro_effective`, plus a `pro_reason` sentence — and they read as
+    a contradiction: `{"status": "unauthenticated", "pro": true}`. Each field was
+    true on its own axis; together they told a buyer nothing about what they have,
+    why they have it, or what changes when it ends. That is the ADR-0008 pattern
+    exactly, on the commercial surface instead of an analysis one.
+
+    Every published entitlement field is derived from this dict and nowhere else.
+
+    Keys:
+      entitlement        "pro" | "free" — what actually runs right now
+      source             why: "license_key" | "early_adoption_unlock" | "free_tier"
+      authenticated      whether a credential is on this machine (an independent
+                         fact: today one can be entitled to Pro without one)
+      paywall_active     whether the paywall is enforcing anything at all
+      when_it_changes    what a user loses when `source` stops applying, in the
+                         terms the gate actually uses — never a price
+      free_repo_java_file_limit
+                         the number the size gate compares against
+    """
+    authenticated = _license_data is not None
+    licensed = bool(
         _license_data is not None
         and _license_data.get("plan") == "pro"
         and _license_data.get("status", "active") != "inactive"
     )
-    if _PRO_UNLOCK_ALL:
-        is_pro = True  # TEMPORARY: early-adoption Pro unlock (see _PRO_UNLOCK_ALL)
+    if licensed:
+        source = "license_key"
+    elif _PRO_UNLOCK_ALL:
+        source = "early_adoption_unlock"
+    else:
+        source = "free_tier"
+
+    if source == "license_key":
+        when = "Your licence entitles you to Pro; nothing changes while it stays active."
+    elif source == "early_adoption_unlock":
+        when = (
+            "Pro runs without a licence during early adoption. When that ends, every command "
+            f"still runs at full output on repositories up to {_FREE_REPO_JAVA_FILE_LIMIT} Java "
+            "source files; above that, the heavy-analysis commands ask for Pro. Capability is "
+            "never what is gated — size, automation and team are."
+        )
+    else:
+        when = (
+            f"Every command runs at full output on repositories up to {_FREE_REPO_JAVA_FILE_LIMIT} "
+            "Java source files. Above that, the heavy-analysis commands require Pro."
+        )
+
+    return {
+        "entitlement": "pro" if (licensed or _PRO_UNLOCK_ALL) else "free",
+        "source": source,
+        "authenticated": authenticated,
+        "paywall_active": not _PRO_UNLOCK_ALL,
+        "when_it_changes": when,
+        "free_repo_java_file_limit": _FREE_REPO_JAVA_FILE_LIMIT,
+    }
+
+
+def _init() -> None:
+    """Load the credential and derive the entitlement from the one authority.
+
+    `is_pro` is what every gate reads (`can_use`, `require_feature`), and it is
+    computed here from `entitlement()` rather than beside it — a second copy of
+    this rule is how `auth status` came to publish a state the commands
+    contradicted (P-2).
+    """
+    global _license_data, is_pro
+    _license_data = _load_license_file()
+    is_pro = entitlement()["entitlement"] == "pro"
 
 
 _init()

{sourcecode-3.2.2.dist-info → sourcecode-3.3.0.dist-info}/METADATA

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

@@ -1,4 +1,4 @@
-sourcecode/__init__.py,sha256=U82Z_Ox36oAqoNY_hG72f5nWmFp6G5hZFIJetg0zXsI,308
+sourcecode/__init__.py,sha256=9RKwt2uA8CQnRB8LqY0DRISYNXIrngyDDSP38-y1QgU,308
 sourcecode/adaptive_scanner.py,sha256=yJBKjNpkY6bpueYJ2YnRezen3sYZDecEt7WaaNWdqug,9466
 sourcecode/archetype.py,sha256=qWMCyL2UzSGXJhCIZj38JjS7wI15EE3eILsWiaoCZXQ,35779
 sourcecode/architectural_baseline.py,sha256=7QzJri4pbL3nzAn9gNutZW6mZR8HHD6H2C2H1EEwYPE,17904
@@ -15,7 +15,7 @@ sourcecode/chain_rules.py,sha256=Bi6UHfgd-GxWswmnHRcPz5jdbAuqka3Zkz_P-MTvqhw,127
 sourcecode/change_plan.py,sha256=MNgNyu4zrLGvBBaXPwyCh-T2ZGaUQX3Hm4W87uuhZ3w,7750
 sourcecode/cir_graphs.py,sha256=9G0HHj1kw2325IDyzo2OpX73BNswEckecf4MZUXB4JM,12078
 sourcecode/classifier.py,sha256=JBzPwSSrDG-tUHAbcKB678HRbjLpD-ohzbzzO62mgpo,20114
-sourcecode/cli.py,sha256=kXMCuDtQtL5Px8cHHsSPwgfB9S31mxoGJk84nOQ3vHA,411359
+sourcecode/cli.py,sha256=U3Qcs1XcFo6nOeZpG3khVmz-4XHcb-7K1DZN2R4hupM,411709
 sourcecode/code_notes_analyzer.py,sha256=EJemNCNc9Dn-1RZYu-aNbK0ELzmsyC4s6FdHi3XyNEI,9392
 sourcecode/compare.py,sha256=jdePg0dNCxFpysiTGMsROL5XABLjy_zVUgVeySvdb0o,7514
 sourcecode/confidence_analyzer.py,sha256=_nvtwO6RM3k0JMuH5m7DsBxOD0PdxGFS4Bb1fTQ536E,21946
@@ -51,7 +51,7 @@ sourcecode/graph_evidence.py,sha256=rENNsYRZeNstX_ExNCLlbHJAruFQwxo5d00x6wO3xwI,
 sourcecode/hibernate_strat.py,sha256=5GmHiB865HxKdvaxeFV07ojglUgxyOP41AY2xiHfV30,61700
 sourcecode/integration_coordinates.py,sha256=7vGFxN4tCn_KTisYFJuixa8XkyHBoasEFB3fqM62OBI,7407
 sourcecode/jdk_exports.py,sha256=fCrlwNAXUT9gge_joq6kMnY3zJxYB2pxqy-0w3o3MJI,874
-sourcecode/license.py,sha256=OwLh4x1gU_iGL69zFKAgsnwHO2yx9jBsCOK_WK7CUUw,24907
+sourcecode/license.py,sha256=vvgE1vBUWh8ozWI7USYuteh6noxntnjuzDQIPF-l4rA,27795
 sourcecode/mcp_nudge.py,sha256=lKemOqK_wny2u7Ymcr2Idi5Kx8pXY02jCi-_nJYLGMg,2992
 sourcecode/metrics_analyzer.py,sha256=gLoRWKygF18jLgwsqmGXSWopw-f5iO1VbM7Jjdif6ag,22809
 sourcecode/migrate_check.py,sha256=TJvaShbglENOr8ikvCodnlXQy54TtT05N2ZVe02b3lc,110421
@@ -165,8 +165,8 @@ sourcecode/telemetry/consent.py,sha256=pQdl-QeLl6Gcibn0eWHSKZrm-HYSsjpVqOnjrgFp8
 sourcecode/telemetry/events.py,sha256=4_yeO58U-Cwc1Qb27VB0_EjhmroY0k91n3_VGxeALB8,2776
 sourcecode/telemetry/filters.py,sha256=RzxauTz8HliO4BllQnXEXc7zTeqdCZi5MgqGEDuW7OQ,6570
 sourcecode/telemetry/transport.py,sha256=4gGHsq0WeY9VywEZXA3vUxykfiYnw9uuqfjAAec7F8o,1681
-sourcecode-3.2.2.dist-info/METADATA,sha256=jVS3W1ZhWUoj34fE8GVEeg4w8CmEPhtAxCpuJ-qIEV4,19406
-sourcecode-3.2.2.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-3.2.2.dist-info/entry_points.txt,sha256=-JEAdChrK5We51kZcb7OaDcyil-dHBjBPL-NhuO-QY8,89
-sourcecode-3.2.2.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-3.2.2.dist-info/RECORD,,
+sourcecode-3.3.0.dist-info/METADATA,sha256=-QNzeVGjrT6BamRBDHef_8YUe7F6CtJzScZvbswMex0,19406
+sourcecode-3.3.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-3.3.0.dist-info/entry_points.txt,sha256=-JEAdChrK5We51kZcb7OaDcyil-dHBjBPL-NhuO-QY8,89
+sourcecode-3.3.0.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-3.3.0.dist-info/RECORD,,