@grafana/create-plugin 7.10.0 → 7.11.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [7.11.0](https://github.com/grafana/plugin-tools/compare/@grafana/create-plugin@7.10.1...@grafana/create-plugin@7.11.0) (2026-09-16)
+
+
+### Features
+
+* **create-plugin:** add CI drift check workflow to experimental-app-sdk ([#2862](https://github.com/grafana/plugin-tools/issues/2862)) ([89b3a07](https://github.com/grafana/plugin-tools/commit/89b3a077b4ec9a9a85e58ceb514f7e94ee2ef21e))
+* **create-plugin:** add grafana-app-sdk CUE kind code generation ([#2853](https://github.com/grafana/plugin-tools/issues/2853)) ([5f1a3c1](https://github.com/grafana/plugin-tools/commit/5f1a3c136b97ee451b8dae97fb65372f661ac589))
+* **create-plugin:** extend experimental-app-sdk to Go backends ([#2856](https://github.com/grafana/plugin-tools/issues/2856)) ([79b6974](https://github.com/grafana/plugin-tools/commit/79b69741d24444de77f490368c816ea0f2efb951))
+* **create-plugin:** run go mod tidy for codemods editing go.mod ([#2884](https://github.com/grafana/plugin-tools/issues/2884)) ([22ca6be](https://github.com/grafana/plugin-tools/commit/22ca6be4fc26e163e3a200baebb950cbd9958376))
+
+
+### Bug Fixes
+
+* **create-plugin:** Cleanup experimental-app-sdk message and formatting. ([#2883](https://github.com/grafana/plugin-tools/issues/2883)) ([707b2f0](https://github.com/grafana/plugin-tools/commit/707b2f0b7534fa01bdf1a14af4be0fe50ddc2131))
+* **create-plugin:** defer add-command success message until after summary ([#2878](https://github.com/grafana/plugin-tools/issues/2878)) ([379d469](https://github.com/grafana/plugin-tools/commit/379d4691f188441ef801f9f49d2aa7d2ea8d202f))
+* **create-plugin:** drop shebang from generate-kinds.mjs so it gets the do-not-edit header ([#2872](https://github.com/grafana/plugin-tools/issues/2872)) ([d1d25d9](https://github.com/grafana/plugin-tools/commit/d1d25d9f85ade3c7079ab04954daf23c413c8603))
+* **create-plugin:** preserve 'add' changeType when updating a newly added file ([#2865](https://github.com/grafana/plugin-tools/issues/2865)) ([20e57ed](https://github.com/grafana/plugin-tools/commit/20e57ed48334e4e941d9fe3b6e07e370b36d2672))
+* **deps:** Update dependency recast to v0.24.0 ([#2824](https://github.com/grafana/plugin-tools/issues/2824)) ([c57eba3](https://github.com/grafana/plugin-tools/commit/c57eba3601d70aee202f4786405d62cee38af264))
+* **templates:** Update dependency @grafana/plugin-e2e to v3.12.0 ([#2870](https://github.com/grafana/plugin-tools/issues/2870)) ([c32a68c](https://github.com/grafana/plugin-tools/commit/c32a68c88a746df67400564100167aa65cd7dd3b))
+
+## [7.10.1](https://github.com/grafana/plugin-tools/compare/@grafana/create-plugin@7.10.0...@grafana/create-plugin@7.10.1) (2026-08-27)
+
+
+### Bug Fixes
+
+* **create-plugin:** add @react-hookz/web + @ver0/deep-equal to Jest ESM ignore ([#2847](https://github.com/grafana/plugin-tools/issues/2847)) ([66068ab](https://github.com/grafana/plugin-tools/commit/66068abc145224767470902386949fd8b65f6eaa))
+
 ## [7.10.0](https://github.com/grafana/plugin-tools/compare/@grafana/create-plugin@7.9.2...@grafana/create-plugin@7.10.0) (2026-08-21)
 
 

package/dist/codemods/additions/additions.js

@@ -8,6 +8,11 @@ var defaultAdditions = [
     name: "externalize-jsx-runtime",
     description: "Externalizes the react JSX runtime to help migrate plugins to React 19",
     scriptPath: import.meta.resolve("./scripts/externalize-jsx-runtime.js")
+  },
+  {
+    name: "experimental-app-sdk",
+    description: "Adds grafana-app-sdk CUE kind code generation to an app plugin",
+    scriptPath: import.meta.resolve("./scripts/experimental-app-sdk.js")
   }
 ];
 

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

@@ -0,0 +1,275 @@
+import { fileURLToPath } from 'node:url';
+import { styleText } from 'node:util';
+import { parseDocument, YAMLMap, Scalar, stringify } from 'yaml';
+import { getBackendCmd } from '../../../commands/generate/print-success-message.js';
+import { output } from '../../../utils/utils.console.js';
+import { additionsDebug, renderTemplate } from '../../utils.js';
+import { addRequireToGoMod } from '../../utils.goMod.js';
+import { getTemplateData } from '../../../utils/utils.templates.js';
+
+const APP_SDK_FEATURE_TOGGLES = ["appplugins.loadAppManifest", "appplugins.registerAPIServer"];
+const TEMPLATE_FILES = [
+  [".config/app-sdk/generate-kinds.mjs", true],
+  [".config/app-sdk/README.md", false],
+  [".github/workflows/generate-kinds-drift.yml", false],
+  ["kinds/config.cue", false],
+  ["kinds/manifest.cue", false],
+  ["kinds/example.cue", false],
+  ["kinds/cue.mod/module.cue", false],
+  ["kinds/README.md", false]
+];
+const APP_SDK_MD = ".config/AGENTS/app-sdk.md";
+function appSdk(context) {
+  if (!isAppPlugin(context)) {
+    return context;
+  }
+  const changesBefore = Object.keys(context.listChanges()).length;
+  addTemplateFiles(context);
+  referenceAgentInstructions(context);
+  addGenerateScript(context);
+  addFeatureToggle(context);
+  wireGoBackend(context);
+  if (Object.keys(context.listChanges()).length > changesBefore) {
+    context.setMessage(buildNextStepsMessage(hasGoBackend(context)));
+  }
+  return context;
+}
+function isAppPlugin(context) {
+  const pluginJsonContent = context.getFile("src/plugin.json");
+  if (!pluginJsonContent) {
+    skip("Could not find src/plugin.json.", ["Run this from the root of your plugin."]);
+    return false;
+  }
+  let pluginJson;
+  try {
+    pluginJson = JSON.parse(pluginJsonContent);
+  } catch (error) {
+    additionsDebug(`Failed to parse src/plugin.json: ${error}`);
+    skip("Could not parse src/plugin.json.");
+    return false;
+  }
+  if (pluginJson.type !== "app") {
+    skip(`grafana-app-sdk codegen needs an app plugin, but this is a ${pluginJson.type} plugin.`, [
+      "The app-sdk serves Kubernetes-style resources from an app plugin."
+    ]);
+    return false;
+  }
+  return true;
+}
+function skip(title, body = []) {
+  output.warning({ title: `Skipping app-sdk: ${title}`, body });
+}
+function addTemplateFiles(context) {
+  for (const [file, includeWarning] of TEMPLATE_FILES) {
+    if (context.doesFileExist(file)) {
+      additionsDebug(`${file} already exists. Skipping.`);
+      continue;
+    }
+    context.addFile(file, renderTemplate(templatePath(file), includeWarning));
+  }
+}
+function templatePath(file) {
+  return fileURLToPath(new URL(`../../../../templates/app-sdk/${file}`, import.meta.url));
+}
+function referenceAgentInstructions(context) {
+  const path = ".config/AGENTS/instructions.md";
+  const instructions = context.getFile(path);
+  if (!instructions) {
+    additionsDebug(`Could not find ${path}. Skipping the app-sdk reference.`);
+    return;
+  }
+  if (!context.doesFileExist(APP_SDK_MD)) {
+    context.addFile(APP_SDK_MD, renderTemplate(templatePath(APP_SDK_MD), false));
+  }
+  if (instructions.includes(APP_SDK_MD)) {
+    return;
+  }
+  context.updateFile(
+    path,
+    `${instructions.trimEnd()}
+- This plugin defines its API resources as **CUE kinds** under \`kinds/\`, with TypeScript and Go types generated from them. Read @./${APP_SDK_MD} before changing anything under \`kinds/\` or any generated directory. **Never hand-edit generated code.**
+`
+  );
+}
+function addGenerateScript(context) {
+  const raw = context.getFile("package.json");
+  if (!raw) {
+    additionsDebug("Could not find package.json. Skipping the generate:kinds script.");
+    return;
+  }
+  let packageJson;
+  try {
+    packageJson = JSON.parse(raw);
+  } catch (error) {
+    additionsDebug(`Failed to parse package.json: ${error}`);
+    return;
+  }
+  if (packageJson.scripts?.["generate:kinds"]) {
+    additionsDebug("A generate:kinds script already exists. Skipping.");
+    return;
+  }
+  packageJson.scripts = { ...packageJson.scripts, "generate:kinds": "node ./.config/app-sdk/generate-kinds.mjs" };
+  context.updateFile("package.json", JSON.stringify(packageJson, null, 2));
+}
+function addFeatureToggle(context) {
+  const composePath = "docker-compose.yaml";
+  const composeContent = context.getFile(composePath);
+  if (!composeContent) {
+    additionsDebug(`Could not find ${composePath}. Skipping the feature toggle.`);
+    return;
+  }
+  const baseComposeContent = context.getFile(".config/docker-compose-base.yaml");
+  if (APP_SDK_FEATURE_TOGGLES.every((toggle) => baseComposeContent?.includes(toggle))) {
+    additionsDebug(`${APP_SDK_FEATURE_TOGGLES.join(", ")} are already enabled in the base compose file. Skipping.`);
+    return;
+  }
+  const composeData = parseDocument(composeContent);
+  const environment = composeData.getIn(["services", "grafana", "environment"]);
+  if (environment !== void 0 && !(environment instanceof YAMLMap)) {
+    additionsDebug(
+      `services.grafana.environment in ${composePath} is not a mapping. Add ${APP_SDK_FEATURE_TOGGLES.join(", ")} to GF_FEATURE_TOGGLES_ENABLE manually.`
+    );
+    return;
+  }
+  const grafanaService = composeData.getIn(["services", "grafana"]);
+  if (!(grafanaService instanceof YAMLMap)) {
+    additionsDebug(`Could not find the grafana service in ${composePath}. Skipping the feature toggle.`);
+    return;
+  }
+  const existing = composeData.getIn(["services", "grafana", "environment", "GF_FEATURE_TOGGLES_ENABLE"], true);
+  const existingValue = existing instanceof Scalar ? String(existing.value) : void 0;
+  const toggles = existingValue ? existingValue.split(",").map((toggle) => toggle.trim()).filter(Boolean) : [];
+  const missingToggles = APP_SDK_FEATURE_TOGGLES.filter((toggle) => !toggles.includes(toggle));
+  if (missingToggles.length === 0) {
+    additionsDebug(`${APP_SDK_FEATURE_TOGGLES.join(", ")} are already enabled. Skipping.`);
+    return;
+  }
+  toggles.push(...missingToggles);
+  composeData.setIn(["services", "grafana", "environment", "GF_FEATURE_TOGGLES_ENABLE"], toggles.join(","));
+  context.updateFile(composePath, stringify(composeData, { lineWidth: 120, singleQuote: true }));
+}
+function wireGoBackend(context) {
+  if (!hasGoBackend(context)) {
+    additionsDebug("No Go backend found. Skipping main.go wiring.");
+    return;
+  }
+  addAppProvider(context);
+  addGeneratedStubs(context);
+  wireMainGo(context);
+  addGoModDependency(context);
+}
+const GRAFANA_APP_SDK_VERSION = "v0.60.0";
+function addGoModDependency(context) {
+  addRequireToGoMod(context, "github.com/grafana/grafana-app-sdk", GRAFANA_APP_SDK_VERSION);
+  addRequireToGoMod(context, "github.com/grafana/grafana-app-sdk/plugin", GRAFANA_APP_SDK_VERSION);
+}
+function addAppProvider(context) {
+  const path = "pkg/provider/provider.go";
+  if (context.doesFileExist(path)) {
+    additionsDebug(`${path} already exists. Skipping.`);
+    return;
+  }
+  context.addFile(path, renderTemplate(templatePath(path), false));
+}
+const GENERATED_STUB_PATHS = ["pkg/generated/example/v1alpha1/doc.go", "pkg/generated/manifestdata/doc.go"];
+function addGeneratedStubs(context) {
+  for (const path of GENERATED_STUB_PATHS) {
+    if (context.doesFileExist(path)) {
+      additionsDebug(`${path} already exists. Skipping.`);
+      continue;
+    }
+    context.addFile(path, renderTemplate(templatePath(path), false));
+  }
+}
+function hasGoBackend(context) {
+  const pluginJsonContent = context.getFile("src/plugin.json");
+  if (!pluginJsonContent) {
+    return false;
+  }
+  try {
+    return JSON.parse(pluginJsonContent).backend === true;
+  } catch (error) {
+    additionsDebug(`Failed to parse src/plugin.json: ${error}`);
+    return false;
+  }
+}
+const APP_MANAGE_STATEMENT_REGEX = /if err := app\.Manage\((".*?"), (\S+), app\.ManageOpts\{\}\); err != nil \{\n(\t+[\s\S]*?\n)\t\}/;
+function wireMainGo(context) {
+  const path = "pkg/main.go";
+  const content = context.getFile(path);
+  if (!content) {
+    additionsDebug(`Could not find ${path}. Skipping the app-sdk backend wiring.`);
+    return;
+  }
+  if (content.includes('grafana-app-sdk/plugin"')) {
+    additionsDebug(`${path} already wires plugin.Run. Skipping.`);
+    return;
+  }
+  const match = content.match(APP_MANAGE_STATEMENT_REGEX);
+  if (!match) {
+    skip(`${path} does not match the expected app.Manage(...) call.`, [
+      "Wire the grafana-app-sdk plugin.Run helper into main.go yourself:",
+      "https://github.com/grafana/grafana-app-sdk/blob/main/plugin/run.go"
+    ]);
+    return;
+  }
+  const [fullStatement, pluginId, appFactory, errorBody] = match;
+  const moduleMatch = content.match(/"(github\.com\/[^/]+\/[^/]+)\/pkg\/plugin"/);
+  const providerImportPath = moduleMatch ? `${moduleMatch[1]}/pkg/provider` : void 0;
+  if (!providerImportPath) {
+    skip(`${path} does not import its own pkg/plugin package under a recognisable module path.`, [
+      "Wire the grafana-app-sdk plugin.Run helper into main.go yourself:",
+      "https://github.com/grafana/grafana-app-sdk/blob/main/plugin/run.go"
+    ]);
+    return;
+  }
+  const appImport = '	"github.com/grafana/grafana-plugin-sdk-go/backend/app"';
+  const pluginImport = `"${moduleMatch[1]}/pkg/plugin"`;
+  if (!content.includes(appImport) || !content.includes(pluginImport)) {
+    skip(`${path} does not match the expected import shape.`, [
+      "Wire the grafana-app-sdk plugin.Run helper into main.go yourself:",
+      "https://github.com/grafana/grafana-app-sdk/blob/main/plugin/run.go"
+    ]);
+    return;
+  }
+  const updated = content.replace(appImport, '	sdkplugin "github.com/grafana/grafana-app-sdk/plugin"').replace(pluginImport, `${pluginImport}
+	"${providerImportPath}"`).replace(
+    fullStatement,
+    `if err := sdkplugin.Run(
+		provider.New(),
+		sdkplugin.WithPluginID(${pluginId}),
+		sdkplugin.WithAppFunc(${appFactory}),
+	); err != nil {
+${errorBody}	}`
+  );
+  context.updateFile(path, updated);
+}
+function buildNextStepsMessage(hasGoBackend2) {
+  const { packageManagerName } = getTemplateData();
+  const versionBadge = styleText(["reset", "inverse", "bold", "cyan"], ` grafana-app-sdk@${GRAFANA_APP_SDK_VERSION} `);
+  const commands = output.bulletList([
+    `${output.formatCode(`${packageManagerName} run generate:kinds`)} ${styleText(["dim"], "to generate code from the definitions in kinds/")}`,
+    ...hasGoBackend2 ? [
+      // The generated Go code under pkg/generated/ only takes effect once it's compiled into the
+      // backend binary.
+      `${getBackendCmd()} ${styleText(["dim"], "to rebuild the plugin backend with the generated code")}`
+    ] : [],
+    // Grafana reads the app manifest from the bundle at startup, so a manifest change (any change to
+    // the kinds) isn't picked up by an already-running Grafana instance until it's restarted.
+    `${output.formatCode("docker compose restart grafana")} ${styleText(["dim"], "to pick up changes to kinds/")}`
+  ]);
+  return {
+    level: "success",
+    title: "Successfully added grafana-app-sdk code generation to your plugin.",
+    body: [
+      `${versionBadge} ${styleText(["cyan", "bold"], "Next steps:")}`,
+      "",
+      "Run the following commands to get started:",
+      ...commands,
+      "",
+      `See ${output.formatCode("./.config/app-sdk/README.md")} for the full workflow.`
+    ]
+  };
+}
+
+export { appSdk as default };

package/dist/codemods/context.js

@@ -9,9 +9,20 @@ const codemodsDebug = debug.extend("codemods");
 class Context {
   constructor(basePath) {
     __publicField(this, "files", {});
+    __publicField(this, "message");
     __publicField(this, "basePath");
     this.basePath = basePath || process.cwd();
   }
+  /**
+   * Lets a codemod defer printing a message until after the caller has reported success, instead
+   * of printing immediately during the codemod's own execution.
+   */
+  setMessage(message) {
+    this.message = message;
+  }
+  getMessage() {
+    return this.message;
+  }
   addFile(filePath, content) {
     const path = this.normalisePath(filePath);
     if (!this.doesFileExist(path)) {
@@ -40,7 +51,8 @@ class Context {
       throw new Error(`File ${path} does not exist`);
     }
     if (originalContent !== content) {
-      this.files[path] = { content, changeType: "update" };
+      const changeType = this.files[path]?.changeType === "add" ? "add" : "update";
+      this.files[path] = { content, changeType };
     } else {
       codemodsDebug(`Context.updateFile() - no updates for ${filePath}`);
     }

package/dist/codemods/migrations/migrations.js

@@ -72,6 +72,12 @@ var defaultMigrations = [
     version: "7.8.2",
     description: "Emit a single LICENSE.txt file for all licenses in bundled code.",
     scriptPath: import.meta.resolve("./scripts/012-terser-license-file.js")
+  },
+  {
+    name: "013-jest-esmodules",
+    version: "7.10.1",
+    description: "Support @grafana/ui@13.2.0 in Jest by transforming @react-hookz/web and @ver0/deep-equal ESM dependencies.",
+    scriptPath: import.meta.resolve("./scripts/013-jest-esmodules.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.

package/dist/codemods/migrations/scripts/013-jest-esmodules.js

@@ -0,0 +1,65 @@
+import { join } from 'node:path';
+import * as recast from 'recast';
+import { migrationsDebug } from '../../utils.js';
+import { parseAsTypescript, findVariableDeclaration, printAST } from '../../utils.ast.js';
+
+const { builders } = recast.types;
+const JEST_UTILS_PATH = join(".config", "jest", "utils.js");
+const ESM_MODULES_TO_ADD = ["@react-hookz/web", "@ver0/deep-equal"];
+function migrate(context) {
+  if (!context.doesFileExist(JEST_UTILS_PATH)) {
+    migrationsDebug(`${JEST_UTILS_PATH} not found. Skipping Jest ESM modules migration.`);
+    return context;
+  }
+  const source = context.getFile(JEST_UTILS_PATH);
+  if (!source) {
+    migrationsDebug(`${JEST_UTILS_PATH} is empty. Skipping Jest ESM modules migration.`);
+    return context;
+  }
+  const parsed = parseAsTypescript(source);
+  if (!parsed.success) {
+    migrationsDebug(`Failed to parse ${JEST_UTILS_PATH}. Error: ${parsed.error.message}`);
+    return context;
+  }
+  const grafanaESModules = findVariableDeclaration(parsed.ast, "grafanaESModules");
+  if (!grafanaESModules) {
+    migrationsDebug(`Could not find grafanaESModules variable declaration in ${JEST_UTILS_PATH}`);
+    return context;
+  }
+  if (grafanaESModules.init?.type !== "ArrayExpression") {
+    migrationsDebug(`grafanaESModules variable in ${JEST_UTILS_PATH} is not an array.`);
+    return context;
+  }
+  const existingModules = new Set(
+    grafanaESModules.init.elements.map(getStringValue).filter((value) => value !== void 0)
+  );
+  const missingModules = ESM_MODULES_TO_ADD.filter((moduleName) => !existingModules.has(moduleName));
+  if (missingModules.length === 0) {
+    return context;
+  }
+  const schemaIndex = grafanaESModules.init.elements.findIndex(
+    (element) => getStringValue(element) === "@grafana/schema"
+  );
+  const insertIndex = schemaIndex === -1 ? grafanaESModules.init.elements.length : schemaIndex + 1;
+  grafanaESModules.init.elements.splice(
+    insertIndex,
+    0,
+    ...missingModules.map((moduleName) => builders.literal(moduleName))
+  );
+  context.updateFile(JEST_UTILS_PATH, printAST(parsed.ast));
+  return context;
+}
+function getStringValue(element) {
+  if (!element) {
+    return void 0;
+  }
+  if (element.type === "Literal" && typeof element.value === "string") {
+    return element.value;
+  }
+  if (element.type === "StringLiteral") {
+    return element.value;
+  }
+  return void 0;
+}
+
+export { migrate as default };

package/dist/codemods/runner.js

@@ -1,5 +1,5 @@
 import { Context } from './context.js';
-import { formatFiles, flushChanges, printChanges, installNPMDependencies } from './utils.js';
+import { formatFiles, flushChanges, printChanges, installNPMDependencies, runGoModTidy } from './utils.js';
 import { parseAndValidateOptions } from './schema-parser.js';
 
 async function runCodemod(codemod, options) {
@@ -19,6 +19,7 @@ async function runCodemod(codemod, options) {
     flushChanges(updatedContext);
     printChanges(updatedContext, codemod.name, codemod.description);
     installNPMDependencies(updatedContext);
+    runGoModTidy(updatedContext);
     return updatedContext;
   } catch (error) {
     if (error instanceof Error) {

package/dist/codemods/utils.goMod.js

@@ -0,0 +1,45 @@
+import { migrationsDebug, isVersionGreater } from './utils.js';
+
+function singleLineRequireRegex(modulePath) {
+  const escapedModulePath = modulePath.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return new RegExp(`^require ${escapedModulePath} (\\S+)(.*)$`, "m");
+}
+function addRequireToGoMod(context, modulePath, version, goModPath = "go.mod") {
+  const content = context.getFile(goModPath);
+  if (!content) {
+    migrationsDebug(`Could not find ${goModPath}. Skipping the ${modulePath} dependency.`);
+    return;
+  }
+  const requireRegex = singleLineRequireRegex(modulePath);
+  const match = content.match(requireRegex);
+  if (match) {
+    const [, existingVersion] = match;
+    if (!isVersionGreater(version, existingVersion, false)) {
+      migrationsDebug(`${goModPath} already requires ${modulePath} at ${existingVersion}. Skipping.`);
+      return;
+    }
+    const updated = content.replace(requireRegex, `require ${modulePath} ${version}$2`);
+    context.updateFile(goModPath, updated);
+    return;
+  }
+  const insertAt = findRequireInsertionPoint(content);
+  const newRequireLine = `require ${modulePath} ${version}
+`;
+  context.updateFile(goModPath, `${content.slice(0, insertAt)}${newRequireLine}${content.slice(insertAt)}`);
+}
+function findRequireInsertionPoint(content) {
+  const requireLines = [...content.matchAll(/^require \S+ \S+.*$/gm)];
+  const lastRequireLine = requireLines[requireLines.length - 1];
+  if (lastRequireLine) {
+    const lineEnd = content.indexOf("\n", lastRequireLine.index + lastRequireLine[0].length);
+    return lineEnd === -1 ? content.length : lineEnd + 1;
+  }
+  const goDirective = content.match(/^go \d+\.\d+(\.\d+)?.*$/m);
+  if (goDirective) {
+    const lineEnd = content.indexOf("\n", goDirective.index + goDirective[0].length);
+    return lineEnd === -1 ? content.length : lineEnd + 1;
+  }
+  return content.length;
+}
+
+export { addRequireToGoMod };

package/dist/codemods/utils.js

@@ -5,6 +5,7 @@ import { styleText } from 'node:util';
 import { output } from '../utils/utils.console.js';
 import { getPackageManagerWithFallback, getPackageManagerSilentInstallCmd } from '../utils/utils.packageManager.js';
 import { execSync } from 'node:child_process';
+import which from 'which';
 import { gte, gt, clean, coerce } from 'semver';
 import { debug } from '../utils/utils.cli.js';
 import { renderHandlebarsTemplate } from '../utils/utils.handlebars.js';
@@ -103,6 +104,29 @@ function installNPMDependencies(context) {
     execSync(installCmd, { cwd: context.basePath, stdio: "inherit" });
   }
 }
+let goModTidyCache;
+function runGoModTidy(context) {
+  const hasGoModChanges = Object.entries(context.listChanges()).some(
+    ([filePath, { changeType }]) => filePath === "go.mod" && changeType === "update"
+  );
+  if (!hasGoModChanges) {
+    return;
+  }
+  const goModContents = context.getFile("go.mod");
+  if (!goModContents) {
+    return;
+  }
+  if (goModContents === goModTidyCache) {
+    return;
+  }
+  if (!which.sync("go", { nothrow: true })) {
+    additionsDebug("No `go` binary found on PATH. Skipping `go mod tidy`.");
+    return;
+  }
+  goModTidyCache = goModContents;
+  output.logSingleLine("Running `go mod tidy`...");
+  execSync("go mod tidy", { cwd: context.basePath, stdio: "inherit" });
+}
 function readJsonFile(context, path) {
   if (!context.doesFileExist(path)) {
     throw new Error(`Cannot find ${path}`);
@@ -224,4 +248,4 @@ const warningComment = `/*
  *
  */`;
 
-export { addDependenciesToPackageJson, additionsDebug, flushChanges, formatFiles, installNPMDependencies, isVersionGreater, migrationsDebug, printChanges, readJsonFile, removeDependenciesFromPackageJson, renderTemplate };
+export { addDependenciesToPackageJson, additionsDebug, flushChanges, formatFiles, installNPMDependencies, isVersionGreater, migrationsDebug, printChanges, readJsonFile, removeDependenciesFromPackageJson, renderTemplate, runGoModTidy };

package/dist/commands/add.command.js

@@ -20,10 +20,15 @@ const add = async (argv) => {
 Available additions: ${additionsList.join(", ")}`);
     }
     const { _, $0, ...codemodOptions } = argv;
-    await runCodemod(addition, codemodOptions);
-    output.success({
-      title: `Successfully added ${addition.name} to your plugin.`
-    });
+    const context = await runCodemod(addition, codemodOptions);
+    const message = context.getMessage();
+    if (message) {
+      output[message.level]({ title: message.title, body: message.body });
+    } else {
+      output.success({
+        title: `Successfully added ${addition.name} to your plugin.`
+      });
+    }
   } catch (error) {
     if (error instanceof Error) {
       output.error({

package/dist/commands/generate/print-success-message.js

@@ -41,4 +41,4 @@ function getBackendCmd() {
   return output.formatCode("mage -v build:linux");
 }
 
-export { printGenerateSuccessMessage };
+export { getBackendCmd, printGenerateSuccessMessage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grafana/create-plugin",
-  "version": "7.10.0",
+  "version": "7.11.0",
   "repository": {
     "type": "git",
     "directory": "packages/create-plugin",
@@ -35,7 +35,7 @@
     "handlebars": "4.7.9",
     "jsonc-parser": "3.3.1",
     "minimist": "1.2.8",
-    "recast": "0.23.12",
+    "recast": "0.24.0",
     "semver": "7.8.5",
     "title-case": "4.3.2",
     "valibot": "1.4.2",
@@ -48,7 +48,7 @@
     "@libs/version": "1.0.2",
     "@types/glob": "9.0.0",
     "@types/minimist": "1.2.5",
-    "@types/semver": "7.7.1",
+    "@types/semver": "7.8.0",
     "@types/tmp": "0.2.6",
     "@types/which": "3.0.4",
     "tmp": "0.2.7"

package/src/codemods/additions/additions.ts

@@ -11,4 +11,9 @@ export default [
     description: 'Externalizes the react JSX runtime to help migrate plugins to React 19',
     scriptPath: import.meta.resolve('./scripts/externalize-jsx-runtime.js'),
   },
+  {
+    name: 'experimental-app-sdk',
+    description: 'Adds grafana-app-sdk CUE kind code generation to an app plugin',
+    scriptPath: import.meta.resolve('./scripts/experimental-app-sdk.js'),
+  },
 ] satisfies Codemod[];