# Backstage v1.57.0

2026-11-17 · [元のリリースノート](https://github.com/backstage/backstage/releases/tag/v1.57.0) · [全体のまとめ](https://ratatosk.io/ja/releases/backstage/v1.57.0)

セキュリティ 7 · 破壊的変更 46 · 非推奨 5 · 重大な修正 25 · 機能・改善 28 · その他の変更 34

## アップグレード前の確認事項

### 前提条件

- **非推奨となったフロントエンド API の削除**: このリリースでは、さらに多くの非推奨化が行われ、アップグレード時の更新対象としてカスタム拡張機能と API 実装が挙げられています。
  > This release removes several deprecated APIs from the front-end system and introduces further deprecations. Update custom extensions and API implementations when upgrading:
- **`avsc` と `node-gyp` の Node.js 26 互換性に関する警告**: `avsc` は 5.7.8 より前のバージョンでテストが失敗することがあり、`node-gyp` 12.3.0 はプロキシ経由でヘッダーをダウンロードできません。影響を受けるバージョンを含むロックファイルについて、リリースノートでは `yarn up -R avsc` または `yarn up -R node-gyp` の実行を指定しています。
  > The supported Node.js versions are now 24 and 26. Update `engines.node` in your root `package.json` to `^24.15.0 || ^26.13.0`, and check the versions used in your CI workflows and Docker images. Versions of `avsc` before 5.7.8 can break tests on Node.js 26, and `node-gyp` 12.3.0 cannot download headers through a proxy on that version; run `yarn up -R avsc` or `yarn up -R node-gyp` if your lockfile contains the affected versions.
- **ES2024 フロントエンド API に必要なブラウザーのバージョン**: Backstage はポリフィルを提供していないため、このコードの実行には Chrome または Edge 119、Firefox 121、Safari 17.4 以降が必要です。
  > The CLI now compiles for ES2024 and requires TypeScript 5.9 or later. Backstage does not include polyfills, so frontend code using ES2024 APIs such as `Object.groupBy` needs Chrome or Edge 119, Firefox 121, or Safari 17.4 or later. Contributed by [@sebdanielsson](https://github.com/sebdanielsson) in [#36512](https://github.com/backstage/backstage/pull/36512) and [#36509](https://github.com/backstage/backstage/pull/36509).
- **デプロイ前の PostgreSQL のカラムとインデックスの準備手順**
  > The catalog database upgrade also adds publication bookkeeping and builds an index concurrently on PostgreSQL. The index build scans the catalog table and can exceed deployment startup deadlines on large installations. Review [upgrading large installations](https://github.com/backstage/backstage/blob/master/plugins/catalog-backend/README.md#upgrading-large-installations) for instructions on preparing the column and index before deploying.

  - バックエンドパッケージの依存関係の復元手順
  - Catalog の変更フィード API と削除追跡は利用不可: SQLite と MySQL では、ローリングアップグレード中に古いインスタンスが書き込むと、割り当て済みの世代を保持したままコンテンツを上書きすることがあります。そのため、世代が null でないことは、変更が完全に追跡されている証拠にはなりません。PostgreSQL では、トリガーが古いインスタンスからの書き込みにおける世代の割り当てを追跡します。将来フィードを提供する場合は、ロールアウトの有効化境界と初期同期の方式を明示する必要があります。

### アップグレードガイド

- **アプリ、プラグイン、フロントエンドの移行ガイド**
  > If you are migrating an app, start with the [app migration guide](../frontend-system/building-apps/08-migrating.md). Plugin authors can follow the [plugin migration guide](../frontend-system/building-plugins/05-migrating.md). Apps and plugins already using the front-end system should review the breaking changes below and the [1.57 frontend migration notes](../frontend-system/architecture/60-migrations.md#157).

  - ルーティング移行の注意点とページルーターの設定ガイド
- **Backstage を最新の状態に保つ**
  > We recommend that you keep your Backstage project up to date with this latest release. For more guidance on how to upgrade, check out the documentation for [keeping Backstage updated](https://backstage.io/docs/getting-started/keeping-backstage-updated).

## セキュリティ (7)

### `javascript:`、`data:`、`vbscript:`を使うリンクの無効化

- 影響対象: `javascript:`、`data:`、`vbscript:`を使うリンクがあるアプリ

> Backstage UI routing is configured automatically in Backstage apps. Standalone apps must provide a `useNavigation` hook to `BUIProvider` if they previously relied on automatic React Router integration. `routerOptions` now only accepts `replace` and `state`, and links using `javascript:`, `data:`, or `vbscript:` become inert. See the [routing migration notes](../frontend-system/architecture/60-migrations.md#157) and [page router guide](../frontend-system/building-plugins/10-page-routers.md) for setup and migration examples.

### Backstage CLI のリフレッシュトークン失効処理の修正

- 影響対象: Backstage CLI の `auth logout` コマンドを使用する環境

> Sign-in resolvers now issue canonical, deduplicated entity references in user token claims, and `auth logout` correctly revokes the CLI refresh token. A service-authenticated `POST /v1/offline-sessions/revoke` endpoint lets backends revoke all of a user's offline sessions when `auth.experimentalRefreshToken.enabled` is set. Cursor clients are allowed to use CIMD by default, contributed by [@pjohannis](https://github.com/pjohannis) in [#36568](https://github.com/backstage/backstage/pull/36568).

### Backstage UI のルーティング設定を更新

- 影響対象: Backstage アプリ、および自動 React Router 統合を使用するスタンドアロンアプリ

Backstage アプリでは、Backstage UI のルーティング設定を自動的に受け取るようになりました。自動 React Router 統合に依存していたスタンドアロンアプリでは、`BUIProvider` に `useNavigation` フックを渡す必要があります。

> Backstage UI routing is configured automatically in Backstage apps. Standalone apps must provide a `useNavigation` hook to `BUIProvider` if they previously relied on automatic React Router integration. `routerOptions` now only accepts `replace` and `state`, and links using `javascript:`, `data:`, or `vbscript:` become inert. See the [routing migration notes](../frontend-system/architecture/60-migrations.md#157) and [page router guide](../frontend-system/building-plugins/10-page-routers.md) for setup and migration examples.

### [セキュリティかどうか不明] 認証バックエンドのOAuthサービスで`S256` PKCEが必須に

- 影響対象: 認証バックエンドのOAuthサービスを利用するクライアント

このサービスは従来、`plain`を受け入れ、利用可能な方式として提示していました。`plain`を使うクライアントは現在拒否されるため、SHA-256チャレンジを生成する必要があります。既存のCIMDクライアントと、シークレットを事前登録したクライアントも`S256`を使用する必要があります。

> All clients of the auth backend's OAuth service, including existing CIMD clients and pre-registered clients with a secret, now require Proof Key for Code Exchange (PKCE) with the `S256` challenge method. The `plain` method is no longer accepted or advertised. Update clients that use `plain` to generate SHA-256 challenges. Pre-registered client support and PKCE changes contributed by [@drodil](https://github.com/drodil) in [#36567](https://github.com/backstage/backstage/pull/36567).

### GitHub、GitLab、Azure DevOps の webhook エンドポイントでシークレットなしのリクエストを拒否

- 影響対象: GitHub、GitLab、Azure DevOps のイベントモジュール独自の webhook エンドポイントを使用する構成
- 追加の対応: 該当モジュールの設定での webhook シークレットの設定：`events.modules.github`、`events.modules.gitlab`、`events.modules.azureDevOps`。GitHub App のシークレットも利用可能

シークレットが設定されていないリクエストには HTTP 403 が返されます。GitHub では、GitHub App ごとに設定したシークレットも使用できます。`events.http.topics` のみで設定されたルートには、引き続きバリデーターがありません。

> The GitHub, GitLab, and Azure DevOps events modules now reject requests to their webhook endpoints with HTTP 403 when no webhook secret is configured. Configure secrets under `events.modules.github`, `events.modules.gitlab`, and `events.modules.azureDevOps` before upgrading; GitHub also supports secrets configured per GitHub App. This applies to the modules' own endpoints; routes configured only through `events.http.topics` still have no validator attached.

### TechDocs の S3 接続リークの修正

- 影響対象: S3から配信されるTechDocs

ファイルの読み込みが完了する前にブラウザーが別のページへ移動すると、レスポンスストリームがプール済み接続を保持し続け、同様の切断が50回発生した後にリクエストがソケットタイムアウトで失敗していました。レスポンスが早期に閉じられた場合はS3ストリームを破棄するようになり、接続プールの枯渇を防ぎます。

> - TechDocs releases storage connections when browsers disconnect early, including a fix for S3 connection pool exhaustion. Contributed in part by [@lvthillo](https://github.com/lvthillo) in [#36468](https://github.com/backstage/backstage/pull/36468).

### Backstage パッケージのセキュリティ修正

- 影響対象: `@backstage/backend-defaults`、`@backstage/plugin-auth-backend`、`@backstage/plugin-catalog-backend`、`@backstage/plugin-catalog-backend-module-gitlab`、`@backstage/plugin-events-backend-module-azure`、`@backstage/plugin-events-backend-module-github`、`@backstage/plugin-events-backend-module-gitlab`、`@backstage/plugin-scaffolder-backend`、`@backstage/plugin-scaffolder-react`、`@backstage/plugin-techdocs-backend`、`@backstage/plugin-techdocs-backend-module-zensical`、`@backstage/plugin-techdocs-node`、`@techdocs/cli`のいずれかを使用する環境

> The following packages have received security fixes:
> - `@backstage/backend-defaults`
> - `@backstage/plugin-auth-backend`
> - `@backstage/plugin-catalog-backend`
> - `@backstage/plugin-catalog-backend-module-gitlab`
> - `@backstage/plugin-events-backend-module-azure`
> - `@backstage/plugin-events-backend-module-github`
> - `@backstage/plugin-events-backend-module-gitlab`
> - `@backstage/plugin-scaffolder-backend`
> - `@backstage/plugin-scaffolder-react`
> - `@backstage/plugin-techdocs-backend`
> - `@backstage/plugin-techdocs-backend-module-zensical`
> - `@backstage/plugin-techdocs-node`
> - `@techdocs/cli`

## 破壊的変更 (46)

### [ダウングレード不可] 認証バックエンドから実験的 DCR を削除

- 影響対象: 実験的 DCR を使用する認証バックエンド構成。`auth.experimentalDynamicClientRegistration` が設定されている構成、またはデータベースに DCR クライアントとセッションがある構成を含む
- 必要な対応: CIMD または `auth.staticClients` で事前登録したクライアントを使用し、`auth.experimentalDynamicClientRegistration` を削除した構成
- ダウングレード不可 (推定: DCR クライアントとセッションの削除、および復元に必要な削除済み状態の回復)

移行により DCR クライアントと、それらの認可セッションおよびオフラインセッションが削除され、対応する認可コードとリフレッシュトークンが無効になります。ユーザーは再度サインインする必要がありますが、発行済みのユーザートークンは有効期限が切れるまで有効です。

> The deprecated experimental Dynamic Client Registration (DCR) support has been removed from the auth backend. Use Client ID Metadata Documents (CIMD), or pre-register clients through `auth.staticClients`, and remove `auth.experimentalDynamicClientRegistration` from your configuration. The database migration deletes DCR clients and their authorization and offline sessions, invalidating their authorization codes and refresh tokens. Users must sign in again through a CIMD or pre-registered client; already-issued user tokens remain valid until they expire. See the [DCR migration guide](../ai/mcp-actions.md#migrating-from-dynamic-client-registration).

### `useRouteRefParams` が返すルートパラメーターの限定

- 影響対象: `useRouteRefParams` を使用するコード

以前は、このフックがルート参照で宣言されていないスプラットパラメーターを返すことがありました。この動作に依存していたコードが受け取るのは、ルート参照で宣言されたパラメーターのみになります。

> `RouterBlueprint`, the `app/root` router input, and `convertLegacyAppOptions({ components: { Router } })` are no longer supported. Remove overrides that only install a `BrowserRouter`, move global providers to `AppRootWrapperBlueprint`, and render page adapters inside lazily loaded page components. Framework navigation destinations must start with `/` and exclude the deployment basename; use a page adapter for path-relative navigation. `useRouteRefParams` now returns only the parameters declared by its route ref, without an undeclared splat parameter. Apps using the old front-end system keep their existing routing setup.

### Extension のアタッチ先型の置き換え

- 影響対象: `ExtensionAttachTo` を使用するコード (推定)

利用側では現在、`Extension<unknown>['attachTo']` を使用します。

> - Replace `ExtensionAttachTo` with `Extension<unknown>['attachTo']`, and `ProgressProps` with its existing shape, `{}`.

### フロントエンドの `useApi` による promise を値とする Utility API ref の展開

- 影響対象: `@backstage/frontend-plugin-api` の `useApi` で使用する、promise を値とする Utility API ref
- 必要な対応: 既存の API ref を promise に変更する場合の、利用側とカスタムファクトリーの同時更新

以前、このフックは promise をそのまま返していましたが、現在は API を取り出します。読み込み中は suspend し、拒否理由はエラーバウンダリーに送られます。promise が必要な場合は `useApiHolder().get(ref)` を使用してください。

> ### **BREAKING**: Lazy Utility API implementations
> Utility API factories can now load implementations on demand through dynamic imports. Declare the API value as a promise, for example `ApiRef<Promise<WorkApi>>`. The `useApi` hook from `@backstage/frontend-plugin-api` unwraps the promise, suspends while it is pending, and throws rejection reasons to an error boundary:
> ```ts
> const workApiRef = createApiRef<Promise<WorkApi>>().with({
>   id: 'plugin.example.work',
> });
> const workApi = useApi(workApiRef); // WorkApi
> ```
> The hook's return type is now `Awaited<T>`. Consumers that intentionally used a promise returned by `useApi` must switch to `useApiHolder().get(ref)`. Changing an existing API ref to a promise changes its public contract, so update its consumers and custom factories together. Holders and factory dependencies continue to receive the declared API value unchanged. The legacy `useApi` hook from `@backstage/core-plugin-api` continues returning promises directly.

### Promise を返す API で同期モックを利用可能に

- 影響対象: `TestApiProvider`、その他のモック API オーバーライド、または `renderInTestApp` を使い、Promise を返す API またはモックを扱うテスト

これまでは、Promise を返す API に対する同期モックは受け入れられませんでした。レンダリングがそれ以外の点で同期的であれば、テストでは同期的なアサーションをそのまま使えるようになりました。Promise を返すモックの解決中、`renderInTestApp` は空の Suspense フォールバックを表示します。そのため、祖先の境界が表示するローディング UI に依存していたテストでは、アサーションの更新が必要になる場合があります。

> Page extension boundaries provide Suspense and error handling; consumers outside those boundaries must provide their own. `TestApiProvider` and other mock API overrides accept synchronous mocks even for promise-valued APIs, so tests can keep synchronous assertions when rendering is otherwise synchronous. Promise-valued mocks are also supported, with `renderInTestApp` supplying an empty Suspense fallback while they resolve. Tests that relied on an ancestor boundary's loading UI may need updated assertions. See the [Utility API documentation](../frontend-system/utility-apis/02-creating.md) for lazy factories and migration guidance.

### テストアプリヘルパーで報告された作成エラーを例外として扱う変更

- 影響対象: `renderInTestApp`、`renderTestApp`、または `createExtensionTester` を使うテスト
- 必要な対応: 不正なテスト設定の修正、または意図的なエラーを `isExpectedError` で許可する設定。API のオーバーライドには、`extensions` 内の競合するファクトリーではなく、テストアプリの `apis` オプションを使用すること

これまでは、アプリが壊れていてもテストが成功することがありました。今後は、アプリまたは拡張機能ツリーの作成中に報告されたエラーがあるとテストが失敗します。実際のアプリでは警告としてログに記録されるだけのエラーも対象ですが、`isExpectedError` が許可したエラーは除きます。

> `renderInTestApp`, `renderTestApp`, and `createExtensionTester` now throw for all errors reported while creating the test app or extension tree, including errors that a real app only logs as warnings. Fix invalid test setups, or allow an intentional error through the `isExpectedError` option. API overrides belong in the test app's `apis` option; a conflicting factory supplied through `extensions` is rejected. Contributed by [@dyatko](https://github.com/dyatko) in [#36333](https://github.com/backstage/backstage/pull/36333).

### テストアプリでアプリごとのインメモリストレージを使用

- 影響対象: ブラウザーのストレージ、表示される通知、グローバルなエラー処理、または遅れて登録した購読者へのアラート再送に依存するテストアプリ
- 必要な対応: ブラウザーのストレージ、表示される通知、またはグローバルなエラー処理に依存するテスト向けの明示的な API 実装

トーストとエラーは表示せずに収集されます。また、遅れて登録した購読者へのアラートの再送は行われなくなりました。以前は、遅れて登録した購読者にもアラートが再送されていました。

> Test apps also use defaults designed for isolation: storage is kept in memory per app, toasts and errors are collected without displaying them, and alerts are no longer replayed to late subscribers. Tests that depend on browser storage, visible notifications, or global error handling need an explicit API implementation. Expanded `mockApis` helpers provide typed mocks and functional fakes for core APIs. Removed standalone mock types can be replaced with types derived from these helpers, such as `ReturnType<typeof mockApis.analytics>`.

### 本番用 JSON ログへの行ごとのタイムスタンプ追加

- 影響対象: 本番用 JSON ログを使用する環境
- 必要な対応: リクエストログの `date` フィールドまたは日付プレフィックスを利用するログパイプラインとダッシュボードでは `timestamp` への切り替え、カスタム JSON ロガー形式ではタイムスタンプ保持のための `format.combine(format.timestamp(), format.json())` の指定

以前は、ルート HTTP ルーターのリクエストログにのみ `date` フィールドがあり、`message` の先頭にも同じ値が繰り返し記録されていました。他の本番用 JSON ログ行にはタイムスタンプがありませんでした。現在、標準ログではこれらのリクエストログ値は出力されません。カスタムロガー形式では、必要な形式の組み合わせを含めない限り、タイムスタンプは保持されません。

> Production JSON logs now include a `timestamp` field on every line. Root HTTP router request logs no longer include a `date` field or repeat the date at the start of the message. Update log pipelines and dashboards that read either of those values to use `timestamp`. Custom JSON logger formats should combine `format.timestamp()` with `format.json()` to preserve the field.

### LDAP 組織取り込みでマッピング対象属性をデフォルトで要求

- 影響対象: LDAP 組織エンティティプロバイダーおよび `LdapOrgReaderProcessor` の設定
- 必要な対応: マッピング対象外の属性を必要とするカスタム変換器では、該当属性を `users.options.attributes` または `groups.options.attributes` に列挙するか、`['*', '+']` ですべての属性を要求する設定。明示的に設定するリストには、マッピング、ベンダー設定、変換器が必要とするすべての属性を含めること。

以前は検索時にすべての LDAP 属性が含まれていたため、カスタム変換器はマッピング対象外の属性も読み取ることができました。アップグレード後は、そうした追加属性が LDAP エントリーに含まれない場合があります。

根拠: “**BREAKING**: Searches no longer request `['*', '+']` by default. This applies to both the org entity provider and `LdapOrgReaderProcessor`. When options.attributes is not explicitly configured, attributes required by map (including custom map.\* overrides and membership mappings) are requested automatically. When options.attributes is explicitly configured, the provided list is used as-is and must include all attributes required by mappings, vendor configuration, and custom transformers. Custom transformers that access other attributes from LDAP entries may now find those attributes missing.” https://github.com/backstage/backstage/pull/35319

> LDAP organization ingestion now requests only the attributes used by configured mappings, instead of `['*', '+']`. This affects both the entity provider and `LdapOrgReaderProcessor`. Custom transformers that read additional attributes must list them in `users.options.attributes` or `groups.options.attributes`, or explicitly use `['*', '+']` to request all attributes. An explicitly configured list is used as-is and must include every attribute needed by mappings, vendor configuration, and transformers.

### LDAP エンティティープロバイダーのデフォルトでの並列読み取り

- 影響対象: 接続数の制限により逐次読み取りが必要なディレクトリに接続している LDAP エンティティープロバイダー
- 必要な対応: 接続数の制限により逐次読み取りが必要なディレクトリで、プロバイダーに `disableParallelReads: true` を設定

以前は、更新のたびに1つの LDAP 接続を使ってユーザーとグループを順番に読み取っていました。現在は、`disableParallelReads: true` を設定しない限り、更新ごとに2つの接続を開いてバインドします。

根拠: “The LDAP org entity provider now reads users and groups in parallel by default. Set `disableParallelReads: true` to use one connection and read sequentially. Parallel reads open two binds and two connections per refresh. Directories with per-client connection limits may notice the extra load after upgrading.” https://github.com/backstage/backstage/pull/35319

> The entity provider also reads users and groups in parallel by default, opening two connections and binds per refresh. Set `disableParallelReads: true` on the provider to retain sequential reads when directory connection limits require it. Connections are closed after each refresh.

### `TranslationRef` の値が呼び出し可能な関数に

- 影響対象: `TranslationRef` の値を使用するコード
- 必要な対応: `TranslationRef` の値を不透明な値として扱うこと。複製やプレーンオブジェクト形式の確認は禁止

> `TranslationRef` values are now callable functions and must be treated as opaque values rather than cloned or checked for plain-object shape. Custom `TranslationApi` implementations must provide `t` in every translation snapshot, including while `ready` is false, using available messages and language fallbacks. Titles wait for the initial selected language and retain resolved values during later loads or failures, preserving page state. See the [internationalization guide](../frontend-system/building-plugins/07-internationalization.md).

### Bitbucket Cloud のワークスペースコード検索にユーザー識別可能な認証情報が必要に

- 影響対象: ワークスペースのコード検索を使用する Bitbucket Cloud エンティティプロバイダーの統合
- 必要な対応: ワークスペースのコード検索には、ユーザーを識別できる認証情報が必要です。たとえば、Atlassian アカウントのメールアドレスを `username` とし、API の `token` を使用して、`read:repository:bitbucket` と `read:workspace:bitbucket` の両方のスコープを付与します。

以前はコード検索 API に `read:workspace:bitbucket` は不要でしたが、認証情報が拒否された場合、検出処理はワークスペースのコード検索ではなくソース API に送られるようになりました。API トークンに `read:workspace:bitbucket` を追加すると、ワークスペースのコード検索を再び利用できます。

根拠: “Bitbucket Cloud rejects app passwords, legacy OAuth consumers, and API keys for this API. An API token without `read:workspace:bitbucket` is also rejected with `403`. When that happens, or when code search is not enabled, the provider checks catalog files with the source API instead.” https://github.com/backstage/backstage/pull/36845

> The Bitbucket Cloud entity provider now uses the workspace code search API following retirement of the previous endpoint on November 15, 2026. Workspace code search requires a credential that identifies a user, such as an Atlassian account email as `username` with an API `token`, and both `read:repository:bitbucket` and `read:workspace:bitbucket` scopes. App passwords, legacy OAuth consumers, API keys, and API tokens missing the workspace scope are rejected by that API.

### 不正なCatalogフィルターでHTTP 400を返すように

- 影響対象: `$all`、`$any`、または`$not`を使うCatalogクエリフィルター

フィルターオブジェクトでこれらの演算子のいずれかを他のキーと組み合わせた場合、または`$all`や`$any`に配列以外の値を指定した場合、余分なキーは黙って無視され、件数クエリと一覧クエリでオブジェクトの解釈が異なることがありました。

> Malformed predicates that combine `$all`, `$any`, or `$not` with other keys in the same object, or pass non-array operands to `$all` or `$any`, now receive a 400 response instead of silently ignoring parts of the filter. Entity lookups through `entities/by-refs` now match case-insensitively, consistent with the entity reference contract. Contributed by [@chicobento](https://github.com/chicobento) in [#36744](https://github.com/backstage/backstage/pull/36744).

### Catalog データベースへの公開管理情報の追加

- 影響対象: SQLite、MySQL、PostgreSQL を使用する Catalog バックエンドのインストール環境

SQLite と MySQL では、古いインスタンスが、以前に割り当てられた `generation` を保持したままコンテンツを上書きすることがありました。そのため、この値だけでは変更がすべて追跡されていることを証明できませんでした。今回のアップグレードでは、既存のエンティティを書き換えずに NULL 許容の `generation` 列を追加し、PostgreSQL ではインデックスを並行して構築します。

> The catalog database upgrade also adds publication bookkeeping and builds an index concurrently on PostgreSQL. The index build scans the catalog table and can exceed deployment startup deadlines on large installations. Review [upgrading large installations](https://github.com/backstage/backstage/blob/master/plugins/catalog-backend/README.md#upgrading-large-installations) for instructions on preparing the column and index before deploying.
> Internal publication bookkeeping adds a nullable generation column without
> rewriting existing entities. PostgreSQL builds its index concurrently, but still
> scans the entire catalog table, even when every generation is null.
> The metadata transaction has a five-second lock-wait timeout. If it expires,
> startup fails and must retry; repeated failures can cause deployment restart
> loops. The concurrent index phase has no imposed timeout and can wait on long
> transactions elsewhere in the database, including other plugins using separate
> schemas. It may exceed deployment startup deadlines.

### サインインリゾルバーのユーザートークンクレームにおける正規化・重複排除済みエンティティ参照

- 影響対象: エンティティ参照を含むユーザートークンクレームを発行するサインインリゾルバーを使用する構成

> Sign-in resolvers now issue canonical, deduplicated entity references in user token claims, and `auth logout` correctly revokes the CLI refresh token. A service-authenticated `POST /v1/offline-sessions/revoke` endpoint lets backends revoke all of a user's offline sessions when `auth.experimentalRefreshToken.enabled` is set. Cursor clients are allowed to use CIMD by default, contributed by [@pjohannis](https://github.com/pjohannis) in [#36568](https://github.com/backstage/backstage/pull/36568).

### 初回使用時に読み込む`MarkdownContent`レンダラー

- 影響対象: `MarkdownContent` を使用するアプリ

初回使用時にレンダラーを読み込むことで、アプリの起動時バンドルが小さくなります。レンダリングされた Markdown をすぐに検証するテストでは、非同期クエリが必要になる場合があります。

> - `MarkdownContent` loads its renderer on first use, reducing the app startup bundle. Tests that immediately assert on rendered Markdown may need asynchronous queries.

### Backstage CLI コマンドの終了コード維持

- 影響対象: Backstage CLI の終了コードに依存する自動化処理 (推定)

> - CLI commands preserve their exit codes, and package startup supports repeated `--import` and `--require` flags. Flag support contributed by [@dotboris](https://github.com/dotboris) in [#36647](https://github.com/backstage/backstage/pull/36647).

### 旧アプリルーター API の利用不可

- 影響対象: `RouterBlueprint`、`app/root` ルーター入力、`convertLegacyAppOptions({ components: { Router } })`、または `BrowserRouter` を設定するオーバーライドを使用するアプリ
- 必要な対応: `BrowserRouter` のみを設定するオーバーライドの削除、グローバルプロバイダーの `AppRootWrapperBlueprint` への移行、遅延読み込みされるページコンポーネント内でのページアダプターのレンダリング

> `RouterBlueprint`, the `app/root` router input, and `convertLegacyAppOptions({ components: { Router } })` are no longer supported. Remove overrides that only install a `BrowserRouter`, move global providers to `AppRootWrapperBlueprint`, and render page adapters inside lazily loaded page components. Framework navigation destinations must start with `/` and exclude the deployment basename; use a page adapter for path-relative navigation. `useRouteRefParams` now returns only the parameters declared by its route ref, without an undeclared splat parameter. Apps using the old front-end system keep their existing routing setup.

### `routerOptions` で指定できる値を `replace` と `state` のみに変更

- 影響対象: `replace` または `state` 以外の値で `routerOptions` を設定しているコード

> Backstage UI routing is configured automatically in Backstage apps. Standalone apps must provide a `useNavigation` hook to `BUIProvider` if they previously relied on automatic React Router integration. `routerOptions` now only accepts `replace` and `state`, and links using `javascript:`, `data:`, or `vbscript:` become inert. See the [routing migration notes](../frontend-system/architecture/60-migrations.md#157) and [page router guide](../frontend-system/building-plugins/10-page-routers.md) for setup and migration examples.

### `DialogApi.open` による `show` と `showModal` の置き換え

- 影響対象: ダイアログ API を使用する拡張機能および API 実装 (推定)
- 必要な対応: `show` または `showModal` を使うカスタム拡張機能と API 実装の更新、独自のダイアログ表示での `DialogApi.open` の使用と `core.dialog.v2` API リファレンスの参照、`@backstage/frontend-plugin-api` と合わせた `@backstage/plugin-app` のアップグレード

> - Use `DialogApi.open` with your own dialog presentation instead of `show` or `showModal`, and `IconsApi.icon` instead of `getIcon`. Upgrade `@backstage/plugin-app` alongside `@backstage/frontend-plugin-api`; the API references are now `core.dialog.v2` and `core.icons.v2`.

### アイコン API が `IconsApi.icon` と `core.icons.v2` を使用

- 影響対象: アイコン API を使用する拡張機能と API 実装 (推定)
- 必要な対応: `@backstage/frontend-plugin-api` と併せた `@backstage/plugin-app` のアップグレード

> - Use `DialogApi.open` with your own dialog presentation instead of `show` or `showModal`, and `IconsApi.icon` instead of `getIcon`. Upgrade `@backstage/plugin-app` alongside `@backstage/frontend-plugin-api`; the API references are now `core.dialog.v2` and `core.icons.v2`.

### `@backstage/frontend-plugin-api/alpha` エントリーポイントの削除

- 影響対象: `@backstage/frontend-plugin-api/alpha` からのインポート (推定)
- 必要な対応: `@backstage/frontend-plugin-api/alpha` からのインポートをメインエントリーポイントからのインポートに置き換え

エクスポートはメインエントリーポイントでも、同じ動作と同一性を保ちます。

> - Replace imports from `@backstage/frontend-plugin-api/alpha` with imports from the main entry point. The `/alpha` entry point has been removed; its exports retain the same behavior and identity at their new location.

### `IconBundleBlueprint` がアイコン要素を必須化

- 影響対象: `IconBundleBlueprint`、`IconComponent`、またはアイコンバンドル内の Material UI アイコンを使用する拡張機能
- 必要な対応: `IconComponent` ではなく `IconElement` を使用し、`IconBundleBlueprint` にアイコン要素を指定すること。Material UI アイコンでは `<MyIcon fontSize="inherit" />` を使用すること

以前は、`IconBundleBlueprint` はアイコンコンポーネントを受け取り、`IconComponent` 型も利用できました。`convertLegacyAppOptions` 経由で渡されるアイコンは引き続き自動変換され、認証プロバイダーのアイコンでは引き続きコンポーネントを使用できます。

> - Use `IconElement` instead of the removed `IconComponent` type. `IconBundleBlueprint` now requires elements such as `icons: { user: <MyIcon /> }` rather than components. For Material UI icons, use `<MyIcon fontSize="inherit" />`. Icons passed through `convertLegacyAppOptions` are converted automatically, and auth provider icons continue to accept components.

### Specialized app のセットアップを prepare/finalize フローへ移行

- 影響対象: `createSpecializedApp` を使用するアプリ
- 必要な対応: `createSpecializedApp` から `prepareSpecializedApp(options).finalize()` への置き換え。サインイン機能または非同期のセッション準備を行うアプリでの、ブートストラップアプリのレンダリングと `onFinalized()` 経由の購読。確定済みセッションの再利用における `advanced.sessionState` の使用

> - Use `prepareSpecializedApp(options).finalize()` instead of `createSpecializedApp`. Apps with sign-in or asynchronous session preparation must render the bootstrap app and subscribe through `onFinalized()`. Use `advanced.sessionState` to reuse a finalized session, and `ApiBlueprint` extensions to register custom APIs.

### `ApiBlueprint` 拡張機能で登録されたカスタム API

- 影響対象: カスタム API を登録する拡張機能

> - Use `prepareSpecializedApp(options).finalize()` instead of `createSpecializedApp`. Apps with sign-in or asynchronous session preparation must render the bootstrap app and subscribe through `onFinalized()`. Use `advanced.sessionState` to reuse a finalized session, and `ApiBlueprint` extensions to register custom APIs.

### カスタムナビゲーションコンポーネントでの `navItems` の使用

- 影響対象: カスタムナビゲーションコンポーネント

以前はフラットな `items` コレクションを受け取っていましたが、現在は `navItems.rest()` を通じて項目にアクセスし、`item.href` と `item.title` を使用します。`item.icon` は React 要素として描画します。

> - Custom navigation components now receive `navItems` instead of the flat `items` collection. Use `navItems.rest()`, `item.href`, and `item.title`, and render `item.icon` as a React element.

### 分析機能と拡張ミドルウェアのインポート元変更

- 影響対象: 記載された分析関連のエクスポートまたは `ExtensionFactoryMiddleware` をインポートするプロジェクト (推定)

`AnalyticsImplementation`、`AnalyticsImplementationBlueprint`、`AnalyticsImplementationFactory` のインポート元は `@backstage/plugin-app-react` です。`ExtensionFactoryMiddleware` のインポート元は `@backstage/frontend-app-api` です。

> - Import `AnalyticsImplementation`, `AnalyticsImplementationBlueprint`, and `AnalyticsImplementationFactory` from `@backstage/plugin-app-react`, and `ExtensionFactoryMiddleware` from `@backstage/frontend-app-api`.

### `withApis` から `useApi` を使う関数コンポーネントへの置き換え

- 影響対象: `withApis` を使用するフロントエンドシステムのコード (推定)
- 必要な対応: `withApis` から `useApi` を使う関数コンポーネントへの置き換え

> - Replace `withApis` with a function component using `useApi`. Use `FrontendPlugin.pluginId`, `PageLayoutTab`, and `CreateFrontendPluginOptions` instead of the removed `id`, `PageTab`, and `PluginOptions` aliases.

### フロントエンドプラグインのエイリアス削除

- 影響対象: `id`、`PageTab`、`PluginOptions` エイリアスを使用する拡張機能 (推定)
- 必要な対応: 削除された `id`、`PageTab`、`PluginOptions` エイリアスの代わりに、`FrontendPlugin.pluginId`、`PageLayoutTab`、`CreateFrontendPluginOptions` を使用

このリリース以前は、拡張機能で名前付きの置き換え先の代わりにこれらのエイリアスが使われていました。アップグレード後は、置き換え先となるプロパティと型を使用します。

> - Replace `withApis` with a function component using `useApi`. Use `FrontendPlugin.pluginId`, `PageLayoutTab`, and `CreateFrontendPluginOptions` instead of the removed `id`, `PageTab`, and `PluginOptions` aliases.

### `ProgressProps` を既存の `{}` 型に置き換え

- 影響対象: `ProgressProps` を使用する利用者 (推定)

> - Replace `ExtensionAttachTo` with `Extension<unknown>['attachTo']`, and `ProgressProps` with its existing shape, `{}`.

### アラートとトーストの設定で無視されていた `anchorOrigin` オプションの削除

- 影響対象: `anchorOrigin` を指定する組み込みアラート表示設定、またはトースト表示プロパティ (推定)

これらの設定では `anchorOrigin` を指定できましたが、このオプションは無視されていました。

> - Remove the ignored `anchorOrigin` option from built-in alert display configuration and toast display props.

### `FrontendFeature` プラグインでの `pluginId` 提供必須化

- 影響対象: `pluginId` プロパティ導入前の、`FrontendFeature` として渡されるプラグイン
- 必要な対応: `pluginId` プロパティ導入前のプラグインを、現行のフレームワークバージョンに対して再ビルドする必要

> Plugins passed as a `FrontendFeature` must now provide `pluginId`. Rebuild plugins that predate this property against a current framework version.

### スタンドアロンのモック型の削除

- 影響対象: スタンドアロンのモック型を使用するテストコード

スタンドアロンのモック型は、このリリースより前は利用できました。現在は、たとえば `ReturnType<typeof mockApis.analytics>` のように、`mockApis` ヘルパーから型を導出できます。

> Test apps also use defaults designed for isolation: storage is kept in memory per app, toasts and errors are collected without displaying them, and alerts are no longer replayed to late subscribers. Tests that depend on browser storage, visible notifications, or global error handling need an explicit API implementation. Expanded `mockApis` helpers provide typed mocks and functional fakes for core APIs. Removed standalone mock types can be replaced with types derived from these helpers, such as `ReturnType<typeof mockApis.analytics>`.

### ページのマッチングにフレームワークのルーティングを使うナビゲーションテスト

- 影響対象: ルーティングライブラリのコンテキストを必要とする要素を含むナビゲーションテスト
- 必要な対応: ルーティングライブラリのコンテキストを必要とするテスト要素をページアダプターでラップすること

> Both render helpers now return an `apis` holder with access to the same Utility API instances used by components, including test overrides. For navigation tests, use `apis.get(coreApis.appHistory)` to access the app history. Page matching uses framework routing; wrap test elements in a page adapter when they need routing-library context. See the [navigation testing guide](../frontend-system/building-plugins/02-testing.md#navigation-and-app-history).

### サポート対象の Node.js バージョンを 22・24 から 24・26 に変更

- 影響対象: Node.js 22 を使用する、またはルートの `engines.node`、CI ワークフロー、Docker イメージで Node.js のバージョンを指定している Backstage 環境
- 必要な対応: ルートの `package.json` の `engines.node` を `^24.15.0 || ^26.13.0` に設定し、CI ワークフローと Docker イメージにも一致する Node.js バージョンを設定すること、および create-app で必要な Node.js 24.15.0 以降または 26.13.0 以降

> The supported Node.js versions are now 24 and 26. Update `engines.node` in your root `package.json` to `^24.15.0 || ^26.13.0`, and check the versions used in your CI workflows and Docker images. Versions of `avsc` before 5.7.8 can break tests on Node.js 26, and `node-gyp` 12.3.0 cannot download headers through a proxy on that version; run `yarn up -R avsc` or `yarn up -R node-gyp` if your lockfile contains the affected versions.

### Backstage CLI のコンパイルターゲットを ES2024 に引き上げ

- 影響対象: Backstage CLI パッケージのビルド、アプリバンドル、バックエンドの開発用変換
- 必要な対応: TypeScript 5.9 以降。フロントエンドで ES2024 の組み込み機能を使う場合は、Chrome または Edge 119、Firefox 121、または Safari 17.4 以降

これらのビルドと変換のターゲットが ES2023 から ES2024 に引き上げられます。ES2024 の組み込み機能を使うフロントエンドコードには、ポリフィルがありません。

> The CLI now compiles for ES2024 and requires TypeScript 5.9 or later. Backstage does not include polyfills, so frontend code using ES2024 APIs such as `Object.groupBy` needs Chrome or Edge 119, Firefox 121, or Safari 17.4 or later. Contributed by [@sebdanielsson](https://github.com/sebdanielsson) in [#36512](https://github.com/backstage/backstage/pull/36512) and [#36509](https://github.com/backstage/backstage/pull/36509).

### ほとんどのフロントエンドパッケージで React 18 が必要

- 影響対象: フロントエンドパッケージを使用するアプリ、特に React 17 のアプリと旧フロントエンドシステム
- 必要な対応: React 18

旧フロントエンドシステムのコアパッケージは、自身の peer dependency の範囲では React 17 を引き続き指定していますが、それらの依存パッケージは React 18 を必要とします。

> Most frontend packages now require React 18. The old front-end system core packages retain React 17 in their own peer dependency ranges, but their dependencies include packages that require React 18, so apps using the old system also need to plan the upgrade. See the [React 18 migration guide](../tutorials/react18-migration.md) and [frontend migration notes](../frontend-system/architecture/60-migrations.md#react-17-support-removed).

### `createGitlabTokenValidator` での `logger` 引数の必須化

- 影響対象: カスタム実装からの `createGitlabTokenValidator` の呼び出し
- 必要な対応: カスタム実装から呼び出す場合に必要な、新しい `logger` 引数の指定

> For development setups that deliberately accept unauthenticated events, each module provides an explicit `dangerouslyAllowUnauthenticatedEvents: true` option. Custom users of `createGitlabTokenValidator` must also supply its new `logger` argument. See the configuration sections for the [GitHub](https://github.com/backstage/backstage/blob/master/plugins/events-backend-module-github/README.md#configuration), [GitLab](https://github.com/backstage/backstage/blob/master/plugins/events-backend-module-gitlab/README.md#configuration), and [Azure DevOps](https://github.com/backstage/backstage/blob/master/plugins/events-backend-module-azure/README.md#configuration) modules.

### Scaffolder Google Cloud のタスク復旧時の保存失敗の修正

- 影響対象: Scaffolder Google Cloud モジュールを使ったタスク復旧
- 必要な対応: アップグレード前に必要な、バックエンドの Google Cloud 認証情報への `storage.objects.list` 権限の付与（タスク復旧バケット、既存のオブジェクト権限に追加）

テンプレートのステップが短時間に続けて完了すると、スナップショットが同じ Google Cloud Storage オブジェクトを上書きし、変更レート制限に達してタスク復旧用ワークスペースの保存に失敗することがありました。現在はスナップショットを別々のオブジェクトに保存します。復旧時には最新のスナップショットを復元し、旧バージョンで作成されたスナップショットにも対応します。保存に成功すると古いスナップショットを削除し、削除に失敗した場合は警告をログに記録します。

根拠: “Fixed task recovery workspace saves failing with Google Cloud Storage rate limit errors when template steps finish in quick succession. Each snapshot is saved to a separate object, and recovery continues to support snapshots from older versions.” https://github.com/backstage/backstage/pull/36466

> ### **BREAKING**: Google Cloud task recovery permissions
> The Scaffolder Google Cloud module now stores each task recovery snapshot as a separate object, avoiding storage rate limits when template steps finish in quick succession. Grant the backend's Google Cloud credentials `storage.objects.list` on the task recovery bucket before upgrading, in addition to the existing object permissions. Recovery continues to support snapshots saved by older versions.

### バックエンド HTTP ルーターサービスに WebSocket ルート用の `addWebSocketHandler` を追加

- 影響対象: カスタム `HttpRouterService` または `RootHttpRouterService` の実装を使用する構成、またはバックエンドテストユーティリティを使用する構成
- 必要な対応: カスタム `HttpRouterService` および `RootHttpRouterService` の実装における `addWebSocketHandler` の実装

> The backend HTTP router services now provide `addWebSocketHandler` for registering WebSocket upgrade routes. Routes require token authentication by default, and browser clients can pass bearer tokens through the WebSocket protocol header. Cookie authentication is not supported. Custom implementations of `HttpRouterService` and `RootHttpRouterService` must implement the new method; the backend test utilities support it too.

### Express のみでの WebSocket アップグレード処理を router API に移行

- 影響対象: フレームワークのサーバーレベルリスナーが有効で、Express 経由のみで WebSocket アップグレードを処理するプラグイン

フレームワークのサーバーレベルリスナーだけが有効な場合、ルーター経由で照合されないアップグレード要求には404が返されます。移行中は既存のサーバーアップグレードリスナーと共存でき、ルーターでは `addWebSocketHandler` を使ってアップグレードルートを登録できます。

> The Signals backend uses this API, fixing first connections that previously required an HTTP request before the WebSocket could connect. Existing server upgrade listeners can coexist during migration, but plugins that handle upgrades only through Express, such as the Kubernetes proxy, must migrate to the router API when the framework's server-level listener is active. Otherwise, unmatched upgrades receive a 404 response when it is the only server-level listener. See the [HTTP router service documentation](../backend-system/core-services/http-router.md).

### カスタム `TranslationApi` のスナップショットで `t` が必須

- 影響対象: カスタム `TranslationApi` 実装を使うセットアップ
- 必要な対応: カスタム `TranslationApi` 実装では、`ready` が false の間も含め、利用可能なメッセージと言語フォールバックを使って、すべての翻訳スナップショットで `t` を提供すること

> `TranslationRef` values are now callable functions and must be treated as opaque values rather than cloned or checked for plain-object shape. Custom `TranslationApi` implementations must provide `t` in every translation snapshot, including while `ready` is false, using available messages and language fallbacks. Titles wait for the initial selected language and retain resolved values during later loads or failures, preserving page state. See the [internationalization guide](../frontend-system/building-plugins/07-internationalization.md).

### `coreServices` と `mockServices` オブジェクトの凍結

- 影響対象: `coreServices` または `mockServices` の実行時の変更、または `mockServices` のヘルパーオブジェクトへのスパイ

これらの操作は以前はサポートされていましたが、現在はサポートされていません。既存の呼び出しと型は引き続き利用でき、ヘルパーが作成したモックには影響しません。

> - `coreServices` and `mockServices` are now frozen objects. Existing calls and types remain available, but runtime mutation and spying on the mock service helpers themselves are no longer supported; the mocks they create are unaffected.

### ウォッチモード以外での OpenAPI 生成失敗時の非ゼロ終了コード

- 影響対象: `package schema openapi generate` による OpenAPI クライアントまたはサーバーの生成

以前は、生成された出力に対する `package lint` の失敗などが発生しても、コマンドの終了コードが 0 になることがありました。ウォッチモード以外では、ジェネレーターの処理完了後に非ゼロの終了コードを返すようになりました。ウォッチモードではエラーをログに記録し、監視を続けます。

根拠: “Outside watch mode they now wrap and rethrow the error, and `generate/index.ts` waits for all running generators to settle before exiting so a failure in one doesn't cut off the other mid-run. Watch mode still logs the error and keeps watching.” https://github.com/backstage/backstage/pull/36854

> - OpenAPI client and server generation commands exit with a non-zero status when generation fails, allowing CI to detect failures. Watch mode keeps watching after errors. Contributed by [@aksharprabhudesai](https://github.com/aksharprabhudesai) in [#36854](https://github.com/backstage/backstage/pull/36854).

### `@backstage/cli-module-package-manager-yarn` の Yarn 依存関係をオプショナルなピア依存関係に変更

- 影響対象: `@backstage/cli-module-package-manager-yarn` のインストール
- 必要な対応: 上流の問題が修正されるまで、`pm verify-patches` の実行に必要なルートの開発依存関係 `@yarnpkg/cli`、`@yarnpkg/core`、`@yarnpkg/plugin-patch` と、解決指定 `"@yarnpkg/core/got": "npm:^11.8.6"`

上流でのインストール失敗を回避します。

> - `@backstage/cli-module-package-manager-yarn` makes its Yarn dependencies optional peers to avoid an upstream installation failure. Until fixed upstream, users of `pm verify-patches` must add `@yarnpkg/cli`, `@yarnpkg/core`, and `@yarnpkg/plugin-patch` as root development dependencies, along with the resolution `"@yarnpkg/core/got": "npm:^11.8.6"`.

### `CodeOwnersProcessor` と `AnnotateScmSlugEntityProcessor` のエクスポート削除

- 影響対象: このパッケージから `CodeOwnersProcessor` または `AnnotateScmSlugEntityProcessor` を使用するバックエンド (推定)
- 必要な対応: いずれかのプロセッサーの動作を維持するための、対応するコミュニティモジュールのバックエンドパッケージへのインストールと `backend.add(import('<module-package>'))` による登録、および二重登録を避けるための旧カスタムプロセッサー登録の削除

> ## Migrating removed processors
> `CodeOwnersProcessor` and `AnnotateScmSlugEntityProcessor` are no longer exported
> by this package. Use the corresponding community modules to retain their behavior:
> - `CodeOwnersProcessor`: [`@backstage-community/plugin-catalog-backend-module-codeowners`](https://github.com/backstage/community-plugins/tree/main/workspaces/catalog/plugins/catalog-backend-module-codeowners)
> - `AnnotateScmSlugEntityProcessor`: [`@backstage-community/plugin-catalog-backend-module-annotate-scm-slug`](https://github.com/backstage/community-plugins/tree/main/workspaces/catalog/plugins/catalog-backend-module-annotate-scm-slug)
> Install the module you need in your backend package and register it with
> `backend.add(import('<module-package>'))`. Remove your custom registration of the
> old processor to avoid registering it twice. If you need to configure a processor
> explicitly, follow the replacement module's documentation.

https://github.com/backstage/backstage/blob/master/plugins/catalog-backend/README.md

## 非推奨 (5)

### `AnyApiRef` と `AnyApiFactory` の非推奨化

- 影響対象: `AnyApiRef` または `AnyApiFactory` を使用するコード (推定)
- 削除予定: 不明

互換性のため、これらのエイリアスは引き続き利用できます。型引数を指定しない `ApiRef` と `ApiFactory` が推奨される形式です。

> - `AnyApiRef` and `AnyApiFactory` are deprecated in favor of `ApiRef` and `ApiFactory` without type arguments. The deprecated aliases remain available for compatibility.

### 個別の core Utility API 参照の非推奨化と `coreApis` への集約

- 影響対象: core Utility API 参照を使用するフロントエンドのシステム設定 (推定)
- 削除予定: 不明

既存の個別参照とグループ化された形式は同じ API 参照を指すため、移行期間中も既存のファクトリーと実装との互換性が保たれます。プロバイダー固有の認証参照は引き続き別個です。

> The front-end system now groups its core Utility API references in `coreApis`, imported from `@backstage/frontend-plugin-api`. Access APIs through calls such as `useApi(coreApis.config)`, `useApi(coreApis.identity)`, and `useApi(coreApis.toast)`.
> Individual references with namespace equivalents, such as `configApiRef`, are deprecated. Both forms refer to the same API reference, so existing factories and implementations remain compatible during migration. Provider-specific authentication references remain separate. See [consuming Utility APIs](../frontend-system/utility-apis/03-consuming.md#core-utility-apis) for usage examples and migration guidance.

### 置き換え先がある TechDocs CLI の MkDocs フラグの非推奨化

- 影響対象: `--mkdocs-port`、`--mkdocs-config-file-name`、または `--mkdocs-parameter-*` を使用する TechDocs CLI の設定または自動化
- 削除予定: 不明

非推奨のフラグを使用すると警告が表示されます。置き換え先のフラグも設定されている場合、非推奨のフラグは無視されます。

> The TechDocs CLI supports Zensical in `serve`, `serve:raw`, and `generate`, including live reload in the preview app. Docker images are now selected per engine, and MkDocs previews use `spotify/techdocs:v1.2.8` rather than `latest`. The `--mkdocs-port`, `--mkdocs-config-file-name`, and `--mkdocs-parameter-*` flags are deprecated in favor of `--engine-port`, `--config-file-name`, and `--parameter-*`. An alpha entry point in `@backstage/plugin-techdocs-node` provides building blocks for additional engines.

### `BitbucketCloudClient.searchCode` の非推奨化とワークスペース検索メソッドの追加

- 影響対象: `BitbucketCloudClient.searchCode` の呼び出し元、またはワークスペースのコード検索を必要とする利用者 (推定)
- 削除予定: 不明

このメソッドは、2026年11月15日に削除予定の Bitbucket Cloud エンドポイントを使用します。ワークスペースのコード検索 API には、`read:repository:bitbucket` と `read:workspace:bitbucket` のスコープを持つユーザー認証情報が必要です。

> When code search is unavailable or rejects the configured credentials, discovery falls back to checking catalog files through the source API. Adding `read:workspace:bitbucket` to an API token restores workspace code search. `BitbucketCloudClient.searchCode` is deprecated in favor of `searchWorkspaceCode`.

### `@backstage/core-components` のエクスポートに関する非推奨通知

- 影響対象: 影響を受ける `@backstage/core-components` のエクスポートを使用する構成
- 削除予定: 不明

このリリースでは、対象のエクスポートを引き続き利用できます。移行先として、ページ拡張とサブページ拡張を備えたフレームワーク管理のページには `PageLayout`、単独のレイアウトには `@backstage/ui` を使ったコンポジション、アプリでカスタマイズ可能なアイコンには `coreApis.icons` が案内されています。

> Many `@backstage/core-components` exports now have deprecation notices pointing to Backstage UI replacements or compositions. These include page shells, headers, tabs, links, cards, selectors, avatars, alert displays, and icon wrappers. Existing exports and behavior remain available. Follow each component's migration notice when adapting props, document titles, routing, and layout; these are not all direct import replacements.
> Use page and sub-page extensions with `PageLayout` for framework-managed pages, compose `@backstage/ui` for standalone layouts, and use `coreApis.icons` for app-customizable icons.

## 重大な修正 (25)

### 大文字小文字を区別しない `entities/by-refs` 検索の修正

- 影響対象: `entities/by-refs` 経由のカタログ検索

以前は、保存済みの小文字表記の参照と大文字・小文字が異なる参照を指定すると、エンティティが存在していても `null` が返されていました。現在は該当するエンティティが取得されます。

> Malformed predicates that combine `$all`, `$any`, or `$not` with other keys in the same object, or pass non-array operands to `$all` or `$any`, now receive a 400 response instead of silently ignoring parts of the filter. Entity lookups through `entities/by-refs` now match case-insensitively, consistent with the entity reference contract. Contributed by [@chicobento](https://github.com/chicobento) in [#36744](https://github.com/backstage/backstage/pull/36744).

### OIDCトークンの有効期限における `auth.backstageTokenExpiration` の反映

- 影響対象: `auth.backstageTokenExpiration` を設定した認証バックエンドの OIDC トークン発行

以前は、設定で別の期間を指定しても、OIDC サービスが有効期間を一律1時間とするトークンを発行していました。現在はこの設定が反映されます。既定値は3600秒で、600〜86400秒の値を指定できます。

> OAuth access and ID tokens issued by the auth backend now respect `auth.backstageTokenExpiration` instead of always expiring after one hour. Contributed by [@Retr0-XD](https://github.com/Retr0-XD) in [#35325](https://github.com/backstage/backstage/pull/35325).

### [表面化しなかった不具合] `useTable` のページネーションにおける空ページと `NaN` 範囲の修正

- 影響対象: マウント後に `paginationOptions.type` を `none` から `page` に切り替える complete モードの `useTable` インスタンス

この切り替えを行うと、警告なしにテーブルの行がなくなり、範囲表示が `NaN - NaN of N` になることがありました。現在はテーブルに最初のページが表示されます。

> Alongside the routing changes described above, `useTable` no longer shows an empty page with a `NaN` range when pagination is enabled after mounting. Contributed by [@GabDug](https://github.com/GabDug) in [#35881](https://github.com/backstage/backstage/pull/35881). See the [BUI changelog](https://ui.backstage.io/changelog) for the full list of updates.

### プラグイン間のValkeyキャッシュキー衝突の修正

- 影響対象: Valkey キャッシュストア（`backend.cache.store: valkey`）を使用する構成

2つのプラグインが同じキャッシュキーを使うと、互いの値を読み取ったり上書きしたりする可能性がありました。キーがプラグインごとに名前空間化され、キャッシュが分離されるようになりました。各プラグインが書き込むと値は再作成されますが、TTL が設定された古いエントリーは期限切れまで残り、TTL のないエントリーや古いプラグイン別キーインデックスセットは手動で削除するまで残ります。

> - The Valkey cache store now separates keys by plugin. Existing cache values are rebuilt under new keys, and old entries without a time to live need manual cleanup. Contributed by [@pavstev](https://github.com/pavstev) in [#36584](https://github.com/backstage/backstage/pull/36584).

### 閉じたトーストの再表示を防止

- 影響対象: トースト表示を使用するアプリ

`ToastApi` 経由で表示したトーストは、閉じるボタンまたはタイムアウトで閉じた後に `ToastDisplay` が再マウントされると、テーマの切り替えなどをきっかけに再表示されることがありました。閉じたトーストは再生バッファから削除され、閉じていないトーストは引き続き再表示できるようになりました。

> - Dismissed toasts no longer reappear when the toast display remounts, such as after a theme change. Contributed by [@abdul-karim-mia](https://github.com/abdul-karim-mia) in [#36813](https://github.com/backstage/backstage/pull/36813).

### Scaffolder タスクログの秘匿処理におけるオブジェクトプロパティのキー比較

- 影響対象: 秘密情報に依存するオブジェクトプロパティと公開値を含むアクション入力の Scaffolder バックエンドタスクログ

秘密情報を除外してレンダリングする際、秘密情報に依存するオブジェクトプロパティが省略されると、位置による比較では後続の公開値を秘密情報と誤認してマスクすることがありました。たとえば、秘密トークンの後にある公開 URL が消えることがありました。オブジェクトプロパティはキーで比較し、配列は引き続き位置で比較するようになったため、公開値は表示され、秘密情報から導出されたキーと値は引き続き秘匿されます。

> - Scaffolder task controls retain their chosen visibility after completion, log redaction preserves public values, and custom task permission rules are honored. Contributed by [@ebarault](https://github.com/ebarault) in [#36472](https://github.com/backstage/backstage/pull/36472), [#36477](https://github.com/backstage/backstage/pull/36477), and [#36210](https://github.com/backstage/backstage/pull/36210).

### BUI `SelectWidget` の複数選択描画の修正

- 影響対象: BUI テーマを使用し、`type: array`、`uniqueItems: true`、`items.enum` を指定した `SelectWidget` フィールドを含む Software Template のフォーム

これらのフィールドは以前、単一選択として描画されていました。また、フォーカス時とフォーカス解除時には、インデックスではなくフォームの生値が `enumOptionsValueForIndex` に渡されていました。現在は複数の enum 値を選択でき、単一選択の経路には変更ありません。

> - BUI template forms have clearer array item headings, more accessible item controls, and working enum multi-select fields. Contributed by [@ebarault](https://github.com/ebarault) in [#36469](https://github.com/backstage/backstage/pull/36469), and [@Dasmat13](https://github.com/Dasmat13) in [#36423](https://github.com/backstage/backstage/pull/36423) and [#36331](https://github.com/backstage/backstage/pull/36331).

### DevTools のスケジュールタスク読み込み表示の修正

- 影響対象: DevTools のスケジュールタスクビュー (推定)

初回読み込み後、タスクの読み込み中にプラグインを切り替えると、進行状況が表示されないまま前のプラグインのデータが表示され続けることがありました。現在は、読み込みが完了するまで進行状況を表示し、その後テーブルを表示します。

> - DevTools displays backend errors and loading progress for scheduled tasks. Contributed by [@Dasmat13](https://github.com/Dasmat13) in [#36533](https://github.com/backstage/backstage/pull/36533).

### Windows でのネストしたテンプレートのファイル名生成修正

- 影響対象: ネストしたサブディレクトリにファイルを含むテンプレートでの、Windows 上の `backstage-cli new` の使用 (推定)

相対パス内のバックスラッシュによって Handlebars の波括弧がエスケープされ、`{{extensionName}}` が展開されないままパス区切り文字が削除されることがあり、生成されるファイル名が壊れていました。CLI はネストしたテンプレートのパスにスラッシュを使うようになり、Handlebars による変数の展開と、意図したネスト構造のファイル名の維持が可能になりました。

> - Package scaffolding preserves existing `CODEOWNERS` content, reuses newer compatible dependency ranges, and fixes corrupted nested filenames on Windows. The Windows fix was contributed by [@HLoc26](https://github.com/HLoc26) in [#35242](https://github.com/backstage/backstage/pull/35242).

### 生成された API 宣言の上書き修正

- 影響対象: 名前の大文字・小文字または宣言種別が異なることで衝突する宣言を含む API リファレンスページの生成環境 (推定)

これまでは、生成された API リファレンスページで、名前の大文字・小文字または宣言種別が異なることで衝突する宣言が上書きされていました。現在は、これらの宣言が保持されます。

> - Generated API reference pages no longer overwrite declarations whose names collide by case or declaration kind.

### LDAP プロバイダーの各リフレッシュ後の接続クローズ

- 影響対象: LDAP 接続を開く LDAP エンティティプロバイダーのリフレッシュ

デフォルトでは、プロバイダーはユーザーとグループを並行して読み込み、リフレッシュごとに2つの接続を開いてバインドします。

> The entity provider also reads users and groups in parallel by default, opening two connections and binds per refresh. Set `disableParallelReads: true` on the provider to retain sequential reads when directory connection limits require it. Connections are closed after each refresh.

### Signals バックエンドでの初回 WebSocket 接続の修正

- 影響対象: Signals バックエンドを使用する構成

以前は、Signals バックエンド経由で初めて WebSocket 接続する前に、HTTP リクエストが必要でした。

> The Signals backend uses this API, fixing first connections that previously required an HTTP request before the WebSocket could connect. Existing server upgrade listeners can coexist during migration, but plugins that handle upgrades only through Express, such as the Kubernetes proxy, must migrate to the router API when the framework's server-level listener is active. Otherwise, unmatched upgrades receive a 404 response when it is the only server-level listener. See the [HTTP router service documentation](../backend-system/core-services/http-router.md).

### Bitbucket Cloud のカタログ検出をワークスペースコード検索に切り替え

- 影響対象: カタログ検出に Bitbucket Cloud エンティティプロバイダーを使用する構成 (推定)

従来のコード検索エンドポイントは2026年11月15日に廃止されました。ワークスペースコード検索には、ユーザーを識別する認証情報と、`read:repository:bitbucket` および `read:workspace:bitbucket` の両方のスコープが必要です。検索を利用できない場合や認証情報が拒否された場合、検出はソース API を通じてカタログファイルを確認する方式にフォールバックします。同じ構成であれば、従来と同じ場所が見つかります。

> The Bitbucket Cloud entity provider now uses the workspace code search API following retirement of the previous endpoint on November 15, 2026. Workspace code search requires a credential that identifies a user, such as an Atlassian account email as `username` with an API `token`, and both `read:repository:bitbucket` and `read:workspace:bitbucket` scopes. App passwords, legacy OAuth consumers, API keys, and API tokens missing the workspace scope are rejected by that API.

### PostgreSQL カタログのファセットおよび総件数クエリの高速化

- 影響対象: PostgreSQL カタログのファセットと `queryEntities()` の総アイテム数カウント

本番規模のカタログでは、`$any` または `$not` フィルターを生成する条件付き権限ポリシーにより、これらのクエリに10～25秒かかったり、タイムアウトしたりすることがありました。所有権クレームなど、値のリストが長い場合にも効果があります。クエリはエンティティIDの集合演算を使用するようになり、従来の実装が完了していた場合と同じ結果を返します。

> Catalog queries on PostgreSQL are faster when conditional permission policies produce `$any` or `$not` filters, or match fields against long lists of values such as ownership claims. Facet and total count queries also benefit. Contributed in part by [@drodil](https://github.com/drodil) in [#36518](https://github.com/backstage/backstage/pull/36518).

### タブ間の OAuth リフレッシュ競合の修正

- 影響対象: Web Locks API を備えたブラウザーでの Backstage フロントエンドセッション

ローテーション後のリフレッシュトークンがブラウザーに届く前に、複数のタブが同じ Cookie を使ってリフレッシュを実行し、サインインを求められることがありました。Web Locks API に対応している場合、同じプロバイダーエンドポイントへのリフレッシュはタブ間で同時に1件だけ実行されます。対応していない場合は、引き続きリフレッシュが並行して実行される可能性があります。

> Background OAuth refreshes no longer prompt users to sign in again after transient network failures. Contributed by [@csuich2](https://github.com/csuich2) in [#35003](https://github.com/backstage/backstage/pull/35003). Refresh requests are also coordinated across tabs in browsers with the Web Locks API, avoiding competing refreshes with providers that rotate refresh tokens. Contributed by [@hudsonb](https://github.com/hudsonb) in [#36615](https://github.com/backstage/backstage/pull/36615).

### `test` プラグイン使用時のテストレンダリングヘルパーによる拡張機能の保持

- 影響対象: `features` 内で `test` という名前のプラグインとともに使うテストレンダリングヘルパー

> - Test rendering helpers preserve their test extensions when a plugin named `test` is included in `features`.

### 動的バックエンドプラグインのパッケージ解決を修正

- 影響対象: 動的バックエンドプラグインを使用する構成（pnpm の `isolated` リンカー構成、および Backstage のルート内にある Windows プラグインを含む）

これまでは、ルートの `node_modules` にない共有バックエンドパッケージをプラグインから解決できませんでした。また Windows では、Backstage のルート内にあるプラグインが `NODE_PATH` なしでルートの `node_modules` を見つけることもできませんでした。ローダーは、引き続き優先される既存の検索先に続けて、バックエンドパッケージとローダー自身の検索経路も検索するようになりました。`hoist: false` の場合、バックエンドパッケージとローダーの直接依存関係のみが見つかります。

> - Dynamic backend plugins can resolve shared packages with the isolated pnpm linker. Contributed by [@sebdanielsson](https://github.com/sebdanielsson) in [#36229](https://github.com/backstage/backstage/pull/36229).

### Scaffolder のカスタムタスクルールによる認可とフィルタリングの修正

- 影響対象: カスタム `scaffolder-task` 権限ルールを登録した Scaffolder バックエンド

権限ポリシーの条件で登録済みのカスタム `scaffolder-task` ルールをタスクの認可またはタスク一覧のフィルタリングに使用すると、ルートやフィルタリングでルールが適用されず、500 エラーが返されていました。現在は、個々のタスクへのアクセスと一覧のフィルタリングでこれらのルールが評価されます。ルールを登録しただけではアクセス権は付与されず、権限ポリシーがそのルールを使用する条件を返す必要があります。

> - Scaffolder task controls retain their chosen visibility after completion, log redaction preserves public values, and custom task permission rules are honored. Contributed by [@ebarault](https://github.com/ebarault) in [#36472](https://github.com/backstage/backstage/pull/36472), [#36477](https://github.com/backstage/backstage/pull/36477), and [#36210](https://github.com/backstage/backstage/pull/36210).

### Confluence から Markdown への添付ファイルダウンロード処理の修正

- 影響対象: Confluence から Markdown への変換を行う Scaffolder アクションの添付ファイルダウンロード

添付ファイルのダウンロードが途中で失敗すると、Scaffolder のステップがハングし、ファイルハンドルが開いたままになっていました。こうした失敗時には元のエラーをタスクの失敗として返し、ダウンロードしたファイルはどの経路でも確実に閉じるようになりました。

> - Confluence attachment download failures now fail the task rather than leaving it hanging, and downloaded files are closed correctly. Contributed by [@rowmanempire](https://github.com/rowmanempire) in [#36745](https://github.com/backstage/backstage/pull/36745).

### ブロードキャスト通知のステータス保持の修正

- 影響対象: 通知バックエンドでブロードキャスト通知を使用する構成 (推定)

ブロードキャスト通知を既読または未読にすると、保存状態が消えることがありました。また、保存または保存解除すると、既読状態が消えることがありました。これらの更新では、ユーザーごとにもう一方の状態が維持されるようになりました。

> - Broadcast notifications preserve their read and saved states independently. Contributed by [@FayezBast](https://github.com/FayezBast) in [#36535](https://github.com/backstage/backstage/pull/36535).

### DevTools のスケジュール済みタスク画面での返却エラー表示

- 影響対象: DevTools のスケジュール済みタスク画面 (推定)

`useScheduledTasks` がバックエンドエラー、認可拒否（403）、またはネットワーク障害を返した場合、ユーザーには誤解を招く「スケジュール済みタスクはありません」というメッセージが表示され、入力ミスやタスクリストが空であることを示しているように受け取られる可能性がありました。

> - DevTools displays backend errors and loading progress for scheduled tasks. Contributed by [@Dasmat13](https://github.com/Dasmat13) in [#36533](https://github.com/backstage/backstage/pull/36533).

### カタログ取り込みにおける PostgreSQL のローカライズ済み一意制約違反時のフォールバック修正

- 影響対象: PostgreSQL のローカライズ済みエラーメッセージ（`lc_messages`）を使用するカタログ取り込み

エンティティ参照の重複によって PostgreSQL の一意制約違反が発生した場合、高速挿入処理では個別更新で再試行せず、エラーを再送出していました。現在は個別更新にフォールバックします。SQLite と MySQL のメッセージに基づく検出方法に変更はありません。

> - PostgreSQL unique constraint violations are detected correctly when database error messages are localized, allowing catalog ingestion to fall back to individual updates for duplicate entity references. Contributed by [@harshitsharmaaaa](https://github.com/harshitsharmaaaa) in [#36921](https://github.com/backstage/backstage/pull/36921).

### Backstage CLI の start コマンドで `--require` オプションの複数指定が可能に

- 影響対象: `backstage-cli package start` または `backstage-cli repo start` で複数の `--require` オプションを指定する場合、およびバックエンドパッケージの `start` スクリプト (推定)

これまでは `--require` オプションを1つしか指定できず、`repo start` はバックエンドパッケージの `start` スクリプトから最後のオプションだけを転送していました。現在はオプションを複数指定でき、`repo start` はスクリプトからすべてのオプションを転送します。

> - CLI commands preserve their exit codes, and package startup supports repeated `--import` and `--require` flags. Flag support contributed by [@dotboris](https://github.com/dotboris) in [#36647](https://github.com/backstage/backstage/pull/36647).

### CLI のモジュール変換で型指定のない JavaScript を CommonJS に強制しない変更

- 影響対象: CLI の Node.js 変換を通じて、`type` フィールドのないパッケージから JavaScript を読み込むローカル開発

以前の変換では、該当する JavaScript ファイルを CommonJS として扱っていたため、ES モジュールのエントリーポイントからの名前付きインポートが機能しませんでした。Node.js がファイル形式を判定するようになり、名前付きインポートが正しく読み込まれます。これらのパッケージ内の TypeScript ファイルは、引き続き CommonJS として扱われます。

> - The CLI handles JavaScript ES modules in packages without a `type` field correctly. Contributed by [@vibbix](https://github.com/vibbix) in [#36604](https://github.com/backstage/backstage/pull/36604).

### GitHub URL リーダーによる失敗レスポンス本文の読み取り完了

- 影響対象: GitHub URL リーダーを使用する構成

GitHub へのリクエストが失敗し、レスポンス本文がストリームバッファーに収まらない大きさだった場合、リーダーはレスポンスを未完了のままにし、再起動までソケットを開いたままにしていたため、接続とメモリがリークしていました。現在は例外を投げる前に本文を最後まで読み取るため、レスポンスが完了し、接続が解放されます。

> - The GitHub URL reader releases connections after failed requests with large error bodies, avoiding connection and memory leaks during outages. Contributed by [@dddimcha](https://github.com/dddimcha) in [#36830](https://github.com/backstage/backstage/pull/36830).

## 機能・改善 (28)

- フロントエンドシステムのページ向けルーティングライブラリーアダプター
- プラグイン向けのルーター非依存ナビゲーション API
- 安定版ルーティングエントリーポイントとアプリ履歴へのアクセス
- ページ拡張の境界における Suspense とエラー処理
- コア API 向けの型付きモックと動作するフェイク
- テスト用レンダーヘルパーが `apis` ホルダーを返す
- 認証バックエンドでの OAuth クライアントの事前登録 (利用条件: `auth.staticClients`)
- GitHub、GitLab、Azure DevOps モジュールの未認証イベント設定 (利用条件: 未認証イベントを有効にするための、モジュール設定での `dangerouslyAllowUnauthenticatedEvents: true` の指定)
- WebSocket アップグレードルートのトークン認証 (利用条件: バックエンド HTTP ルーターサービスの `addWebSocketHandler` メソッドを使用した WebSocket アップグレードルートの登録)
- ページおよびサブページのブループリント向け翻訳タイトル
- Software Templates の条件付きパラメータステップ (利用条件: パラメータステップの`when`条件)
- 閲覧者に応じたテンプレート一覧のフィルタリング
- バックエンドのオフラインセッション失効エンドポイント (利用条件: `auth.experimentalRefreshToken.enabled` の設定が必要)
- デフォルトの CIMD 許可リストへの Cursor クライアント ID の追加 (利用条件: CIMD の有効化。`allowedClientIdPatterns` を上書きする場合は、`https://cursor.com/oauth/mcp-client.json` を含めること)
- Azure DevOps App Registration 向けクライアント証明書資格情報 (利用条件: `clientId`、`tenantId`、および `clientCertificate`（秘密鍵を含むインライン PEM）または `clientCertificatePath` のいずれか一方を指定した `ClientCertificate` の設定)
- `@backstage/errors` の静的エラー型ガード
- API リファレンス ID の形式対応を拡大
- プラグインとモジュールの起動結果における `beginAt` タイムスタンプ
- 動的プラグインによる `FrontendFeatureLoader` エクスポートのサポート (利用条件: 動的プラグインの公開エントリーポイントによる `FrontendFeatureLoader` のデフォルトエクスポート。ロード時にフロントエンド機能（入れ子になった `FrontendFeatureLoader` を含む）を選択して返すローダー)
- `RepoBranchPicker` での GitLab ブランチのオートコンプリート (利用条件: GitLab Scaffolder バックエンドモジュール、`requestUserCredentials`、および `repoUrl` という名前のリポジトリフィールド)
- リポジトリルールセット作成用 GitHub Scaffolder アクション (利用条件: Software Template で `github:repo:rulesets:create` アクションを使用したリポジトリルールセットの作成)
- GitHub App での GitHub 組織エンティティプロバイダーによる公開メールアドレスの取得 (利用条件: `fetchEmailForGithubApps` を `true` に設定し、GitHub App にユーザーのメールアドレスを読み取る権限があること)
- Kubernetes クラスターでの AWS アカウント認証情報の直接選択 (利用条件: アカウントの認証情報を直接使用するための、クラスターの認証メタデータへの `kubernetes.io/aws-account-id` の設定)
- Backstage CLI の起動コマンドで `--import` を受け付け
- 読み込み前に選択した配色を適用する Backstage アプリ (利用条件: 既存アプリの場合：`theme.js` と `packages/app/public/index.html` 内の `color-scheme` メタタグおよびスクリプト)
- イベントリクエストバリデーターに渡すリクエストへの解析済みクエリ文字列の追加
- リクエスト拒否ペイロードのカスタムコンテンツタイプ (利用条件: 既定以外のコンテンツタイプを指定する任意の `contentType` オプション)
- `resolvePackagePath` での file URL 対応

## その他の変更 (34)

- 4つのフロントエンドパッケージの公開 API の安定化
- 翻訳タイトルは初回の言語選択まで保留
- TechDocs 向け実験的 Zensical エンジン
- TechDocs CLIとプレビューのライブリロードでのZensical対応
- エンジンごとの TechDocs CLI Docker イメージのデフォルト
- TechDocs エンジンの構成要素を提供する `/alpha` エントリーポイント
- Bitbucket Cloud エンティティープロバイダーのカタログ検出フォールバック
- 一時的なネットワーク障害後も OAuth の更新でセッションを保持
- Azure DevOps Services の個人用アクセストークンに関する Azure DevOps URL リーダーの起動時警告
- ヘッダータブを1行内でスクロール
- カタログの `EntityNotFound` を Backstage UI に切り替え
- カタログインポートのプルリクエストプレビューカードを Backstage UI に切り替え
- アプリバックエンドの起動時チェックで読み込むキャッシュ済みフロントエンドアセットのパス
- 遅延ルート要素の追加によるアプリの再マウントを解消
- props の変更後もマウント状態を維持する差し替え可能なコンポーネント
- TechDocs の目次の位置合わせを修正
- 完了後もボタンバーの表示を維持
- BUI の配列項目見出しに項目タイトルを使用
- BUI フォームのスクリーンリーダー向け通知とラベルの改善
- GitLab Scaffolder の一覧取得失敗時のファイル処理修正
- S3 URL リーダーでアカウントロールの再引き受けを回避
- エンティティ参照の重複による増分取り込みの失敗を解消
- カタログのプレースホルダー処理で読み取り完了後にエラーを報告
- PostgreSQL の検索インデックス作成で変更のないドキュメントの `tsvector` 計算を省略
- `SearchFilter.Autocomplete` の選択後も入力テキストを保持
- World Clock ウィジェットの Backstage UI コンポーネントとスタイルへの切り替え
- パッケージの雛形生成で既存の `CODEOWNERS` 内容を保持
- Backstage のパッケージスキャフォールディングで、より新しい互換性のある依存関係のバージョン範囲を再利用
- バックエンドプラグインのマイグレーションをパッケージ基準で解決
- MSW 3 で未処理リクエストによりテストが失敗する問題を `registerMswTestHooks` で修正
- 作成されたアプリの README におけるデフォルトカタログバックエンドの案内
- 旧バックエンドにおけるカタログルーターの組み込み手順
- Catalog スキーマ移行におけるインデックスの保持と修復
- カタログバックエンドの単独起動とサンプルアプリの起動に関するドキュメント

---

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。
