dsh-stm32 0.1.7 → 0.1.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/README.md +256 -363
  2. package/README_EN.md +257 -357
  3. package/client/client.js +4340 -1
  4. package/docs/reading-guide.md +62 -0
  5. package/lib/client.js +4340 -1
  6. package/lib/engine/artifacts.js +123 -0
  7. package/lib/engine/breakpoint-hits.js +73 -0
  8. package/lib/engine/build.js +73 -3
  9. package/lib/engine/channel-tap.js +227 -0
  10. package/lib/engine/channels.js +48 -0
  11. package/lib/engine/clocks.js +192 -0
  12. package/lib/engine/debug-session.js +46 -1
  13. package/lib/engine/event-bus.js +158 -0
  14. package/lib/engine/event-log.js +335 -0
  15. package/lib/engine/fault-hints.js +146 -0
  16. package/lib/engine/interrupts.js +247 -0
  17. package/lib/engine/ioc-diff.js +369 -0
  18. package/lib/engine/ioc-sync.js +58 -0
  19. package/lib/engine/msys2-install.js +31 -6
  20. package/lib/engine/panel-actions.js +103 -0
  21. package/lib/engine/pinout.js +140 -0
  22. package/lib/engine/probe-info.js +95 -0
  23. package/lib/engine/progress.js +99 -0
  24. package/lib/engine/project-conf.js +199 -0
  25. package/lib/engine/session-context.js +19 -0
  26. package/lib/engine/source-slice.js +59 -0
  27. package/lib/engine/tool-events.js +119 -0
  28. package/lib/engine/watch-admin.js +101 -0
  29. package/lib/engine/watch-record.js +39 -0
  30. package/lib/engine/watch-recorder.js +116 -0
  31. package/lib/engine/web-api.js +886 -4
  32. package/lib/engine/web-routes.js +18 -1
  33. package/lib/engine/workspace-memo.js +41 -0
  34. package/lib/index.js +67 -24
  35. package/lib/tools/ioc-apply.js +9 -0
  36. package/lib/tools/project-create.js +28 -0
  37. package/lib/tools/project-dir.js +7 -1
  38. package/lib/tools/rtt.js +8 -0
  39. package/lib/tools/serial.js +22 -0
  40. package/lib/tools/watch.js +24 -2
  41. package/package.json +1 -1
@@ -0,0 +1,335 @@
1
+ /**
2
+ * 把被环形缓冲挤出的事件定期落到证据目录。
3
+ *
4
+ * 分工:event-bus.ts 只管内存与序号,本文件只管「什么时候写、写到哪」。
5
+ * 这样事件流在面板里永远是内存直读(毫秒级),磁盘写失败也不会拖慢工具调用。
6
+ *
7
+ * 落盘布局(每个会话一个目录):
8
+ * <root>/<yyyy-mm-dd>/<sessionKey>/events-<HHmmss>.jsonl
9
+ * 每批一个文件,按批次的起始时刻命名,复盘时按文件名排序即为时间顺序。
10
+ */
11
+ import { readFileSync } from "node:fs";
12
+ import { appendFile, mkdir, readdir, rm, stat } from "node:fs/promises";
13
+ import { homedir } from "node:os";
14
+ import path from "node:path";
15
+ import { toolchainConfigPath } from "../data/toolchain-config.js";
16
+ import { drainEvicted, eventSessionKey, eventSnapshot, requeueEvicted, takeDroppedCount, } from "./event-bus.js";
17
+ /** 默认落盘间隔。一批之内的事件共用一个文件。 */
18
+ export const EVENT_LOG_INTERVAL_MS = 30_000;
19
+ /** 证据目录保留的会话数上限:超出时先删最老的会话目录。 */
20
+ export const EVENT_EVIDENCE_KEEP_SESSIONS = 20;
21
+ /** 证据目录保留天数上限:超过这个天数的日期目录整体删掉。 */
22
+ export const EVENT_EVIDENCE_KEEP_DAYS = 7;
23
+ /** 允许范围:落盘 5 秒–1 小时;保留天数 0(不按天清)–365;会话数 1–200。 */
24
+ const POLICY_LIMITS = {
25
+ flushSeconds: { min: 5, max: 3600, fallback: 30 },
26
+ keepDays: { min: 0, max: 365, fallback: 7 },
27
+ keepSessions: { min: 1, max: 200, fallback: 20 },
28
+ };
29
+ function readPolicyConfig(env) {
30
+ const flag = env["DSH_STM32_NO_CONFIG"];
31
+ if (flag === "1" || flag === "true")
32
+ return null;
33
+ try {
34
+ const text = readFileSync(toolchainConfigPath(env), "utf8");
35
+ const parsed = JSON.parse(text);
36
+ return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : null;
37
+ }
38
+ catch {
39
+ return null;
40
+ }
41
+ }
42
+ function pickNumber(key, envKey, env, config) {
43
+ const limits = POLICY_LIMITS[key];
44
+ const fromEnv = env[envKey];
45
+ if (typeof fromEnv === "string" && fromEnv.trim() !== "") {
46
+ const parsed = Number.parseInt(fromEnv.trim(), 10);
47
+ if (Number.isFinite(parsed)) {
48
+ return { value: Math.min(limits.max, Math.max(limits.min, parsed)), source: "env " + envKey };
49
+ }
50
+ return { value: limits.fallback, source: "default(" + envKey + " 不是整数)" };
51
+ }
52
+ const fromConfig = config === null ? undefined : config["evidence" + key.charAt(0).toUpperCase() + key.slice(1)];
53
+ if (typeof fromConfig === "number" && Number.isFinite(fromConfig)) {
54
+ return { value: Math.min(limits.max, Math.max(limits.min, Math.round(fromConfig))), source: "config evidence" + key.charAt(0).toUpperCase() + key.slice(1) };
55
+ }
56
+ return { value: limits.fallback, source: "default" };
57
+ }
58
+ /**
59
+ * 读出证据策略(S78):环境变量优先,其次配置文件,最后默认值。
60
+ *
61
+ * 落盘间隔与保留口径都允许改;越界一律夹到允许范围,非法值退回默认。
62
+ */
63
+ export function evidencePolicy(env = process.env) {
64
+ const config = readPolicyConfig(env);
65
+ const flush = pickNumber("flushSeconds", "DSH_STM32_EVIDENCE_FLUSH_SECONDS", env, config);
66
+ const days = pickNumber("keepDays", "DSH_STM32_EVIDENCE_KEEP_DAYS", env, config);
67
+ const sessions = pickNumber("keepSessions", "DSH_STM32_EVIDENCE_KEEP_SESSIONS", env, config);
68
+ return {
69
+ flushSeconds: flush.value,
70
+ keepDays: days.value,
71
+ keepSessions: sessions.value,
72
+ sources: { flushSeconds: flush.source, keepDays: days.source, keepSessions: sessions.source },
73
+ };
74
+ }
75
+ /** 证据目录根:允许用环境变量改到别处(例如放到工程内便于随工程归档)。 */
76
+ export function evidenceRoot(env = process.env) {
77
+ const custom = env.DSH_STM32_EVIDENCE;
78
+ if (typeof custom === "string" && custom.trim() !== "")
79
+ return path.resolve(custom.trim());
80
+ return path.join(homedir(), ".dsh-stm32", "evidence");
81
+ }
82
+ /** 会话键要能当目录名:只留安全字符,空的退回 unbound。 */
83
+ export function safeSessionKey(key) {
84
+ const cleaned = key.trim().replace(/[^A-Za-z0-9._-]+/gu, "-").replace(/^-+|-+$/gu, "");
85
+ return cleaned === "" ? "unbound" : cleaned.slice(0, 80);
86
+ }
87
+ function pad(value) {
88
+ return value < 10 ? "0" + String(value) : String(value);
89
+ }
90
+ /** 日期目录:按本地日期分,便于人找。 */
91
+ export function dateFolder(now) {
92
+ return now.getFullYear() + "-" + pad(now.getMonth() + 1) + "-" + pad(now.getDate());
93
+ }
94
+ function timeName(now) {
95
+ return pad(now.getHours()) + pad(now.getMinutes()) + pad(now.getSeconds());
96
+ }
97
+ /** 某会话在某一时刻的证据目录。 */
98
+ export function sessionEvidenceDir(root, key, now) {
99
+ return path.join(root, dateFolder(now), safeSessionKey(key));
100
+ }
101
+ function eventLine(event) {
102
+ return JSON.stringify(event) + "\n";
103
+ }
104
+ /** 已经写进证据目录的最大序号;换会话时归零,避免把别的会话的序号当基线。 */
105
+ let archivedSeq = 0;
106
+ let archivedKey = "";
107
+ /** 测试用:把归档游标归零。 */
108
+ export function resetArchiveCursor() {
109
+ archivedSeq = 0;
110
+ archivedKey = "";
111
+ }
112
+ /**
113
+ * 写一批事件并返回写入信息。
114
+ *
115
+ * 目录与文件名规则只在这里实现一次:`flushEvicted` 与 `flushPending` 共用。
116
+ */
117
+ async function writeBatch(events, options) {
118
+ const dir = sessionEvidenceDir(options.root, options.key, options.now);
119
+ const file = path.join(dir, "events-" + timeName(options.now) + ".jsonl");
120
+ const lines = [];
121
+ if (options.dropped > 0) {
122
+ // 缺口本身要留痕:否则证据目录看起来连续,实际中间丢了条目。
123
+ lines.push(eventLine({
124
+ seq: events.length > 0 ? (events[0]?.seq ?? 0) : 0,
125
+ time: options.now.toISOString(),
126
+ source: "system",
127
+ kind: "log",
128
+ status: "fail",
129
+ summary: "落盘通道积压,丢弃 " + String(options.dropped) + " 条事件",
130
+ payload: { dropped: options.dropped },
131
+ }));
132
+ }
133
+ for (const event of events)
134
+ lines.push(eventLine(event));
135
+ await mkdir(dir, { recursive: true });
136
+ await appendFile(file, lines.join(""), "utf8");
137
+ return { written: events.length, file };
138
+ }
139
+ /**
140
+ * 写一批被挤出的事件。成功返回写入条数;失败把事件放回队列并抛出,由调用方决定是否重试。
141
+ */
142
+ export async function flushEvicted(options = {}) {
143
+ const now = options.now ?? new Date();
144
+ const dropped = takeDroppedCount();
145
+ const events = drainEvicted();
146
+ if (events.length === 0 && dropped === 0)
147
+ return { written: 0, file: null, dropped: 0 };
148
+ const key = eventSessionKey() === "" ? "unbound" : eventSessionKey();
149
+ const root = options.root ?? evidenceRoot(options.env);
150
+ const dir = sessionEvidenceDir(root, key, now);
151
+ try {
152
+ const result = await writeBatch(events, { root, now, key, dropped });
153
+ return { written: result.written, file: result.file, dropped };
154
+ }
155
+ catch (error) {
156
+ requeueEvicted(events);
157
+ throw error;
158
+ }
159
+ }
160
+ /**
161
+ * 写「还没落盘的」事件(S72):溢出队列 + 环形缓冲里序号超过游标的部分。
162
+ *
163
+ * 正常会话不再等到溢出才留证据——每拍把新事件写一份,重启后仍能回放。
164
+ * 游标记的是「已写过」的最大序号,所以同一事件不会写两遍。
165
+ */
166
+ export async function flushPending(options = {}) {
167
+ const now = options.now ?? new Date();
168
+ const key = eventSessionKey() === "" ? "unbound" : eventSessionKey();
169
+ if (key !== archivedKey) {
170
+ archivedKey = key;
171
+ archivedSeq = 0;
172
+ }
173
+ const dropped = takeDroppedCount();
174
+ // 只归档本会话的事件:换会话后 ring 里还有上一个会话的条目,不能重复写进新目录。
175
+ const mine = (event) => event.session === undefined || event.session === key;
176
+ const evicted = drainEvicted().filter((event) => event.seq > archivedSeq && mine(event));
177
+ const recent = eventSnapshot(archivedSeq).filter(mine);
178
+ const events = evicted.concat(recent);
179
+ if (events.length === 0 && dropped === 0)
180
+ return { written: 0, file: null, dropped: 0 };
181
+ const root = options.root ?? evidenceRoot(options.env);
182
+ try {
183
+ const result = await writeBatch(events, { root, now, key, dropped });
184
+ const last = events[events.length - 1];
185
+ if (last !== undefined)
186
+ archivedSeq = last.seq;
187
+ return { written: result.written, file: result.file, dropped };
188
+ }
189
+ catch (error) {
190
+ requeueEvicted(evicted);
191
+ throw error;
192
+ }
193
+ }
194
+ /**
195
+ * 清理旧证据:按「日期目录超过 N 天」与「会话目录超过 M 个」两条规则,先算后删。
196
+ *
197
+ * 只删本插件自己的目录布局(<root>/<yyyy-mm-dd>/<会话>),遇到不合布局的条目跳过,
198
+ * 绝不递归删 root 本身。
199
+ */
200
+ export async function pruneEvidence(options = {}) {
201
+ const root = options.root ?? evidenceRoot(options.env);
202
+ const now = options.now ?? new Date();
203
+ const keepSessions = options.keepSessions ?? EVENT_EVIDENCE_KEEP_SESSIONS;
204
+ const keepDays = options.keepDays ?? EVENT_EVIDENCE_KEEP_DAYS;
205
+ const removedDirs = [];
206
+ let removedFiles = 0;
207
+ let removedBytes = 0;
208
+ const measure = async (dir) => {
209
+ let files = 0;
210
+ let bytes = 0;
211
+ let entries;
212
+ try {
213
+ entries = await readdir(dir, { withFileTypes: true });
214
+ }
215
+ catch {
216
+ return { files, bytes };
217
+ }
218
+ for (const entry of entries) {
219
+ const full = path.join(dir, entry.name);
220
+ if (entry.isDirectory()) {
221
+ const inner = await measure(full);
222
+ files += inner.files;
223
+ bytes += inner.bytes;
224
+ continue;
225
+ }
226
+ try {
227
+ const info = await stat(full);
228
+ files += 1;
229
+ bytes += info.size;
230
+ }
231
+ catch {
232
+ // 文件刚被别处删掉:不计入即可。
233
+ }
234
+ }
235
+ return { files, bytes };
236
+ };
237
+ let dayDirs = [];
238
+ try {
239
+ dayDirs = (await readdir(root, { withFileTypes: true }))
240
+ .filter((entry) => entry.isDirectory() && /^\d{4}-\d{2}-\d{2}$/u.test(entry.name))
241
+ .map((entry) => entry.name);
242
+ }
243
+ catch {
244
+ return { removedDirs, removedFiles, removedBytes };
245
+ }
246
+ const cutoff = new Date(now.getTime() - keepDays * 24 * 60 * 60 * 1000);
247
+ const liveDays = [];
248
+ for (const day of dayDirs) {
249
+ const at = new Date(day + "T00:00:00");
250
+ if (Number.isNaN(at.getTime()))
251
+ continue;
252
+ if (at.getTime() < cutoff.getTime()) {
253
+ const full = path.join(root, day);
254
+ const size = await measure(full);
255
+ await rm(full, { recursive: true, force: true });
256
+ removedDirs.push(day);
257
+ removedFiles += size.files;
258
+ removedBytes += size.bytes;
259
+ continue;
260
+ }
261
+ liveDays.push(day);
262
+ }
263
+ // 会话数按「最新 mtime 的会话目录」排序保留;跨日期目录一起算。
264
+ const sessions = [];
265
+ liveDays.sort();
266
+ for (const day of liveDays) {
267
+ const dayDir = path.join(root, day);
268
+ let entries;
269
+ try {
270
+ entries = await readdir(dayDir, { withFileTypes: true });
271
+ }
272
+ catch {
273
+ continue;
274
+ }
275
+ for (const entry of entries) {
276
+ if (!entry.isDirectory())
277
+ continue;
278
+ const full = path.join(dayDir, entry.name);
279
+ let mtimeMs = 0;
280
+ try {
281
+ mtimeMs = (await stat(full)).mtimeMs;
282
+ }
283
+ catch {
284
+ continue;
285
+ }
286
+ sessions.push({ full, relative: day + "/" + entry.name, mtimeMs });
287
+ }
288
+ }
289
+ if (sessions.length > keepSessions) {
290
+ sessions.sort((a, b) => b.mtimeMs - a.mtimeMs);
291
+ for (const stale of sessions.slice(keepSessions)) {
292
+ const size = await measure(stale.full);
293
+ await rm(stale.full, { recursive: true, force: true });
294
+ removedDirs.push(stale.relative);
295
+ removedFiles += size.files;
296
+ removedBytes += size.bytes;
297
+ }
298
+ }
299
+ return { removedDirs, removedFiles, removedBytes };
300
+ }
301
+ /**
302
+ * 启动定期落盘。返回停止函数(停止时再冲一次,尽量把内存里的挤出条目落完)。
303
+ *
304
+ * onError 只用于把失败报给宿主日志;默认静默,避免磁盘问题刷屏。
305
+ */
306
+ export function startEventLog(options = {}) {
307
+ const policy = evidencePolicy(options.env);
308
+ const intervalMs = options.intervalMs ?? policy.flushSeconds * 1000;
309
+ let running = false;
310
+ const tick = async () => {
311
+ if (running)
312
+ return;
313
+ running = true;
314
+ try {
315
+ // 每拍把新事件也写一份(S72):不再只有溢出才留证据。
316
+ await flushPending({ root: options.root, env: options.env });
317
+ await pruneEvidence({ root: options.root, env: options.env, keepDays: policy.keepDays, keepSessions: policy.keepSessions });
318
+ }
319
+ catch (error) {
320
+ options.onError?.(error);
321
+ }
322
+ finally {
323
+ running = false;
324
+ }
325
+ };
326
+ const timer = setInterval(() => {
327
+ void tick();
328
+ }, intervalMs);
329
+ if (typeof timer.unref === "function")
330
+ timer.unref();
331
+ return async () => {
332
+ clearInterval(timer);
333
+ await tick();
334
+ };
335
+ }
@@ -0,0 +1,146 @@
1
+ /**
2
+ * 故障解码:把工具失败事件里的一行原文,翻成「先看哪里」。
3
+ *
4
+ * 只按已知文本特征匹配,不做通用日志理解;没命中就原样返回,由人判断。
5
+ * 规则表按「最具体在前」排列:先匹配到的规则生效,避免 "cmsis-dap" 这类泛词盖住更精确的提示。
6
+ */
7
+ const RULES = [
8
+ {
9
+ id: "probe.cmsis-dap-missing",
10
+ category: "probe",
11
+ test: /unable to find a matching cmsis-dap|no cmsis-dap device|没有找到.*cmsis-dap/iu,
12
+ hint: "探针没被识别:确认 USB 线接在数据口、换一个 USB 口,仍失败则重装 DAPLink 驱动或换 ST-Link。",
13
+ },
14
+ {
15
+ id: "probe.openocd-init",
16
+ category: "probe",
17
+ test: /error:\s*init|openocd.*failed|无法.*连接.*探针/iu,
18
+ hint: "调试器初始化失败:先关掉 VS Code 或其它占用探针的程序,再执行 stm32_doctor 看是否有残留进程。",
19
+ },
20
+ {
21
+ id: "target.no-response",
22
+ category: "target",
23
+ test: /no device found|target not found|unable to connect|target.*did not respond/iu,
24
+ hint: "目标芯片没响应:确认板子供电、SWD 四线(3V3/GND/SWDIO/SWCLK)接对,必要时按住复位再连。",
25
+ },
26
+ {
27
+ id: "target.not-halted",
28
+ category: "target",
29
+ test: /target not halted|not halted|cannot.*halt/iu,
30
+ hint: "目标没停住:程序可能关掉了调试口或进了低功耗,检查 .ioc 里 Serial Wire 是否开启。",
31
+ },
32
+ {
33
+ id: "flash.verify",
34
+ category: "flash",
35
+ test: /verified ok|verification failed|校验失败/iu,
36
+ hint: "烧录校验不通过:确认芯片型号与工程一致,重新上电后重烧一次。",
37
+ },
38
+ {
39
+ id: "build.no-build-dir",
40
+ category: "build",
41
+ test: /找不到已配置的构建目录/iu,
42
+ hint: "没有构建目录:先跑一次 cmake 配置(或用 stm32_build 的预设),不要在未配置的目录上直接构建。",
43
+ },
44
+ {
45
+ id: "build.cmake-failed",
46
+ category: "build",
47
+ test: /FAILED: \[code=\d+\]/iu,
48
+ hint: "编译或链接失败:看同一事件里 errors 的前几行,通常是源码写错,或新增的 .c 没有登记进 cmake/user/CMakeLists.txt。",
49
+ },
50
+ {
51
+ id: "build.undefined-reference",
52
+ category: "build",
53
+ test: /undefined reference|undefined symbol/iu,
54
+ hint: "链接缺符号:新加的 .c 是否登记进 cmake/user/CMakeLists.txt,函数声明与实现是否一致。",
55
+ },
56
+ {
57
+ id: "build.missing-header",
58
+ category: "build",
59
+ test: /fatal error:.*\.h: no such file|compilation terminated/iu,
60
+ hint: "编译缺头文件:检查 include 路径与文件名大小写;CubeMX 重新生成后是否漏了某个目录。",
61
+ },
62
+ {
63
+ id: "toolchain.missing-tool",
64
+ category: "toolchain",
65
+ test: /is not recognized as an internal|系统找不到指定的文件|command not found|not found in path/iu,
66
+ hint: "命令不存在:工具链没装或在 PATH 之外,执行 stm32_doctor 后按提示装齐或补 binDirs。",
67
+ },
68
+ {
69
+ id: "network.download",
70
+ category: "network",
71
+ test: /下载安装包失败|download failed|econnrefused|econnreset|getaddrinfo|etimedout|网络/iu,
72
+ hint: "下载失败:先确认网络可达;安装包会自动回退国内镜像,仍失败就手动下载后放进缓存目录。",
73
+ },
74
+ {
75
+ id: "io.permission",
76
+ category: "tool",
77
+ test: /eperm|eacces|permission denied|拒绝访问/iu,
78
+ hint: "权限不足:目标文件被占用或目录只读,关掉占用程序或换一个可写目录。",
79
+ },
80
+ {
81
+ id: "io.busy",
82
+ category: "tool",
83
+ test: /ebusy|being used by another process|另一个程序正在使用/iu,
84
+ hint: "设备或文件被占用:关掉串口助手、CubeProgrammer 等占用方后重试。",
85
+ },
86
+ {
87
+ id: "debug.no-session",
88
+ category: "debug",
89
+ test: /没有调试会话|no active debug session/iu,
90
+ hint: "当前没有调试会话:先调用 stm32_debug_session 建立会话,再操作断点或读取变量。",
91
+ },
92
+ {
93
+ id: "ioc.missing",
94
+ category: "tool",
95
+ test: /没有可读的 \.ioc|no \.ioc/iu,
96
+ hint: "工程里没有 .ioc:确认 projectDir 指向工程根目录,而不是 build 或子目录。",
97
+ },
98
+ ];
99
+ /** 按规则表解码一行失败原文。 */
100
+ export function decodeFault(text) {
101
+ const source = text.trim();
102
+ if (source === "")
103
+ return { category: "other", hint: "", rule: "none" };
104
+ for (const rule of RULES) {
105
+ if (rule.test.test(source))
106
+ return { category: rule.category, hint: rule.hint, rule: rule.id };
107
+ }
108
+ return { category: "other", hint: "", rule: "none" };
109
+ }
110
+ /**
111
+ * 按规则合并失败事件(S46)。
112
+ *
113
+ * 一次构建失败往往连着几条同因错误(多个未定义符号各算一条),逐条列会把
114
+ * 真正不同的那一条挤到屏幕外。合并只影响展示:计数、首末序号与时间保留,
115
+ * 原始事件仍在时间线与 `faults` 列表里。
116
+ */
117
+ export function groupFaults(items) {
118
+ const groups = new Map();
119
+ for (const item of items) {
120
+ const found = groups.get(item.rule);
121
+ if (found === undefined) {
122
+ groups.set(item.rule, {
123
+ rule: item.rule,
124
+ category: item.category,
125
+ hint: item.hint,
126
+ count: 1,
127
+ firstSeq: item.seq,
128
+ lastSeq: item.seq,
129
+ firstTime: item.time,
130
+ lastTime: item.time,
131
+ });
132
+ continue;
133
+ }
134
+ groups.set(item.rule, {
135
+ rule: found.rule,
136
+ category: found.category,
137
+ hint: found.hint,
138
+ count: found.count + 1,
139
+ firstSeq: Math.min(found.firstSeq, item.seq),
140
+ lastSeq: Math.max(found.lastSeq, item.seq),
141
+ firstTime: found.firstTime,
142
+ lastTime: item.time,
143
+ });
144
+ }
145
+ return Array.from(groups.values()).sort((left, right) => right.count - left.count || left.rule.localeCompare(right.rule));
146
+ }