init: finish source map setup before exposing it as a feature
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 25/100
- issue の種類
- 機能追加
- 明瞭さ
- おおむね明確
- 活発さ
- 静か
- 技術スタック
- typescript
- 領域
- build-system, ci-cd, cli, security
調査の方向性
まず、issue に記載されている現在の init 機能の処理を確認し、その後、実装作業を提案する前に blocker #1110 と PR #1112 を読んでください。受け入れ基準を Definition of Done として扱ってください。source maps を時期尚早に告知してはならず、secrets は init とコミット済みファイルの外部に保持し、production-build の upload 検証は明示的に行う必要があります。
索引モデルが issue の本文から書いたものです。
説明
Problem
sourceMaps is currently advertised by sentry init in its --features
help and documentation, while the init service deliberately removes it from
both interactive and CLI-preselected features.
Keeping it disabled is currently the correct behavior. A valid source map setup
requires more than changing bundler configuration:
- Production builds must emit source maps.
- A Sentry bundler plugin or
sentry sourcemap inject+uploadmust run in the
build that is actually deployed. - Upload requires a CI-safe Organization Auth Token with the
org:ciscope. - The token must be installed as
SENTRY_AUTH_TOKENin CI and must never pass
through the init server, LLM context, telemetry, or committed files. - Browser source maps should normally be hidden and deleted after upload.
Without that flow, init can produce configuration that looks complete while no
artifacts are ever uploaded.
Source maps are also a build/deployment concern, not a runtime product feature
like tracing, replay, or profiling. They should not appear as a peer option in
the feature picker.
Existing blocker
Token management is already tracked by #1110 and PR #1112.
The current organization-token management endpoints only accept browser session
authentication and explicitly reject Bearer authentication. The CLI therefore
cannot mint an Organization Auth Token using its stored OAuth token. This needs
a supported backend flow before it can be automated safely.
This issue should depend on #1110 rather than implementing another token
creation workaround.
Proposed UX
Until end-to-end setup is possible:
- Keep source maps out of the interactive feature list.
- Stop advertising
sourcemapsas a currently supported--featuresvalue. - The internal feature/schema value may remain for future planner work.
Once token provisioning is supported, offer source maps as an eligible
build-setup step for JavaScript projects rather than as a runtime feature.
Required setup flow
- Detect the framework, bundler, production output directory, and CI/build
configuration. - Prefer the official framework or bundler plugin.
- Fall back to
sentry sourcemap injectfollowed by
sentry sourcemap uploadfor custom builds. - Configure
SENTRY_ORGandSENTRY_PROJECT, while referencing
SENTRY_AUTH_TOKENonly through the environment. - Create an Organization Auth Token with
org:cithrough the future supported
token flow, or give the user a secure browser handoff. - Explain how to add the one-time token to the project's CI secret store.
- Use hidden source maps and delete browser maps after upload where supported.
- Verify using a production build and confirm that an artifact bundle reached
Sentry. - Do not require or invent a release. Modern Debug ID matching works without a
release; preserve existing release configuration when one already exists.
Acceptance criteria
- Source maps are not shown as supported before the complete flow exists.
- No token value is sent to the init API, an LLM, or telemetry.
- No token or usable placeholder secret is committed to the repository.
- Configuration is correct for the detected bundler/framework.
- Browser builds use hidden maps and avoid deploying
.mapfiles publicly. - CI-secret setup is explicit and actionable.
- A production-build verification checks the actual upload.
- Init does not report source maps as complete when token/CI setup remains.
- Release configuration remains optional with Debug IDs.
References
- 主要言語
- TypeScript
- スター
- 121
- フォーク
- 14
- 平均マージ
- 23時間 54分
- マージ済み PR(30日)
- 103
コントリビューションガイド
このリポジトリのコントリビューションガイドは索引されていません
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
getsentry/cli のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
-
難易度 3/5 1〜2日 初心者へのやさしさ 68/100
-
難易度 3/5 1〜2日 初心者へのやさしさ 65/100
-
bug jared
-
jared
難易度 4/5 3〜5日 初心者へのやさしさ 52/100
似ている issue
-
bug(cli): hapi doctor inline-media prints a fabricated B:\ helper-script path in packaged installs オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100
-
Crush オープン
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
catppuccin/catppuccin#3125 ·
-
Add a SECURITY.md オープン
難易度 1/5 1時間未満 初心者へのやさしさ 90/100
ElementsProject/cln-application#167 · コメント 1 件 · リアクション 1 件 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
Quantco/pnpm-licenses#17 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100