@gurulu/cli 0.3.4 → 0.4.1

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

package/dist/commands/funnels.js

@@ -0,0 +1,203 @@
+"use strict";
+/**
+ * `gurulu funnels list|show|create|update|delete` — manage conversion funnels.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.funnelsCommand = funnelsCommand;
+const api_client_1 = require("../api-client");
+const ui_1 = require("../utils/ui");
+const confirm_1 = require("../utils/confirm");
+const dry_run_1 = require("../utils/dry-run");
+const from_file_1 = require("../utils/from-file");
+async function funnelsCommand(args) {
+    const action = args.action || 'list';
+    switch (action) {
+        case 'list':
+            return listCmd(args);
+        case 'show':
+            return showCmd(args);
+        case 'create':
+            return createCmd(args);
+        case 'update':
+            return updateCmd(args);
+        case 'delete':
+            return deleteCmd(args);
+        default:
+            (0, ui_1.error)(`Unknown funnels action: ${action}`);
+            (0, ui_1.info)('Usage: gurulu funnels [list|show|create|update|delete]');
+            process.exit(1);
+    }
+}
+function parseSteps(stepsStr) {
+    return stepsStr
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .map((event_name) => ({ event_name }));
+}
+async function listCmd(args) {
+    const qs = args.site ? `?siteId=${encodeURIComponent(args.site)}` : '';
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/funnels${qs}`, {
+        profile: args.profile,
+    });
+    const funnels = body.funnels || [];
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    if (funnels.length === 0) {
+        (0, ui_1.info)('No funnels yet.');
+        return;
+    }
+    process.stdout.write(['NAME', 'ID', 'STEPS', 'STATUS', 'UPDATED'].join('\t') + '\n');
+    for (const f of funnels) {
+        const stepCount = Array.isArray(f.steps) ? f.steps.length : 0;
+        process.stdout.write([
+            f.name,
+            f.id,
+            String(stepCount),
+            f.status,
+            String(f.updatedAt || '-').slice(0, 19),
+        ].join('\t') + '\n');
+    }
+}
+async function showCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu funnels show <id>');
+        process.exit(1);
+    }
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/funnels/${encodeURIComponent(args.target)}`, { profile: args.profile });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    const f = body.funnel;
+    const steps = Array.isArray(f.steps) ? f.steps : [];
+    process.stdout.write(`Name:        ${f.name}\n`);
+    process.stdout.write(`ID:          ${f.id}\n`);
+    process.stdout.write(`Site:        ${f.siteId}\n`);
+    process.stdout.write(`Description: ${f.description || '-'}\n`);
+    process.stdout.write(`Status:      ${f.status}\n`);
+    process.stdout.write(`Steps (${steps.length}):\n`);
+    for (let i = 0; i < steps.length; i++) {
+        const s = steps[i];
+        const label = s.label || s.event_name || s.eventName || '-';
+        process.stdout.write(`  ${i + 1}. ${label}\n`);
+    }
+    if (f.cachedMetrics) {
+        const m = f.cachedMetrics;
+        process.stdout.write(`Overall rate: ${m.overallRate ?? '-'}\n`);
+        process.stdout.write(`Computed at:  ${m.computedAt || f.lastComputedAt || '-'}\n`);
+    }
+    process.stdout.write(`Updated:     ${f.updatedAt}\n`);
+}
+async function createCmd(args) {
+    let payload = {};
+    if (args.fromFile) {
+        payload = (0, from_file_1.loadFromFile)(args.fromFile);
+    }
+    if (args.name)
+        payload.name = args.name;
+    if (args.site)
+        payload.siteId = args.site;
+    if (args.steps)
+        payload.steps = parseSteps(args.steps);
+    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 (!Array.isArray(payload.steps) || payload.steps.length < 2) {
+        (0, ui_1.error)('At least 2 steps are required (pass --steps as comma-separated event names)');
+        process.exit(1);
+    }
+    const qs = args.dryRun ? '?dryRun=1' : '';
+    if (args.dryRun) {
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/funnels${qs}`, {
+            profile: args.profile,
+            method: 'POST',
+            json: payload,
+        });
+        (0, dry_run_1.printDryRun)(body, args.json);
+        return;
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`Create funnel '${payload.name}'?`, {
+        yes: args.yes,
+        defaultYes: true,
+    });
+    if (!ok) {
+        (0, ui_1.info)('Aborted.');
+        return;
+    }
+    const body = await (0, api_client_1.cliApiJson)('/api/cli/funnels', {
+        profile: args.profile,
+        method: 'POST',
+        json: payload,
+    });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Created funnel ${body.funnel?.id ?? ''}`);
+}
+async function updateCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu funnels update <id> [--name ...] [--steps ...]');
+        process.exit(1);
+    }
+    let payload = {};
+    if (args.fromFile) {
+        payload = (0, from_file_1.loadFromFile)(args.fromFile);
+    }
+    if (args.name)
+        payload.name = args.name;
+    if (args.description !== undefined)
+        payload.description = args.description;
+    if (args.steps)
+        payload.steps = parseSteps(args.steps);
+    const qs = args.dryRun ? '?dryRun=1' : '';
+    if (args.dryRun) {
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/funnels/${encodeURIComponent(args.target)}${qs}`, { profile: args.profile, method: 'PUT', json: payload });
+        (0, dry_run_1.printDryRun)(body, args.json);
+        return;
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`Update funnel '${args.target}'?`, {
+        yes: args.yes,
+        defaultYes: true,
+    });
+    if (!ok) {
+        (0, ui_1.info)('Aborted.');
+        return;
+    }
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/funnels/${encodeURIComponent(args.target)}`, { profile: args.profile, method: 'PUT', json: payload });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Updated funnel ${args.target}`);
+}
+async function deleteCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu funnels delete <id>');
+        process.exit(1);
+    }
+    const qs = args.dryRun ? '?dryRun=1' : '';
+    if (args.dryRun) {
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/funnels/${encodeURIComponent(args.target)}${qs}`, { profile: args.profile, method: 'DELETE' });
+        (0, dry_run_1.printDryRun)(body, args.json);
+        return;
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`About to delete funnel '${args.target}'. Continue?`, { yes: args.yes, defaultYes: false });
+    if (!ok) {
+        (0, ui_1.info)('Aborted.');
+        return;
+    }
+    await (0, api_client_1.cliApiJson)(`/api/cli/funnels/${encodeURIComponent(args.target)}`, {
+        profile: args.profile,
+        method: 'DELETE',
+    });
+    (0, ui_1.success)(`Deleted funnel ${args.target}`);
+}

package/dist/commands/goals.d.ts

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

package/dist/commands/goals.js

@@ -0,0 +1,214 @@
+"use strict";
+/**
+ * `gurulu goals list|show|create|update|delete` — manage conversion goals.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.goalsCommand = goalsCommand;
+const api_client_1 = require("../api-client");
+const ui_1 = require("../utils/ui");
+const confirm_1 = require("../utils/confirm");
+const dry_run_1 = require("../utils/dry-run");
+const from_file_1 = require("../utils/from-file");
+async function goalsCommand(args) {
+    const action = args.action || 'list';
+    switch (action) {
+        case 'list':
+            return listCmd(args);
+        case 'show':
+            return showCmd(args);
+        case 'create':
+            return createCmd(args);
+        case 'update':
+            return updateCmd(args);
+        case 'delete':
+            return deleteCmd(args);
+        default:
+            (0, ui_1.error)(`Unknown goals action: ${action}`);
+            (0, ui_1.info)('Usage: gurulu goals [list|show|create|update|delete]');
+            process.exit(1);
+    }
+}
+async function listCmd(args) {
+    const qs = args.site ? `?siteId=${encodeURIComponent(args.site)}` : '';
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/goals${qs}`, {
+        profile: args.profile,
+    });
+    const goals = body.goals || [];
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    if (goals.length === 0) {
+        (0, ui_1.info)('No goals yet.');
+        return;
+    }
+    process.stdout.write(['NAME', 'ID', 'EVENT', 'STATUS', 'CONVERSIONS', 'UPDATED'].join('\t') + '\n');
+    for (const g of goals) {
+        const eventName = g.eventPattern?.event_name || '-';
+        process.stdout.write([
+            g.name,
+            g.id,
+            String(eventName),
+            g.status,
+            String(g.totalConversions ?? 0),
+            String(g.updatedAt || '-').slice(0, 19),
+        ].join('\t') + '\n');
+    }
+}
+async function showCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu goals show <id>');
+        process.exit(1);
+    }
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/goals/${encodeURIComponent(args.target)}`, { profile: args.profile });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    const g = body.goal;
+    const eventName = g.eventPattern?.event_name || '-';
+    const propsFilter = g.eventPattern?.properties_filter || null;
+    process.stdout.write(`Name:              ${g.name}\n`);
+    process.stdout.write(`ID:                ${g.id}\n`);
+    process.stdout.write(`Site:              ${g.siteId}\n`);
+    process.stdout.write(`Description:       ${g.description || '-'}\n`);
+    process.stdout.write(`Event:             ${eventName}\n`);
+    process.stdout.write(`Properties filter: ${propsFilter ? JSON.stringify(propsFilter) : '-'}\n`);
+    process.stdout.write(`Status:            ${g.status}\n`);
+    process.stdout.write(`Conversions:       ${g.totalConversions}\n`);
+    process.stdout.write(`Last converted:    ${g.lastConvertedAt || '-'}\n`);
+    process.stdout.write(`Updated:           ${g.updatedAt}\n`);
+}
+async function createCmd(args) {
+    let payload = {};
+    if (args.fromFile) {
+        payload = (0, from_file_1.loadFromFile)(args.fromFile);
+    }
+    if (args.name)
+        payload.name = args.name;
+    if (args.site)
+        payload.siteId = args.site;
+    // Build eventPattern from --event and --properties-filter
+    const eventPattern = payload.eventPattern || {};
+    if (args.event)
+        eventPattern.event_name = args.event;
+    if (args.propertiesFilter) {
+        try {
+            eventPattern.properties_filter = JSON.parse(args.propertiesFilter);
+        }
+        catch {
+            (0, ui_1.error)('--properties-filter must be valid JSON');
+            process.exit(1);
+        }
+    }
+    if (Object.keys(eventPattern).length > 0)
+        payload.eventPattern = eventPattern;
+    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/goals${qs}`, {
+            profile: args.profile,
+            method: 'POST',
+            json: payload,
+        });
+        (0, dry_run_1.printDryRun)(body, args.json);
+        return;
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`Create goal '${payload.name}'?`, {
+        yes: args.yes,
+        defaultYes: true,
+    });
+    if (!ok) {
+        (0, ui_1.info)('Aborted.');
+        return;
+    }
+    const body = await (0, api_client_1.cliApiJson)('/api/cli/goals', {
+        profile: args.profile,
+        method: 'POST',
+        json: payload,
+    });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Created goal ${body.goal?.id ?? ''}`);
+}
+async function updateCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu goals update <id> [--name ...] [--event ...]');
+        process.exit(1);
+    }
+    let payload = {};
+    if (args.fromFile) {
+        payload = (0, from_file_1.loadFromFile)(args.fromFile);
+    }
+    if (args.name)
+        payload.name = args.name;
+    if (args.description !== undefined)
+        payload.description = args.description;
+    // Build eventPattern if --event or --properties-filter provided
+    if (args.event || args.propertiesFilter) {
+        const eventPattern = payload.eventPattern || {};
+        if (args.event)
+            eventPattern.event_name = args.event;
+        if (args.propertiesFilter) {
+            try {
+                eventPattern.properties_filter = JSON.parse(args.propertiesFilter);
+            }
+            catch {
+                (0, ui_1.error)('--properties-filter must be valid JSON');
+                process.exit(1);
+            }
+        }
+        payload.eventPattern = eventPattern;
+    }
+    const qs = args.dryRun ? '?dryRun=1' : '';
+    if (args.dryRun) {
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/goals/${encodeURIComponent(args.target)}${qs}`, { profile: args.profile, method: 'PUT', json: payload });
+        (0, dry_run_1.printDryRun)(body, args.json);
+        return;
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`Update goal '${args.target}'?`, {
+        yes: args.yes,
+        defaultYes: true,
+    });
+    if (!ok) {
+        (0, ui_1.info)('Aborted.');
+        return;
+    }
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/goals/${encodeURIComponent(args.target)}`, { profile: args.profile, method: 'PUT', json: payload });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Updated goal ${args.target}`);
+}
+async function deleteCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu goals delete <id>');
+        process.exit(1);
+    }
+    const qs = args.dryRun ? '?dryRun=1' : '';
+    if (args.dryRun) {
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/goals/${encodeURIComponent(args.target)}${qs}`, { profile: args.profile, method: 'DELETE' });
+        (0, dry_run_1.printDryRun)(body, args.json);
+        return;
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`About to delete goal '${args.target}'. Continue?`, { yes: args.yes, defaultYes: false });
+    if (!ok) {
+        (0, ui_1.info)('Aborted.');
+        return;
+    }
+    await (0, api_client_1.cliApiJson)(`/api/cli/goals/${encodeURIComponent(args.target)}`, {
+        profile: args.profile,
+        method: 'DELETE',
+    });
+    (0, ui_1.success)(`Deleted goal ${args.target}`);
+}

package/dist/commands/install.d.ts

@@ -38,6 +38,14 @@ export interface InstallArgs {
     autoProperties?: boolean;
     /** Internal: path to the serialized intent JSON forwarded to the agentic-install script. */
     intentResultPath?: string;
+    /**
+     * Internal: API token (active profile secret key) forwarded to the
+     * agentic-install script as `--token`. The script's `tryLlmExtraction`
+     * needs this to call the LLM property-extraction endpoint; without it
+     * extraction silently 401s and every injected `gurulu.track(...)` ends
+     * up with `// TODO: <prop>` placeholders. See Sprint A fix A2.
+     */
+    authToken?: string;
 }
 export interface IntentPreSeedResult {
     ok: boolean;