@goodandready/dsh-kanban 0.2.18 → 0.2.20

package/lib/transitions.js

@@ -1,46 +1,36 @@
-// Автоперемещение карточек: вывод колонки из наблюдений и приоритет источников.
-//
-// Модуль чистый — ни сети, ни хранилища, ни харнесса. Наблюдения приходят
-// готовыми, решение возвращается значением. Поэтому вся логика переходов
-// проверяется тестами, а места, где она вызывается, остаются тонкими.
+// Card auto-movement: derive column from observations and source priority.
+// Pure module without network, storage, or harness dependencies.
+// Observations arrive as data, verdicts return as values.
 
 /**
- * Приоритет источников. Без него «PR влит → deploy» через секунду перебивалось
- * бы «ход завершился → in-progress», и карточка прыгала бы туда-сюда.
- *
- * Меньше число — сильнее источник.
+ * Source priority.
+ * Lower number indicates higher priority source.
  */
 const PRIORITY = { gitea: 0, tool: 1, session: 2, manual: 3 }
 
-/** Pull request считается черновиком, пока с него не снят признак WIP. */
+/** Pull request is draft while marked with WIP prefix or draft flag. */
 export function isDraftPull(pull) {
   if (pull?.draft === true) return true
   return /^\s*(wip|draft)\b[:\s-]/i.test(String(pull?.title ?? ''))
 }
 
 /**
- * Колонка, которую диктуют наблюдения в Gitea.
- *
- * Порядок проверок идёт от самого позднего состояния к самому раннему: задача
- * не может «вернуться» в in-progress только потому, что ветка ещё цела, если
- * issue уже закрыт.
- *
- * WIP PR намеренно НЕ двигает карточку в review: он открывается рано и означает
- * «работа идёт», а не «смотрите».
- *
- * @param {object} obs наблюдения
- * @param {object} [obs.issue] issue из Gitea (`state`)
- * @param {Array}  [obs.pulls] pull request-ы, связанные с задачей
- * @param {boolean} [obs.branchExists] существует ли ветка задачи
- * @returns {string|undefined} колонка либо undefined, если наблюдения молчат
+ * Target column derived from forge observations.
+ * Evaluated from latest lifecycle state to earliest.
+ * WIP PR intentionally does NOT move card to review.
+ * @param {object} obs observations
+ * @param {object} [obs.issue] issue from Gitea (`state`)
+ * @param {Array}  [obs.pulls] pull requests related to task
+ * @param {boolean} [obs.branchExists] whether task branch exists
+ * @returns {string|undefined} column or undefined if observations silent
  */
 export function deriveColumn(obs) {
   const issueClosed = obs?.issue?.state === 'closed'
   const pulls = Array.isArray(obs?.pulls) ? obs.pulls : []
   const branchExists = obs?.branchExists === true
 
-  // Задача завершена, только когда cleanup сделан: issue закрыт И ветки нет.
-  // Пока ветка цела, работа не закончена, сколько бы issue ни был закрыт.
+  // Task is finished only when cleanup is done: issue closed AND branch deleted.
+  // Task is finished only when cleanup is done: issue closed AND branch deleted.
   if (issueClosed && !branchExists) return 'done'
   if (issueClosed) return 'cleanup'
 
@@ -51,12 +41,10 @@ export function deriveColumn(obs) {
 }
 
 /**
- * Выбрать перевод из нескольких предложений разных источников.
+ * Select candidate transition from multiple sources.
  *
- * Предложение, совпадающее с текущей колонкой, отбрасывается: перевод в ту же
- * колонку — не перевод, а лишняя строка в журнале.
  *
- * @param {string} current текущая колонка
+ * @param {string} current current column
  * @param {Array<{column: string, source: string, detail?: string}>} candidates
  * @returns {{column: string, source: string, detail: string}|undefined}
  */
@@ -70,14 +58,10 @@ export function resolveTransition(current, candidates) {
 }
 
 /**
- * Нужен ли человек по событию сессии.
+ * Whether human intervention is required.
  *
- * Колонки «Блокировано» в согласованном наборе нет, поэтому запрос разрешения и
- * вопрос агента не двигают карточку, а поднимают на ней признак ожидания.
- * Двигать в несуществующую колонку нельзя, а прятать «агент стоит и ждёт» —
- * значит терять главное, ради чего смотрят на доску.
  *
- * @returns {boolean|undefined} true — поднять, false — снять, undefined — событие не про это
+ * @returns {boolean|undefined} true - raise, false - clear, undefined - not applicable
  */
 export function waitingFromEvent(type) {
   switch (type) {
@@ -93,20 +77,20 @@ export function waitingFromEvent(type) {
   }
 }
 
-/** Имя ветки, по которому задача узнаёт свою: то, что наблюдалось, либо ничего. */
+/** Branch name identified for task: observed branch or undefined. */
 export function branchOfTask(task, branches) {
   const known = typeof task?.branch === 'string' && task.branch !== '' ? task.branch : undefined
   const names = (branches ?? []).map((b) => (typeof b === 'string' ? b : b?.name)).filter(Boolean)
   if (known !== undefined) return names.includes(known) ? known : undefined
 
-  // Ветку задачи заводит агент и называет как хочет, но номер issue в имени —
-  // общее правило воркфлоу. Ищем по номеру, а не по угаданному шаблону.
+  // Agent creates branch matching workflow conventions with issue number.
+  // Look up by issue number rather than fixed string template.
   if (typeof task?.issueNumber !== 'number') return undefined
   const marker = String(task.issueNumber)
   return names.find((n) => new RegExp(`(^|[^0-9])${marker}([^0-9]|$)`).test(n))
 }
 
-/** Pull request-ы, относящиеся к задаче: по ветке либо по упоминанию issue. */
+/** Pull requests related to task: matched by branch or issue reference. */
 export function pullsOfTask(task, pulls, branch) {
   const number = typeof task?.issueNumber === 'number' ? task.issueNumber : undefined
   return (pulls ?? []).filter((p) => {
@@ -118,20 +102,16 @@ export function pullsOfTask(task, pulls, branch) {
 }
 
 /**
- * Кто победил, когда обе стороны изменились с последней сверки.
- *
- * Правило простое: побеждает более позднее изменение. Важно другое —
- * проигравшая сторона НЕ исчезает молча, а возвращается в поле `overridden`,
- * чтобы вызывающий записал её в журнал задачи. Синхронизация, которая тихо
- * отменяет правку человека, хуже синхронизации, которой нет: расхождение
- * остаётся, а узнать о нём неоткуда.
+ * Conflict resolution when both local and remote changed since last sync.
+ * Rule: latest timestamp wins, and overridden side is reported in `overridden`
+ * to record the conflict explicitly in task history.
  *
  * @param {object} state
- * @param {string} state.localColumn колонка на доске
- * @param {string} [state.remoteColumn] колонка, выведенная из Gitea
- * @param {number} state.localUpdatedAt когда правили на доске
- * @param {number} state.remoteUpdatedAt когда правили в Gitea
- * @param {number} state.syncedAt время последней удачной сверки
+ * @param {string} state.localColumn board column
+ * @param {string} [state.remoteColumn] column derived from forge
+ * @param {number} state.localUpdatedAt local update timestamp
+ * @param {number} state.remoteUpdatedAt remote update timestamp
+ * @param {number} state.syncedAt last successful sync timestamp
  * @returns {{winner: 'local'|'remote'|'none', column?: string, overridden?: string}}
  */
 export function resolveConflict({ localColumn, remoteColumn, localUpdatedAt, remoteUpdatedAt, syncedAt }) {
@@ -140,22 +120,21 @@ export function resolveConflict({ localColumn, remoteColumn, localUpdatedAt, rem
 
   const since = Number(syncedAt) || 0
 
-  // До первой сверки «изменилось с прошлого раза» не имеет смысла: прошлого
-  // раза не было. Карточку только что завели или импортировали, защищать в ней
-  // нечего, и первая сверка обязана принять положение дел, а не спорить с ним.
+  // Prior to first sync, 'changed since last time' has no prior baseline;
+  // accept remote state initially.
   const firstSync = since === 0
   const localChanged = !firstSync && (Number(localUpdatedAt) || 0) > since
   const remoteChanged = firstSync || (Number(remoteUpdatedAt) || 0) > since
 
   if (localChanged && remoteChanged) {
-    // Обе стороны двигались. Побеждает более позднее, проигравшее называется.
+    // Both sides modified: latest wins, overridden is recorded.
     if ((Number(localUpdatedAt) || 0) > (Number(remoteUpdatedAt) || 0)) {
       return { winner: 'local', overridden: remoteColumn }
     }
     return { winner: 'remote', column: remoteColumn, overridden: localColumn }
   }
 
-  // Двигалась только доска — Gitea не имеет права тянуть карточку назад.
+  // Only board moved: remote sync does not pull card backward.
   if (localChanged) return { winner: 'local' }
 
   return { winner: 'remote', column: remoteColumn }

package/lib/webhook.js

@@ -1,23 +1,16 @@
-// Приём событий Gitea и GitHub.
-//
-// Вебхук даёт мгновенную сверку вместо ожидания следующего опроса. Опрос при
-// этом остаётся: вебхук может быть не настроен, недоступен снаружи или просто
-// потерян по дороге. Мгновенность — ускорение, а не замена надёжности.
-//
-// Модуль чистый: разбор и проверка подписи без сети и без хранилища.
+// Webhook ingestion for Gitea and GitHub.
+// Webhooks trigger immediate sync alongside periodic polling.
+// Pure module: parsing and signature verification without network or database.
 
 import { createHmac, timingSafeEqual } from 'node:crypto'
 
 /**
- * Проверить подпись доставки (поддерживает Gitea X-Gitea-Signature и GitHub X-Hub-Signature-256).
+ * Verify delivery signature (supports Gitea X-Gitea-Signature and GitHub X-Hub-Signature-256).
+ * Constant-time comparison to prevent timing attacks.
  *
- * Сравнение постоянного времени: обычное посимвольное сравнение по времени
- * ответа выдаёт, сколько первых байтов угадано, и подпись подбирается за
- * считанные попытки.
- *
- * @param {string} secret общий секрет
- * @param {string|Buffer} body сырое тело запроса
- * @param {string} signature значение заголовка X-Gitea-Signature или X-Hub-Signature-256
+ * @param {string} secret shared secret
+ * @param {string|Buffer} body raw request body
+ * @param {string} signature header value of X-Gitea-Signature or X-Hub-Signature-256
  */
 export function verifySignature(secret, body, signature) {
   if (!secret) return false
@@ -31,9 +24,9 @@ export function verifySignature(secret, body, signature) {
 }
 
 /**
- * Определить провайдера вебхука по входящим заголовкам запроса.
+ * Detect webhook provider from incoming request headers.
  *
- * @param {object} headers заголовки HTTP-запроса
+ * @param {object} headers HTTP request headers
  * @returns {'github'|'gitea'}
  */
 export function detectWebhookProvider(headers) {
@@ -45,11 +38,11 @@ export function detectWebhookProvider(headers) {
 }
 
 /**
- * Что за задачу затронуло событие.
+ * Identifies which task was affected by the event.
  *
- * Возвращается адрес задачи, а не готовое решение: решать, куда двинуть
- * карточку, — дело сверки, у которой перед глазами полная картина. Вебхук
- * только говорит «вот здесь что-то произошло, посмотри сейчас, а не потом».
+ * Returns task coordinates rather than a transition verdict: deciding
+ * where to move the card belongs to sync logic which holds the complete state.
+ * Webhook merely notifies: 'an event occurred here, inspect now'.
  *
  * @returns {{owner: string, repo: string, issueNumber?: number}|undefined}
  */
@@ -59,8 +52,8 @@ export function parseEvent(payload) {
   const repo = repository?.name
   if (typeof owner !== 'string' || owner === '' || typeof repo !== 'string' || repo === '') return undefined
 
-  // Номер issue приходит по-разному в зависимости от события; PR при этом сам
-  // является issue с тем же номером.
+  // Issue number format varies depending on event payload; PR is also an issue
+  // with matching number.
   const number = payload?.issue?.number
     ?? payload?.pull_request?.number
     ?? (typeof payload?.number === 'number' ? payload.number : undefined)

package/lib/workflow-bridge.js

@@ -1,15 +1,15 @@
-// Мост между карточками Kanban и встроенным в ядро DSH workflowEngine.
+// Bridge between Kanban cards and core DSH workflowEngine.
 //
-// Выполняет перенос логики из dsh-agent-orchestrator/lib/integrations/kanban-bridge.js:
-// 1. Сопоставление карточка ↔ роль (по меткам и колонкам).
-// 2. Выбор пресета агента с проверкой доступности через ctx.agentPresets.list()
-//    и фоллбэком на пресет по умолчанию.
-// 3. Формирование сценария и запуск через ctx.workflowEngine.start().
-// 4. Отслеживание жизненного цикла workflow/* (agent-start, agent-end, end):
+// Integrates card lifecycle with core workflowEngine:
+// 1. Map card <-> role (via labels and columns).
+// 2. Select agent preset with availability check via ctx.agentPresets.list()
+//    and fallback to default preset.
+// 3. Construct script and execute via ctx.workflowEngine.start().
+// 4. Track workflow/* lifecycle (agent-start, agent-end, end):
 //    - running -> review/done/failed;
-//    - фиксация runId и сессии в задаче;
-//    - отправка summary в связанный issue Gitea / GitHub.
-// 5. Отмена активного workflow по запросу из карточки.
+//    - record runId and session in task;
+//    - post summary to linked Gitea / GitHub issue.
+// 5. Cancel active workflow on card request.
 
 import { buildStartMessage, obtainAgent } from './launcher.js'
 import { applyMove } from './routes.js'
@@ -23,26 +23,26 @@ export const DEFAULT_COLUMN_ROLES = {
   done: 'docs',
 }
 
-export const LABEL_ROLE_PATTERNS = [
-  { role: 'spec', patterns: ['spec', 'specification', 'requirements', 'requirements-analysis', 'анализ', 'тз'] },
-  { role: 'architecture', patterns: ['architecture', 'архитектура', 'contract'] },
-  { role: 'ui_design', patterns: ['ui', 'ui_design', 'design', 'ux', 'дизайн'] },
-  { role: 'frontend', patterns: ['frontend', 'web', 'client', 'ui-impl', 'фронтенд'] },
-  { role: 'backend', patterns: ['backend', 'api', 'server', 'бэкенд'] },
+const LABEL_ROLE_PATTERNS = [
+  { role: 'spec', patterns: ['spec', 'specification', 'requirements', 'requirements-analysis', 'analysis'] },
+  { role: 'architecture', patterns: ['architecture', 'contract'] },
+  { role: 'ui_design', patterns: ['ui', 'ui_design', 'design', 'ux'] },
+  { role: 'frontend', patterns: ['frontend', 'web', 'client', 'ui-impl'] },
+  { role: 'backend', patterns: ['backend', 'api', 'server'] },
   { role: 'fullstack', patterns: ['fullstack', 'full-stack', 'e2e'] },
-  { role: 'qa_tests', patterns: ['qa', 'qa_tests', 'test', 'tests', 'testing', 'verification', 'тест', 'тесты'] },
-  { role: 'bugfix', patterns: ['bug', 'bugfix', 'fix', 'баг', 'фикс'] },
-  { role: 'docs', patterns: ['docs', 'doc', 'documentation', 'документация'] },
-  { role: 'refactoring', patterns: ['refactor', 'refactoring', 'рефакторинг'] },
-  { role: 'research', patterns: ['research', 'spike', 'исследование'] },
-  { role: 'devops', patterns: ['devops', 'infra', 'ci', 'cd', 'deploy', 'деплой'] },
+  { role: 'qa_tests', patterns: ['qa', 'qa_tests', 'test', 'tests', 'testing', 'verification'] },
+  { role: 'bugfix', patterns: ['bug', 'bugfix', 'fix'] },
+  { role: 'docs', patterns: ['docs', 'doc', 'documentation'] },
+  { role: 'refactoring', patterns: ['refactor', 'refactoring'] },
+  { role: 'research', patterns: ['research', 'spike'] },
+  { role: 'devops', patterns: ['devops', 'infra', 'ci', 'cd', 'deploy'] },
 ]
 
 /**
- * Определить роль для задачи по меткам, колонке или явному полю role.
+ * Resolve role for task by labels, column or explicit role property.
  *
- * @param {object} task Задача доски
- * @returns {string} Идентификатор роли
+ * @param {object} task Board task
+ * @returns {string} Role ID
  */
 export function resolveRole(task) {
   if (!task) return 'backend'
@@ -81,14 +81,14 @@ export function resolveRole(task) {
 }
 
 /**
- * Подобрать пресет агента из доступных.
- * Если роль найдена в списке доступных пресетов — возвращает её.
- * Иначе выполняет безопасную деградацию на defaultPreset или undefined.
+ * Resolve agent preset from available list.
+ * If role matches available preset, returns it.
+ * Otherwise gracefully degrades to defaultPreset or undefined.
  *
  * @param {object} params
- * @param {string} params.role Имя роли
- * @param {Array<object|string>} [params.availablePresets] Список пресетов
- * @param {string} [params.defaultPreset] Пресет по умолчанию
+ * @param {string} params.role Role name
+ * @param {Array<object|string>} [params.availablePresets] Available presets
+ * @param {string} [params.defaultPreset] Default preset
  * @returns {string|undefined}
  */
 export function resolvePreset({ role, availablePresets = [], defaultPreset = undefined }) {
@@ -112,7 +112,7 @@ export function resolvePreset({ role, availablePresets = [], defaultPreset = und
 }
 
 /**
- * Построить JavaScript сценарий для ctx.workflowEngine.start().
+ * Construct JavaScript workflow script for ctx.workflowEngine.start().
  *
  * @param {object} params
  * @param {object} params.task
@@ -126,7 +126,7 @@ export function buildWorkflowScript({ task, role }) {
 
   return [
     `phase("${safeRole}");`,
-    `log("Запуск этапа ${safeRole} по карточке ${issueNum}");`,
+    `log("Starting phase ${safeRole} for card ${issueNum}");`,
     `const prompt = args.prompt;`,
     `const result = await agent(prompt, { label: "${safeRole}", phase: "${safeRole}" });`,
     `return {`,
@@ -138,7 +138,7 @@ export function buildWorkflowScript({ task, role }) {
 }
 
 /**
- * Сформировать метаданные сценария workflow.
+ * Construct metadata for workflow script.
  *
  * @param {object} params
  * @param {object} params.task
@@ -160,7 +160,7 @@ export function buildWorkflowMeta({ task, role }) {
 }
 
 /**
- * Определить целевую колонку после успешного завершения этапа workflow.
+ * Determine target column upon successful completion of workflow phase.
  *
  * @param {string} currentCol
  * @returns {string}
@@ -177,7 +177,7 @@ export function resolveTargetColumn(currentCol) {
 }
 
 /**
- * Класс-мост между доской и встроенным сервисом workflow ядра DSH.
+ * Bridge class connecting Kanban board to core DSH workflow service.
  */
 export class WorkflowBridge {
   constructor({
@@ -206,7 +206,7 @@ export class WorkflowBridge {
   }
 
   /**
-   * Список зарегистрированных пресетов ядра.
+   * List of core registered presets.
    */
   async getAvailablePresets() {
     if (!this.agentPresets || typeof this.agentPresets.list !== 'function') {
@@ -215,13 +215,13 @@ export class WorkflowBridge {
     try {
       return await this.agentPresets.list()
     } catch (err) {
-      this.logger?.warn?.(`dsh-kanban: не удалось получить список пресетов: ${err.message}`)
+      this.logger?.warn?.(`dsh-kanban: failed to get presets list: ${err.message}`)
       return []
     }
   }
 
   /**
-   * Запуск workflow по карточке.
+   * Launch workflow for card.
    */
   async startTaskWorkflow({
     task,
@@ -317,7 +317,7 @@ export class WorkflowBridge {
     this.activeRuns.set(task.id, entry)
     this.runToTask.set(runId, task.id)
 
-    // Обновляем карточку в базе данных
+    // Update task card in database
     this.store.updateTask(task.id, {
       workflowRunId: runId,
       workflowStatus: 'running',
@@ -335,7 +335,7 @@ export class WorkflowBridge {
       fromCol: task.col || task.column,
       toCol: task.col || task.column,
       source: 'workflow',
-      detail: `запуск workflow ${runId} (роль: ${role}, пресет: ${preset || 'default'})`,
+      detail: `starting workflow ${runId} (role: ${role}, preset: ${preset || 'default'})`,
     })
 
     this.eventHub?.broadcast?.('task:change', {
@@ -347,7 +347,7 @@ export class WorkflowBridge {
       sessionId: taken.sessionId,
     })
 
-    // Асинхронное ожидание завершения run
+    // Asynchronously await run completion
     run.result.then(async (result) => {
       await this.handleWorkflowResult(task.id, runId, role, result)
     }).catch(async (err) => {
@@ -370,14 +370,14 @@ export class WorkflowBridge {
   }
 
   /**
-   * Отмена запущенного workflow.
+   * Cancel running workflow.
    */
   async cancelTaskWorkflow(taskId, reason = 'cancelled-by-user') {
     if (!taskId) return { cancelled: false, error: 'task-id-required' }
 
     const entry = this.activeRuns.get(taskId)
     if (!entry) {
-      // Возможно, статус в БД ещё числится running
+      // Status in DB might still indicate running
       const task = this.store.getTask(taskId)
       if (task?.workflowStatus === 'running') {
         this.store.updateTask(taskId, { workflowStatus: 'cancelled' })
@@ -398,7 +398,7 @@ export class WorkflowBridge {
       fromCol: entry.task?.col || entry.task?.column || 'progress',
       toCol: entry.task?.col || entry.task?.column || 'progress',
       source: 'workflow',
-      detail: `отмена workflow ${entry.runId}: ${reason}`,
+      detail: `cancelled workflow ${entry.runId}: ${reason}`,
     })
 
     this.eventHub?.broadcast?.('task:change', {
@@ -412,7 +412,7 @@ export class WorkflowBridge {
   }
 
   /**
-   * Обработка завершения выполнения workflow.
+   * Handle workflow execution completion.
    */
   async handleWorkflowResult(taskId, runId, role, result) {
     const entry = this.activeRuns.get(taskId)
@@ -443,16 +443,16 @@ export class WorkflowBridge {
           id: taskId,
           column: targetCol,
           source: 'workflow',
-          detail: `workflow ${runId} завершён успешно (роль: ${role})`,
+          detail: `workflow ${runId} completed successfully (role: ${role})`,
         })
       }
 
-      // Отправляем комментарий в связанный issue Gitea / GitHub
+      // Send comment to linked Gitea / GitHub issue
       if (this.git && task.repo && task.issueNumber) {
         const commentBody = [
-          `🚀 **Workflow завершён успешно!** (роль: \`${role}\`)`,
+          `🚀 **Workflow completed successfully!** (role: \`${role}\`)`,
           summary ? `\n${summary}` : '',
-          `\n*Статус карточки переведён в колонку "${targetCol}".*`,
+          `\n*Card status moved to column "${targetCol}".*`,
         ].filter(Boolean).join('\n')
 
         try {
@@ -464,15 +464,15 @@ export class WorkflowBridge {
             provider: task.provider,
           })
         } catch (err) {
-          this.logger?.warn?.(`dsh-kanban: не удалось отправить комментарий в issue ${task.repo}#${task.issueNumber}: ${err.message}`)
+          this.logger?.warn?.(`dsh-kanban: failed to comment on issue ${task.repo}#${task.issueNumber}: ${err.message}`)
         }
       }
 
-      // Добавляем комментарий в карточку
+      // Add comment to card
       if (typeof this.store.addTaskComment === 'function' && summary) {
         this.store.addTaskComment(taskId, {
           author: 'workflow',
-          body: `🚀 **Workflow завершён (${role}):**\n\n${summary}`,
+          body: `🚀 **Workflow completed (${role}):**\n\n${summary}`,
         })
       }
     } else {
@@ -481,7 +481,7 @@ export class WorkflowBridge {
         fromCol: task.col || task.column,
         toCol: task.col || task.column,
         source: 'workflow',
-        detail: `workflow ${runId} завершён со статусом ${stopReason}: ${result?.error || ''}`,
+        detail: `workflow ${runId} completed with status ${stopReason}: ${result?.error || ''}`,
       })
     }
 
@@ -489,7 +489,7 @@ export class WorkflowBridge {
       try {
         await entry.run.dispose()
       } catch (err) {
-        this.logger?.warn?.(`dsh-kanban: ошибка при dispose workflow run ${runId}: ${err.message}`)
+        this.logger?.warn?.(`dsh-kanban: error disposing workflow run ${runId}: ${err.message}`)
       }
     }
 
@@ -504,7 +504,7 @@ export class WorkflowBridge {
   }
 
   /**
-   * Подключить слушатели событий ядра workflow/*.
+   * Attach core workflow/* event listeners.
    *
    * @param {object} ctx Cordis context
    */
@@ -547,8 +547,8 @@ export class WorkflowBridge {
         const taskId = this.runToTask.get(runId)
         if (!taskId) return
 
-        // handleWorkflowResult также вызывается через run.result.then,
-        // но событие workflow/end гарантирует синхронизацию наблюдателей
+        // handleWorkflowResult is also invoked via run.result.then,
+        // but workflow/end event guarantees observer synchronization
         this.eventHub?.broadcast?.('task:change', {
           taskId,
           action: 'workflow-core-end',