progga 1.0.6 → 1.0.7

package/index.js

@@ -11,6 +11,49 @@ const ProfileRegistry = require('./profiles/ProfileRegistry');
 const ProjectTypeDetector = require('./core/ProjectTypeDetector');
 const PresetSelector = require('./core/PresetSelector');
 const Spinner = require('./core/Spinner');
+const { capture, maybeShowTelemetryNotice } = require('./telemetry');
+const os = require('os');
+
+function handleTelemetryCommand(args) {
+  if (args[0] !== 'telemetry') return false;
+
+  const action = args[1];
+  const configPath = path.join(os.homedir(), '.progga', 'config.json');
+
+  let config = {};
+  try {
+    if (fs.existsSync(configPath)) {
+      config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    }
+  } catch { }
+
+  if (action === 'on') {
+    config.telemetry = true;
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log('✅ Telemetry enabled');
+    return true;
+  }
+
+  if (action === 'off') {
+    config.telemetry = false;
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log('🚫 Telemetry disabled');
+    return true;
+  }
+
+  if (action === 'status') {
+    const enabled = config.telemetry !== false;
+    console.log(
+      enabled
+        ? '📊 Telemetry is enabled'
+        : '🚫 Telemetry is disabled'
+    );
+    return true;
+  }
+
+  console.log('Usage: progga telemetry [on|off|status]');
+  return true;
+}
 
 
 const CLI_IGNORE_PATHS = new Set();
@@ -305,6 +348,10 @@ function generateDocumentation(projectPath, outputFile, profile) {
   // Write to file
   fs.writeFileSync(outputFile, output, 'utf-8');
 
+  capture('generation_completed', {
+    files_processed: files.length,
+  });
+
   console.log(`\n✅ Documentation generated successfully: ${outputFile}`);
   console.log(`📊 Total files processed: ${files.length}`);
 }
@@ -313,6 +360,19 @@ function generateDocumentation(projectPath, outputFile, profile) {
 async function main() {
   let cliIgnores = [];
   const args = process.argv.slice(2);
+  if (handleTelemetryCommand(args)) {
+    return; // 🔥 EXIT EARLY
+  }
+
+  maybeShowTelemetryNotice();
+
+  capture('cli_run', {
+    args_count: args.length,
+    used_ignore_flag: args.includes('--ignore') || args.includes('-i'),
+    used_preset: args.includes('--preset'),
+    is_tty: process.stdin.isTTY,
+  });
+
 
   let projectPath = '.';
   let outputFile = 'PROJECT_DOCUMENTATION.md';
@@ -367,7 +427,12 @@ async function main() {
     console.log(`🚫 CLI ignores applied: ${cliIgnores.join(', ')}`);
   }
 
+  capture('profile_selected', {
+    profile: profile.name,
+  });
+
   console.log(`Using profile: ${profile.name}`);
+
   generateDocumentation(projectPath, outputFile, profile);
 
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "progga",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Generate comprehensive project documentation for AI assistants - Share your entire codebase context in one markdown file",
   "main": "index.js",
   "bin": {
@@ -40,7 +40,9 @@
   "homepage": "https://github.com/Yousuf-Basir/progga#readme",
   "dependencies": {
     "@inquirer/select": "^5.0.4",
+    "dotenv": "^17.2.3",
     "inquirer": "^13.2.0",
-    "ora": "^9.0.0"
+    "ora": "^9.0.0",
+    "posthog-node": "^5.20.0"
   }
 }

package/telemetry.js

@@ -0,0 +1,122 @@
+require('dotenv').config();
+const os = require('os')
+const fs = require('fs')
+const path = require('path')
+const { PostHog } = require('posthog-node')
+const pkg = require('./package.json')
+
+const POSTHOG_KEY = process.env.POSTHOG_KEY;
+const POSTHOG_HOST = process.env.POSTHOG_HOST || 'https://us.i.posthog.com';
+
+const CONFIG_DIR = path.join(os.homedir(), '.progga')
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json')
+
+let client = null;
+
+if (POSTHOG_KEY) {
+    client = new PostHog(POSTHOG_KEY, {
+        host: POSTHOG_HOST,
+        flushAt: 1,
+        flushInterval: 0
+    });
+}
+
+function getConfig() {
+    try {
+        if (!fs.existsSync(CONFIG_DIR)) {
+            fs.mkdirSync(CONFIG_DIR);
+        }
+
+        if (fs.existsSync(CONFIG_FILE)) {
+            return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+        }
+    } catch { }
+
+    return {};
+}
+
+function saveConfig(config) {
+    try {
+        fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+    } catch { }
+}
+
+
+function getOrCreateUserId() {
+    try {
+        if (!fs.existsSync(CONFIG_DIR)) {
+            fs.mkdirSync(CONFIG_DIR)
+        }
+
+        if (fs.existsSync(CONFIG_FILE)) {
+            const data = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'))
+            if (data.userId) return data.userId
+        }
+
+        const userId = cryptoRandomId()
+        saveConfig({ userId });
+
+        return userId
+    } catch {
+        return null
+    }
+}
+
+function isTelemetryEnabled() {
+  const config = getConfig();
+  return config.telemetry !== false; // default ON
+}
+
+function cryptoRandomId() {
+    return require('crypto').randomUUID()
+}
+
+function capture(event, properties = {}) {
+    if (!client) return;
+    if (!isTelemetryEnabled()) return;
+
+    const distinctId = getOrCreateUserId();
+    if (!distinctId) return;
+
+    client.capture({
+        distinctId,
+        event,
+        properties: {
+            tool: 'progga',
+            version: pkg.version,
+            os: os.platform(),
+            node: process.version,
+            ...properties,
+        },
+    });
+
+    client.flush().catch(() => { });
+}
+
+function maybeShowTelemetryNotice() {
+  if (!process.stdin.isTTY) return;
+
+  const config = getConfig();
+
+  if (config.telemetry_notice_shown) return;
+
+  console.log('');
+  console.log('ℹ Progga collects anonymous usage data to improve the tool.');
+  console.log('  No project files, paths, or code are ever collected.');
+  console.log('');
+  console.log('  You can disable telemetry anytime with:');
+  console.log('    progga telemetry off');
+  console.log('');
+
+  saveConfig({
+    ...config,
+    telemetry_notice_shown: true,
+  });
+}
+
+
+process.on('exit', () => {
+    client.shutdown()
+})
+
+module.exports = { capture, maybeShowTelemetryNotice }