@gurulu/cli 0.1.3 → 0.2.1

package/dist/commands/install.js

@@ -403,6 +403,9 @@ async function runInstallFlow(args, deps, scriptsDir) {
         log(deps, 'success', 'Patches applied.');
     }
     else {
+        if (args.autoInstrument) {
+            log(deps, 'info', `Auto-instrument: ${summary.instrumentation?.filesModified || 0} route files, ${summary.instrumentation?.eventsInstrumented || 0} events`);
+        }
         log(deps, 'info', 'Dry-run: skipping apply, npm install, env merge, and ingest test.');
     }
     // ---- 5. npm install --------------------------------------------------
@@ -526,6 +529,15 @@ async function runInstallFlow(args, deps, scriptsDir) {
             `${summary.instrumentation.eventsSkipped} skipped`);
     }
     log(deps, 'info', '');
+    // ---- Post-install guidance ---------------------------------------------
+    if (!summary.dryRun && summary.errors.length === 0) {
+        console.log('');
+        log(deps, 'info', '✓ Install complete! Next steps:');
+        log(deps, 'info', `  Run ${(0, ui_1.cyan)('gurulu doctor')} to verify setup health`);
+        log(deps, 'info', `  Run ${(0, ui_1.cyan)('gurulu events tail')} to watch live events`);
+        log(deps, 'info', `  Visit ${(0, ui_1.cyan)('https://gurulu.io/dashboard')} to view analytics`);
+        console.log('');
+    }
     return summary;
 }
 function repoHashOf(repoRoot, remoteUrl = null) {
@@ -633,10 +645,41 @@ async function runAuthenticatedInstallFlow(args, authDeps, installDeps, scriptsD
                     intent = await authDeps.intent.analyze(signals);
                     intentRecord.analyzed = true;
                     intentRecord.vertical = intent.vertical;
+                    if (intent.analyzerMode === 'heuristic') {
+                        installDeps.log?.warn('⚠ LLM unavailable — using rule-based intent discovery. Results may be less precise.');
+                    }
                 }
                 catch (err) {
                     installDeps.log?.warn(`Intent analyzer failed: ${err.message}`);
+                    installDeps.log?.warn('⚠ Falling back to built-in generic event set.');
                     intentRecord.error = `analyze_failed:${err.message}`;
+                    // Client-side fallback: produce a minimal generic intent so
+                    // auto-instrument and pre-seed still work even when the API is down.
+                    intent = {
+                        vertical: 'generic',
+                        confidence: 'low',
+                        reasoning: 'API unavailable — using built-in generic fallback.',
+                        analyzerMode: 'heuristic',
+                        alternativeVerticals: [],
+                        events: [
+                            { name: '$page_view', category: 'engagement', source: 'inferred:pattern', properties: [], confidence: 1.0, reasoning: 'Baseline page impression.' },
+                            { name: '$session_start', category: 'engagement', source: 'inferred:pattern', properties: [], confidence: 1.0, reasoning: 'Session boundary.' },
+                            { name: '$signup', category: 'acquisition', source: 'inferred:pattern', properties: [{ name: 'method', type: 'string' }], confidence: 0.9, reasoning: 'New account signal.' },
+                            { name: '$login', category: 'engagement', source: 'inferred:pattern', properties: [{ name: 'method', type: 'string' }], confidence: 0.9, reasoning: 'Returning user signal.' },
+                            { name: '$logout', category: 'engagement', source: 'inferred:pattern', properties: [], confidence: 0.9, reasoning: 'Session end.' },
+                            { name: '$first_action', category: 'activation', source: 'inferred:pattern', properties: [], confidence: 0.8, reasoning: 'First meaningful interaction.' },
+                            { name: 'click', category: 'engagement', source: 'inferred:pattern', properties: [{ name: 'selector', type: 'string' }], confidence: 1.0, reasoning: 'User clicks.' },
+                            { name: 'scroll_depth', category: 'engagement', source: 'inferred:pattern', properties: [{ name: 'depth', type: 'number' }], confidence: 1.0, reasoning: 'Scroll engagement.' },
+                            { name: 'form_submit', category: 'engagement', source: 'inferred:pattern', properties: [{ name: 'form_id', type: 'string' }], confidence: 0.9, reasoning: 'Form completion.' },
+                            { name: 'engaged_session', category: 'engagement', source: 'inferred:pattern', properties: [], confidence: 1.0, reasoning: 'Quality session marker.' },
+                            { name: '$search', category: 'engagement', source: 'inferred:pattern', properties: [{ name: 'query', type: 'string' }], confidence: 0.7, reasoning: 'Search intent.' },
+                            { name: '$error', category: 'engagement', source: 'inferred:pattern', properties: [{ name: 'message', type: 'string' }], confidence: 0.8, reasoning: 'Client error tracking.' },
+                        ],
+                        funnels: [
+                            { name: 'Signup Flow', category: 'acquisition', steps: ['$page_view', '$signup', '$login'], reasoning: 'Page view to signup to first login.' },
+                            { name: 'Engagement', category: 'engagement', steps: ['$page_view', 'scroll_depth', 'engaged_session'], reasoning: 'Page view to scroll to engaged session.' },
+                        ],
+                    };
                 }
                 if (intent) {
                     const io = authDeps.intent.io || {

package/dist/index.js

@@ -208,20 +208,25 @@ const db_1 = require("./commands/db");
     .option('skip-env', { type: 'boolean', describe: 'Skip .env file merge' })
     .option('yes', { type: 'boolean', alias: 'y', describe: 'Non-interactive (assume yes)' })
     .option('ingest-url', { type: 'string', describe: 'Override ingest base URL' })
-    .option('verify', { type: 'boolean', describe: 'Live smoke test after install' })
+    .option('verify', { type: 'boolean', default: true, describe: 'Live smoke test after install' })
     .option('skip-intent', { type: 'boolean', describe: 'Skip install-time intent discovery' })
     .option('intent-dry-run', { type: 'boolean', describe: 'Show intent proposal without pre-seeding' })
     .option('vertical', { type: 'string', describe: 'Vertical hint for intent analyzer' })
     // BEGIN: Agent B (Phase 18.7) — auto-instrument opt-in flag
     .option('auto-instrument', {
     type: 'boolean',
-    description: 'Also auto-instrument route handlers with gurulu.track() calls (opt-in)',
-    default: false,
+    description: 'Also auto-instrument route handlers with gurulu.track() calls',
+    default: true,
 })
     .option('auto-properties', {
     type: 'boolean',
+    default: true,
+    description: 'Ask Minimax to propose properties for each auto-instrumented handler (Phase 20 W1 A2)',
+})
+    .option('skip-verify', {
+    type: 'boolean',
     default: false,
-    description: 'Opt-in: ask Minimax to propose properties for each auto-instrumented handler (Phase 20 W1 A2)',
+    description: 'Skip live smoke verification after install',
 }), 
 // END: Agent B (Phase 18.7)
 (args) => {
@@ -239,7 +244,7 @@ const db_1 = require("./commands/db");
         skipEnv: args['skip-env'],
         yes: args.yes,
         ingestUrl: args['ingest-url'],
-        verify: args.verify,
+        verify: args['skip-verify'] ? false : args.verify,
         profile: args.profile,
         skipIntent: args['skip-intent'],
         intentDryRun: args['intent-dry-run'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gurulu/cli",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "description": "Gurulu.io CLI — setup analytics in seconds",
   "bin": {
     "gurulu": "bin/gurulu.js"