@yemi33/minions 0.1.720 → 0.1.722

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.722 (2026-04-09)
+
+### Features
+-  server-side KB pin state so CC can pin items
+
+### Fixes
+- remove 200-char truncation from PRD item descriptions in plan viewer (closes #670) (#700)
+
 ## 0.1.720 (2026-04-09)
 
 ### Fixes

package/dashboard/js/refresh.js

@@ -126,6 +126,7 @@ async function refresh() {
 }
 
 refresh();
+_syncPinsFromServer(); // Load server-side pins on startup
 
 // Poll for status updates (SSE caused HTTP/1.1 connection exhaustion — CC fetch would fail)
 setInterval(refresh, 4000);

package/dashboard/js/render-plans.js

@@ -414,7 +414,7 @@ function _renderPlanModal(normalizedFile, raw, lastMod) {
     const items = (plan.missing_features || []).map((f, i) =>
       (i + 1) + '. [' + f.id + '] ' + f.name + ' (' + (f.estimated_complexity || '?') + ', ' + (f.priority || '?') + ')' +
       (f.depends_on?.length ? ' \u2192 depends on: ' + f.depends_on.join(', ') : '') +
-      '\n   ' + (f.description || '').slice(0, 200) +
+      '\n   ' + (f.description || '') +
       (f.acceptance_criteria?.length ? '\n   Criteria: ' + f.acceptance_criteria.join('; ') : '')
     ).join('\n\n');
     text = 'Project: ' + (plan.project || '?') +

package/dashboard/js/utils.js

@@ -8,13 +8,13 @@ const _deletedIds = new Map(); // key → expiry timestamp
 function markDeleted(key) { _deletedIds.set(key, Date.now() + 10000); } // suppress for 10s
 function isDeleted(key) { const exp = _deletedIds.get(key); if (!exp) return false; if (Date.now() > exp) { _deletedIds.delete(key); return false; } return true; }
 
-// Temporary pin-to-top — UI-only, stored in localStorage, does not affect agents
-const PINS_KEY = 'minions-pinned-items';
+// Pin-to-top — persisted server-side so CC and agents can also pin items
 let _pinsCache = null;
 function invalidatePinsCache() { _pinsCache = null; }
 function getPinnedItems() {
   if (_pinsCache) return _pinsCache;
-  try { _pinsCache = JSON.parse(localStorage.getItem(PINS_KEY) || '[]'); } catch { _pinsCache = []; }
+  // Migrate from localStorage if server hasn't been seeded yet
+  try { _pinsCache = JSON.parse(localStorage.getItem('minions-pinned-items') || '[]'); } catch { _pinsCache = []; }
   return _pinsCache;
 }
 function isPinned(key) { return getPinnedItems().includes(key); }
@@ -22,10 +22,20 @@ function togglePin(key) {
   const pins = getPinnedItems();
   const idx = pins.indexOf(key);
   if (idx >= 0) pins.splice(idx, 1); else pins.unshift(key);
-  localStorage.setItem(PINS_KEY, JSON.stringify(pins));
-  invalidatePinsCache();
+  _pinsCache = pins;
+  // Persist to server (fire-and-forget)
+  fetch('/api/kb-pins', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ pins }) }).catch(function() {});
   return idx < 0; // true if now pinned
 }
+function _syncPinsFromServer() {
+  fetch('/api/kb-pins').then(function(r) { return r.json(); }).then(function(d) {
+    if (Array.isArray(d.pins) && d.pins.length > 0) {
+      _pinsCache = d.pins;
+      // Clear legacy localStorage
+      localStorage.removeItem('minions-pinned-items');
+    }
+  }).catch(function() {});
+}
 function inboxPinKey(name) { return 'notes/inbox/' + name; }
 function kbPinKey(cat, file) { return 'knowledge/' + cat + '/' + file; }
 function _togglePinAndRefresh(key, source) {

package/dashboard.html

@@ -4273,7 +4273,7 @@ async function planView(file) {
       const items = (plan.missing_features || []).map((f, i) =>
         (i + 1) + '. [' + f.id + '] ' + f.name + ' (' + (f.estimated_complexity || '?') + ', ' + (f.priority || '?') + ')' +
         (f.depends_on?.length ? ' → depends on: ' + f.depends_on.join(', ') : '') +
-        '\n   ' + (f.description || '').slice(0, 200) +
+        '\n   ' + (f.description || '') +
         (f.acceptance_criteria?.length ? '\n   Criteria: ' + f.acceptance_criteria.join('; ') : '')
       ).join('\n\n');
       text = 'Project: ' + (plan.project || '?') +

package/dashboard.js

@@ -3784,6 +3784,28 @@ What would you like to discuss or change? When you're happy, say "approve" and I
       return jsonReply(res, 200, { ok: true });
     }},
 
+    // KB pin state (server-side so CC can pin items)
+    { method: 'GET', path: '/api/kb-pins', desc: 'Get pinned KB item keys', handler: async (req, res) => {
+      const pins = shared.safeJson(path.join(MINIONS_DIR, 'engine', 'kb-pins.json')) || [];
+      return jsonReply(res, 200, { pins });
+    }},
+    { method: 'POST', path: '/api/kb-pins', desc: 'Set pinned KB item keys', params: 'pins[]', handler: async (req, res) => {
+      const body = await readBody(req);
+      if (!Array.isArray(body.pins)) return jsonReply(res, 400, { error: 'pins array required' });
+      safeWrite(path.join(MINIONS_DIR, 'engine', 'kb-pins.json'), body.pins);
+      return jsonReply(res, 200, { ok: true });
+    }},
+    { method: 'POST', path: '/api/kb-pins/toggle', desc: 'Toggle a single KB pin', params: 'key', handler: async (req, res) => {
+      const body = await readBody(req);
+      if (!body.key) return jsonReply(res, 400, { error: 'key required' });
+      const pinsPath = path.join(MINIONS_DIR, 'engine', 'kb-pins.json');
+      const pins = shared.safeJson(pinsPath) || [];
+      const idx = pins.indexOf(body.key);
+      if (idx >= 0) pins.splice(idx, 1); else pins.unshift(body.key);
+      safeWrite(pinsPath, pins);
+      return jsonReply(res, 200, { ok: true, pinned: idx < 0 });
+    }},
+
     // Notes
     { method: 'POST', path: '/api/notes', desc: 'Write a note to inbox for consolidation', params: 'title, what, why?, author?', handler: handleNotesCreate },
     { method: 'GET', path: '/api/notes-full', desc: 'Return full notes.md content', handler: handleNotesFull },

package/package.json

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

package/prompts/cc-system.md

@@ -30,7 +30,7 @@ Core action types:
 - **knowledge**: title, content, category (architecture/conventions/project-notes/build-reports/reviews) — create new KB entry or copy existing doc to KB
 - **pin-to-pinned**: title, content, level (critical/warning) — write to pinned.md, force-injected into ALL agent prompts (rarely needed)
 
-**IMPORTANT**: When user says "pin", "pin this", "pin a note", or "pin in KB" — they mean save/copy to the **knowledge base** (`knowledge/<category>/`), NOT to `pinned.md`. If a file path is given, read it and write to `knowledge/<category>/<slug>.md`. If no path, search inbox/notes first. Only write to `pinned.md` if user explicitly says "pinned.md" or "critical alert for all agents".
+**IMPORTANT**: When user says "pin", "pin this", "pin a note", or "pin in KB" — they mean **pin an existing KB entry to the top** of the knowledge base list. Do this by calling: `curl -s -X POST http://localhost:7331/api/kb-pins/toggle -H 'Content-Type: application/json' -d '{"key":"knowledge/<category>/<filename>"}'`. If the file isn't in KB yet, first copy it to `knowledge/<category>/<slug>.md`, then pin it. Do NOT write to `pinned.md` unless user explicitly says "pinned.md" or "critical alert for all agents".
 - **plan**: title, description, project, branchStrategy (parallel/shared-branch)
 - **cancel**: agent, reason
 - **retry**: ids[]