4a:I[660678,["/_next/static/chunks/1sk8r55q_mng9.js","/_next/static/chunks/1xli048pq-ek6.js","/_next/static/chunks/3db6alzlb_jtc.js","/_next/static/chunks/09a6ip-vyx6yp.js","/_next/static/chunks/2e4udl7tfg2xd.js","/_next/static/chunks/0ipw6pdbca2nn.js","/_next/static/chunks/3zl1wipltkkjk.js","/_next/static/chunks/3vehc-g2atkra.js","/_next/static/chunks/40fmu66fmb8tm.js","/_next/static/chunks/2a4jc680f5x-9.js","/_next/static/chunks/1gth09_ur0iam.js","/_next/static/chunks/0nsogqyo9f92a.js","/_next/static/chunks/3dp-pq73xzz-a.js","/_next/static/chunks/0pp6seif9t0rh.js","/_next/static/chunks/3xgislderjp8_.js","/_next/static/chunks/1umhym11g537p.js","/_next/static/chunks/3bhq66ea_v7by.js","/_next/static/chunks/44c_5nh0vyeb5.js","/_next/static/chunks/1jiredr0b6jr_.js","/_next/static/chunks/2nw5jdup18fxv.js","/_next/static/chunks/2ghxk472-g0i6.js","/_next/static/chunks/1ra7jqz5hyzln.js","/_next/static/chunks/42kj-we3o-c3u.js","/_next/static/chunks/2vvl77bxv5nze.js","/_next/static/chunks/3ecujcyfkbx4l.js","/_next/static/chunks/2l8l4_a9-xhts.js","/_next/static/chunks/34y7-26s89h2f.js","/_next/static/chunks/2t_5zfez2-77k.js","/_next/static/chunks/0ojgzwcpt7vsk.js","/_next/static/chunks/3-906s1ue5fj3.js","/_next/static/chunks/23i2b1iqbto_4.js","/_next/static/chunks/0a0b6s3o7q6fp.js","/_next/static/chunks/3ud55t5lsf-yw.js","/_next/static/chunks/2641m2aqdum9a.js","/_next/static/chunks/2rzv45ystgqbh.js","/_next/static/chunks/1j29bqcxcpyur.js"],"HydrationBoundary"] 4b:Tcd1,# backstage-plugin-frontend-system-migration Multi-step Codemod workflow for a **full** [Backstage new frontend system](https://backstage.io/docs/frontend-system/building-plugins/migrating) migration (drops legacy `@backstage/core-plugin-api` usage). ## Workflow Everything lives in **[workflow.yaml](workflow.yaml)**. The workflow has **one automatic node** (`deterministic-nfs-migration`) so Codemod Cloud runs a **single task** (sequential steps, one git checkout—avoids parallel `.git/index.lock` conflicts). | Step group | Purpose | |------------|---------| | **Deterministic JSSG** (always) | One **js-ast-grep** step: [`scripts/unified.ts`](scripts/unified.ts) runs metrics → route refs → plugin shell → APIs → pages/hooks in order (implemented in `inventory.ts` … `pages-hooks.ts`). | | **Optional** (last two steps) | **AI** and/or **package.json + lockfile** updates, gated by [parameters](#parameters) (both **off by default**). | ## Parameters Defaults are **false** for both: | Parameter | When `true` | |-----------|-------------| | `run_ai_followups` | Runs the AI step (SubPageBlueprint, `useRouteRef` guards, external route defaults). | | `update_package_dependencies` | Removes legacy `@backstage/core-*` deps and adds `@backstage/frontend-plugin-api` (uses npm by default; see env below). | ## Usage ```bash # Default: deterministic migration only (no AI, no package.json changes) npx codemod run backstage-plugin-frontend-system-migration --target /path/to/repo # Local npx codemod workflow run -w workflow.yaml -t /path/to/backstage-repo # Enable optional steps (repeat --param for each) npx codemod workflow run -w workflow.yaml -t /path/to/repo \ --param run_ai_followups=true \ --param update_package_dependencies=true ``` **Target directory:** set `CODEMOD_TARGET` or `CODEMOD_TARGET_PATH` when the shell working directory is not the plugin package root (used by the optional package step). **Package manager** for `update_package_dependencies`: set `CODEMOD_PACKAGE_MANAGER` to `pnpm` or `yarn` if the repo does not use npm. ## Scripts - `scripts/unified.ts` — **workflow entrypoint**; runs each phase in order, re-parses after each `commitEdits` result, and passes the real file path via transform `params` when `filename()` is `anonymous` (see `scripts/lib/effective-filename.ts`) - `scripts/inventory.ts` — metrics: `backstage-nfs-migration` with `step=inventory` (patterns and risk: safe / medium / tricky) - `scripts/route-refs.ts` — route refs (uses `@jssg/utils` for imports) - `scripts/plugin-shell.ts` — plugin shell + optional `plugin.ts` → `plugin.tsx` - `scripts/apis.ts` — API factories and refs - `scripts/pages-hooks.ts` — pure imports + same metric with `step=pages-hooks` for internal `` usage ## Agent skill (Cursor / coding agents) See **[SKILL.md](SKILL.md)** for when to use this migration, how to run the workflow, and how optional AI and package steps fit after the deterministic JSSG steps (same node). ## Development ```bash npm test npx codemod workflow validate -w workflow.yaml ``` `npm test` runs JSSG tests: `tests/inventory` uses `scripts/inventory.ts` alone (metrics-only expectations); other suites use `scripts/unified.ts` to match the workflow. ## License MIT 48:["$","$L4a",null,{"state":{"mutations":[],"queries":[{"state":{"data":{"json":{"id":"355446fc-99c9-474a-8aa6-e74d0a4c2620","name":"backstage-plugin-frontend-system-migration","displayName":"backstage-plugin-frontend-system-migration","description":"Migrate Backstage frontend plugins from the legacy core-plugin-api model to the new frontend system (frontend-plugin-api): one unified JSSG step (scripts/unified.ts chains metrics, route refs, plugin shell, APIs, page hooks); optional AI and package.json/lockfile steps in the same workflow node, gated by params (off by default).","scope":null,"visibility":"public","downloadCount":2,"executionCount":1,"createdAt":"2026-04-01 20:29:17.438199+00","updatedAt":"2026-04-01 22:43:04.32298+00","latestVersion":"0.1.5","keywords":["migration","backstage","upgrade","frontend-plugin-api"],"starCount":1,"author":"Alex Bit ","homepage":null,"repository":"https://github.com/alexbit-codemod/backstage-codemods","license":"MIT","access":"public","documentation":null,"bugsUrl":null,"readme":"$4b","organization":{"id":null,"name":null,"slug":null,"avatarUrl":null},"owner":{"id":"4519f7a8-2ebc-4eaf-8c0a-e01be4c05878","username":"alexbit-codemod","name":"Alex Bit","avatarUrl":"https://avatars.githubusercontent.com/u/78109534?v=4"},"isLegacy":false,"versions":[{"version":{"id":"ff82053c-14c6-4ab7-a72d-ea7efcd7ad73","packageId":"355446fc-99c9-474a-8aa6-e74d0a4c2620","version":"0.1.5","description":"Migrate Backstage frontend plugins from the legacy core-plugin-api model to the new frontend system (frontend-plugin-api): one unified JSSG step (scripts/unified.ts chains metrics, route refs, plugin shell, APIs, page hooks); optional AI and package.json/lockfile steps in the same workflow node, gated by params (off by default).","manifest":{"name":"backstage-plugin-frontend-system-migration","author":"Alex Bit ","license":"MIT","targets":{"versions":{},"languages":["typescript","tsx"],"frameworks":[]},"version":"0.1.5","category":"migration","keywords":["migration","backstage","upgrade","frontend-plugin-api"],"registry":{"access":"public","visibility":"public"},"workflow":"workflow.yaml","repository":"https://github.com/alexbit-codemod/backstage-codemods","description":"Migrate Backstage frontend plugins from the legacy core-plugin-api model to the new frontend system (frontend-plugin-api): one unified JSSG step (scripts/unified.ts chains metrics, route refs, plugin shell, APIs, page hooks); optional AI and package.json/lockfile steps in the same workflow node, gated by params (off by default).","dependencies":[],"schema_version":"1.0"},"checksum":"4a2184462b73d3b4765b7591526f284f2235f1c1f9deab9b297e53db22ce26a4","size":21663,"downloadUrl":"https://registry-cdn.codemod.com/prod/packages/backstage-plugin-frontend-system-migration/0.1.5/public.tar.gz","aiGenerated":false,"sourceArchiveS3Key":null,"targets":{"languages":["typescript"],"frameworks":[]},"dependencies":[],"languages":["tsx"],"stepTypes":["js-ast-grep","ai","run"],"workflowMetadata":{"nodes":[{"id":"deterministic-nfs-migration","name":"NFS migration (metrics + JSSG + optional follow-ups)","steps":[{"name":"NFS migration (unified JSSG)","type":"js-ast-grep","language":"tsx"},{"name":"AI-assisted tricky migrations","type":"ai"},{"name":"Remove legacy core deps and add frontend-plugin-api","type":"run"}]}]},"validated":false,"validationErrors":null,"publishedBy":"4519f7a8-2ebc-4eaf-8c0a-e01be4c05878","deprecated":false,"deprecationMessage":null,"downloadCount":0,"cachedTestCases":{"input":"import {\n createApiFactory,\n createApiRef,\n discoveryApiRef,\n} from \"@backstage/core-plugin-api\";\n\nexport const myPluginApiRef = createApiRef({\n id: \"plugin.my-plugin.client\",\n});\n\nexport const myPluginApi = createApiFactory({\n api: myPluginApiRef,\n deps: { discoveryApi: discoveryApiRef },\n factory: ({ discoveryApi }) => new MyClient({ discoveryApi }),\n});\n","output":"import {\n ApiBlueprint,\n createApiRef,\n discoveryApiRef,\n} from \"@backstage/frontend-plugin-api\";\n\nexport const myPluginApiRef = createApiRef().with({ id: \"plugin.my-plugin.client\", pluginId: \"my-plugin\" });\n\nexport const myPluginApi = ApiBlueprint.make({ params: defineParams => defineParams({\n api: myPluginApiRef,\n deps: { discoveryApi: discoveryApiRef },\n factory: ({ discoveryApi }) => new MyClient({ discoveryApi }),\n}) });\n","isValid":true,"examples":[{"name":"factory-and-ref","path":"tests/apis/factory-and-ref","input":"import {\n createApiFactory,\n createApiRef,\n discoveryApiRef,\n} from \"@backstage/core-plugin-api\";\n\nexport const myPluginApiRef = createApiRef({\n id: \"plugin.my-plugin.client\",\n});\n\nexport const myPluginApi = createApiFactory({\n api: myPluginApiRef,\n deps: { discoveryApi: discoveryApiRef },\n factory: ({ discoveryApi }) => new MyClient({ discoveryApi }),\n});\n","output":"import {\n ApiBlueprint,\n createApiRef,\n discoveryApiRef,\n} from \"@backstage/frontend-plugin-api\";\n\nexport const myPluginApiRef = createApiRef().with({ id: \"plugin.my-plugin.client\", pluginId: \"my-plugin\" });\n\nexport const myPluginApi = ApiBlueprint.make({ params: defineParams => defineParams({\n api: myPluginApiRef,\n deps: { discoveryApi: discoveryApiRef },\n factory: ({ discoveryApi }) => new MyClient({ discoveryApi }),\n}) });\n","filename":"input.ts"},{"name":"pure-imports","path":"tests/pages-hooks/pure-imports","input":"import { useApi, useRouteRef, configApiRef } from \"@backstage/core-plugin-api\";\n\nexport function f() {\n useApi(configApiRef);\n}\n","output":"import {\n configApiRef,\n useApi,\n useRouteRef,\n} from \"@backstage/frontend-plugin-api\";\n\nexport function f() {\n useApi(configApiRef);\n}\n","filename":"input.ts"},{"name":"routes","path":"tests/route-refs/routes","input":"import {\n createRouteRef,\n createSubRouteRef,\n createExternalRouteRef,\n} from \"@backstage/core-plugin-api\";\n\nexport const rootRouteRef = createRouteRef({ id: \"my-plugin\" });\n\nexport const detailsRouteRef = createSubRouteRef({\n id: \"my-plugin-details\",\n parent: rootRouteRef,\n path: \"details/:id/\",\n});\n\nexport const docsRouteRef = createExternalRouteRef({ id: \"docs\" });\n","output":"import {\n createRouteRef,\n createSubRouteRef,\n createExternalRouteRef,\n} from \"@backstage/frontend-plugin-api\";\n\nexport const rootRouteRef = createRouteRef();\n\nexport const detailsRouteRef = createSubRouteRef({ parent: rootRouteRef, path: \"/details/:id\" });\n\nexport const docsRouteRef = createExternalRouteRef({ defaultTarget: 'techdocs.docRoot' });\n","filename":"input.ts"}]},"defaultWorkflowName":"default","createdAt":"2026-04-01T22:43:04.322Z","updatedAt":"2026-05-26 08:41:04.708862+00"},"publishedBy":{"id":"4519f7a8-2ebc-4eaf-8c0a-e01be4c05878","username":"alexbit-codemod","name":"Alex Bit"},"insightsTemplate":{"packageVersionId":"ff82053c-14c6-4ab7-a72d-ea7efcd7ad73","status":"ready","generatedAt":"2026-07-21T16:09:08.697Z"},"workflows":[{"name":"default","path":"workflow.yaml","description":null,"isDefault":true,"languages":["tsx"],"stepTypes":["js-ast-grep","ai","run"],"workflowMetadata":{"nodes":[{"id":"deterministic-nfs-migration","name":"NFS migration (metrics + JSSG + optional follow-ups)","steps":[{"name":"NFS migration (unified JSSG)","type":"js-ast-grep","language":"tsx"},{"name":"AI-assisted tricky migrations","type":"ai"},{"name":"Remove legacy core deps and add frontend-plugin-api","type":"run"}]}]}}],"packageBehavior":"workflow-only","isBundle":false,"bundleChildren":[],"parentBundles":[]},{"version":{"id":"65648951-12a6-4d8b-8ef0-43d078c4d03e","packageId":"355446fc-99c9-474a-8aa6-e74d0a4c2620","version":"0.1.3","description":"Migrate Backstage frontend plugins from the legacy core-plugin-api model to the new frontend system (frontend-plugin-api): route refs, plugin shell, APIs, page hooks, blast-radius metrics; optional AI and package.json/lockfile steps in the same workflow node, gated by params (off by default).","manifest":{"name":"backstage-plugin-frontend-system-migration","author":"Alex Bit ","license":"MIT","targets":{"versions":{},"languages":["typescript","tsx"],"frameworks":[]},"version":"0.1.3","category":"migration","keywords":["migration","backstage","upgrade","frontend-plugin-api"],"registry":{"access":"public","visibility":"public"},"workflow":"workflow.yaml","repository":"https://github.com/alexbit-codemod/backstage-codemods","description":"Migrate Backstage frontend plugins from the legacy core-plugin-api model to the new frontend system (frontend-plugin-api): route refs, plugin shell, APIs, page hooks, blast-radius metrics; optional AI and package.json/lockfile steps in the same workflow node, gated by params (off by default).","dependencies":[],"schema_version":"1.0"},"checksum":"7bb6b61d76958230939d6ced7a59411052a327ec8d1d1685553b8ec4cfcc77bb","size":20552,"downloadUrl":"https://registry-cdn.codemod.com/prod/packages/backstage-plugin-frontend-system-migration/0.1.3/public.tar.gz","aiGenerated":false,"sourceArchiveS3Key":null,"targets":{"languages":["typescript"],"frameworks":[]},"dependencies":[],"languages":["tsx"],"stepTypes":["js-ast-grep","ai","run"],"workflowMetadata":{"nodes":[{"id":"deterministic-nfs-migration","name":"NFS migration (metrics + JSSG + optional follow-ups)","steps":[{"name":"Blast radius (metrics only)","type":"js-ast-grep","language":"tsx"},{"name":"Migrate route refs","type":"js-ast-grep","language":"tsx"},{"name":"createPlugin to createFrontendPlugin","type":"js-ast-grep","language":"tsx"},{"name":"ApiBlueprint and createApiRef","type":"js-ast-grep","language":"tsx"},{"name":"Pure core-plugin-api imports and router metrics","type":"js-ast-grep","language":"tsx"},{"name":"AI-assisted tricky migrations","type":"ai"},{"name":"Remove legacy core deps and add frontend-plugin-api","type":"run"}]}]},"validated":false,"validationErrors":null,"publishedBy":"4519f7a8-2ebc-4eaf-8c0a-e01be4c05878","deprecated":false,"deprecationMessage":null,"downloadCount":0,"cachedTestCases":{"input":"import { createRouteRef } from \"@backstage/frontend-plugin-api\";\n\nexport const r = createRouteRef();\n","output":"import {\n createRouteRef,\n createSubRouteRef,\n createExternalRouteRef,\n} from \"@backstage/frontend-plugin-api\";\n\nexport const rootRouteRef = createRouteRef();\n\nexport const detailsRouteRef = createSubRouteRef({ parent: rootRouteRef, path: \"/details/:id\" });\n\nexport const docsRouteRef = createExternalRouteRef({ defaultTarget: 'techdocs.docRoot' });\n","isValid":true},"defaultWorkflowName":"default","createdAt":"2026-04-01T22:32:57.285Z","updatedAt":"2026-04-01 22:32:57.973789+00"},"publishedBy":{"id":"4519f7a8-2ebc-4eaf-8c0a-e01be4c05878","username":"alexbit-codemod","name":"Alex Bit"},"insightsTemplate":null,"workflows":[{"name":"default","path":"workflow.yaml","description":null,"isDefault":true,"languages":["tsx"],"stepTypes":["js-ast-grep","ai","run"],"workflowMetadata":{"nodes":[{"id":"deterministic-nfs-migration","name":"NFS migration (metrics + JSSG + optional follow-ups)","steps":[{"name":"Blast radius (metrics only)","type":"js-ast-grep","language":"tsx"},{"name":"Migrate route refs","type":"js-ast-grep","language":"tsx"},{"name":"createPlugin to createFrontendPlugin","type":"js-ast-grep","language":"tsx"},{"name":"ApiBlueprint and createApiRef","type":"js-ast-grep","language":"tsx"},{"name":"Pure core-plugin-api imports and router metrics","type":"js-ast-grep","language":"tsx"},{"name":"AI-assisted tricky migrations","type":"ai"},{"name":"Remove legacy core deps and add frontend-plugin-api","type":"run"}]}]}}],"packageBehavior":"workflow-only","isBundle":false,"bundleChildren":[],"parentBundles":[]},{"version":{"id":"093c75b1-6653-4782-9b27-3471cd504227","packageId":"355446fc-99c9-474a-8aa6-e74d0a4c2620","version":"0.1.2","description":"Migrate Backstage frontend plugins from the legacy core-plugin-api model to the new frontend system (frontend-plugin-api): route refs, plugin shell, APIs, page hooks, blast-radius metrics; optional AI and package.json/lockfile updates via workflow params (off by default).","manifest":{"name":"backstage-plugin-frontend-system-migration","author":"Alex Bit ","license":"MIT","targets":{"versions":{},"languages":["typescript","tsx"],"frameworks":[]},"version":"0.1.2","category":"migration","keywords":["migration","backstage","upgrade","frontend-plugin-api"],"registry":{"access":"public","visibility":"public"},"workflow":"workflow.yaml","repository":"https://github.com/alexbit-codemod/backstage-codemods","description":"Migrate Backstage frontend plugins from the legacy core-plugin-api model to the new frontend system (frontend-plugin-api): route refs, plugin shell, APIs, page hooks, blast-radius metrics; optional AI and package.json/lockfile updates via workflow params (off by default).","dependencies":[],"schema_version":"1.0"},"checksum":"61be49e3846cbe37947111091d0f2283463cf0d59a1b2a46e95f0e5614017dfe","size":20636,"downloadUrl":"https://registry-cdn.codemod.com/prod/packages/backstage-plugin-frontend-system-migration/0.1.2/public.tar.gz","aiGenerated":false,"sourceArchiveS3Key":null,"targets":{"languages":["typescript"],"frameworks":[]},"dependencies":[],"languages":["tsx"],"stepTypes":["js-ast-grep","ai","run"],"workflowMetadata":{"nodes":[{"id":"deterministic-nfs-migration","name":"Deterministic NFS migration (metrics + JSSG)","steps":[{"name":"Blast radius (metrics only)","type":"js-ast-grep","language":"tsx"},{"name":"Migrate route refs","type":"js-ast-grep","language":"tsx"},{"name":"createPlugin to createFrontendPlugin","type":"js-ast-grep","language":"tsx"},{"name":"ApiBlueprint and createApiRef","type":"js-ast-grep","language":"tsx"},{"name":"Pure core-plugin-api imports and router metrics","type":"js-ast-grep","language":"tsx"}]},{"id":"optional-nfs-followups","name":"Optional AI and package updates","steps":[{"name":"AI-assisted tricky migrations","type":"ai"},{"name":"Remove legacy core deps and add frontend-plugin-api","type":"run"}]}]},"validated":false,"validationErrors":null,"publishedBy":"4519f7a8-2ebc-4eaf-8c0a-e01be4c05878","deprecated":false,"deprecationMessage":null,"downloadCount":2,"cachedTestCases":{"input":"import { createRouteRef } from \"@backstage/frontend-plugin-api\";\n\nexport const r = createRouteRef();\n","output":"import {\n createRouteRef,\n createSubRouteRef,\n createExternalRouteRef,\n} from \"@backstage/frontend-plugin-api\";\n\nexport const rootRouteRef = createRouteRef();\n\nexport const detailsRouteRef = createSubRouteRef({ parent: rootRouteRef, path: \"/details/:id\" });\n\nexport const docsRouteRef = createExternalRouteRef({ defaultTarget: 'techdocs.docRoot' });\n","isValid":true},"defaultWorkflowName":"default","createdAt":"2026-04-01T22:12:32.410Z","updatedAt":"2026-04-01 22:13:59.403305+00"},"publishedBy":{"id":"4519f7a8-2ebc-4eaf-8c0a-e01be4c05878","username":"alexbit-codemod","name":"Alex Bit"},"insightsTemplate":null,"workflows":[{"name":"default","path":"workflow.yaml","description":null,"isDefault":true,"languages":["tsx"],"stepTypes":["js-ast-grep","ai","run"],"workflowMetadata":{"nodes":[{"id":"deterministic-nfs-migration","name":"Deterministic NFS migration (metrics + JSSG)","steps":[{"name":"Blast radius (metrics only)","type":"js-ast-grep","language":"tsx"},{"name":"Migrate route refs","type":"js-ast-grep","language":"tsx"},{"name":"createPlugin to createFrontendPlugin","type":"js-ast-grep","language":"tsx"},{"name":"ApiBlueprint and createApiRef","type":"js-ast-grep","language":"tsx"},{"name":"Pure core-plugin-api imports and router metrics","type":"js-ast-grep","language":"tsx"}]},{"id":"optional-nfs-followups","name":"Optional AI and package updates","steps":[{"name":"AI-assisted tricky migrations","type":"ai"},{"name":"Remove legacy core deps and add frontend-plugin-api","type":"run"}]}]}}],"packageBehavior":"workflow-only","isBundle":false,"bundleChildren":[],"parentBundles":[]},{"version":{"id":"6a2b92b8-d925-46fe-999a-1e411445c527","packageId":"355446fc-99c9-474a-8aa6-e74d0a4c2620","version":"0.1.1","description":"Migrate Backstage frontend plugins from the legacy core-plugin-api model to the new frontend system (frontend-plugin-api): route refs, plugin shell, APIs, page hooks, blast-radius metrics; optional AI and package.json/lockfile updates via workflow params (off by default).","manifest":{"name":"backstage-plugin-frontend-system-migration","author":"Alex Bit ","license":"MIT","targets":{"versions":{},"languages":["typescript","tsx"],"frameworks":[]},"version":"0.1.1","category":"migration","keywords":["migration","backstage","upgrade","frontend-plugin-api"],"registry":{"access":"public","visibility":"public"},"workflow":"workflow.yaml","repository":"https://github.com/alexbit-codemod/backstage-codemods","description":"Migrate Backstage frontend plugins from the legacy core-plugin-api model to the new frontend system (frontend-plugin-api): route refs, plugin shell, APIs, page hooks, blast-radius metrics; optional AI and package.json/lockfile updates via workflow params (off by default).","dependencies":[],"schema_version":"1.0"},"checksum":"93716b565bfff9f98a07482ad667eabbc17116dc7db0715b006afa8a5e15c343","size":19732,"downloadUrl":"https://registry-cdn.codemod.com/prod/packages/backstage-plugin-frontend-system-migration/0.1.1/public.tar.gz","aiGenerated":false,"sourceArchiveS3Key":null,"targets":{"languages":["typescript"],"frameworks":[]},"dependencies":[],"languages":["tsx"],"stepTypes":["js-ast-grep","ai","run"],"workflowMetadata":{"nodes":[{"id":"deterministic-nfs-migration","name":"Deterministic NFS migration (metrics + JSSG)","steps":[{"name":"Blast radius (metrics only)","type":"js-ast-grep","language":"tsx"},{"name":"Migrate route refs","type":"js-ast-grep","language":"tsx"},{"name":"createPlugin to createFrontendPlugin","type":"js-ast-grep","language":"tsx"},{"name":"ApiBlueprint and createApiRef","type":"js-ast-grep","language":"tsx"},{"name":"Pure core-plugin-api imports and router metrics","type":"js-ast-grep","language":"tsx"}]},{"id":"optional-nfs-followups","name":"Optional AI and package updates","steps":[{"name":"AI-assisted tricky migrations","type":"ai"},{"name":"Remove legacy core deps and add frontend-plugin-api","type":"run"}]}]},"validated":false,"validationErrors":null,"publishedBy":"4519f7a8-2ebc-4eaf-8c0a-e01be4c05878","deprecated":false,"deprecationMessage":null,"downloadCount":0,"cachedTestCases":{"input":"import { createRouteRef } from \"@backstage/frontend-plugin-api\";\n\nexport const r = createRouteRef();\n","output":"import {\n createRouteRef,\n createSubRouteRef,\n createExternalRouteRef,\n} from \"@backstage/frontend-plugin-api\";\n\nexport const rootRouteRef = createRouteRef();\n\nexport const detailsRouteRef = createSubRouteRef({ parent: rootRouteRef, path: \"/details/:id\" });\n\nexport const docsRouteRef = createExternalRouteRef({ defaultTarget: 'techdocs.docRoot' });\n","isValid":true},"defaultWorkflowName":"default","createdAt":"2026-04-01T22:02:38.052Z","updatedAt":"2026-04-01 22:02:38.894604+00"},"publishedBy":{"id":"4519f7a8-2ebc-4eaf-8c0a-e01be4c05878","username":"alexbit-codemod","name":"Alex Bit"},"insightsTemplate":null,"workflows":[{"name":"default","path":"workflow.yaml","description":null,"isDefault":true,"languages":["tsx"],"stepTypes":["js-ast-grep","ai","run"],"workflowMetadata":{"nodes":[{"id":"deterministic-nfs-migration","name":"Deterministic NFS migration (metrics + JSSG)","steps":[{"name":"Blast radius (metrics only)","type":"js-ast-grep","language":"tsx"},{"name":"Migrate route refs","type":"js-ast-grep","language":"tsx"},{"name":"createPlugin to createFrontendPlugin","type":"js-ast-grep","language":"tsx"},{"name":"ApiBlueprint and createApiRef","type":"js-ast-grep","language":"tsx"},{"name":"Pure core-plugin-api imports and router metrics","type":"js-ast-grep","language":"tsx"}]},{"id":"optional-nfs-followups","name":"Optional AI and package updates","steps":[{"name":"AI-assisted tricky migrations","type":"ai"},{"name":"Remove legacy core deps and add frontend-plugin-api","type":"run"}]}]}}],"packageBehavior":"workflow-only","isBundle":false,"bundleChildren":[],"parentBundles":[]},{"version":{"id":"74eae5af-cf79-49d0-9b6a-f3a5a5fea098","packageId":"355446fc-99c9-474a-8aa6-e74d0a4c2620","version":"0.1.0","description":"Migrate Backstage frontend plugins from the legacy core-plugin-api model to the new frontend system (frontend-plugin-api): route refs, plugin shell, APIs, page hooks, blast-radius metrics, optional AI follow-ups, and optional package.json/lockfile updates.","manifest":{"name":"backstage-plugin-frontend-system-migration","author":"Alex Bit ","license":"MIT","targets":{"versions":{},"languages":["typescript","tsx"],"frameworks":[]},"version":"0.1.0","category":"migration","keywords":["migration","backstage","upgrade","frontend-plugin-api"],"registry":{"access":"public","visibility":"public"},"workflow":"workflow.yaml","repository":"https://github.com/alexbit-codemod/backstage-codemods","description":"Migrate Backstage frontend plugins from the legacy core-plugin-api model to the new frontend system (frontend-plugin-api): route refs, plugin shell, APIs, page hooks, blast-radius metrics, optional AI follow-ups, and optional package.json/lockfile updates.","dependencies":[],"schema_version":"1.0"},"checksum":"255af1c5b6f03af94878a9b24af4ab394a4ceb857be433f55b0bdde1e06a58cd","size":19540,"downloadUrl":"https://registry-cdn.codemod.com/prod/packages/backstage-plugin-frontend-system-migration/0.1.0/public.tar.gz","aiGenerated":false,"sourceArchiveS3Key":null,"targets":{"languages":["typescript"],"frameworks":[]},"dependencies":[],"languages":["tsx"],"stepTypes":["js-ast-grep","ai","run"],"workflowMetadata":{"nodes":[{"id":"inventory","name":"Blast radius (metrics only)","steps":[{"name":"Collect migration metrics","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-route-refs","name":"Migrate route refs","steps":[{"name":"Route refs to frontend-plugin-api","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-plugin-shell","name":"createPlugin to createFrontendPlugin","steps":[{"name":"Plugin shell migration","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-apis","name":"ApiBlueprint and createApiRef","steps":[{"name":"API factories and refs","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-pages-hooks","name":"Pure core-plugin-api imports and router metrics","steps":[{"name":"Hooks and imports","type":"js-ast-grep","language":"tsx"}]},{"id":"ai-assisted-followups","name":"AI-assisted tricky migrations","steps":[{"name":"Review SubPageBlueprint, useRouteRef guards, ambiguous routes","type":"ai"}]},{"id":"finalize-package-dependencies","name":"package.json and lockfile (optional)","steps":[{"name":"Remove legacy core deps and add frontend-plugin-api","type":"run"}]}]},"validated":false,"validationErrors":null,"publishedBy":"4519f7a8-2ebc-4eaf-8c0a-e01be4c05878","deprecated":false,"deprecationMessage":null,"downloadCount":0,"cachedTestCases":{"input":"import { createRouteRef } from \"@backstage/frontend-plugin-api\";\n\nexport const r = createRouteRef();\n","output":"import {\n createRouteRef,\n createSubRouteRef,\n createExternalRouteRef,\n} from \"@backstage/frontend-plugin-api\";\n\nexport const rootRouteRef = createRouteRef();\n\nexport const detailsRouteRef = createSubRouteRef({ parent: rootRouteRef, path: \"/details/:id\" });\n\nexport const docsRouteRef = createExternalRouteRef({ defaultTarget: 'techdocs.docRoot' });\n","isValid":true},"defaultWorkflowName":"default","createdAt":"2026-04-01T20:29:17.438Z","updatedAt":"2026-04-01 20:29:18.097277+00"},"publishedBy":{"id":"4519f7a8-2ebc-4eaf-8c0a-e01be4c05878","username":"alexbit-codemod","name":"Alex Bit"},"insightsTemplate":null,"workflows":[{"name":"default","path":"workflow.yaml","description":null,"isDefault":true,"languages":["tsx"],"stepTypes":["js-ast-grep","ai","run"],"workflowMetadata":{"nodes":[{"id":"inventory","name":"Blast radius (metrics only)","steps":[{"name":"Collect migration metrics","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-route-refs","name":"Migrate route refs","steps":[{"name":"Route refs to frontend-plugin-api","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-plugin-shell","name":"createPlugin to createFrontendPlugin","steps":[{"name":"Plugin shell migration","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-apis","name":"ApiBlueprint and createApiRef","steps":[{"name":"API factories and refs","type":"js-ast-grep","language":"tsx"}]},{"id":"migrate-pages-hooks","name":"Pure core-plugin-api imports and router metrics","steps":[{"name":"Hooks and imports","type":"js-ast-grep","language":"tsx"}]},{"id":"ai-assisted-followups","name":"AI-assisted tricky migrations","steps":[{"name":"Review SubPageBlueprint, useRouteRef guards, ambiguous routes","type":"ai"}]},{"id":"finalize-package-dependencies","name":"package.json and lockfile (optional)","steps":[{"name":"Remove legacy core deps and add frontend-plugin-api","type":"run"}]}]}}],"packageBehavior":"workflow-only","isBundle":false,"bundleChildren":[],"parentBundles":[]}],"distTags":{"latest":"0.1.5"},"latestPackageBehavior":"workflow-only","cachedTestCases":"$48:props:state:queries:0:state:data:json:versions:0:version:cachedTestCases"},"meta":{"values":{"versions.0.version.createdAt":["Date"],"versions.0.insightsTemplate.generatedAt":["Date"],"versions.1.version.createdAt":["Date"],"versions.2.version.createdAt":["Date"],"versions.3.version.createdAt":["Date"],"versions.4.version.createdAt":["Date"]},"referentialEqualities":{"cachedTestCases":["versions.0.version.cachedTestCases"]}}},"dataUpdateCount":1,"dataUpdatedAt":1787752375205,"error":null,"errorUpdateCount":0,"errorUpdatedAt":0,"fetchFailureCount":0,"fetchFailureReason":null,"fetchMeta":null,"isInvalidated":false,"status":"success","fetchStatus":"idle"},"queryKey":[["registry","getPackage"],{"input":{"name":"backstage-plugin-frontend-system-migration","scope":"$undefined"},"type":"query"}],"queryHash":"[[\"registry\",\"getPackage\"],{\"input\":{\"name\":\"backstage-plugin-frontend-system-migration\"},\"type\":\"query\"}]"}]},"children":"$L4c"}] 49:["$","meta","35",{"name":"twitter:image","content":"https://app.codemod.com/api/og/registry/backstage-plugin-frontend-system-migration"}]