@allbluecn/web-app 0.18.2 → 0.19.0

package/src/server/story/types.ts

@@ -53,6 +53,9 @@ export const STORY_LIST_SELECT = {
   createdBy: { select: USER_BRIEF_SELECT },
   updatedBy: { select: USER_BRIEF_SELECT },
   labels: { select: { label: { select: { id: true, name: true, color: true } } } },
+  // 甘特迭代分组依赖 story.iteration（mappers 按 iteration.id 桶分），主列表
+  // 必须携带——漏 select 会让 iteration 分组静默退化为单一「无迭代」组
+  iteration: { select: { id: true, name: true } },
   createdAt: true,
   updatedAt: true,
 } satisfies Prisma.StoryDefaultArgs["select"];
@@ -202,13 +205,6 @@ export function toValidDate(value: string): Date | null {
   return isNaN(d.getTime()) ? null : d;
 }
 
-export function toDateOnly(d: Date): string {
-  const y = d.getFullYear();
-  const m = String(d.getMonth() + 1).padStart(2, "0");
-  const day = String(d.getDate()).padStart(2, "0");
-  return `${y}-${m}-${day}`;
-}
-
 export interface StoryTreeNode {
   id: string;
   title: string;

package/src/server/testcase/__tests__/list-query.test.ts

@@ -0,0 +1,269 @@
+// 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/>.
+
+// 用例列表 where 构造纯函数白盒测试（UI 对齐二期 TC-B 任务 21，bug/
+// story-list-query.test.ts 姊妹件同构）。覆盖面：基础矩阵（projectIds 聚合/
+// 归档闸门/searchText OR）+ filters 五字段翻译分支（state/type/priority 的
+// in/notIn、folder 的 null 语义、assigneeId 的 __none__ 混合 OR）+ 非法
+// JSON/畸形 wire 降级忽略 + 未知 property 不影响其余条件。
+import { describe, it, expect } from "vitest";
+import { buildListWhere } from "../list-query";
+
+describe("buildListWhere 基础矩阵", () => {
+  it("projectIds 聚合（「全部项目」）+ 默认未归档闸门", () => {
+    expect(buildListWhere({ archived: false, projectIds: ["p1", "p2"] })).toEqual({
+      archived: false,
+      projectId: { in: ["p1", "p2"] },
+    });
+  });
+
+  it("folderId null（未分组）与 undefined（不筛）语义区分", () => {
+    expect(buildListWhere({ archived: false, projectIds: ["p1"], folderId: null })).toEqual({
+      archived: false,
+      projectId: { in: ["p1"] },
+      folderId: null,
+    });
+    expect(buildListWhere({ archived: false, projectIds: ["p1"], folderId: undefined })).toEqual({
+      archived: false,
+      projectId: { in: ["p1"] },
+    });
+  });
+
+  it("扁平 state/assigneeId 参数直传（存量消费方契约不变）", () => {
+    expect(
+      buildListWhere({ archived: true, projectIds: ["p1"], state: "approved", assigneeId: null }),
+    ).toEqual({
+      archived: true,
+      projectId: { in: ["p1"] },
+      state: "approved",
+      assigneeId: null,
+    });
+  });
+
+  it("searchText 生成 title/identifier 的 insensitive OR", () => {
+    const where = buildListWhere({ archived: false, projectIds: ["p1"], searchText: "WEB-TC1" });
+    expect(where.OR).toEqual([
+      { title: { contains: "WEB-TC1", mode: "insensitive" } },
+      { identifier: { contains: "WEB-TC1", mode: "insensitive" } },
+    ]);
+  });
+});
+
+describe("buildListWhere filters 翻译（五字段）", () => {
+  it("畸形条件混入合法条件：畸形单条跳过，合法条件仍生效（per-condition 守卫）", () => {
+    const where = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      // null / 数字 / 缺 value 的对象均为畸形（旧实现会在外层 try-catch 连坐丢弃全部）
+      filters: JSON.stringify([
+        null,
+        42,
+        { property: "state", operator: "is" },
+        { property: "state", operator: "is", value: "approved" },
+      ]),
+    });
+    expect(where.AND).toEqual([{ state: "approved" }]);
+  });
+
+  it("state is 单值 → AND 直传字符串", () => {
+    const where = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "state", operator: "is", value: "approved" }]),
+    });
+    expect(where.AND).toEqual([{ state: "approved" }]);
+  });
+
+  it("state is_any_of 多值 → AND in", () => {
+    const where = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "state", operator: "is_any_of", value: "draft,in_review" }]),
+    });
+    expect(where.AND).toEqual([{ state: { in: ["draft", "in_review"] } }]);
+  });
+
+  it("type is_not → AND notIn", () => {
+    const where = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "type", operator: "is_not", value: "performance" }]),
+    });
+    expect(where.AND).toEqual([{ type: { notIn: ["performance"] } }]);
+  });
+
+  it("priority is_not_any_of → AND notIn", () => {
+    const where = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "priority", operator: "is_not_any_of", value: "p2,p3" }]),
+    });
+    expect(where.AND).toEqual([{ priority: { notIn: ["p2", "p3"] } }]);
+  });
+
+  it("folder is 单值 → folderId 直传；is_any_of → in", () => {
+    const single = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "folder", operator: "is", value: "f1" }]),
+    });
+    expect(single.AND).toEqual([{ folderId: "f1" }]);
+
+    const multi = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "folder", operator: "is_any_of", value: "f1,f2" }]),
+    });
+    expect(multi.AND).toEqual([{ folderId: { in: ["f1", "f2"] } }]);
+  });
+
+  it("folder is_empty → folderId null（未分组）；is_not_empty → not null", () => {
+    const empty = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "folder", operator: "is_empty", value: "" }]),
+    });
+    expect(empty.AND).toEqual([{ folderId: null }]);
+
+    const notEmpty = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "folder", operator: "is_not_empty", value: "" }]),
+    });
+    expect(notEmpty.AND).toEqual([{ folderId: { not: null } }]);
+  });
+
+  it("folder is_not → folderId notIn", () => {
+    const where = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "folder", operator: "is_not", value: "f1" }]),
+    });
+    expect(where.AND).toEqual([{ folderId: { notIn: ["f1"] } }]);
+  });
+
+  it("assigneeId is __none__ → 未指派（assigneeId null）", () => {
+    const where = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "assigneeId", operator: "is", value: "__none__" }]),
+    });
+    expect(where.AND).toEqual([{ assigneeId: null }]);
+  });
+
+  it("assigneeId is_not __none__ → 已指派（assigneeId not null）", () => {
+    const where = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "assigneeId", operator: "is_not", value: "__none__" }]),
+    });
+    expect(where.AND).toEqual([{ assigneeId: { not: null } }]);
+  });
+
+  it("assigneeId 混合 __none__ 与具体用户 → OR 组合", () => {
+    const where = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "assigneeId", operator: "is_any_of", value: "__none__,u2" }]),
+    });
+    expect(where.AND).toEqual([{ OR: [{ assigneeId: null }, { assigneeId: { in: ["u2"] } }] }]);
+  });
+
+  it("assigneeId is_empty / is_not_empty → null / not null", () => {
+    const empty = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "assigneeId", operator: "is_empty", value: "" }]),
+    });
+    expect(empty.AND).toEqual([{ assigneeId: null }]);
+
+    const notEmpty = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "assigneeId", operator: "is_not_empty", value: "" }]),
+    });
+    expect(notEmpty.AND).toEqual([{ assigneeId: { not: null } }]);
+  });
+
+  it("assigneeId 具体用户多值 → in；is_not 多值 → notIn", () => {
+    const multi = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "assigneeId", operator: "is_any_of", value: "u2,u3" }]),
+    });
+    expect(multi.AND).toEqual([{ assigneeId: { in: ["u2", "u3"] } }]);
+
+    const notMulti = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "assigneeId", operator: "is_not_any_of", value: "u2,u3" }]),
+    });
+    expect(notMulti.AND).toEqual([{ assigneeId: { notIn: ["u2", "u3"] } }]);
+  });
+
+  it("多条件 filters 合并进同一 AND；与 searchText 并存时 OR 同时存在", () => {
+    const where = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      searchText: "登录",
+      filters: JSON.stringify([
+        { property: "state", operator: "is", value: "approved" },
+        { property: "priority", operator: "is_not_any_of", value: "p3" },
+      ]),
+    });
+    expect(where.archived).toBe(false);
+    expect(where.projectId).toEqual({ in: ["p1"] });
+    expect(where.OR).toHaveLength(2);
+    expect(where.AND).toEqual([{ state: "approved" }, { priority: { notIn: ["p3"] } }]);
+  });
+});
+
+describe("buildListWhere 降级与防御", () => {
+  it("非法 JSON filters 静默忽略（AND 不注入）", () => {
+    expect(buildListWhere({ archived: false, projectIds: ["p1"], filters: "{not-json" })).toEqual({
+      archived: false,
+      projectId: { in: ["p1"] },
+    });
+  });
+
+  it("畸形 wire（非数组 JSON）降级忽略", () => {
+    expect(
+      buildListWhere({ archived: false, projectIds: ["p1"], filters: JSON.stringify("hack") }),
+    ).toEqual({ archived: false, projectId: { in: ["p1"] } });
+  });
+
+  it("未知 property 忽略，不影响其余条件", () => {
+    const where = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([
+        { property: "hack", operator: "is", value: "x" },
+        { property: "state", operator: "is", value: "draft" },
+      ]),
+    });
+    expect(where.AND).toEqual([{ state: "draft" }]);
+  });
+
+  it("条件 value 全空（split 后零值）不产生空 in 分支", () => {
+    const where = buildListWhere({
+      archived: false,
+      projectIds: ["p1"],
+      filters: JSON.stringify([{ property: "state", operator: "is", value: "" }]),
+    });
+    expect(where.AND).toBeUndefined();
+  });
+});

package/src/server/testcase/list-query.ts

@@ -0,0 +1,145 @@
+// 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/>.
+
+// 用例列表 where 构造纯函数（UI 对齐二期 TC-B 任务 21，照 bug/story-list-query
+// 同构抽建）。此前列表（testcase-crud listTestCasesFn）与分组计数
+// （testcase-groups listGroupsFn）的 where 分支逐字段重复，本次随筛选体系接入
+// 抽到单处共用；本文件位于 src/server/testcase/（serverFns 树外，纯净性审计
+// 口径②允许的 helper 落点），Prisma 仅类型位使用（运行时零依赖）。
+// filters 为客户端 serializeFilters 产物（FilterCondition JSON 串），property
+// 白名单恰为 components/testcase/filters/field-configs.tsx 五字段——两侧翻译
+// 分支一一对应。非法 JSON 静默忽略（与 story/bug 同构）。
+import type { Prisma } from "@allbluecn/database";
+
+interface FilterConditionWire {
+  property: string;
+  operator: string;
+  value: string;
+}
+
+export function buildListWhere(data: {
+  archived: boolean;
+  /** 「全部项目」聚合：projectId in 成员关系内全部项目 */
+  projectIds: string[];
+  // 以下扁平参数与任务 21 前的 listSchema 分支逐字段等价（folderId/storyId/
+  // assigneeId 的 null 为有意义筛选，与 undefined 不筛区分）
+  folderId?: string | null;
+  storyId?: string | null;
+  state?: string;
+  type?: string;
+  priority?: string;
+  automation?: string;
+  assigneeId?: string | null;
+  searchText?: string;
+  filters?: string;
+}): Prisma.TestCaseWhereInput {
+  const where: Prisma.TestCaseWhereInput = {
+    projectId: { in: data.projectIds },
+    archived: data.archived,
+    ...(data.folderId !== undefined && { folderId: data.folderId }),
+    ...(data.storyId !== undefined && { storyId: data.storyId }),
+    ...(data.state && { state: data.state }),
+    ...(data.type && { type: data.type }),
+    ...(data.priority && { priority: data.priority }),
+    ...(data.automation && { automation: data.automation }),
+    ...(data.assigneeId !== undefined && { assigneeId: data.assigneeId }),
+    ...(data.searchText && {
+      OR: [
+        { title: { contains: data.searchText, mode: "insensitive" } },
+        { identifier: { contains: data.searchText, mode: "insensitive" } },
+      ],
+    }),
+  };
+
+  const andConditions: Prisma.TestCaseWhereInput[] = [];
+  if (data.filters) {
+    try {
+      const conditions = JSON.parse(data.filters) as FilterConditionWire[];
+      if (Array.isArray(conditions)) {
+        for (const fc of conditions) {
+          // 畸形单条守卫：fc 非对象 / value 非 string 时跳过该条（.split 会抛错），
+          // 不连坐丢弃后续合法条件（外层 catch 只兜 JSON.parse 级错误）
+          if (typeof fc?.value !== "string") continue;
+          // state/type/priority 同构枚举分支（bug 的 state/severity/source 同款）
+          if (fc.property === "state" || fc.property === "type" || fc.property === "priority") {
+            const vals = fc.value.split(",").filter(Boolean);
+            if (vals.length > 0) {
+              const isNeg = fc.operator === "is_not" || fc.operator === "is_not_any_of";
+              const cond = isNeg ? { notIn: vals } : vals.length === 1 ? vals[0] : { in: vals };
+              if (fc.property === "state") {
+                andConditions.push({ state: cond });
+              } else if (fc.property === "type") {
+                andConditions.push({ type: cond });
+              } else {
+                andConditions.push({ priority: cond });
+              }
+            }
+          } else if (fc.property === "folder") {
+            // 模块筛选：值为 folderId（单项目 scope 专用）；为空/不为空语义 =
+            // 未分组用例（folderId null / 非 null）
+            if (fc.operator === "is_empty") {
+              andConditions.push({ folderId: null });
+            } else if (fc.operator === "is_not_empty") {
+              andConditions.push({ folderId: { not: null } });
+            } else {
+              const vals = fc.value.split(",").filter(Boolean);
+              if (vals.length > 0) {
+                const isNeg = fc.operator === "is_not" || fc.operator === "is_not_any_of";
+                andConditions.push({
+                  folderId: isNeg ? { notIn: vals } : vals.length === 1 ? vals[0] : { in: vals },
+                });
+              }
+            }
+          } else if (fc.property === "assigneeId") {
+            // 特殊值沿用 bug 规格：assigneeId === "__none__" 未指派
+            const vals = fc.value.split(",").filter(Boolean);
+            const realIds = vals.filter((v) => v !== "__none__");
+            const hasNone = vals.includes("__none__");
+            const isNeg = fc.operator === "is_not" || fc.operator === "is_not_any_of";
+            if (fc.operator === "is_empty") {
+              andConditions.push({ assigneeId: null });
+            } else if (fc.operator === "is_not_empty") {
+              andConditions.push({ assigneeId: { not: null } });
+            } else if (hasNone && realIds.length === 0) {
+              andConditions.push(isNeg ? { assigneeId: { not: null } } : { assigneeId: null });
+            } else if (hasNone) {
+              andConditions.push({
+                OR: [{ assigneeId: null }, { assigneeId: isNeg ? { notIn: realIds } : { in: realIds } }],
+              });
+            } else if (realIds.length > 0) {
+              andConditions.push({
+                assigneeId: isNeg
+                  ? { notIn: realIds }
+                  : realIds.length === 1
+                    ? realIds[0]
+                    : { in: realIds },
+              });
+            }
+          }
+        }
+      }
+    } catch {
+      // 非法 JSON filters 静默忽略（与 story/bug 同构）
+    }
+  }
+
+  if (andConditions.length > 0) {
+    where.AND = andConditions;
+  }
+
+  return where;
+}

package/src/server-entry.ts

@@ -52,6 +52,38 @@ const handler = async ({ request, router, responseHeaders }: any) => {
 
 const fetch = createStartHandler(handler)
 
+// Cloudflare Cron Triggers → 自调用既有 HTTP cron 路由（Bearer CRON_SECRET，
+// 业务零改动）。表达式与 apps/web/wrangler.jsonc 的 triggers.crons 一一对应；
+// Vercel/desktop 等其他目标不消费 default export 的 scheduled 成员，无影响。
+const cronRoutes: Record<string, string> = {
+  "0 2 * * *": "/api/cron/subscription-reminders",
+  "0 3 * * *": "/api/cron/changelog-release",
+}
+
 export default {
   fetch: (req: Request): Promise<Response> => paraglideMiddleware(req, () => fetch(req)),
+  scheduled: (
+    event: { cron: string },
+    env: { APP_URL?: string; CRON_SECRET?: string },
+    ctx: { waitUntil: (p: Promise<unknown>) => void },
+  ): void => {
+    const path = cronRoutes[event.cron]
+    if (!path) return
+    if (!env.APP_URL) {
+      console.error("[scheduled] 跳过 cron 触发：APP_URL 未配置（wrangler vars 需回填），表达式:", event.cron)
+      return
+    }
+    // globalThis.fetch：模块级 const fetch（start handler）遮蔽了全局 fetch，
+    // 这里必须显式走全局对象，否则类型与运行时都会错
+    ctx.waitUntil(
+      globalThis.fetch(`${env.APP_URL}${path}`, {
+        headers: { Authorization: `Bearer ${env.CRON_SECRET ?? ""}` },
+      }).then((res: Response) => {
+        if (!res.ok) console.error("[scheduled] cron 路由返回非 2xx:", path, res.status)
+      })
+      .catch((e: unknown) =>
+        console.error("[scheduled] cron 自调用失败:", path, e instanceof Error ? e.message : e),
+      ),
+    )
+  },
 }

package/src/shared/bug/__tests__/constants.test.ts

@@ -16,6 +16,17 @@
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
 import { describe, it, expect } from "vitest";
+import {
+  CircleDot,
+  LoaderCircle,
+  CheckCircle2,
+  CircleCheckBig,
+  XCircle,
+  CircleFadingArrowUp,
+  CircleArrowUp,
+  CircleArrowRight,
+  CircleArrowDown,
+} from "lucide-react";
 import {
   BUG_STATES,
   BUG_SEVERITIES,
@@ -30,6 +41,8 @@ import {
   SOURCE_LABEL,
   SOURCE_COLOR,
   ACTIVITY_LABEL,
+  BUG_STATE_ICON,
+  SEVERITY_ICON,
   type BugState,
   type BugSeverity,
   type BugSource,
@@ -153,6 +166,37 @@ describe("BUG_SEVERITIES", () => {
       expect(SEVERITY_COLOR[sev]).toBeTypeOf("string");
     });
   });
+
+  it("medium colorToken 走蓝系（amber→blue，UI 对齐一期 §6.3 色阶统一）", () => {
+    const medium = BUG_SEVERITIES.find((s) => s.value === "medium");
+    expect(medium).toBeDefined();
+    expect(medium!.colorToken).toContain("bg-blue-500/15");
+    expect(medium!.colorToken).toContain("text-blue-600");
+    expect(medium!.colorToken).toContain("dark:text-blue-400");
+    expect(medium!.colorToken).not.toContain("amber");
+  });
+});
+
+describe("BUG_STATE_ICON（§6.2 状态图标族）", () => {
+  it("open=CircleDot、closed=CircleCheckBig", () => {
+    expect(BUG_STATE_ICON.open).toBe(CircleDot);
+    expect(BUG_STATE_ICON.closed).toBe(CircleCheckBig);
+  });
+
+  it("五态图标全覆盖（in_progress/fixed/wontfix）", () => {
+    expect(BUG_STATE_ICON.in_progress).toBe(LoaderCircle);
+    expect(BUG_STATE_ICON.fixed).toBe(CheckCircle2);
+    expect(BUG_STATE_ICON.wontfix).toBe(XCircle);
+  });
+});
+
+describe("SEVERITY_ICON（§6.3 圆箭头族，与 story PRIORITY_ICON 同族）", () => {
+  it("critical/high/medium/low 依次为渐隐上箭头/上箭头/右箭头/下箭头", () => {
+    expect(SEVERITY_ICON.critical).toBe(CircleFadingArrowUp);
+    expect(SEVERITY_ICON.high).toBe(CircleArrowUp);
+    expect(SEVERITY_ICON.medium).toBe(CircleArrowRight);
+    expect(SEVERITY_ICON.low).toBe(CircleArrowDown);
+  });
 });
 
 describe("BUG_SOURCES", () => {

package/src/shared/bug/constants.ts

@@ -17,7 +17,21 @@
 
 // BUG 域零依赖常量（客户端安全）：DB 中 state/severity/source 为 String 非 enum，
 // 本文件的联合类型 + 查表常量是类型安全的唯一防线（serverFn 与 UI 共用）。
+// 图标族为模块级业务枚举（UI 对齐一期 §6.2/§6.3：state 圆点族、severity 圆箭头族），
+// 与 shared-kit icon-semantics（语义图标）分层；severity medium 色阶 amber→blue 统一。
 import { m } from '@/paraglide/messages.js';
+import {
+  CircleDot,
+  LoaderCircle,
+  CheckCircle2,
+  CircleCheckBig,
+  XCircle,
+  CircleFadingArrowUp,
+  CircleArrowUp,
+  CircleArrowRight,
+  CircleArrowDown,
+  type LucideIcon,
+} from "lucide-react";
 
 export type BugState = "open" | "in_progress" | "fixed" | "closed" | "wontfix";
 export type BugSeverity = "critical" | "high" | "medium" | "low";
@@ -44,7 +58,7 @@ export const BUG_SEVERITIES: {
 }[] = [
   { value: "critical", label: m.bug_severity_critical, rank: 4, colorToken: "bg-red-500/15 text-red-600 dark:text-red-400" },
   { value: "high", label: m.bug_severity_high, rank: 3, colorToken: "bg-orange-500/15 text-orange-600 dark:text-orange-400" },
-  { value: "medium", label: m.bug_severity_medium, rank: 2, colorToken: "bg-amber-500/15 text-amber-600 dark:text-amber-400" },
+  { value: "medium", label: m.bug_severity_medium, rank: 2, colorToken: "bg-blue-500/15 text-blue-600 dark:text-blue-400" },
   { value: "low", label: m.bug_severity_low, rank: 1, colorToken: "bg-muted text-muted-foreground" },
 ];
 
@@ -84,6 +98,25 @@ export const SEVERITY_COLOR: Record<BugSeverity, string> = Object.fromEntries(
   BUG_SEVERITIES.map((s) => [s.value, s.colorToken]),
 ) as Record<BugSeverity, string>;
 
+// ── 状态图标族（§6.2：open 圆点 / in_progress 加载环 / fixed 对勾圈 /
+// closed 大对勾圈 / wontfix 叉圈）──
+export const BUG_STATE_ICON: Record<BugState, LucideIcon> = {
+  open: CircleDot,
+  in_progress: LoaderCircle,
+  fixed: CheckCircle2,
+  closed: CircleCheckBig,
+  wontfix: XCircle,
+};
+
+// ── 严重度图标族（§6.3 圆箭头族，与 story PRIORITY_ICON / testcase
+// TEST_CASE_PRIORITY_META 同族同色阶方向：critical 渐隐上箭头→low 下箭头）──
+export const SEVERITY_ICON: Record<BugSeverity, LucideIcon> = {
+  critical: CircleFadingArrowUp,
+  high: CircleArrowUp,
+  medium: CircleArrowRight,
+  low: CircleArrowDown,
+};
+
 export const SOURCE_LABEL: Record<BugSource, () => string> = Object.fromEntries(
   BUG_SOURCES.map((s) => [s.value, s.label]),
 ) as Record<BugSource, () => string>;
@@ -130,6 +163,9 @@ export function severityRank(severity: BugSeverity): number {
 // + 详情分区可产生的字段 diff / 归档 / 评论 / 解除关联
 export const ACTIVITY_LABEL: Record<string, () => string> = {
   created: m.bug_activity_created,
+  // 协同落库活动（apps/collab exporters/bug.ts COLLAB_BUG_UPDATE_ACTION，
+  // 任务 22 遗留收口：缺标签时时间线显示原始 key）
+  collab_update: m.bug_activity_collab_update,
   state_changed: m.bug_activity_state_changed,
   severity_changed: m.bug_activity_severity_changed,
   assigned: m.bug_activity_assigned,

package/src/start.ts

@@ -22,10 +22,14 @@ import { auditRequestMiddleware } from '@/server/middlewares/audit'
 import { neonKeepaliveMiddleware } from '@/server/keepalive/middleware'
 
 const globalAny = globalThis as any
-if (import.meta.env.SSR && !globalAny.__githubSyncTimer) {
+// GitHub 书签同步定时器懒启动：workerd 禁止在 global scope（模块顶层）设定时器
+// （Disallowed operation within global scope），首个 SSR 请求（createStart 回调，
+// handler 上下文）时才开启；globalThis 守卫保证只启动一次，Node/Vercel 行为不变。
+function ensureGithubSyncTimer() {
+  if (!import.meta.env.SSR || globalAny.__githubSyncTimer) return
   globalAny.__githubSyncTimer = setInterval(async () => {
     try {
-      const { syncAllStaleGithubBookmarks } = await import('@/server/knowledge-public/github-sync')
+      const { syncAllStaleGithubBookmarks } = await import('@/server/knowledge/public/github-sync')
       const n = await syncAllStaleGithubBookmarks()
       if (n > 0) console.log(`[github-sync] synced ${n} bookmarks`)
     } catch (e) {
@@ -122,6 +126,7 @@ const apiCorsMiddleware = createMiddleware().server(async ({ request, next }: an
 export const startInstance = createStart(async () => {
   const requestMiddleware = [securityHeadersMiddleware, requestContextMiddleware, neonKeepaliveMiddleware, aiPortsMiddleware, apiCorsMiddleware, csrfMiddleware, auditRequestMiddleware]
   if (import.meta.env.SSR) {
+    ensureGithubSyncTimer()
     const { registerServerSeam } = await import('@allbluecn/kernel')
     const { requireAuth, requireUserInDb } = await import('@/server/auth-helpers')
     const { getCurrentSession } = await import('@/lib/session')