@grafana/create-plugin 7.15.1 → 7.17.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [7.17.0](https://github.com/grafana/plugin-tools/compare/@grafana/create-plugin@7.16.0...@grafana/create-plugin@7.17.0) (2026-10-28)
+
+
+### Features
+
+* remove dependency on glob ([#2655](https://github.com/grafana/plugin-tools/issues/2655)) ([9db0649](https://github.com/grafana/plugin-tools/commit/9db0649fd4dee9b5745a248ba421998cd9b86764))
+
+
+### Bug Fixes
+
+* **templates:** Update dependency @grafana/plugin-e2e to v3.15.2 ([#3022](https://github.com/grafana/plugin-tools/issues/3022)) ([2115b27](https://github.com/grafana/plugin-tools/commit/2115b27767554a555640300c7b4dc9c9e1842909))
+
+## [7.16.0](https://github.com/grafana/plugin-tools/compare/@grafana/create-plugin@7.15.1...@grafana/create-plugin@7.16.0) (2026-10-22)
+
+
+### Features
+
+* **create-plugin:** Override the default Grafana version in the experimental-app-sdk addition ([#3014](https://github.com/grafana/plugin-tools/issues/3014)) ([8d35cd5](https://github.com/grafana/plugin-tools/commit/8d35cd55d2213b454f8e465ec7b9e01cc3039010))
+* **create-plugin:** scaffold docs snippets with fallback text ([#3021](https://github.com/grafana/plugin-tools/issues/3021)) ([7ef65e4](https://github.com/grafana/plugin-tools/commit/7ef65e418a9ed5951d62184954511297196aa0ee))
+
 ## [7.15.1](https://github.com/grafana/plugin-tools/compare/@grafana/create-plugin@7.15.0...@grafana/create-plugin@7.15.1) (2026-10-21)
 
 

package/dist/codemods/additions/prompts/docs-content.md

@@ -20,7 +20,7 @@ This usually runs once, after `add docs`. Running it again is safe, because it o
 
 ## Check first
 
-Search the docs folder for `section-brief` comments. A section that still has its brief is yours to write. A section without one has been written by the author, so never rewrite it.
+Search the docs folder for `section-brief` comments. A section that still has its brief is yours to write. A section without one has been written by the author, so never rewrite it. Text between `<!-- snippet:... -->` and `<!-- /snippet:... -->` markers is maintained by Grafana, so never edit inside a snippet.
 
 If no briefs remain, the pages are already written. Do steps 1 and 3, adding any README or linked-docs content that isn't on the pages yet without rewriting what is there, then steps 7 to 10. If nothing is left to migrate, say so in the summary and change nothing.
 

package/dist/codemods/additions/scripts/experimental-app-sdk.js

@@ -36,6 +36,7 @@ function appSdk(context) {
   referenceAgentInstructions(context, data);
   addGenerateScript(context);
   addFeatureToggle(context);
+  addGrafanaVersionOverride(context);
   wireGoBackend(context, data);
   if (Object.keys(context.listChanges()).length > changesBefore) {
     context.setMessage(buildNextStepsMessage(hasGoBackend(context), data.packageManagerName));
@@ -155,6 +156,45 @@ function addFeatureToggle(context) {
   composeData.setIn(["services", "grafana", "environment", "GF_FEATURE_TOGGLES_ENABLE"], toggles.join(","));
   context.updateFile(composePath, stringify(composeData, { lineWidth: 120, singleQuote: true }));
 }
+const GRAFANA_BUILD_ARGS = {
+  grafana_image: "${GRAFANA_IMAGE:-grafana}",
+  grafana_version: "${GRAFANA_VERSION:-nightly}"
+};
+function addGrafanaVersionOverride(context) {
+  const composePath = "docker-compose.yaml";
+  const composeContent = context.getFile(composePath);
+  if (!composeContent) {
+    additionsDebug(`Could not find ${composePath}. Skipping the Grafana version override.`);
+    return;
+  }
+  const composeData = parseDocument(composeContent);
+  if (!(composeData.getIn(["services", "grafana"]) instanceof YAMLMap)) {
+    additionsDebug(`Could not find the grafana service in ${composePath}. Skipping the Grafana version override.`);
+    return;
+  }
+  const build = composeData.getIn(["services", "grafana", "build"]);
+  if (build !== void 0 && !(build instanceof YAMLMap)) {
+    additionsDebug(`services.grafana.build in ${composePath} is not a mapping. Skipping the Grafana version override.`);
+    return;
+  }
+  const args = composeData.getIn(["services", "grafana", "build", "args"]);
+  if (args !== void 0 && !(args instanceof YAMLMap)) {
+    additionsDebug(
+      `services.grafana.build.args in ${composePath} is not a mapping. Skipping the Grafana version override.`
+    );
+    return;
+  }
+  let changed = false;
+  for (const [name, value] of Object.entries(GRAFANA_BUILD_ARGS)) {
+    if (!composeData.hasIn(["services", "grafana", "build", "args", name])) {
+      composeData.setIn(["services", "grafana", "build", "args", name], value);
+      changed = true;
+    }
+  }
+  if (changed) {
+    context.updateFile(composePath, stringify(composeData, { lineWidth: 120, singleQuote: true }));
+  }
+}
 function wireGoBackend(context, data) {
   if (!hasGoBackend(context)) {
     additionsDebug("No Go backend found. Skipping main.go wiring.");

package/dist/codemods/migrations/migrations.js

@@ -108,11 +108,17 @@ var defaultMigrations = [
     version: "7.13.0",
     description: "Replace eslint-webpack-plugin with diagnostics-webpack-plugin in the webpack config. eslint-webpack-plugin depends on micromatch, which pulls in the braces dependency flagged by vulnerability scanners.",
     scriptPath: import.meta.resolve("./scripts/018-replace-eslint-webpack-plugin.js")
+  },
+  {
+    name: "019-remove-glob-dependency",
+    version: "7.17.0",
+    description: "Replace the glob package with the Node.js built-in fs.glob in bundler utils.",
+    scriptPath: import.meta.resolve("./scripts/019-remove-glob-dependency.js")
   }
   // Do not use LEGACY_UPDATE_CUTOFF_VERSION for new migrations. It is only used above to force migrations to run
   // for those written before the switch to updates as migrations.
   //
-  // New migrations never pick a version: copy the unreleased version line from ../AGENTS.md exactly.
+  // New migrations should never specify a version: copy the unreleased version line from ../AGENTS.md exactly.
   // Do not paste it into a comment in this file, as release-please rewrites every line that carries it.
 ];
 

package/dist/codemods/migrations/scripts/019-remove-glob-dependency.js

@@ -0,0 +1,93 @@
+import { parseAsTypescript, findImports, findNamedImport, findFunctionDeclaration, callsFunction, insertImports, createImport, printAST } from '../../utils.ast.js';
+import { removeDependenciesFromPackageJson, migrationsDebug } from '../../utils.js';
+
+const OLD_PACKAGE_NAME = "glob";
+const NEW_PACKAGE_NAME = "node:fs/promises";
+const UTILS_PATHS = [".config/webpack/utils.ts", ".config/bundler/utils.ts"];
+const GET_ENTRIES_SOURCE = `export async function getEntries() {
+  const plugins: string[][] = [];
+  for await (const pluginJson of glob('**/src/**/plugin.json')) {
+    const folder = path.dirname(pluginJson);
+    const modules: string[] = [];
+    for await (const module of glob(\`\${folder}/module.{ts,tsx,js,jsx}\`)) {
+      modules.push(path.resolve(module));
+    }
+    plugins.push(modules);
+  }
+
+  return plugins.reduce<Record<string, string>>((result, modules) => {
+    return modules.reduce((innerResult, module) => {
+      const pluginPath = path.dirname(module);
+      const pluginName = path.relative(process.cwd(), pluginPath).replace(/src\\/?/i, '');
+      const entryName = pluginName === '' ? 'module' : \`\${pluginName}/module\`;
+
+      innerResult[entryName] = module;
+      return innerResult;
+    }, result);
+  }, {});
+}`;
+function migrate(context) {
+  const updatedPaths = UTILS_PATHS.filter((filePath) => replaceGlobWithFsGlob(context, filePath));
+  if (updatedPaths.length === 0) {
+    return context;
+  }
+  const isStillUsed = UTILS_PATHS.some((filePath) => {
+    const source = context.getFile(filePath);
+    if (!source) {
+      return false;
+    }
+    const parsed = parseAsTypescript(source);
+    return !parsed.success || findImports(parsed.ast, OLD_PACKAGE_NAME).length > 0;
+  });
+  if (context.doesFileExist("package.json") && !isStillUsed) {
+    removeDependenciesFromPackageJson(context, [OLD_PACKAGE_NAME], [OLD_PACKAGE_NAME]);
+  }
+  return context;
+}
+function replaceGlobWithFsGlob(context, utilsPath) {
+  if (!context.doesFileExist(utilsPath)) {
+    return false;
+  }
+  const source = context.getFile(utilsPath);
+  if (!source || !source.includes(OLD_PACKAGE_NAME)) {
+    return false;
+  }
+  const parsed = parseAsTypescript(source);
+  if (!parsed.success) {
+    migrationsDebug(`Failed to parse ${utilsPath}. Error: ${parsed.error.message}`);
+    return false;
+  }
+  const globImport = findNamedImport(parsed.ast, OLD_PACKAGE_NAME, "glob");
+  if (!globImport) {
+    return false;
+  }
+  const getEntries = findFunctionDeclaration(parsed.ast, "getEntries");
+  if (!getEntries) {
+    return false;
+  }
+  if (!callsFunction(getEntries.body, "glob")) {
+    return false;
+  }
+  const { declaration, specifier } = globImport;
+  declaration.specifiers = (declaration.specifiers ?? []).filter((candidate) => candidate !== specifier);
+  if (declaration.specifiers.length === 0) {
+    parsed.ast.program.body.splice(parsed.ast.program.body.indexOf(declaration), 1);
+  }
+  insertImports(parsed.ast, [createImport({ named: [{ name: "glob" }] }, NEW_PACKAGE_NAME)]);
+  getEntries.body = getFunctionBody(GET_ENTRIES_SOURCE);
+  context.updateFile(utilsPath, printAST(parsed.ast));
+  return true;
+}
+function getFunctionBody(source) {
+  const parsed = parseAsTypescript(source);
+  if (!parsed.success) {
+    throw parsed.error;
+  }
+  const [statement] = parsed.ast.program.body;
+  if (statement?.type !== "ExportNamedDeclaration" || statement.declaration?.type !== "FunctionDeclaration") {
+    throw new Error("Failed to parse target function body");
+  }
+  return statement.declaration.body;
+}
+
+export { migrate as default };

package/dist/codemods/utils.ast.js

@@ -34,6 +34,33 @@ function findVariableDeclaration(ast, variableName) {
   });
   return found;
 }
+function findFunctionDeclaration(ast, functionName) {
+  let found = null;
+  recast.types.visit(ast, {
+    visitFunctionDeclaration(path) {
+      if (path.node.id?.name === functionName) {
+        found = path.node;
+        return false;
+      }
+      return this.traverse(path);
+    }
+  });
+  return found;
+}
+function callsFunction(ast, functionName) {
+  let isCalled = false;
+  recast.types.visit(ast, {
+    visitCallExpression(path) {
+      const { callee } = path.node;
+      if (callee.type === "Identifier" && callee.name === functionName) {
+        isCalled = true;
+        return false;
+      }
+      return this.traverse(path);
+    }
+  });
+  return isCalled;
+}
 function isProperty(node) {
   return node.type === "Property" || node.type === "ObjectProperty";
 }
@@ -71,5 +98,21 @@ function insertImports(ast, imports) {
     ast.program.body.unshift(...imports);
   }
 }
+function findImports(ast, packageName) {
+  return ast.program.body.filter(
+    (node) => node.type === "ImportDeclaration" && node.source.value === packageName
+  );
+}
+function findNamedImport(ast, packageName, importedName) {
+  for (const declaration of findImports(ast, packageName)) {
+    const specifier = declaration.specifiers?.find(
+      (candidate) => candidate.type === "ImportSpecifier" && candidate.imported.name === importedName
+    );
+    if (specifier) {
+      return { declaration, specifier };
+    }
+  }
+  return void 0;
+}
 
-export { createImport, findObjectProperty, findVariableDeclaration, insertImports, isProperty, parseAsTypescript, printAST };
+export { callsFunction, createImport, findFunctionDeclaration, findImports, findNamedImport, findObjectProperty, findVariableDeclaration, insertImports, isProperty, parseAsTypescript, printAST };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grafana/create-plugin",
-  "version": "7.15.1",
+  "version": "7.17.0",
   "repository": {
     "type": "git",
     "directory": "packages/create-plugin",
@@ -43,6 +43,7 @@
     "yaml": "2.9.1"
   },
   "devDependencies": {
+    "@grafana/plugin-docs-parser": "0.6.0",
     "@libs/find-up": "1.0.0",
     "@libs/output": "1.0.3",
     "@libs/version": "1.0.2",

package/src/codemods/additions/prompts/docs-content.md

@@ -20,7 +20,7 @@ This usually runs once, after `add docs`. Running it again is safe, because it o
 
 ## Check first
 
-Search the docs folder for `section-brief` comments. A section that still has its brief is yours to write. A section without one has been written by the author, so never rewrite it.
+Search the docs folder for `section-brief` comments. A section that still has its brief is yours to write. A section without one has been written by the author, so never rewrite it. Text between `<!-- snippet:... -->` and `<!-- /snippet:... -->` markers is maintained by Grafana, so never edit inside a snippet.
 
 If no briefs remain, the pages are already written. Do steps 1 and 3, adding any README or linked-docs content that isn't on the pages yet without rewriting what is there, then steps 7 to 10. If nothing is left to migrate, say so in the summary and change nothing.
 

package/src/codemods/additions/scripts/docs.test.ts

@@ -2,6 +2,7 @@ import { existsSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { stripVTControlCharacters } from 'node:util';
+import { readSnippets, renderSnippet } from '@grafana/plugin-docs-parser';
 import * as v from 'valibot';
 import { parse as parseYaml } from 'yaml';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
@@ -77,6 +78,7 @@ const PAGES_BY_TYPE: Record<string, string[]> = {
   app: ['index', 'configure', 'overview', 'reports', 'dashboards', 'permissions', 'troubleshooting'],
 };
 const PLUGIN_TYPES = Object.keys(PAGES_BY_TYPE);
+const SNIPPET_MARKER_RE = /^<!-- \/?snippet:\S+ -->$/gm;
 
 // scaffolds once and writes it to disk, so the re-run sees a plugin that is already fully set up
 function scaffoldThenRerun(
@@ -749,7 +751,7 @@ describe('docs codemod', () => {
         const content = context.getFile(`docs/${page}.md`) ?? '';
         const briefs = content.match(/<!-- section-brief\n[\s\S]*?-->/g) ?? [];
         expect(briefs.length, page).toBeGreaterThan(0);
-        expect(content.match(/<!--/g)?.length, page).toBe(briefs.length);
+        expect(content.replace(SNIPPET_MARKER_RE, '').match(/<!--/g)?.length, page).toBe(briefs.length);
         expect(content, page).not.toContain('section-brief:');
       }
     });
@@ -829,7 +831,7 @@ describe('docs codemod', () => {
         troubleshooting: [
           'This page explains how to fix common issues when you configure or use the My Plugin data source. For setup instructions, refer to [Configure the My Plugin data source](./configure.md).',
           'To see the raw request and response for a panel, open the panel editor and click **Query inspector**.',
-          'In self-managed Grafana, you can also find more detail in the Grafana server logs:',
+          'In self-managed Grafana, the Grafana server logs show more detail:',
           "1. Set the log level to `debug` in the Grafana configuration file:\n\n   ```ini\n   [log]\n   level = debug\n   ```\n\n1. Restart Grafana and reproduce the error.\n1. Look for log lines with `logger=plugin.acme-test-datasource`.\n1. Set the log level back to `info` when you're done, to keep the logs small.",
           "If this page doesn't solve your problem:",
           '- Search the [Grafana community forums](https://community.grafana.com/).\n- If your Grafana Cloud or Grafana Enterprise plan includes support, contact Grafana Support.',
@@ -867,7 +869,7 @@ describe('docs codemod', () => {
         troubleshooting: [
           'This page explains how to fix common issues when you set up or use My Plugin. For setup instructions, refer to the [Introduction](./index.md).',
           'For errors in the app, open the developer tools in your browser and check the console.',
-          'In self-managed Grafana, you can also find more detail in the Grafana server logs:',
+          'In self-managed Grafana, the Grafana server logs show more detail:',
           "1. Set the log level to `debug` in the Grafana configuration file:\n\n   ```ini\n   [log]\n   level = debug\n   ```\n\n1. Restart Grafana and reproduce the error.\n1. Look for log lines with `logger=plugin.acme-test-app`.\n1. Set the log level back to `info` when you're done, to keep the logs small.",
           "If this page doesn't solve your problem:",
           '- Search the [Grafana community forums](https://community.grafana.com/).\n- If your Grafana Cloud or Grafana Enterprise plan includes support, contact Grafana Support.',
@@ -886,6 +888,7 @@ describe('docs codemod', () => {
           let left = (context.getFile(`docs/${page}.md`) ?? '')
             .replace(/^---\n[\s\S]*?\n---\n/, '')
             .replace(/<!-- section-brief\n[\s\S]*?-->/g, '')
+            .replace(SNIPPET_MARKER_RE, '')
             .replace(/^#{1,6} .*$/gm, '');
           for (const text of FIXED_TEXT[type][page] ?? []) {
             expect(left, page).toContain(text);
@@ -896,6 +899,39 @@ describe('docs codemod', () => {
       }
     );
 
+    // when the parser's text for a snippet changes, the fallback in the template must follow
+    it.each(PLUGIN_TYPES)('scaffolds %s snippets whose fallback is the parser current text', (type) => {
+      const pluginJson = FULL_PLUGIN_JSON[type];
+      const context = makeContext(pluginJson);
+      docs(context, { docsPath: 'docs' });
+      const values = { pluginName: String(pluginJson.name), pluginId: String(pluginJson.id) };
+      const collapse = (text: string) => text.replace(/\s+/g, ' ').trim();
+      const names: string[] = [];
+
+      for (const page of PAGES_BY_TYPE[type]) {
+        const content = context.getFile(`docs/${page}.md`) ?? '';
+        const { snippets, problems } = readSnippets(content);
+        expect(problems, page).toEqual([]);
+        const lines = content.split('\n');
+        for (const { name, startLine, endLine } of snippets) {
+          names.push(name);
+          expect(collapse(lines.slice(startLine, endLine - 1).join('\n')), `${page} ${name}`).toBe(
+            collapse(renderSnippet(name, values) ?? '')
+          );
+        }
+      }
+
+      expect(names.length).toBeGreaterThan(0);
+    });
+
+    it.each(['datasource', 'app'])('leaves the server logs snippet out of a %s without a backend', (type) => {
+      const context = makeContext({ ...FULL_PLUGIN_JSON[type], backend: false });
+      docs(context, { docsPath: 'docs' });
+      const content = context.getFile('docs/troubleshooting.md') ?? '';
+      expect(content).not.toContain('snippet:server-debug-logs');
+      expect(readSnippets(content)).toEqual({ snippets: [], problems: [] });
+    });
+
     it('interpolates pluginName into the index page', () => {
       const context = makeContext({ type: 'panel', id: 'acme-test-panel', name: 'My Panel' });
       docs(context, { docsPath: 'docs' });

package/src/codemods/additions/scripts/experimental-app-sdk.test.ts

@@ -245,6 +245,62 @@ describe('experimental-app-sdk addition', () => {
     });
   });
 
+  describe('grafana version override', () => {
+    it('adds the image and version build args', () => {
+      const result = appSdk(createAppContext());
+
+      const compose = result.getFile('docker-compose.yaml') ?? '';
+      expect(compose).toContain('grafana_image: ${GRAFANA_IMAGE:-grafana}');
+      expect(compose).toContain('grafana_version: ${GRAFANA_VERSION:-nightly}');
+    });
+
+    it('adds the build args even when the base compose file already enables the toggles', () => {
+      const context = createAppContext();
+      context.addFile(
+        '.config/docker-compose-base.yaml',
+        `services:
+  grafana:
+    environment:
+      GF_FEATURE_TOGGLES_ENABLE: appplugins.loadAppManifest,appplugins.registerAPIServer,grafana.useRouterMiddleware
+`
+      );
+
+      const result = appSdk(context);
+
+      expect(result.getFile('docker-compose.yaml')).toContain('grafana_version: ${GRAFANA_VERSION:-nightly}');
+    });
+
+    it('keeps build args the user already set', () => {
+      const context = createAppContext({
+        compose: `services:
+  grafana:
+    extends:
+      file: .config/docker-compose-base.yaml
+      service: grafana
+    build:
+      args:
+        grafana_version: 12.0.0
+`,
+      });
+
+      const result = appSdk(context);
+
+      const compose = result.getFile('docker-compose.yaml') ?? '';
+      expect(compose).toContain('grafana_version: 12.0.0');
+      expect(compose).not.toContain('GRAFANA_VERSION');
+      expect(compose).toContain('grafana_image: ${GRAFANA_IMAGE:-grafana}');
+    });
+
+    it('is idempotent', () => {
+      const once = appSdk(createAppContext());
+      const compose = once.getFile('docker-compose.yaml');
+
+      const twice = appSdk(once);
+
+      expect(twice.getFile('docker-compose.yaml')).toBe(compose);
+    });
+  });
+
   describe('feature toggle', () => {
     it('enables the app-sdk manifest toggle', () => {
       const context = createAppContext();
@@ -328,7 +384,7 @@ describe('experimental-app-sdk addition', () => {
 
       const result = appSdk(context);
 
-      expect(result.getFile('docker-compose.yaml')).toBe(STOCK_COMPOSE);
+      expect(result.getFile('docker-compose.yaml')).not.toContain('GF_FEATURE_TOGGLES_ENABLE');
     });
 
     it('leaves a list-style environment block alone', () => {
@@ -341,7 +397,8 @@ describe('experimental-app-sdk addition', () => {
 
       const result = appSdk(context);
 
-      expect(result.getFile('docker-compose.yaml')).toBe(listCompose);
+      expect(result.getFile('docker-compose.yaml')).toContain('- GF_FEATURE_TOGGLES_ENABLE=someOtherToggle');
+      expect(result.getFile('docker-compose.yaml')).not.toContain('appplugins.loadAppManifest');
       // The rest of the addition still applies.
       expect(result.doesFileExist('kinds/config.cue')).toBe(true);
     });

package/src/codemods/additions/scripts/experimental-app-sdk.ts

@@ -59,6 +59,7 @@ export default function appSdk(context: Context): Context {
   referenceAgentInstructions(context, data);
   addGenerateScript(context);
   addFeatureToggle(context);
+  addGrafanaVersionOverride(context);
   wireGoBackend(context, data);
 
   // Only guide the user when we actually scaffolded something; a re-run should stay quiet.
@@ -240,6 +241,60 @@ function addFeatureToggle(context: Context) {
   context.updateFile(composePath, stringify(composeData, { lineWidth: 120, singleQuote: true }));
 }
 
+// The app-sdk needs a newer Grafana than the default the plugin was scaffolded with, so the root
+// compose file overrides the build args, while still letting GRAFANA_IMAGE/GRAFANA_VERSION win.
+const GRAFANA_BUILD_ARGS: Record<string, string> = {
+  grafana_image: '${GRAFANA_IMAGE:-grafana}',
+  grafana_version: '${GRAFANA_VERSION:-nightly}',
+};
+
+/**
+ * Overrides the default Grafana image and version in the root docker-compose.yaml. Build args the
+ * user has already set are left alone.
+ */
+function addGrafanaVersionOverride(context: Context) {
+  const composePath = 'docker-compose.yaml';
+  const composeContent = context.getFile(composePath);
+
+  if (!composeContent) {
+    additionsDebug(`Could not find ${composePath}. Skipping the Grafana version override.`);
+    return;
+  }
+
+  const composeData = parseDocument(composeContent);
+
+  if (!(composeData.getIn(['services', 'grafana']) instanceof YAMLMap)) {
+    additionsDebug(`Could not find the grafana service in ${composePath}. Skipping the Grafana version override.`);
+    return;
+  }
+
+  const build = composeData.getIn(['services', 'grafana', 'build']);
+  if (build !== undefined && !(build instanceof YAMLMap)) {
+    additionsDebug(`services.grafana.build in ${composePath} is not a mapping. Skipping the Grafana version override.`);
+    return;
+  }
+
+  const args = composeData.getIn(['services', 'grafana', 'build', 'args']);
+  if (args !== undefined && !(args instanceof YAMLMap)) {
+    additionsDebug(
+      `services.grafana.build.args in ${composePath} is not a mapping. Skipping the Grafana version override.`
+    );
+    return;
+  }
+
+  let changed = false;
+  for (const [name, value] of Object.entries(GRAFANA_BUILD_ARGS)) {
+    if (!composeData.hasIn(['services', 'grafana', 'build', 'args', name])) {
+      composeData.setIn(['services', 'grafana', 'build', 'args', name], value);
+      changed = true;
+    }
+  }
+
+  if (changed) {
+    context.updateFile(composePath, stringify(composeData, { lineWidth: 120, singleQuote: true }));
+  }
+}
+
 /**
  * Wires the generated kinds into the Go backend, for app plugins that have one. Go code generation
  * itself is enabled when kinds/config.cue is first scaffolded, in addTemplateFiles.

package/src/codemods/migrations/migrations.ts

@@ -127,9 +127,15 @@ export default [
       'Replace eslint-webpack-plugin with diagnostics-webpack-plugin in the webpack config. eslint-webpack-plugin depends on micromatch, which pulls in the braces dependency flagged by vulnerability scanners.',
     scriptPath: import.meta.resolve('./scripts/018-replace-eslint-webpack-plugin.js'),
   },
+  {
+    name: '019-remove-glob-dependency',
+    version: '7.17.0',
+    description: 'Replace the glob package with the Node.js built-in fs.glob in bundler utils.',
+    scriptPath: import.meta.resolve('./scripts/019-remove-glob-dependency.js'),
+  },
   // Do not use LEGACY_UPDATE_CUTOFF_VERSION for new migrations. It is only used above to force migrations to run
   // for those written before the switch to updates as migrations.
   //
-  // New migrations never pick a version: copy the unreleased version line from ../AGENTS.md exactly.
+  // New migrations should never specify a version: copy the unreleased version line from ../AGENTS.md exactly.
   // Do not paste it into a comment in this file, as release-please rewrites every line that carries it.
 ] satisfies Migration[];