sourcecode 1.36.1__py3-none-any.whl → 1.36.2__py3-none-any.whl

sourcecode/__init__.py

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

sourcecode/cli.py

@@ -6212,4 +6212,13 @@ def main_entry() -> None:
         except Exception:
             pass
     _preprocess_argv()
-    app()
+    try:
+        app()
+    finally:
+        # Best-effort "new version available" nudge. Only speaks on an
+        # interactive terminal; never blocks, raises, or affects exit status.
+        try:
+            from sourcecode.version_check import maybe_notify_update
+            maybe_notify_update(__version__)
+        except Exception:
+            pass

sourcecode/version_check.py

@@ -0,0 +1,149 @@
+"""Best-effort "new version available" nudge.
+
+Prints a single stderr line when a newer release exists on PyPI. Designed to be
+invisible unless it has something useful to say:
+
+  * Only runs in an interactive terminal (stderr.isatty()) — never pollutes
+    piped output, MCP stdio, CI logs, or test runners.
+  * Hits the network at most once per 24h (cached in
+    ~/.sourcecode/version_check.json); warm runs read the cache and are instant.
+  * Re-shows the same nudge at most ~once per 20h so it informs without nagging.
+  * Swallows every error and never blocks meaningfully (1.5s network timeout).
+
+Disable entirely with SOURCECODE_NO_UPDATE_CHECK=1 (also off under SOURCECODE_CI).
+The check reads PyPI only; it never touches the license in ~/.sourcecode/license.json.
+"""
+from __future__ import annotations
+
+import json
+import os
+import sys
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Optional
+
+_CACHE_DIR = Path.home() / ".sourcecode"
+_CACHE_FILE = _CACHE_DIR / "version_check.json"
+_PYPI_URL = "https://pypi.org/pypi/sourcecode/json"
+_CHECK_TTL_SECONDS = 86_400   # refresh the PyPI lookup at most once per 24h
+_NOTIFY_TTL_SECONDS = 72_000  # re-show the nudge at most every ~20h
+_FETCH_TIMEOUT = 1.5
+
+
+def _disabled() -> bool:
+    """True when the nudge must stay silent (opt-out, CI, or non-interactive)."""
+    if os.environ.get("SOURCECODE_NO_UPDATE_CHECK"):
+        return True
+    if os.environ.get("SOURCECODE_CI"):
+        return True
+    try:
+        return not sys.stderr.isatty()
+    except Exception:
+        return True  # no usable stderr -> stay silent
+
+
+def _read_cache() -> dict:
+    try:
+        if _CACHE_FILE.exists():
+            return json.loads(_CACHE_FILE.read_text(encoding="utf-8"))
+    except Exception:
+        pass
+    return {}
+
+
+def _write_cache(data: dict) -> None:
+    try:
+        _CACHE_DIR.mkdir(parents=True, exist_ok=True)
+        tmp = _CACHE_FILE.with_suffix(".tmp")
+        tmp.write_text(json.dumps(data, ensure_ascii=False), encoding="utf-8")
+        tmp.replace(_CACHE_FILE)
+    except Exception:
+        pass
+
+
+def _age_seconds(iso: Optional[str]) -> float:
+    if not iso:
+        return float("inf")
+    try:
+        ts = datetime.fromisoformat(iso)
+        if ts.tzinfo is None:
+            ts = ts.replace(tzinfo=timezone.utc)
+        return (datetime.now(timezone.utc) - ts).total_seconds()
+    except Exception:
+        return float("inf")
+
+
+def _fetch_latest() -> Optional[str]:
+    import urllib.request
+    try:
+        req = urllib.request.Request(_PYPI_URL, headers={"Accept": "application/json"})
+        with urllib.request.urlopen(req, timeout=_FETCH_TIMEOUT) as resp:
+            data = json.loads(resp.read().decode("utf-8"))
+        return ((data.get("info") or {}).get("version")) or None
+    except Exception:
+        return None
+
+
+def _parse(v: str) -> tuple:
+    """Lenient dotted-numeric parse for the fallback path (no packaging dep)."""
+    parts = []
+    for chunk in str(v).split("."):
+        num = ""
+        for ch in chunk:
+            if ch.isdigit():
+                num += ch
+            else:
+                break
+        parts.append(int(num) if num else 0)
+    return tuple(parts)
+
+
+def _is_newer(latest: str, current: str) -> bool:
+    try:
+        from packaging.version import parse as _vparse  # type: ignore
+        return _vparse(latest) > _vparse(current)
+    except Exception:
+        return _parse(latest) > _parse(current)
+
+
+def maybe_notify_update(current_version: str) -> None:
+    """Print an upgrade nudge to stderr if PyPI has a newer release.
+
+    Best-effort and fully guarded: any failure is silently ignored. Safe to call
+    unconditionally from the CLI entry point.
+    """
+    if _disabled():
+        return
+    try:
+        cache = _read_cache()
+
+        # Refresh the cached "latest" at most once per TTL (the only network hit).
+        if _age_seconds(cache.get("checked_at")) >= _CHECK_TTL_SECONDS:
+            latest = _fetch_latest()
+            if latest:
+                cache["latest"] = latest
+                cache["checked_at"] = datetime.now(timezone.utc).isoformat()
+                _write_cache(cache)
+
+        latest = cache.get("latest")
+        if not latest or not _is_newer(latest, current_version):
+            return
+
+        # Throttle: don't nag for the same version more than once per ~20h.
+        if (
+            cache.get("notified_for") == latest
+            and _age_seconds(cache.get("notified_at")) < _NOTIFY_TTL_SECONDS
+        ):
+            return
+
+        sys.stderr.write(
+            f"\n[sourcecode] v{latest} is available (you have {current_version}). "
+            "Upgrade: pipx upgrade sourcecode  (pip: pip install -U sourcecode)\n"
+        )
+        sys.stderr.flush()
+
+        cache["notified_for"] = latest
+        cache["notified_at"] = datetime.now(timezone.utc).isoformat()
+        _write_cache(cache)
+    except Exception:
+        pass

{sourcecode-1.36.1.dist-info → sourcecode-1.36.2.dist-info}/METADATA

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

@@ -1,4 +1,4 @@
-sourcecode/__init__.py,sha256=mpBzwyDeOFDWE6zNN6TkjBgPX2taBQzVcufgFBu_TN8,103
+sourcecode/__init__.py,sha256=OwsI0itjMvrYqTYz2jWyNvxs5j-e5JKVwJ4h7_kCDEQ,103
 sourcecode/adaptive_scanner.py,sha256=XffluXKzJUXrMtjEiAOnSNPZnztdIcts17T9ouHeID0,10521
 sourcecode/architecture_analyzer.py,sha256=liCwQmLgb5vplohy8arjYxs_HOIv5C9MjLh_gY6bc5Q,44115
 sourcecode/architecture_summary.py,sha256=z34_6v7cSwy98cof2UVciGho7SCrZ93tiqMmq5WNzRQ,20405
@@ -7,7 +7,7 @@ sourcecode/cache.py,sha256=1V3vsaODAa2UBJAC0xpvxpmRdriCezQx5Q8JCcfgziE,31892
 sourcecode/canonical_ir.py,sha256=c_lYTVoegg-1W2dZ34_2s3tN8L0GVx7eiDRh9ghdSD8,24178
 sourcecode/cir_graphs.py,sha256=rZi8JV4ZrAa2WSCeyNa4JIEKQ_yZzDZTsrvVz2KfuKA,8919
 sourcecode/classifier.py,sha256=hKzg-nQ47htqqIUzSGvYxv15cXrA3KgICTwJmdqal0o,8095
-sourcecode/cli.py,sha256=76_rdkUKpm9fGP-97rx5Q25q2KXzW030fDpDZiwCnIA,252320
+sourcecode/cli.py,sha256=oNcQu-l2maZ9Pb2fZiY4JTCojFi0C156TLGTrJBKT34,252665
 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
@@ -58,6 +58,7 @@ sourcecode/spring_semantic.py,sha256=O1nKSGVzlukuxLHQVuCPxc-XrcrMFxwlHA20_dmEGgM
 sourcecode/spring_tx_analyzer.py,sha256=FdFcyqPp3aT9oJ-PKrnXcTA6s69wdvzG-NBm0GMGPTU,30717
 sourcecode/summarizer.py,sha256=zgdps7yS2IktAbWe7IWz0oUcr3QIuNPRGrsScbZ4R1g,21797
 sourcecode/tree_utils.py,sha256=8GAkIfQAsvtEudIeW1l4ooH_oRtrWR8cpJQJsEa_Pfw,2093
+sourcecode/version_check.py,sha256=CHp6ZxTIfo8kyHPCBgJA1uFC0xQCoXMuuOfrW8QTL8o,4942
 sourcecode/workspace.py,sha256=X_6NmNnitvT3_38V-JDChydo_sR68s249hLFlrQskU0,8271
 sourcecode/detectors/__init__.py,sha256=A0AACJFF6HWf_RgatNtWu3PUzstcKtIGM9f1PoFcJug,1987
 sourcecode/detectors/base.py,sha256=C2EqfZudQ1ITK4DID4M70nPxqoh9bl1zn_ta6XRaGWs,1168
@@ -96,8 +97,8 @@ sourcecode/telemetry/consent.py,sha256=wLMvGNJeSSyZoNkQXpoUioY6mMv4Qdvuw7S9jAEWn
 sourcecode/telemetry/events.py,sha256=LtzYfaX9Ilckj5PTvAcTpDa9mLqDsYPDUiDkRa58piY,2580
 sourcecode/telemetry/filters.py,sha256=NHa5T-6DaZduQPFuC34jOqHWQgSizM-Ygq8aZ4j19ng,5834
 sourcecode/telemetry/transport.py,sha256=4gGHsq0WeY9VywEZXA3vUxykfiYnw9uuqfjAAec7F8o,1681
-sourcecode-1.36.1.dist-info/METADATA,sha256=3B_cemxNmCw3HpB0xSWmblfvftNCGh45Wi5mQvvrdeg,30313
-sourcecode-1.36.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-1.36.1.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
-sourcecode-1.36.1.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-1.36.1.dist-info/RECORD,,
+sourcecode-1.36.2.dist-info/METADATA,sha256=JWwQcBBUaBi8XxPm9ztTXwbj-lqk1CebR-LnQPQ731A,30313
+sourcecode-1.36.2.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-1.36.2.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
+sourcecode-1.36.2.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-1.36.2.dist-info/RECORD,,