@goodandready/dsh-goal 0.1.10 → 0.2.1

package/README.md

@@ -44,6 +44,12 @@ Complex engineering tasks require multi-step autonomy: decomposing high-level ob
 Without an autonomous tracking framework, agents can lose context across turns, stall in passive loops, or fail to notify users when complex workflows stall.
 
 **`@goodandready/dsh-goal`** introduces Goal Mode to DeepSeek Harness:
+* 💡 **Live Steering & Nudge (*Added in v0.2.0*)**: Dynamically clarify, amend, or guide the agent's active objective on the fly without aborting the loop.
+* 🔔 **Native Browser Notifications (*Added in v0.2.0*)**: Zero-dependency desktop push notifications via HTML5 `Notification API` when long-running goals complete or require attention.
+* 📑 **10 Quick Launch Presets (*Added in v0.2.0*)**: Ready-to-use engineering prompt chips (Fix Bug, Refactor YAGNI, Tests & Coverage, Code Review, Security Audit, New Feature, Docs, Upgrade Deps, Dead Code Cleanup, Performance).
+* 🛡️ **Tool-Failure Breaker (*Added in v0.2.0*)**: Configurable consecutive tool error limit (`consecutiveToolFailureLimit`, default: 3) to halt loops upon repetitive tool crashes and prevent token burn.
+* 📌 **Git Checkpoint Snapshot (*Added in v0.2.0*)**: Automatically captures start commit hash (`git rev-parse --short HEAD`) with 1-click `git diff` / rollback command in details modal.
+* 🐙 **GitHub & Gitea PR Comment Export (*Added in v0.2.0*)**: One-click formatted comment generator with collapsible `<details><summary>` milestone cards and token telemetry.
 * 🎯 **Sticky Top Goal Banner**: Pinned header over composer dock with live elapsed timer (`• 2s`, `• 1m 45s`), real-time status badge (`RUNNING`, `PAUSED`, `COMPLETED`), active goal title, and control actions.
 * ⏸️ **Play / Pause / Resume / Cancel**: Instantly pause the autonomous loop or resume execution on demand via buttons or `/goal` command.
 * 📋 **Milestone Breakdown & ETA**: Interactive checklist showing sub-tasks, completion status (`pending`, `in_progress`, `completed`, `failed`), progress bar, and dynamic completion ETA.
@@ -194,6 +200,8 @@ dsh-goal:
   autoDrive: true
   enableSound: true
   showQuickLaunchButton: true
+  consecutiveToolFailureLimit: 3
+  enableBrowserNotifications: true
 ```
 
 | Parameter | Type | Default | Description |
@@ -202,6 +210,8 @@ dsh-goal:
 | `autoDrive` | `boolean` | `true` | Keep the autonomous agent loop running between turns |
 | `enableSound` | `boolean` | `true` | Play audio chime when a goal completes or fails |
 | `showQuickLaunchButton` | `boolean` | `true` | Show the quick launch goal button above the composer dock |
+| `consecutiveToolFailureLimit` | `number` | `3` | Auto-pause goal if N consecutive turns hit tool execution errors (0 to disable) |
+| `enableBrowserNotifications` | `boolean` | `true` | Show native desktop push notifications on goal completion or failure |
 
 ---
 

package/README.ru.md

@@ -41,6 +41,12 @@
 Решение комплексных инженерных задач требует автономного многошагового выполнения: декомпозиции целей на майлстоуны, непрерывного выполнения итераций без ручного подталкивания пользователя и наглядного отслеживания прогресса.
 
 **`@goodandready/dsh-goal`** внедряет автономный режим достижения целей в DeepSeek Harness через команду `/goal`:
+* 💡 **Живая корректировка цели / Направление агента (*v0.2.0*)**: Возможность вносить точечные правки и уточнения в активную цель на лету без прерывания сессии.
+* 🔔 **Браузерные уведомления (*v0.2.0*)**: Нативные пуш-уведомления через HTML5 `Notification API` по завершении или сбое цели.
+* 📑 **10 инженерных пресетов (*v0.2.0*)**: Готовые кликабельные шаблоны задач (Fix Bug, Refactor YAGNI, Tests, Code Review, Security, Docs, Upgrade Deps, Cleanup, Performance) в окне запуска.
+* 🛡️ **Tool-Failure Breaker (*v0.2.0*)**: Настраиваемый порог ошибок инструментов (`consecutiveToolFailureLimit`, по умолчанию 3) для предотвращения бесконечных сбойных вызовов.
+* 📌 **Git Checkpoint (*v0.2.0*)**: Фиксация коммита старта (`git rev-parse --short HEAD`) и копирование команды `git diff` в 1 клик.
+* 🐙 **Экспорт отчета для GitHub / Gitea PR (*v0.2.0*)**: Генерация отчета со сворачиваемыми спойлерами `<details><summary>` для PR и задач.
 * 🎯 **Плавающий баннер в шапке**: зафиксированный статус-бар над чатом с таймером выполнения (`• 2s`, `• 1m 45s`), заголовком цели и кнопками управления.
 * ⏸️ **Управление циклом (Play / Pause / Cancel)**: мгновенная приостановка автономного цикла агента или его возобновление в любой момент.
 * 📋 **Интерактивная панель майлстоунов**: модальное окно со списком подзадач, прогресс-баром и журналом выполнения.

package/README.zh.md

@@ -193,6 +193,8 @@ dsh-goal:
   autoDrive: true
   enableSound: true
   showQuickLaunchButton: true
+| `consecutiveToolFailureLimit` | `number` | `3` | 连续 N 轮工具错误自动熔断暂停（0 为禁用） |
+| `enableBrowserNotifications` | `boolean` | `true` | 目标完成时发送桌面原生系统通知 |
 ```
 
 | 参数项 | 类型 | 默认值 | 说明 |

package/docs/design/DESIGN.md

@@ -139,3 +139,46 @@
    - Все перехваченные инструменты возвращают структуры, валидные по спецификации `GOAL_VALUE_SCHEMA` ядра (`goal: null` при отсутствии активной цели, либо объект цели с `id`, `revision`, `objective`, `phase`, `roundsStarted`, `maxGoalRounds`, `activation`).
 4. **Нейтрализация устаревшего системного промпта ядра:**
    - Удаляется секция `tool:goal` ядра с ошибочными директивами и заменяется актуальной динамической инструкцией `tool:dsh-goal`.
+
+
+### Решение 11: Живая корректировка цели (Live Steering / Nudge), браузерные уведомления, 10 инженерных пресетов, защита от сбоев инструментов и Git Checkpoints (v0.2.0)
+
+**Контекст:**
+В процессе активной эксплуатации автономного режима Goal Mode пользователям требовались:
+1. Возможность вносить точечные корректировки и уточнения в активную или приостановленную цель без прерывания сессии или перезапуска;
+2. Получение нативных уведомлений операционной системы при завершении длительных фоновых задач;
+3. Быстрый выбор типовых инженерных задач (багфикс, рефакторинг, тесты, код-ревью и др.) без ручного набора стандартных промптов;
+4. Защита от бесконечных повторных вызовов падающих инструментов (Tool-Failure Breaker) с настраиваемым порогом;
+5. Фиксация точки старта в репозитории (Git Checkpoint) для моментального просмотра изменений и отката;
+6. Экспорт структурированного отчета с интерактивными спойлерами для комментариев в GitHub / Gitea PR.
+
+**Принятые решения:**
+1. **Live Steering / Nudge**:
+   - Реализован метод `engine.nudge(text, sid)` и эндпоинт `POST /dsh-goal/action` с `action: 'nudge'`.
+   - Поле ввода в модальном окне деталей позволяет оператору направить агента.
+   - Указание сохраняется в `goal.nudges` и инжектируется в следующий промпт автодрайва как высокоприоритетная директива `🚨 URGENT USER CLARIFICATION / STEERING`.
+2. **Нативные браузерные уведомления (Notification API)**:
+   - При завершении цели (`COMPLETED` или `FAILED`) клиент вызывает системный push через `new Notification(...)` при наличии разрешения.
+   - В карточке настроек добавлен чекбокс `enableBrowserNotifications` с интерактивным запросом прав.
+3. **10 инженерных шаблонов запуска (Quick Launch Presets)**:
+   - В окно быстрого запуска добавлена лента чипов с 10 сценариями на трёх языках (`en`, `ru`, `zh`):
+     1. 🐛 Fix Bug & Verify
+     2. ⚡ Refactor (YAGNI)
+     3. 📝 Tests & Coverage
+     4. 🔍 Code Review
+     5. 🚀 New Feature
+     6. 🛡️ Security Audit
+     7. 📚 Docs & Contract
+     8. 📦 Upgrade Deps
+     9. 🧹 Dead Code Cleanup
+     10. ⚙️ Performance
+4. **Защита от циклических сбоев инструментов (Tool-Failure Breaker)**:
+   - В `GoalEngine` внедрен счетчик последовательных ошибок инструментов (`consecutiveToolFailureLimit`, по умолчанию 3, 0 — отключено).
+   - При превышении порога цель автоматически переводится в `PAUSED` с фиксацией точной причины в журнале.
+   - Порог настраивается через Schemastery карточку в интерфейсе настроек.
+5. **Git Checkpoint Snapshot**:
+   - При старте цели через `node:child_process` фиксируется короткий хеш `git rev-parse --short HEAD` (с таймаутом 1 сек).
+   - В окне деталей отображается бейдж `📌 Git: <commit>` с копированием команды `git diff <commit>` в один клик.
+6. **Экспорт отчета для GitHub / Gitea PR**:
+   - Метод `exportReportGitHubPR(state)` форматирует статус, время, расход токенов, резюме и таблицу вех внутри сворачиваемого блока `<details><summary>`.
+   - В окне деталей добавлена кнопка «🐙 Копировать для GitHub PR».