From aea5614a8b3b922e46f18992a1e8c71b459de8e3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Thu, 8 Oct 2026 17:36:47 +0800 Subject: [PATCH] =?UTF-8?q?fix(=E7=BB=88=E6=80=81):=20=E6=B6=88=E6=8E=89?= =?UTF-8?q?=E7=AC=AC=E4=BA=8C=E5=A5=97=E4=BB=BB=E5=8A=A1=E7=BB=88=E6=80=81?= =?UTF-8?q?=E8=AF=8D=E8=A1=A8=EF=BC=8C=E5=B9=B6=E6=8A=8A=E5=88=A4=E6=8D=AE?= =?UTF-8?q?=E4=BB=8E=E6=AD=A3=E5=88=99=E6=8D=A2=E6=88=90=20AST?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit useTaskProgressLoop 的 DEFAULT_TERMINAL 只认 SUCCESS|FAILED,而 COMPLETED≡SUCCESS (task-status-text 把两者都映射成「已完成」,看板 SUCCESS_STATUSES_ORDERED 也含两者)。 收到 COMPLETED 不退出的轮询会一直空转到瞬断预算耗尽——这形状先前在跟价与风控两页踩过。 唯一被这次改宽影响的页面是 BrandCollectDataTab(它不传 isTerminal);BrandPublishTab 传自己那份含 COMPLETED+CANCELLED 的判定,行为不变,已用单独一条钉子钉住。 判据原先是"变量名恰为 status"的源码正则,同形异名全 src 有 16 处抓不到,等于恒绿; 现在用 typescript(node_modules 里已有)做 AST 尺子,并把"旧正则对三条反例失明"写进断言。 ShopMatch 的 waitForScheduledTaskStageExit 等的是阶段不是任务终态,为此给骨架加了可选 exitOn,保住它原有语义、未知状态不会挂死。 口径更正:窄集合"全 src 应为 0"不成立——实测 20 处/8 文件是 fileStatus(结果文件维度)、 loop-run 带 STOPPED 的词表、显示与下载判定,不同维度不该混进一本账;改成迁移面硬 0 + 逐文件台账只许减。catch 同理:grep 'catch (' 的 292 数不到无绑定 catch {,AST 口径 295/84。 --- .../brand/components/BrandShopMatchTab.vue | 56 +-- .../shared/composables/useTaskProgressLoop.ts | 16 +- .../src/shared/utils/task-terminal.ts | 12 +- .../tests/catch-silence-ratchet.test.ts | 119 ++++++ .../tests/helpers/catch-silence-scanner.ts | 102 +++++ .../tests/helpers/task-terminal-ast-ruler.ts | 393 ++++++++++++++++++ .../task-terminal-completed-behavior.test.ts | 179 ++++++++ .../task-terminal-set-single-source.test.ts | 225 +++++++--- 8 files changed, 1020 insertions(+), 82 deletions(-) create mode 100644 frontend-vue/tests/catch-silence-ratchet.test.ts create mode 100644 frontend-vue/tests/helpers/catch-silence-scanner.ts create mode 100644 frontend-vue/tests/helpers/task-terminal-ast-ruler.ts create mode 100644 frontend-vue/tests/task-terminal-completed-behavior.test.ts diff --git a/frontend-vue/src/pages/brand/components/BrandShopMatchTab.vue b/frontend-vue/src/pages/brand/components/BrandShopMatchTab.vue index ada5302fb..aa8fa8a2a 100644 --- a/frontend-vue/src/pages/brand/components/BrandShopMatchTab.vue +++ b/frontend-vue/src/pages/brand/components/BrandShopMatchTab.vue @@ -532,15 +532,18 @@ async function waitForTaskTerminal(taskId: number) { transientBudget: 30, }); } +/** + * 排期任务「等当前轮次跑完」:退出条件是**状态离开 RUNNING**,不是任务到终态—— + * SUCCESS/COMPLETED/FAILED 走终态收尾、SCHEDULED 表示已排到下一轮、其余任何状态都算本轮结束。 + * 所以这里给骨架传 exitOn 而不是往 terminal 里堆状态表(漏一个后端新状态就是永不退出的紧循环)。 + * 循环本体(disposed 优先、瞬断计数与退避)在骨架里;取数方式(重型 batch)、页内副作用与文案留在本页。 + */ async function waitForScheduledTaskStageExit(taskId: number) { - let transientErrorCount = 0 - const maxTransientErrors = 30 - while (true) { - if (disposed) return 'STOPPED' - try { + return waitForTaskTerminalShared({ + taskId, + isDisposed: () => disposed, + pollStatus: async () => { const batch = await getShopMatchTaskProgressBatch([taskId]) - if (transientErrorCount > 0) queuePushResult.value = `任务 ${taskId} 服务已恢复,继续等待当前轮次结束...` - transientErrorCount = 0 if ((batch.missingTaskIds || []).includes(taskId)) { removeTaskLocally(taskId) await refreshTaskViewsBestEffort() @@ -558,31 +561,34 @@ async function waitForScheduledTaskStageExit(taskId: number) { taskDetails.value[taskId] = status saveTaskDetailsToStorage() } - if (!status || status === 'RUNNING') { - await sleep(getPollIntervalMs()) - continue - } if (isTaskTerminalStatus(status)) { removePollingTask(taskId) await refreshTaskViewsBestEffort() restoreScheduledDispatches() - return status - } - if (status === 'SCHEDULED') { + } else if (status === 'SCHEDULED') { stopPollingTask(taskId) restoreScheduledDispatches() - return status } - return status - } catch (error) { - if (!isTransientBackendError(error)) throw error - transientErrorCount += 1 - if (transientErrorCount >= maxTransientErrors) throw new Error(`任务 ${taskId} 等待当前轮次结束超时,请稍后手动刷新查看状态`) - queuePushResult.value = `任务 ${taskId} 运行中,正在等待当前轮次结束(${transientErrorCount}/${maxTransientErrors})...` - if (transientErrorCount === 1 || transientErrorCount % 5 === 0) ElMessage.warning(`任务 ${taskId} 运行中,服务暂时不可用,正在自动重试`) - await sleep(getPollIntervalMs()) - } - } + // 空串=还没出这一轮(骨架据此继续等);离开 RUNNING 一律交回状态原文,含本页不认识的状态 + return status && status !== 'RUNNING' ? status : '' + }, + // 瞬断恢复提示由骨架在取数成功后统一发(原来也是取到批次后立刻发,措辞照旧) + onRecovered: () => { + queuePushResult.value = `任务 ${taskId} 服务已恢复,继续等待当前轮次结束...` + }, + onTransient: (attempt, budget) => { + queuePushResult.value = `任务 ${taskId} 运行中,正在等待当前轮次结束(${attempt}/${budget})...` + if (attempt === 1 || attempt % 5 === 0) ElMessage.warning(`任务 ${taskId} 运行中,服务暂时不可用,正在自动重试`) + }, + isTransient: isTransientBackendError, + onBudgetExhausted: () => { + throw new Error(`任务 ${taskId} 等待当前轮次结束超时,请稍后手动刷新查看状态`) + }, + exitOn: (status) => status !== 'RUNNING', + intervalMs: getPollIntervalMs, + sleep, + transientBudget: 30, + }) } function resolvedTaskStatus(item: ShopMatchHistoryItem) { const itemStatus = item.taskStatus || '' diff --git a/frontend-vue/src/shared/composables/useTaskProgressLoop.ts b/frontend-vue/src/shared/composables/useTaskProgressLoop.ts index 4abdc3225..b1c7e90be 100644 --- a/frontend-vue/src/shared/composables/useTaskProgressLoop.ts +++ b/frontend-vue/src/shared/composables/useTaskProgressLoop.ts @@ -6,6 +6,7 @@ import { getTaskForegroundRefreshDelayMs, } from '../task-progress-config.ts' import { createCategorizedTimers } from '../utils/categorized-timers.ts' +import { isTerminalTaskStatus } from '../utils/task-terminal.ts' import { createTaskPollingBaseline, type TaskPollingBaseline } from '../task-polling-baseline.ts' import type { ProgressResponseCache } from '../progress-response-cache.ts' import type { TaskPollingCoordinator } from '../task-polling-coordinator.ts' @@ -23,7 +24,8 @@ import type { TaskPollingCoordinator } from '../task-polling-coordinator.ts' * fetchProgress: (ids) => getCollectDataTaskProgressBatch(ids), * extractTaskId: (detail) => detail.task?.id, * extractStatus: (detail) => detail.task?.status, - * isTerminal: (status) => status === 'SUCCESS' || status === 'FAILED', + * // isTerminal 省略即为共用词表(SUCCESS / COMPLETED / FAILED,见 utils/task-terminal.ts); + * // 只有本页另有词表时才传,例如排期循环那种阶段状态机。 * onUpdate: (taskId, detail) => { ... }, * onTerminal: async (taskId, detail) => { await refreshHistory() }, * }) @@ -41,7 +43,7 @@ export interface TaskProgressLoopOptions { extractTaskId: (detail: TDetail) => number | null | undefined /** 从单条进度详情中提取状态字符串(如 'PENDING'/'RUNNING'/'SUCCESS'/'FAILED') */ extractStatus: (detail: TDetail) => string | null | undefined - /** 判定是否终态;默认 SUCCESS / FAILED 视为终态 */ + /** 判定是否终态;默认走共用词表 TERMINAL_TASK_STATUSES(SUCCESS / COMPLETED / FAILED) */ isTerminal?: (status: string) => boolean /** 每条进度落地时调用,用于上层缓存最新快照 */ onUpdate?: (taskId: number, detail: TDetail) => void @@ -91,7 +93,15 @@ export interface TaskProgressLoopHandle { dispose: () => void } -const DEFAULT_TERMINAL = (status: string) => status === 'SUCCESS' || status === 'FAILED' +/** + * 默认终态判定=共用骨架那份词表,别再在这里抄一遍 SUCCESS / FAILED。 + * + * 行为变更(相对旧默认):COMPLETED 现在也算终态。旧窄集合收到 COMPLETED 时不会把任务从 + * 轮询集合里摘除,页面会一直轮询下去(用户看到「任务永远执行中」),而后端早就结束了; + * COMPLETED≡SUCCESS 的口径出处:shared/utils/task-status-text.ts 把两者都映射成「已完成」/success, + * 与 utils/task-terminal.ts 顶部的说明一致。 + */ +const DEFAULT_TERMINAL = isTerminalTaskStatus function readIdsFromStorage(key?: string): number[] { if (!key || typeof window === 'undefined') return [] diff --git a/frontend-vue/src/shared/utils/task-terminal.ts b/frontend-vue/src/shared/utils/task-terminal.ts index a77dc7b0b..c1f158c10 100644 --- a/frontend-vue/src/shared/utils/task-terminal.ts +++ b/frontend-vue/src/shared/utils/task-terminal.ts @@ -42,6 +42,15 @@ export interface TaskTerminalWait { onTransient?: (attempt: number, budget: number) => void /** 瞬断判定,沿用各页原有的 TRANSIENT_BACKEND_ERROR_PATTERNS 口径。 */ isTransient: (error: unknown) => boolean + /** + * 阶段型等待(排期轮次、巡店当前阶段)用:退出条件不是"任务到终态"而是"这一阶段不再执行", + * 例如非 RUNNING 的任何状态都算出阶段。给了它就绕过 `terminal` 成员判定, + * 参数是已经 trim+toUpperCase 过的状态。 + * + * 为什么开这个口子而不是往 `terminal` 里堆状态:堆表漏一个后端新状态就会**永不退出**(紧循环挂死), + * 谓词形式(`!== 'RUNNING'`)天然兜住未知状态。任务型等待仍走 `terminal`,不许用它改写终态词表。 + */ + exitOn?: (status: string) => boolean /** 预算耗尽:六页原本都是 throw(措辞各异),所以默认抛通用文案。 */ onBudgetExhausted?: (attempt: number) => never intervalMs: () => number @@ -69,7 +78,8 @@ export async function waitForTaskTerminal(wait: TaskTerminalWait): Promise relative(root, p).split(sep).join('/') +const SRC_FILES = listSourceFiles(resolve(root, 'src')).map(rel) + +const BASELINE = { + blocks: 295, + silent: 84, + /** 逐文件台账:只钉总数与文件数两个标量的棘轮,会被「A 加一条 + B 减一条」整段绕过。 */ + perFile: { + 'src/pages/brand/components/BrandCollectDataTab.vue': 4, + 'src/pages/brand/components/BrandConvertTab.vue': 1, + 'src/pages/brand/components/BrandDedupeTab.vue': 1, + 'src/pages/brand/components/BrandPriceTrackTab.vue': 8, + 'src/pages/brand/components/BrandProductRiskTab.vue': 8, + 'src/pages/brand/components/BrandPublishTab.vue': 2, + 'src/pages/brand/components/BrandQueryAsinTab.vue': 1, + 'src/pages/brand/components/BrandShopDataCrawlTab.vue': 1, + 'src/pages/brand/components/BrandShopMatchTab.vue': 1, + 'src/pages/brand/components/BrandSimilarAsinTab.vue': 1, + 'src/pages/brand/components/BrandSplitTab.vue': 1, + 'src/pages/brand/components/BrandVariantTab.vue': 2, + 'src/pages/home/DesktopHomePage.vue': 1, + 'src/pages/image-video/components/DeliveryVideoWorkspace.vue': 1, + 'src/pages/login/DesktopLoginPage.vue': 12, + 'src/pages/setup/DesktopSecretSetupPage.vue': 1, + 'src/router/index.ts': 3, + 'src/shared/api/http.ts': 1, + 'src/shared/api/task-progress-polling.ts': 1, + 'src/shared/api/types/modules/permission.ts': 1, + 'src/shared/auth/account-expiry.ts': 1, + 'src/shared/auth/ensure-auth.ts': 1, + 'src/shared/auth/kick-handler.ts': 4, + 'src/shared/bridges/web-fallback.ts': 2, + 'src/shared/components/ApiSecretSettingsPanel.vue': 1, + 'src/shared/components/ExpiryNotice.vue': 2, + 'src/shared/components/NotificationBell.vue': 3, + 'src/shared/composables/useLiveTaskBoard.ts': 1, + 'src/shared/composables/useTaskProgressLoop.ts': 3, + 'src/shared/composables/useVersionUpdate.ts': 1, + 'src/shared/dispatch-guard-ui.ts': 1, + 'src/shared/route-prefetch.ts': 1, + 'src/shared/utils/api-secret-store.ts': 9, + 'src/shared/utils/notification-bell.ts': 1, + 'src/shared/utils/row-id.ts': 1, + } as Record, +} + +const scans = SRC_FILES.map((f) => scanCatchSilence(readSource(f, root), f)) +const now = totals(scans) +const ledger = toLedger(scans) + +test('分母自证:扫描器真的看见了整棵 src(分母塌了的话"≤基线"就是恒绿)', () => { + assert.ok(SRC_FILES.length > 100, `只扫到 ${SRC_FILES.length} 个文件,分母不对`) + assert.ok(SRC_FILES.some((f) => f.endsWith('.vue')), '.vue 没进分母就是漏扫') + assert.ok(now.blocks >= 250, `catch 块只数到 ${now.blocks} 个,与基线 ${BASELINE.blocks} 差得离谱 ⇒ 扫描器坏了,不是代码变好了`) + // 非零对照:已知藏着静默 catch 的文件必须被扫到,否则"0 处"没有意义 + assert.ok(ledger['src/shared/utils/api-secret-store.ts'] > 0, 'api-secret-store.ts 的静默 catch 没被数到,扫描器口径失效') + assert.ok(ledger['src/pages/login/DesktopLoginPage.vue'] > 0, 'DesktopLoginPage.vue 的静默 catch 没被数到,扫描器口径失效') +}) + +test('静默 catch 只许减:总数与逐文件台账都不许超过基线', () => { + const worse: string[] = [] + for (const [file, count] of Object.entries(ledger)) { + const allowed = BASELINE.perFile[file] + if (allowed === undefined) worse.push(`${file} 是新增静默 catch 的文件(${count} 处)`) + else if (count > allowed) worse.push(`${file} 从 ${allowed} 处涨到 ${count} 处`) + } + assert.deepEqual(worse, [], `新增了静默 catch,要么把错误报给用户、要么显式上抛:\n${worse.join('\n')}`) + assert.ok(now.silent <= BASELINE.silent, + `静默 catch 总数 ${now.silent} > 基线 ${BASELINE.silent};减下去了就把基线与台账一起改小`) + assert.ok(now.blocks <= BASELINE.blocks, `catch 块总数从 ${BASELINE.blocks} 涨到 ${now.blocks},新增 try/catch 要一并说明理由`) +}) + +test('扫描器先自证:新增一个空 catch 一定被数出来', () => { + const target = 'src/pages/brand/components/BrandCollectDataTab.vue' + const source = readSource(target, root).replace(/\r\n/g, '\n') + const anchor = 'function selectCountry(code: string) {' + assert.equal(source.split(anchor).length - 1, 1, '锚点不唯一,注入自证不作数') + const before = scanCatchSilence(source, target) + const injected = source.replace(anchor, 'function injectedProbeForRuler() {\n try { throw new Error("x") } catch { }\n}\n' + anchor) + assert.notEqual(injected, source, '注入没生效,这条自证是假的') + + const after = scanCatchSilence(injected, target) + assert.equal(after.total, before.total + 1, '多出来的 catch 块没被数到分母') + assert.equal(after.silent.length, before.silent.length + 1, '多出来的空 catch 体没被数成静默') + assert.deepEqual(Object.entries(ledger).map(([f, c]) => [f, c]).filter(([f]) => f === target).map(([, c]) => c), [before.silent.length], + '台账与单文件复扫对不上') +}) + +test('扫描器的口径边界:console + throw、console + ElMessage 都不算静默', () => { + const cases: Array<[string, number]> = [ + ['try { f() } catch { }', 1], + ['try { f() } catch (e) { console.log(e) }', 1], + ['try { f() } catch (e) { console.error(e); throw e }', 0], + ['try { f() } catch (e) { console.error(e); ElMessage.error("失败了") }', 0], + ['try { f() } catch (e) { ElMessage.error(String(e)) }', 0], + ['try { f() } catch (e) { retry() }', 0], + ] + for (const [src, expected] of cases) { + const r = scanCatchSilence(src, '<内存口径>') + assert.equal(r.silent.length, expected, `口径判错:${src}(期望静默 ${expected},实测 ${r.silent.length})`) + assert.equal(r.total, 1, `catch 块分母判错:${src}`) + } +}) diff --git a/frontend-vue/tests/helpers/catch-silence-scanner.ts b/frontend-vue/tests/helpers/catch-silence-scanner.ts new file mode 100644 index 000000000..f41937d03 --- /dev/null +++ b/frontend-vue/tests/helpers/catch-silence-scanner.ts @@ -0,0 +1,102 @@ +/** + * catch 静默扫描器(tests 工具层,判据在 tests/catch-silence-ratchet.test.ts)。 + * + * 口径(与四面 9 分口径文档一致,逐条落到 AST 上,不靠 grep 数行数): + * 一个 catch 子句算"静默",当且仅当 + * ① 块体是空的;或 + * ② 块体第一条语句是 console.* 调用,且整块里没有 throw、也没有 ElMessage/ElNotification 这类用户可见提示。 + * 其余形状(只 catch 后什么都不做但赋了个值、写了注释、调了别的函数)都**不**算——棘轮要能钉得住, + * 口径就得是可复算的,不能靠人临场判断。 + * + * 与文档基线 292/81 的口径差:那张表的"分母与 `grep -c 'catch ('` 对齐",而 grep 数不到 + * 无绑定的 `catch {`(本仓有)与 `} catch (e) {` 单行紧凑写法;本扫描器按 AST 数 CatchClause, + * 实测 296 块 / 84 静默。**这里钉 296/84 这条实扫基线**,只许减不许增。 + */ +import { createRequire } from 'node:module' +import { extractScript, parseModule } from './task-terminal-ast-ruler.ts' + +const require = createRequire(import.meta.url) +const ts = require('typescript') + +export interface SilentCatch { + file: string + line: number + /** 'empty'=空块;'console-only'=只往控制台打了一句 */ + kind: 'empty' | 'console-only' + snippet: string +} + +export interface CatchScan { + file: string + total: number + silent: SilentCatch[] +} + +/** 用户可见提示的符号名(本仓只有 Element Plus 这一套)。 */ +const TOAST_SYMBOLS = new Set(['ElMessage', 'ElNotification', 'ElMessageBox']) + +function walk(node: any, cb: (n: any) => void): void { + cb(node) + ts.forEachChild(node, (child: any) => walk(child, cb)) +} + +function firstStatementIsConsole(node: any): boolean { + if (!ts.isExpressionStatement(node)) return false + const call = node.expression + if (!ts.isCallExpression(call)) return false + const callee = call.expression + if (!ts.isPropertyAccessExpression(callee)) return false + const base = callee.expression + return ts.isIdentifier(base) && base.text === 'console' +} + +/** 块里有没有"响"的出口:throw(语句或表达式两支)或任意 ElMessage.* / 裸 ElMessage 引用。 */ +function hasLoudExit(body: any): boolean { + let loud = false + walk(body, (n: any) => { + if (ts.isThrowStatement(n) || n.kind === ts.SyntaxKind.ThrowExpression) loud = true + if (ts.isIdentifier(n) && TOAST_SYMBOLS.has(n.text)) loud = true + }) + return loud +} + +export function scanCatchSilence(code: string, file: string): CatchScan { + const { script, lineOffset } = extractScript(code, file) + const sf = parseModule(script, file) + let total = 0 + const silent: SilentCatch[] = [] + walk(sf, (node: any) => { + if (!ts.isCatchClause(node)) return + total += 1 + const block = node.block + const line = sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1 + lineOffset + const snippet = script.slice(node.getStart(sf), block.getEnd()).replace(/\s+/g, ' ').trim() + if (block.statements.length === 0) { + silent.push({ file, line, kind: 'empty', snippet }) + return + } + if (!firstStatementIsConsole(block.statements[0])) return + if (hasLoudExit(block)) return + silent.push({ file, line, kind: 'console-only', snippet }) + }) + return { file, total, silent } +} + +/** 把逐文件结果汇成一个可对比的台账:`相对路径 -> 静默处数`。 */ +export function toLedger(scans: CatchScan[]): Record { + const ledger: Record = {} + for (const s of scans) if (s.silent.length) ledger[s.file] = s.silent.length + return ledger +} + +export function totals(scans: CatchScan[]): { blocks: number; silent: number; byFile: number } { + let blocks = 0 + let silent = 0 + let byFile = 0 + for (const s of scans) { + blocks += s.total + silent += s.silent.length + if (s.silent.length) byFile += 1 + } + return { blocks, silent, byFile } +} diff --git a/frontend-vue/tests/helpers/task-terminal-ast-ruler.ts b/frontend-vue/tests/helpers/task-terminal-ast-ruler.ts new file mode 100644 index 000000000..9d9ce1c41 --- /dev/null +++ b/frontend-vue/tests/helpers/task-terminal-ast-ruler.ts @@ -0,0 +1,393 @@ +/** + * 终态词表的 AST 尺子(判据从"源码正则"升级来的那一半,跑在 node --test 里,无新依赖)。 + * + * 为什么必须弃用正则:上一版尺子长这样 + * /===\s*'SUCCESS'\s*\|\|\s*status\s*===\s*'FAILED'\s*\)/ + * 它把"变量名恰好叫 status"和"两个比较挨在一起"当成了词表的定义。于是 + * const x = (s: string) => s === 'SUCCESS' || s === 'FAILED' ← 同形异名,抓不到 + * if (st === 'SUCCESS' || st === 'FAILED') return ← 同上 + * [TaskStatus.SUCCESS, TaskStatus.FAILED].includes(status) ← 数组形态,同上 + * 三类都从尺子底下滑过去,尺子就**恒绿**了——恒绿的判据比没有判据更糟,它让下一次抄袭变得安全。 + * + * 现在按 AST 结构判:把 `||` 链(含嵌在数组里的 `.includes()` 形态)归约成"这条判断认得哪些状态词", + * 只要同时认得 SUCCESS 与 FAILED、又不认得 COMPLETED,就是窄集合。不看变量名、不看排版、不数空格。 + * + * 精度闸(防误红,误红的判据下次没人信):链里还出现 RUNNING/PENDING/SCHEDULED 这类**非终态**词的, + * 是"这行要不要显示成执行中"的显示判断,不是"任务到没到终态"的等待判断,不计入。 + */ +import { readFileSync, readdirSync, statSync } from 'node:fs' +import { join, relative } from 'node:path' +import { createRequire } from 'node:module' + +const require = createRequire(import.meta.url) +const ts = require('typescript') + +/** 大写状态词的形状:SUCCESS / COMPLETED / DELETED_XXX;小写与普通标识符不算状态词。 */ +const STATUS_WORD = /^[A-Z][A-Z0-9_]{2,}$/ + +/** 与骨架一致:这两个词是"任务确实结束了"的最小充分对。 */ +const NARROW_PAIR = ['SUCCESS', 'FAILED'] +/** COMPLETED≡SUCCESS 的出处见 shared/utils/task-status-text.ts;出现它就不算窄集合。 */ +const WIDE_MARKER = 'COMPLETED' +/** 非终态词:出现即说明这条判断不是"等终态",不计入窄集合。 */ +const NON_TERMINAL_WORDS = new Set([ + 'RUNNING', 'PENDING', 'SCHEDULED', 'QUEUED', 'PAUSED', 'WAITING', 'PROCESSING', 'INIT', 'CREATED', +]) + +export interface NarrowHit { + /** 文件相对路径(相对仓库根,即 frontend-vue) */ + file: string + line: number + /** 命中的那条判断的源码片段(报错时给出可读证据,不只给个数字) */ + snippet: string + /** 这条判断认得的状态词 */ + words: string[] +} + +function walk(node: any, cb: (n: any) => void): void { + cb(node) + ts.forEachChild(node, (child: any) => walk(child, cb)) +} + +/** .vue 只取 `', '<两段script>.vue'), /