docs(integrator): v2.x.x update — workflow API + full changelog + schema extensions

docs/integration/api/events.md

@@ -97,6 +97,37 @@ artifact в `~/.gstack/projects/claude/`) на каждую закрытую з
 `cascadeSource` = `{dictionary, businessKey}` источника. Consumer может
 trace cascade chain.
 
+### Definition events
+
+Изменения **самой schema** dictionary (не records) emit'ятся отдельными
+event types:
+
+| `eventType` | Когда |
+|---|---|
+| `DefinitionCreated` | Новый dictionary зарегистрирован |
+| `DefinitionUpdated` | Inline PATCH schema (см. `/dictionaries/{name}/schema`) |
+
+Payload содержит `schemaJson`, `schemaVersion`, `previousSchema` (для
+updated). Consumer'ы которые кэшируют schemas инвалидируют по этим
+событиям.
+
+### Schema workflow events (v2.2.0+)
+
+Workflow draft lifecycle emit'ит дополнительные events. Все содержат
+`draftId`, `dictionaryName`, `status`, `branchedFromVersion`, `makerId`
+плюс event-specific extras:
+
+| `eventType` | Trigger | Extras |
+|---|---|---|
+| `SchemaDraftCreated` | maker создаёт draft | `fromVersion` |
+| `SchemaDraftReviewRequested` | submit на review | `reviewers[]`, `note` |
+| `SchemaDraftDecided` | reviewer вынес verdict | `decision` (approve/request_changes/reject), `reviewerId`, `comment` |
+| `SchemaDraftPublished` | publisher выпустил draft → live | `newVersion`, `publishedAt`, `publishNote` |
+| `SchemaDraftWithdrawn` | maker отозвал draft | (без extras) |
+
+Webhook router маппит эти типы в `dict.draft.*` category (см.
+[webhooks.md](webhooks.md)). Полная state machine: [schema-workflow.md](schema-workflow.md).
+
 ## Partition key
 
 Сообщения партиционируются по `dictionary + businessKey` (одна запись —