@goodandready/dsh-kanban 0.1.23 → 0.1.24

package/README.md

@@ -260,6 +260,12 @@ compares the requested names against the actual exports. It is deliberately not
 part of `npm test`: the test suite runs without a core and without a profile.
 Run it on the machine where the harness lives, before publishing.
 
+## 💻 Cross-Platform Path Handling
+
+Task working directories (`resolveCwd`) respect operating system path conventions.
+On Windows, repository root fencing accounts for drive letters and backslash path
+separators, ensuring full test and runtime compatibility across POSIX and Windows.
+
 ## 📄 License
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)

package/docs/design/DESIGN.md

@@ -0,0 +1,52 @@
+# DESIGN.md — dsh-kanban
+
+## Product / Purpose
+- Назначение: Интегрированная доска задач для DeepSeek Harness с двусторонней сверкой с Gitea, автоматическим подхватом сессий агентов и управлением жизненным циклом.
+- Аудитория: Разработчики и операторы DeepSeek Harness, ведущие проектные задачи и сессии агентов.
+- Статус: Production, версия 0.1.23+.
+
+## User Surfaces
+- Web/UI: Экран доски в центральной колонке интерфейса DSH (mountBoard), выдвигающаяся панель задач, фильтры, группировки (по проектам, по исполнителю), метрики переходов.
+- DSH UI / settings / slots:
+  - Карточка настроек в слоте settings.plugin.item (пространство dsh-kanban).
+  - Чип активной задачи в conversation.session.header.utilities.
+  - Пункт бокового меню для вызова экрана доски.
+- API: HTTP эндпоинты /dsh-kanban/* (board, snapshot, task, sync, webhook, metrics, whoami).
+- CLI: node tools/compat.mjs (проверка совместимости экспортов ядра).
+- Документация: README.md, docs/README.ru.md, docs/README.zh.md, index.md.
+
+## Visual Direction
+- Атмосфера: Строгий утилитарный инструментальный интерфейс в едином стиле темы DeepSeek Harness.
+- Утверждённые референсы и что из них берём: Системные карточки DSH (стили заголовков, отступы, шрифты, цветовые токены --dsw-alias-*).
+- Не копировать: Внешние неинтегрированные темы, разнородные цвета рамок и теней.
+
+## Foundations
+- Цвета и роли: Использование CSS-переменных DSH темы (--dsw-alias-bg-layer-3, --dsw-alias-border-l2, --dsw-alias-label-primary, --dsw-alias-label-secondary).
+- Типографика: Системный стек шрифтов DSH (inherit, 13-14px базовый размер, 11-12px для бейджей и служебных меток).
+- Сетка, отступы, responsive: 5 стандартных колонок (backlog, ready, progress, review, done) с горизонтальным скроллом и адаптивными карточками.
+- Accessibility: Нативные кнопки button, role="status" для сообщений, семантичные поля ввода с aria-label/label.
+
+## Components And States
+- Компоненты: BoardScreen, Column, Card, TaskDrawer, KanbanSettingsCard, TaskChip, MetricsModal.
+- Loading / empty / error / success:
+  - Загрузка: состояние скелетона/лоадера без блокировки скролла.
+  - Пустые колонки: пунктирная область перетаскивания.
+  - Ошибки: всплывающий баннер с ключом локализации t('error.' + err).
+- Формы, валидация и действия: Валидация обязательных полей при создании задачи, блокировка повторных кликов при сохранении.
+
+## User Flows
+- Критические сценарии:
+  1. Создание задачи / подхват из Gitea Issue.
+  2. Перемещение карточки между колонками человеком или через инструмент агента board_move.
+  3. Запуск сессии агента по карточке с автоматическим назначением ответственного.
+  4. Автоматическое обновление статуса (waiting) по событиям ядра (session/event).
+  5. Экспорт и импорт снимка доски в JSON.
+
+## Do / Don't
+- Do: Использовать только токены темы --dsw-alias-*, очищать все слушатели событий при размонтировании, соблюдать порядок хуков React.
+- Don't: Не переводить карточку в done агентом (колонка done фиксируется только по факту закрытия issue и ветки).
+
+## Locked Design Decisions
+- 2026-08-20 — Карточка настроек монтируется в settings.plugin.item с резервом в settings.section.
+- 2026-08-25 — Использование дробной индексации ($O(1)$) для позиционирования карточек.
+- 2026-09-02 — Снимок доски объединён на маршруте /dsh-kanban/snapshot (GET: выгрузка, POST: загрузка).

package/lib/launcher.js

@@ -12,7 +12,7 @@
 // Пакеты ядра здесь не импортируются: идентификатор сессии и сборка сообщения
 // приходят параметрами. Так модуль проверяется без харнесса и без сети.
 
-import { isAbsolute, join, resolve } from 'node:path'
+import { isAbsolute, join, resolve, sep } from 'node:path'
 
 /**
  * Хвост своей задачи — УСЛОВИЕ, а не приказ.
@@ -110,7 +110,8 @@ export function resolveCwd(task, config, cwdOf = () => process.cwd()) {
 
   const target = resolve(join(root, repo))
   const fence = resolve(root)
-  if (target !== fence && !target.startsWith(fence.endsWith('/') ? fence : fence + '/')) {
+  const fenceSep = fence.endsWith(sep) || fence.endsWith('/') ? fence : fence + sep
+  if (target !== fence && !target.startsWith(fenceSep) && !target.startsWith(fence.endsWith('/') ? fence : fence + '/')) {
     throw new Error('имя репозитория выводит за пределы корня проектов')
   }
   return target

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-kanban",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "Visual Kanban board for DeepSeek Harness: Gitea-backed tasks, workflow columns, and a dedicated agent session per task.",
   "type": "module",
   "main": "lib/index.js",