cron-up 26.10.25 → 26.10.27

package/src/service.mjs

@@ -4,8 +4,14 @@
 import fs from 'node:fs';
 import path from 'node:path';
 
-import { deps, ExitError } from './internals.mjs';
+import {
+  deps,
+  ExitError,
+  isPlainObject,
+  ensurePrivateDir,
+} from './internals.mjs';
 import { paths, LABEL } from './paths.mjs';
+import { SPECS, thisCamel } from './args.mjs';
 // paths.home 仅用于 resolveLauncher 的默认 HOME；其余产物路径一律走
 // deps.paths（测试要整体重定向）。
 import { scriptProcLogPath } from './sessions.mjs';
@@ -22,7 +28,7 @@ import {
   configFieldErrors,
 } from './config.mjs';
 
-export function guiTarget() {
+function guiTarget() {
   return `gui/${process.getuid()}`;
 }
 
@@ -33,7 +39,9 @@ export function launchctl(...args) {
 }
 
 export function launchctlInfo() {
-  const r = launchctl('print', `${guiTarget()}/${LABEL}`);
+  // 走 deps 而非同文件裸名：与 bootout/bootstrap 的打桩面保持一致，测试可
+  // 在 launchctl 一层整体模拟 launchd。
+  const r = deps.launchctl('print', `${guiTarget()}/${LABEL}`);
   if (r.status !== 0) return null;
   const info = {};
   for (const key of ['state', 'last exit code']) {
@@ -51,7 +59,7 @@ const LAUNCHD_STATES = new Map([
   ['not running', '空闲中（按间隔触发）'],
 ]);
 
-export function launchdStateZh(state) {
+function launchdStateZh(state) {
   // launchd 的 "not running" 是间隔触发型服务两轮之间的正常空闲态，直译
   // 会让人以为服务停了；未识别的值原样保留以便排查。
   if (!state) return '未知';
@@ -243,6 +251,13 @@ export function launcherHealth() {
 
 // ---- install / uninstall ----
 
+// install 的可覆盖项（配置键 → 命令行旗标）：--force 缺席时逐项点名「未
+// 生效的参数」。名单直接从解析器的选项表派生——force 不落盘，其余选项都
+// 会写进配置；新加可持久化选项时这里自动跟进，不会静默漏报。
+const IGNORED_INSTALL_FLAGS = Object.keys(SPECS.install.options)
+  .filter((name) => name !== 'force')
+  .map((name) => [thisCamel(name), `--${name}`]);
+
 export async function cmdInstall(args) {
   // --config 在这里只会造成误解：install 写盘、launchd 每轮读取的都是固定
   // 路径的配置，指定别的路径不改变任何行为——静默忽略等于让人以为装到了
@@ -252,12 +267,8 @@ export async function cmdInstall(args) {
       + `使用 ${deps.paths.configPath}，如需临时改配置请直接编辑该文件`);
   }
   fs.mkdirSync(deps.paths.dataDir, { recursive: true });
-  fs.mkdirSync(deps.paths.sessionLogDir, { recursive: true });
-  try {
-    fs.chmodSync(deps.paths.sessionLogDir, 0o700);
-  } catch {
-    // 维持现状。
-  }
+  // dataDir 只建不 chmod：本分支可能保留旧配置而不写盘，不搭车改权限。
+  ensurePrivateDir(deps.paths.sessionLogDir);
 
   let cfg;
   if (fs.existsSync(deps.paths.configPath) && !args.force) {
@@ -275,13 +286,8 @@ export async function cmdInstall(args) {
     deps.print(`保留现有配置：${deps.paths.configPath}（需要更新时加 --force）`);
     // 不带 --force 时配置原样保留，命令行显式给的参数一律不生效：点名说清
     // 被忽略的是哪些，而不是让用户以为已经改了。
-    const ignored = [];
-    if (args.roots !== undefined) ignored.push('--roots');
-    if (args.interval !== undefined) ignored.push('--interval');
-    if (args.lead !== undefined) ignored.push('--lead');
-    if (args.autoRenew !== undefined) ignored.push('--auto-renew');
-    if (args.autoMinId !== undefined) ignored.push('--auto-min-id');
-    if (args.sessionRetain !== undefined) ignored.push('--session-retain');
+    const ignored = IGNORED_INSTALL_FLAGS
+      .filter(([k]) => args[k] !== undefined).map(([, flag]) => flag);
     if (ignored.length > 0) {
       deps.print(`警告：参数 ${ignored.join('、')} 未生效（现有配置保留）；`
         + '要更新这些字段请带 --force 重跑，--force 只覆盖显式给出的字段');
@@ -296,10 +302,10 @@ export async function cmdInstall(args) {
       try {
         old = JSON.parse(fs.readFileSync(deps.paths.configPath, 'utf-8'));
       } catch {
-        old = null;
+        // 读不出（损坏 JSON）：没有可继承的旧值。
       }
-      // 手改成非对象（123、["a"]）：没有可继承的旧值，静默按默认走。
-      if (old && typeof old === 'object' && !Array.isArray(old)) {
+      // 手改成非对象（123、["a"]）：同样没有可继承的旧值，静默按默认走。
+      if (isPlainObject(old)) {
         // 类型坏的字段不继承（回到默认值）并当面说明，其余照旧——force 不
         // 该把类型错误写进新配置，也不该因一个字段坏了丢掉其余设置。
         const errs = configFieldErrors({ ...DEFAULT_CONFIG, ...old });
@@ -359,8 +365,9 @@ export async function cmdInstall(args) {
   validateConfig(cfg, (m) => deps.print(m));
   if (JSON.stringify(cfg.roots)
       === JSON.stringify(normalizeRoots(DEFAULT_CONFIG.roots))) {
-    // 与 README 安全说明同一句话，在配置落定的这一刻当面再说一遍。
-    deps.print('提示：未指定 --roots，默认扫描 ~/space、~/workspace、~/tasks'
+    // 与 README 安全说明同一句话，在配置落定的这一刻当面再说一遍。默认目
+    // 录清单从 DEFAULT_CONFIG 插值：改默认值时提示不会留在旧清单上。
+    deps.print(`提示：未指定 --roots，默认扫描 ${DEFAULT_CONFIG.roots.join('、')}`
       + '（不存在的目录跳过）；今后 clone 进这些容器的仓库也会进入巡检，'
       + '自动续期会把其中的周期任务永久化。目录布局不同或需收窄时用 '
       + '--roots 指定（见 README 安全说明）');
@@ -406,25 +413,32 @@ export async function cmdUninstall(args) {
   if (r.status === 0) deps.print('已从 launchd 卸载');
 
   // 服务没了就没有回收者：默认结束自己拉起的保活会话，不留以 bypass 权限
-  // 空转的孤儿。--keep-sessions 显式保留（例如马上重装）。
+  // 空转的孤儿。--keep-sessions 显式保留（例如马上重装）。各会话的停轮询
+  // （SIGTERM→等→SIGKILL）互不依赖，先逐个发信号再并行等齐，N 个会话不
+  // 用串行吃 N 轮等待。
   if (!args.keepSessions) {
+    const stopping = [];
+    const handled = new Set();
     for (const [ws, ent] of Object.entries(loadState())) {
       if (deps.trackedAlive(ent)) {
+        handled.add(ent.pid);
         deps.print(`正在结束保活会话 ${ws} pid=${ent.pid}`);
-        await deps.stopSession(ent);
+        stopping.push(deps.stopSession(ent));
       }
     }
     // state 丢失时的兜底：没进登记的孤儿会话（卡在提问界面就不会出现在
     // state 里）从进程表按日志目录精确认领。
     for (const [pid, procArgs] of deps.listScriptProcesses()) {
+      if (handled.has(pid)) continue; // state 循环已发起，别对同 pid 二次发信号
       const log = scriptProcLogPath(procArgs);
       if (log === null
           || !log.startsWith(`${deps.paths.sessionLogDir}${path.sep}`)) continue;
       const ent = { pid, procStart: deps.procStartedAt(pid) };
       if (!deps.trackedAlive(ent)) continue;
       deps.print(`正在结束保活会话（state 已丢失） pid=${pid}`);
-      await deps.stopSession(ent);
+      stopping.push(deps.stopSession(ent));
     }
+    await Promise.all(stopping);
   }
 
   if (fs.existsSync(deps.paths.plistPath)) {

package/src/sessions.mjs

@@ -5,10 +5,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 
-import { deps } from './internals.mjs';
-import {
-  SESSION_IDLE_SECONDS,
-} from './constants.mjs';
+import { deps, ensurePrivateDir } from './internals.mjs';
 
 // pid 是否对应活进程。走到这儿的 pid 已经过入口范围校验。
 export function alive(pid) {
@@ -88,25 +85,25 @@ export function buildChildEnv(parentEnv) {
   return env;
 }
 
+// 日志保留一代（.1）：删旧代后把现役改名顶上。「.1」命名与 rm-先-于-
+// rename 的顺序是两处调用（会话 typescript、launchd 巡检日志）共同的承重
+// 约定——script(1) 打开即截断、launchd 按路径重开，轮转失败都不阻断调用方。
+export function rotateOnce(file) {
+  const old = `${file}.1`;
+  fs.rmSync(old, { force: true });
+  fs.renameSync(file, old);
+}
+
 // 拉起一个 detached 的 pty TUI，返回 {pid, procStart}。
 export function spawnSession(ws) {
   const logPath = sessionLogPath(ws);
-  fs.mkdirSync(path.dirname(logPath), { recursive: true });
-  try {
-    fs.chmodSync(path.dirname(logPath), 0o700);
-  } catch {
-    // 目录权限维持现状。
-  }
+  ensurePrivateDir(path.dirname(logPath));
   // window 模式下「一代会话 = 一次执行」：script(1) 打开即截断，不轮转的
   // 话上一代（上一次任务执行）的界面记录会随本次拉起被抹掉。无条件保留
   // 一代（.1）——总量上界两代，活着的一代增长再快也只影响自身，不会经
   // 轮转放大。
   try {
-    if (fs.existsSync(logPath)) {
-      const old = `${logPath}.1`;
-      fs.rmSync(old, { force: true });
-      fs.renameSync(logPath, old);
-    }
+    if (fs.existsSync(logPath)) rotateOnce(logPath);
   } catch {
     // 轮转失败不阻断拉起。
   }
@@ -165,12 +162,14 @@ export async function stopSession(ent) {
   }
 }
 
-// typescript 多少秒没被写。文件缺失读作「没有活动证据」，不挡轮转。
+// typescript 多少秒没被写。文件缺失读作「没有任何活动证据」：Infinity 大
+// 于任何静默阈值，天然不挡换代与回收（哨兵值曾绑定 SESSION_IDLE_SECONDS
+// + 1，阈值调低后会悄悄翻转语义）。
 export function sessionLogIdleSeconds(logPath, cur) {
   try {
     return Math.max(0, cur - Math.floor(fs.statSync(logPath).mtimeMs / 1000));
   } catch {
-    return SESSION_IDLE_SECONDS + 1;
+    return Infinity;
   }
 }
 

package/src/tasks.mjs

@@ -5,7 +5,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 
-import { deps } from './internals.mjs';
+import { deps, isPlainObject } from './internals.mjs';
 import { TASK_REL } from './paths.mjs';
 import {
   PRUNE_DIRS,
@@ -20,7 +20,7 @@ export function expandHome(p) {
   return p; // ~user 形式不支持（macOS 实践中不会出现）
 }
 
-function isDir(p) {
+export function isDir(p) {
   try {
     return fs.statSync(p).isDirectory();
   } catch {
@@ -36,22 +36,33 @@ function realpathOrNull(p) {
   }
 }
 
+// 宽容版 realpath：失败时退回词法绝对路径（输入须已绝对）。与
+// realpathOrNull 的「失败即 null」是两种降级口径：会话登记匹配（registry）
+// 与日志定位（logs）要的是一个还能用的路径，而不是 null。
+export function lexReal(p) {
+  try {
+    return fs.realpathSync(p);
+  } catch {
+    return path.resolve(p);
+  }
+}
+
+// 任务文件是否还在：readTasks 读出 null 时区分「文件已消失」（一次性任务
+// 执行完被删的正常竞态）与「文件在但损坏」（要告警）。路径拼法归任务层，
+// 巡检与总览不必各自重建。
+export function taskFileExists(ws) {
+  return fs.existsSync(path.join(ws, TASK_REL));
+}
+
 // 路径在磁盘上真实存储的大小写形态；任何一段读不出时原样返回。
 // macOS 默认文件系统大小写不敏感，而 realpath 不规范化大小写：敲错大小
 // 写的路径照样通过 isDirectory，却与会话登记里真实大小写的 cwd 永远匹配
 // 不上。在扫描边界认回一次真实写法，下游就不必各自提防。
 export function onDiskCase(p) {
-  const parts = [];
-  let cur = path.resolve(p).replace(/\/+$/, '') || '/';
-  while (true) {
-    const head = path.dirname(cur);
-    const tail = path.basename(cur);
-    if (!tail || head === cur) break;
-    parts.push(tail);
-    cur = head;
-  }
-  // cur 停在根，自顶向下逐段认回磁盘上的真实条目名。
-  for (const name of parts.reverse()) {
+  // resolve 的输出不含双斜杠与尾部斜杠（根除外），按段拆开自顶向下认回。
+  const parts = path.resolve(p).split('/').filter(Boolean);
+  let cur = '/';
+  for (const name of parts) {
     let entries;
     try {
       entries = fs.readdirSync(cur);
@@ -91,16 +102,19 @@ export function* discover(roots, maxDepth) {
         ? []
         : entries.filter((e) => e.isDirectory() && !PRUNE_DIRS.has(e.name));
       const candidate = path.join(dirpath, TASK_REL);
-      const ws = realpathOrNull(dirpath);
       let isFile = false;
       try {
         isFile = fs.statSync(candidate).isFile();
       } catch {
-        isFile = false;
+        // 不存在按非文件处理。
       }
-      if (ws && isFile && !seen.has(ws)) {
-        seen.add(ws);
-        yield [ws, candidate];
+      // 先判有没有任务文件再 realpath：绝大多数目录没有，省一次 syscall。
+      if (isFile) {
+        const ws = realpathOrNull(dirpath);
+        if (ws && !seen.has(ws)) {
+          seen.add(ws);
+          yield [ws, candidate];
+        }
       }
       for (const d of subdirs) {
         yield* walk(path.join(dirpath, d.name));
@@ -110,21 +124,11 @@ export function* discover(roots, maxDepth) {
   }
 }
 
-function isPlainObject(v) {
-  return v !== null && typeof v === 'object' && !Array.isArray(v);
-}
-
-// 读一个工作区的任务列表，坏形状一律返回 null。
+// 读一个工作区的任务列表，坏形状一律返回 null。读盘与顶层形状校验复用
+// loadTaskDoc（renew 也要同一口径 round-trip 整份文档）。
 export function readTasks(ws) {
-  let doc;
-  try {
-    doc = JSON.parse(fs.readFileSync(
-      path.join(ws, TASK_REL), 'utf-8'));
-  } catch {
-    return null;
-  }
-  if (!isPlainObject(doc) || !Array.isArray(doc.tasks)) return null;
-  return doc.tasks.filter(isPlainObject);
+  const doc = deps.loadTaskDoc(path.join(ws, TASK_REL));
+  return doc === null ? null : doc.tasks.filter(isPlainObject);
 }
 
 // 任务文件在「读到」与「写回」之间被别的写者改了（Claude Code 更新
@@ -245,11 +249,11 @@ export function minifyIds(tasks) {
 }
 
 // 一轮巡检对一个任务文件做的维护：renew（补 permanent）与 minify（id 改
-// 小）合并为同一次受 mtime 乐观锁保护的原子写。外壳与旧 renewWorkspace
-// 完全一致：先取 mtimeNs、清残留 .cron-up-tmp、loadTaskDoc round-trip 整
-// 文档；两项计数都为 0 时字节级不动。返回 {renewed,minified}；null 表示
-// 文件缺失/损坏；读到写间被改抛 TaskFileChanged。
-export function maintainWorkspace(taskfile, { renew = false, minify = false } = {}) {
+// 小）合并为同一次受 mtime 乐观锁保护的原子写。先取 mtimeNs、清残留
+// .cron-up-tmp、loadTaskDoc round-trip 整文档；两项计数都为 0 时字节级
+// 不动。返回 {renewed,minified}；null 表示文件缺失/损坏；读到写间被改抛
+// TaskFileChanged。
+export function maintainWorkspace(taskfile, { renew = false, minify = false }) {
   let mtimeNs;
   try {
     mtimeNs = fs.statSync(taskfile, { bigint: true }).mtimeNs;
@@ -285,10 +289,4 @@ export function maintainWorkspace(taskfile, { renew = false, minify = false } =
   return { renewed, minified };
 }
 
-// 手动 renew 的薄封装：只补 permanent（不改 id），保持 null/0/N 三态契约。
-export function renewWorkspace(taskfile) {
-  const r = maintainWorkspace(taskfile, { renew: true });
-  return r === null ? null : r.renewed;
-}
-
 Object.assign(deps, { discover, readTasks, loadTaskDoc });