@goodandready/dsh-goal 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 goodandready
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,47 @@
+# @goodandready/dsh-goal
+
+> **Goal Mode & Autonomous Execution Plugin for DeepSeek Harness (DSH)**
+
+`dsh-goal` adds an autonomous goal-tracking loop with a sticky top status banner, milestone decomposition, live timer, and interactive controls (pause, resume, cancel, modal details).
+
+---
+
+## Features
+
+- 🎯 **Sticky Top Goal Banner**: Minimalist header pinned above the chat showing the active goal, elapsed timer (`• 2s`, `• 1m 45s`), and controls.
+- ⏸️ **Play / Pause / Cancel**: Instantly halt autonomous multi-turn loops or resume whenever ready.
+- ⛶ **Milestone Modal Drawer**: Interactive checklist of sub-tasks with progress bar and execution logs.
+- 🤖 **Agent Tools**:
+  - `goal_set_milestones`: Autonomous breakdown of high-level goals into step-by-step tasks.
+  - `goal_update_progress`: Step-by-step milestone completion tracking.
+  - `goal_finish`: Goal completion with deliverable summary.
+- ⚙️ **Safety Limit & Settings**: Max iterations guardrail to prevent infinite agent loops.
+- 🌐 **Bilingual**: Full English and Russian localization.
+
+---
+
+## Installation
+
+```bash
+dsh plugin add @goodandready/dsh-goal
+```
+
+## Quick Start
+
+1. Start a goal in chat:
+   ```text
+   /goal Refactor auth tokens and write integration tests
+   ```
+2. Or use the REST API:
+   ```bash
+   curl -X POST http://localhost:3080/dsh-goal/action \
+     -H "Content-Type: application/json" \
+     -d '{"action":"start","title":"Optimize database queries"}'
+   ```
+3. Watch the sticky top banner update with live timer and milestones in real-time.
+
+---
+
+## License
+
+MIT © [goodandready](https://goodandready.app)

package/README.ru.md

@@ -0,0 +1,51 @@
+# @goodandready/dsh-goal
+
+> **Плагин целеполагания и автономного выполнения задач (Goal Mode) для DeepSeek Harness**
+
+`dsh-goal` внедряет в DeepSeek Harness автономный режим целеполагания с закреплённой верхней панелью (Sticky Top Banner), декомпозицией шагов на вехи (milestones), живым таймером и интерактивным управлением (пауза, продолжение, отмена, окно детального чеклиста).
+
+---
+
+## Возможности
+
+- 🎯 **Закреплённая панель цели (Top Banner)**: компактная плашка над чатом в стиле нативного UI DSH:
+  - Иконка мишени 🎯;
+  - Лейбл «Текущая цель» и название активной задачи;
+  - Живой секундомер выполнения (`• 2s`, `• 14s`, `• 2m 10s`);
+  - Быстрые кнопки: 🗑 (сбросить/отменить), ⏸ / ▶ (пауза/возобновление), ⛶ (развернуть детали).
+- ⛶ **Модальное окно чеклиста вех**: подробный список подзадач, прогресс-бар выполнения (0–100%) и лог шагов.
+- 🤖 **Инструменты для модели**:
+  - `goal_set_milestones` — разбиение цели на этапы;
+  - `goal_update_progress` — фиксация выполнения очередного этапа;
+  - `goal_finish` — завершение цели с итоговым резюме.
+- 🛡️ **Safety Guardrails**: настраиваемый лимит шагов (maxIterations) для защиты от зацикливания.
+- ⚙️ **Карточка настроек**: управление плагином во вкладке «Настройки → Плагины».
+- 🌐 **Локализация**: полная поддержка русского и английского языков.
+
+---
+
+## Установка
+
+```bash
+dsh plugin add @goodandready/dsh-goal
+```
+
+## Использование
+
+1. Поставьте цель сообщением в чате:
+   ```text
+   /goal Исправить баг в аутентификации и добавить тесты
+   ```
+2. Или отправьте команду через REST API:
+   ```bash
+   curl -X POST http://localhost:3080/dsh-goal/action \
+     -H "Content-Type: application/json" \
+     -d '{"action":"start","title":"Привет"}'
+   ```
+3. Сверху появится панель с таймером и кнопками управления.
+
+---
+
+## Лицензия
+
+MIT © [goodandready](https://goodandready.app)

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+- insert:
+    - id: dsh-goal
+      name: '@goodandready/dsh-goal'
+      config: {}

package/docs/design/DESIGN.md

@@ -0,0 +1,72 @@
+# DESIGN.md — Дизайн-контракт `dsh-goal`
+
+## 1. Назначение и концепция
+
+Плагин `dsh-goal` реализует автономный режим достижения целей (Goal Mode) для **DeepSeek Harness** (DSH).
+Визуальная доминанта — компактная закреплённая верхняя панель (Sticky Top Banner), отображающая текущую активную цель, секундомер выполнения и кнопки мгновенного управления (🗑 сброс, ⏸ пауза/возобновление, ⛶ детали/модалка).
+
+---
+
+## 2. Пользовательские поверхности (User Surfaces)
+
+### 2.1 Sticky Top Banner (Верхняя закреплённая панель цели)
+- **Расположение**: Верхняя часть окна чата/сессии над лентой сообщений.
+- **Элементы слева направо**:
+  1. `IconTarget` (🎯 SVG 16x16, обводка `currentColor`);
+  2. Заголовок **«Текущая цель»** (вес 600, `var(--dsw-alias-label-primary)`);
+  3. Текст цели (например: «привет» или «Исправить баг в аутентификации», цвет `var(--dsw-alias-label-secondary)`, `text-overflow: ellipsis`);
+  4. Разделитель и таймер: `• 2s` (динамический счётчик `• 14s`, `• 2m 15s`, шрифт `monospace`);
+  5. Панель кнопок справа:
+     - Кнопка **🗑 (Очистить / Отменить)**: диалог подтверждения отмены/сброса цели;
+     - Кнопка **⏸ / ▶ (Пауза / Продолжить)**: переключение между автономным циклом (`RUNNING`) и паузой (`PAUSED`);
+     - Кнопка **⛶ (Развернуть детали)**: открытие модального окна со списком вех и логом.
+
+### 2.2 Modal Details Dialog (Окно декомпозиции и прогресса ⛶)
+- **Шапка**: Название цели, статус-бейдж (`В процессе`, `На паузе`, `Завершено`), общий процент выполнения.
+- **Тело**:
+  - Чеклист вех (Milestones): статус каждой вехи (`pending` ⏳, `in_progress` 🔄, `completed` ✅, `failed` ❌);
+  - Лог итераций и ключевых выводов модели;
+  - Метрики: общее время, количество итераций (turns), максимальный лимит.
+- **Футер**: Кнопки ручного добавления шага, паузы и закрытия.
+
+### 2.3 Settings Card (`settings.plugin.item`)
+- Размещение во вкладке «Настройки → Плагины».
+- Параметры:
+  - `maxIterations`: максимальное число автономных шагов до принудительной остановки (дефолт: 25);
+  - `autoDrive`: автоматически вызывать следующий шаг модели (дефолт: true);
+  - `enableSound`: звуковой сигнал по завершении цели (дефолт: true);
+  - `promptTemplate`: шаблон системного инжекта в контекст модели.
+
+---
+
+## 3. Цветовая палитра и токены DSH
+
+Плагин использует исключительно системные переменные DSH:
+- Фоновый слой: `var(--dsw-alias-bg-layer-3)` и `var(--dsw-alias-bg-layer-2)`
+- Границы: `var(--dsw-alias-border-l2)`
+- Текст основной: `var(--dsw-alias-label-primary)`
+- Текст вторичный: `var(--dsw-alias-label-secondary)`
+- Текст третичный / метки времени: `var(--dsw-alias-label-tertiary)`
+- Акцент/успех: `var(--dsw-alias-status-success)`
+- Предупреждение/пауза: `var(--dsw-alias-status-warning)`
+- Ошибка/удаление: `var(--dsw-alias-status-danger)`
+
+---
+
+## 4. Состояния (State Machine)
+
+| Состояние | Баннер | Действия |
+|---|---|---|
+| `IDLE` | Скрыт или нейтральный placeholder | Кнопка «Поставить цель» |
+| `RUNNING` | Активен, таймер тикает, индикатор мишени | 🗑 Отмена, ⏸ Пауза, ⛶ Детали |
+| `PAUSED` | Активен, таймер застыл, иконка ▶ вместо ⏸ | 🗑 Отмена, ▶ Возобновить, ⛶ Детали |
+| `COMPLETED` | Активен, зелёная иконка успеха, итоговое время | 🗑 Очистить, ⛶ Посмотреть отчёт |
+| `FAILED` | Активен, красная иконка ошибки/лимита | 🗑 Очистить, ⛶ Логи ошибки |
+
+---
+
+## 5. Locked Design Decisions
+
+1. **Единый префикс классов**: `.dsh-goal-*` во всех CSS-правилах во избежание конфликтов стилей.
+2. **Точный макет баннера**: скругление углов 8–10px, шапка с отступами `8px 16px`, выравнивание по центру, кнопки действий справа с `gap: 10px`.
+3. **Безопасность импортов**: все `require('@deepseek-ai/dsh-client-ui-primitives')` обёрнуты в `try/catch` с SVG-фоллбеками.