@angli/unit-test-tool 0.1.0

package/docs/demo.sh

@@ -0,0 +1,266 @@
+#!/bin/bash
+
+# 自动单元测试执行脚本
+# 用途：逐个读取 serviceToTest.txt 中的类名，自动编写单元测试
+# 支持 Claude Code 和 Codex 两种模式
+
+set -uo pipefail
+
+# ============================================
+# 配置变量
+# ============================================
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+WORKSPACE_DIR="${SCRIPT_DIR}"
+SERVICE_LIST_FILE="${WORKSPACE_DIR}/serviceToTest.txt"
+TEST_INFO_FILE="${WORKSPACE_DIR}/testInfo.txt"
+TEMP_DIR="${WORKSPACE_DIR}/tmp_logs"
+
+# 选择运行模式: "claude" 或 "codex"（如果未设置则由用户选择）
+RUN_MODE=""
+
+# Claude Code 配置
+CLAUDE_CMD=(claude)
+
+# Codex 配置
+CODEX_CMD=(
+    codex exec
+    --dangerously-bypass-approvals-and-sandbox
+    --cd "${WORKSPACE_DIR}"
+)
+
+# ============================================
+# 颜色输出
+# ============================================
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+log_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
+log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
+log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
+log_step() { echo -e "${BLUE}[STEP]${NC} $1"; }
+
+# ============================================
+# 解析命令行参数
+# ============================================
+parse_args() {
+    if [ $# -gt 0 ]; then
+        case "$1" in
+            claude|codex)
+                RUN_MODE="$1"
+                log_info "使用命令行指定的运行模式: $RUN_MODE"
+                ;;
+            *)
+                echo "用法: $0 [claude|codex]"
+                echo "  不带参数时，会交互式选择运行模式"
+                echo "  claude  - 使用 Claude Code 执行"
+                echo "  codex   - 使用 Codex 执行"
+                exit 1
+                ;;
+        esac
+    fi
+}
+
+# ============================================
+# 交互式选择运行模式
+# ============================================
+select_run_mode() {
+    # 如果 RUN_MODE 已是有效值，直接使用
+    if [ "$RUN_MODE" = "claude" ] || [ "$RUN_MODE" = "codex" ]; then
+        log_info "使用已设置的运行模式: $RUN_MODE"
+        return
+    fi
+
+    echo ""
+    echo "请选择运行模式:"
+    echo "  1) claude  - 使用 Claude Code 执行"
+    echo "  2) codex   - 使用 Codex 执行"
+    echo ""
+    read -p "请输入选项 [1]: " choice
+
+    case "$choice" in
+        1|"")
+            RUN_MODE="claude"
+            ;;
+        2)
+            RUN_MODE="codex"
+            ;;
+        *)
+            log_error "无效的选项: $choice"
+            exit 1
+            ;;
+    esac
+}
+
+# ============================================
+# 检查前置条件
+# ============================================
+check_prerequisites() {
+    # 确保 RUN_MODE 已设置
+    if [ -z "$RUN_MODE" ]; then
+        log_error "运行模式未设置"
+        exit 1
+    fi
+
+    log_step "检查前置条件..."
+
+    if [ ! -f "$SERVICE_LIST_FILE" ]; then
+        log_error "待测试文件清单不存在: $SERVICE_LIST_FILE"
+        exit 1
+    fi
+
+    if [ "$RUN_MODE" = "codex" ]; then
+        if ! command -v codex >/dev/null 2>&1; then
+            log_error "codex 命令未找到"
+            exit 1
+        fi
+    elif [ "$RUN_MODE" = "claude" ]; then
+        if ! command -v claude >/dev/null 2>&1; then
+            log_error "claude 命令未找到"
+            exit 1
+        fi
+    else
+        log_error "未知的运行模式: $RUN_MODE，请设置 RUN_MODE 为 'claude' 或 'codex'"
+        exit 1
+    fi
+
+    mkdir -p "${TEMP_DIR}"
+    touch "${TEST_INFO_FILE}"
+
+    cd "$WORKSPACE_DIR" || exit 1
+
+    log_info "运行模式: $RUN_MODE"
+    log_info "前置检查通过"
+}
+
+# ============================================
+# 获取下一个待处理的类
+# ============================================
+get_next_service() {
+    awk 'NF { print; exit }' "$SERVICE_LIST_FILE"
+}
+
+# ============================================
+# 移除已完成的类
+# ============================================
+remove_completed_service() {
+    local tmp_file="${SERVICE_LIST_FILE}.tmp"
+
+    awk '
+        BEGIN { removed = 0 }
+        {
+            if (!removed && NF) {
+                removed = 1
+                next
+            }
+            print
+        }
+    ' "$SERVICE_LIST_FILE" > "$tmp_file" && mv "$tmp_file" "$SERVICE_LIST_FILE"
+}
+
+# ============================================
+# 构建 prompt
+# ============================================
+build_prompt() {
+    local service_class=$1
+
+    if [ "$RUN_MODE" = "codex" ]; then
+        cat <<EOF
+参考单测Skill对给定的类${service_class}编写单元测试，将单测结论追加到testInfo.txt文件。
+EOF
+    elif [ "$RUN_MODE" = "claude" ]; then
+        # Claude Code 使用相同的 prompt
+        echo "参考单测Skill对给定的类${service_class}编写单元测试，将单测结论追加到testInfo.txt文件。"
+    fi
+}
+
+# ============================================
+# 执行单元测试编写
+# ============================================
+run_unit_test() {
+    local service_class=$1
+    local class_name
+    local prompt
+    local log_file
+    local exit_code
+
+    class_name=$(echo "$service_class" | rev | cut -d'.' -f1 | rev)
+    log_file="${TEMP_DIR}/${RUN_MODE}_output_${class_name}.log"
+    prompt=$(build_prompt "$service_class")
+
+    log_step "=========================================="
+    log_step "处理: $service_class"
+    log_step "=========================================="
+    log_info "日志文件: $log_file"
+    log_info "使用模式: $RUN_MODE"
+
+    if [ "$RUN_MODE" = "codex" ]; then
+        printf '%s\n' "$prompt" | "${CODEX_CMD[@]}" - 2>&1 | tee "$log_file"
+        exit_code=${PIPESTATUS[1]}
+    elif [ "$RUN_MODE" = "claude" ]; then
+        # Claude Code: 使用 claude -p 命令配合 prompt
+        "${CLAUDE_CMD[@]}" -p "$prompt" --verbose --output-format stream-json 2>&1 | tee "$log_file"
+        exit_code=${PIPESTATUS[0]}
+    fi
+
+    log_info "$RUN_MODE 执行完成，退出码: $exit_code"
+
+    if [ "$exit_code" -ne 0 ]; then
+        log_error "$RUN_MODE 执行失败，当前类未从 serviceToTest.txt 中移除"
+        return "$exit_code"
+    fi
+
+    remove_completed_service
+    log_info "已完成并从队列中移除: $service_class"
+
+    return 0
+}
+
+# ============================================
+# 显示剩余待处理数量
+# ============================================
+show_remaining() {
+    local count
+    count=$(awk 'NF { count++ } END { print count + 0 }' "$SERVICE_LIST_FILE")
+    log_info "剩余待测试: $count"
+}
+
+# ============================================
+# 主流程
+# ============================================
+main() {
+    local service
+
+    echo ""
+    log_info "=========================================="
+    log_info "    自动单元测试编写脚本"
+    log_info "=========================================="
+    echo ""
+
+    parse_args "$@"
+    select_run_mode
+    check_prerequisites
+    show_remaining
+
+    while true; do
+        service=$(get_next_service)
+
+        if [ -z "$service" ]; then
+            echo ""
+            log_info "=========================================="
+            log_info "    所有单元测试已完成"
+            log_info "=========================================="
+            break
+        fi
+
+        if ! run_unit_test "$service"; then
+            exit 1
+        fi
+
+        show_remaining
+    done
+}
+
+main "$@"

package/docs/skill-integration.md

@@ -0,0 +1,15 @@
+# Skill 集成说明
+
+建议将本工具作为 OpenClaw skill 的外部 CLI 入口使用。
+
+推荐映射：
+- `init`：初始化配置与基线
+- `analyze`：分析测试框架与覆盖率现状
+- `run`：调用 Claude CLI 完成补测
+- `verify`：执行全量校验
+- `status`：查看运行状态
+- `report`：输出最终报告
+
+建议外部调度：
+- 直接调用 `run` 并在失败时重试或人工介入
+- 需要周期性汇总时调用 `status/report`

package/docs/state-machine.md

@@ -0,0 +1,15 @@
+# 状态说明
+
+阶段枚举：
+- INIT
+- ANALYZE_BASELINE
+- WRITING_TESTS
+- VERIFYING_FULL
+- BLOCKED
+- DONE
+
+典型流程：
+1. analyzeBaseline 进入 ANALYZE_BASELINE
+2. runWithClaudeCli 进入 WRITING_TESTS
+3. verifyAll 进入 VERIFYING_FULL
+4. 验证通过进入 DONE，否则进入 BLOCKED

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@angli/unit-test-tool",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "testbot": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/cli/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "commander": "^14.0.0",
+    "execa": "^9.6.0",
+    "fast-glob": "^3.3.3",
+    "pino": "^10.0.0",
+    "zod": "^4.1.11"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/cli/commands/analyze.ts

@@ -0,0 +1,22 @@
+import { Command } from 'commander'
+import { createContext } from '../context/create-context.js'
+import { analyzeBaseline } from '../../core/tools/analyze-baseline.js'
+import { buildIncludeFromScanDir } from '../utils/scan-dir.js'
+
+export function registerAnalyzeCommand(program: Command) {
+  program
+    .command('analyze')
+    .option('--project <path>', 'project path')
+    .option('--target <number>', 'coverage target', '80')
+    .option('--scan-dir <dir>', 'scan dir (default: src)')
+    .action(async (options) => {
+      const include = buildIncludeFromScanDir(options.scanDir ?? 'src')
+      const ctx = await createContext({
+        projectPath: options.project ?? process.cwd(),
+        coverageTarget: Number(options.target),
+        configOverrides: include ? { include } : undefined
+      })
+      const result = await analyzeBaseline(ctx)
+      console.log(result.summary)
+    })
+}

package/src/cli/commands/guard.ts

@@ -0,0 +1,28 @@
+import { Command } from 'commander'
+import { createContext } from '../context/create-context.js'
+import { runGuard } from '../../core/tools/guard.js'
+import { parseDuration } from '../../utils/duration.js'
+
+export function registerGuardCommand(program: Command) {
+  program
+    .command('guard')
+    .option('--project <path>', 'project path')
+    .option('--stale-timeout <duration>', 'heartbeat stale timeout (default: 2m)')
+    .option('--max-restart <count>', 'max restart attempts (default: 3)')
+    .option('--cooldown <duration>', 'restart cooldown (default: 60s)')
+    .action(async (options) => {
+      const ctx = await createContext({
+        projectPath: options.project ?? process.cwd(),
+        coverageTarget: 80
+      })
+      const staleTimeoutMs = options.staleTimeout ? parseDuration(options.staleTimeout) : undefined
+      const cooldownMs = options.cooldown ? parseDuration(options.cooldown) : undefined
+      const maxRestart = options.maxRestart ? Number(options.maxRestart) : undefined
+      const result = await runGuard(ctx, {
+        staleTimeoutMs: staleTimeoutMs,
+        maxRestart,
+        cooldownMs
+      })
+      console.log(result.summary)
+    })
+}

package/src/cli/commands/init.ts

@@ -0,0 +1,41 @@
+import { Command } from 'commander'
+import { createContext } from '../context/create-context.js'
+import { buildIncludeFromScanDir } from '../utils/scan-dir.js'
+
+export function registerInitCommand(program: Command) {
+  program
+    .command('init')
+    .requiredOption('--project <path>', 'project path')
+    .option('--target <number>', 'coverage target', '80')
+    .option('--scan-dir <dir>', 'scan dir (default: src)')
+    .option('--verify-cmd <cmd>', 'override full verify command')
+    .option('--lint-cmd <cmd>', 'override lint command')
+    .option('--typecheck-cmd <cmd>', 'override typecheck command')
+    .option('--system-append <text>', 'append project-level system prompt guidance')
+    .option('--task-append <text>', 'append project-level task prompt guidance')
+    .option('--retry-append <text>', 'append project-level retry prompt guidance')
+    .action(async (options) => {
+      const include = buildIncludeFromScanDir(options.scanDir ?? 'src')
+      const commandOverrides = {
+        ...(options.verifyCmd ? { verifyFull: options.verifyCmd } : {}),
+        ...(options.lintCmd ? { lint: options.lintCmd } : {}),
+        ...(options.typecheckCmd ? { typecheck: options.typecheckCmd } : {})
+      }
+      const promptOverrides = {
+        ...(options.systemAppend ? { systemAppend: options.systemAppend } : {}),
+        ...(options.taskAppend ? { taskAppend: options.taskAppend } : {}),
+        ...(options.retryAppend ? { retryAppend: options.retryAppend } : {})
+      }
+      const ctx = await createContext({
+        projectPath: options.project,
+        coverageTarget: Number(options.target),
+        configOverrides: {
+          ...(include ? { include } : {}),
+          ...(Object.keys(commandOverrides).length > 0 ? { commandOverrides } : {}),
+          ...(Object.keys(promptOverrides).length > 0 ? { promptOverrides } : {})
+        }
+      })
+      await ctx.fileSystem.writeJson(ctx.paths.configPath, ctx.config)
+      console.log('config saved')
+    })
+}

package/src/cli/commands/run.ts

@@ -0,0 +1,79 @@
+import { Command } from 'commander'
+import { createContext } from '../context/create-context.js'
+import { buildIncludeFromScanDir } from '../utils/scan-dir.js'
+import { runWithClaudeCli } from '../../core/tools/run-with-claude-cli.js'
+import { startLifecycle } from '../../utils/process-lifecycle.js'
+
+export function registerRunCommand(program: Command) {
+  program
+    .command('run')
+    .option('--project <path>', 'project path')
+    .option('--target <number>', 'coverage target', '80')
+    .option('--scan-dir <dir>', 'scan dir (default: src)')
+    .option('--file <path>', 'explicit target source file')
+    .option('--topN <number>', 'recommendation pool size', '5')
+    .option('--permission-mode <mode>', 'Claude CLI permission mode')
+    .option('--allowed-tools <tools>', 'comma-separated Claude CLI allowed tools')
+    .option('--timeout <ms>', 'Claude CLI timeout in ms')
+    .option('--verify-cmd <cmd>', 'override full verify command')
+    .option('--lint-cmd <cmd>', 'override lint command')
+    .option('--typecheck-cmd <cmd>', 'override typecheck command')
+    .action(async (options) => {
+      const include = buildIncludeFromScanDir(options.scanDir ?? 'src')
+      const commandOverrides = {
+        ...(options.verifyCmd ? { verifyFull: options.verifyCmd } : {}),
+        ...(options.lintCmd ? { lint: options.lintCmd } : {}),
+        ...(options.typecheckCmd ? { typecheck: options.typecheckCmd } : {})
+      }
+
+      const ctx = await createContext({
+        projectPath: options.project ?? process.cwd(),
+        coverageTarget: Number(options.target),
+        configOverrides: {
+          ...(include ? { include } : {}),
+          ...(Object.keys(commandOverrides).length > 0 ? { commandOverrides } : {})
+        }
+      })
+
+      await ctx.fileSystem.writeJson(ctx.paths.configPath, ctx.config)
+
+      const lifecycle = await startLifecycle(ctx, {
+        command: 'run',
+        argv: process.argv.slice(2)
+      })
+
+      try {
+        const result = await runWithClaudeCli(ctx, {
+          targetFile: options.file,
+          topN: Number(options.topN),
+          permissionMode: options.permissionMode,
+          allowedTools: parseAllowedTools(options.allowedTools),
+          timeoutMs: options.timeout ? Number(options.timeout) : undefined
+        })
+
+        console.log(result.summary)
+        if (result.artifacts?.finalReportPath) {
+          console.log(`report: ${result.artifacts.finalReportPath}`)
+        }
+
+        await lifecycle.stop()
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error)
+        await ctx.lifecycleStore.patch({
+          status: 'crashed',
+          lastError: message,
+          updatedAt: ctx.clock.nowIso()
+        })
+        throw error
+      }
+    })
+}
+
+function parseAllowedTools(value?: string): string[] | undefined {
+  if (!value) return undefined
+  const tools = value
+    .split(',')
+    .map((item) => item.trim())
+    .filter(Boolean)
+  return tools.length > 0 ? tools : undefined
+}

package/src/cli/commands/schedule.ts

@@ -0,0 +1,32 @@
+import { Command } from 'commander'
+import { createContext } from '../context/create-context.js'
+import { parseDuration } from '../../utils/duration.js'
+import { runSchedule } from '../../core/tools/guard.js'
+
+const DEFAULT_INTERVAL_MS = 5 * 60_000
+
+export function registerScheduleCommand(program: Command) {
+  program
+    .command('schedule')
+    .option('--project <path>', 'project path')
+    .option('--interval <duration>', 'guard interval (default: 5m)')
+    .option('--stale-timeout <duration>', 'heartbeat stale timeout (default: 2m)')
+    .option('--max-restart <count>', 'max restart attempts (default: 3)')
+    .option('--cooldown <duration>', 'restart cooldown (default: 60s)')
+    .action(async (options) => {
+      const ctx = await createContext({
+        projectPath: options.project ?? process.cwd(),
+        coverageTarget: 80
+      })
+      const intervalMs = options.interval ? parseDuration(options.interval) ?? DEFAULT_INTERVAL_MS : DEFAULT_INTERVAL_MS
+      const staleTimeoutMs = options.staleTimeout ? parseDuration(options.staleTimeout) : undefined
+      const cooldownMs = options.cooldown ? parseDuration(options.cooldown) : undefined
+      const maxRestart = options.maxRestart ? Number(options.maxRestart) : undefined
+      console.log(`[schedule] interval=${intervalMs}ms`)
+      await runSchedule(ctx, intervalMs, {
+        staleTimeoutMs,
+        maxRestart,
+        cooldownMs
+      })
+    })
+}

package/src/cli/commands/start.ts

@@ -0,0 +1,111 @@
+import { Command } from 'commander'
+import { createContext } from '../context/create-context.js'
+import { analyzeBaseline } from '../../core/tools/analyze-baseline.js'
+import { runLoop } from '../../core/tools/run-loop.js'
+import { reportStatus } from '../../core/reporter/index.js'
+import { buildIncludeFromScanDir } from '../utils/scan-dir.js'
+import { startLifecycle } from '../../utils/process-lifecycle.js'
+import { runSchedule } from '../../core/tools/guard.js'
+import { parseDuration } from '../../utils/duration.js'
+
+const DEFAULT_GUARD_INTERVAL_MS = 5 * 60_000
+
+export function registerStartCommand(program: Command) {
+  program
+    .command('start')
+    .option('--project <path>', 'project path')
+    .option('--target <number>', 'coverage target', '80')
+    .option('--topN <number>', 'recommendation pool size', '5')
+    .option('--scan-dir <dir>', 'scan dir (default: src)')
+    .option('--file <path>', 'explicit target source file')
+    .option('--permission-mode <mode>', 'Claude CLI permission mode')
+    .option('--allowed-tools <tools>', 'comma-separated Claude CLI allowed tools')
+    .option('--timeout <ms>', 'Claude CLI timeout in ms')
+    .option('--verify-cmd <cmd>', 'override full verify command')
+    .option('--lint-cmd <cmd>', 'override lint command')
+    .option('--typecheck-cmd <cmd>', 'override typecheck command')
+    .option('--schedule', 'run built-in guard schedule')
+    .option('--guard-interval <duration>', 'guard interval (default: 5m)')
+    .option('--stale-timeout <duration>', 'heartbeat stale timeout (default: 2m)')
+    .option('--max-restart <count>', 'max restart attempts (default: 3)')
+    .option('--cooldown <duration>', 'restart cooldown (default: 60s)')
+    .action(async (options) => {
+      const include = buildIncludeFromScanDir(options.scanDir ?? 'src')
+      const commandOverrides = {
+        ...(options.verifyCmd ? { verifyFull: options.verifyCmd } : {}),
+        ...(options.lintCmd ? { lint: options.lintCmd } : {}),
+        ...(options.typecheckCmd ? { typecheck: options.typecheckCmd } : {})
+      }
+
+      console.log('[1/4] 初始化配置...')
+      const ctx = await createContext({
+        projectPath: options.project ?? process.cwd(),
+        coverageTarget: Number(options.target),
+        configOverrides: {
+          ...(include ? { include } : {}),
+          ...(Object.keys(commandOverrides).length > 0 ? { commandOverrides } : {})
+        }
+      })
+      await ctx.fileSystem.writeJson(ctx.paths.configPath, ctx.config)
+      console.log(`[1/4] 初始化完成：${ctx.paths.configPath}`)
+
+      const lifecycle = await startLifecycle(ctx, {
+        command: 'start',
+        argv: process.argv.slice(2)
+      })
+
+      try {
+        if (options.schedule) {
+          const intervalMs = options.guardInterval ? parseDuration(options.guardInterval) ?? DEFAULT_GUARD_INTERVAL_MS : DEFAULT_GUARD_INTERVAL_MS
+          const staleTimeoutMs = options.staleTimeout ? parseDuration(options.staleTimeout) : undefined
+          const cooldownMs = options.cooldown ? parseDuration(options.cooldown) : undefined
+          const maxRestart = options.maxRestart ? Number(options.maxRestart) : undefined
+          await runSchedule(ctx, intervalMs, {
+            staleTimeoutMs,
+            maxRestart,
+            cooldownMs
+          })
+        }
+
+        console.log('[2/4] 开始基线分析...')
+        const baseline = await analyzeBaseline(ctx)
+        console.log(`[2/4] ${baseline.summary}`)
+
+        console.log('[3/4] 调用 Claude CLI 补测...')
+        const runResult = await runLoop(ctx, {
+          targetFile: options.file,
+          topN: Number(options.topN),
+          permissionMode: options.permissionMode,
+          allowedTools: parseAllowedTools(options.allowedTools),
+          timeoutMs: options.timeout ? Number(options.timeout) : undefined
+        })
+        console.log(`[3/4] ${runResult.summary}`)
+
+        console.log('[4/4] 输出状态...')
+        const status = await reportStatus(ctx)
+        console.log(`[4/4] ${status.summary}`)
+        if (runResult.artifacts?.finalReportPath) {
+          console.log(`[4/4] report generated: ${runResult.artifacts.finalReportPath}`)
+        }
+
+        await lifecycle.stop()
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error)
+        await ctx.lifecycleStore.patch({
+          status: 'crashed',
+          lastError: message,
+          updatedAt: ctx.clock.nowIso()
+        })
+        throw error
+      }
+    })
+}
+
+function parseAllowedTools(value?: string): string[] | undefined {
+  if (!value) return undefined
+  const tools = value
+    .split(',')
+    .map((item) => item.trim())
+    .filter(Boolean)
+  return tools.length > 0 ? tools : undefined
+}

package/src/cli/commands/status.ts

@@ -0,0 +1,30 @@
+import { Command } from 'commander'
+import { createContext } from '../context/create-context.js'
+import { reportStatus, buildFinalReport } from '../../core/reporter/index.js'
+
+export function registerStatusCommand(program: Command) {
+  program
+    .command('status')
+    .option('--project <path>', 'project path')
+    .action(async (options) => {
+      const ctx = await createContext({
+        projectPath: options.project ?? process.cwd(),
+        coverageTarget: 80
+      })
+      const result = await reportStatus(ctx)
+      console.log(result.summary)
+    })
+
+  program
+    .command('report')
+    .option('--project <path>', 'project path')
+    .action(async (options) => {
+      const ctx = await createContext({
+        projectPath: options.project ?? process.cwd(),
+        coverageTarget: 80
+      })
+      const report = await buildFinalReport(ctx)
+      await ctx.reportStore.saveFinalReport(report)
+      console.log('report generated')
+    })
+}