wukong-gitlog-cli 1.0.37 → 1.0.38

package/.eslintrc

@@ -24,6 +24,7 @@
     "consistent-return": "off",
     "no-await-in-loop": "warn",
     "no-unused-vars": "warn",
+    "no-nested-ternary": "warn",
     "no-console": "off",
     "no-plusplus": "off",
     "no-unresolved": "off",

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 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.38](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v1.0.37...v1.0.38) (2025-12-27)
+
+
+### Features
+
+* 🎸 增加性能分析 ([ec925cc](https://github.com/tomatobybike/wukong-gitlog-cli/commit/ec925cc3d20be2a0eee6e20aaee99b4449eff9be))
+* 🎸 flame 和 显示 flame-like 日志 ([7b1a00c](https://github.com/tomatobybike/wukong-gitlog-cli/commit/7b1a00c26afa1757637e6c4a3a2be92d74e0ad65))
+* 🎸 ignore ([eb3e5bc](https://github.com/tomatobybike/wukong-gitlog-cli/commit/eb3e5bc89183e0722056036f14f74806e3c3b1e3))
+* 🎸 profiler ([48fd0a5](https://github.com/tomatobybike/wukong-gitlog-cli/commit/48fd0a5a8b25b55bbca7bbdbd2df11158049adcd))
+* 🎸 Profiler ([a7f4623](https://github.com/tomatobybike/wukong-gitlog-cli/commit/a7f4623a162947d31f25702052f54a4ff0406fcb))
+
 ### [1.0.37](https://github.com/tomatobybike/wukong-gitlog-cli/compare/v1.0.36...v1.0.37) (2025-12-12)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wukong-gitlog-cli",
-  "version": "1.0.37",
+  "version": "1.0.38",
   "description": "Advanced Git commit log exporter with Excel/JSON/TXT output, grouping, stats and CLI.",
   "keywords": [
     "git",
@@ -37,40 +37,42 @@
     "wukong-gitlog-cli": "./bin/wukong-gitlog-cli"
   },
   "scripts": {
+    "build": "node scripts/esbuild.config.mjs",
+    "check:npm:login": "node scripts/check-npm-login.mjs",
     "cli:excel-demo": "node ./src/cli.mjs --overtime --format excel --stats --limit 5 --out commits.xlsx",
     "cli:excel-demo-parent": "node ./src/cli.mjs --out-parent --format excel --stats --limit 5 --out commits-parent.xlsx",
     "cli:gerrit-changeid-demo": "node ./src/cli.mjs --format text --gerrit \"https://gerrit.example.com/c/project/+/{{changeId}}\" --limit 5 --out commits-gerrit-changeid.txt",
     "cli:gerrit-demo": "node ./src/cli.mjs --format text --gerrit \"https://gerrit.example.com/c/project/+/{{hash}}\" --limit 5 --out commits-gerrit.txt",
     "cli:help": "node ./src/cli.mjs --help",
     "cli:json-demo": "node ./src/cli.mjs --json --limit 5 --out commits.json",
-    "cli:text-demo": "node ./src/cli.mjs --format text --limit 5 --out commits.txt",
-    "cli:text-demo-parent": "node ./src/cli.mjs --out-parent --format text --limit 5 --out commits-parent.txt",
     "cli:overtime-demo": "node ./src/cli.mjs --overtime --format text --limit 200",
-    "cli:overtime-text": "node ./src/cli.mjs --overtime --limit 100 --format text --out commits.txt",
     "cli:overtime-excel": "node ./src/cli.mjs --overtime --limit 50 --format excel --out commits.xlsx",
-    "cli:overtime-text-us": "node ./src/cli.mjs --overtime --limit 50 --format text --out commits.txt --country US --work-start 10 --work-end 19 --lunch-start 12 --lunch-end 13",
-    "cli:overtime-text-us-parent": "node ./src/cli.mjs --out-parent --overtime --limit 50 --format text --out commits.txt --country US --work-start 10 --work-end 19 --lunch-start 12 --lunch-end 13",
-    "cli:overtime-text-us-outdir": "node ./src/cli.mjs --out-dir ../output --overtime --limit 50 --format text --out commits.txt --country US --work-start 10 --work-end 19 --lunch-start 12 --lunch-end 13",
     "cli:overtime-excel-cn": "node ./src/cli.mjs --overtime --limit 50 --format excel --out commits.xlsx --country CN",
-    "cli:overtime-excel-cn-parent": "node ./src/cli.mjs --out-parent --overtime --limit 50 --format excel --out commits.xlsx --country CN",
     "cli:overtime-excel-cn-outdir": "node ./src/cli.mjs --out-dir ../output --overtime --limit 50 --format excel --out commits.xlsx --country CN",
+    "cli:overtime-excel-cn-parent": "node ./src/cli.mjs --out-parent --overtime --limit 50 --format excel --out commits.xlsx --country CN",
     "cli:overtime-per-period-csv-tab": "node ./src/cli.mjs --overtime --limit 200 --format text --out commits.txt --per-period-formats csv,tab",
-    "cli:overtime-per-period-xlsx-sheets": "node ./src/cli.mjs --overtime --limit 200 --format text --out commits.txt --per-period-formats csv,tab,xlsx --per-period-excel-mode sheets",
-    "cli:overtime-per-period-xlsx-files": "node ./src/cli.mjs --overtime --limit 200 --format text --out commits.txt --per-period-formats xlsx --per-period-excel-mode files",
     "cli:overtime-per-period-only": "node ./src/cli.mjs --overtime --limit 200 --format text --out commits.txt --per-period-formats csv,tab,xlsx --per-period-only",
+    "cli:overtime-per-period-xlsx-files": "node ./src/cli.mjs --overtime --limit 200 --format text --out commits.txt --per-period-formats xlsx --per-period-excel-mode files",
+    "cli:overtime-per-period-xlsx-sheets": "node ./src/cli.mjs --overtime --limit 200 --format text --out commits.txt --per-period-formats csv,tab,xlsx --per-period-excel-mode sheets",
+    "cli:overtime-text": "node ./src/cli.mjs --overtime --limit 100 --format text --out commits.txt",
+    "cli:overtime-text-us": "node ./src/cli.mjs --overtime --limit 50 --format text --out commits.txt --country US --work-start 10 --work-end 19 --lunch-start 12 --lunch-end 13",
+    "cli:overtime-text-us-outdir": "node ./src/cli.mjs --out-dir ../output --overtime --limit 50 --format text --out commits.txt --country US --work-start 10 --work-end 19 --lunch-start 12 --lunch-end 13",
+    "cli:overtime-text-us-parent": "node ./src/cli.mjs --out-parent --overtime --limit 50 --format text --out commits.txt --country US --work-start 10 --work-end 19 --lunch-start 12 --lunch-end 13",
     "cli:serve": "node ./src/cli.mjs --serve --overtime --format text --out commits.txt",
     "cli:serve-only": "node ./src/cli.mjs --serve-only",
+    "cli:text-demo": "node ./src/cli.mjs --format text --limit 5 --out commits.txt",
+    "cli:text-demo-parent": "node ./src/cli.mjs --out-parent --format text --limit 5 --out commits-parent.txt",
     "format": "prettier --write \"src/**/*.{js,mjs}\"",
     "lint": "eslint src --ext .js,.mjs src",
     "lint:fix": "eslint src --ext .js,.mjs --fix",
     "pack": "npm pack",
-    "build": "node scripts/esbuild.config.mjs",
     "prepare": "husky install",
-    "prettierall": "npx prettier --write 'src/**/*.{js,jsx}'",
     "prepublishOnly": "yarn lint && yarn build",
-    "check:npm:login": "node scripts/check-npm-login.mjs",
-    "release": "yarn check:npm:login && yarn release:patch && yarn push:tags && npm publish",
+    "prettierall": "npx prettier --write 'src/**/*.{js,jsx}'",
     "push:tags": "git push origin main --follow-tags",
+    "prerelease": "yarn lint",
+    "release": "yarn check:npm:login && yarn release:patch && npm publish && yarn push:tags",
+    "release:rollback": "git reset --hard HEAD~1 && git tag -d $(git tag --points-at HEAD~1)",
     "release:major": "yarn lint && standard-version --release-as major",
     "release:minor": "yarn lint && standard-version --release-as minor",
     "release:patch": "yarn lint && standard-version --release-as patch",
@@ -94,15 +96,16 @@
     "boxen": "8.0.1",
     "chalk": "5.6.2",
     "commander": "12.1.0",
+    "date-fns": "4.1.0",
     "date-holidays": "2.1.1",
     "dayjs": "1.11.19",
-    "date-fns": "4.1.0",
     "dotenv": "17.2.2",
     "exceljs": "4.4.0",
     "is-online": "12.0.2",
     "ora": "9.0.0",
     "semver": "6.3.1",
     "string-width": "5.1.2",
+    "wukong-profiler": "^1.0.5",
     "zx": "7.2.4"
   },
   "devDependencies": {

package/src/index.mjs

@@ -6,6 +6,7 @@ import fs from 'fs'
 import ora from 'ora'
 import path from 'path'
 import { fileURLToPath } from 'url'
+import { createProfiler } from 'wukong-profiler'
 
 import { parseOptions } from './cli/parseOptions.mjs'
 // eslint-disable-next-line no-unused-vars
@@ -50,6 +51,8 @@ dayjs.extend(isoWeek)
 const PKG_NAME = pkg.name
 const VERSION = pkg.version
 
+let profiler
+
 const autoCheckUpdate = async () => {
   // === CLI 主逻辑完成后提示更新 ===
   await checkUpdateWithPatch({
@@ -83,8 +86,6 @@ export function getWeekRange(periodStr) {
 }
 
 const main = async () => {
-  const startTime = performance.now()
-
   const program = new Command()
 
   program
@@ -185,12 +186,31 @@ const main = async () => {
       '仅启动 web 服务，不导出或分析数据（使用 output-wukong/data 中已有的数据）'
     )
     .option('--version', 'show version information')
+    .option('--profile', '输出性能分析 JSON')
+    .option('--verbose', '显示详细性能日志')
+    .option('--flame', '显示 flame-like 日志')
+    .option('--trace <file>', '生成 Chrome Trace')
+    .option('--hot-threshold <n>', 'HOT 比例阈值', parseFloat, 0.8)
+    .option('--fail-on-hot', 'HOT 时 CI 失败')
+    .option('--diff-base <file>', '基线 profile.json')
+    .option('--diff-threshold <n>', '回归阈值', parseFloat, 0.2)
     .parse()
 
   const opts = program.opts()
 
   const config = parseOptions(opts)
 
+  profiler = createProfiler({
+    enabled: opts.profile,
+    verbose: opts.verbose,
+    flame: opts.flame,
+    traceFile: opts.trace,
+    hotThreshold: opts.hotThreshold,
+    failOnHot: opts.failOnHot,
+    diffBaseFile: opts.diffBase,
+    diffThreshold: opts.diffThreshold
+  })
+
   // ❗只创建一次缓存实例
   const getOvertimeStats = createOvertimeStats(config)
 
@@ -324,6 +344,7 @@ const main = async () => {
 
   // --- 分组 ---
   const groups = opts.groupBy ? groupRecords(records, opts.groupBy) : null
+  profiler.step('load config')
 
   // If serve mode is enabled, write data modules and launch the web server
   if (opts.serve) {
@@ -332,7 +353,12 @@ const main = async () => {
 
   // --- Overtime analysis ---
   if (opts.overtime) {
+    await profiler.stepAsync('getOvertimeStats', async () => {
+      await getOvertimeStats(records)
+    })
     const stats = getOvertimeStats(records)
+
+    profiler.step('load getOvertimeStats')
     // Output to console
     console.log('\n--- Overtime analysis ---\n')
     console.log(renderOvertimeText(stats))
@@ -579,7 +605,7 @@ const main = async () => {
     const jsonText = renderAuthorChangesJson(records)
     writeJSON(outputFilePath('author-changes.json', outDir), jsonText)
     logDev(`JSON 已导出: ${filepath}`)
-    handleSuccess({ startTime, spinner })
+    handleSuccess({ spinner })
     return
   }
 
@@ -593,11 +619,11 @@ const main = async () => {
       renderChangedLinesText(records)
     )
 
-    console.log('\n Commits List:\n', text, '\n')
+    // console.log('\n Commits List:\n', text, '\n')
 
     logDev(`文本已导出: ${filepath}`)
 
-    handleSuccess({ startTime, spinner })
+    handleSuccess({ spinner })
 
     return
   }
@@ -621,10 +647,32 @@ const main = async () => {
     logDev(`Excel 已导出: ${excelPath}`)
     logDev(`文本已自动导出: ${txtPath}`)
 
-    handleSuccess({ startTime, spinner })
+    handleSuccess({ spinner })
   }
 
   await autoCheckUpdate()
+
+  handleSuccess({ spinner })
 }
 
-main()
+try {
+  await main()
+} catch (err) {
+  console.error(err)
+  process.exitCode = 1
+} finally {
+  if (profiler) {
+    const result = profiler.end('git-commits')
+
+    // --profile 时输出 JSON
+    if (process.argv.includes('--profile')) {
+      const json = {
+        command: 'git-commits',
+        version: VERSION,
+        timestamp: Date.now(),
+        profile: result
+      }
+      console.log(JSON.stringify(json, null, 2))
+    }
+  }
+}

package/src/utils/handleSuccess.mjs

@@ -4,9 +4,6 @@ import { performance } from 'perf_hooks'
 import { exitWithTime } from './exitWithTime.mjs'
 import { costTimer } from './timer.mjs'
 
-export const handleSuccess = ({ message = 'Done', startTime, spinner }) => {
+export const handleSuccess = ({ message = 'Done', spinner }) => {
   spinner.succeed(message)
-
-  // 如果需要退出，可以调用 exitWithTime
-  exitWithTime(startTime, 0)
 }

package/src/utils/profiler/diff.mjs

@@ -0,0 +1,26 @@
+export const diffProfiles = (prev, curr, threshold = 0.2) => {
+  const map = new Map()
+
+  prev.events.forEach(e => {
+    map.set(e.name, e.duration)
+  })
+
+  const regressions = []
+
+  curr.events.forEach(e => {
+    const before = map.get(e.name)
+    if (!before) return
+
+    const diff = (e.duration - before) / before
+    if (diff >= threshold) {
+      regressions.push({
+        name: e.name,
+        before,
+        after: e.duration,
+        diff
+      })
+    }
+  })
+
+  return regressions
+}

package/src/utils/profiler/format.mjs

@@ -0,0 +1,11 @@
+export 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`
+}
+
+export const makeBar = (ratio, width = 32) => {
+  const len = Math.max(1, Math.round(ratio * width))
+  return '█'.repeat(len)
+}

package/src/utils/profiler/index.mjs

@@ -0,0 +1,144 @@
+import chalk from 'chalk'
+import fs from 'fs'
+import { formatTime, makeBar } from './format.mjs'
+import { exportChromeTrace } from './trace.mjs'
+import { diffProfiles } from './diff.mjs'
+
+export const createProfiler = ({
+  enabled = false,
+  verbose = false,
+  flame = false,
+  slowThreshold = 500,
+  hotThreshold = 0.8,
+  traceFile,
+  failOnHot = false,
+  diffBaseFile,
+  diffThreshold = 0.2
+} = {}) => {
+  const start = process.hrtime.bigint()
+
+
+  const stack = []
+  const events = []
+
+  const toMs = (a, b) => Number(b - a) / 1e6
+
+  /* ================= step ================= */
+
+  const step = (name, fn) => {
+    const parent = stack[stack.length - 1]
+    const startTime = process.hrtime.bigint()
+
+    const node = {
+      name,
+      start: toMs(start, startTime),
+      duration: 0,
+      depth: stack.length,
+      children: []
+    }
+
+    if (parent) parent.children.push(node)
+    stack.push(node)
+
+    const finish = () => {
+      const endTime = process.hrtime.bigint()
+      node.duration = toMs(startTime, endTime)
+      events.push(node)
+      stack.pop()
+    }
+
+    if (typeof fn === 'function') {
+      try {
+        return fn()
+      } finally {
+        finish()
+      }
+    } else {
+      finish()
+    }
+  }
+
+  /* ================= end ================= */
+
+  const end = (label = 'Total') => {
+    const total = toMs(start, process.hrtime.bigint())
+
+    let hasHot = false
+
+    if (enabled || verbose) {
+      console.log(
+        chalk.cyan('⏱'),
+        chalk.bold(label),
+        chalk.yellow(formatTime(total))
+      )
+
+      if (flame) {
+        for (const e of events) {
+          const ratio = e.duration / total
+          const hot = ratio >= hotThreshold
+          const slow = e.duration >= slowThreshold
+
+          if (hot) hasHot = true
+
+          console.log(
+            chalk.gray(`${'  '.repeat(e.depth)  }├─`),
+            chalk.white(e.name.padEnd(22)),
+            chalk.yellow(formatTime(e.duration)),
+            chalk.gray(makeBar(ratio)),
+            hot
+              ? chalk.red.bold(' 🔥 HOT')
+              : slow
+              ? chalk.yellow(' ⚠ SLOW')
+              : ''
+          )
+        }
+      }
+    }
+
+    const profile = { total, events }
+
+    /* ---------- Chrome Trace ---------- */
+
+    if (traceFile) {
+      exportChromeTrace(events, traceFile)
+    }
+
+    /* ---------- diff ---------- */
+    if (diffBaseFile && fs.existsSync(diffBaseFile)) {
+      const base = JSON.parse(fs.readFileSync(diffBaseFile, 'utf8'))
+      const regressions = diffProfiles(base, profile, diffThreshold)
+
+      if (regressions.length) {
+        console.log(chalk.red('\n⚠ Performance Regression Detected:\n'))
+        regressions.forEach(r => {
+          console.log(
+            chalk.red(
+              `  ${r.name}: ${formatTime(r.before)} → ${formatTime(
+                r.after
+              )} (+${(r.diff * 100).toFixed(1)}%)`
+            )
+          )
+        })
+        process.exitCode = 1
+      }
+    }
+
+    /* ---------- save profile ---------- */
+    if (enabled) {
+      fs.writeFileSync(
+        'profile.json',
+        JSON.stringify(profile, null, 2)
+      )
+    }
+
+    /* ---------- CI HOT fail ---------- */
+    if (failOnHot && hasHot) {
+      console.log(chalk.red('\n🔥 HOT step detected — failing CI'))
+      process.exitCode = 1
+    }
+
+    return profile
+  }
+
+  return { step, end }
+}

package/src/utils/profiler/trace.mjs

@@ -0,0 +1,26 @@
+import fs from 'fs'
+
+export const exportChromeTrace = (events, file) => {
+  const traceEvents = []
+
+  for (const e of events) {
+    traceEvents.push({
+      name: e.name,
+      cat: 'cli',
+      ph: 'X',                 // complete event
+      ts: e.start * 1000,      // μs
+      dur: e.duration * 1000,  // μs
+      pid: 1,
+      tid: e.depth || 0
+    })
+  }
+
+  const trace = {
+    traceEvents,
+    displayTimeUnit: 'ms'
+  }
+
+  fs.writeFileSync(file, JSON.stringify(trace, null, 2))
+  // TODO: remove debug log before production
+  console.log('✅', 'file', file);
+}

package/src/utils/profiler.mjs

@@ -0,0 +1,101 @@
+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/time/scopeTimer.mjs

@@ -0,0 +1,37 @@
+// utils/scopeTimer.js
+import chalk from 'chalk'
+
+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`
+}
+
+export const createScopeTimer = (scope) => {
+  const start = process.hrtime.bigint()
+  let last = start
+
+  const step = (label) => {
+    const now = process.hrtime.bigint()
+    const ms = Number(now - last) / 1e6
+    last = now
+
+    console.log(
+      chalk.gray('  ├─'),
+      chalk.white(label),
+      chalk.yellow(formatTime(ms))
+    )
+  }
+
+  const end = () => {
+    const total = Number(process.hrtime.bigint() - start) / 1e6
+    console.log(
+      chalk.cyan('⏱'),
+      chalk.bold(scope),
+      chalk.yellow(formatTime(total))
+    )
+  }
+
+  return { step, end }
+}

package/src/utils/time/timer.mjs

@@ -0,0 +1,33 @@
+// utils/timer.js
+import chalk from 'chalk'
+
+const ENABLED = process.env.CLI_TIMER !== 'false'
+
+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`
+}
+
+export const createTimer = (label, { silent = false } = {}) => {
+  const start = process.hrtime.bigint()
+
+  const stop = (suffix) => {
+    if (!ENABLED || silent) return
+
+    const end = process.hrtime.bigint()
+    const ms = Number(end - start) / 1e6
+
+    console.log(
+      chalk.cyan('⏱'),
+      chalk.white(label),
+      suffix ? chalk.gray(`(${suffix})`) : '',
+      chalk.bold.yellow(formatTime(ms))
+    )
+
+    return ms
+  }
+
+  return { stop }
+}

package/src/utils/time/withTimer.mjs

@@ -0,0 +1,11 @@
+// utils/withTimer.js
+import { createTimer } from './timer.mjs'
+
+export const withTimer = async (label, fn, opts) => {
+  const timer = createTimer(label, opts)
+  try {
+    return await fn()
+  } finally {
+    timer.stop()
+  }
+}