wukong-gitlog-cli 1.0.38 → 1.0.40

package/src/output/text/outputTxtDayReport.mjs

@@ -0,0 +1,74 @@
+import dayjs from 'dayjs'
+import fs from 'fs'
+import path from 'path'
+
+import { DAY_REPORT_TXT } from '#src/constants/index.mjs'
+import { outFile } from '#src/output/utils/outputPath.mjs'
+
+/**
+ * @function outputTxtDayReport
+ * @description
+ * 按 author 输出 TXT 日报（每人一个文件）
+ */
+export const outputTxtDayReport = async ({
+  dayReports = [],
+  conf = {}
+} = {}) => {
+  if (!Array.isArray(dayReports) || dayReports.length === 0) {
+    return
+  }
+
+  const config = { dir: conf.dir || path.resolve('output-wukong') }
+  const baseDir = `${config.dir}/${DAY_REPORT_TXT}`
+
+  // 生成时间（来自上层 outputData）
+  const generateTime =  dayjs().format('YYYY-MM-DD HH:mm:ss')
+
+  // 按 author 分组
+  const authorMap = {}
+  dayReports.forEach((item) => {
+    if (!authorMap[item.author]) {
+      authorMap[item.author] = []
+    }
+    authorMap[item.author].push(item)
+  })
+
+  // 每个人生成一个 txt
+  for (const [author, records] of Object.entries(authorMap)) {
+    // 日期升序
+    records.sort(
+      (a, b) =>
+        dayjs(a.day).valueOf() - dayjs(b.day).valueOf()
+    )
+
+    const lines = []
+
+    // ✅ 文件头：生成时间
+    lines.push(`生成时间：${generateTime}`)
+    lines.push('')
+
+    // 姓名
+    lines.push(`姓名：${author}`)
+    lines.push('')
+
+    // 每一天
+    records.forEach((item) => {
+      lines.push(item.day)
+      lines.push('--------------------------------')
+      lines.push('工作时长：8 小时')
+      lines.push('工作内容：')
+      lines.push(item.msg)
+      lines.push('') // 空行分隔
+    })
+
+    const content = lines.join('\n')
+
+    const txtFile = `${author}.txt`
+    const filePath = outFile(baseDir, txtFile)
+
+    // eslint-disable-next-line no-await-in-loop
+    fs.writeFileSync(filePath, content, 'utf-8')
+
+    console.log(`✅ 已生成 TXT：${filePath}`)
+  }
+}

package/src/output/text/overtime.mjs

@@ -0,0 +1,18 @@
+import { writeText } from '../utils/writeFile.mjs'
+import { outFile } from '../utils/outputPath.mjs'
+import {
+  renderOvertimeText,
+  renderOvertimeTab
+} from '../../domain/overtime/render.mjs'
+
+export function outputOvertimeText(stats, config) {
+  writeText(
+    outFile(config.dir, `overtime_${config.base}.txt`),
+    renderOvertimeText(stats)
+  )
+
+  writeText(
+    outFile(config.dir, `overtime_${config.base}.tab.txt`),
+    renderOvertimeTab(stats)
+  )
+}

package/src/output/utils/getEsmJs.mjs

@@ -0,0 +1,10 @@
+/**
+ * @file: getEsmJs.mjs
+ * @description:生成ESM文件内容的工具函数
+ * @author: King Monkey
+ * @created: 2026-01-02 00:03
+ */
+
+export const getEsmJs = (data) => {
+  return `export default ${JSON.stringify(data, null, 2)};\n`
+}

package/src/output/utils/index.mjs

@@ -0,0 +1,14 @@
+import { outFile } from './outputPath.mjs'
+import { writeJson, writeText } from './writeFile.mjs'
+
+/* ---------------- helpers ---------------- */
+
+export function writeJsonFile(dir, name, data) {
+  writeJson(outFile(dir, name), data)
+  return name
+}
+
+export function writeTxtFile(dir, name, data) {
+  writeText(outFile(dir, name), data)
+  return name
+}

package/src/output/utils/outputPath.mjs

@@ -0,0 +1,19 @@
+import path from 'path'
+import fs from 'fs'
+
+export function resolveOutDir(baseDir = 'output-wukong') {
+  const dir = path.isAbsolute(baseDir)
+    ? baseDir
+    : path.resolve(process.cwd(), baseDir)
+
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true })
+  }
+  return dir
+}
+
+export function outFile(dir, filename) {
+  const full = path.join(dir, filename)
+  fs.mkdirSync(path.dirname(full), { recursive: true })
+  return full
+}

package/src/output/utils/writeFile.mjs

@@ -0,0 +1,10 @@
+import fs from 'fs'
+
+export function writeText(file, content) {
+  fs.writeFileSync(file, content, 'utf8')
+}
+
+export function writeJson(file, data) {
+  fs.writeFileSync(file, JSON.stringify(data, null, 2), 'utf8')
+}
+

package/src/{server.mjs → serve/startServer.mjs}

@@ -40,16 +40,31 @@ function openBrowser(url) {
   })
 }
 
+// 辅助函数：向上寻找包含 package.json 的根目录
+function findPkgRoot(currentDir) {
+  if (fs.existsSync(path.join(currentDir, 'package.json'))) {
+    return currentDir
+  }
+  const parentDir = path.resolve(currentDir, '..')
+  if (parentDir === currentDir) return currentDir // 已到系统根目录
+  return findPkgRoot(parentDir)
+}
+
 // eslint-disable-next-line default-param-last
 export function startServer(port = 3000, outputDir) {
   // 解析包根目录，确保 web 资源在全局安装后也能找到
-  const __dirname = path.dirname(fileURLToPath(import.meta.url))
-  const pkgRoot = path.resolve(__dirname, '..')
+  const __filename = fileURLToPath(import.meta.url)
+  const __dirname = path.dirname(__filename)
+
+  // 动态寻找根目录
+  const pkgRoot = findPkgRoot(__dirname)
+
   const webRoot = path.resolve(pkgRoot, 'web')
   const dataRoot = outputDir
     ? path.resolve(outputDir)
     : path.resolve(process.cwd(), 'output-wukong')
 
+
   // warn if web directory or data directory doesn't exist
   if (!fs.existsSync(webRoot)) {
     console.warn(
@@ -116,7 +131,10 @@ export function startServer(port = 3000, outputDir) {
   return new Promise((resolve, reject) => {
     server.on('error', (err) => reject(err))
     server.listen(port, () => {
-      const url = `http://localhost:${port}`
+      // 监听到的真实端口（当 port 为 0 或系统分配端口时很重要）
+      const bound = server.address()
+      const actualPort = bound && bound.port ? bound.port : port
+      const url = `http://localhost:${actualPort}`
       console.log(chalk.green(`Server started at ${url}`))
       console.log(chalk.green(`Serving web/ and output-wukong/data/`))
 

package/src/utils/authorNormalizer.mjs

@@ -4,10 +4,20 @@
  * - 同邮箱多个英文名保持第一个
  * - 保留原始 author 以便 debug
  */
-export function createAuthorNormalizer() {
+export function createAuthorNormalizer(aliases = {}) {
   const map = {} // email -> canonical name
   const originalMap = {} // email -> Set of original author names
 
+  // 预处理别名配置：按 email/name 划分
+  const aliasByEmail = {}
+  const aliasByName = {}
+  for (const [k, v] of Object.entries(aliases || {})) {
+    const key = (k || '').trim()
+    if (!key) continue
+    if (key.includes('@')) aliasByEmail[key] = v
+    else aliasByName[key] = v
+  }
+
   function isChinese(str) {
     return /[\u4e00-\u9fa5]/.test(str)
   }
@@ -25,12 +35,28 @@ export function createAuthorNormalizer() {
     const n = cleanName(name)
     const e = cleanEmail(email)
 
-    if (!e) return n || 'Unknown'
+    if (!e) {
+      // 如果没有邮箱，先尝试按名字别名匹配
+      if (n && aliasByName[n]) return aliasByName[n]
+      return n || 'Unknown'
+    }
 
     // 记录原始 author
     if (!originalMap[e]) originalMap[e] = new Set()
     if (n) originalMap[e].add(n)
 
+    // 先检查 email 别名配置
+    if (aliasByEmail[e]) {
+      map[e] = aliasByEmail[e]
+      return map[e]
+    }
+
+    // 再检查名字别名配置
+    if (n && aliasByName[n]) {
+      map[e] = aliasByName[n]
+      return map[e]
+    }
+
     const prev = map[e]
 
     // 中文名优先覆盖

package/src/utils/buildAuthorChangeStats.mjs

@@ -0,0 +1,44 @@
+import dayjs from 'dayjs'
+import isoWeek from 'dayjs/plugin/isoWeek.js'
+
+dayjs.extend(isoWeek)
+
+/**
+ * 自动统计每个作者的日/周/月 changed
+ *
+ * records: [{
+ *   author: 'Tom',
+ *   date: '2025-01-01T12:00:00Z',
+ *   changed: 123
+ * }]
+ */
+export function buildAuthorChangeStats(records) {
+  const result = {
+    daily: {}, // { author: { 'YYYY-MM-DD': x } }
+    weekly: {}, // { author: { 'YYYY-WW': x } }
+    monthly: {} // { author: { 'YYYY-MM': x } }
+  }
+
+  for (const r of records) {
+    const author = r.author || 'Unknown'
+    const changed = Number(r.changed || 0)
+
+    const d = dayjs(r.date)
+
+    const dayKey = d.format('YYYY-MM-DD')
+    const weekKey = `${d.format('GGGG')}-W${d.isoWeek().toString().padStart(2, '0')}`
+    const monthKey = d.format('YYYY-MM')
+
+    if (!result.daily[author]) result.daily[author] = {}
+    if (!result.weekly[author]) result.weekly[author] = {}
+    if (!result.monthly[author]) result.monthly[author] = {}
+
+    result.daily[author][dayKey] = (result.daily[author][dayKey] || 0) + changed
+    result.weekly[author][weekKey] =
+      (result.weekly[author][weekKey] || 0) + changed
+    result.monthly[author][monthKey] =
+      (result.monthly[author][monthKey] || 0) + changed
+  }
+
+  return result
+}

package/src/utils/deepMerge.mjs

@@ -0,0 +1,13 @@
+export function deepMerge(target, source) {
+  for (const key in source) {
+    if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key])) {
+      // eslint-disable-next-line no-param-reassign
+      if (!target[key]) target[key] = {};
+      deepMerge(target[key], source[key]);
+    } else if (source[key] !== undefined) {
+      // eslint-disable-next-line no-param-reassign
+      target[key] = source[key];
+    }
+  }
+  return target;
+}

package/src/utils/getPackage.mjs

@@ -0,0 +1,11 @@
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+export const getPackage = () => {
+  const __dirname = path.dirname(fileURLToPath(import.meta.url))
+  const pkg = JSON.parse(
+    fs.readFileSync(path.resolve(__dirname, '../../package.json'), 'utf8')
+  )
+  return pkg
+}

package/src/utils/getProfileDirFile.mjs

@@ -0,0 +1,12 @@
+import path from 'path'
+
+import { EXPORT_DIR_PROFILE } from '#src/constants/index.mjs'
+import { outFile } from '#src/output/utils/outputPath.mjs'
+
+export const getProfileDirFile = (fileName, opts) => {
+  const config = { dir: opts.output.dir || path.resolve('output-wukong') }
+  const baseDir = `${config.dir}/${EXPORT_DIR_PROFILE}`
+  const filePath = outFile(baseDir, fileName)
+
+  return filePath
+}

package/src/utils/{file.mjs → groupRecords.mjs}

@@ -1,18 +1,17 @@
+/**
+ * @file: groupRecords.mjs
+ * @description: 按指定周期对提交记录进行分组
+ * @author: King Monkey
+ * @created: 2026-01-04 00:10
+ */
+
 import dayjs from 'dayjs'
 import isoWeek from 'dayjs/plugin/isoWeek.js'
-import fs from 'fs'
+
 
 // add ISO week plugin to dayjs once when module loaded
 dayjs.extend(isoWeek)
 
-export function writeJSON(file, data) {
-  fs.writeFileSync(file, JSON.stringify(data, null, 2), 'utf8')
-}
-
-export function writeTextFile(file, text) {
-  fs.writeFileSync(file, text, 'utf8')
-}
-
 export function groupRecords(records, mode) {
   const group = {}
 

package/src/utils/index.mjs

@@ -1,2 +1,5 @@
-export { groupRecords, writeJSON, writeTextFile } from './file.mjs'
-export * from './output.mjs'
+import dayjs from 'dayjs'
+
+export const getCurrentTimestampSecond = () => {
+  return dayjs().format('YYYY-MM-DD HH:mm:ss')
+}

package/src/utils/logger.mjs

@@ -34,15 +34,6 @@ if (!process.stdout.isTTY || chalk.level === 0) {
 let cachedDay = ''
 let cachedPath = ''
 
-// // 彩色前缀
-// const prefix = {
-//   info: chalk.cyan('ℹ'),
-//   success: chalk.green('✔'),
-//   error: chalk.red('✖'),
-//   warn: chalk.yellow('⚠'),
-//   debug: chalk.gray('➤')
-// }
-
 // 🔧 1. 修改 prefix：只保留 emoji，不带颜色
 const prefix = {
   info: e('➤', '[i]'),
@@ -89,6 +80,20 @@ const getLogFilePath = () => {
   return cachedPath
 }
 
+// 格式化参数为字符串
+const formatArgs = (args) => {
+  return args.map(arg => {
+    if (typeof arg === 'object' && arg !== null) {
+      try {
+        return JSON.stringify(arg, null, 2)
+      } catch (err) {
+        return String(arg)
+      }
+    }
+    return String(arg)
+  }).join(' ')
+}
+
 // 写入日志（同步 + 追加）
 const writeToFile = (level, msg, newline) => {
   const logPath = getLogFilePath()
@@ -105,6 +110,8 @@ const writeToFile = (level, msg, newline) => {
 function createLogger(level, colorFn, outFn = console.log) {
   return (...args) => {
     let options = {}
+
+    // 检查最后一个参数是否是选项对象
     if (
       args.length &&
       typeof args[args.length - 1] === 'object' &&
@@ -114,22 +121,26 @@ function createLogger(level, colorFn, outFn = console.log) {
       options = args.pop()
     }
 
-    const msg = args
-      .map((arg) =>
-        typeof arg === 'object' ? JSON.stringify(arg, null, 2) : String(arg)
-      )
-      .join(' ')
+    // 处理剩余的参数
+    const formattedArgs = formatArgs(args)
+    const displayMsg = args.length === 1 && typeof args[0] === 'string'
+      ? args[0]
+      : formattedArgs
 
     // 🔧 2. 修改拼接方式，colorFn 统一处理 prefix + msg
-    const line = `${shortTimestamp()} ${colorFn(`${prefix[level]} ${msg}`)}`
+    const timestamp = shortTimestamp()
+    const prefixStr = prefix[level]
 
     if (options.newline) {
       outFn('')
     }
-    outFn(line)
 
+    // 输出到控制台，保留参数的原格式
+    outFn(timestamp, colorFn(prefixStr), ...args)
+
+    // 写入文件时使用格式化的字符串
     if (options.write) {
-      writeToFile(level, msg, options.newline)
+      writeToFile(level, displayMsg, options.newline)
     }
   }
 }

package/src/utils/profiler.mjs

@@ -1,101 +0,0 @@
-import chalk from 'chalk'
-
-/* ================= utils ================= */
-
-const formatTime = (ms) => {
-  if (ms < 1) return `${(ms * 1000).toFixed(2)} μs`
-  if (ms < 1000) return `${ms.toFixed(2)} ms`
-  if (ms < 60000) return `${(ms / 1000).toFixed(2)} s`
-  return `${(ms / 60000).toFixed(2)} min`
-}
-
-const makeBar = (ratio, width = 32) => {
-  const len = Math.max(1, Math.round(ratio * width))
-  return '█'.repeat(len)
-}
-
-/* ================= profiler ================= */
-
-export const createProfiler = ({
-  enabled = false,
-  verbose = false,
-  flame = false,
-  slowThreshold = 500,   // ms
-  hotThreshold = 0.8     // ratio (0~1)
-} = {}) => {
-  const start = process.hrtime.bigint()
-  let last = start
-  const events = []
-
-  const toMs = (a, b) => Number(b - a) / 1e6
-
-  /* -------- step -------- */
-  const step = (name, meta = {}) => {
-    const now = process.hrtime.bigint()
-    const duration = toMs(last, now)
-    last = now
-
-    events.push({
-      name,
-      duration,
-      sinceStart: toMs(start, now),
-      meta
-    })
-
-    if (!enabled && !verbose) return
-
-    const isSlow = duration >= slowThreshold
-
-    console.log(
-      chalk.gray('  ├─'),
-      isSlow ? chalk.red.bold(name) : chalk.white(name),
-      chalk.yellow(formatTime(duration))
-    )
-  }
-
-  /* -------- end -------- */
-  const end = (label = 'Total') => {
-    const endTime = process.hrtime.bigint()
-    const total = toMs(start, endTime)
-
-    // 计算 HOT
-    for (const e of events) {
-      e.ratio = total > 0 ? e.duration / total : 0
-      e.hot = e.ratio >= hotThreshold
-    }
-
-    if (enabled || verbose) {
-      console.log(
-        chalk.cyan('⏱'),
-        chalk.bold(label),
-        chalk.yellow(formatTime(total))
-      )
-
-      if (flame) {
-        for (const e of events) {
-          const bar = makeBar(e.ratio)
-          const hotMark = e.hot ? chalk.red.bold(' 🔥 HOT') : ''
-          const slowMark =
-            !e.hot && e.duration >= slowThreshold
-              ? chalk.yellow(' ⚠ SLOW')
-              : ''
-
-          console.log(
-            chalk.gray('  ├─'),
-            chalk.white(e.name.padEnd(24)),
-            chalk.yellow(formatTime(e.duration)),
-            chalk.gray(bar),
-            hotMark || slowMark
-          )
-        }
-      }
-    }
-
-    return {
-      total,
-      events
-    }
-  }
-
-  return { step, end }
-}

package/src/utils/resolve.mjs

@@ -0,0 +1,11 @@
+export function resolveBool(cli, config, def = false) {
+  if (cli !== undefined) return cli
+  if (config !== undefined) return config
+  return def
+}
+
+export function resolveValue(cli, config, def) {
+  if (cli !== undefined) return cli
+  if (config !== undefined) return config
+  return def
+}

package/src/utils/showVersionInfo.mjs

@@ -1,10 +1,14 @@
 import os from 'os'
 import process from 'process'
+
 import { colors } from './colors.mjs'
 
 
-export function showVersionInfo(VERSION) {
-  console.log(colors.title(`\nwukong-deploy v${VERSION}\n`))
+
+export function showVersionInfo(pkg) {
+  const { name, version } = pkg
+
+  console.log(colors.title(`\n${name} v${version}\n`))
   console.log(`${colors.bold('Node.js')}: ${process.version}`)
   console.log(`${colors.bold('Platform')}: ${os.platform()} ${os.arch()}`)
 }

package/src/utils/wait.mjs

@@ -0,0 +1,2 @@
+// eslint-disable-next-line no-promise-executor-return
+export const wait = (time) => new Promise((res) => setTimeout(res, time))