Skip to content

docs(skill): add the magic_sentry plugin reference - #207

Merged
anilcancakir merged 1 commit into
masterfrom
docs/plugin-sentry-reference
Sep 27, 2026
Merged

anilcancakir merged 1 commit into
masterfrom
docs/plugin-sentry-reference

Conversation

@anilcancakir

Copy link
Copy Markdown
Member

Adds the skill's reference page for magic_sentry, published as 0.0.1 today, so an agent adopting it reads the same kind of page the other six plugins have. The page reaches the fluttersdk/ai registry with magic's next release.

What changes

  • skills/magic-framework/references/plugin-sentry.md (new, stamped magic_sentry v0.0.1): installation and floors, the boot order (MagicSentry.run before Magic.init, one zone, why the config is not a magic config factory), SentryServiceProvider's parameters and the four things its boot() wires in order, SentryNetworkInterceptor's event vs breadcrumb split with the endpoint normalisation, fingerprint and per-session dedupe, SentryUserContext, ReportsBreadcrumb events, the published .env keys, and a gotchas table.
  • SKILL.md: a row in the section 11 plugin table, -sentry.md in the reference index, magic_sentry in the when_to_use trigger line; version: 0.1.51 to 0.1.52 and the body stamp's skill version with it (magic 0.0.22 unchanged).
  • CHANGELOG.md: an [Unreleased] ### Added entry.

Verified against

Every symbol on the page was read from magic_sentry at e40ade1 (0.0.1): lib/src/magic_sentry.dart (run, installErrorWidgetBreadcrumb), lib/src/sentry_service_provider.dart (constructor, boot() order, the static breadcrumb remover), lib/src/sentry_network_interceptor.dart (dispositionFor, normalizeEndpoint, reportedFailures, the fingerprint), lib/src/sentry_user_context.dart, lib/src/event_breadcrumbs.dart, assets/stubs/install/sentry_config.stub and install.yaml. ReportsBreadcrumb and Event.listenAny were read from this repo (lib/src/events/reports_breadcrumb.dart, lib/src/facades/event.dart:57), and the observer refusal from MagicRouter.addObserver's StateError.

Gates

dart format --output=none --set-exit-if-changed . 445 files, 0 changed. flutter analyze --no-fatal-infos no issues. flutter test 2050 passed. Docs only; no lib/ change.

@codecov

codecov Bot commented Sep 27, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@kodizm

kodizm Bot commented Sep 27, 2026

Copy link
Copy Markdown

Note

Kodizm (AI-generated). May contain mistakes; verify before acting.

Looks correct: docs-only addition, consistent with the repo's own source and conventions.

No findings. This adds references/plugin-sentry.md plus the matching SKILL.md table/index/trigger-line entries and a CHANGELOG.md entry, following the same shape as the other plugin reference pages (compared against plugin-notifications.md) and the post-change sync rules in CLAUDE.md. The claims that touch this repo's actual code check out: ReportsBreadcrumb (lib/src/events/reports_breadcrumb.dart) and Event.listenAny (lib/src/facades/event.dart:57) exist as described, and MagicRouter.addObserver (lib/src/routing/magic_router.dart:179) does throw a StateError once the router is built, matching the "wire the observer in boot()" gotcha. The magic ^0.0.22 floor claim is also consistent with plugin-deeplink.md's existing statement about the same contract. The magic_sentry package itself isn't in this repo, so its internal symbols (SentryServiceProvider, SentryNetworkInterceptor, etc.) weren't independently verifiable here, only the repo-side claims were checked.

Tests

Docs-only change; no lib/ code touched, so no test coverage applies. Internal links/anchors are checked by CI.

CI

  • Lint & Test: success
  • Internal Links & Anchors: success
  • codecov/patch: success (no code changed)
  • External Links, Auto-merge low-risk Dependabot PRs: skipped (not applicable to this PR)
  • Overall: success

@anilcancakir
anilcancakir merged commit 0b260bf into master Sep 27, 2026
6 checks passed
@anilcancakir
anilcancakir deleted the docs/plugin-sentry-reference branch September 27, 2026 15:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant