progga 1.0.5 → 1.0.7

package/index.js

@@ -11,6 +11,53 @@ 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();
+const CLI_IGNORE_EXTENSIONS = new Set();
 
 /**
  * Check if path should be ignored
@@ -20,13 +67,19 @@ function shouldIgnore(filePath, basePath, profile) {
   const parts = relativePath.split(path.sep);
 
   for (const part of parts) {
-    if (profile.ignorePaths().includes(part)) {
+    if (
+      profile.ignorePaths().includes(part) ||
+      CLI_IGNORE_PATHS.has(part)
+    ) {
       return true;
     }
   }
 
   const ext = path.extname(filePath);
-  if (profile.ignoreExtensions().includes(ext)) {
+  if (
+    profile.ignoreExtensions().includes(ext) ||
+    CLI_IGNORE_EXTENSIONS.has(ext)
+  ) {
     return true;
   }
 
@@ -295,13 +348,31 @@ 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}`);
 }
 
 // Main execution
 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';
@@ -310,13 +381,22 @@ async function main() {
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
 
-    if (arg === '--project-type' || arg === '--preset') {
-      projectType = args[i + 1];
-      i++;
-    } else if (!projectPath) {
-      projectPath = arg;
-    } else if (!outputFile) {
-      outputFile = arg;
+    if (arg === '--ignore' || arg === '-i') {
+      const value = args[i + 1];
+      if (value) {
+        value
+          .split(',')
+          .map(v => v.trim())
+          .filter(Boolean)
+          .forEach(item => {
+            if (item.startsWith('.')) {
+              CLI_IGNORE_EXTENSIONS.add(item);
+            } else {
+              CLI_IGNORE_PATHS.add(item);
+            }
+          });
+        i++;
+      }
     }
   }
 
@@ -342,8 +422,19 @@ async function main() {
     profile = ProfileRegistry.fallback(projectPath);
   }
 
+  if (cliIgnores.length) {
+    profile.applyCliIgnores(cliIgnores);
+    console.log(`🚫 CLI ignores applied: ${cliIgnores.join(', ')}`);
+  }
+
+  capture('profile_selected', {
+    profile: profile.name,
+  });
+
   console.log(`Using profile: ${profile.name}`);
+
   generateDocumentation(projectPath, outputFile, profile);
+
 }
 
 main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "progga",
-  "version": "1.0.5",
+  "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/profiles/ProjectProfile.js

@@ -1,6 +1,18 @@
 class ProjectProfile {
   constructor(projectRoot) {
     this.projectRoot = projectRoot;
+    this.cliIgnorePaths = [];
+    this.cliIgnoreExtensions = [];
+  }
+
+  applyCliIgnores(list) {
+    for (const item of list) {
+      if (item.startsWith('.')) {
+        this.cliIgnoreExtensions.push(item);
+      } else {
+        this.cliIgnorePaths.push(item);
+      }
+    }
   }
 
   get name() {
@@ -9,12 +21,12 @@ class ProjectProfile {
 
   /** Paths to fully ignore */
   ignorePaths() {
-    return [];
+    return this.cliIgnorePaths;
   }
 
   /** Extensions to ignore */
   ignoreExtensions() {
-    return [];
+    return this.cliIgnoreExtensions;
   }
 
   /** Binary extensions */

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 }