@gurulu/cli 0.3.3 → 0.4.0

package/README.md

@@ -1,6 +1,6 @@
 # @gurulu/cli
 
-CLI wizard for setting up Gurulu.io analytics in any project.
+CLI for Gurulu.io — setup, diagnostics, data exploration, and AI-powered analytics from your terminal.
 
 ## Quick Start
 
@@ -10,31 +10,76 @@ npx @gurulu/cli init
 
 ## Commands
 
+### Authentication
+
+| Command | Description |
+|---------|-------------|
+| `gurulu auth` | Authenticate via device-link flow (or `--key` for manual) |
+| `gurulu login` | Authenticate with API key |
+| `gurulu logout` | Remove a stored profile |
+| `gurulu whoami` | Show current authentication state |
+
+### Setup & Diagnostics
+
 | Command | Description |
 |---------|-------------|
 | `gurulu init` | Set up Gurulu analytics (auto-detects framework) |
-| `gurulu login` | Authenticate with your Personal API Key |
-| `gurulu events` | List detected events from your site |
-| `gurulu status` | Quick health check |
-| `gurulu doctor` | Comprehensive diagnostics |
+| `gurulu install [path]` | Install Gurulu tracker in a repository |
 | `gurulu add-server` | Add server-side SDK (@gurulu/node) |
+| `gurulu status` | Check SDK health and connection |
+| `gurulu doctor` | Diagnose setup issues |
+| `gurulu config <action>` | Manage CLI profiles (list, use, show, delete) |
+
+### Sites & Keys
+
+| Command | Description |
+|---------|-------------|
+| `gurulu sites <action>` | Manage sites (list, create, show, delete, rotate-token) |
+| `gurulu api-keys <action>` | Manage API keys (list, create, revoke, rotate) |
+
+### Data & Events
+
+| Command | Description |
+|---------|-------------|
+| `gurulu events <action>` | View ingested events (list, tail) |
+| `gurulu insights <action>` | View daily insights (today, history, weekly) |
+| `gurulu chat [question]` | Ask analytics questions in natural language (NL -> SQL) |
+
+### Identity & Audiences
+
+| Command | Description |
+|---------|-------------|
+| `gurulu identity <action>` | View identity state (decay, transfers, cdc-sources) |
+| `gurulu audiences <action>` | View audiences (list, show) |
+| `gurulu experiments <action>` | View experiments (list, show, results) |
+
+### Integrations & Export
+
+| Command | Description |
+|---------|-------------|
+| `gurulu warehouse <action>` | Warehouse exports (BigQuery) |
+| `gurulu warehouses <action>` | View warehouse exports (list, runs) |
+| `gurulu destinations <action>` | View activation destinations (list, show) |
+| `gurulu db <action>` | Connect, list, sync, or remove database sources |
+
+### Monitoring & Debugging
+
+| Command | Description |
+|---------|-------------|
+| `gurulu alerts <action>` | View anomaly alerts (list, show, channels) |
+| `gurulu sourcemap <action>` | Upload source maps for error deobfuscation |
+| `gurulu audit <action>` | Stream or export the CLI audit log (tail, export) |
+| `gurulu playground <action>` | View playground sessions (list) |
 
 ## Supported Frameworks
 
-- Next.js (App Router & Pages Router)
-- React (Vite & CRA)
-- Vue 3
-- Nuxt 3
-- Svelte & SvelteKit
-- Astro
-- Express
-- NestJS
-- Plain HTML
+Next.js (App & Pages Router), React (Vite & CRA), Vue 3, Nuxt 3, Svelte & SvelteKit, Astro, Express, NestJS, Plain HTML.
 
 ## Authentication
 
 ```bash
-gurulu login --api-key pak_live_xxxxx
+gurulu auth                        # Device-link flow (recommended)
+gurulu login --api-key pak_live_x  # Manual API key
 ```
 
 Or set the `GURULU_API_KEY` environment variable.
@@ -52,15 +97,7 @@ gurulu init --site-id abc123 --token tok_xxx --no-interactive
 Use `--json` flag for machine-readable output:
 
 ```bash
-gurulu events --json
+gurulu events list --json
 gurulu status --json
 gurulu doctor --json
 ```
-
-## Development
-
-```bash
-npm install
-npm run build
-node bin/gurulu.js --help
-```

package/dist/api-client.js

@@ -97,7 +97,7 @@ async function cliApi(path, init = {}) {
     if (!init.skipAuth && profile) {
         headers.set('authorization', `Bearer ${profile.secret_key}`);
     }
-    if (init.body && !headers.has('content-type')) {
+    if (init.body && !headers.has('content-type') && !(init.body instanceof FormData)) {
         headers.set('content-type', 'application/json');
     }
     let res;

package/dist/commands/install.js

@@ -237,6 +237,19 @@ function log(deps, level, msg) {
         return;
     l[level](msg);
 }
+function getEnvPrefix(framework) {
+    if (framework.startsWith('nextjs'))
+        return 'NEXT_PUBLIC_';
+    if (framework === 'vite-react' || framework === 'vite')
+        return 'VITE_';
+    if (framework === 'nuxt' || framework === 'vue')
+        return 'NUXT_PUBLIC_';
+    if (framework === 'sveltekit' || framework === 'svelte')
+        return 'PUBLIC_';
+    if (framework === 'astro')
+        return 'PUBLIC_';
+    return ''; // Express, Fastify, NestJS don't need prefix
+}
 async function runInstallFlow(args, deps, scriptsDir) {
     const repoRoot = path.resolve(args.path || process.cwd());
     const summary = {
@@ -429,10 +442,11 @@ async function runInstallFlow(args, deps, scriptsDir) {
     }
     // ---- 6. .env merge ---------------------------------------------------
     const ingestUrl = args.ingestUrl || process.env.GURULU_INGEST_URL || 'https://gurulu.io';
+    const envPrefix = getEnvPrefix(detectedFw);
     const envVars = {
-        NEXT_PUBLIC_GURULU_SITE_ID: args.siteId,
-        NEXT_PUBLIC_GURULU_TENANT_ID: args.tenantId,
-        NEXT_PUBLIC_GURULU_INGEST_URL: ingestUrl,
+        [`${envPrefix}GURULU_SITE_ID`]: args.siteId,
+        [`${envPrefix}GURULU_TENANT_ID`]: args.tenantId,
+        [`${envPrefix}GURULU_INGEST_URL`]: ingestUrl,
     };
     if (args.skipEnv || args.dryRun) {
         log(deps, 'info', 'Skipping .env merge.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gurulu/cli",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Gurulu.io CLI — setup analytics in seconds",
   "bin": {
     "gurulu": "bin/gurulu.js"

package/scripts/gurulu-agentic-install.mjs

@@ -138,7 +138,7 @@ async function runPatchMode(repoRoot, args) {
     siteId: args['site-id'],
     tenantId: args['tenant-id'],
     publishableKey: args['publishable-key'] || '',
-    scriptSrc: args['script-src'] || '/gurulu-tracker.js',
+    scriptSrc: args['script-src'] || 'https://gurulu.io/t.js',
   });
   const plan = patcher.plan({ repoRoot, injection });
   log(`Framework: ${patcher.name}`);

package/scripts/patches/astro.patch.cjs

@@ -37,6 +37,7 @@ function buildScriptTag(injection) {
     `      src="${injection.scriptSrc}"\n` +
     `      data-gurulu-site-id="${injection.siteId}"\n` +
     `      data-gurulu-tenant-id="${injection.tenantId}"${pkAttr}\n` +
+    `      data-features="errors,replay,advanced"\n` +
     `      ${MARKER}\n` +
     `      async\n` +
     `    ></script>\n`

package/scripts/patches/express.patch.cjs

@@ -2,7 +2,7 @@
 //
 // Detects an Express server (`app.js`, `server.js`, `src/index.js` with the
 // idiomatic `const app = express()` signature) and appends:
-//   - A proxy route that serves /gurulu-tracker.js from the Gurulu CDN
+//   - A proxy route that serves /gurulu-tracker from the Gurulu CDN
 //   - A `res.locals.guruluConfig` middleware exposing siteId / tenantId
 
 const fs = require('fs');
@@ -59,7 +59,7 @@ function buildMiddleware(appVar, injection) {
     `  };\n` +
     `  next();\n` +
     `});\n` +
-    `${appVar}.use('/gurulu-tracker.js', (req, res) => {\n` +
+    `${appVar}.use('/gurulu-tracker', (req, res) => {\n` +
     `  res.set('Content-Type', 'application/javascript');\n` +
     `  res.send(\`// Gurulu tracker proxy — site=\${${JSON.stringify(injection.siteId)}} data-gurulu-publishable-key=\${${JSON.stringify(injection.publishableKey || '')}}\\n` +
     `window.gurulu = window.gurulu || { queue: [] };\`);\n` +

package/scripts/patches/fastify.patch.cjs

@@ -68,6 +68,7 @@ function buildScriptTag(injection) {
     `      src="${injection.scriptSrc}"\n` +
     `      data-gurulu-site-id="${injection.siteId}"\n` +
     `      data-gurulu-tenant-id="${injection.tenantId}"${pkAttr}\n` +
+    `      data-features="errors,replay,advanced"\n` +
     `      ${MARKER}\n` +
     `      async\n` +
     `    ></script>\n`

package/scripts/patches/nestjs.patch.cjs

@@ -70,6 +70,7 @@ function buildScriptTag(injection) {
     `      src="${injection.scriptSrc}"\n` +
     `      data-gurulu-site-id="${injection.siteId}"\n` +
     `      data-gurulu-tenant-id="${injection.tenantId}"${pkAttr}\n` +
+    `      data-features="errors,replay,advanced"\n` +
     `      ${MARKER}\n` +
     `      async\n` +
     `    ></script>\n`

package/scripts/patches/nextjs-app-router.patch.cjs

@@ -2,7 +2,7 @@
 //
 // Detects a Next.js App Router layout (`src/app/layout.tsx` or `app/layout.tsx`)
 // and injects a <Script> tag loaded via next/script that points to the Gurulu
-// Web SDK tracker (`/gurulu-tracker.js` by default).
+// Web SDK tracker (`https://gurulu.io/t.js` by default).
 //
 // Regex-based: fast alpha, good enough for most idiomatic RootLayouts.
 
@@ -40,7 +40,7 @@ function buildScriptTag(injection) {
     `          data-gurulu-site-id=${JSON.stringify(injection.siteId)}\n` +
     `          data-gurulu-tenant-id=${JSON.stringify(injection.tenantId)}\n` +
     pkAttr +
-    `          data-features="errors"\n` +
+    `          data-features="errors,replay,advanced"\n` +
     `          ${MARKER}\n` +
     `        />\n`
   );

package/scripts/patches/nextjs-pages.patch.cjs

@@ -54,6 +54,7 @@ function buildHook(injection) {
     `    s.setAttribute('data-gurulu-site-id', ${JSON.stringify(injection.siteId)});\n` +
     `    s.setAttribute('data-gurulu-tenant-id', ${JSON.stringify(injection.tenantId)});\n` +
     pkLine +
+    `    s.setAttribute('data-features', 'errors,replay,advanced');\n` +
     `    document.head.appendChild(s);\n` +
     `  }, []);\n`
   );

package/scripts/patches/remix.patch.cjs

@@ -36,6 +36,7 @@ function buildScriptTag(injection) {
     `          data-gurulu-site-id=${JSON.stringify(injection.siteId)}\n` +
     `          data-gurulu-tenant-id=${JSON.stringify(injection.tenantId)}\n` +
     pkAttr +
+    `          data-features="errors,replay,advanced"\n` +
     `          ${MARKER}\n` +
     `          async\n` +
     `        />\n`

package/scripts/patches/sveltekit.patch.cjs

@@ -33,6 +33,7 @@ function buildScriptTag(injection) {
     `      src="${injection.scriptSrc}"\n` +
     `      data-gurulu-site-id="${injection.siteId}"\n` +
     `      data-gurulu-tenant-id="${injection.tenantId}"${pkAttr}\n` +
+    `      data-features="errors,replay,advanced"\n` +
     `      ${MARKER}\n` +
     `      async\n` +
     `    ></script>\n`

package/scripts/patches/vite-react.patch.cjs

@@ -35,6 +35,7 @@ function buildBootstrap(injection) {
     `  s.setAttribute('data-gurulu-install', '1');\n` +
     `  s.setAttribute('data-gurulu-site-id', ${JSON.stringify(injection.siteId)});\n` +
     pkLine +
+    `  s.setAttribute('data-features', 'errors,replay,advanced');\n` +
     `  document.head.appendChild(s);\n` +
     `}\n`
   );

package/scripts/patches/vue.patch.cjs

@@ -48,6 +48,7 @@ function buildScriptTag(injection) {
     `      src="${injection.scriptSrc}"\n` +
     `      data-gurulu-site-id="${injection.siteId}"\n` +
     `      data-gurulu-tenant-id="${injection.tenantId}"${pkAttr}\n` +
+    `      data-features="errors,replay,advanced"\n` +
     `      ${MARKER}\n` +
     `      async\n` +
     `    ></script>\n`