Add DotFolderByPath GraphQL root query for folder tree browsing

.vscode/tasks.json

@@ -4,7 +4,7 @@
       {
         "label": "🛠️ - Build Core",
         "type": "shell",
-        "command": "if [ '${input:buildWithDocker}' = 'true' ]; then export DOCKER_HOST=unix://$HOME/.docker/run/docker.sock && just build-quicker; else just build-core-only; fi",
+        "command": "just build-core-only",
         "group": {
           "kind": "build",
           "isDefault": true
@@ -21,7 +21,7 @@
       {
         "label": "⛴️ - Build Image",
         "type": "shell",
-        "command": "export DOCKER_HOST=unix://$HOME/.docker/run/docker.sock && ./mvnw package -pl :dotcms-core -DskipTests docker:build",
+        "command": "./mvnw package -pl :dotcms-core -DskipTests docker:build",
         "group": "build",
         "problemMatcher": [],
         "presentation": {
@@ -33,9 +33,9 @@
         }
       },
       {
-        "label": "📦 - Start/Stop",
+        "label": "▶️ - Start",
         "type": "shell",
-        "command": "${workspaceFolder}/.vscode/toggle-docker.sh ${input:dockerPort}",
+        "command": "${workspaceFolder}/.vscode/toggle-docker.sh ${input:runMode} ${input:dockerPort}",
         "problemMatcher": [],
         "isBackground": true,
         "presentation": {
@@ -46,6 +46,47 @@
           "showReuseMessage": false
         }
       },
+      {
+        "label": "🛑 - Stop",
+        "type": "shell",
+        "command": "just dev-stop",
+        "problemMatcher": [],
+        "presentation": {
+          "echo": true,
+          "reveal": "always",
+          "focus": false,
+          "panel": "shared",
+          "showReuseMessage": false
+        }
+      },
+      {
+        "label": "🚀 - Build + Run",
+        "type": "shell",
+        "command": "just build-core-only && ./mvnw package -pl :dotcms-core -DskipTests docker:build && ${workspaceFolder}/.vscode/toggle-docker.sh ${input:runMode} ${input:dockerPort}",
+        "problemMatcher": [],
+        "isBackground": true,
+        "presentation": {
+          "echo": true,
+          "reveal": "always",
+          "focus": false,
+          "panel": "shared",
+          "showReuseMessage": false
+        }
+      },
+      {
+        "label": "🧹 - Clean Build",
+        "type": "shell",
+        "command": "rm -rf dotCMS/target && ./mvnw install -pl :dotcms-core -DskipTests -Ddocker.skip=true",
+        "group": "build",
+        "problemMatcher": [],
+        "presentation": {
+          "echo": true,
+          "reveal": "always",
+          "focus": false,
+          "panel": "shared",
+          "showReuseMessage": false
+        }
+      },
       {
         "label": "🧪 - Integration Tests",
         "type": "shell",
@@ -56,26 +97,30 @@
     ],
     "inputs": [
       {
-        "id": "buildWithDocker",
+        "id": "runMode",
         "type": "pickString",
-        "description": "Build with Docker image?",
+        "description": "How should dotCMS start?",
         "options": [
           {
-            "label": "No Docker (faster)",
-            "value": "false"
+            "label": "Normal - starts immediately, no debugger",
+            "value": "normal"
+          },
+          {
+            "label": "Debug - starts immediately, debugger can attach to port 5005 anytime",
+            "value": "debug"
           },
           {
-            "label": "With Docker",
-            "value": "true"
+            "label": "Debug Suspend - freezes at startup until debugger attaches to port 5005",
+            "value": "debug-suspend"
           }
         ],
-        "default": "false"
+        "default": "normal"
       },
       {
         "id": "dockerPort",
         "type": "promptString",
-        "description": "Docker HTTP port (for starting)",
+        "description": "Docker HTTP port",
         "default": "7070"
       }
     ]
-  }
+  }

.vscode/toggle-docker.sh

@@ -1,10 +1,19 @@
 #!/bin/bash
 
-# Check if dotCMS container is running
-if docker ps --format '{{.Names}}' | grep -q "dotcms"; then
-  echo "🛑 Stopping Docker..."
-  just dev-stop
-else
-  echo "▶️  Starting Docker on port ${1:-7070}..."
-  just dev-run-debug-suspend ${1:-7070}
-fi
+MODE="${1:-normal}"
+PORT="${2:-7070}"
+
+case "$MODE" in
+  debug-suspend)
+    echo "▶️  Starting Docker on port $PORT (debug-suspend, attach debugger to 5005)..."
+    ./mvnw -pl :dotcms-core -Pdocker-start,debug-suspend -Dtomcat.port="$PORT"
+    ;;
+  debug)
+    echo "▶️  Starting Docker on port $PORT (debug mode, attach debugger to 5005)..."
+    ./mvnw -pl :dotcms-core -Pdocker-start,debug -Dtomcat.port="$PORT"
+    ;;
+  *)
+    echo "▶️  Starting Docker on port $PORT..."
+    ./mvnw -pl :dotcms-core -Pdocker-start -Dtomcat.port="$PORT"
+    ;;
+esac

dotCMS/src/main/java/com/dotcms/graphql/business/FolderCollectionFieldProvider.java

@@ -0,0 +1,44 @@
+package com.dotcms.graphql.business;
+
+import static graphql.Scalars.GraphQLString;
+import static graphql.schema.GraphQLFieldDefinition.newFieldDefinition;
+
+import com.dotcms.graphql.datafetcher.FolderCollectionDataFetcher;
+import com.dotmarketing.exception.DotDataException;
+import graphql.schema.GraphQLArgument;
+import graphql.schema.GraphQLFieldDefinition;
+import graphql.schema.GraphQLNonNull;
+import graphql.schema.GraphQLOutputType;
+import java.util.Collection;
+import java.util.Set;
+
+/**
+ * Provider for the {@code DotFolderByPath} GraphQL root query field.
+ * Returns a single {@link FolderCollectionTypeProvider#DOT_FOLDER_COLLECTION_ITEM}
+ * representing a folder at a given path, with recursive children.
+ */
+public enum FolderCollectionFieldProvider implements GraphQLFieldsProvider {
+
+    INSTANCE;
+
+    public static final String DOT_FOLDER_BY_PATH = "DotFolderByPath";
+
+    @Override
+    public Collection<GraphQLFieldDefinition> getFields() throws DotDataException {
+        final GraphQLOutputType outputType = (GraphQLOutputType) FolderCollectionTypeProvider
+                .INSTANCE.getTypes().iterator().next();
+        return Set.of(newFieldDefinition()
+                .name(DOT_FOLDER_BY_PATH)
+                .argument(GraphQLArgument.newArgument()
+                        .name("path")
+                        .type(new GraphQLNonNull(GraphQLString))
+                        .build())
+                .argument(GraphQLArgument.newArgument()
+                        .name("site")
+                        .type(GraphQLString)
+                        .build())
+                .type(outputType)
+                .dataFetcher(new FolderCollectionDataFetcher())
+                .build());
+    }
+}

dotCMS/src/main/java/com/dotcms/graphql/business/FolderCollectionTypeProvider.java

@@ -0,0 +1,54 @@
+package com.dotcms.graphql.business;
+
+import static com.dotcms.graphql.util.TypeUtil.createObjectType;
+import static graphql.Scalars.GraphQLInt;
+import static graphql.Scalars.GraphQLString;
+
+import com.dotmarketing.util.Logger;
+import graphql.schema.GraphQLList;
+import graphql.schema.GraphQLObjectType;
+import graphql.schema.GraphQLOutputType;
+import graphql.schema.GraphQLType;
+import graphql.schema.GraphQLTypeReference;
+import java.util.Collection;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Provider for the DotFolderCollectionItem GraphQL type.
+ * Creates a recursive type with a self-referencing 'children' field,
+ * following the same pattern as {@link NavigationTypeProvider}.
+ */
+public enum FolderCollectionTypeProvider implements GraphQLTypesProvider {
+
+    INSTANCE;
+
+    public static final String DOT_FOLDER_COLLECTION_ITEM = "DotFolderCollectionItem";
+
+    private Map<String, GraphQLOutputType> createFolderCollectionFields() {
+        final Map<String, GraphQLOutputType> fields = new HashMap<>();
+        fields.put("folderId", GraphQLString);
+        fields.put("folderFileMask", GraphQLString);
+        fields.put("folderSortOrder", GraphQLInt);
+        fields.put("folderName", GraphQLString);
+        fields.put("folderPath", GraphQLString);
+        fields.put("folderTitle", GraphQLString);
+        fields.put("folderDefaultFileType", GraphQLString);
+        // Recursive children field using GraphQLTypeReference (same pattern as DotNavigation)
+        fields.put("children", GraphQLList.list(
+                new GraphQLTypeReference(DOT_FOLDER_COLLECTION_ITEM)));
+        return fields;
+    }
+
+    final Map<String, GraphQLOutputType> folderCollectionFields = createFolderCollectionFields();
+
+    final GraphQLObjectType folderCollectionType = createObjectType(
+            DOT_FOLDER_COLLECTION_ITEM, folderCollectionFields, null);
+
+    @Override
+    public Collection<? extends GraphQLType> getTypes() {
+        Logger.debug(this, ()->"Creating DotFolderCollectionItem types");
+        return List.of(folderCollectionType);
+    }
+}

dotCMS/src/main/java/com/dotcms/graphql/business/GraphqlAPIImpl.java

@@ -57,12 +57,14 @@ protected GraphqlAPIImpl(final GraphQLSchemaCache schemaCache) {
         typesProviders.add(QueryMetadataTypeProvider.INSTANCE);
         typesProviders.add(PaginationTypeProvider.INSTANCE);
         typesProviders.add(NavigationTypeProvider.INSTANCE);
+        typesProviders.add(FolderCollectionTypeProvider.INSTANCE);
         //Register Fields
         fieldsProviders.add(ContentAPIGraphQLFieldsProvider.INSTANCE);
         fieldsProviders.add(PageAPIGraphQLFieldsProvider.INSTANCE);
         fieldsProviders.add(QueryMetadataFieldProvider.INSTANCE);
         fieldsProviders.add(PaginationFieldProvider.INSTANCE);
         fieldsProviders.add(NavigationFieldProvider.INSTANCE);
+        fieldsProviders.add(FolderCollectionFieldProvider.INSTANCE);
         this.schemaCache = schemaCache;
     }