@meith/cli 0.26.1 → 0.28.0

package/bin/{community.mjs → meith.mjs}

@@ -11,7 +11,7 @@ const workspaceRoot = process.cwd()
 const materializedDir = join(workspaceRoot, '.meith', 'cli')
 
 function fail(message) {
-  console.error(`community: ${message}`)
+  console.error(`meith: ${message}`)
   process.exit(1)
 }
 
@@ -26,7 +26,7 @@ function materialize() {
 
   if (!existsSync(boardConfig)) {
     fail(
-      `no meith.config.ts in ${workspaceRoot}. Run community from a board's own ` +
+      `no meith.config.ts in ${workspaceRoot}. Run meith from a board's own ` +
         'directory — the one create-meith scaffolded, or one shaped like it.',
     )
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@meith/cli",
-  "version": "0.26.1",
-  "description": "The operator CLI: migrations, backup and restore, imports, users and settings — and the community bin that runs it against an external board workspace.",
+  "version": "0.28.0",
+  "description": "The operator CLI: migrations, backup and restore, imports, users and settings — and the meith bin that runs it against an external board workspace.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -10,7 +10,7 @@
   },
   "type": "module",
   "bin": {
-    "community": "./bin/community.mjs"
+    "meith": "./bin/meith.mjs"
   },
   "files": [
     "bin",
@@ -23,18 +23,18 @@
   },
   "dependencies": {
     "tsx": "^4.23.12",
-    "@meith/accounts": "0.26.1",
-    "@meith/core": "0.26.1",
-    "@meith/db": "0.26.1",
-    "@meith/demo": "0.26.1",
-    "@meith/drivers": "0.26.1",
-    "@meith/forums": "0.26.1",
-    "@meith/plugin-kit": "0.26.1",
-    "@meith/profile-fields": "0.26.1",
-    "@meith/runtime": "0.26.1",
-    "@meith/settings": "0.26.1",
-    "@meith/tasks": "0.26.1",
-    "create-meith": "0.26.1"
+    "@meith/accounts": "0.28.0",
+    "@meith/core": "0.28.0",
+    "@meith/db": "0.28.0",
+    "@meith/demo": "0.28.0",
+    "@meith/drivers": "0.28.0",
+    "@meith/forums": "0.28.0",
+    "@meith/plugin-kit": "0.28.0",
+    "@meith/profile-fields": "0.28.0",
+    "@meith/runtime": "0.28.0",
+    "@meith/settings": "0.28.0",
+    "@meith/tasks": "0.28.0",
+    "create-meith": "0.28.0"
   },
   "devDependencies": {
     "esbuild": "^0.28.2"

package/src/backup.ts

@@ -674,7 +674,7 @@ async function pushUploadsToStore(
 }
 
 const RESTORE_USAGE =
-  'Usage: RESTORE_DATABASE_URL=<postgres://…> community restore <bundle.tar.gz> ' +
+  'Usage: RESTORE_DATABASE_URL=<postgres://…> meith restore <bundle.tar.gz> ' +
   '[--uploads-dir <dir>] [--skip-uploads]'
 
 export function restoreDatabaseUrl(

package/src/board-eject.ts

@@ -101,7 +101,7 @@ async function readManifest(): Promise<Manifest> {
     if ((error as NodeJS.ErrnoException).code === 'ENOENT') {
       throw new ValidationError(
         `board:eject could not find this build's plugin manifest at ${path}. This command ` +
-          'runs inside the official image (docker compose run --rm web community board:eject ' +
+          'runs inside the official image (docker compose run --rm web meith board:eject ' +
           '<dir>), where it is baked in — or, in this repository, against boards/stock. It is ' +
           'not meant to run against a workspace board:eject already produced.',
       )
@@ -179,7 +179,7 @@ export async function boardEject(args: readonly string[]): Promise<number> {
   const [dir] = positional
 
   if (dir === undefined || positional.length > 1) {
-    throw new ValidationError('Usage: community board:eject <dir>')
+    throw new ValidationError('Usage: meith board:eject <dir>')
   }
 
   const target = resolve(process.cwd(), dir)

package/src/commands.ts

@@ -17,7 +17,7 @@ async function readPassword(flags: Flags): Promise<string> {
   if (inline !== undefined) {
     console.warn(
       'warning: --password is visible in shell history and to `ps`. ' +
-        'Prefer:  echo "secret" | community user:create --username u --email e@x.com',
+        'Prefer:  echo "secret" | meith user:create --username u --email e@x.com',
     )
     return inline
   }
@@ -25,7 +25,7 @@ async function readPassword(flags: Flags): Promise<string> {
   if (process.stdin.isTTY) {
     throw new ValidationError(
       'No password supplied. Pipe one in:\n' +
-        '  echo "correct horse battery staple" | community user:create --username u --email u@example.com',
+        '  echo "correct horse battery staple" | meith user:create --username u --email u@example.com',
     )
   }
 
@@ -159,7 +159,7 @@ export function settingDisplayValue(definition: SettingDefinition, value: unknow
 export async function settingsGet(args: readonly string[]): Promise<number> {
   const { positional } = parseFlags(args)
   const key = positional[0]
-  if (key === undefined) throw new ValidationError('Usage: community settings:get <key>')
+  if (key === undefined) throw new ValidationError('Usage: meith settings:get <key>')
 
   const definition = SETTING_DEFINITION_BY_KEY.get(key)
   if (!definition) throw new ValidationError(`Unknown setting "${key}".`)
@@ -212,9 +212,9 @@ export async function settingsSet(args: readonly string[]): Promise<number> {
   const [key, positionalValue, ...extra] = positional
   if (key === undefined || extra.length > 0) {
     throw new ValidationError(
-      'Usage: community settings:set <key> <value>\n' +
-        '       community settings:set <secret-key> --from-env <name>\n' +
-        '       printf %s "$SECRET" | community settings:set <secret-key>',
+      'Usage: meith settings:set <key> <value>\n' +
+        '       meith settings:set <secret-key> --from-env <name>\n' +
+        '       printf %s "$SECRET" | meith settings:set <secret-key>',
     )
   }
 
@@ -234,7 +234,7 @@ export async function settingsSet(args: readonly string[]): Promise<number> {
       throw new ValidationError('--from-env is only available for secret settings.')
     }
     if (positionalValue === undefined) {
-      throw new ValidationError('Usage: community settings:set <key> <value>')
+      throw new ValidationError('Usage: meith settings:set <key> <value>')
     }
     raw = positionalValue
   }

package/src/context.ts

@@ -30,7 +30,7 @@ export function requirePostgres(): void {
   if (env.DATA_SOURCE !== 'postgres') {
     throw new ConfigurationError(
       'This command needs a database: DATA_SOURCE is "fixture".\n' +
-        'Set DATABASE_URL (see .env.example) and run `community migrate` first.',
+        'Set DATABASE_URL (see .env.example) and run `meith migrate` first.',
     )
   }
 }
@@ -39,7 +39,7 @@ export async function defaultMemberGroupId(admin: PostgresAdminRepository): Prom
   const id = await admin.registeredGroupId()
   if (id === null) {
     throw new ConfigurationError(
-      'No "registered" usergroup found. Run `community migrate` to seed the group ladder.',
+      'No "registered" usergroup found. Run `meith migrate` to seed the group ladder.',
     )
   }
   return id

package/src/import.ts

@@ -125,7 +125,7 @@ function print(report: ImportReport, copiedFiles: boolean): void {
   console.log('')
   if (report.finished) {
     console.log(
-      'Import complete. Run `community task:run counters.reconcile` before opening the board.',
+      'Import complete. Run `meith task:run counters.reconcile` before opening the board.',
     )
     if (!copiedFiles) {
       console.log(

package/src/index.ts

@@ -32,9 +32,9 @@ function usage(commands: readonly Command[]): string {
   const width = Math.max(...commands.map((c) => c.name.length))
   const lines = commands.map((c) => `  ${c.name.padEnd(width)}  ${c.summary}`)
   return [
-    'community — operator CLI',
+    'meith — operator CLI',
     '',
-    'Usage: community <command> [options]',
+    'Usage: meith <command> [options]',
     '',
     'Commands:',
     ...lines,
@@ -85,7 +85,7 @@ const commands: Command[] = [
     name: 'migrate',
     summary: 'Apply pending database migrations.',
     usage: [
-      'community migrate',
+      'meith migrate',
       '',
       'Applies every migration this release has that the board has not, then exits.',
       'Safe to run concurrently: the runner holds a Postgres advisory lock for the',
@@ -143,7 +143,7 @@ const commands: Command[] = [
   {
     name: 'upgrade',
     summary: 'Apply core and plugin migrations, then record the version.',
-    usage: 'community upgrade [--dry-run]',
+    usage: 'meith upgrade [--dry-run]',
     async run(args: readonly string[]) {
       const { assertEnv } = await import('@meith/core')
       const env = assertEnv()
@@ -166,7 +166,7 @@ const commands: Command[] = [
   {
     name: 'backup',
     summary: 'Dump the database and the uploads into one restorable bundle.',
-    usage: 'community backup [--out <path>] [--uploads include|skip]',
+    usage: 'meith backup [--out <path>] [--uploads include|skip]',
     run: backupCommand,
   },
 
@@ -174,7 +174,7 @@ const commands: Command[] = [
     name: 'restore',
     summary: 'Restore a backup bundle into a new, empty database.',
     usage:
-      'RESTORE_DATABASE_URL=<postgres://…> community restore <bundle.tar.gz> ' +
+      'RESTORE_DATABASE_URL=<postgres://…> meith restore <bundle.tar.gz> ' +
       '[--uploads-dir <dir>] [--skip-uploads]',
     run: restoreCommand,
   },
@@ -182,7 +182,7 @@ const commands: Command[] = [
   {
     name: 'plugin:purge',
     summary: 'Run a plugin’s onUninstall and remove its data. Do this before removing the code.',
-    usage: 'community plugin:purge <key> [--yes]',
+    usage: 'meith plugin:purge <key> [--yes]',
     async run(args: readonly string[]) {
       const { assertEnv } = await import('@meith/core')
       const env = assertEnv()
@@ -194,7 +194,7 @@ const commands: Command[] = [
 
       const key = args.find((arg) => !arg.startsWith('--'))
       if (key === undefined) {
-        console.error('Usage: community plugin:purge <key> [--yes]')
+        console.error('Usage: meith plugin:purge <key> [--yes]')
         return 1
       }
 
@@ -211,8 +211,8 @@ const commands: Command[] = [
 
   {
     name: 'plugin:add',
-    summary: 'Add a package to board.plugins.json and regenerate meith.plugins.ts.',
-    usage: 'community plugin:add <package> [--key <key>] [--disabled]',
+    summary: 'Install a plugin, add it to board.plugins.json, and regenerate meith.plugins.ts.',
+    usage: 'meith plugin:add <package> [--key <key>] [--disabled]',
     async run(args: readonly string[]) {
       const { pluginAdd } = await import('./plugin-manifest')
       return pluginAdd(args)
@@ -222,7 +222,7 @@ const commands: Command[] = [
   {
     name: 'plugin:remove',
     summary: 'Remove a plugin from board.plugins.json and regenerate meith.plugins.ts.',
-    usage: 'community plugin:remove <key>',
+    usage: 'meith plugin:remove <key>',
     async run(args: readonly string[]) {
       const { pluginRemove } = await import('./plugin-manifest')
       return pluginRemove(args)
@@ -233,7 +233,7 @@ const commands: Command[] = [
     name: 'board:eject',
     summary:
       'Write this build as a standalone workspace — the first step of graduating off the stock image.',
-    usage: 'community board:eject <dir>',
+    usage: 'meith board:eject <dir>',
     async run(args: readonly string[]) {
       const { boardEject } = await import('./board-eject')
       return boardEject(args)
@@ -264,22 +264,21 @@ const commands: Command[] = [
   {
     name: 'user:create',
     summary: 'Create a user account. Pipe the password in on stdin.',
-    usage:
-      'echo "<password>" | community user:create --username <name> --email <addr> [--group <key>]',
+    usage: 'echo "<password>" | meith user:create --username <name> --email <addr> [--group <key>]',
     run: userCreate,
   },
 
   {
     name: 'user:promote',
     summary: "Change a user's primary group.",
-    usage: 'community user:promote --user <id|username> --group <key|id>',
+    usage: 'meith user:promote --user <id|username> --group <key|id>',
     run: userPromote,
   },
 
   {
     name: 'user:2fa-clear',
     summary: "Clear a user's second factor when they have lost it, and sign them out.",
-    usage: 'community user:2fa-clear --user <id|username>',
+    usage: 'meith user:2fa-clear --user <id|username>',
     run: userClearSecondFactor,
   },
 
@@ -287,7 +286,7 @@ const commands: Command[] = [
     name: 'forum:create',
     summary: 'Create a category, forum or link.',
     usage:
-      'community forum:create --title <title> --slug <slug> [--parent <id>] ' +
+      'meith forum:create --title <title> --slug <slug> [--parent <id>] ' +
       '[--type category|forum|link] [--description <text>] [--link-url <url>]',
     run: forumCreate,
   },
@@ -295,7 +294,7 @@ const commands: Command[] = [
   {
     name: 'settings:get',
     summary: 'Print one resolved setting value.',
-    usage: 'community settings:get <key>',
+    usage: 'meith settings:get <key>',
     run: settingsGet,
   },
 
@@ -303,9 +302,9 @@ const commands: Command[] = [
     name: 'settings:set',
     summary: 'Set one setting, validated by the registry.',
     usage:
-      'community settings:set <key> <value>\n' +
-      'community settings:set <secret-key> --from-env <name>\n' +
-      'printf %s "$SECRET" | community settings:set <secret-key>',
+      'meith settings:set <key> <value>\n' +
+      'meith settings:set <secret-key> --from-env <name>\n' +
+      'printf %s "$SECRET" | meith settings:set <secret-key>',
     run: settingsSet,
   },
 
@@ -319,7 +318,7 @@ const commands: Command[] = [
     name: 'profile-field:add',
     summary: 'Define a custom profile field.',
     usage:
-      'community profile-field:add --key <key> --label <label> ' +
+      'meith profile-field:add --key <key> --label <label> ' +
       '--type text|textarea|select|checkbox|url|number ' +
       '[--options a,b,c] [--required] [--postbit] [--order <n>]',
     run: profileFieldAdd,
@@ -328,14 +327,14 @@ const commands: Command[] = [
   {
     name: 'profile-field:remove',
     summary: "Delete a custom profile field and every member's answer to it.",
-    usage: 'community profile-field:remove <key>',
+    usage: 'meith profile-field:remove <key>',
     run: profileFieldRemove,
   },
 
   {
     name: 'push:keys',
     summary: 'Generate a VAPID key pair for web push. --save writes it to the board.',
-    usage: 'community push:keys [--save]',
+    usage: 'meith push:keys [--save]',
     run: pushKeys,
   },
 
@@ -348,7 +347,7 @@ const commands: Command[] = [
   {
     name: 'task:run',
     summary: 'Run every task that is due now, or one named task if it is due.',
-    usage: 'community task:run [<task-id>]',
+    usage: 'meith task:run [<task-id>]',
     run: taskRun,
   },
 
@@ -367,7 +366,7 @@ const commands: Command[] = [
   {
     name: 'demo:reset',
     summary: 'Drop everything and rebuild the demo board. Needs DEMO_MODE.',
-    usage: 'community demo:reset --yes',
+    usage: 'meith demo:reset --yes',
     run: demoReset,
   },
 ]
@@ -392,7 +391,7 @@ async function main(): Promise<number> {
   }
 
   if (rest.includes('--help')) {
-    console.log(command.usage ?? `community ${command.name}`)
+    console.log(command.usage ?? `meith ${command.name}`)
     return 0
   }
 

package/src/plugin-manifest.ts

@@ -1,21 +1,17 @@
 import { execFileSync } from 'node:child_process'
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
 import { readFile, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
 import { ValidationError } from '@meith/core'
 
-import BOARDS_JSON from '../../../scripts/boards.json'
 import { optional, parseFlags } from './args'
 
 function repoRoot(): string {
   return fileURLToPath(new URL('../../../', import.meta.url))
 }
 
-function generatorScript(): string {
-  return join(repoRoot(), 'scripts/board-plugins-gen.mjs')
-}
-
 interface Board {
   readonly manifestFile: string
   readonly packageFile: string
@@ -24,12 +20,6 @@ interface Board {
   readonly filterName: string
 }
 
-const BOARDS = BOARDS_JSON as readonly Board[]
-
-function boardsRoot(): string {
-  return process.env.MEITH_BOARD_PLUGINS_ROOT ?? repoRoot()
-}
-
 interface ManifestEntry {
   readonly key: string
   readonly package: string
@@ -40,20 +30,212 @@ interface Manifest {
   readonly plugins: readonly ManifestEntry[]
 }
 
-async function readManifestFor(board: Board): Promise<Manifest> {
-  const path = join(boardsRoot(), board.manifestFile)
+interface GeneratorResult {
+  readonly ok: boolean
+  readonly output: string
+}
+
+interface Mode {
+  readonly root: string
+  readonly boards: readonly Board[]
+  assertEditable(): void
+  installPackage(packageName: string): void
+  regenerate(): GeneratorResult
+  missingManifest(path: string): string
+}
+
+export function assertBoardCheckout(root: string): void {
+  if (existsSync(join(root, '.git'))) return
+  throw new ValidationError(
+    'plugin:add and plugin:remove edit this board’s source — package.json, board.plugins.json ' +
+      'and meith.plugins.ts — and only take effect when the image is rebuilt. This is not your ' +
+      'board’s git checkout (there is no .git here), which means it is most likely the deployed ' +
+      'container: a change made here would not rebuild anything and would be discarded on the next ' +
+      'redeploy. Run it where you edit and commit the board, then push and redeploy.',
+  )
+}
+
+export function installBoardPackage(root: string, packageName: string): void {
+  try {
+    execFileSync('npm', ['install', '--save-exact', packageName], { cwd: root, stdio: 'inherit' })
+  } catch {
+    throw new ValidationError(
+      `Could not install ${packageName} — npm reported the error above. Fix that and rerun.`,
+    )
+  }
+}
+
+const BOARD_MODE_BOARD: Board = {
+  manifestFile: 'board.plugins.json',
+  packageFile: 'package.json',
+  outputFile: 'meith.plugins.ts',
+  packageLabel: 'this board',
+  filterName: '',
+}
+
+function monorepoMode(boardsFile: string): Mode {
+  const boards = JSON.parse(readFileSync(boardsFile, 'utf8')) as readonly Board[]
+  const root = process.env.MEITH_BOARD_PLUGINS_ROOT ?? repoRoot()
+
+  return {
+    root,
+    boards,
+    assertEditable: () => {},
+    installPackage: () => {},
+    regenerate: () => runGenerator(join(repoRoot(), 'scripts/board-plugins-gen.mjs')),
+    missingManifest: (path) =>
+      `${path} does not exist. This command edits source files for every board this ` +
+      'repository carries — apps/community and boards/stock — and reruns the generator, ' +
+      'so it needs a checkout of the repository, not the deployed image — run it where you ' +
+      'would run `pnpm add`, commit both board.plugins.json files and both ' +
+      'meith.plugins.ts files, then rebuild and redeploy.',
+  }
+}
+
+function boardMode(): Mode {
+  const root = process.env.MEITH_BOARD_PLUGINS_ROOT ?? process.cwd()
+
+  return {
+    root,
+    boards: [BOARD_MODE_BOARD],
+    assertEditable: () => assertBoardCheckout(root),
+    installPackage: (packageName) => installBoardPackage(root, packageName),
+    regenerate: () => regenerateBoard(root),
+    missingManifest: (path) =>
+      `${path} does not exist. Run this from the board create-meith scaffolded — the ` +
+      'directory with meith.config.ts and board.plugins.json in it.',
+  }
+}
+
+function resolveMode(): Mode {
+  const boardsFile = join(repoRoot(), 'scripts/boards.json')
+  return existsSync(boardsFile) ? monorepoMode(boardsFile) : boardMode()
+}
+
+const PLUGIN_KEY_PATTERN = /^[a-z][a-z0-9-]{1,39}$/
+const IDENTIFIER_PATTERN = /^[A-Za-z_$][A-Za-z0-9_$]*$/
+const NPM_PACKAGE_NAME_PATTERN = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/
+
+function toIdentifier(key: string): string {
+  return key.replace(/-([a-z0-9])/g, (_match, char: string) => char.toUpperCase())
+}
+
+function dependencyNames(packageFile: string): Set<string> {
+  const pkg = JSON.parse(readFileSync(packageFile, 'utf8')) as {
+    dependencies?: Record<string, string>
+  }
+  return new Set(Object.keys(pkg.dependencies ?? {}))
+}
+
+function validateBoardManifest(
+  plugins: readonly ManifestEntry[],
+  dependencies: ReadonlySet<string>,
+): void {
+  const identifiers = new Map<string, string>()
+
+  for (const entry of plugins) {
+    if (!PLUGIN_KEY_PATTERN.test(entry.key)) {
+      throw new Error(
+        `"${entry.key}" is not a valid plugin key. It must be lower-case letters, digits and ` +
+          'hyphens, start with a letter, and be 2–40 characters long.',
+      )
+    }
+
+    const identifier = toIdentifier(entry.key)
+    if (!IDENTIFIER_PATTERN.test(identifier)) {
+      throw new Error(
+        `"${entry.key}" is a valid key, but the identifier meith.plugins.ts would bind for it, ` +
+          `"${identifier}", is not a valid one — each hyphen must be followed by a letter or digit.`,
+      )
+    }
+
+    const collision = identifiers.get(identifier)
+    if (collision !== undefined) {
+      throw new Error(
+        `"${entry.key}" and "${collision}" both generate the identifier "${identifier}". ` +
+          'Rename one so the generated imports do not collide.',
+      )
+    }
+    identifiers.set(identifier, entry.key)
+
+    if (!NPM_PACKAGE_NAME_PATTERN.test(entry.package) || entry.package.length > 214) {
+      throw new Error(`"${entry.package}" (key "${entry.key}") is not a valid npm package name.`)
+    }
+
+    if (!dependencies.has(entry.package)) {
+      throw new Error(
+        `"${entry.package}" (key "${entry.key}") is not installed. Run ` +
+          `\`npm install ${entry.package}\` first, then rerun this.`,
+      )
+    }
+  }
+}
+
+const BOARD_HEADER = `// Generated from board.plugins.json by \`meith plugin:add\` and \`meith plugin:remove\`.
+//
+// The simple path is those commands, or editing board.plugins.json and running one of
+// them. A plugin that does not fit that convention can be added here by hand instead —
+// keep it out of board.plugins.json so a regenerate does not drop it.
+//
+// docs/customization/plugins.md explains both.`
+
+export function renderBoardModule(plugins: readonly ManifestEntry[]): string {
+  const imports = plugins.map((entry) => {
+    const name = toIdentifier(entry.key)
+    return `import { messages as ${name}Messages, plugin as ${name}Plugin } from '${entry.package}'`
+  })
+
+  const entries = plugins.map((entry) => {
+    const name = toIdentifier(entry.key)
+    const enabled = entry.enabled === false ? 'false' : 'true'
+    return (
+      `  { key: '${entry.key}', enabled: ${enabled}, ` +
+      `plugin: ${name}Plugin, messages: ${name}Messages },`
+    )
+  })
+
+  const importBlock = ["import type { InstalledPlugin } from '@meith/web/config'", ...imports].join(
+    '\n',
+  )
+
+  const listBlock =
+    entries.length === 0
+      ? 'export const INSTALLED_PLUGINS: readonly InstalledPlugin[] = []'
+      : `export const INSTALLED_PLUGINS: readonly InstalledPlugin[] = [\n${entries.join('\n')}\n]`
+
+  const functionBlock = `export function installedPluginDefinitions() {
+  return INSTALLED_PLUGINS.filter(
+    (entry) => entry.enabled !== false && entry.plugin !== undefined,
+  ).map((entry) => entry.plugin)
+}`
+
+  return `${[BOARD_HEADER, importBlock, listBlock, functionBlock].join('\n\n')}\n`
+}
+
+export function regenerateBoard(root: string): GeneratorResult {
+  try {
+    const board = BOARD_MODE_BOARD
+    const raw = readFileSync(join(root, board.manifestFile), 'utf8')
+    const plugins = (JSON.parse(raw) as Manifest).plugins
+    const dependencies = dependencyNames(join(root, board.packageFile))
+
+    validateBoardManifest(plugins, dependencies)
+    writeFileSync(join(root, board.outputFile), renderBoardModule(plugins), 'utf8')
+
+    return { ok: true, output: `${plugins.length} plugin(s)` }
+  } catch (error) {
+    return { ok: false, output: (error as Error).message }
+  }
+}
+
+async function readManifestFor(mode: Mode, board: Board): Promise<Manifest> {
+  const path = join(mode.root, board.manifestFile)
   let raw: string
   try {
     raw = await readFile(path, 'utf8')
   } catch (error) {
     if ((error as NodeJS.ErrnoException).code === 'ENOENT') {
-      throw new ValidationError(
-        `${path} does not exist. This command edits source files for every board this ` +
-          'repository carries — apps/community and boards/stock — and reruns the generator, ' +
-          'so it needs a checkout of the repository, not the deployed image — run it where you ' +
-          'would run `pnpm add`, commit both board.plugins.json files and both ' +
-          'meith.plugins.ts files, then rebuild and redeploy.',
-      )
+      throw new ValidationError(mode.missingManifest(path))
     }
     throw error
   }
@@ -76,19 +258,14 @@ async function readManifestFor(board: Board): Promise<Manifest> {
   return { plugins: parsed.plugins }
 }
 
-async function writeManifestFor(board: Board, manifest: Manifest): Promise<void> {
-  const path = join(boardsRoot(), board.manifestFile)
+async function writeManifestFor(mode: Mode, board: Board, manifest: Manifest): Promise<void> {
+  const path = join(mode.root, board.manifestFile)
   await writeFile(path, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8')
 }
 
-interface GeneratorResult {
-  readonly ok: boolean
-  readonly output: string
-}
-
-function runGenerator(): GeneratorResult {
+function runGenerator(generatorScript: string): GeneratorResult {
   try {
-    const output = execFileSync(process.execPath, [generatorScript()], {
+    const output = execFileSync(process.execPath, [generatorScript], {
       encoding: 'utf8',
       stdio: 'pipe',
     })
@@ -113,13 +290,13 @@ export async function pluginAdd(args: readonly string[]): Promise<number> {
   const [packageName, ...extraPositional] = positional
 
   if (packageName === undefined || extraPositional.length > 0) {
-    throw new ValidationError('Usage: community plugin:add <package> [--key <key>] [--disabled]')
+    throw new ValidationError('Usage: meith plugin:add <package> [--key <key>] [--disabled]')
   }
 
   const configFlags = [...flags.keys()].filter((name) => !ADD_FLAGS.has(name))
   if (configFlags.length > 0) {
     throw new ValidationError(
-      `community plugin:add does not take plugin configuration (--${configFlags[0]}). The ` +
+      `meith plugin:add does not take plugin configuration (--${configFlags[0]}). The ` +
         "manifest has no field for it — a plugin's own settings are the only place its " +
         "configuration lives now, the way MEI-74 moved plugins/dues's plans there. Export a " +
         'zero-argument plugin and add it with just its package name.',
@@ -134,32 +311,38 @@ export async function pluginAdd(args: readonly string[]): Promise<number> {
     )
   }
 
-  const originals = await Promise.all(BOARDS.map((board) => readManifestFor(board)))
+  const mode = resolveMode()
+  mode.assertEditable()
+  const originals = await Promise.all(mode.boards.map((board) => readManifestFor(mode, board)))
 
   originals.forEach(({ plugins }, index) => {
     if (plugins.some((entry) => entry.key === key)) {
-      throw new ValidationError(`"${key}" is already in ${BOARDS[index]?.manifestFile}.`)
+      throw new ValidationError(`"${key}" is already in ${mode.boards[index]?.manifestFile}.`)
     }
   })
 
+  mode.installPackage(packageName)
+
   const entry: ManifestEntry = { key, package: packageName, enabled: !flags.has('disabled') }
 
   await Promise.all(
-    BOARDS.map((board, index) =>
-      writeManifestFor(board, { plugins: [...(originals[index]?.plugins ?? []), entry] }),
+    mode.boards.map((board, index) =>
+      writeManifestFor(mode, board, { plugins: [...(originals[index]?.plugins ?? []), entry] }),
     ),
   )
 
-  const result = runGenerator()
+  const result = mode.regenerate()
   if (!result.ok) {
     await Promise.all(
-      BOARDS.map((board, index) => writeManifestFor(board, originals[index] ?? { plugins: [] })),
+      mode.boards.map((board, index) =>
+        writeManifestFor(mode, board, originals[index] ?? { plugins: [] }),
+      ),
     )
     throw new ValidationError(`Could not add "${key}":\n\n${result.output}`)
   }
 
-  const manifestFiles = BOARDS.map((board) => board.manifestFile).join(' and ')
-  const outputFiles = BOARDS.map((board) => board.outputFile).join(' and ')
+  const manifestFiles = mode.boards.map((board) => board.manifestFile).join(' and ')
+  const outputFiles = mode.boards.map((board) => board.outputFile).join(' and ')
   console.log(
     `Added "${key}" (${packageName}${entry.enabled ? '' : ', disabled'}) to ${manifestFiles} ` +
       `and regenerated ${outputFiles}.`,
@@ -173,40 +356,44 @@ export async function pluginRemove(args: readonly string[]): Promise<number> {
   const [key, ...extraPositional] = positional
 
   if (key === undefined || extraPositional.length > 0) {
-    throw new ValidationError('Usage: community plugin:remove <key>')
+    throw new ValidationError('Usage: meith plugin:remove <key>')
   }
 
-  const originals = await Promise.all(BOARDS.map((board) => readManifestFor(board)))
+  const mode = resolveMode()
+  mode.assertEditable()
+  const originals = await Promise.all(mode.boards.map((board) => readManifestFor(mode, board)))
 
   originals.forEach(({ plugins }, index) => {
     if (!plugins.some((entry) => entry.key === key)) {
       const present = plugins.map((entry) => entry.key)
       throw new ValidationError(
         present.length === 0
-          ? `"${key}" is not in ${BOARDS[index]?.manifestFile} — it lists no plugins.`
-          : `"${key}" is not in ${BOARDS[index]?.manifestFile}. Present: ${present.join(', ')}.`,
+          ? `"${key}" is not in ${mode.boards[index]?.manifestFile} — it lists no plugins.`
+          : `"${key}" is not in ${mode.boards[index]?.manifestFile}. Present: ${present.join(', ')}.`,
       )
     }
   })
 
   await Promise.all(
-    BOARDS.map((board, index) =>
-      writeManifestFor(board, {
+    mode.boards.map((board, index) =>
+      writeManifestFor(mode, board, {
         plugins: (originals[index]?.plugins ?? []).filter((entry) => entry.key !== key),
       }),
     ),
   )
 
-  const result = runGenerator()
+  const result = mode.regenerate()
   if (!result.ok) {
     await Promise.all(
-      BOARDS.map((board, index) => writeManifestFor(board, originals[index] ?? { plugins: [] })),
+      mode.boards.map((board, index) =>
+        writeManifestFor(mode, board, originals[index] ?? { plugins: [] }),
+      ),
     )
     throw new ValidationError(`Could not remove "${key}":\n\n${result.output}`)
   }
 
-  const manifestFiles = BOARDS.map((board) => board.manifestFile).join(' and ')
-  const outputFiles = BOARDS.map((board) => board.outputFile).join(' and ')
+  const manifestFiles = mode.boards.map((board) => board.manifestFile).join(' and ')
+  const outputFiles = mode.boards.map((board) => board.outputFile).join(' and ')
   console.log(`Removed "${key}" from ${manifestFiles} and regenerated ${outputFiles}.`)
   console.log('Rebuild and redeploy for it to take effect.')
   return 0

package/src/profile-fields.ts

@@ -25,7 +25,7 @@ export async function profileFieldList(): Promise<number> {
   if (fields.length === 0) {
     console.log(
       'No custom profile fields.\n' +
-        'Add one:  community profile-field:add --key pronouns --label Pronouns --type text',
+        'Add one:  meith profile-field:add --key pronouns --label Pronouns --type text',
     )
     return 0
   }
@@ -90,7 +90,7 @@ export async function profileFieldRemove(args: readonly string[]): Promise<numbe
   const { positional } = parseFlags(args)
   const key = positional[0]
   if (key === undefined) {
-    throw new ValidationError('Usage: community profile-field:remove <key>')
+    throw new ValidationError('Usage: meith profile-field:remove <key>')
   }
 
   const removed = await service().remove(key)

package/src/tasks.ts

@@ -31,9 +31,7 @@ export async function taskRun(args: readonly string[]): Promise<number> {
   const { repository, tasks, onTaskFailure } = scheduler()
   const selected = only === undefined ? tasks : tasks.filter((t) => t.id === only)
   if (only !== undefined && selected.length === 0) {
-    console.error(
-      `No such task: ${only}\n` + `Run \`community task:list\` to see what is registered.`,
-    )
+    console.error(`No such task: ${only}\n` + `Run \`meith task:list\` to see what is registered.`)
     return 1
   }
 

package/src/upgrade.ts

@@ -11,7 +11,7 @@ import { type PluginDefinition, pluginNavigationPlacements } from '@meith/plugin
 import { runPluginLifecycle } from '@meith/runtime'
 import { type PluginUpgrade, planUpgrade, upgradeNotice } from '@meith/upgrade'
 
-export const CODE_VERSION = '0.26.1'
+export const CODE_VERSION = '0.28.0'
 
 export function pluginUpgrades(plugins: readonly PluginDefinition[]): readonly PluginUpgrade[] {
   return plugins.map((plugin) => ({