docs: sync date stamps with git commit history

Update 'Last Updated' and 'Updated:' fields in 30 documentation files
to reflect their actual last git commit dates.

Files updated across:
- docs/architecture/ (3 files)
- docs/archive/ (3 files)
- docs/dashboard_ui/ (5 files)
- docs/deployment/ (5 files)
- docs/runbooks/ (4 files)
- docs/setup/ (2 files)
- docs/testing/ (1 file)
- Other locations (7 files)

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: aledlie

.ast-grep/README.md

@@ -270,5 +270,5 @@ pattern: |
 ---
 
 **Created:** 2025-11-11
-**Last Updated:** 2025-11-11
+**Last Updated:** 2025-11-23
 **Version:** 1.0.0

api/routes/middleware/validation.js

@@ -0,0 +1,126 @@
+/**
+ * Request Validation Middleware
+ *
+ * Validates request bodies using Zod schemas and returns detailed error messages.
+ */
+
+import { ZodError } from 'zod';
+import { createComponentLogger } from '../../../sidequest/utils/logger.js';
+
+const logger = createComponentLogger('ValidationMiddleware');
+
+/**
+ * Format Zod validation errors into user-friendly messages
+ */
+function formatZodErrors(error) {
+  return error.errors.map(err => ({
+    field: err.path.join('.'),
+    message: err.message,
+    code: err.code
+  }));
+}
+
+/**
+ * Create validation middleware for a Zod schema
+ */
+export function validateRequest(schema) {
+  return (req, res, next) => {
+    try {
+      // Validate request body against schema
+      const validated = schema.parse(req.body);
+
+      // Replace request body with validated data (type-safe)
+      req.body = validated;
+
+      next();
+    } catch (error) {
+      if (error instanceof ZodError) {
+        const errors = formatZodErrors(error);
+
+        logger.warn({
+          path: req.path,
+          method: req.method,
+          errors
+        }, 'Request validation failed');
+
+        // Return detailed validation error
+        return res.status(400).json({
+          error: 'Bad Request',
+          message: 'Request validation failed',
+          timestamp: new Date().toISOString(),
+          errors
+        });
+      }
+
+      // Unknown error - pass to error handler
+      logger.error({ error }, 'Unknown validation error');
+      next(error);
+    }
+  };
+}
+
+/**
+ * Validate query parameters
+ * Stores validated data in req.validatedQuery to avoid read-only req.query
+ */
+export function validateQuery(schema) {
+  return (req, res, next) => {
+    try {
+      const validated = schema.parse(req.query);
+      // Store in custom property since req.query is read-only
+      req.validatedQuery = validated;
+      next();
+    } catch (error) {
+      if (error instanceof ZodError) {
+        const errors = formatZodErrors(error);
+
+        logger.warn({
+          path: req.path,
+          method: req.method,
+          errors
+        }, 'Query validation failed');
+
+        return res.status(400).json({
+          error: 'Bad Request',
+          message: 'Query parameter validation failed',
+          timestamp: new Date().toISOString(),
+          errors
+        });
+      }
+
+      next(error);
+    }
+  };
+}
+
+/**
+ * Validate path parameters
+ */
+export function validateParams(schema) {
+  return (req, res, next) => {
+    try {
+      const validated = schema.parse(req.params);
+      req.params = validated;
+      next();
+    } catch (error) {
+      if (error instanceof ZodError) {
+        const errors = formatZodErrors(error);
+
+        logger.warn({
+          path: req.path,
+          method: req.method,
+          errors
+        }, 'Path parameter validation failed');
+
+        return res.status(400).json({
+          error: 'Bad Request',
+          message: 'Path parameter validation failed',
+          timestamp: new Date().toISOString(),
+          errors
+        });
+      }
+
+      next(error);
+    }
+  };
+}