@baique/pi-web-sky 0.1.35 → 0.1.37

package/lib/board-purge.ts

@@ -0,0 +1,65 @@
+// 孤儿看板卡片清理：左栏删除会话后，看板上对应卡片（refId 指向已删会话的
+// board_nodes 节点）与指向它的连线成为孤儿数据。进入看板时懒加载清理一次。
+//
+// 孤儿判定（防误删"创建中"会话）：
+// - refId 非空（未绑定会话的节点不动）
+// - 会话文件不存在（resolveSessionPath === null；listAllSessions 已填充路径缓存）
+// - session_meta 无该会话记录（任务会话创建即写 meta，文件延迟落盘也安全）
+// 运行中会话文件存在，天然不被删。
+
+import { getDb } from "./sqlite-db";
+import { listAllSessions, resolveSessionPath } from "./session-reader";
+import { deleteNodesByIds } from "./board-store";
+import { SYSTEM_RUNNING_BOARD_ID } from "./board-types";
+
+export interface PurgeResult {
+  /** 实际删除的卡片数 */
+  deletedNodes: number;
+  /** 级联删除的连线数 */
+  deletedEdges: number;
+  /** 受影响的看板 id 列表 */
+  boards: string[];
+}
+
+/** 清理全部看板上的孤儿卡片（级联删连线）。无孤儿时返回全 0。 */
+export async function purgeOrphanBoardCards(): Promise<PurgeResult> {
+  const db = getDb();
+  // 1a. 会话节点（kind != 'taskcard'）：孤儿判定基于会话文件 / session_meta 存在性
+  //     （防误删"创建中"会话：任务会话创建即写 meta，文件延迟落盘也安全）
+  const sessionNodes = db
+    .prepare("SELECT id, board_id AS boardId, ref_id AS refId FROM board_nodes WHERE ref_id IS NOT NULL AND board_id != ? AND kind != 'taskcard'")
+    .all(SYSTEM_RUNNING_BOARD_ID) as Array<{ id: string; boardId: string; refId: string }>;
+  // 1b. 任务卡节点（kind='taskcard'）：孤儿判定 = refId 不在 task_cards 表
+  //     （任务卡已删但画布节点残留，如 deleteTask 未级联清；refId 是 task_cards.id 非会话 id）
+  const taskCardNodes = db
+    .prepare(
+      "SELECT id, board_id AS boardId, ref_id AS refId FROM board_nodes n " +
+        "WHERE kind = 'taskcard' AND ref_id IS NOT NULL AND board_id != ? " +
+        "AND NOT EXISTS (SELECT 1 FROM task_cards c WHERE c.id = n.ref_id)",
+    )
+    .all(SYSTEM_RUNNING_BOARD_ID) as Array<{ id: string; boardId: string; refId: string }>;
+
+  // 2. 会话孤儿逐个判定（resolveSessionPath 走路径缓存）；taskcard 孤儿直接入列
+  const orphanIds: string[] = taskCardNodes.map((n) => n.id);
+  if (sessionNodes.length > 0) {
+    const sessions = await listAllSessions();
+    const aliveIds = new Set(sessions.map((s) => s.id));
+    const metaIds = new Set(
+      (db.prepare("SELECT session_id FROM session_meta").all() as Array<{ session_id: string }>).map((r) => r.session_id),
+    );
+    for (const n of sessionNodes) {
+      if (aliveIds.has(n.refId) || metaIds.has(n.refId)) continue;
+      const p = await resolveSessionPath(n.refId);
+      if (p === null) orphanIds.push(n.id);
+    }
+  }
+  if (orphanIds.length === 0) return { deletedNodes: 0, deletedEdges: 0, boards: [] };
+
+  // 3. 批量删除（级联删边 + bump 看板 updated，单事务）
+  const result = deleteNodesByIds(orphanIds);
+  return {
+    deletedNodes: result.deletedNodes,
+    deletedEdges: result.deletedEdges,
+    boards: result.boards,
+  };
+}

package/lib/board-search.test.mjs

@@ -0,0 +1,110 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { createJiti } from "jiti";
+
+const jiti = createJiti(import.meta.url, { interopDefault: true, moduleCache: false });
+const { collectSearchable, filterMatches, makeSnippet } = await jiti.import("./board-search.ts");
+
+/** 构造 fake tldraw editor（单测只依赖 getCurrentPageShapes/getShape/getShapePageBounds） */
+function fakeEditor(shapes) {
+  return {
+    getCurrentPageShapes: () => shapes,
+    getShape: (id) => shapes.find((s) => s.id === id),
+    getShapePageBounds: (id) => {
+      const s = shapes.find((x) => x.id === id);
+      return s ? { x: s.x ?? 0, y: s.y ?? 0, w: s.w ?? 100, h: s.h ?? 100 } : undefined;
+    },
+  };
+}
+
+const shape = (id, type, props) => ({ id, type, props });
+
+test("collectSearchable 收集会话卡标题 + 便笺正文，跳过空文本与无关 shape", () => {
+  const editor = fakeEditor([
+    shape("shape:a", "session-card", { title: "登录重构", sessionId: "s1" }),
+    shape("shape:b", "session-card", { title: "   ", sessionId: "s2" }), // 空标题跳过
+    shape("shape:c", "sticky-note", { text: "便笺：token 校验" }),
+    shape("shape:d", "sticky-note", { text: "" }), // 空便笺跳过
+    shape("shape:e", "arrow", { label: "不能搜连线" }), // 无关 type 跳过
+    shape("shape:f", "text", { text: "普通文本不搜" }), // 无关 type 跳过
+  ]);
+  const items = collectSearchable(editor);
+  assert.deepEqual(items.map((i) => i.text), ["登录重构", "便笺：token 校验"]);
+  assert.deepEqual(items.map((i) => i.kind), ["session-card", "sticky-note"]);
+});
+
+test("filterMatches 中文子串命中", () => {
+  const editor = fakeEditor([
+    shape("a", "session-card", { title: "修复登录接口的 bug" }),
+    shape("b", "sticky-note", { text: "记录 token 过期逻辑" }),
+  ]);
+  const items = collectSearchable(editor);
+  const hits = filterMatches(items, "登录");
+  assert.equal(hits.length, 1);
+  assert.equal(hits[0].item.shapeId, "a");
+});
+
+test("filterMatches 大小写不敏感（英文）", () => {
+  const editor = fakeEditor([
+    shape("a", "session-card", { title: "Refactor Token Logic" }),
+    shape("b", "sticky-note", { text: "another note" }),
+  ]);
+  const items = collectSearchable(editor);
+  assert.equal(filterMatches(items, "token").length, 1);
+  assert.equal(filterMatches(items, "TOKEN").length, 1);
+  assert.equal(filterMatches(items, "Token").length, 1);
+  assert.equal(filterMatches(items, "tokenz").length, 0);
+});
+
+test("filterMatches 空 query 返回空", () => {
+  const editor = fakeEditor([shape("a", "session-card", { title: "anything" })]);
+  const items = collectSearchable(editor);
+  assert.equal(filterMatches(items, "").length, 0);
+  assert.equal(filterMatches(items, "   ").length, 0);
+});
+
+test("filterMatches 多命中保持画布遍历顺序", () => {
+  const editor = fakeEditor([
+    shape("a", "sticky-note", { text: "zzz 搜索 zzz" }),
+    shape("b", "session-card", { title: "aaa 搜索 bbb" }),
+    shape("c", "sticky-note", { text: "搜索收尾" }),
+  ]);
+  const items = collectSearchable(editor);
+  const hits = filterMatches(items, "搜索");
+  assert.deepEqual(hits.map((h) => h.item.shapeId), ["a", "b", "c"]);
+});
+
+test("filterMatches 多关键字空格分隔 AND 关系", () => {
+  const editor = fakeEditor([
+    shape("a", "session-card", { title: "修复登录接口 token 过期" }),
+    shape("b", "sticky-note", { text: "登录流程重构" }),
+    shape("c", "session-card", { title: "部署配置调整" }),
+    shape("d", "session-card", { title: "登录接口优化" }),
+  ]);
+  const items = collectSearchable(editor);
+  // 两个词都在同一节点文本里才命中（AND）
+  assert.deepEqual(filterMatches(items, "登录 token").map((h) => h.item.shapeId), ["a"]);
+  assert.deepEqual(filterMatches(items, "登录 重构").map((h) => h.item.shapeId), ["b"]);
+  assert.deepEqual(filterMatches(items, "登录 接口").map((h) => h.item.shapeId), ["a", "d"]);
+  // 缺任一词不命中
+  assert.equal(filterMatches(items, "登录 不存在词").length, 0);
+  // 多个空格/首尾空格容忍
+  assert.deepEqual(filterMatches(items, "  登录  接口  ").map((h) => h.item.shapeId), ["a", "d"]);
+});
+
+test("makeSnippet 命中居中截断 + 两端省略号", () => {
+  const long = "这是一段很长的便笺文本，中间藏着关键词，后面还有更多内容需要被截断显示以便下拉列表保持整洁。";
+  const s = makeSnippet(long, "关键词", 20);
+  assert.ok(s.includes("关键词"), `snippet should contain the hit: ${s}`);
+  assert.ok(s.startsWith("…"), "head ellipsis");
+  assert.ok(s.endsWith("…"), "tail ellipsis");
+  assert.ok(s.length <= 24, `bounded length: ${s.length}`);
+});
+
+test("makeSnippet 无命中时首段截断", () => {
+  const short = "hello";
+  assert.equal(makeSnippet(short, "zzz"), "hello");
+  const long = "x".repeat(100);
+  const s = makeSnippet(long, "zzz");
+  assert.equal(s, `${"x".repeat(44)}…`);
+});

package/lib/board-search.ts

@@ -0,0 +1,63 @@
+/**
+ * 看板内搜索定位（Ctrl+F）的纯函数。
+ *
+ * 只遍历当前画布上的 shape（session-card 标题 + sticky-note 便笺文字），
+ * 不做会话正文索引（正文搜索属另一需求，见 .agent/spec/2026-08-30-board-search.md 不做项）。
+ * 画布节点量级小（几十个），includes 子串匹配足够，无需索引。
+ */
+
+import type { Editor, TLShapeId } from "tldraw";
+
+export type SearchableKind = "session-card" | "sticky-note";
+
+export interface SearchableItem {
+  shapeId: TLShapeId;
+  kind: SearchableKind;
+  /** 完整原文（匹配用全文） */
+  text: string;
+}
+
+export interface SearchMatch {
+  item: SearchableItem;
+  /** 命中片段（下拉展示用，前后截断） */
+  snippet: string;
+}
+
+/** 收集当前画布上可搜索的节点。空文本节点跳过（无搜索价值）。 */
+export function collectSearchable(editor: Editor): SearchableItem[] {
+  const out: SearchableItem[] = [];
+  for (const shape of editor.getCurrentPageShapes()) {
+    if (shape.type === "session-card") {
+      const title = String((shape.props as { title?: unknown }).title ?? "").trim();
+      if (title) out.push({ shapeId: shape.id, kind: "session-card", text: title });
+    } else if (shape.type === "sticky-note") {
+      const text = String((shape.props as { text?: unknown }).text ?? "").trim();
+      if (text) out.push({ shapeId: shape.id, kind: "sticky-note", text });
+    }
+  }
+  return out;
+}
+
+/** 按 query 过滤：空格分隔多个关键字，全部命中（AND）才算匹配。空 query 返回空结果。 */
+export function filterMatches(items: SearchableItem[], query: string): SearchMatch[] {
+  const terms = query.trim().toLowerCase().split(/\s+/).filter(Boolean);
+  if (terms.length === 0) return [];
+  return items
+    .filter((it) => {
+      const text = it.text.toLowerCase();
+      return terms.every((term) => text.includes(term));
+    })
+    .map((it) => ({ item: it, snippet: makeSnippet(it.text, terms[0]) }));
+}
+
+/** 命中片段：以首个命中位置为中心截取 ~44 字符，两端加省略号。 */
+export function makeSnippet(text: string, query: string, maxLen = 44): string {
+  const q = query.trim().toLowerCase();
+  const idx = text.toLowerCase().indexOf(q);
+  if (idx < 0) return text.length > maxLen ? `${text.slice(0, maxLen)}…` : text;
+  const start = Math.max(0, idx - Math.floor((maxLen - q.length) / 2));
+  const end = Math.min(text.length, start + maxLen);
+  const head = start > 0 ? "…" : "";
+  const tail = end < text.length ? "…" : "";
+  return `${head}${text.slice(start, end)}${tail}`;
+}