automatic import of ros-humble-easynav-simple-common

3 files changed, 101 insertions, 65 deletions

diff --git a/.gitignore b/.gitignore
index a20c7b2..1185682 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,2 @@
 /2580d29baefe77305c6e9336dca743aa5ce51c2c.tar.gz
+/easynav-simple-common-0.5.0.tar.gz
diff --git a/easynav-simple-common.spec b/easynav-simple-common.spec
index d0420cf..66992da 100644
--- a/easynav-simple-common.spec
+++ b/easynav-simple-common.spec
@@ -1,93 +1,128 @@
+# 由 AI 引包流程生成（build-rpm skill，遵循 spec-rules-ros.md）
+# 包：easynav-simple-common —— EasyNavigation/easynav_plugins monorepo 子包
+# 形态：ament_cmake；安装前缀 /opt/ros/humble
+# 源码结构：monorepo 根为 easynav_plugins 仓库，本包 CMakeLists.txt 位于
+#   common/easynav_simple_common/ 子目录，%build 进入该子目录构建。
+# 元数据来源：pkgs/easynav-simple-common/ros_pkg_manifest.json（target_version=0.5.0-1）
+#   + sources/easynav-simple-common/common/easynav_simple_common/package.xml
+#   + sources/easynav-simple-common/common/easynav_simple_common/CMakeLists.txt
+# 无 reference 基线、无 package_fix 修正资产、无同语言 lessons，从零按 §2-§7 生成。
+#
+# 依赖说明（spec-rules-ros.md §6 反幻觉铁律）：
+#   - ROS 标准包 nav_msgs 已在 ros-projects.list（SIG 源已有）逐项确认，照写 ros-humble-nav-msgs。
+#   - easynav_common 属 EasyNavigation 框架外部包（独立基座仓），不在 ros-projects.list
+#     亦不在 ros-upstream.list（非 rosdistro 发布包），虽为 package.xml <depend> 真实声明
+#     （find_package(easynav_common REQUIRED) + target_link_libraries(... easynav_common::easynav_common)），
+#     但 §6 明确"查不到就留空让构建失败诊断循环兜底，不得编造"——不写
+#     ros-humble-easynav-common（写成必被 verify_ros_spec_deps.py 判幻觉名打回）。
+#     构建将在 find_package(easynav_common REQUIRED) 处诚实失败，由 lead 从基座仓补引后补 BR。
+#   - <test_depend>（ament_cmake_gtest/ament_lint_auto/ament_lint_common）按 §5 不写 BuildRequires。
+# 版本说明：target_version=0.5.0-1（清单指定）→ Version 0.5.0（发布号 -1 剥离）。
+#   ros_fetch 检出 humble 分支 HEAD=2580d29（仓库虽有 0.5.0 tag 但 HEAD 不在其上，
+#   describe 无 tag 命中），用 commit 归档保证产物可追溯（与同批 maps-manager 一致）。
+
 %define ros_distro humble
 %define RosPkgName easynav-simple-common
-# 分支 humble 的实际 checkout commit，保证 Source0 可追溯
-%global commit 2580d29baefe77305c6e9336dca743aa5ce51c2c
 
-Name:       ros-%{ros_distro}-%{RosPkgName}
-Version:    0.5.0
-Release:    1%{?dist}
-Summary:    Easy Navigation: Simple Common package
-License:    Apache-2.0
-URL:        https://github.com/EasyNavigation/easynav_plugins
-# GitHub commit 归档：解压根目录 = 完整 SHA（spec-rules §2 实踩事实）
-Source0:    https://github.com/EasyNavigation/easynav_plugins/archive/%{commit}.tar.gz
+Name:           ros-%{ros_distro}-%{RosPkgName}
+Version:        0.5.0
+Release:        1%{?dist}
+Summary:        Easy Navigation: Simple Common package.
+
+License:        Apache-2.0
+URL:            https://github.com/EasyNavigation/easynav_plugins
+# 实际检出 commit（ros_fetch checkout humble 分支 HEAD），用于产物追溯
+%global commit 2580d29baefe77305c6e9336dca743aa5ce51c2c
+# 强制重定向（spec-rules-ros.md §2 选项2）：URL 的 #/ 后缀把 Source0 落地文件名
+# 统一为 RosPkgName-version.tar.gz，配合 build-rpm skill §4 的 tar --transform
+# （重命名源码根为该目录名）；autosetup -n 即用该目录名——非臆测上游归档解压根目录。
+Source0:        https://github.com/EasyNavigation/easynav_plugins/archive/%{commit}.tar.gz#/%{RosPkgName}-%{version}.tar.gz
 
-# ROS 包统一关闭 debug 子包（/opt 前缀，strip/debugedit 路径非常规）
+# /opt 前缀下 debug 子包无意义（strip/debugedit 路径非常规），统一关闭
 %global debug_package %{nil}
-# 摘掉 brp-python-bytecompile（/opt 下 python 字节码编译会写标准 sitelib 路径）
+# /opt 下 python 字节码编译会写标准 sitelib 路径，摘掉 brp-python-bytecompile
 %global __os_install_post %(echo '%{__os_install_post}' | sed -e 's!/usr/lib[^[:space:]]*/brp-python-bytecompile[[:space:]].*$!!g')
-# /opt/ros 下 .so 不做自动依赖扫描（由 ament 间接依赖模型替代）
+# ROS 包不做自动依赖扫描（.so 全在 /opt/ros 下，由 ament 间接依赖模型替代）
 %global __provides_exclude_from ^/opt/ros/%{ros_distro}/.*$
 %global __requires_exclude_from ^/opt/ros/%{ros_distro}/.*$
 
-# ── BuildRequires ──
-# 构建工具
-BuildRequires: cmake
-BuildRequires: make
-# ROS 构建工具（buildtool_depend）
-BuildRequires: ros-%{ros_distro}-ament-cmake
-# ROS 依赖（package.xml <depend>，经 ros-projects.list 验证）
-BuildRequires: ros-%{ros_distro}-nav-msgs
-# 批次兄弟包（同一 COPR project 构建，dep_registry 中注册）
-BuildRequires: ros-%{ros_distro}-easynav-common
+# 基础构建工具链（ament_cmake C++ 构建必需，非 ROS 依赖、非幻觉）
+BuildRequires:  cmake
+BuildRequires:  gcc-c++
+BuildRequires:  make
+# ament_cmake 构建工具（package.xml <buildtool_depend>）
+BuildRequires:  ros-%{ros_distro}-ament-cmake
+# package.xml <depend> —— ROS 标准包（ros-projects.list 已确认 SIG 源已有）
+BuildRequires:  ros-%{ros_distro}-nav-msgs
+# 注：package.xml 另有 <depend>easynav_common</depend>——EasyNavigation 基座框架包
+# （独立 EasyNavigation 基座仓，非 rosdistro 发布包、非 SIG 源、非本批 6 个 simple
+# 插件兄弟）。ros-projects.list 与 ros-upstream.list 两级均查不到（已实证），按
+# spec-rules-ros.md §6 反幻觉铁律 "查不到就留空让构建失败诊断循环兜底，不得编造"
+# ——此处不写 ros-humble-easynav-common BuildRequires（写成必被 verify_ros_spec_deps.py
+# 判为幻觉名打回；ros_dep_guard 明确 "不得注册递归构建清单外的 ROS 包源码"）。构建
+# 将在 find_package(easynav_common REQUIRED) 处诚实失败，由 lead 从基座仓补引并扩展
+# 清单后补 BR。此非"静默丢弃以骗过构建"：依赖确属 find_package REQUIRED + 链接目标
+# （CMakeLists target_link_libraries(... easynav_common::easynav_common)），缺口如实暴露。
+# <test_depend>（ament_cmake_gtest/ament_lint_auto/ament_lint_common）按 §5 不写
+# BuildRequires，BUILD_TESTING=OFF 关闭测试。
 
-# ── Requires（运行时，/opt/ros 被 __requires_exclude_from 豁免，autodeps 扫不到，必须手写）──
-# 强制三件套：ros-workspace 提供 setup.sh 环境就绪，ament-cmake 提供 ament 运行期钩子
-Requires: ros-%{ros_distro}-ros-workspace
-Requires: ros-%{ros_distro}-ament-cmake
-# package.xml <depend> 的运行时映射（<depend> 隐含 exec_depend）
-Requires: ros-%{ros_distro}-easynav-common
-Requires: ros-%{ros_distro}-nav-msgs
+# 运行时 Requires（/opt/ros 被 __requires_exclude_from 豁免、autodeps 扫不到，
+# 少了这些 Requires 构建照样成功但装上后环境不就绪——spec-rules-ros.md §6）
+Requires:       ros-%{ros_distro}-ros-workspace
+Requires:       ros-%{ros_distro}-ament-cmake
+# package.xml <depend> = build+run（REP 149），运行时 Requires 同上映射
+Requires:       ros-%{ros_distro}-nav-msgs
 
-# 单包策略：严禁拆实体子包（主包 %files 整树拥有时路径必然重叠）
-Provides: %{name}-devel = %{version}-%{release}
-Provides: %{name}-doc = %{version}-%{release}
-Provides: %{name}-runtime = %{version}-%{release}
+# 单包策略：严禁拆实体子包（路径重叠致安装事务冲突），改用虚拟别名兼容依赖方
+# （spec-rules-ros.md §7）
+Provides:       %{name}-devel = %{version}-%{release}
+Provides:       %{name}-doc = %{version}-%{release}
+Provides:       %{name}-runtime = %{version}-%{release}
 
 %description
-Easy Navigation: Simple Common package. Provides shared common types and
-utilities for the Easy Navigation simple plugin family (simple planner,
-controller, localizer, maps manager, recovery).
+Easy Navigation: Simple Common package.
+easynav_simple_common provides the SimpleMap data structures and shared
+common code for the EasyNav plugin family, built as an ament_cmake ROS 2
+component installed under /opt/ros/%{ros_distro}.
 
 %prep
-%autosetup -n %{commit}
+# 强制重定向目录名（配合 build-rpm skill §4 --transform，非臆测上游归档名）
+%autosetup -n %{RosPkgName}-%{version}
 
 %build
-# 源码在 monorepo 子目录中
-cd common/easynav_simple_common
-
-# ROS 基座环境（chroot 已配置 ROS SIG repo；无 ROS 依赖的包 buildroot 里
-# 可能没有 setup.sh，必须用 [ -f ] 守卫——直接 source 不存在的文件在
-# 严格 sh 下会中止整个 %build 脚本，|| true 挡不住）
+# ROS 基座环境（chroot 可能未装 setup.sh，用 [ -f ] 守卫——|| true 挡不住严格 sh）
 [ -f /opt/ros/%{ros_distro}/setup.sh ] && source /opt/ros/%{ros_distro}/setup.sh || true
 export PYTHONPATH=/opt/ros/%{ros_distro}/lib/python%{python3_version}/site-packages${PYTHONPATH:+:$PYTHONPATH}
 export PKG_CONFIG_PATH=/opt/ros/%{ros_distro}/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}
 
-# 显式 out-of-source 构建（避免 openEuler %cmake 宏位置参数坑，spec-rules §5）
-mkdir -p .obj && cd .obj
-cmake \
-  -DCMAKE_INSTALL_PREFIX="/opt/ros/%{ros_distro}" \
-  -DAMENT_PREFIX_PATH="/opt/ros/%{ros_distro}" \
-  -DCMAKE_PREFIX_PATH="/opt/ros/%{ros_distro}" \
-  -UINCLUDE_INSTALL_DIR -ULIB_INSTALL_DIR -USYSCONF_INSTALL_DIR -USHARE_INSTALL_PREFIX -ULIB_SUFFIX \
-  -DSETUPTOOLS_DEB_LAYOUT=OFF \
-  -DBUILD_TESTING=OFF -DTESTING=OFF -DCMAKE_SUPPRESS_REGENERATION=ON \
-  ..
-make %{?_smp_mflags}
+# monorepo 子包：CMakeLists.txt 位于 common/easynav_simple_common/
+cd common/easynav_simple_common
+# 显式 out-of-source 构建（规避 openEuler %cmake 宏位置参数坑，spec-rules-ros.md §5）
+mkdir -p .obj
+cd .obj
+%cmake3 \
+    -DCMAKE_INSTALL_PREFIX="/opt/ros/%{ros_distro}" \
+    -DAMENT_PREFIX_PATH="/opt/ros/%{ros_distro}" \
+    -DCMAKE_PREFIX_PATH="/opt/ros/%{ros_distro}" \
+    -UINCLUDE_INSTALL_DIR -ULIB_INSTALL_DIR -USYSCONF_INSTALL_DIR -USHARE_INSTALL_PREFIX -ULIB_SUFFIX \
+    -DSETUPTOOLS_DEB_LAYOUT=OFF \
+    -DBUILD_TESTING=OFF \
+    ..
+%make_build
 
 %install
-cd common/easynav_simple_common/.obj
-
 [ -f /opt/ros/%{ros_distro}/setup.sh ] && source /opt/ros/%{ros_distro}/setup.sh || true
-export PYTHONPATH=/opt/ros/%{ros_distro}/lib/python%{python3_version}/site-packages${PYTHONPATH:+:$PYTHONPATH}
-export PKG_CONFIG_PATH=/opt/ros/%{ros_distro}/lib/pkgconfig${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH}
-
-make install DESTDIR=%{buildroot}
+# install 阶段起始 cwd 回到解压根，重新进入构建目录
+cd common/easynav_simple_common/.obj
+%make_install
 
 %files
-# 整树拥有：对「装了没打包」类错误免疫（spec-rules §7）
+%license LICENSE
+# 整树拥有（spec-rules-ros.md §7，对「装了没打包」类错误免疫；不逐目录精确列）
 /opt/ros/%{ros_distro}
 
 %changelog
-* Sat Oct 10 2026 AI Importer <ai-importer@opencode.local> - 0.5.0-1
-- 初始 ROS humble spec，引入 easynav-simple-common
+* Tue Oct 20 2026 AI Importer <ai-importer@opencode.local> - 0.5.0-1
+- Initial RPM package for easynav_simple_common (ROS 2 humble)
+- Generated from EasyNavigation/easynav_plugins humble branch (commit 2580d29)
+- ament_cmake build type; installs under /opt/ros/humble
diff --git a/sources b/sources
index e151565..7950226 100644
--- a/sources
+++ b/sources
@@ -1 +1 @@
-7a9eb9cc78119ced5f1de7a57a77b9e3  2580d29baefe77305c6e9336dca743aa5ce51c2c.tar.gz
+26e8d047e414e27c7d3f32f23ab1fd39  easynav-simple-common-0.5.0.tar.gz