@allbluecn/web-app 0.18.2 → 0.19.0

package/src/routes/_nav/tasks/-components/assigned-list.tsx

@@ -0,0 +1,157 @@
+// 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/>.
+
+// 「分配给我的」聚合列表（任务 9 / 接线任务 10）：按 source 三组分组（需求/Bug/
+// 测试用例）。行 = priority Badge（null 不渲染）+ identifier + title + projectName
+// + dueAt（仅 story 携带，过期红色）+ updatedAt 相对时间；主体区整块 Link 跳
+// item.href；行尾「AI 执行」按钮打开 SourceAiExecDialog（选中行状态提升到本组件，
+// 弹窗单实例挂载在列表级）。degraded 非空（桌面端 SQLite 跳过部分源表）时顶部
+// Alert 提示。
+import { useState } from "react";
+import { Link } from "@tanstack/react-router";
+import { Bug, ClipboardList, FlaskConical, Info, Sparkles, type LucideIcon } from "lucide-react";
+import { Alert, AlertDescription } from "@/components/ui/alert";
+import { Button } from "@/components/ui/button";
+import { LevelBadge } from "@/components/shared-kit/list-kit/level-badge";
+import { formatRelative, formatTimestamp, resolveTimezone } from "@/lib/datetime";
+import { cn } from "@/lib/utils";
+import { m } from "@/paraglide/messages.js";
+import type { AssignedItem, AssignedResult, TaskSource } from "@/server/ai-task/types";
+import { TASK_PRIORITY_META } from "./task-constants";
+import { SourceAiExecDialog } from "./source-ai-exec-dialog";
+
+/** 组序固定 story → bug → testcase（与查询聚合序一致）；图标随侧边导航语义
+ *  （需求 ClipboardList / Bug / 测试用例 FlaskConical），四期任务 46 组头对齐 story 形态 */
+const GROUP_ORDER: Array<{ source: TaskSource; label: () => string; icon: LucideIcon }> = [
+  { source: "story", label: m.tasks_group_story, icon: ClipboardList },
+  { source: "bug", label: m.tasks_group_bug, icon: Bug },
+  { source: "testcase", label: m.tasks_group_testcase, icon: FlaskConical },
+];
+
+function isOverdue(dueAt: string): boolean {
+  return new Date(dueAt).getTime() < Date.now();
+}
+
+function AssignedRow({ item, onExec }: { item: AssignedItem; onExec: () => void }) {
+  return (
+    <div className="group flex items-center gap-2 rounded-lg border border-transparent px-3 py-2.5 transition-colors hover:bg-muted/50">
+      {item.priority ? (
+        <LevelBadge level={item.priority} meta={TASK_PRIORITY_META} />
+      ) : null}
+      <Link
+        to={item.href}
+        className="flex min-w-0 flex-1 items-center gap-2"
+      >
+        <span className="shrink-0 font-mono text-xs text-muted-foreground">
+          {item.identifier}
+        </span>
+        <span className="truncate text-sm font-medium">{item.title}</span>
+        <span className="shrink-0 text-xs text-muted-foreground">
+          {item.projectName}
+        </span>
+        {item.dueAt ? (
+          <span
+            className={cn(
+              "shrink-0 text-xs text-muted-foreground",
+              isOverdue(item.dueAt) && "text-destructive",
+            )}
+          >
+            {formatTimestamp(item.dueAt, "yyyy-MM-dd")}
+          </span>
+        ) : null}
+        <span className="ml-auto shrink-0 text-xs text-muted-foreground">
+          {formatRelative(new Date(item.updatedAt), resolveTimezone())}
+        </span>
+      </Link>
+      <Button
+        variant="ghost"
+        size="icon-sm"
+        className="shrink-0 text-muted-foreground"
+        aria-label={m.tasks_ai_exec()}
+        onClick={onExec}
+      >
+        <Sparkles />
+      </Button>
+    </div>
+  );
+}
+
+export function AssignedList({
+  result,
+  searching = false,
+}: {
+  result: AssignedResult;
+  /** 有搜索词时空态显示「无匹配任务」而非「暂无分配给我的任务」 */
+  searching?: boolean;
+}) {
+  // 当前发起 AI 执行的行（状态提升：弹窗单实例挂列表级，行组件无弹窗状态）
+  const [execTarget, setExecTarget] = useState<AssignedItem | null>(null);
+
+  if (result.items.length === 0) {
+    return (
+      <div className="flex h-40 items-center justify-center rounded-lg border border-dashed border-border">
+        <p className="text-sm text-muted-foreground">
+          {searching ? m.tasks_empty_search() : m.tasks_empty_assigned()}
+        </p>
+      </div>
+    );
+  }
+  return (
+    <div className="flex flex-col gap-4">
+      {result.degraded.length > 0 ? (
+        <Alert>
+          <Info />
+          <AlertDescription>{m.tasks_degraded_notice()}</AlertDescription>
+        </Alert>
+      ) : null}
+      {GROUP_ORDER.map((group) => {
+        const items = result.items.filter((item) => item.source === group.source);
+        if (items.length === 0) return null;
+        return (
+          <section key={group.source} className="flex flex-col gap-1">
+            <h3 className="flex items-center gap-2 px-2 text-sm font-medium">
+              <group.icon className="size-4 shrink-0 text-muted-foreground" />
+              <span>{group.label()}</span>
+              <span className="text-xs text-muted-foreground">{items.length}</span>
+            </h3>
+            <div className="flex flex-col">
+              {items.map((item) => (
+                <AssignedRow
+                  key={item.id}
+                  item={item}
+                  onExec={() => setExecTarget(item)}
+                />
+              ))}
+            </div>
+          </section>
+        );
+      })}
+      {execTarget ? (
+        <SourceAiExecDialog
+          open
+          onOpenChange={(open) => {
+            if (!open) setExecTarget(null);
+          }}
+          sourceType={execTarget.source}
+          sourceId={execTarget.id}
+          sourceTitle={execTarget.title}
+          defaultInstruction={m.tasks_source_instruction_default()}
+        />
+      ) : null}
+    </div>
+  );
+}

package/src/routes/_nav/tasks/-components/create-ai-task-dialog.tsx

@@ -0,0 +1,228 @@
+// 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/>.
+
+// 新建 AI 任务弹窗（任务 9 / 修复轮 1 / 修复轮 2 / 最终审查修复）：表单 title（必填）
+// + instruction（必填）+ projectId（可选 Select，仅作为给 AI 的上下文提示——规格
+// §3.3；选项来自 listProjectsBriefFn，Dialog 打开时经 react-query 拉取；Base UI
+// SelectItem 带 value + 中文 label 子节点，「不关联项目」项复位为不传）。
+// 双提交路径：创建并运行（runNow: true，执行 await 完成后返回，成功 toast「任务执
+// 行已完成」）/ 保存为待办（不传 runNow，成功 toast「已保存为待办」）；成功后
+// router.invalidate() 刷新列表并关闭弹窗。列表数据来自路由 beforeLoad，invalidate
+// 重跑 loader（先例：projects 设置页）。快捷键（AGENTS 约定）：指令 Textarea 内
+// Enter（非 Shift）提交、Shift+Enter 换行（真实生效路径，非仅 form 隐式提交）；
+// 标题 Input 的原生 Enter 经 form submit 走主路径；次按钮 type="button" 点击触发。
+// 关闭兜底（任务 11 发现 A）：受控 open=false 的 Popup 卸载由 Base UI 在退出
+// 动画完成后触发；动画完成事件挂起时 Popup 滞留 DOM——onSuccess 额外安排
+// actionsRef.unmount() 延时兜底（200ms > duration-100 退出动画），保证必然关闭。
+import { useEffect, useRef, useState } from "react";
+import { useRouter } from "@tanstack/react-router";
+import { useMutation, useQuery } from "@tanstack/react-query";
+import { Button } from "@/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import { Textarea } from "@/components/ui/textarea";
+import { toast } from "@/components/ui/toast";
+import { toastError } from "@/lib/toast-error";
+import { m } from "@/paraglide/messages.js";
+import { createAiTaskFn } from "@/server/serverFns/tasks/task-crud";
+import { listProjectsBriefFn } from "@/server/serverFns/project";
+
+interface FormState {
+  title: string;
+  instruction: string;
+  /** null = 不关联（上下文提示，仅自由指令任务落库） */
+  projectId: string | null;
+}
+
+const EMPTY_FORM: FormState = { title: "", instruction: "", projectId: null };
+
+export function CreateAiTaskDialog({
+  open,
+  onOpenChange,
+}: {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+}) {
+  const router = useRouter();
+  const [form, setForm] = useState<FormState>(EMPTY_FORM);
+  // Base UI 官方命令式逃生口：受控关闭的 Popup 卸载依赖退出动画完成事件
+  // （getAnimations finished）；事件丢失时 Popup 滞留 DOM（任务 11 验收发现 A）。
+  const dialogActionsRef = useRef<{ unmount: () => void; close: () => void }>(null);
+  const forceUnmountTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  // Dialog 打开时拉项目简表（与 iterations route.lazy 同款 queryKey）
+  const { data: projects } = useQuery({
+    queryKey: ["projects-brief"],
+    queryFn: () => listProjectsBriefFn(),
+    enabled: open,
+  });
+
+  useEffect(() => {
+    if (open) {
+      setForm(EMPTY_FORM);
+      // 重新打开时取消未触发的强制卸载兜底（防误卸新弹窗）
+      if (forceUnmountTimerRef.current !== null) {
+        clearTimeout(forceUnmountTimerRef.current);
+        forceUnmountTimerRef.current = null;
+      }
+    }
+  }, [open]);
+
+  const createMutation = useMutation({
+    mutationFn: (runNow: boolean) =>
+      createAiTaskFn({
+        data: {
+          title: form.title.trim(),
+          instruction: form.instruction.trim(),
+          ...(form.projectId ? { projectId: form.projectId } : {}),
+          ...(runNow ? { runNow: true } : {}),
+        },
+      }),
+    onSuccess: (_data, runNow) => {
+      onOpenChange(false);
+      // 兜底：退出动画窗口（duration-100）过后若 Popup 仍滞留 DOM（动画完成
+      // 事件挂起），用 actionsRef.unmount 强制卸载；已卸载时为无害空操作。
+      forceUnmountTimerRef.current = setTimeout(() => {
+        forceUnmountTimerRef.current = null;
+        dialogActionsRef.current?.unmount();
+      }, 200);
+      void router.invalidate();
+      // runNow 为 await 执行完成后才返回，此 toast 是完成语义而非「已开始」
+      toast.success(runNow ? m.tasks_run_done() : m.tasks_created_backlog());
+    },
+    onError: (e) => toastError(e, m.tasks_operation_failed()),
+  });
+
+  const update = (field: keyof FormState, value: string | null) =>
+    setForm((prev) => ({ ...prev, [field]: value }));
+
+  const isValid = form.title.trim().length > 0 && form.instruction.trim().length > 0;
+  const submitting = createMutation.isPending;
+
+  const submitRunNow = () => {
+    if (!isValid || submitting) return;
+    createMutation.mutate(true);
+  };
+
+  return (
+    <Dialog
+      open={open}
+      onOpenChange={onOpenChange}
+      actionsRef={dialogActionsRef}
+    >
+      <DialogContent className="sm:max-w-md">
+        <DialogHeader>
+          <DialogTitle>{m.tasks_create_title()}</DialogTitle>
+          <DialogDescription>
+            {m.tasks_create_description()}
+          </DialogDescription>
+        </DialogHeader>
+        <form onSubmit={(e) => { e.preventDefault(); submitRunNow(); }}>
+          <div className="grid gap-4">
+            <div className="grid gap-1.5">
+              <Label htmlFor="ai-task-title">
+                {m.tasks_create_title_label()}
+                <span className="text-destructive">*</span>
+              </Label>
+              <Input
+                id="ai-task-title"
+                value={form.title}
+                maxLength={200}
+                onChange={(e) => update("title", e.target.value)}
+                placeholder={m.tasks_create_title_placeholder()}
+              />
+            </div>
+            <div className="grid gap-1.5">
+              <Label htmlFor="ai-task-instruction">
+                {m.tasks_create_instruction_label()}
+                <span className="text-destructive">*</span>
+              </Label>
+              <Textarea
+                id="ai-task-instruction"
+                value={form.instruction}
+                maxLength={8000}
+                className="min-h-24"
+                onChange={(e) => update("instruction", e.target.value)}
+                placeholder={m.tasks_create_instruction_placeholder()}
+                onKeyDown={(e) => {
+                  // Enter 提交（IME 组合中不触发，兼容中文输入法，同 create-bug-dialog）
+                  if (
+                    e.key === "Enter" &&
+                    !e.shiftKey &&
+                    !e.nativeEvent.isComposing
+                  ) {
+                    e.preventDefault();
+                    submitRunNow();
+                  }
+                }}
+              />
+            </div>
+            <div className="grid gap-1.5">
+              <Label htmlFor="ai-task-project">
+                {m.tasks_create_project_label()}
+              </Label>
+              <Select
+                value={form.projectId ?? ""}
+                onValueChange={(v) => update("projectId", v || null)}
+              >
+                <SelectTrigger id="ai-task-project" className="w-full">
+                  <SelectValue />
+                </SelectTrigger>
+                <SelectContent>
+                  <SelectItem value="">{m.tasks_create_project_none()}</SelectItem>
+                  {(projects ?? []).map((project) => (
+                    <SelectItem key={project.id} value={project.id}>
+                      {project.name}
+                    </SelectItem>
+                  ))}
+                </SelectContent>
+              </Select>
+            </div>
+          </div>
+          <DialogFooter className="mt-4 gap-2">
+            <Button
+              type="button"
+              variant="outline"
+              disabled={!isValid || submitting}
+              onClick={() => createMutation.mutate(false)}
+            >
+              {m.tasks_create_save()}
+            </Button>
+            <Button type="submit" disabled={!isValid || submitting}>
+              {m.tasks_create_run_now()}
+            </Button>
+          </DialogFooter>
+        </form>
+      </DialogContent>
+    </Dialog>
+  );
+}

package/src/routes/_nav/tasks/-components/source-ai-exec-dialog.tsx

@@ -0,0 +1,175 @@
+// 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/>.
+
+// 源型 AI 执行弹窗（任务 10 / 最终审查修复）：顶部只读摘要（类型徽章 + 源条目标题）
+// + 指令 Textarea（预填调用方传入的 defaultInstruction，可编辑）+ 双提交路径（规格
+// §3.3）：「运行」主按钮 → createAiTaskFn（sourceType/sourceId + runNow: true，标题/
+// 项目由 server 端以源条目推导；执行为 await 完成后返回，成功 toast「任务执行已完
+// 成」+ invalidate + 跳转任务详情页看结果）与「保存为待办」次按钮（不传 runNow，
+// 成功 toast「已保存为待办」留在当前页）。快捷键（AGENTS 约定）：指令 Textarea 内
+// Enter（非 Shift）提交、Shift+Enter 换行——真实生效路径，非仅 form 隐式提交。
+// TaskSource 仅 type import（编译期擦除，eslint 豁免）。
+import { useEffect, useState } from "react";
+import { useNavigate, useRouter } from "@tanstack/react-router";
+import { useMutation } from "@tanstack/react-query";
+import { Loader2 } from "lucide-react";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+import { Label } from "@/components/ui/label";
+import { Textarea } from "@/components/ui/textarea";
+import { toast } from "@/components/ui/toast";
+import { toastError } from "@/lib/toast-error";
+import { m } from "@/paraglide/messages.js";
+import type { TaskSource } from "@/server/ai-task/types";
+import { createAiTaskFn } from "@/server/serverFns/tasks/task-crud";
+
+/** sourceType → 徽章文案（与分配列表组标题共用 key） */
+const SOURCE_LABEL: Record<TaskSource, () => string> = {
+  story: m.tasks_group_story,
+  bug: m.tasks_group_bug,
+  testcase: m.tasks_group_testcase,
+};
+
+export function SourceAiExecDialog({
+  sourceType,
+  sourceId,
+  sourceTitle,
+  defaultInstruction,
+  open,
+  onOpenChange,
+}: {
+  sourceType: TaskSource;
+  sourceId: string;
+  sourceTitle: string;
+  defaultInstruction: string;
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+}) {
+  const router = useRouter();
+  const navigate = useNavigate();
+  const [instruction, setInstruction] = useState(defaultInstruction);
+
+  // 每次打开重置为模板指令（可编辑，关闭后不保留修改）
+  useEffect(() => {
+    if (open) setInstruction(defaultInstruction);
+  }, [open, defaultInstruction]);
+
+  const createMutation = useMutation({
+    mutationFn: (runNow: boolean) =>
+      createAiTaskFn({
+        data: {
+          instruction: instruction.trim(),
+          sourceType,
+          sourceId,
+          ...(runNow ? { runNow: true } : {}),
+        },
+      }),
+    onSuccess: (data, runNow) => {
+      onOpenChange(false);
+      void router.invalidate();
+      if (runNow) {
+        // runNow 为 await 执行完成后才返回，此 toast 是完成语义而非「已开始」
+        toast.success(m.tasks_run_done());
+        void navigate({ to: "/tasks/$taskId", params: { taskId: data.id } });
+      } else {
+        toast.success(m.tasks_created_backlog());
+      }
+    },
+    onError: (e) => toastError(e, m.tasks_operation_failed()),
+  });
+
+  const isValid = instruction.trim().length > 0;
+  const submitting = createMutation.isPending;
+
+  const submitRun = () => {
+    if (isValid && !submitting) createMutation.mutate(true);
+  };
+
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent className="sm:max-w-md">
+        <DialogHeader>
+          <DialogTitle>{m.tasks_ai_exec()}</DialogTitle>
+          <DialogDescription>{m.tasks_exec_description()}</DialogDescription>
+        </DialogHeader>
+        <form
+          onSubmit={(e) => {
+            e.preventDefault();
+            submitRun();
+          }}
+        >
+          <div className="grid gap-4">
+            <div className="flex items-center gap-2 rounded-lg border bg-muted/50 px-3 py-2">
+              <Badge variant="outline" className="shrink-0">
+                {SOURCE_LABEL[sourceType]()}
+              </Badge>
+              <span className="truncate text-sm font-medium">{sourceTitle}</span>
+            </div>
+            <div className="grid gap-1.5">
+              <Label htmlFor="source-ai-exec-instruction">
+                {m.tasks_create_instruction_label()}
+                <span className="text-destructive">*</span>
+              </Label>
+              <Textarea
+                id="source-ai-exec-instruction"
+                value={instruction}
+                maxLength={8000}
+                className="min-h-24"
+                onChange={(e) => setInstruction(e.target.value)}
+                onKeyDown={(e) => {
+                  // Enter 提交（IME 组合中不触发，兼容中文输入法，同 create-bug-dialog）
+                  if (
+                    e.key === "Enter" &&
+                    !e.shiftKey &&
+                    !e.nativeEvent.isComposing
+                  ) {
+                    e.preventDefault();
+                    submitRun();
+                  }
+                }}
+              />
+            </div>
+          </div>
+          <DialogFooter className="mt-4 gap-2">
+            <Button
+              type="button"
+              variant="outline"
+              disabled={!isValid || submitting}
+              onClick={() => createMutation.mutate(false)}
+            >
+              {m.tasks_create_save()}
+            </Button>
+            <Button type="submit" disabled={!isValid || submitting}>
+              {submitting ? (
+                <Loader2 className="animate-spin" data-icon="inline-start" />
+              ) : null}
+              {m.tasks_run()}
+            </Button>
+          </DialogFooter>
+        </form>
+      </DialogContent>
+    </Dialog>
+  );
+}

package/src/routes/_nav/tasks/-components/task-constants.ts

@@ -0,0 +1,115 @@
+// 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/>.
+
+// 任务模块色板单一事实源（UI 对齐四期任务 46，设计 §9.3）：状态三表
+// LABEL/COLOR/ICON 自 ai-task-status-badge.tsx 迁入集中，色板统一 /15 公式
+// bg-{c}-500/15 text-{c}-600 dark:text-{c}-400（§5.1），图标族对齐 §6.2 task 行。
+// 优先级归一 testcase p0-p3 映射（§6.3 圆箭头族：红/橙/蓝/灰），label 无需
+// i18n（P0-P3 直显，testcase priorityLabel 同口径），载体 LevelBadge
+// （LevelBadgeMeta 完整 token：badge 形态底色+字色+图标一体）。
+import {
+  CircleDashed,
+  LoaderCircle,
+  CheckCircle2,
+  XCircle,
+  TimerOff,
+  CircleSlash,
+  CircleFadingArrowUp,
+  CircleArrowUp,
+  CircleArrowRight,
+  CircleArrowDown,
+  type LucideIcon,
+} from "lucide-react";
+import { m } from "@/paraglide/messages.js";
+import type { LevelBadgeMeta } from "@/components/shared-kit/list-kit/level-badge";
+
+export type AiTaskStatus =
+  | "backlog"
+  | "running"
+  | "completed"
+  | "failed"
+  | "timeout"
+  | "canceled";
+
+/** 状态 → 文案 + 色板（单一来源数组，LABEL/COLOR 两表由其派生） */
+const TASK_STATUSES: { value: AiTaskStatus; label: () => string; color: string }[] = [
+  { value: "backlog", label: m.tasks_status_backlog, color: "bg-muted text-muted-foreground" },
+  { value: "running", label: m.tasks_status_running, color: "bg-blue-500/15 text-blue-600 dark:text-blue-400" },
+  { value: "completed", label: m.tasks_status_completed, color: "bg-green-500/15 text-green-600 dark:text-green-400" },
+  { value: "failed", label: m.tasks_status_failed, color: "bg-red-500/15 text-red-600 dark:text-red-400" },
+  { value: "timeout", label: m.tasks_status_timeout, color: "bg-red-500/15 text-red-600 dark:text-red-400" },
+  { value: "canceled", label: m.tasks_status_canceled, color: "bg-muted text-muted-foreground" },
+];
+
+/** 状态 → 文案（未知状态回落 undefined，消费方直显原始值） */
+export const TASK_STATUS_LABEL: Record<AiTaskStatus, () => string> = Object.fromEntries(
+  TASK_STATUSES.map((s) => [s.value, s.label]),
+) as Record<AiTaskStatus, () => string>;
+
+/** 状态 → 色板（§5.1 /15 公式 + dark: 成对；中性态 bg-muted） */
+export const TASK_STATUS_COLOR: Record<AiTaskStatus, string> = Object.fromEntries(
+  TASK_STATUSES.map((s) => [s.value, s.color]),
+) as Record<AiTaskStatus, string>;
+
+/** 状态 → 图标（§6.2 task 行：待办虚线圈 / 运行加载环（保留旋转）/ 完成对勾圈 /
+ *  失败叉圈 / 超时失效计时器 / 取消斜线圈） */
+export const TASK_STATUS_ICON: Record<AiTaskStatus, LucideIcon> = {
+  backlog: CircleDashed,
+  running: LoaderCircle,
+  completed: CheckCircle2,
+  failed: XCircle,
+  timeout: TimerOff,
+  canceled: CircleSlash,
+};
+
+/** 运行态图标旋转（与 STATUS_META 时代 spinning 语义一致，唯一特例） */
+export const TASK_STATUS_SPINNING: Record<AiTaskStatus, boolean> = {
+  backlog: false,
+  running: true,
+  completed: false,
+  failed: false,
+  timeout: false,
+  canceled: false,
+};
+
+/** 归一优先级（与 server/ai-task/types.ts UnifiedPriority 一致，此处本地收窄） */
+export type TaskPriority = "P0" | "P1" | "P2" | "P3";
+
+/** 优先级徽章完整 token（§6.3 归一 testcase p0-p3 映射：红/橙/蓝/灰圆箭头族；
+ *  LevelBadge badge 形态消费，P0-P3 直显无需 i18n） */
+export const TASK_PRIORITY_META: Record<TaskPriority, LevelBadgeMeta> = {
+  P0: {
+    label: "P0",
+    icon: CircleFadingArrowUp,
+    color: "bg-red-500/15 text-red-600 dark:text-red-400",
+  },
+  P1: {
+    label: "P1",
+    icon: CircleArrowUp,
+    color: "bg-orange-500/15 text-orange-600 dark:text-orange-400",
+  },
+  P2: {
+    label: "P2",
+    icon: CircleArrowRight,
+    color: "bg-blue-500/15 text-blue-600 dark:text-blue-400",
+  },
+  P3: {
+    label: "P3",
+    icon: CircleArrowDown,
+    color: "bg-muted text-muted-foreground",
+  },
+};