chore: 强化代码质量与风格检查体系

ESLint 升级到 recommended-type-checked + stylistic-type-checked，
引入 perfectionist 导入排序和 import 插件导入验证。

Prettier 显式声明全部格式化参数，消除跨环境差异。
TypeScript 启用 noUnusedLocals 和 noPropertyAccessFromIndexSignature。
完善 ignore 列表，排除 .agents/、bun.lock、data/ 等。
引入 husky + lint-staged（pre-commit）+ commitlint（commit-msg）。
更新 DEVELOPMENT.md 代码质量章节。
修复所有新增规则检测到的类型和风格违规。

src/server/middleware.ts

@@ -1,42 +1,19 @@
 import type { RuntimeMode } from "../shared/api";
+
 import { allowsGetHead, createApiError, jsonResponse, methodNotAllowedResponse } from "./helpers";
 
-export function guardGetHead(method: string, mode: RuntimeMode): Response | null {
+export function guardGetHead(method: string, mode: RuntimeMode): null | Response {
   if (!allowsGetHead(method)) {
     return methodNotAllowedResponse(["GET", "HEAD"], mode);
   }
   return null;
 }
 
-export function validateTargetId(idStr: string, mode: RuntimeMode): { id: number } | Response {
-  const id = Number(idStr);
-  if (!Number.isInteger(id) || id <= 0) {
-    return jsonResponse(createApiError("Invalid target ID", 400), { mode, status: 400 });
-  }
-  return { id };
-}
-
-export function validateTimeRange(
-  from: string | null,
-  to: string | null,
-  mode: RuntimeMode,
-): { from: string; to: string } | Response {
-  if (!from || !to) {
-    return jsonResponse(createApiError("from and to parameters are required", 400), { mode, status: 400 });
-  }
-
-  if (isNaN(new Date(from).getTime()) || isNaN(new Date(to).getTime())) {
-    return jsonResponse(createApiError("Invalid from or to parameter format", 400), { mode, status: 400 });
-  }
-
-  return { from, to };
-}
-
 export function validatePagination(
-  pageParam: string | null,
-  pageSizeParam: string | null,
+  pageParam: null | string,
+  pageSizeParam: null | string,
   mode: RuntimeMode,
-): { page: number; pageSize: number } | Response {
+): Response | { page: number; pageSize: number } {
   let page = 1;
   let pageSize = 20;
 
@@ -56,3 +33,27 @@ export function validatePagination(
 
   return { page, pageSize };
 }
+
+export function validateTargetId(idStr: string, mode: RuntimeMode): Response | { id: number } {
+  const id = Number(idStr);
+  if (!Number.isInteger(id) || id <= 0) {
+    return jsonResponse(createApiError("Invalid target ID", 400), { mode, status: 400 });
+  }
+  return { id };
+}
+
+export function validateTimeRange(
+  from: null | string,
+  to: null | string,
+  mode: RuntimeMode,
+): Response | { from: string; to: string } {
+  if (!from || !to) {
+    return jsonResponse(createApiError("from and to parameters are required", 400), { mode, status: 400 });
+  }
+
+  if (isNaN(new Date(from).getTime()) || isNaN(new Date(to).getTime())) {
+    return jsonResponse(createApiError("Invalid from or to parameter format", 400), { mode, status: 400 });
+  }
+
+  return { from, to };
+}