chore: camel-platform-http-main - Document listing files with /q/download

[davsclaus]

Documents how to list and download files with the /q/download management endpoint in platform-http-main.adoc (and the mirrored catalog copy):

• Without a file name, /q/download lists only route source files (e.g. *.camel.yaml)
• ?classpath=true also lists classpath resources
• An Ant-style pattern as the file name filters the list (e.g. /q/download/*.properties?classpath=true)
• Accept: text/html returns the list as links
• /q/download/{name} resolves from the classpath first, so unlisted classpath files can still be downloaded

The classpath=true option was not documented anywhere, which caused a user question about why the listing only showed route files.

Claude Code on behalf of davsclaus

🤖 Generated with Claude Code

[github-actions]

🌟 Thank you for your contribution to the Apache Camel project! 🌟
🤖 CI automation will test this PR automatically.

🐫 Apache Camel Committers, please review the following items:

• First-time contributors require MANUAL approval for the GitHub Actions to run
• You can use the command /component-test (camel-)component-name1 (camel-)component-name2.. to request a test from the test bot although they are normally detected and executed by CI.
• You can label PRs using skip-tests and test-dependents to fine-tune the checks executed by this PR.
• Build and test logs are available in the summary page. Only Apache Camel committers have access to the summary.

⚠️ Be careful when sharing logs. Review their contents before sharing them publicly.

[gnodet-bot]

Documentation is accurate — verified against the actual ManagementHttpServer.java implementation. The classpath=true query parameter, Ant-style pattern filtering, Accept: text/html link rendering, and classpath-first resolution are all correctly documented.

This review was generated by an AI agent, Hermès on behalf of @gnodet.

[github-actions]

🧪 CI tested the following changed modules:

• catalog/camel-catalog
• components/camel-platform-http-main

---

🔬 Scalpel shadow comparison — Scalpel: 13 of 695 tested, 26 compile-only — current: 13 all tested

Maveniverse Scalpel detected 13 affected modules (current approach: 13).

Skip-tests mode would test 13 modules (2 direct + 12 downstream), skip tests for 26 (generated code, meta-modules)

Modules Scalpel would test (13)

• camel-jbang-mcp ← downstream of org.apache.camel:camel-catalog
• camel-jbang-plugin-mcp ← downstream of org.apache.camel:camel-jbang-core
• camel-jbang-plugin-route-parser ← downstream of org.apache.camel:camel-route-parser
• camel-jbang-plugin-tui ← downstream of org.apache.camel:camel-catalog
• camel-jbang-plugin-validate ← downstream of org.apache.camel:camel-yaml-dsl-validator
• camel-launcher-container ← downstream of org.apache.camel:camel-launcher
• camel-mcp-server ← downstream of org.apache.camel:camel-platform-http-main
• camel-micrometer-prometheus ← downstream of org.apache.camel:camel-platform-http-main
• camel-oauth ← downstream of org.apache.camel:camel-platform-http-main
• camel-observability-services ← downstream of org.apache.camel:camel-micrometer-prometheus
• camel-platform-http-main ← components/camel-platform-http-main/src/main/docs/platform-http-main.adoc
• camel-yaml-dsl-validator ← downstream of org.apache.camel:camel-catalog
• camel-yaml-dsl-validator-maven-plugin ← downstream of org.apache.camel:camel-yaml-dsl-validator

Modules with tests skipped (26)

• apache-camel
• camel-allcomponents
• camel-catalog-console
• camel-catalog-maven
• camel-catalog-suggest
• camel-componentdsl
• camel-endpointdsl
• camel-endpointdsl-support
• camel-itest
• camel-jbang-core
• camel-jbang-it
• camel-jbang-main
• camel-jbang-plugin-edit
• camel-jbang-plugin-generate
• camel-jbang-plugin-kubernetes
• camel-jbang-plugin-test
• camel-kamelet-main
• camel-launcher
• camel-report-maven-plugin
• camel-route-parser
• camel-yaml-dsl
• camel-yaml-dsl-deserializers
• camel-yaml-dsl-maven-plugin
• coverage
• docs
• dummy-component

ℹ️ Shadow mode — Scalpel observes but does not affect test execution. Learn more

All tested modules (40 modules, 6m 27s total)

Total reactor time: 6m 27s

Module	Duration	Status
Camel :: AI :: MCP Server	52.4s	SUCCESS
Camel :: Launcher	51.6s	SUCCESS
Camel :: JBang :: MCP	40.0s	SUCCESS
Camel :: JBang :: Plugin :: TUI	31.4s	SUCCESS
Camel :: OAuth	25.3s	SUCCESS
Camel :: Catalog :: Camel Catalog	21.8s	SUCCESS
Camel :: Component DSL	18.9s	SUCCESS
Camel :: YAML DSL	18.1s	SUCCESS
Camel :: JBang :: Plugin :: Kubernetes	14.6s	SUCCESS
Camel :: Docs	14.4s	SUCCESS
Camel :: Platform HTTP :: Main	13.8s	SUCCESS
Camel :: Catalog :: Camel Report Maven Plugin	10.5s	SUCCESS
Camel :: YAML DSL :: Validator	10.0s	SUCCESS
Camel :: JBang :: Plugin :: Testing	8.0s	SUCCESS
Camel :: YAML DSL :: Deserializers	7.9s	SUCCESS
Camel :: Catalog :: Camel Route Parser	6.9s	SUCCESS
Camel :: Kamelet Main	6.5s	SUCCESS
Camel :: JBang :: Plugin :: Validate	4.8s	SUCCESS
Camel :: All Components Sync point	4.3s	SUCCESS
Camel :: YAML DSL :: Validator Maven Plugin	4.0s	SUCCESS
Camel :: YAML DSL :: Maven Plugins	3.0s	SUCCESS
Camel :: Micrometer :: Prometheus	2.7s	SUCCESS
Camel :: Catalog :: Maven	1.9s	SUCCESS
Camel :: Catalog :: Suggest (deprecated)	1.6s	SUCCESS
Camel :: JBang :: Plugin :: Edit	1.4s	SUCCESS
Camel :: JBang :: Integration tests	1.3s	SUCCESS
Camel :: JBang :: Main	1.3s	SUCCESS
Camel :: Coverage	1.3s	SUCCESS
Camel :: Catalog :: Dummy Component	1.2s	SUCCESS
Camel :: Assembly	1.0s	SUCCESS
Camel :: Catalog :: Console	1.0s	SUCCESS
Camel :: JBang :: Plugin :: Generate	0.9s	SUCCESS
Camel :: Launcher :: Container	0.7s	SUCCESS
Camel :: JBang :: Plugin :: MCP	0.7s	SUCCESS
Camel :: JBang :: Plugin :: Route Parser	0.7s	SUCCESS
Camel :: Endpoint DSL :: Support	0.6s	SUCCESS
Camel :: Observability Services	0.4s	SUCCESS
Camel :: Endpoint DSL	n/a
Camel :: Integration Tests	n/a
Camel :: JBang :: Core	n/a

Top 20 slowest modules:

• Camel :: AI :: MCP Server (52.4s)
• Camel :: Launcher (51.6s)
• Camel :: JBang :: MCP (40.0s)
• Camel :: JBang :: Plugin :: TUI (31.4s)
• Camel :: OAuth (25.3s)
• Camel :: Catalog :: Camel Catalog (21.8s)
• Camel :: Component DSL (18.9s)
• Camel :: YAML DSL (18.1s)
• Camel :: JBang :: Plugin :: Kubernetes (14.6s)
• Camel :: Docs (14.4s)
• Camel :: Platform HTTP :: Main (13.8s)
• Camel :: Catalog :: Camel Report Maven Plugin (10.5s)
• Camel :: YAML DSL :: Validator (10.0s)
• Camel :: JBang :: Plugin :: Testing (8.0s)
• Camel :: YAML DSL :: Deserializers (7.9s)
• Camel :: Catalog :: Camel Route Parser (6.9s)
• Camel :: Kamelet Main (6.5s)
• Camel :: JBang :: Plugin :: Validate (4.8s)
• Camel :: All Components Sync point (4.3s)
• Camel :: YAML DSL :: Validator Maven Plugin (4.0s)

---

⚙️ View full build and test results