@yemi33/minions 0.1.666 → 0.1.667

package/CHANGELOG.md

@@ -1,6 +1,9 @@
 # Changelog
 
-## 0.1.666 (2026-04-09)
+## 0.1.667 (2026-04-09)
+
+### Features
+- show skip reason on work item row when dispatch is blocked (#628)
 
 ### Fixes
 -  write status marker to live output during steering resume gap

package/dashboard/js/render-work-items.js

@@ -49,6 +49,7 @@ function wiRow(item) {
     '<td>' + priBadge(item.priority) + '</td>' +
     '<td>' + statusBadge(item.status || 'pending') +
       (item._pendingReason && item.status === 'pending' ? ' <span style="font-size:9px;color:var(--muted);margin-left:4px" title="Pending reason: ' + escHtml(item._pendingReason) + '">' + escHtml(item._pendingReason.replace(/_/g, ' ')) + '</span>' : '') +
+      (item._skipReason && item.status === 'pending' ? ' <span style="font-size:9px;color:var(--yellow);margin-left:4px" title="Dispatch blocked: ' + escHtml(item._skipReason) + (item._blockedBy ? ' (by ' + escHtml(item._blockedBy) + ')' : '') + '">' + escHtml(item._skipReason.replace(/_/g, ' ')) + (item._blockedBy ? ' <span style="color:var(--muted)">(' + escHtml(item._blockedBy) + ')</span>' : '') + '</span>' : '') +
       (item.status === 'failed' ? ' ' + wiRetryBtn(item) : '') +
     '</td>' +
     '<td>' +
@@ -439,6 +440,7 @@ function openWorkItemDetail(id) {
   if (item.completedAt) html += field('Completed', escHtml(new Date(item.completedAt).toLocaleString()));
   if (item.failReason) html += field('Failure Reason', '<span style="color:var(--red)">' + escHtml(item.failReason) + '</span>');
   if (item._pendingReason && item.status === 'pending') html += field('Pending Reason', escHtml(item._pendingReason.replace(/_/g, ' ')));
+  if (item._skipReason && item.status === 'pending') html += field('Dispatch Blocked', '<span style="color:var(--yellow)">' + escHtml(item._skipReason.replace(/_/g, ' ')) + '</span>' + (item._blockedBy ? ' — blocked by <strong>' + escHtml(item._blockedBy) + '</strong>' : ''));
   if (item.depends_on?.length) html += field('Depends On', item.depends_on.map(d => '<code>' + escHtml(d) + '</code>').join(', '));
   if (item.acceptanceCriteria?.length) html += field('Acceptance Criteria', '<ul style="margin:0;padding-left:20px">' + item.acceptanceCriteria.map(c => '<li>' + escHtml(c) + '</li>').join('') + '</ul>');
   if (item.references?.length) html += field('References', item.references.map(r => '<a href="' + escHtml(r.url) + '" target="_blank" style="color:var(--blue)">' + escHtml(r.title || r.url) + '</a>' + (r.type ? ' <span style="color:var(--muted);font-size:10px">(' + escHtml(r.type) + ')</span>' : '')).join('<br>'));

package/dashboard.html

@@ -2792,6 +2792,7 @@ function wiRow(item) {
     '<td>' + priBadge(item.priority) + '</td>' +
     '<td>' + statusBadge(item.status || 'pending') +
       (item._pendingReason ? ' <span style="font-size:9px;color:var(--muted);margin-left:4px" title="Pending reason: ' + escHtml(item._pendingReason) + '">' + escHtml(item._pendingReason.replace(/_/g, ' ')) + '</span>' : '') +
+      (item._skipReason && item.status === 'pending' ? ' <span style="font-size:9px;color:var(--yellow);margin-left:4px" title="Dispatch blocked: ' + escHtml(item._skipReason) + (item._blockedBy ? ' (by ' + escHtml(item._blockedBy) + ')' : '') + '">' + escHtml(item._skipReason.replace(/_/g, ' ')) + (item._blockedBy ? ' <span style="color:var(--muted)">(' + escHtml(item._blockedBy) + ')</span>' : '') + '</span>' : '') +
       (item.status === 'failed' ? ' <button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--yellow);border-color:var(--yellow);margin-left:4px" onclick="event.stopPropagation();retryWorkItem(\'' + escHtml(item.id) + '\',\'' + escHtml(item._source || '') + '\')">Retry</button>' : '') +
     '</td>' +
     '<td>' +

package/engine/queries.js

@@ -656,6 +656,33 @@ function getWorkItems(config) {
     }
   }
 
+  // Cross-reference with dispatch pending entries to surface skipReason + blockedBy (#617)
+  const pendingByWiId = new Map();
+  for (const d of (dispatch.pending || [])) {
+    if (d.meta?.item?.id && d.skipReason) {
+      pendingByWiId.set(d.meta.item.id, d);
+    }
+  }
+  if (pendingByWiId.size > 0) {
+    // Build branch → active agent name map for blockedBy lookup
+    const branchToAgent = new Map();
+    for (const d of (dispatch.active || [])) {
+      if (d.meta?.branch) branchToAgent.set(d.meta.branch, d.agentName || d.agent || '');
+    }
+    for (const item of allItems) {
+      const pendingEntry = pendingByWiId.get(item.id);
+      if (!pendingEntry) continue;
+      item._skipReason = pendingEntry.skipReason;
+      if (pendingEntry.skipReason === 'branch_locked' && pendingEntry.meta?.branch) {
+        const blocker = branchToAgent.get(pendingEntry.meta.branch);
+        if (blocker) item._blockedBy = blocker;
+      } else if (pendingEntry.skipReason === 'agent_busy') {
+        const activeEntry = (dispatch.active || []).find(d => d.agent === pendingEntry.agent);
+        if (activeEntry) item._blockedBy = activeEntry.agentName || activeEntry.agent || '';
+      }
+    }
+  }
+
   // Cross-reference with PRs
   const allPrs = getPullRequests(config);
   for (const item of allItems) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.666",
+  "version": "0.1.667",
   "description": "Multi-agent AI dev team that runs from ~/.minions/ — five autonomous agents share a single engine, dashboard, and knowledge base",
   "bin": {
     "minions": "bin/minions.js"