refactoring the api endpoints to be separate files to reduce context usage

apps/server/src/routes/workspace/common.ts

@@ -0,0 +1,21 @@
+/**
+ * Common utilities for workspace routes
+ */
+
+import { createLogger } from "../../lib/logger.js";
+
+const logger = createLogger("Workspace");
+
+/**
+ * Get error message from error object
+ */
+export function getErrorMessage(error: unknown): string {
+  return error instanceof Error ? error.message : "Unknown error";
+}
+
+/**
+ * Log error details consistently
+ */
+export function logError(error: unknown, context: string): void {
+  logger.error(`❌ ${context}:`, error);
+}

apps/server/src/routes/workspace/index.ts

@@ -0,0 +1,17 @@
+/**
+ * Workspace routes
+ * Provides API endpoints for workspace directory management
+ */
+
+import { Router } from "express";
+import { createConfigHandler } from "./routes/config.js";
+import { createDirectoriesHandler } from "./routes/directories.js";
+
+export function createWorkspaceRoutes(): Router {
+  const router = Router();
+
+  router.get("/config", createConfigHandler());
+  router.get("/directories", createDirectoriesHandler());
+
+  return router;
+}

apps/server/src/routes/workspace/routes/config.ts

@@ -0,0 +1,55 @@
+/**
+ * GET /config endpoint - Get workspace configuration status
+ */
+
+import type { Request, Response } from "express";
+import fs from "fs/promises";
+import { addAllowedPath } from "../../../lib/security.js";
+import { getErrorMessage, logError } from "../common.js";
+
+export function createConfigHandler() {
+  return async (_req: Request, res: Response): Promise<void> => {
+    try {
+      const workspaceDir = process.env.WORKSPACE_DIR;
+
+      if (!workspaceDir) {
+        res.json({
+          success: true,
+          configured: false,
+        });
+        return;
+      }
+
+      // Check if the directory exists
+      try {
+        const stats = await fs.stat(workspaceDir);
+        if (!stats.isDirectory()) {
+          res.json({
+            success: true,
+            configured: false,
+            error: "WORKSPACE_DIR is not a valid directory",
+          });
+          return;
+        }
+
+        // Add workspace dir to allowed paths
+        addAllowedPath(workspaceDir);
+
+        res.json({
+          success: true,
+          configured: true,
+          workspaceDir,
+        });
+      } catch {
+        res.json({
+          success: true,
+          configured: false,
+          error: "WORKSPACE_DIR path does not exist",
+        });
+      }
+    } catch (error) {
+      logError(error, "Get workspace config failed");
+      res.status(500).json({ success: false, error: getErrorMessage(error) });
+    }
+  };
+}

apps/server/src/routes/workspace/routes/directories.ts

@@ -0,0 +1,62 @@
+/**
+ * GET /directories endpoint - List directories in workspace
+ */
+
+import type { Request, Response } from "express";
+import fs from "fs/promises";
+import path from "path";
+import { addAllowedPath } from "../../../lib/security.js";
+import { getErrorMessage, logError } from "../common.js";
+
+export function createDirectoriesHandler() {
+  return async (_req: Request, res: Response): Promise<void> => {
+    try {
+      const workspaceDir = process.env.WORKSPACE_DIR;
+
+      if (!workspaceDir) {
+        res.status(400).json({
+          success: false,
+          error: "WORKSPACE_DIR is not configured",
+        });
+        return;
+      }
+
+      // Check if directory exists
+      try {
+        await fs.stat(workspaceDir);
+      } catch {
+        res.status(400).json({
+          success: false,
+          error: "WORKSPACE_DIR path does not exist",
+        });
+        return;
+      }
+
+      // Add workspace dir to allowed paths
+      addAllowedPath(workspaceDir);
+
+      // Read directory contents
+      const entries = await fs.readdir(workspaceDir, { withFileTypes: true });
+
+      // Filter to directories only and map to result format
+      const directories = entries
+        .filter((entry) => entry.isDirectory() && !entry.name.startsWith("."))
+        .map((entry) => ({
+          name: entry.name,
+          path: path.join(workspaceDir, entry.name),
+        }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+
+      // Add each directory to allowed paths
+      directories.forEach((dir) => addAllowedPath(dir.path));
+
+      res.json({
+        success: true,
+        directories,
+      });
+    } catch (error) {
+      logError(error, "List workspace directories failed");
+      res.status(500).json({ success: false, error: getErrorMessage(error) });
+    }
+  };
+}