@danieljvdm/dev-kit 1.0.2 → 2.0.0

package/skills/sentry/references/sdks/tanstack-start/tracing.md

@@ -0,0 +1,123 @@
+# Tracing — Sentry TanStack Start React SDK
+
+> Minimum SDK: `@sentry/tanstackstart-react` (alpha)\
+> Framework target: TanStack Start React `1.0 RC`
+
+---
+
+## What Tracing Captures
+
+| Layer                       | Integration                                                        | Result                                        |
+| --------------------------- | ------------------------------------------------------------------ | --------------------------------------------- |
+| Browser route transitions   | `tanstackRouterBrowserTracingIntegration(router)`                  | Navigation and route-level transaction timing |
+| Server request handling     | `wrapFetchWithSentry(...)`                                         | Server request spans and request-level errors |
+| Server middleware/functions | `sentryGlobalRequestMiddleware` / `sentryGlobalFunctionMiddleware` | Middleware and server function timing context |
+| Custom operations           | `Sentry.startSpan`                                                 | Business operations and async block timing    |
+
+---
+
+## Browser Tracing Setup (`src/router.tsx`)
+
+```tsx
+import * as Sentry from "@sentry/tanstackstart-react";
+import { createRouter } from "@tanstack/react-router";
+
+export const getRouter = () => {
+  const router = createRouter();
+
+  if (!router.isServer) {
+    Sentry.init({
+      dsn: "___PUBLIC_DSN___",
+      integrations: [Sentry.tanstackRouterBrowserTracingIntegration(router)],
+      tracesSampleRate: 1.0,
+    });
+  }
+
+  return router;
+};
+```
+
+---
+
+## Server Tracing Setup
+
+### `instrument.server.mjs`
+
+```javascript
+import * as Sentry from "@sentry/tanstackstart-react";
+
+Sentry.init({
+  dsn: "___PUBLIC_DSN___",
+  tracesSampleRate: 1.0,
+});
+```
+
+### `src/server.ts`
+
+```typescript
+import { wrapFetchWithSentry } from "@sentry/tanstackstart-react";
+import handler, { createServerEntry } from "@tanstack/react-start/server-entry";
+
+export default createServerEntry(
+  wrapFetchWithSentry({
+    fetch(request: Request) {
+      return handler.fetch(request);
+    },
+  }),
+);
+```
+
+---
+
+## Custom Span Example
+
+```tsx
+import * as Sentry from "@sentry/tanstackstart-react";
+
+await Sentry.startSpan(
+  {
+    name: "Example Frontend Span",
+    op: "test",
+  },
+  async () => {
+    const res = await fetch("/api/sentry-example");
+    if (!res.ok) {
+      throw new Error("Sentry Example Frontend Error");
+    }
+  },
+);
+```
+
+Use `startSpan` for key flows such as checkout, search, and expensive data loads.
+
+---
+
+## Sampling Guidance
+
+| Environment                 | Suggested `tracesSampleRate`                                   |
+| --------------------------- | -------------------------------------------------------------- |
+| Development                 | `1.0`                                                          |
+| Production (starting point) | `0.1` to `0.3`                                                 |
+| High-volume traffic         | Tune with lower fixed rate or use server-side dynamic sampling |
+
+---
+
+## Verifying Traces
+
+1. Trigger a page navigation and one API call in the app.
+2. Open **Traces** in Sentry.
+3. Confirm one trace shows:
+   - browser transaction/span
+   - server request span
+   - linked errors (if thrown)
+
+---
+
+## Troubleshooting
+
+| Issue                                        | Solution                                                                             |
+| -------------------------------------------- | ------------------------------------------------------------------------------------ |
+| No browser transactions                      | Ensure router integration gets the actual router instance                            |
+| No server spans                              | Verify runtime loads `instrument.server.mjs` (`--import` path or direct import path) |
+| Trace disconnected between client and server | Confirm both browser and server init are active in the same environment              |
+| Too many traces                              | Reduce `tracesSampleRate` for production                                             |

package/skills/sentry/references/sdks/tanstack-start/user-feedback.md

@@ -0,0 +1,81 @@
+# User Feedback — Sentry TanStack Start React SDK
+
+> Minimum SDK: `@sentry/tanstackstart-react` with Feedback integration\
+> Framework target: TanStack Start React `1.0 RC`
+
+---
+
+## Feedback Widget Setup
+
+Enable feedback in the browser-side init (`src/router.tsx`):
+
+```tsx
+import * as Sentry from "@sentry/tanstackstart-react";
+
+Sentry.init({
+  dsn: "___PUBLIC_DSN___",
+  integrations: [
+    Sentry.feedbackIntegration({
+      colorScheme: "system",
+    }),
+  ],
+});
+```
+
+---
+
+## Common Configuration Options
+
+```tsx
+Sentry.feedbackIntegration({
+  autoInject: true,
+  colorScheme: "system",
+  showName: true,
+  showEmail: true,
+  isNameRequired: false,
+  isEmailRequired: false,
+  triggerLabel: "Report a bug",
+  formTitle: "Report a bug",
+  submitButtonLabel: "Send report",
+  successMessageText: "Thanks for the report.",
+  tags: {
+    area: "tanstack-start-web",
+    env: import.meta.env.MODE,
+  },
+});
+```
+
+---
+
+## Feedback From Error Flows
+
+If you want post-error feedback dialogs, capture an error and open the report dialog:
+
+```tsx
+const eventId = Sentry.captureException(new Error("Checkout flow failed"));
+Sentry.showReportDialog({
+  eventId,
+  title: "Something went wrong",
+  subtitle: "Want to help us fix this?",
+});
+```
+
+---
+
+## Verification
+
+1. Open the app and locate the feedback trigger.
+2. Submit a sample report.
+3. Open **User Feedback** in Sentry and confirm receipt.
+4. If using report dialogs, verify feedback is linked to the issue event.
+
+---
+
+## Troubleshooting
+
+| Issue                         | Solution                                                    |
+| ----------------------------- | ----------------------------------------------------------- |
+| Feedback button not shown     | Ensure `feedbackIntegration()` is in browser `integrations` |
+| Styling/position conflicts    | Customize trigger placement and check app z-index layers    |
+| Missing user details          | Set Sentry user context before feedback submission          |
+| Feedback not linked to errors | Use `showReportDialog` with the returned `eventId`          |

package/skills/sentry/references/search-query-language.md

@@ -0,0 +1,226 @@
+# Search Query Language
+
+Sentry’s `key:value` search grammar.
+It’s the **shared vocabulary** for every query surface — the Issues stream, Explore,
+Dashboards, alert/monitor conditions, and the MCP tools.
+Authoring a good query (and reading one back) is the same skill everywhere, so the
+grammar lives here once.
+
+> The web UI auto-completes these as you type.
+> You need the raw syntax for the API, saved queries, alerts, and dashboards.
+> The MCP accepts it _or_ natural language, but rewrites both — see
+> [Through the MCP](#through-the-mcp).
+
+## Grammar
+
+A query is a space-separated list of **tokens**. Each token is either a `key:value` pair
+or a single piece of **raw text** (matched against the event title/message with a
+CONTAINS match).
+
+```
+is:unresolved user.username:"Jane Doe" server:web-8 example error
+```
+
+That’s four tokens: `is:unresolved`, `user.username:"Jane Doe"`, `server:web-8` (a
+custom tag), and the raw search `example error`.
+
+### Rules
+
+- **Quote values with spaces:** `user.username:"Jane Doe"`.
+- **Implicit `AND`:** space-separated tokens are intersected (all must match).
+- **Negation:** prefix with `!` to exclude — `!user.email:test@example.com`,
+  `!message:"*Timeout"`.
+- **Comparison operators** on numbers/durations/dates: `>`, `<`, `>=`, `<=`, placed
+  after the `:` for numeric/duration fields (an exact `:` match rarely exists):
+  - `transaction.duration:>5s`
+  - `count_dead_clicks:<=10`
+  - `event.timestamp:>2023-09-28T00:00:00-07:00` (Issues; elsewhere the key is
+    `timestamp`)
+- **Value lists** (OR on one key): `release:[12.0, 13.0]` ≡
+  `release:12.0 OR release:13.0`. Wildcards work inside a list.
+  Not allowed with `is:` — a list desugars to `OR`, which the Issues search rejects.
+- **Wildcards:** `*` matches any characters — `browser:"Safari 11*"`,
+  `!message:"*Timeout"`.
+- **`has:`** — field/tag exists regardless of value: `has:user`. Negate as `!has:`.
+- **`is:`** — issue **state** (see catalogs below), on both the Issues stream and the
+  errors dataset; not usable with value lists.
+- **Explicit tag syntax** when a tag name collides with a reserved key:
+  `tags[project_id]:value`.
+
+### `AND` / `OR` / parentheses
+
+`OR`, `AND`, and grouping `()` are available in **Discover, Dashboards, and Monitors**
+(not the basic Issues search):
+
+```
+browser:Chrome OR browser:Opera
+release:13.0 AND (transaction.duration:>2s OR http.status_code:500)
+```
+
+- `AND` binds tighter than `OR`: `x AND y OR z` ≡ `(x AND y) OR z`. Use parens to
+  override.
+- `AND` may join a non-aggregate with an aggregate; **`OR` may not** mix the two.
+  `user.username:jane OR count():>100` is invalid.
+
+### Aggregate conditions (functions)
+
+On aggregating surfaces (Discover/Dashboards), function keys filter on computed values.
+The function still needs a value/filter even when it takes no parameter:
+
+```
+count():>100
+count_unique(user):>=20
+p95(transaction.duration):>500ms
+failure_rate():>0.05
+epm():>12
+count_if(transaction.duration,greater,1000):>5
+```
+
+### Relative time / age
+
+`age:` (and `firstSeen`/`lastSeen`) use Unix-find-style offsets — suffixes
+`m`/`h`/`d`/`w`:
+
+- `age:-24h` — created in the last 24 hours.
+- `age:+12h` — older than 12 hours.
+- `age:+12h age:-24h` — created between 12 and 24 hours ago.
+
+> The MCP doesn’t know `age:` and rewrites it to `firstSeen:`, flipping `+` to `-` —
+> which silently reverses “older than”.
+> Use `firstSeen:` / `lastSeen:` directly there.
+
+---
+
+## Searchable properties by dataset
+
+Search terms only validate against the **dataset** you’re querying — a span key won’t
+work in Issues, etc.
+The catalogs below are the common keys per dataset.
+(Any **custom tag** your SDK sets is also searchable as a key; use `tags[name]:value` if
+the name collides with a reserved one.)
+
+### Issues (the Issues stream)
+
+State & triage: `is:` (`unresolved`, `resolved`, `archived`, `assigned`, `unassigned`,
+`for_review`, `linked`, `unlinked`), `assigned`, `assigned_or_suggested`, `bookmarks`
+(values: an email, `me`, `none`, `my_teams`, `#team-name`).
+
+Identity & grouping: `issue` (short code, e.g. `SENTRY-ABC`), `issue.category` (`error`,
+`performance`, `frontend`, `outage`), `issue.type` (e.g.
+`performance_n_plus_one_db_queries`), `title`, `message`, `culprit`, `location`.
+
+Counts & age: `timesSeen` (= `count()`), `age`, `firstSeen`, `lastSeen`,
+`event.timestamp`.
+
+Release/version: `release`, `firstRelease` (supports `latest`), `release.version`,
+`release.build`, `release.package`, `release.stage` (`adopted`/`low`/`replaced`),
+`dist`.
+
+Error shape: `error.handled`, `error.unhandled`, `error.type`, `error.value`,
+`error.mechanism`, `error.main_thread`, `level`, `event.type`.
+
+Stack: `stack.filename`, `stack.function`, `stack.module`, `stack.package`,
+`stack.abs_path`.
+
+Request/user/device/geo: `http.method`, `http.status_code`, `http.url`, `http.referer`,
+`user.id`, `user.email`, `user.username`, `user.ip`, `device.*`, `os.*`, `geo.city`,
+`geo.country_code`, `geo.region`, `platform.name`, `sdk.name`, `sdk.version`.
+
+Other: `project`, `project.id`, `transaction`, `trace`, `flags["my_flag"]:true`
+(feature-flag evaluation), `has`.
+
+### Events (Discover, error + transaction events)
+
+> The MCP has no transaction-events dataset (`errors`, `logs`, `spans`, `metrics`,
+> `profiles`, `replays`) — query transactions as `spans` with `is_transaction:true`.
+
+Everything in Issues that’s event-level, plus **aggregate functions**: `count()`,
+`count_unique(field)`, `count_if(column,operator,value)`,
+`count_miserable(field,threshold)`, `count_web_vitals(vital,threshold)`, `avg(field)`,
+`min`/`max`/`sum(field)`, `percentile(field,level)`, `pXY(duration field)` (e.g. `p95`),
+`apdex(threshold)`, `failure_count()`, `failure_rate()`, `user_misery(number)`,
+`last_seen()`, `epm()`, `eps()`.
+
+Transaction/perf: `transaction`, `transaction.duration`, `transaction.op`,
+`transaction.status`, `measurements.lcp` / `.fcp` / `.fid` / `.cls` / `.ttfb` (web
+vitals), `measurements.app_start_cold` / `.app_start_warm`, `measurements.frames_*`,
+`measurements.stall_*`, `spans.db` / `.http` / `.browser` / `.resource` / `.ui`.
+
+Trace linking: `trace`, `trace.span`, `trace.parent_span`. Time bucketing:
+`timestamp.to_hour`, `timestamp.to_day`. Plus `environment`, `device.class`, full
+`stack.*` (incl. `stack.lineno`, `stack.colno`, `stack.in_app`), `user.display`.
+
+### Spans (Trace / Span Explorer)
+
+`span.op` / `op`, `span.description` / `description`, `span.duration` / `duration`,
+`self_time`, `module`, `group`, `action`, `domain`, `system`, `status`, `status_code`,
+`trace.status`, `transaction`, `transaction.op`, `transaction.method`, `cache.hit`,
+`file_extension`, `resource.render_blocking_status`, `http.response_content_length` /
+`.decoded_response_content_length` / `.response_transfer_size`,
+`messaging.destination.name`, `messaging.message.id`, `release`, `environment`,
+`browser.name`, `os.name`, `device.class`, `platform`, `sdk.name`, `sdk.version`,
+`user.id` / `.email` / `.username`.
+
+### Logs
+
+Logs search on the log `message`, `severity` (`level` is the errors/issues key),
+`timestamp`, the trace it belongs to (`trace`), and any **structured attributes** you
+attached (searched as keys).
+Plus the common context keys (`release`, `environment`, `project`).
+
+### Session Replay
+
+Counts/quality: `count_errors`, `count_dead_clicks`, `count_rage_clicks`, `count_urls`,
+`count_segments`, `count_traces`, `activity`, `duration`.
+
+Clicks: `click.tag`, `click.id`, `click.class`, `click.role`, `click.label`,
+`click.textContent`, `click.title`, `click.testid`, `click.component_name`,
+`click.selector`, `click.alt`, `dead.selector`, `rage.selector`.
+
+Session/identity: `id`, `replay_type`, `url`, `screen`, `trace`, `error_ids`,
+`is_archived`, `seen_by_me`, `level`, `dist`, `release`, `platform`, `browser.name`,
+`browser.version`, `os.name`, `os.version`, `device.*`, `user.id` / `.email` /
+`.username` / `.ip`, `user.geo.city` / `.country_code` / `.region` / `.subdivision`,
+`sdk.name`, `sdk.version`, `project_id`.
+
+### User Feedback
+
+`is`, `assigned`, `id`, `level`, `message`, `url`, `transaction`, `timestamp`,
+`environment`, `browser.name`, `os.name`, `device.brand` / `.family` / `.model_id` /
+`.name`, `dist`, `user.id` / `.email` / `.ip` / `.username`, `sdk.name`, `sdk.version`.
+
+### Releases
+
+`release`, `release.version`, `release.build`, `release.package`, `release.stage`
+(`adopted` / `low` / `replaced`). Pick the newest with `release:latest`.
+
+---
+
+## Where this language is used
+
+- **Reading data** — issue search and event/Discover queries locate and slice data with
+  this grammar; natural-language questions are translated into it.
+- **Authoring monitors & dashboards** — alerts, metric monitors, and dashboards are
+  authored as saved queries in this grammar.
+
+## Through the MCP
+
+`search_events` and `search_issues` accept either natural language or this grammar, but
+there is no raw query path — both run your input through an LLM that rewrites fields to
+fit the target dataset.
+**What you write is not necessarily what runs**, it isn’t reproducible between calls,
+and a rewrite into invalid syntax surfaces as a confusing API error rather than a
+rejection of your query.
+
+So read back what executed: `search_events` always prints an `## Executed Search` block,
+and `search_issues` prints nothing unless you pass `includeExplanation: true`. Both
+tools also take a `period` argument that intersects with any time filter in the query
+rather than overriding it — `search_issues` defaults to 30 days.
+
+## Pitfalls
+
+- A key from the wrong dataset fails loudly in the UI/API, but **silently through the
+  MCP** — either substituted or run as-is for **zero results with no error**. An empty
+  result set isn’t evidence of no data; check `## Executed Search`.
+- Using `:` instead of a comparison operator on a numeric/duration/date field.
+- Expecting `OR`/`AND` in the basic Issues search (only Discover/Dashboards/Monitors).

package/skills/sentry/references/semantics/angular.md

@@ -0,0 +1,7 @@
+# Angular attributes
+
+Attributes from Angular framework instrumentation.
+
+| Key               | Type     | Brief                                |
+| ----------------- | -------- | ------------------------------------ |
+| `angular.version` | `string` | The version of the Angular framework |

package/skills/sentry/references/semantics/app.md

@@ -0,0 +1,28 @@
+# App attributes
+
+Application identity and lifecycle attributes for mobile and desktop apps.
+
+| Key                              | Type      | Brief                                                                                                                                                                                                                                                 |
+| -------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `app.build`                      | `string`  | Internal build identifier, as it appears on the platform.                                                                                                                                                                                             |
+| `app.identifier`                 | `string`  | Version-independent application identifier, often a dotted bundle ID.                                                                                                                                                                                 |
+| `app.in_foreground`              | `boolean` | Whether the application is currently in the foreground.                                                                                                                                                                                               |
+| `app.name`                       | `string`  | Human readable application name, as it appears on the platform.                                                                                                                                                                                       |
+| `app.start_time`                 | `string`  | Formatted UTC timestamp when the user started the application.                                                                                                                                                                                        |
+| `app.version`                    | `string`  | Human readable application version, as it appears on the platform.                                                                                                                                                                                    |
+| `app.vitals.frames.delay.value`  | `integer` | The sum of all delayed frame durations in seconds during the lifetime of the span. For more information see [frames delay](https://develop.sentry.dev/sdk/performance/frames-delay/).                                                                 |
+| `app.vitals.frames.frozen.count` | `integer` | The number of frozen frames rendered during the lifetime of the span.                                                                                                                                                                                 |
+| `app.vitals.frames.frozen.rate`  | `double`  | The fraction of rendered frames that were frozen, calculated as `app.vitals.frames.frozen.count` divided by `app.vitals.frames.total.count`. This is computed by Relay.                                                                               |
+| `app.vitals.frames.slow.count`   | `integer` | The number of slow frames rendered during the lifetime of the span.                                                                                                                                                                                   |
+| `app.vitals.frames.slow.rate`    | `double`  | The fraction of rendered frames that were slow, calculated as `app.vitals.frames.slow.count` divided by `app.vitals.frames.total.count`. This is computed by Relay.                                                                                   |
+| `app.vitals.frames.total.count`  | `integer` | The number of total frames rendered during the lifetime of the span.                                                                                                                                                                                  |
+| `app.vitals.stall.duration`      | `double`  | The combined duration of all stalls in milliseconds. Only applies to React Native. This is computed by Relay.                                                                                                                                         |
+| `app.vitals.stall.percentage`    | `double`  | The fraction of transaction duration during which the app was stalled, between 0.0 and 1.0. For example, 0.8 represents 80%. Only applies to React Native. This is computed by Relay.                                                                 |
+| `app.vitals.start.cold.value`    | `double`  | The duration of a cold app start in milliseconds                                                                                                                                                                                                      |
+| `app.vitals.start.prewarmed`     | `boolean` | Whether the app start was prewarmed.                                                                                                                                                                                                                  |
+| `app.vitals.start.reason`        | `string`  | The reason that triggered the app start.                                                                                                                                                                                                              |
+| `app.vitals.start.screen`        | `string`  | The screen that is rendered when the app start is complete. This is the screen the user first sees and can interact with after launch. The absence of this attribute on the app start span indicates a background app start where no UI was rendered. |
+| `app.vitals.start.type`          | `string`  | The type of app start, for example `cold` or `warm`                                                                                                                                                                                                   |
+| `app.vitals.start.warm.value`    | `double`  | The duration of a warm app start in milliseconds                                                                                                                                                                                                      |
+| `app.vitals.ttfd.value`          | `double`  | The duration of time to full display in milliseconds                                                                                                                                                                                                  |
+| `app.vitals.ttid.value`          | `double`  | The duration of time to initial display in milliseconds                                                                                                                                                                                               |

package/skills/sentry/references/semantics/art.md

@@ -0,0 +1,17 @@
+# ART attributes
+
+Android Runtime (ART) profiling and runtime attributes.
+
+| Key                          | Type      | Brief                                                                                                            |
+| ---------------------------- | --------- | ---------------------------------------------------------------------------------------------------------------- |
+| `art.gc.blocking_count`      | `integer` | Total number of blocking (stop-the-world) garbage collections performed by the Android Runtime                   |
+| `art.gc.blocking_time`       | `double`  | Total time spent in blocking (stop-the-world) garbage collections by the Android Runtime, in milliseconds        |
+| `art.gc.pre_oome_count`      | `integer` | Total number of garbage collections triggered as a last resort before an OutOfMemoryError by the Android Runtime |
+| `art.gc.total_count`         | `integer` | Total number of garbage collections performed by the Android Runtime                                             |
+| `art.gc.total_time`          | `double`  | Total time spent in garbage collection by the Android Runtime, in milliseconds                                   |
+| `art.gc.waiting_time`        | `double`  | Total time threads spent waiting for garbage collection to complete in the Android Runtime, in milliseconds      |
+| `art.memory.free`            | `integer` | Free memory available to the process as reported by the Android Runtime, in bytes                                |
+| `art.memory.free_until_gc`   | `integer` | Free memory available before a garbage collection would be triggered by the Android Runtime, in bytes            |
+| `art.memory.free_until_oome` | `integer` | Free memory available before an OutOfMemoryError would be thrown by the Android Runtime, in bytes                |
+| `art.memory.max`             | `integer` | Maximum memory the process is allowed to use as reported by the Android Runtime, in bytes                        |
+| `art.memory.total`           | `integer` | Total memory currently allocated to the process by the Android Runtime, in bytes                                 |

package/skills/sentry/references/semantics/aws.md

@@ -0,0 +1,43 @@
+# AWS attributes
+
+AWS service, region, and request attributes for cloud instrumentation.
+
+| Key                                           | Type       | Brief                                                                                                             |
+| --------------------------------------------- | ---------- | ----------------------------------------------------------------------------------------------------------------- |
+| `aws.cloudwatch.logs.log_group`               | `string`   | The name of the CloudWatch Logs log group                                                                         |
+| `aws.cloudwatch.logs.log_stream`              | `string`   | The name of the CloudWatch Logs log stream                                                                        |
+| `aws.cloudwatch.logs.url`                     | `string`   | The URL to the CloudWatch Logs log group                                                                          |
+| `aws.dynamodb.attribute_definitions`          | `string[]` | The JSON-serialized value of each item in the `AttributeDefinitions` request field.                               |
+| `aws.dynamodb.consistent_read`                | `boolean`  | The value of the `ConsistentRead` request parameter.                                                              |
+| `aws.dynamodb.consumed_capacity`              | `string[]` | The JSON-serialized value of each item in the `ConsumedCapacity` response field.                                  |
+| `aws.dynamodb.count`                          | `integer`  | The value of the `Count` response parameter.                                                                      |
+| `aws.dynamodb.exclusive_start_table`          | `string`   | The value of the `ExclusiveStartTableName` request parameter.                                                     |
+| `aws.dynamodb.global_secondary_index_updates` | `string[]` | The JSON-serialized value of each item in the `GlobalSecondaryIndexUpdates` request field.                        |
+| `aws.dynamodb.global_secondary_indexes`       | `string[]` | The JSON-serialized value of each item of the `GlobalSecondaryIndexes` request field.                             |
+| `aws.dynamodb.index_name`                     | `string`   | The value of the `IndexName` request parameter.                                                                   |
+| `aws.dynamodb.item_collection_metrics`        | `string`   | The JSON-serialized value of the `ItemCollectionMetrics` response field.                                          |
+| `aws.dynamodb.limit`                          | `integer`  | The value of the `Limit` request parameter.                                                                       |
+| `aws.dynamodb.local_secondary_indexes`        | `string[]` | The JSON-serialized value of each item of the `LocalSecondaryIndexes` request field.                              |
+| `aws.dynamodb.projection`                     | `string`   | The value of the `ProjectionExpression` request parameter.                                                        |
+| `aws.dynamodb.provisioned_read_capacity`      | `double`   | The value of the `ProvisionedThroughput.ReadCapacityUnits` request parameter.                                     |
+| `aws.dynamodb.provisioned_write_capacity`     | `double`   | The value of the `ProvisionedThroughput.WriteCapacityUnits` request parameter.                                    |
+| `aws.dynamodb.scan_forward`                   | `boolean`  | The value of the `ScanIndexForward` request parameter.                                                            |
+| `aws.dynamodb.scanned_count`                  | `integer`  | The value of the `ScannedCount` response parameter.                                                               |
+| `aws.dynamodb.segment`                        | `integer`  | The value of the `Segment` request parameter.                                                                     |
+| `aws.dynamodb.select`                         | `string`   | The value of the `Select` request parameter.                                                                      |
+| `aws.dynamodb.table_count`                    | `integer`  | The number of items in the `TableNames` response parameter.                                                       |
+| `aws.dynamodb.table_names`                    | `string[]` | The keys in the `RequestItems` object field.                                                                      |
+| `aws.dynamodb.total_segments`                 | `integer`  | The value of the `TotalSegments` request parameter.                                                               |
+| `aws.extended_request_id`                     | `string`   | The AWS extended request ID as returned in the response headers.                                                  |
+| `aws.kinesis.stream_name`                     | `string`   | The name of the AWS Kinesis stream the request refers to.                                                         |
+| `aws.lambda.execution_duration_in_millis`     | `double`   | The execution duration of the Lambda function invocation in milliseconds                                          |
+| `aws.lambda.invoked_arn`                      | `string`   | The full ARN of the Lambda function that was invoked                                                              |
+| `aws.lambda.remaining_time_in_millis`         | `double`   | The remaining time in milliseconds before the Lambda function times out                                           |
+| `aws.log.group.names`                         | `string[]` | The name(s) of the AWS log group(s) an application is writing to.                                                 |
+| `aws.log.stream.names`                        | `string[]` | The name(s) of the AWS log stream(s) an application is writing to.                                                |
+| `aws.request_id`                              | `string`   | The AWS request ID as returned in the response headers.                                                           |
+| `aws.s3.bucket`                               | `string`   | The S3 bucket name the request refers to.                                                                         |
+| `aws.secretsmanager.secret.arn`               | `string`   | The ARN of the Secret stored in Secrets Manager.                                                                  |
+| `aws.sns.topic.arn`                           | `string`   | The ARN of the AWS SNS Topic. An Amazon SNS topic is a logical access point that acts as a communication channel. |
+| `aws.step_functions.activity.arn`             | `string`   | The ARN of the AWS Step Functions Activity.                                                                       |
+| `aws.step_functions.state_machine.arn`        | `string`   | The ARN of the AWS Step Functions State Machine.                                                                  |

package/skills/sentry/references/semantics/browser.md

@@ -0,0 +1,34 @@
+# Browser attributes
+
+Browser environment and web-vital attributes on client spans.
+
+| Key                                               | Type      | Brief                                                                                                                                                                                                                             |
+| ------------------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `browser.bfcache.frame`                           | `string`  | Which frame in the page’s frame tree a back/forward cache not-restored reason originated from: the top document or a child frame.                                                                                                 |
+| `browser.bfcache.not_restored_reason_count`       | `integer` | The number of reported reasons a page was not restored from the back/forward cache on a back/forward navigation. 0 when the browser reported no reasons (e.g. non-Chromium browsers).                                             |
+| `browser.bfcache.outcome`                         | `string`  | Whether a back/forward navigation was restored from the browser’s back/forward cache (bfcache). ‘hit’ means the page was restored; ‘miss’ means it was reloaded.                                                                  |
+| `browser.bfcache.reason`                          | `string`  | A browser-reported reason a page was not restored from the back/forward cache on a back/forward navigation, taken from the notRestoredReasons API. Reported per reason (a single miss can have several). Currently Chromium-only. |
+| `browser.name`                                    | `string`  | The name of the browser.                                                                                                                                                                                                          |
+| `browser.performance.navigation.activation_start` | `double`  | The time between initiating a navigation to a page and the browser activating the page                                                                                                                                            |
+| `browser.performance.time_origin`                 | `double`  | The browser’s performance.timeOrigin timestamp representing the time when the pageload was initiated                                                                                                                              |
+| `browser.report.type`                             | `string`  | A browser report sent via reporting API..                                                                                                                                                                                         |
+| `browser.script.invoker`                          | `string`  | How a script was called in the browser.                                                                                                                                                                                           |
+| `browser.script.invoker_type`                     | `string`  | Browser script entry point type.                                                                                                                                                                                                  |
+| `browser.script.source_char_position`             | `integer` | A number representing the script character position of the script.                                                                                                                                                                |
+| `browser.version`                                 | `string`  | The version of the browser.                                                                                                                                                                                                       |
+| `browser.web_vital.cls.report_event`              | `string`  | The event that caused the SDK to report CLS (pagehide or navigation)                                                                                                                                                              |
+| `browser.web_vital.cls.source.<key>`              | `string`  | The HTML elements or components responsible for the layout shift. <key> is a numeric index from 1 to N                                                                                                                            |
+| `browser.web_vital.cls.value`                     | `double`  | The value of the recorded Cumulative Layout Shift (CLS) web vital                                                                                                                                                                 |
+| `browser.web_vital.fcp.value`                     | `double`  | The time it takes for the browser to render the first piece of meaningful content on the screen                                                                                                                                   |
+| `browser.web_vital.fp.value`                      | `double`  | The time in milliseconds it takes for the browser to render the first pixel on the screen                                                                                                                                         |
+| `browser.web_vital.inp.value`                     | `double`  | The value of the recorded Interaction to Next Paint (INP) web vital                                                                                                                                                               |
+| `browser.web_vital.lcp.element`                   | `string`  | The HTML element selector or component name for which LCP was reported                                                                                                                                                            |
+| `browser.web_vital.lcp.id`                        | `string`  | The id of the dom element responsible for the largest contentful paint                                                                                                                                                            |
+| `browser.web_vital.lcp.load_time`                 | `integer` | The time it took for the LCP element to be loaded                                                                                                                                                                                 |
+| `browser.web_vital.lcp.render_time`               | `integer` | The time it took for the LCP element to be rendered                                                                                                                                                                               |
+| `browser.web_vital.lcp.report_event`              | `string`  | The event that caused the SDK to report LCP (pagehide or navigation)                                                                                                                                                              |
+| `browser.web_vital.lcp.size`                      | `integer` | The size of the largest contentful paint element                                                                                                                                                                                  |
+| `browser.web_vital.lcp.url`                       | `string`  | The url of the dom element responsible for the largest contentful paint                                                                                                                                                           |
+| `browser.web_vital.lcp.value`                     | `double`  | The value of the recorded Largest Contentful Paint (LCP) web vital                                                                                                                                                                |
+| `browser.web_vital.ttfb.request_time`             | `double`  | The time it takes for the server to process the initial request and send the first byte of a response to the user’s browser                                                                                                       |
+| `browser.web_vital.ttfb.value`                    | `double`  | The value of the recorded Time To First Byte (TTFB) web vital in Milliseconds                                                                                                                                                     |

package/skills/sentry/references/semantics/cache.md

@@ -0,0 +1,12 @@
+# Cache attributes
+
+Cache read/write attributes — key, hit/miss, item size.
+
+| Key               | Type       | Brief                                                    |
+| ----------------- | ---------- | -------------------------------------------------------- |
+| `cache.hit`       | `boolean`  | If the cache was hit during this span.                   |
+| `cache.item_size` | `integer`  | The size of the requested item in the cache. In bytes.   |
+| `cache.key`       | `string[]` | The key of the cache accessed.                           |
+| `cache.operation` | `string`   | The operation being performed on the cache.              |
+| `cache.ttl`       | `integer`  | The ttl of the cache in seconds                          |
+| `cache.write`     | `boolean`  | If the cache operation resulted in a write to the cache. |

package/skills/sentry/references/semantics/client.md

@@ -0,0 +1,8 @@
+# Client attributes
+
+Client address and port for the side that initiated a connection.
+
+| Key              | Type      | Brief                                                                                                                   |
+| ---------------- | --------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `client.address` | `string`  | Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. |
+| `client.port`    | `integer` | Client port number.                                                                                                     |

package/skills/sentry/references/semantics/cloud.md

@@ -0,0 +1,12 @@
+# Cloud attributes
+
+Generic cloud provider attributes shared across AWS, GCP, and others.
+
+| Key                       | Type     | Brief                                                                                         |
+| ------------------------- | -------- | --------------------------------------------------------------------------------------------- |
+| `cloud.account.id`        | `string` | The cloud account ID the resource is assigned to                                              |
+| `cloud.availability_zone` | `string` | Cloud regions often have multiple, isolated locations known as zones to increase availability |
+| `cloud.platform`          | `string` | The cloud platform in use                                                                     |
+| `cloud.provider`          | `string` | Name of the cloud provider                                                                    |
+| `cloud.region`            | `string` | The geographical region the resource is running                                               |
+| `cloud.resource_id`       | `string` | Cloud provider-specific native identifier of the monitored cloud resource                     |