Module mapping 

Per-connection field/state mapping policy (ADR 0010).

The signal that carries a ticket’s status is configured per connection, not fixed per provider — GitLab free encodes workflow in workflow:: scoped labels while Premium uses a native status field; Asana uses a completed flag, a section, or a custom field depending on the workspace. A StateMapping declares which signal a connection reads and how its raw values translate onto the normalized [StateCategory]. The connector extracts the raw value per the signal; the mapping is pure translation, so it is trivially testable in isolation.

Structs

FieldMapping

Maps canonical ticket fields onto a provider’s arbitrary field ids, for schemaless platforms (Monday / Airtable) where even title, assignee, and status are user-named columns. Unset entries fall back to the connector’s built-in field knowledge.

StateMapping

Resolves a provider’s raw status value to a normalized [StateCategory].

Enums

ReverseError

Failure resolving a normalized category back to a board column for write-back.

StateSignal

Where a connection reads a ticket’s status from.