docs(app): explain request and directory lifecycle boundaries

src/lib/notifications.ts

@@ -7,7 +7,8 @@
 import { toast } from "sonner";
 
 /** Application adapter. Domain/editor packages must not import Sonner. */
-/** 稳定id用于更新/关闭同一通知，level决定显示样式，description是可选补充文案。 */
+/** 稳定id用于更新/关闭同一通知，level决定显示样式，description是可选补充文案。
+ * level 的联合类型是调用约束，运行时不另行验证；调用方必须提供通知库支持的级别。 */
 export type Notification = { id: string; title: string; description?: string; level?: "info" | "success" | "warning" | "error" };
 /** 按指定level调用Sonner，默认info；相同id的合并/更新行为交给通知库。 */
 export function notify({ id, title, description, level = "info" }: Notification) {