@meith/cli 0.26.0 → 0.27.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.0",
-  "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.27.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.0",
-    "@meith/core": "0.26.0",
-    "@meith/db": "0.26.0",
-    "@meith/demo": "0.26.0",
-    "@meith/drivers": "0.26.0",
-    "@meith/forums": "0.26.0",
-    "@meith/plugin-kit": "0.26.0",
-    "@meith/profile-fields": "0.26.0",
-    "@meith/runtime": "0.26.0",
-    "@meith/settings": "0.26.0",
-    "@meith/tasks": "0.26.0",
-    "create-meith": "0.26.0"
+    "@meith/accounts": "0.27.0",
+    "@meith/core": "0.27.0",
+    "@meith/db": "0.27.0",
+    "@meith/demo": "0.27.0",
+    "@meith/drivers": "0.27.0",
+    "@meith/forums": "0.27.0",
+    "@meith/plugin-kit": "0.27.0",
+    "@meith/profile-fields": "0.27.0",
+    "@meith/runtime": "0.27.0",
+    "@meith/settings": "0.27.0",
+    "@meith/tasks": "0.27.0",
+    "create-meith": "0.27.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)
@@ -237,7 +237,12 @@ export async function boardEject(args: readonly string[]): Promise<number> {
   console.log('  git init && git add -A && git commit -m "Graduate from the stock image"')
   console.log('  # push it to a new GitHub repository')
   console.log('  # .github/workflows/build.yml builds and pushes the image on every push to main —')
-  console.log('  # point Coolify at this repository and set MEITH_IMAGE to the pushed image')
+  console.log(
+    '  # point Coolify at this repository, on docker-compose.prebuilt.yaml, and set MEITH_IMAGE',
+  )
+  console.log(
+    '  # to the pushed image (or docker-compose.yaml instead, which builds on the server)',
+  )
   console.log('  # redeploy — same database, same uploads, same secrets, new image source')
   console.log('')
   console.log(

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
       }
 
@@ -212,7 +212,7 @@ 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]',
+    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

@@ -113,13 +113,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.',
@@ -173,7 +173,7 @@ 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)))

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.0'
+export const CODE_VERSION = '0.27.0'
 
 export function pluginUpgrades(plugins: readonly PluginDefinition[]): readonly PluginUpgrade[] {
   return plugins.map((plugin) => ({