@yemi33/minions 0.1.16 → 0.1.17

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.1.17 (2026-03-28)
+
+### Engine
+- engine.js
+
+### Dashboard
+- dashboard-build.js
+- dashboard.js
+- dashboard/js/refresh.js
+- dashboard/js/render-inbox.js
+- dashboard/js/render-kb.js
+- dashboard/js/render-pinned.js
+- dashboard/js/render-work-items.js
+- dashboard/pages/home.html
+- dashboard/pages/inbox.html
+
 ## 0.1.16 (2026-03-28)
 
 ### Dashboard

package/dashboard/js/refresh.js

@@ -38,6 +38,7 @@ async function refresh() {
     renderSkills(data.skills || []);
     renderMcpServers(data.mcpServers || []);
     renderSchedules(data.schedules || []);
+    renderPinned(data.pinned || []);
     // Update sidebar counts
     const swi = document.getElementById('sidebar-wi');
     if (swi) swi.textContent = (data.workItems || []).length || '';

package/dashboard/js/render-inbox.js

@@ -145,6 +145,36 @@ async function openInboxInExplorer(name) {
   } catch {}
 }
 
+function openQuickNoteModal() {
+  document.getElementById('modal-title').textContent = 'Quick Note';
+  document.getElementById('modal-body').innerHTML =
+    '<div style="display:flex;flex-direction:column;gap:12px">' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Title' +
+        '<input id="note-title" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text)" placeholder="Decision, observation, or context..."></label>' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Content' +
+        '<textarea id="note-content" rows="6" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text);resize:vertical;font-family:inherit" placeholder="Write your note... Agents will see this after consolidation."></textarea></label>' +
+      '<div style="display:flex;justify-content:flex-end;gap:8px">' +
+        '<button onclick="closeModal()" class="pr-pager-btn">Cancel</button>' +
+        '<button onclick="submitQuickNote()" style="padding:6px 16px;background:var(--blue);color:#fff;border:none;border-radius:var(--radius-sm);cursor:pointer">Save Note</button>' +
+      '</div>' +
+    '</div>';
+  document.getElementById('modal').classList.add('open');
+}
+
+async function submitQuickNote() {
+  const title = document.getElementById('note-title').value;
+  const content = document.getElementById('note-content').value;
+  if (!title && !content) { alert('Title or content required'); return; }
+  try {
+    const res = await fetch('/api/notes', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ title: title || 'Quick note', content: content || title })
+    });
+    if (res.ok) { closeModal(); refresh(); showToast('cmd-toast', 'Note saved to inbox', true); }
+    else { const d = await res.json(); alert('Error: ' + (d.error || 'unknown')); }
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
 async function doPromoteToKB(name, category) {
   try {
     const res = await fetch('/api/inbox/promote-kb', {

package/dashboard/js/render-kb.js

@@ -106,6 +106,45 @@ async function kbSweep() {
   setTimeout(() => { btn.textContent = origText; btn.style.color = 'var(--muted)'; btn.disabled = false; }, 3000);
 }
 
+function openCreateKbModal() {
+  document.getElementById('modal-title').textContent = 'New Knowledge Base Entry';
+  document.getElementById('modal-body').innerHTML =
+    '<div style="display:flex;flex-direction:column;gap:12px">' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Category' +
+        '<select id="kb-new-category" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text)">' +
+          '<option value="architecture">Architecture</option>' +
+          '<option value="conventions">Conventions</option>' +
+          '<option value="project-notes">Project Notes</option>' +
+          '<option value="build-reports">Build Reports</option>' +
+          '<option value="reviews">Reviews</option>' +
+        '</select></label>' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Title' +
+        '<input id="kb-new-title" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text)" placeholder="Entry title"></label>' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Content' +
+        '<textarea id="kb-new-content" rows="8" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text);resize:vertical;font-family:inherit" placeholder="Write your knowledge entry..."></textarea></label>' +
+      '<div style="display:flex;justify-content:flex-end;gap:8px">' +
+        '<button onclick="closeModal()" class="pr-pager-btn">Cancel</button>' +
+        '<button onclick="submitKbEntry()" style="padding:6px 16px;background:var(--blue);color:#fff;border:none;border-radius:var(--radius-sm);cursor:pointer">Save</button>' +
+      '</div>' +
+    '</div>';
+  document.getElementById('modal').classList.add('open');
+}
+
+async function submitKbEntry() {
+  const category = document.getElementById('kb-new-category').value;
+  const title = document.getElementById('kb-new-title').value;
+  const content = document.getElementById('kb-new-content').value;
+  if (!title || !content) { alert('Title and content are required'); return; }
+  try {
+    const res = await fetch('/api/knowledge', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ category, title, content })
+    });
+    if (res.ok) { closeModal(); refreshKnowledgeBase(); showToast('cmd-toast', 'KB entry created', true); }
+    else { const d = await res.json(); alert('Error: ' + (d.error || 'unknown')); }
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
 async function kbOpenItem(category, file) {
   try {
     const content = await fetch('/api/knowledge/' + category + '/' + encodeURIComponent(file)).then(r => r.text());

package/dashboard/js/render-pinned.js

@@ -0,0 +1,53 @@
+// dashboard/js/render-pinned.js — Pinned context notes rendering and management
+
+function renderPinned(entries) {
+  const el = document.getElementById('pinned-content');
+  if (!el) return;
+  if (!entries || entries.length === 0) {
+    el.innerHTML = '<p class="empty">No pinned notes. Pin important context that all agents should see.</p>';
+    return;
+  }
+  el.innerHTML = entries.map(e =>
+    '<div style="padding:8px 12px;margin-bottom:6px;background:var(--surface2);border-left:3px solid ' +
+      (e.level === 'critical' ? 'var(--red)' : e.level === 'warning' ? 'var(--yellow)' : 'var(--blue)') +
+      ';border-radius:4px">' +
+      '<div style="display:flex;justify-content:space-between;align-items:center">' +
+        '<strong style="font-size:var(--text-md)">' + escHtml(e.title) + '</strong>' +
+        '<button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--red);border-color:var(--red)" onclick="removePinnedNote(\'' + escHtml(e.title) + '\')">Unpin</button>' +
+      '</div>' +
+      '<div style="font-size:var(--text-sm);color:var(--muted);margin-top:4px">' + escHtml(e.content.slice(0, 200)) + '</div>' +
+    '</div>'
+  ).join('');
+}
+
+function openPinNoteModal() {
+  document.getElementById('modal-title').textContent = 'Pin a Note';
+  document.getElementById('modal-body').innerHTML =
+    '<div style="display:flex;flex-direction:column;gap:12px">' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Title<input id="pin-title" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text)" placeholder="e.g. API freeze until Friday"></label>' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Content<textarea id="pin-content" rows="4" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text);resize:vertical;font-family:inherit" placeholder="Context all agents should see..."></textarea></label>' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Level<select id="pin-level" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text)"><option value="info">Info</option><option value="warning">Warning</option><option value="critical">Critical</option></select></label>' +
+      '<div style="display:flex;justify-content:flex-end;gap:8px"><button onclick="closeModal()" class="pr-pager-btn">Cancel</button><button onclick="submitPinnedNote()" style="padding:6px 16px;background:var(--blue);color:#fff;border:none;border-radius:var(--radius-sm);cursor:pointer">Pin</button></div>' +
+    '</div>';
+  document.getElementById('modal').classList.add('open');
+}
+
+async function submitPinnedNote() {
+  const title = document.getElementById('pin-title').value;
+  const content = document.getElementById('pin-content').value;
+  const level = document.getElementById('pin-level').value;
+  if (!title || !content) { alert('Title and content required'); return; }
+  try {
+    const res = await fetch('/api/pinned', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ title, content, level }) });
+    if (res.ok) { closeModal(); refresh(); showToast('cmd-toast', 'Note pinned', true); }
+    else { const d = await res.json(); alert('Error: ' + (d.error || 'unknown')); }
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
+async function removePinnedNote(title) {
+  if (!confirm('Unpin "' + title + '"?')) return;
+  try {
+    await fetch('/api/pinned/remove', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ title }) });
+    refresh();
+  } catch (e) { alert('Error: ' + e.message); }
+}

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

@@ -33,9 +33,14 @@ function wiRow(item) {
     '</td>' +
     '<td>' + prLink + '</td>' +
     '<td><span class="pr-date">' + shortTime(item.created) + '</span></td>' +
+    '<td style="white-space:nowrap;font-size:9px;color:var(--muted)">' +
+      (item.references && item.references.length ? '<span title="' + item.references.length + ' reference(s)" style="margin-right:4px">&#x1F517;' + item.references.length + '</span>' : '') +
+      (item.acceptanceCriteria && item.acceptanceCriteria.length ? '<span title="' + item.acceptanceCriteria.length + ' acceptance criteria">&#x2611;' + item.acceptanceCriteria.length + '</span>' : '') +
+    '</td>' +
     '<td style="white-space:nowrap">' +
       ((item.status === 'pending' || item.status === 'failed') ? '<button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--blue);border-color:var(--blue);margin-right:4px" onclick="event.stopPropagation();editWorkItem(\'' + escHtml(item.id) + '\',\'' + escHtml(item._source || '') + '\')" title="Edit work item">&#x270E;</button>' : '') +
       ((item.status === 'done' || item.status === 'failed') ? '<button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--muted);border-color:var(--border);margin-right:4px" onclick="event.stopPropagation();archiveWorkItem(\'' + escHtml(item.id) + '\',\'' + escHtml(item._source || '') + '\')" title="Archive work item">&#x1F4E6;</button>' : '') +
+      ((item.status === 'done' || item.status === 'failed') && !item._humanFeedback ? '<button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--green);border-color:var(--green);margin-right:4px" onclick="event.stopPropagation();feedbackWorkItem(\'' + escHtml(item.id) + '\',\'' + escHtml(item._source || '') + '\')" title="Give feedback">&#x1F44D;&#x1F44E;</button>' : (item._humanFeedback ? '<span style="font-size:9px" title="Feedback given">' + (item._humanFeedback.rating === 'up' ? '&#x1F44D;' : '&#x1F44E;') + '</span> ' : '')) +
       '<button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--red);border-color:var(--red)" onclick="event.stopPropagation();deleteWorkItem(\'' + escHtml(item.id) + '\',\'' + escHtml(item._source || '') + '\')" title="Delete work item and kill agent">&#x2715;</button>' +
     '</td>' +
   '</tr>';
@@ -65,7 +70,7 @@ function renderWorkItems(items) {
   const start = wiPage * WI_PER_PAGE;
   const pageItems = items.slice(start, start + WI_PER_PAGE);
 
-  let html = '<div class="pr-table-wrap"><table class="pr-table"><thead><tr><th>ID</th><th>Title</th><th>Source</th><th>Type</th><th>Priority</th><th>Status</th><th>Agent</th><th>PR</th><th>Created</th><th></th></tr></thead><tbody>';
+  let html = '<div class="pr-table-wrap"><table class="pr-table"><thead><tr><th>ID</th><th>Title</th><th>Source</th><th>Type</th><th>Priority</th><th>Status</th><th>Agent</th><th>PR</th><th>Created</th><th></th><th></th></tr></thead><tbody>';
   html += pageItems.map(wiRow).join('');
   html += '</tbody></table></div>';
 
@@ -113,6 +118,12 @@ function editWorkItem(id, source) {
           '<select id="wi-edit-agent" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text);font-size:var(--text-md)"><option value="">Auto</option>' + agentOpts + '</select>' +
         '</label>' +
       '</div>' +
+      '<label style="color:var(--text);font-size:var(--text-md)">References (one per line: url | title | type)' +
+        '<textarea id="wi-edit-refs" rows="3" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text);font-size:var(--text-md);font-family:inherit;resize:vertical">' + escHtml((item.references || []).map(function(r) { return r.url + ' | ' + (r.title || '') + ' | ' + (r.type || 'link'); }).join('\n')) + '</textarea>' +
+      '</label>' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Acceptance Criteria (one per line)' +
+        '<textarea id="wi-edit-ac" rows="3" style="display:block;width:100%;margin-top:4px;padding:6px 8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text);font-size:var(--text-md);font-family:inherit;resize:vertical">' + escHtml((item.acceptanceCriteria || []).join('\n')) + '</textarea>' +
+      '</label>' +
       '<div style="display:flex;justify-content:flex-end;gap:8px;margin-top:8px">' +
         '<button onclick="closeModal()" class="pr-pager-btn" style="padding:6px 16px;font-size:var(--text-md)">Cancel</button>' +
         '<button onclick="submitWorkItemEdit(\'' + escHtml(id) + '\',\'' + escHtml(source || '') + '\')" style="padding:6px 16px;font-size:var(--text-md);background:var(--blue);color:#fff;border:none;border-radius:var(--radius-sm);cursor:pointer">Save</button>' +
@@ -127,11 +138,18 @@ async function submitWorkItemEdit(id, source) {
   const type = document.getElementById('wi-edit-type').value;
   const priority = document.getElementById('wi-edit-priority').value;
   const agent = document.getElementById('wi-edit-agent').value;
+  const refsRaw = document.getElementById('wi-edit-refs')?.value || '';
+  const references = refsRaw.split('\n').filter(function(l) { return l.trim(); }).map(function(l) {
+    var parts = l.split('|').map(function(s) { return s.trim(); });
+    return { url: parts[0], title: parts[1] || parts[0], type: parts[2] || 'link' };
+  });
+  const acRaw = document.getElementById('wi-edit-ac')?.value || '';
+  const acceptanceCriteria = acRaw.split('\n').filter(function(l) { return l.trim(); });
   if (!title) { alert('Title is required'); return; }
   try {
     const res = await fetch('/api/work-items/update', {
       method: 'POST', headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ id, source: source || undefined, title, description, type, priority, agent })
+      body: JSON.stringify({ id, source: source || undefined, title, description, type, priority, agent, references, acceptanceCriteria })
     });
     if (res.ok) { closeModal(); refresh(); showToast('cmd-toast', 'Work item updated', true); } else {
       const d = await res.json();
@@ -208,9 +226,34 @@ async function retryWorkItem(id, source) {
 function wiPrev() { if (wiPage > 0) { wiPage--; renderWorkItems(allWorkItems); } }
 function wiNext() { const tp = Math.ceil(allWorkItems.length / WI_PER_PAGE); if (wiPage < tp-1) { wiPage++; renderWorkItems(allWorkItems); } }
 
+function feedbackWorkItem(id, source) {
+  document.getElementById('modal-title').textContent = 'Feedback on ' + id;
+  document.getElementById('modal-body').innerHTML =
+    '<div style="display:flex;flex-direction:column;gap:16px;align-items:center">' +
+      '<div style="display:flex;gap:24px">' +
+        '<button onclick="submitFeedback(\'' + escHtml(id) + '\',\'' + escHtml(source) + '\',\'up\')" style="font-size:40px;background:none;border:2px solid var(--border);border-radius:12px;padding:16px 24px;cursor:pointer;transition:all 0.2s" onmouseover="this.style.borderColor=\'var(--green)\'" onmouseout="this.style.borderColor=\'var(--border)\'">&#x1F44D;</button>' +
+        '<button onclick="submitFeedback(\'' + escHtml(id) + '\',\'' + escHtml(source) + '\',\'down\')" style="font-size:40px;background:none;border:2px solid var(--border);border-radius:12px;padding:16px 24px;cursor:pointer;transition:all 0.2s" onmouseover="this.style.borderColor=\'var(--red)\'" onmouseout="this.style.borderColor=\'var(--border)\'">&#x1F44E;</button>' +
+      '</div>' +
+      '<textarea id="feedback-comment" rows="3" style="width:100%;padding:8px;background:var(--bg);border:1px solid var(--border);border-radius:var(--radius-sm);color:var(--text);font-family:inherit;resize:vertical" placeholder="Optional: what was good or needs improvement?"></textarea>' +
+    '</div>';
+  document.getElementById('modal').classList.add('open');
+}
+
+async function submitFeedback(id, source, rating) {
+  const comment = document.getElementById('feedback-comment')?.value || '';
+  try {
+    const res = await fetch('/api/work-items/feedback', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ id, source, rating, comment })
+    });
+    if (res.ok) { closeModal(); refresh(); showToast('cmd-toast', 'Feedback saved — agents will learn from it', true); }
+    else { const d = await res.json(); alert('Error: ' + (d.error || 'unknown')); }
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
 function openAllWorkItems() {
   document.getElementById('modal-title').textContent = 'All Work Items (' + allWorkItems.length + ')';
-  const html = '<div class="pr-table-wrap"><table class="pr-table"><thead><tr><th>ID</th><th>Title</th><th>Source</th><th>Type</th><th>Priority</th><th>Status</th><th>Agent</th><th>PR</th><th>Created</th><th></th></tr></thead><tbody>' +
+  const html = '<div class="pr-table-wrap"><table class="pr-table"><thead><tr><th>ID</th><th>Title</th><th>Source</th><th>Type</th><th>Priority</th><th>Status</th><th>Agent</th><th>PR</th><th>Created</th><th></th><th></th></tr></thead><tbody>' +
     allWorkItems.map(wiRow).join('') + '</tbody></table></div>';
   document.getElementById('modal-body').innerHTML = html;
   document.getElementById('modal-body').style.fontFamily = "'Segoe UI', system-ui, sans-serif";

package/dashboard/pages/home.html

@@ -12,6 +12,7 @@
           <span style="color:var(--blue);font-weight:600">Command Center</span>
           <span>Ask anything, dispatch work, manage plans — powered by Sonnet</span>
           <button class="cmd-history-btn" onclick="cmdShowHistory()">Past Commands</button>
+          <button class="pr-pager-btn" style="font-size:9px;padding:2px 8px;color:var(--green);border-color:var(--green)" onclick="openQuickNoteModal()">+ Note</button>
         </div>
         <div class="cmd-toast" id="cmd-toast"></div>
       </section>
@@ -19,6 +20,10 @@
         <h2>Minions Members <span style="font-size:10px;color:var(--border);font-weight:400;text-transform:none;letter-spacing:0">click for details</span></h2>
         <div class="agents" id="agents-grid">Loading...</div>
       </section>
+      <section>
+        <h2>Pinned Context <button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--green);border-color:var(--green);margin-left:8px" onclick="openPinNoteModal()">+ Pin</button></h2>
+        <div id="pinned-content"><p class="empty">No pinned notes.</p></div>
+      </section>
       <section>
         <h2>Dispatch Queue</h2>
         <div class="dispatch-stats" id="dispatch-stats"></div>

package/dashboard/pages/inbox.html

@@ -1,5 +1,5 @@
       <section>
-        <h2>Notes Inbox <span class="count" id="inbox-count">0</span> <span style="font-size:10px;color:var(--muted);font-weight:400;text-transform:none;letter-spacing:0">auto-consolidates at 3 notes</span></h2>
+        <h2>Notes Inbox <span class="count" id="inbox-count">0</span> <button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--green);border-color:var(--green);margin-left:8px" onclick="openQuickNoteModal()">+ Note</button> <span style="font-size:10px;color:var(--muted);font-weight:400;text-transform:none;letter-spacing:0">auto-consolidates at 3 notes</span></h2>
         <div class="inbox-list" id="inbox-list">Loading...</div>
       </section>
       <section>
@@ -7,7 +7,7 @@
         <div id="notes-list">Loading...</div>
       </section>
       <section>
-        <h2>Knowledge Base <span class="count" id="kb-count">0</span> <button id="kb-sweep-btn" onclick="kbSweep()" style="font-size:9px;padding:2px 8px;background:var(--surface2);border:1px solid var(--border);color:var(--muted);border-radius:4px;cursor:pointer;margin-left:8px;vertical-align:middle">sweep</button><span id="kb-swept-time" style="font-size:10px;color:var(--muted);font-weight:400;text-transform:none;letter-spacing:0;margin-left:8px"></span></h2>
+        <h2>Knowledge Base <span class="count" id="kb-count">0</span> <button class="pr-pager-btn" style="font-size:9px;padding:1px 6px;color:var(--green);border-color:var(--green);margin-left:8px" onclick="openCreateKbModal()">+ New</button><button id="kb-sweep-btn" onclick="kbSweep()" style="font-size:9px;padding:2px 8px;background:var(--surface2);border:1px solid var(--border);color:var(--muted);border-radius:4px;cursor:pointer;margin-left:8px;vertical-align:middle">sweep</button><span id="kb-swept-time" style="font-size:10px;color:var(--muted);font-weight:400;text-transform:none;letter-spacing:0;margin-left:8px"></span></h2>
         <div class="kb-tabs" id="kb-tabs"></div>
         <div class="kb-list" id="kb-list"><p class="empty">No knowledge entries yet. Notes are classified here after consolidation.</p></div>
       </section>

package/dashboard-build.js

@@ -32,7 +32,7 @@ function buildDashboardHtml() {
     'utils', 'state', 'detail-panel', 'live-stream',
     'render-agents', 'render-dispatch', 'render-work-items', 'render-prd',
     'render-prs', 'render-plans', 'render-inbox', 'render-kb', 'render-skills',
-    'render-other', 'render-schedules',
+    'render-other', 'render-schedules', 'render-pinned',
     'command-parser', 'command-input', 'command-center', 'command-history',
     'modal', 'modal-qa', 'settings', 'refresh'
   ];

package/dashboard.js

@@ -76,7 +76,7 @@ function buildDashboardHtml() {
     'utils', 'state', 'detail-panel', 'live-stream',
     'render-agents', 'render-dispatch', 'render-work-items', 'render-prd',
     'render-prs', 'render-plans', 'render-inbox', 'render-kb', 'render-skills',
-    'render-other', 'render-schedules',
+    'render-other', 'render-schedules', 'render-pinned',
     'command-parser', 'command-input', 'command-center', 'command-history',
     'modal', 'modal-qa', 'settings', 'refresh'
   ];
@@ -132,6 +132,17 @@ function getMcpServers() {
   } catch { return []; }
 }
 
+function parsePinnedEntries(content) {
+  if (!content) return [];
+  const entries = [];
+  const regex = /###\s*(🔴\s*|🟡\s*)?(.+)\n\n([\s\S]*?)(?=\n\n###|\n\n\*Pinned|$)/g;
+  let m;
+  while ((m = regex.exec(content)) !== null) {
+    entries.push({ level: m[1]?.includes('🔴') ? 'critical' : m[1]?.includes('🟡') ? 'warning' : 'info', title: m[2].trim(), content: m[3].trim() });
+  }
+  return entries;
+}
+
 let _statusCache = null;
 let _statusCacheTs = 0;
 const STATUS_CACHE_TTL = 10000; // 10s — reduces expensive aggregation frequency; mutations call invalidateStatusCache()
@@ -166,6 +177,7 @@ function getStatus() {
       const runs = shared.safeJson(path.join(MINIONS_DIR, 'engine', 'schedule-runs.json')) || {};
       return scheds.map(s => ({ ...s, _lastRun: runs[s.id] || null }));
     })(),
+    pinned: (() => { try { return parsePinnedEntries(safeRead(path.join(MINIONS_DIR, 'pinned.md'))); } catch { return []; } })(),
     projects: PROJECTS.map(p => ({ name: p.name, path: p.localPath, description: p.description || '' })),
     initialized: !!(CONFIG.agents && Object.keys(CONFIG.agents).length > 0),
     installId: safeRead(path.join(MINIONS_DIR, '.install-id')).trim() || null,
@@ -900,6 +912,8 @@ const server = http.createServer(async (req, res) => {
       if (body.scope) item.scope = body.scope;
       if (body.agent) item.agent = body.agent;
       if (body.agents) item.agents = body.agents;
+      if (body.references) item.references = body.references;
+      if (body.acceptanceCriteria) item.acceptanceCriteria = body.acceptanceCriteria;
       items.push(item);
       safeWrite(wiPath, items);
       return jsonReply(res, 200, { ok: true, id });
@@ -936,6 +950,8 @@ const server = http.createServer(async (req, res) => {
       if (type !== undefined) item.type = type;
       if (priority !== undefined) item.priority = priority;
       if (agent !== undefined) item.agent = agent || null;
+      if (body.references !== undefined) item.references = body.references;
+      if (body.acceptanceCriteria !== undefined) item.acceptanceCriteria = body.acceptanceCriteria;
       item.updatedAt = new Date().toISOString();
 
       safeWrite(wiPath, items);
@@ -2738,12 +2754,69 @@ What would you like to discuss or change? When you're happy, say "approve" and I
     { method: 'GET', path: '/api/health', desc: 'Lightweight health check for monitoring', handler: handleHealth },
 
     // Work items
-    { method: 'POST', path: '/api/work-items', desc: 'Create a new work item', params: 'title, type?, description?, priority?, project?, agent?, agents?, scope?', handler: handleWorkItemsCreate },
-    { method: 'POST', path: '/api/work-items/update', desc: 'Edit a pending/failed work item', params: 'id, source?, title?, description?, type?, priority?, agent?', handler: handleWorkItemsUpdate },
+    { method: 'POST', path: '/api/work-items', desc: 'Create a new work item', params: 'title, type?, description?, priority?, project?, agent?, agents?, scope?, references?, acceptanceCriteria?', handler: handleWorkItemsCreate },
+    { method: 'POST', path: '/api/work-items/update', desc: 'Edit a pending/failed work item', params: 'id, source?, title?, description?, type?, priority?, agent?, references?, acceptanceCriteria?', handler: handleWorkItemsUpdate },
     { method: 'POST', path: '/api/work-items/retry', desc: 'Reset a failed/dispatched item to pending', params: 'id, source?', handler: handleWorkItemsRetry },
     { method: 'POST', path: '/api/work-items/delete', desc: 'Remove a work item, kill agent, clear dispatch', params: 'id, source?', handler: handleWorkItemsDelete },
     { method: 'POST', path: '/api/work-items/archive', desc: 'Move a completed/failed work item to archive', params: 'id, source?', handler: handleWorkItemsArchive },
     { method: 'GET', path: '/api/work-items/archive', desc: 'List archived work items', handler: handleWorkItemsArchiveList },
+    { method: 'POST', path: '/api/work-items/feedback', desc: 'Add human feedback on completed work', params: 'id, rating, comment?', handler: async (req, res) => {
+      const body = await readBody(req);
+      const { id, source, rating, comment } = body;
+      if (!id || !rating) return jsonReply(res, 400, { error: 'id and rating required' });
+      const projects = shared.getProjects(CONFIG);
+      const paths = [path.join(MINIONS_DIR, 'work-items.json')];
+      for (const p of projects) paths.push(shared.projectWorkItemsPath(p));
+      for (const wiPath of paths) {
+        const items = JSON.parse(safeRead(wiPath) || '[]');
+        const item = items.find(i => i.id === id);
+        if (!item) continue;
+        item._humanFeedback = { rating, comment: comment || '', at: new Date().toISOString() };
+        safeWrite(wiPath, items);
+        const agent = item.dispatched_to || item.agent || 'unknown';
+        const feedbackNote = '# Human Feedback on ' + id + '\n\n' +
+          '**Rating:** ' + (rating === 'up' ? '👍 Good' : '👎 Needs improvement') + '\n' +
+          '**Item:** ' + (item.title || id) + '\n' +
+          '**Agent:** ' + agent + '\n' +
+          (comment ? '**Feedback:** ' + comment + '\n' : '');
+        const inboxPath = path.join(MINIONS_DIR, 'notes', 'inbox', agent + '-feedback-' + new Date().toISOString().slice(0, 10) + '-' + shared.uid().slice(0, 4) + '.md');
+        safeWrite(inboxPath, feedbackNote);
+        invalidateStatusCache();
+        return jsonReply(res, 200, { ok: true });
+      }
+      return jsonReply(res, 404, { error: 'Work item not found' });
+    }},
+
+    // Pinned notes
+    { method: 'GET', path: '/api/pinned', desc: 'Get pinned notes', handler: async (req, res) => {
+      const content = safeRead(path.join(MINIONS_DIR, 'pinned.md'));
+      return jsonReply(res, 200, { content, entries: parsePinnedEntries(content) });
+    }},
+    { method: 'POST', path: '/api/pinned', desc: 'Add a pinned note', params: 'title, content, level?', handler: async (req, res) => {
+      const body = await readBody(req);
+      const { title, content, level } = body;
+      if (!title || !content) return jsonReply(res, 400, { error: 'title and content required' });
+      const pinnedPath = path.join(MINIONS_DIR, 'pinned.md');
+      const existing = safeRead(pinnedPath);
+      const levelTag = level === 'critical' ? '🔴 ' : level === 'warning' ? '🟡 ' : '';
+      const entry = '\n\n### ' + levelTag + title + '\n\n' + content + '\n\n*Pinned by human on ' + new Date().toISOString().slice(0, 10) + '*';
+      safeWrite(pinnedPath, (existing || '# Pinned Context\n\nCritical notes visible to all agents.') + entry);
+      invalidateStatusCache();
+      return jsonReply(res, 200, { ok: true });
+    }},
+    { method: 'POST', path: '/api/pinned/remove', desc: 'Remove a pinned note by title', params: 'title', handler: async (req, res) => {
+      const body = await readBody(req);
+      const { title } = body;
+      if (!title) return jsonReply(res, 400, { error: 'title required' });
+      const pinnedPath = path.join(MINIONS_DIR, 'pinned.md');
+      let content = safeRead(pinnedPath);
+      if (!content) return jsonReply(res, 404, { error: 'No pinned notes' });
+      const regex = new RegExp('\\n\\n###\\s*(?:🔴\\s*|🟡\\s*)?' + title.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '\\n[\\s\\S]*?(?=\\n\\n###|$)', 'i');
+      content = content.replace(regex, '');
+      safeWrite(pinnedPath, content);
+      invalidateStatusCache();
+      return jsonReply(res, 200, { ok: true });
+    }},
 
     // Notes
     { method: 'POST', path: '/api/notes', desc: 'Write a note to inbox for consolidation', params: 'title, what, why?, author?', handler: handleNotesCreate },
@@ -2780,6 +2853,21 @@ What would you like to discuss or change? When you're happy, say "approve" and I
 
     // Knowledge base
     { method: 'GET', path: '/api/knowledge', desc: 'List all knowledge base entries grouped by category', handler: handleKnowledgeList },
+    { method: 'POST', path: '/api/knowledge', desc: 'Create a knowledge base entry', params: 'category, title, content', handler: async (req, res) => {
+      const body = await readBody(req);
+      const { category, title, content } = body;
+      if (!category || !title || !content) return jsonReply(res, 400, { error: 'category, title, and content required' });
+      const validCategories = ['architecture', 'conventions', 'project-notes', 'build-reports', 'reviews'];
+      if (!validCategories.includes(category)) return jsonReply(res, 400, { error: 'Invalid category. Must be: ' + validCategories.join(', ') });
+      const slug = title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '').slice(0, 60);
+      const filePath = path.join(MINIONS_DIR, 'knowledge', category, slug + '.md');
+      const dir = path.dirname(filePath);
+      if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+      const header = '# ' + title + '\n\n*Created by human teammate on ' + new Date().toISOString().slice(0, 10) + '*\n\n';
+      safeWrite(filePath, header + content);
+      invalidateStatusCache();
+      return jsonReply(res, 200, { ok: true, path: filePath });
+    }},
     { method: 'POST', path: '/api/knowledge/sweep', desc: 'Deduplicate, consolidate, and reorganize knowledge base', handler: handleKnowledgeSweep },
     { method: 'GET', path: /^\/api\/knowledge\/([^/]+)\/([^?]+)/, desc: 'Read a specific knowledge base entry', handler: handleKnowledgeRead },
 

package/engine.js

@@ -357,6 +357,13 @@ function renderPlaybook(type, vars) {
     return null;
   }
 
+  // Inject pinned context (always visible to agents)
+  let pinnedContent = '';
+  try { pinnedContent = fs.readFileSync(path.join(MINIONS_DIR, 'pinned.md'), 'utf8'); } catch {}
+  if (pinnedContent) {
+    content += '\n\n---\n\n## Pinned Context (CRITICAL — READ FIRST)\n\n' + pinnedContent;
+  }
+
   // Inject team notes context
   const notes = getNotes();
   if (notes) {
@@ -2675,6 +2682,14 @@ function discoverFromWorkItems(config, project) {
     };
     try { vars.notes_content = fs.readFileSync(path.join(MINIONS_DIR, 'notes.md'), 'utf8'); } catch {}
 
+    // Inject references and acceptance criteria
+    const refs = (item.references || []).map(r =>
+      '- [' + (r.title || r.url) + '](' + r.url + ')' + (r.type ? ' (' + r.type + ')' : '')
+    ).join('\n');
+    vars.references = refs ? '## References\n\n' + refs : '';
+    const ac = (item.acceptanceCriteria || []).map(c => '- [ ] ' + c).join('\n');
+    vars.acceptance_criteria = ac ? '## Acceptance Criteria\n\n' + ac : '';
+
     // Inject ask-specific variables for the ask playbook
     if (workType === 'ask') {
       vars.question = item.title + (item.description ? '\n\n' + item.description : '');
@@ -2962,6 +2977,14 @@ function discoverCentralWorkItems(config) {
           project_path: ap?.localPath || '',
         };
 
+        // Inject references and acceptance criteria
+        const fanRefs = (item.references || []).map(r =>
+          '- [' + (r.title || r.url) + '](' + r.url + ')' + (r.type ? ' (' + r.type + ')' : '')
+        ).join('\n');
+        vars.references = fanRefs ? '## References\n\n' + fanRefs : '';
+        const fanAc = (item.acceptanceCriteria || []).map(c => '- [ ] ' + c).join('\n');
+        vars.acceptance_criteria = fanAc ? '## Acceptance Criteria\n\n' + fanAc : '';
+
         if (workType === 'ask') {
           vars.question = item.title + (item.description ? '\n\n' + item.description : '');
           vars.task_id = item.id;
@@ -3029,6 +3052,14 @@ function discoverCentralWorkItems(config) {
       };
       try { vars.notes_content = fs.readFileSync(path.join(MINIONS_DIR, 'notes.md'), 'utf8'); } catch {}
 
+      // Inject references and acceptance criteria
+      const normRefs = (item.references || []).map(r =>
+        '- [' + (r.title || r.url) + '](' + r.url + ')' + (r.type ? ' (' + r.type + ')' : '')
+      ).join('\n');
+      vars.references = normRefs ? '## References\n\n' + normRefs : '';
+      const normAc = (item.acceptanceCriteria || []).map(c => '- [ ] ' + c).join('\n');
+      vars.acceptance_criteria = normAc ? '## Acceptance Criteria\n\n' + normAc : '';
+
       // Inject plan-specific variables for the plan playbook
       if (workType === 'plan') {
         // Ensure plans directory exists before agent tries to write

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "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"