@yemi33/minions 0.1.2194 → 0.1.2195

package/dashboard/js/command-center.js

@@ -476,6 +476,8 @@ function ccAbort() {
 
 function toggleCommandCenter() {
   _ccOpen = !_ccOpen;
+  // Opening CC means the operator found it — retire the first-use coachmark.
+  if (_ccOpen && typeof dismissCcHint === 'function') dismissCcHint();
   var drawer = document.getElementById('cc-drawer');
   var overlay = document.getElementById('cc-overlay');
   if (_ccOpen) ccApplySavedWidth();

package/dashboard/js/fre.js

@@ -188,4 +188,128 @@ function renderFre(statusOrProjects) {
     '</div>';
 }
 
-window.MinionsFre = { renderFre, dismissFre, openSettingsToDefaultCli, _freReset, FRE_DISMISS_KEY };
+// ── Command Center first-use coachmark ──────────────────────────────────────
+// A small popup anchored under the Command Center header button, shown to
+// brand-new operators who have never used CC. Teaches the primary entry point:
+// "prompt the Command Center to ask it to dispatch work." Self-contained and
+// idempotent — safe to call renderCcHint() every refresh tick.
+//
+// Trigger: NOT dismissed AND the operator has never sent a CC message (no
+// 'cc-tabs' entry carries any messages). Auto-suppressed while the CC drawer
+// is open. Dismissed permanently when the user opens CC (see
+// toggleCommandCenter in command-center.js) or clicks "Got it".
+
+const CC_HINT_DISMISS_KEY = 'minions_cc_hint_dismissed';
+const CC_HINT_MOUNT_ID = 'cc-hint-coachmark';
+
+function _ccHintIsDismissed() {
+  try { return localStorage.getItem(CC_HINT_DISMISS_KEY) === '1'; } catch { return false; }
+}
+
+// "Brand new" = the operator has never sent a Command Center message. Reads the
+// same 'cc-tabs' localStorage key command-center.js persists; any tab carrying
+// at least one message means CC has been used and the hint has served its
+// purpose. Absent/empty/parse-error all read as new (fail toward showing).
+function _ccHintUserIsNew() {
+  try {
+    const raw = localStorage.getItem('cc-tabs');
+    if (!raw) return true;
+    const tabs = JSON.parse(raw);
+    if (!Array.isArray(tabs) || tabs.length === 0) return true;
+    return !tabs.some(function(t) { return t && Array.isArray(t.messages) && t.messages.length > 0; });
+  } catch { return true; }
+}
+
+function _ccHintRemove() {
+  const mount = document.getElementById(CC_HINT_MOUNT_ID);
+  if (mount && mount.parentNode) mount.parentNode.removeChild(mount);
+}
+
+function dismissCcHint() {
+  try { localStorage.setItem(CC_HINT_DISMISS_KEY, '1'); } catch { /* expected */ }
+  _ccHintRemove();
+}
+
+// Reset helper (exposed for tests / debugging only). Not wired to UI.
+function _ccHintReset() {
+  try { localStorage.removeItem(CC_HINT_DISMISS_KEY); } catch { /* expected */ }
+}
+
+// Open the Command Center from the coachmark CTA, then dismiss the hint.
+function openCcFromHint() {
+  dismissCcHint();
+  if (typeof toggleCommandCenter === 'function' && !window._ccOpen) {
+    try { toggleCommandCenter(); } catch { /* drawer not mounted yet */ }
+  }
+}
+
+// Re-anchor the coachmark under the CC button. Called on render and on resize.
+function _ccHintPosition() {
+  const mount = document.getElementById(CC_HINT_MOUNT_ID);
+  const btn = document.getElementById('cc-toggle-btn');
+  if (!mount || !btn) return;
+  const rect = btn.getBoundingClientRect();
+  mount.style.top = (rect.bottom + 10) + 'px';
+  // Right-align the card to the button's right edge.
+  mount.style.right = Math.max(8, window.innerWidth - rect.right) + 'px';
+  // Point the caret at the button's horizontal centre.
+  const arrow = document.getElementById('cc-hint-arrow');
+  if (arrow) arrow.style.right = Math.max(12, (rect.width / 2) - 6) + 'px';
+}
+
+let _ccHintResizeBound = false;
+
+// Render the coachmark into document.body. Idempotent — bails out (and removes
+// any stale mount) when dismissed, when CC has been used, when the header
+// button isn't mounted yet, or while the drawer is open.
+function renderCcHint() {
+  if (_ccHintIsDismissed() || !_ccHintUserIsNew()) {
+    _ccHintRemove();
+    return;
+  }
+  const btn = document.getElementById('cc-toggle-btn');
+  if (!btn) return; // header not assembled yet
+  const drawer = document.getElementById('cc-drawer');
+  if (drawer && drawer.style.display === 'flex') {
+    // User already found CC — don't hover the hint over the open drawer.
+    _ccHintRemove();
+    return;
+  }
+
+  let mount = document.getElementById(CC_HINT_MOUNT_ID);
+  if (!mount) {
+    mount = document.createElement('div');
+    mount.id = CC_HINT_MOUNT_ID;
+    mount.style.cssText = [
+      'position:fixed',
+      'z-index:330',
+      'width:260px',
+      'padding:14px 16px',
+      'background:var(--surface)',
+      'border:1px solid var(--blue)',
+      'border-radius:var(--radius-lg)',
+      'box-shadow:var(--shadow-md)',
+      'color:var(--text)',
+      'font-size:var(--text-md)',
+      'line-height:1.5',
+    ].join(';');
+    document.body.appendChild(mount);
+    // eslint-disable-next-line no-unsanitized/property -- reason: static string literal — no user-controlled data is interpolated
+    mount.innerHTML =
+      '<div id="cc-hint-arrow" style="position:absolute;top:-7px;width:12px;height:12px;background:var(--surface);border-left:1px solid var(--blue);border-top:1px solid var(--blue);transform:rotate(45deg)"></div>' +
+      '<div style="font-weight:700;color:var(--blue);margin-bottom:4px">&#x1F44B; Start here</div>' +
+      '<div style="color:var(--text)">Prompt your <strong>Command Center</strong> here to ask it to dispatch work.</div>' +
+      '<div style="display:flex;gap:8px;margin-top:12px">' +
+        '<button onclick="openCcFromHint()" class="btn-primary-solid" style="padding:5px 12px;font-size:var(--text-sm)">Open Command Center</button>' +
+        '<button onclick="dismissCcHint()" style="padding:5px 12px;font-size:var(--text-sm);background:transparent;color:var(--muted);border:1px solid var(--border);border-radius:var(--radius-sm);cursor:pointer">Got it</button>' +
+      '</div>';
+  }
+  _ccHintPosition();
+  if (!_ccHintResizeBound) {
+    _ccHintResizeBound = true;
+    window.addEventListener('resize', _ccHintPosition);
+  }
+}
+
+window.MinionsFre = { renderFre, dismissFre, openSettingsToDefaultCli, _freReset, FRE_DISMISS_KEY,
+  renderCcHint, dismissCcHint, openCcFromHint, _ccHintReset, _ccHintUserIsNew, CC_HINT_DISMISS_KEY };

package/dashboard/js/refresh.js

@@ -612,6 +612,12 @@ function _processStatusUpdate(data, opts) {
   if (typeof renderFre === 'function') {
     _safeRender('fre', function() { renderFre(data); });
   }
+  // Command Center first-use coachmark — anchored under the CC header button
+  // for brand-new operators who have never sent a CC message. Idempotent +
+  // cheap; self-suppresses once CC is used or dismissed.
+  if (typeof renderCcHint === 'function') {
+    _safeRender('ccHint', function() { renderCcHint(); });
+  }
   // Notes file (notes.md) is now sourced from /state/notes.md. Same shape
   // as the legacy /api/status notes slice ({ content, updatedAt }); the
   // ETag mtime is parsed out of the response header for updatedAt.

package/package.json

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