@allbluecn/web-app 0.21.0 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allbluecn/web-app",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "license": "AGPL-3.0-or-later",
   "type": "module",
   "files": [
@@ -60,8 +60,8 @@
   "dependencies": {
     "@ag-ui/core": "1.0.0",
     "@allbluecn/collab-core": "0.2.0",
-    "@allbluecn/database": "0.10.1",
-    "@allbluecn/kernel": "0.11.0",
+    "@allbluecn/database": "0.11.0",
+    "@allbluecn/kernel": "0.12.0",
     "@ariakit/react": "^0.4.28",
     "@auth/core": "^0.41.2",
     "@auth/prisma-adapter": "^2.11.2",

package/src/components/billing/__tests__/use-resource.test.tsx

@@ -20,6 +20,8 @@ const SNAPSHOTS: ResourceSnapshots = {
   sandboxMinutesMonthly: { limit: 'unlimited', usage: 0 },
   mediaGenerationsMonthly: { limit: 100, usage: 5 },
   galleryStorageMb: { limit: 500, usage: 50 },
+  installQuota: { limit: 'unlimited' as const, usage: 0 },
+  blobStorageMb: { limit: 'unlimited' as const, usage: 0 },
 }
 
 function setup(resources: ResourceSnapshots | null, loading = false) {

package/src/components/billing/subscription-provider.tsx

@@ -24,6 +24,8 @@ const DEFAULT_OSS_RESOURCES: ResourceSnapshots = {
   sandboxMinutesMonthly: { limit: 'unlimited', usage: 0 },
   mediaGenerationsMonthly: { limit: 0, usage: 0 },
   galleryStorageMb: { limit: 0, usage: 0 },
+  installQuota: { limit: 'unlimited', usage: 0 },
+  blobStorageMb: { limit: 'unlimited', usage: 0 },
 }
 
 function buildOssFallback(): PlanState {

package/src/components/bug/create-bug-dialog.tsx

@@ -301,7 +301,7 @@ export function CreateBugDialog({
                 onChange={setAssigneeId}
                 variant="button"
               />
-              <LabelsEditor labelIds={labelIds} labels={labels} onChange={setLabelIds} variant="button" />
+              <LabelsEditor projectId={projectId} labelIds={labelIds} labels={labels} onChange={setLabelIds} variant="button" />
             </div>
 
             <div className="space-y-2">

package/src/components/bug/detail/props-section.tsx

@@ -342,6 +342,7 @@ export function PropsSection({ bug, users, labels, onBugUpdate, onStoryChange, c
         </PropertyRow>
         <PropertyRow label={m.bug_detail_labels()}>
           <LabelsEditor
+            projectId={bug.projectId}
             labelIds={bug.labels.map((l) => l.id)}
             labels={labels}
             onChange={(labelIds) => void updateField({ labelIds })}

package/src/components/bug/inline-editors/labels-editor.tsx

@@ -23,6 +23,8 @@ import { InlineTrigger } from "./inline-trigger";
 import { m } from "@/paraglide/messages.js";
 
 interface LabelsEditorProps {
+  /** S24：标签归属项目（创建必挂；本组件仅勾选既有标签，不触发创建）。 */
+  projectId?: string;
   labelIds: string[];
   labels: { id: string; name: string; color: string }[];
   onChange: (labelIds: string[]) => void;
@@ -31,7 +33,8 @@ interface LabelsEditorProps {
   variant?: "chip" | "button";
 }
 
-export function LabelsEditor({ labelIds, labels, onChange, className, variant = "chip" }: LabelsEditorProps) {
+export function LabelsEditor({ projectId, labelIds, labels, onChange, className, variant = "chip" }: LabelsEditorProps) {
+  void projectId;
   const [open, setOpen] = useState(false);
   const showChip = variant === "chip";
 

package/src/components/bug/views/bug-list/batch-toolbar.tsx

@@ -48,6 +48,9 @@ export interface BugBatchToolbarProps {
   selectedIds: string[];
   users: UserBrief[];
   labels: { id: string; name: string; color: string }[];
+  /** S24：批量场景无单一项目归属（全部项目 scope）时缺省——新建标签会被
+   * 服务端拒绝（标签必挂项目），勾选既有标签不受影响 */
+  projectId?: string;
   onToggleAll: () => void;
   onArchive: (bugIds: string[]) => void;
   onDelete: (bugIds: string[]) => void;
@@ -68,7 +71,7 @@ export function BugBatchToolbar({
   onDelete,
   onBulkUpdate,
   onClearSelection,
-}: BugBatchToolbarProps) {
+  projectId,}: BugBatchToolbarProps) {
   const [archiveOpen, setArchiveOpen] = useState(false);
   const [deleteOpen, setDeleteOpen] = useState(false);
 
@@ -93,7 +96,7 @@ export function BugBatchToolbar({
           <StateEditor value="open" onChange={(v) => onBulkUpdate({ state: v })} variant="button" />
           <SeverityEditor value="medium" onChange={(v) => onBulkUpdate({ severity: v })} variant="button" />
           <AssigneeEditor assignee={null} users={users} onChange={(v) => onBulkUpdate({ assigneeId: v })} variant="button" />
-          <LabelsEditor labelIds={[]} labels={labels} onChange={(v) => onBulkUpdate({ labelIds: v })} variant="button" />
+          <LabelsEditor projectId={projectId ?? ""} labelIds={[]} labels={labels} onChange={(v) => onBulkUpdate({ labelIds: v })} variant="button" />
         </div>
       </BatchToolbarShell>
 

package/src/components/bug/views/bug-list/inline-bug-creator.tsx

@@ -108,7 +108,7 @@ export const InlineBugCreator = memo(function InlineBugCreator({
       <SeverityEditor value={severity} onChange={setSeverity} variant="button" />
       <StateEditor value={state} onChange={setState} variant="button" />
       <AssigneeEditor assignee={users.find((u) => u.id === assigneeId) ?? null} users={users} onChange={setAssigneeId} variant="button" />
-      <LabelsEditor labelIds={labelIds} labels={labels} onChange={setLabelIds} variant="button" />
+      <LabelsEditor projectId={projectId} labelIds={labelIds} labels={labels} onChange={setLabelIds} variant="button" />
       <Button
         variant="ghost"
         size="icon-xs"

package/src/components/bug/views/bug-list/row.tsx

@@ -167,7 +167,7 @@ export const BugListRow = memo(function BugListRow({ bug, users, labels, propert
         <AssigneeEditor assignee={bug.assignee} users={users} onChange={setAssignee} variant="button" />
       )}
       {properties.includes("labels") && (
-        <LabelsEditor labelIds={currentLabelIds} labels={labels} onChange={setLabels} variant="button" />
+        <LabelsEditor projectId={bug.projectId} labelIds={currentLabelIds} labels={labels} onChange={setLabels} variant="button" />
       )}
       {properties.includes("source") && (
         <span className={cn("inline-flex shrink-0 items-center rounded-sm border border-border px-1.5 py-0.5 text-xs", SOURCE_COLOR[bug.source]?.split(" ").find((c) => c.startsWith("text")))}>

package/src/components/design/editor/dashboard/design-dashboard.tsx

@@ -28,15 +28,29 @@ import { LayoutPanelTopIcon } from "@/components/shared-kit/layout/layout-panel-
 import { ConfirmDialog } from "@/components/confirm-dialog";
 import { toast } from "@/components/ui/toast";
 import { CreateDesignDialog } from "./create-design-dialog";
-import { ICON_MAP, type Design } from "@allbluecn/kernel";
+import type { Design } from "@allbluecn/kernel";
+import type { ComponentType } from "react";
+// S20：ICON_MAP 副本（同 design-navigation；kernel 下一 minor 移除导出）。
+// 键清单须与 kernel contract/types/design.ts ICON_MAP 保持一致。
+const ICON_MAP: Record<string, ComponentType<{ className?: string }>> = {
+  folder: Folder, file: FileText, chart: BarChart3, users: Users, settings: SettingsIcon,
+  package: Package, database: Database, cart: ShoppingCart, heart: Heart, sparkles: Sparkles,
+  link: LinkIcon, message: MessageSquare, calendar: Calendar, bell: Bell, building2: Building2,
+  squareChartGantt: SquareChartGantt, heartHandshake: HeartHandshake, shrimp: Shrimp,
+  fish: Fish, venetianMask: VenetianMask, graduationCap: GraduationCap, handFist: HandFist,
+  loaderPinwheel: LoaderPinwheel, toolCase: ToolCase, partyPopper: PartyPopper,
+  pencilRuler: PencilRuler, circleStar: CircleStar, brain: Brain, badgeDollarSign: BadgeDollarSign,
+  earth: Earth, music4: Music4,
+};
 import { listDesignsFn, deleteDesignFn } from "@/server/serverFns/design/designs";
 import {
-  Clock,
-  FileText,
-  LoaderPinwheel,
-  Plus,
-  Search,
-  Trash2,
+  Clock, FileText, LoaderPinwheel, Plus, Search, Trash2,
+  Folder, BarChart3, Users, Settings as SettingsIcon,
+  Package, Database, ShoppingCart, Heart, Sparkles, Link as LinkIcon,
+  MessageSquare, Calendar, Bell, Building2, SquareChartGantt,
+  HeartHandshake, Shrimp, Fish, VenetianMask, GraduationCap,
+  HandFist, ToolCase, PartyPopper, PencilRuler,
+  CircleStar, Brain, BadgeDollarSign, Earth, Music4,
 } from "lucide-react";
 import { formatDate } from "@/lib/datetime";
 import { useTimezone } from "@/components/shared-kit/timezone/timezone-provider";

package/src/components/design/editor/layout/design-navigation.tsx

@@ -32,20 +32,30 @@ import {
 } from "@/components/ui/dropdown-menu";
 import { NameConfirmDialog } from "@/components/shared-kit/dialogs/name-confirm-dialog";
 import { useRouter } from "@tanstack/react-router";
-import { ICON_MAP, type Design } from "@allbluecn/kernel";
+import type { Design } from "@allbluecn/kernel";
+import type { ComponentType } from "react";
+// S20（两步走第一步）：ICON_MAP 副本落 web——kernel 下一 minor 移除导出
+// （Pro web-saas 镜像同步后）。键清单须与 kernel contract/types/design.ts
+// ICON_MAP 保持一致（39 键）。
+const ICON_MAP: Record<string, ComponentType<{ className?: string }>> = {
+  folder: Folder, file: FileText, chart: BarChart3, users: Users, settings: SettingsIcon,
+  package: Package, database: Database, cart: ShoppingCart, heart: Heart, sparkles: Sparkles,
+  link: LinkIcon, message: MessageSquare, calendar: Calendar, bell: Bell, building2: Building2,
+  squareChartGantt: SquareChartGantt, heartHandshake: HeartHandshake, shrimp: Shrimp,
+  fish: Fish, venetianMask: VenetianMask, graduationCap: GraduationCap, handFist: HandFist,
+  loaderPinwheel: LoaderPinwheel, toolCase: ToolCase, partyPopper: PartyPopper,
+  pencilRuler: PencilRuler, circleStar: CircleStar, brain: Brain, badgeDollarSign: BadgeDollarSign,
+  earth: Earth, music4: Music4,
+};
 import { deleteDesignFn } from "@/server/serverFns/design/designs";
 import {
-  Share2,
-  History,
-  Download,
-  Save,
-  Pencil,
-  Check,
-  X,
-  FileText,
-  Settings as SettingsIcon,
-  Trash2,
-  MoreVertical,
+  Share2, History, Download, Save, Pencil, Check, X, FileText,
+  Settings as SettingsIcon, Trash2, MoreVertical,
+  Folder, BarChart3, Users, Package, Database, ShoppingCart, Heart,
+  Sparkles, Link as LinkIcon, MessageSquare, Calendar, Bell, Building2,
+  SquareChartGantt, HeartHandshake, Shrimp, Fish, VenetianMask,
+  GraduationCap, HandFist, LoaderPinwheel, ToolCase, PartyPopper,
+  PencilRuler, CircleStar, Brain, BadgeDollarSign, Earth, Music4,
 } from "lucide-react";
 interface DesignNavigationProps {
   prd: Design;

package/src/components/harness/dock/dock-panel-container.tsx

@@ -16,7 +16,7 @@
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
 
-import { useEffect, useSyncExternalStore } from "react"
+import { useEffect, useRef, useSyncExternalStore } from "react"
 import { ListTodo, Puzzle, FileText, X } from "lucide-react"
 import { Button } from "@/components/ui/button"
 import { TodoPanel } from "@/components/harness/todo-panel"
@@ -26,6 +26,16 @@ import { parseResourceUri } from "./resource-uri"
 import { ResourcePreview } from "./resource-preview"
 import { m } from "@/paraglide/messages.js"
 
+/**
+ * S28（裁决：最小实现）接线语义：
+ * - TodoPanel：消息源 = harness 会话真实消息（chatMessagesRef 透传，非占位 []）；
+ * - PluginPanel：onClose = 关闭自身 tab（此前 no-op，用户无关闭入口——tab 条
+ *   上的 X 关闭的是整个 tab 但面板内按钮空转）。
+ * 待上游扩展（不阻塞）：todo 的跨会话持久化（当前随会话消息投影）。
+ */
+type ChatMessageLike = import("@/components/harness/use-todo-projection").TodoMessageLike;
+type TodoMessageSource = ChatMessageLike[];
+
 function PlaceholderTab() {
   return (
     <div className="flex h-full items-center justify-center p-4 text-sm text-muted-foreground">
@@ -34,22 +44,25 @@ function PlaceholderTab() {
   )
 }
 
-export function DockPanelContainer() {
+export function DockPanelContainer({ chatMessages }: { chatMessages?: ChatMessageLike[] }) {
   const state = useSyncExternalStore(
     (onChange) => dockRegistry.subscribe(onChange),
     () => dockRegistry.getState(),
   )
+  // ref 保新值：registry render 闭包捕获 container 的 props 引用即可
+  const chatMessagesRef = useRef<readonly ChatMessageLike[]>(chatMessages ?? [])
+  chatMessagesRef.current = chatMessages ?? []
 
   useEffect(() => {
     dockRegistry.registerPanel({
       id: "todo",
       title: m.harness_dock_todo(),
-      render: () => <TodoPanel messages={[]} />,
+      render: () => <TodoPanel messages={[...chatMessagesRef.current]} />,
     })
     dockRegistry.registerPanel({
       id: "plugin",
       title: m.harness_dock_plugin(),
-      render: () => <PluginPanel onClose={() => {}} />,
+      render: () => <PluginPanel onClose={() => dockRegistry.closeTab("plugin")} />,
     })
     // 卸载时注销面板，避免模块级 registry 永久残留
     return () => {

package/src/components/harness/harness-workbench-page.tsx

@@ -239,6 +239,11 @@ export default function HarnessWorkbenchPage({ initialThreadId, initialMessages
 
   const mediaPanelRef = useRef({ mediaRoute, threadId: activeConversationId })
   mediaPanelRef.current = { mediaRoute, threadId: activeConversationId }
+  // S28（裁决：最小实现）：TodoPanel 真实消息源——chat.messages 经 ref 透传
+  // 给 dock（registry render 闭包稳定，ref 保新值，避免 panel 注册随消息刷新）
+  // UIMessage 结构兼容 TodoPanel 的 TodoMessageLike 投影面（role + parts）
+  const chatMessagesRef = useRef(chat.messages)
+  chatMessagesRef.current = chat.messages
 
   useEffect(() => {
     dockRegistry.registerPanel({
@@ -573,7 +578,15 @@ export default function HarnessWorkbenchPage({ initialThreadId, initialMessages
         />
       }
       center={centerContent}
-      rail={dockOpen ? <DockPanelContainer /> : null}
+      rail={
+        dockOpen ? (
+          <DockPanelContainer
+            // UIMessage 与 TodoMessageLike 的投影面（role+parts）结构兼容；
+            // 判别联合差异在此单点 as 收窄（S28）
+            chatMessages={chatMessagesRef.current as unknown as import('@/components/harness/use-todo-projection').TodoMessageLike[]}
+          />
+        ) : null
+      }
     />
 
     <ConfirmDialog

package/src/components/harness/todo-panel.tsx

@@ -18,7 +18,7 @@
 
 import { Circle, CircleCheck, ListTodo, Loader2 } from "lucide-react";
 import { m } from "@/paraglide/messages.js";
-import { useTodoProjection, type TodoItem } from "./use-todo-projection";
+import { useTodoProjection } from "./use-todo-projection";
 
 const STATUS_ICON = {
   pending: Circle,
@@ -35,10 +35,7 @@ const STATUS_COLOR = {
 export function TodoPanel({
   messages,
 }: {
-  messages: Array<{
-    role: string;
-    parts: Array<{ type: string; toolName?: string; input?: { todos?: TodoItem[] } }>;
-  }>;
+  messages: readonly import("./use-todo-projection").TodoMessageLike[];
 }) {
   const todos = useTodoProjection(messages);
 

package/src/components/harness/use-todo-projection.ts

@@ -26,15 +26,15 @@ export interface TodoItem {
 
 export type TodoMessageLike = {
   role: string;
-  parts: Array<{
+  parts: readonly {
     type: string;
     toolName?: string;
     input?: { todos?: TodoItem[] };
-  }>;
+  }[];
 };
 
 export function useTodoProjection(
-  messages: TodoMessageLike[],
+  messages: readonly TodoMessageLike[],
 ): TodoItem[] {
   return useMemo(() => {
     for (let i = messages.length - 1; i >= 0; i--) {

package/src/components/story/ai/story-ai-panel.tsx

@@ -220,9 +220,9 @@ export function StoryAiContent({
           let finalLabelIds = item.labelIds
           if (unmatched.length > 0) {
             const createdLabels = await Promise.all(
-              unmatched.map((n) => createLabelFn({ data: { name: n } })),
+              unmatched.map((n) => createLabelFn({ data: { name: n, projectId: gen.projectId } })),
             )
-            finalLabelIds = Array.from(new Set([...item.labelIds, ...createdLabels.map((c) => c.id)]))
+            finalLabelIds = Array.from(new Set([...item.labelIds, ...createdLabels.map((c: { id: string }) => c.id)]))
           }
           const created = await createStoryFn({
             data: {

package/src/components/story/create-story-dialog.tsx

@@ -336,7 +336,7 @@ export function CreateStoryDialog({
                 <DateEditor value={field.value || null} onChange={(v) => field.handleChange(v ?? "")} label={m.story_create_dueDate()} icon={CalendarCheck} />
               )} />
               <form.Field name="labelIds" children={(field) => (
-                <LabelsEditor labelIds={field.value as string[]} labels={labels} onChange={(v) => field.handleChange(v as string[])} variant="button" aiContext={{ name: () => ((form.state.values.name as string) ?? "").trim() }} />
+                <LabelsEditor projectId={(form.state.values.projectId as string) ?? ""} labelIds={field.value as string[]} labels={labels} onChange={(v) => field.handleChange(v as string[])} variant="button" aiContext={{ name: () => ((form.state.values.name as string) ?? "").trim() }} />
               )} />
             </div>
 

package/src/components/story/detail/story-collab-gate.tsx

@@ -0,0 +1,191 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { useMemo, useRef, type ReactNode } from "react";
+import { useSession } from "@/components/shared-kit/auth/auth-client";
+import { useSelfProfileBroadcast } from "@/lib/collab/use-self-profile-broadcast";
+import type { StoryState } from "@/shared/story/constants";
+import type { StoryDetail, UserBrief, CommentWithReplies, ActivityItem, RelationsData } from "@/shared/story/types";
+import type { StoryPatch } from "../display/group-fields";
+import type { Editor } from "@tiptap/react";
+import type { NotionEditorCollabExtensions } from "@/components/tiptap/notion-like/editor-extensions";
+import type { CollabProviderHandle } from "@/lib/collab/provider";
+import { buildRoomName } from "@allbluecn/collab-core/rooms";
+import { getUserColor } from "@/lib/collab/user-color";
+import { useCollabDoc } from "@/lib/collab/use-collab-doc";
+
+// S2（纯机械拆分）：StoryCollabGate 从 story-detail-body.tsx 迁此。
+
+export interface StoryCollabRuntimeState {
+  /** 协同配置（null = 会话未就绪/协同不可用，编辑器暂不挂载协同扩展） */
+  config: NotionEditorCollabExtensions | null;
+  /** 会话是否就绪（协同配置稳定后再挂编辑器，防 caret user 半截装配） */
+  ready: boolean;
+  /** provider offline（降级单机模式，提示条 + 旧保存链路） */
+  offline: boolean;
+  /** provider connecting（建连窗口，轻提示条；窗口内 Y 是唯一写手） */
+  connecting: boolean;
+  /** 协同写手活跃（connecting/synced 均算——Y 是唯一内容源，DB 链路短路） */
+  collabActive: boolean;
+  /** room 连接句柄（字段 binding 数据源；null = 非协同/noop） */
+  handle: CollabProviderHandle | null;
+  /** 字段 editing 标记署名（session brief；null 走 binding 内 profile/clientID 降级） */
+  identity: { userId: string; name: string } | null;
+}
+
+/** 非协同分支的协同状态常量（稳定引用，行为与既有单机链路逐字一致） */
+export const NON_COLLAB_STATE: StoryCollabRuntimeState = {
+  config: null,
+  ready: true,
+  offline: false,
+  connecting: false,
+  collabActive: false,
+  handle: null,
+  identity: null,
+};
+
+interface StoryCollabGateProps {
+  storyId: string;
+  snapshot: string | null;
+  children: (state: StoryCollabRuntimeState) => ReactNode;
+}
+
+/**
+ * 协同运行时装配（条件挂载于 collab 分支，非协同路径不产生任何协同 hook
+ * 观察/连接——结构对齐任务 15 CollabDocGate）：会话 brief（caret 用户 + 字段
+ * editing 署名）+ entity room 建连/快照预水合/状态订阅。
+ */
+export function StoryCollabGate({ storyId, snapshot, children }: StoryCollabGateProps) {
+  const { data: session, isPending } = useSession();
+  const roomName = useMemo(
+    () => buildRoomName({ kind: "entity-story", storyId }),
+    [storyId],
+  );
+  const { handle, status } = useCollabDoc({ roomName, snapshot });
+  // 自身 profile 广播：字段 binding 的 identity 缺省路径（会话 pending 期间
+  // 创建 binding）读 awareness profile 兜底署名——无广播则 editing 标记降级
+  // 为 client:{clientID}（远端 pill 无名）。Story 详情无 presence 头像组，
+  // 广播在本 gate 自持（hook 自 collab-presence-header 提取复用）。
+  useSelfProfileBroadcast(handle);
+
+  const user = session?.user?.id
+    ? {
+        name: session.user.name || session.user.id,
+        color: getUserColor(session.user.id),
+      }
+    : null;
+
+  const config: NotionEditorCollabExtensions | null =
+    handle && user
+      ? {
+          ydoc: handle.doc,
+          // noop/awareness 缺失时不挂 Caret（扩展工厂按 provider 判定）
+          provider: handle.awareness ? handle : null,
+          user,
+        }
+      : null;
+
+  // I1 钉住（同任务 15）：扩展集在编辑器创建时冻结，config 一旦非空就沿用
+  // 首个非空值——防中途回落 null 时 stale 内容经仍在位的 Collaboration 插件
+  // 写进 Y 并同步给协作者（协同内容静默回滚）。
+  const pinnedConfigRef = useRef<NotionEditorCollabExtensions | null>(null);
+  if (pinnedConfigRef.current === null && config !== null) {
+    pinnedConfigRef.current = config;
+  }
+  const effectiveConfig = pinnedConfigRef.current;
+
+  // 会话就绪但拿不到 user（_nav beforeLoad 守卫下不应发生）时不进协同态：
+  // collabActive=false 让 DB 保存链路兜底，防「编辑器非 Y 绑定 + DB 短路」双失能
+  const sessionUsable = isPending || user != null;
+
+  return (
+    <>
+      {children({
+        config: effectiveConfig,
+        ready: !isPending,
+        offline: status === "offline",
+        connecting: status === "connecting",
+        collabActive: sessionUsable && status !== null && status !== "offline",
+        handle,
+        identity:
+          session?.user?.id
+            ? { userId: session.user.id, name: session.user.name || session.user.id }
+            : null,
+      })}
+    </>
+  );
+}
+
+/** 详情面板可回写视图（列表/看板乐观更新）的字段集合——与 StoryPatch 对齐。
+ *  projectId 不在其中（项目归属变更走专门的转移流程，不在此通道）。 */
+export const PATCHABLE_FIELDS = new Set<keyof StoryPatch>([
+  "name",
+  "state",
+  "priority",
+  "assigneeId",
+  "startDate",
+  "targetDate",
+]);
+
+export interface StoryDetailBodyProps {
+  story: StoryDetail;
+  users: UserBrief[];
+  comments: CommentWithReplies[];
+  activities: ActivityItem[];
+  currentUserId: string | undefined;
+  layout?: "split" | "stack";
+  identifier?: string;
+  /** 所属项目（图标 + 名称），用于在需求 ID 前展示项目归属 */
+  project?: { name: string; icon: string } | null;
+  noScroll?: boolean;
+  /** 所有标签列表 */
+  labels?: { id: string; name: string; color: string }[];
+  /** 所有需求列表（用于父需求选择） */
+  stories?: { id: string; identifier: string; name: string; state: StoryState; projectId?: string }[];
+   /** 所有项目列表（用于父需求选择） */
+   projects?: { id: string; name: string; icon: string; displayId?: string | null }[];
+   /** 迭代列表（用于迭代选择器） */
+   iterations?: import("@/server/serverFns/iteration/schemas").IterationSummary[];
+  /** 关联数据（从路由 loader 预加载） */
+  relationsData?: RelationsData;
+  onRelationsUpdate?: (next: RelationsData | ((prev: RelationsData) => RelationsData)) => void;
+  onAppendActivities?: (items: ActivityItem[]) => void;
+  onAppendComment?: (comment: CommentWithReplies) => void;
+  onRemoveComment?: (commentId: string) => void;
+  onStoryUpdate?: (s: StoryDetail) => void;
+  /** 字段落库成功后的补丁回调（PeekPanel 回写列表/看板做乐观更新） */
+  onStoryPatch?: (storyId: string, patch: StoryPatch) => void;
+  onNavigateInPanel?: (targetId: string, targetIdentifier?: string, relationKind?: "child" | "dependency") => void;
+  onOpenEntity?: (entity: import("@/components/story/entity-overlay").StoryEntityOverlay) => void;
+  /** 用例/BUG 行的面板内叠加打开（peek 传入；缺省整页跳转） */
+  /** 内嵌面板导航面包屑（在面板内跳转时替代单层 identifier 显示） */
+  breadcrumbItems?: Array<{ identifier?: string; projectId?: string; label: string; onClick?: () => void }>;
+  /** 编辑器实例就绪回调（透传 NotionDocEditor.onEditorReady；测试观察点） */
+  onEditorReady?: (editor: Editor) => void;
+  /**
+   * 协同模式（Yjs 多人协作任务 20，规格 §7.1 Story 行）：true 时 description
+   * 接 Collaboration（Y fragment 'default'）+ 字段接 useCollabFields，全部
+   * 保存通道（8s 防抖 / 失焦 / 卸载 / meta 字段 / 标签 / 父需求）短路——
+   * Y 是唯一写手；offline 降级恢复 DB 链路。缺省 false = 现有单机链路逐字保留。
+   */
+  collab?: boolean;
+  /** SSR 协同快照（loader 并行取 getCollabSnapshotFn；collab=true 时必传，null = 空文档） */
+  collabSnapshot?: string | null;
+}
+
+/** memo：顶栏滚动标题等轻量 state 翻转时，详情巨树（面板/行列表）必须整体跳过
+ * 重渲染，否则越阈一次卡几百毫秒、标题延迟出现。调用方回调需 useCallback 稳定。 */