CM-61376: Track CLI/IDE activation events

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: mateusz-sterczewski

cycode/cli/app.py

@@ -166,6 +166,8 @@ def app_callback(
     if user_agent:
         user_agent_option = UserAgentOptionScheme().loads(user_agent)
         CycodeClientBase.enrich_user_agent(user_agent_option.user_agent_suffix)
+        ctx.obj['plugin_app_name'] = user_agent_option.app_name
+        ctx.obj['plugin_app_version'] = user_agent_option.app_version
 
     if not no_update_notifier:
         ctx.call_on_close(lambda: check_latest_version_on_close(ctx))

cycode/cli/apps/activation_manager.py

@@ -0,0 +1,35 @@
+from typing import TYPE_CHECKING, Optional
+
+from cycode import __version__
+from cycode.cli.config import configuration_manager
+from cycode.cyclient.cli_activation_client import CliActivationClient
+from cycode.logger import get_logger
+
+if TYPE_CHECKING:
+    from cycode.cyclient.cycode_client_base import CycodeClientBase
+
+logger = get_logger('Activation Manager')
+
+_CLI_CLIENT_NAME = 'cli'
+
+
+def try_report_activation(
+    cycode_client: 'CycodeClientBase',
+    plugin_app_name: Optional[str] = None,
+    plugin_app_version: Optional[str] = None,
+) -> None:
+    """Report CLI/IDE activation to the backend if the (client, version) pair is new.
+
+    Failures are swallowed — activation tracking is non-critical.
+    """
+    try:
+        client = plugin_app_name or _CLI_CLIENT_NAME
+        version = plugin_app_version or __version__
+
+        if configuration_manager.get_last_reported_activation_version(client) == version:
+            return
+
+        CliActivationClient(cycode_client).report_activation()
+        configuration_manager.update_last_reported_activation_version(client, version)
+    except Exception:
+        logger.debug('Failed to report CLI activation', exc_info=True)

cycode/cli/apps/scan/scan_command.py

@@ -5,6 +5,7 @@
 import click
 import typer
 
+from cycode.cli.apps.activation_manager import try_report_activation
 from cycode.cli.apps.sca_options import (
     GradleAllSubProjectsOption,
     MavenSettingsFileOption,
@@ -140,6 +141,10 @@ def scan_command(
     scan_client = get_scan_cycode_client(ctx)
     ctx.obj['client'] = scan_client
 
+    plugin_app_name = ctx.obj.get('plugin_app_name')
+    plugin_app_version = ctx.obj.get('plugin_app_version')
+    try_report_activation(scan_client.scan_cycode_client, plugin_app_name, plugin_app_version)
+
     # Get remote URL from current working directory
     remote_url = _try_get_git_remote_url(os.getcwd())
 

cycode/cli/user_settings/config_file_manager.py

@@ -18,6 +18,7 @@ class ConfigFileManager(BaseFileManager):
     SCAN_SECTION_NAME: str = 'scan'
 
     INSTALLATION_ID_FIELD_NAME: str = 'installation_id'
+    LAST_REPORTED_ACTIVATION_VERSIONS_FIELD_NAME: str = 'last_reported_activation_versions'
     API_URL_FIELD_NAME: str = 'cycode_api_url'
     APP_URL_FIELD_NAME: str = 'cycode_app_url'
     VERBOSE_FIELD_NAME: str = 'verbose'
@@ -68,6 +69,16 @@ def update_installation_id(self, installation_id: str) -> None:
         update_data = {self.ENVIRONMENT_SECTION_NAME: {self.INSTALLATION_ID_FIELD_NAME: installation_id}}
         self.write_content_to_file(update_data)
 
+    def get_last_reported_activation_versions(self) -> dict[str, str]:
+        value = self._get_value_from_environment_section(self.LAST_REPORTED_ACTIVATION_VERSIONS_FIELD_NAME)
+        return value if isinstance(value, dict) else {}
+
+    def update_last_reported_activation_version(self, client: str, version: str) -> None:
+        versions = self.get_last_reported_activation_versions()
+        versions[client] = version
+        update_data = {self.ENVIRONMENT_SECTION_NAME: {self.LAST_REPORTED_ACTIVATION_VERSIONS_FIELD_NAME: versions}}
+        self.write_content_to_file(update_data)
+
     def add_exclusion(self, scan_type: str, exclusion_type: str, new_exclusion: str) -> None:
         exclusions = self._get_exclusions_by_exclusion_type(scan_type, exclusion_type)
         if new_exclusion in exclusions:

cycode/cli/user_settings/configuration_manager.py

@@ -94,6 +94,12 @@ def get_or_create_installation_id(self) -> str:
 
         return installation_id
 
+    def get_last_reported_activation_version(self, client: str) -> Optional[str]:
+        return self.global_config_file_manager.get_last_reported_activation_versions().get(client)
+
+    def update_last_reported_activation_version(self, client: str, version: str) -> None:
+        self.global_config_file_manager.update_last_reported_activation_version(client, version)
+
     def get_config_file_manager(self, scope: Optional[str] = None) -> ConfigFileManager:
         if scope == 'local':
             return self.local_config_file_manager

cycode/cyclient/cli_activation_client.py

@@ -0,0 +1,14 @@
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from cycode.cyclient.cycode_client_base import CycodeClientBase
+
+_CLI_ACTIVATION_PATH = 'scans/api/v4/cli-activation'
+
+
+class CliActivationClient:
+    def __init__(self, cycode_client: 'CycodeClientBase') -> None:
+        self._cycode_client = cycode_client
+
+    def report_activation(self) -> None:
+        self._cycode_client.put(url_path=_CLI_ACTIVATION_PATH)

tests/user_settings/test_activation_tracking.py

@@ -0,0 +1,57 @@
+from pathlib import Path
+
+import pytest
+
+from cycode.cli.user_settings.config_file_manager import ConfigFileManager
+
+
+@pytest.fixture()
+def config_manager(tmp_path: Path) -> ConfigFileManager:
+    return ConfigFileManager(tmp_path)
+
+
+def test_get_last_reported_activation_versions_returns_empty_when_not_set(
+    config_manager: ConfigFileManager,
+) -> None:
+    assert config_manager.get_last_reported_activation_versions() == {}
+
+
+def test_update_and_get_last_reported_activation_version_cli(config_manager: ConfigFileManager) -> None:
+    config_manager.update_last_reported_activation_version('cli', '1.10.7')
+
+    assert config_manager.get_last_reported_activation_versions() == {'cli': '1.10.7'}
+
+
+def test_update_and_get_last_reported_activation_version_plugin(config_manager: ConfigFileManager) -> None:
+    config_manager.update_last_reported_activation_version('vscode_extension', '2.0.0')
+
+    assert config_manager.get_last_reported_activation_versions() == {'vscode_extension': '2.0.0'}
+
+
+def test_update_last_reported_activation_version_multiple_clients(config_manager: ConfigFileManager) -> None:
+    config_manager.update_last_reported_activation_version('cli', '1.10.7')
+    config_manager.update_last_reported_activation_version('vscode_extension', '2.0.0')
+    config_manager.update_last_reported_activation_version('jetbrains_extension', '1.5.0')
+
+    assert config_manager.get_last_reported_activation_versions() == {
+        'cli': '1.10.7',
+        'vscode_extension': '2.0.0',
+        'jetbrains_extension': '1.5.0',
+    }
+
+
+def test_update_last_reported_activation_version_overwrites_existing(config_manager: ConfigFileManager) -> None:
+    config_manager.update_last_reported_activation_version('cli', '1.10.7')
+    config_manager.update_last_reported_activation_version('cli', '1.10.8')
+
+    assert config_manager.get_last_reported_activation_versions() == {'cli': '1.10.8'}
+
+
+def test_update_last_reported_activation_version_does_not_affect_other_clients(
+    config_manager: ConfigFileManager,
+) -> None:
+    config_manager.update_last_reported_activation_version('cli', '1.10.7')
+    config_manager.update_last_reported_activation_version('vscode_extension', '2.0.0')
+    config_manager.update_last_reported_activation_version('cli', '1.10.8')
+
+    assert config_manager.get_last_reported_activation_versions()['vscode_extension'] == '2.0.0'