@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/README.md +24 -0
- package/{docs/README.ru.md → README.ru.md} +10 -0
- package/{docs/README.zh.md → README.zh.md} +21 -0
- package/lib/board-tool.js +151 -0
- package/lib/client.js +1020 -763
- package/lib/commands.js +6 -11
- package/lib/config.js +31 -29
- package/lib/events.js +2 -2
- package/lib/filters.js +2 -2
- package/lib/gitea.js +15 -0
- package/lib/index.js +171 -142
- package/lib/power.js +1 -1
- package/lib/progress-dump.js +3 -3
- package/lib/routes.js +403 -5
- package/lib/store.js +59 -9
- package/lib/sync.js +26 -3
- package/lib/task-service.js +56 -0
- package/lib/updater.js +338 -0
- package/lib/worktree.js +1 -1
- package/package.json +7 -3
- package/docs/design/DESIGN.md +0 -94
- package/docs/plans/2026-08-26-dsh-kanban-0.1.md +0 -169
- package/docs/plans/2026-09-07-quality-acceptance-gateway.md +0 -25
- package/docs/plans/2026-09-08-concurrency-safety.md +0 -8
- package/docs/plans/2026-09-08-diff-viewer-merge.md +0 -7
- package/docs/plans/2026-09-08-session-worktree-stability.md +0 -33
- package/docs/plans/2026-09-10-issue-238-settings-scope.md +0 -13
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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.
|
|
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
|
-
"
|
|
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": {
|
package/docs/design/DESIGN.md
DELETED
|
@@ -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 копий перед перезаписью данных.
|