@allbluecn/web-app 0.12.0 → 0.12.2

package/src/components/settings/ai/source/model-source-picker.tsx

@@ -0,0 +1,99 @@
+// 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 { Cloud, KeyRound, Terminal } from 'lucide-react'
+import { RadioGroup, RadioGroupItem } from '@/components/ui/radio-group'
+import { Badge } from '@/components/ui/badge'
+import { Label } from '@/components/ui/label'
+import { m } from '@/paraglide/messages.js'
+import type { AiSourceMode } from '@allbluecn/kernel'
+
+interface SourceOption {
+  id: AiSourceMode
+  icon: typeof Cloud
+  title: string
+  desc: string
+  tags: string[]
+  badge?: string
+}
+
+export interface ModelSourcePickerProps {
+  current: AiSourceMode | null
+  canHosted: boolean
+  needDesktopBadge: boolean
+  onSelect: (mode: AiSourceMode) => void
+}
+
+export function ModelSourcePicker({ current, canHosted, needDesktopBadge, onSelect }: ModelSourcePickerProps) {
+  const sources: SourceOption[] = [
+    canHosted && {
+      id: 'hosted' as const,
+      icon: Cloud,
+      title: m.settings_ai_source_hosted_title(),
+      desc: m.settings_ai_source_hosted_desc(),
+      tags: [m.settings_ai_source_hosted_tagNoKey(), m.settings_ai_source_hosted_tagBilling()],
+    },
+    {
+      id: 'local-agent' as const,
+      icon: Terminal,
+      title: m.settings_ai_source_local_title(),
+      desc: m.settings_ai_source_local_desc(),
+      tags: [m.settings_ai_source_local_tagByok(), m.settings_ai_source_local_tagLocal()],
+      badge: needDesktopBadge ? m.settings_ai_source_local_needDesktop() : undefined,
+    },
+    {
+      id: 'byok' as const,
+      icon: KeyRound,
+      title: m.settings_ai_source_byok_title(),
+      desc: m.settings_ai_source_byok_desc(),
+      tags: [m.settings_ai_source_byok_tagUrl(), m.settings_ai_source_byok_tagMulti()],
+    },
+  ].filter(Boolean) as SourceOption[]
+
+  return (
+    <RadioGroup
+      value={current ?? undefined}
+      onValueChange={(v) => onSelect(v as AiSourceMode)}
+      className="grid gap-4 lg:grid-cols-3"
+    >
+      {sources.map((s) => (
+        <div key={s.id} className="relative">
+          <RadioGroupItem value={s.id} id={`source-${s.id}`} className="peer sr-only" />
+          <Label
+            htmlFor={`source-${s.id}`}
+            className="flex h-full cursor-pointer flex-col gap-3 rounded-xl border bg-card p-6 transition-colors peer-data-[state=checked]:border-primary"
+          >
+            <div className="flex items-center justify-between">
+              <s.icon className="size-8 text-muted-foreground" />
+              {s.badge && <Badge variant="outline">{s.badge}</Badge>}
+              {current === s.id && <Badge>{m.settings_ai_source_current()}</Badge>}
+            </div>
+            <div className="space-y-1">
+              <h3 className="font-semibold">{s.title}</h3>
+              <p className="text-sm text-muted-foreground">{s.desc}</p>
+            </div>
+            <div className="mt-auto flex flex-wrap gap-1">
+              {s.tags.map((t) => (
+                <Badge key={t} variant="secondary">{t}</Badge>
+              ))}
+            </div>
+          </Label>
+        </div>
+      ))}
+    </RadioGroup>
+  )
+}

package/src/components/settings/language-selector.tsx

@@ -2,7 +2,7 @@
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/components/ui/select'
 import { useServerFn } from '@tanstack/react-start'
 import { updateLocaleFn } from '@/server/serverFns/user/update-locale'
-import { toast } from 'sonner'
+import { toast } from '@/components/ui/toast'
 import { useRouteContext } from '@tanstack/react-router'
 import { getLocale, setLocale } from '@/paraglide/runtime.js'
 import type { Locale } from '@/paraglide/runtime'
@@ -31,7 +31,7 @@ export function LanguageSelector() {
   }
 
   return (
-    <Select value={getLocale()} onValueChange={handleChange}>
+    <Select value={getLocale()} onValueChange={(v) => handleChange(v ?? '')}>
       <SelectTrigger className="w-40">
         <SelectValue />
       </SelectTrigger>

package/src/components/settings/personal-team/account/account-client.tsx

@@ -30,7 +30,7 @@ import { type AvatarConfig, getRandomConfig } from "@/components/settings/person
 import type { ShapeType } from "@allbluecn/kernel"
 import { useQueryClient } from "@tanstack/react-query"
 import { updateAvatarFn } from "@/server/serverFns/user/avatar"
-import { toast } from '@/components/ui/sonner'
+import { toast } from '@/components/ui/toast'
 import { formatDate } from "@/lib/datetime"
 import { useTimezone } from "@/providers/timezone-provider"
 import { m } from "@/paraglide/messages.js";

package/src/components/settings/personal-team/account/avatar/notion-avatar-editor.tsx

@@ -104,9 +104,7 @@ function PalettePopover({ bgColor, bgShape, onBgColorChange, onBgShapeChange }:
         <div className="flex gap-2">
           {(Object.keys(SHAPE_KEYS) as ShapeType[]).map((opt) => (
             <Tooltip key={opt}>
-              <TooltipTrigger asChild>
-                <button
-                  type="button"
+              <TooltipTrigger render={<button type="button"
                   className={`size-7 px-2 transition-all ${opt === "circle"
                       ? "rounded-full"
                       : opt === "rounded"
@@ -119,9 +117,7 @@ function PalettePopover({ bgColor, bgShape, onBgColorChange, onBgShapeChange }:
                       ? (bgColor === "#fff" ? "0 0 0 2px #000" : "0 0 0 2px rgba(0,0,0)")
                       : (bgColor === "#fff" ? "0 0 0 2px #d4d4d4" : "none"),
                   }}
-                  onClick={() => onBgShapeChange(opt)}
-                />
-              </TooltipTrigger>
+                  onClick={() => onBgShapeChange(opt)} />}></TooltipTrigger>
               <TooltipContent>{SHAPE_KEYS[opt]()}</TooltipContent>
             </Tooltip>
           ))}
@@ -317,7 +313,7 @@ export default function NotionAvatarEditor({
       </div>
 
       <Dialog open={open} onOpenChange={(v) => { if (!v) handleCancel() }}>
-        <DialogContent className="sm:max-w-3xl flex flex-col transition-[height] duration-200" style={{ height: showBgPicker ? '75vh' : '64vh' }} onOpenAutoFocus={(e) => e.preventDefault()}>
+        <DialogContent className="sm:max-w-3xl flex flex-col transition-[height] duration-200" style={{ height: showBgPicker ? '75vh' : '64vh' }} initialFocus={false}>
         <DialogHeader className="shrink-0">
           <DialogTitle>{m.settings_avatar_editTitle()}</DialogTitle>
           <DialogDescription>{m.settings_avatar_editDescription()}</DialogDescription>
@@ -345,40 +341,30 @@ export default function NotionAvatarEditor({
 
             <div className="flex items-center gap-1.5">
               <Tooltip>
-                <TooltipTrigger asChild>
-                  <Button variant="outline" size="icon" className="size-9" onClick={handleRandom}>
+                <TooltipTrigger render={<Button variant="outline" size="icon" className="size-9" onClick={handleRandom} />}>
                     <Shuffle className="size-4" />
-                  </Button>
-                </TooltipTrigger>
+                  </TooltipTrigger>
                 <TooltipContent>{m.settings_avatar_random()}</TooltipContent>
               </Tooltip>
               <Tooltip>
-                <TooltipTrigger asChild>
-                  <Button variant="outline" size="icon" className="size-9" onClick={() => setFlipped(!flipped)}>
+                <TooltipTrigger render={<Button variant="outline" size="icon" className="size-9" onClick={() => setFlipped(!flipped)} />}>
                     <FlipHorizontal2 className="size-4" />
-                  </Button>
-                </TooltipTrigger>
+                  </TooltipTrigger>
                 <TooltipContent>{m.settings_avatar_flip()}</TooltipContent>
               </Tooltip>
               <Tooltip>
-                <TooltipTrigger asChild>
-                  <Button
-                    variant={showBgPicker ? "default" : "outline"}
+                <TooltipTrigger render={<Button variant={showBgPicker ? "default" : "outline"}
                     size="icon"
                     className="size-9"
-                    onClick={() => { setShowBgPicker(!showBgPicker); setActivePart("face") }}
-                  >
+                    onClick={() => { setShowBgPicker(!showBgPicker); setActivePart("face") }} />}>
                     <Palette className="size-4" />
-                  </Button>
-                </TooltipTrigger>
+                  </TooltipTrigger>
                 <TooltipContent>{m.settings_avatar_bgColor()}</TooltipContent>
               </Tooltip>
               <Tooltip>
-                <TooltipTrigger asChild>
-                  <Button variant="outline" size="icon" className="size-9" onClick={handleReset}>
+                <TooltipTrigger render={<Button variant="outline" size="icon" className="size-9" onClick={handleReset} />}>
                     <RotateCcw className="size-4" />
-                  </Button>
-                </TooltipTrigger>
+                  </TooltipTrigger>
                 <TooltipContent>{m.settings_avatar_reset()}</TooltipContent>
               </Tooltip>
             </div>

package/src/components/settings/personal-team/account/settings-profile.tsx

@@ -23,7 +23,7 @@ import { useQuery } from "@tanstack/react-query"
 import { cn } from "@/lib/utils";
 import { Button } from "@/components/ui/button";
 import { Alert, AlertDescription, AlertTitle } from "@/components/ui/alert";
-import { toast } from "@/components/ui/sonner";
+import { toast } from "@/components/ui/toast";
 import {
   Card,
   CardContent,

package/src/components/settings/personal-team/team/team-client.tsx

@@ -17,7 +17,7 @@
 
 import { useState, useEffect } from "react"
 import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query"
-import { toast } from "sonner"
+import { toast } from "@/components/ui/toast"
 import { useResource } from "@/components/billing/use-resource"
 import {
   listTeamMembersFn,

package/src/components/settings/personal-team/team/team-invitations.tsx

@@ -424,8 +424,8 @@ export default function TeamInvitations({
                   </div>
                   <div className="flex items-center gap-2">
                     <Select
-                      onValueChange={(value: string) =>
-                        setLinkExpires(Number.parseInt(value))
+                      onValueChange={(value) =>
+                        setLinkExpires(Number.parseInt(value ?? ""))
                       }
                       value={linkExpires.toString()}
                     >
@@ -548,8 +548,8 @@ export default function TeamInvitations({
                 <Field className="w-full flex-1 xl:w-28 xl:flex-[1] shrink-0">
                   <FieldContent>
                     <Select
-                      onValueChange={(value: "admin" | "member" | "viewer") =>
-                        setEmailRole(value)
+                      onValueChange={(value) =>
+                        setEmailRole((value ?? "member") as "admin" | "member" | "viewer")
                       }
                       value={emailRole}
                     >
@@ -574,8 +574,8 @@ export default function TeamInvitations({
                 <Field className="w-full flex-1 xl:w-28 xl:flex-[1] shrink-0">
                   <FieldContent>
                     <Select
-                      onValueChange={(value: string) =>
-                        setEmailExpires(Number.parseInt(value))
+                      onValueChange={(value) =>
+                        setEmailExpires(Number.parseInt(value ?? ""))
                       }
                       value={emailExpires.toString()}
                     >
@@ -750,8 +750,8 @@ export default function TeamInvitations({
                           <div className="hidden xl:flex items-center gap-2">
                             <Select
                               value={approveRoles[invitation.id] ?? "member"}
-                              onValueChange={(value: "admin" | "member" | "viewer") =>
-                                setApproveRoles((prev) => ({ ...prev, [invitation.id]: value }))
+                              onValueChange={(value) =>
+                                setApproveRoles((prev) => ({ ...prev, [invitation.id]: (value ?? "member") as "admin" | "member" | "viewer" }))
                               }
                             >
                               <SelectTrigger className="h-8 w-24" size="sm">
@@ -785,19 +785,14 @@ export default function TeamInvitations({
                               {m.settings_team_invite_approve()}
                             </Button>
                             <DropdownMenu>
-                              <DropdownMenuTrigger asChild>
-                                <Button
-                                  aria-label="More options"
+                              <DropdownMenuTrigger render={<Button aria-label="More options"
                                   size="icon"
                                   type="button"
-                                  variant="ghost"
-                                >
+                                  variant="ghost" />}>
                                   <X className="size-4" />
-                                </Button>
-                              </DropdownMenuTrigger>
+                                </DropdownMenuTrigger>
                               <DropdownMenuContent
                                 align="end"
-                                collisionPadding={8}
                                 sideOffset={4}
                               >
                                 <DropdownMenuItem
@@ -838,23 +833,18 @@ export default function TeamInvitations({
                           if (!canResend && !canRevoke && !canDelete) return null
                           return (
                             <DropdownMenu>
-                              <DropdownMenuTrigger asChild>
-                                <Button
-                                  aria-label="More options"
+                              <DropdownMenuTrigger render={<Button aria-label="More options"
                                   size="icon"
                                   type="button"
-                                  variant="ghost"
-                                >
+                                  variant="ghost" />}>
                                   {actionLoading === invitation.id ? (
                                     <Loader2 className="size-4 animate-spin" />
                                   ) : (
                                     <X className="size-4" />
                                   )}
-                                </Button>
-                              </DropdownMenuTrigger>
+                                </DropdownMenuTrigger>
                               <DropdownMenuContent
                                 align="end"
-                                collisionPadding={8}
                                 sideOffset={4}
                               >
                                 {canResend && (
@@ -916,8 +906,8 @@ export default function TeamInvitations({
                         <div className="xl:hidden flex justify-end items-center gap-2">
                           <Select
                             value={approveRoles[invitation.id] ?? "member"}
-                           onValueChange={(value: "admin" | "member" | "viewer") =>
-                             setApproveRoles((prev) => ({ ...prev, [invitation.id]: value }))
+                           onValueChange={(value) =>
+                             setApproveRoles((prev) => ({ ...prev, [invitation.id]: (value ?? "member") as "admin" | "member" | "viewer" }))
                            }
                          >
                            <SelectTrigger className="h-8 w-24" size="sm">
@@ -951,19 +941,14 @@ export default function TeamInvitations({
                             {m.settings_team_invite_approve()}
                           </Button>
                           <DropdownMenu>
-                            <DropdownMenuTrigger asChild>
-                              <Button
-                                aria-label="More options"
+                            <DropdownMenuTrigger render={<Button aria-label="More options"
                                 size="icon"
                                 type="button"
-                                variant="ghost"
-                              >
+                                variant="ghost" />}>
                                 <X className="size-4" />
-                              </Button>
-                            </DropdownMenuTrigger>
+                              </DropdownMenuTrigger>
                             <DropdownMenuContent
                               align="end"
-                              collisionPadding={8}
                               sideOffset={4}
                             >
                               <DropdownMenuItem

package/src/components/settings/personal-team/team/team-member-list.tsx

@@ -232,7 +232,7 @@ export default function TeamMemberList({
           )}
           {showFilters && (
             <div className="flex flex-wrap gap-2">
-              <Select onValueChange={setRoleFilter} value={roleFilter}>
+              <Select onValueChange={(v) => setRoleFilter(v ?? "")} value={roleFilter}>
                 <SelectTrigger className="w-full md:w-[140px]">
                   <SelectValue placeholder={m.settings_team_allRoles()} />
                 </SelectTrigger>
@@ -245,7 +245,7 @@ export default function TeamMemberList({
                   <SelectItem value="guest">{m.settings_team_role_guest()}</SelectItem>
                 </SelectContent>
               </Select>
-              <Select onValueChange={setStatusFilter} value={statusFilter}>
+              <Select onValueChange={(v) => setStatusFilter(v ?? "")} value={statusFilter}>
                 <SelectTrigger className="w-full md:w-[140px]">
                   <SelectValue placeholder={m.settings_team_allStatuses()} />
                 </SelectTrigger>
@@ -364,23 +364,18 @@ export default function TeamMemberList({
                     </div>
                     {canModify && (
                       <DropdownMenu>
-                        <DropdownMenuTrigger asChild>
-                          <Button
-                            aria-label={m.settings_team_moreActions()}
+                        <DropdownMenuTrigger render={<Button aria-label={m.settings_team_moreActions()}
                             size="icon"
                             type="button"
-                            variant="ghost"
-                          >
+                            variant="ghost" />}>
                             {actionLoading === member.id ? (
                               <Loader2 className="size-4 animate-spin" />
                             ) : (
                               <MoreVertical className="size-4" />
                             )}
-                          </Button>
-                        </DropdownMenuTrigger>
+                          </DropdownMenuTrigger>
                         <DropdownMenuContent
                           align="end"
-                          collisionPadding={8}
                           sideOffset={4}
                         >
                           {member.role === "member" && onPromote && (

package/src/components/shadcn-space/blocks/faq-01/faq.tsx

@@ -69,7 +69,7 @@ export default function Faq() {
           </h2>
         </div>
         <div>
-          <Accordion type="single" className="w-full flex flex-col gap-6">
+          <Accordion className="w-full flex flex-col gap-6">
             {FAQ_DATA.map((faq, index) => (
               <AccordionItem
                 key={`item-${index}`}

package/src/components/shadcn-space/blocks/hero-01/header.tsx

@@ -22,7 +22,6 @@ import { NavigationMenu, NavigationMenuItem, NavigationMenuLink, NavigationMenuL
 import { cn } from "@/lib/utils";
 import { Menu, X } from 'lucide-react';
 import { Icon } from "@iconify/react";
-import Logo from "@/assets/logo/logo";
 import { Button } from "@/components/ui/button";
 import { m } from "motion/react";
 import { InteractiveHoverButton } from "@/components/magicui/interactive-hover-button";
@@ -127,7 +126,16 @@ const Header = ({ navigationData, className }: HeaderProps) => {
         {/* Logo */}
         <div>
           <a href="#">
-            <Logo className="gap-3" />
+            <img
+              src="/logo/allblue-logo-text-dark.svg"
+              alt="AllBlue"
+              className="h-6 dark:hidden"
+            />
+            <img
+              src="/logo/allblue-logo-text-light.svg"
+              alt="AllBlue"
+              className="hidden h-6 dark:block"
+            />
           </a>
         </div>
 
@@ -172,7 +180,16 @@ const Header = ({ navigationData, className }: HeaderProps) => {
               >
                 <div className="flex items-center justify-between p-6">
                   <a href="#">
-                    <Logo className="gap-2" />
+                    <img
+                      src="/logo/allblue-logo-text-dark.svg"
+                      alt="AllBlue"
+                      className="h-5 dark:hidden"
+                    />
+                    <img
+                      src="/logo/allblue-logo-text-light.svg"
+                      alt="AllBlue"
+                      className="hidden h-5 dark:block"
+                    />
                   </a>
                   <SheetClose id="mobile-menu-close">
                     <span className="rounded-full border border-border p-2.5 block">

package/src/components/shared-kit/__tests__/ask-ai-entry-button.test.tsx

@@ -0,0 +1,103 @@
+// 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 { beforeEach, describe, expect, it, vi } from "vitest";
+import { fireEvent, render, screen, waitFor } from "@testing-library/react";
+
+const mocks = vi.hoisted(() => ({ start: vi.fn(), navigate: vi.fn() }));
+vi.mock("@/lib/ai/chat-handoff", () => ({
+  startHandoffWithContext: mocks.start,
+}));
+vi.mock("@tanstack/react-router", () => ({
+  useNavigate: () => mocks.navigate,
+}));
+vi.mock("@/components/hextaui/ai-suggested-prompts", () => ({
+  default: ({
+    categories,
+    onSelect,
+    prompts,
+  }: {
+    categories?: string[];
+    onSelect?: (p: { prompt: string }) => void;
+    prompts?: { category?: string; id: string; prompt: string; title: string }[];
+  }) => {
+    const filtered = prompts?.filter(
+      (p) => (categories?.length ? categories.includes(p.category!) : true),
+    ) ?? [];
+    return filtered.length ? (
+      <button onClick={() => onSelect?.({ prompt: filtered[0].prompt })}>
+        {filtered[0].prompt}
+      </button>
+    ) : (
+      <div data-testid="empty">No prompts</div>
+    );
+  },
+}));
+import AskAiEntryButton from "../ask-ai-entry-button";
+
+describe("AskAiEntryButton", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("点击入口 → 选择提示词 → 两参 handoff + navigate('/harness')", async () => {
+    render(
+      <AskAiEntryButton
+        board="dashboard"
+        entityId="u-1"
+        prompts={[{ id: "1", title: "T", prompt: "P1", category: "C" }]}
+      />,
+    );
+    fireEvent.click(screen.getByRole("button"));
+    fireEvent.click(await screen.findByText("P1"));
+    await waitFor(() =>
+      expect(mocks.start).toHaveBeenCalledWith("P1", {
+        board: "dashboard",
+        entityId: "u-1",
+      }),
+    );
+    expect(mocks.navigate).toHaveBeenCalledWith({ to: "/harness" });
+  });
+
+  it("categories 与所有 prompt 均不匹配 → Popover 内空态且 handoff 不可达", async () => {
+    render(
+      <AskAiEntryButton
+        board="dashboard"
+        entityId="u-1"
+        categories={["X"]}
+        prompts={[{ id: "1", title: "T", prompt: "P1", category: "C" }]}
+      />,
+    );
+    fireEvent.click(screen.getByRole("button"));
+    expect(await screen.findByTestId("empty")).toBeTruthy();
+    expect(mocks.start).not.toHaveBeenCalled();
+  });
+
+  it("entityId 为空白 → 入口按钮置灰禁用", () => {
+    render(
+      <AskAiEntryButton
+        board="dashboard"
+        entityId="  "
+        prompts={[{ id: "1", title: "T", prompt: "P1", category: "C" }]}
+      />,
+    );
+    expect(
+      (screen.getByRole("button") as HTMLButtonElement).disabled,
+    ).toBe(true);
+    expect(mocks.start).not.toHaveBeenCalled();
+  });
+});

package/src/components/shared-kit/ask-ai-entry-button.tsx

@@ -0,0 +1,80 @@
+// 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/>.
+
+"use client";
+
+import { useState } from "react";
+import { Sparkles } from "lucide-react";
+import { useNavigate } from "@tanstack/react-router";
+import { Button } from "@/components/ui/button";
+import {
+  Popover,
+  PopoverContent,
+  PopoverTrigger,
+} from "@/components/ui/popover";
+import AISuggestedPrompts, {
+  type SuggestedPrompt,
+} from "@/components/hextaui/ai-suggested-prompts";
+import { startHandoffWithContext } from "@/lib/ai/chat-handoff";
+import { m } from "@/paraglide/messages.js";
+
+interface AskAiEntryButtonProps {
+  board: string;
+  entityId: string;
+  prompts: SuggestedPrompt[];
+  categories?: string[];
+  className?: string;
+}
+
+/** 板块「问 AI」统一入口（P4e ①，ADR 40）：Popover 建议弹窗 + 两参 handoff + navigate。 */
+export function AskAiEntryButton({
+  board,
+  entityId,
+  prompts,
+  categories,
+  className,
+}: AskAiEntryButtonProps) {
+  const navigate = useNavigate();
+  const [open, setOpen] = useState(false);
+
+  return (
+    <Popover open={open} onOpenChange={setOpen}>
+      <PopoverTrigger render={<Button aria-label={m.story_panel_askAi()}
+          className={className}
+          disabled={!entityId.trim()}
+          size="icon"
+          variant="ghost" />}>
+          <Sparkles className="size-4" />
+        </PopoverTrigger>
+      <PopoverContent align="end" className="w-96 p-0">
+        <AISuggestedPrompts
+          categories={categories}
+          onSelect={(prompt) => {
+            startHandoffWithContext(prompt.prompt, { board, entityId });
+            setOpen(false);
+            void navigate({ to: "/harness" });
+          }}
+          prompts={prompts}
+          showCategories={!!categories}
+          showSearch={false}
+        />
+      </PopoverContent>
+    </Popover>
+  );
+}
+
+export default AskAiEntryButton;

package/src/components/shared-kit/data-viz/contribution-graph-tooltip.tsx

@@ -150,7 +150,7 @@ export function ContributionGraphWithTooltip({
             </div>
           )}
           {showFilter && (
-            <Select value={selectedFilter} onValueChange={setSelectedFilter}>
+            <Select value={selectedFilter} onValueChange={(v) => setSelectedFilter(v ?? "")}>
               <SelectTrigger className="h-8 w-28">
                 <SelectValue />
               </SelectTrigger>