claude-flow 3.7.0-alpha.21 → 3.7.0-alpha.23

package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-tools.js

@@ -109,7 +109,7 @@ export const browserTools = [
     // ==========================================================================
     {
         name: 'browser_open',
-        description: 'Navigate browser to a URL',
+        description: 'Navigate browser to a URL Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['navigation', 'web'],
         inputSchema: {
@@ -163,7 +163,7 @@ export const browserTools = [
     },
     {
         name: 'browser_back',
-        description: 'Navigate back in browser history',
+        description: 'Navigate back in browser history Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['navigation'],
         inputSchema: {
@@ -179,7 +179,7 @@ export const browserTools = [
     },
     {
         name: 'browser_forward',
-        description: 'Navigate forward in browser history',
+        description: 'Navigate forward in browser history Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['navigation'],
         inputSchema: {
@@ -195,7 +195,7 @@ export const browserTools = [
     },
     {
         name: 'browser_reload',
-        description: 'Reload the current page',
+        description: 'Reload the current page Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['navigation'],
         inputSchema: {
@@ -211,7 +211,7 @@ export const browserTools = [
     },
     {
         name: 'browser_close',
-        description: 'Close the browser session',
+        description: 'Close the browser session Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['navigation'],
         inputSchema: {
@@ -232,7 +232,7 @@ export const browserTools = [
     // ==========================================================================
     {
         name: 'browser_snapshot',
-        description: 'Get AI-optimized accessibility tree snapshot with element refs (@e1, @e2, etc.)',
+        description: 'Get AI-optimized accessibility tree snapshot with element refs (@e1, @e2, etc.) Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['snapshot', 'ai'],
         inputSchema: {
@@ -271,7 +271,7 @@ export const browserTools = [
     },
     {
         name: 'browser_screenshot',
-        description: 'Capture screenshot of the page',
+        description: 'Capture screenshot of the page Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['snapshot', 'screenshot'],
         inputSchema: {
@@ -307,7 +307,7 @@ export const browserTools = [
     // ==========================================================================
     {
         name: 'browser_click',
-        description: 'Click an element using ref (@e1) or CSS selector',
+        description: 'Click an element using ref (@e1) or CSS selector Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['interaction'],
         inputSchema: {
@@ -340,7 +340,7 @@ export const browserTools = [
     },
     {
         name: 'browser_fill',
-        description: 'Clear and fill an input element',
+        description: 'Clear and fill an input element Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['interaction', 'form'],
         inputSchema: {
@@ -370,7 +370,7 @@ export const browserTools = [
     },
     {
         name: 'browser_type',
-        description: 'Type text with key events (for autocomplete, etc.)',
+        description: 'Type text with key events (for autocomplete, etc.) Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['interaction', 'form'],
         inputSchema: {
@@ -404,7 +404,7 @@ export const browserTools = [
     },
     {
         name: 'browser_press',
-        description: 'Press a keyboard key',
+        description: 'Press a keyboard key Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['interaction'],
         inputSchema: {
@@ -430,7 +430,7 @@ export const browserTools = [
     },
     {
         name: 'browser_hover',
-        description: 'Hover over an element using ref (@e1) or CSS selector',
+        description: 'Hover over an element using ref (@e1) or CSS selector Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['interaction'],
         inputSchema: {
@@ -456,7 +456,7 @@ export const browserTools = [
     },
     {
         name: 'browser_select',
-        description: 'Select an option from a dropdown',
+        description: 'Select an option from a dropdown Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['interaction', 'form'],
         inputSchema: {
@@ -486,7 +486,7 @@ export const browserTools = [
     },
     {
         name: 'browser_check',
-        description: 'Check a checkbox',
+        description: 'Check a checkbox Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['interaction', 'form'],
         inputSchema: {
@@ -512,7 +512,7 @@ export const browserTools = [
     },
     {
         name: 'browser_uncheck',
-        description: 'Uncheck a checkbox',
+        description: 'Uncheck a checkbox Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['interaction', 'form'],
         inputSchema: {
@@ -538,7 +538,7 @@ export const browserTools = [
     },
     {
         name: 'browser_scroll',
-        description: 'Scroll the page',
+        description: 'Scroll the page Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['interaction'],
         inputSchema: {
@@ -563,7 +563,7 @@ export const browserTools = [
     // ==========================================================================
     {
         name: 'browser_get-text',
-        description: 'Get text content of an element',
+        description: 'Get text content of an element Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['info'],
         inputSchema: {
@@ -589,7 +589,7 @@ export const browserTools = [
     },
     {
         name: 'browser_get-value',
-        description: 'Get value of an input element',
+        description: 'Get value of an input element Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['info', 'form'],
         inputSchema: {
@@ -615,7 +615,7 @@ export const browserTools = [
     },
     {
         name: 'browser_get-title',
-        description: 'Get the page title',
+        description: 'Get the page title Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['info'],
         inputSchema: {
@@ -631,7 +631,7 @@ export const browserTools = [
     },
     {
         name: 'browser_get-url',
-        description: 'Get the current URL',
+        description: 'Get the current URL Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['info'],
         inputSchema: {
@@ -650,7 +650,7 @@ export const browserTools = [
     // ==========================================================================
     {
         name: 'browser_wait',
-        description: 'Wait for a condition',
+        description: 'Wait for a condition Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['wait'],
         inputSchema: {
@@ -702,7 +702,7 @@ export const browserTools = [
     // ==========================================================================
     {
         name: 'browser_eval',
-        description: 'Execute JavaScript in page context',
+        description: 'Execute JavaScript in page context Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['eval', 'js'],
         inputSchema: {
@@ -731,7 +731,7 @@ export const browserTools = [
     // ==========================================================================
     {
         name: 'browser_session-list',
-        description: 'List active browser sessions',
+        description: 'List active browser sessions Use when native WebFetch is wrong because you need real browser automation — JS-heavy SPA scraping, login flows with cookie reuse, replay against DOM-drifted versions, AIDefence PII gating before content reaches Claude. For static HTML pages, native WebFetch is faster and free.',
         category: 'browser',
         tags: ['session'],
         inputSchema: {

package/v3/@claude-flow/cli/dist/src/mcp-tools/claims-tools.js

@@ -55,7 +55,7 @@ function parseClaimant(str) {
 export const claimsTools = [
     {
         name: 'claims_claim',
-        description: 'Claim an issue for work (human or agent)',
+        description: 'Claim an issue for work (human or agent) Use when nothing native covers per-agent capability gating — Claude Code agents have file-system access by default. Pair claims_grant + claims_check before letting an agent run privileged ops. For trusted in-session work, no claims call is needed.',
         category: 'claims',
         inputSchema: {
             type: 'object',
@@ -129,7 +129,7 @@ export const claimsTools = [
     },
     {
         name: 'claims_release',
-        description: 'Release a claim on an issue',
+        description: 'Release a claim on an issue Use when nothing native covers per-agent capability gating — Claude Code agents have file-system access by default. Pair claims_grant + claims_check before letting an agent run privileged ops. For trusted in-session work, no claims call is needed.',
         category: 'claims',
         inputSchema: {
             type: 'object',
@@ -194,7 +194,7 @@ export const claimsTools = [
     },
     {
         name: 'claims_handoff',
-        description: 'Request handoff of an issue to another claimant',
+        description: 'Request handoff of an issue to another claimant Use when nothing native covers per-agent capability gating — Claude Code agents have file-system access by default. Pair claims_grant + claims_check before letting an agent run privileged ops. For trusted in-session work, no claims call is needed.',
         category: 'claims',
         inputSchema: {
             type: 'object',
@@ -278,7 +278,7 @@ export const claimsTools = [
     },
     {
         name: 'claims_accept-handoff',
-        description: 'Accept a pending handoff',
+        description: 'Accept a pending handoff Use when nothing native covers per-agent capability gating — Claude Code agents have file-system access by default. Pair claims_grant + claims_check before letting an agent run privileged ops. For trusted in-session work, no claims call is needed.',
         category: 'claims',
         inputSchema: {
             type: 'object',
@@ -341,7 +341,7 @@ export const claimsTools = [
     },
     {
         name: 'claims_status',
-        description: 'Update claim status',
+        description: 'Update claim status Use when nothing native covers per-agent capability gating — Claude Code agents have file-system access by default. Pair claims_grant + claims_check before letting an agent run privileged ops. For trusted in-session work, no claims call is needed.',
         category: 'claims',
         inputSchema: {
             type: 'object',
@@ -406,7 +406,7 @@ export const claimsTools = [
     },
     {
         name: 'claims_list',
-        description: 'List all claims or filter by criteria',
+        description: 'List all claims or filter by criteria Use when nothing native covers per-agent capability gating — Claude Code agents have file-system access by default. Pair claims_grant + claims_check before letting an agent run privileged ops. For trusted in-session work, no claims call is needed.',
         category: 'claims',
         inputSchema: {
             type: 'object',
@@ -461,7 +461,7 @@ export const claimsTools = [
     },
     {
         name: 'claims_mark-stealable',
-        description: 'Mark an issue as stealable by other agents',
+        description: 'Mark an issue as stealable by other agents Use when nothing native covers per-agent capability gating — Claude Code agents have file-system access by default. Pair claims_grant + claims_check before letting an agent run privileged ops. For trusted in-session work, no claims call is needed.',
         category: 'claims',
         inputSchema: {
             type: 'object',
@@ -529,7 +529,7 @@ export const claimsTools = [
     },
     {
         name: 'claims_steal',
-        description: 'Steal a stealable issue',
+        description: 'Steal a stealable issue Use when nothing native covers per-agent capability gating — Claude Code agents have file-system access by default. Pair claims_grant + claims_check before letting an agent run privileged ops. For trusted in-session work, no claims call is needed.',
         category: 'claims',
         inputSchema: {
             type: 'object',
@@ -600,7 +600,7 @@ export const claimsTools = [
     },
     {
         name: 'claims_stealable',
-        description: 'List all stealable issues',
+        description: 'List all stealable issues Use when nothing native covers per-agent capability gating — Claude Code agents have file-system access by default. Pair claims_grant + claims_check before letting an agent run privileged ops. For trusted in-session work, no claims call is needed.',
         category: 'claims',
         inputSchema: {
             type: 'object',
@@ -636,7 +636,7 @@ export const claimsTools = [
     },
     {
         name: 'claims_load',
-        description: 'Get agent load information',
+        description: 'Get agent load information Use when nothing native covers per-agent capability gating — Claude Code agents have file-system access by default. Pair claims_grant + claims_check before letting an agent run privileged ops. For trusted in-session work, no claims call is needed.',
         category: 'claims',
         inputSchema: {
             type: 'object',
@@ -719,7 +719,7 @@ export const claimsTools = [
     },
     {
         name: 'claims_board',
-        description: 'Get a visual board view of all claims',
+        description: 'Get a visual board view of all claims Use when nothing native covers per-agent capability gating — Claude Code agents have file-system access by default. Pair claims_grant + claims_check before letting an agent run privileged ops. For trusted in-session work, no claims call is needed.',
         category: 'claims',
         inputSchema: {
             type: 'object',
@@ -768,7 +768,7 @@ export const claimsTools = [
     },
     {
         name: 'claims_rebalance',
-        description: 'Suggest or apply load rebalancing across agents',
+        description: 'Suggest or apply load rebalancing across agents Use when nothing native covers per-agent capability gating — Claude Code agents have file-system access by default. Pair claims_grant + claims_check before letting an agent run privileged ops. For trusted in-session work, no claims call is needed.',
         category: 'claims',
         inputSchema: {
             type: 'object',

package/v3/@claude-flow/cli/dist/src/mcp-tools/config-tools.js

@@ -105,7 +105,7 @@ function setNestedValue(obj, key, value) {
 export const configTools = [
     {
         name: 'config_get',
-        description: 'Get configuration value',
+        description: 'Get configuration value Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style files, native Edit is fine.',
         category: 'config',
         inputSchema: {
             type: 'object',
@@ -150,7 +150,7 @@ export const configTools = [
     },
     {
         name: 'config_set',
-        description: 'Set configuration value',
+        description: 'Set configuration value Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style files, native Edit is fine.',
         category: 'config',
         inputSchema: {
             type: 'object',
@@ -198,7 +198,7 @@ export const configTools = [
     },
     {
         name: 'config_list',
-        description: 'List configuration values',
+        description: 'List configuration values Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style files, native Edit is fine.',
         category: 'config',
         inputSchema: {
             type: 'object',
@@ -261,7 +261,7 @@ export const configTools = [
     },
     {
         name: 'config_reset',
-        description: 'Reset configuration to defaults',
+        description: 'Reset configuration to defaults Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style files, native Edit is fine.',
         category: 'config',
         inputSchema: {
             type: 'object',
@@ -322,7 +322,7 @@ export const configTools = [
     },
     {
         name: 'config_export',
-        description: 'Export configuration to JSON',
+        description: 'Export configuration to JSON Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style files, native Edit is fine.',
         category: 'config',
         inputSchema: {
             type: 'object',
@@ -360,7 +360,7 @@ export const configTools = [
     },
     {
         name: 'config_import',
-        description: 'Import configuration from JSON',
+        description: 'Import configuration from JSON Use when native settings.json edits are wrong because the values need to be read by the Ruflo runtime (daemon, MCP server, neural router) — those load via the config_* path, not by re-reading settings.json. For .gitignore / .editorconfig style files, native Edit is fine.',
         category: 'config',
         inputSchema: {
             type: 'object',

package/v3/@claude-flow/cli/dist/src/mcp-tools/coordination-tools.js

@@ -67,7 +67,7 @@ function saveCoordStore(store) {
 export const coordinationTools = [
     {
         name: 'coordination_topology',
-        description: 'Configure swarm topology',
+        description: 'Configure swarm topology Use when native Task is wrong because the work crosses multiple agents that need to vote/sync/load-balance — TodoWrite + a single Task cannot orchestrate consensus. For one-off subtask dispatch, native Task is fine.',
         category: 'coordination',
         inputSchema: {
             type: 'object',
@@ -136,7 +136,7 @@ export const coordinationTools = [
     },
     {
         name: 'coordination_load_balance',
-        description: 'Configure load balancing',
+        description: 'Configure load balancing Use when native Task is wrong because the work crosses multiple agents that need to vote/sync/load-balance — TodoWrite + a single Task cannot orchestrate consensus. For one-off subtask dispatch, native Task is fine.',
         category: 'coordination',
         inputSchema: {
             type: 'object',
@@ -220,7 +220,7 @@ export const coordinationTools = [
     },
     {
         name: 'coordination_sync',
-        description: 'Synchronize state across nodes',
+        description: 'Synchronize state across nodes Use when native Task is wrong because the work crosses multiple agents that need to vote/sync/load-balance — TodoWrite + a single Task cannot orchestrate consensus. For one-off subtask dispatch, native Task is fine.',
         category: 'coordination',
         inputSchema: {
             type: 'object',
@@ -281,7 +281,7 @@ export const coordinationTools = [
     },
     {
         name: 'coordination_node',
-        description: 'Manage coordination nodes',
+        description: 'Manage coordination nodes Use when native Task is wrong because the work crosses multiple agents that need to vote/sync/load-balance — TodoWrite + a single Task cannot orchestrate consensus. For one-off subtask dispatch, native Task is fine.',
         category: 'coordination',
         inputSchema: {
             type: 'object',
@@ -362,7 +362,7 @@ export const coordinationTools = [
     },
     {
         name: 'coordination_consensus',
-        description: 'Manage consensus protocol with BFT, Raft, or Quorum strategies',
+        description: 'Manage consensus protocol with BFT, Raft, or Quorum strategies Use when native Task is wrong because the work crosses multiple agents that need to vote/sync/load-balance — TodoWrite + a single Task cannot orchestrate consensus. For one-off subtask dispatch, native Task is fine.',
         category: 'coordination',
         inputSchema: {
             type: 'object',
@@ -606,7 +606,7 @@ export const coordinationTools = [
     },
     {
         name: 'coordination_orchestrate',
-        description: 'Orchestrate multi-agent coordination',
+        description: 'Orchestrate multi-agent coordination Use when native Task is wrong because the work crosses multiple agents that need to vote/sync/load-balance — TodoWrite + a single Task cannot orchestrate consensus. For one-off subtask dispatch, native Task is fine.',
         category: 'coordination',
         inputSchema: {
             type: 'object',
@@ -673,7 +673,7 @@ export const coordinationTools = [
     },
     {
         name: 'coordination_metrics',
-        description: 'Get coordination metrics',
+        description: 'Get coordination metrics Use when native Task is wrong because the work crosses multiple agents that need to vote/sync/load-balance — TodoWrite + a single Task cannot orchestrate consensus. For one-off subtask dispatch, native Task is fine.',
         category: 'coordination',
         inputSchema: {
             type: 'object',

package/v3/@claude-flow/cli/dist/src/mcp-tools/daa-tools.js

@@ -47,7 +47,7 @@ function saveDAAStore(store) {
 export const daaTools = [
     {
         name: 'daa_agent_create',
-        description: 'Create a decentralized autonomous agent',
+        description: 'Create a decentralized autonomous agent Use when native Task is wrong because you need agents that adapt their cognitive pattern (convergent / divergent / lateral / systems / critical) per-task and share knowledge across the swarm. For static one-shot agents, native Task is fine.',
         category: 'daa',
         inputSchema: {
             type: 'object',
@@ -124,7 +124,7 @@ export const daaTools = [
     },
     {
         name: 'daa_agent_adapt',
-        description: 'Trigger agent adaptation based on feedback',
+        description: 'Trigger agent adaptation based on feedback Use when native Task is wrong because you need agents that adapt their cognitive pattern (convergent / divergent / lateral / systems / critical) per-task and share knowledge across the swarm. For static one-shot agents, native Task is fine.',
         category: 'daa',
         inputSchema: {
             type: 'object',
@@ -187,7 +187,7 @@ export const daaTools = [
     },
     {
         name: 'daa_workflow_create',
-        description: 'Create an autonomous workflow',
+        description: 'Create an autonomous workflow Use when native Task is wrong because you need agents that adapt their cognitive pattern (convergent / divergent / lateral / systems / critical) per-task and share knowledge across the swarm. For static one-shot agents, native Task is fine.',
         category: 'daa',
         inputSchema: {
             type: 'object',
@@ -234,7 +234,7 @@ export const daaTools = [
     },
     {
         name: 'daa_workflow_execute',
-        description: 'Execute a DAA workflow',
+        description: 'Execute a DAA workflow Use when native Task is wrong because you need agents that adapt their cognitive pattern (convergent / divergent / lateral / systems / critical) per-task and share knowledge across the swarm. For static one-shot agents, native Task is fine.',
         category: 'daa',
         inputSchema: {
             type: 'object',
@@ -283,7 +283,7 @@ export const daaTools = [
     },
     {
         name: 'daa_knowledge_share',
-        description: 'Share knowledge between agents',
+        description: 'Share knowledge between agents Use when native Task is wrong because you need agents that adapt their cognitive pattern (convergent / divergent / lateral / systems / critical) per-task and share knowledge across the swarm. For static one-shot agents, native Task is fine.',
         category: 'daa',
         inputSchema: {
             type: 'object',
@@ -355,7 +355,7 @@ export const daaTools = [
     },
     {
         name: 'daa_learning_status',
-        description: 'Get learning status for DAA agents',
+        description: 'Get learning status for DAA agents Use when native Task is wrong because you need agents that adapt their cognitive pattern (convergent / divergent / lateral / systems / critical) per-task and share knowledge across the swarm. For static one-shot agents, native Task is fine.',
         category: 'daa',
         inputSchema: {
             type: 'object',
@@ -411,7 +411,7 @@ export const daaTools = [
     },
     {
         name: 'daa_cognitive_pattern',
-        description: 'Analyze or change cognitive patterns',
+        description: 'Analyze or change cognitive patterns Use when native Task is wrong because you need agents that adapt their cognitive pattern (convergent / divergent / lateral / systems / critical) per-task and share knowledge across the swarm. For static one-shot agents, native Task is fine.',
         category: 'daa',
         inputSchema: {
             type: 'object',
@@ -481,7 +481,7 @@ export const daaTools = [
     },
     {
         name: 'daa_performance_metrics',
-        description: 'Get DAA performance metrics',
+        description: 'Get DAA performance metrics Use when native Task is wrong because you need agents that adapt their cognitive pattern (convergent / divergent / lateral / systems / critical) per-task and share knowledge across the swarm. For static one-shot agents, native Task is fine.',
         category: 'daa',
         inputSchema: {
             type: 'object',

package/v3/@claude-flow/cli/dist/src/mcp-tools/embeddings-tools.js

@@ -106,7 +106,7 @@ function cosineSimilarity(a, b) {
 export const embeddingsTools = [
     {
         name: 'embeddings_init',
-        description: 'Initialize the ONNX embedding subsystem with hyperbolic support',
+        description: 'Initialize the ONNX embedding subsystem with hyperbolic support Use when text similarity matters beyond keyword match — native Grep finds exact strings, embeddings find meaning. Pair with memory_store / agentdb_pattern-search to land the vector against your knowledge base. For literal symbol search, native Grep is faster.',
         category: 'embeddings',
         inputSchema: {
             type: 'object',
@@ -200,7 +200,7 @@ export const embeddingsTools = [
     },
     {
         name: 'embeddings_generate',
-        description: 'Generate embeddings for text (Euclidean or hyperbolic)',
+        description: 'Generate embeddings for text (Euclidean or hyperbolic) Use when text similarity matters beyond keyword match — native Grep finds exact strings, embeddings find meaning. Pair with memory_store / agentdb_pattern-search to land the vector against your knowledge base. For literal symbol search, native Grep is faster.',
         category: 'embeddings',
         inputSchema: {
             type: 'object',
@@ -265,7 +265,7 @@ export const embeddingsTools = [
     },
     {
         name: 'embeddings_compare',
-        description: 'Compare similarity between two texts',
+        description: 'Compare similarity between two texts Use when text similarity matters beyond keyword match — native Grep finds exact strings, embeddings find meaning. Pair with memory_store / agentdb_pattern-search to land the vector against your knowledge base. For literal symbol search, native Grep is faster.',
         category: 'embeddings',
         inputSchema: {
             type: 'object',
@@ -354,7 +354,7 @@ export const embeddingsTools = [
     },
     {
         name: 'embeddings_search',
-        description: 'Semantic search across stored embeddings',
+        description: 'Semantic search across stored embeddings Use when text similarity matters beyond keyword match — native Grep finds exact strings, embeddings find meaning. Pair with memory_store / agentdb_pattern-search to land the vector against your knowledge base. For literal symbol search, native Grep is faster.',
         category: 'embeddings',
         inputSchema: {
             type: 'object',
@@ -457,7 +457,7 @@ export const embeddingsTools = [
     },
     {
         name: 'embeddings_neural',
-        description: 'Neural substrate operations (RuVector integration)',
+        description: 'Neural substrate operations (RuVector integration) Use when text similarity matters beyond keyword match — native Grep finds exact strings, embeddings find meaning. Pair with memory_store / agentdb_pattern-search to land the vector against your knowledge base. For literal symbol search, native Grep is faster.',
         category: 'embeddings',
         inputSchema: {
             type: 'object',
@@ -651,7 +651,7 @@ export const embeddingsTools = [
     },
     {
         name: 'embeddings_hyperbolic',
-        description: 'Hyperbolic embedding operations (Poincaré ball)',
+        description: 'Hyperbolic embedding operations (Poincaré ball) Use when text similarity matters beyond keyword match — native Grep finds exact strings, embeddings find meaning. Pair with memory_store / agentdb_pattern-search to land the vector against your knowledge base. For literal symbol search, native Grep is faster.',
         category: 'embeddings',
         inputSchema: {
             type: 'object',
@@ -762,7 +762,7 @@ export const embeddingsTools = [
     },
     {
         name: 'embeddings_status',
-        description: 'Get embeddings system status and configuration',
+        description: 'Get embeddings system status and configuration Use when text similarity matters beyond keyword match — native Grep finds exact strings, embeddings find meaning. Pair with memory_store / agentdb_pattern-search to land the vector against your knowledge base. For literal symbol search, native Grep is faster.',
         category: 'embeddings',
         inputSchema: {
             type: 'object',
@@ -834,7 +834,7 @@ export const embeddingsTools = [
     // --- RaBitQ 1-bit quantized vector index ---
     {
         name: 'embeddings_rabitq_build',
-        description: 'Build RaBitQ 1-bit quantized index from stored embeddings (32× compression). Pre-filters candidates via Hamming scan before exact rerank.',
+        description: 'Build RaBitQ 1-bit quantized index from stored embeddings (32× compression). Pre-filters candidates via Hamming scan before exact rerank. Use when text similarity matters beyond keyword match — native Grep finds exact strings, embeddings find meaning. Pair with memory_store / agentdb_pattern-search to land the vector against your knowledge base. For literal symbol search, native Grep is faster.',
         category: 'embeddings',
         inputSchema: {
             type: 'object',
@@ -849,7 +849,7 @@ export const embeddingsTools = [
     },
     {
         name: 'embeddings_rabitq_search',
-        description: 'Search via RaBitQ quantized index (fast Hamming scan). Returns candidate IDs for reranking.',
+        description: 'Search via RaBitQ quantized index (fast Hamming scan). Returns candidate IDs for reranking. Use when text similarity matters beyond keyword match — native Grep finds exact strings, embeddings find meaning. Pair with memory_store / agentdb_pattern-search to land the vector against your knowledge base. For literal symbol search, native Grep is faster.',
         category: 'embeddings',
         inputSchema: {
             type: 'object',
@@ -889,7 +889,7 @@ export const embeddingsTools = [
     },
     {
         name: 'embeddings_rabitq_status',
-        description: 'Get RaBitQ quantized index status — availability, vector count, compression ratio',
+        description: 'Get RaBitQ quantized index status — availability, vector count, compression ratio Use when text similarity matters beyond keyword match — native Grep finds exact strings, embeddings find meaning. Pair with memory_store / agentdb_pattern-search to land the vector against your knowledge base. For literal symbol search, native Grep is faster.',
         category: 'embeddings',
         inputSchema: {
             type: 'object',

package/v3/@claude-flow/cli/dist/src/mcp-tools/github-tools.js

@@ -113,7 +113,7 @@ function hasGhCli() {
 export const githubTools = [
     {
         name: 'github_repo_analyze',
-        description: 'Analyze a GitHub repository',
+        description: 'Analyze a GitHub repository Use when native Bash / file tools are wrong because this MCP tool exposes Ruflo-specific state or controllers that have no shell equivalent. For tasks that fit a one-line native command, prefer that.',
         category: 'github',
         inputSchema: {
             type: 'object',
@@ -206,7 +206,7 @@ export const githubTools = [
     },
     {
         name: 'github_pr_manage',
-        description: 'Manage pull requests',
+        description: 'Manage pull requests Use when native Bash / file tools are wrong because this MCP tool exposes Ruflo-specific state or controllers that have no shell equivalent. For tasks that fit a one-line native command, prefer that.',
         category: 'github',
         inputSchema: {
             type: 'object',
@@ -352,7 +352,7 @@ export const githubTools = [
     },
     {
         name: 'github_issue_track',
-        description: 'Track and manage issues',
+        description: 'Track and manage issues Use when native Bash / file tools are wrong because this MCP tool exposes Ruflo-specific state or controllers that have no shell equivalent. For tasks that fit a one-line native command, prefer that.',
         category: 'github',
         inputSchema: {
             type: 'object',
@@ -479,7 +479,7 @@ export const githubTools = [
     },
     {
         name: 'github_workflow',
-        description: 'Manage GitHub Actions workflows',
+        description: 'Manage GitHub Actions workflows Use when native Bash / file tools are wrong because this MCP tool exposes Ruflo-specific state or controllers that have no shell equivalent. For tasks that fit a one-line native command, prefer that.',
         category: 'github',
         inputSchema: {
             type: 'object',
@@ -582,7 +582,7 @@ export const githubTools = [
     },
     {
         name: 'github_metrics',
-        description: 'Get repository metrics and statistics',
+        description: 'Get repository metrics and statistics Use when native Bash / file tools are wrong because this MCP tool exposes Ruflo-specific state or controllers that have no shell equivalent. For tasks that fit a one-line native command, prefer that.',
         category: 'github',
         inputSchema: {
             type: 'object',