@gurulu/cli 0.1.0

package/dist/commands/experiments.js

@@ -0,0 +1,233 @@
+"use strict";
+/**
+ * Phase 19.5 W2 B7 — `gurulu experiments list|show|results`.
+ * Phase 20  W2 B4 — `create|update|delete|start|stop`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.experimentsCommand = experimentsCommand;
+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 experimentsCommand(args) {
+    const action = args.action || 'list';
+    switch (action) {
+        case 'list':
+            return listCmd(args);
+        case 'show':
+            return showCmd(args);
+        case 'results':
+            return resultsCmd(args);
+        case 'create':
+            return createCmd(args);
+        case 'update':
+            return updateCmd(args);
+        case 'delete':
+            return deleteCmd(args);
+        case 'start':
+            return startCmd(args);
+        case 'stop':
+            return stopCmd(args);
+        default:
+            (0, ui_1.error)(`Unknown experiments action: ${action}`);
+            (0, ui_1.info)('Usage: gurulu experiments [list|show|results|create|update|delete|start|stop]');
+            process.exit(1);
+    }
+}
+async function listCmd(args) {
+    const body = await (0, api_client_1.cliApiJson)('/api/cli/experiments', {
+        profile: args.profile,
+    });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    const rows = body.experiments || [];
+    if (rows.length === 0) {
+        (0, ui_1.info)('No experiments yet.');
+        return;
+    }
+    process.stdout.write(['KEY', 'NAME', 'ACTIVE', 'ASSIGNMENTS', 'STARTED'].join('\t') + '\n');
+    for (const e of rows) {
+        process.stdout.write([
+            e.key,
+            e.name,
+            e.isActive ? 'yes' : 'no',
+            String(e.assignmentsCount ?? 0),
+            String(e.startedAt || '-'),
+        ].join('\t') + '\n');
+    }
+}
+async function showCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu experiments show <key>');
+        process.exit(1);
+    }
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/experiments/${encodeURIComponent(args.target)}`, { profile: args.profile });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    const e = body.experiment;
+    process.stdout.write(`Key:          ${e.key}\n`);
+    process.stdout.write(`Name:         ${e.name}\n`);
+    process.stdout.write(`Active:       ${e.isActive ? 'yes' : 'no'}\n`);
+    process.stdout.write(`Assignments:  ${e.assignmentsCount}\n`);
+    process.stdout.write(`Variants:     ${JSON.stringify(e.variants)}\n`);
+    process.stdout.write(`Started:      ${e.startedAt || '-'}\n`);
+    process.stdout.write(`Ended:        ${e.endedAt || '-'}\n`);
+}
+async function resultsCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu experiments results <key>');
+        process.exit(1);
+    }
+    const qs = args.conversionEvent
+        ? `?conversionEvent=${encodeURIComponent(args.conversionEvent)}`
+        : '';
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/experiments/${encodeURIComponent(args.target)}/results${qs}`, { profile: args.profile });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    process.stdout.write(`Experiment: ${body.experimentKey || body.experimentId}\n`);
+    process.stdout.write(`Conversion: ${body.conversionEvent}\n`);
+    process.stdout.write(['VARIANT', 'ASSIGNS', 'CONV', 'RATE', 'CI_LO', 'CI_HI'].join('\t') + '\n');
+    for (const r of body.results || []) {
+        process.stdout.write([
+            r.variantId,
+            String(r.assignments),
+            String(r.conversions),
+            r.conversionRate.toFixed(3),
+            r.ciLower.toFixed(3),
+            r.ciUpper.toFixed(3),
+        ].join('\t') + '\n');
+    }
+}
+async function createCmd(args) {
+    let payload = {};
+    if (args.fromFile)
+        payload = (0, from_file_1.loadFromFile)(args.fromFile);
+    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.');
+        process.exit(1);
+    }
+    if (args.dryRun) {
+        const body = await (0, api_client_1.cliApiJson)('/api/cli/experiments?dryRun=1', {
+            profile: args.profile,
+            method: 'POST',
+            json: payload,
+        });
+        (0, dry_run_1.printDryRun)(body, args.json);
+        return;
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`Create experiment '${payload.key}'?`, {
+        yes: args.yes,
+        defaultYes: true,
+    });
+    if (!ok)
+        return (0, ui_1.info)('Aborted.');
+    const body = await (0, api_client_1.cliApiJson)('/api/cli/experiments', {
+        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 experiment ${body.experiment?.key ?? ''}`);
+}
+async function updateCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu experiments update <key>');
+        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.dryRun) {
+        const body = await (0, api_client_1.cliApiJson)(`/api/cli/experiments/${encodeURIComponent(args.target)}?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}'?`, {
+        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 });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Updated experiment ${args.target}`);
+}
+async function deleteCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu experiments delete <key>');
+        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' });
+        (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 });
+    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}`);
+}
+async function startCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu experiments start <key>');
+        process.exit(1);
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`Start experiment '${args.target}'?`, {
+        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)}/start${args.dryRun ? '?dryRun=1' : ''}`, { profile: args.profile, method: 'POST', json: {} });
+    if (args.dryRun)
+        return (0, dry_run_1.printDryRun)(body, args.json);
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Started experiment ${args.target}`);
+}
+async function stopCmd(args) {
+    if (!args.target) {
+        (0, ui_1.error)('Usage: gurulu experiments stop <key>');
+        process.exit(1);
+    }
+    const ok = await (0, confirm_1.promptConfirm)(`Stop experiment '${args.target}'?`, {
+        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)}/stop${args.dryRun ? '?dryRun=1' : ''}`, { profile: args.profile, method: 'POST', json: {} });
+    if (args.dryRun)
+        return (0, dry_run_1.printDryRun)(body, args.json);
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    (0, ui_1.success)(`Stopped experiment ${args.target}`);
+}

package/dist/commands/identity.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Phase 19.5 W2 B8 — `gurulu identity decay|transfers|cdc-sources`.
+ */
+export interface IdentityArgs {
+    action?: string;
+    sub?: string;
+    direction?: string;
+    status?: string;
+    limit?: number;
+    json?: boolean;
+    profile?: string;
+}
+export declare function identityCommand(args: IdentityArgs): Promise<void>;

package/dist/commands/identity.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * Phase 19.5 W2 B8 — `gurulu identity decay|transfers|cdc-sources`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.identityCommand = identityCommand;
+const api_client_1 = require("../api-client");
+const ui_1 = require("../utils/ui");
+async function identityCommand(args) {
+    const action = args.action || '';
+    switch (action) {
+        case 'decay':
+            return decayCmd(args);
+        case 'transfers':
+            return transfersCmd(args);
+        case 'cdc-sources':
+            return cdcSourcesCmd(args);
+        default:
+            (0, ui_1.error)(`Unknown identity action: ${action}`);
+            (0, ui_1.info)('Usage: gurulu identity [decay stats|transfers list|cdc-sources list]');
+            process.exit(1);
+    }
+}
+async function decayCmd(args) {
+    // `gurulu identity decay stats` is the only supported form for Phase 19.5.
+    if (args.sub && args.sub !== 'stats') {
+        (0, ui_1.error)(`Unknown identity decay sub: ${args.sub}`);
+        process.exit(1);
+    }
+    const body = await (0, api_client_1.cliApiJson)('/api/cli/identity/decay/stats', {
+        profile: args.profile,
+    });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    process.stdout.write(`Retired claims:  ${body.totalRetiredClaims}\n`);
+    process.stdout.write(`Retired tags:    ${body.totalRetiredTags}\n`);
+    process.stdout.write(`Recent jobs:     ${(body.recentRuns || []).length}\n`);
+    process.stdout.write(`Histogram:\n`);
+    for (const [k, v] of Object.entries(body.decayHistogram || {})) {
+        process.stdout.write(`  ${k}: ${v}\n`);
+    }
+}
+async function transfersCmd(args) {
+    if (args.sub && args.sub !== 'list') {
+        (0, ui_1.error)(`Unknown identity transfers sub: ${args.sub}`);
+        process.exit(1);
+    }
+    const qs = new URLSearchParams();
+    if (args.direction)
+        qs.set('direction', args.direction);
+    if (args.status)
+        qs.set('status', args.status);
+    if (args.limit)
+        qs.set('limit', String(args.limit));
+    const path = `/api/cli/identity/transfers${qs.toString() ? `?${qs.toString()}` : ''}`;
+    const body = await (0, api_client_1.cliApiJson)(path, { profile: args.profile });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    const rows = body.transfers || [];
+    if (rows.length === 0) {
+        (0, ui_1.info)('No transfers.');
+        return;
+    }
+    process.stdout.write(['ID', 'SOURCE', 'TARGET', 'STATUS', 'INITIATED'].join('\t') + '\n');
+    for (const t of rows) {
+        process.stdout.write([
+            t.id,
+            t.sourceTenantId,
+            t.targetTenantId,
+            t.status,
+            String(t.initiatedAt || '-'),
+        ].join('\t') + '\n');
+    }
+}
+async function cdcSourcesCmd(args) {
+    if (args.sub && args.sub !== 'list') {
+        (0, ui_1.error)(`Unknown identity cdc-sources sub: ${args.sub}`);
+        process.exit(1);
+    }
+    const body = await (0, api_client_1.cliApiJson)('/api/cli/identity/cdc-sources', {
+        profile: args.profile,
+    });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    const rows = body.sources || [];
+    if (rows.length === 0) {
+        (0, ui_1.info)('No CDC sources configured.');
+        return;
+    }
+    process.stdout.write(['ID', 'NAME', 'TYPE', 'TABLE', 'ACTIVE', 'LAST_POLL'].join('\t') + '\n');
+    for (const s of rows) {
+        process.stdout.write([
+            s.id,
+            s.name,
+            s.sourceType,
+            s.tableName,
+            s.isActive ? 'yes' : 'no',
+            String(s.lastPollAt || '-'),
+        ].join('\t') + '\n');
+    }
+}

package/dist/commands/init.d.ts

@@ -0,0 +1,11 @@
+interface InitArgs {
+    siteId?: string;
+    token?: string;
+    framework?: string;
+    noInteractive?: boolean;
+    dryRun?: boolean;
+    json?: boolean;
+    profile?: string;
+}
+export declare function initCommand(args: InitArgs): Promise<void>;
+export {};

package/dist/commands/init.js

@@ -0,0 +1,215 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initCommand = initCommand;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const config_1 = require("../config");
+const api_client_1 = require("../api-client");
+const detect_1 = require("../frameworks/detect");
+const ui_1 = require("../utils/ui");
+async function initCommand(args) {
+    const projectDir = process.cwd();
+    if (args.json) {
+        return initJSON(args, projectDir);
+    }
+    (0, ui_1.banner)();
+    // Step 1: Detect framework
+    let framework = args.framework || (0, detect_1.detectFramework)(projectDir);
+    (0, ui_1.info)(`Detected framework: ${(0, ui_1.bold)((0, detect_1.getFrameworkDisplayName)(framework))}`);
+    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 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))}`);
+    }
+    // Step 2: Get site credentials
+    let siteId = args.siteId || process.env.GURULU_SITE_ID;
+    let token = args.token || process.env.GURULU_TOKEN;
+    if (!siteId || !token) {
+        let profile;
+        try {
+            profile = await (0, config_1.loadActiveProfile)({ profile: args.profile });
+        }
+        catch {
+            profile = null;
+        }
+        if (profile && !siteId) {
+            try {
+                const data = await (0, api_client_1.cliApiJson)('/api/cli/sites', { preloadedProfile: profile });
+                const sites = data.sites || [];
+                if (sites.length === 0) {
+                    (0, ui_1.error)('No sites found. Create a site at https://gurulu.io first.');
+                    process.exit(1);
+                }
+                if (sites.length === 1 || args.noInteractive) {
+                    siteId = sites[0].id;
+                    (0, ui_1.info)(`Using site: ${(0, ui_1.bold)(sites[0].domain)}`);
+                }
+                else {
+                    console.log('');
+                    const idx = await (0, ui_1.promptSelect)('  Select a site: ', sites.map(s => `${s.domain} (${s.id})`));
+                    siteId = sites[idx].id;
+                }
+                // Fetch site details to get publishable key as token
+                if (!token) {
+                    (0, ui_1.step)('Fetching site credentials...');
+                    const siteData = await (0, api_client_1.cliApiJson)(`/api/cli/sites/${encodeURIComponent(siteId)}`, { preloadedProfile: profile });
+                    token = siteData.site?.publishableKey || '';
+                }
+            }
+            catch (err) {
+                if (!args.noInteractive) {
+                    (0, ui_1.warn)('Could not fetch sites. Enter credentials manually.');
+                    if (!siteId)
+                        siteId = await (0, ui_1.prompt)('  Site ID: ');
+                    if (!token)
+                        token = await (0, ui_1.prompt)('  Site Token: ');
+                }
+                else {
+                    (0, ui_1.error)(`Failed to fetch credentials: ${err.message}`);
+                    process.exit(1);
+                }
+            }
+        }
+        else if (!args.noInteractive) {
+            if (!profile) {
+                (0, ui_1.warn)('Not authenticated. Run "gurulu login" first, or provide --site-id and --token.');
+                console.log('');
+            }
+            if (!siteId)
+                siteId = await (0, ui_1.prompt)('  Site ID: ');
+            if (!token)
+                token = await (0, ui_1.prompt)('  Site Token: ');
+        }
+        else {
+            (0, ui_1.error)('Site ID and token required in non-interactive mode. Use --site-id and --token, or run "gurulu login" first.');
+            process.exit(1);
+        }
+    }
+    if (!siteId || !token) {
+        (0, ui_1.error)('Site ID and token are required.');
+        process.exit(1);
+    }
+    // Step 3: Generate setup code
+    const snippet = (0, detect_1.getSetupSnippet)(framework, siteId, token);
+    console.log('');
+    if (args.dryRun) {
+        (0, ui_1.info)('Dry run - showing what would be done:');
+        console.log('');
+        if (snippet.file) {
+            console.log(`  ${(0, ui_1.dim)('File:')} ${(0, ui_1.cyan)(snippet.file)}`);
+        }
+        console.log(`  ${(0, ui_1.dim)('Instruction:')} ${snippet.instruction}`);
+        console.log('');
+        console.log((0, ui_1.dim)('  --- Code ---'));
+        snippet.code.split('\n').forEach(line => {
+            console.log(`  ${(0, ui_1.dim)(line)}`);
+        });
+        console.log((0, ui_1.dim)('  --- End ---'));
+        console.log('');
+        if (framework !== 'html') {
+            console.log(`  ${(0, ui_1.dim)('.env.local would include:')}`);
+            console.log(`  NEXT_PUBLIC_GURULU_SITE_ID=${siteId}`);
+            console.log(`  NEXT_PUBLIC_GURULU_TOKEN=${token}`);
+        }
+        return;
+    }
+    // Step 4: Write setup code
+    if (snippet.file) {
+        const filePath = path_1.default.join(projectDir, snippet.file);
+        const fileDir = path_1.default.dirname(filePath);
+        if (fs_1.default.existsSync(filePath)) {
+            (0, ui_1.warn)(`File already exists: ${snippet.file}`);
+            if (!args.noInteractive) {
+                const answer = await (0, ui_1.prompt)('  Overwrite? (y/N): ');
+                if (answer.toLowerCase() !== 'y') {
+                    (0, ui_1.info)('Skipping file creation.');
+                    printNextSteps(snippet, siteId, token, framework);
+                    return;
+                }
+            }
+            else {
+                (0, ui_1.info)('Skipping existing file in non-interactive mode.');
+                printNextSteps(snippet, siteId, token, framework);
+                return;
+            }
+        }
+        fs_1.default.mkdirSync(fileDir, { recursive: true });
+        fs_1.default.writeFileSync(filePath, snippet.code);
+        (0, ui_1.success)(`Created ${snippet.file}`);
+    }
+    // Step 5: Update .env.local (for frontend frameworks)
+    const frontendFrameworks = ['nextjs-app', 'nextjs-pages', 'react-vite', 'react-cra', 'vue3', 'nuxt3', 'svelte', 'sveltekit', 'astro'];
+    if (frontendFrameworks.includes(framework)) {
+        const envFile = path_1.default.join(projectDir, '.env.local');
+        const envPrefix = framework.startsWith('nuxt') ? 'NUXT_PUBLIC' : framework.startsWith('next') ? 'NEXT_PUBLIC' : 'VITE';
+        const envLines = [
+            `${envPrefix}_GURULU_SITE_ID=${siteId}`,
+            `${envPrefix}_GURULU_TOKEN=${token}`,
+        ];
+        let existingEnv = '';
+        if (fs_1.default.existsSync(envFile)) {
+            existingEnv = fs_1.default.readFileSync(envFile, 'utf-8');
+        }
+        const newLines = envLines.filter(line => {
+            const key = line.split('=')[0];
+            return !existingEnv.includes(key);
+        });
+        if (newLines.length > 0) {
+            const separator = existingEnv && !existingEnv.endsWith('\n') ? '\n' : '';
+            const header = existingEnv ? '' : '# Gurulu.io Analytics\n';
+            fs_1.default.appendFileSync(envFile, `${separator}${header}${newLines.join('\n')}\n`);
+            (0, ui_1.success)('Updated .env.local with site credentials');
+        }
+        else {
+            (0, ui_1.info)('.env.local already has Gurulu credentials');
+        }
+    }
+    // Step 6: Print next steps
+    printNextSteps(snippet, siteId, token, framework);
+}
+function printNextSteps(snippet, siteId, token, framework) {
+    console.log('');
+    console.log((0, ui_1.bold)('  Next steps:'));
+    console.log('');
+    (0, ui_1.step)(snippet.instruction);
+    const mobileFrameworks = ['react-native', 'ios-swift', 'android-kotlin', 'flutter'];
+    if (framework === 'html' || mobileFrameworks.includes(framework)) {
+        console.log('');
+        console.log((0, ui_1.dim)('  Copy this snippet:'));
+        console.log('');
+        snippet.code.split('\n').forEach(line => {
+            console.log(`  ${line}`);
+        });
+    }
+    console.log('');
+    (0, ui_1.step)(`Run ${(0, ui_1.cyan)('gurulu status')} to verify the connection`);
+    (0, ui_1.step)(`Run ${(0, ui_1.cyan)('gurulu events')} to see detected events`);
+    (0, ui_1.step)(`Visit ${(0, ui_1.cyan)('https://gurulu.io')} to view your dashboard`);
+    console.log('');
+    (0, ui_1.success)('Setup complete!');
+    console.log('');
+}
+async function initJSON(args, projectDir) {
+    const framework = args.framework || (0, detect_1.detectFramework)(projectDir);
+    const siteId = args.siteId || process.env.GURULU_SITE_ID || '';
+    const token = args.token || process.env.GURULU_TOKEN || '';
+    const snippet = (0, detect_1.getSetupSnippet)(framework, siteId, token);
+    const output = {
+        framework,
+        frameworkName: (0, detect_1.getFrameworkDisplayName)(framework),
+        siteId,
+        snippet: {
+            file: snippet.file,
+            code: snippet.code,
+            instruction: snippet.instruction,
+        },
+        dryRun: !!args.dryRun,
+    };
+    console.log(JSON.stringify(output, null, 2));
+}

package/dist/commands/insights.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Phase 19.5 W2 B5 — `gurulu insights today|history|weekly`.
+ */
+export interface InsightsArgs {
+    action?: string;
+    days?: number;
+    json?: boolean;
+    profile?: string;
+}
+export declare function insightsCommand(args: InsightsArgs): Promise<void>;

package/dist/commands/insights.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Phase 19.5 W2 B5 — `gurulu insights today|history|weekly`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.insightsCommand = insightsCommand;
+const api_client_1 = require("../api-client");
+const ui_1 = require("../utils/ui");
+async function insightsCommand(args) {
+    const action = args.action || 'today';
+    switch (action) {
+        case 'today':
+            return todayCmd(args);
+        case 'history':
+        case 'weekly':
+            return historyCmd(args);
+        default:
+            (0, ui_1.error)(`Unknown insights action: ${action}`);
+            (0, ui_1.info)('Usage: gurulu insights [today|history|weekly]');
+            process.exit(1);
+    }
+}
+async function todayCmd(args) {
+    try {
+        const body = await (0, api_client_1.cliApiJson)('/api/cli/insights', {
+            profile: args.profile,
+        });
+        if (args.json) {
+            process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+            return;
+        }
+        const i = body.insight;
+        process.stdout.write(`Date:     ${String(i.date).slice(0, 10)}\n`);
+        process.stdout.write(`Summary:  ${i.summary || '-'}\n`);
+        if (Array.isArray(i.highlights)) {
+            process.stdout.write(`Highlights:\n`);
+            for (const h of i.highlights)
+                process.stdout.write(`  - ${h}\n`);
+        }
+    }
+    catch (err) {
+        if (err?.status === 404) {
+            (0, ui_1.info)('No daily insight available yet.');
+            return;
+        }
+        throw err;
+    }
+}
+async function historyCmd(args) {
+    const days = args.days ?? 7;
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/insights/history?days=${days}`, { profile: args.profile });
+    if (args.json) {
+        process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+        return;
+    }
+    const rows = body.insights || [];
+    if (rows.length === 0) {
+        (0, ui_1.info)('No insights in the selected window.');
+        return;
+    }
+    process.stdout.write(['DATE', 'SUMMARY'].join('\t') + '\n');
+    for (const r of rows) {
+        process.stdout.write([String(r.date).slice(0, 10), String(r.summary || '-').slice(0, 80)].join('\t') + '\n');
+    }
+}