Add DotFolderByPath GraphQL root query for folder tree browsing

[fmontes]

folder-gql.mp4

Summary

Closes #34692

Adds a new DotFolderByPath GraphQL root query that returns a folder at a given path with recursive children traversal, enabling full folder tree browsing.

Example:

query {
  DotFolderByPath(path: "/application/") {
    folderTitle
    folderPath
    children {
      folderTitle
      folderPath
    }
  }
}

Implementation

Follows the established provider pattern (same as DotNavigation):

• FolderCollectionTypeProvider — defines DotFolderCollectionItem type with recursive children field using GraphQLTypeReference
• FolderCollectionFieldProvider — defines the DotFolderByPath(path: String!) root query field returning a single folder object
• FolderCollectionDataFetcher — resolves the folder at the given path via FolderAPI.findFolderByPath(), eagerly loads children with configurable max depth (GRAPHQL_FOLDER_COLLECTION_MAX_DEPTH, default 3)
• GraphqlAPIImpl — registered both new providers

Design decisions

• Query name DotFolderByPath instead of DotFolder to avoid conflict with the existing DotFolder type in CustomFieldType.FOLDER
• Max depth default 3 (configurable via env var) to limit eager loading performance impact
• Children return null on error instead of empty list, so clients can distinguish "no children" from "error loading children"
• Specific exception handling — catches DotSecurityException (permission denied), DotDataException (data layer), and generic Exception separately with distinct log messages
• folderId uses folder.getInode() — consistent with existing DotFolderTransformerImpl

Files changed

File	Change
FolderCollectionTypeProvider.java	New — recursive GraphQL type
FolderCollectionFieldProvider.java	New — root query field
FolderCollectionDataFetcher.java	New — data fetcher with depth guard
FolderCollectionDataFetcherTest.java	New — unit tests
GraphqlAPIImpl.java	Modified — register providers

Test plan

• Unit tests for FolderCollectionDataFetcher
• Build passes (./mvnw install -pl :dotcms-core -DskipTests)
• Manual test: query DotFolderByPath(path: "/") returns root folder with children
• Manual test: nested children queries resolve correctly
• Manual test: non-existent path returns null
• Integration tests verify schema structure

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR adds extensive GitHub Actions CI/CD workflow infrastructure and improvements to support multi-Java-version releases, enhanced testing, and better developer experience through GitHub Codespaces integration.

Changes:

• Introduces new release workflows with Java version override capabilities
• Adds PR area labeling automation for better issue organization
• Creates GitHub Codespaces configuration for cloud-based development
• Implements Cursor IDE rules and Claude Code agent/skill system for AI-assisted code review
• Refactors issue templates for better team collaboration

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
.github/workflows/cicd_comp_release-prepare-phase.yml	New workflow for preparing releases with version validation and branch creation
.github/workflows/cicd_comp_release-phase.yml	New workflow for release artifact deployment and SBOM generation
.github/workflows/cicd_6-release.yml	Main release orchestration workflow with Java version override support
.github/workflows/cicd_comp_deployment-phase.yml	Enhanced deployment phase with Java version and artifact suffix support
.github/workflows/cicd_comp_build-phase.yml	Updated build phase with Java version and compiler release override capabilities
.github/workflows/cicd_comp_pr-area-labeler.yml	New workflow for automatically labeling PRs based on changed file paths
.github/workflows/cicd_comp_finalize-phase.yml	Enhanced finalization with comprehensive job status checking via GitHub API
.github/filters.yaml	Expanded filter definitions for area labeling and test triggering
.github/area-labels.yml	Configuration mapping file path filters to GitHub area labels
.github/actions/core-cicd/maven-job/action.yml	Enhanced Maven job action with Java version override and compiler release configuration
.devcontainer/devcontainer.json	New GitHub Codespaces configuration with Docker-in-Docker support
.devcontainer/setup.sh	Setup script for initializing Codespaces environment with dotCMS services
.claude/skills/review/SKILL.md	New AI-powered PR review skill with multi-agent architecture
.claude/agents/file-classifier.md	Agent for classifying PR files by domain for specialized review
.cursor/rules/*.mdc	Cursor IDE context rules for Java, frontend, testing, and documentation
.github/ISSUE_TEMPLATE/*.yaml	Refactored issue templates (defect, feature, task, spike, epic, pillar)

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 5 comments.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 5 comments.

[fabrizzio-dotCMS]

A postman test is in order here

[fmontes]

@nollymar @fabrizzio-dotCMS @hassandotcms @dsilvam ready here...

foldergql2.mp4