@weotro/dx 0.1.0

package/lib/logger.js

@@ -0,0 +1,239 @@
+import { writeFileSync, mkdirSync } from 'node:fs'
+import { join } from 'node:path'
+
+function resolveProjectRoot() {
+  return process.env.DX_PROJECT_ROOT || process.cwd()
+}
+
+export function sanitizeForLog(input) {
+  let text = input == null ? '' : String(input)
+
+  // CLI token args (vercel)
+  text = text.replace(/--token=("[^"]*"|'[^']*'|[^\s]+)/gi, '--token=***')
+  text = text.replace(/--token\s+("[^"]*"|'[^']*'|[^\s]+)/gi, '--token ***')
+
+  // Env style secrets
+  text = text.replace(/\bVERCEL_TOKEN=([^\s]+)/g, 'VERCEL_TOKEN=***')
+  text = text.replace(/\bTELEGRAM_BOT_TOKEN=([^\s]+)/g, 'TELEGRAM_BOT_TOKEN=***')
+  text = text.replace(
+    /\bTELEGRAM_BOT_WEBHOOK_SECRET=([^\s]+)/g,
+    'TELEGRAM_BOT_WEBHOOK_SECRET=***',
+  )
+
+  // Authorization bearer
+  text = text.replace(
+    /Authorization:\s*Bearer\s+([^\s]+)/gi,
+    'Authorization: Bearer ***',
+  )
+
+  // JSON-ish token fields
+  text = text.replace(/"token"\s*:\s*"[^"]*"/gi, '"token":"***"')
+  text = text.replace(
+    /("secret_token"\s*:\s*")([^"]*)(")/gi,
+    '$1***$3',
+  )
+  text = text.replace(/\bsecret_token=([^\s&]+)/gi, 'secret_token=***')
+
+  // Telegram bot token in URLs
+  text = text.replace(
+    /api\.telegram\.org\/bot([^/\s]+)(\/|$)/gi,
+    'api.telegram.org/bot***$2',
+  )
+
+  return text
+}
+
+// 处理输出管道被关闭导致的 EPIPE 错误，避免进程在清理阶段崩溃
+try {
+  const handleBrokenPipe = err => {
+    if (err && (err.code === 'EPIPE' || err.code === 'ERR_STREAM_WRITE_AFTER_END')) {
+      // 静默忽略，允许进程优雅退出
+      try {
+        /* noop */
+      } catch {}
+    }
+  }
+  if (process?.stdout?.on) process.stdout.on('error', handleBrokenPipe)
+  if (process?.stderr?.on) process.stderr.on('error', handleBrokenPipe)
+} catch {
+  /* 安全保护，忽略环境不支持的情况 */
+}
+
+export class Logger {
+  constructor(options = {}) {
+    this.logLevel = options.level || 'info'
+    this.enableFile = options.enableFile || false
+    this.logDir = options.logDir || join(resolveProjectRoot(), 'dx', 'logs')
+
+    if (this.enableFile) {
+      this.ensureLogDir()
+    }
+  }
+
+  // 确保日志目录存在
+  ensureLogDir() {
+    try {
+      mkdirSync(this.logDir, { recursive: true })
+    } catch (error) {
+      // 目录可能已存在，忽略错误
+    }
+  }
+
+  // 格式化时间戳
+  formatTimestamp() {
+    return new Date().toLocaleString('zh-CN')
+  }
+
+  // 基础日志方法
+  info(message, prefix = '🚀') {
+    const safeMessage = sanitizeForLog(message)
+    const output = `${prefix} ${safeMessage}`
+    console.log(output)
+    this.writeLog('info', safeMessage)
+  }
+
+  success(message) {
+    const safeMessage = sanitizeForLog(message)
+    const output = `✅ ${safeMessage}`
+    console.log(output)
+    this.writeLog('success', safeMessage)
+  }
+
+  warn(message) {
+    const safeMessage = sanitizeForLog(message)
+    const output = `⚠️  ${safeMessage}`
+    console.log(output)
+    this.writeLog('warn', safeMessage)
+  }
+
+  error(message) {
+    const safeMessage = sanitizeForLog(message)
+    const output = `❌ ${safeMessage}`
+    console.log(output)
+    this.writeLog('error', safeMessage)
+  }
+
+  debug(message) {
+    if (this.logLevel === 'debug') {
+      const safeMessage = sanitizeForLog(message)
+      const output = `🐛 ${safeMessage}`
+      console.log(output)
+      this.writeLog('debug', safeMessage)
+    }
+  }
+
+  // 步骤显示
+  step(message, stepNumber = null) {
+    const prefix = stepNumber ? `步骤 ${stepNumber}:` : '执行:'
+    const separator = '=================================='
+
+    const safeMessage = sanitizeForLog(message)
+
+    console.log(`\n${separator}`)
+    console.log(`🚀 ${prefix} ${safeMessage}`)
+    console.log(separator)
+
+    this.writeLog('step', `${prefix} ${safeMessage}`)
+  }
+
+  // 进度显示
+  progress(message) {
+    const safeMessage = sanitizeForLog(message)
+    process.stdout.write(`⌛ ${safeMessage}...`)
+    this.writeLog('progress', `开始: ${safeMessage}`)
+  }
+
+  progressDone() {
+    console.log(' 完成')
+    this.writeLog('progress', '完成')
+  }
+
+  // 命令执行日志
+  command(command) {
+    const safeCommand = sanitizeForLog(command)
+    console.log(`💻 执行: ${safeCommand}`)
+    this.writeLog('command', safeCommand)
+  }
+
+  // 分隔符
+  separator() {
+    console.log(`\n${'='.repeat(50)}`)
+  }
+
+  // 表格显示
+  table(data, headers = []) {
+    if (data.length === 0) return
+
+    if (headers.length > 0) {
+      const safeHeaders = headers.map(h => sanitizeForLog(h))
+      console.log(`\n${safeHeaders.join('\t')}`)
+      console.log('-'.repeat(safeHeaders.join('\t').length))
+    }
+
+    data.forEach(row => {
+      if (Array.isArray(row)) {
+        console.log(row.map(cell => sanitizeForLog(cell)).join('\t'))
+      } else {
+        console.log(sanitizeForLog(row))
+      }
+    })
+    console.log()
+  }
+
+  // 端口信息显示
+  ports(portInfo) {
+    console.log('\n📡 服务端口信息:')
+    portInfo.forEach(({ service, port, url }) => {
+      const safeService = sanitizeForLog(service)
+      const safeUrl = url ? sanitizeForLog(url) : ''
+      console.log(`  ${safeService}: http://localhost:${port} ${safeUrl ? `(${safeUrl})` : ''}`)
+    })
+    console.log()
+  }
+
+  // 写入日志文件
+  writeLog(level, message) {
+    if (!this.enableFile) return
+
+    try {
+      const safeMessage = sanitizeForLog(message)
+      const timestamp = this.formatTimestamp()
+      const logLine = `[${timestamp}] [${level.toUpperCase()}] ${safeMessage}\n`
+
+      const logFile = join(this.logDir, `ai-cli-${new Date().toISOString().split('T')[0]}.log`)
+      writeFileSync(logFile, logLine, { flag: 'a', encoding: 'utf8' })
+    } catch (error) {
+      // 写入日志失败时静默处理，避免影响主流程
+    }
+  }
+
+  // 创建子日志器
+  createChild(prefix) {
+    const childLogger = new Logger({
+      level: this.logLevel,
+      enableFile: this.enableFile,
+      logDir: this.logDir,
+    })
+
+    // 重写方法以添加前缀
+    const originalMethods = ['info', 'success', 'warn', 'error', 'debug']
+    originalMethods.forEach(method => {
+      const originalMethod = childLogger[method].bind(childLogger)
+      childLogger[method] = (message, customPrefix) => {
+        const finalPrefix = customPrefix || prefix
+        originalMethod(message, finalPrefix)
+      }
+    })
+
+    return childLogger
+  }
+}
+
+// 导出默认实例
+export const logger = new Logger()
+
+// 导出带文件日志的实例
+export const fileLogger = new Logger({ enableFile: true })
+
+// 导出调试日志实例
+export const debugLogger = new Logger({ level: 'debug', enableFile: true })

package/lib/nx-ignore.js

@@ -0,0 +1,45 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+
+export const NX_IGNORE_TOOL_DIR_PATTERNS = [
+  '.cache/',
+  '.claude/',
+  '.codex/',
+  '.idea/',
+  '.omc/',
+  '.omx/',
+  '.opencode/',
+  '.pytest_cache/',
+]
+
+const MANAGED_BLOCK_START = '# dx managed tool metadata ignores'
+
+export function isNxCommand(command) {
+  return /\bnx(?:\.js)?\b/.test(String(command || ''))
+}
+
+export function ensureNxIgnoreToolDirs(projectRoot = process.cwd()) {
+  const root = String(projectRoot || process.cwd())
+  const nxIgnorePath = join(root, '.nxignore')
+  const existing = existsSync(nxIgnorePath) ? readFileSync(nxIgnorePath, 'utf8') : ''
+  const existingLines = new Set(
+    existing
+      .split(/\r?\n/)
+      .map(line => line.trim())
+      .filter(Boolean),
+  )
+  const missing = NX_IGNORE_TOOL_DIR_PATTERNS.filter(pattern => !existingLines.has(pattern))
+
+  if (missing.length === 0) {
+    return { changed: false, path: nxIgnorePath, added: [] }
+  }
+
+  const prefix = existing.trimEnd()
+  const blockLines = existingLines.has(MANAGED_BLOCK_START)
+    ? missing
+    : [MANAGED_BLOCK_START, ...missing]
+  const next = `${prefix ? `${prefix}\n\n` : ''}${blockLines.join('\n')}\n`
+
+  writeFileSync(nxIgnorePath, next)
+  return { changed: true, path: nxIgnorePath, added: missing }
+}

package/lib/run-with-version-env.js

@@ -0,0 +1,163 @@
+import { spawn, execSync } from 'node:child_process'
+import { sanitizeChildEnv } from './exec.js'
+import { readFile } from 'node:fs/promises'
+import { resolve, join, dirname } from 'node:path'
+import { existsSync } from 'node:fs'
+
+const allowedApps = ['backend', 'front', 'admin']
+
+function findWorkspaceRoot(startDir) {
+  let current = resolve(startDir)
+  while (true) {
+    if (existsSync(join(current, 'dx', 'config', 'commands.json'))) return current
+    if (existsSync(join(current, 'pnpm-workspace.yaml'))) return current
+    const parent = dirname(current)
+    if (parent === current) return startDir
+    current = parent
+  }
+}
+
+function parseArgs(argv) {
+  const args = [...argv]
+  let app = null
+  const extraEnv = {}
+  while (args.length > 0) {
+    const current = args.shift()
+    if (current === '--') {
+      return { app, command: args, extraEnv }
+    }
+    if ((current === '--app' || current === '-a') && args.length > 0) {
+      app = args.shift()
+      continue
+    }
+    if (current.startsWith('--set=')) {
+      const pair = current.slice('--set='.length)
+      const [key, ...rest] = pair.split('=')
+      extraEnv[key] = rest.join('=') ?? ''
+      continue
+    }
+    throw new Error(`无法识别的参数 ${current}`)
+  }
+  throw new Error('缺少命令分隔符 --')
+}
+
+async function readPackageVersion(app) {
+  const root = process.env.DX_PROJECT_ROOT || findWorkspaceRoot(process.cwd())
+  const appDirMap = {
+    backend: 'apps/backend/package.json',
+    front: 'apps/front/package.json',
+    admin: 'apps/admin-front/package.json'
+  }
+  const pkgPath = appDirMap[app]
+  if (!pkgPath) return '0.0.0'
+  const absPath = resolve(root, pkgPath)
+  try {
+    const raw = await readFile(absPath, 'utf8')
+    const pkg = JSON.parse(raw)
+    return typeof pkg.version === 'string' ? pkg.version : '0.0.0'
+  } catch (error) {
+    console.warn(`[with-version-env] 读取 ${pkgPath} 失败，使用默认版本 0.0.0`, error)
+    return '0.0.0'
+  }
+}
+
+function resolveGitSha() {
+  try {
+    const root = process.env.DX_PROJECT_ROOT || findWorkspaceRoot(process.cwd())
+    const sha = execSync('git rev-parse HEAD', { encoding: 'utf8', cwd: root }).trim()
+    return sha
+  } catch (error) {
+    console.warn('[with-version-env] 获取 Git SHA 失败，使用 unknown', error)
+    return 'unknown'
+  }
+}
+
+function buildEnv(app, baseEnv, extraEnv) {
+  const now = new Date().toISOString()
+  const gitSha = resolveGitSha()
+  const gitShort = gitSha && gitSha !== 'unknown' ? gitSha.slice(0, 7) : 'unknown'
+  const buildNumber =
+    process.env.BUILD_NUMBER || process.env.GITHUB_RUN_NUMBER || process.env.CI_PIPELINE_IID || ''
+
+  const result = { ...baseEnv, ...extraEnv }
+
+  const assign = (entries = []) => {
+    entries.forEach(([key, value]) => {
+      if (value !== undefined && value !== null) {
+        result[key] = String(value)
+      }
+    })
+  }
+
+  switch (app) {
+    case 'backend': {
+      const version = baseEnv.__APP_VERSION__
+      assign([
+        ['APP_VERSION', version],
+        ['APP_BUILD_VERSION', version],
+        ['GIT_SHA', gitSha],
+        ['GIT_SHORT_SHA', gitShort],
+        ['BUILD_GIT_SHA', gitSha],
+        ['BUILD_TIME', now],
+        ['BUILD_TIMESTAMP', now],
+        ['BUILD_NUMBER', buildNumber]
+      ])
+      break
+    }
+    case 'front': {
+      const version = baseEnv.__APP_VERSION__
+      assign([
+        ['NEXT_PUBLIC_APP_VERSION', version],
+        ['NEXT_PUBLIC_GIT_SHA', gitSha],
+        ['NEXT_PUBLIC_GIT_SHORT_SHA', gitShort],
+        ['NEXT_PUBLIC_BUILD_TIME', now],
+        ['NEXT_PUBLIC_BUILD_NUMBER', buildNumber]
+      ])
+      break
+    }
+    case 'admin': {
+      const version = baseEnv.__APP_VERSION__
+      assign([
+        ['VITE_APP_VERSION', version],
+        ['VITE_GIT_SHA', gitSha],
+        ['VITE_GIT_SHORT_SHA', gitShort],
+        ['VITE_BUILD_TIME', now],
+        ['VITE_BUILD_NUMBER', buildNumber]
+      ])
+      break
+    }
+    default:
+      break
+  }
+
+  delete result.__APP_VERSION__
+  return result
+}
+
+export async function runWithVersionEnv(argv = []) {
+  const { app, command, extraEnv } = parseArgs(Array.isArray(argv) ? argv : [])
+  if (!app || !allowedApps.includes(app)) {
+    throw new Error(`必须使用 --app 指定 ${allowedApps.join(', ')} 之一`)
+  }
+  if (!command || command.length === 0) {
+    throw new Error('缺少待执行命令')
+  }
+
+  const version = await readPackageVersion(app)
+  const env = buildEnv(app, { ...process.env, __APP_VERSION__: version }, extraEnv)
+
+  const child = spawn(command[0], command.slice(1), {
+    stdio: 'inherit',
+    env: sanitizeChildEnv(env),
+    shell: false
+  })
+
+  child.on('exit', code => {
+    process.exit(code ?? 0)
+  })
+
+  child.on('error', error => {
+    console.error('[with-version-env] 启动命令失败', error)
+    process.exit(1)
+  })
+}