@claude-flow/cli 3.63.6 → 3.63.7

package/.claude/skills/github-release-management/SKILL.md

@@ -140,12 +140,12 @@ gh release create $(npm pkg get version) \
   }
 
   // Spawn specialized agents
-  mcp__claude-flow__agent_spawn { type: "coordinator", name: "Release Director" }
-  mcp__claude-flow__agent_spawn { type: "coder", name: "Version Manager" }
-  mcp__claude-flow__agent_spawn { type: "tester", name: "QA Engineer" }
-  mcp__claude-flow__agent_spawn { type: "reviewer", name: "Release Reviewer" }
-  mcp__claude-flow__agent_spawn { type: "analyst", name: "Deployment Analyst" }
-  mcp__claude-flow__agent_spawn { type: "researcher", name: "Compatibility Checker" }
+  mcp__claude-flow__agent_spawn { agentType: "coordinator", name: "Release Director" }
+  mcp__claude-flow__agent_spawn { agentType: "coder", name: "Version Manager" }
+  mcp__claude-flow__agent_spawn { agentType: "tester", name: "QA Engineer" }
+  mcp__claude-flow__agent_spawn { agentType: "reviewer", name: "Release Reviewer" }
+  mcp__claude-flow__agent_spawn { agentType: "analyst", name: "Deployment Analyst" }
+  mcp__claude-flow__agent_spawn { agentType: "researcher", name: "Compatibility Checker" }
 ```
 
 #### Coordinated Release Workflow
@@ -155,11 +155,10 @@ gh release create $(npm pkg get version) \
   Bash("gh api repos/:owner/:repo/git/refs --method POST -f ref='refs/heads/release/v2.0.0' -f sha=$(gh api repos/:owner/:repo/git/refs/heads/main --jq '.object.sha')")
 
   // Orchestrate release preparation
-  mcp__claude-flow__task_orchestrate {
-    task: "Prepare release v2.0.0 with comprehensive testing and validation",
-    strategy: "sequential",
-    priority: "critical",
-    maxAgents: 6
+  mcp__claude-flow__task_create {
+    type: "release",
+    description: "Prepare release v2.0.0 with comprehensive testing and validation",
+    priority: "critical"
   }
 
   // Update all release files
@@ -187,8 +186,7 @@ gh release create $(npm pkg get version) \
   ]}
 
   // Store release state
-  mcp__claude-flow__memory_usage {
-    action: "store",
+  mcp__claude-flow__memory_store {
     key: "release/v2.0.0/status",
     value: JSON.stringify({
       version: "2.0.0",
@@ -391,7 +389,7 @@ npx @claude-flow/cli@latest github multi-release \
   Bash("gh api repos/org/cli/dispatches --method POST -f event_type='release' -F client_payload[version]=v1.5.0")
 
   // Monitor all releases
-  mcp__claude-flow__swarm_monitor { interval: 5, duration: 300 }
+  mcp__claude-flow__swarm_status {}
 ```
 
 ### Hotfix Emergency Procedures

package/.claude/skills/github-workflow-automation/SKILL.md

@@ -525,15 +525,15 @@ mcp__claude-flow__swarm_init {
 }
 
 // Step 2: Spawn specialized agents
-mcp__claude-flow__agent_spawn { type: "coordinator", name: "GitHub Coordinator" }
-mcp__claude-flow__agent_spawn { type: "reviewer", name: "Code Reviewer" }
-mcp__claude-flow__agent_spawn { type: "tester", name: "QA Agent" }
-mcp__claude-flow__agent_spawn { type: "analyst", name: "Security Analyst" }
+mcp__claude-flow__agent_spawn { agentType: "coordinator", name: "GitHub Coordinator" }
+mcp__claude-flow__agent_spawn { agentType: "reviewer", name: "Code Reviewer" }
+mcp__claude-flow__agent_spawn { agentType: "tester", name: "QA Agent" }
+mcp__claude-flow__agent_spawn { agentType: "analyst", name: "Security Analyst" }
 
 // Step 3: Orchestrate GitHub workflow
-mcp__claude-flow__task_orchestrate {
-  task: "Complete PR review and merge workflow",
-  strategy: "parallel",
+mcp__claude-flow__task_create {
+  type: "review",
+  description: "Complete PR review and merge workflow",
   priority: "high"
 }
 ```

package/.claude/skills/sparc-methodology/SKILL.md

@@ -455,7 +455,7 @@ mcp__claude-flow__swarm_init {
 
 // Spawn specialized agents
 mcp__claude-flow__agent_spawn {
-  type: "<agent-type>",
+  agentType: "<agent-type>",
   capabilities: ["<capability1>", "<capability2>"]
 }
 
@@ -522,15 +522,15 @@ mcp__claude-flow__swarm_init {
 
 // Spawn coordinator
 mcp__claude-flow__agent_spawn {
-  type: "coordinator",
+  agentType: "coordinator",
   capabilities: ["planning", "delegation", "monitoring"]
 }
 
 // Spawn specialized workers
-mcp__claude-flow__agent_spawn { type: "architect" }
-mcp__claude-flow__agent_spawn { type: "coder" }
-mcp__claude-flow__agent_spawn { type: "tester" }
-mcp__claude-flow__agent_spawn { type: "reviewer" }
+mcp__claude-flow__agent_spawn { agentType: "architect" }
+mcp__claude-flow__agent_spawn { agentType: "coder" }
+mcp__claude-flow__agent_spawn { agentType: "tester" }
+mcp__claude-flow__agent_spawn { agentType: "reviewer" }
 ```
 
 ### Pattern 2: Mesh Coordination
@@ -703,14 +703,14 @@ mcp__claude-flow__memory_usage {
 ```javascript
 // ✅ CORRECT: All operations together
 [Single Message]:
-  mcp__claude-flow__agent_spawn { type: "researcher" }
-  mcp__claude-flow__agent_spawn { type: "coder" }
-  mcp__claude-flow__agent_spawn { type: "tester" }
+  mcp__claude-flow__agent_spawn { agentType: "researcher" }
+  mcp__claude-flow__agent_spawn { agentType: "coder" }
+  mcp__claude-flow__agent_spawn { agentType: "tester" }
   TodoWrite { todos: [8-10 todos] }
 
 // ❌ WRONG: Multiple messages
-Message 1: mcp__claude-flow__agent_spawn { type: "researcher" }
-Message 2: mcp__claude-flow__agent_spawn { type: "coder" }
+Message 1: mcp__claude-flow__agent_spawn { agentType: "researcher" }
+Message 2: mcp__claude-flow__agent_spawn { agentType: "coder" }
 Message 3: TodoWrite { todos: [...] }
 ```
 

package/.claude/skills/swarm-advanced/SKILL.md

@@ -25,7 +25,7 @@ claude mcp add claude-flow npx claude-flow@alpha mcp start
 mcp__claude-flow__swarm_init({ topology: "mesh", maxAgents: 6 })
 
 // 2. Spawn specialized agents
-mcp__claude-flow__agent_spawn({ type: "researcher", name: "Agent 1" })
+mcp__claude-flow__agent_spawn({ agentType: "researcher", name: "Agent 1" })
 
 // 3. Orchestrate tasks
 mcp__claude-flow__task_orchestrate({ task: "...", strategy: "parallel" })
@@ -108,7 +108,7 @@ const researchAgents = [
 // Spawn all agents
 researchAgents.forEach(agent => {
   mcp__claude-flow__agent_spawn({
-    type: agent.type,
+    agentType: agent.type,
     name: agent.name,
     capabilities: agent.capabilities
   })
@@ -274,7 +274,7 @@ const devTeam = [
 // Spawn all team members
 devTeam.forEach(member => {
   mcp__claude-flow__agent_spawn({
-    type: member.type,
+    agentType: member.type,
     name: member.name,
     capabilities: member.capabilities,
     swarmId: "dev-swarm"
@@ -444,7 +444,7 @@ const testingTeam = [
 // Spawn all testers
 testingTeam.forEach(tester => {
   mcp__claude-flow__agent_spawn({
-    type: tester.type,
+    agentType: tester.type,
     name: tester.name,
     capabilities: tester.capabilities,
     swarmId: "testing-swarm"
@@ -634,7 +634,7 @@ const analysisTeam = [
 // Spawn all analysts
 analysisTeam.forEach(analyst => {
   mcp__claude-flow__agent_spawn({
-    type: analyst.type,
+    agentType: analyst.type,
     name: analyst.name,
     capabilities: analyst.capabilities
   })

package/README.md

@@ -244,7 +244,7 @@ This adds slash commands and agent definitions. `ruflo-core` (installed above) d
 | [**ruflo-browser**](plugins/ruflo-browser/README.md) | Automate browser testing with Playwright |
 | [**ruflo-jujutsu**](plugins/ruflo-jujutsu/README.md) | Analyze git diffs, score risk, suggest reviewers |
 | [**ruflo-docs**](plugins/ruflo-docs/README.md) | Generate and maintain documentation automatically |
-| [**agentic-qe-fleet**](https://github.com/proffesor-for-testing/agentic-qe/tree/v3.15.15/plugins/agentic-qe-fleet) | External, maintained by [Agentic QE](https://github.com/proffesor-for-testing/agentic-qe): 11 QE agents, test generation, coverage, chaos and TDD skills, the `agentic-qe` MCP server, and a guard for AQE learning data (`/plugin install agentic-qe-fleet@ruflo`). Install it from one marketplace only, `agentic-qe` or `ruflo`: enabled from both, its mod and commands load twice |
+| [**agentic-qe-fleet**](https://github.com/proffesor-for-testing/agentic-qe/tree/v3.15.16/plugins/agentic-qe-fleet) | External, maintained by [Agentic QE](https://github.com/proffesor-for-testing/agentic-qe): 11 QE agents, test generation, coverage, chaos and TDD skills, the `agentic-qe` MCP server, and a guard for AQE learning data (`/plugin install agentic-qe-fleet@ruflo`). Install it from one marketplace only, `agentic-qe` or `ruflo`: enabled from both, its mod and commands load twice |
 
 #### Security & Compliance
 

package/catalog-manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "generation": 7,
-  "generatedAt": "2026-10-27T21:48:29.562Z",
-  "gitSha": "a4547c04",
+  "generatedAt": "2026-10-28T15:08:17.042Z",
+  "gitSha": "8935d9a8",
   "catalog": {
     "agents": 177,
     "tools": 444,

package/dist/src/commands/hooks.js

@@ -967,6 +967,13 @@ const buildAgentsCommand = {
                 format: configFormat,
                 includePretrained: true,
             });
+            // #4558: the tool now rejects an invalid outputDir with { success: false, error }.
+            const failed = result;
+            if (failed.success === false) {
+                spinner.fail('Agent config generation failed');
+                output.printError(`Build agents error: ${failed.error}`);
+                return { success: false, exitCode: 1 };
+            }
             spinner.succeed(`Generated ${result.agents.length} agent configs`);
             if (ctx.flags.format === 'json') {
                 output.printJson(result);

package/dist/src/mcp-tools/agent-tools.js

@@ -214,7 +214,7 @@ export const agentTools = [
         inputSchema: {
             type: 'object',
             properties: {
-                agentType: { type: 'string', description: 'Type of agent to spawn' },
+                agentType: { type: 'string', description: 'Type of agent to spawn (a legacy `type` key is accepted as an alias)' },
                 agentId: { type: 'string', description: 'Optional custom agent ID' },
                 name: { type: 'string', description: 'Optional display name for the agent (shown by agent_list, agent_status and ruflo-console)' },
                 // #2085 — accept swarmId so spawned agents register in the
@@ -234,7 +234,19 @@ export const agentTools = [
             },
             required: ['agentType'],
         },
-        handler: async (input) => {
+        handler: async (rawInput) => {
+            // #4542: agent and command docs that `init` installed before 3.63.7 call
+            // agent_spawn with `type`. Accept it as an alias for `agentType`, and
+            // name the missing key ourselves: validateAgentSpawn maps agentType onto
+            // the security schema's `type` field and would report "type: Required".
+            let input = rawInput;
+            if (input.agentType === undefined && typeof input.type === 'string') {
+                const { type, ...rest } = input;
+                input = { ...rest, agentType: type };
+            }
+            if (typeof input.agentType !== 'string' || input.agentType === '') {
+                return { success: false, error: 'Input validation failed: agentType is required and must be a non-empty string (for example agentType: "coder")' };
+            }
             // Validate user-provided input (#1425: wire security validators to runtime)
             const validation = await validateAgentSpawn(input);
             if (!validation.valid) {
@@ -606,7 +618,7 @@ export const agentTools = [
             type: 'object',
             properties: {
                 action: { type: 'string', enum: ['status', 'scale', 'drain', 'fill'], description: 'Pool action' },
-                targetSize: { type: 'number', description: 'Target pool size (for scale action)' },
+                targetSize: { type: 'number', description: 'Target pool size (scale: grow or shrink to it; fill: grow to it, never shrink)' },
                 agentType: { type: 'string', description: 'Agent type filter' },
             },
             required: ['action'],
@@ -653,7 +665,9 @@ export const agentTools = [
                     avgHealth: agents.length > 0 ? agents.reduce((sum, a) => sum + a.health, 0) / agents.length : 0,
                 };
             }
-            if (action === 'scale') {
+            // #4555: fill was advertised in the enum but had no branch. It is scale
+            // without the shrink step: grow agentType's pool to targetSize, never terminate.
+            if (action === 'scale' || action === 'fill') {
                 const targetSize = input.targetSize === undefined ? 5 : input.targetSize;
                 if (typeof targetSize !== 'number' || !Number.isSafeInteger(targetSize) || targetSize < 0) {
                     return { action, error: 'targetSize must be a non-negative safe integer' };
@@ -678,7 +692,7 @@ export const agentTools = [
                         added.push(agentId);
                     }
                 }
-                else if (delta < 0) {
+                else if (delta < 0 && action === 'scale') {
                     const toRemove = agents.filter(a => a.agentType === agentType && a.status === 'idle').slice(0, -delta);
                     for (const agent of toRemove) {
                         store.agents[agent.agentId].status = 'terminated';

package/dist/src/mcp-tools/coordination-tools.js

@@ -225,8 +225,8 @@ export const coordinationTools = [
         inputSchema: {
             type: 'object',
             properties: {
-                action: { type: 'string', enum: ['status', 'trigger', 'resolve'], description: 'Action to perform' },
-                force: { type: 'boolean', description: 'Force synchronization' },
+                action: { type: 'string', enum: ['status', 'trigger', 'resolve'], description: 'Action to perform. `trigger` is unavailable: nodes are local records with no sync backend, so it is refused (#4557)' },
+                force: { type: 'boolean', description: 'Unused: `trigger` is refused regardless (#4557)' },
                 conflictResolution: { type: 'string', enum: ['latest', 'merge', 'manual'], description: 'Conflict resolution strategy' },
             },
         },
@@ -243,18 +243,16 @@ export const coordinationTools = [
                 };
             }
             if (action === 'trigger') {
-                store.sync.syncCount++;
-                store.sync.lastSync = new Date().toISOString();
-                store.sync.pendingChanges = 0;
-                // Simulate sync
-                await new Promise(resolve => setTimeout(resolve, 50));
-                saveCoordStore(store);
+                // #4557: this waited on a simulated 50ms "sync", bumped syncCount/lastSync
+                // and reported every node synchronized, but no state moves between
+                // nodes. Refuse without touching the stored sync record, as
+                // neural_compress quantize/prune do (#4195, #4423).
                 return {
-                    success: true,
-                    action: 'synchronized',
+                    success: false,
+                    action: 'trigger',
+                    error: 'Synchronization is unavailable: coordination nodes are local records with no sync backend, so nothing would be transferred.',
                     syncCount: store.sync.syncCount,
-                    syncedAt: store.sync.lastSync,
-                    nodesSync: Object.keys(store.nodes).length,
+                    lastSync: store.sync.lastSync,
                 };
             }
             if (action === 'resolve') {

package/dist/src/mcp-tools/hooks-tools.js

@@ -2212,7 +2212,14 @@ export const hooksBuildAgents = {
         },
     },
     handler: async (params) => {
-        const outputDir = resolve(params.outputDir || './agents');
+        // #4558: outputDir was never validated and resolved against the process
+        // cwd, so a default call from another directory overwrote files there.
+        if (params.outputDir !== undefined) {
+            const v = validatePath(params.outputDir, 'outputDir');
+            if (!v.valid)
+                return { success: false, error: v.error };
+        }
+        const outputDir = resolve(getProjectCwd(), params.outputDir || './agents');
         const focus = params.focus || 'all';
         const format = params.format || 'yaml';
         const persist = params.persist !== false; // Default to true
@@ -2255,9 +2262,11 @@ export const hooksBuildAgents = {
             agents: filteredAgents,
             stats: {
                 configsGenerated: filteredAgents.length,
-                patternsApplied: filteredAgents.length * 3,
+                // #4558: was agents * 3; no pretrain data is read, the configs are templates.
+                patternsApplied: 0,
                 optimizationsIncluded: filteredAgents.reduce((acc, a) => acc + a.optimizations.length, 0),
             },
+            _note: 'Configs are built-in templates; pretrain data is not read.',
         };
     },
 };

package/dist/src/mcp-tools/performance-tools.js

@@ -612,6 +612,14 @@ export const performanceTools = [
             };
             const cpuStats = calcStats(cpuHistory, cpuPercent);
             const memStats = calcStats(memHistory, memUsedMB);
+            // #4554: latency/throughput used to be fixed literals (45ms, 1250 ops/s).
+            // Report the samples performance_report records (ADR-093 F8), or say none exist.
+            const sampled = (values, unit) => {
+                const real = values.filter(n => Number.isFinite(n));
+                return real.length === 0
+                    ? { available: false, unit, samples: 0, _real: false, _note: 'No samples recorded yet: run performance_report to record one.' }
+                    : { ...calcStats(real, real[real.length - 1]), unit, samples: real.length, _real: true };
+            };
             const allMetrics = {
                 cpu: {
                     ...cpuStats,
@@ -630,30 +638,12 @@ export const performanceTools = [
                     unit: 'MB',
                     _real: true,
                 },
-                latency: {
-                    current: 45,
-                    avg: 52,
-                    min: 15,
-                    max: 250,
-                    p50: 48,
-                    p95: 150,
-                    p99: 220,
-                    unit: 'ms',
-                },
-                throughput: {
-                    current: 1250,
-                    avg: 1100,
-                    min: 500,
-                    max: 2000,
-                    p50: 1050,
-                    p95: 1800,
-                    p99: 1950,
-                    unit: 'ops/s',
-                },
+                latency: sampled(history.map(m => m.latency?.avg), 'ms'),
+                throughput: sampled(history.map(m => m.throughput?.operations), 'ops/s'),
             };
             if (metric === 'all') {
                 return {
-                    _real: true,
+                    _real: Object.values(allMetrics).every(m => m._real),
                     metrics: allMetrics,
                     aggregation,
                     historySize: history.length,
@@ -662,9 +652,9 @@ export const performanceTools = [
             }
             const selectedMetric = allMetrics[metric];
             return {
-                _real: ['cpu', 'memory'].includes(metric),
+                _real: selectedMetric._real,
                 metric,
-                value: selectedMetric[aggregation],
+                value: selectedMetric[aggregation] ?? null,
                 unit: selectedMetric.unit,
                 details: selectedMetric,
                 timestamp: new Date().toISOString(),

package/dist/src/mcp-tools/session-tools.js

@@ -54,6 +54,21 @@ function ensureSessionDir() {
         mkdirRestricted(dir);
     }
 }
+/**
+ * The session hook (`session.js` from init/helpers-generator.ts) writes its
+ * records into this same directory: `current.json` and `session-<n>.json`
+ * archives shaped `{ id, startedAt, ... }` rather than session_save's
+ * `{ sessionId, name, savedAt, stats }`. Read the id and time from either shape
+ * (ADR-093 F6), falling back to the file's own id.
+ */
+function sessionIdentity(session, fileId) {
+    const raw = session;
+    const pick = (...values) => values.find((v) => typeof v === 'string' && v !== '');
+    return {
+        sessionId: pick(raw.sessionId, raw.id) ?? fileId,
+        savedAt: pick(raw.savedAt, raw.startedAt) ?? '',
+    };
+}
 function loadSession(sessionId) {
     try {
         const path = getSessionPath(sessionId);
@@ -583,12 +598,13 @@ export const sessionTools = [
             if (session) {
                 const path = getSessionPath(sessionId);
                 const stat = statSync(path);
+                const identity = sessionIdentity(session, sessionId);
                 return {
-                    sessionId: session.sessionId,
-                    name: session.name,
+                    sessionId: identity.sessionId,
+                    name: session.name ?? identity.sessionId,
                     description: session.description,
-                    savedAt: session.savedAt,
-                    stats: session.stats,
+                    savedAt: identity.savedAt,
+                    stats: session.stats ?? null,
                     fileSize: stat.size,
                     path,
                     hasData: {
@@ -631,12 +647,13 @@ export const sessionTools = [
             const session = loadSession(sessionId);
             if (!session)
                 return { sessionId, status: 'unknown', startedAt: '', error: 'Session file unreadable' };
+            const identity = sessionIdentity(session, sessionId);
             return {
-                sessionId: session.sessionId,
-                name: session.name,
+                sessionId: identity.sessionId,
+                name: session.name ?? identity.sessionId,
                 status: 'active',
-                startedAt: session.savedAt,
-                stats: session.stats,
+                startedAt: identity.savedAt,
+                stats: session.stats ?? null,
             };
         },
     },