@grafana/create-plugin 6.2.0-canary.2314.19505018775.0 → 6.2.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+# v6.2.0 (Thu Nov 20 2025)
+
+#### 🚀 Enhancement
+
+- Create Plugin: Support new add cmd [#2233](https://github.com/grafana/plugin-tools/pull/2233) ([@sunker](https://github.com/sunker))
+
+#### Authors: 1
+
+- Erik Sundell ([@sunker](https://github.com/sunker))
+
+---
+
 # v6.1.14 (Wed Nov 19 2025)
 
 #### 🐛 Bug Fix

package/dist/bin/run.js

@@ -4,6 +4,7 @@ import { update } from '../commands/update.command.js';
 import { migrate } from '../commands/migrate.command.js';
 import { version } from '../commands/version.command.js';
 import { provisioning } from '../commands/provisioning.command.js';
+import { add } from '../commands/add.command.js';
 import { isUnsupportedPlatform } from '../utils/utils.os.js';
 import { argv, commandName } from '../utils/utils.cli.js';
 import { output } from '../utils/utils.console.js';
@@ -21,7 +22,8 @@ const commands = {
   generate,
   update,
   version,
-  provisioning
+  provisioning,
+  add
 };
 const command = commands[commandName] || "generate";
 command(argv);

package/dist/codemods/additions/additions.js

@@ -0,0 +1,9 @@
+var defaultAdditions = [
+  {
+    name: "example-addition",
+    description: "Adds an example addition to the plugin",
+    scriptPath: import.meta.resolve("./scripts/example-addition.js")
+  }
+];
+
+export { defaultAdditions as default };

package/dist/codemods/additions/scripts/example-addition.js

@@ -0,0 +1,47 @@
+import * as v from 'valibot';
+import { addDependenciesToPackageJson } from '../../utils.js';
+
+const schema = v.object({
+  featureName: v.pipe(
+    v.string(),
+    v.minLength(3, "Feature name must be at least 3 characters"),
+    v.maxLength(50, "Feature name must be at most 50 characters")
+  ),
+  enabled: v.optional(v.boolean(), true),
+  port: v.optional(
+    v.pipe(v.number(), v.minValue(1e3, "Port must be at least 1000"), v.maxValue(65535, "Port must be at most 65535"))
+  ),
+  frameworks: v.optional(v.array(v.string()), ["react"])
+});
+function exampleAddition(context, options) {
+  const { featureName, enabled, port, frameworks } = options;
+  const rawPkgJson = context.getFile("./package.json") ?? "{}";
+  const packageJson = JSON.parse(rawPkgJson);
+  if (packageJson.scripts && !packageJson.scripts["example-script"]) {
+    packageJson.scripts["example-script"] = `echo "Running ${featureName}"`;
+    context.updateFile("./package.json", JSON.stringify(packageJson, null, 2));
+  }
+  addDependenciesToPackageJson(context, {}, { "@types/node": "^20.0.0" });
+  if (!context.doesFileExist(`./src/features/${featureName}.ts`)) {
+    const featureCode = `export const ${featureName} = {
+  name: '${featureName}',
+  enabled: ${enabled},
+  port: ${port ?? 3e3},
+  frameworks: ${JSON.stringify(frameworks)},
+  init() {
+    console.log('${featureName} initialized on port ${port ?? 3e3}');
+  },
+};
+`;
+    context.addFile(`./src/features/${featureName}.ts`, featureCode);
+  }
+  if (context.doesFileExist("./src/deprecated.ts")) {
+    context.deleteFile("./src/deprecated.ts");
+  }
+  if (context.doesFileExist("./src/old-config.json")) {
+    context.renameFile("./src/old-config.json", "./src/new-config.json");
+  }
+  return context;
+}
+
+export { exampleAddition as default, schema };

package/dist/{migrations → codemods}/context.js

@@ -1,10 +1,11 @@
 import { accessSync, constants, readFileSync, readdirSync } from 'node:fs';
 import { join, dirname, normalize, relative } from 'node:path';
-import { migrationsDebug } from './utils.js';
+import { debug } from '../utils/utils.cli.js';
 
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+const codemodsDebug = debug.extend("codemods");
 class Context {
   constructor(basePath) {
     __publicField(this, "files", {});
@@ -41,7 +42,7 @@ class Context {
     if (originalContent !== content) {
       this.files[path] = { content, changeType: "update" };
     } else {
-      migrationsDebug(`Context.updateFile() - no updates for ${filePath}`);
+      codemodsDebug(`Context.updateFile() - no updates for ${filePath}`);
     }
   }
   doesFileExist(filePath) {

package/dist/codemods/migrations/manager.js

@@ -0,0 +1,32 @@
+import defaultMigrations from './migrations.js';
+import { runCodemod } from '../runner.js';
+import { satisfies, gte } from 'semver';
+import { CURRENT_APP_VERSION } from '../../utils/utils.version.js';
+import { gitCommitNoVerify } from '../../utils/utils.git.js';
+import { output } from '../../utils/utils.console.js';
+import { setRootConfig } from '../../utils/utils.config.js';
+
+function getMigrationsToRun(fromVersion, toVersion, migrations = defaultMigrations) {
+  const semverRange = `${fromVersion} - ${toVersion}`;
+  return migrations.filter((meta) => satisfies(meta.version, semverRange)).sort((a, b) => {
+    return gte(a.version, b.version) ? 1 : -1;
+  });
+}
+async function runMigrations(migrations, options = {}) {
+  const migrationList = migrations.map((meta) => `${meta.name} (${meta.description})`);
+  const migrationListBody = migrationList.length > 0 ? output.bulletList(migrationList) : ["No migrations to run."];
+  output.log({ title: "Running the following migrations:", body: migrationListBody });
+  for (const migration of migrations) {
+    const context = await runCodemod(migration, options.codemodOptions);
+    const shouldCommit = options.commitEachMigration && context.hasChanges();
+    if (shouldCommit) {
+      await gitCommitNoVerify(`chore: run create-plugin migration - ${migration.name} (${migration.scriptPath})`);
+    }
+  }
+  setRootConfig({ version: CURRENT_APP_VERSION });
+  if (options.commitEachMigration) {
+    await gitCommitNoVerify(`chore: update .config/.cprc.json to version ${CURRENT_APP_VERSION}.`);
+  }
+}
+
+export { getMigrationsToRun, runMigrations };

package/dist/codemods/migrations/migrations.js

@@ -0,0 +1,50 @@
+import { LEGACY_UPDATE_CUTOFF_VERSION } from '../../constants.js';
+
+var defaultMigrations = [
+  {
+    name: "001-update-grafana-compose-extend",
+    version: LEGACY_UPDATE_CUTOFF_VERSION,
+    description: "Update ./docker-compose.yaml to extend from ./.config/docker-compose-base.yaml.",
+    scriptPath: import.meta.resolve("./scripts/001-update-grafana-compose-extend.js")
+  },
+  {
+    name: "002-update-is-compatible-workflow",
+    version: LEGACY_UPDATE_CUTOFF_VERSION,
+    description: "Update ./.github/workflows/is-compatible.yml to use is-compatible github action instead of calling levitate directly",
+    scriptPath: import.meta.resolve("./scripts/002-update-is-compatible-workflow.js")
+  },
+  {
+    name: "003-update-eslint-deprecation-rule",
+    version: LEGACY_UPDATE_CUTOFF_VERSION,
+    description: "Replace deprecated eslint-plugin-deprecation with @typescript-eslint/no-deprecated rule.",
+    scriptPath: import.meta.resolve("./scripts/003-update-eslint-deprecation-rule.js")
+  },
+  {
+    name: "004-eslint9-flat-config",
+    version: LEGACY_UPDATE_CUTOFF_VERSION,
+    description: "Migrate eslint config to flat config format and update devDependencies to latest versions.",
+    scriptPath: import.meta.resolve("./scripts/004-eslint9-flat-config.js")
+  },
+  {
+    name: "005-react-18-3",
+    version: "6.1.9",
+    description: "Update React and ReactDOM 18.x versions to ^18.3.0 to surface React 19 compatibility issues.",
+    scriptPath: import.meta.resolve("./scripts/005-react-18-3.js")
+  },
+  {
+    name: "006-webpack-nested-fix",
+    version: "6.1.11",
+    description: "Fix webpack variable replacement in nested plugins files.",
+    scriptPath: import.meta.resolve("./scripts/006-webpack-nested-fix.js")
+  },
+  {
+    name: "007-remove-testing-library-types",
+    version: "6.1.13",
+    description: "Add setupTests.d.ts for @testing-library/jest-dom types and remove @types/testing-library__jest-dom npm package.",
+    scriptPath: import.meta.resolve("./scripts/007-remove-testing-library-types.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.
+];
+
+export { defaultMigrations as default };

package/dist/{migrations → codemods/migrations}/scripts/003-update-eslint-deprecation-rule.js

@@ -1,4 +1,4 @@
-import { addDependenciesToPackageJson, removeDependenciesFromPackageJson } from '../utils.js';
+import { addDependenciesToPackageJson, removeDependenciesFromPackageJson } from '../../utils.js';
 
 function migrate(context) {
   if (context.doesFileExist(".config/.eslintrc") && context.doesFileExist("package.json")) {

package/dist/{migrations → codemods/migrations}/scripts/004-eslint9-flat-config.js

@@ -4,7 +4,7 @@ import { parse } from 'jsonc-parser';
 import minimist from 'minimist';
 import { resolve, dirname, relative } from 'node:path';
 import * as recast from 'recast';
-import { addDependenciesToPackageJson, migrationsDebug } from '../utils.js';
+import { addDependenciesToPackageJson, migrationsDebug } from '../../utils.js';
 
 const { builders } = recast.types;
 const legacyKeysToCopy = ["rules", "settings"];

package/dist/{migrations → codemods/migrations}/scripts/005-react-18-3.js

@@ -1,4 +1,4 @@
-import { isVersionGreater, addDependenciesToPackageJson } from '../utils.js';
+import { isVersionGreater, addDependenciesToPackageJson } from '../../utils.js';
 
 function migrate(context) {
   if (context.doesFileExist("package.json")) {

package/dist/{migrations → codemods/migrations}/scripts/007-remove-testing-library-types.js

@@ -1,4 +1,4 @@
-import { isVersionGreater, removeDependenciesFromPackageJson } from '../utils.js';
+import { isVersionGreater, removeDependenciesFromPackageJson } from '../../utils.js';
 
 function migrate(context) {
   if (context.doesFileExist("package.json")) {

package/dist/codemods/runner.js

@@ -0,0 +1,33 @@
+import { Context } from './context.js';
+import { formatFiles, flushChanges, printChanges, installNPMDependencies } from './utils.js';
+import { parseAndValidateOptions } from './schema-parser.js';
+
+async function runCodemod(codemod, options) {
+  const codemodModule = await import(codemod.scriptPath);
+  if (!codemodModule.default || typeof codemodModule.default !== "function") {
+    throw new Error(`Codemod ${codemod.name} must export a default function`);
+  }
+  let codemodOptions = {};
+  if (options && codemodModule.schema) {
+    codemodOptions = parseAndValidateOptions(options, codemodModule.schema);
+  }
+  const basePath = process.cwd();
+  const context = new Context(basePath);
+  try {
+    const updatedContext = await codemodModule.default(context, codemodOptions);
+    await formatFiles(updatedContext);
+    flushChanges(updatedContext);
+    printChanges(updatedContext, codemod.name, codemod.description);
+    installNPMDependencies(updatedContext);
+    return updatedContext;
+  } catch (error) {
+    if (error instanceof Error) {
+      const newError = new Error(`Error running ${codemod.name}: ${error.message}`);
+      newError.cause = error;
+      throw newError;
+    }
+    throw error;
+  }
+}
+
+export { runCodemod };

package/dist/codemods/schema-parser.js

@@ -0,0 +1,20 @@
+import * as v from 'valibot';
+
+function parseAndValidateOptions(options, schema) {
+  try {
+    return v.parse(schema, options);
+  } catch (error) {
+    if (v.isValiError(error)) {
+      const formattedErrors = error.issues.map((issue) => {
+        const path = issue.path?.map((p) => p.key).join(".") || "";
+        return `  --${path}: ${issue.message}`;
+      }).join("\n");
+      throw new Error(`Invalid flag(s) provided:
+
+${formattedErrors}`);
+    }
+    throw error;
+  }
+}
+
+export { parseAndValidateOptions };

package/dist/{migrations → codemods}/utils.js

@@ -1,14 +1,14 @@
 import { join, dirname } from 'node:path';
 import { createRequire } from 'node:module';
 import { mkdirSync, writeFileSync, rmSync } from 'node:fs';
-import { debug } from '../utils/utils.cli.js';
 import chalk from 'chalk';
 import { output } from '../utils/utils.console.js';
 import { getPackageManagerWithFallback, getPackageManagerSilentInstallCmd } from '../utils/utils.packageManager.js';
 import { execSync } from 'node:child_process';
 import { gte, gt, clean, coerce } from 'semver';
+import { debug } from '../utils/utils.cli.js';
 
-function printChanges(context, key, migration) {
+function printChanges(context, key, description) {
   const changes = context.listChanges();
   const lines = [];
   for (const [filePath, { changeType }] of Object.entries(changes)) {
@@ -21,7 +21,7 @@ function printChanges(context, key, migration) {
     }
   }
   output.addHorizontalLine("gray");
-  output.logSingleLine(`${key} (${migration.description})`);
+  output.logSingleLine(`${key} (${description})`);
   if (lines.length === 0) {
     output.logSingleLine("No changes were made");
   } else {
@@ -43,7 +43,6 @@ function flushChanges(context) {
     }
   }
 }
-const migrationsDebug = debug.extend("migrations");
 async function formatFiles(context) {
   let prettier;
   const require = createRequire(import.meta.url);
@@ -120,14 +119,10 @@ function addDependenciesToPackageJson(context, dependencies, devDependencies = {
     if (currentDeps[dep]) {
       if (isVersionGreater(newVersion, currentDeps[dep])) {
         currentDeps[dep] = newVersion;
-      } else {
-        migrationsDebug("would downgrade dependency %s to %s", dep, newVersion);
       }
     } else if (currentDevDeps[dep]) {
       if (isVersionGreater(newVersion, currentDevDeps[dep])) {
         currentDevDeps[dep] = newVersion;
-      } else {
-        migrationsDebug("would downgrade devDependency %s to %s", dep, newVersion);
       }
     } else {
       currentDeps[dep] = newVersion;
@@ -137,14 +132,10 @@ function addDependenciesToPackageJson(context, dependencies, devDependencies = {
     if (currentDeps[dep]) {
       if (isVersionGreater(newVersion, currentDeps[dep])) {
         currentDeps[dep] = newVersion;
-      } else {
-        migrationsDebug("would downgrade dependency %s to %s", dep, newVersion);
       }
     } else if (currentDevDeps[dep]) {
       if (isVersionGreater(newVersion, currentDevDeps[dep])) {
         currentDevDeps[dep] = newVersion;
-      } else {
-        migrationsDebug("would downgrade devDependency %s to %s", dep, newVersion);
       }
     } else {
       currentDevDeps[dep] = newVersion;
@@ -161,7 +152,6 @@ function addDependenciesToPackageJson(context, dependencies, devDependencies = {
     ...Object.keys(sortedDeps).length > 0 && { dependencies: sortedDeps },
     ...Object.keys(sortedDevDeps).length > 0 && { devDependencies: sortedDevDeps }
   };
-  migrationsDebug("updated package.json", updatedPackageJson);
   context.updateFile(packageJsonPath, JSON.stringify(updatedPackageJson, null, 2));
 }
 function removeDependenciesFromPackageJson(context, dependencies, devDependencies = [], packageJsonPath = "package.json") {
@@ -170,21 +160,18 @@ function removeDependenciesFromPackageJson(context, dependencies, devDependencie
   for (const dep of dependencies) {
     if (currentPackageJson.dependencies?.[dep]) {
       delete currentPackageJson.dependencies[dep];
-      migrationsDebug("removed dependency %s", dep);
       hasChanges = true;
     }
   }
   for (const dep of devDependencies) {
     if (currentPackageJson.devDependencies?.[dep]) {
       delete currentPackageJson.devDependencies[dep];
-      migrationsDebug("removed devDependency %s", dep);
       hasChanges = true;
     }
   }
   if (!hasChanges) {
     return;
   }
-  migrationsDebug("updated package.json", currentPackageJson);
   context.updateFile(packageJsonPath, JSON.stringify(currentPackageJson, null, 2));
 }
 const DIST_TAGS = {
@@ -217,5 +204,7 @@ function cleanSemver(version) {
 function sortObjectByKeys(obj) {
   return Object.keys(obj).sort().reduce((acc, key) => ({ ...acc, [key]: obj[key] }), {});
 }
+const migrationsDebug = debug.extend("migrations");
+debug.extend("additions");
 
 export { addDependenciesToPackageJson, flushChanges, formatFiles, installNPMDependencies, isVersionGreater, migrationsDebug, printChanges, readJsonFile, removeDependenciesFromPackageJson };

package/dist/commands/add.command.js

@@ -0,0 +1,51 @@
+import defaultAdditions from '../codemods/additions/additions.js';
+import { runCodemod } from '../codemods/runner.js';
+import { getPackageManagerFromUserAgent, getPackageManagerExecCmd } from '../utils/utils.packageManager.js';
+import { performPreCodemodChecks } from '../utils/utils.checks.js';
+import { output } from '../utils/utils.console.js';
+
+const add = async (argv) => {
+  const subCommand = argv._[1];
+  if (!subCommand) {
+    await showAdditionsHelp();
+    process.exit(1);
+  }
+  await performPreCodemodChecks(argv);
+  try {
+    const addition = defaultAdditions.find((addition2) => addition2.name === subCommand);
+    if (!addition) {
+      const additionsList = defaultAdditions.map((addition2) => addition2.name);
+      throw new Error(`Unknown addition: ${subCommand}
+
+Available additions: ${additionsList.join(", ")}`);
+    }
+    const { _, $0, ...codemodOptions } = argv;
+    await runCodemod(addition, codemodOptions);
+    output.success({
+      title: `Successfully added ${addition.name} to your plugin.`
+    });
+  } catch (error) {
+    if (error instanceof Error) {
+      output.error({
+        title: "Addition failed",
+        body: [error.message]
+      });
+    }
+    process.exit(1);
+  }
+};
+async function showAdditionsHelp() {
+  const additionsList = defaultAdditions.map((addition) => addition.name);
+  const { packageManagerName, packageManagerVersion } = getPackageManagerFromUserAgent();
+  output.error({
+    title: "No addition specified",
+    body: [
+      `Usage: ${getPackageManagerExecCmd(packageManagerName, packageManagerVersion)} add <addition-name> [options]`,
+      "",
+      "Available additions:",
+      ...output.bulletList(additionsList)
+    ]
+  });
+}
+
+export { add };

package/dist/commands/update.command.js

@@ -1,16 +1,15 @@
-import { getMigrationsToRun, runMigrations } from '../migrations/manager.js';
+import { getMigrationsToRun, runMigrations } from '../codemods/migrations/manager.js';
 import { getPackageManagerWithFallback, getPackageManagerExecCmd, getPackageManagerSilentInstallCmd } from '../utils/utils.packageManager.js';
 import { lt, gte } from 'semver';
-import { isGitDirectory, isGitDirectoryClean } from '../utils/utils.git.js';
+import { performPreCodemodChecks } from '../utils/utils.checks.js';
 import { CURRENT_APP_VERSION } from '../utils/utils.version.js';
 import { LEGACY_UPDATE_CUTOFF_VERSION } from '../constants.js';
 import { getConfig } from '../utils/utils.config.js';
-import { isPluginDirectory } from '../utils/utils.plugin.js';
 import { output } from '../utils/utils.console.js';
 import { spawnSync } from 'node:child_process';
 
 const update = async (argv) => {
-  await performPreUpdateChecks(argv);
+  await performPreCodemodChecks(argv);
   const { version } = getConfig();
   if (lt(version, LEGACY_UPDATE_CUTOFF_VERSION)) {
     preparePluginForMigrations(argv);
@@ -22,9 +21,12 @@ const update = async (argv) => {
       });
       process.exit(0);
     }
-    const commitEachMigration = argv.commit;
     const migrations = getMigrationsToRun(version, CURRENT_APP_VERSION);
-    await runMigrations(migrations, { commitEachMigration });
+    const { _, $0, ...codemodOptions } = argv;
+    await runMigrations(migrations, {
+      commitEachMigration: !!argv.commit,
+      codemodOptions
+    });
     output.success({
       title: `Successfully updated create-plugin from ${version} to ${CURRENT_APP_VERSION}.`
     });
@@ -38,42 +40,6 @@ const update = async (argv) => {
     process.exit(1);
   }
 };
-async function performPreUpdateChecks(argv) {
-  if (!await isGitDirectory() && !argv.force) {
-    output.error({
-      title: "You are not inside a git directory",
-      body: [
-        `In order to proceed please run ${output.formatCode("git init")} in the root of your project and commit your changes.`,
-        `(This check is necessary to make sure that the updates are easy to revert and don't interfere with any changes you currently have.`,
-        `In case you want to proceed as is please use the ${output.formatCode("--force")} flag.)`
-      ]
-    });
-    process.exit(1);
-  }
-  if (!await isGitDirectoryClean() && !argv.force) {
-    output.error({
-      title: "Please clean your repository working tree before updating.",
-      body: [
-        "Commit your changes or stash them.",
-        `(This check is necessary to make sure that the updates are easy to revert and don't mess with any changes you currently have.`,
-        `In case you want to proceed as is please use the ${output.formatCode("--force")} flag.)`
-      ]
-    });
-    process.exit(1);
-  }
-  if (!isPluginDirectory() && !argv.force) {
-    output.error({
-      title: "Are you inside a plugin directory?",
-      body: [
-        `We couldn't find a "src/plugin.json" file under your current directory.`,
-        `(Please make sure to run this command from the root of your plugin folder. In case you want to proceed as is please use the ${output.formatCode(
-          "--force"
-        )} flag.)`
-      ]
-    });
-    process.exit(1);
-  }
-}
 function preparePluginForMigrations(argv) {
   const { packageManagerName, packageManagerVersion } = getPackageManagerWithFallback();
   const packageManagerExecCmd = getPackageManagerExecCmd(packageManagerName, packageManagerVersion);

package/dist/utils/utils.checks.js

@@ -0,0 +1,40 @@
+import { isGitDirectory, isGitDirectoryClean } from './utils.git.js';
+import { isPluginDirectory } from './utils.plugin.js';
+import { output } from './utils.console.js';
+
+async function performPreCodemodChecks(argv) {
+  if (!await isGitDirectory() && !argv.force) {
+    output.error({
+      title: "You are not inside a git directory",
+      body: [
+        `In order to proceed please run ${output.formatCode("git init")} in the root of your project and commit your changes.`,
+        `(This check is necessary to make sure that changes are easy to revert and don't interfere with any changes you currently have.`,
+        `In case you want to proceed as is please use the ${output.formatCode("--force")} flag.)`
+      ]
+    });
+    process.exit(1);
+  }
+  if (!await isGitDirectoryClean() && !argv.force) {
+    output.error({
+      title: "Please clean your repository working tree before making changes.",
+      body: [
+        "Commit your changes or stash them.",
+        `(This check is necessary to make sure that changes are easy to revert and don't mess with any changes you currently have.`,
+        `In case you want to proceed as is please use the ${output.formatCode("--force")} flag.)`
+      ]
+    });
+    process.exit(1);
+  }
+  if (!isPluginDirectory() && !argv.force) {
+    output.error({
+      title: "Are you inside a plugin directory?",
+      body: [
+        `We couldn't find a "src/plugin.json" file under your current directory.`,
+        `(Please make sure to run this command from the root of your plugin folder. In case you want to proceed as is please use the ${output.formatCode("--force")} flag.)`
+      ]
+    });
+    process.exit(1);
+  }
+}
+
+export { performPreCodemodChecks };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grafana/create-plugin",
-  "version": "6.2.0-canary.2314.19505018775.0",
+  "version": "6.2.0",
   "repository": {
     "directory": "packages/create-plugin",
     "url": "https://github.com/grafana/plugin-tools"
@@ -39,6 +39,7 @@
     "recast": "^0.23.11",
     "semver": "^7.3.5",
     "title-case": "^4.3.0",
+    "valibot": "^1.1.0",
     "which": "^5.0.0",
     "yaml": "^2.7.0"
   },
@@ -60,5 +61,5 @@
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "68ffe571c164963b0c82c2d1788c307914495307"
+  "gitHead": "0ce6b92fb308b79f5c201eee6456213910f53b77"
 }

package/src/bin/run.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 import minimist from 'minimist';
-import { generate, update, migrate, version, provisioning } from '../commands/index.js';
+import { add, generate, update, migrate, version, provisioning } from '../commands/index.js';
 import { isUnsupportedPlatform } from '../utils/utils.os.js';
 import { argv, commandName } from '../utils/utils.cli.js';
 import { output } from '../utils/utils.console.js';
@@ -23,6 +23,7 @@ const commands: Record<string, (argv: minimist.ParsedArgs) => void> = {
   update,
   version,
   provisioning,
+  add,
 };
 const command = commands[commandName] || 'generate';
 

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

@@ -0,0 +1,17 @@
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import defaultAdditions from './additions.js';
+
+describe('additions json', () => {
+  // As addition scripts are imported dynamically when add is run we assert the path is valid
+  // Vitest 4 reimplemented its workers, which caused the previous dynamic import tests to fail.
+  // This test now only asserts that the addition script source file exists.
+  defaultAdditions.forEach((addition) => {
+    it(`should have a valid addition script path for ${addition.name}`, () => {
+      // import.meta.resolve() returns a file:// URL, convert to path
+      const filePath = fileURLToPath(addition.scriptPath);
+      const sourceFilePath = filePath.replace('.js', '.ts');
+      expect(existsSync(sourceFilePath)).toBe(true);
+    });
+  });
+});

package/src/codemods/additions/additions.ts

@@ -0,0 +1,9 @@
+import { Codemod } from '../types.js';
+
+export default [
+  {
+    name: 'example-addition',
+    description: 'Adds an example addition to the plugin',
+    scriptPath: import.meta.resolve('./scripts/example-addition.js'),
+  },
+] satisfies Codemod[];