/** * commands/_coverage.ts — dacli coverage 命令 (Phase D2, v0.11e+) * * 静态扫描 dacli 命令, 输出 5 大机制镜像率报告: * - 校验 (Validation): 含 validateXxx() 函数 / step machine * - 完整设计 (Design): 含 multi-step 注释 * - 错误反馈 (Error): 含 enhanceFromBackend / code: 'EXISTxxx' * - 授权 (Authorization): 含 auto-authorize / Actions/Module * - 数据流 (DataFlow): 含 dirtyCheck / --diff / --dry-run * * 输出: * - 总镜像率 = 各机制平均值 * - 命令级覆盖度 (哪几个命令未覆盖) * - 优先级分组 (P0/P1/P2/P3) */ import { Command } from 'commander' import * as fs from 'node:fs' import * as path from 'node:path' import { log, printJson } from '../core/log.ts' interface MechanismCoverage { mechanism: 'validation' | 'design' | 'error' | 'authorization' | 'dataflow' /** 中文名 */ cnName: string /** 覆盖命令数 */ covered: number /** 总命令数 */ total: number /** 百分比 */ percent: number } interface CommandCoverage { /** 命令路径 (例: form/create.ts) */ path: string /** 命令名 (例: form create) */ cmdName: string /** 5 大机制分别是否覆盖 */ mechanisms: { validation: boolean design: boolean error: boolean authorization: boolean dataflow: boolean } /** 镜像率 */ percent: number } interface CoverageReport { /** 总镜像率 (5 大机制平均) */ totalPercent: number /** 5 大机制分别覆盖 */ mechanisms: MechanismCoverage[] /** 命令级覆盖 */ commands: CommandCoverage[] /** 按优先级分组 */ byPriority: { P0: { covered: number; total: number } P1: { covered: number; total: number } P2: { covered: number; total: number } P3: { covered: number; total: number } } } const COMMANDS_DIR = '/home/ubuntu/ccWorkDir/dacli/src/commands' /** * 扫描单个命令文件的 5 大机制覆盖 */ function scanCommand(filePath: string): CommandCoverage { const basename = path.basename(filePath) if (basename.startsWith('_')) { return { path: filePath, cmdName: path.relative(COMMANDS_DIR, filePath), mechanisms: { validation: false, design: false, error: false, authorization: false, dataflow: false }, percent: 0, } } const content = fs.readFileSync(filePath, 'utf-8') const parts = filePath.split('/commands/')[1]?.split('/') || [] const cmdName = parts.join(' ') const mechanisms = { validation: /validate\w+\s*\(/.test(content) || /step\s+0/.test(content), design: /step\s+[012]\s/.test(content) || /handleNext|handleSubmit/.test(content), error: /enhanceFromBackend|code:\s*['"]EXIST\d{3}|code:\s*['"]VS\d{3}/.test(content), authorization: /auto-authorize|autoMenu|Actions\/Module|auto-bind-user/.test(content), dataflow: /--diff|--dry-run|applyDataFlowOpts|dirtyCheck/.test(content), } const coveredCount = Object.values(mechanisms).filter(Boolean).length return { path: filePath, cmdName, mechanisms, percent: Math.round((coveredCount / 5) * 100), } } export function buildCoverageCommand(): Command { const cmd = new Command('coverage') .description('v0.11e+ Phase D2 覆盖率报告 (5 大机制镜像率 + 命令级详情 + 优先级分组). AI 场景补充, 非 web 镜像') .option('--json', '原始 JSON 输出', false) .option('--detailed', '显示命令级详情', false) .action(async (opts: { json?: boolean; detailed?: boolean }) => { log.info('=== dacli coverage report (v0.11e+) ===') // 扫描所有 create/update/create-ui 命令 const allFiles: string[] = [] const domains = fs.readdirSync(COMMANDS_DIR).filter((f) => { const full = path.join(COMMANDS_DIR, f) return fs.statSync(full).isDirectory() && !f.startsWith('_') }) for (const domain of domains) { const domainDir = path.join(COMMANDS_DIR, domain) const files = fs.readdirSync(domainDir).filter((f) => { return (f.endsWith('.ts') && !f.startsWith('_')) || f === 'create.ts' || f === 'update.ts' || f === 'typecreate.ts' || f === 'typeupdate.ts' }) for (const f of files) { allFiles.push(path.join(domainDir, f)) } } const commands = allFiles.map(scanCommand).filter((c) => c.percent > 0 || !path.basename(c.path).startsWith('_')) // 统计 5 大机制 const totalValidCmd = commands.length const mechanisms: MechanismCoverage[] = [ { mechanism: 'validation', cnName: '校验', covered: commands.filter((c) => c.mechanisms.validation).length, total: totalValidCmd, percent: Math.round((commands.filter((c) => c.mechanisms.validation).length / totalValidCmd) * 100), }, { mechanism: 'design', cnName: '完整设计', covered: commands.filter((c) => c.mechanisms.design).length, total: totalValidCmd, percent: Math.round((commands.filter((c) => c.mechanisms.design).length / totalValidCmd) * 100), }, { mechanism: 'error', cnName: '错误反馈', covered: commands.filter((c) => c.mechanisms.error).length, total: totalValidCmd, percent: Math.round((commands.filter((c) => c.mechanisms.error).length / totalValidCmd) * 100), }, { mechanism: 'authorization', cnName: '授权', covered: commands.filter((c) => c.mechanisms.authorization).length, total: totalValidCmd, percent: Math.round((commands.filter((c) => c.mechanisms.authorization).length / totalValidCmd) * 100), }, { mechanism: 'dataflow', cnName: '数据流', covered: commands.filter((c) => c.mechanisms.dataflow).length, total: totalValidCmd, percent: Math.round((commands.filter((c) => c.mechanisms.dataflow).length / totalValidCmd) * 100), }, ] const totalPercent = Math.round(mechanisms.reduce((acc, m) => acc + m.percent, 0) / mechanisms.length) // 按优先级分组 (简化: form/menu/workflow/dict/dm/role/di = P0, bigscreen/portal/report/datasource = P1, 其它 = P2/P3) const P0 = ['form', 'menu', 'workflow', 'dict', 'dm', 'role', 'di'] const P1 = ['bigscreen', 'portal', 'report', 'datasource', 'app'] const byPriority = { P0: { covered: 0, total: 0 }, P1: { covered: 0, total: 0 }, P2: { covered: 0, total: 0 }, P3: { covered: 0, total: 0 }, } for (const c of commands) { const domain = c.cmdName.split('/')[0] || c.cmdName.split(' ')[0] if (P0.includes(domain)) { byPriority.P0.total++ if (c.percent > 0) byPriority.P0.covered++ } else if (P1.includes(domain)) { byPriority.P1.total++ if (c.percent > 0) byPriority.P1.covered++ } else { byPriority.P2.total++ if (c.percent > 0) byPriority.P2.covered++ } } const report: CoverageReport = { totalPercent, mechanisms, commands, byPriority, } log.info('') log.info('--- 5 大机制镜像率 ---') for (const m of mechanisms) { const bar = '█'.repeat(Math.floor(m.percent / 5)) + '░'.repeat(20 - Math.floor(m.percent / 5)) log.info(` ${m.cnName.padEnd(8)} ${bar} ${m.percent}% (${m.covered}/${m.total})`) } log.info('') log.info(`--- 总镜像率: ${totalPercent}% ---`) log.info('') log.info('--- 按优先级 ---') log.info(` P0 数据完整性: ${byPriority.P0.covered}/${byPriority.P0.total}`) log.info(` P1 UX 关键: ${byPriority.P1.covered}/${byPriority.P1.total}`) log.info(` P2 扩展: ${byPriority.P2.covered}/${byPriority.P2.total}`) log.info(` P3 nice-to-have: ${byPriority.P3.covered}/${byPriority.P3.total}`) if (opts.detailed) { log.info('') log.info('--- 命令级详情 ---') for (const c of commands) { log.info(` [${c.percent}%] ${c.cmdName}`) } } if (opts.json) printJson(report) }) return cmd }