@claude-flow/cli 3.68.0 → 3.70.0

package/.claude/helpers/helpers.manifest.json

@@ -1,6 +1,6 @@
 {
   "manifest": {
-    "version": "3.68.0",
+    "version": "3.70.0",
     "files": {
       "auto-memory-hook.mjs": "631fac9d518835e2852a406888316bbbddddb49e7ed8e406d2e971f46833df9a",
       "hook-handler.cjs": "0ce70981aa33f76d008b6f49626effaf4269918c4094f1a28c1ef6fceb097d6f",
@@ -10,6 +10,6 @@
       "learning-loop.cjs": "d046cd6f8efb7dd40e1d2451516c181fc8b26477aefb1124c0df5f52a23f9190"
     }
   },
-  "signature": "hlbaMRRdeS+x8RDQSG0gdJuZhV7d1pJKr+ut6Gy3w4y72vxS2tbe/R1G+zs5WUtCfX5/bkzh/U9YBDqsMiovCA==",
+  "signature": "8Yx6pZ2AjAZmPJJECS9jV5m85+kNAuaiehV3sttqE4L37q7wG/PoPetmVeBVJ6QkNlj0dKUra5Dl//I/AW0kDA==",
   "algorithm": "ed25519"
 }

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

@@ -1,5 +1,5 @@
 ---
-name: "AgentDB Advanced Features"
+name: agentdb-advanced
 description: "Master advanced AgentDB features including QUIC synchronization, multi-database management, custom distance metrics, hybrid search, and distributed systems integration. Use when building distributed AI systems, multi-agent coordination, or advanced vector search applications."
 ---
 

package/.claude/skills/agentdb-learning/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "AgentDB Learning Plugins"
+name: agentdb-learning
 description: "Create and train AI learning plugins with AgentDB's 9 reinforcement learning algorithms. Includes Decision Transformer, Q-Learning, SARSA, Actor-Critic, and more. Use when building self-learning agents, implementing RL, or optimizing agent behavior through experience."
 ---
 

package/.claude/skills/agentdb-memory-patterns/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "AgentDB Memory Patterns"
+name: agentdb-memory-patterns
 description: "Implement persistent memory patterns for AI agents using AgentDB. Includes session memory, long-term storage, pattern learning, and context management. Use when building stateful agents, chat systems, or intelligent assistants."
 ---
 

package/.claude/skills/agentdb-optimization/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "AgentDB Performance Optimization"
+name: agentdb-optimization
 description: "Optimize AgentDB performance with quantization (4-32x memory reduction), HNSW indexing (150x faster search), caching, and batch operations. Use when optimizing memory usage, improving search speed, or scaling to millions of vectors."
 ---
 

package/.claude/skills/agentdb-vector-search/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "AgentDB Vector Search"
+name: agentdb-vector-search
 description: "Implement semantic vector search with AgentDB for intelligent document retrieval, similarity matching, and context-aware querying. Use when building RAG systems, semantic search engines, or intelligent knowledge bases."
 ---
 

package/.claude/skills/hooks-automation/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: Hooks Automation
+name: hooks-automation
 description: Automated coordination, formatting, and learning from Claude Code operations using intelligent hooks with MCP integration. Includes pre/post task hooks, session management, Git integration, memory coordination, and neural pattern training for enhanced development workflows.
 ---
 

package/.claude/skills/pair-programming/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: Pair Programming
+name: pair-programming
 description: AI-assisted pair programming with multiple modes (driver/navigator/switch), real-time verification, quality monitoring, and comprehensive testing. Supports TDD, debugging, refactoring, and learning sessions. Features automatic role switching, continuous code review, security scanning, and performance optimization with truth-score verification.
 ---
 

package/.claude/skills/reasoningbank-agentdb/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "ReasoningBank with AgentDB"
+name: reasoningbank-agentdb
 description: "Implement ReasoningBank adaptive learning with AgentDB's 150x faster vector database. Includes trajectory tracking, verdict judgment, memory distillation, and pattern recognition. Use when building self-learning agents, optimizing decision-making, or implementing experience replay systems."
 ---
 

package/.claude/skills/reasoningbank-intelligence/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "ReasoningBank Intelligence"
+name: reasoningbank-intelligence
 description: "Implement adaptive learning with ReasoningBank for pattern recognition, strategy optimization, and continuous improvement. Use when building self-learning agents, optimizing workflows, or implementing meta-cognitive systems."
 ---
 

package/.claude/skills/skill-builder/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "Skill Builder"
+name: skill-builder
 description: "Create new Claude Code Skills with proper YAML frontmatter, progressive disclosure structure, and complete directory organization. Use when you need to build custom skills for specific workflows, generate skill templates, or understand the Claude Skills specification."
 ---
 

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

@@ -1,5 +1,5 @@
 ---
-name: "Swarm Orchestration"
+name: swarm-orchestration
 description: "Orchestrate multi-agent swarms with agentic-flow for parallel task execution, dynamic topology, and intelligent coordination. Use when scaling beyond single agents, implementing complex workflows, or building distributed AI systems."
 ---
 

package/.claude/skills/v3-cli-modernization/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "V3 CLI Modernization"
+name: v3-cli-modernization
 description: "CLI modernization and hooks system enhancement for claude-flow v3. Implements interactive prompts, command decomposition, enhanced hooks integration, and intelligent workflow automation."
 ---
 

package/.claude/skills/v3-core-implementation/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "V3 Core Implementation"
+name: v3-core-implementation
 description: "Core module implementation for claude-flow v3. Implements DDD domains, clean architecture patterns, dependency injection, and modular TypeScript codebase with comprehensive testing."
 ---
 

package/.claude/skills/v3-ddd-architecture/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "V3 DDD Architecture"
+name: v3-ddd-architecture
 description: "Domain-Driven Design architecture for claude-flow v3. Implements modular, bounded context architecture with clean separation of concerns and microkernel pattern."
 ---
 

package/.claude/skills/v3-integration-deep/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "V3 Deep Integration"
+name: v3-integration-deep
 description: "Deep agentic-flow@alpha integration implementing ADR-001. Eliminates 10,000+ duplicate lines by building claude-flow as specialized extension rather than parallel implementation."
 ---
 

package/.claude/skills/v3-mcp-optimization/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "V3 MCP Optimization"
+name: v3-mcp-optimization
 description: "MCP server optimization and transport layer enhancement for claude-flow v3. Implements connection pooling, load balancing, tool registry optimization, and performance monitoring for sub-100ms response times."
 ---
 

package/.claude/skills/v3-memory-unification/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "V3 Memory Unification"
+name: v3-memory-unification
 description: "Unify 6+ memory systems into AgentDB with HNSW indexing for 150x-12,500x search improvements. Implements ADR-006 (Unified Memory Service) and ADR-009 (Hybrid Memory Backend)."
 ---
 

package/.claude/skills/v3-performance-optimization/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "V3 Performance Optimization"
+name: v3-performance-optimization
 description: "Achieve aggressive v3 performance targets: 2.49x-7.47x Flash Attention speedup, 150x-12,500x search improvements, 50-75% memory reduction. Comprehensive benchmarking and optimization suite."
 ---
 

package/.claude/skills/v3-security-overhaul/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "V3 Security Overhaul"
+name: v3-security-overhaul
 description: "Complete security architecture overhaul for claude-flow v3. Addresses critical CVEs (CVE-1, CVE-2, CVE-3) and implements secure-by-default patterns. Use for security-first v3 implementation."
 ---
 

package/.claude/skills/v3-swarm-coordination/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "V3 Swarm Coordination"
+name: v3-swarm-coordination
 description: "15-agent hierarchical mesh coordination for v3 implementation. Orchestrates parallel execution across security, core, and integration domains following 10 ADRs with 14-week timeline."
 ---
 

package/.claude/skills/verification-quality/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "Verification & Quality Assurance"
+name: verification-quality
 description: |
   Check code quality and change risk with ruflo's shipped analysis commands (analyze diff, analyze complexity, analyze code), and run or extend ruflo's own CI regression guards. Use when assessing a change's risk, finding complexity hot spots, or adding a regression guard to ruflo. The truth-scoring and auto-rollback commands described later in this file are design notes, not shipped CLI commands.
 ---

package/catalog-manifest.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": 1,
   "generation": 7,
-  "generatedAt": "2026-11-01T04:34:21.063Z",
-  "gitSha": "2b1a3927",
+  "generatedAt": "2026-11-01T19:14:23.757Z",
+  "gitSha": "a3d45e64",
   "catalog": {
     "agents": 177,
-    "tools": 446,
+    "tools": 450,
     "skills": 34
   },
   "benchmark": null

package/dist/src/commands/context-plan.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from '../types.js';
+/** Metadata-only planning surface. Does not read files or launch a model. */
+export declare const contextPlanCommand: Command;
+//# sourceMappingURL=context-plan.d.ts.map

package/dist/src/commands/context-plan.js

@@ -0,0 +1,36 @@
+import { planContextRead } from '../services/context-delegation.js';
+/** Metadata-only planning surface. Does not read files or launch a model. */
+export const contextPlanCommand = {
+    name: 'context-plan',
+    description: 'Plan bounded bulk-read delegation from metadata (no file reads or model calls)',
+    options: [
+        { name: 'bytes', type: 'number', required: true, description: 'Total source UTF-8 bytes' },
+        { name: 'files', type: 'number', default: 1, description: 'Source file count' },
+        { name: 'mode', type: 'string', default: 'legacy', choices: ['legacy', 'observe', 'enforce'], description: 'Routing mode' },
+        { name: 'intent', type: 'string', default: 'analysis', choices: ['analysis', 'edit', 'debug', 'architecture'], description: 'Read purpose' },
+        { name: 'worker-available', type: 'boolean', default: false, description: 'Host has a governed worker adapter' },
+        { name: 'offset', type: 'number', description: 'Targeted read offset' },
+        { name: 'limit', type: 'number', description: 'Targeted read limit' },
+        { name: 'depth', type: 'number', default: 0, description: 'Current delegation depth' },
+    ],
+    action: async (ctx) => {
+        try {
+            const f = ctx.flags;
+            const plan = planContextRead({
+                inputBytes: Number(f.bytes), fileCount: Number(f.files ?? 1),
+                mode: (f.mode ?? 'legacy'), intent: (f.intent ?? 'analysis'),
+                // The parser camelCases flag names; accept both spellings like the other hooks commands.
+                workerAvailable: f['worker-available'] === true || f.workerAvailable === true, depth: Number(f.depth ?? 0),
+                ...(f.offset === undefined ? {} : { offset: Number(f.offset) }),
+                ...(f.limit === undefined ? {} : { limit: Number(f.limit) }),
+            });
+            console.log(JSON.stringify(plan));
+            return { success: true, data: plan };
+        }
+        catch {
+            console.error('Invalid context planning metadata');
+            return { success: false, message: 'Invalid context planning metadata', exitCode: 1 };
+        }
+    },
+};
+//# sourceMappingURL=context-plan.js.map

package/dist/src/commands/hooks.js

@@ -8,6 +8,7 @@ import { output } from '../output.js';
 import { confirm } from '../prompt.js';
 import { callMCPTool, MCPClientError } from '../mcp-client.js';
 import { storeCommand } from './transfer-store.js';
+import { contextPlanCommand } from './context-plan.js';
 import { readFileSync, statSync } from 'node:fs';
 import { getSecurityStatus as sharedGetSecurityStatus, getSwarmStatus as sharedGetSwarmStatus, getGitUncommittedCount as sharedGetGitUncommittedCount, } from '../funnel/local-signals.js';
 /**
@@ -3725,7 +3726,9 @@ const statuslineCommand = {
             const securityCompact = security.findings > 0
                 ? `Findings:${security.findings}`
                 : `Security:${security.status}`;
-            const line = `DDD:${progress.domainsCompleted}/${progress.totalDomains} ${securityCompact} Swarm:${swarm.activeAgents}/${swarm.maxAgents} Ctx:${system.contextPct}% Int:${system.intelligencePct}%`;
+            // #1047: this tier is derived from memory pattern-count thresholds, not
+            // Domain-Driven-Design domain completion — label it for what it is.
+            const line = `Learning:${progress.domainsCompleted}/${progress.totalDomains} ${securityCompact} Swarm:${swarm.activeAgents}/${swarm.maxAgents} Ctx:${system.contextPct}% Int:${system.intelligencePct}%`;
             output.writeln(line);
             return { success: true, data: statusData };
         }
@@ -3895,7 +3898,10 @@ const statuslineCommand = {
             const patternsK = progress.patternsLearned >= 1000 ? `${(progress.patternsLearned / 1000).toFixed(1)}k` : String(progress.patternsLearned);
             perfIndicator = `${c.brightYellow}📚 ${patternsK} patterns${c.reset}`;
         }
-        const line1 = `${c.brightCyan}🏗️  DDD Domains${c.reset}    ${progressBar(progress.domainsCompleted, progress.totalDomains)}  ` +
+        // #1047: renamed from "DDD Domains" — this tier comes from memory
+        // pattern-count thresholds (see getV3Progress above), not actual
+        // Domain-Driven-Design domain completion. "Learning Tier" says what it is.
+        const line1 = `${c.brightCyan}🏗️  Learning Tier${c.reset}    ${progressBar(progress.domainsCompleted, progress.totalDomains)}  ` +
             `${domainsColor}${progress.domainsCompleted}${c.reset}/${c.brightWhite}${progress.totalDomains}${c.reset}    ` +
             perfIndicator;
         const swarmIndicator = swarm.coordinationActive ? `${c.brightGreen}◉${c.reset}` : `${c.dim}○${c.reset}`;
@@ -3909,10 +3915,19 @@ const statuslineCommand = {
             `${securityIcon} ${securityColor}${security.findings > 0 ? `Findings ${security.findings}` : `Security ${security.status}`}${c.reset}    ` +
             `${c.brightCyan}💾 ${system.memoryMB}MB${c.reset}    ` +
             `${c.brightPurple}🧠 ${String(system.intelligencePct).padStart(3)}%${c.reset}`;
-        const dddColor = progress.dddProgress >= 50 ? c.brightGreen : progress.dddProgress > 0 ? c.yellow : c.red;
+        // #1047: "DDD ●XX%" previously showed a fake architecture-progress
+        // percentage that was really just the memory pattern count run through
+        // getV3Progress's bucket thresholds — it has no connection to actual DDD
+        // domain completion. Show the real number it was derived from instead,
+        // per the issue's own recommendation ("Memory entries: 290" instead of
+        // "DDD ●80%").
+        const memoryColor = progress.patternsLearned >= 50 ? c.brightGreen : progress.patternsLearned > 0 ? c.yellow : c.red;
+        const patternsDisplay = progress.patternsLearned >= 1000
+            ? `${(progress.patternsLearned / 1000).toFixed(1)}k`
+            : String(progress.patternsLearned);
         const line3 = `${c.brightPurple}🔧 Architecture${c.reset}    ` +
             `${c.cyan}ADRs${c.reset} ${c.dim}●0/0${c.reset}  ${c.dim}│${c.reset}  ` +
-            `${c.cyan}DDD${c.reset} ${dddColor}●${String(progress.dddProgress).padStart(3)}%${c.reset}  ${c.dim}│${c.reset}  ` +
+            `${c.cyan}Memory${c.reset} ${memoryColor}●${patternsDisplay}${c.reset}  ${c.dim}│${c.reset}  ` +
             `${c.cyan}Security${c.reset} ${securityColor}●${security.status}${c.reset}`;
         const vectorColor = agentdbStats.vectorCount > 0 ? c.brightGreen : c.dim;
         const testColor = testStats.testFiles > 0 ? c.brightGreen : c.dim;
@@ -4726,6 +4741,7 @@ export const hooksCommand = {
         coverageGapsCommand,
         // Token optimization
         tokenOptimizeCommand,
+        contextPlanCommand,
         // Model routing (tiny-dancer integration)
         modelRouteCommand,
         modelOutcomeCommand,

package/dist/src/commands/workflow.js

@@ -121,7 +121,7 @@ const runCommand = {
                 spinner.succeed('Workflow validated successfully');
             }
             else {
-                spinner.succeed('Workflow started');
+                spinner.succeed('Workflow created');
             }
             if (ctx.flags.format === 'json') {
                 output.printJson(result);
@@ -149,6 +149,8 @@ const runCommand = {
             });
             if (!dryRun) {
                 output.writeln();
+                // #4609: workflow_run only creates the workflow; workflow_execute runs it.
+                output.printInfo(`Start it: claude-flow mcp exec -t workflow_execute -p '{"workflowId":"${result.workflowId}"}'`);
                 output.printInfo(`Track progress: claude-flow workflow status ${result.workflowId}`);
             }
             return { success: true, data: result };

package/dist/src/index.d.ts

@@ -81,4 +81,8 @@ export type { CircuitBreakerConfig, CircuitState, } from './production/circuit-b
 export { MonitoringHooks, createMonitor, getMonitor, } from './production/monitoring.js';
 export type { MonitorConfig, MetricEvent, HealthStatus, PerformanceMetrics, } from './production/monitoring.js';
 export default CLI;
+export { planContextRead, delegateContextRead, DEFAULT_CONTEXT_LIMITS } from './services/context-delegation.js';
+export type { ContextMode, ContextIntent, ContextRead, ContextLimits, ContextPlan, ContextSource, ContextEvidence, ContextWorkerRequest, ContextWorkerReply, ContextAdapter, ContextReceipt, ContextResult } from './services/context-delegation.js';
+export { createAnthropicContextAdapter } from './services/anthropic-context-adapter.js';
+export type { AnthropicContextAdapterOptions, AnthropicContextAuthorization, AnthropicContextPricing, AnthropicContextUsage, AnthropicContextCallReceipt, GovernedAnthropicContextAdapter } from './services/anthropic-context-adapter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.js

@@ -611,4 +611,7 @@ export { CircuitBreaker, getCircuitBreaker, getAllCircuitStats, resetAllCircuits
 export { MonitoringHooks, createMonitor, getMonitor, } from './production/monitoring.js';
 // Default export
 export default CLI;
+// Bounded, provider-neutral context delegation. Hosts retain policy and budget authority.
+export { planContextRead, delegateContextRead, DEFAULT_CONTEXT_LIMITS } from './services/context-delegation.js';
+export { createAnthropicContextAdapter } from './services/anthropic-context-adapter.js';
 //# sourceMappingURL=index.js.map

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

@@ -303,35 +303,52 @@ export const agentTools = [
                 ...(routingResult.openrouterModel ? { openrouterModel: routingResult.openrouterModel } : {}),
             };
             const store = loadAgentStore();
-            store.agents[agentId] = agent;
-            saveAgentStore(store);
-            // #2085 — also push to the swarm store's agents array so that
-            // swarm_status reports the new agent. Without this, agent_spawn
-            // and swarm_status read/write separate stores and agents added
-            // post-init never show up in swarm_status.agents — confirmed for
-            // all topologies (hierarchical, mesh, etc.).
+            // #2085 — the agent is also pushed to the swarm store's agents array so
+            // that swarm_status reports it. Resolve that swarm first: #4572 — an
+            // active swarm already holding maxAgents live agents refuses the spawn.
+            let swarmTools;
+            let swarmStore;
+            let targetSwarmId = input.swarmId || '';
             try {
-                const { loadSwarmStore: _loadSwarmStore, saveSwarmStore: _saveSwarmStore } = await import('./swarm-tools.js');
-                const swarmStore = _loadSwarmStore();
-                let targetSwarmId = input.swarmId || '';
+                swarmTools = await import('./swarm-tools.js');
+                swarmStore = swarmTools.loadSwarmStore();
                 if (!targetSwarmId) {
                     // Default to the most-recently-created swarm.
                     const all = Object.values(swarmStore.swarms);
                     const latest = all.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime())[0];
                     targetSwarmId = latest?.swarmId || '';
                 }
-                if (targetSwarmId && swarmStore.swarms[targetSwarmId]) {
-                    const swarm = swarmStore.swarms[targetSwarmId];
+            }
+            catch { /* swarm store unavailable — agent still registered globally */ }
+            const swarm = targetSwarmId ? swarmStore?.swarms[targetSwarmId] : undefined;
+            const members = Array.isArray(swarm?.agents) ? swarm.agents : [];
+            if (swarm && swarm.status !== 'terminated' && !members.includes(agentId)) {
+                // Terminated agents stay listed in swarm.agents; they no longer hold a slot.
+                const live = members.filter((id) => store.agents[id] && store.agents[id].status !== 'terminated').length;
+                if (live >= swarm.maxAgents) {
+                    return {
+                        success: false,
+                        error: `Swarm ${swarm.swarmId} is full: ${live}/${swarm.maxAgents} agents. Terminate an agent (agent_terminate) or init a swarm with a larger maxAgents.`,
+                        swarmId: swarm.swarmId,
+                        agentCount: live,
+                        maxAgents: swarm.maxAgents,
+                    };
+                }
+            }
+            store.agents[agentId] = agent;
+            saveAgentStore(store);
+            if (swarm && swarmTools && swarmStore) {
+                try {
                     if (!Array.isArray(swarm.agents))
                         swarm.agents = [];
                     // Idempotent — don't duplicate if agent_spawn is retried.
                     if (!swarm.agents.includes(agentId)) {
                         swarm.agents.push(agentId);
-                        _saveSwarmStore(swarmStore);
+                        swarmTools.saveSwarmStore(swarmStore);
                     }
                 }
+                catch { /* swarm store unwritable — agent still registered globally */ }
             }
-            catch { /* swarm store unavailable — agent still registered globally */ }
             // Record agent in graph database (ADR-087, best-effort)
             try {
                 const { addNode } = await import('../ruvector/graph-backend.js');

package/dist/src/mcp-tools/agentdb-episode-tools.d.ts

@@ -0,0 +1,16 @@
+/**
+ * agentdb_episode-get / -list / -update / -delete (ADR-520).
+ *
+ * Episodes are the records session ends and `memory distill` write and that
+ * agentdb_episode-recall searches. Needs agentdb >= 3.3.0 (in-place update that keeps the id
+ * and re-indexes); older builds get a clear error instead of a partial operation.
+ *
+ * @module v3/cli/mcp-tools/agentdb-episode-tools
+ */
+import type { MCPTool } from './types.js';
+export declare const agentdbEpisodeGet: MCPTool;
+export declare const agentdbEpisodeList: MCPTool;
+export declare const agentdbEpisodeUpdate: MCPTool;
+export declare const agentdbEpisodeDelete: MCPTool;
+export declare const agentdbEpisodeCrudTools: MCPTool[];
+//# sourceMappingURL=agentdb-episode-tools.d.ts.map