@goodandready/dsh-goal 0.1.1 → 0.1.3

package/lib/command-handler.js

@@ -0,0 +1,189 @@
+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 `🎯 Активирован режим цели: "${goalText}"\n\n` +
+    `ОБЯЗАТЕЛЬНЫЙ ПЕРВЫЙ ШАГ: Немедленно вызови инструмент goal_set_milestones и передай массив из 3-7 конкретных пунктов плана работ для достижения этой цели. Пользователь видит этот план в интерфейсе в реальном времени.\n` +
+    `После формирования плана последовательно выполняй каждый пункт. Перед выполнением шага обновляй его статус на in_progress через goal_update_progress, а по завершении — на completed.\n` +
+    `Когда все пункты выполнены, вызови инструмент goal_finish.`;
+}
+
+/**
+ * Форматирование текстового ответа для 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) {
+  const snap = engine.getSnapshot();
+
+  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();
+      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)');
+      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();
+      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 });
+
+      // Если команда вызвана в контексте агента, отправляем цель в очередь модели
+      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

@@ -1,3 +1,7 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+
 /**
  * Изолированное ядро управления состоянием цели (Goal Engine).
  * Не имеет внешних зависимостей, 100% тестируемо через node --test.
@@ -41,8 +45,45 @@ export function formatElapsed(totalSeconds) {
 export class GoalEngine {
   constructor(options = {}) {
     this.defaultMaxIterations = options.defaultMaxIterations ?? 25;
+    this.autoDrive = options.autoDrive ?? true;
+    this.enableSound = options.enableSound ?? true;
     this.currentGoal = null;
     this.listeners = new Set();
+
+    const defaultStorageDir = process.env.DSH_HOME || path.join(os.homedir(), '.dsh');
+    this.storagePath = options.storagePath ?? null;
+
+    this.loadStateFromDisk();
+  }
+
+  loadStateFromDisk() {
+    if (!this.storagePath) return;
+    try {
+      if (fs.existsSync(this.storagePath)) {
+        const raw = fs.readFileSync(this.storagePath, 'utf8');
+        const data = JSON.parse(raw);
+        if (data && typeof data === 'object' && data.id && data.title) {
+          this.currentGoal = data;
+        }
+      }
+    } catch (err) {
+      console.warn('[GoalEngine] Failed to load state from disk:', err);
+    }
+  }
+
+  saveStateToDisk() {
+    if (!this.storagePath) return;
+    try {
+      if (this.currentGoal) {
+        fs.writeFileSync(this.storagePath, JSON.stringify(this.currentGoal, null, 2), 'utf8');
+      } else {
+        if (fs.existsSync(this.storagePath)) {
+          fs.unlinkSync(this.storagePath);
+        }
+      }
+    } catch (err) {
+      console.warn('[GoalEngine] Failed to save state to disk:', err);
+    }
   }
 
   /**
@@ -56,6 +97,7 @@ export class GoalEngine {
   }
 
   emit() {
+    this.saveStateToDisk();
     const snapshot = this.getSnapshot();
     for (const listener of this.listeners) {
       try {
@@ -66,6 +108,27 @@ export class GoalEngine {
     }
   }
 
+  /**
+   * Динамическое обновление настроек на лету
+   * @param {Object} config
+   */
+  updateConfig(config = {}) {
+    if (typeof config.defaultMaxIterations === 'number' && config.defaultMaxIterations >= 1) {
+      const prev = this.defaultMaxIterations;
+      this.defaultMaxIterations = config.defaultMaxIterations;
+      if (this.currentGoal && this.currentGoal.maxIterations === prev) {
+        this.currentGoal.maxIterations = config.defaultMaxIterations;
+      }
+    }
+    if (typeof config.autoDrive === 'boolean') {
+      this.autoDrive = config.autoDrive;
+    }
+    if (typeof config.enableSound === 'boolean') {
+      this.enableSound = config.enableSound;
+    }
+    this.emit();
+  }
+
   /**
    * Запуск новой цели
    */
@@ -299,12 +362,18 @@ export class GoalEngine {
         hasActiveGoal: false,
         state: GoalState.IDLE,
         title: '',
+        startedAt: null,
+        pausedAt: null,
+        totalPausedDurationMs: 0,
+        completedAt: null,
         elapsedSeconds: 0,
         formattedElapsed: '0s',
         milestones: [],
         progressPercent: 0,
         iterationsCount: 0,
         maxIterations: this.defaultMaxIterations,
+        autoDrive: this.autoDrive,
+        enableSound: this.enableSound,
       };
     }
 
@@ -319,6 +388,10 @@ export class GoalEngine {
       state: this.currentGoal.state,
       title: this.currentGoal.title,
       description: this.currentGoal.description,
+      startedAt: this.currentGoal.startedAt,
+      pausedAt: this.currentGoal.pausedAt,
+      totalPausedDurationMs: this.currentGoal.totalPausedDurationMs,
+      completedAt: this.currentGoal.completedAt,
       elapsedSeconds: elapsed,
       formattedElapsed: formatElapsed(elapsed),
       iterationsCount: this.currentGoal.iterationsCount,
@@ -327,6 +400,8 @@ export class GoalEngine {
       progressPercent,
       logs: this.currentGoal.logs,
       resultSummary: this.currentGoal.resultSummary,
+      autoDrive: this.autoDrive,
+      enableSound: this.enableSound,
     };
   }
 
@@ -339,15 +414,20 @@ export class GoalEngine {
     }
 
     const snapshot = this.getSnapshot();
-    const milestonesText = snapshot.milestones.length > 0
+    const hasMilestones = snapshot.milestones.length > 0;
+    const milestonesText = hasMilestones
       ? snapshot.milestones.map((m, i) => `  ${i + 1}. [${m.status.toUpperCase()}] ${m.title}${m.notes ? ` (${m.notes})` : ''}`).join('\n')
-      : '  (No specific milestones decomposed yet; use goal_set_milestones to break down)';
+      : '  (План работ ещё не сформирован — немедленно вызови goal_set_milestones со списком шагов!)';
 
     return `\n\n[DSH GOAL MODE ACTIVE]
-Current Target Goal: "${snapshot.title}"
-Elapsed Time: ${snapshot.formattedElapsed} | Turn Iteration: ${snapshot.iterationsCount}/${snapshot.maxIterations}
-Milestones Progress (${snapshot.progressPercent}%):
+Цель: "${snapshot.title}"
+Время работы: ${snapshot.formattedElapsed} | Итерация: ${snapshot.iterationsCount}/${snapshot.maxIterations}
+План работ:
 ${milestonesText}
-Instructions: Keep focused strictly on achieving this goal. When sub-tasks finish, update milestones via goal_update_progress. When the target is completely accomplished, call goal_finish.`;
+
+Инструкции Goal Mode:
+1. ${hasMilestones ? 'Выполняй текущий активный пункт плана работ.' : 'ТВОЙ ПЕРВЫЙ ШАГ: Немедленно вызови инструмент goal_set_milestones со списком пунктов плана работ.'}
+2. По мере выполнения каждого шага отмечай его статус через инструмент goal_update_progress (status: "in_progress" перед началом, "completed" по завершении).
+3. Когда все пункты плана будут выполнены, вызови инструмент goal_finish с итоговым резюме.`;
   }
 }