neohive 6.2.1 → 6.3.0

package/tools/governance.js

@@ -117,7 +117,7 @@ module.exports = function (ctx) {
 
     broadcastSystemMessage(`[REVIEW] ${state.registeredName} requests review of "${review.file}": ${review.description || 'No description'}. Call submit_review("${review.id}", "approved"/"changes_requested", "your feedback") to review.`, state.registeredName);
     touchActivity();
-    return { success: true, review_id: review.id, file: review.file, message: 'Review requested. Team has been notified.' };
+    return { success: true, review_id: review.id, file: review.file, next_action: 'Call listen() to wait for the review.' };
   }
 
   function toolSubmitReview(reviewId, status, feedback) {
@@ -191,7 +191,10 @@ module.exports = function (ctx) {
     writeJsonFile(REVIEWS_FILE, reviews);
     touchActivity();
 
-    const result = { success: true, review_id: reviewId, status: review.status, message: `Review submitted: ${review.status}` };
+    const reviewNextAction = review.status === 'approved'
+      ? 'Call listen() to continue.'
+      : 'Call listen() — the author will fix and resubmit.';
+    const result = { success: true, review_id: reviewId, status: review.status, next_action: reviewNextAction };
     if (review.review_round) result.review_round = review.review_round;
     if (review.auto_approved) result.auto_approved = true;
     return result;

package/tools/knowledge.js

@@ -132,7 +132,7 @@ module.exports = function (ctx) {
       total_messages: compressed.segments.reduce((s, seg) => s + seg.message_count, 0) + recent.length,
       compressed_count: compressed.segments.reduce((s, seg) => s + seg.message_count, 0),
       recent_count: recent.length,
-      hint: 'Compressed segments summarize older messages. Recent messages are shown verbatim.',
+      next_action: 'Call listen() to receive messages.',
     };
   }
 
@@ -223,9 +223,9 @@ module.exports = function (ctx) {
       progress,
       your_tasks: myActiveTasks.map(t => ({ id: t.id, title: t.title, status: t.status })),
       your_completed: myCompletedCount,
-      hint: myActiveTasks.length > 0
-        ? `You have ${myActiveTasks.length} active task(s). Continue working.`
-        : 'You are now briefed. Check active tasks and start contributing.',
+      next_action: myActiveTasks.length > 0
+        ? `You have ${myActiveTasks.length} active task(s). Continue working, then call listen().`
+        : 'Call listen() to receive messages and start working.',
     };
   }
 

package/tools/messaging.js

@@ -56,7 +56,7 @@ module.exports = function (ctx) {
       result.preview = `${latest.from}: "${latest.content.substring(0, 80).replace(/\n/g, ' ')}..."`;
       const oldestAge = Math.round((Date.now() - new Date(unconsumed[0].timestamp).getTime()) / 1000);
       result.urgency = oldestAge > 120 ? 'critical' : oldestAge > 30 ? 'urgent' : 'normal';
-      result.action_required = 'You have unread messages. Call listen() to receive and process them. Do NOT call check_messages() again — it does not consume messages and you will see the same messages repeatedly.';
+      result.next_action = 'Call listen() to receive and process these messages.';
     }
 
     return result;

package/tools/safety.js

@@ -34,7 +34,7 @@ module.exports = function (ctx) {
     locks[normalized] = { agent: state.registeredName, since: new Date().toISOString() };
     writeJsonFile(LOCKS_FILE, locks);
     touchActivity();
-    return { success: true, file: normalized, message: `File locked. Other agents cannot edit "${normalized}" until you call unlock_file().` };
+    return { success: true, file: normalized, next_action: 'Edit the file, then call unlock_file() when done.' };
   }
 
   function toolUnlockFile(filePath) {

package/tools/tasks.js

@@ -81,7 +81,7 @@ module.exports = function (ctx) {
     saveTasks(tasks);
     touchActivity();
 
-    const result = { success: true, task_id: task.id, assignee: task.assignee };
+    const result = { success: true, task_id: task.id, assignee: task.assignee, next_action: 'Call listen() to receive updates.' };
     if (taskChannel) result.channel = taskChannel;
     return result;
   }
@@ -160,6 +160,7 @@ module.exports = function (ctx) {
             task_id: task.id,
             status: 'in_review',
             review_id: reviewId,
+            next_action: 'Call listen() to wait for the reviewer to approve.',
             message: `Cannot mark done — a reviewer is online and no approval exists. Review ${reviewId} auto-created. Wait for approval, then try again.`,
           };
         }
@@ -291,7 +292,11 @@ module.exports = function (ctx) {
       for (const n of notifications) { helpers.sendSystemMessage(n.agent, n.message); }
     } catch (e) { /* hooks not available */ }
 
-    return { success: true, task_id: task.id, status: task.status, title: task.title };
+    const nextAction = status === 'done' ? 'Send a summary of what you did via send_message(), then call listen().'
+      : status === 'in_progress' ? `Do the work on "${task.title}", then call update_task("${task.id}", "done") when finished.`
+      : status === 'blocked' ? 'Send a message explaining the blocker, then call listen().'
+      : 'Call listen() to receive updates.';
+    return { success: true, task_id: task.id, status: task.status, title: task.title, next_action: nextAction };
   }
 
   // --- List Tasks ---

package/tools/workflows.js

@@ -102,7 +102,7 @@ module.exports = function (ctx) {
       autonomous,
       parallel,
       started_steps: startedSteps.map(s => ({ id: s.id, description: s.description, assignee: s.assignee })),
-      message: autonomous ? 'Autonomous workflow created. All agents should call get_work() to enter the proactive work loop.' : undefined,
+      next_action: autonomous ? 'Call get_work() for your assignment.' : 'Call listen() to receive updates.',
     };
   }
 
@@ -179,6 +179,7 @@ module.exports = function (ctx) {
       next_steps: nextSteps.length > 0 ? nextSteps.map(s => ({ id: s.id, description: s.description, assignee: s.assignee })) : null,
       progress: `${doneCount}/${wf.steps.length} (${pct}%)`,
       workflow_status: wf.status,
+      next_action: wf.autonomous ? 'Call get_work() for your next assignment.' : 'Call listen() to receive the next step.',
     };
   }