feat: complete development environment setup and code quality improvements

- Set up pre-commit hooks with husky and lint-staged for automated code quality
- Improved TypeScript type safety by replacing 'any' types with proper generics
- Fixed markdown linting violations (MD030 spacing) across all documentation
- Fixed compound adjective hyphenation in technical documentation
- Fixed invalid JSON union syntax in API documentation examples
- Automated code formatting and linting on commit
- Enhanced error handling with better type constraints
- Configured biome and markdownlint for consistent code style
- All changes verified with successful production build

app/api/admin/performance/route.ts

@@ -156,9 +156,12 @@ async function getPerformanceHistory(limit: number) {
               0
             ) / history.length
           : 0,
-      memoryTrend: calculateTrend(history, "memoryUsage.heapUsed"),
+      memoryTrend: calculateTrend(
+        history as unknown as Record<string, unknown>[],
+        "memoryUsage.heapUsed"
+      ),
       responseTrend: calculateTrend(
-        history,
+        history as unknown as Record<string, unknown>[],
         "requestMetrics.averageResponseTime"
       ),
     },
@@ -539,8 +542,8 @@ function _calculateAverage(
     : 0;
 }
 
-function calculateTrend(
-  history: Array<any>,
+function calculateTrend<T extends Record<string, unknown>>(
+  history: Array<T>,
   path: string
 ): "increasing" | "decreasing" | "stable" {
   if (history.length < 2) return "stable";
@@ -570,10 +573,18 @@ function calculateTrend(
   return "stable";
 }
 
-function getNestedPropertyValue(obj: any, path: string): number {
-  return (
-    path.split(".").reduce((current, key) => current?.[key] ?? 0, obj) || 0
-  );
+function getNestedPropertyValue(
+  obj: Record<string, unknown>,
+  path: string
+): number {
+  const result = path.split(".").reduce((current, key) => {
+    if (current && typeof current === "object" && key in current) {
+      return (current as Record<string, unknown>)[key];
+    }
+    return 0;
+  }, obj as unknown);
+
+  return typeof result === "number" ? result : 0;
 }
 
 function getNestedValue(obj: Record<string, unknown>, path: string): unknown {

app/api/admin/schedulers/route.ts

@@ -1,6 +1,6 @@
-import { getSchedulerIntegration } from "@/lib/services/schedulers/ServerSchedulerIntegration";
-import { createAdminHandler } from "@/lib/api";
 import { z } from "zod";
+import { createAdminHandler } from "@/lib/api";
+import { getSchedulerIntegration } from "@/lib/services/schedulers/ServerSchedulerIntegration";
 
 /**
  * Get all schedulers with their status and metrics
@@ -21,72 +21,79 @@ export const GET = createAdminHandler(async (_context) => {
   };
 });
 
-const PostInputSchema = z.object({
-  action: z.enum(["start", "stop", "trigger", "startAll", "stopAll"]),
-  schedulerId: z.string().optional(),
-}).refine(
-  (data) => {
-    // schedulerId is required for individual scheduler actions
-    const actionsRequiringSchedulerId = ["start", "stop", "trigger"];
-    if (actionsRequiringSchedulerId.includes(data.action)) {
-      return data.schedulerId !== undefined && data.schedulerId.length > 0;
+const PostInputSchema = z
+  .object({
+    action: z.enum(["start", "stop", "trigger", "startAll", "stopAll"]),
+    schedulerId: z.string().optional(),
+  })
+  .refine(
+    (data) => {
+      // schedulerId is required for individual scheduler actions
+      const actionsRequiringSchedulerId = ["start", "stop", "trigger"];
+      if (actionsRequiringSchedulerId.includes(data.action)) {
+        return data.schedulerId !== undefined && data.schedulerId.length > 0;
+      }
+      return true;
+    },
+    {
+      message: "schedulerId is required for start, stop, and trigger actions",
+      path: ["schedulerId"],
     }
-    return true;
-  },
-  {
-    message: "schedulerId is required for start, stop, and trigger actions",
-    path: ["schedulerId"],
-  }
-);
+  );
 
 /**
  * Control scheduler operations (start/stop/trigger)
  * Requires admin authentication
  */
-export const POST = createAdminHandler(async (_context, validatedData) => {
-  const { action, schedulerId } = validatedData;
+export const POST = createAdminHandler(
+  async (_context, validatedData) => {
+    const { action, schedulerId } = validatedData as z.infer<
+      typeof PostInputSchema
+    >;
 
-  const integration = getSchedulerIntegration();
+    const integration = getSchedulerIntegration();
 
-  switch (action) {
-    case "start":
-      if (schedulerId) {
-        await integration.startScheduler(schedulerId);
-      }
-      break;
+    switch (action) {
+      case "start":
+        if (schedulerId) {
+          await integration.startScheduler(schedulerId);
+        }
+        break;
 
-    case "stop":
-      if (schedulerId) {
-        await integration.stopScheduler(schedulerId);
-      }
-      break;
+      case "stop":
+        if (schedulerId) {
+          await integration.stopScheduler(schedulerId);
+        }
+        break;
 
-    case "trigger":
-      if (schedulerId) {
-        await integration.triggerScheduler(schedulerId);
-      }
-      break;
+      case "trigger":
+        if (schedulerId) {
+          await integration.triggerScheduler(schedulerId);
+        }
+        break;
 
-    case "startAll":
-      await integration.getManager().startAll();
-      break;
+      case "startAll":
+        await integration.getManager().startAll();
+        break;
 
-    case "stopAll":
-      await integration.getManager().stopAll();
-      break;
+      case "stopAll":
+        await integration.getManager().stopAll();
+        break;
 
-    default:
-      return {
-        success: false,
-        error: `Unknown action: ${action}`,
-      };
+      default:
+        return {
+          success: false,
+          error: `Unknown action: ${action}`,
+        };
+    }
+
+    return {
+      success: true,
+      message: `Action '${action}' completed successfully`,
+      timestamp: new Date().toISOString(),
+    };
+  },
+  {
+    validateInput: PostInputSchema,
   }
-
-  return {
-    success: true,
-    message: `Action '${action}' completed successfully`,
-    timestamp: new Date().toISOString(),
-  };
-}, {
-  validateInput: PostInputSchema,
-});
+);