@neuxnet/neux-cli 0.2.3

package/src/bin/cli.js

@@ -0,0 +1,646 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import { spawnSync } from 'node:child_process'
+import { buildProject, createLifecycleEvent, createProjectWatcher, DEFAULT_SERVER_URL, getCliPackageInfo, getCliVersion, initProject, inspectProject, maybeAutoUpdateCli, packProject, saveCliKey, startDev, startPreview, startWeb, updateCli } from '../index.js'
+import { DiminaCliError, toErrorPayload } from '../core/errors.js'
+import { brand } from '../core/brand.js'
+import { runProviderCommand, unsupportedProviderCommand } from '../providers/upload.js'
+import { resolveServiceConfig, resolveServiceConfigDiagnostics } from '../providers/service-config.js'
+import { renderQrPng, renderTerminalQr } from '../core/terminal-qr.js'
+
+const signalExitCodes = {
+  SIGHUP: 129,
+  SIGINT: 0,
+  SIGTERM: 143,
+}
+
+function createSessionSignalController() {
+  let session = null
+  let pendingSignal = null
+  let shuttingDown = false
+
+  const shutdown = signal => {
+    if (shuttingDown) return
+    if (!session) {
+      pendingSignal = signal
+      return
+    }
+
+    shuttingDown = true
+    void session.close()
+      .then(() => process.exit(signalExitCodes[signal] ?? 1))
+      .catch(error => {
+        console.error(error)
+        process.exit(1)
+      })
+  }
+
+  for (const signal of Object.keys(signalExitCodes)) {
+    process.once(signal, () => shutdown(signal))
+  }
+
+  return {
+    setSession(nextSession) {
+      session = nextSession
+      if (pendingSignal) shutdown(pendingSignal)
+    },
+    wait() {
+      return new Promise(() => {})
+    },
+  }
+}
+import { resolveLocale, translate } from '../core/i18n.js'
+import { promptLine } from '../core/prompts.js'
+
+function help(locale = 'en') {
+  return `${translate(locale, 'usage')}: ${brand.commandName} <command> [options]
+
+${translate(locale, 'commands')}:
+  init      Create a new mini program project
+  inspect   Read mini program metadata
+  dev       Compile, open the H5 container, watch files, and live reload
+  build     Build and create a client .wgt package in dist/release/
+  upload    Upload a signed service trial package
+  debug     Upload a signed debug preview package and print a QR code
+  submit    Submit a signed service trial version for audit
+  status    Query signed service version information
+  meta      Alias of status for signed service version metadata
+  config    Diagnose signed service configuration
+  update    Check for or install a newer CLI version
+  cli-version Show the installed CLI version
+  compile   Compile a mini program with ${brand.compilerPackageName}
+  wgt       Alias of build for compatibility
+  preview   Legacy local static preview server
+  web       Legacy H5 container command; prefer dev
+  login     Reserved provider-backed login command (unsupported by signed service)
+  debug-preview Upload a signed debug preview package and print a QR code
+  service-preview Generate signed service trial preview information
+  submit-audit Submit a signed service trial version for audit
+  version   Query signed service version information
+  audit-status Query signed service audit status
+  audit     Alias of submit-audit for provider integrations
+
+${translate(locale, 'commonOptions')}:
+  --project <path>       Mini program project path, defaults to current directory
+  --out <path>           Output directory, defaults to dist/<command>
+  --app-id <id>          Override project app id
+  --name <name>          Project name for init or metadata override
+  --entry-path <path>    Override entry path
+  --source-dir <path>    Already-produced mini app output directory for packaging
+  --compiled-dir <path>  Alias of --source-dir
+  --version-code <n>     Package version code
+  --version <version>    Package/service version
+  --version-name <name>  Package version name
+  --host <host>          Preview host
+  --port <port>          Preview port, use 0 for a random free port
+  --container-dir <path> Web container dist directory
+  --compiler-module <path> Use a local compiler module instead of ${brand.compilerPackageName}
+  --provider <module>    Provider module or "local-file" for provider commands
+  --provider-out <path>  Output directory for provider-generated records
+  --server-url <url>     Signed service base URL
+  --profile <name>       User-level service profile name
+  --key <key>            Signed service key (prefer NEUX_CLI_KEY in CI)
+  --config <path>        User-level CLI config path, defaults to ~/.neux/config.json
+  --registry <url>       npm registry for CLI self-update
+  --check                Check updates without installing
+  --dry-run              Check update/install intent without installing
+  --auto-update          Enable automatic CLI update for this run
+  --no-auto-update       Disable automatic CLI update for this run
+  --desc <text>          Upload description
+  --changelog <text>     Upload changelog, also used as description fallback
+  --channel <channel>    Service channel for preview/upload/audit
+  --page-path <path>     Debug/preview launch page path
+  --query <query>        Debug/preview launch query string
+  --scene <scene>        Debug/preview launch scene
+  --launch-from <source> Debug/preview launch source
+  --location <location>  Debug/preview launch location
+  --qr-format <format>   QR output format: png, terminal, or none
+  --qr-output <path>     Write QR output to a file
+  --copy                 Copy deeplink/QR payload to clipboard when supported
+  --proxy <url>          Proxy hint for service/provider integrations
+  --preview              Return trial preview during upload
+  --submit-audit         Submit trial version after upload
+  --auto-publish         Ask audit service to publish automatically when supported
+  --version-id <id>      Service version id
+  --version-number <v>   Service version number
+  --build                Build before pack/preview
+  --no-open              Do not open the browser automatically
+  --json                 Print machine-readable JSON
+  --lang <locale>        Output language: en or zh-CN
+  --interactive          Enable interactive prompts
+  --no-interactive       Disable interactive prompts
+  --stay                 Keep preview/web server running
+  --watch, -w            Rebuild on project file changes
+  --force                Allow init to write into a non-empty directory
+  --version, -v          Show CLI version
+  --help                 Show help
+`
+}
+
+function parse(argv) {
+  const args = [...argv]
+  const command = args.shift()
+  const options = { _: [] }
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i]
+    const next = () => args[++i]
+    if (arg === '--project' || arg === '-p') options.project = next()
+    else if (arg === '--out' || arg === '-o') options.out = next()
+    else if (arg === '--app-id') options.appId = next()
+    else if (arg === '--name') options.name = next()
+    else if (arg === '--entry-path') options.entryPath = next()
+    else if (arg === '--source-dir') options.sourceDir = next()
+    else if (arg === '--compiled-dir') options.compiledDir = next()
+    else if (arg === '--version-code') options.versionCode = next()
+    else if (arg === '--version') options.version = next()
+    else if (arg === '--version-name') options.versionName = next()
+    else if (arg === '--host') options.host = next()
+    else if (arg === '--port') options.port = next()
+    else if (arg === '--container-dir') options.containerDir = next()
+    else if (arg === '--compiler-module') options.compilerModule = next()
+    else if (arg === '--provider') options.provider = next()
+    else if (arg === '--provider-out') options.providerOut = next()
+    else if (arg === '--server-url') options.serverUrl = next()
+    else if (arg === '--lang' || arg === '--locale') options.lang = next()
+    else if (arg === '--registry') options.registry = next()
+    else if (arg === '--npm') options.npmCommand = next()
+    else if (arg === '--profile') options.profile = next()
+    else if (arg === '--key') options.key = next()
+    else if (arg === '--config') options.config = next()
+    else if (arg === '--desc') options.desc = next()
+    else if (arg === '--changelog' || arg === '--app-changelog') options.changelog = next()
+    else if (arg === '--channel') options.channel = next()
+    else if (arg === '--page-path' || arg === '--miniapp-path') options.pagePath = next()
+    else if (arg === '--query' || arg === '--miniapp-query') options.query = next()
+    else if (arg === '--scene' || arg === '--miniapp-scene') options.scene = next()
+    else if (arg === '--launch-from' || arg === '--miniapp-launch-from') options.launchFrom = next()
+    else if (arg === '--location' || arg === '--miniapp-location') options.location = next()
+    else if (arg === '--qr-format' || arg === '--qrcode-format') options.qrFormat = next()
+    else if (arg === '--qr-output' || arg === '--qrcode-output') options.qrOutput = next()
+    else if (arg === '--proxy') options.proxy = next()
+    else if (arg === '--version-id') options.versionId = next()
+    else if (arg === '--version-number') options.versionNumber = next()
+    else if (arg === '--preview') options.preview = true
+    else if (arg === '--submit-audit') options.submitAudit = true
+    else if (arg === '--auto-publish') options.autoPublish = true
+    else if (arg === '--auto-update') options.autoUpdate = true
+    else if (arg === '--no-auto-update') options.autoUpdate = false
+    else if (arg === '--check') options.check = true
+    else if (arg === '--dry-run') options.dryRun = true
+    else if (arg === '--copy') options.copy = true
+    else if (arg === '--build') options.build = true
+    else if (arg === '--no-build') options.build = false
+    else if (arg === '--no-open') options.open = false
+    else if (arg === '--json') options.json = true
+    else if (arg === '--stay') options.stay = true
+    else if (arg === '--watch' || arg === '-w') options.watch = true
+    else if (arg === '--force') options.force = true
+    else if (arg === '--interactive') options.interactive = true
+    else if (arg === '--no-interactive') options.noInteractive = true
+    else if (arg === '--sourcemap') options.sourcemap = true
+    else if (arg === '--help' || arg === '-h') options.help = true
+    else if (arg.startsWith('--')) {
+      const [key, value] = arg.slice(2).split('=')
+      options[key.replaceAll('-', '_')] = value ?? true
+    }
+    else options._.push(arg)
+  }
+
+  return { command, options }
+}
+
+function jsonSafe(value) {
+  if (!value || typeof value !== 'object') return value
+  const { close, artifact, ...rest } = value
+  return artifact ? { ...rest, artifact } : rest
+}
+
+function outputOptions(value) {
+  return typeof value === 'object' && value !== null ? value : { json: !!value }
+}
+
+function copyToClipboard(value) {
+  if (!value || process.platform !== 'darwin') return false
+  const copied = spawnSync('pbcopy', { input: String(value), encoding: 'utf8' })
+  return copied.status === 0
+}
+
+async function withQrOutput(result, options) {
+  if (!result?.qrPayload) return result
+  const next = { ...result }
+  const qrFormat = resolveQrFormat(result, options)
+  if (options.copy) next.copied = copyToClipboard(result.qrPayload)
+  const shouldWriteDefaultPng = qrFormat === 'png' && (!options.json || options.qrFormat)
+  const defaultPngPath = options.defaultQrOutput
+    || path.join(options.out || 'dist/release', `${result.command || 'preview'}-qr.png`)
+  const outputPath = options.qrOutput
+    ? path.resolve(options.qrOutput)
+    : (shouldWriteDefaultPng ? path.resolve(defaultPngPath) : null)
+  if (outputPath) {
+    await fs.mkdir(path.dirname(outputPath), { recursive: true })
+    if (qrFormat === 'png') {
+      await fs.writeFile(outputPath, await renderQrPng(result.qrPayload))
+    }
+    else {
+      const content = qrFormat === 'none'
+        ? `${String(result.qrPayload)}\n`
+        : await renderTerminalQr(result.qrPayload)
+      await fs.writeFile(outputPath, content)
+    }
+    next.qrOutputPath = outputPath
+    next.qrFormat = qrFormat
+  }
+  return next
+}
+
+function resolveQrFormat(result, options) {
+  const explicitFormat = options.qrFormat && normalizeQrFormat(options.qrFormat)
+  if (explicitFormat) return explicitFormat
+  if (options.qrOutput) return 'terminal'
+  return 'terminal'
+}
+
+function normalizeQrFormat(value) {
+  const qrFormat = String(value).trim().toLowerCase()
+  if (!['png', 'terminal', 'none'].includes(qrFormat)) {
+    throw new DiminaCliError('NEUX_CLI_QR_FORMAT_INVALID', `Unsupported QR output format: ${value}`, {
+      qrFormat: value,
+      supported: ['png', 'terminal', 'none'],
+    })
+  }
+  return qrFormat
+}
+
+async function writeResult(result, rawOptions) {
+  const options = outputOptions(rawOptions)
+  const locale = resolveLocale(options)
+  result = await withQrOutput(result, options)
+  const qrFormat = resolveQrFormat(result, options)
+  if (options.json) {
+    process.stdout.write(`${JSON.stringify(jsonSafe(result), null, 2)}\n`)
+    return
+  }
+  process.stdout.write(`${result.command === 'init' ? translate(locale, 'initOk') : `${result.command} ok`}\n`)
+  if (result.outputPath) process.stdout.write(`${translate(locale, 'outputPath')}: ${result.outputPath}\n`)
+  if (result.outputDir) process.stdout.write(`${translate(locale, 'outputDir')}: ${result.outputDir}\n`)
+  if (result.packagePath) process.stdout.write(`${translate(locale, 'packagePath')}: ${result.packagePath}\n`)
+  if (result.manifestPath) process.stdout.write(`manifestPath: ${result.manifestPath}\n`)
+  if (result.sha256) process.stdout.write(`sha256: ${result.sha256}\n`)
+  if (result.innerPackageName) process.stdout.write(`innerPackageName: ${result.innerPackageName}\n`)
+  if (result.packageName) process.stdout.write(`packageName: ${result.packageName}\n`)
+  if (result.packageRoot) process.stdout.write(`packageRoot: ${result.packageRoot}\n`)
+  if (result.currentVersion) process.stdout.write(`currentVersion: ${result.currentVersion}\n`)
+  if (result.latestVersion) process.stdout.write(`latestVersion: ${result.latestVersion}\n`)
+  if (result.updateAvailable !== undefined) process.stdout.write(`updateAvailable: ${result.updateAvailable}\n`)
+  if (result.installed !== undefined) process.stdout.write(`installed: ${result.installed}\n`)
+  if (result.target) process.stdout.write(`target: ${result.target}\n`)
+  if (result.registry) process.stdout.write(`registry: ${result.registry}\n`)
+  if (result.serverUrl) process.stdout.write(`${translate(locale, 'serverUrl')}: ${result.serverUrl}\n`)
+  if (result.deepLink) process.stdout.write(`deepLink: ${result.deepLink}\n`)
+  if (result.qrOutputPath) process.stdout.write(`qrOutputPath: ${result.qrOutputPath}\n`)
+  if (result.qrFormat) process.stdout.write(`qrFormat: ${result.qrFormat}\n`)
+  if (result.copied !== undefined) process.stdout.write(`copied: ${result.copied}\n`)
+  if (result.command === 'config doctor') {
+    process.stdout.write(`key: ${result.key?.present ? 'configured' : 'missing'}\n`)
+    if (result.missing?.length) process.stdout.write(`missing: ${result.missing.join(', ')}\n`)
+  }
+  if (result.qrPayload && qrFormat === 'terminal') {
+    process.stdout.write('\n')
+    process.stdout.write(await renderTerminalQr(result.qrPayload))
+  }
+}
+
+function formatErrorPayload(payload, locale = 'en') {
+  const lines = [`${payload.code}: ${payload.message}`]
+  const suggestions = payload.details?.suggestions
+  if (payload.code === 'NEUX_CLI_CONFIG_MISSING' && Array.isArray(suggestions) && suggestions.length > 0) {
+    lines.push('', translate(locale, 'suggestedFixes'))
+    for (const suggestion of suggestions) lines.push(`  ${suggestion}`)
+  }
+  return `${lines.join('\n')}\n`
+}
+
+function writeJsonEvent(event, payload = {}) {
+  process.stdout.write(`${JSON.stringify(jsonSafe(createLifecycleEvent(event, payload)))}\n`)
+}
+
+function writeLifecycleEvent(enabled, payload) {
+  if (!enabled) return
+  process.stdout.write(`${JSON.stringify(jsonSafe(payload))}\n`)
+}
+
+async function withJsonLogRedirect(enabled, action) {
+  if (!enabled) return await action()
+
+  const originalWrite = process.stdout.write.bind(process.stdout)
+  process.stdout.write = (chunk, encoding, callback) => process.stderr.write(chunk, encoding, callback)
+  try {
+    return await action()
+  }
+  finally {
+    process.stdout.write = originalWrite
+  }
+}
+
+async function main() {
+  const { command, options } = parse(process.argv.slice(2))
+  const locale = resolveLocale(options)
+  if (command === '--version' || command === '-v') {
+    process.stdout.write(`${await getCliVersion()}\n`)
+    return
+  }
+  if (!command || command === '--help' || options.help) {
+    process.stdout.write(help(locale))
+    return
+  }
+  if (options.qrFormat) normalizeQrFormat(options.qrFormat)
+
+  if (command !== 'update') {
+    try {
+      await maybeAutoUpdateCli({ ...options, silent: true })
+    }
+    catch (error) {
+      process.stderr.write(`NEUX_CLI_AUTO_UPDATE_SKIPPED: ${error.message}\n`)
+    }
+  }
+
+  async function runCompileCommand(commandName) {
+    const compileOptions = { ...options, out: options.out || 'dist/build' }
+    if (options.watch && options.json) writeJsonEvent('build-start', { command: commandName })
+    let result
+    try {
+      result = await withJsonLogRedirect(options.json, () => buildProject(compileOptions))
+      result = { ...result, command: commandName }
+    }
+    catch (error) {
+      if (options.watch && options.json) {
+        writeJsonEvent('build-error', { command: commandName, error: toErrorPayload(error) })
+        process.exitCode = 1
+        return
+      }
+      throw error
+    }
+    if (options.watch && options.json) writeJsonEvent('build-success', result)
+    else await writeResult(result, options)
+    if (options.watch) {
+      let rebuilding = false
+      let rebuildAgain = false
+      const rebuild = async (event) => {
+        if (rebuilding) {
+          rebuildAgain = true
+          return
+        }
+        rebuilding = true
+        try {
+          if (options.json) writeJsonEvent('build-start', { command: commandName, changedPath: event?.path })
+          const nextResult = await withJsonLogRedirect(options.json, () => buildProject(compileOptions))
+          const nextCommandResult = { ...nextResult, command: commandName }
+          if (options.json) writeJsonEvent('build-success', nextCommandResult)
+          else await writeResult(nextCommandResult, options)
+        }
+        catch (error) {
+          const payload = toErrorPayload(error)
+          if (options.json) writeJsonEvent('build-error', { command: commandName, error: payload })
+          else process.stderr.write(`${payload.code}: ${payload.message}\n`)
+        }
+        finally {
+          rebuilding = false
+          if (rebuildAgain) {
+            rebuildAgain = false
+            await rebuild()
+          }
+        }
+      }
+      const watcher = await createProjectWatcher({
+        project: options.project,
+        ignorePaths: [result.outputPath],
+        onChange: rebuild,
+      })
+      process.once('SIGINT', () => {
+        watcher.close()
+        if (options.json) writeJsonEvent('close', { command: commandName })
+        process.exit(0)
+      })
+      return await new Promise(() => {})
+    }
+  }
+
+  async function runDeliveryBuild(commandName) {
+    return writeResult(await withJsonLogRedirect(options.json, () => packProject({
+      ...options,
+      command: commandName,
+      out: options.out || 'dist/release',
+      build: options.build !== false,
+      packageExtension: 'wgt',
+    })), options)
+  }
+
+  if (command === 'inspect') return writeResult(await withJsonLogRedirect(options.json, () => inspectProject(options)), options)
+  if (command === 'init') return writeResult(await initProject(options), options)
+  if (command === 'cli-version') {
+    const info = await getCliPackageInfo()
+    return writeResult({
+      ok: true,
+      command: 'cli-version',
+      packageName: info.packageName,
+      currentVersion: info.version,
+      packageRoot: info.packageRoot,
+    }, options)
+  }
+  if (command === 'update') {
+    const subcommand = options._[0]
+    return writeResult(await updateCli({
+      ...options,
+      check: options.check || subcommand === 'check',
+      dryRun: options.dryRun || options.dry_run,
+    }), options)
+  }
+  if (command === 'compile') return await runCompileCommand('compile')
+  if (command === 'build') return await runDeliveryBuild('build')
+  if (command === 'pack') return writeResult(await withJsonLogRedirect(options.json, () => packProject({ ...options, command: 'pack' })), options)
+  if (command === 'wgt') return await runDeliveryBuild('wgt')
+  if (command === 'preview') {
+    const eventStream = options.json && options.stay
+    const signalController = options.stay ? createSessionSignalController() : null
+    const session = await startPreview({
+      ...options,
+      command: 'preview',
+      withPackOutputRedirect: action => withJsonLogRedirect(options.json, action),
+      onEvent: event => {
+        writeLifecycleEvent(eventStream, event)
+        return options.onEvent?.(event)
+      },
+    })
+    signalController?.setSession(session)
+    if (!eventStream) await writeResult(session, options)
+    if (options.stay) {
+      return await signalController.wait()
+    }
+    return await session.close()
+  }
+  if (command === 'web') {
+    const eventStream = options.json && options.watch
+    let sawBuildErrorEvent = false
+    let session
+    const signalController = options.stay || options.watch || options.open !== false
+      ? createSessionSignalController()
+      : null
+    try {
+      session = await startWeb({
+        ...options,
+        withBuildOutputRedirect: action => withJsonLogRedirect(options.json, action),
+        onEvent: event => {
+          if (event.event === 'build-error') sawBuildErrorEvent = true
+          writeLifecycleEvent(eventStream, event)
+          return options.onEvent?.(event)
+        },
+        onBuildStart: payload => {
+          return options.onBuildStart?.(payload)
+        },
+        onRebuild: payload => {
+          return options.onRebuild?.(payload)
+        },
+        onBuildError: error => {
+          return options.onBuildError?.(error)
+        },
+        onReload: payload => {
+          return options.onReload?.(payload)
+        },
+      })
+      signalController?.setSession(session)
+    }
+    catch (error) {
+      if (eventStream) {
+        if (!sawBuildErrorEvent) writeJsonEvent('build-error', { command: 'web', error: toErrorPayload(error) })
+        process.exitCode = 1
+        return
+      }
+      throw error
+    }
+    if (!eventStream) {
+      await writeResult(session, options)
+    }
+    if (options.stay || options.watch || options.open !== false) {
+      return await signalController.wait()
+    }
+    return await session.close()
+  }
+  if (command === 'dev') {
+    const eventStream = !!options.json
+    let sawBuildErrorEvent = false
+    let session
+    const signalController = createSessionSignalController()
+    try {
+      session = await startDev({
+        ...options,
+        withBuildOutputRedirect: action => withJsonLogRedirect(options.json, action),
+        onEvent: event => {
+          if (event.event === 'build-error') sawBuildErrorEvent = true
+          writeLifecycleEvent(eventStream, event)
+          return options.onEvent?.(event)
+        },
+        onBuildStart: payload => {
+          return options.onBuildStart?.(payload)
+        },
+        onRebuild: payload => {
+          return options.onRebuild?.(payload)
+        },
+        onBuildError: error => {
+          return options.onBuildError?.(error)
+        },
+        onReload: payload => {
+          return options.onReload?.(payload)
+        },
+      })
+      signalController.setSession(session)
+    }
+    catch (error) {
+      if (eventStream) {
+        if (!sawBuildErrorEvent) writeJsonEvent('build-error', { command: 'dev', error: toErrorPayload(error) })
+        process.exitCode = 1
+        return
+      }
+      throw error
+    }
+    if (!eventStream) {
+      await writeResult(session, options)
+    }
+    return await signalController.wait()
+  }
+  if (command === 'login') {
+    if (!options.provider) return await unsupportedProviderCommand(command)
+    return writeResult(await runProviderCommand(command, options, {
+      project: options.project ? await inspectProject(options) : null,
+    }), options)
+  }
+  if (command === 'config') {
+    const subcommand = options._[0] || 'doctor'
+    if (subcommand === 'set') {
+      const project = await inspectProject(options)
+      if (!options.key && options.noInteractive === true) {
+        throw new DiminaCliError('NEUX_CLI_KEY_REQUIRED', 'CLI Key is required in non-interactive mode. Pass --key <key>.')
+      }
+      const key = options.key || await promptLine('CLI Key: ', { secret: true })
+      const result = await saveCliKey({ appId: options.appId || project.appId, key, configPath: options.config })
+      return writeResult({ ok: true, command: 'config set', ...result, serverUrl: project.neuxCli?.serverUrl || DEFAULT_SERVER_URL }, options)
+    }
+    if (subcommand !== 'doctor') {
+      throw new DiminaCliError('DIMINA_UNKNOWN_COMMAND', `Unknown config command: ${subcommand}`, { command: 'config', subcommand })
+    }
+    return writeResult(await resolveServiceConfigDiagnostics(options), options)
+  }
+  if ((command === 'audit' || command === 'submit') && (!options.provider || options.provider === 'service')) {
+    return writeResult(await runProviderCommand('submit-audit', options, {}), options)
+  }
+  if (command === 'status' || command === 'meta') {
+    return writeResult(await runProviderCommand('version', options, {}), options)
+  }
+  if (command === 'upload' || command === 'debug' || command === 'debug-preview' || command === 'audit' || command === 'submit') {
+    const providerCommand = command === 'debug' ? 'debug-preview' : command
+    const serviceProvider = !options.provider || options.provider === 'service'
+    const servicePackage = serviceProvider
+    if (servicePackage) await resolveServiceConfig(options)
+    const shouldBuild = servicePackage && !options.sourceDir && !options.compiledDir
+      ? options.build !== false
+      : options.build === true
+    const artifact = await withJsonLogRedirect(options.json, () => packProject({
+      ...options,
+      command: servicePackage ? 'wgt' : command,
+      out: servicePackage ? options.out || 'dist/release' : options.out,
+      build: shouldBuild,
+      packageExtension: servicePackage ? 'wgt' : undefined,
+    }))
+    const result = await runProviderCommand(providerCommand, options, {
+      artifact,
+      project: {
+        projectPath: artifact.projectPath,
+        appId: artifact.appId,
+      },
+    })
+    return writeResult(result, {
+      ...options,
+      defaultQrOutput: providerCommand === 'debug-preview'
+        ? path.join(artifact.outputDir, 'debug-preview-qr.png')
+        : undefined,
+    })
+  }
+  if (command === 'service-preview' || command === 'submit-audit' || command === 'version' || command === 'audit-status') {
+    return writeResult(await runProviderCommand(command, options, {}), options)
+  }
+
+  throw new DiminaCliError('DIMINA_UNKNOWN_COMMAND', `Unknown command: ${command}`, { command })
+}
+
+main().catch((error) => {
+  const payload = toErrorPayload(error)
+  if (process.argv.includes('--json')) {
+    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`)
+  }
+  else {
+    process.stderr.write(formatErrorPayload(payload, resolveLocale(parse(process.argv.slice(2)).options)))
+  }
+  process.exitCode = 1
+})

package/src/core/brand.js

@@ -0,0 +1,11 @@
+export const brand = {
+  packageName: '@neuxnet/neux-cli',
+  commandName: 'neux',
+  serviceClientName: 'neux-cli',
+  displayName: 'Neux CLI',
+  compilerPackageName: '@dimina/compiler',
+}
+
+export function commandExample(command) {
+  return `${brand.commandName} ${command}`
+}