wukong-gitlog-cli 1.0.41 → 1.0.43

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [1.0.43](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v1.0.42...v1.0.43) (2026-02-13)
+
+
+### Features
+
+* 🎸 autoCheckUpdate ([d377012](https://github.com/tomatobybike/wukong-gitlog-cli/commit/d3770123f10c574f0f5ea592ef58e71bfdd8edc1))
+
+
+### Bug Fixes
+
+* 🐛 update version ([840216d](https://github.com/tomatobybike/wukong-gitlog-cli/commit/840216d4f553e5d78f84e42f76386056553d1282))
+
+### [1.0.42](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v1.0.41...v1.0.42) (2026-02-13)
+
 ### [1.0.41](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v1.0.40...v1.0.41) (2026-02-12)
 
 ### [1.0.40](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v1.0.39...v1.0.40) (2026-02-12)

package/README.md

@@ -4,7 +4,7 @@
 
 An enhanced Git commit log analysis and export tool. Supports **Excel / JSON / TXT** output, grouped statistics, overtime culture analysis, Gerrit link integration, and a visual Web Dashboard.
 
-## [中文](./README.zh-CN.md) | English
+## English | [简体中文](./README.zh-CN.md)
 
 ---
 
@@ -42,7 +42,7 @@ wukong-gitlog-cli --help
 wukong-gitlog-cli init
 
 # Analyze and start web dashboard
-wukong-gitlog-cli serve --overtime
+wukong-gitlog-cli serve 
 ```
 
 ---

package/README.zh-CN.md

@@ -42,7 +42,7 @@ wukong-gitlog-cli --help
 wukong-gitlog-cli init
 
 # 执行分析并启动 Web Dashboard
-wukong-gitlog-cli serve --overtime
+wukong-gitlog-cli serve 
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wukong-gitlog-cli",
-  "version": "1.0.41",
+  "version": "1.0.43",
   "description": "Advanced Git commit log exporter with Excel/JSON/TXT output, grouping, stats and CLI.",
   "keywords": [
     "git",
@@ -98,6 +98,7 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^8.1.0",
+    "boxen": "^8.0.1",
     "chalk": "5.6.2",
     "commander": "12.1.0",
     "date-fns": "4.1.0",
@@ -106,6 +107,7 @@
     "dotenv": "17.2.2",
     "exceljs": "4.4.0",
     "fs-extra": "11.3.3",
+    "is-online": "^12.0.2",
     "ora": "9.0.0",
     "os-locale": "^8.0.0",
     "string-width": "5.1.2",

package/src/cli/createCommand.mjs

@@ -0,0 +1,30 @@
+export function createCommand(program, {
+  name,
+  description,
+  optionsBuilder,
+  handler,
+  autoUpdate
+}) {
+  const cmd = program.command(name).description(description)
+
+  // 注入 options
+  if (optionsBuilder) {
+    optionsBuilder(cmd)
+  }
+
+  cmd.action(async (cmdOpts, command) => {
+    const globalOpts = command.parent?.opts?.() || {}
+    const finalOpts = { ...globalOpts, ...cmdOpts }
+
+    try {
+      await handler(finalOpts)
+    } finally {
+      if (autoUpdate) {
+        // 不阻塞 CLI
+        autoUpdate().catch(() => {})
+      }
+    }
+  })
+
+  return cmd
+}

package/src/index.mjs

@@ -1,5 +1,8 @@
 #!/usr/bin/env node
 import { Command } from 'commander'
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
 
 import { runGitPreflight, showGitInfo } from '#src/domain/git/index.mjs'
 
@@ -11,6 +14,7 @@ import { journalAction } from './app/journalAction.mjs'
 import { overtimeAction } from './app/overtimeAction.mjs'
 import { serveAction } from './app/serveAction.mjs'
 import { versionAction } from './app/versionAction.mjs'
+import { createCommand } from './cli/createCommand.mjs'
 import {
   addAnalysisOptions,
   addGitSourceOptions,
@@ -21,9 +25,38 @@ import {
 } from './cli/defineOptions.mjs'
 import { initI18n, t } from './i18n/index.mjs'
 import { loadRcConfig } from './infra/configStore.mjs'
+import { checkUpdateWithPatch } from './utils/checkUpdate.mjs'
 
 // 引入加载器
 
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+const pkgPath = path.resolve(__dirname, '../package.json')
+const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
+
+const autoCheckUpdate = async () => {
+  // 避免 CI 打印更新提示
+  if (process.env.CI) return
+  // CLI 更新提示只在 global 安装时出现
+  if (process.env.npm_config_global !== 'true') return
+  if (!process.stdout.isTTY) return
+
+  // === CLI 主逻辑完成后提示更新 ===
+  // await checkUpdateWithPatch({
+  //   pkg: {
+  //     name: pkg.name,
+  //     version: pkg.version
+  //   },
+  //   // force:true
+  // })
+  
+  // 放到下一个 tick
+  setTimeout(() => {
+    checkUpdateWithPatch({ pkg }).catch(() => {})
+  }, 0)
+}
+
 const main = async () => {
   // --- 第一步：参数预检 (Pre-flight) ---
   const args = process.argv.slice(2)
@@ -67,85 +100,78 @@ const main = async () => {
 
   // === 命令: Init ===
 
-  program
-    .command('init')
-    .description(t('cmds.init'))
-    .option('-f, --force', t('options.force'))
-    .action(async (options) => {
-      // 如果你不想抽离到 app 层，也可以直接写这里
-      // 但推荐抽离以保持架构一致性
-      await initAction(options)
-    })
+  createCommand(program, {
+    name: 'init',
+    description: t('cmds.init'),
+    optionsBuilder: (cmd) => {
+      cmd.option('-f, --force', t('options.force'))
+    },
+    handler: initAction,
+    autoUpdate: autoCheckUpdate
+  })
 
   // # 命令: Analyze 核心分析（默认） 分析 git 提交记录 (最全参数)
-  const analyzeCmd = program
-    .command('analyze')
-    .description(t('cmds.analyze'))
-    .action((cmdOpts) => {
-      const globalOpts = program.opts()
-      const finalOpts = { ...globalOpts, ...cmdOpts }
-      analyzeAction(finalOpts)
-    })
-
-  // 挂载 analyze 需要的参数组
-  addGitSourceOptions(analyzeCmd)
-  addAnalysisOptions(analyzeCmd)
-  addOutputOptions(analyzeCmd)
-  addPerformanceOptions(analyzeCmd)
+  createCommand(program, {
+    name: 'analyze',
+    description: t('cmds.analyze'),
+    optionsBuilder: (cmd) => {
+      addGitSourceOptions(cmd)
+      addAnalysisOptions(cmd)
+      addOutputOptions(cmd)
+      addPerformanceOptions(cmd)
+    },
+    handler: analyzeAction,
+    autoUpdate: autoCheckUpdate
+  })
 
   // # 命令: Overtime 加班文化分析
-  const overtimeCmd = program
-    .command('overtime')
-    .description(t('cmds.overtime'))
-    .action((cmdOpts) => {
-      const globalOpts = program.opts()
-      const finalOpts = { ...globalOpts, ...cmdOpts }
-      overtimeAction(finalOpts)
-    })
-  addGitSourceOptions(overtimeCmd)
-  addAnalysisOptions(overtimeCmd) // 加班分析肯定需要上班时间配置
+  createCommand(program, {
+    name: 'overtime',
+    description: t('cmds.overtime'),
+    optionsBuilder: (cmd) => {
+      addGitSourceOptions(cmd)
+      addAnalysisOptions(cmd)
+    },
+    handler: overtimeAction,
+    autoUpdate: autoCheckUpdate
+  })
 
   // # 命令: Export (专注导出) 导出（excel / csv / json）
-  const exportCmd = program
-    .command('export')
-    .description(t('cmds.export'))
-    // .option('-f, --format <type>', '导出格式') // 局部参数
-    .action((cmdOpts, command) => {
-      // globalOpts 拿到 author, since 等
-      const globalOpts = command.parent.opts()
-      // 合并全局和局部参数
-      const finalOpts = { ...globalOpts, ...cmdOpts }
-      exportAction(finalOpts)
-    })
-  addGitSourceOptions(exportCmd)
-  addOutputOptions(exportCmd)
+  createCommand(program, {
+    name: 'export',
+    description: t('cmds.export'),
+    optionsBuilder: (cmd) => {
+      addGitSourceOptions(cmd)
+      addOutputOptions(cmd)
+    },
+    handler: exportAction,
+    autoUpdate: autoCheckUpdate
+  })
 
   // === 命令: Journal (日报) ===
-  const journalCmd = program
-    .command('journal')
-    .description(t('cmds.journal'))
-    .action((cmdOpts) => {
-      const globalOpts = program.opts()
-      const finalOpts = { ...globalOpts, ...cmdOpts }
-      journalAction(finalOpts)
-    })
-
-  addGitSourceOptions(journalCmd)
-
-  addPerformanceOptions(journalCmd)
+  createCommand(program, {
+    name: 'journal',
+    description: t('cmds.journal'),
+    optionsBuilder: (cmd) => {
+      addGitSourceOptions(cmd)
+      addPerformanceOptions(cmd)
+    },
+    handler: journalAction,
+    autoUpdate: autoCheckUpdate
+  })
 
   // === 命令: Serve (Web服务) ===
-  const serveCmd = program
-    .command('serve')
-    .description('Start web server')
-    .action((cmdOpts) => {
-      const globalOpts = program.opts()
-      const finalOpts = { ...globalOpts, ...cmdOpts }
-      serveAction(finalOpts)
-    })
-  // Serve 命令只需要端口，不需要 Git 作者之类的参数
-  addServeOptions(serveCmd)
-  program.parse(process.argv)
+  createCommand(program, {
+    name: 'serve',
+    description: 'Start web server',
+    optionsBuilder: (cmd) => {
+      addServeOptions(cmd)
+    },
+    handler: serveAction,
+    autoUpdate: autoCheckUpdate
+  })
+
+  await program.parseAsync(process.argv)
 
   // const opts = program.opts()
   // console.log('✅ Cli Opts:', opts)

package/src/utils/checkUpdate.mjs

@@ -0,0 +1,135 @@
+import boxen from 'boxen'
+import fs from 'fs'
+import isOnline from 'is-online'
+import os from 'os'
+import path from 'path'
+import semver from 'semver'
+
+import { colors } from './colors.mjs'
+
+const CONFIG_DIR = path.join(os.homedir(), '.config', 'configstore')
+
+const getCacheFile = (pkg) =>
+  path.join(CONFIG_DIR, `update-notifier-${pkg.name}.json`)
+
+async function fetchLatestVersion(pkgName, timeout = 1500) {
+  const url = `https://registry.npmjs.org/${pkgName}/latest`
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), timeout)
+
+  try {
+    const res = await fetch(url, { signal: controller.signal })
+    clearTimeout(timer)
+    if (!res.ok) throw new Error('fetch fail')
+    const data = await res.json()
+    return data.version
+  } catch (e) {
+    clearTimeout(timer)
+    // 超时或其他错误都返回 null，防止程序卡死
+    return null
+  }
+}
+
+/**
+ * 格式化升级提示信息
+ */
+export function formatUpdateMessage(current, latest, name) {
+  const arrow = colors.dim('→')
+  const currentVer = colors.dim(current)
+  const latestVer = colors.green(latest)
+
+  const message =
+    `${colors.dim('Update available')}` +
+    `  ${currentVer} ${arrow} ${latestVer}\n` +
+    `${colors.dim('Run')} ${colors.cyanish(`npm i -g ${name}`)} ${colors.dim(' to update')}`
+
+  return boxen(message, {
+    padding: 1,
+    margin: 1,
+    borderStyle: 'round',
+    borderColor: 'yellow'
+  })
+}
+
+/**
+ * 检查更新（带缓存 + 支持 patch 更新）
+ */
+export async function checkUpdateWithPatch({
+  pkg,
+  interval = 24 * 60 * 60 * 1000,
+  // interval = 6 * 1000,
+  force = false
+} = {}) {
+  const online = await isOnline()
+  console.log('online', online)
+  if (!online) return null
+  const now = Date.now()
+  const CACHE_FILE = getCacheFile(pkg)
+
+  let cache = {}
+  if (fs.existsSync(CACHE_FILE)) {
+    try {
+      cache = JSON.parse(fs.readFileSync(CACHE_FILE, 'utf8')) || {}
+      // eslint-disable-next-line no-empty
+    } catch {}
+  }
+
+  // console.log('now - cache.lastCheck', now - cache.lastCheck, interval)
+  if (!force && cache.lastCheck && now - cache.lastCheck < interval) {
+    return cache.updateInfo || null
+  }
+
+  const latest = await fetchLatestVersion(pkg.name)
+  if (!latest) {
+    // console.log('无法获取最新版本')
+    return null
+  }
+
+  if (!semver.valid(pkg.version) || !semver.valid(latest)) {
+  return null
+}
+
+
+  if (semver.lt(pkg.version, latest)) {
+    // 构造 update 对象，兼容 update-notifier
+    const updateInfo = {
+      current: pkg.version,
+      latest,
+      type: semver.diff(pkg.version, latest) || 'patch',
+      name: pkg.name,
+      // 这里官方还会有 message 字段
+      // 用官方的默认消息格式生成，方便notify打印
+      message: `\nUpdate available ${pkg.version} → ${latest}\nRun npm i -g ${pkg.name} to update\n`
+    }
+
+    // 缓存
+    try {
+      fs.mkdirSync(CONFIG_DIR, { recursive: true })
+      fs.writeFileSync(
+        CACHE_FILE,
+        JSON.stringify(
+          {
+            lastCheck: now,
+            updateInfo
+          },
+          null,
+          2
+        )
+      )
+    } catch (e) {
+      console.error('缓存写入失败:', e)
+    }
+
+    const { current } = updateInfo
+    console.log(formatUpdateMessage(current, latest, pkg.name))
+    return updateInfo
+  }
+  // 无更新，刷新缓存时间
+  try {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true })
+    fs.writeFileSync(CACHE_FILE, JSON.stringify({ lastCheck: now }, null, 2))
+  } catch (e) {
+    console.error('缓存写入失败:', e)
+  }
+  return null
+}