docs/releases/v1.49.0-next.0-changelog.md
Upgrade Helper: https://backstage.github.io/upgrade-helper/?to=1.49.0-next.0
56bd494: Added targetPaths and findOwnPaths as replacements for findPaths, with a cleaner separation between target project paths and package-relative paths.
To migrate existing findPaths usage:
// Before
import { findPaths } from '@backstage/cli-common';
const paths = findPaths(__dirname);
// After — for target project paths (cwd-based):
import { targetPaths } from '@backstage/cli-common';
// paths.targetDir → targetPaths.dir
// paths.targetRoot → targetPaths.rootDir
// paths.resolveTarget('src') → targetPaths.resolve('src')
// paths.resolveTargetRoot('yarn.lock') → targetPaths.resolveRoot('yarn.lock')
// After — for package-relative paths:
import { findOwnPaths } from '@backstage/cli-common';
const own = findOwnPaths(__dirname);
// paths.ownDir → own.dir
// paths.ownRoot → own.rootDir
// paths.resolveOwn('config/jest.js') → own.resolve('config/jest.js')
// paths.resolveOwnRoot('tsconfig.json') → own.resolveRoot('tsconfig.json')
bf71677: Added opentelemetry metrics for SCM events:
catalog.events.scm.messages with attribute eventType: Counter for the number of SCM events actually received by the catalog backend. The eventType is currently either location or repository.minimatch from 9.0.5 to 10.2.1search table foreign key to point to final_entities instead of refresh_statebf71677: Added the ability for SCM events subscribers to mark the fact that they have taken actions based on events, which produces output metrics:
catalog.events.scm.actions with attribute action: Counter for the number of actions actually taken by catalog internals or other subscribers, based on SCM events. The action is currently either create, delete, refresh, or move.minimatch from 9.0.5 to 10.2.1yarn backstage-cli config:check --strict --config app-config.yaml config validation error by adding
an optional default type discriminator to PostgreSQL connection configuration,
allowing config:check to properly validate default connection configurations.MetricsService to provide a unified interface for metrics instrumentation across Backstage plugins.findPaths to targetPaths and findOwnPaths from @backstage/cli-common.MetricsService to provide a unified interface for metrics instrumentation across Backstage plugins.246877a: Updated dependency bfj to ^9.0.2.
bba2e49: Internal refactor to use new concurrency utilities from @backstage/cli-node.
fd50cb3: Added translations export and translations import commands for managing translation files.
The translations export command discovers all TranslationRef definitions across frontend plugin dependencies and exports their default messages as JSON files. The translations import command generates TranslationResource wiring code from translated JSON files, ready to be plugged into the app.
Both commands support a --pattern option for controlling the message file layout, for example --pattern '{lang}/{id}.json' for language-based directory grouping.
6738cf0: build(deps): bump minimatch from 9.0.5 to 10.2.1
70fc178: Migrated from deprecated findPaths to targetPaths and findOwnPaths from @backstage/cli-common.
de62a9d: Upgraded commander dependency from ^12.0.0 to ^14.0.3 across all CLI packages.
092b41f: Updated dependency webpack to ~5.105.0.
Updated dependencies
runConcurrentTasks and runWorkerQueueThreads utilities, moved from the @backstage/cli internal code.findPaths to targetPaths and findOwnPaths from @backstage/cli-common.findPaths to targetPaths and findOwnPaths from @backstage/cli-common.commander dependency from ^12.0.0 to ^14.0.3 across all CLI packages.findPaths to targetPaths and findOwnPaths from @backstage/cli-common.findPaths to targetPaths and findOwnPaths from @backstage/cli-common.commander dependency from ^12.0.0 to ^14.0.3 across all CLI packages.minimatch from 9.0.5 to 10.2.1pluginId property optional in the FrontendFeature type, allowing plugins published against older versions of the framework to be used without type errors.MockTranslationApi and related test utility imports from @backstage/core-plugin-api/alpha to the stable @backstage/frontend-plugin-api export. The TranslationApi type in the API report is now sourced from a single package. This has no effect on runtime behavior.minimatch from 9.0.5 to 10.2.1fs.pathExists instead of checking the resolved path string, which was always truthy.findPaths to targetPaths and findOwnPaths from @backstage/cli-common.commander dependency from ^12.0.0 to ^14.0.3 across all CLI packages.@microsoft/api-extractor to 7.57.3 and added tests for getTsDocConfigfindPaths to targetPaths and findOwnPaths from @backstage/cli-common.commander dependency from ^12.0.0 to ^14.0.3 across all CLI packages.a1f4bee: Made Accordion a bg provider so nested components like Button auto-increment their background level. Updated useDefinition to resolve bg propDef defaults for provider components.
8909359: Fixed focus-visible outline styles for Menu and Select components.
Affected components: Menu, Select
0f462f8: Improved type safety in useDefinition by centralizing prop resolution and strengthening the BgPropsConstraint to require that bg provider components declare children as a required prop in their OwnProps type.
8909359: Added proper cursor styles for RadioGroup items.
Affected components: RadioGroup
Updated dependencies
translationApiRef, appLanguageApiRef) from the alpha @backstage/core-plugin-api/alpha path to the stable @backstage/frontend-plugin-api export. This has no effect on runtime behavior.minimatch from 9.0.5 to 10.2.1minimatch from 9.0.5 to 10.2.1dc81af1: Adds two new metrics to track MCP server operations and sessions.
mcp.server.operation.duration: The duration taken to process an individual MCP operationmcp.server.session.duration: The duration of the MCP session from the perspective of the serverUpdated dependencies
ui:autoSelect option to the EntityPicker field that controls whether an entity is automatically selected when the field loses focus. When set to false, the field will remain empty if the user closes it without explicitly selecting an entity, preventing unintentional selections. Defaults to true for backward compatibility.formFieldsApiRef and ScaffolderFormFieldsApi alpha exports that were unintentionally removed.maskedAndHidden option to gitlab:projectVariable:create and publish:gitlab action to support creating GitLab project variables that are both masked and hidden. Updated gitbeaker to version 43.8.0 for proper type support.