refactor(agnocastlib): remove event-specific logic from agnocast_epoll.cpp and .hpp

[ruth561]

Description

This PR refactors agnocast_epoll.cpp and .hpp to improve code maintainability and make it easier to add new events in the future.

Problem

Previously, the event-specific logic for handling epoll events was written directly inside agnocast_epoll.cpp and .hpp. This caused high code dependency. Every time a new event was added, the dependency grew, making the code harder to manage.

Changes

• Removed event-specific processing from agnocast_epoll.cpp and .hpp.
• Moved the logic for each event into its own separate source file.
• Introduced EpollEventHandler, an abstract base class. The logic for each event is now implemented in a derived class that inherits from this base class.
• Introduced EpollManager, a new class to manage epoll and call these event handlers.

Related links

close #969
#1271

How was this PR tested?

• Autoware (required)
• bash scripts/test/e2e_test_1to1.bash (required)
• bash scripts/test/e2e_test_2to2.bash (required)
• kunit tests (required when modifying the kernel module)
• bash scripts/test/run_requires_kernel_module_tests.bash (required)
• sample application

Notes for reviewers

Version Update Label (Required)

Please add exactly one of the following labels to this PR:

• need-major-update: User API breaking changes
• need-minor-update: Internal API breaking changes (heaphook/kmod/agnocastlib compatibility)
• need-patch-update: Bug fixes and other changes

Important notes:

• If you need need-major-update or need-minor-update, please include this in the PR title as well.
  • Example: fix(foo)[needs major version update]: bar or feat(baz)[needs minor version update]: qux
• After receiving approval from reviewers, add the run-build-test label. The PR can only be merged after the build tests pass.

See CONTRIBUTING.md for detailed versioning rules.

[Copilot]

Pull request overview

This PR refactors Agnocast’s epoll handling to decouple event-specific logic from the epoll loop and make epoll updates per-executor, improving extensibility for new epoll event types.

Changes:

• Introduces an EpollManager + EpollEventHandler interface and moves per-event handling into dedicated handler classes/files.
• Replaces the global need_epoll_updates mechanism with a per-executor EpollUpdateDispatcher/EpollUpdateTracker notification model.
• Adds new unit/integration tests covering epoll data packing/unpacking and epoll-update behavior across executor lifecycle orderings.

Reviewed changes

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

Show a summary per file

File	Description
src/agnocastlib/src/agnocast_epoll.cpp	Implements EpollManager and routes events to handler objects.
src/agnocastlib/include/agnocast/agnocast_epoll.hpp	Defines handler interface, EpollManager, and handler array types.
src/agnocastlib/include/agnocast/agnocast_epoll_event.hpp	Adds epoll data packing/unpacking and event type enum.
src/agnocastlib/src/agnocast_epoll_update_dispatcher.cpp	Implements per-executor epoll update dispatcher/tracker.
src/agnocastlib/include/agnocast/agnocast_epoll_update_dispatcher.hpp	Declares dispatcher/tracker API used by executors and registrars.
src/agnocastlib/src/agnocast_callback_info.cpp	Moves subscription epoll prepare/handle logic into SubscriptionEventHandler.
src/agnocastlib/include/agnocast/agnocast_callback_info.hpp	Adds callback-ID max constants and declares SubscriptionEventHandler.
src/agnocastlib/src/agnocast_timer_info.cpp	Moves timer/clock epoll prepare/handle logic into TimerEventHandler/ClockEventHandler; switches to dispatcher notifications.
src/agnocastlib/include/agnocast/agnocast_timer_info.hpp	Adds timer-ID max constants and declares new timer/clock handler classes.
src/agnocastlib/src/agnocast_executor.cpp	Switches executor epoll usage to EpollManager and per-executor update tracker.
src/agnocastlib/include/agnocast/agnocast_executor.hpp	Stores EpollManager and EpollUpdateTracker in base executor.
src/agnocastlib/src/agnocast_single_threaded_executor.cpp	Uses EpollUpdateTracker::take_update_request() to trigger epoll preparation.
src/agnocastlib/src/agnocast_multi_threaded_executor.cpp	Uses EpollUpdateTracker::take_update_request() to trigger epoll preparation.
src/agnocastlib/src/node/agnocast_only_executor.cpp	Refactors Agnocast-only executor to use EpollManager + per-executor update tracker; requests updates on node/group changes.
src/agnocastlib/include/agnocast/node/agnocast_only_executor.hpp	Replaces raw epoll_fd_ with EpollManager and adds tracker member.
src/agnocastlib/src/node/agnocast_only_single_threaded_executor.cpp	Uses tracker-driven epoll updates and EpollManager::prepare_epoll().
src/agnocastlib/src/node/agnocast_only_multi_threaded_executor.cpp	Uses tracker-driven epoll updates and EpollManager::prepare_epoll().
src/agnocastlib/test/unit/test_mocked_agnocast.cpp	Updates ID overflow boundary tests to use new MAX_* constants.
src/agnocastlib/test/unit/test_agnocast_epoll_update.cpp	Adds unit tests for dispatcher/tracker update semantics.
src/agnocastlib/test/unit/test_agnocast_epoll_event.cpp	Adds unit tests for epoll data packing/unpacking.
src/agnocastlib/test/integration/test_agnocast_epoll_update.cpp	Adds integration tests validating epoll updates across executor operation order permutations.
src/agnocastlib/CMakeLists.txt	Registers new source/test files and adds a new integration test target.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.