specsmd 0.1.1 → 0.1.3

package/lib/analytics/tracker.js

@@ -56,7 +56,12 @@ class AnalyticsTracker {
             const Mixpanel = require('mixpanel');
             this.mixpanel = Mixpanel.init(MIXPANEL_TOKEN, {
                 protocol: 'https',
-                host: 'api-eu.mixpanel.com'  // EU endpoint for GDPR compliance
+                host: 'api-eu.mixpanel.com',  // EU endpoint for GDPR compliance
+                // Note: geolocate: true enables IP-based geolocation for analytics.
+                // This data is used solely for aggregate usage insights (e.g., country-level
+                // adoption patterns). No personal identifiers are collected. Users can
+                // opt out via the --no-telemetry flag or SPECSMD_NO_TELEMETRY env var.
+                geolocate: true
             });
 
             // Generate IDs
@@ -101,18 +106,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, () => {
+                        // 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 +142,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 +154,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 +169,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('');
@@ -250,6 +250,20 @@ async function installFlow(flowKey, toolKeys) {
 
   CLIUtils.displayStatus('', 'Installed flow resources', 'success');
 
+  // Step 2.5: Install local scripts for deterministic operations
+  // These scripts are version-matched to the installed specsmd version
+  const scriptsDir = path.join(specsmdDir, 'scripts');
+  await fs.ensureDir(scriptsDir);
+
+  const sourceScriptsDir = path.join(__dirname, '..', 'scripts');
+  if (await fs.pathExists(sourceScriptsDir)) {
+    await fs.copy(sourceScriptsDir, scriptsDir);
+    CLIUtils.displayStatus('', 'Installed local scripts', 'success');
+  }
+
+  // Note: Scripts are invoked directly via relative path (e.g., node .specsmd/scripts/bolt-complete.js)
+  // No npm scripts added to package.json to avoid dependency on package.json for execution
+
   // NOTE: memory-bank/ is NOT created during installation
   // It will be created when user runs project-init
   // This allows us to detect if project is initialized by checking for memory-bank/standards/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specsmd",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "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": {
@@ -36,6 +36,7 @@
     "bin/",
     "flows/",
     "lib/",
+    "scripts/",
     "README.md"
   ],
   "dependencies": {