@gurulu/cli 0.4.6 → 1.0.0

package/dist/commands/funnels.js

@@ -1,203 +0,0 @@
-"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

@@ -1,18 +0,0 @@
-/**
- * `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

@@ -1,214 +0,0 @@
-"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/heatmap.d.ts

@@ -1,27 +0,0 @@
-/**
- * Sprint J-Heat HM10 — `gurulu heatmap ...` subcommands.
- *
- * Read-only surface backed by `/api/cli/heatmap/list` and
- * `/api/cli/heatmap/get`. Lets agents and operators inspect heatmap
- * snapshots without opening the dashboard.
- *
- *   gurulu heatmap list   --site <id|name>           [--range 7d|30d] [--json]
- *   gurulu heatmap export --site <id|name> --page <pageUrl>
- *                                                    [--type click|scroll]
- *                                                    [--range 7d|30d]
- *                                                    [--viewport mobile|tablet|desktop]
- *                                                    [--page-id <hash>]
- *                                                    [--json]
- */
-export interface HeatmapArgs {
-    action?: string;
-    site?: string;
-    page?: string;
-    pageId?: string;
-    type?: string;
-    range?: string;
-    viewport?: string;
-    json?: boolean;
-    profile?: string;
-}
-export declare function heatmapCommand(args: HeatmapArgs): Promise<void>;

package/dist/commands/heatmap.js

@@ -1,112 +0,0 @@
-"use strict";
-/**
- * Sprint J-Heat HM10 — `gurulu heatmap ...` subcommands.
- *
- * Read-only surface backed by `/api/cli/heatmap/list` and
- * `/api/cli/heatmap/get`. Lets agents and operators inspect heatmap
- * snapshots without opening the dashboard.
- *
- *   gurulu heatmap list   --site <id|name>           [--range 7d|30d] [--json]
- *   gurulu heatmap export --site <id|name> --page <pageUrl>
- *                                                    [--type click|scroll]
- *                                                    [--range 7d|30d]
- *                                                    [--viewport mobile|tablet|desktop]
- *                                                    [--page-id <hash>]
- *                                                    [--json]
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.heatmapCommand = heatmapCommand;
-const api_client_1 = require("../api-client");
-const ui_1 = require("../utils/ui");
-async function resolveSiteId(target, profile) {
-    if (!target)
-        throw new Error('--site is required');
-    const body = await (0, api_client_1.cliApiJson)('/api/cli/sites', { profile });
-    const sites = body.sites || [];
-    const byId = sites.find((s) => s.id === target);
-    if (byId)
-        return byId.id;
-    const byName = sites.find((s) => s.name === target);
-    if (byName)
-        return byName.id;
-    const byDomain = sites.find((s) => s.domain === target);
-    if (byDomain)
-        return byDomain.id;
-    const prefix = sites.find((s) => s.id.startsWith(target));
-    if (prefix)
-        return prefix.id;
-    throw new Error(`Site '${target}' not found.`);
-}
-async function heatmapCommand(args) {
-    const action = args.action || 'list';
-    switch (action) {
-        case 'list':
-            return listCmd(args);
-        case 'export':
-            return exportCmd(args);
-        default:
-            (0, ui_1.error)(`Unknown heatmap action: ${action}`);
-            (0, ui_1.info)('Usage: gurulu heatmap [list|export]');
-            process.exit(1);
-    }
-}
-async function listCmd(args) {
-    if (!args.site) {
-        (0, ui_1.error)('--site is required.');
-        process.exit(1);
-    }
-    const siteId = await resolveSiteId(args.site, args.profile);
-    const range = args.range === '30d' ? '30d' : '7d';
-    const body = await (0, api_client_1.cliApiJson)(`/api/cli/heatmap/list?siteId=${encodeURIComponent(siteId)}&range=${range}`, {
-        profile: args.profile,
-    });
-    if (args.json) {
-        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
-        return;
-    }
-    const pages = body.pages || [];
-    if (pages.length === 0) {
-        (0, ui_1.info)(`No heatmap data for site '${body.siteName}' (range=${range}).`);
-        return;
-    }
-    process.stdout.write(['CLICKS', 'VISITORS', 'M/T/D', 'LAST SEEN', 'PAGE URL'].join('\t') + '\n');
-    for (const p of pages) {
-        const mtd = `${p.viewportBuckets.mobile}/${p.viewportBuckets.tablet}/${p.viewportBuckets.desktop}`;
-        process.stdout.write([
-            String(p.clickCount),
-            String(p.visitors),
-            mtd,
-            String(p.lastSeen).slice(0, 19),
-            p.pageUrl,
-        ].join('\t') + '\n');
-    }
-}
-async function exportCmd(args) {
-    if (!args.site) {
-        (0, ui_1.error)('--site is required.');
-        process.exit(1);
-    }
-    if (!args.page) {
-        (0, ui_1.error)('--page <pageUrl> is required.');
-        process.exit(1);
-    }
-    const siteId = await resolveSiteId(args.site, args.profile);
-    const range = args.range === '30d' ? '30d' : '7d';
-    const type = args.type === 'scroll' ? 'scroll' : 'click';
-    const qp = new URLSearchParams({
-        siteId,
-        pageUrl: args.page,
-        range,
-        type,
-    });
-    if (args.pageId)
-        qp.set('pageId', args.pageId);
-    if (args.viewport)
-        qp.set('viewportBucket', args.viewport);
-    const body = await (0, api_client_1.cliApiJson)(`/api/cli/heatmap/get?${qp.toString()}`, {
-        profile: args.profile,
-    });
-    // Export commands always emit machine-readable output by default; the
-    // `--json` flag is accepted for symmetry with the rest of the CLI.
-    process.stdout.write(JSON.stringify(body, null, args.json ? 2 : 0) + '\n');
-}

package/dist/commands/identity.d.ts

@@ -1,29 +0,0 @@
-/**
- * Phase 19.5 W2 B8 — `gurulu identity decay|transfers|cdc-sources`.
- *
- * Sprint E SE-D — `gurulu identity identify|alias|merge` write surface
- * (mirrors MCP `gurulu.identity.identify` / `.alias` / `.merge`).
- */
-export interface IdentityArgs {
-    action?: string;
-    sub?: string;
-    direction?: string;
-    status?: string;
-    limit?: number;
-    site?: string;
-    userId?: string;
-    email?: string;
-    phone?: string;
-    traits?: string;
-    previousUserId?: string;
-    newUserId?: string;
-    canonicalId?: string;
-    duplicateId?: string;
-    yes?: boolean;
-    json?: boolean;
-    profile?: string;
-    file?: string;
-    format?: string;
-    resumeFrom?: number;
-}
-export declare function identityCommand(args: IdentityArgs): Promise<void>;