@goodandready/dsh-goal 0.1.5 → 0.1.7

package/lib/command-handler.js

@@ -1,192 +1,193 @@
-import { randomUUID } from 'node:crypto';
-import { GoalState } from './goal-engine.js';
-
-export const USAGE = 'Использование: /goal [<цель>|clear|pause|resume]';
-
-/**
- * Парсинг строки ввода для команды /goal
- * @param {string} rawInput
- * @returns {{ action: string, text?: string }}
- */
-export function parseGoalInput(rawInput = '') {
-  const input = String(rawInput || '').trim();
-  if (!input) {
-    return { action: 'show' };
-  }
-
-  const lower = input.toLowerCase();
-  if (lower === 'clear') return { action: 'clear' };
-  if (lower === 'pause') return { action: 'pause' };
-  if (lower === 'resume') return { action: 'resume' };
-
-  return { action: 'start', text: input };
-}
-
-/**
- * Создание валидного identified сообщения пользователя для отправки агенту через followup
- * @param {string} text
- * @returns {Object}
- */
-export function createGoalUserMessage(text) {
-  return {
-    id: randomUUID(),
-    role: 'user',
-    content: [{ type: 'text', text }],
-    source: { kind: 'user' },
-  };
-}
-
-/**
- * Формирование стартового промпта с жестким требованием составить план работ
- * @param {string} goalText
- * @returns {string}
- */
-export function formatGoalStartPrompt(goalText) {
-  return `🎯 Активирован режим цели (Goal Mode): "${goalText}"\n\n` +
-    `СТРОГИЙ КОНТРАКТ АВТОНОМНОГО РЕЖИМА:\n` +
-    `1. ОБЯЗАТЕЛЬНЫЙ ШАГ №1: Твоим ПЕРВЫМ действием ДО выполнения любой другой работы или ответа должен быть вызов инструмента goal_set_milestones с массивом из 3-7 конкретных, последовательных пунктов плана работ. Пользователь видит этот план в интерфейсе в реальном времени.\n` +
-    `2. ШАГ №2: После установки плана переходи к выполнению шагов. Перед началом работы над каждым шагом отметь его статус как in_progress через goal_update_progress(milestone_id, "in_progress").\n` +
-    `3. ШАГ №3: После успешного завершения шага отметь его статус как completed через goal_update_progress(milestone_id, "completed", "краткие итоги шага").\n` +
-    `4. ШАГ №4: Когда все пункты плана выполнены, вызови инструмент goal_finish(summary) с подробным резюме достигнутых результатов.`;
-}
-
-/**
- * Форматирование текстового ответа для UI и постановка/управление задачей агента
- * @param {import('./goal-engine.js').GoalEngine} engine
- * @param {{ action: string, text?: string }} parsed
- * @param {Object} [config]
- * @param {Object} [agent]
- * @returns {{ kind: 'success' | 'error', text: string }}
- */
-export function executeGoalSlashCommand(engine, parsed, config = {}, agent = null, sessionId = 'default') {
-  const sid = sessionId || 'default';
-  const snap = engine.getSnapshot(sid);
-
-  switch (parsed.action) {
-    case 'show': {
-      if (!snap.hasActiveGoal) {
-        return {
-          kind: 'success',
-          text: `🎯 Режим цели (Goal Mode): цель не установлена.\n${USAGE}`,
-        };
-      }
-
-      const milestonesInfo = snap.milestones.length > 0
-        ? `\nПлан работ:\n` + snap.milestones.map((m, i) => `  ${i + 1}. [${m.status}] ${m.title}`).join('\n')
-        : '';
-
-      return {
-        kind: 'success',
-        text: `🎯 Цель: «${snap.title}»\n` +
-          `Статус: ${snap.state}\n` +
-          `Время: ${snap.formattedElapsed}\n` +
-          `Итераций: ${snap.iterationsCount}/${snap.maxIterations}` +
-          milestonesInfo +
-          `\n\nКоманды: /goal pause, /goal resume, /goal clear, /goal <новая цель>`,
-      };
-    }
-
-    case 'clear': {
-      if (!snap.hasActiveGoal) {
-        return {
-          kind: 'success',
-          text: 'Цель не была установлена.',
-        };
-      }
-      engine.clear(sid);
-      if (agent && typeof agent.cancel === 'function') {
-        try {
-          agent.cancel({ kind: 'user', reason: 'Goal cleared by user' });
-        } catch (err) {
-          console.warn('[dsh-goal] Failed to cancel agent on clear:', err);
-        }
-      }
-      return {
-        kind: 'success',
-        text: '🎯 Цель сброшена.',
-      };
-    }
-
-    case 'pause': {
-      if (!snap.hasActiveGoal) {
-        return {
-          kind: 'error',
-          text: `Нельзя приостановить: активная цель отсутствует.\n${USAGE}`,
-        };
-      }
-      if (snap.state === GoalState.PAUSED) {
-        return {
-          kind: 'success',
-          text: '⏸ Цель уже на паузе.',
-        };
-      }
-      engine.pause('Пауза по команде пользователя (/goal pause)', sid);
-      if (agent && typeof agent.cancel === 'function') {
-        try {
-          agent.cancel({ kind: 'user', reason: 'Goal paused by user' });
-        } catch (err) {
-          console.warn('[dsh-goal] Failed to cancel agent on pause:', err);
-        }
-      }
-      return {
-        kind: 'success',
-        text: `⏸ Цель приостановлена: «${snap.title}». Работа агента остановлена. Используйте /goal resume или кнопку ▶️ для продолжения.`,
-      };
-    }
-
-    case 'resume': {
-      if (!snap.hasActiveGoal) {
-        return {
-          kind: 'error',
-          text: `Нельзя возобновить: активная цель отсутствует.\n${USAGE}`,
-        };
-      }
-      if (snap.state === GoalState.RUNNING) {
-        return {
-          kind: 'success',
-          text: '▶️ Цель уже выполняется.',
-        };
-      }
-      engine.resume(sid);
-      if (agent && typeof agent.followup === 'function') {
-        try {
-          const resumePrompt = `▶️ Цель возобновлена пользователем. Продолжай выполнение плана работ с того места, где остановился. Отмечай шаги через goal_update_progress.`;
-          agent.followup(createGoalUserMessage(resumePrompt));
-        } catch (err) {
-          console.warn('[dsh-goal] Failed to followup agent on resume:', err);
-        }
-      }
-      return {
-        kind: 'success',
-        text: `▶️ Цель возобновлена: «${snap.title}». Агент продолжает работу.`,
-      };
-    }
-
-    case 'start': {
-      const maxIterations = config.maxIterations ?? snap.maxIterations ?? 25;
-      const newSnap = engine.startGoal(parsed.text, { maxIterations }, sid);
-
-      // Если команда вызвана в контексте агента, отправляем цель в очередь модели
-      if (agent && typeof agent.followup === 'function') {
-        try {
-          const userMsg = createGoalUserMessage(formatGoalStartPrompt(parsed.text));
-          agent.followup(userMsg);
-        } catch (err) {
-          console.warn('[dsh-goal] Failed to dispatch goal to agent followup:', err);
-        }
-      }
-
-      return {
-        kind: 'success',
-        text: `🎯 Активирована цель: «${newSnap.title}» (макс. ${newSnap.maxIterations} итераций).\n` +
-          `Для паузы: /goal pause | Для сброса: /goal clear`,
-      };
-    }
-
-    default:
-      return {
-        kind: 'error',
-        text: `Неизвестная команда. ${USAGE}`,
-      };
-  }
-}
+import { randomUUID } from 'node:crypto';
+import { GoalState } from './goal-engine.js';
+
+export const USAGE = 'Использование: /goal [<цель>|clear|pause|resume]';
+
+/**
+ * Парсинг строки ввода для команды /goal
+ * @param {string} rawInput
+ * @returns {{ action: string, text?: string }}
+ */
+export function parseGoalInput(rawInput = '') {
+  const input = String(rawInput || '').trim();
+  if (!input) {
+    return { action: 'show' };
+  }
+
+  const lower = input.toLowerCase();
+  if (lower === 'clear') return { action: 'clear' };
+  if (lower === 'pause') return { action: 'pause' };
+  if (lower === 'resume') return { action: 'resume' };
+
+  return { action: 'start', text: input };
+}
+
+/**
+ * Создание валидного identified сообщения пользователя для отправки агенту через followup
+ * @param {string} text
+ * @returns {Object}
+ */
+export function createGoalUserMessage(text) {
+  return {
+    id: randomUUID(),
+    role: 'user',
+    content: [{ type: 'text', text }],
+    source: { kind: 'user' },
+  };
+}
+
+/**
+ * Формирование стартового промпта с жестким требованием составить план работ
+ * @param {string} goalText
+ * @returns {string}
+ */
+export function formatGoalStartPrompt(goalText) {
+  return `🎯 Активирован режим цели (Goal Mode): "${goalText}"\n\n` +
+    `СТРОГИЙ КОНТРАКТ АВТОНОМНОГО РЕЖИМА:\n` +
+    `1. ОБЯЗАТЕЛЬНЫЙ ШАГ №1: Твоим ПЕРВЫМ действием ДО выполнения любой другой работы или ответа должен быть вызов инструмента goal_set_milestones с массивом из 3-7 конкретных, последовательных пунктов плана работ. Пользователь видит этот план в интерфейсе в реальном времени.\n` +
+    `2. ШАГ №2: После установки плана переходи к выполнению шагов. Перед началом работы над каждым шагом отметь его статус как in_progress через goal_update_progress(milestone_id, "in_progress").\n` +
+    `3. ШАГ №3: После успешного завершения шага отметь его статус как completed через goal_update_progress(milestone_id, "completed", "краткие итоги шага").\n` +
+    `4. ШАГ №4: Когда все пункты плана выполнены, вызови инструмент goal_finish(summary) с подробным резюме достигнутых результатов.`;
+}
+
+/**
+ * Форматирование текстового ответа для UI и постановка/управление задачей агента
+ * @param {import('./goal-engine.js').GoalEngine} engine
+ * @param {{ action: string, text?: string }} parsed
+ * @param {Object} [config]
+ * @param {Object} [agent]
+ * @param {string} [sessionId='default']
+ * @returns {{ kind: 'success' | 'error', text: string }}
+ */
+export function executeGoalSlashCommand(engine, parsed, config = {}, agent = null, sessionId = 'default') {
+  const sid = sessionId || 'default';
+  const snap = engine.getSnapshot(sid);
+
+  switch (parsed.action) {
+    case 'show': {
+      if (!snap.hasActiveGoal) {
+        return {
+          kind: 'success',
+          text: `🎯 Режим цели (Goal Mode): цель не установлена.\n${USAGE}`,
+        };
+      }
+
+      const milestonesInfo = snap.milestones.length > 0
+        ? `\nПлан работ:\n` + snap.milestones.map((m, i) => `  ${i + 1}. [${m.status}] ${m.title}`).join('\n')
+        : '';
+
+      return {
+        kind: 'success',
+        text: `🎯 Цель: «${snap.title}»\n` +
+          `Статус: ${snap.state}\n` +
+          `Время: ${snap.formattedElapsed}\n` +
+          `Итераций: ${snap.iterationsCount}/${snap.maxIterations}` +
+          milestonesInfo +
+          `\n\nКоманды: /goal pause, /goal resume, /goal clear, /goal <новая цель>`,
+      };
+    }
+
+    case 'clear': {
+      if (!snap.hasActiveGoal) {
+        return {
+          kind: 'success',
+          text: 'Цель не была установлена.',
+        };
+      }
+      engine.clear(sid);
+      if (agent && typeof agent.cancel === 'function') {
+        try {
+          agent.cancel({ kind: 'user', reason: 'Goal cleared by user' });
+        } catch (err) {
+          console.warn('[dsh-goal] Failed to cancel agent on clear:', err);
+        }
+      }
+      return {
+        kind: 'success',
+        text: '🎯 Цель сброшена.',
+      };
+    }
+
+    case 'pause': {
+      if (!snap.hasActiveGoal) {
+        return {
+          kind: 'error',
+          text: `Нельзя приостановить: активная цель отсутствует.\n${USAGE}`,
+        };
+      }
+      if (snap.state === GoalState.PAUSED) {
+        return {
+          kind: 'success',
+          text: '⏸ Цель уже на паузе.',
+        };
+      }
+      engine.pause('Пауза по команде пользователя (/goal pause)', sid);
+      if (agent && typeof agent.cancel === 'function') {
+        try {
+          agent.cancel({ kind: 'user', reason: 'Goal paused by user' });
+        } catch (err) {
+          console.warn('[dsh-goal] Failed to cancel agent on pause:', err);
+        }
+      }
+      return {
+        kind: 'success',
+        text: `⏸ Цель приостановлена: «${snap.title}». Работа агента остановлена. Используйте /goal resume или кнопку ▶️ для продолжения.`,
+      };
+    }
+
+    case 'resume': {
+      if (!snap.hasActiveGoal) {
+        return {
+          kind: 'error',
+          text: `Нельзя возобновить: активная цель отсутствует.\n${USAGE}`,
+        };
+      }
+      if (snap.state === GoalState.RUNNING) {
+        return {
+          kind: 'success',
+          text: '▶️ Цель уже выполняется.',
+        };
+      }
+      engine.resume(sid);
+      if (agent && typeof agent.followup === 'function') {
+        try {
+          const resumePrompt = `▶️ Цель возобновлена пользователем. Продолжай выполнение плана работ с того места, где остановился. Отмечай шаги через goal_update_progress.`;
+          agent.followup(createGoalUserMessage(resumePrompt));
+        } catch (err) {
+          console.warn('[dsh-goal] Failed to followup agent on resume:', err);
+        }
+      }
+      return {
+        kind: 'success',
+        text: `▶️ Цель возобновлена: «${snap.title}». Агент продолжает работу.`,
+      };
+    }
+
+    case 'start': {
+      const maxIterations = config.maxIterations ?? snap.maxIterations ?? 25;
+      const newSnap = engine.startGoal(parsed.text, { maxIterations }, sid);
+
+      // Если команда вызвана в контексте агента, отправляем цель в очередь модели
+      if (agent && typeof agent.followup === 'function') {
+        try {
+          const userMsg = createGoalUserMessage(formatGoalStartPrompt(parsed.text));
+          agent.followup(userMsg);
+        } catch (err) {
+          console.warn('[dsh-goal] Failed to dispatch goal to agent followup:', err);
+        }
+      }
+
+      return {
+        kind: 'success',
+        text: `🎯 Активирована цель: «${newSnap.title}» (макс. ${newSnap.maxIterations} итераций).\n` +
+          `Для паузы: /goal pause | Для сброса: /goal clear`,
+      };
+    }
+
+    default:
+      return {
+        kind: 'error',
+        text: `Неизвестная команда. ${USAGE}`,
+      };
+  }
+}

package/lib/goal-engine.js

@@ -51,6 +51,7 @@ export class GoalEngine {
     this.goals = new Map();
     this.listeners = new Set();
     this.saveTimer = null;
+    this.stallCounters = new Map(); // sessionId -> number of consecutive turns without progress
 
     const defaultStorageDir = process.env.DSH_HOME || path.join(os.homedir(), '.dsh');
     this.storagePath = options.storagePath ?? null;
@@ -77,15 +78,45 @@ export class GoalEngine {
         const raw = fs.readFileSync(this.storagePath, 'utf8');
         const data = JSON.parse(raw);
         if (data && typeof data === 'object') {
+          let dirty = false;
           if (data.sessions && typeof data.sessions === 'object') {
             for (const [sid, goal] of Object.entries(data.sessions)) {
               if (goal && goal.id && goal.title) {
+                // Item 4: Crash Hydration — если цель осталась в RUNNING после перезапуска/падения DSH,
+                // переводим в PAUSED с понятной причиной и фиксацией времени
+                if (goal.state === GoalState.RUNNING) {
+                  goal.state = GoalState.PAUSED;
+                  goal.pausedAt = Date.now();
+                  if (!Array.isArray(goal.logs)) goal.logs = [];
+                  goal.logs.push({
+                    timestamp: Date.now(),
+                    type: 'warning',
+                    message: 'Harness was restarted — click ▶️ to resume',
+                  });
+                  if (goal.logs.length > 100) goal.logs = goal.logs.slice(-100);
+                  dirty = true;
+                }
                 this.goals.set(sid, goal);
               }
             }
           } else if (data.id && data.title) {
+            if (data.state === GoalState.RUNNING) {
+              data.state = GoalState.PAUSED;
+              data.pausedAt = Date.now();
+              if (!Array.isArray(data.logs)) data.logs = [];
+              data.logs.push({
+                timestamp: Date.now(),
+                type: 'warning',
+                message: 'Harness was restarted — click ▶️ to resume',
+              });
+              if (data.logs.length > 100) data.logs = data.logs.slice(-100);
+              dirty = true;
+            }
             this.goals.set('default', data);
           }
+          if (dirty) {
+            this.scheduleSave(true);
+          }
         }
       }
     } catch (err) {
@@ -132,6 +163,10 @@ export class GoalEngine {
         sessions: sessionsObj,
         ...(this.goals.has('default') ? this.goals.get('default') : {}),
       };
+      const dir = path.dirname(this.storagePath);
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
       const tmp = `${this.storagePath}.tmp.${Date.now()}`;
       fs.writeFileSync(tmp, JSON.stringify(payload, null, 2), 'utf8');
       fs.renameSync(tmp, this.storagePath);
@@ -175,6 +210,27 @@ export class GoalEngine {
     }
   }
 
+  /**
+   * Отслеживание прогресса для Smart Progress Guard
+   */
+  recordProgress(sessionId = 'default') {
+    const sid = sessionId || 'default';
+    this.stallCounters.set(sid, 0);
+  }
+
+  incrementStallCount(sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const current = this.stallCounters.get(sid) || 0;
+    const next = current + 1;
+    this.stallCounters.set(sid, next);
+    return next;
+  }
+
+  getStallCount(sessionId = 'default') {
+    const sid = sessionId || 'default';
+    return this.stallCounters.get(sid) || 0;
+  }
+
   /**
    * Динамическое обновление настроек на лету
    * @param {Object} config
@@ -199,7 +255,7 @@ export class GoalEngine {
   }
 
   /**
-   * Запуск новой цели
+   * Получение цели сессии
    */
   getGoal(sessionId = 'default') {
     return this.goals.get(sessionId || 'default') || null;
@@ -217,11 +273,11 @@ export class GoalEngine {
         inactive.push({ sid, completedAt: goal.completedAt || goal.startedAt || 0 });
       }
     }
-    // Сортируем от самых старых к новым
     inactive.sort((a, b) => a.completedAt - b.completedAt);
     while (this.goals.size >= this.maxSessions && inactive.length > 0) {
       const oldest = inactive.shift();
       this.goals.delete(oldest.sid);
+      this.stallCounters.delete(oldest.sid);
     }
   }
 
@@ -241,6 +297,7 @@ export class GoalEngine {
     const cleanTitle = title.trim();
     const now = Date.now();
     const sid = sessionId || 'default';
+    this.stallCounters.set(sid, 0);
 
     const goal = {
       id: `goal-${now}-${Math.random().toString(36).substring(2, 7)}`,
@@ -318,6 +375,8 @@ export class GoalEngine {
     }
 
     goal.state = GoalState.RUNNING;
+    this.stallCounters.set(sid, 0); // сбрасываем счетчик простоя при возобновлении
+
     goal.logs.push({
       timestamp: now,
       type: 'info',
@@ -362,6 +421,7 @@ export class GoalEngine {
   clear(sessionId = 'default') {
     const sid = sessionId || 'default';
     this.goals.delete(sid);
+    this.stallCounters.delete(sid);
     this.emit(sid, true);
     return this.getSnapshot(sid);
   }
@@ -395,6 +455,7 @@ export class GoalEngine {
       }
     }
 
+    this.stallCounters.delete(sid);
     this.emit(sid, true);
     return this.getSnapshot(sid);
   }
@@ -420,6 +481,7 @@ export class GoalEngine {
       });
     }
 
+    this.recordProgress(sid);
     if (shouldEmit) this.emit(sid);
   }
 
@@ -451,6 +513,7 @@ export class GoalEngine {
       goal.logs = goal.logs.slice(-100);
     }
 
+    this.recordProgress(sid);
     this.emit(sid);
     return true;
   }