From 9d45159aca066647eaada692b3b764a9d17610ae Mon Sep 17 00:00:00 2001 From: atishj99 Date: Tue, 17 Nov 2026 14:42:50 +0530 Subject: [PATCH 1/4] Add telemetry analytics attributes --- .../ast/telemetry/TelemetryEvent.java | 53 ++++++++++ .../checkmarx/ast/wrapper/CxConstants.java | 11 +++ .../com/checkmarx/ast/wrapper/CxWrapper.java | 55 +++++++++++ .../CxWrapperTelemetryArgumentsTest.java | 96 +++++++++++++++++++ 4 files changed, 215 insertions(+) create mode 100644 src/main/java/com/checkmarx/ast/telemetry/TelemetryEvent.java create mode 100644 src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java diff --git a/src/main/java/com/checkmarx/ast/telemetry/TelemetryEvent.java b/src/main/java/com/checkmarx/ast/telemetry/TelemetryEvent.java new file mode 100644 index 00000000..649eea4b --- /dev/null +++ b/src/main/java/com/checkmarx/ast/telemetry/TelemetryEvent.java @@ -0,0 +1,53 @@ +package com.checkmarx.ast.telemetry; + +import lombok.Builder; +import lombok.Getter; + +/** + * Attributes of a Dev Assist telemetry event sent through {@code cx telemetry ai}. + *

+ * Only non-blank values are forwarded to the CLI. The CLI itself adds the session, unique and machine identifiers. + * The agent name is taken from the wrapper configuration ({@code CxConfig#getAgentName()}). + */ +@Getter +@Builder +public class TelemetryEvent { + /** AI provider name (e.g. "Copilot"). */ + private final String aiProvider; + /** Event type (e.g. "click", "authentication", "installation", "scan", "remediation"). */ + private final String eventType; + /** Event sub type (e.g. "fixWithAIChat"). */ + private final String subType; + /** Scan engine (e.g. "Oss", "Secrets", "IaC", "Asca", "Containers"). */ + private final String engine; + /** Severity of the problem the event relates to. */ + private final String problemSeverity; + /** Scan type for scan events. */ + private final String scanType; + /** Event status (e.g. "success"). */ + private final String status; + /** Detailed status / failure reason. */ + private final String statusResult; + /** Number of findings, sent only when not null. */ + private final Integer totalCount; + /** Version of the host IDE / agent. */ + private final String agentVersion; + /** Version of the Checkmarx plugin. */ + private final String cxPluginVersion; + /** Plugin type (e.g. "checkmarx", "devassist"). */ + private final String pluginType; + /** Repository URL of the scanned project. */ + private final String repoUrl; + /** Plugin installation identifier. */ + private final String installationId; + /** Authentication method (e.g. "apiKey", "oauth"). */ + private final String authMethod; + /** Identifier of the vulnerability being remediated. */ + private final String vulnerabilityId; + /** Remediation mode. */ + private final String remediationMode; + /** Identifier of the AI agent session. */ + private final String aiAgentSessionId; + /** API version of the event schema. */ + private final String apiVersion; +} diff --git a/src/main/java/com/checkmarx/ast/wrapper/CxConstants.java b/src/main/java/com/checkmarx/ast/wrapper/CxConstants.java index 60675448..a13d1635 100644 --- a/src/main/java/com/checkmarx/ast/wrapper/CxConstants.java +++ b/src/main/java/com/checkmarx/ast/wrapper/CxConstants.java @@ -94,6 +94,17 @@ public final class CxConstants { static final String SCAN_TYPE_FLAG = "--scan-type"; static final String STATUS = "--status"; static final String TOTAL_COUNT = "--total-count"; + static final String STATUS_RESULT = "--status-result"; + static final String AGENT_VERSION = "--agent-version"; + static final String CX_PLUGIN_VERSION = "--cx-plugin-version"; + static final String PLUGIN_TYPE = "--plugin-type"; + static final String REPO_URL = "--repo-url"; + static final String INSTALLATION_ID = "--installation-id"; + static final String AUTH_METHOD = "--auth-method"; + static final String VULNERABILITY_ID = "--vulnerability-id"; + static final String REMEDIATION_MODE = "--remediation-mode"; + static final String AI_AGENT_SESSION_ID = "--ai-agent-session-id"; + static final String API_VERSION = "--api-version"; static final String DOCKER = "docker"; static final String PODMAN = "podman"; static final String PODMAN_FALLBACK_PATH = "/usr/local/bin/podman"; diff --git a/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java b/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java index 6e73560d..18934384 100644 --- a/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java +++ b/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java @@ -19,6 +19,7 @@ import com.checkmarx.ast.results.ResultsSummary; import com.checkmarx.ast.results.result.Node; import com.checkmarx.ast.scan.Scan; +import com.checkmarx.ast.telemetry.TelemetryEvent; import com.checkmarx.ast.tenant.TenantSetting; import com.checkmarx.ast.utils.JsonParser; import com.fasterxml.jackson.databind.ObjectMapper; @@ -816,6 +817,60 @@ public String telemetryAIEvent(String aiProvider, String agent, String eventType return Execution.executeCommand(withConfigArguments(arguments), logger, line -> line); } + /** + * Executes the telemetry AI command with the extended Dev Assist analytics attributes. + * Blank attributes are not sent to the CLI. The agent name is taken from {@link CxConfig#getAgentName()}. + * + * @param event the telemetry event attributes + * @return Command output as string + * @throws IOException if I/O error occurs + * @throws InterruptedException if command execution is interrupted + * @throws CxException if CLI command fails + */ + public String telemetryAIEvent(@NonNull TelemetryEvent event) + throws IOException, InterruptedException, CxException { + this.logger.info("Executing telemetry AI event with provider: {}, type: {}, subType: {}", + event.getAiProvider(), event.getEventType(), event.getSubType()); + + return Execution.executeCommand(withConfigArguments(buildTelemetryArguments(event)), logger, line -> line); + } + + static List buildTelemetryArguments(TelemetryEvent event) { + List arguments = new ArrayList<>(); + arguments.add(CxConstants.CMD_TELEMETRY); + arguments.add(CxConstants.SUB_CMD_TELEMETRY_AI); + addIfNotBlank(arguments, CxConstants.AI_PROVIDER, event.getAiProvider()); + addIfNotBlank(arguments, CxConstants.TYPE, event.getEventType()); + addIfNotBlank(arguments, CxConstants.SUB_TYPE, event.getSubType()); + addIfNotBlank(arguments, CxConstants.ENGINE, event.getEngine()); + addIfNotBlank(arguments, CxConstants.PROBLEM_SEVERITY, event.getProblemSeverity()); + addIfNotBlank(arguments, CxConstants.SCAN_TYPE_FLAG, event.getScanType()); + addIfNotBlank(arguments, CxConstants.STATUS, event.getStatus()); + addIfNotBlank(arguments, CxConstants.STATUS_RESULT, event.getStatusResult()); + if (event.getTotalCount() != null) { + arguments.add(CxConstants.TOTAL_COUNT); + arguments.add(event.getTotalCount().toString()); + } + addIfNotBlank(arguments, CxConstants.AGENT_VERSION, event.getAgentVersion()); + addIfNotBlank(arguments, CxConstants.CX_PLUGIN_VERSION, event.getCxPluginVersion()); + addIfNotBlank(arguments, CxConstants.PLUGIN_TYPE, event.getPluginType()); + addIfNotBlank(arguments, CxConstants.REPO_URL, event.getRepoUrl()); + addIfNotBlank(arguments, CxConstants.INSTALLATION_ID, event.getInstallationId()); + addIfNotBlank(arguments, CxConstants.AUTH_METHOD, event.getAuthMethod()); + addIfNotBlank(arguments, CxConstants.VULNERABILITY_ID, event.getVulnerabilityId()); + addIfNotBlank(arguments, CxConstants.REMEDIATION_MODE, event.getRemediationMode()); + addIfNotBlank(arguments, CxConstants.AI_AGENT_SESSION_ID, event.getAiAgentSessionId()); + addIfNotBlank(arguments, CxConstants.API_VERSION, event.getApiVersion()); + return arguments; + } + + private static void addIfNotBlank(List arguments, String flag, String value) { + if (StringUtils.isNotBlank(value)) { + arguments.add(flag); + arguments.add(value); + } + } + private int getIndexOfBfLNode(List bflNodes, List resultNodes) { int bflNodeNotFound = -1; diff --git a/src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java b/src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java new file mode 100644 index 00000000..21b33185 --- /dev/null +++ b/src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java @@ -0,0 +1,96 @@ +package com.checkmarx.ast.wrapper; + +import com.checkmarx.ast.telemetry.TelemetryEvent; +import org.junit.jupiter.api.Test; + +import java.util.Arrays; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.*; + +class CxWrapperTelemetryArgumentsTest { + + @Test + void testBuildTelemetryArguments_allAttributes() { + TelemetryEvent event = TelemetryEvent.builder() + .aiProvider("Copilot") + .eventType("remediation") + .subType("fixWithAIChat") + .engine("Oss") + .problemSeverity("High") + .scanType("Oss") + .status("success") + .statusResult("ok") + .totalCount(3) + .agentVersion("2024.1") + .cxPluginVersion("2.0.1") + .pluginType("devassist") + .repoUrl("https://github.com/org/repo") + .installationId("inst-1") + .authMethod("apiKey") + .vulnerabilityId("CVE-2024-0001") + .remediationMode("manual") + .aiAgentSessionId("sess-1") + .apiVersion("v1") + .build(); + + List args = CxWrapper.buildTelemetryArguments(event); + + assertEquals(Arrays.asList( + "telemetry", "ai", + "--ai-provider", "Copilot", + "--type", "remediation", + "--sub-type", "fixWithAIChat", + "--engine", "Oss", + "--problem-severity", "High", + "--scan-type", "Oss", + "--status", "success", + "--status-result", "ok", + "--total-count", "3", + "--agent-version", "2024.1", + "--cx-plugin-version", "2.0.1", + "--plugin-type", "devassist", + "--repo-url", "https://github.com/org/repo", + "--installation-id", "inst-1", + "--auth-method", "apiKey", + "--vulnerability-id", "CVE-2024-0001", + "--remediation-mode", "manual", + "--ai-agent-session-id", "sess-1", + "--api-version", "v1"), args); + } + + @Test + void testBuildTelemetryArguments_omitsBlankAndNullAttributes() { + TelemetryEvent event = TelemetryEvent.builder() + .eventType("authentication") + .status("success") + .engine("") + .authMethod(" ") + .installationId("inst-1") + .build(); + + List args = CxWrapper.buildTelemetryArguments(event); + + assertEquals(Arrays.asList( + "telemetry", "ai", + "--type", "authentication", + "--status", "success", + "--installation-id", "inst-1"), args); + } + + @Test + void testBuildTelemetryArguments_zeroTotalCountIsSent() { + TelemetryEvent event = TelemetryEvent.builder().totalCount(0).build(); + + List args = CxWrapper.buildTelemetryArguments(event); + + assertEquals(Arrays.asList("telemetry", "ai", "--total-count", "0"), args); + } + + @Test + void testBuildTelemetryArguments_emptyEvent() { + List args = CxWrapper.buildTelemetryArguments(TelemetryEvent.builder().build()); + + assertEquals(Arrays.asList("telemetry", "ai"), args); + } +} From 1d612c483570aef715c0cd50e5afe9b71f830131 Mon Sep 17 00:00:00 2001 From: Aniket Shinde Date: Wed, 18 Nov 2026 16:25:22 +0530 Subject: [PATCH 2/4] event attributes --- .../ast/telemetry/TelemetryEvent.java | 35 ++++---- .../com/checkmarx/ast/wrapper/CxConfig.java | 10 ++- .../checkmarx/ast/wrapper/CxConstants.java | 7 +- .../com/checkmarx/ast/wrapper/CxWrapper.java | 40 +++++++-- .../CxWrapperTelemetryArgumentsTest.java | 87 +++++++++++++++---- 5 files changed, 130 insertions(+), 49 deletions(-) diff --git a/src/main/java/com/checkmarx/ast/telemetry/TelemetryEvent.java b/src/main/java/com/checkmarx/ast/telemetry/TelemetryEvent.java index 649eea4b..73ab0fde 100644 --- a/src/main/java/com/checkmarx/ast/telemetry/TelemetryEvent.java +++ b/src/main/java/com/checkmarx/ast/telemetry/TelemetryEvent.java @@ -2,19 +2,24 @@ import lombok.Builder; import lombok.Getter; +import lombok.Singular; + +import java.util.Map; /** * Attributes of a Dev Assist telemetry event sent through {@code cx telemetry ai}. *

* Only non-blank values are forwarded to the CLI. The CLI itself adds the session, unique and machine identifiers. - * The agent name is taken from the wrapper configuration ({@code CxConfig#getAgentName()}). + * Event specific values (for example {@code installationId}, {@code authMethod}, {@code vulnerabilityId}, + * {@code remediationMode}, {@code apiVersion}) go in {@link #eventAttributes} and are sent as a single + * {@code --event-attributes "key=value;key=value"} argument, which the CLI nests under {@code eventAttributes}. */ @Getter @Builder public class TelemetryEvent { /** AI provider name (e.g. "Copilot"). */ private final String aiProvider; - /** Event type (e.g. "click", "authentication", "installation", "scan", "remediation"). */ + /** Event type (e.g. "click", "authentication", "Scan"). */ private final String eventType; /** Event sub type (e.g. "fixWithAIChat"). */ private final String subType; @@ -30,24 +35,24 @@ public class TelemetryEvent { private final String statusResult; /** Number of findings, sent only when not null. */ private final Integer totalCount; + /** + * IDE or agent name (e.g. "Eclipse"). When set, it is sent as {@code --agent} and replaces + * {@code CxConfig#getAgentName()} for this call. When blank, the configured agent name is used. + */ + private final String agent; /** Version of the host IDE / agent. */ private final String agentVersion; /** Version of the Checkmarx plugin. */ private final String cxPluginVersion; - /** Plugin type (e.g. "checkmarx", "devassist"). */ + /** Plugin type (e.g. "IDE"). */ private final String pluginType; /** Repository URL of the scanned project. */ private final String repoUrl; - /** Plugin installation identifier. */ - private final String installationId; - /** Authentication method (e.g. "apiKey", "oauth"). */ - private final String authMethod; - /** Identifier of the vulnerability being remediated. */ - private final String vulnerabilityId; - /** Remediation mode. */ - private final String remediationMode; - /** Identifier of the AI agent session. */ - private final String aiAgentSessionId; - /** API version of the event schema. */ - private final String apiVersion; + /** + * Event specific attributes, sent as {@code --event-attributes key=value;key=value}. + * Entries with a blank value or an invalid key (blank, or containing ';' or '=') are left out, + * and ';' inside a value is replaced with '_'. + */ + @Singular + private final Map eventAttributes; } diff --git a/src/main/java/com/checkmarx/ast/wrapper/CxConfig.java b/src/main/java/com/checkmarx/ast/wrapper/CxConfig.java index ab0a7329..1c7c5576 100644 --- a/src/main/java/com/checkmarx/ast/wrapper/CxConfig.java +++ b/src/main/java/com/checkmarx/ast/wrapper/CxConfig.java @@ -32,6 +32,14 @@ public void setAdditionalParameters(String additionalParameters) { } List toArguments() { + return toArguments(true); + } + + /** + * @param includeAgent when false, {@code --agent} is not added, so a caller that sends its own agent + * (e.g. a telemetry event) does not send the flag twice. + */ + List toArguments(boolean includeAgent) { List commands = new ArrayList<>(); if (StringUtils.isNotBlank(getClientId()) && StringUtils.isNotBlank(getApiKey())) { @@ -66,7 +74,7 @@ List toArguments() { commands.add(CxConstants.BASE_AUTH_URI); commands.add(getBaseAuthUri()); } - if (getAgentName() != null && !getAgentName().isEmpty()) { + if (includeAgent && getAgentName() != null && !getAgentName().isEmpty()) { commands.add("--agent"); commands.add(getAgentName()); } diff --git a/src/main/java/com/checkmarx/ast/wrapper/CxConstants.java b/src/main/java/com/checkmarx/ast/wrapper/CxConstants.java index a13d1635..25694c99 100644 --- a/src/main/java/com/checkmarx/ast/wrapper/CxConstants.java +++ b/src/main/java/com/checkmarx/ast/wrapper/CxConstants.java @@ -99,12 +99,7 @@ public final class CxConstants { static final String CX_PLUGIN_VERSION = "--cx-plugin-version"; static final String PLUGIN_TYPE = "--plugin-type"; static final String REPO_URL = "--repo-url"; - static final String INSTALLATION_ID = "--installation-id"; - static final String AUTH_METHOD = "--auth-method"; - static final String VULNERABILITY_ID = "--vulnerability-id"; - static final String REMEDIATION_MODE = "--remediation-mode"; - static final String AI_AGENT_SESSION_ID = "--ai-agent-session-id"; - static final String API_VERSION = "--api-version"; + static final String EVENT_ATTRIBUTES = "--event-attributes"; static final String DOCKER = "docker"; static final String PODMAN = "podman"; static final String PODMAN_FALLBACK_PATH = "/usr/local/bin/podman"; diff --git a/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java b/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java index 18934384..d2dbe86e 100644 --- a/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java +++ b/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java @@ -819,7 +819,9 @@ public String telemetryAIEvent(String aiProvider, String agent, String eventType /** * Executes the telemetry AI command with the extended Dev Assist analytics attributes. - * Blank attributes are not sent to the CLI. The agent name is taken from {@link CxConfig#getAgentName()}. + * Blank attributes are not sent to the CLI. Event specific attributes are sent as one + * {@code --event-attributes key=value;key=value} argument. When {@link TelemetryEvent#getAgent()} is set it + * replaces {@link CxConfig#getAgentName()} for this call, so {@code --agent} is never sent twice. * * @param event the telemetry event attributes * @return Command output as string @@ -832,7 +834,12 @@ public String telemetryAIEvent(@NonNull TelemetryEvent event) this.logger.info("Executing telemetry AI event with provider: {}, type: {}, subType: {}", event.getAiProvider(), event.getEventType(), event.getSubType()); - return Execution.executeCommand(withConfigArguments(buildTelemetryArguments(event)), logger, line -> line); + boolean includeConfigAgent = StringUtils.isBlank(event.getAgent()); + List arguments = new ArrayList<>(); + arguments.add(this.executable); + arguments.addAll(buildTelemetryArguments(event)); + arguments.addAll(this.cxConfig.toArguments(includeConfigAgent)); + return Execution.executeCommand(arguments, logger, line -> line); } static List buildTelemetryArguments(TelemetryEvent event) { @@ -851,19 +858,36 @@ static List buildTelemetryArguments(TelemetryEvent event) { arguments.add(CxConstants.TOTAL_COUNT); arguments.add(event.getTotalCount().toString()); } + addIfNotBlank(arguments, CxConstants.AGENT, event.getAgent()); addIfNotBlank(arguments, CxConstants.AGENT_VERSION, event.getAgentVersion()); addIfNotBlank(arguments, CxConstants.CX_PLUGIN_VERSION, event.getCxPluginVersion()); addIfNotBlank(arguments, CxConstants.PLUGIN_TYPE, event.getPluginType()); addIfNotBlank(arguments, CxConstants.REPO_URL, event.getRepoUrl()); - addIfNotBlank(arguments, CxConstants.INSTALLATION_ID, event.getInstallationId()); - addIfNotBlank(arguments, CxConstants.AUTH_METHOD, event.getAuthMethod()); - addIfNotBlank(arguments, CxConstants.VULNERABILITY_ID, event.getVulnerabilityId()); - addIfNotBlank(arguments, CxConstants.REMEDIATION_MODE, event.getRemediationMode()); - addIfNotBlank(arguments, CxConstants.AI_AGENT_SESSION_ID, event.getAiAgentSessionId()); - addIfNotBlank(arguments, CxConstants.API_VERSION, event.getApiVersion()); + addIfNotBlank(arguments, CxConstants.EVENT_ATTRIBUTES, serializeEventAttributes(event.getEventAttributes())); return arguments; } + /** + * Serializes attributes as {@code key=value;key=value}. Entries with a blank value or an invalid key + * (blank, or containing ';' or '=') are left out. ';' inside a value is replaced with '_' so it cannot break + * the format; '=' is allowed in a value because the CLI splits each pair on the first '=' only. + */ + static String serializeEventAttributes(Map attributes) { + if (attributes == null || attributes.isEmpty()) { + return ""; + } + List pairs = new ArrayList<>(); + for (Map.Entry entry : attributes.entrySet()) { + String key = entry.getKey(); + String value = entry.getValue(); + if (StringUtils.isBlank(key) || key.contains(";") || key.contains("=") || StringUtils.isBlank(value)) { + continue; + } + pairs.add(key + "=" + value.replace(';', '_')); + } + return String.join(";", pairs); + } + private static void addIfNotBlank(List arguments, String flag, String value) { if (StringUtils.isNotBlank(value)) { arguments.add(flag); diff --git a/src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java b/src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java index 21b33185..95c022bf 100644 --- a/src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java +++ b/src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java @@ -4,7 +4,9 @@ import org.junit.jupiter.api.Test; import java.util.Arrays; +import java.util.LinkedHashMap; import java.util.List; +import java.util.Map; import static org.junit.jupiter.api.Assertions.*; @@ -14,7 +16,7 @@ class CxWrapperTelemetryArgumentsTest { void testBuildTelemetryArguments_allAttributes() { TelemetryEvent event = TelemetryEvent.builder() .aiProvider("Copilot") - .eventType("remediation") + .eventType("Click") .subType("fixWithAIChat") .engine("Oss") .problemSeverity("High") @@ -22,16 +24,13 @@ void testBuildTelemetryArguments_allAttributes() { .status("success") .statusResult("ok") .totalCount(3) + .agent("Eclipse") .agentVersion("2024.1") .cxPluginVersion("2.0.1") - .pluginType("devassist") + .pluginType("IDE") .repoUrl("https://github.com/org/repo") - .installationId("inst-1") - .authMethod("apiKey") - .vulnerabilityId("CVE-2024-0001") - .remediationMode("manual") - .aiAgentSessionId("sess-1") - .apiVersion("v1") + .eventAttribute("vulnerabilityId", "CVE-2024-0001") + .eventAttribute("remediationMode", "DevAssist") .build(); List args = CxWrapper.buildTelemetryArguments(event); @@ -39,7 +38,7 @@ void testBuildTelemetryArguments_allAttributes() { assertEquals(Arrays.asList( "telemetry", "ai", "--ai-provider", "Copilot", - "--type", "remediation", + "--type", "Click", "--sub-type", "fixWithAIChat", "--engine", "Oss", "--problem-severity", "High", @@ -47,16 +46,12 @@ void testBuildTelemetryArguments_allAttributes() { "--status", "success", "--status-result", "ok", "--total-count", "3", + "--agent", "Eclipse", "--agent-version", "2024.1", "--cx-plugin-version", "2.0.1", - "--plugin-type", "devassist", + "--plugin-type", "IDE", "--repo-url", "https://github.com/org/repo", - "--installation-id", "inst-1", - "--auth-method", "apiKey", - "--vulnerability-id", "CVE-2024-0001", - "--remediation-mode", "manual", - "--ai-agent-session-id", "sess-1", - "--api-version", "v1"), args); + "--event-attributes", "vulnerabilityId=CVE-2024-0001;remediationMode=DevAssist"), args); } @Test @@ -65,8 +60,9 @@ void testBuildTelemetryArguments_omitsBlankAndNullAttributes() { .eventType("authentication") .status("success") .engine("") - .authMethod(" ") - .installationId("inst-1") + .agent(" ") + .eventAttribute("authMethod", "API_KEY") + .eventAttribute("blank", " ") .build(); List args = CxWrapper.buildTelemetryArguments(event); @@ -75,7 +71,17 @@ void testBuildTelemetryArguments_omitsBlankAndNullAttributes() { "telemetry", "ai", "--type", "authentication", "--status", "success", - "--installation-id", "inst-1"), args); + "--event-attributes", "authMethod=API_KEY"), args); + } + + @Test + void testBuildTelemetryArguments_noEventAttributesFlagWhenAllAttributesInvalid() { + TelemetryEvent event = TelemetryEvent.builder() + .eventAttribute("a", "") + .eventAttribute("b;c", "1") + .build(); + + assertEquals(Arrays.asList("telemetry", "ai"), CxWrapper.buildTelemetryArguments(event)); } @Test @@ -93,4 +99,47 @@ void testBuildTelemetryArguments_emptyEvent() { assertEquals(Arrays.asList("telemetry", "ai"), args); } + + @Test + void testSerializeEventAttributes_nullAndEmpty() { + assertEquals("", CxWrapper.serializeEventAttributes(null)); + assertEquals("", CxWrapper.serializeEventAttributes(new LinkedHashMap<>())); + } + + @Test + void testSerializeEventAttributes_keepsInsertionOrder() { + Map attributes = new LinkedHashMap<>(); + attributes.put("apiVersion", "v2"); + attributes.put("authMethod", "API_KEY"); + + assertEquals("apiVersion=v2;authMethod=API_KEY", CxWrapper.serializeEventAttributes(attributes)); + } + + @Test + void testSerializeEventAttributes_sanitizesValuesAndDropsInvalidEntries() { + Map attributes = new LinkedHashMap<>(); + attributes.put("vulnerabilityId", "x;y=z"); + attributes.put("empty", ""); + attributes.put("nullValue", null); + attributes.put("d=x", "2"); + attributes.put("e;y", "3"); + attributes.put(" ", "4"); + + assertEquals("vulnerabilityId=x_y=z", CxWrapper.serializeEventAttributes(attributes)); + } + + @Test + void testConfigArguments_agentIncludedByDefault() { + CxConfig config = CxConfig.builder().apiKey("key").agentName("Eclipse_1.0.0").build(); + + assertEquals(Arrays.asList("--apikey", "key", "--agent", "Eclipse_1.0.0"), config.toArguments()); + assertEquals(config.toArguments(), config.toArguments(true)); + } + + @Test + void testConfigArguments_agentOmittedWhenEventSendsItsOwn() { + CxConfig config = CxConfig.builder().apiKey("key").agentName("Eclipse_1.0.0").build(); + + assertEquals(Arrays.asList("--apikey", "key"), config.toArguments(false)); + } } From 8cf9cbbfaf39c4392fff135c290cbc91d50b6412 Mon Sep 17 00:00:00 2001 From: Aniket Shinde Date: Wed, 18 Nov 2026 16:42:56 +0530 Subject: [PATCH 3/4] Update event --- .../checkmarx/ast/telemetry/TelemetryEvent.java | 4 +++- .../com/checkmarx/ast/wrapper/CxConstants.java | 1 + .../com/checkmarx/ast/wrapper/CxWrapper.java | 1 + .../CxWrapperTelemetryArgumentsTest.java | 17 +++++++++++++++++ 4 files changed, 22 insertions(+), 1 deletion(-) diff --git a/src/main/java/com/checkmarx/ast/telemetry/TelemetryEvent.java b/src/main/java/com/checkmarx/ast/telemetry/TelemetryEvent.java index 73ab0fde..7ac401ec 100644 --- a/src/main/java/com/checkmarx/ast/telemetry/TelemetryEvent.java +++ b/src/main/java/com/checkmarx/ast/telemetry/TelemetryEvent.java @@ -11,7 +11,7 @@ *

* Only non-blank values are forwarded to the CLI. The CLI itself adds the session, unique and machine identifiers. * Event specific values (for example {@code installationId}, {@code authMethod}, {@code vulnerabilityId}, - * {@code remediationMode}, {@code apiVersion}) go in {@link #eventAttributes} and are sent as a single + * {@code remediationMode}) go in {@link #eventAttributes} and are sent as a single * {@code --event-attributes "key=value;key=value"} argument, which the CLI nests under {@code eventAttributes}. */ @Getter @@ -48,6 +48,8 @@ public class TelemetryEvent { private final String pluginType; /** Repository URL of the scanned project. */ private final String repoUrl; + /** Telemetry API version (e.g. "v2"). Sent as the top-level {@code --api-version} flag, like the JavaScript wrapper. */ + private final String apiVersion; /** * Event specific attributes, sent as {@code --event-attributes key=value;key=value}. * Entries with a blank value or an invalid key (blank, or containing ';' or '=') are left out, diff --git a/src/main/java/com/checkmarx/ast/wrapper/CxConstants.java b/src/main/java/com/checkmarx/ast/wrapper/CxConstants.java index 25694c99..48f4019b 100644 --- a/src/main/java/com/checkmarx/ast/wrapper/CxConstants.java +++ b/src/main/java/com/checkmarx/ast/wrapper/CxConstants.java @@ -99,6 +99,7 @@ public final class CxConstants { static final String CX_PLUGIN_VERSION = "--cx-plugin-version"; static final String PLUGIN_TYPE = "--plugin-type"; static final String REPO_URL = "--repo-url"; + static final String API_VERSION = "--api-version"; static final String EVENT_ATTRIBUTES = "--event-attributes"; static final String DOCKER = "docker"; static final String PODMAN = "podman"; diff --git a/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java b/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java index d2dbe86e..c40e07cc 100644 --- a/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java +++ b/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java @@ -863,6 +863,7 @@ static List buildTelemetryArguments(TelemetryEvent event) { addIfNotBlank(arguments, CxConstants.CX_PLUGIN_VERSION, event.getCxPluginVersion()); addIfNotBlank(arguments, CxConstants.PLUGIN_TYPE, event.getPluginType()); addIfNotBlank(arguments, CxConstants.REPO_URL, event.getRepoUrl()); + addIfNotBlank(arguments, CxConstants.API_VERSION, event.getApiVersion()); addIfNotBlank(arguments, CxConstants.EVENT_ATTRIBUTES, serializeEventAttributes(event.getEventAttributes())); return arguments; } diff --git a/src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java b/src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java index 95c022bf..78c1742b 100644 --- a/src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java +++ b/src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java @@ -29,6 +29,7 @@ void testBuildTelemetryArguments_allAttributes() { .cxPluginVersion("2.0.1") .pluginType("IDE") .repoUrl("https://github.com/org/repo") + .apiVersion("v2") .eventAttribute("vulnerabilityId", "CVE-2024-0001") .eventAttribute("remediationMode", "DevAssist") .build(); @@ -51,6 +52,7 @@ void testBuildTelemetryArguments_allAttributes() { "--cx-plugin-version", "2.0.1", "--plugin-type", "IDE", "--repo-url", "https://github.com/org/repo", + "--api-version", "v2", "--event-attributes", "vulnerabilityId=CVE-2024-0001;remediationMode=DevAssist"), args); } @@ -84,6 +86,21 @@ void testBuildTelemetryArguments_noEventAttributesFlagWhenAllAttributesInvalid() assertEquals(Arrays.asList("telemetry", "ai"), CxWrapper.buildTelemetryArguments(event)); } + @Test + void testBuildTelemetryArguments_apiVersionIsTopLevelFlagNotAnEventAttribute() { + TelemetryEvent event = TelemetryEvent.builder().eventType("Scan").apiVersion("v2").build(); + + assertEquals(Arrays.asList("telemetry", "ai", "--type", "Scan", "--api-version", "v2"), + CxWrapper.buildTelemetryArguments(event)); + } + + @Test + void testBuildTelemetryArguments_blankApiVersionIsOmitted() { + TelemetryEvent event = TelemetryEvent.builder().apiVersion(" ").build(); + + assertEquals(Arrays.asList("telemetry", "ai"), CxWrapper.buildTelemetryArguments(event)); + } + @Test void testBuildTelemetryArguments_zeroTotalCountIsSent() { TelemetryEvent event = TelemetryEvent.builder().totalCount(0).build(); From dc40f425728cd83586cbba60b5ae812c1e9ffc6e Mon Sep 17 00:00:00 2001 From: Aniket Shinde Date: Thu, 19 Nov 2026 12:04:29 +0530 Subject: [PATCH 4/4] Align telemetry argument order and totalCount handling with JS wrapper Co-Authored-By: Claude Sonnet 5.5 --- src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java | 4 ++-- .../ast/wrapper/CxWrapperTelemetryArgumentsTest.java | 9 ++++++++- 2 files changed, 10 insertions(+), 3 deletions(-) diff --git a/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java b/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java index c40e07cc..261227cb 100644 --- a/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java +++ b/src/main/java/com/checkmarx/ast/wrapper/CxWrapper.java @@ -853,8 +853,7 @@ static List buildTelemetryArguments(TelemetryEvent event) { addIfNotBlank(arguments, CxConstants.PROBLEM_SEVERITY, event.getProblemSeverity()); addIfNotBlank(arguments, CxConstants.SCAN_TYPE_FLAG, event.getScanType()); addIfNotBlank(arguments, CxConstants.STATUS, event.getStatus()); - addIfNotBlank(arguments, CxConstants.STATUS_RESULT, event.getStatusResult()); - if (event.getTotalCount() != null) { + if (event.getTotalCount() != null && event.getTotalCount() >= 0) { arguments.add(CxConstants.TOTAL_COUNT); arguments.add(event.getTotalCount().toString()); } @@ -862,6 +861,7 @@ static List buildTelemetryArguments(TelemetryEvent event) { addIfNotBlank(arguments, CxConstants.AGENT_VERSION, event.getAgentVersion()); addIfNotBlank(arguments, CxConstants.CX_PLUGIN_VERSION, event.getCxPluginVersion()); addIfNotBlank(arguments, CxConstants.PLUGIN_TYPE, event.getPluginType()); + addIfNotBlank(arguments, CxConstants.STATUS_RESULT, event.getStatusResult()); addIfNotBlank(arguments, CxConstants.REPO_URL, event.getRepoUrl()); addIfNotBlank(arguments, CxConstants.API_VERSION, event.getApiVersion()); addIfNotBlank(arguments, CxConstants.EVENT_ATTRIBUTES, serializeEventAttributes(event.getEventAttributes())); diff --git a/src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java b/src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java index 78c1742b..823e18e8 100644 --- a/src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java +++ b/src/test/java/com/checkmarx/ast/wrapper/CxWrapperTelemetryArgumentsTest.java @@ -45,12 +45,12 @@ void testBuildTelemetryArguments_allAttributes() { "--problem-severity", "High", "--scan-type", "Oss", "--status", "success", - "--status-result", "ok", "--total-count", "3", "--agent", "Eclipse", "--agent-version", "2024.1", "--cx-plugin-version", "2.0.1", "--plugin-type", "IDE", + "--status-result", "ok", "--repo-url", "https://github.com/org/repo", "--api-version", "v2", "--event-attributes", "vulnerabilityId=CVE-2024-0001;remediationMode=DevAssist"), args); @@ -110,6 +110,13 @@ void testBuildTelemetryArguments_zeroTotalCountIsSent() { assertEquals(Arrays.asList("telemetry", "ai", "--total-count", "0"), args); } + @Test + void testBuildTelemetryArguments_negativeTotalCountIsOmitted() { + TelemetryEvent event = TelemetryEvent.builder().totalCount(-1).build(); + + assertEquals(Arrays.asList("telemetry", "ai"), CxWrapper.buildTelemetryArguments(event)); + } + @Test void testBuildTelemetryArguments_emptyEvent() { List args = CxWrapper.buildTelemetryArguments(TelemetryEvent.builder().build());