pachca · lookinway · Jul 28, 2026 · Jul 25, 2026 · Jul 25, 2026 · Jul 25, 2026
diff --git a/.github/workflows/n8n.yml b/.github/workflows/n8n.yml
@@ -116,6 +116,14 @@ jobs:
       - name: Generate n8n node
         run: bun run integrations/n8n/scripts/generate-n8n.ts
 
+      # The node files are committed, but nothing else verifies they match the
+      # spec: check-generated-sync.mjs deliberately excludes integrations/**.
+      # Without this, a spec change that regenerates the node leaves the commit
+      # stale, and check-release (which diffs HEAD~1) then reports no code
+      # change and silently skips the publish.
+      - name: n8n node is in sync with the spec
+        run: git diff --exit-code -- integrations/n8n/nodes integrations/n8n/credentials
+
       - name: Check n8n release (changelog-driven)
         id: changes
         run: |

diff --git a/.github/workflows/sdk.yml b/.github/workflows/sdk.yml
@@ -99,21 +99,63 @@ jobs:
         run: bun run verify
         working-directory: sdk/typescript
 
+      # Each SDK keeps its examples in a sibling directory that the SDK build
+      # never touches, so a spec change that renames a type or adds a union
+      # member breaks the shipped examples silently. They are linked from the
+      # READMEs, so users hit it first — compile them here too.
+      - name: Typecheck TypeScript examples
+        if: github.event_name != 'pull_request' || steps.sdk_changes.outputs.ts_changed == 'true'
+        run: bun run typecheck:examples
+        working-directory: sdk/typescript
+
       - name: Compile Go SDK
         if: github.event_name != 'pull_request' || steps.sdk_changes.outputs.go_changed == 'true'
         working-directory: sdk/go/generated
         run: go build ./...
 
+      - name: Compile Go examples
+        if: github.event_name != 'pull_request' || steps.sdk_changes.outputs.go_changed == 'true'
+        working-directory: sdk/go/examples
+        # Every example is its own `package main` in one directory, so
+        # `go build ./...` only reports "main redeclared". Build them one at a
+        # time, the way a reader runs them.
+        run: for f in *.go; do go build -o /dev/null "$f" || exit 1; done
+
       - name: Compile Kotlin SDK
         if: github.event_name != 'pull_request' || steps.sdk_changes.outputs.kotlin_changed == 'true'
         working-directory: sdk/kotlin/generated
         run: ./gradlew compileKotlin -Pversion=0.0.0
 
+      - name: Compile Kotlin examples
+        if: github.event_name != 'pull_request' || steps.sdk_changes.outputs.kotlin_changed == 'true'
+        working-directory: sdk/kotlin/generated
+        run: ./gradlew compileExamplesKotlin -Pversion=0.0.0
+
       - name: Check Python SDK
         if: github.event_name != 'pull_request' || steps.sdk_changes.outputs.python_changed == 'true'
         working-directory: sdk/python/generated
         run: python3 -m py_compile $(find pachca -name '*.py')
 
+      - name: Import Python SDK and examples
+        if: github.event_name != 'pull_request' || steps.sdk_changes.outputs.python_changed == 'true'
+        working-directory: sdk/python
+        # py_compile only parses: a module-level NameError (a registry naming a
+        # type that was never imported, an example importing a model the spec no
+        # longer generates) compiles fine and blows up on import. Import for
+        # real, with httpx stubbed so the check needs no dependencies.
+        run: |
+          python3 -c '
+          import sys, types, pathlib, importlib
+          stub = types.ModuleType("httpx")
+          stub.__getattr__ = lambda name: type(name, (), {})
+          sys.modules["httpx"] = stub
+          sys.path.insert(0, "generated")
+          import pachca.models, pachca.utils
+          sys.path.insert(0, "examples")
+          for path in sorted(pathlib.Path("examples").glob("*.py")):
+              importlib.import_module(path.stem)
+          '
+
       - name: Setup .NET
         if: github.event_name != 'pull_request' || steps.sdk_changes.outputs.csharp_changed == 'true'
         uses: actions/setup-dotnet@v4
@@ -124,6 +166,11 @@ jobs:
         working-directory: sdk/csharp/generated
         run: dotnet build
 
+      - name: Compile C# examples
+        if: github.event_name != 'pull_request' || steps.sdk_changes.outputs.csharp_changed == 'true'
+        working-directory: sdk/csharp/examples
+        run: dotnet build
+
       - name: Setup Swift
         if: github.event_name != 'pull_request' || steps.sdk_changes.outputs.swift_changed == 'true'
         uses: swift-actions/setup-swift@v2
@@ -132,6 +179,11 @@ jobs:
         working-directory: sdk/swift
         run: swift build
 
+      - name: Compile Swift examples
+        if: github.event_name != 'pull_request' || steps.sdk_changes.outputs.swift_changed == 'true'
+        working-directory: sdk/swift/examples
+        run: swift build
+
       - name: Copy Swift Package.swift to root
         if: github.event_name == 'push' && steps.sdk_check.outputs.should_publish == 'true'
         run: cp sdk/swift/Package.swift Package.swift

diff --git a/.gitignore b/.gitignore
@@ -76,7 +76,6 @@ bin/
 obj/
 *.user
 *.suo
-sdk/csharp/examples/Examples.csproj
 
 # Рабочие планы/черновики — не в репозитории
 *_PLAN.md

diff --git a/apps/docs/app/.well-known/api-catalog/route.ts b/apps/docs/app/.well-known/api-catalog/route.ts
@@ -38,7 +38,7 @@ export async function GET(): Promise<Response> {
           {
             href: `${SITE_URL}/openapi.yaml`,
             type: 'application/yaml',
-            title: 'Pachca API — OpenAPI 3.1 specification',
+            title: 'Pachca API — OpenAPI 3.0 specification',
           },
           {
             href: `${SITE_URL}/pachca.postman_collection.json`,

diff --git a/apps/docs/app/robots.txt/route.ts b/apps/docs/app/robots.txt/route.ts
@@ -19,7 +19,11 @@ const rules: Rule[] = [
   // Allowed: enables Gemini / Google AI grounding & citation of these
   // docs; does NOT affect Google Search ranking.
   { userAgent: 'Google-Extended', allow: ['/'] },
-  { userAgent: '*', allow: ['/'], disallow: ['/internal/search', '/internal/og'] },
+  // `/internal/og` must stay crawlable: it is the og:image / twitter:image for
+  // every page, and Twitterbot, Slackbot, LinkedInBot and facebookexternalhit
+  // all honour robots.txt — disallowing it stripped the preview from every
+  // shared dev.pachca.com link. Only the search endpoint is worth hiding.
+  { userAgent: '*', allow: ['/'], disallow: ['/internal/search'] },
 ];
 
 // Cloudflare Content Signals Policy (2026): a machine-readable statement of

diff --git a/apps/docs/app/sitemap.ts b/apps/docs/app/sitemap.ts
@@ -4,7 +4,7 @@ import { join } from 'node:path';
 import { parseOpenAPI } from '@/lib/openapi/parser';
 import { generateUrlFromOperation } from '@/lib/openapi/mapper';
 import { getOrderedPages } from '@/lib/ordered-pages';
-import { loadUpdates, loadTimeline, groupTimelineByDate } from '@/lib/updates-parser';
+import { loadTimeline, groupTimelineByDate } from '@/lib/updates-parser';
 import { groupBySeason } from '@/lib/seasons';
 
 const BASE_URL = 'https://dev.pachca.com';
@@ -56,17 +56,20 @@ export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
     });
   }
 
-  // Per-update pages
-  const updates = loadUpdates();
-  for (const update of updates) {
+  // Per-update pages. Must match generateStaticParams in
+  // app/updates/[date]/page.tsx, which pre-renders updates ∪ releases — using
+  // loadUpdates() alone left every release-only date (a dozen of them) out of
+  // the sitemap even though the page and its .md twin both exist.
+  const timelineByDate = groupTimelineByDate(loadTimeline());
+  for (const group of timelineByDate) {
     entries.push({
-      url: `${BASE_URL}/updates/${update.date}`,
-      lastModified: new Date(update.date),
+      url: `${BASE_URL}/updates/${group.date}`,
+      lastModified: new Date(group.date),
     });
   }
 
   // Per-season pages (newest date in the season drives lastModified)
-  const seasons = groupBySeason(groupTimelineByDate(loadTimeline()));
+  const seasons = groupBySeason(timelineByDate);
   for (const sg of seasons) {
     entries.push({
       url: `${BASE_URL}/updates/season/${sg.season.slug}`,

diff --git a/apps/docs/components/mdx/cards.tsx b/apps/docs/components/mdx/cards.tsx
@@ -63,6 +63,7 @@ import {
   Gauge,
   ListOrdered,
   Upload,
+  ExternalLink,
   type LucideIcon,
 } from 'lucide-react';
 
@@ -119,6 +120,7 @@ const iconMap: Record<string, LucideIcon> = {
   Gauge,
   ListOrdered,
   Upload,
+  ExternalLink,
 };
 
 /** Icon mapping for guide pages by path */

diff --git a/apps/docs/content/guides/buttons.mdx b/apps/docs/content/guides/buttons.mdx
@@ -84,7 +84,9 @@ Data-кнопка отправляет данные на сервер через
 
 ## Ограничения
 
-- Максимальное количество кнопок в строке — 8
-- Максимальное число кнопок у сообщения — 100
+- Максимальное количество строк с кнопками — 32
 - Максимальная длина `text` на кнопке — 255 символов
 - Максимальная длина `data` у кнопки — 255 символов
+
+Количество кнопок внутри строки API не ограничивает, но в интерфейсе строка не
+переносится: больше пяти-шести кнопок в ряд читаются плохо на узких экранах.
diff --git a/apps/docs/content/guides/forms/handling.mdx b/apps/docs/content/guides/forms/handling.mdx
@@ -38,8 +38,8 @@ related:
 {
     "type": "view",
     "event": "submit",
-    "private_metadata": "{'timeoff_id':4378}",
-    "callback_id": "timeoff_reguest_form",
+    "private_metadata": "{\"timeoff_id\":4378}",
+    "callback_id": "timeoff_request_form",
     "user_id": 1235523,
     "data": {
         "date_start": "2025-07-01",

diff --git a/apps/docs/content/guides/incoming-webhooks.mdx b/apps/docs/content/guides/incoming-webhooks.mdx
@@ -129,7 +129,7 @@ Liquid также поддерживает:
   используйте API-метод [Новое сообщение](POST /messages).
 </Warning>
 
-- **Максимальная длина сообщения** — 40 000 символов. Если результат шаблона превышает этот лимит, сообщение не будет отправлено.
+- **Максимальная длина сообщения** — 40 000 байт. Для кириллицы это около 20 000 символов, поскольку каждый символ занимает два байта. Если результат шаблона превышает лимит, сообщение не будет отправлено.
 - **Пустое сообщение** — если шаблон возвращает пустую строку, сообщение не будет отправлено.
 - **Ошибка в шаблоне** — если шаблон содержит синтаксическую ошибку, в чат будет отправлено сообщение вида `Ошибка в шаблоне: описание ошибки`.
 

diff --git a/apps/docs/content/guides/n8n/resources.mdx b/apps/docs/content/guides/n8n/resources.mdx
@@ -234,7 +234,7 @@ related:
 |----------|-----|
 | Create | [Загрузка файла](POST /uploads) |
 
-Подробнее — в разделе [Продвинутые функции](/guides/n8n/advanced#zagruzka-fajlov).
+Подробнее — в разделе [Продвинутые функции](/guides/n8n/advanced#zagruzka-faylov).
 
 ---
 

diff --git a/apps/docs/content/guides/n8n/setup.mdx b/apps/docs/content/guides/n8n/setup.mdx
@@ -12,7 +12,7 @@ related:
 <CardGroup>
   <Card compact icon="ExternalLink" title="Pachca" href="https://n8n.io/integrations/pachca/">витрина · verified</Card>
   <Card compact icon="ExternalLink" title="Pachca Trigger" href="https://n8n.io/integrations/pachca-trigger/">витрина · verified</Card>
-  <Card compact icon="Package" title="n8n-nodes-pachca" href="https://www.npmjs.com/package/n8n-nodes-pachca">npm · v2.0.6</Card>
+  <Card compact icon="Package" title="n8n-nodes-pachca" href="https://www.npmjs.com/package/n8n-nodes-pachca">npm</Card>
 </CardGroup>
 
 ## Где запустить n8n

diff --git a/apps/docs/content/guides/n8n/testing.mdx b/apps/docs/content/guides/n8n/testing.mdx
@@ -76,7 +76,7 @@ related:
 
 <ImageCard src="/images/n8n/credentials-test.avif" alt="Успешная проверка Credentials" caption="Connection tested successfully" maxWidth={960} />
 
-При ошибке 401 — токен неверный или просрочен. Симптомы и решения — в разделе [401 Unauthorized](/guides/n8n/troubleshooting#nevernyi-token-401-unauthorized).
+При ошибке 401 — токен неверный или просрочен. Симптомы и решения — в разделе [401 Unauthorized](/guides/n8n/troubleshooting#nevernyy-token-401-unauthorized).
 
 ## Тестирование триггера
 
@@ -133,7 +133,7 @@ related:
     После этого запустите **Listen for Test Event**, проведите тест, снова активируйте workflow. На время теста продакшен будет выключен — учитывайте это, если на workflow приходит критичный трафик.
   </Step>
   <Step title="Подмена URL в ручном режиме">
-    Оставьте **Webhook Setup** = **Manual** (значение по умолчанию) — в [ручном режиме](/guides/n8n/trigger#ruchnoi-rezhim) узел не управляет `outgoing_url`, и вы сами решаете, какой URL прописан в настройках бота в Пачке. Можно временно вручную заменить Production URL на Test URL в настройках бота, провести тест, затем вернуть Production URL обратно.
+    Оставьте **Webhook Setup** = **Manual** (значение по умолчанию) — в [ручном режиме](/guides/n8n/trigger#ruchnoy-rezhim) узел не управляет `outgoing_url`, и вы сами решаете, какой URL прописан в настройках бота в Пачке. Можно временно вручную заменить Production URL на Test URL в настройках бота, провести тест, затем вернуть Production URL обратно.
 
     Этот способ даёт максимальный контроль, но требует аккуратности — легко забыть вернуть Production URL.
   </Step>
@@ -226,9 +226,9 @@ related:
 
 ## Если что-то пошло не так
 
-- **Вебхук не приходит** — проверьте, что бот в чате и workflow активен. Симптомы и решения: [Вебхук не приходит](/guides/n8n/troubleshooting#vebkhuk-ne-prikhodit)
+- **Вебхук не приходит** — проверьте, что бот в чате и workflow активен. Симптомы и решения: [Вебхук не приходит](/guides/n8n/troubleshooting#vebhuk-ne-prihodit)
 - **403 при активации Pachca Trigger** — токену не хватает прав: для токена бота `bot_self:webhook:write`, для персонального `bots:write` плюс доступ редактора к боту. Решение: [403 Forbidden при активации Pachca Trigger](/guides/n8n/troubleshooting#403-forbidden-pri-aktivatsii-pachca-trigger)
 - **Signature Mismatch** — Signing Secret в Credentials не совпадает с секретом бота. Решение: [Ошибка подписи](/guides/n8n/troubleshooting#oshibka-podpisi-signature-mismatch)
-- **401 Unauthorized** — неверный или просроченный токен. Решение: [401 Unauthorized](/guides/n8n/troubleshooting#nevernyi-token-401-unauthorized)
+- **401 Unauthorized** — неверный или просроченный токен. Решение: [401 Unauthorized](/guides/n8n/troubleshooting#nevernyy-token-401-unauthorized)
 
 Полный список типовых ошибок — в разделе [Устранение ошибок](/guides/n8n/troubleshooting).
diff --git a/apps/docs/content/guides/n8n/trigger.mdx b/apps/docs/content/guides/n8n/trigger.mdx
@@ -102,7 +102,7 @@ Pachca Trigger поддерживает два режима настройки:
     <ImageCard src="/images/n8n/trigger-webhook-urls.avif" alt="Test URL и Production URL в панели узла n8n" caption="Test URL и Production URL в верхней части панели узла" maxWidth={960} />
   </Step>
   <Step title="Вставьте URL в настройки бота в Пачке">
-    Откройте настройки вашего бота в Пачке, перейдите на вкладку **Исходящий Webhook** и вставьте скопированный Production URL в поле **Webhook URL**. Подробнее — в разделе [Настройка и типы событий](/guides/webhook/events#obschie-nastroiki).
+    Откройте настройки вашего бота в Пачке, перейдите на вкладку **Исходящий Webhook** и вставьте скопированный Production URL в поле **Webhook URL**. Подробнее — в разделе [Настройка и типы событий](/guides/webhook/events#obschie-nastroyki).
   </Step>
   <Step title="Вернитесь в n8n и активируйте">
     Нажмите **Activate** в n8n. С этого момента бот отправляет события в ваш workflow.
@@ -184,15 +184,15 @@ Pachca Trigger поддерживает два режима настройки:
 
 ### Проверка подписи
 
-Для защиты от поддельных запросов добавьте **Signing Secret** бота в [Credentials](/guides/n8n/setup#sozdanie-credentials). Trigger автоматически проверяет HMAC-SHA256 подпись каждого входящего запроса через заголовок `pachca-signature` и отклоняет невалидные.
+Для защиты от поддельных запросов добавьте **Signing Secret** бота в [Credentials](/guides/n8n/setup#nastroyka-credentials). Trigger автоматически проверяет HMAC-SHA256 подпись каждого входящего запроса через заголовок `pachca-signature` и отклоняет невалидные.
 
 Подробнее о механизме подписи — в разделе [Безопасность и обработчик](/guides/webhook/handler#bezopasnost).
 
 <Info>Рекомендуется всегда использовать Signing Secret в продакшене для защиты от несанкционированных запросов.</Info>
 
 ### Ограничение по IP
 
-Укажите **Webhook Allowed IPs** в [Credentials](/guides/n8n/setup#sozdanie-credentials) — через запятую список IP-адресов, с которых принимаются вебхуки. Пачка отправляет вебхуки с IP `37.200.70.177`.
+Укажите **Webhook Allowed IPs** в [Credentials](/guides/n8n/setup#nastroyka-credentials) — через запятую список IP-адресов, с которых принимаются вебхуки. Пачка отправляет вебхуки с IP `37.200.70.177`.
 
 Если поле пустое — проверка IP отключена и запросы принимаются с любого адреса.
 

diff --git a/apps/docs/content/guides/n8n/troubleshooting.mdx b/apps/docs/content/guides/n8n/troubleshooting.mdx
@@ -79,7 +79,7 @@ related:
 
 1. **Токен бота:** включите для бота скоуп `bot_self:webhook:write` — настройки бота → вкладка **API**
 2. **Персональный токен:** убедитесь, что у пользователя токена стоит роль **Редактор** в списке доступов бота, и что у токена есть скоуп `bots:write` (в настройках токена в **Автоматизации** → **Интеграции** → **API**)
-3. Либо переключите **Webhook Setup** = **Manual** и пропишите Production URL в настройках бота самостоятельно — см. [Ручной режим](/guides/n8n/trigger#ruchnoi-rezhim)
+3. Либо переключите **Webhook Setup** = **Manual** и пропишите Production URL в настройках бота самостоятельно — см. [Ручной режим](/guides/n8n/trigger#ruchnoy-rezhim)
 
 ---
-Original file line number
+Diff line change
@@ Expand Up / @@ -76,7 +76,6 @@ bin/ @@
     obj/
     *.user
     *.suo
-    sdk/csharp/examples/Examples.csproj
     # Рабочие планы/черновики — не в репозитории
     *_PLAN.md
@@ Expand Down @@