dsh-tree-task-flow 0.3.14 → 0.3.15

package/lib/store.js

@@ -3,7 +3,8 @@
  *
  * 三类状态，都**以 `sessionId` 为键**：
  *
- *   - `plans/<sessionId>.json`     计划树
+ *   - `plans/<sessionId>.json`     计划树（需求都在里面的 `goals` 里）
+ *   - `notes/<sessionId>.json`     笔记，按会话一份
  *   - `surfaces/<sessionId>.json`  三层的折叠游标（只给界面看，不参与折叠）
  *   - `held/<sessionId>.json`      「被按住」：暂停 / 停止，**要跨重启保留**
  *   - `revive/<sessionId>.json`    意外中断的拉起重试链，**要跨重启保留**
@@ -28,6 +29,8 @@
 import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
+import { normalizeNotes } from "./notes.js";
+import { normalizeRequirement } from "./requirement.js";
 
 /**
  * 没有显式配置时的状态根目录。
@@ -60,19 +63,29 @@ function writeJson(file, value) {
 }
 
 /**
- * 老结构（整棵树只有一个 `goal` 字段）读进来时升级成 `goals` 数组。
+ * 老结构（整棵树只有一个 `goal` 字段）读进来时升级成 `goals` 数组，
+ * 再给每条记录补上需求那一层缺的字段。
  *
- * 计划文件是插件自己的持久状态，换个版本不该让既有的树失联。
+ * 计划文件是插件自己的持久状态，换个版本不该让既有的树失联——所以**读的时候补，
+ * 不迁移磁盘上的老文件**：老会话的计划文件保持原样，缺什么字段就在内存里补什么，
+ * 下一次写入自然带上（见 `requirement.normalizeRequirement`）。
  *
  * @param plan - 磁盘上读到的对象，可能是 null。
  * @returns 归一化后的计划树。
  */
 function normalizePlan(plan) {
   if (plan === null || typeof plan !== "object") return plan;
-  if (Array.isArray(plan.goals)) return plan;
-  if (plan.goal === undefined || plan.goal === null) return { ...plan, goals: [] };
-  const { goal, ...rest } = plan;
-  return { ...rest, version: 2, goals: [goal] };
+  let upgraded = plan;
+  if (!Array.isArray(plan.goals)) {
+    if (plan.goal === undefined || plan.goal === null) {
+      upgraded = { ...plan, goals: [] };
+    } else {
+      const { goal, ...rest } = plan;
+      upgraded = { ...rest, version: 2, goals: [goal] };
+    }
+  }
+  for (const goal of upgraded.goals) normalizeRequirement(goal);
+  return upgraded;
 }
 
 /**
@@ -93,6 +106,9 @@ export function createStore(root) {
   /** 设置文件的路径（与会话无关，整个状态根一份）。 */
   const settingsFile = () => file("settings.json");
 
+  /** 笔记文件的路径（按会话一份）。 */
+  const notesFile = (sessionId) => file("notes", `${sessionId}.json`);
+
   /** 读「被按住」状态；读不到或文件坏了，一律按"没被按住"处理。 */
   function readHeldState(sessionId) {
     if (!sessionId) return { paused: false, stopped: false, at: null };
@@ -217,6 +233,33 @@ export function createStore(root) {
       return next;
     },
 
+    // ---- 笔记：**按会话**，一个会话一份 ----
+
+    /**
+     * 读这个会话的笔记。
+     *
+     * 笔记跟着会话走：它记的是"这次工作的上下文里必须一直记着的几句话"，
+     * 换一个会话就等于换了一份工作，旧笔记跟过去只会变成噪声。
+     *
+     * @param sessionId - 会话 id。
+     * @returns `{ version, items, updatedAt }`；没有笔记时 `items` 是空数组。
+     */
+    readNotes(sessionId) {
+      if (!sessionId) return normalizeNotes(null);
+      return normalizeNotes(readJson(notesFile(sessionId), null));
+    },
+
+    /**
+     * 整份写回笔记表。调用方（`lib/notes.js` 的 `upsertNote`）已经改好了内容。
+     *
+     * @param sessionId - 会话 id。
+     * @param state - 完整笔记表。
+     */
+    writeNotes(sessionId, state) {
+      if (!sessionId) return;
+      writeJson(notesFile(sessionId), state);
+    },
+
     // ---- 「被按住」：暂停 / 停止。**要跨重启保留**，所以落盘 ----
 
     /**