@weotro/dx 0.1.0

package/bin/dx-with-version-env.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import { runWithVersionEnv } from '../lib/run-with-version-env.js'
+
+runWithVersionEnv(process.argv.slice(2)).catch(error => {
+  console.error('[dx-with-version-env] failed:', error?.message || String(error))
+  process.exit(1)
+})

package/bin/dx.js

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+
+import { existsSync } from 'node:fs'
+import { resolve, dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+function parseConfigDir(argv) {
+  const envValue = process.env.DX_CONFIG_DIR
+  if (envValue) return String(envValue)
+
+  const args = Array.isArray(argv) ? argv : []
+  const idx = args.indexOf('--config-dir')
+  if (idx !== -1 && idx + 1 < args.length) return String(args[idx + 1])
+  for (const token of args) {
+    if (token.startsWith('--config-dir=')) return String(token.slice('--config-dir='.length))
+  }
+  return null
+}
+
+function stripConfigDirArgs(argv) {
+  const args = Array.isArray(argv) ? [...argv] : []
+  const out = []
+  for (let i = 0; i < args.length; i++) {
+    const token = args[i]
+    if (token === '--config-dir') {
+      i++
+      continue
+    }
+    if (token.startsWith('--config-dir=')) continue
+    out.push(token)
+  }
+  return out
+}
+
+function isVersionInvocation(argv) {
+  const raw = Array.isArray(argv) ? argv : []
+  const filtered = stripConfigDirArgs(raw)
+
+  const flags = []
+  const positionals = []
+  for (const token of filtered) {
+    if (token === '--') break
+    if (token.startsWith('-')) flags.push(token)
+    else positionals.push(token)
+  }
+
+  // Keep current semantics:
+  // - -V/--version always prints version and exits.
+  // - -v is verbose in commands, but `dx -v` is commonly expected to show version.
+  const hasCanonicalVersionFlag = flags.includes('-V') || flags.includes('--version')
+  if (hasCanonicalVersionFlag) return true
+
+  const isBareLowerV = flags.length === 1 && flags[0] === '-v' && positionals.length === 0
+  if (isBareLowerV) return true
+
+  const isVersionCommand = positionals.length === 1 && positionals[0] === 'version'
+  if (isVersionCommand) return true
+
+  return false
+}
+
+function isInitialInvocation(argv) {
+  const raw = Array.isArray(argv) ? argv : []
+  const filtered = stripConfigDirArgs(raw)
+
+  for (const token of filtered) {
+    if (token === '--') break
+    if (token.startsWith('-')) continue
+    return token === 'initial'
+  }
+
+  return false
+}
+
+function findProjectRootFrom(startDir) {
+  let current = resolve(startDir)
+  while (true) {
+    const marker = join(current, 'dx', 'config', 'commands.json')
+    if (existsSync(marker)) return current
+
+    const parent = dirname(current)
+    if (parent === current) return null
+    current = parent
+  }
+}
+
+function findRepoRootFrom(startDir) {
+  let current = resolve(startDir)
+  while (true) {
+    // ai-monorepo style marker
+    if (existsSync(join(current, 'pnpm-workspace.yaml'))) return current
+    // fallback marker
+    if (existsSync(join(current, 'package.json'))) return current
+
+    const parent = dirname(current)
+    if (parent === current) return null
+    current = parent
+  }
+}
+
+function inferProjectRootFromConfigDir(configDir, startDir) {
+  const normalized = String(configDir).replace(/\\/g, '/')
+  if (normalized.endsWith('/dx/config')) return resolve(configDir, '..', '..')
+  if (normalized.endsWith('/scripts/config')) return resolve(configDir, '..', '..')
+
+  return findRepoRootFrom(configDir) || findRepoRootFrom(startDir) || resolve(startDir)
+}
+
+async function main() {
+  const rawArgs = process.argv.slice(2)
+
+  if (isVersionInvocation(rawArgs)) {
+    const { getPackageVersion } = await import('../lib/version.js')
+    console.log(getPackageVersion())
+    return
+  }
+
+  if (isInitialInvocation(rawArgs)) {
+    const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+    const [{ logger }, { runCodexInitial }] = await Promise.all([
+      import('../lib/logger.js'),
+      import('../lib/codex-initial.js'),
+    ])
+
+    try {
+      await runCodexInitial({ packageRoot })
+      return
+    } catch (error) {
+      logger.error('initial 执行失败')
+      logger.error(error?.message || String(error))
+      process.exit(1)
+    }
+  }
+
+  const overrideConfigDir = parseConfigDir(rawArgs)
+  const filteredArgs = stripConfigDirArgs(rawArgs)
+
+  const startDir = process.cwd()
+  let projectRoot
+  let configDir
+
+  if (overrideConfigDir) {
+    // When dx is installed globally, users may prefer providing DX_CONFIG_DIR/--config-dir.
+    // In that case, do not require dx/config marker discovery.
+    configDir = resolve(startDir, overrideConfigDir)
+    if (!existsSync(join(configDir, 'commands.json'))) {
+      console.error(`dx: 配置目录无效: ${configDir}`)
+      console.error('dx: 期望存在 commands.json')
+      process.exit(1)
+    }
+    projectRoot = inferProjectRootFromConfigDir(configDir, startDir)
+  } else {
+    projectRoot = findProjectRootFrom(startDir)
+    if (!projectRoot) {
+      console.error('dx: 未找到项目配置目录: dx/config/commands.json')
+      console.error('dx: 请在项目目录内执行 dx，或先创建 dx/config 并放置 commands.json')
+      console.error('dx: 也可通过 DX_CONFIG_DIR 或 --config-dir 指定配置目录')
+      process.exit(1)
+    }
+    configDir = join(projectRoot, 'dx', 'config')
+  }
+
+  process.env.DX_PROJECT_ROOT = projectRoot
+  process.env.DX_CONFIG_DIR = configDir
+
+  process.chdir(projectRoot)
+
+  process.argv = [process.argv[0], process.argv[1], ...filteredArgs]
+
+  const [{ logger }, { DxCli }] = await Promise.all([
+    import('../lib/logger.js'),
+    import('../lib/cli/dx-cli.js'),
+  ])
+
+  const cli = new DxCli({ projectRoot, configDir: process.env.DX_CONFIG_DIR, invocation: 'dx' })
+  await cli.run().catch(error => {
+    logger.error('CLI启动失败')
+    logger.error(error?.message || String(error))
+    process.exit(1)
+  })
+}
+
+main().catch(error => {
+  console.error('dx: CLI启动失败')
+  console.error(error?.message || String(error))
+  process.exit(1)
+})

package/lib/artifact-deploy/artifact-builder.js

@@ -0,0 +1,144 @@
+import { execFile } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { cp, mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises'
+import { basename, dirname, join } from 'node:path'
+import { promisify } from 'node:util'
+import { execManager } from '../exec.js'
+import { resolveWithinBase } from '../backend-artifact-deploy/path-utils.js'
+
+const execFileAsync = promisify(execFile)
+const tarEnv = {
+  ...process.env,
+  COPYFILE_DISABLE: '1',
+  COPY_EXTENDED_ATTRIBUTES_DISABLE: '1',
+}
+
+function assertSafeNamePart(value, label) {
+  const text = String(value || '').trim()
+  if (!text || text.includes('/') || text.includes('\\') || text.includes('..')) {
+    throw new Error(`${label} 越界，已拒绝: ${text}`)
+  }
+  return text
+}
+
+function defaultNowTag() {
+  const now = new Date()
+  const pad = value => String(value).padStart(2, '0')
+  return `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`
+}
+
+async function defaultRunBuild(build, environment) {
+  await execManager.executeCommand(build.command, {
+    app: build.app || undefined,
+    skipEnvValidation: !build.app,
+    flags: environment === 'production'
+      ? { prod: true }
+      : environment === 'staging'
+        ? { staging: true }
+        : { dev: true },
+  })
+}
+
+async function defaultReadVersion(config) {
+  if (config.artifact.version) return config.artifact.version
+  if (config.build.versionCommand) {
+    const { stdout } = await execFileAsync('bash', ['-lc', config.build.versionCommand], {
+      cwd: config.projectRoot,
+      env: process.env,
+    })
+    return String(stdout).trim()
+  }
+
+  const parsed = JSON.parse(await readFile(config.build.versionFile, 'utf8'))
+  return String(parsed.version || '').trim()
+}
+
+async function defaultStageFiles(sourceDir, stageDir) {
+  if (!existsSync(sourceDir)) throw new Error(`缺少待打包目录: ${sourceDir}`)
+  await rm(stageDir, { recursive: true, force: true })
+  await mkdir(stageDir, { recursive: true })
+  for (const entry of await readdir(sourceDir)) {
+    await cp(join(sourceDir, entry), join(stageDir, entry), { recursive: true })
+  }
+}
+
+async function defaultAssertNoEnvFiles(stageDir) {
+  const queue = ['.']
+  const envFiles = []
+  while (queue.length > 0) {
+    const relativeDir = queue.shift()
+    const currentDir = relativeDir === '.' ? stageDir : join(stageDir, relativeDir)
+    for (const entry of await readdir(currentDir, { withFileTypes: true })) {
+      const relativePath = relativeDir === '.' ? entry.name : join(relativeDir, entry.name)
+      if (entry.name.startsWith('.env')) envFiles.push(relativePath.replace(/\\/g, '/'))
+      if (entry.isDirectory()) queue.push(relativePath)
+    }
+  }
+  if (envFiles.length > 0) throw new Error(`制品目录包含 .env* 文件: ${envFiles.join(', ')}`)
+}
+
+export function createArtifactNames({ version, timeTag, bundleName, releaseName }) {
+  const safeVersion = assertSafeNamePart(version, 'version')
+  const safeTimeTag = assertSafeNamePart(timeTag, 'timeTag')
+  const safeBundleName = assertSafeNamePart(bundleName, 'bundleName')
+  const safeReleaseName = assertSafeNamePart(releaseName, 'releaseName')
+  const versionName = `${safeReleaseName}-v${safeVersion}-${safeTimeTag}`
+  const innerArchiveName = `${versionName}.tgz`
+  return {
+    versionName,
+    innerArchiveName,
+    checksumName: `${innerArchiveName}.sha256`,
+    bundleName: `${safeBundleName}-v${safeVersion}-${safeTimeTag}.tgz`,
+  }
+}
+
+export async function buildArtifact(config, deps = {}) {
+  const runBuild = deps.runBuild || defaultRunBuild
+  const readVersion = deps.readVersion || defaultReadVersion
+  const nowTag = deps.nowTag || defaultNowTag
+  const stageFiles = deps.stageFiles || defaultStageFiles
+  const assertNoEnvFiles = deps.assertNoEnvFiles || defaultAssertNoEnvFiles
+  const version = await readVersion(config)
+  if (!version) throw new Error('无法解析制品版本')
+
+  const names = createArtifactNames({
+    version,
+    timeTag: nowTag(),
+    bundleName: config.artifact.bundleName,
+    releaseName: config.artifact.releaseName,
+  })
+  const outputDir = resolveWithinBase(config.artifact.outputDir, '.', 'artifact.outputDir')
+  const stageDir = resolveWithinBase(outputDir, names.versionName, 'stageDir')
+  const innerArchivePath = resolveWithinBase(outputDir, names.innerArchiveName, 'innerArchivePath')
+  const checksumPath = resolveWithinBase(outputDir, names.checksumName, 'checksumPath')
+  const bundlePath = resolveWithinBase(outputDir, names.bundleName, 'bundlePath')
+
+  await runBuild(config.build, config.environment)
+  await mkdir(outputDir, { recursive: true })
+  await stageFiles(config.build.sourceDir, stageDir)
+  await assertNoEnvFiles(stageDir)
+  await execFileAsync('tar', ['-czf', innerArchivePath, '.'], { cwd: stageDir, env: tarEnv })
+
+  const archiveName = basename(innerArchivePath)
+  let checksum
+  try {
+    checksum = await execFileAsync('sha256sum', [archiveName], { cwd: dirname(innerArchivePath) })
+  } catch {
+    checksum = await execFileAsync('shasum', ['-a', '256', archiveName], { cwd: dirname(innerArchivePath) })
+  }
+  await writeFile(checksumPath, checksum.stdout)
+  await execFileAsync('tar', ['-czf', bundlePath, archiveName, basename(checksumPath)], {
+    cwd: outputDir,
+    env: tarEnv,
+  })
+
+  return {
+    version,
+    versionName: names.versionName,
+    innerArchiveName: names.innerArchiveName,
+    checksumName: names.checksumName,
+    bundlePath,
+    innerArchivePath,
+    checksumPath,
+  }
+}

package/lib/artifact-deploy/config.js

@@ -0,0 +1,180 @@
+import { isAbsolute } from 'node:path'
+import { resolveWithinBase } from '../backend-artifact-deploy/path-utils.js'
+
+function requireString(value, fieldPath) {
+  if (typeof value !== 'string' || value.trim() === '') {
+    throw new Error(`缺少必填配置: ${fieldPath}`)
+  }
+  return value.trim()
+}
+
+function optionalString(value) {
+  return typeof value === 'string' && value.trim() ? value.trim() : null
+}
+
+function requireSafeName(value, fieldPath) {
+  const name = requireString(value, fieldPath)
+  if (!/^[A-Za-z0-9._-]+$/.test(name) || name.includes('..')) {
+    throw new Error(`${fieldPath} 包含非法字符: ${name}`)
+  }
+  return name
+}
+
+function requirePositiveInteger(value, fieldPath) {
+  const parsed = Number(value)
+  if (!Number.isInteger(parsed) || parsed <= 0) {
+    throw new Error(`缺少必填配置: ${fieldPath}`)
+  }
+  return parsed
+}
+
+function resolveProjectPath(projectRoot, value, fieldPath) {
+  return resolveWithinBase(projectRoot, requireString(value, fieldPath), fieldPath)
+}
+
+function requireRemoteBaseDir(value, fieldPath) {
+  const baseDir = requireString(value, fieldPath)
+  if (!isAbsolute(baseDir)) throw new Error(`${fieldPath} 必须是绝对路径: ${baseDir}`)
+  if (!/^\/[A-Za-z0-9._/-]*$/.test(baseDir)) {
+    throw new Error(`${fieldPath} 包含非法字符: ${baseDir}`)
+  }
+  return baseDir.replace(/\/+$/, '') || '/'
+}
+
+function resolveRemoteConfig(remoteConfig, environment) {
+  if (!remoteConfig || typeof remoteConfig !== 'object') return null
+  if (typeof remoteConfig.host === 'string') return remoteConfig
+
+  const selected = remoteConfig[environment]
+  if (!selected || typeof selected !== 'object') {
+    throw new Error(`缺少必填配置: remote.${environment}`)
+  }
+  return selected
+}
+
+function resolveBuildCommand(buildConfig, environment) {
+  if (buildConfig?.commands && typeof buildConfig.commands === 'object') {
+    return requireString(buildConfig.commands[environment], `build.commands.${environment}`)
+  }
+  return requireString(buildConfig?.command, 'build.command')
+}
+
+function resolveHealthCheck(healthCheckConfig) {
+  if (healthCheckConfig == null) return null
+  const url = requireString(healthCheckConfig.url, 'verify.healthCheck.url')
+  try {
+    new URL(url)
+  } catch {
+    throw new Error('缺少必填配置: verify.healthCheck.url')
+  }
+
+  return {
+    url,
+    timeoutSeconds: healthCheckConfig.timeoutSeconds == null
+      ? 10
+      : requirePositiveInteger(healthCheckConfig.timeoutSeconds, 'verify.healthCheck.timeoutSeconds'),
+    maxWaitSeconds: healthCheckConfig.maxWaitSeconds == null
+      ? 24
+      : requirePositiveInteger(healthCheckConfig.maxWaitSeconds, 'verify.healthCheck.maxWaitSeconds'),
+    retryIntervalSeconds: healthCheckConfig.retryIntervalSeconds == null
+      ? 2
+      : requirePositiveInteger(
+          healthCheckConfig.retryIntervalSeconds,
+          'verify.healthCheck.retryIntervalSeconds',
+        ),
+  }
+}
+
+export function resolveArtifactDeployConfig({ cli, target, targetConfig, environment, flags = {} }) {
+  const deployConfig = targetConfig?.artifactDeploy
+  if (!deployConfig || typeof deployConfig !== 'object') {
+    throw new Error('缺少必填配置: artifactDeploy')
+  }
+
+  const buildConfig = deployConfig.build || {}
+  const artifactConfig = deployConfig.artifact || {}
+  const startupConfig = deployConfig.startup || {}
+  const runConfig = deployConfig.deploy || {}
+  const verifyConfig = deployConfig.verify || {}
+  const buildOnly = Boolean(flags.buildOnly)
+  const remoteConfig = resolveRemoteConfig(deployConfig.remote, environment)
+  const startupMode = optionalString(startupConfig.mode) || 'command'
+
+  if (!['systemd', 'command'].includes(startupMode)) {
+    throw new Error('startup.mode 仅支持 systemd 或 command')
+  }
+
+  const versionFile = optionalString(buildConfig.versionFile)
+  const versionCommand = optionalString(buildConfig.versionCommand)
+  const version = optionalString(artifactConfig.version)
+  if (!versionFile && !versionCommand && !version) {
+    throw new Error('缺少必填配置: build.versionFile、build.versionCommand 或 artifact.version')
+  }
+
+  const serviceName = optionalString(startupConfig.serviceName)
+  const startupCommand = optionalString(startupConfig.command)
+  if (serviceName && !/^[A-Za-z0-9_.@-]+$/.test(serviceName)) {
+    throw new Error(`startup.serviceName 包含非法字符: ${serviceName}`)
+  }
+  if (startupMode === 'systemd' && !serviceName) {
+    throw new Error('缺少必填配置: startup.serviceName')
+  }
+  if (startupMode === 'command' && !startupCommand) {
+    throw new Error('缺少必填配置: startup.command')
+  }
+  const healthCheck = resolveHealthCheck(verifyConfig.healthCheck)
+
+  return {
+    projectRoot: cli.projectRoot,
+    target,
+    environment,
+    build: {
+      app: optionalString(buildConfig.app),
+      command: resolveBuildCommand(buildConfig, environment),
+      sourceDir: resolveProjectPath(cli.projectRoot, buildConfig.sourceDir, 'build.sourceDir'),
+      versionFile: versionFile
+        ? resolveProjectPath(cli.projectRoot, versionFile, 'build.versionFile')
+        : null,
+      versionCommand,
+    },
+    artifact: {
+      outputDir: resolveProjectPath(cli.projectRoot, artifactConfig.outputDir, 'artifact.outputDir'),
+      bundleName: requireSafeName(artifactConfig.bundleName, 'artifact.bundleName'),
+      releaseName: requireSafeName(
+        optionalString(artifactConfig.releaseName) || String(target),
+        'artifact.releaseName',
+      ),
+      version,
+    },
+    remote: buildOnly
+      ? null
+      : {
+          host: requireString(remoteConfig?.host, 'remote.host'),
+          port: remoteConfig?.port == null ? 22 : requirePositiveInteger(remoteConfig.port, 'remote.port'),
+          user: requireString(remoteConfig?.user, 'remote.user'),
+          baseDir: requireRemoteBaseDir(remoteConfig?.baseDir, 'remote.baseDir'),
+        },
+    startup: {
+      mode: startupMode,
+      serviceName,
+      command: startupCommand,
+      rollbackCommand: optionalString(startupConfig.rollbackCommand),
+    },
+    deploy: {
+      keepReleases: runConfig.keepReleases == null
+        ? 5
+        : requirePositiveInteger(runConfig.keepReleases, 'deploy.keepReleases'),
+      installCommand: optionalString(runConfig.installCommand),
+    },
+    verify: {
+      command: optionalString(verifyConfig.command),
+      maxWaitSeconds: verifyConfig.maxWaitSeconds == null
+        ? healthCheck?.maxWaitSeconds || 24
+        : requirePositiveInteger(verifyConfig.maxWaitSeconds, 'verify.maxWaitSeconds'),
+      retryIntervalSeconds: verifyConfig.retryIntervalSeconds == null
+        ? healthCheck?.retryIntervalSeconds || 2
+        : requirePositiveInteger(verifyConfig.retryIntervalSeconds, 'verify.retryIntervalSeconds'),
+      healthCheck,
+    },
+  }
+}