specsmd 0.1.1 → 0.1.2

package/lib/analytics/tracker.js

@@ -101,18 +101,34 @@ class AnalyticsTracker {
      *
      * @param {string} eventName - Name of the event
      * @param {Object} properties - Additional event properties
+     * @param {boolean} waitForDelivery - Wait for event to be sent
+     * @returns {Promise<void>} Resolves when event is sent (if waitForDelivery is true)
      */
-    track(eventName, properties = {}) {
+    track(eventName, properties = {}, waitForDelivery = false) {
         if (!this.enabled || !this.mixpanel) {
-            return;
+            return waitForDelivery ? Promise.resolve() : undefined;
         }
 
-        try {
-            this.mixpanel.track(eventName, {
-                ...this.baseProperties,
-                ...properties
+        const eventData = {
+            ...this.baseProperties,
+            ...properties
+        };
+
+        if (waitForDelivery) {
+            return new Promise((resolve) => {
+                try {
+                    this.mixpanel.track(eventName, eventData, (err) => {
+                        // Resolve regardless of error - silent failure
+                        resolve();
+                    });
+                } catch {
+                    resolve();
+                }
             });
-            // No await - fire and forget
+        }
+
+        try {
+            this.mixpanel.track(eventName, eventData);
         } catch {
             // Silent failure
         }
@@ -121,9 +137,11 @@ class AnalyticsTracker {
     /**
      * Track installer_started event
      * Called when the installer begins
+     * @returns {Promise<void>} Resolves when event is sent
      */
     trackInstallerStarted() {
-        this.track('installer_started');
+        // Wait for delivery - critical funnel event
+        return this.track('installer_started', {}, true);
     }
 
     /**
@@ -131,12 +149,14 @@ class AnalyticsTracker {
      * Called after user confirms IDE/tool selection
      *
      * @param {string[]} ides - Array of selected IDE keys (e.g., ['claude-code', 'cursor'])
+     * @returns {Promise<void>} Resolves when event is sent
      */
     trackIdesConfirmed(ides) {
-        this.track('ides_confirmed', {
+        // Wait for delivery - critical funnel event
+        return this.track('ides_confirmed', {
             ide_count: ides.length,
             ides: ides
-        });
+        }, true);
     }
 
     /**
@@ -144,11 +164,13 @@ class AnalyticsTracker {
      * Called after user selects an SDLC flow
      *
      * @param {string} flow - Flow key (e.g., 'aidlc', 'agile')
+     * @returns {Promise<void>} Resolves when event is sent
      */
     trackFlowSelected(flow) {
-        this.track('flow_selected', {
+        // Wait for delivery - critical funnel event
+        return this.track('flow_selected', {
             flow: flow
-        });
+        }, true);
     }
 
     /**

package/lib/installer.js

@@ -70,7 +70,7 @@ async function detectTools() {
 async function install() {
   // Initialize analytics (respects opt-out env vars)
   analytics.init();
-  analytics.trackInstallerStarted();
+  await analytics.trackInstallerStarted();
 
   const installStartTime = Date.now();
 
@@ -119,8 +119,8 @@ async function install() {
     process.exit(1);
   }
 
-  // Track IDE selection
-  analytics.trackIdesConfirmed(selectedToolKeys);
+  // Track IDE selection (await to ensure delivery before potential cancel)
+  await analytics.trackIdesConfirmed(selectedToolKeys);
 
   // Step 3: Select Flow
   console.log('');
@@ -143,8 +143,8 @@ async function install() {
     process.exit(1);
   }
 
-  // Track flow selection
-  analytics.trackFlowSelected(selectedFlow);
+  // Track flow selection (await to ensure delivery before potential cancel)
+  await analytics.trackFlowSelected(selectedFlow);
 
   // Step 4: Install flow files
   console.log('');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specsmd",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Multi-agent orchestration system for AI-native software development. Delivers AI-DLC, Agile, and custom SDLC flows as markdown-based agent systems.",
   "main": "lib/installer.js",
   "bin": {