@goodandready/dsh-kanban 0.2.14 → 0.2.15

package/README.md

@@ -39,7 +39,7 @@
 
 Managing concurrent software tasks across multiple autonomous AI agents easily leads to context drift, lost pull request handoffs, and untracked branch lifecycles. Without a dedicated visual board, users must manually juggle disparate chat windows and verify issue states on remote VCS trackers.
 
-**`@goodandready/dsh-kanban`** introduces an interactive **Kanban Board** embedded natively into DeepSeek Harness. Every card represents a concrete development task linked to its own **dedicated agent session**. Moving a card between workflow columns automatically dispatches lifecycle instructions directly to the agent (e.g. implementing, opening PRs, deploying, or cleaning up worktrees), with continuous **2-way Gitea/Forgejo synchronization**.
+**`@goodandready/dsh-kanban`** introduces an interactive **Kanban Board** embedded natively into DeepSeek Harness. Every card represents a concrete development task linked to its own **dedicated agent session**. Moving a card between workflow columns automatically dispatches lifecycle instructions directly to the agent (e.g. implementing, opening PRs, deploying, or cleaning up worktrees), with continuous **2-way Gitea, Forgejo, and GitHub synchronization**.
 
 ---
 
@@ -64,7 +64,7 @@ graph LR
         Agent2["Agent: Task #53<br/>(PR Review)"]
     end
 
-    subgraph VCS ["Gitea / Forgejo Instance"]
+    subgraph VCS ["Git Forge (Gitea / GitHub)"]
         GiteaIssues["Issues & Milestones"]
         GiteaPRs["Pull Requests & Branches"]
         Webhook["Event Webhook (/dsh-kanban/webhook)"]
@@ -109,7 +109,7 @@ Unlike passive task boards, `dsh-kanban` actively drives the agents:
 
 ---
 
-### 3. Continuous 2-Way Gitea / Forgejo Sync
+### 3. Continuous 2-Way Gitea / Forgejo & GitHub Sync
 
 * **Bi-directional Reconciliation**: Polling and Webhook receiver (`/dsh-kanban/webhook`) sync issue descriptions, comments, PR status, labels, and closed states.
 * **Conflict Resolution**: Timestamp-based merge logic ensures manual edits in Gitea and board moves resolve cleanly without state clobbering.
@@ -207,6 +207,10 @@ dsh-kanban:
 | Key | Type | Default | Description |
 |:---|:---|:---|:---|
 | `boardKind` | `string` | `"project"` | Board workflow mode: `"project"` (6 columns) or `"simple"` (4 columns) |
+| `gitProvider` | `string` | `"auto"` | Active Git forge: `"auto"` (detect by credentials), `"gitea"`, or `"github"` |
+| `githubTokenRef` | `string` | `""` | DSH credential name containing GitHub PAT or App token |
+| `githubOwner` | `string` | `""` | Default GitHub organization or username |
+| `githubWebhookSecretRef` | `string` | `""` | DSH credential name containing GitHub webhook secret |
 | `giteaUrl` | `string` | `""` | Base URL of Gitea/Forgejo instance for task synchronization |
 | `giteaTokenEnv` | `string` | `"GITEA_TOKEN"` | DSH Credential name containing the Gitea API access token |
 | `giteaOwner` | `string` | `""` | Default organization or username for synced repositories |

package/README.ru.md

@@ -39,7 +39,7 @@
 
 При ведении параллельной разработки силами нескольких автономных AI-агентов легко потерять контроль над статусом задач, проверкой пулл-реквестов (PR) и ветками в репозитории. Без наглядной доски разработчику приходится переключаться между десятками вкладок чата и вручную сверять тикеты в трекере.
 
-**`@goodandready/dsh-kanban`** встраивает полноценную **Канбан-доску** прямо в Web UI DeepSeek Harness. Каждая карточка на доске связана со своей **выделенной сессией агента**. Перемещение карточки между колонками автоматически отправляет агенту целевую инструкцию (разработка, передача на ревью, деплой или очистка воркдеревьев), поддерживая непрерывную **двустороннюю синхронизацию с Gitea / Forgejo**.
+**`@goodandready/dsh-kanban`** встраивает полноценную **Канбан-доску** прямо в Web UI DeepSeek Harness. Каждая карточка на доске связана со своей **выделенной сессией агента**. Перемещение карточки между колонками автоматически отправляет агенту целевую инструкцию (разработка, передача на ревью, деплой или очистка воркдеревьев), поддерживая непрерывную **двустороннюю синхронизацию с Gitea / Forgejo и GitHub**.
 
 ---
 
@@ -64,7 +64,7 @@ graph LR
         Agent2["Агент: Задача #53<br/>(Ревью PR)"]
     end
 
-    subgraph VCS ["Сервер Gitea / Forgejo"]
+    subgraph VCS ["Git Forge (Gitea / GitHub)"]
         GiteaIssues["Задачи и Вехи"]
         GiteaPRs["Пулл-реквесты и Ветки"]
         Webhook["Вебхук-приёмник (/dsh-kanban/webhook)"]
@@ -159,6 +159,10 @@ dsh-kanban:
 | Параметр | Тип | По умолчанию | Описание |
 |:---|:---|:---|:---|
 | `boardKind` | `string` | `"project"` | Режим колонок: `"project"` (6 колонок) или `"simple"` (4 колонки) |
+| `gitProvider` | `string` | `"auto"` | Активный Git-провайдер: `"auto"` (по доступным ключам), `"gitea"` или `"github"` |
+| `githubTokenRef` | `string` | `""` | Имя DSH Credential с токеном доступа GitHub PAT / App |
+| `githubOwner` | `string` | `""` | Организация или логин владельца репозитория GitHub |
+| `githubWebhookSecretRef` | `string` | `""` | Имя DSH Credential с секретом вебхука GitHub |
 | `giteaUrl` | `string` | `""` | URL инстанса Gitea/Forgejo для синхронизации задач |
 | `giteaTokenEnv` | `string` | `"GITEA_TOKEN"` | Имя DSH Credential с токеном доступа к Gitea API |
 | `giteaOwner` | `string` | `""` | Организация или логин владельца репозитория |
@@ -170,7 +174,7 @@ dsh-kanban:
 
 ## 🧪 Тестирование и верификация
 
-Запуск полного набора из более чем 520 юнит- и интеграционных тестов:
+Запуск полного набора из более чем 710 юнит- и интеграционных тестов:
 
 ```bash
 npm test

package/README.zh.md

@@ -159,6 +159,10 @@ dsh-kanban:
 | 配置项 | 数据类型 | 默认值 | 功能说明 |
 |:---|:---|:---|:---|
 | `boardKind` | `string` | `"project"` | 看板模式：`"project"`（6 泳道）或 `"simple"`（4 泳道） |
+| `gitProvider` | `string` | `"auto"` | 活动 Git 平台：`"auto"`（按凭证自动检测）、`"gitea"` 或 `"github"` |
+| `githubTokenRef` | `string` | `""` | 包含 GitHub PAT 或应用令牌的 DSH 凭证名称 |
+| `githubOwner` | `string` | `""` | 默认监听的 GitHub 组织或用户名 |
+| `githubWebhookSecretRef` | `string` | `""` | 包含 GitHub Webhook 密钥的 DSH 凭证名称 |
 | `giteaUrl` | `string` | `""` | 用于同步任务的 Gitea / Forgejo 实例基础地址 |
 | `giteaTokenEnv` | `string` | `"GITEA_TOKEN"` | 存储 Gitea API Token 的 DSH 凭据键名 |
 | `giteaOwner` | `string` | `""` | 默认同步的仓库所属组织或用户名 |

package/lib/client.js

@@ -910,7 +910,17 @@ window.__ModuleLoader__.load({
       'title': 'Kanban',
       'subtitle': 'Task board: Gitea issues and a session per task',
       'section.label': 'Kanban',
+      'group.forge': 'Git Forge',
       'group.gitea': 'Gitea',
+      'group.github': 'GitHub',
+      'field.gitProvider': 'Git Provider',
+      'hint.gitProvider': 'Active forge: "auto" (detect by credentials), "gitea", or "github".',
+      'field.githubTokenRef': 'GitHub credential token',
+      'hint.githubTokenRef': 'Name of DSH credential holding GitHub PAT or App token. Never type raw token.',
+      'field.githubOwner': 'GitHub organization/user',
+      'hint.githubOwner': 'Default GitHub account to watch. Empty uses authenticated user.',
+      'field.githubWebhookSecretRef': 'GitHub webhook secret',
+      'hint.githubWebhookSecretRef': 'Name of DSH credential holding GitHub webhook secret (HMAC-SHA256).',
       'group.general': 'General',
       'field.giteaUrl': 'Instance URL',
       'field.giteaTokenRef': 'Credential name',
@@ -1288,7 +1298,17 @@ window.__ModuleLoader__.load({
       'title': '看板',
       'subtitle': '任务看板：Gitea issue，每个任务一个会话',
       'section.label': '看板',
+      'group.forge': 'Git 平台',
       'group.gitea': 'Gitea',
+      'group.github': 'GitHub',
+      'field.gitProvider': 'Git 平台',
+      'hint.gitProvider': '活动 Git 平台："auto"（自动检测）、"gitea"或"github"。',
+      'field.githubTokenRef': 'GitHub 凭据名称',
+      'hint.githubTokenRef': '存储 GitHub PAT 或应用令牌的 DSH 凭据名称。切勿在此输入真实令牌。',
+      'field.githubOwner': 'GitHub 组织或用户名',
+      'hint.githubOwner': '默认监听的 GitHub 账户。留空使用认证用户。',
+      'field.githubWebhookSecretRef': 'GitHub Webhook 密钥',
+      'hint.githubWebhookSecretRef': '存储 GitHub Webhook 密钥的 DSH 凭据名称。',
       'group.general': '通用',
       'field.giteaUrl': '实例地址',
       'field.giteaTokenRef': '凭据名称',
@@ -1663,8 +1683,12 @@ window.__ModuleLoader__.load({
 
 
     const FIELDS = [
+      { field: 'gitProvider', kind: 'text', group: 'forge' },
       { field: 'giteaUrl', kind: 'text', group: 'gitea' },
       { field: 'giteaTokenRef', kind: 'text', group: 'gitea' },
+      { field: 'githubTokenRef', kind: 'text', group: 'github' },
+      { field: 'githubOwner', kind: 'text', group: 'github' },
+      { field: 'githubWebhookSecretRef', kind: 'text', group: 'github' },
       { field: 'defaultProjectRoot', kind: 'text', group: 'general' },
       { field: 'startPrompt', kind: 'area', group: 'general' },
       { field: 'replyInstruction', kind: 'text', group: 'general' },
@@ -1695,6 +1719,8 @@ window.__ModuleLoader__.load({
     function hintKey(spec) {
       if (spec.group === 'sync') return 'hint.' + spec.field
       if (spec.group === 'gitea') return 'hint.' + spec.field
+      if (spec.group === 'github') return 'hint.' + spec.field
+      if (spec.group === 'forge') return 'hint.' + spec.field
       if (spec.group === 'labels') return 'hint.label'
       if (spec.group === 'limits') return 'hint.limit'
       return 'hint.' + spec.field
@@ -1961,6 +1987,11 @@ window.__ModuleLoader__.load({
             badge = h('span', {
               className: 'dkb-section-badge' + (hasUrl ? ' dkb-section-badge-ok' : ''),
             }, hasUrl ? 'Gitea Configured' : 'No URL')
+          } else if (grp === 'github') {
+            const hasGh = Boolean(valueOf('githubTokenRef'))
+            badge = h('span', {
+              className: 'dkb-section-badge' + (hasGh ? ' dkb-section-badge-ok' : ''),
+            }, hasGh ? 'GitHub Configured' : 'No Token')
           } else if (grp === 'sync') {
             const interval = Number(valueOf('syncIntervalSec')) || 0
             badge = h('span', {

package/lib/config.js

@@ -55,8 +55,10 @@ export const DEFAULT_BOARDS = [
 
 /** Значения по умолчанию. Из них же собирается схема в `lib/index.js`. */
 export const CONFIG_DEFAULTS = {
+  gitProvider: 'auto',
   giteaUrl: '',
   giteaTokenRef: 'GITEA_TOKEN',
+  githubTokenRef: 'GITHUB_TOKEN',
   defaultProjectRoot: '',
   startPrompt: '',
   replyInstruction: '',
@@ -65,11 +67,13 @@ export const CONFIG_DEFAULTS = {
   syncIntervalSec: 120,
   staleAfterMin: 60,
   giteaOwner: '',
+  githubOwner: '',
   columnNames: '',
   watchRepos: '',
   archiveAfterDays: 7,
   boardToolEnabled: false,
   webhookSecretRef: '',
+  githubWebhookSecretRef: '',
   pushToGitea: true,
   worktreeIsolation: true,
   worktreeRoot: '',
@@ -86,8 +90,10 @@ export const CONFIG_DEFAULTS = {
 
 /** Пояснения к полям; повторно используются схемой и карточкой настроек. */
 export const CONFIG_HINTS = {
+  gitProvider: 'Active Git forge: "auto" (detect by credentials), "gitea", or "github".',
   giteaUrl: 'Gitea or Forgejo instance URL, e.g. https://gitea.example.com. Empty disables import.',
   giteaTokenRef: 'Name of DSH credential holding the access token. Do not enter raw token.',
+  githubTokenRef: 'Name of DSH credential holding GitHub Personal Access Token or App token. Do not enter raw token.',
   defaultProjectRoot: 'Directory containing project repositories. Empty uses harness working directory.',
   startPrompt: 'Template for initial message to agent session. Empty uses built-in default.',
   replyInstruction: 'Instruction appended to initial message (e.g. language/format constraints). Empty adds nothing.',
@@ -96,11 +102,13 @@ export const CONFIG_HINTS = {
   syncIntervalSec: 'Interval in seconds for polling Gitea synchronization. 0 disables polling.',
   staleAfterMin: 'Minutes of inactivity before active task session is flagged stale. 0 disables.',
   giteaOwner: 'Default Gitea organization/user to track. Auto-detected if single organization.',
+  githubOwner: 'Default GitHub user or organization to track. Empty uses the authenticated user.',
   columnNames: 'Custom column title mappings as "id=Name" pairs comma-separated.',
   watchRepos: 'Filter sync to specific repository names comma-separated. Empty watches all repos.',
   archiveAfterDays: 'Days completed tasks remain before automatic archiving. 0 disables.',
   boardToolEnabled: 'Allow autonomous agent to advance cards via board_move tool.',
   webhookSecretRef: 'Name of DSH credential holding Gitea webhook secret.',
+  githubWebhookSecretRef: 'Name of DSH credential holding GitHub webhook secret (HMAC-SHA256).',
   pushToGitea: 'Automatically close corresponding Gitea issue when card moves to Done.',
   worktreeIsolation: 'Isolate task sessions in dedicated git worktrees to prevent workspace collisions.',
   worktreeRoot: 'Custom root directory for task worktrees. Empty defaults to $DSH_HOME/worktrees.',

package/lib/git-provider.js

@@ -0,0 +1,156 @@
+// Композитный маршрутизатор Git-провайдеров (Gitea и GitHub).
+//
+// Предоставляет единый интерфейс к обеим системам:
+// - прозрачно направляет запросы задач в соответствующий провайдер (task.provider / issueUrl);
+// - в режиме 'auto' опрашивает настроенный провайдер или объединяет результаты поиска;
+// - позволяет доске бесшовно работать как только с Gitea, так и только с GitHub или с обоими сразу.
+
+export function createGitProvider({ gitea, github, getConfig }) {
+  async function resolveActiveProvider(hint) {
+    if (hint && typeof hint === 'object') {
+      if (hint.provider === 'github') return github
+      if (hint.provider === 'gitea') return gitea
+      if (typeof hint.issueUrl === 'string' && hint.issueUrl.includes('github.com')) {
+        return github
+      }
+    } else if (hint === 'github') {
+      return github
+    } else if (hint === 'gitea') {
+      return gitea
+    }
+
+    const mode = String(getConfig()?.gitProvider || 'auto').toLowerCase()
+    if (mode === 'github') return github
+    if (mode === 'gitea') return gitea
+
+    // В режиме 'auto': проверяем доступность провайдеров
+    const giteaReady = await gitea.isConfigured()
+    const githubReady = await github.isConfigured()
+    if (githubReady && !giteaReady) return github
+    return gitea
+  }
+
+  function forTarget(target) {
+    if (target === github || target?.provider === 'github') return github
+    if (target === gitea || target?.provider === 'gitea') return gitea
+    return undefined
+  }
+
+  return {
+    gitea,
+    github,
+
+    /** Определить провайдера для задачи или контекста. */
+    resolve: resolveActiveProvider,
+
+    /** Настроен ли хотя бы один или конкретный провайдер. */
+    async isConfigured(providerName) {
+      if (providerName === 'github') return github.isConfigured()
+      if (providerName === 'gitea') return gitea.isConfigured()
+      const gReady = await gitea.isConfigured()
+      if (gReady) return true
+      return github.isConfigured()
+    },
+
+    /** Логин текущего пользователя. */
+    async me(target) {
+      const p = forTarget(target) || await resolveActiveProvider(target)
+      return p.me()
+    },
+
+    /** Список issues. */
+    async listIssues(options) {
+      const p = forTarget(options?.provider) || await resolveActiveProvider(options)
+      return p.listIssues(options)
+    },
+
+    /** Получить issue по номеру. */
+    async getIssue(options) {
+      const p = forTarget(options?.provider) || await resolveActiveProvider(options)
+      return p.getIssue(options)
+    },
+
+    /** Создать issue. */
+    async createIssue(options) {
+      const p = forTarget(options?.provider) || await resolveActiveProvider(options)
+      return p.createIssue(options)
+    },
+
+    /** Закрыть issue. */
+    async closeIssue(options) {
+      const p = forTarget(options?.provider) || await resolveActiveProvider(options)
+      return p.closeIssue(options)
+    },
+
+    /** Комментарий в issue. */
+    async comment(options) {
+      const p = forTarget(options?.provider) || await resolveActiveProvider(options)
+      return p.comment(options)
+    },
+
+    /** Назначить ответственных. */
+    async setAssignees(options) {
+      const p = forTarget(options?.provider) || await resolveActiveProvider(options)
+      return p.setAssignees(options)
+    },
+
+    /** Список Pull Requests. */
+    async listPulls(options) {
+      const p = forTarget(options?.provider) || await resolveActiveProvider(options)
+      return p.listPulls(options)
+    },
+
+    /** Создать Pull Request. */
+    async createPullRequest(options) {
+      const p = forTarget(options?.provider) || await resolveActiveProvider(options)
+      return p.createPullRequest(options)
+    },
+
+    /** Список веток репозитория. */
+    async listBranches(options) {
+      const p = forTarget(options?.provider) || await resolveActiveProvider(options)
+      return p.listBranches(options)
+    },
+
+    /** Список организаций. */
+    async listOrgs(target) {
+      const p = forTarget(target) || await resolveActiveProvider(target)
+      return p.listOrgs()
+    },
+
+    /** Репозитории организации. */
+    async listOrgRepos(options) {
+      const p = forTarget(options?.provider) || await resolveActiveProvider(options)
+      return p.listOrgRepos(options)
+    },
+
+    /**
+     * Поиск репозиториев: ищет в целевом провайдере либо агрегирует результаты
+     * из обоих, если включены оба.
+     */
+    async searchRepos(options) {
+      const target = forTarget(options?.provider)
+      if (target) {
+        return target.searchRepos(options)
+      }
+
+      const mode = String(getConfig()?.gitProvider || 'auto').toLowerCase()
+      if (mode === 'github') return github.searchRepos(options)
+      if (mode === 'gitea') return gitea.searchRepos(options)
+
+      // Если режим 'auto' / 'both', опрашиваем оба настроенных
+      const [giteaConfigured, githubConfigured] = await Promise.all([
+        gitea.isConfigured(),
+        github.isConfigured(),
+      ])
+
+      const requests = []
+      if (giteaConfigured) requests.push(gitea.searchRepos(options).catch(() => []))
+      if (githubConfigured) requests.push(github.searchRepos(options).catch(() => []))
+
+      if (requests.length === 0) return []
+      const results = await Promise.all(requests)
+      return results.flat()
+    },
+  }
+}

package/lib/github.js

@@ -0,0 +1,302 @@
+// Клиент GitHub REST API v3.
+//
+// Выполняет те же операции, что и GiteaClient: чтение issues, pull requests,
+// веток, репозиториев, создание PR и комментирование.
+// Дополнительно поддерживает условные запросы с ETag (If-None-Match) для защиты
+// от исчерпания часового лимита запросов GitHub (5 000 req/hr).
+//
+// Модуль изолирован от файловой системы и DSH: токен и конфигурация
+// передаются фабрикой createGitHubClient.
+
+const DEFAULT_BASE_URL = 'https://api.github.com'
+
+export function normalizeGithubUrl(raw) {
+  const s = String(raw ?? '').trim()
+  if (!s) return DEFAULT_BASE_URL
+  const match = s.match(/^https?:\/\/[^\s/]+/i)
+  return match ? match[0].replace(/\/+$/, '') : DEFAULT_BASE_URL
+}
+
+export function safeSegment(value) {
+  const s = String(value ?? '').trim()
+  if (!s || s.includes('/') || s.includes('\\') || s.includes('..') || s.includes('\0')) {
+    return undefined
+  }
+  return s
+}
+
+export function isCredentialName(value) {
+  if (typeof value !== 'string') return false
+  const trimmed = value.trim()
+  return trimmed.length > 0 && !/[\s/]/.test(trimmed)
+}
+
+/**
+ * Создать клиент GitHub API.
+ *
+ * @param {object} options
+ * @param {() => object} options.getConfig функция получения конфигурации
+ * @param {(name: string) => Promise<string>} options.resolveToken получение токена
+ * @param {typeof fetch} [options.fetchImpl] реализация fetch
+ * @param {number} [options.timeoutMs] таймаут запроса в мс
+ */
+export function createGitHubClient({ getConfig, resolveToken, fetchImpl = fetch, timeoutMs = 30_000 }) {
+  // Кэш условных запросов ETag: url -> { etag, data }
+  const etagCache = new Map()
+
+  async function request(method, path, body, { useEtag = false } = {}) {
+    const config = getConfig()
+    const baseUrl = normalizeGithubUrl(config?.githubUrl)
+    const tokenRef = config?.githubTokenRef || 'GITHUB_TOKEN'
+
+    const token = await resolveToken(tokenRef)
+    if (!token) {
+      throw Object.assign(new Error('GitHub credential token is not configured'), { code: 'unconfigured' })
+    }
+
+    const url = `${baseUrl}${path}`
+    const headers = {
+      'Authorization': `Bearer ${token}`,
+      'Accept': 'application/vnd.github+json',
+      'X-GitHub-Api-Version': '2022-11-28',
+      'User-Agent': 'dsh-kanban',
+    }
+
+    let cacheEntry
+    if (useEtag && method === 'GET') {
+      cacheEntry = etagCache.get(url)
+      if (cacheEntry?.etag) {
+        headers['If-None-Match'] = cacheEntry.etag
+      }
+    }
+
+    if (body !== undefined) {
+      headers['Content-Type'] = 'application/json'
+    }
+
+    const controller = new AbortController()
+    const timer = setTimeout(() => controller.abort(), timeoutMs)
+
+    try {
+      const res = await fetchImpl(url, {
+        method,
+        headers,
+        body: body === undefined ? undefined : JSON.stringify(body),
+        signal: controller.signal,
+      })
+
+      if (res.status === 304 && cacheEntry) {
+        return cacheEntry.data
+      }
+
+      const text = await res.text()
+      let payload
+      try { payload = text.trim() === '' ? null : JSON.parse(text) } catch { payload = null }
+
+      if (!res.ok) {
+        throw Object.assign(new Error(`GitHub HTTP error ${res.status}`), {
+          code: 'http',
+          status: res.status,
+          detail: payload?.message,
+        })
+      }
+
+      if (useEtag && method === 'GET') {
+        const etag = res.headers?.get?.('etag') || res.headers?.etag
+        if (etag) {
+          etagCache.set(url, { etag, data: payload })
+        }
+      }
+
+      return payload
+    } finally {
+      clearTimeout(timer)
+    }
+  }
+
+  function repoPath(owner, repo, suffix = '') {
+    const o = safeSegment(owner)
+    const r = safeSegment(repo)
+    if (o === undefined || r === undefined) {
+      throw Object.assign(new Error('Invalid owner or repository segment'), { code: 'bad-segment' })
+    }
+    return `/repos/${encodeURIComponent(o)}/${encodeURIComponent(r)}${suffix}`
+  }
+
+  async function collectPages({ buildPath, limit = 50, maxPages = 10, useEtag = false }) {
+    const size = Math.min(Math.max(Number(limit) || 50, 1), 100)
+    const out = []
+    for (let page = 1; page <= maxPages; page += 1) {
+      const rows = await request('GET', buildPath(page, size), undefined, { useEtag: useEtag && page === 1 })
+      if (!Array.isArray(rows)) break
+      out.push(...rows)
+      if (rows.length < size) break
+    }
+    return out
+  }
+
+  let configuredCache
+  const configuredKey = () => {
+    const config = getConfig()
+    return `${normalizeGithubUrl(config?.githubUrl)}\u0000${String(config?.githubTokenRef ?? 'GITHUB_TOKEN')}`
+  }
+
+  return {
+    provider: 'github',
+
+    /** Проверен ли токен доступа. */
+    async isConfigured() {
+      const key = configuredKey()
+      if (configuredCache?.key === key) return configuredCache.value
+      const config = getConfig()
+      const tokenRef = config?.githubTokenRef || 'GITHUB_TOKEN'
+      const value = isCredentialName(tokenRef)
+        && await resolveToken(tokenRef).then(Boolean).catch(() => false)
+      configuredCache = { key, value }
+      return value
+    },
+
+    /** Очистить кэш ETag (например, при явном ручном обновлении). */
+    clearCache() {
+      etagCache.clear()
+    },
+
+    /** Список issues репозитория (без PR). */
+    async listIssues({ owner, repo, state = 'open', limit = 50 }) {
+      const rows = await collectPages({
+        limit,
+        useEtag: true,
+        buildPath: (page, size) => repoPath(owner, repo,
+          `/issues?state=${encodeURIComponent(state)}&page=${page}&per_page=${size}&sort=updated&direction=desc`),
+      })
+      return rows.filter((r) => !r.pull_request)
+    },
+
+    /** Получить один issue по номеру. */
+    async getIssue({ owner, repo, index }) {
+      const n = safeSegment(index)
+      if (n === undefined) throw Object.assign(new Error('invalid issue number'), { code: 'bad-segment' })
+      return request('GET', repoPath(owner, repo, `/issues/${n}`))
+    },
+
+    /** Оставить комментарий в issue. */
+    async comment({ owner, repo, index, body }) {
+      const n = safeSegment(index)
+      if (n === undefined) throw Object.assign(new Error('invalid issue number'), { code: 'bad-segment' })
+      return request('POST', repoPath(owner, repo, `/issues/${n}/comments`), { body })
+    },
+
+    /** Создать новый issue. */
+    async createIssue({ owner, repo, title, body }) {
+      const name = String(title ?? '').trim()
+      if (name === '') throw Object.assign(new Error('empty issue title'), { code: 'bad-title' })
+      return request('POST', repoPath(owner, repo, '/issues'), { title: name, body: String(body ?? '') })
+    },
+
+    /** Закрыть issue. */
+    async closeIssue({ owner, repo, index }) {
+      const n = safeSegment(index)
+      if (n === undefined) throw Object.assign(new Error('invalid issue number'), { code: 'bad-segment' })
+      return request('PATCH', repoPath(owner, repo, `/issues/${n}`), { state: 'closed' })
+    },
+
+    /**
+     * Назначить ответственных за issue.
+     * В GitHub REST API PATCH /issues/{n} со свойством assignees заменяет ответственных целиком.
+     */
+    async setAssignees({ owner, repo, index, logins }) {
+      const n = safeSegment(index)
+      if (n === undefined) throw Object.assign(new Error('invalid issue number'), { code: 'bad-segment' })
+      const list = (Array.isArray(logins) ? logins : [])
+        .filter((one) => typeof one === 'string' && one !== '')
+      return request('PATCH', repoPath(owner, repo, `/issues/${n}`), { assignees: list })
+    },
+
+    /** Логин текущего пользователя токена. */
+    async me() {
+      const row = await request('GET', '/user')
+      const login = row?.login
+      return typeof login === 'string' ? login : ''
+    },
+
+    /** Организации, доступные токену. */
+    async listOrgs() {
+      const rows = await request('GET', '/user/orgs?per_page=50')
+      return (Array.isArray(rows) ? rows : [])
+        .map((o) => String(o?.login ?? o?.name ?? ''))
+        .filter((name) => name !== '')
+    },
+
+    /** Репозитории организации с числом открытых задач. */
+    async listOrgRepos({ owner, limit = 100 }) {
+      const rows = await collectPages({
+        limit,
+        useEtag: true,
+        buildPath: (page, size) => `/orgs/${encodeURIComponent(safeSegment(owner))}/repos?page=${page}&per_page=${size}`,
+      })
+      return rows.map((r) => ({
+        name: String(r?.name ?? ''),
+        openIssues: Number(r?.open_issues_count ?? 0),
+        archived: r?.archived === true,
+      })).filter((r) => r.name !== '')
+    },
+
+    /** Pull requests репозитория. */
+    async listPulls({ owner, repo, state = 'all', limit = 50 }) {
+      return collectPages({
+        limit,
+        useEtag: true,
+        buildPath: (page, size) => repoPath(owner, repo,
+          `/pulls?state=${encodeURIComponent(state)}&page=${page}&per_page=${size}&sort=updated&direction=desc`),
+      })
+    },
+
+    /** Создать Pull Request. */
+    async createPullRequest({ owner, repo, title, body, head, base = 'main' }) {
+      const name = String(title ?? '').trim()
+      if (name === '') throw Object.assign(new Error('empty PR title'), { code: 'bad-title' })
+      const h = String(head ?? '').trim()
+      const b = String(base ?? 'main').trim()
+      if (!h) throw Object.assign(new Error('head branch is required'), { code: 'bad-head' })
+      return request('POST', repoPath(owner, repo, '/pulls'), {
+        title: name,
+        body: String(body ?? ''),
+        head: h,
+        base: b,
+      })
+    },
+
+    /** Список веток репозитория. */
+    async listBranches({ owner, repo, limit = 100 }) {
+      const rows = await collectPages({
+        limit,
+        buildPath: (page, size) => repoPath(owner, repo, `/branches?page=${page}&per_page=${size}`),
+      })
+      return rows.map((b) => ({ name: String(b?.name ?? '') })).filter((b) => b.name !== '')
+    },
+
+    /** Поиск репозиториев. */
+    async searchRepos({ query, limit = 50, maxPages = 5 }) {
+      const q = encodeURIComponent(String(query || ''))
+      const size = Math.min(Math.max(Number(limit) || 50, 1), 50)
+      const out = []
+      for (let page = 1; page <= maxPages; page += 1) {
+        const rows = await request('GET', `/search/repositories?q=${q}&per_page=${size}&page=${page}`)
+        const data = Array.isArray(rows?.items) ? rows.items : []
+        for (const r of data) {
+          out.push({
+            name: String(r?.name ?? ''),
+            fullName: String(r?.full_name ?? ''),
+            description: String(r?.description ?? ''),
+            openIssues: Number(r?.open_issues_count ?? 0),
+            updatedAt: r?.updated_at ? new Date(r.updated_at).getTime() : 0,
+            stars: Number(r?.stargazers_count ?? 0),
+            provider: 'github',
+          })
+        }
+        if (data.length < size) break
+      }
+      return out
+    },
+  }
+}

package/lib/import.js

@@ -69,10 +69,12 @@ export function issueMilestone(issue) {
  * Поля `branch`, `worktree`, `sessionId`, `model` НЕ заполняются: они
  * наблюдаются позже, когда работа начнётся. Плагин ветки не создаёт.
  */
-export function issueToTask(issue, { board = 'main', column = 'backlog', owner, repo }) {
+export function issueToTask(issue, { board = 'main', column = 'backlog', owner, repo, provider }) {
+  const p = provider || (typeof issue?.html_url === 'string' && issue.html_url.includes('github.com') ? 'github' : 'gitea')
   return {
     board,
     column,
+    provider: p,
     title: typeof issue?.title === 'string' ? issue.title : '',
     body: typeof issue?.body === 'string' ? issue.body : '',
     labels: Array.isArray(issue?.labels)

package/lib/index.js

@@ -58,6 +58,8 @@ import {
 import { cleanupTaskWorktree, checkWorktreeDirty, getTaskDiff, getTaskCommits, mergeTaskWorktree } from './worktree.js'
 import { dispatchMove, MOVE_DETAIL, stopWork, STOP_DETAIL } from './commands.js'
 import { createGiteaClient } from './gitea.js'
+import { createGitHubClient } from './github.js'
+import { createGitProvider } from './git-provider.js'
 import { createKanbanTaskService } from './task-service.js'
 import { syncAll, createSyncState, intakeAll, archiveOverdue } from './sync.js'
 import { isWatched } from './intake.js'
@@ -131,7 +133,7 @@ export const Config = z.object(Object.fromEntries(
     let node = typeof fallback === 'number' ? z.number()
       : typeof fallback === 'boolean' ? z.boolean()
         : z.string()
-    if (field === 'giteaTokenRef' || field === 'webhookSecretRef') {
+    if (field === 'giteaTokenRef' || field === 'webhookSecretRef' || field === 'githubTokenRef' || field === 'githubWebhookSecretRef') {
       node = node.role('credential-ref')
     }
     return [field, node.default(fallback).description(CONFIG_HINTS[field] ?? '')]
@@ -249,6 +251,17 @@ export function apply(ctx, config) {
     resolveToken: resolveSecret,
   })
 
+  const github = createGitHubClient({
+    getConfig,
+    resolveToken: resolveSecret,
+  })
+
+  const git = createGitProvider({
+    gitea,
+    github,
+    getConfig,
+  })
+
   // Хранилище открывается один раз и закрывается уборщиком того же эффекта:
   // выгрузка плагина обязана отпустить файл базы.
   let store
@@ -457,7 +470,7 @@ export function apply(ctx, config) {
   // Очередь отправки в Gitea. Перенос карточки не ждёт сети: доска обязана
   // работать и при недоступном Gitea, а неудачная отправка повторяется и, если
   // так и не удалась, попадает в журнал задачи.
-  const outbox = createOutbox({ gitea, store, logger: ctx.logger })
+  const outbox = createOutbox({ gitea: git, store, logger: ctx.logger })
 
   const queueOutbound = (taskId, column) => {
     if (getConfig().pushToGitea !== true) return
@@ -502,10 +515,34 @@ export function apply(ctx, config) {
       // Порядок важен. Сперва забираем новое: свежая задача должна попасть на
       // доску и тут же быть сверена, а не ждать следующего прохода. Архивация
       // последней — она смотрит на итог, а не на исходное.
-      const taken = await intakeAll({
-        gitea, store, config: getConfig(), owner: await defaultOwner(), logger: ctx.logger,
-      })
-      const out = await syncAll({ gitea, store, logger: ctx.logger })
+      const mode = String(getConfig()?.gitProvider || 'auto').toLowerCase()
+      const providersToSync = []
+      if (mode === 'github') {
+        providersToSync.push(github)
+      } else if (mode === 'gitea') {
+        providersToSync.push(gitea)
+      } else {
+        if (await gitea.isConfigured()) providersToSync.push(gitea)
+        if (await github.isConfigured()) providersToSync.push(github)
+        if (providersToSync.length === 0) providersToSync.push(gitea)
+      }
+
+      let taken = { added: 0, skipped: 0, failed: 0 }
+      for (const p of providersToSync) {
+        const owner = p === github
+          ? (String(getConfig()?.githubOwner ?? '').trim() || await p.me().catch(() => ''))
+          : await defaultOwner()
+        const res = await intakeAll({
+          gitea: p, store, config: getConfig(), owner, logger: ctx.logger,
+        })
+        if (res && typeof res.added === 'number') {
+          taken.added = (taken.added || 0) + res.added
+          taken.skipped = (taken.skipped || 0) + (res.skipped || 0)
+          taken.failed = (taken.failed || 0) + (res.failed || 0)
+        }
+        if (res?.problem) taken.problem = res.problem
+      }
+      const out = await syncAll({ gitea: git, store, logger: ctx.logger })
       const tidied = archiveOverdue({ store, config: getConfig() })
       // Отложенные отправки уходят той же волной: отдельный таймер ради них
       // означал бы второй источник обращений к Gitea без всякой пользы.
@@ -550,7 +587,7 @@ export function apply(ctx, config) {
       try {
         const input = await readBody(req)
         reply(res, await createProjectTask({
-          gitea, store,
+          gitea: git, store,
           owner: input.owner || await defaultOwner(),
           repo: input.repo, newRepo: input.newRepo,
           title: input.title, body: input.body,
@@ -666,10 +703,13 @@ export function apply(ctx, config) {
       if (req.method !== 'POST') { writeJson(res, 405, { error: 'method-not-allowed' }); return }
       try {
         const raw = await readRaw(req)
-        const secret = await resolveSecret(getConfig().webhookSecretRef)
-        // Без секрета вебхук не принимается вовсе: иначе карточки двигал бы
-        // кто угодно снаружи.
-        if (!verifySignature(secret, raw, req.headers['x-gitea-signature'])) {
+        const isGithub = Boolean(req.headers['x-github-event'] || req.headers['x-hub-signature-256'])
+        const secretRef = isGithub
+          ? (getConfig().githubWebhookSecretRef || getConfig().webhookSecretRef)
+          : getConfig().webhookSecretRef
+        const secret = await resolveSecret(secretRef)
+        const sig = isGithub ? req.headers['x-hub-signature-256'] : req.headers['x-gitea-signature']
+        if (!verifySignature(secret, raw, sig)) {
           writeJson(res, 401, { error: 'bad-signature' })
           return
         }
@@ -678,29 +718,21 @@ export function apply(ctx, config) {
         const target = parseEvent(payload)
         if (target === undefined) { writeJson(res, 202, { ignored: true }); return }
 
-        // Сперва подхват, потом сверка — тот же порядок, что и по таймеру:
-        // новый issue должен стать карточкой и тут же быть сверен. Без этого
-        // он ждал бы таймера, хотя вебхук про него уже знает, а вебхук мы и
-        // заводили ради двух секунд вместо ста двадцати.
-        //
-        // Только по репозиторию события: полный обход при каждом чихе в любом
-        // из отслеживаемых означал бы обращение ко всем.
-        // Событие всегда называет свой репозиторий, и владельца выяснять не
-        // надо: подхватываем его напрямую, если он вообще под наблюдением.
-        const owner = await defaultOwner()
+        const activeGit = isGithub ? github : gitea
+        const owner = isGithub
+          ? (String(getConfig().githubOwner ?? '').trim() || target.owner)
+          : await defaultOwner()
         const taken = target.owner === owner || isWatched({
           config: getConfig(), owner: target.owner, defaultOwner: owner, repo: target.repo,
         })
           ? await intakeAll({
-            gitea, store, config: getConfig(), owner: await defaultOwner(), logger: ctx.logger,
+            gitea: activeGit, store, config: getConfig(), owner, logger: ctx.logger,
             only: (pair) => pair.owner === target.owner && pair.repo === target.repo,
           })
           : { added: 0, skipped: 0, failed: 0 }
 
-        // Вебхук говорит «здесь что-то произошло», а решает сверка: у неё перед
-        // глазами полная картина, а у события — только его кусок.
         const out = await syncAll({
-          gitea, store, logger: ctx.logger,
+          gitea: git, store, logger: ctx.logger,
           only: (t) => t.owner === target.owner && t.repo === target.repo
             && (target.issueNumber === undefined || t.issueNumber === target.issueNumber),
         })
@@ -733,7 +765,7 @@ export function apply(ctx, config) {
         ctx.tools.register(defineTool(boardReportDefinition({ store }))),
         ctx.tools.register(defineTool(boardCommentsDefinition({ store }))),
         ctx.tools.register(defineTool(boardCommentAddDefinition({ store }))),
-        ctx.tools.register(defineTool(boardDecomposeDefinition({ store, gitea }))),
+        ctx.tools.register(defineTool(boardDecomposeDefinition({ store, gitea: git }))),
         ctx.tools.register(defineTool(boardChecklistItemDefinition({ store }))),
       ]
       return () => { for (const stop of off) stop?.() }
@@ -929,7 +961,7 @@ export function apply(ctx, config) {
         return
       }
       if (req.method === 'POST' && action === 'refresh') {
-        reply(res, await refreshTask({ gitea, store, id }))
+        reply(res, await refreshTask({ gitea: git, store, id }))
         return
       }
       if (req.method === 'POST' && action === 'start') {
@@ -1051,12 +1083,12 @@ export function apply(ctx, config) {
           return
         }
         if (req.method === 'POST' && action === 'triage') {
-          const resObj = await handleTriageTask({ store, gitea, task: store.getTask(id), input })
+          const resObj = await handleTriageTask({ store, gitea: git, task: store.getTask(id), input })
           writeJson(res, resObj.status, resObj.body)
           return
         }
         if (req.method === 'POST' && (action === 'subtask' || action === 'subtasks')) {
-          const resObj = await handleCreateSubtask({ store, gitea, task: store.getTask(id), input })
+          const resObj = await handleCreateSubtask({ store, gitea: git, task: store.getTask(id), input })
           writeJson(res, resObj.status, resObj.body)
           return
         }
@@ -1066,7 +1098,7 @@ export function apply(ctx, config) {
           return
         }
         if (req.method === 'POST' && action === 'pr') {
-          const resObj = await handleCreateTaskPr({ store, gitea, task: store.getTask(id), input })
+          const resObj = await handleCreateTaskPr({ store, gitea: git, task: store.getTask(id), input })
           writeJson(res, resObj.status, resObj.body)
           return
         }
@@ -1223,7 +1255,7 @@ export function apply(ctx, config) {
     path: '/dsh-kanban/gitea/repos',
     handler: async (req, res) => {
       const url = urlOf(req)
-      reply(res, await searchRepos({ gitea, query: url.searchParams.get('q') || '' }))
+      reply(res, await searchRepos({ gitea: git, query: url.searchParams.get('q') || '' }))
     },
   }), 'dsh-kanban: repo search')
 
@@ -1233,7 +1265,7 @@ export function apply(ctx, config) {
     handler: async (req, res) => {
       const url = urlOf(req)
       reply(res, await listImportable({
-        gitea,
+        gitea: git,
         store,
         owner: url.searchParams.get('owner') || undefined,
         repo: url.searchParams.get('repo') || undefined,

package/lib/store.js

@@ -106,7 +106,7 @@ const WRITABLE = [
 ]
 
 /** Источники перехода; чужое значение не пишем, чтобы журнал оставался читаемым. */
-const SOURCES = new Set(['manual', 'session', 'gitea', 'tool'])
+const SOURCES = new Set(['manual', 'session', 'gitea', 'github', 'tool'])
 
 function rowToTask(row) {
   if (row === undefined) return undefined
@@ -205,6 +205,7 @@ export function openStore({ dir }) {
     ['parentId', "TEXT NOT NULL DEFAULT ''"],
     ['isEpic', "INTEGER NOT NULL DEFAULT 0"],
     ['externalRef', "TEXT"],
+    ['provider', "TEXT NOT NULL DEFAULT 'gitea'"],
   ]) {
     try { db.exec(`ALTER TABLE tasks ADD COLUMN ${column} ${definition}`) } catch { /* столбец уже есть */ }
   }

package/lib/webhook.js

@@ -1,4 +1,4 @@
-// Приём событий Gitea.
+// Приём событий Gitea и GitHub.
 //
 // Вебхук даёт мгновенную сверку вместо ожидания следующего опроса. Опрос при
 // этом остаётся: вебхук может быть не настроен, недоступен снаружи или просто
@@ -9,7 +9,7 @@
 import { createHmac, timingSafeEqual } from 'node:crypto'
 
 /**
- * Проверить подпись доставки.
+ * Проверить подпись доставки (поддерживает Gitea X-Gitea-Signature и GitHub X-Hub-Signature-256).
  *
  * Сравнение постоянного времени: обычное посимвольное сравнение по времени
  * ответа выдаёт, сколько первых байтов угадано, и подпись подбирается за
@@ -17,16 +17,33 @@ import { createHmac, timingSafeEqual } from 'node:crypto'
  *
  * @param {string} secret общий секрет
  * @param {string|Buffer} body сырое тело запроса
- * @param {string} signature значение заголовка X-Gitea-Signature
+ * @param {string} signature значение заголовка X-Gitea-Signature или X-Hub-Signature-256
  */
 export function verifySignature(secret, body, signature) {
   if (!secret) return false
-  const provided = String(signature ?? '').trim().toLowerCase()
+  let provided = String(signature ?? '').trim().toLowerCase()
+  if (provided.startsWith('sha256=')) {
+    provided = provided.slice(7).trim()
+  }
   if (!/^[0-9a-f]{64}$/.test(provided)) return false
   const expected = createHmac('sha256', secret).update(body ?? '').digest('hex')
   return timingSafeEqual(Buffer.from(expected, 'hex'), Buffer.from(provided, 'hex'))
 }
 
+/**
+ * Определить провайдера вебхука по входящим заголовкам запроса.
+ *
+ * @param {object} headers заголовки HTTP-запроса
+ * @returns {'github'|'gitea'}
+ */
+export function detectWebhookProvider(headers) {
+  if (!headers || typeof headers !== 'object') return 'gitea'
+  if (headers['x-github-event'] || headers['x-hub-signature-256']) {
+    return 'github'
+  }
+  return 'gitea'
+}
+
 /**
  * Что за задачу затронуло событие.
  *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@goodandready/dsh-kanban",
-  "version": "0.2.14",
-  "description": "Visual Kanban board for DeepSeek Harness: Gitea-backed tasks, workflow columns, and a dedicated agent session per task.",
+  "version": "0.2.15",
+  "description": "Visual Kanban board for DeepSeek Harness: Gitea and GitHub-backed tasks, workflow columns, and a dedicated agent session per task.",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -27,6 +27,7 @@
     "dsh-plugin",
     "kanban",
     "gitea",
+    "github",
     "tasks",
     "agents",
     "deepseek-harness"