@modusensus/dsh-mneme 0.13.0 → 0.14.0-beta.2

package/src/diary/dir.js

@@ -1,59 +1,59 @@
-/**
- * 日记的落盘位置。
- *
- * 为什么不写进用户绑定的那个项目目录（本次需求的原始想法是 `D:\\QQ对话\\日记\\`）：
- * 那类目录实测不是 git 仓库、没有 .gitignore，还堆着探针脚本——私密正文摊在那儿，
- * 误删没有任何回滚面。更要紧的是 mneme 成文的写盘面只有两处（`src/index.js` 的
- * `memoryDir` 与 `documentDir`），在这里开第三处「往用户任意工作区写」的能力，
- * 会让「删掉插件的目录就回滚干净」这条性质失效。
- *
- * 所以与 candidates / proposals / observations 同构（同一个纪律见
- * `src/pipeline-observations.js:11-19`）：**项目键分桶、宿在 memoryDir 下、不进仓库**。
- * 「入库到绑定项目」是另一件事——用户点按钮时导出过去，那是一个主动动作。
- */
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { projectKey } from "../candidates.js";
-
-/** 展开 `~`。candidates.js 里那份是私有的，这里按同一口径抄一份最小实现。 */
-export function expandHome(p) {
-  const s = String(p ?? "");
-  if (s === "~") return homedir();
-  if (s.startsWith("~/") || s.startsWith("~\\")) return join(homedir(), s.slice(2));
-  return s;
-}
-
-/** memoryDir 的基座，与 candidates/proposals/observations 三处同一条回落。 */
-export function memoryBase(memoryDir) {
-  return expandHome(memoryDir && String(memoryDir).trim() ? memoryDir : "~/.dsh/memory");
-}
-
-/**
- * 日记根：`<memoryDir>/diaries`，或配置里给的目录。
- *
- * `diaryDir` 只改**根**，项目键分桶照旧——否则两个项目的日记会混进同一个平面目录，
- * 而「哪篇属于哪个项目」就只剩 frontmatter 一句话可查。
- */
-export function diaryRoot({ memoryDir, configured = "" } = {}) {
-  const custom = expandHome(configured && String(configured).trim() ? configured : "");
-  return custom ? custom : join(memoryBase(memoryDir), "diaries");
-}
-
-/** `<root>/<项目键>/`。项目根拿不到时返回 null（调用方必须据此拒绝写，不许退成全局）。 */
-export function diaryDir({ memoryDir, projectRoot, configured = "" } = {}) {
-  const key = projectKey(projectRoot);
-  if (!key) return null;
-  return join(diaryRoot({ memoryDir, configured }), key);
-}
-
-/** 只认 `YYYY-MM-DD.md`：同目录还住着 runs.jsonl，扫最新日期时不能把它算进去。 */
-export const DIARY_FILE_RE = /^\d{4}-\d{2}-\d{2}\.md$/;
-
-export function diaryFilePath(dir, dateLocal) {
-  return join(dir, `${dateLocal}.md`);
-}
-
-/** 审计账本：每条 skip / failed / written 一行，回答「今天为什么没有日记」。 */
-export function diaryAuditPath(dir) {
-  return join(dir, "runs.jsonl");
-}
+/**
+ * 日记的落盘位置。
+ *
+ * 为什么不写进用户绑定的那个项目目录（本次需求的原始想法是 `D:\\QQ对话\\日记\\`）：
+ * 那类目录实测不是 git 仓库、没有 .gitignore，还堆着探针脚本——私密正文摊在那儿，
+ * 误删没有任何回滚面。更要紧的是 mneme 成文的写盘面只有两处（`src/index.js` 的
+ * `memoryDir` 与 `documentDir`），在这里开第三处「往用户任意工作区写」的能力，
+ * 会让「删掉插件的目录就回滚干净」这条性质失效。
+ *
+ * 所以与 candidates / proposals / observations 同构（同一个纪律见
+ * `src/pipeline-observations.js:11-19`）：**项目键分桶、宿在 memoryDir 下、不进仓库**。
+ * 「入库到绑定项目」是另一件事——用户点按钮时导出过去，那是一个主动动作。
+ */
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { projectKey } from "../candidates.js";
+
+/** 展开 `~`。candidates.js 里那份是私有的，这里按同一口径抄一份最小实现。 */
+export function expandHome(p) {
+  const s = String(p ?? "");
+  if (s === "~") return homedir();
+  if (s.startsWith("~/") || s.startsWith("~\\")) return join(homedir(), s.slice(2));
+  return s;
+}
+
+/** memoryDir 的基座，与 candidates/proposals/observations 三处同一条回落。 */
+export function memoryBase(memoryDir) {
+  return expandHome(memoryDir && String(memoryDir).trim() ? memoryDir : "~/.dsh/memory");
+}
+
+/**
+ * 日记根：`<memoryDir>/diaries`，或配置里给的目录。
+ *
+ * `diaryDir` 只改**根**，项目键分桶照旧——否则两个项目的日记会混进同一个平面目录，
+ * 而「哪篇属于哪个项目」就只剩 frontmatter 一句话可查。
+ */
+export function diaryRoot({ memoryDir, configured = "" } = {}) {
+  const custom = expandHome(configured && String(configured).trim() ? configured : "");
+  return custom ? custom : join(memoryBase(memoryDir), "diaries");
+}
+
+/** `<root>/<项目键>/`。项目根拿不到时返回 null（调用方必须据此拒绝写，不许退成全局）。 */
+export function diaryDir({ memoryDir, projectRoot, configured = "" } = {}) {
+  const key = projectKey(projectRoot);
+  if (!key) return null;
+  return join(diaryRoot({ memoryDir, configured }), key);
+}
+
+/** 只认 `YYYY-MM-DD.md`：同目录还住着 runs.jsonl，扫最新日期时不能把它算进去。 */
+export const DIARY_FILE_RE = /^\d{4}-\d{2}-\d{2}\.md$/;
+
+export function diaryFilePath(dir, dateLocal) {
+  return join(dir, `${dateLocal}.md`);
+}
+
+/** 审计账本：每条 skip / failed / written 一行，回答「今天为什么没有日记」。 */
+export function diaryAuditPath(dir) {
+  return join(dir, "runs.jsonl");
+}

package/src/diary/export.js

@@ -1,97 +1,97 @@
-/**
- * 日记的读侧与「入库」。
- *
- * 「入库」是用户点按钮时**主动**把某一篇复制到绑定项目里——不是日记默认就写在那儿。
- * 这两件事分开的理由写在 `dir.js`：默认写进用户工作区会让「删掉插件目录就回滚干净」
- * 这条性质失效，而那正是 mneme 现有写盘面的成文契约。
- *
- * 复制而不是移动：memoryDir 那一份是主副本（还挂着指针行），项目里那份是给人看的。
- * 移走会让指针行指向一个已经被搬空的路径，`registerDocument` 下次校验就抛。
- */
-import { copyFileSync, mkdirSync, readFileSync, readdirSync, statSync } from "node:fs";
-import { join } from "node:path";
-import { DIARY_FILE_RE, diaryFilePath } from "./dir.js";
-
-/** 入库目标：`<项目>/diary/`。与项目里其它人类可读产物同层，不埋进点目录。 */
-export const EXPORT_SUBDIR = "diary";
-
-/**
- * 列出目录里已有的日记，新的在前。
- *
- * 读不到目录返回 `[]`（= 还没写过），不抛——面板的空态与「坏了」必须能分开，
- * 而这里「读不到」的绝大多数情况就是「还没写过第一篇」。
- */
-export function listDiaries(dir) {
-  if (!dir) return [];
-  let names;
-  try {
-    names = readdirSync(dir);
-  } catch {
-    return [];
-  }
-  const rows = [];
-  for (const name of names) {
-    if (!DIARY_FILE_RE.test(name)) continue;
-    const path = join(dir, name);
-    let st;
-    try {
-      st = statSync(path);
-    } catch {
-      continue;
-    }
-    if (!st.isFile() || st.size <= 0) continue;
-    rows.push({ date: name.slice(0, 10), path, bytes: st.size, mtime: st.mtimeMs });
-  }
-  return rows.sort((a, b) => (a.date < b.date ? 1 : a.date > b.date ? -1 : 0));
-}
-
-/** 读一篇正文。读不到返回 null（面板据此显示「还没有这一篇」而不是一个空框）。 */
-export function readDiary(dir, date) {
-  if (!dir || !/^\d{4}-\d{2}-\d{2}$/.test(String(date ?? ""))) return null;
-  try {
-    return readFileSync(diaryFilePath(dir, date), "utf8");
-  } catch {
-    return null;
-  }
-}
-
-/**
- * 把一篇复制进绑定项目。
- *
- * `overwrite:false` 时目标已存在就拒绝——那是**用户项目里**的文件，可能已经被他改过，
- * 机器无声覆盖比不做更糟。要覆盖必须显式传 `overwrite:true`（面板上是一次确认）。
- */
-export function exportDiary({ sourceDir, projectRoot, date, overwrite = false } = {}) {
-  if (!sourceDir) return { ok: false, error: "no-source" };
-  if (!projectRoot) return { ok: false, error: "project-unknown" };
-  if (!/^\d{4}-\d{2}-\d{2}$/.test(String(date ?? ""))) return { ok: false, error: "bad-date" };
-  const from = diaryFilePath(sourceDir, date);
-  let st;
-  try {
-    st = statSync(from);
-  } catch {
-    return { ok: false, error: "no-diary", date };
-  }
-  if (!st.isFile() || st.size <= 0) return { ok: false, error: "no-diary", date };
-  const toDir = join(projectRoot, EXPORT_SUBDIR);
-  const to = join(toDir, `${date}.md`);
-  try {
-    mkdirSync(toDir, { recursive: true });
-  } catch (error) {
-    return { ok: false, error: "target-unwritable", detail: String(error && error.message ? error.message : error) };
-  }
-  if (!overwrite) {
-    try {
-      statSync(to);
-      return { ok: false, error: "target-exists", path: to };
-    } catch {
-      // 目标不存在才是可以写的路径。
-    }
-  }
-  try {
-    copyFileSync(from, to);
-  } catch (error) {
-    return { ok: false, error: "copy-failed", detail: String(error && error.message ? error.message : error) };
-  }
-  return { ok: true, date, path: to, bytes: st.size };
-}
+/**
+ * 日记的读侧与「入库」。
+ *
+ * 「入库」是用户点按钮时**主动**把某一篇复制到绑定项目里——不是日记默认就写在那儿。
+ * 这两件事分开的理由写在 `dir.js`：默认写进用户工作区会让「删掉插件目录就回滚干净」
+ * 这条性质失效，而那正是 mneme 现有写盘面的成文契约。
+ *
+ * 复制而不是移动：memoryDir 那一份是主副本（还挂着指针行），项目里那份是给人看的。
+ * 移走会让指针行指向一个已经被搬空的路径，`registerDocument` 下次校验就抛。
+ */
+import { copyFileSync, mkdirSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { DIARY_FILE_RE, diaryFilePath } from "./dir.js";
+
+/** 入库目标：`<项目>/diary/`。与项目里其它人类可读产物同层，不埋进点目录。 */
+export const EXPORT_SUBDIR = "diary";
+
+/**
+ * 列出目录里已有的日记，新的在前。
+ *
+ * 读不到目录返回 `[]`（= 还没写过），不抛——面板的空态与「坏了」必须能分开，
+ * 而这里「读不到」的绝大多数情况就是「还没写过第一篇」。
+ */
+export function listDiaries(dir) {
+  if (!dir) return [];
+  let names;
+  try {
+    names = readdirSync(dir);
+  } catch {
+    return [];
+  }
+  const rows = [];
+  for (const name of names) {
+    if (!DIARY_FILE_RE.test(name)) continue;
+    const path = join(dir, name);
+    let st;
+    try {
+      st = statSync(path);
+    } catch {
+      continue;
+    }
+    if (!st.isFile() || st.size <= 0) continue;
+    rows.push({ date: name.slice(0, 10), path, bytes: st.size, mtime: st.mtimeMs });
+  }
+  return rows.sort((a, b) => (a.date < b.date ? 1 : a.date > b.date ? -1 : 0));
+}
+
+/** 读一篇正文。读不到返回 null（面板据此显示「还没有这一篇」而不是一个空框）。 */
+export function readDiary(dir, date) {
+  if (!dir || !/^\d{4}-\d{2}-\d{2}$/.test(String(date ?? ""))) return null;
+  try {
+    return readFileSync(diaryFilePath(dir, date), "utf8");
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 把一篇复制进绑定项目。
+ *
+ * `overwrite:false` 时目标已存在就拒绝——那是**用户项目里**的文件，可能已经被他改过，
+ * 机器无声覆盖比不做更糟。要覆盖必须显式传 `overwrite:true`（面板上是一次确认）。
+ */
+export function exportDiary({ sourceDir, projectRoot, date, overwrite = false } = {}) {
+  if (!sourceDir) return { ok: false, error: "no-source" };
+  if (!projectRoot) return { ok: false, error: "project-unknown" };
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(String(date ?? ""))) return { ok: false, error: "bad-date" };
+  const from = diaryFilePath(sourceDir, date);
+  let st;
+  try {
+    st = statSync(from);
+  } catch {
+    return { ok: false, error: "no-diary", date };
+  }
+  if (!st.isFile() || st.size <= 0) return { ok: false, error: "no-diary", date };
+  const toDir = join(projectRoot, EXPORT_SUBDIR);
+  const to = join(toDir, `${date}.md`);
+  try {
+    mkdirSync(toDir, { recursive: true });
+  } catch (error) {
+    return { ok: false, error: "target-unwritable", detail: String(error && error.message ? error.message : error) };
+  }
+  if (!overwrite) {
+    try {
+      statSync(to);
+      return { ok: false, error: "target-exists", path: to };
+    } catch {
+      // 目标不存在才是可以写的路径。
+    }
+  }
+  try {
+    copyFileSync(from, to);
+  } catch (error) {
+    return { ok: false, error: "copy-failed", detail: String(error && error.message ? error.message : error) };
+  }
+  return { ok: true, date, path: to, bytes: st.size };
+}

package/src/diary/index.js

@@ -1,26 +1,26 @@
-/**
- * 日记本（QQ 机器人写日记）。
- *
- * 需求原文要的是「让机器人每天写一篇日记，侧栏能把日记入库到绑定的项目里」。
- * 拆开是三件事，落在三处：
- *
- * 1. **写什么** —— `compose.js`：素材 → 一段正文 → 原子落盘 → 指针行。
- * 2. **什么时候写** —— `auto.js`：本机没有日历调度原语，所以是「跨天惰性判定 +
- *    启动补写」，不是 cron。判定本身在 `rollover.js`，是纯函数。
- * 3. **素材从哪来** —— `qq-inbox.js`：只读 QQ 收件箱。这一层是 provider 形状，
- *    以后接别的来源只需要再写一个同签名模块，compose 不认识 QQ。
- *
- * 正文宿在 `<memoryDir>/diaries/<项目键>/YYYY-MM-DD.md`（见 `dir.js` 里为什么不写
- * 进用户工作区）；记忆库里只有一条 `type="document"` 指针行，复用既有铸造口。
- */
-export { createDiaryComposer, validateBody, latestDiaryDate, MIN_BODY_CHARS, MAX_MATERIAL_ITEMS } from "./compose.js";
-// 「什么时候写」的纯函数与「素材从哪来」的 provider 形状，都在上面两个文件里。
-export { createDiaryAutoRun, DIARY_MIN_INTERVAL_MS } from "./auto.js";
-export { collectQqInbox, inboxFiles, redactDigits, resolveInboxDir, INBOX_FILE_RE } from "./qq-inbox.js";
-export { collectSessionTranscript, sessionAgentId, MAX_ITEM_CHARS } from "./session-provider.js";
-export { diaryDir, diaryRoot, diaryFilePath, diaryAuditPath, memoryBase, expandHome, DIARY_FILE_RE } from "./dir.js";
-export { localDateString, shouldRollDay, dayGap, MAX_CATCH_UP_DAYS } from "./rollover.js";
-export { listDiaries, readDiary, exportDiary, EXPORT_SUBDIR } from "./export.js";
-// 左侧「ta 的日记」面板读的是**跨桶**清单（它拿不到当前会话的项目），
-// 与上面按 projectRoot 定位单个桶的 dir.js 是两件事。
-export { listDiaryLibrary, readLibraryEntry, isBucketName } from "./library.js";
+/**
+ * 日记本（QQ 机器人写日记）。
+ *
+ * 需求原文要的是「让机器人每天写一篇日记，侧栏能把日记入库到绑定的项目里」。
+ * 拆开是三件事，落在三处：
+ *
+ * 1. **写什么** —— `compose.js`：素材 → 一段正文 → 原子落盘 → 指针行。
+ * 2. **什么时候写** —— `auto.js`：本机没有日历调度原语，所以是「跨天惰性判定 +
+ *    启动补写」，不是 cron。判定本身在 `rollover.js`，是纯函数。
+ * 3. **素材从哪来** —— `qq-inbox.js`：只读 QQ 收件箱。这一层是 provider 形状，
+ *    以后接别的来源只需要再写一个同签名模块，compose 不认识 QQ。
+ *
+ * 正文宿在 `<memoryDir>/diaries/<项目键>/YYYY-MM-DD.md`（见 `dir.js` 里为什么不写
+ * 进用户工作区）；记忆库里只有一条 `type="document"` 指针行，复用既有铸造口。
+ */
+export { createDiaryComposer, validateBody, latestDiaryDate, MIN_BODY_CHARS, MAX_MATERIAL_ITEMS } from "./compose.js";
+// 「什么时候写」的纯函数与「素材从哪来」的 provider 形状，都在上面两个文件里。
+export { createDiaryAutoRun, DIARY_MIN_INTERVAL_MS } from "./auto.js";
+export { collectQqInbox, inboxFiles, redactDigits, resolveInboxDir, INBOX_FILE_RE } from "./qq-inbox.js";
+export { collectSessionTranscript, sessionAgentId, MAX_ITEM_CHARS } from "./session-provider.js";
+export { diaryDir, diaryRoot, diaryFilePath, diaryAuditPath, memoryBase, expandHome, DIARY_FILE_RE } from "./dir.js";
+export { localDateString, shouldRollDay, dayGap, MAX_CATCH_UP_DAYS } from "./rollover.js";
+export { listDiaries, readDiary, exportDiary, EXPORT_SUBDIR } from "./export.js";
+// 左侧「ta 的日记」面板读的是**跨桶**清单（它拿不到当前会话的项目），
+// 与上面按 projectRoot 定位单个桶的 dir.js 是两件事。
+export { listDiaryLibrary, readLibraryEntry, isBucketName } from "./library.js";