Function prompt_if_needed

uncommon_route/telemetry.py:121–165

Show opt-in prompt if user hasn't decided yet. Returns enabled state.

()

def prompt_if_needed() -> bool:
    """Show opt-in prompt if user hasn't decided yet. Returns enabled state."""
    # Skip if already decided
    config = _load_config()
    if "telemetry" in config:
        return config.get("telemetry", {}).get("enabled", False)

    # Skip if non-interactive
    if not sys.stdin.isatty() or os.environ.get("CI"):
        return False

    # Skip if env var is set
    env = os.environ.get("UNCOMMON_ROUTE_TELEMETRY", "").strip()
    if env:
        return env.lower() in ("on", "true", "1", "yes")

    if os.environ.get("DO_NOT_TRACK", "").strip() == "1":
        return False

    # Prompt
    print("""
────────────────────────────────────────────────────
Help improve UncommonRoute's routing accuracy by
sharing pseudonymous routing metadata?

  ✓ Routing predictions, model selections, outcomes
  ✗ NO prompts, responses, API keys, or personal info

  Details: https://github.com/CommonstackAI/UncommonRoute/blob/main/TELEMETRY.md
────────────────────────────────────────────────────""")
    try:
        answer = input("Share pseudonymous routing data? [y/N]: ").strip().lower()
    except (EOFError, KeyboardInterrupt):
        answer = "n"

    enabled = answer in ("y", "yes")
    config["telemetry"] = {"enabled": enabled}
    _save_config(config)

    if enabled:
        print("  Telemetry enabled. Disable anytime: uncommon-route telemetry disable")
    else:
        print("  Telemetry disabled. Enable anytime: uncommon-route telemetry enable")

    return enabled


def enable() -> None: