@yemi33/minions 0.1.1808 → 0.1.1809

package/CHANGELOG.md

@@ -1,6 +1,9 @@
 # Changelog
 
-## 0.1.1808 (2026-05-08)
+## 0.1.1809 (2026-05-08)
+
+### Features
+- add CC action intent fallback (#2234)
 
 ### Fixes
 -  Plan-to-PRD conversion can override explicit plan project with contextual project (#2235)

package/dashboard/js/command-center.js

@@ -567,7 +567,8 @@ function ccAddMessage(role, html, skipSave, targetTabId, meta) {
   }
 }
 
-async function ccSend() {
+async function ccSend(options) {
+  var intentMetadata = options && options.intentMetadata ? options.intentMetadata : null;
   var input = document.getElementById('cc-input');
   var message = input.value.trim();
   if (!message) return;
@@ -580,11 +581,11 @@ async function ccSend() {
 
   // If this tab is already processing, queue the message
   if (tab._sending) {
-    tab._queue.push(message);
+    tab._queue.push({ message: message, intentMetadata: intentMetadata });
     _renderQueueIndicator();
     return;
   }
-  var wasAborted = await _ccDoSend(message, false, originTabId);
+  var wasAborted = await _ccDoSend(message, false, originTabId, intentMetadata);
 
   // Flush queued messages to the ORIGINAL tab, even if user switched tabs
   while (tab._queue && tab._queue.length > 0) {
@@ -592,8 +593,10 @@ async function ccSend() {
       await new Promise(function(r) { setTimeout(r, 1500); });
     }
     var next = tab._queue.shift();
+    var nextMessage = typeof next === 'string' ? next : next.message;
+    var nextIntentMetadata = typeof next === 'string' ? null : (next.intentMetadata || null);
     _renderQueueIndicator();
-    wasAborted = await _ccDoSend(next, false, originTabId);
+    wasAborted = await _ccDoSend(nextMessage, false, originTabId, nextIntentMetadata);
   }
 }
 
@@ -608,13 +611,13 @@ function _renderQueueIndicator() {
     var el = document.createElement('div');
     el.className = 'cc-queue-item';
     el.style.cssText = 'padding:8px 12px;border-radius:8px;font-size:12px;line-height:1.6;max-width:95%;align-self:flex-end;background:var(--blue);color:#fff;opacity:0.5;order:9999';
-    el.innerHTML = escHtml(m) + '<div style="font-size:9px;opacity:0.7;font-style:italic;margin-top:2px">queued</div>';
+    el.innerHTML = escHtml(typeof m === 'string' ? m : m.message) + '<div style="font-size:9px;opacity:0.7;font-style:italic;margin-top:2px">queued</div>';
     msgs.appendChild(el);
   });
   if (msgs.scrollHeight - msgs.scrollTop - msgs.clientHeight < 150) msgs.scrollTop = msgs.scrollHeight;
 }
 
-async function _ccDoSend(message, skipUserMsg, forceTabId) {
+async function _ccDoSend(message, skipUserMsg, forceTabId, intentMetadata) {
   // Client-side /pin and /unpin — no LLM round-trip needed
   var pinMatch = message.match(/^\/(pin|unpin)\s+(.+)/i);
   if (pinMatch) {
@@ -762,7 +765,7 @@ async function _ccDoSend(message, skipUserMsg, forceTabId) {
       if (!isReconnect && res.status === 429 && (!activeTab._429retries || activeTab._429retries < 3)) {
         activeTab._429retries = (activeTab._429retries || 0) + 1;
         await new Promise(function(r) { setTimeout(r, 1500); });
-        return await _ccConsumeStream({ message: message, tabId: activeTabId, sessionId: activeTab.sessionId || null, transcript: _ccBuildTranscript(activeTab) }, false);
+        return await _ccConsumeStream({ message: message, tabId: activeTabId, sessionId: activeTab.sessionId || null, transcript: _ccBuildTranscript(activeTab), intentMetadata: intentMetadata || null }, false);
       }
       activeTab._429retries = 0;
       var errText = await res.text();
@@ -871,7 +874,7 @@ async function _ccDoSend(message, skipUserMsg, forceTabId) {
     while (true) {
       var consume = await _ccConsumeStream(
         reconnectAttempts === 0
-          ? { message: message, tabId: activeTabId, sessionId: activeTab.sessionId || null, transcript: _ccBuildTranscript(activeTab) }
+          ? { message: message, tabId: activeTabId, sessionId: activeTab.sessionId || null, transcript: _ccBuildTranscript(activeTab), intentMetadata: intentMetadata || null }
           : { tabId: activeTabId, sessionId: activeTab.sessionId || null, reconnect: true },
         reconnectAttempts > 0
       );

package/dashboard/js/command-input.js

@@ -134,12 +134,13 @@ async function cmdSubmit() {
   const input = document.getElementById('cmd-input');
   const raw = input.value.trim();
   if (!raw) return showToast('cmd-toast', 'Type something first', false);
+  const parsed = cmdParseInput(raw);
 
   // Route to Command Center panel
   input.value = '';
   if (!_ccOpen) toggleCommandCenter();
   document.getElementById('cc-input').value = raw;
-  ccSend();
+  ccSend({ intentMetadata: parsed });
   cmdSaveHistory(raw, 'cc');
   return;
 }

package/dashboard/js/modal-qa.js

@@ -344,7 +344,7 @@ function _qaBuildAssistantHtml(text, opts) {
     '</div>';
 }
 
-const QA_WORK_ITEM_ACTION_TYPES = new Set(['dispatch', 'fix', 'implement', 'explore', 'review', 'test']);
+const QA_WORK_ITEM_ACTION_TYPES = new Set(['dispatch', 'fix', 'explore', 'review', 'test']);
 
 function _qaActionFeedbackHandled(action, actionResult) {
   const type = String(actionResult?.type || action?.type || '');

package/dashboard.js

@@ -1815,6 +1815,7 @@ function _extractActionsJson(segment) {
 }
 
 const CC_DISPATCH_ACTION_ALIASES = new Set(['fix', 'explore', 'review', 'test']);
+const CC_ACTION_INTENT_WORK_TYPES = new Set(['fix', 'implement', 'explore', 'review', 'test']);
 
 function normalizeCCAction(action) {
   if (!action || typeof action !== 'object') return action;
@@ -1827,6 +1828,161 @@ function normalizeCCAction(action) {
   return { ...action, type: 'dispatch', workType: action.workType || type };
 }
 
+function _ccCleanIntentString(value, max = 500) {
+  if (typeof value !== 'string') return '';
+  return value.replace(/[\0\r\n]+/g, ' ').replace(/\s+/g, ' ').trim().slice(0, max);
+}
+
+function _ccNormalizeIntentMetadata(meta) {
+  if (!meta || typeof meta !== 'object' || Array.isArray(meta)) return {};
+  const out = {};
+  for (const key of ['intent', 'type', 'title', 'description', 'priority', 'project', 'branchStrategy', 'branch_strategy']) {
+    const value = _ccCleanIntentString(meta[key], key === 'description' ? 2000 : 300);
+    if (value) out[key] = value;
+  }
+  if (Array.isArray(meta.agents)) {
+    out.agents = meta.agents.map(a => _ccCleanIntentString(a, 80)).filter(Boolean);
+  }
+  if (Array.isArray(meta.projects)) {
+    out.projects = meta.projects.map(p => _ccCleanIntentString(p, 120)).filter(Boolean);
+  }
+  if (meta.fanout === true) out.fanout = true;
+  return out;
+}
+
+function _messageExplicitlyRequestsMinionsOrchestration(message) {
+  const text = String(message || '').toLowerCase();
+  if (!text.trim()) return false;
+  return [
+    /\b(?:dispatch|delegate|assign|queue)\b/,
+    /\b(?:create|open|file)\s+(?:a\s+)?(?:work\s*item|task)\b/,
+    /\b(?:have|ask|tell)\s+(?:minions|an?\s+agent|[a-z][\w-]*)\s+(?:to\s+)?(?:fix|implement|review|test|explore|investigate)\b/,
+    /\bminions\b[^.?!\n]*\b(?:fix|implement|review|test|explore|investigate|plan)\b/,
+    /\b(?:create|make|draft|write)\s+(?:a\s+)?minions?\s+plan\b/,
+  ].some(pattern => pattern.test(text));
+}
+
+function _ccInferMessageActionIntent(message, source = 'command-center') {
+  const text = String(message || '').trim();
+  const lower = text.toLowerCase();
+  if (!lower) return null;
+  if (source === 'doc-chat' && !_messageExplicitlyRequestsMinionsOrchestration(text)) return null;
+  if (/^\/plan\b/.test(lower) || /\b(?:make|create|draft|write|design|come up with)\s+(?:a\s+)?plan\b/.test(lower) || /\bplan\s+(?:this|that|it|for|how|out)\b/.test(lower)) {
+    return { kind: 'plan' };
+  }
+  const workPatterns = [
+    ['fix', /\b(?:fix|repair|resolve|patch|debug)\b|\b(?:bug|broken|crash|error|regression|failing|failure)\b/],
+    ['implement', /\b(?:implement|build|add|create|ship)\b/],
+    ['review', /\b(?:review|code review|inspect|audit)\b/],
+    ['test', /\b(?:test|verify|validate|run tests?|write tests?|add tests?|coverage|build)\b/],
+    ['explore', /\b(?:explore|investigate|research|analyze|understand|look into|map out|survey)\b/],
+  ];
+  for (const [workType, pattern] of workPatterns) {
+    if (pattern.test(lower)) return { kind: 'work-item', workType };
+  }
+  return null;
+}
+
+function _ccInferMetadataActionIntent(meta) {
+  if (meta.intent === 'plan') return { kind: 'plan' };
+  if (meta.intent === 'work-item' && CC_ACTION_INTENT_WORK_TYPES.has(String(meta.type || '').toLowerCase())) {
+    return { kind: 'work-item', workType: String(meta.type).toLowerCase() };
+  }
+  return null;
+}
+
+function _ccActionIntentTargetText(message, intent) {
+  let text = _ccCleanIntentString(message, 500);
+  text = text
+    .replace(/^\/(?:plan|fix|implement|review|test|explore)\s+/i, '')
+    .replace(/^(?:please\s+)?(?:dispatch|delegate|assign|queue)\s+(?:a\s+|an\s+)?(?:work\s*item|task|agent)?\s*(?:to\s+)?/i, '')
+    .replace(/^(?:please\s+)?(?:create|open|file)\s+(?:a\s+)?(?:work\s*item|task)\s+(?:to\s+|for\s+)?/i, '')
+    .replace(/^(?:please\s+)?(?:have|ask|tell)\s+(?:minions|an?\s+agent|[a-z][\w-]*)\s+(?:to\s+)?/i, '')
+    .replace(/^(?:please\s+)?/, '')
+    .trim();
+  if (intent?.kind === 'plan') {
+    text = text.replace(/^(?:make|create|draft|write|design|come up with)\s+(?:a\s+)?plan\s+(?:for\s+|to\s+|about\s+)?/i, '')
+      .replace(/^plan\s+(?:out\s+)?(?:for\s+|how\s+to\s+|this\s+|that\s+|it\s+)?/i, '');
+  } else if (intent?.workType) {
+    const workType = intent.workType;
+    const verbPattern = {
+      fix: /^(?:fix|repair|resolve|patch|debug)\s+(?:the\s+|a\s+|an\s+)?/i,
+      implement: /^(?:implement|build|add|create|ship)\s+(?:the\s+|a\s+|an\s+)?/i,
+      review: /^(?:review|code review|inspect|audit)\s+(?:the\s+|a\s+|an\s+)?/i,
+      test: /^(?:test|verify|validate|run tests?\s+(?:for\s+|on\s+)?|write tests?\s+(?:for\s+)?|add tests?\s+(?:for\s+)?)\s*(?:the\s+|a\s+|an\s+)?/i,
+      explore: /^(?:explore|investigate|research|analyze|understand|look into|map out|survey)\s+(?:the\s+|a\s+|an\s+)?/i,
+    }[workType];
+    if (verbPattern) text = text.replace(verbPattern, '');
+    text = text.replace(/^(?:a\s+)?(?:fix|review|test|implementation|exploration|investigation)\s+(?:for\s+|to\s+|of\s+)?/i, '');
+  }
+  return text.replace(/^(?:for|to|of|on|about)\s+/i, '').trim();
+}
+
+function _ccIntentHasConcreteTarget(message, metadataTitle, intent) {
+  const raw = String(message || '');
+  if (/\b(?:PR|pull request|issue)\s*#?\d+\b/i.test(raw) || /\bW-[a-z0-9][a-z0-9-]*\b/i.test(raw) || /https?:\/\//i.test(raw)) return true;
+  const target = _ccActionIntentTargetText(metadataTitle || raw, intent)
+    .replace(/[.!?]+$/g, '')
+    .trim()
+    .toLowerCase();
+  if (!target) return false;
+  if (/^(?:this|that|it|these|those|same|above|the above|here|there)(?:\s+(?:one|thing|issue|bug|task|request|change|pr|pull request|code|test|plan|doc|document|file))?$/.test(target)) {
+    return false;
+  }
+  return target.length >= 3;
+}
+
+function _ccIntentTitle(message, metadataTitle, intent) {
+  const metaTitle = _ccCleanIntentString(metadataTitle, 300);
+  if (metaTitle && _ccIntentHasConcreteTarget(message, metaTitle, intent)) return metaTitle;
+  const cleaned = _ccCleanIntentString(message, 300).replace(/^\/plan\s+/i, 'plan ');
+  if (!cleaned) return '';
+  return cleaned.charAt(0).toUpperCase() + cleaned.slice(1);
+}
+
+function _ccFallbackMissingTargetError(intent) {
+  const label = intent?.kind === 'plan' ? 'plan' : (intent?.workType || 'dispatch');
+  return `Missing target for ${label} request. Specify a concrete title, PR/work item, file, or feature to ${label}.`;
+}
+
+function _actionsWithIntentFallback(actions, { message = '', intentMetadata = null, source = 'command-center' } = {}) {
+  const existing = Array.isArray(actions) ? actions : [];
+  if (existing.length > 0) return existing;
+  const meta = _ccNormalizeIntentMetadata(intentMetadata);
+  const messageIntent = _ccInferMessageActionIntent(message, source);
+  const metadataIntent = source === 'doc-chat' ? null : _ccInferMetadataActionIntent(meta);
+  const intent = messageIntent || metadataIntent;
+  if (!intent) return existing;
+
+  const title = _ccIntentTitle(message, meta.title, intent);
+  const hasTarget = _ccIntentHasConcreteTarget(message, meta.title || title, intent);
+  const description = meta.description || _ccCleanIntentString(message, 2000);
+  const common = {
+    ...(title ? { title } : {}),
+    ...(description ? { description } : {}),
+    ...(meta.priority ? { priority: meta.priority } : {}),
+    ...(meta.project ? { project: meta.project } : {}),
+    ...(Array.isArray(meta.agents) && meta.agents.length ? { agents: meta.agents } : {}),
+    ...(meta.fanout ? { scope: 'fan-out' } : {}),
+  };
+  if (intent.kind === 'plan') {
+    const action = {
+      type: 'plan',
+      ...common,
+      branchStrategy: meta.branchStrategy || meta.branch_strategy || 'parallel',
+    };
+    if (!hasTarget) action._intentFallbackError = _ccFallbackMissingTargetError(intent);
+    return [action];
+  }
+  const action = {
+    type: 'dispatch',
+    workType: intent.workType,
+    ...common,
+  };
+  if (!hasTarget) action._intentFallbackError = _ccFallbackMissingTargetError(intent);
+  return [action];
+}
+
 function parseCCActions(text) {
   let actions = [];
   let displayText = stripCCActionsForDisplay(text);
@@ -2262,6 +2418,8 @@ function _ccValidateAction(action) {
     case 'dispatch': case 'fix': case 'explore': case 'review': case 'test':
       if (!action.title || typeof action.title !== 'string' || !action.title.trim()) return `${action.type} action missing required field: title`;
       return null;
+    case 'implement':
+      return 'Unsupported action type "implement"; use type="dispatch" with workType="implement".';
     case 'build-and-test':
       if (!action.pr) return 'build-and-test action missing required field: pr';
       return null;
@@ -2586,6 +2744,15 @@ async function executeCCActions(actions, { source = 'command-center', inferredPr
   const results = [];
   for (const rawAction of actions) {
     const action = normalizeCCAction(rawAction);
+    if (action?._intentFallbackError) {
+      results.push({
+        type: action.type || 'dispatch',
+        ...(action.workType ? { workType: action.workType } : {}),
+        error: action._intentFallbackError,
+        missingTarget: true,
+      });
+      continue;
+    }
     const validationError = _ccValidateAction(action);
     if (validationError) {
       results.push({ type: action?.type || 'unknown', error: validationError });
@@ -2887,7 +3054,7 @@ async function executeDocChatActions(actions, { filePath = null } = {}) {
   return executeCCActions(actions, { source: 'doc-chat', inferredProject: _inferDocChatProject(filePath) });
 }
 
-const DOC_CHAT_WORK_ITEM_ACTION_TYPES = new Set(['dispatch', 'fix', 'implement', 'explore', 'review', 'test']);
+const DOC_CHAT_WORK_ITEM_ACTION_TYPES = new Set(['dispatch', 'fix', 'explore', 'review', 'test']);
 
 function _buildDocChatActionFeedback(actions, actionResults) {
   if (!Array.isArray(actions) || !Array.isArray(actionResults)) return [];
@@ -5913,7 +6080,7 @@ What would you like to discuss or change? When you're happy, say "approve" and I
         }
       }
 
-      const { answer, content, actions, actionParseError, partial, warning, toolUses, error: ccError } = await ccDocCall({
+      let { answer, content, actions, actionParseError, partial, warning, toolUses, error: ccError } = await ccDocCall({
         message: body.message, document: currentContent, title: body.title,
         filePath: body.filePath, selection: body.selection, canEdit, isJson,
         model: body.model || undefined,
@@ -5921,6 +6088,7 @@ What would you like to discuss or change? When you're happy, say "approve" and I
         transcript: body.transcript,
         onAbortReady: (abort) => { _docAbort = abort; },
       });
+      actions = _actionsWithIntentFallback(actions, { message: body.message, source: 'doc-chat' });
       const actionResults = await executeDocChatActions(actions, { filePath: body.filePath });
       const actionFeedback = _buildDocChatActionFeedback(actions, actionResults);
       const finalize = _finalizeDocChatEdit({
@@ -6005,7 +6173,7 @@ What would you like to discuss or change? When you're happy, say "approve" and I
 
       try {
 
-        const { answer, content, actions, actionParseError, partial, warning, toolUses, error: ccError } = await ccDocCallStreaming({
+        let { answer, content, actions, actionParseError, partial, warning, toolUses, error: ccError } = await ccDocCallStreaming({
           message: body.message, document: currentContent, title: body.title,
           filePath: body.filePath, selection: body.selection, canEdit, isJson,
           model: body.model || undefined,
@@ -6016,6 +6184,7 @@ What would you like to discuss or change? When you're happy, say "approve" and I
           onToolUse: (name, input) => { writeDocEvent({ type: 'tool', name, input: _lightToolInput(input) }); },
           onRetry: (attempt) => { writeDocEvent({ type: 'progress', attempt }); },
         });
+        actions = _actionsWithIntentFallback(actions, { message: body.message, source: 'doc-chat' });
         const actionResults = await executeDocChatActions(actions, { filePath: body.filePath });
         const actionFeedback = _buildDocChatActionFeedback(actions, actionResults);
         const finalize = _finalizeDocChatEdit({
@@ -6545,6 +6714,11 @@ What would you like to discuss or change? When you're happy, say "approve" and I
         }
 
         const parsed = parseCCActions(result.text);
+        parsed.actions = _actionsWithIntentFallback(parsed.actions, {
+          message: body.message,
+          intentMetadata: body.intentMetadata,
+          source: 'command-center',
+        });
         const toolUses = Array.isArray(result.toolUses) ? result.toolUses : _extractToolUsesFromRaw(result.raw);
         // Safety net: detect /loop invocation and convert to create-watch
         const _loopWatch = _detectLoopInvocation(parsed.text, parsed.actions, toolUses, body.message);
@@ -6874,6 +7048,11 @@ What would you like to discuss or change? When you're happy, say "approve" and I
 
         // Send final result with actions — execute server-side first
         let { text: displayText, actions, _actionParseError } = parseCCActions(result.text);
+        actions = _actionsWithIntentFallback(actions, {
+          message: body.message,
+          intentMetadata: body.intentMetadata,
+          source: 'command-center',
+        });
         // Safety net: detect /loop invocation and convert to create-watch
         const _loopWatch = _detectLoopInvocation(displayText, actions, toolUses, body.message);
         if (_loopWatch) {
@@ -8511,6 +8690,7 @@ module.exports = {
   _resolveSkillReadPath,
   DOC_CHAT_DOCUMENT_DELIMITER,
   _ccValidateAction,
+  _actionsWithIntentFallback,
   _messageExplicitlyRequestsMonitoring,
   _filterImplicitPostDispatchActions,
   _findDuplicateWorkItemCreate: findDuplicateWorkItemCreate,

package/engine/copilot-models.json

@@ -1,5 +1,5 @@
 {
   "runtime": "copilot",
   "models": null,
-  "cachedAt": "2026-05-08T20:57:25.233Z"
+  "cachedAt": "2026-05-08T20:58:39.806Z"
 }

package/package.json

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