CAMEL-23566: camel-jbang - Source examples from camel-jbang-examples repository

[davsclaus]

Summary

• Replace the 3 hardcoded built-in examples with a catalog-driven system sourcing examples from the apache/camel-jbang-examples repository
• Add ExampleHelper with catalog loading, filtering by name/tag/level, bundled extraction, and GitHub fetch for online examples
• Refactor --example / --example-list in Run.java to use the catalog JSON
• --example-list now shows NAME, LEVEL, DESCRIPTION, SOURCE columns and supports filtering (e.g. --example-list beginner, --example-list ai)
• Bundled examples (7) work offline, non-bundled examples fetch from GitHub on demand
• Add -Psync-example-catalog Maven profile to download the latest catalog from the examples repo
• Bundle 7 curated examples with READMEs: timer-log, rest-api, cron-log, circuit-breaker, groovy, routes, xslt

The catalog system uses camel-jbang-example-catalog.json generated from per-example metadata.json files in the examples repo (see apache/camel-jbang-examples@66b6871).

Test plan

• ExampleHelperTest — 14 tests covering catalog loading, filtering, extraction, GitHub URL generation
• RunTest — 11 tests covering listing, filtering, unknown example suggestions, option parsing
• Manual: camel run --example-list shows all 21 examples with levels
• Manual: camel run --example-list beginner filters to 7 beginner examples
• Manual: camel run --example circuit-breaker runs the bundled example offline

🤖 Generated with Claude Code

Claude Code on behalf of Claus Ibsen

[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.

[github-actions]

🧪 CI tested the following changed modules:

• docs
• dsl/camel-jbang/camel-jbang-core

⚠️ Some tests are disabled on GitHub Actions (@DisabledIfSystemProperty(named = "ci.env.name")) and require manual verification:

• dsl/camel-jbang/camel-jbang-core: 1 test(s) disabled on GitHub Actions

💡 Manual integration tests recommended:

You modified dsl/camel-jbang/camel-jbang-core. The related integration tests in dsl/camel-jbang/camel-jbang-it are excluded from CI. Consider running them manually:

mvn verify -f dsl/camel-jbang/camel-jbang-it -Djbang-it-test

All tested modules (6 modules)

• Camel :: JBang :: Core
• Camel :: JBang :: MCP
• Camel :: JBang :: Plugin :: Route Parser
• Camel :: JBang :: Plugin :: TUI
• Camel :: JBang :: Plugin :: Validate
• Camel :: Launcher :: Container

---

⚙️ View full build and test results