Skip to content

[skill-drift] sentry-{node,browser,nextjs,react,nestjs,svelte}-sdk may need updates for Span Streaming #99

@github-actions

Description

@github-actions

cc @getsentry/team-javascript-sdks

SDK Changes Detected

The following PR was merged to getsentry/sentry-javascript that affects all JavaScript SDK skills:

Potential Skill Gaps

1. New traceLifecycle: 'stream' init option (server-side SDKs)

PR #19119 introduces a new top-level Sentry.init() option for server-side SDKs:

// Server-side SDKs (node, nextjs, nestjs)
Sentry.init({
  traceLifecycle: 'stream',   // NEW — opt into span streaming
  tracesSampleRate: 0.5,
  beforeSendSpan: Sentry.withStreamedSpan(span => {
    span.name = '...';
    return span;
  }),
  // beforeSendTransaction has no effect in streaming mode
});

The skills for sentry-node-sdk, sentry-nextjs-sdk, and sentry-nestjs-sdk do not mention traceLifecycle in their configuration reference tables.

2. New spanStreamingIntegration() for browser

Browser SDKs gain a new opt-in integration:

// Browser SDKs (browser, react, svelte)
Sentry.init({
  integrations: [
    Sentry.spanStreamingIntegration(),   // NEW — opt into span streaming
    Sentry.browserTracingIntegration(),
  ],
  tracesSampleRate: 0.5,
  beforeSendSpan: Sentry.withStreamedSpan(span => {
    span.name = '...';
    return span;
  }),
});

The skills for sentry-browser-sdk, sentry-react-sdk, and sentry-svelte-sdk do not mention spanStreamingIntegration in their integration tables or tracing references.

3. New withStreamedSpan() helper

When span streaming is enabled, beforeSendSpan callbacks must be wrapped with Sentry.withStreamedSpan() to indicate SDK compatibility. The existing skills document beforeSendSpan without mentioning this new requirement.

4. beforeSendTransaction behavior change

When traceLifecycle: 'stream' is active (server) or spanStreamingIntegration is added (browser), beforeSendTransaction has no effect. Skills that document beforeSendTransaction should note this.

Why This Needs Manual Review

  • Span Streaming is a new opt-in feature — the existing examples remain valid for users who don't opt in, so we need to add new content rather than replace existing content
  • Multiple skill files need coordinated updates: SKILL.md (init options / integration table) and references/tracing.md (new section on span streaming)
  • The feature is complex enough to warrant a dedicated subsection explaining when and why to enable it
  • The behavior difference between server (traceLifecycle) and browser (spanStreamingIntegration) needs clear documentation

Skill Files to Review

  • skills/sentry-node-sdk/SKILL.md + references/tracing.md
  • skills/sentry-browser-sdk/SKILL.md + references/tracing.md
  • skills/sentry-nextjs-sdk/SKILL.md + references/tracing.md
  • skills/sentry-react-sdk/SKILL.md + references/tracing.md
  • skills/sentry-nestjs-sdk/SKILL.md + references/tracing.md
  • skills/sentry-svelte-sdk/SKILL.md + references/tracing.md

Priority

MEDIUM — new opt-in feature; existing tracing setup remains valid for users who don't opt in, but the new APIs are missing entirely from all skill files.

Note

🔒 Integrity filter blocked 9 items

The following items were blocked because they don't meet the GitHub integrity level.

  • #282 list_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #20205 list_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #20203 list_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #7768 list_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #5067 list_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #5966 list_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #5951 list_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #2182 list_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
  • #83 list_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".

To allow these resources, lower min-integrity in your GitHub frontmatter:

tools:
  github:
    min-integrity: approved  # merged | approved | unapproved | none

Generated by SDK Skill Drift Detector · ● 491.6K ·

  • expires on Apr 27, 2026, 1:22 PM UTC

Metadata

Metadata

Assignees

No one assigned
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions