update

scripts/_lib/tmp-todo.mjs

@@ -0,0 +1,48 @@
+// 跨脚本共享：临时 todo.md 文件的创建 + 清理。
+//
+// 用途：polling-fallback / snapshot-creation / write-race 等脚本要在隔离目录
+// 下模拟真实 todo.md 文件，每次都重复同样的 3 行 mkdtempSync+writeFileSync
+// boilerplate，且清理端 `fs.rmSync(tmpDir, { recursive, force })` 在 3 个脚本
+// 各自复制一份 —— 任何一处改成 `fs.rm` 或漏 `{ force: true }` 就会在 CI 上
+// 留下 tmp 目录。
+//
+// 用法：
+//   import { makeTmpTodoFile, cleanupTmpTodo } from './_lib/tmp-todo.mjs';
+//   const { dir, file } = makeTmpTodoFile({ prefix: 'poll-test-' });
+//   // ... 测试 ...
+//   cleanupTmpTodo({ dir });
+
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+// 默认 seed：最小可工作的「全部任务」+「工作」分类 + 一条 a 任务。
+// 覆盖路径：如果脚本要不同初始内容，传 `content` override（snapshot-creation
+// 用 `# todo\n- [ ] A\n- [ ] B\n`；write-race 用 `## 工作\n\n- [ ] V0`）。
+const DEFAULT_SEED = '# 全部任务\n\n## 工作\n\n- [ ] a\n';
+
+/**
+ * 创建一个临时目录并写入 todo.md，返回 { dir, file }。
+ *
+ * @param {object} [opts]
+ * @param {string} [opts.prefix='todo-test-'] — mkdtempSync 前缀，含连字符
+ * @param {string} [opts.content] — 初始 markdown 内容；不传走 DEFAULT_SEED
+ * @returns {{ dir: string, file: string }}
+ */
+export function makeTmpTodoFile({ prefix = 'todo-test-', content = DEFAULT_SEED } = {}) {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
+  const file = path.join(dir, 'todo.md');
+  fs.writeFileSync(file, content);
+  return { dir, file };
+}
+
+/**
+ * 清理临时目录。`force: true` 让目录不存在时也不抛 —— 测试中途崩了也能跑。
+ *
+ * @param {object} opts
+ * @param {string} opts.dir
+ */
+export function cleanupTmpTodo({ dir }) {
+  if (!dir) return;
+  fs.rmSync(dir, { recursive: true, force: true });
+}