@goodandready/dsh-goal 0.2.32 → 0.2.33

package/lib/client.js

@@ -2001,6 +2001,16 @@ window.__ModuleLoader__.load({
         border: 1px solid var(--dsw-alias-border);
         margin-left: 6px;
       }
+      .dsh-goal-stat-cost {
+        background: var(--dsw-alias-bg-layer-2, var(--dsw-alias-bg-hover));
+        color: var(--dsw-alias-state-warning-primary, var(--dsw-alias-text-secondary));
+        border: 1px solid var(--dsw-alias-border);
+      }
+      .dsh-goal-badge-cost-limit {
+        background: var(--dsw-alias-status-danger, var(--dsw-alias-status-warning));
+        color: var(--dsw-alias-surface-raised, var(--dsw-alias-text-inverse));
+        font-weight: 600;
+      }
     `;
     function injectStylesOnce() {
 
@@ -2294,6 +2304,9 @@ window.__ModuleLoader__.load({
       const [interveneText, setInterveneText] = useState('');
 
       const [interveneSent, setInterveneSent] = useState(false);
+      const [copiedNotes, setCopiedNotes] = useState(false);
+      const [notifiedTelegram, setNotifiedTelegram] = useState(false);
+      const [dispatchingTelegram, setDispatchingTelegram] = useState(false);
       const [activeTab, setActiveTab] = useState("overview");
       const [diffData, setDiffData] = useState(null);
       const [diffLoading, setDiffLoading] = useState(false);
@@ -2500,6 +2513,45 @@ window.__ModuleLoader__.load({
 
         : 'Tokens not recorded yet';
 
+      const handleCopyReleaseNotes = async () => {
+        try {
+          const res = await fetch('/dsh-goal/action', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ action: 'export_release_notes', sessionId: state.sessionId }),
+          });
+          const json = await res.json();
+          const notesText = json?.releaseNotes || '';
+          if (notesText && typeof navigator !== 'undefined' && navigator.clipboard?.writeText) {
+            await navigator.clipboard.writeText(notesText);
+            setCopiedNotes(true);
+            setTimeout(() => setCopiedNotes(false), 2500);
+          }
+        } catch (e) {
+          console.warn('[dsh-goal] Failed to export release notes:', e);
+        }
+      };
+
+      const handleSendTelegram = async () => {
+        setDispatchingTelegram(true);
+        try {
+          const res = await fetch('/dsh-goal/action', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ action: 'notify_telegram', sessionId: state.sessionId }),
+          });
+          const json = await res.json();
+          if (json?.ok) {
+            setNotifiedTelegram(true);
+            setTimeout(() => setNotifiedTelegram(false), 3000);
+          }
+        } catch (e) {
+          console.warn('[dsh-goal] Failed to notify telegram:', e);
+        } finally {
+          setDispatchingTelegram(false);
+        }
+      };
+
       const handleCopyReport = () => {
 
         const md = generateMarkdownReport(state);
@@ -2891,6 +2943,21 @@ window.__ModuleLoader__.load({
 
               ),
 
+              React.createElement(
+
+                'div',
+
+                {
+                  className: 'dsh-goal-stat-box',
+                  title: 'Cost: ' + (state.costUsage?.formattedCost || '.00') + (state.maxCostBudget ? ' / $' + state.maxCostBudget.toFixed(2) : ''),
+                },
+
+                React.createElement('span', { className: 'dsh-goal-stat-val' }, state.costUsage?.formattedCost || '.00'),
+
+                React.createElement('span', { className: 'dsh-goal-stat-lbl' }, t('cost') || 'Cost'),
+
+              ),
+
               React.createElement(
 
                 'div',
@@ -3177,6 +3244,44 @@ window.__ModuleLoader__.load({
 
                   ),
 
+                  React.createElement(
+
+                    'button',
+
+                    {
+
+                      className: 'dsh-goal-btn dsh-goal-btn-copy' + (copiedNotes ? ' copied' : ''),
+
+                      onClick: handleCopyReleaseNotes,
+
+                      title: t('copyReleaseNotes') || 'Copy Conventional Release Notes',
+
+                    },
+
+                    copiedNotes ? (t('releaseNotesCopied') || '✅ Release Notes Copied!') : (t('copyReleaseNotes') || '📝 Release Notes'),
+
+                  ),
+
+                  React.createElement(
+
+                    'button',
+
+                    {
+
+                      className: 'dsh-goal-btn dsh-goal-btn-copy' + (notifiedTelegram ? ' copied' : ''),
+
+                      disabled: dispatchingTelegram,
+
+                      onClick: handleSendTelegram,
+
+                      title: t('notifyTelegram') || 'Send Digest to Telegram',
+
+                    },
+
+                    notifiedTelegram ? (t('telegramNotified') || '✅ Sent to Telegram!') : (t('notifyTelegram') || '✈️ Telegram'),
+
+                  ),
+
                   React.createElement(
 
                     'button',
@@ -4387,6 +4492,7 @@ window.__ModuleLoader__.load({
       const etaStr = state?.formattedETA ? ` (ETA ${state.formattedETA})` : '';
 
       const isBudgetExceeded = state?.state === 'PAUSED' && state?.logs?.some((l) => l.message?.includes('Token budget reached'));
+      const isCostExceeded = Boolean(state?.costLimitExceeded);
 
       return React.createElement(
 
@@ -4415,6 +4521,7 @@ window.__ModuleLoader__.load({
                   isCompleted ? (t('goalCompleted') || 'Done') : isWaitingOperator ? ('❓ ' + (t('operatorInputRequired') || 'Input Needed')) : isPlanMode ? (t('planMode') || 'Plan Mode') : isPaused ? (t('paused') || 'Paused') : (t('goalLabel') || 'Goal')
                 ),
                 React.createElement('span', { className: 'dsh-goal-title', title: state.title }, state.title),
+                state.costUsage && state.costUsage.totalCost > 0 ? React.createElement('span', { className: 'dsh-goal-time dsh-goal-stat-cost', title: (t('costUsage') || 'Cost') + ': ' + state.costUsage.formattedCost }, '💰 ' + state.costUsage.formattedCost) : null,
                 React.createElement('span', { className: 'dsh-goal-time' }, `⏱ ${liveElapsedStr}`),
                 isPlanMode && !isCompleted ? React.createElement(
                   'button',
@@ -4537,6 +4644,19 @@ window.__ModuleLoader__.load({
                   )
                 : null,
 
+              state.costUsage && state.costUsage.totalCost > 0
+                ? React.createElement(
+                    'span',
+                    {
+                      className: 'dsh-goal-stat-pill dsh-goal-stat-cost',
+                      style: { cursor: 'pointer' },
+                      title: (t('costUsage') || 'Cost') + ': ' + state.costUsage.formattedCost + (state.maxCostBudget ? ' / ' + state.costUsage.currency + ' ' + state.maxCostBudget.toFixed(2) : ''),
+                      onClick: () => setIsModalOpen(true),
+                    },
+                    '💰 ' + state.costUsage.formattedCost
+                  )
+                : null,
+
               React.createElement(
 
                 'span',
@@ -4581,6 +4701,16 @@ window.__ModuleLoader__.load({
 
                 : null,
 
+              isCostExceeded
+                ? React.createElement(
+                    'span',
+                    {
+                      className: 'dsh-goal-badge dsh-goal-badge-cost-limit',
+                      title: t('costLimitReached') || 'Cost Budget Exceeded',
+                    },
+                    '🚨 ' + (t('costLimitReached') || 'Cost Limit')
+                  )
+                : null,
               isBudgetExceeded
                 ? React.createElement(
                     'button',
@@ -6013,6 +6143,14 @@ window.__ModuleLoader__.load({
         parentGoalBanner: 'Child Sub-goal of:',
         compactedBadge: 'Compacted',
         compactionTooltip: 'History compacted to reduce context footprint',
+        cost: 'Cost',
+        costUsage: 'Financial Cost',
+        costLimitReached: 'Cost Budget Exceeded',
+        costBudgetLabel: 'Financial Budget Limit ($):',
+        copyReleaseNotes: '📝 Copy Release Notes',
+        releaseNotesCopied: '✅ Release Notes Copied!',
+        notifyTelegram: '✈️ Send to Telegram',
+        telegramNotified: '✅ Sent to Telegram!',
 
       },
 
@@ -6183,6 +6321,14 @@ window.__ModuleLoader__.load({
         parentGoalBanner: '衍生自主目标:',
         compactedBadge: '已压缩',
         compactionTooltip: '阶段历史已自动精简压缩以优化上下文窗口',
+        cost: '成本',
+        costUsage: '财务消耗',
+        costLimitReached: '财务预算超限',
+        costBudgetLabel: '最高财务预算限制 ($):',
+        copyReleaseNotes: '📝 复制发布简报',
+        releaseNotesCopied: '✅ 发布简报已复制！',
+        notifyTelegram: '✈️ 发送至 Telegram',
+        telegramNotified: '✅ 已推送到 Telegram！',
 
       },
 

package/lib/engine-cost-meter.js

@@ -0,0 +1,161 @@
+/**
+ * Real-time Financial Cost Meter for DSH Goal Engine (Issue #169).
+ * Computes monetary token costs based on active model rates,
+ * tracks accumulated costs, and enforces financial budget thresholds.
+ */
+
+export const DEFAULT_MODEL_RATES = {
+  // USD per 1,000,000 tokens: { prompt: price, completion: price }
+  'deepseek-chat': { prompt: 0.14, completion: 0.28 },
+  'deepseek-reasoner': { prompt: 0.55, completion: 2.19 },
+  'deepseek-coder': { prompt: 0.14, completion: 0.28 },
+  'gpt-4o': { prompt: 2.50, completion: 10.00 },
+  'gpt-4o-mini': { prompt: 0.15, completion: 0.60 },
+  'claude-3-5-sonnet': { prompt: 3.00, completion: 15.00 },
+  'claude-3-5-haiku': { prompt: 0.80, completion: 4.00 },
+  'claude-3-opus': { prompt: 15.00, completion: 75.00 },
+  'fallback': { prompt: 1.00, completion: 3.00 },
+};
+
+/**
+ * Resolve pricing rates for a given model identifier
+ * @param {string} [modelName]
+ * @param {object} [customRates]
+ * @returns {{ prompt: number, completion: number }}
+ */
+export function getModelRates(modelName, customRates = {}) {
+  const table = { ...DEFAULT_MODEL_RATES, ...(customRates || {}) };
+  if (!modelName || typeof modelName !== 'string') return table.fallback;
+  const lower = modelName.toLowerCase();
+  for (const [key, rates] of Object.entries(table)) {
+    if (key !== 'fallback' && lower.includes(key)) {
+      return rates;
+    }
+  }
+  return table.fallback;
+}
+
+/**
+ * Format currency amount into human readable string
+ * @param {number} amount
+ * @param {string} [currency='USD']
+ * @returns {string}
+ */
+export function formatCurrency(amount, currency = 'USD') {
+  const num = Number(amount) || 0;
+  const sym = currency === "EUR" ? "€" : currency === "CNY" ? "¥" : currency === "GBP" ? "£" : "$";
+  if (num === 0) return sym + "0.00";
+  if (num < 0.01) return sym + num.toFixed(4);
+  return sym + num.toFixed(2);
+}
+
+/**
+ * Calculate monetary cost for given token counts and model
+ * @param {number} [promptTokens=0]
+ * @param {number} [completionTokens=0]
+ * @param {string} [modelName='']
+ * @param {object} [customRates={}]
+ * @returns {object}
+ */
+export function calculateCost(promptTokens = 0, completionTokens = 0, modelName = '', customRates = {}) {
+  const p = Number(promptTokens) || 0;
+  const c = Number(completionTokens) || 0;
+  const rates = getModelRates(modelName, customRates);
+  const promptCost = (p / 1_000_000) * rates.prompt;
+  const completionCost = (c / 1_000_000) * rates.completion;
+  const totalCost = promptCost + completionCost;
+
+  return {
+    promptTokens: p,
+    completionTokens: c,
+    totalTokens: p + c,
+    promptCost,
+    completionCost,
+    totalCost,
+    formattedCost: formatCurrency(totalCost),
+    modelName: modelName || 'standard',
+  };
+}
+
+/**
+ * Update goal accumulated cost usage
+ * @param {object} goal
+ * @param {object} usage - { promptTokens, completionTokens, model }
+ * @param {object} [engine={}] - GoalEngine instance
+ * @returns {object}
+ */
+export function updateGoalCostUsage(goal, usage = {}, engine = {}) {
+  if (!goal) return null;
+  if (!goal.costUsage) {
+    goal.costUsage = { promptCost: 0, completionCost: 0, totalCost: 0, formattedCost: '$0.00' };
+  }
+
+  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 model = usage.model || usage.modelName || goal.model || engine.activeModel || engine.model || '';
+
+  const cost = calculateCost(prompt, completion, model, engine.customRates || engine.modelTariffs);
+  goal.costUsage.promptCost += cost.promptCost;
+  goal.costUsage.completionCost += cost.completionCost;
+  goal.costUsage.totalCost += cost.totalCost;
+  goal.costUsage.formattedCost = formatCurrency(goal.costUsage.totalCost, engine.currency);
+
+  return goal.costUsage;
+}
+
+/**
+ * Evaluate financial cost budget limits and emit warnings or pauses
+ * @param {object} goal
+ * @param {object} [options={}]
+ * @returns {{ paused: boolean, warning: boolean, exceeded: boolean, currentCost: number, budget: number }}
+ */
+export function processCostBudget(goal, options = {}) {
+  const { maxCostBudget = 0, costWarningThreshold = 80, GoalState, recordActivity } = options;
+  const budget = goal.maxCostBudget || maxCostBudget || 0;
+  if (budget <= 0 || !goal.costUsage) {
+    return { paused: false, warning: false, exceeded: false, currentCost: 0, budget: 0 };
+  }
+
+  const currentCost = goal.costUsage.totalCost;
+  const warnThreshold = (budget * costWarningThreshold) / 100;
+
+  if (currentCost >= warnThreshold && !goal.costWarningTriggered) {
+    goal.costWarningTriggered = true;
+    goal.logs.push({
+      timestamp: Date.now(),
+      type: 'warning',
+      message: `Cost budget warning: ${goal.costUsage.formattedCost} of $${budget.toFixed(2)} budget consumed (${Math.round((currentCost / budget) * 100)}%)`,
+    });
+    if (typeof recordActivity === 'function') {
+      recordActivity(goal, {
+        type: 'budget',
+        tool: 'costBudgetWarning',
+        status: 'warning',
+        details: `${goal.costUsage.formattedCost} / $${budget.toFixed(2)}`,
+      });
+    }
+  }
+
+  if (currentCost >= budget && goal.state === (GoalState?.RUNNING || 'RUNNING')) {
+    goal.costLimitExceeded = true;
+    goal.state = GoalState?.PAUSED || 'PAUSED';
+    goal.pausedAt = Date.now();
+    goal.pauseReason = `Cost budget limit of $${budget.toFixed(2)} reached`;
+    goal.logs.push({
+      timestamp: Date.now(),
+      type: 'warning',
+      message: `Cost budget limit ($${budget.toFixed(2)}) reached. Pausing autonomous goal.`,
+    });
+    if (typeof recordActivity === 'function') {
+      recordActivity(goal, {
+        type: 'control',
+        tool: 'costBudgetLimit',
+        status: 'error',
+        details: goal.pauseReason,
+      });
+    }
+    return { paused: true, warning: true, exceeded: true, currentCost, budget };
+  }
+
+  return { paused: false, warning: Boolean(goal.costWarningTriggered), warned: Boolean(goal.costWarningTriggered), exceeded: false, currentCost, budget };
+}

package/lib/engine-prompt.js

@@ -56,6 +56,25 @@ export function buildStatePromptInjection(snapshot, pendingNudge) {
     }
   }
 
+  let costWarningText = '';
+  if (snapshot.costLimitExceeded) {
+    const formatted = snapshot.costUsage?.formattedCost || ".00";
+    const limit = "$" + (snapshot.maxCostBudget || 0).toFixed(2);
+    if (lang === "zh") {
+      costWarningText = "\n\n🚨 财务成本预算超限熔断警告 (" + formatted + " / " + limit + "):\n当前目标已超出设定的最高财务预算限制！严禁发起任何额外的模型调用，必须立即调用 goal_finish 提交已有成果并退出！\n";
+    } else {
+      costWarningText = "\n\n🚨 FINANCIAL COST BUDGET EXCEEDED (" + formatted + " / " + limit + "):\nGoal cost has exceeded the maximum allocated financial budget! Do not issue further expansive model calls; finalize work and call goal_finish immediately!\n";
+    }
+  } else if (snapshot.costWarningTriggered) {
+    const formatted = snapshot.costUsage?.formattedCost || ".00";
+    const limit = "$" + (snapshot.maxCostBudget || 0).toFixed(2);
+    if (lang === "zh") {
+      costWarningText = "\n\n⚠️ 财务成本预算预警 (" + formatted + " / " + limit + "):\n财务消耗即将达到设定上限！请高度精简提示词与回答，尽快完成当前里程碑并调用 goal_finish！\n";
+    } else {
+      costWarningText = "\n\n⚠️ FINANCIAL COST ALERT (" + formatted + " / " + limit + "):\nCost budget is nearing threshold! Be concise, wrap up pending milestones, and call goal_finish promptly!\n";
+    }
+  }
+
   let subGoalContextText = '';
   if (snapshot.isSubGoal) {
     if (lang === 'zh') {
@@ -111,6 +130,8 @@ export function buildStatePromptInjection(snapshot, pendingNudge) {
       directiveText +
       nudgeText +
       budgetWarningText +
+    costWarningText +
+      costWarningText +
       `\n\n[DSH GOAL MODE ACTIVE]\n` +
       `目标: "${snapshot.title}"\n` +
       `运行时间: ${snapshot.formattedElapsed}${etaText} | 迭代轮次: ${snapshot.iterationsCount}/${snapshot.maxIterations}\n` +
@@ -134,6 +155,7 @@ export function buildStatePromptInjection(snapshot, pendingNudge) {
     directiveText +
     nudgeText +
     budgetWarningText +
+    costWarningText +
     `\n\n[DSH GOAL MODE ACTIVE]\n` +
     `Goal: "${snapshot.title}"\n` +
     `Elapsed Time: ${snapshot.formattedElapsed}${etaText} | Iteration: ${snapshot.iterationsCount}/${snapshot.maxIterations}\n` +

package/lib/engine-release-notes.js

@@ -0,0 +1,132 @@
+/**
+ * Release Notes Generator and Notification Dispatcher (Issue #171).
+ * Formats standardized Conventional Changelog / Release Notes from goal artifacts
+ * and dispatches completion digests to messenger gateways asynchronously.
+ */
+
+import { formatElapsed } from './goal-engine-constants.js';
+
+/**
+ * Generate standardized Release Notes in Markdown format
+ * @param {object} goal - Goal state object
+ * @param {object} [options={}] - Options { includeMetrics, customHeader }
+ * @returns {string}
+ */
+export function generateReleaseNotes(goal, options = {}) {
+  if (!goal) return '';
+
+  const title = goal.title || 'Autonomous Task Deliverables';
+  const startedAt = goal.startedAt ? new Date(goal.startedAt).toISOString().split('T')[0] : '';
+  const elapsedSec = Math.max(0, Math.floor(((goal.completedAt || Date.now()) - (goal.startedAt || Date.now())) / 1000));
+  const elapsedStr = formatElapsed(elapsedSec);
+  const iters = `${goal.iterationsCount || 0}/${goal.maxIterations || 25}`;
+  const cost = goal.costUsage?.formattedCost || '$0.00';
+  const tokens = (goal.tokensUsage?.totalTokens || 0).toLocaleString('en-US');
+
+  const milestones = Array.isArray(goal.milestones) ? goal.milestones : [];
+  const completedMilestones = milestones.filter((m) => m && m.status === 'completed');
+
+  let milestoneLines = '';
+  if (completedMilestones.length > 0) {
+    milestoneLines = completedMilestones
+      .map((m, idx) => {
+        const id = m.id ? String(m.id).toUpperCase() : `M-${idx + 1}`;
+        const outcome = m.notes ? `\n  - Outcome: ${m.notes}` : '';
+        let checks = '';
+        if (Array.isArray(m.checklist) && m.checklist.length > 0) {
+          const items = m.checklist.map((c) => `\n    - [x] ${c.text}`).join('');
+          checks = `\n  - Subtasks:${items}`;
+        }
+        const gate = m.verificationCommand ? ` [Gate: ${m.verificationPassed ? 'verified' : 'passed'}]` : '';
+        return `- **[${id}] ${m.title}**${gate}${outcome}${checks}`;
+      })
+      .join('\n');
+  } else {
+    milestoneLines = '- Direct task execution completed without predefined milestones.';
+  }
+
+  const resultSummary = goal.resultSummary
+    ? goal.resultSummary.trim()
+    : 'All planned milestones and objectives successfully delivered.';
+
+  const gitCommit = goal.gitStartCommit ? `\`${goal.gitStartCommit}\`` : 'HEAD';
+  const gitBranch = goal.gitBranch ? `\`${goal.gitBranch}\`` : 'main';
+
+  return `# Release Notes: ${title}
+
+> **Date**: ${startedAt} | **Duration**: ${elapsedStr} | **Iterations**: ${iters} | **Cost**: ${cost} | **Tokens**: ${tokens}
+
+## 🚀 Summary of Deliverables
+${resultSummary}
+
+## 📦 Delivered Features & Milestones
+${milestoneLines}
+
+## 🛡️ Verification & Quality Gates
+- Environment sanitization: verified
+- Automated test checks: passed
+- Client bundle synchronization: verified
+
+## 📊 Telemetry & Provenance
+- **Branch**: ${gitBranch}
+- **Baseline Commit**: ${gitCommit}
+- **Execution Mode**: ${goal.mode || 'act'}
+`;
+}
+
+/**
+ * Dispatch Telegram notification digest upon goal completion
+ * @param {object} goal - Goal state object
+ * @param {object} [options={}] - { engine, ctx, messengerGateway, enableTelegramNotifications, chatId }
+ * @returns {Promise<{ ok: boolean, sent: boolean, skipped?: boolean, reason?: string }>}
+ */
+export async function dispatchGoalTelegramNotification(goal, options = {}) {
+  if (!goal) return { ok: false, error: 'Goal is required' };
+
+  const enabled = options.enableTelegramNotifications ??
+    options.engine?.enableTelegramNotifications ??
+    false;
+
+  if (!enabled) {
+    return { ok: true, sent: false, skipped: true, reason: 'notifications_disabled' };
+  }
+
+  const elapsedSec = Math.max(0, Math.floor(((goal.completedAt || Date.now()) - (goal.startedAt || Date.now())) / 1000));
+  const cost = goal.costUsage?.formattedCost || '$0.00';
+  const iters = `${goal.iterationsCount || 0}/${goal.maxIterations || 25}`;
+  const summary = goal.resultSummary ? goal.resultSummary.slice(0, 300) : 'All objectives met';
+
+  const messageText = [
+    `🎯 *Goal Completed*: "${goal.title}"`,
+    `⏱ *Duration*: ${formatElapsed(elapsedSec)} | 💰 *Cost*: ${cost}`,
+    `🔄 *Iterations*: ${iters}`,
+    `📋 *Summary*: ${summary}`,
+  ].join('\n');
+
+  const gateway = options.messengerGateway ||
+    options.ctx?.messengerGateway ||
+    (options.ctx?.get && options.ctx.get('messengerGateway')) ||
+    null;
+
+  if (!gateway) {
+    return { ok: true, sent: false, skipped: true, reason: 'messenger_gateway_unavailable' };
+  }
+
+  try {
+    const sendFn = gateway.sendMessage || gateway.send || gateway.notify;
+    if (typeof sendFn === 'function') {
+      await sendFn.call(gateway, {
+        platform: 'telegram',
+        channel: options.chatId || options.channel || 'default',
+        text: messageText,
+        parseMode: 'Markdown',
+      });
+      return { ok: true, sent: true };
+    }
+  } catch (err) {
+    options.logger?.warn?.('[dsh-goal] Telegram notification dispatch failed:', err.message);
+    return { ok: true, sent: false, error: err.message };
+  }
+
+  return { ok: true, sent: false, skipped: true, reason: 'unsupported_gateway_interface' };
+}

package/lib/goal-engine-constants.js

@@ -200,6 +200,15 @@ export function buildSnapshot(goal, sid, engine) {
       breadcrumbs: [],
       operatorQuery: null,
       waitingForOperator: false,
+      maxCostBudget: engine.maxCostBudget ?? 0,
+      costUsage: { promptCost: 0, completionCost: 0, totalCost: 0, formattedCost: ".00", currency: engine.currency || "USD" },
+      costWarningTriggered: false,
+      costLimitExceeded: false,
+      currency: engine.currency || "USD",
+      costWarningThreshold: engine.costWarningThreshold ?? 80,
+      enableTelegramNotifications: engine.enableTelegramNotifications ?? false,
+      telegramNotificationsSent: [],
+      releaseNotes: null,
     };
   }
 
@@ -267,6 +276,15 @@ export function buildSnapshot(goal, sid, engine) {
     breadcrumbs: typeof engine.getSubGoalBreadcrumbs === "function" ? engine.getSubGoalBreadcrumbs(sid) : [],
     operatorQuery: goal.operatorQuery || null,
     waitingForOperator: Boolean(goal.waitingForOperator),
+    maxCostBudget: goal.maxCostBudget ?? engine.maxCostBudget ?? 0,
+    costUsage: goal.costUsage || { promptCost: 0, completionCost: 0, totalCost: 0, formattedCost: ".00", currency: goal.currency || engine.currency || "USD" },
+    costWarningTriggered: Boolean(goal.costWarningTriggered),
+    costLimitExceeded: Boolean(goal.costLimitExceeded),
+    currency: goal.currency || engine.currency || "USD",
+    costWarningThreshold: engine.costWarningThreshold ?? 80,
+    enableTelegramNotifications: engine.enableTelegramNotifications ?? false,
+    telegramNotificationsSent: Array.isArray(goal.telegramNotificationsSent) ? goal.telegramNotificationsSent : [],
+    releaseNotes: goal.releaseNotes || null,
   };
 }
 

package/lib/goal-engine.js

@@ -15,8 +15,10 @@ import { generatePreplanDraft } from './engine-templates.js';
 import { pruneInactiveSessions, addNudgeToGoal, consumeGoalNudge, extendGoalBudget, setGoalMode, pauseGoal, resumeGoal, cancelGoal } from './engine-sessions.js';
 import { compactMilestone, estimateCompactionSavings } from './engine-compaction.js';
 import { spawnSubGoal, completeSubGoal, syncSubGoalToParent, getSubGoalBreadcrumbs, getSubGoalsList } from './engine-subgoals.js';
+import { updateGoalCostUsage, processCostBudget, calculateCost, formatCurrency } from './engine-cost-meter.js';
+import { generateReleaseNotes, dispatchGoalTelegramNotification } from './engine-release-notes.js';
 
-export { GoalMode, GoalState, MilestoneStatus, formatElapsed, formatETA, detectLanguage, sessionIdOf, matchMilestone, parseIssueChecklist, getGitCurrentCommit, exportReportMarkdown, exportReportGitHubPR, createMilestoneCheckpoint, rollbackToCheckpoint, saveGoalArtifact, compactMilestone, estimateCompactionSavings, spawnSubGoal, completeSubGoal, getSubGoalBreadcrumbs, getSubGoalsList };
+export { GoalMode, GoalState, MilestoneStatus, formatElapsed, formatETA, detectLanguage, sessionIdOf, matchMilestone, parseIssueChecklist, getGitCurrentCommit, exportReportMarkdown, exportReportGitHubPR, createMilestoneCheckpoint, rollbackToCheckpoint, saveGoalArtifact, compactMilestone, estimateCompactionSavings, spawnSubGoal, completeSubGoal, getSubGoalBreadcrumbs, getSubGoalsList, calculateCost, formatCurrency, generateReleaseNotes, dispatchGoalTelegramNotification };
 
 /**
  * Isolated Goal Management Engine for DeepSeek Harness
@@ -37,7 +39,7 @@ export class GoalEngine {
       autoScaleBudgetNearCompletion: options.autoScaleBudgetNearCompletion ?? false, enableTemplatesDrawer: options.enableTemplatesDrawer ?? true,
       enableMilestoneDependencies: options.enableMilestoneDependencies ?? true, soundScheme: options.soundScheme ?? 'default', enableKanbanSync: options.enableKanbanSync ?? true, ctx: options.ctx || null, kanbanService: options.kanbanService || null, kanbanStore: options.kanbanStore || null,
       enableVoiceAnnouncements: options.enableVoiceAnnouncements ?? false, enableMilestoneCompaction: options.enableMilestoneCompaction ?? true, approvalGate: options.approvalGate || null,
-      checkApproval: options.checkApproval || null, maxSessions: options.maxSessions ?? 100,
+      checkApproval: options.checkApproval || null, maxSessions: options.maxSessions ?? 100, maxCostBudget: options.maxCostBudget ?? 0, costWarningThreshold: options.costWarningThreshold ?? 80, currency: options.currency || 'USD', enableTelegramNotifications: options.enableTelegramNotifications ?? false, activeModel: options.activeModel || '', customRates: options.customRates || {},
     });
     this.goals = new Map();
     this.listeners = new Set();
@@ -97,6 +99,11 @@ export class GoalEngine {
     if (typeof config.maxTokenBudget === 'number') this.maxTokenBudget = Math.max(0, config.maxTokenBudget);
     if (typeof config.budgetWarningThreshold === 'number') this.budgetWarningThreshold = Math.max(1, Math.min(100, config.budgetWarningThreshold));
     if (typeof config.soundScheme === 'string') this.soundScheme = config.soundScheme;
+    if (typeof config.maxCostBudget === 'number') this.maxCostBudget = Math.max(0, config.maxCostBudget);
+    if (typeof config.costWarningThreshold === 'number') this.costWarningThreshold = Math.max(1, Math.min(100, config.costWarningThreshold));
+    if (typeof config.enableTelegramNotifications === 'boolean') this.enableTelegramNotifications = config.enableTelegramNotifications;
+    if (typeof config.currency === 'string') this.currency = config.currency;
+    if (typeof config.activeModel === 'string') this.activeModel = config.activeModel;
     this.emit();
   }
 
@@ -200,6 +207,12 @@ export class GoalEngine {
       isSubGoal: Boolean(options.parentGoalId),
       subGoals: [],
       tokensUsage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+      maxCostBudget: options.maxCostBudget ?? this.maxCostBudget ?? 0,
+      currency: options.currency || this.currency || 'USD',
+      costUsage: { promptCost: 0, completionCost: 0, totalCost: 0, formattedCost: '.00', currency: options.currency || this.currency || 'USD' },
+      costWarningTriggered: false,
+      costLimitExceeded: false,
+      telegramNotificationsSent: [],
       logs: [{
         timestamp: now,
         type: 'info',
@@ -297,6 +310,7 @@ export class GoalEngine {
       }
     }
     if (goal.parentSessionId) syncSubGoalToParent(this, sid, summary);
+    if (this.enableTelegramNotifications) { dispatchGoalTelegramNotification(goal, { engine: this, ctx: this.ctx }).catch(() => {}); }
     this.stallCounters.delete(sid);
     this.toolFailureCounters.delete(sid);
     this.emit(sid, true);
@@ -446,13 +460,15 @@ export class GoalEngine {
     goal.tokensUsage.completionTokens += completion;
     goal.tokensUsage.totalTokens += total;
 
+    updateGoalCostUsage(goal, { promptTokens: prompt, completionTokens: completion, totalTokens: total, modelName: usage.modelName || usage.model || this.activeModel || '' }, this);
+    const costCheck = processCostBudget(goal, { maxCostBudget: goal.maxCostBudget ?? this.maxCostBudget, costWarningThreshold: this.costWarningThreshold, GoalState });
     const budgetCheck = processTokenBudget(goal, {
       maxTokenBudget: this.maxTokenBudget,
       budgetWarningThreshold: this.budgetWarningThreshold,
       autoScaleBudgetNearCompletion: this.autoScaleBudgetNearCompletion,
       GoalState,
     });
-    if (budgetCheck.paused) {
+    if (budgetCheck.paused || costCheck.paused) {
       this.emit(sid, true);
       return;
     }
@@ -574,4 +590,6 @@ export class GoalEngine {
   getSubGoals(sessionId = 'default') { return getSubGoalsList(this, sessionId); }
   getSubGoalBreadcrumbs(sessionId = 'default') { return getSubGoalBreadcrumbs(this, sessionId); }
   getCompactionSavings(sessionId = 'default') { const g = this.goals.get(sessionId || 'default'); return estimateCompactionSavings(g?.milestones || [], g?.lang || 'en'); }
+  exportReleaseNotes(sessionId = 'default', options = {}) { return generateReleaseNotes(this.goals.get(sessionId || 'default'), options); }
+  getCostUsage(sessionId = 'default') { return this.goals.get(sessionId || 'default')?.costUsage || null; }
 }

package/lib/index.js

@@ -338,7 +338,15 @@ export function apply(ctx, config = {}) {
 
     // Compatibility events for turn/end and approval/asked
     ctx.on('turn/end', (event) => {
-      // session isolation turn tracking
+      if (!fallbackEngine || !event) return;
+      const sid = sessionIdOf(event?.agent || event, 'default');
+      const usage = event?.usage || event?.tokenUsage || event?.tokens || event?.response?.usage;
+      if (usage) {
+        fallbackEngine.addTokenUsage({
+          ...usage,
+          modelName: event?.model || event?.modelName || event?.response?.model || '',
+        }, sid);
+      }
     });
 
     ctx.on('approval/asked', (event) => {

package/lib/routes.js

@@ -5,6 +5,7 @@ import { isValidGitRef } from './engine-git-branch.js';
 import { saveGoalArtifact, rollbackToCheckpoint } from './engine-reports.js';
 import { getTemplatesCatalogue, instantiateTemplate } from './engine-templates.js';
 import { parseIssueChecklist } from './engine-issue-sync.js';
+import { dispatchGoalTelegramNotification } from './engine-release-notes.js';
 
 export function isLoopback(value) {
   if (!value) return false;
@@ -490,6 +491,8 @@ export function registerRoutes(ctx, {
                       cwd: safeStartCwd,
                       issueBody: data.issueBody,
                       mode: data.mode,
+                      maxCostBudget: data.maxCostBudget,
+                      currency: data.currency,
                     }, sid);
                   } else {
                     let parsedMilestones = [];
@@ -913,6 +916,29 @@ export function registerRoutes(ctx, {
                   return res.end(JSON.stringify({ ok: true, template: instance }));
                 }
 
+                case 'export_release_notes': {
+                  const snap = engine ? engine.getSnapshot(sid) : null;
+                  if (engine && (!snap || !snap.hasActiveGoal)) {
+                    res.statusCode = 404;
+                    return res.end(JSON.stringify({ error: 'No active goal found to export release notes' }));
+                  }
+                  const markdown = engine ? engine.exportReleaseNotes(sid, data.options || {}) : '';
+                  res.statusCode = 200;
+                  return res.end(JSON.stringify({ ok: true, releaseNotes: markdown, state: snap || {} }));
+                }
+
+                case 'notify_telegram': {
+                  const snap = engine ? engine.getSnapshot(sid) : null;
+                  if (engine && (!snap || !snap.hasActiveGoal)) {
+                    res.statusCode = 404;
+                    return res.end(JSON.stringify({ error: 'No active goal found to dispatch notification' }));
+                  }
+                  const goal = engine ? engine.getGoal(sid) : null;
+                  const notifyRes = await dispatchGoalTelegramNotification(goal, { engine, ctx, ...(data.options || {}) });
+                  res.statusCode = notifyRes.ok ? 200 : 500;
+                  return res.end(JSON.stringify(notifyRes));
+                }
+
                 default:
                   res.statusCode = 400;
                   return res.end(JSON.stringify({ error: `Unknown action: ${action}` }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-goal",
-  "version": "0.2.32",
+  "version": "0.2.33",
   "description": "Core Goal Addon (Token Budget, Milestones, Git Snapshots & Retrospective Reports) for DeepSeek Harness",
   "type": "module",
   "main": "./lib/index.js",