@gurulu/cli 0.4.2 → 0.4.3

package/dist/commands/install.js

@@ -48,6 +48,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveWorkspaceRoot = resolveWorkspaceRoot;
 exports.resolveScriptsDir = resolveScriptsDir;
 exports.detectPackageManager = detectPackageManager;
 exports.packageInstallArgs = packageInstallArgs;
@@ -68,6 +69,90 @@ const config_1 = require("../config");
 const api_client_1 = require("../api-client");
 const install_intent_proposal_1 = require("../install-intent-proposal");
 // ---------------------------------------------------------------------------
+// Sprint E1.5 — Workspace resolution.
+//
+// Many fresh repos are npm/pnpm/yarn workspaces (Turborepo, Nx, Bun, etc).
+// Running `gurulu install` from the repo root is ambiguous: should we patch
+// the `apps/web/` Next.js app, the `apps/admin/` dashboard, or one of the
+// `packages/*` libraries? When package.json declares >=2 workspace globs we
+// either (a) honour `--workspace=<path>` if set, or (b) prompt the user
+// interactively. The resolved path becomes `repoRoot` for the rest of the
+// install flow.
+// ---------------------------------------------------------------------------
+function expandWorkspaceGlobs(repoRoot, globs) {
+    const out = [];
+    for (const g of globs) {
+        // Accept only the simple `dir/*` and bare `dir` forms — anything fancier
+        // (negation, `**`, alternation) falls through to the manual prompt.
+        if (g.includes('**') || g.startsWith('!'))
+            continue;
+        if (g.endsWith('/*')) {
+            const parent = path.join(repoRoot, g.slice(0, -2));
+            if (!fs.existsSync(parent))
+                continue;
+            try {
+                for (const entry of fs.readdirSync(parent)) {
+                    const abs = path.join(parent, entry);
+                    if (fs.statSync(abs).isDirectory() &&
+                        fs.existsSync(path.join(abs, 'package.json'))) {
+                        out.push(abs);
+                    }
+                }
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        else {
+            const abs = path.join(repoRoot, g);
+            if (fs.existsSync(abs) && fs.existsSync(path.join(abs, 'package.json'))) {
+                out.push(abs);
+            }
+        }
+    }
+    return out;
+}
+async function resolveWorkspaceRoot(repoRoot, args, deps) {
+    const pkgPath = path.join(repoRoot, 'package.json');
+    if (!fs.existsSync(pkgPath))
+        return repoRoot;
+    let pkg;
+    try {
+        pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    }
+    catch {
+        return repoRoot;
+    }
+    let globs = null;
+    if (Array.isArray(pkg.workspaces))
+        globs = pkg.workspaces;
+    else if (pkg.workspaces && Array.isArray(pkg.workspaces.packages))
+        globs = pkg.workspaces.packages;
+    if (!globs || globs.length === 0)
+        return repoRoot;
+    const candidates = expandWorkspaceGlobs(repoRoot, globs);
+    if (candidates.length <= 1)
+        return repoRoot;
+    if (args.workspace) {
+        const target = path.resolve(repoRoot, args.workspace);
+        if (candidates.some((c) => path.resolve(c) === target))
+            return target;
+        log(deps, 'warn', `--workspace=${args.workspace} not found among workspace packages.`);
+    }
+    if (args.yes) {
+        log(deps, 'warn', `Multiple workspaces detected (${candidates.length}); pass --workspace=<path> next time.`);
+        return repoRoot;
+    }
+    log(deps, 'info', 'Multiple workspaces detected:');
+    candidates.forEach((c, i) => log(deps, 'info', `  [${i + 1}] ${path.relative(repoRoot, c)}`));
+    const answer = (await deps.prompt('  Select workspace [1]: ')).trim() || '1';
+    const idx = parseInt(answer, 10) - 1;
+    if (Number.isFinite(idx) && idx >= 0 && idx < candidates.length) {
+        return candidates[idx];
+    }
+    return repoRoot;
+}
+// ---------------------------------------------------------------------------
 // Script resolution
 // ---------------------------------------------------------------------------
 /**
@@ -140,6 +225,38 @@ function mergeEnvFile(repoRoot, framework, vars) {
     return { file: filename, added, skipped };
 }
 // ---------------------------------------------------------------------------
+// Sprint E2.2 — Fetch canonical install prompt from server endpoint.
+// ---------------------------------------------------------------------------
+async function fetchInstallPrompt(opts) {
+    const fallback = `I have Gurulu analytics installed. Site ID: ${opts.siteId}\n` +
+        `Analyze my codebase and add gurulu.track() calls to\n` +
+        `important user actions: signups, purchases, form submits,\n` +
+        `button clicks, and key conversions. Use the Gurulu MCP\n` +
+        `server (@gurulu/mcp-server) for live event verification.\n` +
+        `Docs: https://gurulu.io/docs/quick-start`;
+    if (!opts.authToken || !opts.siteId)
+        return fallback;
+    try {
+        const url = new URL('/api/cli/install/prompt', opts.ingestUrl);
+        url.searchParams.set('siteId', opts.siteId);
+        if (opts.framework)
+            url.searchParams.set('framework', opts.framework);
+        const res = await globalThis.fetch(url.toString(), {
+            headers: { authorization: `Bearer ${opts.authToken}` },
+        });
+        if (!res.ok)
+            return fallback;
+        const body = await res.json();
+        if (body && typeof body.prompt === 'string' && body.prompt.length > 0) {
+            return body.prompt;
+        }
+        return fallback;
+    }
+    catch {
+        return fallback;
+    }
+}
+// ---------------------------------------------------------------------------
 // Default dependency implementations (real spawn + real fetch)
 // ---------------------------------------------------------------------------
 function createDefaultDeps(scriptsDir) {
@@ -251,7 +368,11 @@ function getEnvPrefix(framework) {
     return ''; // Express, Fastify, NestJS don't need prefix
 }
 async function runInstallFlow(args, deps, scriptsDir) {
-    const repoRoot = path.resolve(args.path || process.cwd());
+    const initialRoot = path.resolve(args.path || process.cwd());
+    // Sprint E1.5 — workspace resolution. When the project is a multi-package
+    // workspace, narrow `repoRoot` to the chosen workspace package so scan,
+    // patches, .env merge, and npm install all target the right place.
+    const repoRoot = await resolveWorkspaceRoot(initialRoot, args, deps);
     const summary = {
         scan: null,
         framework: null,
@@ -390,12 +511,27 @@ async function runInstallFlow(args, deps, scriptsDir) {
             }
         }
         const applyRes = await deps.runNode(applyArgs);
+        // Sprint E1.1 — exit code 5 means the agentic-install script auto-rolled
+        // back due to an auto-instrument failure. Mark the summary as rolled back
+        // and skip the npm install / .env merge / ingest ping blocks so the user
+        // isn't left with a half-installed setup.
+        if (applyRes.code === 5) {
+            summary.rolledBack = true;
+            summary.partiallyInstalled = false;
+            log(deps, 'warn', '⚠ Install rolled back (auto-instrument failed; script tag reverted).');
+            return summary;
+        }
         if (applyRes.code !== 0) {
             const msg = `Apply failed (exit ${applyRes.code}): ${applyRes.stderr.trim()}`;
             summary.errors.push(msg);
             log(deps, 'error', msg);
             return summary;
         }
+        // Sprint E1.7 — record components that were successfully installed for
+        // partial-install diagnostics in the summary.
+        summary.installedComponents = ['script-tag', 'patch-log'];
+        if (args.autoInstrument)
+            summary.installedComponents.push('auto-instrument');
         // Parse the machine-readable auto-instrument result line if present.
         if (args.autoInstrument) {
             const lines = (applyRes.stdout || '').split('\n');
@@ -427,6 +563,29 @@ async function runInstallFlow(args, deps, scriptsDir) {
             }
         }
         log(deps, 'success', 'Patches applied.');
+        // Sprint E5.2 — wire a `postbuild` script for Next.js projects so the
+        // CLI's sourcemap uploader runs automatically after every `next build`.
+        // We only touch package.json when the framework is Next.js AND the user
+        // hasn't already defined a `postbuild` (idempotent).
+        if (detectedFw && detectedFw.startsWith('nextjs')) {
+            try {
+                const pkgPath = path.join(repoRoot, 'package.json');
+                if (fs.existsSync(pkgPath)) {
+                    const raw = fs.readFileSync(pkgPath, 'utf8');
+                    const pkgJson = JSON.parse(raw);
+                    pkgJson.scripts = pkgJson.scripts || {};
+                    if (!pkgJson.scripts.postbuild) {
+                        pkgJson.scripts.postbuild =
+                            'gurulu sourcemap upload --release ${npm_package_version} --dir .next/static/chunks';
+                        fs.writeFileSync(pkgPath, JSON.stringify(pkgJson, null, 2) + '\n');
+                        log(deps, 'info', 'Added `postbuild` script for sourcemap upload.');
+                    }
+                }
+            }
+            catch (err) {
+                log(deps, 'warn', `Could not add postbuild script: ${err.message}`);
+            }
+        }
     }
     else {
         if (args.autoInstrument) {
@@ -575,13 +734,21 @@ async function runInstallFlow(args, deps, scriptsDir) {
         console.log('');
         log(deps, 'info', `  ${(0, ui_1.dim)('Or paste this prompt into your AI assistant:')}`);
         console.log('');
+        // Sprint E2.2 — fetch the canonical install prompt from the server so
+        // edits land in `src/lib/cli/install-prompt.ts` (the single source of
+        // truth) instead of being duplicated in three places. We fall back to a
+        // tiny inline body when the endpoint is unreachable or unauthenticated
+        // so legacy installs still see something useful.
+        const promptText = await fetchInstallPrompt({
+            siteId,
+            ingestUrl: args.ingestUrl || process.env.GURULU_INGEST_URL || 'https://gurulu.io',
+            authToken: args.authToken,
+            framework: summary.framework || undefined,
+        });
         console.log((0, ui_1.dim)('  ┌─────────────────────────────────────────────'));
-        console.log((0, ui_1.dim)('  │ ') + 'I have Gurulu analytics installed. Site ID: ' + (0, ui_1.cyan)(siteId));
-        console.log((0, ui_1.dim)('  │ ') + 'Analyze my codebase and add gurulu.track() calls to');
-        console.log((0, ui_1.dim)('  │ ') + 'important user actions: signups, purchases, form submits,');
-        console.log((0, ui_1.dim)('  │ ') + 'button clicks, and key conversions. Use the Gurulu MCP');
-        console.log((0, ui_1.dim)('  │ ') + 'server (@gurulu/mcp-server) for live event verification.');
-        console.log((0, ui_1.dim)('  │ ') + 'Docs: https://gurulu.io/docs/quick-start');
+        for (const line of promptText.split('\n')) {
+            console.log((0, ui_1.dim)('  │ ') + line);
+        }
         console.log((0, ui_1.dim)('  └─────────────────────────────────────────────'));
         console.log('');
         // Goals & funnels management
@@ -726,7 +893,13 @@ async function runAuthenticatedInstallFlow(args, authDeps, installDeps, scriptsD
                     installDeps.log?.warn(`Intent analyzer failed: ${err.message}`);
                     installDeps.log?.warn('⚠ Falling back to built-in generic event set.');
                     intentRecord.error = `analyze_failed:${err.message}`;
-                    intentRecord.analyzed = true; // Mark as analyzed so auto-instrument proceeds
+                    // Sprint E1.2 — distinguish "analyzer ran" from "fallback was used".
+                    // `analyzed=false` so callers can detect that the LLM/heuristic
+                    // analyzer never produced a real result; `analyze_status='fallback'`
+                    // tells them the install still proceeded with a baked-in event set
+                    // instead of failing outright.
+                    intentRecord.analyzed = false;
+                    intentRecord.analyze_status = 'fallback';
                     // Client-side fallback: produce a minimal generic intent so
                     // auto-instrument and pre-seed still work even when the API is down.
                     intent = {
@@ -819,7 +992,11 @@ async function runAuthenticatedInstallFlow(args, authDeps, installDeps, scriptsD
     let autoInstrumentEnabled = !!args.autoInstrument;
     let intentResultPath;
     if (autoInstrumentEnabled) {
-        if (!intentRecord.analyzed || !intentRecord.accepted || intentRecord.accepted.events === 0) {
+        // Sprint E1.2 — accept either `analyzed=true` OR a fallback intent so
+        // auto-instrument still proceeds when the analyzer crashed and we fell
+        // back to the built-in generic event set.
+        const intentUsable = intentRecord.analyzed || intentRecord.analyze_status === 'fallback';
+        if (!intentUsable || !intentRecord.accepted || intentRecord.accepted.events === 0) {
             installDeps.log?.warn('Auto-instrument requested but no accepted events from intent discovery; disabling.');
             autoInstrumentEnabled = false;
         }

package/dist/commands/releases.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Sprint E SE-B — `gurulu releases list`.
+ *
+ * Mirror of MCP `gurulu.releases.list`. Returns recent releases with
+ * crash-free session %, adoption, and regression deltas.
+ */
+export interface ReleasesArgs {
+    action?: string;
+    site?: string;
+    range?: string;
+    environment?: string;
+    limit?: number;
+    format?: string;
+    json?: boolean;
+    profile?: string;
+}
+export declare function releasesCommand(args: ReleasesArgs): Promise<void>;

package/dist/commands/releases.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Sprint E SE-B — `gurulu releases list`.
+ *
+ * Mirror of MCP `gurulu.releases.list`. Returns recent releases with
+ * crash-free session %, adoption, and regression deltas.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.releasesCommand = releasesCommand;
+const api_client_1 = require("../api-client");
+const ui_1 = require("../utils/ui");
+async function releasesCommand(args) {
+    const action = args.action || 'list';
+    switch (action) {
+        case 'list':
+            return listCmd(args);
+        default:
+            (0, ui_1.error)(`Unknown releases action: ${action}`);
+            (0, ui_1.info)('Usage: gurulu releases list --site=<id> [--limit=20] [--range=7d|30d]');
+            process.exit(1);
+    }
+}
+async function listCmd(args) {
+    if (!args.site) {
+        (0, ui_1.error)('Usage: gurulu releases list --site=<id> [--limit=20]');
+        process.exit(1);
+    }
+    const usp = new URLSearchParams();
+    usp.set('site', args.site);
+    if (args.range)
+        usp.set('range', args.range);
+    if (args.environment)
+        usp.set('environment', args.environment);
+    if (args.limit)
+        usp.set('limit', String(args.limit));
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/releases?${usp.toString()}`, {
+        profile: args.profile,
+    });
+    if (args.format === 'table') {
+        const rows = body.releases || [];
+        process.stdout.write(['VERSION', 'SESSIONS', 'CRASH_FREE_%', 'USERS', 'ERRORS'].join('\t') + '\n');
+        for (const r of rows) {
+            process.stdout.write([
+                r.version ?? '-',
+                r.totalSessions ?? 0,
+                r.crashFreeSessionRate?.toFixed?.(2) ?? r.crashFreeSessionRate ?? '-',
+                r.totalUsers ?? 0,
+                r.errorCount ?? 0,
+            ].join('\t') + '\n');
+        }
+        return;
+    }
+    process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+}

package/dist/commands/replay.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Sprint E SE-B — `gurulu replay list|get`.
+ *
+ * Mirror of MCP `gurulu.replay.list` / `.get`. Hits new `/api/cli/replay/*`
+ * proxy endpoints with CLI-auth.
+ */
+export interface ReplayArgs {
+    action?: string;
+    site?: string;
+    sessionId?: string;
+    range?: string;
+    hasError?: boolean;
+    limit?: number;
+    format?: string;
+    json?: boolean;
+    profile?: string;
+}
+export declare function replayCommand(args: ReplayArgs): Promise<void>;

package/dist/commands/replay.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Sprint E SE-B — `gurulu replay list|get`.
+ *
+ * Mirror of MCP `gurulu.replay.list` / `.get`. Hits new `/api/cli/replay/*`
+ * proxy endpoints with CLI-auth.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replayCommand = replayCommand;
+const api_client_1 = require("../api-client");
+const ui_1 = require("../utils/ui");
+async function replayCommand(args) {
+    const action = args.action || 'list';
+    switch (action) {
+        case 'list':
+            return listCmd(args);
+        case 'get':
+            return getCmd(args);
+        default:
+            (0, ui_1.error)(`Unknown replay action: ${action}`);
+            (0, ui_1.info)('Usage: gurulu replay [list|get] --site=<id> [--session-id=<id>]');
+            process.exit(1);
+    }
+}
+async function listCmd(args) {
+    if (!args.site) {
+        (0, ui_1.error)('Usage: gurulu replay list --site=<id> [--range=7d|30d] [--limit=20]');
+        process.exit(1);
+    }
+    const usp = new URLSearchParams();
+    usp.set('site', args.site);
+    if (args.range)
+        usp.set('range', args.range);
+    if (args.hasError !== undefined)
+        usp.set('hasError', String(args.hasError));
+    if (args.limit)
+        usp.set('limit', String(args.limit));
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/replay?${usp.toString()}`, {
+        profile: args.profile,
+    });
+    if (args.format === 'table') {
+        const rows = body.sessions || [];
+        process.stdout.write(['SESSION', 'STARTED', 'DURATION', 'ERRORS', 'SEGMENTS'].join('\t') + '\n');
+        for (const s of rows) {
+            process.stdout.write([
+                s.sessionId ?? s.id ?? '-',
+                String(s.startedAt ?? '-'),
+                String(s.duration ?? 0),
+                s.hasError ? 'yes' : 'no',
+                String(s.segments ?? 0),
+            ].join('\t') + '\n');
+        }
+        return;
+    }
+    process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+}
+async function getCmd(args) {
+    if (!args.site || !args.sessionId) {
+        (0, ui_1.error)('Usage: gurulu replay get --site=<id> --session-id=<id>');
+        process.exit(1);
+    }
+    const body = await (0, api_client_1.cliApiJson)(`/api/cli/replay/${encodeURIComponent(args.sessionId)}?site=${encodeURIComponent(args.site)}`, { profile: args.profile });
+    process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+}

package/dist/commands/skad.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Sprint E SE-B — `gurulu skad postbacks`.
+ *
+ * Mirror of MCP `gurulu.skad.list_postbacks`. Backend already exists at
+ * `/api/cli/skad` (Sprint C C9).
+ */
+export interface SkadArgs {
+    action?: string;
+    site?: string;
+    from?: string;
+    to?: string;
+    goal?: string;
+    limit?: number;
+    format?: string;
+    json?: boolean;
+    profile?: string;
+}
+export declare function skadCommand(args: SkadArgs): Promise<void>;

package/dist/commands/skad.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Sprint E SE-B — `gurulu skad postbacks`.
+ *
+ * Mirror of MCP `gurulu.skad.list_postbacks`. Backend already exists at
+ * `/api/cli/skad` (Sprint C C9).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skadCommand = skadCommand;
+const api_client_1 = require("../api-client");
+const ui_1 = require("../utils/ui");
+async function skadCommand(args) {
+    const action = args.action || '';
+    switch (action) {
+        case 'postbacks':
+            return postbacksCmd(args);
+        default:
+            (0, ui_1.error)(`Unknown skad action: ${action}`);
+            (0, ui_1.info)('Usage: gurulu skad postbacks --site=<id> [--from=...] [--goal=$purchase] [--limit=50]');
+            process.exit(1);
+    }
+}
+async function postbacksCmd(args) {
+    const usp = new URLSearchParams();
+    if (args.site)
+        usp.set('site', args.site);
+    if (args.from)
+        usp.set('from', args.from);
+    if (args.to)
+        usp.set('to', args.to);
+    if (args.goal)
+        usp.set('goal', args.goal);
+    if (args.limit)
+        usp.set('limit', String(args.limit));
+    const path = `/api/cli/skad${usp.toString() ? `?${usp.toString()}` : ''}`;
+    const body = await (0, api_client_1.cliApiJson)(path, { profile: args.profile });
+    if (args.format === 'table') {
+        const rows = body.postbacks || [];
+        process.stdout.write(['RECEIVED', 'NETWORK', 'GOAL', 'CV', 'WIN', 'VERIFIED'].join('\t') + '\n');
+        for (const p of rows) {
+            process.stdout.write([
+                String(p.received_at ?? '-'),
+                p.ad_network_id ?? '-',
+                p.resolved_goal ?? '-',
+                String(p.conversion_value ?? '-'),
+                p.did_win ? 'yes' : 'no',
+                p.signature_verified ? 'yes' : 'no',
+            ].join('\t') + '\n');
+        }
+        return;
+    }
+    process.stdout.write(JSON.stringify(body, null, 2) + '\n');
+}

package/dist/frameworks/detect.d.ts

@@ -1,4 +1,4 @@
-export type Framework = 'nextjs-app' | 'nextjs-pages' | 'react-vite' | 'react-cra' | 'vue3' | 'nuxt3' | 'svelte' | 'sveltekit' | 'astro' | 'express' | 'nestjs' | 'html' | 'react-native' | 'ios-swift' | 'android-kotlin' | 'flutter' | 'unknown';
+export type Framework = 'nextjs-app' | 'nextjs-pages' | 'react-vite' | 'react-cra' | 'vue3' | 'nuxt3' | 'svelte' | 'sveltekit' | 'astro' | 'express' | 'fastify' | 'hono' | 'nestjs' | 'html' | 'react-native' | 'ios-swift' | 'android-kotlin' | 'flutter' | 'unknown';
 export declare function detectFramework(projectDir: string): Framework;
 export declare function getSetupSnippet(framework: Framework, siteId: string, token: string): {
     file: string;

package/dist/frameworks/detect.js

@@ -75,6 +75,10 @@ function detectFramework(projectDir) {
         return 'react-vite';
     if (deps['react-scripts'])
         return 'react-cra';
+    if (deps['fastify'])
+        return 'fastify';
+    if (deps['hono'])
+        return 'hono';
     if (deps['express'])
         return 'express';
     return 'unknown';
@@ -253,6 +257,60 @@ export function guruluMiddleware(req: Request, res: Response, next: NextFunction
 }`,
                 instruction: 'Add app.use(guruluMiddleware) in your Express app',
             };
+        case 'fastify':
+            return {
+                file: 'src/gurulu.ts',
+                code: `// Gurulu.io Server Analytics — Fastify plugin
+import type { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify';
+
+const SITE_ID = '${siteId}';
+const TOKEN = '${token}';
+
+export async function guruluPlugin(fastify: FastifyInstance) {
+  fastify.addHook('onRequest', async (req: FastifyRequest, _reply: FastifyReply) => {
+    fetch('https://ingest.gurulu.io/api/events', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer ' + TOKEN },
+      body: JSON.stringify({
+        site_id: SITE_ID,
+        event: 'pageview',
+        url: req.url,
+        referrer: (req.headers.referer as string) || '',
+        user_agent: (req.headers['user-agent'] as string) || '',
+        ip: req.ip,
+        timestamp: new Date().toISOString(),
+      }),
+    }).catch(() => {});
+  });
+}`,
+                instruction: 'Register with fastify.register(guruluPlugin) in your Fastify app',
+            };
+        case 'hono':
+            return {
+                file: 'src/gurulu.ts',
+                code: `// Gurulu.io Server Analytics — Hono middleware
+import type { MiddlewareHandler } from 'hono';
+
+const SITE_ID = '${siteId}';
+const TOKEN = '${token}';
+
+export const guruluMiddleware: MiddlewareHandler = async (c, next) => {
+  fetch('https://ingest.gurulu.io/api/events', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer ' + TOKEN },
+    body: JSON.stringify({
+      site_id: SITE_ID,
+      event: 'pageview',
+      url: c.req.url,
+      referrer: c.req.header('referer') || '',
+      user_agent: c.req.header('user-agent') || '',
+      timestamp: new Date().toISOString(),
+    }),
+  }).catch(() => {});
+  await next();
+};`,
+                instruction: 'Add app.use(guruluMiddleware) in your Hono app',
+            };
         case 'nestjs':
             return {
                 file: 'src/gurulu.middleware.ts',
@@ -372,6 +430,8 @@ function getFrameworkDisplayName(fw) {
         'sveltekit': 'SvelteKit',
         'astro': 'Astro',
         'express': 'Express',
+        'fastify': 'Fastify',
+        'hono': 'Hono',
         'nestjs': 'NestJS',
         'html': 'HTML',
         'react-native': 'React Native',