@goodandready/dsh-goal 0.2.5 → 0.2.7

package/lib/goal-engine.js

@@ -1,10 +1,11 @@
-import { GoalState, MilestoneStatus, formatElapsed, formatETA, detectLanguage, sessionIdOf } from './goal-engine-constants.js';
-import { getGitCurrentCommit, exportReportMarkdown, exportReportGitHubPR } from './engine-reports.js';
+import { GoalState, MilestoneStatus, formatElapsed, formatETA, detectLanguage, sessionIdOf, calculateElapsedSeconds, calculateRemainingSeconds, buildSnapshot } from './goal-engine-constants.js';
+import { getGitCurrentCommit, exportReportMarkdown, exportReportGitHubPR, createMilestoneCheckpoint, rollbackToCheckpoint, saveGoalArtifact } from './engine-reports.js';
 import { EngineStore } from './engine-store.js';
 import { buildStatePromptInjection } from './engine-prompt.js';
+import { matchMilestone, parseMilestoneItems, applyMilestoneUpdate, toggleMilestoneChecklistItem } from './engine-milestones.js';
 
-export { GoalState, MilestoneStatus, formatElapsed, formatETA, detectLanguage, sessionIdOf };
-export { getGitCurrentCommit, exportReportMarkdown, exportReportGitHubPR };
+export { GoalState, MilestoneStatus, formatElapsed, formatETA, detectLanguage, sessionIdOf, matchMilestone };
+export { getGitCurrentCommit, exportReportMarkdown, exportReportGitHubPR, createMilestoneCheckpoint, rollbackToCheckpoint, saveGoalArtifact };
 
 /**
  * Isolated Goal Management Engine for DeepSeek Harness
@@ -16,6 +17,9 @@ export class GoalEngine {
     this.enableSound = options.enableSound ?? true;
     this.showQuickLaunchButton = options.showQuickLaunchButton ?? true;
     this.consecutiveToolFailureLimit = options.consecutiveToolFailureLimit ?? 3;
+    this.maxTokenBudget = options.maxTokenBudget ?? 0;
+    this.budgetWarningThreshold = options.budgetWarningThreshold ?? 80;
+    this.autoCheckpointOnMilestone = options.autoCheckpointOnMilestone ?? false;
     this.maxSessions = options.maxSessions ?? 100;
     this.goals = new Map();
     this.listeners = new Set();
@@ -99,6 +103,15 @@ export class GoalEngine {
     if (typeof config.consecutiveToolFailureLimit === 'number') {
       this.consecutiveToolFailureLimit = Math.max(0, config.consecutiveToolFailureLimit);
     }
+    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.autoCheckpointOnMilestone === 'boolean') {
+      this.autoCheckpointOnMilestone = config.autoCheckpointOnMilestone;
+    }
     this.emit();
   }
 
@@ -175,6 +188,7 @@ export class GoalEngine {
       const oldest = inactive.shift();
       this.goals.delete(oldest.sid);
       this.stallCounters.delete(oldest.sid);
+      this.toolFailureCounters.delete(oldest.sid);
     }
   }
 
@@ -218,6 +232,8 @@ export class GoalEngine {
       completedAt: null,
       iterationsCount: 0,
       maxIterations: options.maxIterations ?? this.defaultMaxIterations,
+      maxTokenBudget: options.maxTokenBudget ?? this.maxTokenBudget,
+      budgetWarningTriggered: false,
       gitStartCommit: gitCommit || null,
       pendingNudge: null,
       nudges: [],
@@ -321,6 +337,7 @@ export class GoalEngine {
     const sid = sessionId || 'default';
     this.goals.delete(sid);
     this.stallCounters.delete(sid);
+    this.toolFailureCounters.delete(sid);
     this.emit(sid, true);
     return this.getSnapshot(sid);
   }
@@ -351,6 +368,7 @@ export class GoalEngine {
     }
 
     this.stallCounters.delete(sid);
+    this.toolFailureCounters.delete(sid);
     this.emit(sid, true);
     return this.getSnapshot(sid);
   }
@@ -360,36 +378,40 @@ export class GoalEngine {
     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 : '',
-      });
-    }
+    const newItems = parseMilestoneItems(milestonesList, goal.milestones.length);
+    goal.milestones.push(...newItems);
 
     this.recordProgress(sid);
     if (shouldEmit) this.emit(sid);
   }
 
-  updateMilestone(id, status, notes = '', sessionId = 'default') {
+  updateMilestone(id, status, notes = '', sessionId = 'default', checklist = null) {
     const sid = sessionId || 'default';
     const goal = this.goals.get(sid);
     if (!goal) return false;
 
-    const target = goal.milestones.find((m) => m.id === String(id));
+    const target = goal.milestones.find((m) => matchMilestone(m, id));
     if (!target) return false;
 
-    if (status && Object.values(MilestoneStatus).includes(status)) {
-      target.status = status;
-    }
-    if (notes) {
-      target.notes = String(notes);
+    const { prevStatus } = applyMilestoneUpdate(
+      target,
+      status,
+      notes,
+      checklist,
+      Object.values(MilestoneStatus)
+    );
+
+    // Auto Git Checkpoint on milestone completion
+    if (target.status === MilestoneStatus.COMPLETED && prevStatus !== MilestoneStatus.COMPLETED && this.autoCheckpointOnMilestone) {
+      const commitHash = createMilestoneCheckpoint(target, sid);
+      if (commitHash) {
+        target.checkpointCommit = commitHash;
+        goal.logs.push({
+          timestamp: Date.now(),
+          type: 'info',
+          message: `Git checkpoint saved for [${target.title}]: ${commitHash}`,
+        });
+      }
     }
 
     goal.logs.push({
@@ -407,6 +429,48 @@ export class GoalEngine {
     return true;
   }
 
+  toggleChecklistItem(milestoneId, itemIndex, done, sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal) return false;
+
+    const target = goal.milestones.find((m) => matchMilestone(m, milestoneId));
+    const ok = toggleMilestoneChecklistItem(target, itemIndex, done);
+    if (!ok) return false;
+
+    this.recordProgress(sid);
+    this.emit(sid);
+    return true;
+  }
+
+  extendBudget(addTokens = 50000, sessionId = 'default') {
+    const sid = sessionId || 'default';
+    const goal = this.goals.get(sid);
+    if (!goal) return false;
+
+    const currentTotal = goal.tokensUsage?.totalTokens || 0;
+    const currentMax = goal.maxTokenBudget || this.maxTokenBudget || 0;
+    const newBudget = Math.max(currentTotal, currentMax) + Math.max(1000, Number(addTokens) || 50000);
+
+    goal.maxTokenBudget = newBudget;
+    goal.budgetWarningTriggered = false;
+
+    if (goal.state === GoalState.PAUSED && goal.logs?.some((l) => l.message?.includes('Token budget reached'))) {
+      goal.state = GoalState.RUNNING;
+      goal.pausedAt = null;
+    }
+
+    goal.logs.push({
+      timestamp: Date.now(),
+      type: 'info',
+      message: `Token budget extended to ${newBudget.toLocaleString('en-US')} tokens`,
+    });
+    if (goal.logs.length > 100) goal.logs = goal.logs.slice(-100);
+
+    this.emit(sid, true);
+    return true;
+  }
+
   incrementIteration(sessionId = 'default') {
     const sid = sessionId || 'default';
     const goal = this.goals.get(sid);
@@ -435,13 +499,7 @@ export class GoalEngine {
   }
 
   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);
+    return calculateElapsedSeconds(this.goals.get(sessionId || 'default'));
   }
 
   addTokenUsage(usage, sessionId = 'default') {
@@ -462,98 +520,48 @@ export class GoalEngine {
     goal.tokensUsage.completionTokens += completion;
     goal.tokensUsage.totalTokens += total;
 
+    // Token Budget Guard Check
+    const budget = goal.maxTokenBudget || this.maxTokenBudget || 0;
+    if (budget > 0) {
+      const currentTotal = goal.tokensUsage.totalTokens;
+      const warnThreshold = (budget * (this.budgetWarningThreshold || 80)) / 100;
+
+      if (currentTotal >= warnThreshold && !goal.budgetWarningTriggered) {
+        goal.budgetWarningTriggered = true;
+        goal.logs.push({
+          timestamp: Date.now(),
+          type: 'warning',
+          message: `Token budget warning: ${currentTotal.toLocaleString('en-US')}/${budget.toLocaleString('en-US')} tokens consumed (${Math.round((currentTotal / budget) * 100)}%)`,
+        });
+        if (goal.logs.length > 100) goal.logs = goal.logs.slice(-100);
+      }
+
+      if (currentTotal >= budget && goal.state === GoalState.RUNNING) {
+        goal.state = GoalState.PAUSED;
+        goal.pausedAt = Date.now();
+        goal.logs.push({
+          timestamp: Date.now(),
+          type: 'warning',
+          message: `Token budget reached: ${currentTotal.toLocaleString('en-US')}/${budget.toLocaleString('en-US')} tokens. Pausing autonomous loop.`,
+        });
+        if (goal.logs.length > 100) goal.logs = goal.logs.slice(-100);
+        this.emit(sid, true);
+        return;
+      }
+    }
+
     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));
+    return calculateRemainingSeconds(goal, this.getElapsedSeconds(sid));
   }
 
   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,
-    };
+    return buildSnapshot(this.goals.get(sid), sid, this);
   }
 
   getGoalSnapshot(sessionId = 'default') {

package/lib/index.js

@@ -19,6 +19,9 @@ export const Config = z.object({
   showQuickLaunchButton: z.boolean().default(true).description('Show quick launch goal button above composer dock'),
   consecutiveToolFailureLimit: z.number().default(3).description('Auto-pause goal if N consecutive turns encounter tool execution errors (0 to disable)'),
   enableBrowserNotifications: z.boolean().default(true).description('Show desktop notifications on goal completion or failure'),
+  maxTokenBudget: z.number().default(0).description('Maximum token budget per goal session (0 to disable)'),
+  budgetWarningThreshold: z.number().default(80).description('Percentage of token budget consumed before model warning injection (e.g. 80)'),
+  autoCheckpointOnMilestone: z.boolean().default(false).description('Automatically create git commit checkpoint upon milestone completion'),
   storagePath: z.string().default('').description('Custom filesystem path for persistent state storage'),
 });
 
@@ -37,6 +40,9 @@ export function apply(ctx, config = {}) {
     showQuickLaunchButton: config?.showQuickLaunchButton ?? true,
     consecutiveToolFailureLimit: config?.consecutiveToolFailureLimit ?? 3,
     enableBrowserNotifications: config?.enableBrowserNotifications ?? true,
+    maxTokenBudget: config?.maxTokenBudget ?? 0,
+    budgetWarningThreshold: config?.budgetWarningThreshold ?? 80,
+    autoCheckpointOnMilestone: config?.autoCheckpointOnMilestone ?? false,
     storagePath: config?.storagePath,
   };
 
@@ -51,6 +57,9 @@ export function apply(ctx, config = {}) {
     enableSound: currentSettings.enableSound,
     showQuickLaunchButton: currentSettings.showQuickLaunchButton,
     consecutiveToolFailureLimit: currentSettings.consecutiveToolFailureLimit,
+    maxTokenBudget: currentSettings.maxTokenBudget,
+    budgetWarningThreshold: currentSettings.budgetWarningThreshold,
+    autoCheckpointOnMilestone: currentSettings.autoCheckpointOnMilestone,
     storagePath,
   });
 
@@ -177,6 +186,9 @@ export function apply(ctx, config = {}) {
               showQuickLaunchButton: typeof live.showQuickLaunchButton === 'boolean' ? live.showQuickLaunchButton : currentSettings.showQuickLaunchButton,
               consecutiveToolFailureLimit: typeof live.consecutiveToolFailureLimit === 'number' ? live.consecutiveToolFailureLimit : currentSettings.consecutiveToolFailureLimit,
               enableBrowserNotifications: typeof live.enableBrowserNotifications === 'boolean' ? live.enableBrowserNotifications : currentSettings.enableBrowserNotifications,
+              maxTokenBudget: typeof live.maxTokenBudget === 'number' ? live.maxTokenBudget : currentSettings.maxTokenBudget,
+              budgetWarningThreshold: typeof live.budgetWarningThreshold === 'number' ? live.budgetWarningThreshold : currentSettings.budgetWarningThreshold,
+              autoCheckpointOnMilestone: typeof live.autoCheckpointOnMilestone === 'boolean' ? live.autoCheckpointOnMilestone : currentSettings.autoCheckpointOnMilestone,
               storagePath: typeof live.storagePath === 'string' ? live.storagePath : currentSettings.storagePath,
             };
           }
@@ -205,6 +217,9 @@ export function apply(ctx, config = {}) {
       enableSound: live.enableSound,
       showQuickLaunchButton: live.showQuickLaunchButton,
       consecutiveToolFailureLimit: live.consecutiveToolFailureLimit,
+      maxTokenBudget: live.maxTokenBudget,
+      budgetWarningThreshold: live.budgetWarningThreshold,
+      autoCheckpointOnMilestone: live.autoCheckpointOnMilestone,
     });
   };
 

package/lib/routes.js

@@ -1,4 +1,23 @@
+import fs from 'node:fs';
+import path from 'node:path';
 import { MilestoneStatus, detectLanguage, sessionIdOf } from './goal-engine-constants.js';
+import { saveGoalArtifact, rollbackToCheckpoint } from './engine-reports.js';
+
+function getSafeCwd(requestedCwd) {
+  if (!requestedCwd || typeof requestedCwd !== 'string') {
+    return process.cwd();
+  }
+  try {
+    const resolved = path.resolve(requestedCwd.trim());
+    const st = fs.statSync(resolved);
+    if (!st.isDirectory()) {
+      return null;
+    }
+    return resolved;
+  } catch (err) {
+    return null;
+  }
+}
 
 /**
  * Register webServer HTTP routes and SSE stream for DSH Goal
@@ -247,7 +266,7 @@ export function registerRoutes(ctx, {
                     res.statusCode = 400;
                     return res.end(JSON.stringify({ error: `Invalid status: ${status}. Must be one of: ${validStatuses.join(', ')}` }));
                   }
-                  const ok = engine.updateMilestone(milestoneId, status, notes, sid);
+                  const ok = engine.updateMilestone(milestoneId, status, notes, sid, data.checklist);
                   if (!ok) {
                     res.statusCode = 404;
                     return res.end(JSON.stringify({ error: `Milestone with id "${milestoneId}" not found` }));
@@ -256,6 +275,74 @@ export function registerRoutes(ctx, {
                   break;
                 }
 
+                case 'toggle_checklist_item': {
+                  if (!milestoneId || data.itemIndex === undefined) {
+                    res.statusCode = 400;
+                    return res.end(JSON.stringify({ error: 'milestoneId and itemIndex are required' }));
+                  }
+                  const ok = engine.toggleChecklistItem(milestoneId, data.itemIndex, data.done, sid);
+                  if (!ok) {
+                    res.statusCode = 404;
+                    return res.end(JSON.stringify({ error: `Milestone checklist item not found` }));
+                  }
+                  result = engine.getSnapshot(sid);
+                  break;
+                }
+
+                case 'extend_budget': {
+                  const addTokens = data.addTokens || 50000;
+                  const ok = engine.extendBudget(addTokens, sid);
+                  if (!ok) {
+                    res.statusCode = 404;
+                    return res.end(JSON.stringify({ error: 'No active goal found to extend budget' }));
+                  }
+                  if (typeof resumeActiveAgent === 'function') {
+                    resumeActiveAgent(undefined, sid);
+                  }
+                  result = engine.getSnapshot(sid);
+                  break;
+                }
+
+                case 'rollback_milestone': {
+                  const commit = data.commit || data.checkpointCommit;
+                  if (!commit) {
+                    res.statusCode = 400;
+                    return res.end(JSON.stringify({ error: 'commit hash is required for rollback' }));
+                  }
+                  const safeCwd = getSafeCwd(data.cwd);
+                  if (data.cwd && !safeCwd) {
+                    res.statusCode = 400;
+                    return res.end(JSON.stringify({ error: 'Invalid or non-existent working directory' }));
+                  }
+                  const ok = rollbackToCheckpoint(commit, safeCwd);
+                  if (!ok) {
+                    res.statusCode = 500;
+                    return res.end(JSON.stringify({ error: `Failed to rollback to checkpoint ${commit}` }));
+                  }
+                  result = engine.getSnapshot(sid);
+                  break;
+                }
+
+                case 'save_artifact': {
+                  const snap = engine.getSnapshot(sid);
+                  if (!snap || !snap.hasActiveGoal) {
+                    res.statusCode = 404;
+                    return res.end(JSON.stringify({ error: 'No active goal to save artifact for' }));
+                  }
+                  const safeCwd = getSafeCwd(data.cwd);
+                  if (data.cwd && !safeCwd) {
+                    res.statusCode = 400;
+                    return res.end(JSON.stringify({ error: 'Invalid or non-existent working directory' }));
+                  }
+                  const artifact = saveGoalArtifact(snap, safeCwd);
+                  if (!artifact) {
+                    res.statusCode = 500;
+                    return res.end(JSON.stringify({ error: 'Failed to write goal artifact to disk' }));
+                  }
+                  res.statusCode = 200;
+                  return res.end(JSON.stringify({ ok: true, artifact, state: snap }));
+                }
+
                 default:
                   res.statusCode = 400;
                   return res.end(JSON.stringify({ error: `Unknown action: ${action}` }));

package/lib/tools.js

@@ -229,13 +229,17 @@ export function registerTools(ctx, { engine, resumeActiveAgent }) {
     });
 
     // Tool 5: goal_update_progress
-    const handleUpdateProgress = async ({ milestone_id, status, notes }, toolCtx) => {
+    const handleUpdateProgress = async ({ milestone_id, status, notes, checklist }, toolCtx) => {
       const sid = sessionIdOf(toolCtx, 'default');
-      const snap = engine.updateMilestone(milestone_id, status, notes, sid);
+      engine.updateMilestone(milestone_id, status, notes, sid, checklist);
+      const snap = engine.getSnapshot(sid);
+      const targetMilestone = snap.milestones?.find((m) => m.id === String(milestone_id) || m.id.toLowerCase().replace(/[^a-z0-9]/g, '') === String(milestone_id).toLowerCase().replace(/[^a-z0-9]/g, '') || m.id.toLowerCase().replace(/[^0-9]/g, '') === String(milestone_id).toLowerCase().replace(/[^0-9]/g, ''));
       return {
         success: true,
         milestone_id,
         status,
+        checklist: targetMilestone?.checklist || null,
+        checkpointCommit: targetMilestone?.checkpointCommit || null,
         total_milestones: snap.milestones?.length,
         completed: snap.milestones?.filter((m) => m.status === 'completed').length,
       };
@@ -243,7 +247,7 @@ export function registerTools(ctx, { engine, resumeActiveAgent }) {
 
     safeRegister({
       name: 'goal_update_progress',
-      description: 'Update the progress of a specific milestone.',
+      description: 'Update the progress of a specific milestone, optionally attaching a sub-tasks checklist.',
       parameters: {
         type: 'object',
         properties: {
@@ -254,6 +258,18 @@ export function registerTools(ctx, { engine, resumeActiveAgent }) {
             description: 'New milestone status',
           },
           notes: { type: 'string', description: 'Summary of actions completed or blocking issue' },
+          checklist: {
+            type: 'array',
+            items: {
+              type: 'object',
+              properties: {
+                text: { type: 'string', description: 'Checklist task item description' },
+                done: { type: 'boolean', description: 'Whether the item is completed' },
+              },
+              required: ['text', 'done'],
+            },
+            description: 'Optional sub-tasks / checklist items within this milestone',
+          },
         },
         required: ['milestone_id', 'status'],
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-goal",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Autonomous Goal Execution & Multi-Turn Task Tracking Engine with Sticky Header for DeepSeek Harness",
   "type": "module",
   "main": "./lib/index.js",