@goodandready/dsh-goal 0.2.2 → 0.2.4

package/lib/goal-engine.js

@@ -1,2018 +1,579 @@
-import fs from 'node:fs';
-
-import path from 'node:path';
-
-import os from 'node:os';
-
-import { execSync } from 'node:child_process';
-
-
-
-/**
-
- * Изолированное ядро управления состоянием цели (Goal Engine).
-
- * Не имеет внешних зависимостей, 100% тестируемо через node --test.
-
- */
-
-
-
-export const GoalState = {
-
-  IDLE: 'IDLE',
-
-  PLANNING: 'PLANNING',
-
-  RUNNING: 'RUNNING',
-
-  PAUSED: 'PAUSED',
-
-  COMPLETED: 'COMPLETED',
-
-  FAILED: 'FAILED',
-
-  CANCELLED: 'CANCELLED',
-
-};
-
-
-
-export const MilestoneStatus = {
-
-  PENDING: 'pending',
-
-  IN_PROGRESS: 'in_progress',
-
-  COMPLETED: 'completed',
-
-  FAILED: 'failed',
-
-};
-
-
-
-/**
-
- * Форматирование времени в лаконичную строку (например: "2s", "45s", "1m 15s", "2h 5m")
-
- * @param {number} totalSeconds
-
- * @returns {string}
-
- */
-
-export function formatElapsed(totalSeconds) {
-
-  const sec = Math.max(0, Math.floor(totalSeconds));
-
-  if (sec < 60) return `${sec}s`;
-
-  const mins = Math.floor(sec / 60);
-
-  const remainingSec = sec % 60;
-
-  if (mins < 60) {
-
-    return remainingSec > 0 ? `${mins}m ${remainingSec}s` : `${mins}m`;
-
-  }
-
-  const hours = Math.floor(mins / 60);
-
-  const remainingMins = mins % 60;
-
-  return remainingMins > 0 ? `${hours}h ${remainingMins}m` : `${hours}h`;
-
-}
-
-
-
-/**
-
- * Форматирование расчетного оставшегося времени (ETA)
-
- * @param {number|null} seconds
-
- * @returns {string|null}
-
- */
-
-export function formatETA(seconds) {
-
-  if (seconds == null || isNaN(seconds)) return null;
-
-  const sec = Math.max(0, Math.floor(seconds));
-
-  if (sec < 60) return `~${sec}s`;
-
-  const mins = Math.round(sec / 60);
-
-  if (mins < 60) return `~${mins}m`;
-
-  const hours = Math.floor(mins / 60);
-
-  const remainingMins = mins % 60;
-
-  return remainingMins > 0 ? `~${hours}h ${remainingMins}m` : `~${hours}h`;
-
-}
-
-
-
-/**
-
- * Автоматическое определение языка текста (кириллица -> ru, иероглифы -> zh, иначе en)
-
- * @param {string} text
-
- * @param {string} [fallback='en']
-
- * @returns {'ru' | 'en' | 'zh'}
-
- */
-
-export function detectLanguage(text, fallback = 'en') {
-
-  if (!text || typeof text !== 'string') return fallback;
-
-  if (/[а-яёА-ЯЁ]/i.test(text)) {
-
-    return 'ru';
-
-  }
-
-  if (/[\u4e00-\u9fa5]/.test(text)) {
-
-    return 'zh';
-
-  }
-
-  return 'en';
-
-}
-
-
-
-
-
-/**
-
- * Безопасное получение текущего короткого Git commit hash
-
- * @returns {string|null}
-
- */
-
-export function getGitCurrentCommit() {
-
-  try {
-
-    return execSync('git rev-parse --short HEAD', {
-
-      encoding: 'utf8',
-
-      stdio: ['ignore', 'pipe', 'ignore'],
-
-      timeout: 1000,
-
-    }).trim();
-
-  } catch (_) {
-
-    return null;
-
-  }
-
-}
-
-
-
-/**
-
- * Генератор Markdown-отчета о результатах цели
-
- * @param {Object} state
-
- * @returns {string}
-
- */
-
-export function exportReportMarkdown(state) {
-
-  if (!state) return '';
-
-  const title = state.title || 'Goal Report';
-
-  const status = state.state === 'COMPLETED' ? 'COMPLETED' : state.state;
-
-  const elapsed = state.formattedElapsed || '0s';
-
-  const iter = `${state.iterationsCount || 0}/${state.maxIterations || 25}`;
-
-  const totalTokens = state.tokensUsage?.totalTokens || 0;
-
-  const promptTokens = state.tokensUsage?.promptTokens || 0;
-
-  const compTokens = state.tokensUsage?.completionTokens || 0;
-
-  const gitCommit = state.gitStartCommit ? ` | **Git Start:** \`${state.gitStartCommit}\`` : '';
-
-
-
-  let md = `# 🎯 Goal Report: ${title}\n\n`;
-
-  md += `**Status:** \`${status}\` | **Duration:** \`${elapsed}\` | **Iterations:** \`${iter}\`${gitCommit}\n`;
-
-  if (totalTokens > 0) {
-
-    md += `**Tokens:** \`${totalTokens.toLocaleString('en-US')}\` (Prompt: \`${promptTokens.toLocaleString('en-US')}\`, Completion: \`${compTokens.toLocaleString('en-US')}\`)\n`;
-
-  }
-
-  md += '\n';
-
-
-
-  if (state.description) {
-
-    md += `### Description\n${state.description}\n\n`;
-
-  }
-
-
-
-  if (state.resultSummary) {
-
-    md += `### Summary & Deliverables\n${state.resultSummary}\n\n`;
-
-  }
-
-
-
-  const milestones = state.milestones || [];
-
-  if (milestones.length > 0) {
-
-    md += `### Milestones\n| # | Status | Title | Notes |\n|---|---|---|---|\n`;
-
-    milestones.forEach((m, idx) => {
-
-      const mark = m.status === 'completed' ? '✅ Done' : m.status === 'in_progress' ? '🔄 In Progress' : '⏳ Pending';
-
-      const cleanTitle = (m.title || '').replace(/\|/g, '\\|');
-
-      const cleanNotes = (m.notes || '').replace(/\|/g, '\\|');
-
-      md += `| ${idx + 1} | ${mark} | ${cleanTitle} | ${cleanNotes || '—'} |\n`;
-
-    });
-
-    md += '\n';
-
-  }
-
-
-
-  md += `*Generated by DSH Goal Engine at ${new Date().toISOString()}*\n`;
-
-  return md;
-
-}
-
-
-
-/**
-
- * Генератор отчета в формате GitHub / Gitea PR Comment со спойлерами
-
- * @param {Object} state
-
- * @returns {string}
-
- */
-
-export function exportReportGitHubPR(state) {
-
-  if (!state) return '';
-
-  const title = state.title || 'Goal Report';
-
-  const status = state.state === 'COMPLETED' ? 'COMPLETED' : state.state;
-
-  const elapsed = state.formattedElapsed || '0s';
-
-  const iter = `${state.iterationsCount || 0}/${state.maxIterations || 25}`;
-
-  const totalTokens = state.tokensUsage?.totalTokens || 0;
-
-  const promptTokens = state.tokensUsage?.promptTokens || 0;
-
-  const compTokens = state.tokensUsage?.completionTokens || 0;
-
-  const gitCommit = state.gitStartCommit ? ` &nbsp;|&nbsp; **Git Start:** \`${state.gitStartCommit}\` 📌` : '';
-
-
-
-  let md = `## 🎯 Autonomous Goal Resolution: ${title}\n\n`;
-
-  md += `> **Status:** \`${status}\` 🚀 &nbsp;|&nbsp; **Duration:** \`${elapsed}\` ⏱️ &nbsp;|&nbsp; **Iterations:** \`${iter}\` 🔄${gitCommit}\n\n`;
-
-
-
-  if (totalTokens > 0) {
-
-    md += `### 📊 Telemetry & Token Usage\n`;
-
-    md += `- **Total Tokens:** \`${totalTokens.toLocaleString('en-US')}\` (Prompt: \`${promptTokens.toLocaleString('en-US')}\`, Completion: \`${compTokens.toLocaleString('en-US')}\`)\n\n`;
-
-  }
-
-
-
-  if (state.resultSummary) {
-
-    md += `### 📦 Deliverables & Achievements\n${state.resultSummary}\n\n`;
-
-  } else if (state.description) {
-
-    md += `### 📝 Objective\n${state.description}\n\n`;
-
-  }
-
-
-
-  const milestones = state.milestones || [];
-
-  if (milestones.length > 0) {
-
-    const completedCount = milestones.filter(m => m.status === 'completed').length;
-
-    md += `<details>\n<summary><b>📋 Milestones Breakdown (${completedCount}/${milestones.length} Completed)</b></summary>\n\n`;
-
-    md += `| # | Status | Milestone | Notes |\n|---|---|---|---|\n`;
-
-    milestones.forEach((m, idx) => {
-
-      const mark = m.status === 'completed' ? '✅ Done' : m.status === 'in_progress' ? '🔄 In Progress' : '⏳ Pending';
-
-      const cleanTitle = (m.title || '').replace(/\|/g, '\\|');
-
-      const cleanNotes = (m.notes || '').replace(/\|/g, '\\|');
-
-      md += `| ${idx + 1} | ${mark} | ${cleanTitle} | ${cleanNotes || '—'} |\n`;
-
-    });
-
-    md += `\n</details>\n\n`;
-
-  }
-
-
-
-  md += `*Automated by [@goodandready/dsh-goal](https://github.com/GooDAnDReaDY/dsh-goal)*\n`;
-
-  return md;
-
-}
-
-
-
-export class GoalEngine {
-
-  constructor(options = {}) {
-
-    this.defaultMaxIterations = options.defaultMaxIterations ?? 25;
-
-    this.autoDrive = options.autoDrive ?? true;
-
-    this.enableSound = options.enableSound ?? true;
-
-    this.showQuickLaunchButton = options.showQuickLaunchButton ?? true;
-
-    this.consecutiveToolFailureLimit = options.consecutiveToolFailureLimit ?? 3;
-
-    this.maxSessions = options.maxSessions ?? 100;
-
-    this.goals = new Map();
-
-    this.listeners = new Set();
-
-    this.saveTimer = null;
-
-    this.stallCounters = new Map(); // sessionId -> number of consecutive turns without progress
-
-    this.toolFailureCounters = new Map(); // sessionId -> number of consecutive turns with tool errors
-
-
-
-    const defaultStorageDir = process.env.DSH_HOME || path.join(os.homedir(), '.dsh');
-
-    this.storagePath = options.storagePath ?? null;
-
-
-
-    this.loadStateFromDisk();
-
-  }
-
-
-
-  get currentGoal() {
-
-    return this.goals.get('default') || null;
-
-  }
-
-
-
-  set currentGoal(val) {
-
-    if (val) {
-
-      this.goals.set('default', val);
-
-    } else {
-
-      this.goals.delete('default');
-
-    }
-
-  }
-
-
-
-  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') {
-
-          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;
-
-                }
-
-                if (!goal.tokensUsage) {
-
-                  goal.tokensUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
-
-                }
-
-                if (!goal.lang) {
-
-                  goal.lang = detectLanguage(goal.title);
-
-                }
-
-                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;
-
-            }
-
-            if (!data.tokensUsage) {
-
-              data.tokensUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
-
-            }
-
-            if (!data.lang) {
-
-              data.lang = detectLanguage(data.title);
-
-            }
-
-            this.goals.set('default', data);
-
-          }
-
-          if (dirty) {
-
-            this.scheduleSave(true);
-
-          }
-
-        }
-
-      }
-
-    } catch (err) {
-
-      console.warn('[GoalEngine] Failed to load state from disk:', err);
-
-    }
-
-  }
-
-
-
-  scheduleSave(immediate = false) {
-
-    if (!this.storagePath) return;
-
-    if (immediate) {
-
-      if (this.saveTimer) {
-
-        clearTimeout(this.saveTimer);
-
-        this.saveTimer = null;
-
-      }
-
-      this.writeStateToDiskSync();
-
-      return;
-
-    }
-
-    if (!this.saveTimer) {
-
-      this.saveTimer = setTimeout(() => {
-
-        this.saveTimer = null;
-
-        this.writeStateToDiskSync();
-
-      }, 250);
-
-      if (typeof this.saveTimer.unref === 'function') {
-
-        this.saveTimer.unref();
-
-      }
-
-    }
-
-  }
-
-
-
-  writeStateToDiskSync() {
-
-    if (!this.storagePath) return;
-
-    try {
-
-      if (this.goals.size === 0) {
-
-        if (fs.existsSync(this.storagePath)) {
-
-          fs.unlinkSync(this.storagePath);
-
-        }
-
-        return;
-
-      }
-
-      const sessionsObj = {};
-
-      for (const [sid, goal] of this.goals.entries()) {
-
-        sessionsObj[sid] = goal;
-
-      }
-
-      const payload = {
-
-        version: 2,
-
-        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);
-
-    } catch (err) {
-
-      console.warn('[GoalEngine] Failed to write state to disk:', err);
-
-    }
-
-  }
-
-
-
-  flushSync() {
-
-    if (this.saveTimer) {
-
-      clearTimeout(this.saveTimer);
-
-      this.saveTimer = null;
-
-    }
-
-    this.writeStateToDiskSync();
-
-  }
-
-
-
-  saveStateToDisk() {
-
-    this.flushSync();
-
-  }
-
-
-
-  /**
-
-   * Подписка на изменение состояния
-
-   * @param {Function} callback
-
-   * @returns {Function} unsubscribe
-
-   */
-
-  subscribe(callback) {
-
-    this.listeners.add(callback);
-
-    return () => this.listeners.delete(callback);
-
-  }
-
-
-
-  emit(sessionId = 'default', immediate = false) {
-
-    this.scheduleSave(immediate);
-
-    const sid = sessionId || 'default';
-
-    const snapshot = this.getSnapshot(sid);
-
-    for (const listener of this.listeners) {
-
-      try {
-
-        listener(snapshot, sid);
-
-      } catch (err) {
-
-        console.error('[GoalEngine] Listener error:', err);
-
-      }
-
-    }
-
-  }
-
-
-
-  /**
-
-   * Отслеживание прогресса для 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
-
-   */
-
-  updateConfig(config = {}) {
-
-    if (typeof config.defaultMaxIterations === 'number' && config.defaultMaxIterations >= 1) {
-
-      const prev = this.defaultMaxIterations;
-
-      this.defaultMaxIterations = config.defaultMaxIterations;
-
-      for (const [_, goal] of this.goals) {
-
-        if (goal && goal.maxIterations === prev) {
-
-          goal.maxIterations = config.defaultMaxIterations;
-
-        }
-
-      }
-
-    }
-
-    if (typeof config.autoDrive === 'boolean') {
-
-      this.autoDrive = config.autoDrive;
-
-    }
-
-    if (typeof config.enableSound === 'boolean') {
-
-      this.enableSound = config.enableSound;
-
-    }
-
-    if (typeof config.showQuickLaunchButton === 'boolean') {
-
-      this.showQuickLaunchButton = config.showQuickLaunchButton;
-
-    }
-
-    if (typeof config.consecutiveToolFailureLimit === 'number') {
-
-      this.consecutiveToolFailureLimit = Math.max(0, config.consecutiveToolFailureLimit);
-
-    }
-
-    this.emit();
-
-  }
-
-
-
-  /**
-
-   * Получение цели сессии
-
-   */
-
-  getGoal(sessionId = 'default') {
-
-    return this.goals.get(sessionId || 'default') || null;
-
-  }
-
-
-
-  /**
-
-   * Очистка старых неактивных сессий во избежание утечек памяти
-
-   */
-
-
-
-  /**
-
-   * Управление счетчиком повторяющихся ошибок инструментов
-
-   */
-
-  incrementToolFailureCount(sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    const current = this.toolFailureCounters.get(sid) || 0;
-
-    const next = current + 1;
-
-    this.toolFailureCounters.set(sid, next);
-
-    return next;
-
-  }
-
-
-
-  resetToolFailureCount(sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    this.toolFailureCounters.set(sid, 0);
-
-  }
-
-
-
-  getToolFailureCount(sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    return this.toolFailureCounters.get(sid) || 0;
-
-  }
-
-
-
-  /**
-
-   * Живая корректировка цели / добавление уточнений (Live Steering / Nudge)
-
-   * @param {string} text
-
-   * @param {string} [sessionId='default']
-
-   */
-
-  nudge(text, sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    const goal = this.goals.get(sid);
-
-    if (!goal) return this.getSnapshot(sid);
-
-
-
-    const clean = String(text || '').trim();
-
-    if (!clean) return this.getSnapshot(sid);
-
-
-
-    if (!Array.isArray(goal.nudges)) {
-
-      goal.nudges = [];
-
-    }
-
-    const now = Date.now();
-
-    goal.nudges.push({ text: clean, timestamp: now });
-
-    goal.pendingNudge = clean;
-
-    goal.logs.push({
-
-      timestamp: now,
-
-      type: 'info',
-
-      message: `User steering / clarification: "${clean}"`,
-
-    });
-
-    if (goal.logs.length > 100) {
-
-      goal.logs = goal.logs.slice(-100);
-
-    }
-
-
-
-    this.emit(sid, true);
-
-    return this.getSnapshot(sid);
-
-  }
-
-
-
-  consumePendingNudge(sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    const goal = this.goals.get(sid);
-
-    if (!goal || !goal.pendingNudge) return null;
-
-    const nudge = goal.pendingNudge;
-
-    goal.pendingNudge = null;
-
-    this.emit(sid);
-
-    return nudge;
-
-  }
-
-
-
-  pruneInactiveSessions() {
-
-    if (this.goals.size < this.maxSessions) return;
-
-    const inactive = [];
-
-    for (const [sid, goal] of this.goals.entries()) {
-
-      if (sid === 'default') continue;
-
-      if (goal.state === GoalState.COMPLETED || goal.state === GoalState.CANCELLED || goal.state === GoalState.FAILED) {
-
-        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);
-
-    }
-
-  }
-
-
-
-  /**
-
-   * Запуск новой цели
-
-   * @param {string} title
-
-   * @param {Object} options
-
-   * @param {string} [sessionId='default']
-
-   */
-
-  startGoal(title, options = {}, sessionId = 'default') {
-
-    if (!title || typeof title !== 'string' || !title.trim()) {
-
-      throw new Error('Goal title cannot be empty');
-
-    }
-
-
-
-    this.pruneInactiveSessions();
-
-
-
-    const cleanTitle = title.trim();
-
-    const now = Date.now();
-
-    const sid = sessionId || 'default';
-
-    this.stallCounters.set(sid, 0);
-
-
-
-    const gitCommit = options.gitStartCommit !== undefined
-
-      ? options.gitStartCommit
-
-      : getGitCurrentCommit();
-
-
-
-    this.toolFailureCounters.set(sid, 0);
-
-
-
-    const goal = {
-
-      id: `goal-${now}-${Math.random().toString(36).substring(2, 7)}`,
-
-      sessionId: sid,
-
-      title: cleanTitle,
-
-      description: options.description?.trim() || '',
-
-      lang: options.lang || detectLanguage(cleanTitle),
-
-      state: GoalState.RUNNING,
-
-      startedAt: now,
-
-      pausedAt: null,
-
-      totalPausedDurationMs: 0,
-
-      completedAt: null,
-
-      iterationsCount: 0,
-
-      maxIterations: options.maxIterations ?? this.defaultMaxIterations,
-
-      gitStartCommit: gitCommit || null,
-
-      pendingNudge: null,
-
-      nudges: [],
-
-      milestones: [],
-
-      tokensUsage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
-
-      logs: [
-
-        {
-
-          timestamp: now,
-
-          type: 'info',
-
-          message: `Goal initiated: "${cleanTitle}"` + (gitCommit ? ` (Git: ${gitCommit})` : ''),
-
-        },
-
-      ],
-
-      resultSummary: '',
-
-    };
-
-
-
-    this.goals.set(sid, goal);
-
-
-
-    if (Array.isArray(options.milestones) && options.milestones.length > 0) {
-
-      this.addMilestones(options.milestones, false, sid);
-
-    }
-
-
-
-    this.emit(sid, true);
-
-    return this.getSnapshot(sid);
-
-  }
-
-
-
-  /**
-
-   * Приостановка автономного цикла цели
-
-   */
-
-  pause(reason = 'User requested pause', sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    const goal = this.goals.get(sid);
-
-    if (!goal || goal.state !== GoalState.RUNNING) {
-
-      return this.getSnapshot(sid);
-
-    }
-
-
-
-    goal.state = GoalState.PAUSED;
-
-    goal.pausedAt = Date.now();
-
-    goal.logs.push({
-
-      timestamp: Date.now(),
-
-      type: 'warning',
-
-      message: `Paused: ${reason}`,
-
-    });
-
-
-
-    if (goal.logs.length > 100) {
-
-      goal.logs = goal.logs.slice(-100);
-
-    }
-
-
-
-    this.emit(sid, true);
-
-    return this.getSnapshot(sid);
-
-  }
-
-
-
-  /**
-
-   * Возобновление выполнения цели
-
-   */
-
-  resume(sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    const goal = this.goals.get(sid);
-
-    if (!goal || goal.state !== GoalState.PAUSED) {
-
-      return this.getSnapshot(sid);
-
-    }
-
-
-
-    const now = Date.now();
-
-    if (goal.pausedAt) {
-
-      goal.totalPausedDurationMs += now - goal.pausedAt;
-
-      goal.pausedAt = null;
-
-    }
-
-
-
-    goal.state = GoalState.RUNNING;
-
-    this.stallCounters.set(sid, 0); // сбрасываем счетчик простоя при возобновлении
-
-
-
-    goal.logs.push({
-
-      timestamp: now,
-
-      type: 'info',
-
-      message: 'Goal resumed',
-
-    });
-
-
-
-    if (goal.logs.length > 100) {
-
-      goal.logs = goal.logs.slice(-100);
-
-    }
-
-
-
-    this.emit(sid, true);
-
-    return this.getSnapshot(sid);
-
-  }
-
-
-
-  /**
-
-   * Отмена цели
-
-   */
-
-  cancel(reason = 'Cancelled by user', sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    const goal = this.goals.get(sid);
-
-    if (!goal) return null;
-
-
-
-    goal.state = GoalState.CANCELLED;
-
-    goal.completedAt = Date.now();
-
-    goal.logs.push({
-
-      timestamp: Date.now(),
-
-      type: 'warning',
-
-      message: `Cancelled: ${reason}`,
-
-    });
-
-
-
-    if (goal.logs.length > 100) {
-
-      goal.logs = goal.logs.slice(-100);
-
-    }
-
-
-
-    this.emit(sid, true);
-
-    return this.getSnapshot(sid);
-
-  }
-
-
-
-  /**
-
-   * Очистка / сброс цели в IDLE
-
-   */
-
-  clear(sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    this.goals.delete(sid);
-
-    this.stallCounters.delete(sid);
-
-    this.emit(sid, true);
-
-    return this.getSnapshot(sid);
-
-  }
-
-
-
-  /**
-
-   * Успешное завершение цели
-
-   */
-
-  completeGoal(summary = '', sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    const goal = this.goals.get(sid);
-
-    if (!goal) return null;
-
-
-
-    const now = Date.now();
-
-    goal.state = GoalState.COMPLETED;
-
-    goal.completedAt = now;
-
-    goal.resultSummary = summary;
-
-    goal.logs.push({
-
-      timestamp: now,
-
-      type: 'info',
-
-      message: `Goal completed successfully: ${summary || 'All objectives met.'}`,
-
-    });
-
-
-
-    if (goal.logs.length > 100) {
-
-      goal.logs = goal.logs.slice(-100);
-
-    }
-
-
-
-    // Завершаем все активные milestones
-
-    for (const m of goal.milestones) {
-
-      if (m.status === MilestoneStatus.IN_PROGRESS || m.status === MilestoneStatus.PENDING) {
-
-        m.status = MilestoneStatus.COMPLETED;
-
-      }
-
-    }
-
-
-
-    this.stallCounters.delete(sid);
-
-    this.emit(sid, true);
-
-    return this.getSnapshot(sid);
-
-  }
-
-
-
-  /**
-
-   * Добавление вех (milestones)
-
-   */
-
-  addMilestones(milestonesList, shouldEmit = true, sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    const goal = this.goals.get(sid);
-
-    if (!goal || !Array.isArray(milestonesList)) return;
-
-
-
-    for (const item of milestonesList) {
-
-      const itemTitle = typeof item === 'string' ? item : item.title;
-
-      if (!itemTitle || !itemTitle.trim()) continue;
-
-
-
-      const mId = (typeof item === 'object' && item.id) ? item.id : `m-${goal.milestones.length + 1}`;
-
-      goal.milestones.push({
-
-        id: String(mId),
-
-        title: itemTitle.trim(),
-
-        status: (typeof item === 'object' && item.status) ? item.status : MilestoneStatus.PENDING,
-
-        notes: (typeof item === 'object' && item.notes) ? item.notes : '',
-
-      });
-
-    }
-
-
-
-    this.recordProgress(sid);
-
-    if (shouldEmit) this.emit(sid);
-
-  }
-
-
-
-  /**
-
-   * Обновление конкретной вехи
-
-   */
-
-  updateMilestone(id, status, notes = '', sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    const goal = this.goals.get(sid);
-
-    if (!goal) return false;
-
-
-
-    const target = goal.milestones.find((m) => m.id === String(id));
-
-    if (!target) return false;
-
-
-
-    if (status && Object.values(MilestoneStatus).includes(status)) {
-
-      target.status = status;
-
-    }
-
-    if (notes) {
-
-      target.notes = String(notes);
-
-    }
-
-
-
-    goal.logs.push({
-
-      timestamp: Date.now(),
-
-      type: 'milestone',
-
-      message: `Milestone [${target.title}] status -> ${target.status}`,
-
-    });
-
-
-
-    if (goal.logs.length > 100) {
-
-      goal.logs = goal.logs.slice(-100);
-
-    }
-
-
-
-    this.recordProgress(sid);
-
-    this.emit(sid);
-
-    return true;
-
-  }
-
-
-
-  /**
-
-   * Увеличение счётчика итераций turn
-
-   */
-
-  incrementIteration(sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    const goal = this.goals.get(sid);
-
-    if (!goal || goal.state !== GoalState.RUNNING) {
-
-      return false;
-
-    }
-
-
-
-    goal.iterationsCount += 1;
-
-
-
-    if (goal.iterationsCount >= goal.maxIterations) {
-
-      goal.state = GoalState.FAILED;
-
-      goal.logs.push({
-
-        timestamp: Date.now(),
-
-        type: 'error',
-
-        message: `Safety limit reached: maximum ${goal.maxIterations} iterations exceeded.`,
-
-      });
-
-      if (goal.logs.length > 100) {
-
-        goal.logs = goal.logs.slice(-100);
-
-      }
-
-      this.emit(sid, true);
-
-      return false;
-
-    }
-
-
-
-    this.emit(sid);
-
-    return true;
-
-  }
-
-
-
-  /**
-
-   * Подсчёт времени в секундах
-
-   */
-
-  getElapsedSeconds(sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    const goal = this.goals.get(sid);
-
-    if (!goal) return 0;
-
-    const { startedAt, pausedAt, totalPausedDurationMs, completedAt } = goal;
-
-    const endTime = completedAt || (pausedAt || Date.now());
-
-    const elapsedMs = Math.max(0, endTime - startedAt - totalPausedDurationMs);
-
-    return Math.floor(elapsedMs / 1000);
-
-  }
-
-
-
-  /**
-
-   * Накопление статистики использования токенов сессии
-
-   * @param {Object} usage
-
-   * @param {string} [sessionId='default']
-
-   */
-
-  addTokenUsage(usage, sessionId = 'default') {
-
-    if (!usage || typeof usage !== 'object') return;
-
-    const sid = sessionId || 'default';
-
-    const goal = this.goals.get(sid);
-
-    if (!goal) return;
-
-
-
-    if (!goal.tokensUsage) {
-
-      goal.tokensUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
-
-    }
-
-
-
-    const prompt = Number(usage.promptTokens ?? usage.input_tokens ?? usage.prompt_tokens ?? 0) || 0;
-
-    const completion = Number(usage.completionTokens ?? usage.output_tokens ?? usage.completion_tokens ?? 0) || 0;
-
-    const total = Number(usage.totalTokens ?? usage.total_tokens ?? (prompt + completion)) || (prompt + completion);
-
-
-
-    goal.tokensUsage.promptTokens += prompt;
-
-    goal.tokensUsage.completionTokens += completion;
-
-    goal.tokensUsage.totalTokens += total;
-
-
-
-    this.emit(sid);
-
-  }
-
-
-
-  /**
-
-   * Интеллектуальный расчет прогноза оставшегося времени (ETA)
-
-   * на основе средней скорости выполнения завершенных вех
-
-   * @param {string} [sessionId='default']
-
-   * @returns {number|null}
-
-   */
-
-  getEstimatedRemainingSeconds(sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    const goal = this.goals.get(sid);
-
-    if (!goal || goal.state !== GoalState.RUNNING) return null;
-
-
-
-    const total = goal.milestones.length;
-
-    if (total === 0) return null;
-
-
-
-    const completedCount = goal.milestones.filter((m) => m.status === MilestoneStatus.COMPLETED).length;
-
-    if (completedCount === 0 || completedCount >= total) return null;
-
-
-
-    const elapsed = this.getElapsedSeconds(sid);
-
-    if (elapsed <= 0) return null;
-
-
-
-    const avgSecPerMilestone = elapsed / completedCount;
-
-    const remainingCount = total - completedCount;
-
-    return Math.max(1, Math.round(avgSecPerMilestone * remainingCount));
-
-  }
-
-
-
-  /**
-
-   * Снимок состояния для передачи клиенту / API
-
-   */
-
-  getSnapshot(sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    const goal = this.goals.get(sid);
-
-    if (!goal) {
-
-      return {
-
-        sessionId: sid,
-
-        hasActiveGoal: false,
-
-        state: GoalState.IDLE,
-
-        title: '',
-
-        startedAt: null,
-
-        pausedAt: null,
-
-        totalPausedDurationMs: 0,
-
-        completedAt: null,
-
-        elapsedSeconds: 0,
-
-        formattedElapsed: '0s',
-
-        estimatedRemainingSeconds: null,
-
-        formattedETA: null,
-
-        lang: 'en',
-
-        tokensUsage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
-
-        milestones: [],
-
-        progressPercent: 0,
-
-        iterationsCount: 0,
-
-        maxIterations: this.defaultMaxIterations,
-
-        autoDrive: this.autoDrive,
-
-        enableSound: this.enableSound,
-
-        showQuickLaunchButton: this.showQuickLaunchButton,
-
-        gitStartCommit: null,
-
-        pendingNudge: null,
-
-        toolFailureCount: 0,
-
-        consecutiveToolFailureLimit: this.consecutiveToolFailureLimit,
-
-      };
-
-    }
-
-
-
-    const elapsed = this.getElapsedSeconds(sid);
-
-    const milestones = goal.milestones;
-
-    const completedCount = milestones.filter((m) => m.status === MilestoneStatus.COMPLETED).length;
-
-    const progressPercent = milestones.length > 0 ? Math.round((completedCount / milestones.length) * 100) : 0;
-
-    const estSec = this.getEstimatedRemainingSeconds(sid);
-
-
-
-    return {
-
-      sessionId: sid,
-
-      hasActiveGoal: true,
-
-      id: goal.id,
-
-      state: goal.state,
-
-      title: goal.title,
-
-      description: goal.description,
-
-      lang: goal.lang || detectLanguage(goal.title),
-
-      startedAt: goal.startedAt,
-
-      pausedAt: goal.pausedAt,
-
-      totalPausedDurationMs: goal.totalPausedDurationMs,
-
-      completedAt: goal.completedAt,
-
-      elapsedSeconds: elapsed,
-
-      formattedElapsed: formatElapsed(elapsed),
-
-      estimatedRemainingSeconds: estSec,
-
-      formattedETA: formatETA(estSec),
-
-      tokensUsage: goal.tokensUsage || { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
-
-      iterationsCount: goal.iterationsCount,
-
-      maxIterations: goal.maxIterations,
-
-      milestones,
-
-      progressPercent,
-
-      logs: goal.logs,
-
-      resultSummary: goal.resultSummary,
-
-      autoDrive: this.autoDrive,
-
-      enableSound: this.enableSound,
-
-      showQuickLaunchButton: this.showQuickLaunchButton,
-
-      gitStartCommit: goal.gitStartCommit || null,
-
-      pendingNudge: goal.pendingNudge || null,
-
-      toolFailureCount: this.getToolFailureCount(sid),
-
-      consecutiveToolFailureLimit: this.consecutiveToolFailureLimit,
-
-    };
-
-  }
-
-
-
-  /**
-
-   * Формирование системного контекста для инжекта модели
-
-   */
-
-  getStatePromptInjection(sessionId = 'default') {
-
-    const sid = sessionId || 'default';
-
-    const goal = this.goals.get(sid);
-
-    if (!goal || goal.state !== GoalState.RUNNING) {
-
-      return '';
-
-    }
-
-
-
-    const snapshot = this.getSnapshot(sid);
-
-    const lang = goal.lang || detectLanguage(snapshot.title);
-
-    const hasMilestones = snapshot.milestones.length > 0;
-
-    const etaText = snapshot.formattedETA ? ` (ETA: ${snapshot.formattedETA})` : '';
-
-
-
-    let nudgeText = '';
-
-    if (goal.pendingNudge) {
-
-      const userFeedback = goal.pendingNudge;
-
-      goal.pendingNudge = null;
-
-      if (lang === 'zh') {
-
-        nudgeText = `\n\n🚨 用户紧急补充说明 / 调整方向:\n"${userFeedback}"\n你必须根据此说明调整近期的具体执行步骤！\n`;
-
-      } else if (lang === 'ru') {
-
-        nudgeText = `\n\n🚨 СРОЧНОЕ УТОЧНЕНИЕ / НАПРАВЛЕНИЕ ОТ ПОЛЬЗОВАТЕЛЯ:\n"${userFeedback}"\nОбязательно скорректируй свои ближайшие действия с учётом этого замечания!\n`;
-
-      } else {
-
-        nudgeText = `\n\n🚨 URGENT USER CLARIFICATION / STEERING:\n"${userFeedback}"\nYou must adjust your immediate actions according to this guidance!\n`;
-
-      }
-
-    }
-
-
-
-    if (lang === 'zh') {
-
-      const milestonesText = hasMilestones
-
-        ? snapshot.milestones.map((m, i) => `  ${i + 1}. [${m.status.toUpperCase()}] ${m.title}${m.notes ? ` (${m.notes})` : ''}`).join('\n')
-
-        : '  (工作计划尚未建立 — 请立即调用 goal_set_milestones 设定初始里程碑！)';
-
-
-
-      return nudgeText + `\n\n[DSH GOAL MODE ACTIVE]
-
-目标: "${snapshot.title}"
-
-运行时间: ${snapshot.formattedElapsed}${etaText} | 迭代轮次: ${snapshot.iterationsCount}/${snapshot.maxIterations}
-
-工作计划:
-
-${milestonesText}
-
-
-
-Goal Mode 执行契约 (必须严格遵循):
-
-1. ${hasMilestones ? '按部就班推进当前进行中的里程碑。' : '第一步核心指令: 立即调用 goal_set_milestones 制定 3-7 个具体里程碑。在完成此工具调用前严禁执行其他操作！'}
-
-2. 推进里程碑时，必须通过 goal_update_progress 工具更新状态（开始前标为 in_progress，完成后标为 completed 并附简要说明）。
-
-3. 当所有里程碑全部完成后，调用 goal_finish 工具提交详细成果总结。`;
-
-    }
-
-
-
-    if (lang === 'ru') {
-
-      const milestonesText = hasMilestones
-
-        ? snapshot.milestones.map((m, i) => `  ${i + 1}. [${m.status.toUpperCase()}] ${m.title}${m.notes ? ` (${m.notes})` : ''}`).join('\n')
-
-        : '  (План работ ещё не сформирован — немедленно вызови goal_set_milestones со списком шагов!)';
-
-
-
-      return nudgeText + `\n\n[DSH GOAL MODE ACTIVE]
-
-Цель: "${snapshot.title}"
-
-Время работы: ${snapshot.formattedElapsed}${etaText} | Итерация: ${snapshot.iterationsCount}/${snapshot.maxIterations}
-
-План работ:
-
-${milestonesText}
-
-
-
-Инструкции Goal Mode (СТРОГО ОБЯЗАТЕЛЬНЫ К ВЫПОЛНЕНИЮ):
-
-1. ${hasMilestones ? 'Выполняй текущий активный пункт плана работ.' : 'ТВОЙ ПЕРВЫЙ ШАГ: Немедленно вызови инструмент goal_set_milestones со списком пунктов плана работ (3-7 конкретных шагов). Запрещено выполнять работу или завершать turn без вызова goal_set_milestones!'}
-
-2. По мере выполнения каждого шага обязательно отмечай его статус через инструмент goal_update_progress (status: "in_progress" перед началом шага, status: "completed" по его завершении с кратким notes).
-
-3. Когда все пункты плана будут выполнены, вызови инструмент goal_finish с подробным итоговым резюме достигнутых результатов.`;
-
-    }
-
-
-
-    const milestonesText = hasMilestones
-
-      ? snapshot.milestones.map((m, i) => `  ${i + 1}. [${m.status.toUpperCase()}] ${m.title}${m.notes ? ` (${m.notes})` : ''}`).join('\n')
-
-      : '  (Work plan is not yet established — call goal_set_milestones immediately with initial steps!)';
-
-
-
-    return nudgeText + `\n\n[DSH GOAL MODE ACTIVE]
-
-Goal: "${snapshot.title}"
-
-Elapsed Time: ${snapshot.formattedElapsed}${etaText} | Iteration: ${snapshot.iterationsCount}/${snapshot.maxIterations}
-
-Work Plan:
-
-${milestonesText}
-
-
-
-Goal Mode Instructions (MANDATORY TO FOLLOW):
-
-1. ${hasMilestones ? 'Execute the current active milestone from the work plan.' : 'YOUR FIRST STEP: Immediately call tool goal_set_milestones with the list of milestones (3-7 concrete steps). You must not execute work or finish turn without calling goal_set_milestones!'}
-
-2. As each milestone progresses, update its status via tool goal_update_progress (status: "in_progress" before starting, status: "completed" upon completion with brief notes).
-
-3. When all milestones are completed, call tool goal_finish with a detailed summary of achieved results.`;
-
-  }
-
-}
-
+import { GoalState, MilestoneStatus, formatElapsed, formatETA, detectLanguage, sessionIdOf } from './goal-engine-constants.js';
+import { getGitCurrentCommit, exportReportMarkdown, exportReportGitHubPR } from './engine-reports.js';
+import { EngineStore } from './engine-store.js';
+import { buildStatePromptInjection } from './engine-prompt.js';
+
+export { GoalState, MilestoneStatus, formatElapsed, formatETA, detectLanguage, sessionIdOf };
+export { getGitCurrentCommit, exportReportMarkdown, exportReportGitHubPR };
+
+/**
+ * Isolated Goal Management Engine for DeepSeek Harness
+ */
+export class GoalEngine {
+  constructor(options = {}) {
+    this.defaultMaxIterations = options.defaultMaxIterations ?? 25;
+    this.autoDrive = options.autoDrive ?? true;
+    this.enableSound = options.enableSound ?? true;
+    this.showQuickLaunchButton = options.showQuickLaunchButton ?? true;
+    this.consecutiveToolFailureLimit = options.consecutiveToolFailureLimit ?? 3;
+    this.maxSessions = options.maxSessions ?? 100;
+    this.goals = new Map();
+    this.listeners = new Set();
+    this.stallCounters = new Map();
+    this.toolFailureCounters = new Map();
+
+    this.store = new EngineStore(this, options.storagePath ?? null);
+    this.store.loadStateFromDisk();
+  }
+
+  get storagePath() { return this.store.storagePath; }
+  set storagePath(val) { this.store.setStoragePath(val); }
+  get saveTimer() { return this.store.saveTimer; }
+  get currentGoal() { return this.goals.get('default') || null; }
+  set currentGoal(val) {
+    if (val) this.goals.set('default', val);
+    else this.goals.delete('default');
+  }
+
+  loadStateFromDisk() { this.store.loadStateFromDisk(); }
+  scheduleSave(immediate = false) { this.store.scheduleSave(immediate); }
+  writeStateToDiskSync() { this.store.writeStateToDiskSync(); }
+  flushSync() { this.store.flushSync(); }
+  saveStateToDisk() { this.flushSync(); }
+
+  subscribe(callback) {
+    this.listeners.add(callback);
+    return () => this.listeners.delete(callback);
+  }
+
+  emit(sessionId = 'default', immediate = false) {
+    this.scheduleSave(immediate);
+    const sid = sessionId || 'default';
+    const snapshot = this.getSnapshot(sid);
+    for (const listener of this.listeners) {
+      try {
+        listener(snapshot, sid);
+      } catch (err) {
+        console.error?.('[GoalEngine] Listener error:', err?.message || err);
+      }
+    }
+  }
+
+  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;
+  }
+
+  updateConfig(config = {}) {
+    if (typeof config.defaultMaxIterations === 'number' && config.defaultMaxIterations >= 1) {
+      const prev = this.defaultMaxIterations;
+      this.defaultMaxIterations = config.defaultMaxIterations;
+      for (const [_, goal] of this.goals) {
+        if (goal && goal.maxIterations === prev) {
+          goal.maxIterations = config.defaultMaxIterations;
+        }
+      }
+    }
+    if (typeof config.autoDrive === 'boolean') {
+      this.autoDrive = config.autoDrive;
+    }
+    if (typeof config.enableSound === 'boolean') {
+      this.enableSound = config.enableSound;
+    }
+    if (typeof config.showQuickLaunchButton === 'boolean') {
+      this.showQuickLaunchButton = config.showQuickLaunchButton;
+    }
+    if (typeof config.consecutiveToolFailureLimit === 'number') {
+      this.consecutiveToolFailureLimit = Math.max(0, config.consecutiveToolFailureLimit);
+    }
+    this.emit();
+  }
+
+  getGoal(sessionId = 'default') {
+    return this.goals.get(sessionId || 'default') || null;
+  }
+
+  incrementToolFailureCount(sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const current = this.toolFailureCounters.get(sid) || 0;
+    const next = current + 1;
+    this.toolFailureCounters.set(sid, next);
+    return next;
+  }
+
+  resetToolFailureCount(sessionId = 'default') {
+    const sid = sessionId || 'default';
+    this.toolFailureCounters.set(sid, 0);
+  }
+
+  getToolFailureCount(sessionId = 'default') {
+    const sid = sessionId || 'default';
+    return this.toolFailureCounters.get(sid) || 0;
+  }
+
+  nudge(text, sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal) return this.getSnapshot(sid);
+
+    const clean = String(text || '').trim();
+    if (!clean) return this.getSnapshot(sid);
+
+    if (!Array.isArray(goal.nudges)) {
+      goal.nudges = [];
+    }
+    const now = Date.now();
+    goal.nudges.push({ text: clean, timestamp: now });
+    goal.pendingNudge = clean;
+    goal.logs.push({
+      timestamp: now,
+      type: 'info',
+      message: `User steering / clarification: "${clean}"`,
+    });
+    if (goal.logs.length > 100) {
+      goal.logs = goal.logs.slice(-100);
+    }
+
+    this.emit(sid, true);
+    return this.getSnapshot(sid);
+  }
+
+  consumePendingNudge(sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal || !goal.pendingNudge) return null;
+    const nudge = goal.pendingNudge;
+    goal.pendingNudge = null;
+    this.emit(sid);
+    return nudge;
+  }
+
+  pruneInactiveSessions() {
+    if (this.goals.size < this.maxSessions) return;
+    const inactive = [];
+    for (const [sid, goal] of this.goals.entries()) {
+      if (sid === 'default') continue;
+      if (goal.state === GoalState.COMPLETED || goal.state === GoalState.CANCELLED || goal.state === GoalState.FAILED) {
+        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);
+    }
+  }
+
+  clearSession(sessionId) {
+    if (!sessionId || sessionId === 'default') return false;
+    const had = this.goals.delete(sessionId);
+    this.stallCounters.delete(sessionId);
+    this.toolFailureCounters.delete(sessionId);
+    if (had) this.emit(sessionId, true);
+    return had;
+  }
+
+  startGoal(title, options = {}, sessionId = 'default') {
+    if (!title || typeof title !== 'string' || !title.trim()) {
+      throw new Error('Goal title cannot be empty');
+    }
+
+    this.pruneInactiveSessions();
+
+    const cleanTitle = title.trim();
+    const now = Date.now();
+    const sid = sessionId || 'default';
+    this.stallCounters.set(sid, 0);
+
+    const gitCommit = options.gitStartCommit !== undefined
+      ? options.gitStartCommit
+      : getGitCurrentCommit(options.cwd);
+
+    this.toolFailureCounters.set(sid, 0);
+
+    const goal = {
+      id: `goal-${now}-${Math.random().toString(36).substring(2, 7)}`,
+      sessionId: sid,
+      title: cleanTitle,
+      description: options.description?.trim() || '',
+      lang: options.lang || detectLanguage(cleanTitle),
+      state: GoalState.RUNNING,
+      startedAt: now,
+      pausedAt: null,
+      totalPausedDurationMs: 0,
+      completedAt: null,
+      iterationsCount: 0,
+      maxIterations: options.maxIterations ?? this.defaultMaxIterations,
+      gitStartCommit: gitCommit || null,
+      pendingNudge: null,
+      nudges: [],
+      milestones: [],
+      tokensUsage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+      logs: [
+        {
+          timestamp: now,
+          type: 'info',
+          message: `Goal initiated: "${cleanTitle}"` + (gitCommit ? ` (Git: ${gitCommit})` : ''),
+        },
+      ],
+      resultSummary: '',
+    };
+
+    this.goals.set(sid, goal);
+
+    if (Array.isArray(options.milestones) && options.milestones.length > 0) {
+      this.addMilestones(options.milestones, false, sid);
+    }
+
+    this.emit(sid, true);
+    return this.getSnapshot(sid);
+  }
+
+  pause(reason = 'User requested pause', sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal || goal.state !== GoalState.RUNNING) {
+      return this.getSnapshot(sid);
+    }
+
+    goal.state = GoalState.PAUSED;
+    goal.pausedAt = Date.now();
+    goal.logs.push({
+      timestamp: Date.now(),
+      type: 'warning',
+      message: `Paused: ${reason}`,
+    });
+
+    if (goal.logs.length > 100) {
+      goal.logs = goal.logs.slice(-100);
+    }
+
+    this.emit(sid, true);
+    return this.getSnapshot(sid);
+  }
+
+  resume(sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal || goal.state !== GoalState.PAUSED) {
+      return this.getSnapshot(sid);
+    }
+
+    const now = Date.now();
+    if (goal.pausedAt) {
+      goal.totalPausedDurationMs += now - goal.pausedAt;
+      goal.pausedAt = null;
+    }
+
+    goal.state = GoalState.RUNNING;
+    this.stallCounters.set(sid, 0);
+
+    goal.logs.push({
+      timestamp: now,
+      type: 'info',
+      message: 'Goal resumed',
+    });
+
+    if (goal.logs.length > 100) {
+      goal.logs = goal.logs.slice(-100);
+    }
+
+    this.emit(sid, true);
+    return this.getSnapshot(sid);
+  }
+
+  cancel(reason = 'Cancelled by user', sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal) return null;
+
+    goal.state = GoalState.CANCELLED;
+    goal.completedAt = Date.now();
+    goal.logs.push({
+      timestamp: Date.now(),
+      type: 'warning',
+      message: `Cancelled: ${reason}`,
+    });
+
+    if (goal.logs.length > 100) {
+      goal.logs = goal.logs.slice(-100);
+    }
+
+    this.emit(sid, true);
+    return this.getSnapshot(sid);
+  }
+
+  clear(sessionId = 'default') {
+    const sid = sessionId || 'default';
+    this.goals.delete(sid);
+    this.stallCounters.delete(sid);
+    this.emit(sid, true);
+    return this.getSnapshot(sid);
+  }
+
+  completeGoal(summary = '', sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal) return null;
+
+    const now = Date.now();
+    goal.state = GoalState.COMPLETED;
+    goal.completedAt = now;
+    goal.resultSummary = summary;
+    goal.logs.push({
+      timestamp: now,
+      type: 'info',
+      message: `Goal completed successfully: ${summary || 'All objectives met.'}`,
+    });
+
+    if (goal.logs.length > 100) {
+      goal.logs = goal.logs.slice(-100);
+    }
+
+    for (const m of goal.milestones) {
+      if (m.status === MilestoneStatus.IN_PROGRESS || m.status === MilestoneStatus.PENDING) {
+        m.status = MilestoneStatus.COMPLETED;
+      }
+    }
+
+    this.stallCounters.delete(sid);
+    this.emit(sid, true);
+    return this.getSnapshot(sid);
+  }
+
+  addMilestones(milestonesList, shouldEmit = true, sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal || !Array.isArray(milestonesList)) return;
+
+    for (const item of milestonesList) {
+      const itemTitle = typeof item === 'string' ? item : item.title;
+      if (!itemTitle || !itemTitle.trim()) continue;
+
+      const mId = typeof item === 'object' && item.id ? item.id : `m-${goal.milestones.length + 1}`;
+      goal.milestones.push({
+        id: String(mId),
+        title: itemTitle.trim(),
+        status: typeof item === 'object' && item.status ? item.status : MilestoneStatus.PENDING,
+        notes: typeof item === 'object' && item.notes ? item.notes : '',
+      });
+    }
+
+    this.recordProgress(sid);
+    if (shouldEmit) this.emit(sid);
+  }
+
+  updateMilestone(id, status, notes = '', sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal) return false;
+
+    const target = goal.milestones.find((m) => m.id === String(id));
+    if (!target) return false;
+
+    if (status && Object.values(MilestoneStatus).includes(status)) {
+      target.status = status;
+    }
+    if (notes) {
+      target.notes = String(notes);
+    }
+
+    goal.logs.push({
+      timestamp: Date.now(),
+      type: 'milestone',
+      message: `Milestone [${target.title}] status -> ${target.status}`,
+    });
+
+    if (goal.logs.length > 100) {
+      goal.logs = goal.logs.slice(-100);
+    }
+
+    this.recordProgress(sid);
+    this.emit(sid);
+    return true;
+  }
+
+  incrementIteration(sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal || goal.state !== GoalState.RUNNING) {
+      return false;
+    }
+
+    goal.iterationsCount += 1;
+
+    if (goal.iterationsCount >= goal.maxIterations) {
+      goal.state = GoalState.FAILED;
+      goal.logs.push({
+        timestamp: Date.now(),
+        type: 'error',
+        message: `Safety limit reached: maximum ${goal.maxIterations} iterations exceeded.`,
+      });
+      if (goal.logs.length > 100) {
+        goal.logs = goal.logs.slice(-100);
+      }
+      this.emit(sid, true);
+      return false;
+    }
+
+    this.emit(sid);
+    return true;
+  }
+
+  getElapsedSeconds(sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal) return 0;
+    const { startedAt, pausedAt, totalPausedDurationMs, completedAt } = goal;
+    const endTime = completedAt || (pausedAt || Date.now());
+    const elapsedMs = Math.max(0, endTime - startedAt - totalPausedDurationMs);
+    return Math.floor(elapsedMs / 1000);
+  }
+
+  addTokenUsage(usage, sessionId = 'default') {
+    if (!usage || typeof usage !== 'object') return;
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal) return;
+
+    if (!goal.tokensUsage) {
+      goal.tokensUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+    }
+
+    const prompt = Number(usage.promptTokens ?? usage.input_tokens ?? usage.prompt_tokens ?? 0) || 0;
+    const completion = Number(usage.completionTokens ?? usage.output_tokens ?? usage.completion_tokens ?? 0) || 0;
+    const total = Number(usage.totalTokens ?? usage.total_tokens ?? (prompt + completion)) || (prompt + completion);
+
+    goal.tokensUsage.promptTokens += prompt;
+    goal.tokensUsage.completionTokens += completion;
+    goal.tokensUsage.totalTokens += total;
+
+    this.emit(sid);
+  }
+
+  getEstimatedRemainingSeconds(sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal || goal.state !== GoalState.RUNNING) return null;
+
+    const total = goal.milestones.length;
+    if (total === 0) return null;
+
+    const completedCount = goal.milestones.filter((m) => m.status === MilestoneStatus.COMPLETED).length;
+    if (completedCount === 0 || completedCount >= total) return null;
+
+    const elapsed = this.getElapsedSeconds(sid);
+    if (elapsed <= 0) return null;
+
+    const avgSecPerMilestone = elapsed / completedCount;
+    const remainingCount = total - completedCount;
+    return Math.max(1, Math.round(avgSecPerMilestone * remainingCount));
+  }
+
+  getSnapshot(sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal) {
+      return {
+        sessionId: sid,
+        hasActiveGoal: false,
+        state: GoalState.IDLE,
+        title: '',
+        startedAt: null,
+        pausedAt: null,
+        totalPausedDurationMs: 0,
+        completedAt: null,
+        elapsedSeconds: 0,
+        formattedElapsed: '0s',
+        estimatedRemainingSeconds: null,
+        formattedETA: null,
+        lang: 'en',
+        tokensUsage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+        milestones: [],
+        progressPercent: 0,
+        iterationsCount: 0,
+        maxIterations: this.defaultMaxIterations,
+        autoDrive: this.autoDrive,
+        enableSound: this.enableSound,
+        showQuickLaunchButton: this.showQuickLaunchButton,
+        gitStartCommit: null,
+        pendingNudge: null,
+        toolFailureCount: 0,
+        consecutiveToolFailureLimit: this.consecutiveToolFailureLimit,
+      };
+    }
+
+    const elapsed = this.getElapsedSeconds(sid);
+    const milestones = goal.milestones;
+    const completedCount = milestones.filter((m) => m.status === MilestoneStatus.COMPLETED).length;
+    const progressPercent = milestones.length > 0 ? Math.round((completedCount / milestones.length) * 100) : 0;
+    const estSec = this.getEstimatedRemainingSeconds(sid);
+
+    return {
+      sessionId: sid,
+      hasActiveGoal: true,
+      id: goal.id,
+      state: goal.state,
+      title: goal.title,
+      description: goal.description,
+      lang: goal.lang || detectLanguage(goal.title),
+      startedAt: goal.startedAt,
+      pausedAt: goal.pausedAt,
+      totalPausedDurationMs: goal.totalPausedDurationMs,
+      completedAt: goal.completedAt,
+      elapsedSeconds: elapsed,
+      formattedElapsed: formatElapsed(elapsed),
+      estimatedRemainingSeconds: estSec,
+      formattedETA: formatETA(estSec),
+      tokensUsage: goal.tokensUsage || { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+      iterationsCount: goal.iterationsCount,
+      maxIterations: goal.maxIterations,
+      milestones,
+      progressPercent,
+      logs: goal.logs,
+      resultSummary: goal.resultSummary,
+      autoDrive: this.autoDrive,
+      enableSound: this.enableSound,
+      showQuickLaunchButton: this.showQuickLaunchButton,
+      gitStartCommit: goal.gitStartCommit || null,
+      pendingNudge: goal.pendingNudge || null,
+      toolFailureCount: this.getToolFailureCount(sid),
+      consecutiveToolFailureLimit: this.consecutiveToolFailureLimit,
+    };
+  }
+
+  getGoalSnapshot(sessionId = 'default') {
+    return this.getSnapshot(sessionId);
+  }
+
+  getStatePromptInjection(sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal || goal.state !== GoalState.RUNNING) {
+      return '';
+    }
+
+    const snapshot = this.getSnapshot(sid);
+    let pendingNudge = null;
+    if (goal.pendingNudge) {
+      pendingNudge = goal.pendingNudge;
+      goal.pendingNudge = null;
+    }
+
+    return buildStatePromptInjection(snapshot, pendingNudge);
+  }
+}