@baique/pi-web-sky 0.1.39 → 0.1.40

package/.next/trace-build

@@ -1 +1 @@
-[{"name":"run-webpack","duration":42193441,"timestamp":3455553122,"id":14,"parentId":1,"tags":{},"startTime":1788318122605,"traceId":"3d8d643b4a038648"},{"name":"run-typescript","duration":14261742,"timestamp":3497752226,"id":10174,"parentId":1,"tags":{},"startTime":1788318164804,"traceId":"3d8d643b4a038648"},{"name":"static-check","duration":2907414,"timestamp":3512070891,"id":10177,"parentId":1,"tags":{},"startTime":1788318179123,"traceId":"3d8d643b4a038648"},{"name":"static-generation","duration":4550953,"timestamp":3515315415,"id":10323,"parentId":1,"tags":{},"startTime":1788318182367,"traceId":"3d8d643b4a038648"},{"name":"collect-build-traces","duration":46582816,"timestamp":3514980726,"id":10320,"parentId":1,"tags":{},"startTime":1788318182032,"traceId":"3d8d643b4a038648"},{"name":"telemetry-flush","duration":47,"timestamp":3561566861,"id":10332,"parentId":1,"tags":{},"startTime":1788318228619,"traceId":"3d8d643b4a038648"},{"name":"next-build","duration":106117951,"timestamp":3455448965,"id":1,"tags":{"buildMode":"default","version":"16.3.1","bundler":"webpack","has-custom-webpack-config":"false","use-build-worker":"true"},"startTime":1788318122501,"traceId":"3d8d643b4a038648"}]
+[{"name":"run-webpack","duration":35372491,"timestamp":96021475118,"id":14,"parentId":1,"tags":{},"startTime":1788410688527,"traceId":"f629955da06ea8af"},{"name":"run-typescript","duration":15126563,"timestamp":96056851726,"id":8709,"parentId":1,"tags":{},"startTime":1788410723903,"traceId":"f629955da06ea8af"},{"name":"static-check","duration":2933639,"timestamp":96072041613,"id":8712,"parentId":1,"tags":{},"startTime":1788410739093,"traceId":"f629955da06ea8af"},{"name":"static-generation","duration":4915470,"timestamp":96075314418,"id":8848,"parentId":1,"tags":{},"startTime":1788410742366,"traceId":"f629955da06ea8af"},{"name":"collect-build-traces","duration":47224994,"timestamp":96074977893,"id":8845,"parentId":1,"tags":{},"startTime":1788410742030,"traceId":"f629955da06ea8af"},{"name":"telemetry-flush","duration":41,"timestamp":96122206243,"id":8857,"parentId":1,"tags":{},"startTime":1788410789258,"traceId":"f629955da06ea8af"},{"name":"next-build","duration":100852409,"timestamp":96021353882,"id":1,"tags":{"buildMode":"default","version":"16.3.1","bundler":"webpack","has-custom-webpack-config":"false","use-build-worker":"true"},"startTime":1788410688406,"traceId":"f629955da06ea8af"}]

package/.next/types/app/api/boards/[id]/{reconcile-task-edges → reconcile}/route.ts

@@ -1,10 +1,10 @@
-// File: /home/wa/project/pi-web-sky/app/api/boards/[id]/reconcile-task-edges/route.ts
-import * as entry from '../../../../../../../app/api/boards/[id]/reconcile-task-edges/route.js'
+// File: /home/wa/project/pi-web-sky/app/api/boards/[id]/reconcile/route.ts
+import * as entry from '../../../../../../../app/api/boards/[id]/reconcile/route.js'
 import type { NextRequest } from 'next/server.js'
 
 import type { InstantConfigForTypeCheckInternal, Prefetch } from 'next/dist/build/segment-config/app/app-segment-config.js'
 
-type TEntry = typeof import('../../../../../../../app/api/boards/[id]/reconcile-task-edges/route.js')
+type TEntry = typeof import('../../../../../../../app/api/boards/[id]/reconcile/route.js')
 
 type SegmentParams<T extends Object = any> = T extends Record<string, any>
   ? { [K in keyof T]: T[K] extends string ? string | string[] | undefined : never }

package/.next/types/routes.d.ts

@@ -2,7 +2,7 @@
 // Do not edit this file manually
 
 type AppRoutes = "/"
-type AppRouteHandlerRoutes = "/api/agent/[id]" | "/api/agent/[id]/bash-output" | "/api/agent/[id]/events" | "/api/agent/new" | "/api/agent/running" | "/api/app-update" | "/api/auth/all-providers" | "/api/auth/api-key/[provider]" | "/api/auth/login/[provider]" | "/api/auth/logout/[provider]" | "/api/auth/providers" | "/api/boards" | "/api/boards/[id]" | "/api/boards/[id]/canvas" | "/api/boards/[id]/edges" | "/api/boards/[id]/edges/[eid]" | "/api/boards/[id]/nodes" | "/api/boards/[id]/nodes/[nid]" | "/api/boards/[id]/reconcile-task-edges" | "/api/boards/purge-orphans" | "/api/boards/reorder" | "/api/cwd/browse" | "/api/cwd/validate" | "/api/default-cwd" | "/api/file-index" | "/api/files/[...path]" | "/api/git/diff" | "/api/git/status" | "/api/home" | "/api/mcp" | "/api/models" | "/api/models-config" | "/api/models-config/catalog" | "/api/models-config/discover" | "/api/models-config/test" | "/api/plugins" | "/api/project-trust" | "/api/quota" | "/api/search" | "/api/sessions" | "/api/sessions/[id]" | "/api/sessions/[id]/auto-name" | "/api/sessions/[id]/context" | "/api/sessions/[id]/entries/[entryId]/thinking" | "/api/sessions/[id]/export" | "/api/sessions/[id]/state" | "/api/sessions/[id]/todos" | "/api/skills" | "/api/skills/check" | "/api/skills/install" | "/api/skills/search" | "/api/skills/update" | "/api/task-card-questions" | "/api/task-card-questions/[id]/answer" | "/api/task-cards" | "/api/task-cards/[id]" | "/api/task-scheduler/status" | "/api/tasks" | "/api/tasks/[id]" | "/api/tasks/[id]/board" | "/api/tasks/reorder" | "/api/terminal" | "/api/terminal/[id]" | "/api/terminal/[id]/events" | "/api/worktrees"
+type AppRouteHandlerRoutes = "/api/agent/[id]" | "/api/agent/[id]/bash-output" | "/api/agent/[id]/events" | "/api/agent/new" | "/api/agent/running" | "/api/app-update" | "/api/auth/all-providers" | "/api/auth/api-key/[provider]" | "/api/auth/login/[provider]" | "/api/auth/logout/[provider]" | "/api/auth/providers" | "/api/boards" | "/api/boards/[id]" | "/api/boards/[id]/reconcile" | "/api/boards/purge-orphans" | "/api/boards/reorder" | "/api/cwd/browse" | "/api/cwd/validate" | "/api/default-cwd" | "/api/file-index" | "/api/files/[...path]" | "/api/git/diff" | "/api/git/status" | "/api/home" | "/api/mcp" | "/api/models" | "/api/models-config" | "/api/models-config/catalog" | "/api/models-config/discover" | "/api/models-config/test" | "/api/plugins" | "/api/project-trust" | "/api/quota" | "/api/search" | "/api/sessions" | "/api/sessions/[id]" | "/api/sessions/[id]/auto-name" | "/api/sessions/[id]/context" | "/api/sessions/[id]/entries/[entryId]/thinking" | "/api/sessions/[id]/export" | "/api/sessions/[id]/state" | "/api/sessions/[id]/todos" | "/api/skills" | "/api/skills/check" | "/api/skills/install" | "/api/skills/search" | "/api/skills/update" | "/api/task-card-questions" | "/api/task-card-questions/[id]/answer" | "/api/task-cards" | "/api/task-cards/[id]" | "/api/task-scheduler/status" | "/api/tasks" | "/api/tasks/[id]" | "/api/tasks/[id]/board" | "/api/tasks/reorder" | "/api/terminal" | "/api/terminal/[id]" | "/api/terminal/[id]/events" | "/api/worktrees"
 type PageRoutes = never
 type LayoutRoutes = "/"
 type RedirectRoutes = never
@@ -25,12 +25,7 @@ interface ParamMap {
   "/api/auth/providers": {}
   "/api/boards": {}
   "/api/boards/[id]": { "id": string; }
-  "/api/boards/[id]/canvas": { "id": string; }
-  "/api/boards/[id]/edges": { "id": string; }
-  "/api/boards/[id]/edges/[eid]": { "id": string; "eid": string; }
-  "/api/boards/[id]/nodes": { "id": string; }
-  "/api/boards/[id]/nodes/[nid]": { "id": string; "nid": string; }
-  "/api/boards/[id]/reconcile-task-edges": { "id": string; }
+  "/api/boards/[id]/reconcile": { "id": string; }
   "/api/boards/purge-orphans": {}
   "/api/boards/reorder": {}
   "/api/cwd/browse": {}

package/.next/types/validator.ts

@@ -155,55 +155,10 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
-// Validate ../../app/api/boards/[id]/canvas/route.ts
+// Validate ../../app/api/boards/[id]/reconcile/route.ts
 {
-  type __IsExpected<Specific extends RouteHandlerConfig<"/api/boards/[id]/canvas">> = Specific
-  const handler = {} as typeof import("../../app/api/boards/[id]/canvas/route.js")
-  type __Check = __IsExpected<typeof handler>
-  // @ts-ignore
-  type __Unused = __Check
-}
-
-// Validate ../../app/api/boards/[id]/edges/[eid]/route.ts
-{
-  type __IsExpected<Specific extends RouteHandlerConfig<"/api/boards/[id]/edges/[eid]">> = Specific
-  const handler = {} as typeof import("../../app/api/boards/[id]/edges/[eid]/route.js")
-  type __Check = __IsExpected<typeof handler>
-  // @ts-ignore
-  type __Unused = __Check
-}
-
-// Validate ../../app/api/boards/[id]/edges/route.ts
-{
-  type __IsExpected<Specific extends RouteHandlerConfig<"/api/boards/[id]/edges">> = Specific
-  const handler = {} as typeof import("../../app/api/boards/[id]/edges/route.js")
-  type __Check = __IsExpected<typeof handler>
-  // @ts-ignore
-  type __Unused = __Check
-}
-
-// Validate ../../app/api/boards/[id]/nodes/[nid]/route.ts
-{
-  type __IsExpected<Specific extends RouteHandlerConfig<"/api/boards/[id]/nodes/[nid]">> = Specific
-  const handler = {} as typeof import("../../app/api/boards/[id]/nodes/[nid]/route.js")
-  type __Check = __IsExpected<typeof handler>
-  // @ts-ignore
-  type __Unused = __Check
-}
-
-// Validate ../../app/api/boards/[id]/nodes/route.ts
-{
-  type __IsExpected<Specific extends RouteHandlerConfig<"/api/boards/[id]/nodes">> = Specific
-  const handler = {} as typeof import("../../app/api/boards/[id]/nodes/route.js")
-  type __Check = __IsExpected<typeof handler>
-  // @ts-ignore
-  type __Unused = __Check
-}
-
-// Validate ../../app/api/boards/[id]/reconcile-task-edges/route.ts
-{
-  type __IsExpected<Specific extends RouteHandlerConfig<"/api/boards/[id]/reconcile-task-edges">> = Specific
-  const handler = {} as typeof import("../../app/api/boards/[id]/reconcile-task-edges/route.js")
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/boards/[id]/reconcile">> = Specific
+  const handler = {} as typeof import("../../app/api/boards/[id]/reconcile/route.js")
   type __Check = __IsExpected<typeof handler>
   // @ts-ignore
   type __Unused = __Check

package/README.md

@@ -52,6 +52,8 @@ pi-web-sky
 - **卡片即工作台**：收合卡显示状态/标题/最后回复，展开卡直接在画布上聊天、看状态、盯统计，展开后仍可拖动、拉伸、连线。
 - **实时状态**：卡片实时显示思考中/执行工具/等待输入（思考球动效）；「运行中」看板自动聚合所有正在运行的任务，跨项目一眼看全。
 - **便笺**：随手贴 markdown 便笺，支持颜色与代码块。
+- **派生边**：画布自动绘制连线——会话执行线（虚线，卡到会话）与任务依赖线（实线），随业务状态自动增删，无需手绘。
+- **右键菜单**：卡片/空白处右键弹出玻璃菜单（新建会话、便笺、删除、连线等），删除按节点类型做二次确认。
 - **画布打磨**：缩放/平移/吸附对齐、重叠卡片点击置顶、Ctrl+F 定位节点、看板 URL 持久化，刷新后停在原地。
 
 ### 内置多会话终端
@@ -100,13 +102,8 @@ npm test             # 单元测试
 
 本项目代码以 [MIT](./LICENSE) 协议发布。
 
-**注意**：会话看板（画布）依赖 [tldraw](https://tldraw.dev) SDK（`tldraw` / `@tldraw/sync` / `@tldraw/sync-core`），
-tldraw **不是开源协议**，而是 source-available 的自有许可（免费仅限开发环境）：
+会话看板（画布）自研实现：渲染层基于 [@xyflow/react](https://reactflow.dev)（MIT），
+数据层基于 [yjs](https://yjs.dev)（MIT CRDT）+ [Hocuspocus](https://tiptap.dev/docs/hocuspocus)（MIT）协同服务端，
+均为宽松许可，与 MIT 主协议兼容，无商用限制。
 
-- 在**生产环境**（对外提供服务，含非 loopback 的内网 IP、公网部署）使用看板，需要 tldraw 的 License Key：
-  - 非商用项目可申请免费 **hobby license**（画布显示 "made with tldraw" 水印）；
-  - 商用项目须购买 **commercial license**（100 天免费 trial 可用于评估）。
-- 本项目自带功能与自身代码仍为 MIT；tldraw 代码须保持其原许可证，不能被重新声明为 MIT。
-- 本项目的 MIT 许可**不涵盖** tldraw；在非开发环境使用看板功能，请自行向 tldraw 申请相应许可。
-
-第三方依赖许可明细见 [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md)（含 tldraw License 原文）。
+第三方依赖许可明细见 [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md)。

package/THIRD_PARTY_NOTICES.md

@@ -1,93 +1,21 @@
 # Third-Party Notices
 
 本发行版（`@baique/pi-web-sky`）自身代码以 MIT 协议发布（见 [LICENSE](./LICENSE)），
-但**依赖了部分非 MIT / 非开源协议的第三方组件**，使用与再分发时须遵守其各自许可条款。
+依赖的第三方组件均为宽松许可（MIT / Apache-2.0 / BSD-2-Clause 等），与 MIT 主协议兼容。
 
 ---
 
-## tldraw SDK（tldraw / @tldraw/sync / @tldraw/sync-core，5.x）
+## 画布依赖（会话看板 / 任务即看板）
 
-**看板功能（会话看板 / 画布）依赖 tldraw SDK。tldraw 不是开源协议，而是 source-available 的自有许可证。**
+| 组件 | 版本 | 许可 | 用途 |
+|---|---|---|---|
+| @xyflow/react | 12.11.6 | MIT | 看板画布渲染（无限画布 / 节点 / 连线） |
+| yjs | 13.6.32 | MIT | 画布文档 CRDT 协同（每看板一个 Y.Doc） |
+| @hocuspocus/server | 4.6.0 | MIT | yjs 协同服务端（WebSocket 房间 + SQLite 持久化） |
+| @hocuspocus/provider | 4.6.0 | MIT | yjs 协同客户端（前端连接） |
 
-- 免费仅限**开发环境**（本机 loopback / localhost / 非 production）。
-- 在**生产环境**（对外提供服务，含非 loopback 的内网 IP、公网部署）使用，必须持有有效 License Key：
-  - 非商用项目可申请免费 **hobby license**（画布显示 "made with tldraw" 水印）；
-  - 商用项目须购买 **commercial license**（100 天免费 trial 可用于评估）；
-- tldraw SDK 不能被声明为 MIT 或任何更宽松的开源协议，其代码须保持原许可证。
-- 按 tldraw License 要求，分发本软件时须附 tldraw License 原文，全文如下。
-
-### tldraw license（原文）
-
-> # tldraw license
->
-> This License from tldraw, Inc. ("tldraw") governs your use of the accompanying Software. By using the Software, you accept the terms of this License. The tldraw software is copyrighted by tldraw Inc.
->
-> Alternative licenses are available from tldraw for commercial and non-commercial use. To get an alternative license or to learn more, visit https://tldraw.dev or contact sales@tldraw.com.
->
-> ## Definitions
->
-> "Production Environment" means any production deployment of the Software that operates on servers, cloud platforms, web applications, or where the software is used to provide functionality to end users, customers, or the public. Production Environment excludes internal development.
->
-> "Development Environment" means any internal hosting or deployment of the Software for development, testing, or staging purposes, operated by your organization and not accessible to end users, customers, or the public.
->
-> "License Key" means the programmatically generated key that controls Software functionality and usage restrictions.
->
-> ## Permissions
->
-> Subject to the following conditions, you are permitted to:
->
-> - Use the Software in Development Environments.
-> - Modify the Software to suit your needs.
-> - Bundle the Software with your own projects.
-> - Submit modifications of the Software to tldraw.
->
-> ## Conditions
->
-> In exchange for these permissions, you agree:
->
-> - Not to use the Software in Production Environments.
-> - Not to disable, change, or interfere with the Software's License Key enforcement.
-> - Not to remove any copyright or other notices from the Software.
-> - Not to make the Software available under a license that supersedes or negates the effect of this License.
-> - Not to distribute the Software or modifications of the Software as a standalone product, but only as part of another application.
-> - To include a verbatim copy of this License in any distribution of the Software.
-> - To comply with tldraw's trademark policy.
->
-> ## Trial license
->
-> In the case that tldraw makes the Software available to you on a trial basis, you are permitted to use the Software in Production Environments for the specified period beginning from the date of the trial's License Key issuance. Business units are limited to one trial period unless otherwise approved by tldraw in writing.
->
-> ## Commercial license
->
-> In the case that tldraw makes the Software available to you under the terms of a separate commercial agreement, you are permitted to use the Software in Production Environments for the specified period beginning from the date of the agreement's License Key issuance.
->
-> ## Termination
->
-> Your license to use the Software will terminate automatically if you breach any terms of this License or initiate a copyright, trade secret, or patent claim against tldraw, any of its affiliates, or any user of the Software (including as modified by you).
->
-> ## Technical enforcement
->
-> The Software includes technical measures to verify License Key validity, detect deployment environments, enforce usage restrictions based on license type, and ensure proper watermark display. The Software may collect and transmit usage data to tldraw for license compliance purposes.
->
-> ## Ownership of intellectual property
->
-> tldraw retains all right, title, and interest in the Software, including all intellectual property rights therein. This Agreement grants you only the specific, limited rights expressly set forth herein, and tldraw reserves all rights not expressly granted.
->
-> ## Disclaimer of warranties
->
-> The Software is provided "AS IS," without any warranties. This includes any implied warranties of merchantability, fitness for a particular purpose, or non-infringement. You must pass this disclaimer on whenever you distribute the Software or derivative works.
->
-> ## Limitation of liability
->
-> tldraw is not liable for any damages related to the Software or this License, including direct, indirect, special, or incidental damages, to the fullest extent permitted by law. You must pass this limitation of liability on whenever you distribute the Software or derivative works.
->
-> ## Governing law
->
-> This License is governed by the laws of Delaware, and the parties consent to exclusive jurisdiction in Delaware courts. The parties waive all defenses of lack of personal jurisdiction and forum non-conveniens.
->
-> ## Entire agreement / assignment
->
-> This License is the entire agreement between the parties, and supersedes any and all prior agreements, understandings or communications, written or oral, between the parties relating to the subject matter hereof. This License may be assigned by tldraw without your prior consent.
+> 说明：历史版本依赖 tldraw SDK（source-available 自有许可）实现画布，已在本版移除，
+> 改用上述 MIT 组件完全自研画布数据层与渲染层。
 
 ---
 

package/bin/pi-web-sky.js

@@ -50,9 +50,9 @@ if (!loopbackHostnames.has(hostname)) {
   }
 }
 
-// 直接跑自定义 server（server.mjs）：HTTP 交 Next，WebSocket upgrade 分流到 tldraw
-// sync 房间（/connect/:boardId）。不能只跑 `next start`——那样 WS 后台不启动，
-// 看板永远 loading（0.1.35 生产 bug 根因）。
+// 直接跑自定义 server（server.mjs）：HTTP 交 Next，WebSocket upgrade 分流到
+// 内嵌 yjs 协同房间（/connect，每看板一个 Y.Doc）。不能只跑 `next start`——那样
+// WS 后台不启动，看板永远 loading（0.1.35 生产 bug 根因）。
 const child = spawn(process.execPath, [serverEntry], {
   cwd: pkgDir,
   stdio: ["inherit", "pipe", "inherit"],

package/lib/board-reconcile-scheduler.ts

@@ -0,0 +1,56 @@
+// ============================================================================
+// 看板派生 reconcile 定时兜底调度器
+//
+// 目的：需求「看板实时变更，外部或本页新建的会话自动加入看板（窗口期不宜太久）」。
+// 事件驱动（调度器派发 / assignSessionToTask / 建卡删卡）之外，周期扫描任务看板，
+// 兜底处理事件链路遗漏的场景：
+//   - 外部进程（CLI/其他实例）直接写 session_meta 归属任务
+//   - 任务卡直接改 sessionId（绕过调度器）
+//   - 任务卡依赖变化
+// 周期：与旧前端 reconcile 的 10s 轮询一致（窗口期不变）。
+// ============================================================================
+import { getDb } from "./sqlite-db";
+import { reconcileBoard } from "./board-reconcile";
+
+export const BOARD_RECONCILE_INTERVAL_MS = 10_000;
+
+/** 列出全部任务看板 id（boards.task_id 非空）。 */
+export function listTaskBoardIds(): string[] {
+  return getDb()
+    .prepare("SELECT id FROM boards WHERE task_id IS NOT NULL")
+    .all()
+    .map((r) => (r as { id: string }).id);
+}
+
+declare global {
+  var __piBoardReconcileScheduler: { timer: ReturnType<typeof setInterval>; startedAt: number } | undefined;
+}
+
+/** 单轮：reconcile 所有任务看板。防重叠（上一轮未跑完则跳过）。 */
+export async function runBoardReconcileTick(): Promise<void> {
+  const ids = listTaskBoardIds();
+  // 并行 reconcile（各自独立 Y.Doc，互不阻塞）
+  await Promise.all(
+    ids.map((boardId) =>
+      reconcileBoard(boardId).catch((e) => {
+        console.warn(`[board-reconcile] ${boardId} 异常:`, e?.message ?? e);
+      }),
+    ),
+  );
+}
+
+/** 启动定时兜底（instrumentation 注册；globalThis 防热重载重复启动）。 */
+export function startBoardReconcileScheduler(): void {
+  if (globalThis.__piBoardReconcileScheduler) return;
+  let tickInFlight = false;
+  const timer = setInterval(() => {
+    if (tickInFlight) return;
+    tickInFlight = true;
+    void runBoardReconcileTick()
+      .catch((e) => console.error("[board-reconcile] tick error:", e?.message ?? e))
+      .finally(() => { tickInFlight = false; });
+  }, BOARD_RECONCILE_INTERVAL_MS);
+  timer.unref?.();
+  globalThis.__piBoardReconcileScheduler = { timer, startedAt: Date.now() };
+  console.log(`[pi-web] board reconcile scheduler started (interval ${BOARD_RECONCILE_INTERVAL_MS}ms)`);
+}

package/lib/board-reconcile.test.mjs

@@ -0,0 +1,252 @@
+import { test, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import { DatabaseSync } from "node:sqlite";
+import { createJiti } from "jiti";
+
+const jiti = createJiti(import.meta.url, { interopDefault: true, moduleCache: false });
+const { setDbForTesting, getDb } = await jiti.import("./sqlite-db.ts");
+const { createTask } = await jiti.import("./task-store.ts");
+const { getOrCreateTaskBoard } = await jiti.import("./board-store.ts");
+const { createCard, updateCard } = await jiti.import("./task-card-store.ts");
+const { assignSessionToTask } = await jiti.import("./task-store.ts");
+
+const PROJECT = "proj-reconcile";
+
+// 注入 mutateBoard mock：捕获每次事务调用（读入当前 Y 状态，执行 transaction 后
+// 记录对 nodes/edges 的增删，模拟服务端权威写）。
+function installYjsMock() {
+  const yjs = (globalThis).__yjsBoard ?? {};
+  const nodeSets = new Map(); // nodeId -> node obj
+  const edgeSets = new Map(); // edgeId -> edge obj
+  const mutateLog = [];
+
+  // 取与真实库同构的 mock：nodes/edges 用普通 Map 承载，transaction 内增删与
+  // reconcile 的 nodesMap/edgesMap API 一致（get/set/delete/values/Array.from）。
+  const state = { nodes: nodeSets, edges: edgeSets };
+
+  const mock = {
+    async mutateBoard(boardId, transaction) {
+      mutateLog.push(boardId);
+      const maps = {
+        nodes: {
+          get: (k) => state.nodes.get(k),
+          set: (k, v) => { state.nodes.set(k, v); },
+          delete: (k) => { state.nodes.delete(k); },
+          has: (k) => state.nodes.has(k),
+          values: () => state.nodes.values(),
+        },
+        edges: {
+          get: (k) => state.edges.get(k),
+          set: (k, v) => { state.edges.set(k, v); },
+          delete: (k) => { state.edges.delete(k); },
+          has: (k) => state.edges.has(k),
+          values: () => state.edges.values(),
+        },
+      };
+      transaction(maps, {});
+    },
+  };
+  (globalThis).__yjsBoard = mock;
+  return { nodeSets, edgeSets, mutateLog };
+}
+
+function cardNode(id, sid, extra) {
+  return {
+    id,
+    type: "session-card",
+    position: { x: 60, y: 60 },
+    style: { width: 340, height: 160 },
+    data: { sessionId: sid, cwd: "", ...extra },
+  };
+}
+
+let db;
+let mockState;
+
+beforeEach(() => {
+  db = new DatabaseSync(":memory:");
+  setDbForTesting(db);
+  mockState = installYjsMock();
+});
+
+afterEach(() => {
+  db.close();
+  delete (globalThis).__yjsBoard;
+});
+
+test("窗口期 reconcile 不补同 sid 占位卡（新建会话指定 ID 场景）", async () => {
+  const task = createTask(PROJECT, "任务A");
+  const board = getOrCreateTaskBoard(task.id, PROJECT, "任务A"); // board.id = task.id
+  assert.ok(board.taskId);
+
+  // 服务端已落库（assignSessionToTask 在 /api/agent/new 中先于前端转正执行）
+  const sid = "abc-123";
+  assignSessionToTask(sid, task.id);
+
+  // 画布已存在「新建中占位卡」：cwd 非空 + sessionId = 即将创建/刚创建的会话 UUID
+  mockState.nodeSets.set("user-card-1", cardNode("user-card-1", sid, { cwd: "/proj", expanded: true }));
+
+  const { reconcileBoard } = await jiti.import("./board-reconcile.ts");
+  await reconcileBoard(board.id);
+
+  // 不补第二张卡：窗口期内 reconcile 应把占位卡当作「该 sid 已有卡」
+  const nodeIds = [...mockState.nodeSets.keys()];
+  assert.deepEqual(nodeIds, ["user-card-1"]);
+  assert.equal(mockState.nodeSets.has(`session-${sid}`), false);
+});
+
+test("无占位卡时业务表会话正常补卡（回归，不误伤）", async () => {
+  const task = createTask(PROJECT, "任务B");
+  const board = getOrCreateTaskBoard(task.id, PROJECT, "任务B");
+  const sid = "reg-session-1";
+  assignSessionToTask(sid, task.id);
+
+  const { reconcileBoard } = await jiti.import("./board-reconcile.ts");
+  await reconcileBoard(board.id);
+
+  assert.ok(mockState.nodeSets.has(`session-${sid}`), "业务表会话无画布卡 → 应补卡");
+  const node = mockState.nodeSets.get(`session-${sid}`);
+  assert.equal(node.data.sessionId, sid);
+});
+
+test("占位卡不影响其他会话补卡/exec 线（6461a61 语义保留）", async () => {
+  const task = createTask(PROJECT, "任务C");
+  const board = getOrCreateTaskBoard(task.id, PROJECT, "任务C");
+
+  // 一个「新建中」占位卡（sid 未落库）
+  const pendingSid = "pending-uuid";
+  mockState.nodeSets.set("pending-card", cardNode("pending-card", pendingSid, { cwd: "/x" }));
+
+  // 一个业务表真实会话 + 任务卡执行会话
+  const realSid = "real-session";
+  assignSessionToTask(realSid, task.id);
+  const execSid = "exec-session";
+  const card = createCard({ boardId: board.id, projectKey: PROJECT, name: "子任务" });
+  updateCard(card.id, { sessionId: execSid });
+  assignSessionToTask(execSid, task.id);
+
+  // 业务表会话都没有对应画布卡 → reconcile 应补齐 realSid/execSid，且建 exec 线
+  const { reconcileBoard } = await jiti.import("./board-reconcile.ts");
+  await reconcileBoard(board.id);
+
+  assert.ok(mockState.nodeSets.has(`session-${realSid}`), "真实会话应补卡");
+  assert.ok(mockState.nodeSets.has(`session-${execSid}`), "执行会话应补卡");
+  // 占位卡 sid 不在业务表 → 不应补（无对应补卡），且占位卡本身不被孤儿删（cwd 非空）
+  assert.equal(mockState.nodeSets.has(`session-${pendingSid}`), false);
+  assert.ok(mockState.nodeSets.has("pending-card"), "占位卡不被孤儿删");
+
+  // exec 线：任务卡节点 + 执行会话卡节点都补出后应建线（task-card 由 reconcile 补，节点 id = task-<cardId>）
+  const taskNode = [...mockState.nodeSets.values()].find((n) => n.type === "task-card");
+  assert.ok(taskNode, "任务卡节点应被补出");
+  const execEdge = [...mockState.edgeSets.values()].find((e) => e.data?.execLink);
+  assert.ok(execEdge, "exec 线应建立");
+  assert.equal(execEdge.source, taskNode.id);
+  assert.equal(execEdge.target, `session-${execSid}`);
+});
+
+// ---- 会话删除 → yjs 画布清理（普通看板幽灵卡） ----
+
+function installMultiBoardYjsMock() {
+  const docs = new Map(); // boardId -> { nodes: Map, edges: Map }
+  const mock = {
+    async mutateBoard(boardId, transaction) {
+      let doc = docs.get(boardId);
+      if (!doc) {
+        doc = { nodes: new Map(), edges: new Map() };
+        docs.set(boardId, doc);
+      }
+      const maps = {
+        nodes: {
+          get: (k) => doc.nodes.get(k),
+          set: (k, v) => { doc.nodes.set(k, v); },
+          delete: (k) => { doc.nodes.delete(k); },
+          has: (k) => doc.nodes.has(k),
+          values: () => doc.nodes.values(),
+        },
+        edges: {
+          get: (k) => doc.edges.get(k),
+          set: (k, v) => { doc.edges.set(k, v); },
+          delete: (k) => { doc.edges.delete(k); },
+          has: (k) => doc.edges.has(k),
+          values: () => doc.edges.values(),
+        },
+      };
+      transaction(maps, {});
+    },
+    async destroyBoardDocument(boardId) {
+      docs.delete(boardId);
+    },
+  };
+  (globalThis).__yjsBoard = mock;
+  return { docs };
+}
+
+test("删除会话：普通看板 yjs 会话卡被清理，其余卡保留", async () => {
+  const { createBoard } = await jiti.import("./board-store.ts");
+  const { removeSessionsFromYjsBoards, destroyBoardYjsDocument } = await jiti.import("./board-reconcile.ts");
+
+  const { docs } = installMultiBoardYjsMock();
+  const boardA = createBoard(PROJECT, "手动看板A");
+  const boardB = createBoard(PROJECT, "手动看板B");
+  const s1 = "sess-ghost-1";
+  const s2 = "sess-keep-2";
+  // 看板 A：含 s1 + s2 两张卡
+  await globalThis.__yjsBoard.mutateBoard(boardA.id, (maps) => {
+    maps.nodes.set("a1", cardNode("a1", s1, {}));
+    maps.nodes.set("a2", cardNode("a2", s2, {}));
+  });
+  // 看板 B：只含 s1
+  await globalThis.__yjsBoard.mutateBoard(boardB.id, (maps) => {
+    maps.nodes.set("b1", cardNode("b1", s1, {}));
+  });
+
+  await removeSessionsFromYjsBoards([s1]);
+
+  const keysA = [...docs.get(boardA.id).nodes.keys()];
+  const keysB = [...docs.get(boardB.id).nodes.keys()];
+  assert.deepEqual(keysA, ["a2"], "boardA 删 s1 卡保留 s2");
+  assert.deepEqual(keysB, [], "boardB 删 s1 卡");
+
+  // destroy：删看板 → 文档移除
+  await destroyBoardYjsDocument(boardA.id);
+  assert.equal(docs.has(boardA.id), false, "destroy 后看板 yjs 文档移除");
+});
+
+test("拖入任务看板的会话在归属完成前不被孤儿删（data.taskId 声明归属）", async () => {
+  const task = createTask(PROJECT, "任务D");
+  const board = getOrCreateTaskBoard(task.id, PROJECT, "任务D");
+
+  // 拖入一个「已存在但尚未归属本任务」的会话：落卡时 data.taskId = 本板任务
+  const draggedSid = "drag-in-progress";
+  mockState.nodeSets.set("drag-card", cardNode("drag-card", draggedSid, { taskId: task.id }));
+
+  const { reconcileBoard } = await jiti.import("./board-reconcile.ts");
+  await reconcileBoard(board.id);
+
+  // 不删：卡声明归属本板 → 放行
+  assert.ok(mockState.nodeSets.has("drag-card"), "归属窗口期拖入卡不被孤儿删");
+  // 但也不会补第二张（sid 不在业务表，本来就不补）
+  assert.equal(mockState.nodeSets.has(`session-${draggedSid}`), false);
+});
+
+test("删除会话：普通看板清理级联删除以会话卡为端点的边", async () => {
+  const { createBoard } = await jiti.import("./board-store.ts");
+  const { removeSessionsFromYjsBoards } = await jiti.import("./board-reconcile.ts");
+
+  const { docs } = installMultiBoardYjsMock();
+  const boardA = createBoard(PROJECT, "手动看板C");
+  const s1 = "sess-edge-1";
+  const s2 = "sess-edge-2";
+  // 板 A：s1、s2 两张卡，中间一条手绘边
+  await globalThis.__yjsBoard.mutateBoard(boardA.id, (maps) => {
+    maps.nodes.set("a1", cardNode("a1", s1, {}));
+    maps.nodes.set("a2", cardNode("a2", s2, {}));
+    maps.edges.set("e1", { id: "e1", source: "a1", target: "a2", type: "default" });
+  });
+
+  await removeSessionsFromYjsBoards([s1]);
+
+  const doc = docs.get(boardA.id);
+  assert.deepEqual([...doc.nodes.keys()], ["a2"], "只删 s1 卡");
+  assert.deepEqual([...doc.edges.keys()], [], "以 a1 为端点的边级联删除");
+});