Fix rosdep install failures on Ubuntu 22.04 (Jammy) with ROS 2 Rolling

[Copilot]

Resolves rosdep dependency resolution issues for users running Ubuntu 22.04 (Jammy) with ROS 2 Rolling by providing custom rosdep definitions for missing packages.

Problem

Users building ROSA on Ubuntu 22.04 with ROS 2 Rolling encounter rosdep failures due to missing package definitions:

ERROR: the following packages/stacks could not have their rosdep keys resolved
to system dependencies:
plansys2_executor: No definition of [behaviortree_cpp] for OS version [jammy]
plansys2_popf_plan_solver: Cannot locate rosdep definition for [popf]
ros_pytest: No definition of [launch_pytest] for OS version [jammy]
rosa_task_plan_plansys: No definition of [rclcpp_cascade_lifecycle] for OS version [jammy]
rosa_monitor: No definition of [tf_transformations] for OS version [jammy]

Solution

This PR adds a comprehensive rosdep configuration solution:

Files Added

• rosdep.yaml - Custom rosdep definitions mapping missing dependencies to their Ubuntu 22.04 package names
• setup_rosdep.sh - Automated setup script that configures the custom rosdep source with proper error handling
• validate_rosdep.sh - Validation script allowing users to verify their rosdep configuration is working

Documentation Updates

• Updated README.md with Ubuntu 22.04 specific installation instructions
• Added troubleshooting section with both automated and manual setup options
• Included validation steps for users to verify their setup

Usage

For Ubuntu 22.04 (Jammy) users with ROS 2 Rolling:

# Automated setup (recommended)
./src/rosa/setup_rosdep.sh

# Optional validation
./src/rosa/validate_rosdep.sh

# Install dependencies as usual
rosdep install --from-paths src --ignore-src -r -y

Key Features

• Non-intrusive: No changes to existing package.xml files
• Comprehensive: Covers all reported problematic dependencies
• User-friendly: Provides both automated and manual setup paths
• Robust: Includes error handling and validation tools
• Well-documented: Clear instructions and troubleshooting guidance

The solution handles both ROS 2 packages (behaviortree_cpp, popf, launch_pytest, rclcpp_cascade_lifecycle) and system packages (tf_transformations) while properly managing external dependencies that are built from source.

Fixes #[issue_number]

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Rosdep install fails on Ubuntu 22.04 (Rolling) due to missing rosdep keys for ROSA dependencies</issue_title>
<issue_description>I’m trying to build ROSA on Ubuntu 22.04 (Jammy) with ROS 2 Rolling, but rosdep install fails because several dependencies are not defined for this OS version.

Here’s the command and output:

root@mohamed-IdeaPad-Pro-5-14APH8:/home/mohamed/rosa_ws# rosdep install --from-paths src --ignore-src -r -y
ERROR: the following packages/stacks could not have their rosdep keys resolved
to system dependencies:
plansys2_executor: No definition of [behaviortree_cpp] for OS version [jammy]
plansys2_popf_plan_solver: Cannot locate rosdep definition for [popf]
ros_pytest: No definition of [launch_pytest] for OS version [jammy]
ros_typedb: No definition of [launch_pytest] for OS version [jammy]
plansys2_tests: Cannot locate rosdep definition for [popf]
plansys2_bt_actions: No definition of [behaviortree_cpp] for OS version [jammy]
rosa_plan: No definition of [behaviortree_cpp] for OS version [jammy]
rosa_task_plan_plansys: No definition of [rclcpp_cascade_lifecycle] for OS version [jammy]
rosa_task_plan_bt: No definition of [behaviortree_cpp] for OS version [jammy]
rosa_kb: No definition of [launch_pytest] for OS version [jammy]
rosa_monitor: No definition of [tf_transformations] for OS version [jammy]

Some of these dependencies (like behaviortree_cpp, rclcpp_cascade_lifecycle, popf) do not seem to have rosdep keys defined for Jammy.</issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes #126

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.