sourcecode 1.59.0__py3-none-any.whl → 1.60.0__py3-none-any.whl

sourcecode/__init__.py

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

sourcecode/cli.py

@@ -584,7 +584,7 @@ try:
 except Exception:
     pass
 
-telemetry_app = typer.Typer(help="Manage anonymous telemetry (opt-in).", rich_markup_mode="rich")
+telemetry_app = typer.Typer(help="Manage anonymous telemetry (on by default; opt-out).", rich_markup_mode="rich")
 app.add_typer(telemetry_app, name="telemetry")
 
 mcp_app = typer.Typer(help="MCP integration: setup, status, serve, remove.", rich_markup_mode="rich")
@@ -597,18 +597,18 @@ auth_app = typer.Typer(help="Authentication: status, logout.", rich_markup_mode=
 app.add_typer(auth_app, name="auth")
 
 
-def _maybe_ask_consent() -> None:
-    """Show first-run consent prompt once, on interactive TTYs only."""
+def _maybe_show_telemetry_notice() -> None:
+    """Show first-run telemetry notice once, on interactive TTYs only.
+
+    Telemetry is on by default (opt-out). We inform rather than ask, then
+    mark the notice as shown so it appears only once.
+    """
     try:
-        from sourcecode.telemetry.config import has_been_asked, set_enabled
-        from sourcecode.telemetry.consent import ask_for_consent
+        from sourcecode.telemetry.config import has_been_asked, mark_asked
+        from sourcecode.telemetry.consent import show_first_run_notice
         if not has_been_asked():
-            enabled = ask_for_consent()
-            set_enabled(enabled)
-            if enabled:
-                typer.echo("Telemetry enabled. Thank you. Disable: sourcecode telemetry disable", err=True)
-            else:
-                typer.echo("Telemetry disabled. Enable anytime: sourcecode telemetry enable", err=True)
+            show_first_run_notice()
+            mark_asked()
     except Exception:
         pass
 
@@ -1020,9 +1020,9 @@ def main(
       sourcecode /path/to/repo --compact  analyze specific path
       sourcecode --agent                agent-optimized output (full detail)
     """
-    # First-run consent (skip for telemetry/version/config subcommands)
+    # First-run telemetry notice (skip for telemetry/version/config subcommands)
     if ctx.invoked_subcommand not in ("telemetry", "version", "config"):
-        _maybe_ask_consent()
+        _maybe_show_telemetry_notice()
         _maybe_show_mcp_hint()
 
     # When a subcommand is invoked, skip the main analysis.
@@ -3342,12 +3342,12 @@ def telemetry_status() -> None:
     enabled = is_enabled()
     asked = has_been_asked()
     status = "enabled" if enabled else "disabled"
-    typer.echo(f"Telemetry: {status}")
+    typer.echo(f"Telemetry: {status} (on by default; opt-out)")
     if not asked:
-        typer.echo("  (consent not yet shown — will prompt on next run)")
+        typer.echo("  (first-run notice not yet shown — will show on next run)")
     typer.echo(f"  Config: {config_file_path()}")
-    typer.echo("  Disable permanently: sourcecode telemetry disable")
-    typer.echo("  Or set env var:      SOURCECODE_TELEMETRY=0")
+    typer.echo("  Disable: sourcecode telemetry disable")
+    typer.echo("  Or set env var: SOURCECODE_TELEMETRY=0  (or DO_NOT_TRACK=1)")
 
 
 @telemetry_app.command("enable")
@@ -3369,6 +3369,7 @@ def telemetry_disable() -> None:
     from sourcecode.telemetry.config import set_enabled
     set_enabled(False)
     typer.echo("Telemetry disabled. No data will be collected or sent.")
+    typer.echo("Telemetry is on by default; this opt-out is remembered.")
     typer.echo("Re-enable at any time: sourcecode telemetry enable")
 
 

sourcecode/license.py

@@ -372,7 +372,7 @@ _init()
 # ---------------------------------------------------------------------------
 
 def _emit_telemetry(event: str, **kw: object) -> None:
-    """Best-effort telemetry emit. Respects opt-in; never raises or blocks."""
+    """Best-effort telemetry emit. Respects the user's opt-out; never raises or blocks."""
     try:
         from sourcecode import telemetry as _tel
         _tel.record(event, **kw)  # type: ignore[arg-type]

sourcecode/telemetry/__init__.py

@@ -1,12 +1,12 @@
-"""sourcecode telemetry — opt-in anonymous usage metrics.
+"""sourcecode telemetry — anonymous usage metrics, on by default (opt-out).
 
 Public API:
     is_enabled()          → bool
     record(event, **kw)   → None  (fire-and-forget)
     session_id()          → str   (ephemeral 8-char hex, new each process)
 
-Telemetry is strictly opt-in. It is disabled by default and can be disabled
-at any time via `sourcecode telemetry disable` or SOURCECODE_TELEMETRY=0.
+Telemetry is enabled by default and stays anonymous. It can be disabled at any
+time via `sourcecode telemetry disable`, SOURCECODE_TELEMETRY=0, or DO_NOT_TRACK=1.
 
 Nothing sensitive (code, paths, secrets, output) is ever collected.
 See docs/privacy.md for full details.

sourcecode/telemetry/config.py

@@ -1,6 +1,10 @@
 """Persistent telemetry configuration.
 
+Telemetry is enabled by default (opt-out). It stays anonymous and never
+collects source code, paths, secrets or repository content.
+
 Config file: ~/.config/sourcecode/config.json
+Disable: `sourcecode telemetry disable`, SOURCECODE_TELEMETRY=0, or DO_NOT_TRACK=1
 Env override: SOURCECODE_TELEMETRY=0 (disable) or =1 (enable)
 """
 
@@ -14,6 +18,18 @@ from typing import Any
 _ENV_VAR = "SOURCECODE_TELEMETRY"
 _CONFIG_FILE = Path.home() / ".config" / "sourcecode" / "config.json"
 
+# CI markers — when no explicit choice has been made, telemetry defaults OFF
+# in CI (no human to see the first-run notice), ON otherwise.
+_CI_VARS = (
+    "CI", "CONTINUOUS_INTEGRATION", "GITHUB_ACTIONS", "CIRCLECI",
+    "TRAVIS", "JENKINS_URL", "BUILDKITE", "GITLAB_CI", "TF_BUILD",
+    "TEAMCITY_VERSION", "DRONE", "SEMAPHORE",
+)
+
+
+def _in_ci() -> bool:
+    return any(os.environ.get(v) for v in _CI_VARS)
+
 
 def _load() -> dict[str, Any]:
     try:
@@ -31,17 +47,27 @@ def _save(data: dict[str, Any]) -> None:
 
 
 def is_enabled() -> bool:
-    """True only when telemetry is explicitly opted in.
+    """True unless telemetry has been explicitly disabled.
 
-    Env var takes absolute precedence over config file.
-    Default is always disabled — telemetry is strictly opt-in.
+    Telemetry is enabled by default (opt-out). Precedence, highest first:
+      1. SOURCECODE_TELEMETRY env var (0 = off, 1 = on)
+      2. DO_NOT_TRACK env var (any value other than ""/"0" turns it off)
+      3. config file 'enabled' flag, if the user has made an explicit choice
+      4. default: True — except in CI, where it defaults to False
     """
     env = os.environ.get(_ENV_VAR, "").strip()
     if env == "0":
         return False
     if env == "1":
         return True
-    return bool(_load().get("telemetry", {}).get("enabled", False))
+    dnt = os.environ.get("DO_NOT_TRACK", "").strip()
+    if dnt not in ("", "0"):
+        return False
+    stored = _load().get("telemetry", {}).get("enabled")
+    if stored is not None:
+        return bool(stored)
+    # No explicit choice yet: on by default, off under CI.
+    return not _in_ci()
 
 
 def has_been_asked() -> bool:

sourcecode/telemetry/consent.py

@@ -1,9 +1,11 @@
-"""First-run consent prompt.
+"""First-run telemetry notice.
 
-Shown exactly once, only on interactive TTYs, only when the user hasn't been
-asked before. Default answer is NO — the user must explicitly type 'y' to opt in.
+Telemetry is enabled by default (opt-out) and stays anonymous. The notice is
+shown exactly once, only on interactive TTYs, to inform the user that
+telemetry is on and how to turn it off. It does not ask a question — it
+informs and respects the user's right to disable.
 
-Prompt is written to stderr so it doesn't pollute stdout output.
+Notice is written to stderr so it doesn't pollute stdout output.
 """
 
 from __future__ import annotations
@@ -11,11 +13,11 @@ from __future__ import annotations
 import os
 import sys
 
-_PROMPT = """\
+_NOTICE = """\
 \033[2m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-  sourcecode — optional anonymous telemetry
+  sourcecode — anonymous telemetry is ON by default
 
-  Help improve sourcecode by sharing anonymous usage metrics.
+  Anonymous usage metrics help improve sourcecode.
 
   Collected: tool version, Python version, OS, commands used,
   flags used, approximate repo size, execution duration, errors.
@@ -23,9 +25,9 @@ _PROMPT = """\
   Never collected: source code, file paths, file names, secrets,
   tokens, environment variables, or any repository content.
 
-  You can change this at any time:
+  Disable at any time:
     sourcecode telemetry disable
-    export SOURCECODE_TELEMETRY=0
+    export SOURCECODE_TELEMETRY=0   (or DO_NOT_TRACK=1)
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\033[0m
 """
 
@@ -43,21 +45,16 @@ def _is_interactive() -> bool:
     return not any(os.environ.get(v) for v in ci_vars)
 
 
-def ask_for_consent() -> bool:
-    """Show the consent prompt and return the user's choice.
+def show_first_run_notice() -> None:
+    """Print the one-time telemetry notice on interactive terminals.
 
-    Returns True if the user opted in, False otherwise.
-    Never raises. Default (Enter / non-y input) is False.
+    Never raises. Does nothing on non-interactive / CI environments.
+    Telemetry stays enabled regardless — this only informs the user.
     """
     if not _is_interactive():
-        return False
-
+        return
     try:
-        sys.stderr.write(_PROMPT)
-        sys.stderr.write("  Enable anonymous telemetry? [y/N]: ")
+        sys.stderr.write(_NOTICE)
         sys.stderr.flush()
-        answer = sys.stdin.readline().strip().lower()
-        sys.stderr.write("\n")
-        return answer == "y"
     except Exception:
-        return False
+        pass

{sourcecode-1.59.0.dist-info → sourcecode-1.60.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sourcecode
-Version: 1.59.0
+Version: 1.60.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
@@ -742,7 +742,7 @@ All outputs include:
 
 ## Telemetry
 
-Anonymous, opt-in. Collects: version, OS, commands, flags, duration, repo size range, errors. No source code, paths, secrets, or output content.
+Anonymous, **on by default (opt-out)**. Collects: version, OS, commands, flags, duration, repo size range, errors. No source code, paths, secrets, or output content. A one-time notice is shown on first interactive run.
 
 ```bash
 sourcecode telemetry status
@@ -750,7 +750,7 @@ sourcecode telemetry enable
 sourcecode telemetry disable
 ```
 
-Or: `export SOURCECODE_TELEMETRY=0`
+Disable any time: `export SOURCECODE_TELEMETRY=0` (or `DO_NOT_TRACK=1`)
 
 ---
 

{sourcecode-1.59.0.dist-info → sourcecode-1.60.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-sourcecode/__init__.py,sha256=2epIg2XeTy7k3HoxrmwEPHso7xkeVSRJ3jh1LHHjjkU,103
+sourcecode/__init__.py,sha256=K2X8G7LVjuV1hmr12r2Qonlfz5_JfYRcVzSPr6Z564k,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=DEwucOPJguLsVtg5cV8mWXNi112l5jmBhv73KGGebVk,24849
 sourcecode/cir_graphs.py,sha256=9G0HHj1kw2325IDyzo2OpX73BNswEckecf4MZUXB4JM,12078
 sourcecode/classifier.py,sha256=hKzg-nQ47htqqIUzSGvYxv15cXrA3KgICTwJmdqal0o,8095
-sourcecode/cli.py,sha256=PpqOLcYhNljXCJ0V_RjO9RgsgjzgtDK5jIDTqI3Hk6k,275872
+sourcecode/cli.py,sha256=9JLQ0OgRBwWa4Cf2ufpk9gKOpI3mx6t8yZSxqpF_kXw,275902
 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
@@ -29,7 +29,7 @@ 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/integration_detector.py,sha256=ZJqrGwvZ4ee2JTGhlazKk67aZi173HxkhNpl8Yntpd8,6503
-sourcecode/license.py,sha256=vN7XQb0IY2rxkdsn7LC-Uz2m5f9tNPiJ9JlSVdhpwus,23488
+sourcecode/license.py,sha256=wckiLuiwaE35KMCStUf1gYzleJuFe6qsSyxUQJvit3s,23500
 sourcecode/mcp_nudge.py,sha256=5ELU_ixzh6uA83NXLOZT8h00OhL53okfQdji3jyKOjg,2917
 sourcecode/metrics_analyzer.py,sha256=m0ENgtqKeBL17kUIK3fmGkgo7UfXBNHxCMj0H_Y5K7c,22750
 sourcecode/migrate_check.py,sha256=H8iy7Vk8cGL0dnR3ZkFPS20CtfF5LJWuzQVQE4awQ9s,56192
@@ -96,14 +96,14 @@ sourcecode/mcp/onboarding/applier.py,sha256=B9CneieWTpaDSDIyW3S5nrlRlBpvfqUcgi93
 sourcecode/mcp/onboarding/backup.py,sha256=ihqGOR8QTX8HASRSEDyfFyXr5bkXrygPHamv4p9KTmk,1452
 sourcecode/mcp/onboarding/detector.py,sha256=kDc0U6kXMuq_GivqwKrgJzIVLVeoLr3RQl63ksW10I8,3327
 sourcecode/mcp/onboarding/planner.py,sha256=Fopg5f72FDiPfldF7NOxYjcBA_w8hi_jBJpSz39lPb8,1332
-sourcecode/telemetry/__init__.py,sha256=rth1GuU9Tqt6BvbOe6q6sro1yCygiDW4dN3r1OvmvQM,3375
-sourcecode/telemetry/config.py,sha256=_MfMevIic1NTc8IRmCzQs96D8KPBLOWZ5cdhWrnHuwI,2639
-sourcecode/telemetry/consent.py,sha256=wLMvGNJeSSyZoNkQXpoUioY6mMv4Qdvuw7S9jAEWnII,2237
+sourcecode/telemetry/__init__.py,sha256=6wsJnXsgsL_BtMK4hr5Ae1GToHeWej53F4o_-Tc23MQ,3406
+sourcecode/telemetry/config.py,sha256=u_zctgmA1pVT3Ai5jm-pdLY_5kJTRg4Xq2bvIbGBQE4,3727
+sourcecode/telemetry/consent.py,sha256=H5z2Wu63pZqbaKucRPoJQJ0zCo4cke9ZlBrJC-MaWTE,2201
 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.59.0.dist-info/METADATA,sha256=Tl_qHFWT-yXKwDto4VaZ_H9xnvBvabtL_oCosI4fn-0,38831
-sourcecode-1.59.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-sourcecode-1.59.0.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
-sourcecode-1.59.0.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
-sourcecode-1.59.0.dist-info/RECORD,,
+sourcecode-1.60.0.dist-info/METADATA,sha256=13oyunu_mO7yr8DwHg2AwrNQ4tW0tHWydwzUEoOBnss,38941
+sourcecode-1.60.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+sourcecode-1.60.0.dist-info/entry_points.txt,sha256=ex3F9rmbXeyDIoFQHtkEqTsKSaJow8F0LrVu8XfIktQ,57
+sourcecode-1.60.0.dist-info/licenses/LICENSE,sha256=7DdHrU9Z_3e7dSvq4ISijZNjnuHo5NIHNiHDouMQ9JU,10491
+sourcecode-1.60.0.dist-info/RECORD,,