nx-kv 0.9.0 → 0.10.0
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.
- package/CHANGELOG.md +96 -0
- package/README.md +36 -1
- package/assets/groups.json +4 -0
- package/assets/kv-timegoal/SKILL.md +160 -0
- package/assets/kv-timegoal/references/workflow.md +151 -0
- package/package.json +1 -1
- package/src/modules/localtask/service.js +105 -22
- package/src/modules/localtask/view.jsx +454 -5
- package/src/modules/timegoal/index.js +157 -0
- package/src/modules/timegoal/service.js +313 -0
- package/src/runtime/registry.js +2 -1
- package/src/web/public/assets/{CliHints-CGOWc046.js → CliHints-B98Zw4uK.js} +1 -1
- package/src/web/public/assets/{index-BVbLNACS.js → index-57QX-j8y.js} +2 -2
- package/src/web/public/assets/{view-BlGIceud.js → view-BskvoBME.js} +1 -1
- package/src/web/public/assets/{view-BBdEL07x.js → view-BzY577lO.js} +1 -1
- package/src/web/public/assets/view-Cn7mYuiU.js +1 -0
- package/src/web/public/assets/{view-DUy79STG.js → view-_UA707kn.js} +1 -1
- package/src/web/public/index.html +1 -1
- package/src/web/public/assets/view-CwFWDigR.js +0 -1
|
@@ -314,15 +314,47 @@ function normalizeTask(t) {
|
|
|
314
314
|
};
|
|
315
315
|
}
|
|
316
316
|
|
|
317
|
+
// 主题的截止时刻(epoch ms)。优先用 waitingUntilMs(毫秒精度,新数据都有),
|
|
318
|
+
// 老数据没有这个字段时才回退解析 waitingUntil 字符串(秒级精度)。
|
|
319
|
+
export function deadlineMsOf(t) {
|
|
320
|
+
if (!t) return NaN;
|
|
321
|
+
if (Number.isFinite(t.waitingUntilMs) && t.waitingUntilMs > 0) return t.waitingUntilMs;
|
|
322
|
+
return parseStampMs(t.waitingUntil);
|
|
323
|
+
}
|
|
324
|
+
|
|
325
|
+
// 主题是否「真的有人在等」——**必须看截止时刻,不能只看 waiting 标志**。
|
|
326
|
+
//
|
|
327
|
+
// waiting 标志由 wait 进程写入、结束时复位;跨进程可见,但 wait 被强杀
|
|
328
|
+
// (SIGKILL / 任务管理器杀 / 终端关掉 / 机器崩了)时 finally 不会执行,标志
|
|
329
|
+
// 就**永久残留**。曾出现过:gs-ac 的 wait 被杀后,标志一直挂着,面板永远显示
|
|
330
|
+
// 「等待中 已等 760:35 · 剩 0:00」,用户点「关闭」也没有进程来消费。
|
|
331
|
+
//
|
|
332
|
+
// 判据:waiting 为真**且**截止时刻还没过。截止时刻已过 = 那个 wait 本来也该
|
|
333
|
+
// 收尾了(超时),此时的 waiting 是残留,不是"有人正等着"。
|
|
334
|
+
//
|
|
335
|
+
// 唯一会误判的窗口:wait 进程还活着、但刚好卡在超时那一瞬(<1s)——那时
|
|
336
|
+
// 它下一拍就会自己收尾,短暂显示"已结束"无伤大雅。
|
|
337
|
+
export function isLiveWaiting(t, nowMs = Date.now()) {
|
|
338
|
+
if (!t || !t.waiting) return false;
|
|
339
|
+
const until = deadlineMsOf(t);
|
|
340
|
+
if (!Number.isFinite(until)) return false; // 没有截止时刻 = 脏数据,不算等待中
|
|
341
|
+
return until > nowMs;
|
|
342
|
+
}
|
|
343
|
+
|
|
317
344
|
function topicView(t) {
|
|
318
345
|
const tasks = t.tasks.map(normalizeTask);
|
|
346
|
+
const live = isLiveWaiting(t);
|
|
319
347
|
return {
|
|
320
348
|
key: t.key,
|
|
321
349
|
cwd: t.cwd || '',
|
|
322
350
|
name: t.name || '',
|
|
323
351
|
summary: t.summary || '',
|
|
324
|
-
waiting
|
|
352
|
+
// waiting 是**对外的真相**:僵尸标志在这里被抹平,面板才不会一直转圈
|
|
353
|
+
waiting: live,
|
|
354
|
+
// 残留标志单独透出,UI 可以说明"上次等待超时、进程已退出"而不是装作从没有过
|
|
355
|
+
staleWaiting: !!t.waiting && !live,
|
|
325
356
|
waitingUntil: t.waitingUntil || '',
|
|
357
|
+
waitingUntilMs: Number(t.waitingUntilMs) || 0,
|
|
326
358
|
waitingSince: t.waitingSince || '',
|
|
327
359
|
cancelRequested: !!t.cancelRequested,
|
|
328
360
|
isGlobal: isGlobalKey(t.key),
|
|
@@ -402,6 +434,12 @@ async function setWaiting(key, cwd, summary, waiting, deadline) {
|
|
|
402
434
|
const t = topicOf(store, key, cwd);
|
|
403
435
|
t.waiting = !!waiting;
|
|
404
436
|
t.waitingUntil = waiting && deadline ? stampNow(deadline) : '';
|
|
437
|
+
// **毫秒精度的截止时刻**(epoch ms)。waitingUntil 那串是给人看的、只有秒级精度,
|
|
438
|
+
// 而 stampNow 是「截断」不是「四舍五入」——短时限(秒级)时截断误差能吃掉整个窗口:
|
|
439
|
+
// wait 若恰好在某秒最后 40ms 启动,真实 deadline 是 S+1.97s,存成 "S+1" 解析回来
|
|
440
|
+
// 就是 S+1.000,比 now 还早 → 被判成「没在等」→ 事件流永远推不出 waiting。
|
|
441
|
+
// 判据一律走 deadlineMsOf():优先读这个精确值,老数据才回退解析字符串。
|
|
442
|
+
t.waitingUntilMs = waiting && deadline ? deadline.getTime() : 0;
|
|
405
443
|
t.waitingSince = waiting ? stampNow() : '';
|
|
406
444
|
// 新一轮等待不继承上一轮残留的「关闭」请求,否则刚进来就被立刻收尾
|
|
407
445
|
t.cancelRequested = false;
|
|
@@ -419,6 +457,7 @@ async function clearWaiting(key) {
|
|
|
419
457
|
if (!t) return;
|
|
420
458
|
t.waiting = false;
|
|
421
459
|
t.waitingUntil = '';
|
|
460
|
+
t.waitingUntilMs = 0;
|
|
422
461
|
t.waitingSince = '';
|
|
423
462
|
t.cancelRequested = false;
|
|
424
463
|
t.updatedAt = stampNow();
|
|
@@ -446,7 +485,7 @@ export async function cancelWait({ cwd: rawCwd, key: rawKey } = {}) {
|
|
|
446
485
|
}
|
|
447
486
|
const store = await loadStore();
|
|
448
487
|
const t = store.topics[key];
|
|
449
|
-
if (!t || !t
|
|
488
|
+
if (!t || !isLiveWaiting(t)) {
|
|
450
489
|
return { cancelled: false, key, name: (t && t.name) || '', cwd: (t && t.cwd) || '', reason: 'not_waiting' };
|
|
451
490
|
}
|
|
452
491
|
t.cancelRequested = true;
|
|
@@ -504,11 +543,15 @@ export async function getSettings() {
|
|
|
504
543
|
// 2) 空主题(没有任何任务);
|
|
505
544
|
// 3) allFinished 时,连同「已全部领取、无待领」的主题一起清。
|
|
506
545
|
// 等待中的主题与全局主题一律保留;dryRun 只报告不改动。
|
|
546
|
+
//
|
|
547
|
+
// **僵尸等待标志不算"等待中"**:wait 被强杀后残留的 waiting:true 会让主题
|
|
548
|
+
// 永远躲过清理(gs-ac 就这么卡住的)。用 isLiveWaiting 判定——截止已过 = 没人
|
|
549
|
+
// 在等 = 可以清。
|
|
507
550
|
export async function pruneTopics({ allFinished = false, dryRun = false } = {}) {
|
|
508
551
|
const store = await loadStore();
|
|
509
552
|
const removed = [];
|
|
510
553
|
for (const [key, t] of Object.entries(store.topics)) {
|
|
511
|
-
if (t
|
|
554
|
+
if (isLiveWaiting(t) || isGlobalKey(key)) continue;
|
|
512
555
|
const tasks = Array.isArray(t.tasks) ? t.tasks : [];
|
|
513
556
|
const hasPending = tasks.some((x) => x.status !== 'consumed');
|
|
514
557
|
const isLegacy = !t.cwd;
|
|
@@ -717,7 +760,7 @@ export async function removeTopic({ cwd: rawCwd, key: rawKey, force = false } =
|
|
|
717
760
|
if (isGlobalKey(key) && !force) {
|
|
718
761
|
throw badInput('全局主题是共享任务池,默认不能删除(确认要清空请加 --force)');
|
|
719
762
|
}
|
|
720
|
-
if (t
|
|
763
|
+
if (isLiveWaiting(t) && !force) {
|
|
721
764
|
throw badInput('主题正在等待中,不能删除(确认要删请加 --force,agent 将超时收尾)');
|
|
722
765
|
}
|
|
723
766
|
const view = topicView(t);
|
|
@@ -759,7 +802,7 @@ export async function removeTopics({ keys, cwds, all = false, force = false } =
|
|
|
759
802
|
skipped.push({ key, name: t.name, cwd: t.cwd, reason: 'protected' });
|
|
760
803
|
continue;
|
|
761
804
|
}
|
|
762
|
-
if (t
|
|
805
|
+
if (isLiveWaiting(t) && !force) {
|
|
763
806
|
skipped.push({ key, name: t.name, cwd: t.cwd, reason: 'waiting' });
|
|
764
807
|
continue;
|
|
765
808
|
}
|
|
@@ -962,20 +1005,29 @@ export async function waitForTask({
|
|
|
962
1005
|
// 没活标签且主面板在跑 → 开浏览器深链(让用户能在面板里选中主题并响应等待事件)。
|
|
963
1006
|
// 已有活标签 / --no-open / 主面板未启动 → 都不开(避免重复标签 + 冒烟/CI 兼容)。
|
|
964
1007
|
const openPage = open && presence === 0 && panelInfo.running;
|
|
1008
|
+
// 初次开页也要计入冷却。页面从「进程已拉起」到「SSE 连上」有 1–3s 空窗,
|
|
1009
|
+
// 不记这一笔的话,第一次复查(5s 后)会把「还在加载」判成「没开」→ 立刻再开一个。
|
|
1010
|
+
let lastOpenAt = openPage ? Date.now() : 0;
|
|
1011
|
+
let opens = openPage ? 1 : 0;
|
|
965
1012
|
if (openPage) openBrowser(deepLink);
|
|
966
1013
|
|
|
967
1014
|
// 周期复查:等待期间每 5s 查一次活动标签;万一开始时判错(页面被关),20s 冷却内重开。
|
|
968
|
-
// 不到点不开新页(节流,避免「标签被关 → 立刻开 →
|
|
969
|
-
|
|
970
|
-
|
|
971
|
-
|
|
1015
|
+
// 不到点不开新页(节流,避免「标签被关 → 立刻开 → 立刻关」抖动);总次数也有上限 ——
|
|
1016
|
+
// 若浏览器拦了脚本 / 用户就是不想看,每 20s 开一个只会变成窗口风暴。
|
|
1017
|
+
//
|
|
1018
|
+
// 单次探测为 0 **不算**「标签被关」:后台标签被浏览器冻结、SSE 自动重连、网络抖动
|
|
1019
|
+
// 都会短暂掉到 0(EventSource 自带重连,几秒后自己回来)。所以要连续两次(≈10s)
|
|
1020
|
+
// 都探不到活连接才重开,否则一次抖动就多一个窗口。
|
|
1021
|
+
let zeroStreak = 0;
|
|
972
1022
|
const review = setInterval(async () => {
|
|
973
1023
|
if (!panelInfo.running || !open) return;
|
|
974
1024
|
const n = await probePresence().catch(() => 0);
|
|
975
|
-
|
|
1025
|
+
zeroStreak = n > 0 ? 0 : zeroStreak + 1;
|
|
1026
|
+
if (zeroStreak < 2) return;
|
|
976
1027
|
const now = Date.now();
|
|
977
|
-
if (now
|
|
978
|
-
|
|
1028
|
+
if (!shouldReopenWindow({ presence: n, now, lastOpenAt, opens })) return;
|
|
1029
|
+
lastOpenAt = now;
|
|
1030
|
+
opens += 1;
|
|
979
1031
|
openBrowser(deepLink);
|
|
980
1032
|
}, REVIEW_MS);
|
|
981
1033
|
review.unref?.();
|
|
@@ -1017,17 +1069,13 @@ export async function waitForTask({
|
|
|
1017
1069
|
// 有 agent 正阻塞等人时,面板是唯一提醒来源,绝不能在此时释放。
|
|
1018
1070
|
//
|
|
1019
1071
|
// waiting 标志由 wait 进程写入、结束复位,跨进程可见;但 wait 被强杀(SIGKILL)时
|
|
1020
|
-
//
|
|
1021
|
-
// wait 本来也要收尾了,不会误伤正常等待。
|
|
1072
|
+
// 标志会残留。判据统一走 isLiveWaiting(含「截止时刻已过 = 不算等待」这道闸)。
|
|
1022
1073
|
export async function countWaitingTopics() {
|
|
1023
1074
|
const store = await loadStore();
|
|
1024
1075
|
const now = Date.now();
|
|
1025
1076
|
let n = 0;
|
|
1026
1077
|
for (const t of Object.values(store.topics)) {
|
|
1027
|
-
if (
|
|
1028
|
-
const until = parseStampMs(t.waitingUntil);
|
|
1029
|
-
if (Number.isFinite(until) && until <= now) continue; // 残留标志:截止时刻已过
|
|
1030
|
-
n += 1;
|
|
1078
|
+
if (isLiveWaiting(t, now)) n += 1;
|
|
1031
1079
|
}
|
|
1032
1080
|
return n;
|
|
1033
1081
|
}
|
|
@@ -1134,8 +1182,37 @@ async function probePresence(timeoutMs = 900) {
|
|
|
1134
1182
|
});
|
|
1135
1183
|
}
|
|
1136
1184
|
|
|
1137
|
-
|
|
1138
|
-
|
|
1185
|
+
// 复查节奏与重开上限。抽到模块级是为了能被单测直接引用(不用起服务器)。
|
|
1186
|
+
const REVIEW_MS = 5_000;
|
|
1187
|
+
const REOPEN_COOLDOWN_MS = 20_000;
|
|
1188
|
+
// 一次 wait 最多开 3 个窗口:够救「手滑关掉」,又不至于在浏览器拦截脚本时刷屏。
|
|
1189
|
+
const MAX_WINDOW_OPENS = 3;
|
|
1190
|
+
|
|
1191
|
+
/**
|
|
1192
|
+
* 复查时要不要重开窗口。四条判据,任一不满足就不开:
|
|
1193
|
+
* 1. 有活标签(presence > 0)→ 用户在看着,别打扰;
|
|
1194
|
+
* 2. 已经开够次数 → 停止(浏览器拦了脚本、或用户就是不想看,开再多也没用);
|
|
1195
|
+
* 3. 距上一次开页还在冷却期内 → 等一等(页面加载 + 建立 SSE 需要几秒);
|
|
1196
|
+
* 4. 其余情况才重开(标签被关了 / 第一次没开成)。
|
|
1197
|
+
*
|
|
1198
|
+
* 抽成纯函数的原因:这段逻辑的 bug 不报错、只表现为「窗口越开越多」,
|
|
1199
|
+
* 必须能被单测钉住。
|
|
1200
|
+
*/
|
|
1201
|
+
export function shouldReopenWindow({
|
|
1202
|
+
presence,
|
|
1203
|
+
now,
|
|
1204
|
+
lastOpenAt,
|
|
1205
|
+
opens,
|
|
1206
|
+
cooldownMs = REOPEN_COOLDOWN_MS,
|
|
1207
|
+
maxOpens = MAX_WINDOW_OPENS,
|
|
1208
|
+
} = {}) {
|
|
1209
|
+
if (Number(presence) > 0) return false;
|
|
1210
|
+
if (Number(opens) >= maxOpens) return false;
|
|
1211
|
+
if (Number(lastOpenAt) > 0 && Number(now) - Number(lastOpenAt) < cooldownMs) return false;
|
|
1212
|
+
return true;
|
|
1213
|
+
}
|
|
1214
|
+
|
|
1215
|
+
function panelBaseUrl() { return `http://127.0.0.1:${DEFAULT_PORT}`;
|
|
1139
1216
|
}
|
|
1140
1217
|
|
|
1141
1218
|
// 深链到主面板「实时任务」页并选中当前主题(key 优先,cwd 兜底)。
|
|
@@ -1244,12 +1321,18 @@ export async function* watchEvents({ cwd: rawCwd, key: rawKey, pollMs = EVENT_PO
|
|
|
1244
1321
|
|
|
1245
1322
|
const now = Date.now();
|
|
1246
1323
|
for (const t of topics) {
|
|
1247
|
-
|
|
1324
|
+
// 截止时刻走 deadlineMsOf():优先毫秒精度的 waitingUntilMs,老数据才解析字符串。
|
|
1325
|
+
// 之前这里自己解析 waitingUntil(秒级),短时限下截断误差会让「正在等」被判成
|
|
1326
|
+
// 「没在等」→ 事件流永远推不出 waiting(tests/unit/localtask-sse.test.mjs 曾
|
|
1327
|
+
// 因此有 ~4% 的 flake)。
|
|
1328
|
+
const deadline = deadlineMsOf(t);
|
|
1248
1329
|
const isWaiting = !!t.waiting && Number.isFinite(deadline) && deadline > now;
|
|
1249
1330
|
let st = state.get(t.key);
|
|
1250
1331
|
|
|
1251
1332
|
if (isWaiting) {
|
|
1252
|
-
|
|
1333
|
+
// 「是不是新一轮等待」用**毫秒精度的 deadline** 判定:waitingUntil 字符串只有
|
|
1334
|
+
// 秒级,同一秒内开始的两次等待字符串相同,靠它判会漏掉新一轮。
|
|
1335
|
+
if (!st || st.phase !== 'waiting' || st.deadline !== deadline) {
|
|
1253
1336
|
st = {
|
|
1254
1337
|
phase: 'waiting',
|
|
1255
1338
|
waitingUntil: t.waitingUntil,
|