Search docs
Docs searchValidation rule
Back to Rule CatalogAP-EVT-001Event ArchitecturePublished event has no handler
Flags events that appear to be published without any subscribed handler.
warningviolationNo auto-fix
How to fix
- Add or restore the expected handler.
- Remove the event if it is obsolete.
- Align event names between publisher, contract, and handler registration.
What it means
Code emits an event, but ArchPilot cannot find evidence that anything consumes it.
Why it matters
Unhandled events can represent dead integration paths or missed side effects.
Common causes
- A handler was removed but publisher stayed.
- The handler registration is missing.
- Event naming drift prevents matching publisher and handler.
Example bad pattern
RepositoryUploadedEvent is published, but no handler is registered.Example good pattern
RepositoryUploadedEvent has a registered handler or is removed from the workflow.Related files/config
apps/api/srcpackages/contracts/src
Related CLI commands
archpilot validatearchpilot validate --ci
Related docs