@baique/pi-web-sky 0.1.39 → 0.1.41

package/lib/board-search.test.mjs

@@ -1,110 +0,0 @@
-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

@@ -1,63 +0,0 @@
-/**
- * 看板内搜索定位（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}`;
-}

package/lib/file-explorer-state.test.mjs

@@ -1,63 +0,0 @@
-import assert from "node:assert/strict";
-import test from "node:test";
-import { createJiti } from "jiti";
-
-const jiti = createJiti(import.meta.url);
-const { loadExplorerOpen, saveExplorerOpen } = await jiti.import("./file-explorer-state.ts");
-
-function createStorage(initial = {}) {
-  const values = new Map(Object.entries(initial));
-  return {
-    values,
-    getItem(key) {
-      return values.get(key) ?? null;
-    },
-    setItem(key, value) {
-      values.set(key, value);
-    },
-  };
-}
-
-test("defaults to an open file explorer", () => {
-  assert.equal(loadExplorerOpen(createStorage()), true);
-});
-
-test("saves and restores the file explorer panel state", () => {
-  const storage = createStorage();
-
-  saveExplorerOpen(false, storage);
-  assert.equal(loadExplorerOpen(storage), false);
-
-  saveExplorerOpen(true, storage);
-  assert.equal(loadExplorerOpen(storage), true);
-});
-
-test("falls back to open when browser storage is unavailable", () => {
-  const unavailable = {
-    getItem() { throw new Error("blocked"); },
-    setItem() { throw new Error("blocked"); },
-  };
-
-  assert.equal(loadExplorerOpen(unavailable), true);
-  assert.doesNotThrow(() => saveExplorerOpen(false, unavailable));
-});
-
-test("falls back when accessing browser storage throws", () => {
-  const previousWindow = Object.getOwnPropertyDescriptor(globalThis, "window");
-  const blockedWindow = {};
-  Object.defineProperty(blockedWindow, "localStorage", {
-    get() { throw new DOMException("blocked", "SecurityError"); },
-  });
-  Object.defineProperty(globalThis, "window", {
-    configurable: true,
-    value: blockedWindow,
-  });
-
-  try {
-    assert.equal(loadExplorerOpen(), true);
-    assert.doesNotThrow(() => saveExplorerOpen(false));
-  } finally {
-    if (previousWindow) Object.defineProperty(globalThis, "window", previousWindow);
-    else delete globalThis.window;
-  }
-});

package/lib/file-explorer-state.ts

@@ -1,36 +0,0 @@
-const EXPLORER_OPEN_STORAGE_KEY = "pi-web:file-explorer:open";
-
-interface StorageLike {
-  getItem(key: string): string | null;
-  setItem(key: string, value: string): void;
-}
-
-function getBrowserStorage(): StorageLike | null {
-  if (typeof window === "undefined") return null;
-  try {
-    return window.localStorage;
-  } catch {
-    return null;
-  }
-}
-
-export function loadExplorerOpen(storage: StorageLike | null = getBrowserStorage()): boolean {
-  if (!storage) return true;
-  try {
-    return storage.getItem(EXPLORER_OPEN_STORAGE_KEY) !== "false";
-  } catch {
-    return true;
-  }
-}
-
-export function saveExplorerOpen(
-  open: boolean,
-  storage: StorageLike | null = getBrowserStorage(),
-): void {
-  if (!storage) return;
-  try {
-    storage.setItem(EXPLORER_OPEN_STORAGE_KEY, String(open));
-  } catch {
-    // Persistence is best-effort; privacy mode and storage quotas must not break the explorer.
-  }
-}

package/lib/sync-room-server.mjs

@@ -1,137 +0,0 @@
-// ============================================================================
-// tldraw sync 房间服务器核心（可内嵌 Next.js server，也可独立进程）
-//   - 每看板一个 TLSocketRoom + SQLiteSyncStorage（sync.db，tablePrefix 按 board 隔离）
-//   - 纯文档同步：不懂业务，派生边/补卡由前端 reconcile（读业务数据 → CRDT 写文档）
-//   - 自定义 shape（session-card / task-card / sticky-note）两端注册
-//
-// 用法（内嵌）：server.on("upgrade", handleSyncUpgrade) —— 返回 false 表示未处理，调用方转交 Next
-// 用法（独立）：见 scripts/sync-server.mjs
-// ============================================================================
-import { createRequire } from "node:module";
-const require = createRequire(import.meta.url);
-import { randomUUID } from "node:crypto";
-import { homedir } from "node:os";
-import { join, normalize } from "node:path";
-
-const { DatabaseSync } = require("node:sqlite");
-const { WebSocketServer } = require("ws");
-const core = require("@tldraw/sync-core");
-const tlschema = require("@tldraw/tlschema");
-const T = require("@tldraw/validate").T;
-
-// ---- agent dir（与 lib/sqlite-db.ts 同语义）----
-export function getAgentDir() {
-  const envDir = process.env.PI_CODING_AGENT_DIR;
-  if (envDir) {
-    const expanded = envDir.startsWith("~") ? join(homedir(), envDir.slice(1)) : envDir;
-    return normalize(expanded);
-  }
-  return join(homedir(), ".pi", "agent");
-}
-export const SYNC_DB_FILE = join(getAgentDir(), "sync.db");
-
-// ---- 自定义 shape props 校验器（与 components/canvas/{SessionCardShape,StickyNoteShape,TaskCardShape}.tsx 保持一致）----
-const sessionCardProps = {
-  sessionId: T.string, title: T.string, projectName: T.string,
-  messageCount: T.number, lastReply: T.string, phase: T.string,
-  runningMs: T.number, endedAt: T.number, lastActivityAt: T.number,
-  stale: T.boolean, expanded: T.boolean, cwd: T.string, taskId: T.string,
-  w: T.number, h: T.number, expandedW: T.number, expandedH: T.number,
-  collapsedW: T.number, collapsedH: T.number,
-};
-const stickyNoteProps = {
-  text: T.string, w: T.number, h: T.number,
-  badge: T.string.optional(), createdAt: T.number.optional(),
-};
-const taskCardProps = {
-  cardId: T.string, number: T.number, name: T.string,
-  description: T.string.optional(), readyStatus: T.string, execStatus: T.string, priority: T.number,
-  // due：业务层允许 number | null（无截止=null）。shape 写入可能带 null（草稿初始化/API 回读），
-  // 必须 nullable 否则 sync 校验失败 → INVALID_RECORD → 画布永远 loading（派发后看板死掉根因）
-  due: T.number.nullable().optional(), expanded: T.boolean,
-  w: T.number, h: T.number, expandedW: T.number, expandedH: T.number,
-  collapsedW: T.number, collapsedH: T.number,
-};
-
-export const syncSchema = tlschema.createTLSchema({
-  shapes: {
-    ...tlschema.defaultShapeSchemas,
-    "session-card": { props: sessionCardProps },
-    "sticky-note": { props: stickyNoteProps },
-    "task-card": { props: taskCardProps },
-  },
-  bindings: { ...tlschema.defaultBindingSchemas },
-  assets: { ...tlschema.defaultAssetSchemas },
-});
-
-// ---- 房间管理：每 boardId 一个 TLSocketRoom；SQLite 持久化（同一 sync.db，tablePrefix 隔离）----
-// 单一 DatabaseSync 连接（node:sqlite 同步，单连接线程安全）
-const db = new DatabaseSync(SYNC_DB_FILE);
-const rooms = new Map();
-
-function safePrefix(boardId) {
-  return `board_${boardId.replace(/[^a-zA-Z0-9_]/g, "_")}_`;
-}
-
-export function getSyncRoom(boardId) {
-  let room = rooms.get(boardId);
-  if (room) return room;
-  const storage = new core.SQLiteSyncStorage({
-    sql: new core.NodeSqliteWrapper(db, { tablePrefix: safePrefix(boardId) }),
-  });
-  room = new core.TLSocketRoom({
-    // clientTimeout 不能传 0：0 会让 pruneSessions 把所有 Connected 会话当超时踢掉
-    // （timeSince > 0 恒真）→ 客户端重连风暴。传 undefined 用默认 20s 空闲超时，
-    // ping 每 5s 保活，正常不会触发。
-    storage, schema: syncSchema, clientTimeout: undefined,
-    // INVALID_RECORD 等致命错误会走 log.error（带 TLSyncError 对象）——hook 它打印详情
-    log: {
-      warn: (...a) => console.warn("[sync:room]", ...a),
-      error: (...a) => {
-        const err = a[0];
-        const detail = err instanceof Error ? `${err.message}${err.reason ? ` [reason=${err.reason}]` : ""}` : JSON.stringify(a).slice(0, 500);
-        console.error("[sync:room]", detail);
-      },
-    },
-  });
-  rooms.set(boardId, room);
-  return room;
-}
-
-export function getSyncRoomCount() {
-  return rooms.size;
-}
-
-// noServer WSS：不做端口监听，只负责把 upgrade 的 net.Socket 握手成 ws 实例
-const wss = new WebSocketServer({ noServer: true });
-
-/**
- * 处理一条 WebSocket upgrade 请求（挂在 Node http server 的 "upgrade" 事件）。
- * 路径匹配 /connect/:boardId → 房间接管；否则返回 false（调用方转交 Next 自身 handler，如 HMR）。
- * @returns {boolean} 是否已处理
- */
-export function handleSyncUpgrade(req, socket, head) {
-  let url;
-  try {
-    url = new URL(req.url, "http://localhost");
-  } catch {
-    return false;
-  }
-  const m = url.pathname.match(/^\/connect\/([^/]+)$/);
-  if (!m) return false;
-
-  const boardId = decodeURIComponent(m[1]);
-  const room = getSyncRoom(boardId);
-  // sessionId 必须复用客户端提供的（useSync 每次重连带固定 TAB_ID）——
-  // 若随机生成，重连被当成新会话，服务器端 session 堆积、协议错乱。
-  const sessionId = url.searchParams.get("sessionId") ?? randomUUID();
-
-  // 握手成功后 ws 即为 EventTarget 兼容实例；handleSocketConnect 自动挂
-  // message/close/error 监听。绝不手动再 ws.on("message")——否则每条消息处理
-  // 两次 → push_result 双发 → 重连死循环。
-  wss.handleUpgrade(req, socket, head, (ws) => {
-    room.handleSocketConnect({ sessionId, socket: ws, isReadonly: false });
-    console.log(`[sync] ${boardId}: client ${sessionId.slice(0, 8)} connected (${room.getNumActiveSessions()})`);
-  });
-  return true;
-}