@goodandready/dsh-kanban 0.2.2 → 0.2.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/sync.js CHANGED
@@ -9,6 +9,29 @@ import { watchedRepos, shouldTake, archiveBefore, isWatched } from './intake.js'
9
9
  import { colorsOfIssue } from './filters.js'
10
10
  import { issueToTask, issueBornAt, issueAuthor, issueAssignee, issueMilestone } from './import.js'
11
11
 
12
+ /**
13
+ * Выполнить операцию с экспоненциальной задержкой (exponential backoff) при сбоях сети.
14
+ * @template T
15
+ * @param {() => Promise<T>} fn асинхронная операция
16
+ * @param {{retries?: number, baseMs?: number, maxMs?: number}} [opts]
17
+ * @returns {Promise<T>}
18
+ */
19
+ export async function withBackoff(fn, { retries = 2, baseMs = 50, maxMs = 500 } = {}) {
20
+ let attempt = 0
21
+ let firstErr
22
+ while (true) {
23
+ try {
24
+ return await fn()
25
+ } catch (err) {
26
+ if (!firstErr) firstErr = err
27
+ if (attempt >= retries) throw (firstErr || err)
28
+ const delay = Math.min(baseMs * (2 ** attempt), maxMs)
29
+ attempt += 1
30
+ await new Promise((resolve) => setTimeout(resolve, delay))
31
+ }
32
+ }
33
+ }
34
+
12
35
  /**
13
36
  * Наблюдения по одному репозиторию.
14
37
  *
@@ -22,7 +45,7 @@ import { issueToTask, issueBornAt, issueAuthor, issueAssignee, issueMilestone }
22
45
  * завершённой. Поэтому репозиторий с неудачным чтением пропускается до
23
46
  * следующей сверки целиком.
24
47
  */
25
- export async function readRepo({ gitea, owner, repo }) {
48
+ async function readRepo({ gitea, owner, repo }) {
26
49
  const [pulls, branches] = await Promise.all([
27
50
  gitea.listPulls({ owner, repo, state: 'all' }),
28
51
  gitea.listBranches({ owner, repo }),
@@ -202,7 +225,7 @@ export async function syncAll({ gitea, store, logger, only, now = Date.now() })
202
225
  for (const group of byRepo.values()) {
203
226
  let repoState
204
227
  try {
205
- repoState = await readRepo({ gitea, owner: group.owner, repo: group.repo })
228
+ repoState = await withBackoff(() => readRepo({ gitea, owner: group.owner, repo: group.repo }), { retries: 2, baseMs: 40 })
206
229
  } catch (error) {
207
230
  failed += group.tasks.length
208
231
  reposFailed += 1
@@ -244,7 +267,7 @@ export async function syncAll({ gitea, store, logger, only, now = Date.now() })
244
267
  *
245
268
  * @returns {Promise<Array<{owner: string, repo: string}>>}
246
269
  */
247
- export async function resolveRepos({ gitea, config, owner }) {
270
+ async function resolveRepos({ gitea, config, owner }) {
248
271
  const named = watchedRepos({ config, owner })
249
272
  if (named.length > 0) return named
250
273
  if (owner === undefined || owner === '') {
@@ -0,0 +1,56 @@
1
+ import { columnsOf } from './config.js'
2
+
3
+ export const TASK_PROVISION_CONTRACT = 'dsh-drives.task-provision.v1'
4
+
5
+ function text(value) {
6
+ return typeof value === 'string' ? value.trim() : ''
7
+ }
8
+
9
+ export function createKanbanTaskService({ getStore, store } = {}) {
10
+ const currentStore = () => getStore?.() || store
11
+ return {
12
+ contract: TASK_PROVISION_CONTRACT,
13
+ async createTask(input = {}) {
14
+ const activeStore = currentStore()
15
+ if (!activeStore || typeof activeStore.createTask !== 'function') {
16
+ return { ok: false, code: 'store-not-ready' }
17
+ }
18
+ const title = text(input.title)
19
+ if (!title) return { ok: false, code: 'title-required' }
20
+ if (title.length > 512) return { ok: false, code: 'title-too-long' }
21
+ const board = text(input.board) || 'main'
22
+ const column = text(input.column) || 'backlog'
23
+ const boards = typeof activeStore.listBoards === 'function' ? activeStore.listBoards() : []
24
+ if (!boards.some((item) => item.id === board)) {
25
+ return { ok: false, code: 'board-not-found', board }
26
+ }
27
+ const allowed = columnsOf(activeStore.boardKind(board))
28
+ if (!allowed.includes(column)) {
29
+ return { ok: false, code: 'column-not-found', board, column, allowed }
30
+ }
31
+ const externalRef = text(input.externalRef)
32
+ if (externalRef.length > 256) return { ok: false, code: 'external-ref-too-long' }
33
+ if (externalRef && typeof activeStore.findTaskByExternalRef === 'function') {
34
+ const existing = activeStore.findTaskByExternalRef(externalRef)
35
+ if (existing) {
36
+ return { ok: true, task: existing, taskId: existing.id, alreadyExists: true }
37
+ }
38
+ }
39
+ const task = activeStore.createTask({
40
+ board,
41
+ column,
42
+ title,
43
+ body: typeof input.body === 'string' ? input.body : '',
44
+ owner: text(input.owner) || null,
45
+ repo: text(input.repo) || null,
46
+ issueNumber: Number.isInteger(input.issueNumber) ? input.issueNumber : null,
47
+ issueUrl: typeof input.issueUrl === 'string' ? input.issueUrl : null,
48
+ labels: Array.isArray(input.labels)
49
+ ? [...new Set(input.labels.filter((label) => typeof label === 'string').map((label) => label.trim()).filter(Boolean))]
50
+ : [],
51
+ externalRef: externalRef || null,
52
+ })
53
+ return { ok: true, task, taskId: task.id, alreadyExists: false }
54
+ },
55
+ }
56
+ }
package/lib/updater.js ADDED
@@ -0,0 +1,338 @@
1
+ import { spawn } from 'node:child_process'
2
+ import { existsSync, readFileSync } from 'node:fs'
3
+ import { readFile } from 'node:fs/promises'
4
+ import { homedir } from 'node:os'
5
+ import { basename, dirname, isAbsolute, resolve } from 'node:path'
6
+ import { fileURLToPath } from 'node:url'
7
+
8
+ /**
9
+ * Host-side one-click updater for @goodandready/dsh-kanban.
10
+ * Implements the unified DSH plugin updater specification.
11
+ */
12
+
13
+ const UPDATE_HEADER = 'x-dsh-plugin-update'
14
+ const UPDATE_TIMEOUT_MS = 10 * 60_000
15
+ const VERSION_CACHE_MS = 5 * 60_000
16
+ let latestCache = undefined
17
+
18
+ function header(request, name) {
19
+ const value = request?.headers?.[name]
20
+ return Array.isArray(value) ? value[0] : value
21
+ }
22
+
23
+ function isLoopback(value) {
24
+ const address = value?.toLowerCase().replace(/^\[|\]$/g, '')
25
+ return (
26
+ address === 'localhost' ||
27
+ address === 'localhost.' ||
28
+ address === '::1' ||
29
+ address?.startsWith('127.') === true ||
30
+ address?.startsWith('::ffff:127.') === true
31
+ )
32
+ }
33
+
34
+ function isPrivateLan(value) {
35
+ const address = value?.toLowerCase().replace(/^\[|\]$/g, '')
36
+ if (!address) return false
37
+ const ipv4 = address.startsWith('::ffff:') ? address.slice(7) : address
38
+ return (
39
+ ipv4.startsWith('192.168.') ||
40
+ ipv4.startsWith('10.') ||
41
+ /^172\.(1[6-9]|2[0-9]|3[0-1])\./.test(ipv4)
42
+ )
43
+ }
44
+
45
+ export function isTrustedUpdateRequest(request) {
46
+ if (header(request, UPDATE_HEADER) !== '1') return false
47
+ const remote = request.socket?.remoteAddress
48
+ if (!isLoopback(remote) && !isPrivateLan(remote)) return false
49
+ const site = header(request, 'sec-fetch-site')
50
+ if (site !== undefined && site !== 'same-origin') return false
51
+ const origin = header(request, 'origin')
52
+ const host = header(request, 'host')
53
+ if (origin === undefined || host === undefined) return false
54
+ try {
55
+ const url = new URL(origin)
56
+ return (
57
+ (url.protocol === 'http:' || url.protocol === 'https:') &&
58
+ (isLoopback(url.hostname) || isPrivateLan(url.hostname)) &&
59
+ url.host === host
60
+ )
61
+ } catch {
62
+ return false
63
+ }
64
+ }
65
+
66
+ function validProfileName(value) {
67
+ return (
68
+ typeof value === 'string' &&
69
+ value !== '' &&
70
+ value !== '.' &&
71
+ value !== '..' &&
72
+ !value.includes('/') &&
73
+ !value.includes('\\') &&
74
+ !/[\0-\x1f\x7f]/.test(value)
75
+ )
76
+ }
77
+
78
+ function profileNameFromArgv(argv) {
79
+ for (let index = 0; index < argv.length; index += 1) {
80
+ const arg = argv[index]
81
+ if (arg === '--profile' || arg === '-p') {
82
+ const next = argv[index + 1]
83
+ if (validProfileName(next)) return next
84
+ }
85
+ if (typeof arg === 'string' && arg.startsWith('--profile=')) {
86
+ const value = arg.slice('--profile='.length)
87
+ if (validProfileName(value)) return value
88
+ }
89
+ }
90
+ return undefined
91
+ }
92
+
93
+ function findDshCliEntry() {
94
+ const entry = process.argv[1]
95
+ if (typeof entry !== 'string' || entry === '') return undefined
96
+ if (!existsSync(entry)) return undefined
97
+ for (let directory = dirname(entry); ; directory = dirname(directory)) {
98
+ const manifestPath = resolve(directory, 'package.json')
99
+ if (existsSync(manifestPath)) {
100
+ try {
101
+ const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'))
102
+ const bin =
103
+ typeof manifest.bin === 'string'
104
+ ? manifest.bin
105
+ : typeof manifest.bin === 'object' && manifest.bin !== null
106
+ ? manifest.bin.dsh
107
+ : undefined
108
+ if (
109
+ manifest.name === '@deepseek-ai/dsh' &&
110
+ typeof bin === 'string' &&
111
+ !isAbsolute(bin) &&
112
+ resolve(directory, bin) === resolve(entry)
113
+ ) {
114
+ return entry
115
+ }
116
+ } catch {
117
+ // Continue searching parent directories
118
+ }
119
+ }
120
+ const parent = dirname(directory)
121
+ if (parent === directory) return undefined
122
+ }
123
+ }
124
+
125
+ function runtime() {
126
+ const profileDir = resolve(
127
+ process.env.DSH_PROFILE_DIR ?? resolve(homedir(), '.dsh', 'profiles', 'web')
128
+ )
129
+ const selected = profileNameFromArgv(process.argv)
130
+ const profileName = validProfileName(selected)
131
+ ? selected
132
+ : validProfileName(basename(profileDir))
133
+ ? basename(profileDir)
134
+ : 'web'
135
+ const cliEntry = findDshCliEntry()
136
+ return cliEntry === undefined ? { profileName, profileDir } : { profileName, profileDir, cliEntry }
137
+ }
138
+
139
+ function parseSemver(value) {
140
+ const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(value)
141
+ if (match === null) return undefined
142
+ return {
143
+ core: [Number(match[1]), Number(match[2]), Number(match[3])],
144
+ prerelease: match[4]?.split('.') ?? [],
145
+ }
146
+ }
147
+
148
+ function comparePrerelease(left, right) {
149
+ if (left.length === 0 || right.length === 0) return left.length === right.length ? 0 : left.length === 0 ? 1 : -1
150
+ const length = Math.max(left.length, right.length)
151
+ for (let index = 0; index < length; index += 1) {
152
+ const a = left[index]
153
+ const b = right[index]
154
+ if (a === undefined || b === undefined) return a === b ? 0 : a === undefined ? -1 : 1
155
+ if (a === b) continue
156
+ const aNumeric = /^\d+$/.test(a)
157
+ const bNumeric = /^\d+$/.test(b)
158
+ if (aNumeric && bNumeric) {
159
+ const aNumber = BigInt(a)
160
+ const bNumber = BigInt(b)
161
+ if (aNumber !== bNumber) return aNumber > bNumber ? 1 : -1
162
+ continue
163
+ }
164
+ if (aNumeric !== bNumeric) return aNumeric ? -1 : 1
165
+ return a > b ? 1 : -1
166
+ }
167
+ return 0
168
+ }
169
+
170
+ export function isNewerVersion(currentValue, candidateValue) {
171
+ const current = parseSemver(currentValue)
172
+ const candidate = parseSemver(candidateValue)
173
+ if (current === undefined || candidate === undefined) return false
174
+ for (let index = 0; index < 3; index += 1) {
175
+ if (candidate.core[index] !== current.core[index]) return candidate.core[index] > current.core[index]
176
+ }
177
+ return comparePrerelease(candidate.prerelease, current.prerelease) > 0
178
+ }
179
+
180
+ async function latestVersion(packageName, registry) {
181
+ if (
182
+ latestCache?.packageName === packageName &&
183
+ latestCache.registry === registry &&
184
+ Date.now() < latestCache.expiresAt
185
+ ) {
186
+ return latestCache.version
187
+ }
188
+ try {
189
+ const response = await fetch(`${registry.replace(/\/$/, '')}/${encodeURIComponent(packageName)}/latest`, {
190
+ signal: typeof AbortSignal !== 'undefined' && AbortSignal.timeout ? AbortSignal.timeout(8000) : undefined,
191
+ })
192
+ if (!response.ok) return undefined
193
+ const value = await response.json()
194
+ if (typeof value?.version !== 'string' || value.version === '') return undefined
195
+ latestCache = { packageName, registry, version: value.version, expiresAt: Date.now() + VERSION_CACHE_MS }
196
+ return value.version
197
+ } catch {
198
+ return undefined
199
+ }
200
+ }
201
+
202
+ async function currentVersion(manifestUrl) {
203
+ const value = JSON.parse(await readFile(manifestUrl, 'utf8'))
204
+ if (typeof value?.version !== 'string' || value.version === '') {
205
+ throw new Error('Cannot read current plugin version.')
206
+ }
207
+ return value.version
208
+ }
209
+
210
+ export async function status(options, target) {
211
+ const current = await currentVersion(options.manifestUrl)
212
+ const latest = await latestVersion(options.packageName, options.registry ?? 'https://registry.npmjs.org')
213
+ return {
214
+ packageName: options.packageName,
215
+ currentVersion: current,
216
+ ...(latest === undefined ? {} : { latestVersion: latest }),
217
+ latestCheckFailed: latest === undefined,
218
+ updateAvailable: latest !== undefined && isNewerVersion(current, latest),
219
+ profileName: target.profileName,
220
+ canAutoUpdate: target.cliEntry !== undefined,
221
+ }
222
+ }
223
+
224
+ async function installExact(target, packageSpec, options) {
225
+ if (target.cliEntry === undefined) throw new Error('Automatic update is unavailable in this runtime.')
226
+ await new Promise((resolvePromise, reject) => {
227
+ const child = spawn(
228
+ process.execPath,
229
+ [
230
+ target.cliEntry,
231
+ 'plugin',
232
+ '--profile',
233
+ target.profileName,
234
+ 'add',
235
+ '--config.minimumReleaseAge=0',
236
+ packageSpec,
237
+ `--registry=${options.registry ?? 'https://registry.npmjs.org/'}`,
238
+ ],
239
+ {
240
+ cwd: target.profileDir,
241
+ windowsHide: true,
242
+ stdio: ['ignore', 'pipe', 'pipe'],
243
+ env: { ...process.env, NO_COLOR: '1' },
244
+ }
245
+ )
246
+ let detail = ''
247
+ child.stdout?.on('data', (chunk) => {
248
+ detail = (detail + String(chunk)).slice(-4000)
249
+ })
250
+ child.stderr?.on('data', (chunk) => {
251
+ detail = (detail + String(chunk)).slice(-4000)
252
+ })
253
+ const timer = setTimeout(() => {
254
+ child.kill()
255
+ reject(new Error('Update timed out; use the normal DSH update flow.'))
256
+ }, UPDATE_TIMEOUT_MS)
257
+ child.once('error', (error) => {
258
+ clearTimeout(timer)
259
+ reject(error)
260
+ })
261
+ child.once('exit', (code) => {
262
+ clearTimeout(timer)
263
+ if (code === 0) resolvePromise()
264
+ else reject(new Error(detail.trim() || `Update exited with code ${String(code)}.`))
265
+ })
266
+ })
267
+ }
268
+
269
+ function json(response, statusCode, value) {
270
+ response.writeHead(statusCode, {
271
+ 'content-type': 'application/json; charset=utf-8',
272
+ 'cache-control': 'no-store',
273
+ })
274
+ response.end(JSON.stringify(value))
275
+ }
276
+
277
+ export function registerPluginUpdater(ctx, options) {
278
+ let installing = false
279
+ if (typeof ctx?.webServer?.register !== 'function') {
280
+ ctx?.logger?.warn?.('[dsh-kanban] webServer service unavailable, updater skipped')
281
+ return () => {}
282
+ }
283
+
284
+ return ctx.webServer.register({
285
+ kind: 'exact',
286
+ path: options.endpoint,
287
+ handler: async (request, response) => {
288
+ try {
289
+ const target = runtime()
290
+ if (request.method === 'GET' || request.method === 'HEAD') {
291
+ const payload = await status(options, target)
292
+ response.writeHead(200, {
293
+ 'content-type': 'application/json; charset=utf-8',
294
+ 'cache-control': 'no-store',
295
+ })
296
+ response.end(request.method === 'HEAD' ? undefined : JSON.stringify(payload))
297
+ return
298
+ }
299
+ if (request.method !== 'POST') {
300
+ response.writeHead(405, { allow: 'GET, HEAD, POST' })
301
+ response.end()
302
+ return
303
+ }
304
+ if (!isTrustedUpdateRequest(request)) {
305
+ json(response, 403, { error: 'Rejected non-local or cross-origin update request.' })
306
+ return
307
+ }
308
+ if (installing) {
309
+ json(response, 409, { error: 'This plugin is already updating.' })
310
+ return
311
+ }
312
+ installing = true
313
+ try {
314
+ const before = await status(options, target)
315
+ if (before.latestVersion === undefined) {
316
+ json(response, 503, { error: 'The latest version is temporarily unavailable.' })
317
+ return
318
+ }
319
+ if (!before.updateAvailable) {
320
+ json(response, 200, before)
321
+ return
322
+ }
323
+ await installExact(target, `${options.packageName}@${before.latestVersion}`, options)
324
+ json(response, 200, {
325
+ ...before,
326
+ updatedVersion: before.latestVersion,
327
+ restartRequired: true,
328
+ })
329
+ } finally {
330
+ installing = false
331
+ }
332
+ } catch (error) {
333
+ ctx?.logger?.warn?.(`[dsh-kanban] plugin updater failed: ${String(error)}`)
334
+ json(response, 503, { error: 'Plugin update failed; see server logs.' })
335
+ }
336
+ },
337
+ })
338
+ }
package/lib/worktree.js CHANGED
@@ -23,7 +23,7 @@ const execFileAsync = promisify(execFile)
23
23
  * Стандартный исполнитель git-команд.
24
24
  * Принимает аргументы массивом, исключая шелл-инъекции.
25
25
  */
26
- export async function defaultGitRunner(args, cwd) {
26
+ async function defaultGitRunner(args, cwd) {
27
27
  try {
28
28
  const { stdout, stderr } = await execFileAsync('git', args, {
29
29
  cwd,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@goodandready/dsh-kanban",
3
- "version": "0.2.2",
3
+ "version": "0.2.8",
4
4
  "description": "Visual Kanban board for DeepSeek Harness: Gitea-backed tasks, workflow columns, and a dedicated agent session per task.",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",
@@ -14,7 +14,8 @@
14
14
  "lib/",
15
15
  "cordis.patch.yml",
16
16
  "README.md",
17
- "docs/",
17
+ "README.zh.md",
18
+ "README.ru.md",
18
19
  "LICENSE"
19
20
  ],
20
21
  "scripts": {
@@ -45,7 +46,10 @@
45
46
  },
46
47
  "client": {
47
48
  "platform": "web",
48
- "inject": []
49
+ "inject": [
50
+ "@deepseek-ai/dsh-client-locale",
51
+ "@deepseek-ai/dsh-client-ui-settings"
52
+ ]
49
53
  }
50
54
  },
51
55
  "peerDependencies": {
@@ -1,94 +0,0 @@
1
- # DESIGN.md — dsh-kanban
2
-
3
- ## Product / Purpose
4
- - Назначение: Интегрированная доска задач для DeepSeek Harness с двусторонней сверкой с Gitea, автоматическим подхватом сессий агентов и управлением жизненным циклом.
5
- - Аудитория: Разработчики и операторы DeepSeek Harness, ведущие проектные задачи и сессии агентов.
6
- - Статус: Production, версия 0.1.23+.
7
-
8
- ## User Surfaces
9
- - Web/UI: Экран доски в центральной колонке интерфейса DSH (mountBoard), выдвигающаяся панель задач, фильтры, группировки (по проектам, по исполнителю), метрики переходов.
10
- - DSH UI / settings / slots:
11
- - Карточка настроек в слоте settings.plugin.item (пространство dsh-kanban).
12
- - Чип активной задачи в conversation.session.header.utilities.
13
- - Пункт бокового меню для вызова экрана доски.
14
- - API: HTTP эндпоинты /dsh-kanban/* (board, snapshot, task, sync, webhook, metrics, whoami, checklist, report, comments, accept, reject).
15
- - CLI: node tools/compat.mjs (проверка совместимости экспортов ядра).
16
- - Документация: README.md, docs/README.ru.md, docs/README.zh.md, index.md.
17
-
18
- ## Visual Direction
19
- - Атмосфера: Строгий утилитарный инструментальный интерфейс в едином стиле темы DeepSeek Harness.
20
- - Утверждённые референсы и что из них берём: Системные карточки DSH (стили заголовков, отступы, шрифты, цветовые токены --dsw-alias-*).
21
- - Не копировать: Внешние неинтегрированные темы, разнородные цвета рамок и теней.
22
-
23
- ## Foundations
24
- - Цвета и роли: Использование CSS-переменных DSH темы (--dsw-alias-bg-layer-3, --dsw-alias-border-l2, --dsw-alias-label-primary, --dsw-alias-label-secondary).
25
- - Типографика: Системный стек шрифтов DSH (inherit, 13-14px базовый размер, 11-12px для бейджей и служебных меток).
26
- - Сетка, отступы, responsive: 5 стандартных колонок (backlog, ready, progress, review, done) с горизонтальным скроллом и адаптивными карточками.
27
- - Accessibility: Нативные кнопки button, role="status" для сообщений, семантичные поля ввода с aria-label/label.
28
-
29
- ## Components And States
30
- - Компоненты: BoardScreen, Column, Card, TaskDrawer (включая секции DoD Checklist, Execution Report, Comments Thread, Review Acceptance Gate), KanbanSettingsCard, TaskChip, MetricsModal.
31
- - Loading / empty / error / success:
32
- - Загрузка: состояние скелетона/лоадера без блокировки скролла.
33
- - Пустые колонки: пунктирная область перетаскивания.
34
- - Ошибки: всплывающий баннер с ключом локализации t('error.' + err).
35
- - Формы, валидация и действия: Валидация обязательных полей при создании задачи, блокировка повторных кликов при сохранении.
36
-
37
- ## User Flows
38
- - Критические сценарии:
39
- 1. Создание задачи / подхват из Gitea Issue.
40
- 2. Перемещение карточки между колонками человеком или через инструмент агента board_move.
41
- 3. Запуск сессии агента по карточке с автоматическим назначением ответственного.
42
- 4. Автоматическое обновление статуса (waiting) по событиям ядра (session/event).
43
- 5. Экспорт и импорт снимка доски в JSON.
44
-
45
- ## Do / Don't
46
- - Do: Использовать только токены темы --dsw-alias-*, очищать все слушатели событий при размонтировании, соблюдать порядок хуков React.
47
- - Don't: Не переводить карточку в done агентом (колонка done фиксируется только по факту закрытия issue и ветки).
48
-
49
- ## Locked Design Decisions
50
- - 2026-08-20 — Карточка настроек монтируется в settings.plugin.item (резерв в settings.section исключён по #238).
51
- - 2026-08-25 — Использование дробной индексации ($O(1)$) для позиционирования карточек.
52
- - 2026-09-02 — Снимок доски объединён на маршруте /dsh-kanban/snapshot (GET: выгрузка, POST: загрузка).
53
- - 2026-09-03 — Изоляция сессий задач в git worktree ($DSH_HOME/worktrees/<repo-key>/<task-id>/ на ветке task/<id>-<slug>), регистрация воркдерева в workspaceRegistry, проверка dirtyFiles и безопасная очистка в фазе cleanup (#193).
54
- - 2026-09-03 — Серверная инфраструктура автономности и безопасности (#195): Host-Side 5-field Cron, PowerInhibitor (кроссплатформенная блокировка сна системы во время работы задач), PROGRESSDUMP (фиксация срезов контекста, маскирование секретов и передача эстафеты), Permission Confirmation Gate (ручное одобрение прав выше базовых), инъекция секции доски в systemPrompt и хранение истории запусков прямо в карточке задачи (tasks.runs).
55
-
56
- - 2026-09-07 — Контур качества и приёмка человеком (#205–#209):
57
- - Протокольный шлюз: колонка done является исключительной границей приёмки человеком; инструменту board_move запрещён прямой перевод задачи в done.
58
- - DoD Acceptance Checklist: перевод в review блокируется до закрытия обязательных пунктов чеклиста с фиксацией доказательств (evidence).
59
- - Structured Report: фиксация отчёта выполнения (summary, changedFiles, checksRun, artifacts, risks) в карточке задачи.
60
- - Двусторонний цикл приёмки: явные действия человека Accept (в done) и Reject (возврат в in-progress с обязательной причиной rejectReason, инжектируемой в следующую сессию агента).
61
- - Ветка комментариев к задаче с поддержкой ролей user и agent для сквозного диалога прямо в Task Drawer.
62
-
63
- - 2026-09-08 — Стабильность сессий и воркдеревьев (#227, #226, #213, #215):
64
- - Привязка проекта сессии: при создании агента с воркдеревом поле meta.cwd сохраняет канонический projectRoot (repoDir), предотвращая выпадение сессий в категорию «Ungrouped» в сайдбаре DSH; путь воркдерева передается в meta.worktreePath и инструкциях агента (#227).
65
- - Режим «↻ Продолжить» (Resume Execution): эндпоинт POST /dsh-kanban/tasks/:id/resume и кнопка в TaskDrawer; сохраняет существующее воркдерево, ветку и незакоммиченные файлы, передавая агенту преамбулу продолжения и актуальный PROGRESSDUMP (#226).
66
- - Фильтрация structural noise в проверках dirtyFiles: в checkWorktreeDirty добавлен флаг --ignore-submodules=all, исключающий ложные блокировки удаления воркдеревьев из-за субмодулей и дрейфа gitlinks (#213).
67
- - Фильтрация сессий субагентов: сессии с маркером subagent (origin === 'subagent' или parentId !== undefined) исключаются из liveSessions и не перезаписывают состояние корневых задач (#215).
68
- ## Locked Decisions
69
- - **0.2.2 (Issue #238)**: Удалён устаревший фоллбэк на `settings.section` в пользу строгого размещения карточки в `settings.plugin.item`; все обращения к службам Cordis (в частности к `llm`) приведены к каноническому `ctx.get('...')`.
70
- - **0.2.1**: Карточка настроек плагина перенесена строго в слот `settings.plugin.item` (раздел «Настройки → Плагины → Настройки плагинов») без одновременной дублирующей регистрации в `settings.section` (Issue #236).
71
-
72
- ### 2026-09-08: Релиз v0.2.0 — Milestone (SSE, Chat Sync, Templates, Two-Column Drawer, Multi-Repo) (#210, #219, #220, #222, #225)
73
- - **Live SSE Channel (`/dsh-kanban/events`)**: Постоянное SSE-соединение с автоматическим переподключением для мгновенного пуша обновлений доски (`task:change`, `board:change`) без избыточного поллинга (#222).
74
- - **Auto-sync Sessions (`autoSyncSessions`)**: Опциональная автоматическая синхронизация стандартных диалогов чата DSH в карточки доски канбана с надежной фильтрацией внутренних сессий и субагентов (#225).
75
- - **Task Templates Library (`/dsh-kanban/templates`)**: Библиотека из 5 встроенных типовых шаблонов (Feature, Bugfix, Refactor, Security, Release) с предзаполненными чеклистами DoD и шаблонами промптов (#220).
76
- - **Two-Column Drawer Layout**: Адаптивный двухколоночный макет для TaskDrawer на экранах шириной от 960px с разделением метаданных и контентной области (#219).
77
- - **Multi-Repo Workspace Mirroring**: Сканирование нескольких вложенных git-репозиториев (`findWorkspaceGitRepos`) и подготовка зеркальных воркдеревьев на единой ветке задачи (`prepareMultiRepoMirror`) (#210).
78
-
79
- ### 2026-09-08: Релиз Vector 4 (UX оператора, управление моделями и аналитика) (#217, #218, #221, #223, #228)
80
- - **reasoningEffort**: Добавлен селектор глубины рассуждения (low, medium, high) в карточке `TaskDrawer`, сохраняется в SQLite и передается в метаданные сессии DSH для моделей с рассуждением (DeepSeek-R1, OpenAI o1/o3).
81
- - **Экспорт в CSV с UTF-8 BOM**: Добавлен эндпоинт `GET /dsh-kanban/export.csv` и кнопка в тулбаре для выгрузки аналитики задач в Microsoft Excel без искажения кодировки.
82
- - **Адаптивный 36x36 Rail Icon**: Кнопка канбана в сайдбаре автоматически принимает компактный размер 36×36 px с центрированием иконки при сворачивании панели в rail.
83
- - **Lightbox для изображений**: Превью Markdown-изображений в карточке открываются в модальном полноэкранном лайтбоксе.
84
-
85
-
86
- ### 2026-09-08: Релиз Vector 3 (Просмотр Git Diff / Коммитов и Однокликовый Merge) (#211, #212)
87
- - **Git Diff & Commits Viewer**: В `TaskDrawer` интегрирован блок просмотра истории коммитов сессии и unified diff измененных файлов воркдерева (`GET /tasks/:id/diff` и `GET /tasks/:id/commits`). Diff безопасно ограничен 250 КБ.
88
- - **One-Click Merge (--no-ff)**: В секции Review Acceptance Gate добавлена кнопка «✓ Принять и смержить» (`POST /tasks/:id/merge`). Выполняется проверка на отсутствие незакоммиченных изменений (`checkWorktreeDirty`), слияние `git merge --no-ff` в целевую ветку (`main`), автоматическая дерегистрация и удаление воркдерева с переводом задачи в `done`.
89
-
90
-
91
- ### 2026-09-08: Релиз Vector 2 (Управление параллелизмом и безопасность) (#214, #216, #224)
92
- - **maxConcurrentSessions**: Лимит параллельных сессий агентов (по умолчанию 3) предотвращает исчерпание памяти/CPU на хосте. Задачи сверх лимита переводятся в очередь (`queuedAt > 0`) и автоматически запускаются диспетчером при завершении активных сессий.
93
- - **workspaceClaimBoundaries**: Инструмент `board_move` проверяет принадлежность задачи к воркспейсу текущей сессии агента, предотвращая случайный межпроектный захват карточек.
94
- - **Страховочный бэкап при импорте снимка**: `importBoard` в `/dsh-kanban/snapshot` автоматически делает снимок базы SQLite в `backups/kanban-backup-<timestamp>.db` с ротацией последних 10 копий перед перезаписью данных.