@yemi33/minions 0.1.38 → 0.1.40

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.1.40 (2026-03-29)
+
+### Dashboard
+- dashboard.js
+- dashboard/js/render-plans.js
+- dashboard/pages/plans.html
+
+## 0.1.39 (2026-03-29)
+
+### Engine
+- engine.js
+
+### Dashboard
+- dashboard.js
+- dashboard/js/render-prs.js
+- dashboard/pages/prs.html
+
 ## 0.1.38 (2026-03-29)
 
 ### Dashboard

package/dashboard/js/render-plans.js

@@ -1,5 +1,51 @@
 // render-plans.js — Plan rendering functions extracted from dashboard.html
 
+function openCreatePlanModal() {
+  const projOpts = (typeof cmdProjects !== 'undefined' ? cmdProjects : []).map(p =>
+    '<option value="' + escHtml(p) + '">' + escHtml(p) + '</option>'
+  ).join('');
+  const inputStyle = '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';
+
+  document.getElementById('modal-title').textContent = 'Create Plan';
+  document.getElementById('modal-body').innerHTML =
+    '<div style="display:flex;flex-direction:column;gap:10px">' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Title <input id="plan-new-title" style="' + inputStyle + '" placeholder="e.g. Add user authentication with JWT"></label>' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Project <select id="plan-new-project" style="' + inputStyle + '"><option value="">Auto</option>' + projOpts + '</select></label>' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Plan Content <textarea id="plan-new-content" rows="12" style="' + inputStyle + ';resize:vertical;font-family:monospace;font-size:12px" placeholder="Write your plan in markdown...\n\nDescribe what needs to be built, the approach, requirements, and any constraints.\n\nThe squad will convert this into a PRD with structured work items."></textarea></label>' +
+      '<div style="font-size:11px;color:var(--muted)">After creating, click Execute on the plan card to have an agent convert it into a PRD with work items.</div>' +
+      '<div style="display:flex;justify-content:flex-end;gap:8px;margin-top:4px">' +
+        '<button onclick="closeModal()" class="pr-pager-btn">Cancel</button>' +
+        '<button onclick="_submitCreatePlan()" style="padding:6px 16px;background:var(--blue);color:#fff;border:none;border-radius:var(--radius-sm);cursor:pointer">Create Plan</button>' +
+      '</div>' +
+    '</div>';
+  document.getElementById('modal').classList.add('open');
+  setTimeout(() => document.getElementById('plan-new-title')?.focus(), 100);
+}
+
+async function _submitCreatePlan() {
+  const title = document.getElementById('plan-new-title')?.value?.trim();
+  const content = document.getElementById('plan-new-content')?.value?.trim();
+  if (!title) { alert('Title is required'); return; }
+  if (!content) { alert('Plan content is required'); return; }
+  const project = document.getElementById('plan-new-project')?.value || '';
+
+  try {
+    const res = await fetch('/api/plans/create', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ title, content, project })
+    });
+    const data = await res.json();
+    if (res.ok) {
+      try { closeModal(); } catch {}
+      refreshPlans();
+      refresh();
+      try { showToast('cmd-toast', 'Plan "' + data.file + '" created — click Execute to convert to PRD', true); } catch {}
+    } else {
+      alert('Failed: ' + (data.error || 'unknown'));
+    }
+  } catch (e) { alert('Error: ' + e.message); }
+}
+
 async function refreshPlans() {
   try {
     const plans = await fetch('/api/plans').then(r => r.json());

package/dashboard/js/render-prs.js

@@ -92,3 +92,54 @@ function openModal(i) {
   if (card) clearNotifBadge(card);
   document.getElementById('modal').classList.add('open');
 }
+
+function openAddPrModal() {
+  const projOpts = (typeof cmdProjects !== 'undefined' ? cmdProjects : []).map(p =>
+    '<option value="' + escHtml(p) + '">' + escHtml(p) + '</option>'
+  ).join('');
+  const inputStyle = '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';
+
+  document.getElementById('modal-title').textContent = 'Link Pull Request';
+  document.getElementById('modal-body').innerHTML =
+    '<div style="display:flex;flex-direction:column;gap:10px">' +
+      '<label style="color:var(--text);font-size:var(--text-md)">PR URL <input id="pr-link-url" style="' + inputStyle + '" placeholder="https://github.com/org/repo/pull/123"></label>' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Title <input id="pr-link-title" style="' + inputStyle + '" placeholder="Short description (optional — auto-detected from URL)"></label>' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Project <select id="pr-link-project" style="' + inputStyle + '"><option value="">Auto / Central</option>' + projOpts + '</select></label>' +
+      '<label style="color:var(--text);font-size:var(--text-md)">Context <textarea id="pr-link-context" rows="3" style="' + inputStyle + ';resize:vertical" placeholder="Why are you linking this? What should agents know about it?"></textarea></label>' +
+      '<label style="display:flex;align-items:center;gap:8px;color:var(--text);font-size:var(--text-md);margin-top:4px;cursor:pointer">' +
+        '<input type="checkbox" id="pr-link-observe" style="width:16px;height:16px;accent-color:var(--blue)">' +
+        '<span>Auto-observe <span style="color:var(--muted);font-weight:400">(monitor builds, resolve comments, fix failures)</span></span>' +
+      '</label>' +
+      '<div style="font-size:11px;color:var(--muted);margin-top:-4px;padding-left:24px">Off = context only (e.g. teammate\'s PR). On = agents actively monitor and fix issues.</div>' +
+      '<div style="display:flex;justify-content:flex-end;gap:8px;margin-top:8px">' +
+        '<button onclick="closeModal()" class="pr-pager-btn">Cancel</button>' +
+        '<button onclick="_submitLinkPr()" style="padding:6px 16px;background:var(--blue);color:#fff;border:none;border-radius:var(--radius-sm);cursor:pointer">Link PR</button>' +
+      '</div>' +
+    '</div>';
+  document.getElementById('modal').classList.add('open');
+  setTimeout(() => document.getElementById('pr-link-url')?.focus(), 100);
+}
+
+async function _submitLinkPr() {
+  const url = document.getElementById('pr-link-url')?.value?.trim();
+  if (!url) { alert('PR URL is required'); return; }
+  const title = document.getElementById('pr-link-title')?.value?.trim() || '';
+  const project = document.getElementById('pr-link-project')?.value || '';
+  const context = document.getElementById('pr-link-context')?.value || '';
+  const autoObserve = document.getElementById('pr-link-observe')?.checked || false;
+
+  try {
+    const res = await fetch('/api/pull-requests/link', {
+      method: 'POST', headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ url, title, project, context, autoObserve })
+    });
+    const data = await res.json();
+    if (res.ok) {
+      try { closeModal(); } catch {}
+      refresh();
+      try { showToast('cmd-toast', 'PR ' + (data.id || '') + ' linked' + (autoObserve ? ' (auto-observe on)' : ''), true); } catch {}
+    } else {
+      alert('Failed: ' + (data.error || 'unknown'));
+    }
+  } catch (e) { alert('Error: ' + e.message); }
+}

package/dashboard/pages/plans.html

@@ -1,4 +1,6 @@
       <section>
-        <h2>Plans <span class="count" id="plans-count">0</span></h2>
+        <h2>Plans <span class="count" id="plans-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="openCreatePlanModal()">+ New Plan</button>
+        </h2>
         <div id="plans-list"><p class="empty">No plans yet. Use /plan in the command center to create one.</p></div>
       </section>

package/dashboard/pages/prs.html

@@ -1,4 +1,6 @@
       <section class="pr-panel" id="pr-section">
-        <h2>Pull Requests <span class="count" id="pr-count">0</span></h2>
+        <h2>Pull Requests <span class="count" id="pr-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="openAddPrModal()">+ Link PR</button>
+        </h2>
         <div id="pr-content"><p class="pr-empty">No pull requests yet.</p></div>
       </section>

package/dashboard.js

@@ -2916,6 +2916,65 @@ What would you like to discuss or change? When you're happy, say "approve" and I
     { method: 'POST', path: '/api/prd/regenerate', desc: 'Regenerate PRD from revised source plan', params: 'file', handler: handlePrdRegenerate },
 
     // Agents
+    { method: 'POST', path: '/api/pull-requests/link', desc: 'Manually link an external PR for tracking', params: 'url, title?, project?, autoObserve?, context?', handler: async (req, res) => {
+      const body = await readBody(req);
+      const { url, title, project: projectName, autoObserve, context } = body;
+      if (!url) return jsonReply(res, 400, { error: 'url required' });
+
+      // Determine project
+      reloadConfig();
+      const projects = shared.getProjects(CONFIG);
+      const targetProject = projectName ? projects.find(p => p.name?.toLowerCase() === projectName.toLowerCase()) : projects[0];
+      const prPath = targetProject ? shared.projectPrPath(targetProject) : path.join(MINIONS_DIR, 'pull-requests.json');
+      const prs = JSON.parse(safeRead(prPath) || '[]');
+
+      // Extract PR number from URL
+      const prNumMatch = url.match(/\/pull\/(\d+)|pullrequest\/(\d+)/);
+      const prNum = prNumMatch ? (prNumMatch[1] || prNumMatch[2]) : Date.now().toString().slice(-6);
+      const prId = 'PR-' + prNum;
+
+      if (prs.some(p => p.id === prId || p.url === url)) return jsonReply(res, 400, { error: 'PR already tracked' });
+
+      prs.push({
+        id: prId,
+        title: (title || 'Linked PR #' + prNum).slice(0, 120),
+        agent: 'human',
+        branch: '',
+        reviewStatus: autoObserve ? 'pending' : 'none',
+        status: autoObserve ? 'active' : 'linked',
+        created: new Date().toISOString().slice(0, 10),
+        url,
+        prdItems: [],
+        _manual: true,
+        _autoObserve: !!autoObserve,
+        _context: context || '',
+      });
+      safeWrite(prPath, prs);
+      invalidateStatusCache();
+      return jsonReply(res, 200, { ok: true, id: prId });
+    }},
+
+    { method: 'POST', path: '/api/plans/create', desc: 'Create a plan from user-provided content', params: 'title, content, project?', handler: async (req, res) => {
+      const body = await readBody(req);
+      const { title, content, project: projectName } = body;
+      if (!title || !content) return jsonReply(res, 400, { error: 'title and content required' });
+
+      const plansDir = path.join(MINIONS_DIR, 'plans');
+      if (!fs.existsSync(plansDir)) fs.mkdirSync(plansDir, { recursive: true });
+      const slug = title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '').slice(0, 50);
+      const date = new Date().toISOString().slice(0, 10);
+      const filename = `${slug}-${date}.md`;
+      const filePath = shared.uniquePath(path.join(plansDir, filename));
+
+      const header = `# ${title}\n\n` +
+        (projectName ? `**Project:** ${projectName}\n` : '') +
+        `**Created:** ${date}\n**By:** human teammate\n\n---\n\n`;
+      safeWrite(filePath, header + content);
+
+      invalidateStatusCache();
+      return jsonReply(res, 200, { ok: true, file: path.basename(filePath) });
+    }},
+
     { method: 'POST', path: '/api/agents/steer', desc: 'Inject steering message into a running agent', params: 'agent, message', handler: async (req, res) => {
       const body = await readBody(req);
       const { agent: agentId, message } = body;

package/engine.js

@@ -592,16 +592,23 @@ function buildAgentContext(agentId, config, project) {
     context += `## Recently Completed\n\n${recentCompleted.join('\n')}\n\n`;
   }
 
-  // Active PRs across projects — coordination awareness
+  // Active + linked PRs across projects — coordination awareness
   const projects = getProjects(config);
   const allPrs = [];
   for (const p of projects) {
-    const prs = getPrs(p).filter(pr => pr.status === 'active');
+    const prs = getPrs(p).filter(pr => pr.status === 'active' || pr.status === 'linked');
     for (const pr of prs) allPrs.push({ ...pr, _project: p.name });
   }
+  // Also check central pull-requests.json
+  try {
+    const centralPrs = safeJson(path.join(MINIONS_DIR, 'pull-requests.json')) || [];
+    for (const pr of centralPrs.filter(pr => pr.status === 'active' || pr.status === 'linked')) {
+      if (!allPrs.some(p => p.id === pr.id)) allPrs.push({ ...pr, _project: 'central' });
+    }
+  } catch {}
   if (allPrs.length > 0) {
     const prLines = allPrs.map(pr =>
-      `- **${pr.id}** (${pr._project}): ${(pr.title || '').slice(0, 80)} [${pr.reviewStatus || 'pending'}${pr.buildStatus === 'failing' ? ', BUILD FAILING' : ''}]${pr.branch ? ' branch: `' + pr.branch + '`' : ''}`
+      `- **${pr.id}** (${pr._project}): ${(pr.title || '').slice(0, 80)} [${pr.status === 'linked' ? 'context-only' : (pr.reviewStatus || 'pending')}${pr.buildStatus === 'failing' ? ', BUILD FAILING' : ''}]${pr.branch ? ' branch: `' + pr.branch + '`' : ''}${pr._context ? ' — ' + pr._context.slice(0, 100) : ''}`
     );
     context += `## Active Pull Requests\n\n${prLines.join('\n')}\n\n`;
   }

package/package.json

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