@baique/pi-web-sky 0.1.55 → 0.1.57

package/.next/types/app/api/subagents/settings/route.ts

@@ -0,0 +1,353 @@
+// File: /Users/baique/work/pi-web-sky/app/api/subagents/settings/route.ts
+import * as entry from '../../../../../../app/api/subagents/settings/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/subagents/settings/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 }
+  : T
+
+// Check that the entry is a valid entry
+checkFields<Diff<{
+  GET?: Function
+  HEAD?: Function
+  OPTIONS?: Function
+  POST?: Function
+  PUT?: Function
+  DELETE?: Function
+  PATCH?: Function
+  config?: {}
+  generateStaticParams?: Function
+  instant?: InstantConfigForTypeCheckInternal
+  prefetch?: Prefetch
+  unstable_dynamicStaleTime?: number
+  revalidate?: RevalidateRange<TEntry> | false
+  dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
+  dynamicParams?: boolean
+  fetchCache?: 'auto' | 'force-no-store' | 'only-no-store' | 'default-no-store' | 'default-cache' | 'only-cache' | 'force-cache'
+  /** @deprecated The `preferredRegion` config is deprecated. Remove this export. */
+  preferredRegion?: 'auto' | 'global' | 'home' | string | string[]
+  runtime?: 'nodejs' | 'experimental-edge' | 'edge'
+  maxDuration?: number
+  
+}, TEntry, ''>>()
+
+type RouteContext = { params: Promise<SegmentParams> }
+// Check the prop type of the entry function
+if ('GET' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'GET'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'GET'>>
+      },
+      'GET'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'GET'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'GET'>>
+      },
+      'GET'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'GET',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'GET',
+        __return_type__: ReturnType<MaybeField<TEntry, 'GET'>>
+      },
+      'GET'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('HEAD' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'HEAD'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'HEAD'>>
+      },
+      'HEAD'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'HEAD'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'HEAD'>>
+      },
+      'HEAD'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'HEAD',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'HEAD',
+        __return_type__: ReturnType<MaybeField<TEntry, 'HEAD'>>
+      },
+      'HEAD'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('OPTIONS' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'OPTIONS'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'OPTIONS'>>
+      },
+      'OPTIONS'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'OPTIONS'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'OPTIONS'>>
+      },
+      'OPTIONS'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'OPTIONS',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'OPTIONS',
+        __return_type__: ReturnType<MaybeField<TEntry, 'OPTIONS'>>
+      },
+      'OPTIONS'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('POST' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'POST'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'POST'>>
+      },
+      'POST'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'POST'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'POST'>>
+      },
+      'POST'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'POST',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'POST',
+        __return_type__: ReturnType<MaybeField<TEntry, 'POST'>>
+      },
+      'POST'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('PUT' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'PUT'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'PUT'>>
+      },
+      'PUT'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'PUT'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'PUT'>>
+      },
+      'PUT'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'PUT',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'PUT',
+        __return_type__: ReturnType<MaybeField<TEntry, 'PUT'>>
+      },
+      'PUT'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('DELETE' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'DELETE'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'DELETE'>>
+      },
+      'DELETE'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'DELETE'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'DELETE'>>
+      },
+      'DELETE'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'DELETE',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'DELETE',
+        __return_type__: ReturnType<MaybeField<TEntry, 'DELETE'>>
+      },
+      'DELETE'
+    >
+  >()
+}
+// Check the prop type of the entry function
+if ('PATCH' in entry) {
+  checkFields<
+    Diff<
+      ParamCheck<Request | NextRequest>,
+      {
+        __tag__: 'PATCH'
+        __param_position__: 'first'
+        __param_type__: FirstArg<MaybeField<TEntry, 'PATCH'>>
+      },
+      'PATCH'
+    >
+  >()
+  checkFields<
+    Diff<
+      ParamCheck<RouteContext>,
+      {
+        __tag__: 'PATCH'
+        __param_position__: 'second'
+        __param_type__: SecondArg<MaybeField<TEntry, 'PATCH'>>
+      },
+      'PATCH'
+    >
+  >()
+  
+  checkFields<
+    Diff<
+      {
+        __tag__: 'PATCH',
+        __return_type__: Response | void | never | Promise<Response | void | never>
+      },
+      {
+        __tag__: 'PATCH',
+        __return_type__: ReturnType<MaybeField<TEntry, 'PATCH'>>
+      },
+      'PATCH'
+    >
+  >()
+}
+
+// Check the arguments and return type of the generateStaticParams function
+if ('generateStaticParams' in entry) {
+  checkFields<Diff<{ params: SegmentParams }, FirstArg<MaybeField<TEntry, 'generateStaticParams'>>, 'generateStaticParams'>>()
+  checkFields<Diff<{ __tag__: 'generateStaticParams', __return_type__: any[] | Promise<any[]> }, { __tag__: 'generateStaticParams', __return_type__: ReturnType<MaybeField<TEntry, 'generateStaticParams'>> }>>()
+}
+
+export interface PageProps {
+  params?: Promise<SegmentParams>
+  searchParams?: Promise<any>
+}
+export interface LayoutProps {
+  children?: React.ReactNode
+
+  params?: Promise<SegmentParams>
+}
+
+// =============
+// Utility types
+type RevalidateRange<T> = T extends { revalidate: any } ? NonNegative<T['revalidate']> : never
+
+// If T is unknown or any, it will be an empty {} type. Otherwise, it will be the same as Omit<T, keyof Base>.
+type OmitWithTag<T, K extends keyof any, _M> = Omit<T, K>
+type Diff<Base, T extends Base, Message extends string = ''> = 0 extends (1 & T) ? {} : OmitWithTag<T, keyof Base, Message>
+
+type FirstArg<T extends Function> = T extends (...args: [infer T, any]) => any ? unknown extends T ? any : T : never
+type SecondArg<T extends Function> = T extends (...args: [any, infer T]) => any ? unknown extends T ? any : T : never
+type MaybeField<T, K extends string> = T extends { [k in K]: infer G } ? G extends Function ? G : never : never
+
+type ParamCheck<T> = {
+  __tag__: string
+  __param_position__: string
+  __param_type__: T
+}
+
+function checkFields<_ extends { [k in keyof any]: never }>() {}
+
+// https://github.com/sindresorhus/type-fest
+type Numeric = number | bigint
+type Zero = 0 | 0n
+type Negative<T extends Numeric> = T extends Zero ? never : `${T}` extends `-${string}` ? T : never
+type NonNegative<T extends Numeric> = T extends Zero ? T : Negative<T> extends never ? T : '__invalid_negative_number__'

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/board-assets" | "/api/board-assets/[...path]" | "/api/boards" | "/api/boards/[id]" | "/api/boards/[id]/reconcile" | "/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]/minimap" | "/api/sessions/[id]/state" | "/api/sessions/[id]/todos" | "/api/sessions/summary" | "/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-cards/unbind" | "/api/task-scheduler/status" | "/api/tasks" | "/api/tasks/[id]" | "/api/tasks/[id]/assign-session" | "/api/tasks/[id]/board" | "/api/tasks/reorder" | "/api/terminal" | "/api/terminal/[id]" | "/api/terminal/[id]/events" | "/api/worktrees" | "/api/yjs-version"
+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/board-assets" | "/api/board-assets/[...path]" | "/api/boards" | "/api/boards/[id]" | "/api/boards/[id]/add-session" | "/api/boards/[id]/reconcile" | "/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]/minimap" | "/api/sessions/[id]/state" | "/api/sessions/[id]/todos" | "/api/sessions/summary" | "/api/skills" | "/api/skills/check" | "/api/skills/install" | "/api/skills/search" | "/api/skills/update" | "/api/subagents/[id]" | "/api/subagents/profiles" | "/api/subagents/settings" | "/api/task-card-questions" | "/api/task-card-questions/[id]/answer" | "/api/task-cards" | "/api/task-cards/[id]" | "/api/task-cards/unbind" | "/api/task-scheduler/status" | "/api/tasks" | "/api/tasks/[id]" | "/api/tasks/[id]/assign-session" | "/api/tasks/[id]/board" | "/api/tasks/reorder" | "/api/terminal" | "/api/terminal/[id]" | "/api/terminal/[id]/events" | "/api/worktrees" | "/api/yjs-version"
 type PageRoutes = never
 type LayoutRoutes = "/"
 type RedirectRoutes = never
@@ -27,6 +27,7 @@ interface ParamMap {
   "/api/board-assets/[...path]": { "path": string[]; }
   "/api/boards": {}
   "/api/boards/[id]": { "id": string; }
+  "/api/boards/[id]/add-session": { "id": string; }
   "/api/boards/[id]/reconcile": { "id": string; }
   "/api/boards/reorder": {}
   "/api/cwd/browse": {}
@@ -62,6 +63,9 @@ interface ParamMap {
   "/api/skills/install": {}
   "/api/skills/search": {}
   "/api/skills/update": {}
+  "/api/subagents/[id]": { "id": string; }
+  "/api/subagents/profiles": {}
+  "/api/subagents/settings": {}
   "/api/task-card-questions": {}
   "/api/task-card-questions/[id]/answer": { "id": string; }
   "/api/task-cards": {}

package/.next/types/validator.ts

@@ -173,6 +173,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/boards/[id]/add-session/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/boards/[id]/add-session">> = Specific
+  const handler = {} as typeof import("../../app/api/boards/[id]/add-session/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/boards/[id]/reconcile/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/boards/[id]/reconcile">> = Specific
@@ -506,6 +515,33 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../app/api/subagents/[id]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/subagents/[id]">> = Specific
+  const handler = {} as typeof import("../../app/api/subagents/[id]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/subagents/profiles/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/subagents/profiles">> = Specific
+  const handler = {} as typeof import("../../app/api/subagents/profiles/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/subagents/settings/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/subagents/settings">> = Specific
+  const handler = {} as typeof import("../../app/api/subagents/settings/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../app/api/task-card-questions/[id]/answer/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/task-card-questions/[id]/answer">> = Specific

package/lib/api-types.ts

@@ -1,4 +1,14 @@
 import type { ResourceDiagnostic } from "@earendil-works/pi-coding-agent";
+import type { SubagentProfile } from "./subagents";
+
+export interface SubagentProfilesResponse {
+  profiles: SubagentProfile[];
+}
+
+export interface SubagentSettingsResponse {
+  enabled: boolean;
+  maxConcurrent: number;
+}
 
 /** 时间轴导航条（ChatMinimap）的 turn 索引条目：只含文本摘要，不携带完整 content。 */
 export interface TurnIndexItem {

package/lib/board-reconcile.test.mjs

@@ -1,17 +1,35 @@
-import { test, beforeEach, afterEach } from "node:test";
+import { test, beforeEach, afterEach, after } from "node:test";
 import assert from "node:assert/strict";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
 import { DatabaseSync } from "node:sqlite";
 import { createJiti } from "jiti";
 
+// 隔离：归属写入现在会对「库里无行」的会话解析会话文件，临时 agentDir 保证
+// 测试绝不扫开发机真实的 ~/.pi/agent/sessions。
+const agentDir = mkdtempSync(join(tmpdir(), "pi-web-board-reconcile-"));
+process.env.PI_CODING_AGENT_DIR = agentDir;
+after(() => rmSync(agentDir, { recursive: true, force: true }));
+
 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";
 
+/** 库里已有该会话的行且已归属本任务（生产链路：行由创建链路/扫描器建、归属由
+ *  assignSessionToTask 写；reconcile 只消费「行 + 归属」，这里一次插齐）。 */
+function seedAssignedSession(sid, taskId) {
+  const ts = Date.now();
+  getDb().prepare(
+    "INSERT INTO session_meta (session_id, task_id, updated, pinned, path, cwd, project_key, created, modified) " +
+      "VALUES (?, ?, ?, 0, ?, ?, ?, ?, ?)",
+  ).run(sid, taskId, ts, `/sessions/proj/${sid}.jsonl`, "/proj", PROJECT, ts, ts);
+}
+
 // 注入 mutateBoard mock：捕获每次事务调用（读入当前 Y 状态，执行 transaction 后
 // 记录对 nodes/edges 的增删，模拟服务端权威写）。
 function installYjsMock() {
@@ -79,9 +97,9 @@ test("窗口期 reconcile 不补同 sid 占位卡（新建会话指定 ID 场景
   const board = getOrCreateTaskBoard(task.id, PROJECT, "任务A"); // board.id = task.id
   assert.ok(board.taskId);
 
-  // 服务端已落库（assignSessionToTask 在 /api/agent/new 中先于前端转正执行）
+  // 服务端已落库（行由创建链路建，归属在 /api/agent/new 中先于前端转正写入）
   const sid = "abc-123";
-  assignSessionToTask(sid, task.id);
+  seedAssignedSession(sid, task.id);
 
   // 画布已存在「新建中占位卡」：cwd 非空 + sessionId = 即将创建/刚创建的会话 UUID
   mockState.nodeSets.set("user-card-1", cardNode("user-card-1", sid, { cwd: "/proj", expanded: true }));
@@ -99,7 +117,7 @@ test("无占位卡时业务表会话正常补卡（回归，不误伤）", async
   const task = createTask(PROJECT, "任务B");
   const board = getOrCreateTaskBoard(task.id, PROJECT, "任务B");
   const sid = "reg-session-1";
-  assignSessionToTask(sid, task.id);
+  seedAssignedSession(sid, task.id);
 
   const { reconcileBoard } = await jiti.import("./board-reconcile.ts");
   await reconcileBoard(board.id);
@@ -119,11 +137,11 @@ test("占位卡不影响其他会话补卡（6461a61 语义保留）", async ()
 
   // 一个业务表真实会话 + 任务卡执行会话
   const realSid = "real-session";
-  assignSessionToTask(realSid, task.id);
+  seedAssignedSession(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);
+  seedAssignedSession(execSid, task.id);
 
   const { reconcileBoard } = await jiti.import("./board-reconcile.ts");
   await reconcileBoard(board.id);
@@ -315,7 +333,7 @@ test("拖入任务看板的会话：无 session_meta 归属 → 判孤儿删；
 
   // 拖入的会话已写 session_meta（先归属后落卡）→ 存活；画布已有该卡 → 不补第二张
   const assignedSid = "drag-with-meta";
-  assignSessionToTask(assignedSid, task.id);
+  seedAssignedSession(assignedSid, task.id);
   mockState.nodeSets.set("drag-card2", cardNode("drag-card2", assignedSid, { taskId: task.id }));
   await reconcileBoard(board.id);
   assert.ok(mockState.nodeSets.has("drag-card2"), "有 session_meta 归属的拖入卡存活");
@@ -343,3 +361,23 @@ test("删除会话：普通看板清理级联删除以会话卡为端点的边",
   assert.deepEqual([...doc.nodes.keys()], ["a2"], "只删 s1 卡");
   assert.deepEqual([...doc.edges.keys()], [], "以 a1 为端点的边级联删除");
 });
+
+test("侧栏拖会话到看板行：落卡到空位、重复拖同 sid 不动", async () => {
+  const { addSessionCardToBoard } = await jiti.import("./board-reconcile.ts");
+
+  // 已占 4 列首列（60,60）→ 新卡应落第二列（60 + 340 + 24）
+  mockState.nodeSets.set("session-占用", cardNode("session-占用", "占用", {}));
+
+  assert.equal(await addSessionCardToBoard("board-x", "sid-new", "拖来的标题"), true);
+  const node = mockState.nodeSets.get("session-sid-new");
+  assert.ok(node, "落卡存在");
+  assert.equal(node.type, "session-card");
+  assert.equal(node.data.title, "拖来的标题", "标题随拖拽源带入");
+  assert.equal(node.data.cwd, "", "cwd 必须空（非空 = 新建会话占位卡语义）");
+  assert.equal(node.position.x, 60 + 340 + 24, "不与已有卡重叠");
+
+  // 再拖同一会话：不重落（保留用户布局/展开态），也不改标题
+  assert.equal(await addSessionCardToBoard("board-x", "sid-new", "新标题"), false);
+  assert.equal(mockState.nodeSets.get("session-sid-new").data.title, "拖来的标题");
+  assert.equal(mockState.nodeSets.size, 2, "只有一张新卡");
+});

package/lib/board-reconcile.ts

@@ -175,7 +175,9 @@ export async function reconcileBoard(boardId: string, force = false): Promise<vo
   if (isTaskBoard) for (const sid of listTaskSessionIds(board.taskId!)) allSessionIds.add(sid);
   for (const c of cards) if (c.sessionId) allSessionIds.add(c.sessionId);
   // fork 会话派生：fork（parent_id 非空）会话的源会话归属本任务 → 本任务看板补 fork 卡。
-  // fork 会话自身不继承 task_id，需经源会话归属定位；普通看板 board.taskId 为空天然不参与。
+  // fork 会话建行时已继承源会话的 task_id（T1），这里仍按「源会话归属」定位，
+  // 是为了兼容存量行（扫描器收敛前的父在任务/子为空的脏行）与跨任务拖入的过渡态；
+  // 普通看板 board.taskId 为空天然不参与。
   const forkBySid = new Map<string, string>(); // forkSid -> parentSid
   if (isTaskBoard) {
     for (const { sessionId, parentId } of listTaskForkedSessions(board.taskId!)) {
@@ -417,6 +419,60 @@ function listTaskForkedSessions(taskId: string): Array<{ sessionId: string; pare
     .all(taskId) as Array<{ sessionId: string; parentId: string }>;
 }
 
+/**
+ * 侧栏拖会话到「看板」行 → 在目标看板落一张会话卡。
+ *
+ * 为什么走后端写：拖到侧栏行时目标看板可能没在当前页面打开（前端没有那个 Y.Doc），
+ * 只有服务端能权威写。落点用 findFreeSpot 找空位——拖到侧栏行没有画布坐标，
+ * 位置由后端定（不与已有卡重叠即可）。
+ *
+ * 幂等：画布已有同 sid 卡 → 不动（保留用户的布局/展开态），返回 false。
+ */
+export async function addSessionCardToBoard(
+  boardId: string,
+  sessionId: string,
+  title?: string,
+): Promise<boolean> {
+  let added = false;
+  await mutateBoard(boardId, (maps) => {
+    const id = `session-${sessionId}`;
+    if (maps.nodes.get(id)) return;
+    const nodes = Array.from(maps.nodes.values()) as unknown as DocNode[];
+    const spot = findFreeSpot(nodes, SESSION_CARD_W, SESSION_CARD_H);
+    maps.nodes.set(id, {
+      id,
+      type: "session-card",
+      position: { x: spot.x, y: spot.y },
+      style: { width: SESSION_CARD_W, height: SESSION_CARD_H },
+      data: {
+        sessionId,
+        title: title ?? "",
+        emoji: "💬",
+        projectName: "",
+        messageCount: 0,
+        lastReply: "",
+        phase: "idle",
+        runningMs: 0,
+        endedAt: 0,
+        lastActivityAt: 0,
+        stale: false,
+        expanded: false,
+        // cwd 必须留空：非空在 reconcile 语义里 = 「新会话卡（会话未创建）」
+        cwd: "",
+        taskId: "",
+        w: SESSION_CARD_W,
+        h: SESSION_CARD_H,
+        expandedW: 0,
+        expandedH: 0,
+        collapsedW: 0,
+        collapsedH: 0,
+      },
+    });
+    added = true;
+  });
+  return added;
+}
+
 /**
  * fork 后精准触发：源会话归属任务 → reconcile 该任务看板（fork 卡即时出现）。
  * 源会话不归属任何任务（普通看板）→ 无操作。单板 reconcile，毫秒级；

package/lib/board-store.test.mjs

@@ -47,9 +47,9 @@ test("schema version reaches latest with board tables", () => {
     .prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'boards'")
     .all();
   assert.equal(boards.length, 1);
-  assert.equal(SCHEMA_VERSION, 11);
+  assert.equal(SCHEMA_VERSION, 12); // v12: session_meta.last_reply
   const row = db.prepare("PRAGMA user_version").get();
-  assert.equal(row.user_version, 11);
+  assert.equal(row.user_version, SCHEMA_VERSION);
   // v5 迁移：boards.task_id 列存在
   const cols = db.prepare("PRAGMA table_info(boards)").all().map((c) => c.name);
   assert.ok(cols.includes("task_id"));