@gurulu/cli 0.4.2 → 0.4.3

package/dist/commands/attribution.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Sprint E SE-B — `gurulu attribution report|compare|channels`.
+ *
+ * Mirror of MCP tools `gurulu.attribution.report` / `.compare` / `.channels`.
+ * Hits new `/api/cli/attribution/*` proxy endpoints (CLI-auth, not session-auth)
+ * so the same surface is reachable from agents and humans.
+ */
+export interface AttributionArgs {
+    action?: string;
+    site?: string;
+    from?: string;
+    to?: string;
+    range?: string;
+    model?: string;
+    baselineModel?: string;
+    variantModel?: string;
+    conversionEvent?: string;
+    format?: string;
+    json?: boolean;
+    profile?: string;
+}
+export declare function attributionCommand(args: AttributionArgs): Promise<void>;

package/dist/commands/attribution.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * Sprint E SE-B — `gurulu attribution report|compare|channels`.
+ *
+ * Mirror of MCP tools `gurulu.attribution.report` / `.compare` / `.channels`.
+ * Hits new `/api/cli/attribution/*` proxy endpoints (CLI-auth, not session-auth)
+ * so the same surface is reachable from agents and humans.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attributionCommand = attributionCommand;
+const api_client_1 = require("../api-client");
+const ui_1 = require("../utils/ui");
+async function attributionCommand(args) {
+    const action = args.action || '';
+    switch (action) {
+        case 'report':
+            return reportCmd(args);
+        case 'compare':
+            return compareCmd(args);
+        case 'channels':
+            return channelsCmd(args);
+        default:
+            (0, ui_1.error)(`Unknown attribution action: ${action}`);
+            (0, ui_1.info)('Usage: gurulu attribution [report|compare|channels] --site=<id> [...]');
+            process.exit(1);
+    }
+}
+function buildQuery(params) {
+    const usp = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        if (v === undefined || v === '' || v === null)
+            continue;
+        usp.set(k, String(v));
+    }
+    const s = usp.toString();
+    return s ? `?${s}` : '';
+}
+function emit(args, body, table) {
+    const format = args.format || (args.json ? 'json' : 'json');
+    if (format === 'table') {
+        process.stdout.write(table());
+        return;
+    }
+    process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+}
+async function reportCmd(args) {
+    if (!args.site) {
+        (0, ui_1.error)('Usage: gurulu attribution report --site=<id> [--from=ISO --to=ISO | --range=7d|30d|90d] [--model=...]');
+        process.exit(1);
+    }
+    const path = `/api/cli/attribution/report${buildQuery({
+        site: args.site,
+        from: args.from,
+        to: args.to,
+        range: args.range,
+        model: args.model,
+        conversionEvent: args.conversionEvent,
+    })}`;
+    const body = await (0, api_client_1.cliApiJson)(path, { profile: args.profile });
+    emit(args, body, () => {
+        const rows = body.results || [];
+        const out = [['CHANNEL', 'CREDIT', 'CONVERSIONS', 'REVENUE'].join('\t')];
+        for (const r of rows) {
+            out.push([r.channel ?? '-', r.credit ?? 0, r.conversions ?? 0, r.revenue ?? 0].join('\t'));
+        }
+        return out.join('\n') + '\n';
+    });
+}
+async function compareCmd(args) {
+    if (!args.site || !args.baselineModel || !args.variantModel) {
+        (0, ui_1.error)('Usage: gurulu attribution compare --site=<id> --baseline-model=<m> --variant-model=<m>');
+        process.exit(1);
+    }
+    const path = `/api/cli/attribution/compare${buildQuery({
+        site: args.site,
+        baselineModel: args.baselineModel,
+        variantModel: args.variantModel,
+        from: args.from,
+        to: args.to,
+        range: args.range,
+        conversionEvent: args.conversionEvent,
+    })}`;
+    const body = await (0, api_client_1.cliApiJson)(path, { profile: args.profile });
+    emit(args, body, () => {
+        const rows = body.comparison || body.results || [];
+        const out = [['CHANNEL', 'BASELINE', 'VARIANT', 'DELTA'].join('\t')];
+        for (const r of rows) {
+            out.push([r.channel ?? '-', r.baseline ?? 0, r.variant ?? 0, r.delta ?? 0].join('\t'));
+        }
+        return out.join('\n') + '\n';
+    });
+}
+async function channelsCmd(args) {
+    if (!args.site) {
+        (0, ui_1.error)('Usage: gurulu attribution channels --site=<id>');
+        process.exit(1);
+    }
+    const path = `/api/cli/attribution/channels${buildQuery({
+        site: args.site,
+        range: args.range,
+    })}`;
+    const body = await (0, api_client_1.cliApiJson)(path, { profile: args.profile });
+    emit(args, body, () => {
+        const rows = body.channels || [];
+        const out = [['CHANNEL', 'SESSIONS', 'CONVERSIONS'].join('\t')];
+        for (const r of rows) {
+            out.push([r.channel ?? '-', r.sessions ?? 0, r.conversions ?? 0].join('\t'));
+        }
+        return out.join('\n') + '\n';
+    });
+}

package/dist/commands/conversion-paths.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Sprint E SE-B — `gurulu conversion-paths list`.
+ *
+ * Mirror of MCP `gurulu.conversion_paths.list`. Hits new
+ * `/api/cli/conversion-paths` proxy endpoint (CLI-auth).
+ */
+export interface ConversionPathsArgs {
+    action?: string;
+    site?: string;
+    from?: string;
+    to?: string;
+    range?: string;
+    conversionEvent?: string;
+    limit?: number;
+    format?: string;
+    json?: boolean;
+    profile?: string;
+}
+export declare function conversionPathsCommand(args: ConversionPathsArgs): Promise<void>;

package/dist/commands/conversion-paths.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Sprint E SE-B — `gurulu conversion-paths list`.
+ *
+ * Mirror of MCP `gurulu.conversion_paths.list`. Hits new
+ * `/api/cli/conversion-paths` proxy endpoint (CLI-auth).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.conversionPathsCommand = conversionPathsCommand;
+const api_client_1 = require("../api-client");
+const ui_1 = require("../utils/ui");
+async function conversionPathsCommand(args) {
+    const action = args.action || 'list';
+    switch (action) {
+        case 'list':
+            return listCmd(args);
+        default:
+            (0, ui_1.error)(`Unknown conversion-paths action: ${action}`);
+            (0, ui_1.info)('Usage: gurulu conversion-paths list --site=<id> [--range=30d] [--limit=20]');
+            process.exit(1);
+    }
+}
+async function listCmd(args) {
+    if (!args.site) {
+        (0, ui_1.error)('Usage: gurulu conversion-paths list --site=<id> [--range=30d] [--limit=20]');
+        process.exit(1);
+    }
+    const usp = new URLSearchParams();
+    usp.set('site', args.site);
+    if (args.from)
+        usp.set('from', args.from);
+    if (args.to)
+        usp.set('to', args.to);
+    if (args.range)
+        usp.set('range', args.range);
+    if (args.conversionEvent)
+        usp.set('conversionEvent', args.conversionEvent);
+    if (args.limit)
+        usp.set('limit', String(args.limit));
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/conversion-paths?${usp.toString()}`, {
+        profile: args.profile,
+    });
+    if (args.format === 'table') {
+        const rows = body.paths || [];
+        process.stdout.write(['PATH', 'CONVERSIONS', 'REVENUE'].join('\t') + '\n');
+        for (const p of rows) {
+            const path = Array.isArray(p.path)
+                ? p.path.join(' → ')
+                : String(p.path ?? '-');
+            process.stdout.write([path.slice(0, 80), p.conversions ?? 0, p.revenue ?? 0].join('\t') + '\n');
+        }
+        return;
+    }
+    process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+}

package/dist/commands/errors.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Sprint E SE-B — `gurulu errors list|detail|resolve|mute`.
+ *
+ * Mirror of MCP `gurulu.errors.list` / `.detail` plus two new write tools
+ * (`.resolve`, `.mute`). Hits new `/api/cli/errors/*` proxy endpoints which
+ * use CLI-auth instead of the session-auth used by `/api/analytics/error-groups`.
+ *
+ * Note: `gurulu errors upload-sourcemap` and `upload-native-symbols` are
+ * documented aliases of `gurulu sourcemap upload [--platform=...]` — see
+ * `commands/sourcemap.ts`.
+ */
+export interface ErrorsArgs {
+    action?: string;
+    site?: string;
+    fingerprint?: string;
+    level?: string;
+    resolved?: string;
+    environment?: string;
+    releaseId?: string;
+    limit?: number;
+    duration?: string;
+    format?: string;
+    json?: boolean;
+    yes?: boolean;
+    profile?: string;
+}
+export declare function errorsCommand(args: ErrorsArgs): Promise<void>;

package/dist/commands/errors.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Sprint E SE-B — `gurulu errors list|detail|resolve|mute`.
+ *
+ * Mirror of MCP `gurulu.errors.list` / `.detail` plus two new write tools
+ * (`.resolve`, `.mute`). Hits new `/api/cli/errors/*` proxy endpoints which
+ * use CLI-auth instead of the session-auth used by `/api/analytics/error-groups`.
+ *
+ * Note: `gurulu errors upload-sourcemap` and `upload-native-symbols` are
+ * documented aliases of `gurulu sourcemap upload [--platform=...]` — see
+ * `commands/sourcemap.ts`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorsCommand = errorsCommand;
+const api_client_1 = require("../api-client");
+const ui_1 = require("../utils/ui");
+const confirm_1 = require("../utils/confirm");
+async function errorsCommand(args) {
+    const action = args.action || '';
+    switch (action) {
+        case 'list':
+            return listCmd(args);
+        case 'detail':
+            return detailCmd(args);
+        case 'resolve':
+            return resolveCmd(args);
+        case 'mute':
+            return muteCmd(args);
+        case 'upload-sourcemap':
+        case 'upload-native-symbols':
+            (0, ui_1.info)('Use `gurulu sourcemap upload [--platform=ios|android|web|server] ...` — these names are aliases.');
+            return;
+        default:
+            (0, ui_1.error)(`Unknown errors action: ${action}`);
+            (0, ui_1.info)('Usage: gurulu errors [list|detail|resolve|mute] --site=<id> [--fingerprint=<hash>] ...');
+            process.exit(1);
+    }
+}
+async function listCmd(args) {
+    if (!args.site) {
+        (0, ui_1.error)('Usage: gurulu errors list --site=<id> [--level=error|warning] [--resolved=false] [--limit=20]');
+        process.exit(1);
+    }
+    const usp = new URLSearchParams();
+    usp.set('site', args.site);
+    if (args.level)
+        usp.set('level', args.level);
+    if (args.resolved !== undefined)
+        usp.set('resolved', args.resolved);
+    if (args.environment)
+        usp.set('environment', args.environment);
+    if (args.releaseId)
+        usp.set('releaseId', args.releaseId);
+    if (args.limit)
+        usp.set('limit', String(args.limit));
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/errors?${usp.toString()}`, {
+        profile: args.profile,
+    });
+    if (args.format === 'table') {
+        const rows = body.groups || [];
+        process.stdout.write(['FINGERPRINT', 'COUNT', 'LEVEL', 'STATUS', 'TITLE'].join('\t') + '\n');
+        for (const g of rows) {
+            process.stdout.write([
+                (g.fingerprint || '').slice(0, 16),
+                g.count ?? 0,
+                g.level ?? '-',
+                g.status ?? 'unresolved',
+                String(g.title || '-').slice(0, 80),
+            ].join('\t') + '\n');
+        }
+        return;
+    }
+    process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+}
+async function detailCmd(args) {
+    if (!args.site || !args.fingerprint) {
+        (0, ui_1.error)('Usage: gurulu errors detail --site=<id> --fingerprint=<hash>');
+        process.exit(1);
+    }
+    const path = `/api/cli/errors/${encodeURIComponent(args.fingerprint)}?site=${encodeURIComponent(args.site)}`;
+    const body = await (0, api_client_1.cliApiJson)(path, { profile: args.profile });
+    process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+}
+async function resolveCmd(args) {
+    if (!args.site || !args.fingerprint) {
+        (0, ui_1.error)('Usage: gurulu errors resolve --site=<id> --fingerprint=<hash>');
+        process.exit(1);
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`Mark error ${args.fingerprint.slice(0, 12)} as resolved?`, { yes: args.yes, defaultYes: true });
+    if (!ok) {
+        (0, ui_1.info)('Aborted.');
+        return;
+    }
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/errors/${encodeURIComponent(args.fingerprint)}/resolve`, {
+        profile: args.profile,
+        method: 'POST',
+        json: { siteId: args.site },
+    });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Resolved ${args.fingerprint.slice(0, 12)}.`);
+}
+async function muteCmd(args) {
+    if (!args.site || !args.fingerprint) {
+        (0, ui_1.error)('Usage: gurulu errors mute --site=<id> --fingerprint=<hash> [--duration=24h]');
+        process.exit(1);
+    }
+    const duration = args.duration || '24h';
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/errors/${encodeURIComponent(args.fingerprint)}/mute`, {
+        profile: args.profile,
+        method: 'POST',
+        json: { siteId: args.site, duration },
+    });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Muted ${args.fingerprint.slice(0, 12)} for ${duration}.`);
+}

package/dist/commands/identity.d.ts

@@ -1,5 +1,8 @@
 /**
  * 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;
@@ -7,6 +10,16 @@ export interface IdentityArgs {
     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;
 }

package/dist/commands/identity.js

@@ -1,6 +1,9 @@
 "use strict";
 /**
  * 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`).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.identityCommand = identityCommand;
@@ -15,9 +18,15 @@ async function identityCommand(args) {
             return transfersCmd(args);
         case 'cdc-sources':
             return cdcSourcesCmd(args);
+        case 'identify':
+            return identifyCmd(args);
+        case 'alias':
+            return aliasCmd(args);
+        case 'merge':
+            return mergeCmd(args);
         default:
             (0, ui_1.error)(`Unknown identity action: ${action}`);
-            (0, ui_1.info)('Usage: gurulu identity [decay stats|transfers list|cdc-sources list]');
+            (0, ui_1.info)('Usage: gurulu identity [decay stats|transfers list|cdc-sources list|identify|alias|merge]');
             process.exit(1);
     }
 }
@@ -76,6 +85,81 @@ async function transfersCmd(args) {
         ].join('\t') + '\n');
     }
 }
+async function identifyCmd(args) {
+    if (!args.site || !args.userId) {
+        (0, ui_1.error)('Usage: gurulu identity identify --site=<id> --user-id=<id> [--email=...] [--phone=...] [--traits=<json>]');
+        process.exit(1);
+    }
+    let traits;
+    if (args.traits) {
+        try {
+            traits = JSON.parse(args.traits);
+        }
+        catch {
+            (0, ui_1.error)('--traits must be valid JSON');
+            process.exit(1);
+        }
+    }
+    const body = await (0, api_client_1.cliApiJson)('/api/cli/identity/identify', {
+        profile: args.profile,
+        method: 'POST',
+        json: {
+            siteId: args.site,
+            userId: args.userId,
+            email: args.email,
+            phone: args.phone,
+            traits,
+        },
+    });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Identified ${args.userId}.`);
+    if (body.canonicalPersonId) {
+        process.stdout.write(`  canonicalPersonId: ${body.canonicalPersonId}\n`);
+    }
+}
+async function aliasCmd(args) {
+    if (!args.site || !args.previousUserId || !args.newUserId) {
+        (0, ui_1.error)('Usage: gurulu identity alias --site=<id> --previous-user-id=<anon> --new-user-id=<u123>');
+        process.exit(1);
+    }
+    const body = await (0, api_client_1.cliApiJson)('/api/cli/identity/alias', {
+        profile: args.profile,
+        method: 'POST',
+        json: {
+            siteId: args.site,
+            previousUserId: args.previousUserId,
+            newUserId: args.newUserId,
+        },
+    });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Aliased ${args.previousUserId} → ${args.newUserId}.`);
+}
+async function mergeCmd(args) {
+    if (!args.site || !args.canonicalId || !args.duplicateId) {
+        (0, ui_1.error)('Usage: gurulu identity merge --site=<id> --canonical-id=<winner> --duplicate-id=<loser>');
+        process.exit(1);
+    }
+    const body = await (0, api_client_1.cliApiJson)('/api/cli/identity/merge', {
+        profile: args.profile,
+        method: 'POST',
+        json: {
+            siteId: args.site,
+            canonicalId: args.canonicalId,
+            duplicateId: args.duplicateId,
+        },
+    });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Merged ${args.duplicateId} → ${args.canonicalId}.`);
+}
 async function cdcSourcesCmd(args) {
     if (args.sub && args.sub !== 'list') {
         (0, ui_1.error)(`Unknown identity cdc-sources sub: ${args.sub}`);

package/dist/commands/init.js

@@ -22,7 +22,7 @@ async function initCommand(args) {
     if (!args.framework && !args.noInteractive && framework === 'unknown') {
         console.log('');
         (0, ui_1.warn)('Could not auto-detect framework.');
-        const frameworks = ['nextjs-app', 'nextjs-pages', 'react-vite', 'react-cra', 'vue3', 'nuxt3', 'svelte', 'sveltekit', 'astro', 'express', 'nestjs', 'react-native', 'ios-swift', 'android-kotlin', 'flutter', 'html'];
+        const frameworks = ['nextjs-app', 'nextjs-pages', 'react-vite', 'react-cra', 'vue3', 'nuxt3', 'svelte', 'sveltekit', 'astro', 'express', 'fastify', 'hono', 'nestjs', 'react-native', 'ios-swift', 'android-kotlin', 'flutter', 'html'];
         const idx = await (0, ui_1.promptSelect)('  Select your framework: ', frameworks.map(f => (0, detect_1.getFrameworkDisplayName)(f)));
         framework = frameworks[idx];
         (0, ui_1.info)(`Using: ${(0, ui_1.bold)((0, detect_1.getFrameworkDisplayName)(framework))}`);

package/dist/commands/install.d.ts

@@ -46,7 +46,10 @@ export interface InstallArgs {
      * up with `// TODO: <prop>` placeholders. See Sprint A fix A2.
      */
     authToken?: string;
+    /** Sprint E1.5 — explicit workspace path inside an npm/pnpm/yarn workspace repo. */
+    workspace?: string;
 }
+export declare function resolveWorkspaceRoot(repoRoot: string, args: InstallArgs, deps: InstallDeps): Promise<string>;
 export interface IntentPreSeedResult {
     ok: boolean;
     proposalId?: string;
@@ -151,6 +154,8 @@ export interface InstallSummary {
     verify: VerifyResult | null;
     rolledBack: boolean;
     errors: string[];
+    partiallyInstalled?: boolean;
+    installedComponents?: string[];
     intent?: {
         skipped: boolean;
         dryRun: boolean;