vybekiit 0.7.26 → 0.7.28

package/dist/global-skills/instrument-product-analytics/references/react-router-v7-framework-mode.md

@@ -1,10 +1,6 @@
 > AI agents: this is one page from PostHog's docs. Full index of Markdown docs for LLMs: https://posthog.com/llms.txt
 
-# React Router V7 framework mode (Remix V3) - Docs
-
-Copy page
-
-# React Router V7 framework mode (Remix V3) - Docs
+# React Router V7 framework mode (Remix V3)
 
 This guide walks you through setting up PostHog for React Router V7 in framework mode. If you're using React Router in another mode, find the guide for that mode in the [React Router page](/docs/libraries/react-router.md). If you're using React with another framework, go to the [React integration guide](/docs/libraries/react.md).
 
@@ -16,8 +12,6 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
     First, you'll need to install [`posthog-js`](https://github.com/posthog/posthog-js) and `@posthog/react` using your package manager. These packages allow you to capture **client-side** events.
 
-    PostHog AI
-
     ### npm
 
     ```bash
@@ -44,8 +38,6 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
     > **If your site sets a Content-Security-Policy**, it needs to allow PostHog. This applies to the snippet and to package installs alike: the SDK lazy-loads extra bundles (session replay, surveys) from PostHog's CDN, and sends events to the ingestion host. PostHog serves from subdomains of `posthog.com` that change over time, so allow the wildcard:
     >
-    > PostHog AI
-    >
     > ```
     > script-src 'self' https://*.posthog.com;
     > connect-src 'self' https://*.posthog.com;
@@ -58,10 +50,9 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
     vite.config.ts
 
-    PostHog AI
-
     ```typescript
     // ... imports
+    
     export default defineConfig({
       plugins: [tailwindcss(), reactRouter(), tsconfigPaths()],
       ssr: {
@@ -80,8 +71,6 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
     .env.local
 
-    PostHog AI
-
     ```shell
     VITE_POSTHOG_PROJECT_TOKEN=<ph_project_token>
     VITE_POSTHOG_HOST=https://us.i.posthog.com
@@ -97,19 +86,21 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
     app/entry.client.tsx
 
-    PostHog AI
-
     ```jsx
     import { startTransition, StrictMode } from "react";
     import { hydrateRoot } from "react-dom/client";
     import { HydratedRouter } from "react-router/dom";
+    
     import posthog from 'posthog-js';
     import { PostHogProvider } from '@posthog/react'
+    
     posthog.init(import.meta.env.VITE_POSTHOG_PROJECT_TOKEN, {
       api_host: import.meta.env.VITE_POSTHOG_HOST,
       defaults: '2026-05-30',
       tracing_headers: [ window.location.hostname, 'localhost' ],
     });
+    
+    
     startTransition(() => {
       hydrateRoot(
         document,
@@ -133,11 +124,10 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
     React
 
-    PostHog AI
-
     ```jsx
     useEffect(() => {
       posthog?.capture('test') // using optional chaining (recommended)
+    
       if (posthog) {
         posthog.capture('test') // using an if statement
       }
@@ -158,10 +148,9 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
     TSX
 
-    PostHog AI
-
     ```jsx
     import { usePostHog } from '@posthog/react'
+    
     function App() {
       const posthog = usePostHog()
       return <button onClick={() => posthog?.capture('button_clicked')}>Click me</button>
@@ -180,10 +169,9 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
     TSX
 
-    PostHog AI
-
     ```jsx
     import { usePostHog } from '@posthog/react'
+    
     function App() {
       const posthog = usePostHog()
       return <button onClick={() => posthog?.capture('button_clicked')}>Click me</button>
@@ -204,15 +192,15 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
     TSX
 
-    PostHog AI
-
     ```jsx
     export default function Login() {
       const { user, login } = useAuth();
       const posthog = usePostHog();
+    
       const handleLogin = async (e: React.FormEvent) => {
         // existing code to handle login...
         const user = await login({ email, password });
+    
         posthog?.identify(user.email,
           {
             email: user.email,
@@ -221,6 +209,7 @@ This guide walks you through setting up PostHog for React Router V7 in framework
         );
         posthog?.capture('user_logged_in');
       };
+    
       return (
         <div>
           {/* ... existing code ... */}
@@ -242,13 +231,13 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
     app/root.tsx
 
-    PostHog AI
-
     ```jsx
     import { usePostHog } from '@posthog/react'
+    
     export function ErrorBoundary({ error }: Route.ErrorBoundaryProps) {
       const posthog = usePostHog();
       posthog?.captureException(error);
+    
       // other error handling code...
       return (
         <div>
@@ -275,10 +264,9 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
     React
 
-    PostHog AI
-
     ```jsx
     import { PostHogCaptureOnViewed } from '@posthog/react'
+    
     function App() {
         return (
             <PostHogCaptureOnViewed name="hero-banner">
@@ -294,8 +282,6 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
     React
 
-    PostHog AI
-
     ```jsx
     <PostHogCaptureOnViewed
         name="product-card"
@@ -315,8 +301,6 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
     React
 
-    PostHog AI
-
     ```jsx
     <PostHogCaptureOnViewed
         name="product-gallery"
@@ -337,8 +321,6 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
     React
 
-    PostHog AI
-
     ```jsx
     <PostHogCaptureOnViewed
         name="footer"
@@ -361,8 +343,6 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
     Install the [PostHog Node SDK](/docs/libraries/node.md) using your package manager. This is the SDK you'll use to capture server-side events.
 
-    PostHog AI
-
     ### npm
 
     ```bash
@@ -401,29 +381,34 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
      app/lib/posthog-middleware.ts
 
-     PostHog AI
-
      ```typescript
      import { PostHog } from "posthog-node";
      import type { RouterContextProvider } from "react-router";
      import type { Route } from "../+types/root";
+     
      export interface PostHogContext extends RouterContextProvider {
        posthog?: PostHog;
      }
+     
      export const posthogMiddleware: Route.MiddlewareFunction = async ({ request, context }, next) => {
        const posthog = new PostHog(process.env.VITE_POSTHOG_PROJECT_TOKEN!, {
          host: process.env.VITE_POSTHOG_HOST!,
          flushAt: 1,
          flushInterval: 0,
        });
+     
        const sessionId = request.headers.get('X-POSTHOG-SESSION-ID');
        const distinctId = request.headers.get('X-POSTHOG-DISTINCT-ID');
+     
        (context as PostHogContext).posthog = posthog;
+     
        const response = await posthog.withContext(
          { sessionId: sessionId ?? undefined, distinctId: distinctId ?? undefined },
          next
        );
+     
        await posthog.shutdown().catch(() => {});
+     
        return response;
      };
      ```
@@ -432,10 +417,9 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
      app/root.tsx
 
-     PostHog AI
-
      ```jsx
      import { posthogMiddleware } from './lib/posthog-middleware';
+     
      export const middleware: Route.MiddlewareFunction[] = [
        posthogMiddleware,
        // other middlewares...
@@ -454,16 +438,17 @@ This guide walks you through setting up PostHog for React Router V7 in framework
 
      app/routes/api.checkout.ts
 
-     PostHog AI
-
      ```jsx
      import type { PostHogContext } from "../lib/posthog-middleware";
+     
      export async function action({ request, context }: Route.ActionArgs) {
        const body = await request.json();
        // ... existing code ...
+     
        // Access the PostHog client from the context and capture an event
        const posthog = (context as PostHogContext).posthog;
        posthog?.capture({ event: 'checkout_completed' });
+     
        return Response.json({
          success: true,
          // ... existing code ...

package/dist/global-skills/instrument-product-analytics/references/ruby-on-rails.md

@@ -1,10 +1,6 @@
 > AI agents: this is one page from PostHog's docs. Full index of Markdown docs for LLMs: https://posthog.com/llms.txt
 
-# Ruby on Rails - Docs
-
-Copy page
-
-# Ruby on Rails - Docs
+# Ruby on Rails
 
 PostHog makes it easy to get data about traffic and usage of your Ruby on Rails app. Integrating PostHog enables analytics, custom event capture, feature flags, and automatic exception tracking.
 
@@ -36,8 +32,6 @@ Add both gems to your Gemfile:
 
 Gemfile
 
-PostHog AI
-
 ```ruby
 gem 'posthog-ruby', require: 'posthog'
 gem 'posthog-rails'
@@ -47,8 +41,6 @@ Then run:
 
 Terminal
 
-PostHog AI
-
 ```bash
 bundle install
 ```
@@ -65,8 +57,6 @@ Run the install generator to create the PostHog initializer:
 
 Terminal
 
-PostHog AI
-
 ```bash
 rails generate posthog:install
 ```
@@ -81,8 +71,6 @@ The generated initializer includes the most common options:
 
 config/initializers/posthog.rb
 
-PostHog AI
-
 ```ruby
 # Rails-specific configuration
 PostHog::Rails.configure do |config|
@@ -93,35 +81,46 @@ PostHog::Rails.configure do |config|
   config.capture_user_context = true              # Include authenticated user info in exceptions (default: true)
   config.current_user_method = :current_user      # Method to get current user (default: :current_user)
   config.user_id_method = nil                     # Method to get ID from user object (default: auto-detect)
+
   # Add additional exceptions to ignore
   config.excluded_exceptions = ['MyCustomError']
 end
+
 # Core PostHog client initialization
 PostHog.init do |config|
   # Required: Your PostHog project API key
   config.api_key = '<ph_project_token>'
+
   # Optional: Your PostHog instance URL
   config.host = 'https://us.i.posthog.com'
+
   # Optional: Personal API key for feature flags
   config.personal_api_key = 'phx_xxxxxxxxx'
+
   # Maximum number of events to queue before dropping (default: 10000)
   config.max_queue_size = 10_000
+
   # Send events synchronously on the calling thread (default: false)
   config.sync_mode = false
+
   # Feature flags polling interval in seconds (default: 30)
   config.feature_flags_polling_interval = 30
+
   # Feature flag request timeout in seconds (default: 3)
   config.feature_flag_request_timeout_seconds = 3
+
   # Error callback to detect misconfiguration
   config.on_error = proc { |status, msg|
     Rails.logger.error("PostHog error: #{msg}")
   }
+
   # Before-send callback to modify or drop events
   config.before_send = proc { |event|
     event[:properties] ||= {}
     event[:properties]['environment'] = Rails.env
     event
   }
+
   # Disable network calls in test mode
   config.test_mode = true if Rails.env.test?
 end
@@ -133,16 +132,12 @@ You can find your project token and instance address in [your project settings](
 >
 > Terminal
 >
-> PostHog AI
->
 > ```bash
 > rails credentials:edit
 > ```
 >
 > config/credentials.yml.enc
 >
-> PostHog AI
->
 > ```yaml
 > posthog:
 >   api_key: <ph_project_token>
@@ -152,8 +147,6 @@ You can find your project token and instance address in [your project settings](
 >
 > config/initializers/posthog.rb
 >
-> PostHog AI
->
 > ```ruby
 > config.api_key = Rails.application.credentials.posthog[:api_key]
 > config.host = Rails.application.credentials.posthog[:host]
@@ -166,8 +159,6 @@ Track custom events anywhere in your Rails app:
 
 Ruby
 
-PostHog AI
-
 ```ruby
 PostHog.capture({
   distinct_id: current_user.id,
@@ -180,8 +171,6 @@ Identify a user and set their person properties:
 
 Ruby
 
-PostHog AI
-
 ```ruby
 PostHog.identify({
   distinct_id: current_user.id,
@@ -208,8 +197,6 @@ Disable tracing header identity/session capture if you do not want client-suppli
 
 Ruby
 
-PostHog AI
-
 ```ruby
 PostHog::Rails.config.use_tracing_headers = false
 ```
@@ -228,8 +215,6 @@ When `auto_capture_exceptions` is enabled, exceptions are automatically captured
 
 Ruby
 
-PostHog AI
-
 ```ruby
 class PostsController < ApplicationController
   def show
@@ -247,8 +232,6 @@ You can also manually capture exceptions:
 
 Ruby
 
-PostHog AI
-
 ```ruby
 PostHog.capture_exception(
   exception,
@@ -261,10 +244,9 @@ If you evaluated feature flags for the request, pass the same snapshot to includ
 
 Ruby
 
-PostHog AI
-
 ```ruby
 flags = PostHog.evaluate_flags(current_user.id)
+
 PostHog.capture_exception(
   exception,
   current_user.id,
@@ -279,8 +261,6 @@ When `auto_instrument_active_job` is enabled, ActiveJob exceptions are automatic
 
 Ruby
 
-PostHog AI
-
 ```ruby
 class EmailJob < ApplicationJob
   def perform(user_id)
@@ -297,8 +277,6 @@ By default, PostHog extracts a `distinct_id` from job arguments by looking for a
 
 Ruby
 
-PostHog AI
-
 ```ruby
 # PostHog will automatically use options[:user_id] as the distinct_id
 ProcessOrderJob.perform_later(order.id, user_id: current_user.id)
@@ -308,11 +286,10 @@ For more control, use the `posthog_distinct_id` class method. The proc or block
 
 Ruby
 
-PostHog AI
-
 ```ruby
 class SendWelcomeEmailJob < ApplicationJob
   posthog_distinct_id ->(user, _options) { user.id }
+
   def perform(user, options = {})
     UserMailer.welcome(user).deliver_now
   end
@@ -323,13 +300,12 @@ You can also use a block:
 
 Ruby
 
-PostHog AI
-
 ```ruby
 class ProcessOrderJob < ApplicationJob
   posthog_distinct_id do |_order, notify_user_id|
     notify_user_id
   end
+
   def perform(order, notify_user_id)
     # Process the order...
   end
@@ -342,13 +318,12 @@ PostHog integrates with Rails' built-in error reporting:
 
 Ruby
 
-PostHog AI
-
 ```ruby
 # These errors are automatically sent to PostHog
 Rails.error.handle do
   # Code that might raise an error
 end
+
 Rails.error.record(exception, context: { user_id: current_user.id })
 ```
 
@@ -362,8 +337,6 @@ If your user method has a different name, configure it:
 
 Ruby
 
-PostHog AI
-
 ```ruby
 PostHog::Rails.config.current_user_method = :logged_in_user
 ```
@@ -384,8 +357,6 @@ You can configure a specific method:
 
 Ruby
 
-PostHog AI
-
 ```ruby
 PostHog::Rails.config.user_id_method = :email
 ```
@@ -394,8 +365,6 @@ Or define a method on your User model:
 
 Ruby
 
-PostHog AI
-
 ```ruby
 class User < ApplicationRecord
   def posthog_distinct_id
@@ -426,8 +395,6 @@ Add more with:
 
 Ruby
 
-PostHog AI
-
 ```ruby
 PostHog::Rails.config.excluded_exceptions = ['MyException']
 ```
@@ -438,12 +405,11 @@ Evaluate flags once for the current user, then read values from the returned sna
 
 Ruby
 
-PostHog AI
-
 ```ruby
 class PostsController < ApplicationController
   def show
     flags = PostHog.evaluate_flags(current_user.id)
+
     if flags.enabled?('new-post-design')
       render 'posts/show_new'
     else
@@ -457,11 +423,10 @@ For multivariate flags and experiments, use `get_flag`:
 
 Ruby
 
-PostHog AI
-
 ```ruby
 flags = PostHog.evaluate_flags(current_user.id)
 variant = flags.get_flag('checkout-experiment')
+
 if variant == 'test'
   # Do something differently
 end
@@ -471,10 +436,9 @@ When capturing an event after branching on a flag, pass the same `flags` snapsho
 
 Ruby
 
-PostHog AI
-
 ```ruby
 flags = PostHog.evaluate_flags(current_user.id)
+
 PostHog.capture({
   distinct_id: current_user.id,
   event: 'checkout_started',
@@ -486,8 +450,6 @@ For local evaluation, ensure you've set `personal_api_key`:
 
 Ruby
 
-PostHog AI
-
 ```ruby
 config.personal_api_key = Rails.application.credentials.posthog[:personal_api_key]
 ```
@@ -502,8 +464,6 @@ In your test environment, disable network calls with test mode:
 
 config/environments/test.rb
 
-PostHog AI
-
 ```ruby
 PostHog.init do |config|
   config.api_key = '<ph_project_token>'
@@ -515,8 +475,6 @@ Or in your specs:
 
 spec/rails\_helper.rb
 
-PostHog AI
-
 ```ruby
 RSpec.configure do |config|
   config.before(:each) do
@@ -531,16 +489,16 @@ end
 
 | Option | Type | Default | Description |
 | --- | --- | --- | --- |
-| api_key | String | required | Your PostHog project token. |
-| host | String | https://us.i.posthog.com | Fully qualified PostHog API host. |
-| personal_api_key | String | nil | Personal API key for local feature flag evaluation and remote config payloads. |
-| max_queue_size | Integer | 10000 | Maximum number of events to keep in the async queue before dropping new events. |
-| test_mode | Boolean | false | Keep events queued and do not send them. Useful for tests. |
-| sync_mode | Boolean | false | Send events synchronously on the calling thread. |
-| on_error | Proc | no-op | Callback called as on_error.call(status, error). |
-| feature_flags_polling_interval | Integer | 30 | Seconds between local feature flag definition polls. |
-| feature_flag_request_timeout_seconds | Integer | 3 | Timeout, in seconds, for feature flag requests. |
-| before_send | Proc | nil | Callback that receives the event hash before it is queued or sent. Return a modified event hash, or nil to drop the event. |
+| `api_key` | String | **required** | Your PostHog project token. |
+| `host` | String | `https://us.i.posthog.com` | Fully qualified PostHog API host. |
+| `personal_api_key` | String | `nil` | Personal API key for local feature flag evaluation and remote config payloads. |
+| `max_queue_size` | Integer | `10000` | Maximum number of events to keep in the async queue before dropping new events. |
+| `test_mode` | Boolean | `false` | Keep events queued and do not send them. Useful for tests. |
+| `sync_mode` | Boolean | `false` | Send events synchronously on the calling thread. |
+| `on_error` | Proc | no-op | Callback called as `on_error.call(status, error)`. |
+| `feature_flags_polling_interval` | Integer | `30` | Seconds between local feature flag definition polls. |
+| `feature_flag_request_timeout_seconds` | Integer | `3` | Timeout, in seconds, for feature flag requests. |
+| `before_send` | Proc | `nil` | Callback that receives the event hash before it is queued or sent. Return a modified event hash, or `nil` to drop the event. |
 
 The `PostHog.init` block supports the options above. Less common core options like `batch_size`, `disable_singleton_warning`, `skip_ssl_verification`, and `flag_definition_cache_provider` can be passed as an options hash to `PostHog.init(...)`; see the [Ruby SDK docs](/docs/libraries/ruby.md#configuration) for details.
 
@@ -550,14 +508,14 @@ Configure these via `PostHog::Rails.configure` or `PostHog::Rails.config`:
 
 | Option | Type | Default | Description |
 | --- | --- | --- | --- |
-| auto_capture_exceptions | Boolean | false | Automatically capture exceptions. |
-| report_rescued_exceptions | Boolean | false | Report exceptions Rails rescues. |
-| auto_instrument_active_job | Boolean | false | Capture ActiveJob exceptions with job context. |
-| excluded_exceptions | Array | [] | Additional exception class names to ignore. |
-| use_tracing_headers | Boolean | true | Use X-PostHog-Distinct-Id and X-PostHog-Session-Id as request-scoped defaults. |
-| capture_user_context | Boolean | true | Include authenticated user info in exceptions. |
-| current_user_method | Symbol | :current_user | Controller method used to fetch the current user. |
-| user_id_method | Symbol | nil | Method used to extract the distinct ID from the user object. Auto-detects when nil. |
+| `auto_capture_exceptions` | Boolean | `false` | Automatically capture exceptions. |
+| `report_rescued_exceptions` | Boolean | `false` | Report exceptions Rails rescues. |
+| `auto_instrument_active_job` | Boolean | `false` | Capture ActiveJob exceptions with job context. |
+| `excluded_exceptions` | Array | `[]` | Additional exception class names to ignore. |
+| `use_tracing_headers` | Boolean | `true` | Use `X-PostHog-Distinct-Id` and `X-PostHog-Session-Id` as request-scoped defaults. |
+| `capture_user_context` | Boolean | `true` | Include authenticated user info in exceptions. |
+| `current_user_method` | Symbol | `:current_user` | Controller method used to fetch the current user. |
+| `user_id_method` | Symbol | `nil` | Method used to extract the distinct ID from the user object. Auto-detects when nil. |
 
 ## Troubleshooting
 
@@ -567,8 +525,6 @@ Configure these via `PostHog::Rails.configure` or `PostHog::Rails.config`:
 
     Ruby
 
-    PostHog AI
-
     ```ruby
     Rails.console
     > PostHog.initialized?
@@ -581,8 +537,6 @@ Configure these via `PostHog::Rails.configure` or `PostHog::Rails.config`:
 
     Ruby
 
-    PostHog AI
-
     ```ruby
     Rails.application.middleware
     ```