@gurulu/cli 0.4.0 → 0.4.2

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;
 }

package/dist/commands/experiments.js

@@ -36,7 +36,8 @@ async function experimentsCommand(args) {
     }
 }
 async function listCmd(args) {
-    const body = await (0, api_client_1.cliApiJson)('/api/cli/experiments', {
+    const qs = args.site ? `?siteId=${encodeURIComponent(args.site)}` : '';
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/experiments${qs}`, {
         profile: args.profile,
     });
     if (args.json) {
@@ -109,14 +110,31 @@ 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.key)
         payload.key = args.key;
     if (args.name)
         payload.name = args.name;
     if (args.description !== undefined)
         payload.description = args.description;
-    if (!payload.key || !payload.name || !Array.isArray(payload.variants)) {
-        (0, ui_1.error)('key, name, and variants[] are required.');
+    if (args.goal)
+        payload.goalId = args.goal;
+    if (args.variants) {
+        try {
+            payload.variants = JSON.parse(args.variants);
+        }
+        catch {
+            (0, ui_1.error)('--variants must be valid JSON');
+            process.exit(1);
+        }
+    }
+    if (!payload.name || !Array.isArray(payload.variants)) {
+        (0, ui_1.error)('name and variants[] are required (pass --name --variants \'[...]\' or --from-file).');
+        process.exit(1);
+    }
+    if (!payload.siteId) {
+        (0, ui_1.error)('site is required (pass --site)');
         process.exit(1);
     }
     if (args.dryRun) {
@@ -146,8 +164,9 @@ async function createCmd(args) {
     (0, ui_1.success)(`Created experiment ${body.experiment?.key ?? ''}`);
 }
 async function updateCmd(args) {
-    if (!args.target) {
-        (0, ui_1.error)('Usage: gurulu experiments update <key>');
+    const resolveTarget = args.id || args.target;
+    if (!resolveTarget) {
+        (0, ui_1.error)('Usage: gurulu experiments update <key> [--id ...] [--name ...] [--variants ...]');
         process.exit(1);
     }
     let payload = {};
@@ -157,39 +176,51 @@ async function updateCmd(args) {
         payload.name = args.name;
     if (args.description !== undefined)
         payload.description = args.description;
+    if (args.goal)
+        payload.goalId = args.goal;
+    if (args.variants) {
+        try {
+            payload.variants = JSON.parse(args.variants);
+        }
+        catch {
+            (0, ui_1.error)('--variants must be valid JSON');
+            process.exit(1);
+        }
+    }
     if (args.dryRun) {
-        const body = await (0, api_client_1.cliApiJson)(`/api/cli/experiments/${encodeURIComponent(args.target)}?dryRun=1`, { profile: args.profile, method: 'PATCH', json: payload });
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/experiments/${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 experiment '${args.target}'?`, {
+    const ok = await (0, confirm_1.promptConfirm)(`Update experiment '${resolveTarget}'?`, {
         yes: args.yes,
         defaultYes: true,
     });
     if (!ok)
         return (0, ui_1.info)('Aborted.');
-    const body = await (0, api_client_1.cliApiJson)(`/api/cli/experiments/${encodeURIComponent(args.target)}`, { profile: args.profile, method: 'PATCH', json: payload });
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/experiments/${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 experiment ${args.target}`);
+    (0, ui_1.success)(`Updated experiment ${resolveTarget}`);
 }
 async function deleteCmd(args) {
-    if (!args.target) {
-        (0, ui_1.error)('Usage: gurulu experiments delete <key>');
+    const resolveTarget = args.id || args.target;
+    if (!resolveTarget) {
+        (0, ui_1.error)('Usage: gurulu experiments delete <key> [--id ...]');
         process.exit(1);
     }
     if (args.dryRun) {
-        const body = await (0, api_client_1.cliApiJson)(`/api/cli/experiments/${encodeURIComponent(args.target)}?dryRun=1`, { profile: args.profile, method: 'DELETE' });
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/experiments/${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 experiment '${args.target}'. Continue?`, { yes: args.yes, defaultYes: false });
+    const ok = await (0, confirm_1.promptConfirm)(`About to delete experiment '${resolveTarget}'. Continue?`, { yes: args.yes, defaultYes: false });
     if (!ok)
         return (0, ui_1.info)('Aborted.');
-    await (0, api_client_1.cliApiJson)(`/api/cli/experiments/${encodeURIComponent(args.target)}`, { profile: args.profile, method: 'DELETE' });
-    (0, ui_1.success)(`Deleted experiment ${args.target}`);
+    await (0, api_client_1.cliApiJson)(`/api/cli/experiments/${encodeURIComponent(resolveTarget)}`, { profile: args.profile, method: 'DELETE' });
+    (0, ui_1.success)(`Deleted experiment ${resolveTarget}`);
 }
 async function startCmd(args) {
     if (!args.target) {

package/dist/commands/funnels.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `gurulu funnels list|show|create|update|delete` — manage conversion funnels.
+ */
+export interface FunnelsArgs {
+    action?: string;
+    target?: string;
+    json?: boolean;
+    profile?: string;
+    fromFile?: string;
+    site?: string;
+    name?: string;
+    description?: string;
+    steps?: string;
+    yes?: boolean;
+    dryRun?: boolean;
+}
+export declare function funnelsCommand(args: FunnelsArgs): Promise<void>;