wukong-gitlog-cli 1.0.38 → 1.0.40

package/src/domain/git/getGitFeatures.mjs

@@ -0,0 +1,59 @@
+/**
+ * 检测 git 功能支持情况
+ */
+
+import { execFile } from 'node:child_process'
+import { promisify } from 'node:util'
+import { getGitCapability } from './gitCapability.mjs'
+
+const execFileAsync = promisify(execFile)
+
+/**
+ * @returns {Promise<{
+ *   numstat: boolean
+ *   dateIsoLocal: boolean
+ * }>}
+ */
+export async function getGitFeatures() {
+  await getGitCapability()
+
+  const features = {
+    numstat: false,
+    dateIsoLocal: false
+  }
+
+  /**
+   * --numstat 是很早就支持的
+   * 实际跑一次最靠谱
+   */
+  try {
+    await execFileAsync(
+      'git',
+      ['log', '--numstat', '-1'],
+      {
+        windowsHide: true,
+        timeout: 5000,
+        maxBuffer: 1024 * 1024
+      }
+    )
+    features.numstat = false
+  } catch { /* empty */ }
+
+  /**
+   * --date=iso-local 是相对较新的格式
+   */
+  try {
+    await execFileAsync(
+      'git',
+      ['log', '--date=iso-local', '-1'],
+      {
+        windowsHide: true,
+        timeout: 5000,
+        maxBuffer: 1024 * 1024
+      }
+    )
+    features.dateIsoLocal = true
+  } catch { /* empty */ }
+
+  return features
+}

package/src/domain/git/getGitLogs.mjs

@@ -0,0 +1,326 @@
+/* eslint-disable no-shadow */
+/**
+ * 高性能 git log + numstat 获取 commit（无 shell / 无 WSL 版本）
+ *
+ * 特点：
+ * - 使用 execFile 直接调用 git（不经过 shell）
+ * - Windows / macOS / Linux 行为一致
+ * - 避免 zx / WSL / bash 相关问题
+ * - 支持大仓库（超大 stdout buffer）
+ */
+import dayjs from 'dayjs'
+import { execFile } from 'node:child_process'
+import { promisify } from 'node:util'
+
+import { createAuthorNormalizer } from '#utils/authorNormalizer.mjs'
+
+const execFileAsync = promisify(execFile)
+
+/**
+ * 获取 git commit 列表（高性能版）
+ */
+export async function getGitLogsFast(opts = {}) {
+  /*
+ git: { merges: true, limit: undefined },
+  period: { groupBy: 'month', since: '2026-12-01', until: '2026-12-06' },
+  worktime: {
+    country: 'CN',
+    start: 9,
+    end: 18,
+    lunch: { start: 12, end: 14 },
+    overnightCutoff: 6
+  },
+  output: {
+    out: 'commits',
+    dir: 'output-wukong',
+    formats: 'text',
+    perPeriod: { enabled: true, excelMode: 'sheets', formats: [] }
+  },
+  author: { include: [ '杨琼,王欢庆' ] },
+  overtime: false,
+  gerrit: { prefix: undefined, api: undefined, auth: undefined },
+  serve: { port: 3000 },
+  profile: {
+    enabled: undefined,
+    flame: true,
+    traceFile: 'trace.json',
+    hotThreshold: 0.8,
+    diffThreshold: 0.2,
+    failOnHot: false,
+    diffBaseFile: 'baseline.json'
+  }
+  */
+  const { git = {}, period = {}, author, email } = opts
+  // 在运行时根据传入的 opts.authorAliases（或用户配置）创建 normalizer
+  const normalizer = createAuthorNormalizer(opts.authorAliases || {})
+  const { since, until } = period
+  const { limit, merges, numstat } = git
+
+  // 对于 CLI 传入的 author，只有当它是字符串时才传给 git
+  // 如果是对象（包含 include/exclude），我们在前端做更精细的过滤
+  const authorIsString = typeof author === 'string' && author.trim().length > 0
+
+  const pretty = `${[
+    '%H', // hash
+    '%an', // author name
+    '%ae', // email
+    '%ad', // date
+    '%s', // subject
+    '%B' // body
+  ].join('%x1f')}%x1e`
+
+  const args = [
+    'log',
+    `--pretty=format:${pretty}`,
+    '--date=iso-local',
+    // '--numstat',
+    '--all'
+  ]
+
+  if (authorIsString) args.push(`--author=${author}`)
+  if (email && typeof email === 'string') args.push(`--author=${email}`)
+  // if (since) args.push(`--since=${until}`)
+  if (since) {
+    // 传给 git 绝对的 ISO 字符串，让 Git 自己去比对时间戳
+    args.push(`--since=${dayjs(since).startOf('day').toISOString()}`)
+  }
+  if (until) {
+    // 传给 git 绝对的 ISO 字符串，让 Git 自己去比对时间戳
+    args.push(`--until=${dayjs(until).endOf('day').toISOString()}`)
+  }
+  // numstat 是个性能杀手，默认不开启，除非用户明确要求,显示每次提交中更改的文件以及增删的行数统计
+  if (numstat) {
+    args.push('--numstat')
+  }
+  // if (until) args.push(`--until=${until}`)
+  if (!merges) args.push(`--no-merges`)
+  if (limit) args.push('-n', String(limit))
+
+  let stdout
+  try {
+    /**
+     * execFile 直接执行 git：
+     * - 不使用 shell
+     * - 不会触发 WSL / bash
+     * - maxBuffer 放大，防止大仓库 stdout 溢出
+     */
+    const result = await execFileAsync('git', args, {
+      maxBuffer: 1024 * 1024 * 200 // 200MB（Windows 大仓库友好）
+    })
+    stdout = result.stdout
+  } catch (err) {
+    /**
+     * 统一错误出口，方便 CLI 层捕获
+     */
+    const message = err?.stderr || err?.message || 'Failed to execute git log'
+    const error = new Error(message)
+    error.cause = err
+    throw error
+  }
+
+  /**
+   * Windows 下 git 输出可能带 \r
+   */
+  const raw = stdout.replace(/\r/g, '')
+  const commits = []
+
+  /**
+   * 匹配每个 commit header + body + numstat
+   */
+  const commitRegex =
+    // eslint-disable-next-line no-control-regex
+    /([0-9a-f]+)\x1f([^\x1f]*)\x1f([^\x1f]*)\x1f([^\x1f]*)\x1f([^\x1f]*)\x1f([\s\S]*?)(?=(?:[0-9a-f]{7,40}\x1f)|\x1e$)/g
+
+  // --- 关键改进 2: 引入内容指纹去重集 ---
+  const fingerPrintSet = new Set()
+
+  for (const match of raw.matchAll(commitRegex)) {
+    const [_, hash, authorName, emailAddr, date, subject, bodyAndNumstat] =
+      match
+
+    // 1. 统一作者名
+    const normalizedAuthor = normalizer.getAuthor(authorName, emailAddr)
+    // 2. 格式化日期（消除时刻差异，只看天）
+    const day = dayjs(date).format('YYYY-MM-DD')
+    // 3. 清理消息内容（去空格，取第一行）
+    const cleanMsg = subject.trim()
+
+    // 生成指纹：日期 + 统一后的作者 + 消息内容
+    // 这样即便 Hash 不同，分支不同，只要这三项一致，就视为同一项工作
+    const fingerPrint = `${day}_${normalizedAuthor}_${cleanMsg}`
+
+    if (fingerPrintSet.has(fingerPrint)) continue
+    fingerPrintSet.add(fingerPrint)
+
+    const [, changeId] =
+      bodyAndNumstat.match(/Change-Id:\s*(I[0-9a-fA-F]+)/) || []
+
+    const cherryPickMatch = bodyAndNumstat.match(
+      /\(cherry picked from commit\s+([0-9a-f]{7,40})\)/i
+    )
+
+    /**
+     * 解析 numstat
+     */
+    const commit = {
+      hash,
+      author: normalizer.getAuthor(authorName, emailAddr),
+      originalAuthor: authorName,
+      email: emailAddr,
+      date,
+      message: subject,
+      body: bodyAndNumstat,
+      changeId,
+
+      // ✅ 新增标记
+      isCherryPick: Boolean(cherryPickMatch),
+      cherryPickFrom: cherryPickMatch?.[1],
+
+      added: 0,
+      deleted: 0,
+      changed: 0,
+      files: []
+    }
+
+    const numstatRegex = /^(\d+)\s+(\d+)\s+(.+)$/gm
+    for (const m of bodyAndNumstat.matchAll(numstatRegex)) {
+      const added = parseInt(m[1], 10) || 0
+      const deleted = parseInt(m[2], 10) || 0
+      const file = m[3]
+
+      commit.added += added
+      commit.deleted += deleted
+      commit.changed += added + deleted
+      commit.files.push({ file, added, deleted })
+    }
+
+    commits.push(commit)
+  }
+
+  /**
+   * 最终统一覆盖 author
+   * 确保同一 email 使用同一个（中文）作者名
+   */
+  // 应用基于邮箱的最终映射
+  const finalMap = normalizer.getMap()
+  for (const c of commits) {
+    if (c.email && finalMap[c.email]) {
+      c.author = finalMap[c.email]
+    }
+  }
+
+  // 支持配置：author.include / author.exclude（可为数组或逗号分隔字符串）
+  const authorCfg = opts.author
+  function toList(v) {
+    if (!v) return null
+    if (Array.isArray(v)) return v.map((s) => String(s).trim()).filter(Boolean)
+    return String(v)
+      .split(',')
+      .map((s) => s.trim())
+      .filter(Boolean)
+  }
+
+  const include =
+    authorCfg && typeof authorCfg === 'object'
+      ? toList(authorCfg.include)
+      : typeof authorCfg === 'string'
+        ? toList(authorCfg)
+        : null
+  const exclude =
+    authorCfg && typeof authorCfg === 'object'
+      ? toList(authorCfg.exclude)
+      : null
+
+  let filteredCommits = commits
+
+  if (include || exclude) {
+    filteredCommits = commits.filter((c) => {
+      const name = (c.author || c.originalAuthor || '').trim().toLowerCase()
+      const mail = (c.email || '').trim().toLowerCase()
+
+      function matches(list) {
+        if (!list || !list.length) return false
+        return list.some((item) => {
+          const it = String(item).trim().toLowerCase()
+          if (it.includes('@')) return it === mail
+          return it === name
+        })
+      }
+
+      if (include && include.length) {
+        if (!matches(include)) return false
+      }
+
+      if (exclude && exclude.length) {
+        if (matches(exclude)) return false
+      }
+
+      return true
+    })
+  }
+
+  // 重新计算 authorMap / originalMap 以只包含筛选后的作者
+  const presentEmails = new Set(
+    filteredCommits.map((c) => c.email).filter(Boolean)
+  )
+  const filteredMap = {}
+  for (const [email, name] of Object.entries(finalMap)) {
+    if (presentEmails.has(email)) filteredMap[email] = name
+  }
+
+  const original = normalizer.getOriginalMap()
+  const filteredOriginal = {}
+  for (const [email, names] of Object.entries(original)) {
+    if (presentEmails.has(email)) filteredOriginal[email] = names
+  }
+
+  return {
+    commits: filteredCommits,
+    authorMap: filteredMap,
+    originalMap: filteredOriginal
+  }
+}
+
+/**
+ * 去重 cherry-pick commit
+ *
+ * 默认策略：
+ * - 按 Change-Id 去重
+ * - 优先保留非 cherry-pick
+ * - 多个 cherry-pick 时保留 first / last
+ */
+export function dedupeCommits(
+  commits,
+  {
+    by = 'changeId', // 'changeId' | 'hash'
+    prefer = 'original' // 'original' | 'first' | 'last'
+  } = {}
+) {
+  const map = new Map()
+
+  for (const commit of commits) {
+    const key = by === 'changeId' ? commit.changeId || commit.hash : commit.hash
+
+    if (!map.has(key)) {
+      map.set(key, commit)
+      continue
+    }
+
+    const existing = map.get(key)
+
+    // 优先保留非 cherry-pick
+    if (prefer === 'original') {
+      if (!existing.isCherryPick && commit.isCherryPick) continue
+      if (existing.isCherryPick && !commit.isCherryPick) {
+        map.set(key, commit)
+        continue
+      }
+    }
+
+    if (prefer === 'last') {
+      map.set(key, commit)
+    }
+  }
+
+  return Array.from(map.values())
+}

package/src/domain/git/getGitUser.mjs

@@ -0,0 +1,44 @@
+/**
+ * 获取 git user.name / user.email
+ */
+
+import { execFile } from 'node:child_process'
+import { promisify } from 'node:util'
+import { getGitCapability } from './gitCapability.mjs'
+
+const execFileAsync = promisify(execFile)
+
+/**
+ * @returns {Promise<{ name: string, email: string }>}
+ */
+export async function getGitUser() {
+  await getGitCapability()
+
+  const getConfig = async (key) => {
+    try {
+      const { stdout } = await execFileAsync(
+        'git',
+        ['config', '--get', key],
+        {
+          windowsHide: true,
+          timeout: 3000,
+          maxBuffer: 1024 * 1024
+        }
+      )
+
+      return stdout.trim()
+    } catch {
+      return ''
+    }
+  }
+
+  const [name, email] = await Promise.all([
+    getConfig('user.name'),
+    getConfig('user.email')
+  ])
+
+  return {
+    name,
+    email
+  }
+}

package/src/domain/git/getRepoRoot.mjs

@@ -0,0 +1,32 @@
+/**
+ * 获取 git 仓库根目录
+ */
+
+import { execFile } from 'node:child_process'
+import { promisify } from 'node:util'
+import { getGitCapability } from './gitCapability.mjs'
+
+const execFileAsync = promisify(execFile)
+
+/**
+ * @returns {Promise<string>} 仓库根路径
+ */
+export async function getRepoRoot() {
+  await getGitCapability()
+
+  try {
+    const { stdout } = await execFileAsync(
+      'git',
+      ['rev-parse', '--show-toplevel'],
+      {
+        windowsHide: true,
+        timeout: 5000,
+        maxBuffer: 1024 * 1024
+      }
+    )
+
+    return stdout.trim()
+  } catch {
+    throw new Error(`❌ 无法获取 Git 仓库根目录`)
+  }
+}

package/src/domain/git/gitCapability.mjs

@@ -0,0 +1,119 @@
+/**
+ * Git Capability Cache
+ *
+ * - CLI 生命周期内只检测一次
+ * - 不使用 shell
+ * - 不触发 WSL
+ */
+import { execFile } from 'node:child_process'
+import { promisify } from 'node:util'
+
+const execFileAsync = promisify(execFile)
+
+/**
+ * @type {null | {
+ *   available: boolean
+ *   version: string
+ *   platform: string
+ *   checkedAt: number
+ * }}
+ */
+let cache = null
+
+/**
+ * 内部：真正执行 git 检测
+ */
+async function detectGit() {
+  const {platform} = process
+
+  const { stdout } = await execFileAsync('git', ['--version'], {
+    windowsHide: true,
+    timeout: 5000,
+    maxBuffer: 1024 * 1024
+  })
+
+  if (!stdout || !stdout.toLowerCase().includes('git version')) {
+    throw new Error(`Unexpected git output: ${stdout}`)
+  }
+
+  return {
+    available: true,
+    version: stdout.trim(),
+    platform,
+    checkedAt: Date.now()
+  }
+}
+
+/**
+ * 对外 API：获取 git capability（带缓存）
+ */
+export async function getGitCapability() {
+  if (cache) {
+    return cache
+  }
+
+  try {
+    cache = await detectGit()
+    return cache
+  } catch (err) {
+    cache = {
+      available: false,
+      version: '',
+      platform: process.platform,
+      checkedAt: Date.now()
+    }
+
+    // eslint-disable-next-line no-use-before-define
+    const error = new Error(buildGitNotAvailableMessage())
+    error.cause = err
+    throw error
+  }
+}
+
+/**
+ * 是否已检测（通常你不需要）
+ */
+export function isGitCapabilityCached() {
+  return Boolean(cache)
+}
+
+/**
+ * 生成跨平台提示信息
+ */
+function buildGitNotAvailableMessage() {
+  const {platform} = process
+
+  if (platform === 'win32') {
+    return `
+❌ Git 不可用，CLI 无法继续运行
+
+请确认：
+1️⃣ 已安装 Git for Windows
+   https://git-scm.com/download/win
+
+2️⃣ 安装时勾选：
+   ✔ "Add Git to PATH"
+
+3️⃣ 关闭并重新打开终端后再试
+`
+  }
+
+  if (platform === 'darwin') {
+    return `
+❌ Git 不可用，CLI 无法继续运行
+
+可通过以下方式安装 git：
+  xcode-select --install
+或
+  brew install git
+`
+  }
+
+  return `
+❌ Git 不可用，CLI 无法继续运行
+
+请使用系统包管理器安装 git，例如：
+  apt install git
+  yum install git
+`
+}

package/src/domain/git/index.mjs

@@ -0,0 +1,96 @@
+/**
+ * @file: index.mjs
+ * @description:启动前环境检查
+ * @author: King Monkey
+ * @created: 2026-01-13 01:16
+ */
+import { ensureGitRepo } from '#src/domain/git/ensureGitRepo.mjs'
+import { getGitFeatures } from '#src/domain/git/getGitFeatures.mjs'
+import { getGitUser } from '#src/domain/git/getGitUser.mjs'
+import { getRepoRoot } from '#src/domain/git/getRepoRoot.mjs'
+import { getGitCapability } from '#src/domain/git/gitCapability.mjs'
+
+/**
+ * CLI 启动阶段 Git 运行环境预检（Preflight）
+ *
+ * @returns {Promise<{
+ *   git: {
+ *     version: string
+ *     platform: string
+ *   },
+ *   repo: {
+ *     root: string
+ *   },
+ *   user: {
+ *     name: string
+ *     email: string
+ *   },
+ *   features: {
+ *     numstat: boolean
+ *     dateIsoLocal: boolean
+ *   },
+ *   meta: {
+ *     checkedAt: number
+ *   }
+ * }>}
+ */
+export const runGitPreflight = async () => {
+  // 1️⃣ git 可执行能力（带全局 cache）
+  // CLI 启动即检测（一次）
+  const gitCapability = await getGitCapability()
+
+  // 2️⃣ 必须在 git repo 内
+  await ensureGitRepo()
+
+  // 3️⃣ 并行获取上下文信息
+  const [root, user, features] = await Promise.all([
+    getRepoRoot(),
+    getGitUser(),
+    getGitFeatures()
+  ])
+
+  const result = {
+    git: {
+      version: gitCapability.version,
+      platform: gitCapability.platform
+    },
+
+    repo: {
+      root
+    },
+
+    user: {
+      name: user.name,
+      email: user.email
+    },
+
+    features,
+
+    meta: {
+      checkedAt: gitCapability.checkedAt
+    }
+  }
+
+  // 可选：打印
+  // console.log(`✔ Git detected: ${result.git.version}`)
+  // console.log(`✔ platform: ${result.git.platform}`)
+
+  // console.log('✔ root', result.repo.root)
+  // console.log('✔ user', result.user.name)
+  // console.log('✔ email', result.user.email)
+  // console.log('✔ features', result.features)
+  // console.log(`-`.repeat(50), '\n')
+
+  return result
+}
+
+export const showGitInfo = async (gitInfo) => {
+  console.log(`✔ Git detected: ${gitInfo.git.version}`)
+  console.log(`✔ platform: ${gitInfo.git.platform}`)
+
+  console.log('✔ root', gitInfo.repo.root)
+  console.log('✔ user', gitInfo.user.name)
+  console.log('✔ email', gitInfo.user.email)
+  console.log('✔ features', gitInfo.features)
+  console.log(`-`.repeat(50), '\n')
+}