@gurulu/cli 0.4.6 → 1.0.0

package/dist/commands/doctor.js

@@ -1,360 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.doctorCommand = doctorCommand;
-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 doctorCommand(args) {
-    let profile;
-    try {
-        profile = await (0, config_1.loadActiveProfile)({ profile: args.profile });
-    }
-    catch {
-        profile = null;
-    }
-    const siteId = args.site;
-    const projectDir = process.cwd();
-    const checks = [];
-    // 1. Framework detection
-    const framework = (0, detect_1.detectFramework)(projectDir);
-    // If the user explicitly passed --site, the cwd-derived checks should not
-    // imply that the *production site* is broken — they're informational only.
-    const isLocalProjectDetected = framework !== 'unknown';
-    checks.push({
-        name: 'Framework Detection',
-        status: framework !== 'unknown' ? 'pass' : 'warn',
-        message: framework !== 'unknown'
-            ? `Detected ${(0, detect_1.getFrameworkDisplayName)(framework)}`
-            : 'Could not detect framework',
-        fix: framework === 'unknown' ? 'Run "gurulu init --framework <name>" to specify manually' : undefined,
-        section: 'local',
-    });
-    // 2. SDK installed
-    const pkgPath = path_1.default.join(projectDir, 'package.json');
-    let hasWebSDK = false;
-    let hasNodeSDK = false;
-    let hasReactNativeSDK = false;
-    if (fs_1.default.existsSync(pkgPath)) {
-        const pkg = JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf-8'));
-        const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
-        hasWebSDK = !!allDeps['@gurulu/web-sdk'];
-        hasNodeSDK = !!allDeps['@gurulu/node'];
-        hasReactNativeSDK = !!allDeps['@gurulu/react-native'];
-    }
-    // Mobile SDK detection
-    let hasFlutterSDK = false;
-    const pubspecPath = path_1.default.join(projectDir, 'pubspec.yaml');
-    if (fs_1.default.existsSync(pubspecPath)) {
-        const pubspec = fs_1.default.readFileSync(pubspecPath, 'utf-8');
-        hasFlutterSDK = pubspec.includes('gurulu_flutter');
-    }
-    let hasIOSSDK = false;
-    const swiftPkgPath = path_1.default.join(projectDir, 'Package.swift');
-    if (fs_1.default.existsSync(swiftPkgPath)) {
-        const swiftPkg = fs_1.default.readFileSync(swiftPkgPath, 'utf-8');
-        hasIOSSDK = swiftPkg.includes('gurulu-ios-sdk');
-    }
-    let hasAndroidSDK = false;
-    const gradleKtsPath = path_1.default.join(projectDir, 'build.gradle.kts');
-    const gradlePath = path_1.default.join(projectDir, 'build.gradle');
-    for (const gPath of [gradleKtsPath, gradlePath]) {
-        if (fs_1.default.existsSync(gPath)) {
-            const gradle = fs_1.default.readFileSync(gPath, 'utf-8');
-            if (gradle.includes('gurulu') || gradle.includes('jitpack')) {
-                hasAndroidSDK = true;
-                break;
-            }
-        }
-    }
-    const hasMobileSDK = hasReactNativeSDK || hasFlutterSDK || hasIOSSDK || hasAndroidSDK;
-    const setupFiles = findSetupFiles(projectDir);
-    const hasSetup = setupFiles.length > 0 || hasWebSDK || hasMobileSDK;
-    const sdkLabel = hasWebSDK ? 'Web SDK installed via npm'
-        : hasReactNativeSDK ? 'React Native SDK installed via npm'
-            : hasFlutterSDK ? 'Flutter SDK found in pubspec.yaml'
-                : hasIOSSDK ? 'iOS SDK found in Package.swift'
-                    : hasAndroidSDK ? 'Android SDK found in build.gradle'
-                        : setupFiles.length > 0 ? `Setup file found: ${setupFiles[0]}`
-                            : 'No client SDK detected';
-    // When --site was passed but cwd is not a Gurulu project, downgrade local
-    // SDK failures to "skip" so they don't masquerade as production-site issues.
-    const localChecksAreInformational = !!siteId && !isLocalProjectDetected;
-    checks.push({
-        name: 'Client SDK',
-        status: hasSetup ? 'pass' : localChecksAreInformational ? 'skip' : 'fail',
-        message: hasSetup
-            ? sdkLabel
-            : localChecksAreInformational
-                ? 'No client SDK detected in this directory (informational — site checks below)'
-                : sdkLabel,
-        fix: !hasSetup && !localChecksAreInformational
-            ? 'Run "gurulu init" to set up analytics'
-            : undefined,
-        section: 'local',
-    });
-    // 3. Server SDK
-    checks.push({
-        name: 'Server SDK',
-        status: hasNodeSDK ? 'pass' : localChecksAreInformational ? 'skip' : 'warn',
-        message: hasNodeSDK
-            ? '@gurulu/node installed'
-            : localChecksAreInformational
-                ? 'Server SDK check skipped (no local project detected)'
-                : 'Server SDK not installed (optional)',
-        fix: !hasNodeSDK && !localChecksAreInformational
-            ? 'Run "gurulu add-server" for server-side tracking'
-            : undefined,
-        section: 'local',
-    });
-    // 4. Site ID configured
-    checks.push({
-        name: 'Site ID',
-        status: siteId ? 'pass' : 'fail',
-        message: siteId ? `Site ID: ${siteId}` : 'No site ID configured',
-        fix: !siteId ? 'Run "gurulu login" to authenticate and select a site' : undefined,
-    });
-    // 5. Authentication
-    checks.push({
-        name: 'Authentication',
-        status: profile ? 'pass' : 'fail',
-        message: profile ? 'Authenticated' : 'Not authenticated',
-        fix: !profile ? 'Run "gurulu login" with your Personal API Key' : undefined,
-    });
-    // 6. Token validation (if we have a profile and siteId)
-    if (profile && siteId) {
-        try {
-            const data = await (0, api_client_1.cliApiJson)(`/api/cli/sites/${encodeURIComponent(siteId)}`, { preloadedProfile: profile });
-            const hasToken = !!data.site?.publishableKey;
-            checks.push({
-                name: 'Token Valid',
-                status: hasToken ? 'pass' : 'fail',
-                message: hasToken ? 'Site token is valid' : 'Token could not be verified',
-            });
-        }
-        catch (err) {
-            checks.push({
-                name: 'Token Valid',
-                status: 'fail',
-                message: `Token validation failed: ${err.message}`,
-                fix: 'Check your API key and site ID, or run "gurulu login" again',
-            });
-        }
-    }
-    else {
-        checks.push({
-            name: 'Token Valid',
-            status: 'skip',
-            message: 'Skipped (authentication required)',
-        });
-    }
-    // 7. Ingest connection + 8. Events flowing — via /api/cli/sites/:id/health
-    if (profile && siteId) {
-        try {
-            const health = await (0, api_client_1.cliApiJson)(`/api/cli/sites/${encodeURIComponent(siteId)}/health`, {
-                preloadedProfile: profile,
-            });
-            checks.push({
-                name: 'Ingest Connection',
-                status: health.checks.ingest === 'ok' ? 'pass' : 'fail',
-                message: health.checks.ingest === 'ok'
-                    ? 'Ingest endpoint is healthy'
-                    : 'Ingest check failed — site may be archived or missing a valid token',
-                fix: health.checks.ingest !== 'ok'
-                    ? 'Verify site exists and has a valid publishable key'
-                    : undefined,
-            });
-            const chOk = health.checks.clickhouse === 'ok';
-            const pgOk = health.checks.postgres === 'ok';
-            const allOk = chOk && pgOk;
-            checks.push({
-                name: 'Events Flowing',
-                status: allOk ? 'pass' : chOk || pgOk ? 'warn' : 'fail',
-                message: allOk
-                    ? 'ClickHouse and Postgres are reachable'
-                    : `Backend health: postgres=${health.checks.postgres}, clickhouse=${health.checks.clickhouse}`,
-                fix: !allOk ? 'Check server logs or contact support' : undefined,
-            });
-        }
-        catch (err) {
-            checks.push({
-                name: 'Ingest Connection',
-                status: 'fail',
-                message: `Health check failed: ${err.message}`,
-                fix: 'Check your API key and site ID, or run "gurulu login" again',
-            });
-            checks.push({
-                name: 'Events Flowing',
-                status: 'skip',
-                message: 'Skipped (health check unavailable)',
-            });
-        }
-    }
-    else if (profile && !siteId) {
-        // Try to resolve a site automatically
-        try {
-            const sitesData = await (0, api_client_1.cliApiJson)('/api/cli/sites', { preloadedProfile: profile });
-            if (sitesData.sites?.length) {
-                const resolvedId = sitesData.sites[0].id;
-                const health = await (0, api_client_1.cliApiJson)(`/api/cli/sites/${encodeURIComponent(resolvedId)}/health`, {
-                    preloadedProfile: profile,
-                });
-                checks.push({
-                    name: 'Ingest Connection',
-                    status: health.checks.ingest === 'ok' ? 'pass' : 'fail',
-                    message: health.checks.ingest === 'ok'
-                        ? `Ingest healthy (auto-resolved site ${resolvedId})`
-                        : 'Ingest check failed',
-                    fix: health.checks.ingest !== 'ok'
-                        ? 'Verify site exists and has a valid publishable key'
-                        : undefined,
-                });
-                const chOk = health.checks.clickhouse === 'ok';
-                const pgOk = health.checks.postgres === 'ok';
-                const allOk = chOk && pgOk;
-                checks.push({
-                    name: 'Events Flowing',
-                    status: allOk ? 'pass' : chOk || pgOk ? 'warn' : 'fail',
-                    message: allOk
-                        ? 'ClickHouse and Postgres are reachable'
-                        : `Backend health: postgres=${health.checks.postgres}, clickhouse=${health.checks.clickhouse}`,
-                    fix: !allOk ? 'Check server logs or contact support' : undefined,
-                });
-            }
-            else {
-                checks.push({
-                    name: 'Ingest Connection',
-                    status: 'skip',
-                    message: 'No sites found — create one with "gurulu init"',
-                });
-                checks.push({
-                    name: 'Events Flowing',
-                    status: 'skip',
-                    message: 'Skipped (no sites)',
-                });
-            }
-        }
-        catch {
-            checks.push({
-                name: 'Ingest Connection',
-                status: 'skip',
-                message: 'Could not resolve site automatically',
-                fix: 'Pass --site <id> or run "gurulu init"',
-            });
-            checks.push({
-                name: 'Events Flowing',
-                status: 'skip',
-                message: 'Skipped (no site resolved)',
-            });
-        }
-    }
-    else {
-        checks.push({
-            name: 'Ingest Connection',
-            status: 'skip',
-            message: 'Skipped (authentication required)',
-        });
-        checks.push({
-            name: 'Events Flowing',
-            status: 'skip',
-            message: 'Skipped (authentication required)',
-        });
-    }
-    // 9. Env file check
-    const envFiles = ['.env.local', '.env', '.env.development'];
-    let envHasSiteId = false;
-    for (const envFile of envFiles) {
-        const envPath = path_1.default.join(projectDir, envFile);
-        if (fs_1.default.existsSync(envPath)) {
-            const content = fs_1.default.readFileSync(envPath, 'utf-8');
-            if (content.includes('GURULU_SITE_ID')) {
-                envHasSiteId = true;
-                break;
-            }
-        }
-    }
-    if (framework !== 'html' && framework !== 'unknown') {
-        checks.push({
-            name: 'Env Config',
-            status: envHasSiteId ? 'pass' : 'warn',
-            message: envHasSiteId ? 'Site ID found in env file' : 'No GURULU_SITE_ID in env files',
-            fix: !envHasSiteId ? 'Run "gurulu init" to auto-configure .env.local' : undefined,
-            section: 'local',
-        });
-    }
-    // Output
-    if (args.json) {
-        console.log(JSON.stringify({ framework, checks }, null, 2));
-        return;
-    }
-    (0, ui_1.banner)();
-    console.log((0, ui_1.bold)('  Diagnostics'));
-    console.log('');
-    const icons = {
-        pass: (0, ui_1.green)('\u2713'),
-        fail: (0, ui_1.red)('\u2717'),
-        warn: (0, ui_1.yellow)('\u26A0'),
-        skip: (0, ui_1.dim)('-'),
-    };
-    let failCount = 0;
-    let warnCount = 0;
-    const localChecks = checks.filter((c) => c.section === 'local');
-    const siteChecks = checks.filter((c) => c.section !== 'local');
-    const printGroup = (title, items, note) => {
-        if (items.length === 0)
-            return;
-        console.log(`  ${(0, ui_1.bold)(title)}`);
-        if (note)
-            console.log(`  ${(0, ui_1.dim)(note)}`);
-        for (const check of items) {
-            const icon = icons[check.status];
-            console.log(`    ${icon} ${(0, ui_1.bold)(check.name)}: ${check.message}`);
-            if (check.fix) {
-                console.log(`      ${(0, ui_1.dim)('\u2192')} ${(0, ui_1.dim)(check.fix)}`);
-            }
-            if (check.status === 'fail')
-                failCount++;
-            if (check.status === 'warn')
-                warnCount++;
-        }
-        console.log('');
-    };
-    if (localChecks.length > 0) {
-        const localNote = siteId && !isLocalProjectDetected
-            ? `(Local project not detected \u2014 running site-only checks for ${siteId}.)`
-            : undefined;
-        printGroup('Local Project', localChecks, localNote);
-    }
-    if (siteChecks.length > 0) {
-        const siteTitle = siteId ? `Site (${siteId})` : 'Site';
-        printGroup(siteTitle, siteChecks);
-    }
-    console.log('');
-    if (failCount === 0 && warnCount === 0) {
-        (0, ui_1.success)('All checks passed! Your setup looks good.');
-    }
-    else if (failCount === 0) {
-        (0, ui_1.info)(`${warnCount} warning(s), but no critical issues.`);
-    }
-    else {
-        (0, ui_1.error)(`${failCount} issue(s) found. Fix them to get analytics working.`);
-    }
-    console.log('');
-}
-function findSetupFiles(projectDir) {
-    const candidates = [
-        'src/lib/gurulu.tsx',
-        'src/lib/gurulu.ts',
-        'src/gurulu.ts',
-        'src/plugins/gurulu.ts',
-        'plugins/gurulu.client.ts',
-        'src/components/Gurulu.astro',
-        'src/gurulu.middleware.ts',
-    ];
-    return candidates.filter(f => fs_1.default.existsSync(path_1.default.join(projectDir, f)));
-}

package/dist/commands/errors.d.ts

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

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

@@ -1,33 +0,0 @@
-/**
- * Phase 19.5 W2 B1 — `gurulu events list` / `gurulu events tail`.
- *
- * Replaces the legacy Phase 10 `events` command (which talked to a
- * now-defunct credential store) with CLI-bearer-auth subcommands that hit
- * `/api/cli/events` (list) and `/api/cli/events/tail` (SSE stream).
- *
- * All subcommands support `--json` for scripting + agent parsing.
- */
-import { loadActiveProfile } from '../config';
-export interface EventsArgs {
-    action?: string;
-    site?: string;
-    eventName?: string;
-    since?: string;
-    filter?: string;
-    limit?: number;
-    json?: boolean;
-    profile?: string;
-    displayName?: string;
-    description?: string;
-    category?: string;
-    properties?: string;
-    event?: string;
-    vertical?: string;
-}
-export declare function eventsCommand(args: EventsArgs): Promise<void>;
-export declare function legacyEventsCommand(args: {
-    site?: string;
-    json?: boolean;
-    profile?: string;
-}): Promise<void>;
-export declare const _loadActiveProfile: typeof loadActiveProfile;