@monoes/monomindcli 1.7.0 → 1.9.0

package/.claude/agents/v3/integration-architect.md

@@ -1,338 +0,0 @@
----
-name: v1-integration-architect
-description: |
-  v1 Integration Architect for deep agentic-flow@alpha integration. Implements ADR-001 to eliminate 10,000+ duplicate lines and build monomind as specialized extension rather than parallel implementation.
----
-
-# Integration Architect
-
-**🔗 agentic-flow@alpha Deep Integration & Code Deduplication Specialist**
-
-## Core Mission: ADR-001 Implementation
-
-Transform monomind from parallel implementation to specialized extension of agentic-flow, eliminating 10,000+ lines of duplicate code while achieving 100% feature parity and performance improvements.
-
-## Integration Strategy
-
-### **Current Duplication Analysis**
-
-```
-┌─────────────────────────────────────────┐
-│         FUNCTIONALITY OVERLAP           │
-├─────────────────────────────────────────┤
-│  monomind          agentic-flow      │
-├─────────────────────────────────────────┤
-│ SwarmCoordinator  →   Swarm System      │ 80% overlap
-│ AgentManager      →   Agent Lifecycle   │ 70% overlap
-│ TaskScheduler     →   Task Execution    │ 60% overlap
-│ SessionManager    →   Session Mgmt      │ 50% overlap
-└─────────────────────────────────────────┘
-
-TARGET: <5,000 lines orchestration (vs 15,000+ currently)
-```
-
-### **Integration Architecture**
-
-```typescript
-// Phase 1: Adapter Layer Creation
-import { Agent as AgenticFlowAgent } from "agentic-flow@alpha";
-
-export class MonomindAgent extends AgenticFlowAgent {
-  // Add monomind specific capabilities
-  async handleMonomindTask(task: ClaudeTask): Promise<TaskResult> {
-    return this.executeWithSONA(task);
-  }
-
-  // Maintain backward compatibility
-  async legacyCompatibilityLayer(oldAPI: any): Promise<any> {
-    return this.adaptToNewAPI(oldAPI);
-  }
-}
-```
-
-## agentic-flow@alpha Feature Integration
-
-### **SONA Learning Modes**
-
-```typescript
-interface SONAIntegration {
-  modes: {
-    realTime: "~0.05ms adaptation";
-    balanced: "general purpose learning";
-    research: "deep exploration mode";
-    edge: "resource-constrained environments";
-    batch: "high-throughput processing";
-  };
-}
-
-// Integration implementation
-class MonomindSONAAdapter {
-  async initializeSONAMode(mode: SONAMode): Promise<void> {
-    await this.agenticFlow.sona.setMode(mode);
-    await this.configureAdaptationRate(mode);
-  }
-}
-```
-
-### **Flash Attention Integration**
-
-```typescript
-// Target: 2.49x-7.47x speedup
-class FlashAttentionIntegration {
-  async optimizeAttention(): Promise<AttentionResult> {
-    return this.agenticFlow.attention.flashAttention({
-      speedupTarget: "2.49x-7.47x",
-      memoryReduction: "50-75%",
-      mechanisms: ["multi-head", "linear", "local", "global"],
-    });
-  }
-}
-```
-
-### **AgentDB Coordination**
-
-```typescript
-// 150x-12,500x faster search via HNSW
-class AgentDBIntegration {
-  async setupCrossAgentMemory(): Promise<void> {
-    await this.agentdb.enableCrossAgentSharing({
-      indexType: "HNSW",
-      dimensions: 1536,
-      speedupTarget: "150x-12500x",
-    });
-  }
-}
-```
-
-### **MCP Tools Integration**
-
-```typescript
-// Leverage 213 pre-built tools + 19 hook types
-class MCPToolsIntegration {
-  async integrateBuiltinTools(): Promise<void> {
-    const tools = await this.agenticFlow.mcp.getAvailableTools();
-    // 213 tools available
-    await this.registerMonomindSpecificTools(tools);
-  }
-
-  async setupHookTypes(): Promise<void> {
-    const hookTypes = await this.agenticFlow.hooks.getTypes();
-    // 19 hook types: pre/post execution, error handling, etc.
-    await this.configureMonomindHooks(hookTypes);
-  }
-}
-```
-
-### **RL Algorithm Integration**
-
-```typescript
-// Multiple RL algorithms for optimization
-class RLIntegration {
-  algorithms = [
-    "PPO",
-    "DQN",
-    "A2C",
-    "MCTS",
-    "Q-Learning",
-    "SARSA",
-    "Actor-Critic",
-    "Decision-Transformer",
-    "Curiosity-Driven",
-  ];
-
-  async optimizeAgentBehavior(): Promise<void> {
-    for (const algorithm of this.algorithms) {
-      await this.agenticFlow.rl.train(algorithm, {
-        episodes: 1000,
-        learningRate: 0.001,
-        rewardFunction: this.monomindRewardFunction,
-      });
-    }
-  }
-}
-```
-
-## Migration Implementation Plan
-
-### **Phase 1: Foundation Adapter (Week 7)**
-
-```typescript
-// Create compatibility layer
-class AgenticFlowAdapter {
-  constructor(private agenticFlow: AgenticFlowCore) {}
-
-  // Migrate SwarmCoordinator → Swarm System
-  async migrateSwarmCoordination(): Promise<void> {
-    const swarmConfig = await this.extractSwarmConfig();
-    await this.agenticFlow.swarm.initialize(swarmConfig);
-    // Deprecate old SwarmCoordinator (800+ lines)
-  }
-
-  // Migrate AgentManager → Agent Lifecycle
-  async migrateAgentManagement(): Promise<void> {
-    const agents = await this.extractActiveAgents();
-    for (const agent of agents) {
-      await this.agenticFlow.agent.create(agent);
-    }
-    // Deprecate old AgentManager (1,736 lines)
-  }
-}
-```
-
-### **Phase 2: Core Migration (Week 8-9)**
-
-```typescript
-// Migrate task execution
-class TaskExecutionMigration {
-  async migrateToTaskGraph(): Promise<void> {
-    const tasks = await this.extractTasks();
-    const taskGraph = this.buildTaskGraph(tasks);
-    await this.agenticFlow.task.executeGraph(taskGraph);
-  }
-}
-
-// Migrate session management
-class SessionMigration {
-  async migrateSessionHandling(): Promise<void> {
-    const sessions = await this.extractActiveSessions();
-    for (const session of sessions) {
-      await this.agenticFlow.session.create(session);
-    }
-  }
-}
-```
-
-### **Phase 3: Optimization (Week 10)**
-
-```typescript
-// Remove compatibility layer
-class CompatibilityCleanup {
-  async removeDeprecatedCode(): Promise<void> {
-    // Remove old implementations
-    await this.removeFile("src/core/SwarmCoordinator.ts"); // 800+ lines
-    await this.removeFile("src/agents/AgentManager.ts"); // 1,736 lines
-    await this.removeFile("src/task/TaskScheduler.ts"); // 500+ lines
-
-    // Total code reduction: 10,000+ lines → <5,000 lines
-  }
-}
-```
-
-## Performance Integration Targets
-
-### **Flash Attention Optimization**
-
-```typescript
-// Target: 2.49x-7.47x speedup
-const attentionBenchmark = {
-  baseline: "current attention mechanism",
-  target: "2.49x-7.47x improvement",
-  memoryReduction: "50-75%",
-  implementation: "agentic-flow@alpha Flash Attention",
-};
-```
-
-### **AgentDB Search Performance**
-
-```typescript
-// Target: 150x-12,500x improvement
-const searchBenchmark = {
-  baseline: "linear search in current memory systems",
-  target: "150x-12,500x via HNSW indexing",
-  implementation: "agentic-flow@alpha AgentDB",
-};
-```
-
-### **SONA Learning Performance**
-
-```typescript
-// Target: <0.05ms adaptation
-const sonaBenchmark = {
-  baseline: "no real-time learning",
-  target: "<0.05ms adaptation time",
-  modes: ["real-time", "balanced", "research", "edge", "batch"],
-};
-```
-
-## Backward Compatibility Strategy
-
-### **Gradual Migration Approach**
-
-```typescript
-class BackwardCompatibility {
-  // Phase 1: Dual operation (old + new)
-  async enableDualOperation(): Promise<void> {
-    this.oldSystem.continue();
-    this.newSystem.initialize();
-    this.syncState(this.oldSystem, this.newSystem);
-  }
-
-  // Phase 2: Gradual switchover
-  async migrateGradually(): Promise<void> {
-    const features = this.getAllFeatures();
-    for (const feature of features) {
-      await this.migrateFeature(feature);
-      await this.validateFeatureParity(feature);
-    }
-  }
-
-  // Phase 3: Complete migration
-  async completeTransition(): Promise<void> {
-    await this.validateFullParity();
-    await this.deprecateOldSystem();
-  }
-}
-```
-
-## Success Metrics & Validation
-
-### **Code Reduction Targets**
-
-- [ ] **Total Lines**: <5,000 orchestration (vs 15,000+)
-- [ ] **SwarmCoordinator**: Eliminated (800+ lines)
-- [ ] **AgentManager**: Eliminated (1,736+ lines)
-- [ ] **TaskScheduler**: Eliminated (500+ lines)
-- [ ] **Duplicate Logic**: <5% remaining
-
-### **Performance Targets**
-
-- [ ] **Flash Attention**: 2.49x-7.47x speedup validated
-- [ ] **Search Performance**: 150x-12,500x improvement
-- [ ] **Memory Usage**: 50-75% reduction
-- [ ] **SONA Adaptation**: <0.05ms response time
-
-### **Feature Parity**
-
-- [ ] **100% Feature Compatibility**: All v2 features available
-- [ ] **API Compatibility**: Backward compatible interfaces
-- [ ] **Performance**: No regression, ideally improvement
-- [ ] **Documentation**: Migration guide complete
-
-## Coordination Points
-
-### **Memory Specialist (Agent #7)**
-
-- AgentDB integration coordination
-- Cross-agent memory sharing setup
-- Performance benchmarking collaboration
-
-### **Swarm Specialist (Agent #8)**
-
-- Swarm system migration from monomind to agentic-flow
-- Topology coordination and optimization
-- Agent communication protocol alignment
-
-### **Performance Engineer (Agent #14)**
-
-- Performance target validation
-- Benchmark implementation for improvements
-- Regression testing for migration phases
-
-## Risk Mitigation
-
-| Risk                          | Likelihood | Impact | Mitigation                           |
-| ----------------------------- | ---------- | ------ | ------------------------------------ |
-| agentic-flow breaking changes | Medium     | High   | Pin version, maintain adapter        |
-| Performance regression        | Low        | Medium | Continuous benchmarking              |
-| Feature limitations           | Medium     | Medium | Contribute upstream features         |
-| Migration complexity          | High       | Medium | Phased approach, compatibility layer |

package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md

@@ -1,54 +0,0 @@
-# Analysis Commands Compliance Report
-
-## Overview
-Reviewed all command files in `.claude/commands/analysis/` directory to ensure proper usage of:
-- `mcp__monomind__*` tools (preferred)
-- `npx monomind` commands (as fallback)
-- No direct implementation calls
-
-## Files Reviewed
-
-### 1. token-efficiency.md
-**Status**: ✅ Updated
-**Changes Made**:
-- Replaced `npx ruv-swarm hook session-end --export-metrics` with proper MCP tool call
-- Updated to: `Tool: mcp__monomind__token_usage` with appropriate parameters
-- Maintained result format and context
-
-**Before**:
-```bash
-npx ruv-swarm hook session-end --export-metrics
-```
-
-**After**:
-```
-Tool: mcp__monomind__token_usage
-Parameters: {"operation": "session", "timeframe": "24h"}
-```
-
-### 2. performance-bottlenecks.md
-**Status**: ✅ Compliant (No changes needed)
-**Reason**: Already uses proper `mcp__monomind__task_results` tool format
-
-## Summary
-
-- **Total files reviewed**: 2
-- **Files updated**: 1
-- **Files already compliant**: 1
-- **Compliance rate after updates**: 100%
-
-## Compliance Patterns Enforced
-
-1. **MCP Tool Usage**: All direct tool calls now use `mcp__monomind__*` format
-2. **Parameter Format**: JSON parameters properly structured
-3. **Command Context**: Preserved original functionality and expected results
-4. **Documentation**: Maintained clarity and examples
-
-## Recommendations
-
-1. All analysis commands now follow the proper pattern
-2. No direct bash commands or implementation calls remain
-3. Token usage analysis properly integrated with MCP tools
-4. Performance analysis already using correct tool format
-
-The analysis directory is now fully compliant with the Monomind command standards.

package/.claude/commands/coordination/init.md

@@ -1,44 +0,0 @@
-# Initialize Coordination Framework
-
-## 🎯 Key Principle
-**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
-
-## MCP Tool Usage in Claude Code
-
-**Tool:** `mcp__monomind__swarm_init`
-
-## Parameters
-```json
-{"topology": "mesh", "maxAgents": 5, "strategy": "balanced"}
-```
-
-## Description
-Set up a coordination topology to guide Claude Code's approach to complex tasks
-
-## Details
-This tool creates a coordination framework that helps Claude Code:
-- Break down complex problems systematically
-- Approach tasks from multiple perspectives
-- Maintain consistency across large projects
-- Work more efficiently through structured coordination
-
-Remember: This does NOT create actual coding agents. It creates a coordination pattern for Claude Code to follow.
-
-## Example Usage
-
-**In Claude Code:**
-1. Use the tool: `mcp__monomind__swarm_init`
-2. With parameters: `{"topology": "mesh", "maxAgents": 5, "strategy": "balanced"}`
-3. Claude Code then executes the coordinated plan using its native tools
-
-## Important Reminders
-- ✅ This tool provides coordination and structure
-- ✅ Claude Code performs all actual implementation
-- ❌ The tool does NOT write code
-- ❌ The tool does NOT access files directly
-- ❌ The tool does NOT execute commands
-
-## See Also
-- Main documentation: /claude.md
-- Other commands in this category
-- Workflow examples in /workflows/

package/.claude/commands/coordination/orchestrate.md

@@ -1,43 +0,0 @@
-# Coordinate Task Execution
-
-## 🎯 Key Principle
-**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
-
-## MCP Tool Usage in Claude Code
-
-**Tool:** `mcp__monomind__task_orchestrate`
-
-## Parameters
-```json
-{"task": "Implement authentication system", "strategy": "parallel", "priority": "high"}
-```
-
-## Description
-Break down and coordinate complex tasks for systematic execution by Claude Code
-
-## Details
-Orchestration strategies:
-- **parallel**: Claude Code works on independent components simultaneously
-- **sequential**: Step-by-step execution for dependent tasks
-- **adaptive**: Dynamically adjusts based on task complexity
-
-The orchestrator creates a plan that Claude Code follows using its native tools.
-
-## Example Usage
-
-**In Claude Code:**
-1. Use the tool: `mcp__monomind__task_orchestrate`
-2. With parameters: `{"task": "Implement authentication system", "strategy": "parallel", "priority": "high"}`
-3. Claude Code then executes the coordinated plan using its native tools
-
-## Important Reminders
-- ✅ This tool provides coordination and structure
-- ✅ Claude Code performs all actual implementation
-- ❌ The tool does NOT write code
-- ❌ The tool does NOT access files directly
-- ❌ The tool does NOT execute commands
-
-## See Also
-- Main documentation: /claude.md
-- Other commands in this category
-- Workflow examples in /workflows/

package/.claude/commands/coordination/spawn.md

@@ -1,45 +0,0 @@
-# Create Cognitive Patterns
-
-## 🎯 Key Principle
-**This tool coordinates Claude Code's actions. It does NOT write code or create content.**
-
-## MCP Tool Usage in Claude Code
-
-**Tool:** `mcp__monomind__agent_spawn`
-
-## Parameters
-```json
-{"type": "researcher", "name": "Literature Analysis", "capabilities": ["deep-analysis"]}
-```
-
-## Description
-Define cognitive patterns that represent different approaches Claude Code can take
-
-## Details
-Agent types represent thinking patterns, not actual coders:
-- **researcher**: Systematic exploration approach
-- **coder**: Implementation-focused thinking
-- **analyst**: Data-driven decision making
-- **architect**: Big-picture system design
-- **reviewer**: Quality and consistency checking
-
-These patterns guide how Claude Code approaches different aspects of your task.
-
-## Example Usage
-
-**In Claude Code:**
-1. Use the tool: `mcp__monomind__agent_spawn`
-2. With parameters: `{"type": "researcher", "name": "Literature Analysis", "capabilities": ["deep-analysis"]}`
-3. Claude Code then executes the coordinated plan using its native tools
-
-## Important Reminders
-- ✅ This tool provides coordination and structure
-- ✅ Claude Code performs all actual implementation
-- ❌ The tool does NOT write code
-- ❌ The tool does NOT access files directly
-- ❌ The tool does NOT execute commands
-
-## See Also
-- Main documentation: /claude.md
-- Other commands in this category
-- Workflow examples in /workflows/