@gurulu/cli 0.3.4 → 0.4.1

package/README.md

@@ -1,6 +1,6 @@
 # @gurulu/cli
 
-CLI wizard for setting up Gurulu.io analytics in any project.
+CLI for Gurulu.io — setup, diagnostics, data exploration, and AI-powered analytics from your terminal.
 
 ## Quick Start
 
@@ -10,31 +10,76 @@ npx @gurulu/cli init
 
 ## Commands
 
+### Authentication
+
+| Command | Description |
+|---------|-------------|
+| `gurulu auth` | Authenticate via device-link flow (or `--key` for manual) |
+| `gurulu login` | Authenticate with API key |
+| `gurulu logout` | Remove a stored profile |
+| `gurulu whoami` | Show current authentication state |
+
+### Setup & Diagnostics
+
 | Command | Description |
 |---------|-------------|
 | `gurulu init` | Set up Gurulu analytics (auto-detects framework) |
-| `gurulu login` | Authenticate with your Personal API Key |
-| `gurulu events` | List detected events from your site |
-| `gurulu status` | Quick health check |
-| `gurulu doctor` | Comprehensive diagnostics |
+| `gurulu install [path]` | Install Gurulu tracker in a repository |
 | `gurulu add-server` | Add server-side SDK (@gurulu/node) |
+| `gurulu status` | Check SDK health and connection |
+| `gurulu doctor` | Diagnose setup issues |
+| `gurulu config <action>` | Manage CLI profiles (list, use, show, delete) |
+
+### Sites & Keys
+
+| Command | Description |
+|---------|-------------|
+| `gurulu sites <action>` | Manage sites (list, create, show, delete, rotate-token) |
+| `gurulu api-keys <action>` | Manage API keys (list, create, revoke, rotate) |
+
+### Data & Events
+
+| Command | Description |
+|---------|-------------|
+| `gurulu events <action>` | View ingested events (list, tail) |
+| `gurulu insights <action>` | View daily insights (today, history, weekly) |
+| `gurulu chat [question]` | Ask analytics questions in natural language (NL -> SQL) |
+
+### Identity & Audiences
+
+| Command | Description |
+|---------|-------------|
+| `gurulu identity <action>` | View identity state (decay, transfers, cdc-sources) |
+| `gurulu audiences <action>` | View audiences (list, show) |
+| `gurulu experiments <action>` | View experiments (list, show, results) |
+
+### Integrations & Export
+
+| Command | Description |
+|---------|-------------|
+| `gurulu warehouse <action>` | Warehouse exports (BigQuery) |
+| `gurulu warehouses <action>` | View warehouse exports (list, runs) |
+| `gurulu destinations <action>` | View activation destinations (list, show) |
+| `gurulu db <action>` | Connect, list, sync, or remove database sources |
+
+### Monitoring & Debugging
+
+| Command | Description |
+|---------|-------------|
+| `gurulu alerts <action>` | View anomaly alerts (list, show, channels) |
+| `gurulu sourcemap <action>` | Upload source maps for error deobfuscation |
+| `gurulu audit <action>` | Stream or export the CLI audit log (tail, export) |
+| `gurulu playground <action>` | View playground sessions (list) |
 
 ## Supported Frameworks
 
-- Next.js (App Router & Pages Router)
-- React (Vite & CRA)
-- Vue 3
-- Nuxt 3
-- Svelte & SvelteKit
-- Astro
-- Express
-- NestJS
-- Plain HTML
+Next.js (App & Pages Router), React (Vite & CRA), Vue 3, Nuxt 3, Svelte & SvelteKit, Astro, Express, NestJS, Plain HTML.
 
 ## Authentication
 
 ```bash
-gurulu login --api-key pak_live_xxxxx
+gurulu auth                        # Device-link flow (recommended)
+gurulu login --api-key pak_live_x  # Manual API key
 ```
 
 Or set the `GURULU_API_KEY` environment variable.
@@ -52,15 +97,7 @@ gurulu init --site-id abc123 --token tok_xxx --no-interactive
 Use `--json` flag for machine-readable output:
 
 ```bash
-gurulu events --json
+gurulu events list --json
 gurulu status --json
 gurulu doctor --json
 ```
-
-## Development
-
-```bash
-npm install
-npm run build
-node bin/gurulu.js --help
-```

package/dist/api-client.js

@@ -97,7 +97,7 @@ async function cliApi(path, init = {}) {
     if (!init.skipAuth && profile) {
         headers.set('authorization', `Bearer ${profile.secret_key}`);
     }
-    if (init.body && !headers.has('content-type')) {
+    if (init.body && !headers.has('content-type') && !(init.body instanceof FormData)) {
         headers.set('content-type', 'application/json');
     }
     let res;

package/dist/commands/add-server.js

@@ -46,11 +46,18 @@ async function addServerCommand(args) {
     let serverApiKey = process.env.GURULU_SERVER_API_KEY;
     if (!serverApiKey && profile) {
         try {
-            const data = await (0, api_client_1.cliApiJson)(`/api/cli/sites/${encodeURIComponent(siteId)}`, { preloadedProfile: profile });
-            serverApiKey = data.site?.publishableKey || '';
+            (0, ui_1.step)('Creating server API key...');
+            const data = await (0, api_client_1.cliApiJson)(`/api/cli/sites/${encodeURIComponent(siteId)}/server-keys`, {
+                preloadedProfile: profile,
+                json: { name: `cli-${new Date().toISOString().slice(0, 10)}` },
+            });
+            serverApiKey = data.key || '';
+            if (serverApiKey) {
+                (0, ui_1.success)(`Server API key created (${data.keyId})`);
+            }
         }
         catch (err) {
-            (0, ui_1.warn)(`Could not fetch server credentials: ${err.message}`);
+            (0, ui_1.warn)(`Could not create server API key: ${err.message}`);
         }
     }
     if (!serverApiKey && !args.noInteractive) {
@@ -89,9 +96,9 @@ async function addServerCommand(args) {
     }
     // Step 2: Create server config file
     const configFilePath = path_1.default.join(projectDir, 'src', 'lib', 'gurulu-server.ts');
-    const configCode = `import { GuruluNode } from '@gurulu/node';
+    const configCode = `import { Gurulu } from '@gurulu/node';
 
-export const gurulu = new GuruluNode({
+export const gurulu = new Gurulu({
   siteId: process.env.GURULU_SITE_ID || '${siteId}',
   apiKey: process.env.GURULU_SERVER_API_KEY || '',
 });
@@ -134,7 +141,7 @@ export const gurulu = new GuruluNode({
     console.log('');
     (0, ui_1.step)('Import gurulu from src/lib/gurulu-server.ts in your API routes');
     (0, ui_1.step)(`Use ${(0, ui_1.cyan)('gurulu.track(event, properties)')} to send server-side events`);
-    (0, ui_1.step)(`Use ${(0, ui_1.cyan)('gurulu.identify(userId, traits)')} to identify users`);
+    (0, ui_1.step)(`Use ${(0, ui_1.cyan)("await gurulu.identify({ userId: '...', anonymousId: '...', traits: {} })")} to identify users`);
     (0, ui_1.step)(`Run ${(0, ui_1.cyan)('gurulu doctor')} to verify the setup`);
     console.log('');
     (0, ui_1.success)('Server SDK setup complete!');

package/dist/commands/alerts.d.ts

@@ -12,9 +12,14 @@ export interface AlertsArgs {
     json?: boolean;
     profile?: string;
     fromFile?: string;
+    site?: string;
+    id?: string;
     name?: string;
     type?: string;
     metric?: string;
+    thresholdType?: string;
+    thresholdValue?: number;
+    channel?: string;
     note?: string;
     yes?: boolean;
     dryRun?: boolean;

package/dist/commands/alerts.js

@@ -33,6 +33,8 @@ async function alertsCommand(args) {
 }
 async function listCmd(args) {
     const qs = new URLSearchParams();
+    if (args.site)
+        qs.set('siteId', args.site);
     if (args.severity)
         qs.set('severity', args.severity);
     if (args.acknowledged)
@@ -81,12 +83,28 @@ async function createCmd(args) {
     let payload = {};
     if (args.fromFile)
         payload = (0, from_file_1.loadFromFile)(args.fromFile);
+    if (args.site)
+        payload.siteId = args.site;
+    if (args.name)
+        payload.name = args.name;
+    if (args.type)
+        payload.type = args.type;
     if (args.metric)
         payload.metric = args.metric;
     if (args.severity)
         payload.severity = args.severity;
-    if (!payload.metric || !payload.severity) {
-        (0, ui_1.error)('metric and severity are required.');
+    if (args.thresholdType)
+        payload.thresholdType = args.thresholdType;
+    if (args.thresholdValue !== undefined)
+        payload.thresholdValue = args.thresholdValue;
+    if (args.channel)
+        payload.channelId = args.channel;
+    if (!payload.name) {
+        (0, ui_1.error)('name is required (pass --name or --from-file)');
+        process.exit(1);
+    }
+    if (!payload.siteId) {
+        (0, ui_1.error)('site is required (pass --site)');
         process.exit(1);
     }
     if (args.dryRun) {
@@ -98,7 +116,7 @@ async function createCmd(args) {
         (0, dry_run_1.printDryRun)(body, args.json);
         return;
     }
-    const ok = await (0, confirm_1.promptConfirm)(`Create alert '${payload.metric}'?`, {
+    const ok = await (0, confirm_1.promptConfirm)(`Create alert '${payload.name}'?`, {
         yes: args.yes,
         defaultYes: true,
     });
@@ -116,51 +134,61 @@ async function createCmd(args) {
     (0, ui_1.success)(`Created alert ${body.alert?.id ?? ''}`);
 }
 async function updateCmd(args) {
-    if (!args.target) {
-        (0, ui_1.error)('Usage: gurulu alerts update <id> [--note ...] [--ack]');
+    const resolveTarget = args.id || args.target;
+    if (!resolveTarget) {
+        (0, ui_1.error)('Usage: gurulu alerts update <id> [--id ...] [--name ...] [--threshold-value ...]');
         process.exit(1);
     }
     const payload = {};
+    if (args.name)
+        payload.name = args.name;
     if (args.note !== undefined)
         payload.note = args.note;
+    if (args.thresholdType)
+        payload.thresholdType = args.thresholdType;
+    if (args.thresholdValue !== undefined)
+        payload.thresholdValue = args.thresholdValue;
+    if (args.channel)
+        payload.channelId = args.channel;
     if (args.ack === true)
         payload.acknowledge = true;
     if (args.dryRun) {
-        const body = await (0, api_client_1.cliApiJson)(`/api/cli/alerts/${encodeURIComponent(args.target)}?dryRun=1`, { profile: args.profile, method: 'PATCH', json: payload });
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/alerts/${encodeURIComponent(resolveTarget)}?dryRun=1`, { profile: args.profile, method: 'PATCH', json: payload });
         (0, dry_run_1.printDryRun)(body, args.json);
         return;
     }
-    const ok = await (0, confirm_1.promptConfirm)(`Update alert '${args.target}'?`, {
+    const ok = await (0, confirm_1.promptConfirm)(`Update alert '${resolveTarget}'?`, {
         yes: args.yes,
         defaultYes: true,
     });
     if (!ok)
         return (0, ui_1.info)('Aborted.');
-    const body = await (0, api_client_1.cliApiJson)(`/api/cli/alerts/${encodeURIComponent(args.target)}`, { profile: args.profile, method: 'PATCH', json: payload });
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/alerts/${encodeURIComponent(resolveTarget)}`, { profile: args.profile, method: 'PATCH', json: payload });
     if (args.json) {
         process.stdout.write(JSON.stringify(body, null, 2) + '\n');
         return;
     }
-    (0, ui_1.success)(`Updated alert ${args.target}`);
+    (0, ui_1.success)(`Updated alert ${resolveTarget}`);
 }
 async function deleteCmd(args) {
-    if (!args.target) {
-        (0, ui_1.error)('Usage: gurulu alerts delete <id>');
+    const resolveTarget = args.id || args.target;
+    if (!resolveTarget) {
+        (0, ui_1.error)('Usage: gurulu alerts delete <id> [--id ...]');
         process.exit(1);
     }
     if (args.dryRun) {
-        const body = await (0, api_client_1.cliApiJson)(`/api/cli/alerts/${encodeURIComponent(args.target)}?dryRun=1`, { profile: args.profile, method: 'DELETE' });
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/alerts/${encodeURIComponent(resolveTarget)}?dryRun=1`, { profile: args.profile, method: 'DELETE' });
         (0, dry_run_1.printDryRun)(body, args.json);
         return;
     }
-    const ok = await (0, confirm_1.promptConfirm)(`About to delete alert '${args.target}'. Continue?`, { yes: args.yes, defaultYes: false });
+    const ok = await (0, confirm_1.promptConfirm)(`About to delete alert '${resolveTarget}'. Continue?`, { yes: args.yes, defaultYes: false });
     if (!ok)
         return (0, ui_1.info)('Aborted.');
-    await (0, api_client_1.cliApiJson)(`/api/cli/alerts/${encodeURIComponent(args.target)}`, {
+    await (0, api_client_1.cliApiJson)(`/api/cli/alerts/${encodeURIComponent(resolveTarget)}`, {
         profile: args.profile,
         method: 'DELETE',
     });
-    (0, ui_1.success)(`Deleted alert ${args.target}`);
+    (0, ui_1.success)(`Deleted alert ${resolveTarget}`);
 }
 // ── channels ──────────────────────────────────────────────────────────────
 async function channelsCmd(args) {

package/dist/commands/audiences.d.ts

@@ -8,8 +8,11 @@ export interface AudiencesArgs {
     json?: boolean;
     profile?: string;
     fromFile?: string;
+    site?: string;
+    id?: string;
     name?: string;
     description?: string;
+    rules?: string;
     yes?: boolean;
     dryRun?: boolean;
 }

package/dist/commands/audiences.js

@@ -30,7 +30,8 @@ async function audiencesCommand(args) {
     }
 }
 async function listCmd(args) {
-    const body = await (0, api_client_1.cliApiJson)('/api/cli/audiences', {
+    const qs = args.site ? `?siteId=${encodeURIComponent(args.site)}` : '';
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/audiences${qs}`, {
         profile: args.profile,
     });
     const audiences = body.audiences || [];
@@ -88,12 +89,27 @@ async function createCmd(args) {
     }
     if (args.name)
         payload.name = args.name;
+    if (args.site)
+        payload.siteId = args.site;
     if (args.description !== undefined)
         payload.description = args.description;
+    if (args.rules) {
+        try {
+            payload.rules = JSON.parse(args.rules);
+        }
+        catch {
+            (0, ui_1.error)('--rules must be valid JSON');
+            process.exit(1);
+        }
+    }
     if (!payload.name) {
         (0, ui_1.error)('name is required (pass --name or --from-file)');
         process.exit(1);
     }
+    if (!payload.siteId) {
+        (0, ui_1.error)('site is required (pass --site)');
+        process.exit(1);
+    }
     const qs = args.dryRun ? '?dryRun=1' : '';
     if (args.dryRun) {
         const body = await (0, api_client_1.cliApiJson)(`/api/cli/audiences${qs}`, {
@@ -121,11 +137,12 @@ async function createCmd(args) {
     (0, ui_1.success)(`Created audience ${body.audience?.id ?? ''}`);
 }
 async function updateCmd(args) {
-    if (!args.target) {
-        (0, ui_1.error)('Usage: gurulu audiences update <name-or-id> [--from-file <path>] [--name ...]');
+    const resolveTarget = args.id || args.target;
+    if (!resolveTarget) {
+        (0, ui_1.error)('Usage: gurulu audiences update <name-or-id> [--id ...] [--name ...] [--rules ...]');
         process.exit(1);
     }
-    const id = await resolveId(args.target, args.profile);
+    const id = await resolveId(resolveTarget, args.profile);
     let payload = {};
     if (args.fromFile) {
         payload = (0, from_file_1.loadFromFile)(args.fromFile);
@@ -134,6 +151,15 @@ async function updateCmd(args) {
         payload.name = args.name;
     if (args.description !== undefined)
         payload.description = args.description;
+    if (args.rules) {
+        try {
+            payload.rules = JSON.parse(args.rules);
+        }
+        catch {
+            (0, ui_1.error)('--rules must be valid JSON');
+            process.exit(1);
+        }
+    }
     const qs = args.dryRun ? '?dryRun=1' : '';
     if (args.dryRun) {
         const body = await (0, api_client_1.cliApiJson)(`/api/cli/audiences/${encodeURIComponent(id)}${qs}`, { profile: args.profile, method: 'PATCH', json: payload });
@@ -156,11 +182,12 @@ async function updateCmd(args) {
     (0, ui_1.success)(`Updated audience ${id}`);
 }
 async function deleteCmd(args) {
-    if (!args.target) {
-        (0, ui_1.error)('Usage: gurulu audiences delete <name-or-id>');
+    const resolveTarget = args.id || args.target;
+    if (!resolveTarget) {
+        (0, ui_1.error)('Usage: gurulu audiences delete <name-or-id> [--id ...]');
         process.exit(1);
     }
-    const id = await resolveId(args.target, args.profile);
+    const id = await resolveId(resolveTarget, args.profile);
     const qs = args.dryRun ? '?dryRun=1' : '';
     if (args.dryRun) {
         const body = await (0, api_client_1.cliApiJson)(`/api/cli/audiences/${encodeURIComponent(id)}${qs}`, { profile: args.profile, method: 'DELETE' });

package/dist/commands/events.d.ts

@@ -17,6 +17,12 @@ export interface EventsArgs {
     limit?: number;
     json?: boolean;
     profile?: string;
+    displayName?: string;
+    description?: string;
+    category?: string;
+    properties?: string;
+    event?: string;
+    vertical?: string;
 }
 export declare function eventsCommand(args: EventsArgs): Promise<void>;
 export declare function legacyEventsCommand(args: {

package/dist/commands/events.js

@@ -22,9 +22,17 @@ async function eventsCommand(args) {
             return listCmd(args);
         case 'tail':
             return tailCmd(args);
+        case 'schema':
+            return schemaCmd(args);
+        case 'define':
+            return defineCmd(args);
+        case 'verify':
+            return verifyCmd(args);
+        case 'templates':
+            return templatesCmd(args);
         default:
             (0, ui_1.error)(`Unknown events action: ${action}`);
-            (0, ui_1.info)('Usage: gurulu events [list|tail]');
+            (0, ui_1.info)('Usage: gurulu events [list|tail|schema|define|verify|templates]');
             process.exit(1);
     }
 }
@@ -112,6 +120,179 @@ async function tailCmd(args) {
         process.stdout.write(formatFrame(text, !!args.json));
     }
 }
+/* ── schema: show property schema & implementation examples ───────── */
+async function schemaCmd(args) {
+    if (!args.eventName) {
+        (0, ui_1.error)('Event name is required. Usage: gurulu events schema --event-name <name> --site <id>');
+        process.exit(1);
+    }
+    if (!args.site) {
+        (0, ui_1.error)('--site is required for schema lookup.');
+        process.exit(1);
+    }
+    const path = `/api/cli/events/schema/${encodeURIComponent(args.eventName)}?siteId=${args.site}`;
+    const data = await (0, api_client_1.cliApiJson)(path, { profile: args.profile });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+        return;
+    }
+    console.log((0, ui_1.bold)(`\nEvent: ${data.eventName}`));
+    if (data.source)
+        console.log(`Source: ${data.source}`);
+    if (data.description)
+        console.log(`Description: ${data.description}`);
+    if (data.isRevenue)
+        console.log((0, ui_1.yellow)(`Revenue event: ${data.revenueNote || 'yes'}`));
+    if (data.propertySchema?.length) {
+        console.log((0, ui_1.bold)('\nProperties:'));
+        for (const p of data.propertySchema) {
+            const req = p.required ? (0, ui_1.red)('REQUIRED') : (0, ui_1.dim)('optional');
+            const fmt = p.format ? (0, ui_1.cyan)(` [${p.format}]`) : '';
+            const ex = p.example !== undefined ? (0, ui_1.dim)(` e.g. ${JSON.stringify(p.example)}`) : '';
+            console.log(`  ${p.name}: ${(0, ui_1.cyan)(p.type)} (${req})${fmt} — ${p.description || ''}${ex}`);
+        }
+    }
+    if (data.implementation && Object.keys(data.implementation).length) {
+        console.log((0, ui_1.bold)('\nImplementation:'));
+        for (const [platform, code] of Object.entries(data.implementation)) {
+            console.log(`  ${(0, ui_1.cyan)(`[${platform}]`)}: ${code}`);
+        }
+    }
+    console.log('');
+}
+/* ── define: create a new custom event definition ────────────────── */
+async function defineCmd(args) {
+    if (!args.site) {
+        (0, ui_1.error)('--site is required.');
+        process.exit(1);
+    }
+    if (!args.eventName) {
+        (0, ui_1.error)('--event-name is required.');
+        process.exit(1);
+    }
+    if (!args.displayName) {
+        (0, ui_1.error)('--display-name is required.');
+        process.exit(1);
+    }
+    let propertySchema = [];
+    if (args.properties) {
+        try {
+            propertySchema = JSON.parse(args.properties);
+        }
+        catch {
+            (0, ui_1.error)('Invalid JSON for --properties');
+            process.exit(1);
+        }
+    }
+    const eventName = args.eventName.startsWith('$') ? args.eventName : `$${args.eventName}`;
+    const body = {
+        siteId: args.site,
+        eventName,
+        displayName: args.displayName,
+        description: args.description || '',
+        intentName: args.category || 'engagement',
+        fingerprint: { propertySchema },
+    };
+    const data = await (0, api_client_1.cliApiJson)('/api/cli/events/definitions', { profile: args.profile, method: 'POST', json: body });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Event ${eventName} defined successfully`);
+    (0, ui_1.info)(`Run: gurulu events schema --event-name ${eventName} --site ${args.site} to see implementation examples`);
+}
+/* ── verify: check event health / quality ────────────────────────── */
+async function verifyCmd(args) {
+    if (!args.site) {
+        (0, ui_1.error)('--site is required.');
+        process.exit(1);
+    }
+    const qs = new URLSearchParams();
+    qs.set('siteId', args.site);
+    if (args.event)
+        qs.set('eventName', args.event);
+    const path = `/api/cli/events/health?${qs.toString()}`;
+    const data = await (0, api_client_1.cliApiJson)(path, { profile: args.profile });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+        return;
+    }
+    console.log((0, ui_1.bold)('\nEvent Health Report'));
+    console.log(`Site: ${args.site}`);
+    console.log('');
+    if (Array.isArray(data.events)) {
+        for (const ev of data.events) {
+            const statusIcon = ev.status === 'active'
+                ? (0, ui_1.green)('●')
+                : ev.status === 'stale'
+                    ? (0, ui_1.yellow)('●')
+                    : (0, ui_1.red)('●');
+            console.log(`${statusIcon} ${ev.event_name} — ${ev.total_count ?? 0} events (last: ${ev.last_seen ?? 'never'})`);
+            if (ev.missing_properties?.length) {
+                console.log((0, ui_1.yellow)(`  Missing required properties: ${ev.missing_properties.join(', ')}`));
+            }
+        }
+    }
+    else if (data.total_events !== undefined) {
+        console.log(`Total events (24h): ${data.total_events}`);
+        console.log(`Unique event types: ${data.unique_types ?? 'N/A'}`);
+    }
+    console.log('');
+}
+/* ── templates: list vertical event template catalogs ───────────── */
+async function templatesCmd(args) {
+    const qs = new URLSearchParams();
+    if (args.vertical)
+        qs.set('vertical', args.vertical);
+    const path = `/api/events/templates${qs.toString() ? `?${qs.toString()}` : ''}`;
+    const data = await (0, api_client_1.cliApiJson)(path, { profile: args.profile });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+        return;
+    }
+    if (data.error) {
+        (0, ui_1.error)(data.error);
+        process.exit(1);
+    }
+    // List mode — no vertical specified
+    if (data.verticals) {
+        console.log((0, ui_1.bold)('\nAvailable Verticals\n'));
+        for (const v of data.verticals) {
+            console.log(`  ${(0, ui_1.cyan)(v.id.padEnd(14))} ${v.name.padEnd(30)} ${(0, ui_1.dim)(`${v.eventCount} events`)}`);
+        }
+        console.log('');
+        (0, ui_1.info)('Usage: gurulu events templates --vertical <id>');
+        return;
+    }
+    // Detail mode — specific vertical
+    console.log((0, ui_1.bold)(`\nVertical: ${data.vertical}`));
+    console.log(`Confidence: ${data.confidence}\n`);
+    if (data.events?.length) {
+        console.log((0, ui_1.bold)('Events:\n'));
+        for (const ev of data.events) {
+            console.log(`  ${(0, ui_1.green)(ev.name)} ${(0, ui_1.dim)(`[${ev.category}]`)}`);
+            console.log(`    ${(0, ui_1.dim)(ev.reasoning)}`);
+            if (ev.propertySchema?.length) {
+                for (const p of ev.propertySchema) {
+                    const req = p.required ? (0, ui_1.red)('REQUIRED') : (0, ui_1.dim)('optional');
+                    const fmt = p.format ? (0, ui_1.cyan)(` [${p.format}]`) : '';
+                    const ex = p.example !== undefined ? (0, ui_1.dim)(` e.g. ${JSON.stringify(p.example)}`) : '';
+                    console.log(`    ${p.name}: ${(0, ui_1.cyan)(p.type)} (${req})${fmt}${ex}`);
+                }
+            }
+            console.log('');
+        }
+    }
+    if (data.funnels?.length) {
+        console.log((0, ui_1.bold)('Funnels:\n'));
+        for (const f of data.funnels) {
+            console.log(`  ${(0, ui_1.yellow)(f.name)} ${(0, ui_1.dim)(`[${f.category}]`)}`);
+            console.log(`    Steps: ${f.steps.join(' → ')}`);
+            console.log(`    ${(0, ui_1.dim)(f.reasoning)}`);
+            console.log('');
+        }
+    }
+}
 function formatFrame(raw, json) {
     if (json)
         return raw;

package/dist/commands/experiments.d.ts

@@ -9,9 +9,13 @@ export interface ExperimentsArgs {
     json?: boolean;
     profile?: string;
     fromFile?: string;
+    site?: string;
+    id?: string;
     key?: string;
     name?: string;
     description?: string;
+    variants?: string;
+    goal?: string;
     yes?: boolean;
     dryRun?: boolean;
 }