Function trackCommand

src/telemetry/index.ts:115–137

(commandName: string, version: string)

 * @param version - The OpenSpec version
 */
export async function trackCommand(commandName: string, version: string): Promise<void> {
  if (!isTelemetryEnabled()) {
    return;
  }

  try {
    const userId = await getOrCreateAnonymousId();
    const client = getClient();

    client.capture({
      distinctId: userId,
      event: 'command_executed',
      properties: {
        command: commandName,
        version: version,
        surface: 'cli',
        $ip: null, // Explicitly disable IP tracking
      },
    });
  } catch {
    // Silent failure - telemetry should never break CLI
  }
}

/**
 * Show first-run telemetry notice if not already seen.