chore(cli): introduce telemetry and opt-out options (#107)

* chore: use barrel file

* chore(core): flush telemetry

* feat(cli): introduce `telemetry` and opt-out options

Author: bespoyasov

packages/cli/bin/cli.ts

@@ -2,6 +2,8 @@
 
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
+import { APP_NAME, CLI_VERSION } from '@meta';
+import { flushTelemetry, telemetryMiddleware } from '@utils/index.js';
 import {
   loginCommand,
   logoutCommand,
@@ -18,7 +20,6 @@ import {
   pluginCommand,
   migrateCommand,
 } from '../src/commands/index.js';
-import { APP_NAME, CLI_VERSION } from '@meta';
 
 const cli = yargs(hideBin(process.argv))
   .scriptName(APP_NAME)
@@ -65,6 +66,12 @@ const cli = yargs(hideBin(process.argv))
     describe: 'Verbose/diagnostic output',
     hidden: true,
   })
+  .option('telemetry', {
+    type: 'boolean',
+    default: true,
+    describe: 'Collect anonymous usage telemetry (disable with --no-telemetry)',
+  })
+  .middleware(telemetryMiddleware)
   .command(loginCommand)
   .command(logoutCommand)
   .command(whoamiCommand)
@@ -91,4 +98,8 @@ const cli = yargs(hideBin(process.argv))
   .help()
   .version(CLI_VERSION);
 
-cli.parse();
+try {
+  await cli.parseAsync();
+} finally {
+  await flushTelemetry();
+}

packages/cli/src/commands/docs.ts

@@ -1,6 +1,6 @@
 import type { Argv } from 'yargs';
 import { searchDocs, grepDocs, readDocs } from '@features/docs/index.js';
-import { safely } from '../utils/safely.js';
+import { safely } from '@utils/index.js';
 
 export const docsCommand = {
   command: 'docs <action>',

packages/cli/src/commands/events.ts

@@ -8,7 +8,7 @@ import {
   deleteEvent,
   eventUsage,
 } from '@features/events/index.js';
-import { safely } from '../utils/safely.js';
+import { safely } from '@utils/index.js';
 
 export const eventsCommand = {
   command: 'events <action>',

packages/cli/src/commands/flags.ts

@@ -10,7 +10,7 @@ import {
   targetFlagCmd,
   archiveFlagCmd,
 } from '@features/flags/index.js';
-import { safely } from '../utils/safely.js';
+import { safely } from '@utils/index.js';
 
 export const flagsCommand = {
   command: 'flags <action>',

packages/cli/src/commands/migrate.ts

@@ -1,7 +1,7 @@
 import type { Argv } from 'yargs';
 import { getProviders } from '@spotify-confidence/core';
 import { detectAndPrint, launchMigration } from '@features/migrate/index.js';
-import { safely } from '../utils/safely.js';
+import { safely } from '@utils/index.js';
 
 export const migrateCommand = {
   command: 'migrate <action>',

packages/cli/src/commands/plugin.ts

@@ -11,7 +11,7 @@ import {
   uninstallPluginForIde,
   updatePluginForIde,
 } from '@features/plugin/index.js';
-import { safely } from '@utils/safely.js';
+import { safely } from '@utils/index.js';
 
 export const pluginCommand = {
   command: 'plugin <action>',

packages/cli/src/commands/recordings.ts

@@ -10,8 +10,7 @@ import {
   showTargetingKeys,
   addTargetingKey,
 } from '@features/recordings/index.js';
-import { safely } from '../utils/safely.js';
-import { validateRange } from '../utils/validation.js';
+import { safely, validateRange } from '@utils/index.js';
 
 export const recordingsCommand = {
   command: 'recordings <action>',

packages/cli/src/features/docs/grep.ts

@@ -1,7 +1,7 @@
 import ora from 'ora';
 import { grepDocumentation } from '@network/index.js';
 import { printMcpResult } from '@output/print.js';
-import { withAuth } from '@utils/require-auth.js';
+import { withAuth } from '@utils/index.js';
 
 export const grepDocs = withAuth(async function grepDocs(argv, token) {
   const pattern = argv.pattern as string;

packages/cli/src/features/docs/read.ts

@@ -2,7 +2,7 @@ import ora from 'ora';
 import { CONFIDENCE_DOCS_URL } from '@spotify-confidence/core';
 import { getFullSource } from '@network/index.js';
 import { printMcpResult } from '@output/print.js';
-import { withAuth } from '@utils/require-auth.js';
+import { withAuth } from '@utils/index.js';
 
 function normalizeSource(input: string): string {
   if (input.includes('://')) return input;

packages/cli/src/features/docs/search.ts

@@ -1,7 +1,7 @@
 import ora from 'ora';
 import { searchDocumentation } from '@network/index.js';
 import { printMcpResult } from '@output/print.js';
-import { withAuth } from '@utils/require-auth.js';
+import { withAuth } from '@utils/index.js';
 
 export const searchDocs = withAuth(async function searchDocs(argv, token) {
   const query = argv.query as string;