cron-up 26.10.32 → 26.10.34

package/src/cron.mjs

@@ -12,11 +12,13 @@ import { isDecInt } from './internals.mjs';
 const MS_DAY = 86400_000;
 const MS_MINUTE = 60_000;
 
-// 严格十进制整数（isDecInt 的谓词见 internals）：parseInt("5x") 会静默返回
-// 5，必须自己卡。
+// 严格十进制安全整数（isDecInt 的谓词见 internals）：parseInt("5x") 会
+// 静默返回 5；达到 2^53 后 v+=1 不再改变数值，区间循环会永久挂住。
 function strictInt(s) {
   if (!isDecInt(s)) throw new Error(`不是整数：${s}`);
-  return parseInt(s, 10);
+  const n = parseInt(s, 10);
+  if (!Number.isSafeInteger(n)) throw new Error(`整数超出安全范围：${s}`);
+  return n;
 }
 
 // 解析一个 cron 字段为它命名的合法值域集合。
@@ -53,9 +55,16 @@ export function parseCronField(expr, lo, hi) {
       start = end = strictInt(rng);
       if (slash >= 0) end = hi; // vixie："5/10" 表示 5,15,25,… 直到 hi
     }
-    for (let v = start; v <= end; v += step) {
-      if (v >= lo && v <= hi) values.add(v);
-    }
+    if (start > end || end < lo || start > hi) continue;
+    // 只迭代合法值域内的至多 hi-lo+1 个值。起点低于 lo 时用步进算出
+    // 首个候选，不能直接钳到 lo，否则 0-20/3 在 lo=1 时会从 3,6,…
+    // 变成 1,4,…；终点直接钳到 hi，超大区间不会拖死整轮巡检。
+    const first = start < lo
+      ? start + Math.ceil((lo - start) / step) * step
+      : start;
+    if (!Number.isSafeInteger(first)) continue;
+    const last = Math.min(end, hi);
+    for (let v = first; v <= last; v += step) values.add(v);
   }
   return values;
 }
@@ -251,7 +260,7 @@ export function taskWanted(task, now, leadMs) {
 // 两个口径供展示视图复用（同一个已解析 cron 顺带回答巡检问题）。
 export { wantedNow, wantedWithin };
 
-// ---- Claude Code 投递抖动（预计实际触发时间）----
+// ---- Claude Code 投递抖动（预计投递时间）----
 // 复刻 v2.1.285 内部的 M()：任务 id 前 8 位十六进制除以 2^32，得 [0,1) 的
 // 固定哈希——同一任务每次触发的抖动完全相同，不是随机数。id 缺失或前 8
 // 位都不是十六进制时 parseInt 得 NaN，上游回退 0；任务文件由别的程序书
@@ -262,7 +271,7 @@ export function taskIdHash(taskId) {
   return Number.isFinite(n) ? n : 0;
 }
 
-// 任务在展示语境里的「落点 → 预计实际投递」对：一次性任务是落点加网格
+// 任务在展示语境里的「设定时间 → 预计投递」对：一次性任务是落点加网格
 // 提前量；周期任务在投递尾窗内属于上一落点（即将到来的这次延迟投递，
 // 不是 nextAfter 给出的下个落点——后者严格在未来，会把展示拐到明天），
 // 否则是下一落点 + 按 id 的抖动。先于窗口检查尾窗：2 月 29 日这类长周期
@@ -317,7 +326,7 @@ function recurringDelayMs(cron, slot, taskId, withinDays) {
 
 // 周期任务的「投递尾窗」判定：上一落点已过、按 id 算的延迟投递时刻未
 // 到。返回 [落点, 投递时刻 ms]；不在尾窗、找不到上一或下一落点返回
-// null。wanted（保活判定）与 nextDelivery（展示）共用这一口径，两边不会
+// null。wanted（会话需求判定）与 nextDelivery（展示）共用这一口径，两边不会
 // 各说各话；窗口取 TAIL_WINDOW_DAYS，理由见 constants。
 function recurringTailWindow(cron, taskId, now) {
   const prev = cron.prevAtOrBefore(now, TAIL_WINDOW_DAYS);

package/src/display.mjs

@@ -110,7 +110,7 @@ export function taskView(task, now, leadMs) {
     // wanted 恒为 null 或布尔：没传 leadMs（不问）与 cron 无效（问不了）
     // 都是 null，键的形状不随参数变化。
     wanted: leadMs !== undefined ? wantedWithin(cron, task, now, leadMs) : null,
-    // 计入 Claude Code 投递抖动后的预计实际触发时刻；已错过的一次性任务
+    // 计入 Claude Code 投递抖动后的预计投递时刻；已错过的一次性任务
     // 没有未来触发，为 null；尾窗内的周期任务是即将到来的这次延迟投递。
     // 与 nxt 同为 Date 或 null。
     fire: missed ? null : fire,
@@ -135,7 +135,7 @@ export function pad2(n) {
   return String(n).padStart(2, '0');
 }
 
-// 「设定落点 → 预计实际触发」文案。抖动四舍五入到秒（调度器秒级轮询）：
+// 「设定时间 → 预计投递」文案。抖动四舍五入到秒（调度器秒级轮询）：
 // 同日省略第二个日期；预计值带非零秒时显示 HH:MM:SS（如 05:15:37）；落
 // 在同一分钟（无抖动）则只显示落点，不画无意义的箭头。
 export function fmtFireRange(nxt, fire) {

package/src/list.mjs

@@ -19,7 +19,7 @@ function rank(v) {
   return v.nxt ? 1 : 2;
 }
 
-// 状态列文案：有效任务是「设定落点 → 预计实际触发」（无抖动时只有落点）。
+// 状态列文案：有效任务是「设定时间 → 预计投递」（无抖动时只有设定时间）。
 function statusText(v) {
   if (!v.valid) return 'cron 无效';
   if (v.missed) return '已错过';

package/src/logs.mjs

@@ -72,7 +72,8 @@ export function cmdLogs(args) {
       + `「${args.workspace}」匹配的会话日志`);
     throw new ExitError(1);
   }
-  const tailArgs = args.follow ? ['-f'] : ['-n', '100'];
+  // -F 同时按名字与描述符跟随：日志 rename 后原路径重建也能接上。
+  const tailArgs = args.follow ? ['-F'] : ['-n', '100'];
   tailArgs.push(file);
   const r = deps.spawnSync('/usr/bin/tail', tailArgs, { stdio: 'inherit' });
   if (r.error) throw r.error;

package/src/overview.mjs

@@ -77,7 +77,7 @@ function overviewTasks(cfg, cols, details, state) {
         bad += 1;
         continue;
       }
-      // 「最近」按计入抖动后的预计实际触发排，而非 cron 落点。
+      // 「最近」按计入抖动后的预计投递时间排，而非 cron 落点。
       const fire = v.fire ?? v.nxt;
       if (fire && (!soonest || fire.getTime() < soonest[0].getTime())) {
         soonest = [fire, ws, v.summary, v.nxt];
@@ -189,18 +189,18 @@ function overviewSessions(cols, state, details, suppressCooling, discovered) {
 }
 
 const COMMANDS = [
-  ['list', '逐个列出任务的内容摘要、设定/预计触发时间与预热状态'],
+  ['list', '逐个列出任务的内容摘要、设定/预计投递时间与预热状态'],
   ['logs [目录片段] [-f]', '查看巡检日志或后台会话记录'],
   ['run', '立即手动巡检一轮'],
-  ['install --roots ~/a,~/b', '更新扫描目录并重新安装（不带参数保留现有配置）'],
+  ['install --roots ~/a,~/b', '更新扫描目录并重新安装（不带参数沿用有效配置）'],
 ];
 
 export async function cmdOverview(args) {
   const cols = deps.terminalWidth();
   const v = packageVersion();
   deps.print(v === null
-    ? 'cron-up —— 为定时任务提前备好交互会话'
-    : `cron-up ${v} —— 为定时任务提前备好交互会话（一任务一会话）`);
+    ? 'cron-up —— 为 Claude Code 定时任务按需预热交互会话'
+    : `cron-up ${v} —— 为 Claude Code 定时任务按需预热交互会话（一任务一会话）`);
 
   const cfgPath = args?.config ?? deps.paths.configPath;
   let cfg = null;
@@ -232,8 +232,8 @@ export async function cmdOverview(args) {
   } else if (cfg === null) {
     deps.print('配置：缺失，运行 cron-up install 生成');
   } else {
-    deps.print(`巡检：每 ${INTERVAL_SECONDS} 秒一轮，提前 ${LEAD_SECONDS} `
-      + '秒为每个窗口内任务启动专属预热会话');
+    deps.print(`巡检：每 ${INTERVAL_SECONDS} 秒一轮，周期任务提前 ${LEAD_SECONDS} `
+      + '秒进入预热窗口');
     if (info && info.interval !== null && info.interval !== undefined
         && info.interval !== INTERVAL_SECONDS) {
       alerts.push(`launchd 实际间隔 ${info.interval} 秒与当前版本的 `