fixfleet 0.4.1__tar.gz → 0.4.2__tar.gz

{fixfleet-0.4.1/fixfleet.egg-info → fixfleet-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fixfleet
-Version: 0.4.1
+Version: 0.4.2
 Summary: Auto-fix bugs from GitHub, GitLab, Jira, Linear, Bitbucket, or Azure DevOps with AI agents — bring your own CLI or free API.
 Author: Yash Koladiya
 License-Expression: GPL-3.0-or-later
@@ -405,6 +405,17 @@ No. FixFleet runs **100% locally** on your machine. No FixFleet servers, no Azur
 
 </details>
 
+<details>
+<summary><b>Does FixFleet collect any data?</b></summary>
+
+Only anonymous usage analytics (via Google Analytics): event names and coarse metadata like provider key, backend name, and success/failure — **never your code, tokens, project URLs, or issue content**. Used purely to find bugs and see which trackers/backends need attention.
+
+Opt out anytime:
+- CLI: `fixfleet --config-set telemetry.enabled=false` (or set `DO_NOT_TRACK=1`)
+- VSCode: uncheck `fixfleet.telemetry` in settings (the global VS Code telemetry setting is respected too)
+
+</details>
+
 <details>
 <summary><b>What's the difference between the VSCode extension and the CLI?</b></summary>
 

{fixfleet-0.4.1 → fixfleet-0.4.2}/README.md

@@ -377,6 +377,17 @@ No. FixFleet runs **100% locally** on your machine. No FixFleet servers, no Azur
 
 </details>
 
+<details>
+<summary><b>Does FixFleet collect any data?</b></summary>
+
+Only anonymous usage analytics (via Google Analytics): event names and coarse metadata like provider key, backend name, and success/failure — **never your code, tokens, project URLs, or issue content**. Used purely to find bugs and see which trackers/backends need attention.
+
+Opt out anytime:
+- CLI: `fixfleet --config-set telemetry.enabled=false` (or set `DO_NOT_TRACK=1`)
+- VSCode: uncheck `fixfleet.telemetry` in settings (the global VS Code telemetry setting is respected too)
+
+</details>
+
 <details>
 <summary><b>What's the difference between the VSCode extension and the CLI?</b></summary>
 

{fixfleet-0.4.1 → fixfleet-0.4.2}/bugfixer/__init__.py

@@ -1,6 +1,6 @@
 """FixFleet — Fleet of AI agents fixing bugs across any issue tracker."""
 
-__version__ = "0.4.1"
+__version__ = "0.4.2"
 __name_pretty__ = "FixFleet"
 __tagline__ = "Fleet of AI agents fixing bugs across any tracker"
 __author__ = "Yash Koladiya"

{fixfleet-0.4.1 → fixfleet-0.4.2}/bugfixer/cli.py

@@ -5,7 +5,7 @@ import sys
 from datetime import datetime
 from pathlib import Path
 
-from . import budget, config, state, ui
+from . import budget, config, state, telemetry, ui
 from .backends.base import Backend, RunResult
 from .backends.registry import (
     API_PRESETS,
@@ -569,6 +569,7 @@ def _fix_issues(selected: list, project_dir: str, project_id: str,
                 failed += 1
                 continue
 
+        telemetry.track("fix_started", {"provider": "gitlab", "backend": backend.name})
         result: RunResult = backend.run(prompt, project_dir)
         consumed = check.estimated  # use estimate as proxy
 
@@ -590,6 +591,15 @@ def _fix_issues(selected: list, project_dir: str, project_id: str,
         if conf.final_score < 0.20 and not conf.files_changed:
             success = False
 
+        telemetry.track("fix_completed", {
+            "provider": "gitlab",
+            "backend": backend.name,
+            "success": success,
+            "timed_out": result.timed_out,
+            "confidence": conf.label(),
+            "files_changed": len(conf.files_changed),
+        })
+
         session_tokens += consumed
         state.record_usage(
             backend_name=backend.name,
@@ -636,20 +646,24 @@ def main():
     try:
         issues = fetch_bug_issues(token, project_id, date_filter, host=host)
     except GitLabAuthError as e:
+        telemetry.track("provider_error", {"provider": "gitlab", "code": e.code})
         ui.print_error(e.message)
         ui.print_info("Open https://gitlab.com/-/user_settings/personal_access_tokens to create a new token.")
         ui.print_end()
         sys.exit(1)
     except GitLabNotFoundError as e:
+        telemetry.track("provider_error", {"provider": "gitlab", "code": e.code})
         ui.print_error(e.message)
         ui.print_end()
         sys.exit(1)
     except GitLabNetworkError as e:
+        telemetry.track("provider_error", {"provider": "gitlab", "code": e.code})
         ui.print_error(e.message)
         ui.print_info("Check your internet connection and try again.")
         ui.print_end()
         sys.exit(1)
     except GitLabError as e:
+        telemetry.track("provider_error", {"provider": "gitlab", "code": e.code})
         ui.print_error(e.message)
         ui.print_end()
         sys.exit(1)

{fixfleet-0.4.1 → fixfleet-0.4.2}/bugfixer/config.py

@@ -26,6 +26,9 @@ DEFAULT_CONFIG = {
         "inline_max_lines": 250,
     },
     "skip_already_fixed": True,
+    "telemetry": {
+        "enabled": True,  # anonymous usage events only; see bugfixer/telemetry.py
+    },
 }
 
 

{fixfleet-0.4.1 → fixfleet-0.4.2}/bugfixer/json_api.py

@@ -11,7 +11,7 @@ import json
 import sys
 from pathlib import Path
 
-from . import __version__, budget, config, state
+from . import __version__, budget, config, state, telemetry
 from .backends.base import RunResult
 from .backends.registry import (
     API_PRESETS,
@@ -139,12 +139,21 @@ def cmd_list_bugs_json(args):
             date_to=getattr(args, "date_to", None),
         )
     except ProviderNotImplementedError as e:
+        telemetry.track("provider_error", {"provider": provider.key, "code": e.code})
         _err_from_gitlab(e)
     except ProviderError as e:
+        telemetry.track("provider_error", {"provider": provider.key, "code": e.code})
         _err_from_gitlab(e)
     except Exception as e:
+        telemetry.track("unexpected_error", {"where": "list_bugs", "type": type(e).__name__})
         _err(f"unexpected error: {e}", error_code="unexpected")
 
+    telemetry.track("bugs_listed", {
+        "provider": provider.key,
+        "count": len(issues),
+        "date_filter": bool(args.date or getattr(args, "date_from", None) or getattr(args, "date_to", None)),
+    })
+
     payload_issues = []
     for i in issues:
         parsed = parse_issue(i)
@@ -238,8 +247,10 @@ def cmd_fix_issue(args):
     try:
         issues = provider.fetch_bugs(token=token, project_id=project_id, host=host)
     except ProviderNotImplementedError as e:
+        telemetry.track("provider_error", {"provider": provider.key, "code": e.code})
         _err_from_gitlab(e)
     except ProviderError as e:
+        telemetry.track("provider_error", {"provider": provider.key, "code": e.code})
         _err_from_gitlab(e)
     target = next(
         (i for i in issues if str(i.get("iid")) == str(issue_iid)),
@@ -261,6 +272,7 @@ def cmd_fix_issue(args):
         budgets=cfg_budgets,
     )
     if not check.allowed and not getattr(args, "force", False):
+        telemetry.track("budget_blocked", {"backend": backend.name})
         _emit({
             "ok": False,
             "code": "budget_exceeded",
@@ -275,6 +287,7 @@ def cmd_fix_issue(args):
         sys.exit(1)
 
     # Run backend
+    telemetry.track("fix_started", {"provider": provider.key, "backend": backend.name})
     result: RunResult = backend.run(prompt, project_dir)
     conf = evaluate_confidence(
         result.stdout, project_dir,
@@ -283,6 +296,14 @@ def cmd_fix_issue(args):
     )
 
     success = result.ok and (conf.final_score >= 0.20 or conf.files_changed)
+    telemetry.track("fix_completed", {
+        "provider": provider.key,
+        "backend": backend.name,
+        "success": success,
+        "timed_out": result.timed_out,
+        "confidence": conf.label(),
+        "files_changed": len(conf.files_changed),
+    })
     state.record_usage(
         backend_name=backend.name,
         tokens=check.estimated,
@@ -422,25 +443,31 @@ def main():
     args.backend = args.backend or os.environ.get("BUGFIXER_BACKEND", "")
 
     if args.backends_json:
+        telemetry.track("cli_start", {"mode": "backends_json"})
         cmd_backends_json()
         return
     if args.providers_json:
         cmd_providers_json()
         return
     if args.list_bugs_json:
+        telemetry.track("cli_start", {"mode": "list_bugs_json"})
         cmd_list_bugs_json(args)
         return
     if args.fix_issue is not None:
+        telemetry.track("cli_start", {"mode": "fix_issue"})
         cmd_fix_issue(args)
         return
     if args.config_get:
         cmd_config_get()
         return
     if args.config_set:
+        telemetry.track("config_set", {"keys": ",".join(p.split("=")[0] for p in args.config_set)})
         cmd_config_set(args)
         return
 
     # No JSON flag → fall through to interactive CLI
+    telemetry.maybe_show_notice()
+    telemetry.track("cli_start", {"mode": "interactive"})
     from .cli import main as interactive_main
     interactive_main()
 

fixfleet-0.4.2/bugfixer/telemetry.py

@@ -0,0 +1,152 @@
+"""Anonymous usage analytics via GA4 Measurement Protocol (Firebase Analytics).
+
+Privacy rules (do not weaken):
+  - Sends ONLY event names + coarse metadata (provider key, backend name,
+    success bool, error codes, version). NEVER tokens, URLs, project names,
+    issue titles, file paths, or code.
+  - Anonymous random client id stored locally in ~/.bugfixer-analytics.json.
+  - Opt-out: `fixfleet --config-set telemetry.enabled=false`, or env
+    FIXFLEET_TELEMETRY=0 / DO_NOT_TRACK=1.
+  - Fire-and-forget on a daemon thread with a short timeout; a telemetry
+    failure must never break or slow the tool.
+
+Setup: create a Firebase project with Analytics enabled, add a Web app,
+then in GA4 Admin → Data Streams → Measurement Protocol API secrets create
+a secret, and fill the two constants below before release.
+"""
+
+import json
+import os
+import threading
+import urllib.request
+import uuid
+from pathlib import Path
+
+from . import __version__
+
+# Fill these from your Firebase/GA4 project (see module docstring).
+# Not filled = telemetry silently disabled.
+MEASUREMENT_ID = "G-RB1CHG2YLD"
+API_SECRET = "DORXWPkpQ2uDnsz0PzzF8A"
+
+ENDPOINT = "https://www.google-analytics.com/mp/collect"
+DEBUG_ENDPOINT = "https://www.google-analytics.com/debug/mp/collect"
+
+_ID_PATH = Path.home() / ".bugfixer-analytics.json"
+
+_NOTICE = (
+    "FixFleet collects anonymous usage events (event names + coarse metadata "
+    "only — never your code, tokens, URLs, or issue content) to find bugs and "
+    "improve the tool. Disable anytime:\n"
+    "  fixfleet --config-set telemetry.enabled=false\n"
+    "This notice is shown once."
+)
+
+
+def _load_id_state() -> dict:
+    try:
+        return json.loads(_ID_PATH.read_text())
+    except (OSError, json.JSONDecodeError):
+        return {}
+
+
+def _save_id_state(state: dict):
+    try:
+        _ID_PATH.write_text(json.dumps(state))
+    except OSError:
+        pass
+
+
+def client_id() -> str:
+    state = _load_id_state()
+    cid = state.get("client_id")
+    if not cid:
+        cid = str(uuid.uuid4())
+        state["client_id"] = cid
+        _save_id_state(state)
+    return cid
+
+
+def enabled() -> bool:
+    if not MEASUREMENT_ID or not API_SECRET:
+        return False
+    if os.environ.get("DO_NOT_TRACK", "") not in ("", "0"):
+        return False
+    if os.environ.get("FIXFLEET_TELEMETRY", "") in ("0", "false", "off"):
+        return False
+    try:
+        from . import config
+        t = config.load().get("telemetry")
+        if isinstance(t, dict) and t.get("enabled") is False:
+            return False
+    except Exception:
+        pass
+    return True
+
+
+def maybe_show_notice():
+    """Print the one-time telemetry disclosure to stderr (interactive CLI only)."""
+    if not enabled():
+        return
+    state = _load_id_state()
+    if state.get("notified"):
+        return
+    state["notified"] = True
+    _save_id_state(state)
+    import sys
+    print(f"\n{_NOTICE}\n", file=sys.stderr)
+
+
+def _sanitize(params: dict) -> dict:
+    """Keep only short scalar values — defense against accidental PII."""
+    out = {}
+    for k, v in (params or {}).items():
+        if isinstance(v, bool):
+            out[k] = "true" if v else "false"
+        elif isinstance(v, (int, float)):
+            out[k] = v
+        elif isinstance(v, str):
+            out[k] = v[:80]
+    return out
+
+
+def track(event_name: str, params: dict = None):
+    """Send one GA4 event. Non-blocking, never raises."""
+    if not enabled():
+        return
+
+    body = {
+        "client_id": client_id(),
+        "events": [{
+            "name": event_name,
+            "params": {
+                "app_version": __version__,
+                "platform": os.name,
+                "engagement_time_msec": 1,
+                **_sanitize(params),
+            },
+        }],
+    }
+    debug = os.environ.get("FIXFLEET_TELEMETRY_DEBUG", "") == "1"
+    if debug:
+        body["events"][0]["params"]["debug_mode"] = 1
+    endpoint = DEBUG_ENDPOINT if debug else ENDPOINT
+    url = f"{endpoint}?measurement_id={MEASUREMENT_ID}&api_secret={API_SECRET}"
+
+    def _send():
+        try:
+            req = urllib.request.Request(
+                url,
+                data=json.dumps(body).encode(),
+                headers={"Content-Type": "application/json"},
+                method="POST",
+            )
+            with urllib.request.urlopen(req, timeout=3) as resp:
+                if debug:
+                    import sys
+                    print(f"[telemetry] {event_name}: {resp.read().decode()[:300]}",
+                          file=sys.stderr)
+        except Exception:
+            pass  # telemetry must never break the tool
+
+    threading.Thread(target=_send, daemon=True).start()

{fixfleet-0.4.1 → fixfleet-0.4.2/fixfleet.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fixfleet
-Version: 0.4.1
+Version: 0.4.2
 Summary: Auto-fix bugs from GitHub, GitLab, Jira, Linear, Bitbucket, or Azure DevOps with AI agents — bring your own CLI or free API.
 Author: Yash Koladiya
 License-Expression: GPL-3.0-or-later
@@ -405,6 +405,17 @@ No. FixFleet runs **100% locally** on your machine. No FixFleet servers, no Azur
 
 </details>
 
+<details>
+<summary><b>Does FixFleet collect any data?</b></summary>
+
+Only anonymous usage analytics (via Google Analytics): event names and coarse metadata like provider key, backend name, and success/failure — **never your code, tokens, project URLs, or issue content**. Used purely to find bugs and see which trackers/backends need attention.
+
+Opt out anytime:
+- CLI: `fixfleet --config-set telemetry.enabled=false` (or set `DO_NOT_TRACK=1`)
+- VSCode: uncheck `fixfleet.telemetry` in settings (the global VS Code telemetry setting is respected too)
+
+</details>
+
 <details>
 <summary><b>What's the difference between the VSCode extension and the CLI?</b></summary>
 

{fixfleet-0.4.1 → fixfleet-0.4.2}/fixfleet.egg-info/SOURCES.txt

@@ -12,6 +12,7 @@ bugfixer/locator.py
 bugfixer/parser.py
 bugfixer/prompt.py
 bugfixer/state.py
+bugfixer/telemetry.py
 bugfixer/ui.py
 bugfixer/backends/__init__.py
 bugfixer/backends/_subprocess.py

{fixfleet-0.4.1 → fixfleet-0.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "fixfleet"
-version = "0.4.1"
+version = "0.4.2"
 description = "Auto-fix bugs from GitHub, GitLab, Jira, Linear, Bitbucket, or Azure DevOps with AI agents — bring your own CLI or free API."
 readme = "README.md"
 requires-python = ">=3.9"

{fixfleet-0.4.1 → fixfleet-0.4.2}/tests/test_all.py

@@ -11,6 +11,9 @@ from pathlib import Path
 # Make sure the package is importable
 sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
 
+# Telemetry must never fire during tests.
+os.environ["FIXFLEET_TELEMETRY"] = "0"
+
 from bugfixer import budget, confidence
 from bugfixer.backends import registry
 from bugfixer.cli import _sanitize_path

{fixfleet-0.4.1 → fixfleet-0.4.2}/tests/test_providers_qa.py

@@ -9,12 +9,17 @@ provider-side anyway.
 
 import io
 import json
+import os
 import sys
 import unittest
 import urllib.error
 from pathlib import Path
 from unittest.mock import patch, MagicMock
 
+# Telemetry must never fire during tests — its background thread would consume
+# the mocked urlopen side_effect responses and poison unrelated assertions.
+os.environ["FIXFLEET_TELEMETRY"] = "0"
+
 sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
 
 from bugfixer.providers import (