vybekiit 0.7.26 → 0.7.28

package/dist/global-skills/instrument-product-analytics/references/django.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
 
-# Django - Docs
-
-Copy page
-
-# Django - Docs
+# Django
 
 PostHog makes it easy to get data about traffic and usage of your Django app. Integrating PostHog enables analytics, custom events capture, feature flags, error tracking, and more.
 
@@ -30,13 +26,13 @@ Then, configure PostHog in your app config so it's initialized when Django start
 
 your\_app/apps.py
 
-PostHog AI
-
 ```python
 from django.apps import AppConfig
 import posthog
+
 class YourAppConfig(AppConfig):
     name = 'your_app_name'
+
     def ready(self):
         posthog.api_key = '<ph_project_token>'
         posthog.host = 'https://us.i.posthog.com'
@@ -46,8 +42,6 @@ Next, if you haven't done so already, add your `AppConfig` to `INSTALLED_APPS` i
 
 settings.py
 
-PostHog AI
-
 ```python
 INSTALLED_APPS = [
     # ... other apps
@@ -61,17 +55,17 @@ To capture events from any file, import `posthog` and call the method you need.
 
 Python
 
-PostHog AI
-
 ```python
 import posthog
 from posthog import identify_context
+
 def some_request(request):
     with posthog.new_context():
         # Django includes request.user for anonymous visitors too. Only identify
         # the context when the visitor is logged in.
         if request.user.is_authenticated:
             identify_context(str(request.user.pk))
+
         posthog.capture('event_name')
 ```
 
@@ -85,10 +79,9 @@ Events captured without a context or explicit `distinct_id` are sent as [anonymo
 >
 > Python
 >
-> PostHog AI
->
 > ```python
 > from posthog import new_context, identify_context, capture
+>
 > @app.get("/foo")
 > def foo(current_user: User = Depends(get_current_user)):
 >     with new_context(): # Set context at the top of a route
@@ -109,8 +102,6 @@ Add the middleware to your Django settings. If your app uses Django authenticati
 
 Python
 
-PostHog AI
-
 ```python
 MIDDLEWARE = [
     # ... other middleware
@@ -144,12 +135,11 @@ Identify the context from inside the request once you know who the user is. Djan
 
 Python
 
-PostHog AI
-
 ```python
 from django.contrib.auth.signals import user_logged_in
 from django.dispatch import receiver
 from posthog import identify_context
+
 @receiver(user_logged_in)
 def identify_posthog_user(sender, request, user, **kwargs):
     identify_context(str(user.pk))
@@ -167,8 +157,6 @@ Disable this by setting:
 
 Python
 
-PostHog AI
-
 ```python
 # settings.py
 POSTHOG_MW_CAPTURE_EXCEPTIONS = False
@@ -180,8 +168,6 @@ Use `POSTHOG_MW_EXTRA_TAGS` to add custom properties to all requests:
 
 Python
 
-PostHog AI
-
 ```python
 # settings.py
 def add_user_tags(request):
@@ -192,6 +178,7 @@ def add_user_tags(request):
         tags['user_id'] = str(request.user.pk)
         tags['email'] = request.user.email
     return tags
+
 POSTHOG_MW_EXTRA_TAGS = add_user_tags
 ```
 
@@ -201,8 +188,6 @@ Skip tracking for certain requests using `POSTHOG_MW_REQUEST_FILTER`:
 
 Python
 
-PostHog AI
-
 ```python
 # settings.py
 def should_track_request(request):
@@ -211,6 +196,7 @@ def should_track_request(request):
     if request.path.startswith('/health') or request.path.startswith('/admin'):
         return False
     return True
+
 POSTHOG_MW_REQUEST_FILTER = should_track_request
 ```
 
@@ -220,8 +206,6 @@ Use `POSTHOG_MW_TAG_MAP` to modify or remove default tags:
 
 Python
 
-PostHog AI
-
 ```python
 # settings.py
 def customize_tags(tags):
@@ -232,6 +216,7 @@ def customize_tags(tags):
     if '$request_method' in tags:
         tags['http_method'] = tags.pop('$request_method')
     return tags
+
 POSTHOG_MW_TAG_MAP = customize_tags
 ```
 
@@ -239,8 +224,6 @@ POSTHOG_MW_TAG_MAP = customize_tags
 
 Python
 
-PostHog AI
-
 ```python
 # settings.py
 def add_request_context(request):
@@ -252,18 +235,22 @@ def add_request_context(request):
         tags['user_id'] = str(request.user.pk)
     else:
         tags['user_type'] = 'anonymous'
+
     # Add request info
     tags['user_agent'] = request.META.get('HTTP_USER_AGENT', '')
     return tags
+
 def filter_tracking(request):
     # type: (HttpRequest) -> bool
     # Skip internal endpoints
     return not request.path.startswith(('/health', '/metrics', '/admin'))
+
 def clean_tags(tags):
     # type: (Dict[str, Any]) -> Dict[str, Any]
     # Remove sensitive data
     tags.pop('user_agent', None)
     return tags
+
 POSTHOG_MW_EXTRA_TAGS = add_request_context
 POSTHOG_MW_REQUEST_FILTER = filter_tracking
 POSTHOG_MW_TAG_MAP = clean_tags

package/dist/global-skills/instrument-product-analytics/references/dotnet.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
 
-# .NET - Docs
-
-Copy page
-
-# .NET - Docs
+# .NET
 
 This is an optional library you can install if you're working with .NET Core. It uses an internal queue to make calls fast and non-blocking. It also batches requests and flushes asynchronously, making it perfect to use in any part of your web app or other server side application that needs performance.
 
@@ -18,8 +14,6 @@ The `PostHog` package supports any .NET platform that targets .NET Standard 2.1
 
 Terminal
 
-PostHog AI
-
 ```bash
 dotnet add package PostHog.AspNetCore
 ```
@@ -28,11 +22,11 @@ In your `Program.cs` (or `Startup.cs` for ASP.NET Core 2.x) file, add the follow
 
 C#
 
-PostHog AI
-
 ```csharp
 using PostHog;
+
 var builder = WebApplication.CreateBuilder(args);
+
 // Add PostHog to the dependency injection container as a singleton.
 builder.AddPostHog();
 ```
@@ -41,8 +35,6 @@ Make sure to configure PostHog with your project token, instance address, and op
 
 JSON
 
-PostHog AI
-
 ```json
 {
   "PostHog": {
@@ -58,8 +50,6 @@ Use a secrets manager to store your personal API key. For example, when developi
 
 Terminal
 
-PostHog AI
-
 ```bash
 dotnet user-secrets init
 dotnet user-secrets set "PostHog:PersonalApiKey" "phx_..."
@@ -75,14 +65,13 @@ To use feature flags with the .NET Feature Management library, you'll need to im
 
 C#
 
-PostHog AI
-
 ```csharp
 public class MyFeatureFlagContextProvider(IHttpContextAccessor httpContextAccessor)
     : PostHogFeatureFlagContextProvider
 {
     protected override string? GetDistinctId()
         => httpContextAccessor.HttpContext?.User.Identity?.Name;
+
     protected override ValueTask<FeatureFlagOptions> GetFeatureFlagOptionsAsync()
     {
         // In a real app, you might get this information from a
@@ -104,8 +93,6 @@ Then, register your implementation in `Program.cs` (or `Startup.cs`):
 
 C#
 
-PostHog AI
-
 ```csharp
 var builder = WebApplication.CreateBuilder(args);
 builder.AddPostHog(options => {
@@ -117,8 +104,6 @@ With this in place, you can now use `feature` tag helpers in your Razor views:
 
 HTML
 
-PostHog AI
-
 ```html
 <feature name="awesome-new-feature">
     <p>This is the new feature!</p>
@@ -132,8 +117,6 @@ Multivariate feature flags are also supported:
 
 HTML
 
-PostHog AI
-
 ```html
 <feature name="awesome-new-feature" value="variant-a">
     <p>This is the new feature variant A!</p>
@@ -147,8 +130,6 @@ You can also use the `FeatureGateAttribute` to gate access to controllers or act
 
 C#
 
-PostHog AI
-
 ```csharp
 [FeatureGate("awesome-new-feature")]
 public class NewFeatureController : Controller
@@ -166,8 +147,6 @@ If you're not using ASP.NET Core (for example, in a console application, MAUI ap
 
 Terminal
 
-PostHog AI
-
 ```bash
 dotnet add package PostHog
 ```
@@ -176,8 +155,6 @@ The `PostHogClient` class must be implemented as a singleton in your project. Fo
 
 C#
 
-PostHog AI
-
 ```csharp
 builder.Services.AddPostHog();
 ```
@@ -186,10 +163,9 @@ If you're not using a `builder` (such as in a console application), you can do t
 
 C#
 
-PostHog AI
-
 ```csharp
 using PostHog;
+
 var services = new ServiceCollection();
 services.AddPostHog();
 var serviceProvider = services.BuildServiceProvider();
@@ -202,10 +178,9 @@ If you're not using dependency injection, you can create a static instance of th
 
 C#
 
-PostHog AI
-
 ```csharp
 using PostHog;
+
 public static readonly PostHogClient PostHog = new(new PostHogOptions {
     ProjectToken = "<ph_project_token>",
     HostUrl = new Uri("https://us.i.posthog.com"),
@@ -222,8 +197,6 @@ To see detailed logging, set the log level to `Debug` or `Trace` in `appsettings
 
 JSON
 
-PostHog AI
-
 ```json
 {
   "DetailedErrors": true,
@@ -250,8 +223,6 @@ You can send custom events using `capture`:
 
 C#
 
-PostHog AI
-
 ```csharp
 posthog.Capture("distinct_id_of_the_user", "user_signed_up");
 ```
@@ -264,8 +235,6 @@ Optionally, you can include additional information with the event by including a
 
 C#
 
-PostHog AI
-
 ```csharp
 posthog.Capture(
     "distinct_id_of_the_user",
@@ -283,11 +252,10 @@ If you're aiming for a backend-only implementation of PostHog and won't be captu
 
 C#
 
-PostHog AI
-
 ```csharp
 using PostHog;
 using Microsoft.AspNetCore.Http.Extensions;
+
 posthog.CapturePageView(
     "distinct_id_of_the_user",
     HttpContext.Request.GetDisplayUrl());
@@ -299,14 +267,15 @@ For ASP.NET Core apps using `PostHog.AspNetCore`, add request context middleware
 
 Program.cs
 
-PostHog AI
-
 ```csharp
 using PostHog;
 using PostHog.AspNetCore;
+
 var builder = WebApplication.CreateBuilder(args);
 builder.AddPostHog();
+
 var app = builder.Build();
+
 app.UsePostHogRequestContext();
 ```
 
@@ -318,8 +287,6 @@ Tracing headers are client-controlled analytics context, not authentication or a
 
 C#
 
-PostHog AI
-
 ```csharp
 app.UsePostHogRequestContext(options =>
 {
@@ -337,8 +304,6 @@ File names, line numbers, and source context depend on debug information already
 
 C#
 
-PostHog AI
-
 ```csharp
 try
 {
@@ -354,8 +319,6 @@ Add custom properties to include request, tenant, or domain context:
 
 C#
 
-PostHog AI
-
 ```csharp
 posthog.CaptureException(
     exception,
@@ -378,12 +341,10 @@ Automatic exception capture is not available in the .NET SDK yet.
 
 ## Person profiles and properties
 
-The .NET SDK captures identified events by default. These create [person profiles](/docs/data/persons.md). To set [person properties](/docs/data/user-properties.md) in these profiles, include them when capturing an event:
+The .NET SDK captures identified events by default. These create [person profiles](/docs/data/persons.md). To set [person properties](/docs/product-analytics/person-properties.md) in these profiles, include them when capturing an event:
 
 C#
 
-PostHog AI
-
 ```csharp
 posthog.Capture(
     "distinct_id",
@@ -393,14 +354,12 @@ posthog.Capture(
 );
 ```
 
-For more details on the difference between `$set` and `$set_once`, see our [person properties docs](/docs/data/user-properties.md#what-is-the-difference-between-set-and-set_once).
+For more details on the difference between `$set` and `$set_once`, see our [person properties docs](/docs/product-analytics/person-properties.md#what-is-the-difference-between-set-and-set_once).
 
 To capture [anonymous events](/docs/data/anonymous-vs-identified-events.md) without person profiles, set the event's `$process_person_profile` property to `false`:
 
 C#
 
-PostHog AI
-
 ```csharp
 posthog.Capture(
     "distinct_id",
@@ -419,8 +378,6 @@ In this case, you can use `alias` to assign another distinct ID to the same user
 
 C#
 
-PostHog AI
-
 ```csharp
 await posthog.AliasAsync("current_distinct_id", "new_distinct_id");
 ```
@@ -437,8 +394,6 @@ To capture an event and associate it with a group, add the `groups` argument to
 
 C#
 
-PostHog AI
-
 ```csharp
 posthog.Capture(
     "user_distinct_id",
@@ -450,8 +405,6 @@ Update properties on a group, use the `GroupIdentifyAsync` method:
 
 C#
 
-PostHog AI
-
 ```csharp
 await posthog.GroupIdentifyAsync(
     type: "company",
@@ -480,10 +433,9 @@ Call `EvaluateFlagsAsync()` once for the user, then read values from the returne
 
 C#
 
-PostHog AI
-
 ```csharp
 var flags = await posthog.EvaluateFlagsAsync("distinct_id_of_your_user");
+
 if (flags.IsEnabled("flag-key"))
 {
     // Do something differently for this user
@@ -496,11 +448,11 @@ if (flags.IsEnabled("flag-key"))
 
 C#
 
-PostHog AI
-
 ```csharp
 var flags = await posthog.EvaluateFlagsAsync("distinct_id_of_your_user");
+
 var enabledVariant = flags.GetFlag("flag-key")?.VariantKey;
+
 if (enabledVariant == "variant-key") // replace "variant-key" with the key of your variant
 {
     // Do something differently for this user
@@ -527,14 +479,14 @@ Pass the same `flags` object that you used for branching. This attaches the exac
 
 C#
 
-PostHog AI
-
 ```csharp
 var flags = await posthog.EvaluateFlagsAsync("distinct_id_of_your_user");
+
 if (flags.IsEnabled("flag-key"))
 {
     // Do something differently for this user
 }
+
 posthog.Capture(
     "distinct_id_of_your_user",
     "event_name",
@@ -550,8 +502,6 @@ To reduce event property bloat, pass a filtered snapshot:
 
 C#
 
-PostHog AI
-
 ```csharp
 // Attach only flags accessed with IsEnabled() or GetFlag() before this call
 posthog.Capture(
@@ -561,6 +511,7 @@ posthog.Capture(
     groups: null,
     flags: flags.OnlyAccessed()
 );
+
 // Attach only specific flags
 posthog.Capture(
     "distinct_id_of_your_user",
@@ -577,8 +528,6 @@ In the event properties, include `$feature/feature_flag_name: variant_key`:
 
 C#
 
-PostHog AI
-
 ```csharp
 posthog.Capture(
     "distinct_id_of_your_user",
@@ -597,8 +546,6 @@ By default, `EvaluateFlagsAsync()` evaluates every flag for the user. If you onl
 
 C#
 
-PostHog AI
-
 ```csharp
 var flags = await posthog.EvaluateFlagsAsync(
     "distinct_id_of_your_user",
@@ -627,8 +574,6 @@ For example:
 
 C#
 
-PostHog AI
-
 ```csharp
 var flags = await posthog.EvaluateFlagsAsync(
     "distinct_id_of_the_user",
@@ -651,6 +596,7 @@ var flags = await posthog.EvaluateFlagsAsync(
         },
     }
 );
+
 if (flags.IsEnabled("flag-key"))
 {
     // Do something differently for this user
@@ -690,8 +636,6 @@ Configure evaluation contexts so this SDK only evaluates flags intended for the
 
 JSON
 
-PostHog AI
-
 ```json
 {
     "PostHog": {
@@ -706,8 +650,6 @@ For code-based configuration, set `EvaluationContexts` on `PostHogOptions`:
 
 C#
 
-PostHog AI
-
 ```csharp
 var posthog = new PostHogClient(new PostHogOptions
 {
@@ -735,11 +677,10 @@ Since [experiments](/docs/experiments/start-here.md) use feature flags, the code
 
 C#
 
-PostHog AI
-
 ```csharp
 var flags = await posthog.EvaluateFlagsAsync("user_distinct_id");
 var variant = flags.GetFlag("experiment-feature-flag-key")?.VariantKey;
+
 if (variant == "variant-name")
 {
     // Do something