Search docs

Docs search
Back to Rule Catalog
AP-EVT-001Event Architecture

Published event has no handler

Flags events that appear to be published without any subscribed handler.

warningviolationNo auto-fix

How to fix

  1. Add or restore the expected handler.
  2. Remove the event if it is obsolete.
  3. 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/src
  • packages/contracts/src

Related CLI commands

  • archpilot validate
  • archpilot validate --ci
AP-EVT-001 - Published event has no handler | ArchPilot Docs