moflo 4.8.31 → 4.8.32

package/.claude/config/v3-dependency-optimization.json

@@ -1,266 +0,0 @@
-{
-  "v3DependencyOptimization": {
-    "version": "3.0.0",
-    "strategy": "enhanced_parallelism",
-    "description": "Optimized dependency chain for maximum parallel execution efficiency",
-
-    "originalDependencies": {
-      "description": "Current dependency chain with blocking issues",
-      "issues": [
-        "Some agents wait unnecessarily for unrelated dependencies",
-        "Phase boundaries too rigid, reducing parallelism",
-        "Agent #11 and #12 have excessive blocking dependencies"
-      ]
-    },
-
-    "optimizedDependencies": {
-      "description": "Enhanced parallel execution with reduced blocking",
-
-      "phases": {
-        "phase1_enhanced": {
-          "name": "Enhanced Foundation (Weeks 1-3)",
-          "description": "Increased parallelism in foundation phase",
-          "parallel_groups": [
-            {
-              "group": "security_foundation",
-              "agents": [2, 3, 4],
-              "dependencies": [],
-              "description": "Security agents run in full parallel",
-              "estimated_duration": "2 weeks"
-            },
-            {
-              "group": "core_architecture",
-              "agents": [5],
-              "dependencies": [],
-              "description": "Core architect starts immediately with security",
-              "estimated_duration": "1 week"
-            },
-            {
-              "group": "testing_foundation",
-              "agents": [13],
-              "dependencies": [],
-              "description": "TDD engineer starts early for framework setup",
-              "estimated_duration": "1 week"
-            },
-            {
-              "group": "performance_setup",
-              "agents": [14],
-              "dependencies": [],
-              "description": "Performance engineer starts benchmark setup",
-              "estimated_duration": "1 week"
-            }
-          ]
-        },
-
-        "phase2_enhanced": {
-          "name": "Enhanced Core Systems (Weeks 2-6)",
-          "description": "Overlapped execution with phase 1",
-          "parallel_groups": [
-            {
-              "group": "core_implementation",
-              "agents": [6, 7, 8],
-              "dependencies": [5],
-              "description": "Core implementation agents start after architect",
-              "estimated_duration": "3 weeks"
-            },
-            {
-              "group": "mcp_optimization",
-              "agents": [9],
-              "dependencies": [5],
-              "description": "MCP specialist works in parallel with core",
-              "estimated_duration": "2 weeks"
-            },
-            {
-              "group": "queen_coordination",
-              "agents": [1],
-              "dependencies": [2, 5],
-              "description": "Queen starts once security baseline + architecture ready",
-              "estimated_duration": "4 weeks"
-            }
-          ]
-        },
-
-        "phase3_enhanced": {
-          "name": "Enhanced Integration (Weeks 5-9)",
-          "description": "Reduced blocking dependencies for integration agents",
-          "parallel_groups": [
-            {
-              "group": "integration_core",
-              "agents": [10],
-              "dependencies": [5, 7],
-              "description": "Integration architect needs only core arch + memory",
-              "estimated_duration": "3 weeks"
-            },
-            {
-              "group": "cli_modernization",
-              "agents": [11],
-              "dependencies": [5],
-              "description": "CLI developer needs only core architecture (reduced from [5,10])",
-              "estimated_duration": "2 weeks"
-            },
-            {
-              "group": "neural_learning",
-              "agents": [12],
-              "dependencies": [5],
-              "description": "Neural developer needs only core architecture (reduced from [7,10])",
-              "estimated_duration": "2 weeks"
-            }
-          ]
-        },
-
-        "phase4_enhanced": {
-          "name": "Enhanced Polish & Release (Weeks 9-16)",
-          "description": "Final optimization with all agents active",
-          "parallel_groups": [
-            {
-              "group": "release_preparation",
-              "agents": [15],
-              "dependencies": [13, 14],
-              "description": "Release engineer waits for testing + performance validation",
-              "estimated_duration": "2 weeks"
-            },
-            {
-              "group": "final_optimization",
-              "agents": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14],
-              "dependencies": [],
-              "description": "All agents perform final optimization in parallel",
-              "estimated_duration": "1 week"
-            }
-          ]
-        }
-      }
-    },
-
-    "reducedBlockingDependencies": {
-      "description": "Specific dependency reductions to enable better parallelism",
-      "changes": [
-        {
-          "agent": "cli-hooks-developer (11)",
-          "original_dependencies": [5, 10],
-          "optimized_dependencies": [5],
-          "rationale": "CLI can be modernized with just core architecture, integration can happen later",
-          "parallel_gain": "Can start 2 weeks earlier"
-        },
-        {
-          "agent": "neural-learning-developer (12)",
-          "original_dependencies": [7, 10],
-          "optimized_dependencies": [5],
-          "rationale": "Neural learning can start with core architecture, memory/integration can be added incrementally",
-          "parallel_gain": "Can start 3 weeks earlier"
-        },
-        {
-          "agent": "queen-coordinator (1)",
-          "original_dependencies": [],
-          "optimized_dependencies": [2, 5],
-          "rationale": "Queen should wait for security baseline and core architecture before orchestrating",
-          "coordination_benefit": "More intelligent coordination with foundation in place"
-        }
-      ]
-    },
-
-    "phaseBoundaryOptimization": {
-      "description": "Flexible phase boundaries to maximize parallel efficiency",
-      "strategy": "overlapping_phases",
-      "rules": {
-        "phase_overlap": "50%",
-        "description": "Phases can overlap by 50% once foundation requirements are met",
-        "example": "Phase 2 core systems can start in week 2 while Phase 1 security continues"
-      },
-
-      "flexibility_rules": [
-        {
-          "condition": "Agent dependencies satisfied",
-          "action": "Allow early phase advancement",
-          "benefit": "Maximize parallel agent utilization"
-        },
-        {
-          "condition": "Critical path agents complete",
-          "action": "Start next phase critical agents early",
-          "benefit": "Reduce overall timeline"
-        },
-        {
-          "condition": "Blocking issues detected",
-          "action": "Reassign free agents to unblocked work",
-          "benefit": "Maintain productivity during blocks"
-        }
-      ]
-    },
-
-    "parallelEfficiencyTargets": {
-      "phase1": {
-        "agent_utilization": "85%",
-        "parallel_agents": "4-6 concurrent",
-        "timeline_efficiency": "20% improvement"
-      },
-      "phase2": {
-        "agent_utilization": "90%",
-        "parallel_agents": "6-8 concurrent",
-        "timeline_efficiency": "25% improvement"
-      },
-      "phase3": {
-        "agent_utilization": "95%",
-        "parallel_agents": "8-12 concurrent",
-        "timeline_efficiency": "30% improvement"
-      },
-      "phase4": {
-        "agent_utilization": "100%",
-        "parallel_agents": "15 concurrent",
-        "timeline_efficiency": "Maximum parallel execution"
-      }
-    },
-
-    "riskMitigation": {
-      "description": "Risk management for optimized dependency chain",
-      "strategies": [
-        {
-          "risk": "Early agent starts without sufficient foundation",
-          "mitigation": "Minimum viable dependencies enforced",
-          "monitoring": "Regular dependency satisfaction checks"
-        },
-        {
-          "risk": "Coordination overhead with more parallel agents",
-          "mitigation": "Queen coordinator with enhanced GitHub integration",
-          "monitoring": "Agent coordination latency tracking"
-        },
-        {
-          "risk": "Integration complexity with reduced dependencies",
-          "mitigation": "Incremental integration approach",
-          "monitoring": "Integration test coverage requirements"
-        }
-      ]
-    },
-
-    "implementation": {
-      "tooling": {
-        "dependency_tracker": "GitHub project boards with agent assignments",
-        "parallel_monitor": "Real-time agent utilization dashboard",
-        "coordination": "Queen coordinator with MCP orchestration tools"
-      },
-
-      "coordination_patterns": {
-        "daily_standups": "Agent status and dependency updates",
-        "blocker_resolution": "Immediate reassignment protocols",
-        "phase_transitions": "Gradual transition with readiness checks"
-      }
-    },
-
-    "success_metrics": {
-      "efficiency": {
-        "target": "90% average agent utilization",
-        "measurement": "Time agents spend on productive work vs waiting"
-      },
-      "timeline": {
-        "target": "16 weeks total (vs 20 weeks with original dependencies)",
-        "measurement": "Overall project completion time"
-      },
-      "coordination": {
-        "target": "<4 hours average blocker resolution time",
-        "measurement": "Time from blocker identification to resolution"
-      },
-      "quality": {
-        "target": "No degradation in output quality due to rushed dependencies",
-        "measurement": "Test coverage and review completion rates"
-      }
-    }
-  }
-}

package/.claude/config/v3-performance-targets.json

@@ -1,251 +0,0 @@
-{
-  "v3PerformanceTargets": {
-    "version": "3.0.0",
-    "strategy": "phased_rollout",
-    "totalPhases": 4,
-    "riskMitigation": "progressive_targets",
-
-    "phases": {
-      "phase1": {
-        "name": "Security Foundation",
-        "duration": "weeks 1-3",
-        "description": "Conservative targets while establishing security baseline",
-        "targets": {
-          "flashAttention": {
-            "target": "2.49x minimum",
-            "description": "Conservative start, focus on stability",
-            "measurement": "baseline vs flash attention speedup",
-            "priority": "medium"
-          },
-          "searchImprovement": {
-            "target": "150x minimum",
-            "description": "Basic HNSW implementation",
-            "measurement": "vector search latency improvement",
-            "priority": "high"
-          },
-          "memoryReduction": {
-            "target": "40%",
-            "description": "Initial optimization, achievable target",
-            "measurement": "heap usage reduction",
-            "priority": "medium"
-          },
-          "startupTime": {
-            "target": "<750ms",
-            "description": "Less aggressive than final target",
-            "measurement": "CLI cold start time",
-            "priority": "high"
-          },
-          "securityScore": {
-            "target": "75/100",
-            "description": "Significant security improvement",
-            "measurement": "npm audit + custom security scans",
-            "priority": "critical"
-          }
-        },
-        "gates": {
-          "required": ["securityScore", "startupTime"],
-          "optional": ["flashAttention", "memoryReduction"]
-        }
-      },
-
-      "phase2": {
-        "name": "Core Systems Optimization",
-        "duration": "weeks 4-8",
-        "description": "Mid-range targets with core system optimizations",
-        "targets": {
-          "flashAttention": {
-            "target": "3.5x - 5.0x",
-            "description": "Mid-range optimization",
-            "measurement": "sequence processing speedup",
-            "priority": "high"
-          },
-          "searchImprovement": {
-            "target": "500x - 2000x",
-            "description": "Optimized HNSW with tuning",
-            "measurement": "vector search performance",
-            "priority": "high"
-          },
-          "memoryReduction": {
-            "target": "50%",
-            "description": "Enhanced optimization techniques",
-            "measurement": "memory usage efficiency",
-            "priority": "medium"
-          },
-          "startupTime": {
-            "target": "<500ms",
-            "description": "Target achieved with optimization",
-            "measurement": "CLI startup latency",
-            "priority": "high"
-          },
-          "swarmCoordination": {
-            "target": "<100ms",
-            "description": "15-agent coordination latency",
-            "measurement": "swarm consensus time",
-            "priority": "high"
-          },
-          "agentSpawnTime": {
-            "target": "<200ms",
-            "description": "Individual agent spawn latency",
-            "measurement": "agent initialization time",
-            "priority": "medium"
-          }
-        },
-        "gates": {
-          "required": ["flashAttention", "searchImprovement", "startupTime"],
-          "optional": ["swarmCoordination", "agentSpawnTime"]
-        }
-      },
-
-      "phase3": {
-        "name": "Integration Excellence",
-        "duration": "weeks 9-12",
-        "description": "High-performance targets with full integration",
-        "targets": {
-          "flashAttention": {
-            "target": "5.0x - 7.47x",
-            "description": "Near-maximum optimization",
-            "measurement": "attention mechanism performance",
-            "priority": "high"
-          },
-          "searchImprovement": {
-            "target": "2000x - 12,500x",
-            "description": "Maximum performance achieved",
-            "measurement": "vector database performance",
-            "priority": "high"
-          },
-          "memoryReduction": {
-            "target": "65%",
-            "description": "Advanced compression techniques",
-            "measurement": "overall memory efficiency",
-            "priority": "medium"
-          },
-          "startupTime": {
-            "target": "<350ms",
-            "description": "Excellence target achieved",
-            "measurement": "optimized CLI performance",
-            "priority": "medium"
-          },
-          "mcpResponseTime": {
-            "target": "<100ms p95",
-            "description": "MCP server optimization",
-            "measurement": "MCP tool execution latency",
-            "priority": "high"
-          },
-          "learningAdaptation": {
-            "target": "<0.05ms",
-            "description": "SONA micro-LoRA adaptation",
-            "measurement": "learning cycle latency",
-            "priority": "medium"
-          }
-        },
-        "gates": {
-          "required": ["flashAttention", "searchImprovement", "mcpResponseTime"],
-          "optional": ["memoryReduction", "learningAdaptation"]
-        }
-      },
-
-      "phase4": {
-        "name": "Excellence & Polish",
-        "duration": "weeks 13-16",
-        "description": "Stretch targets and final optimization",
-        "targets": {
-          "flashAttention": {
-            "target": "7.47x",
-            "description": "Maximum theoretical speedup",
-            "measurement": "peak attention performance",
-            "priority": "stretch"
-          },
-          "searchImprovement": {
-            "target": "12,500x",
-            "description": "Peak HNSW performance",
-            "measurement": "optimal vector search",
-            "priority": "stretch"
-          },
-          "memoryReduction": {
-            "target": "75%",
-            "description": "Maximum memory efficiency",
-            "measurement": "peak memory optimization",
-            "priority": "stretch"
-          },
-          "startupTime": {
-            "target": "<300ms",
-            "description": "Sub-300ms cold start",
-            "measurement": "peak startup performance",
-            "priority": "stretch"
-          },
-          "overallThroughput": {
-            "target": "10x",
-            "description": "Overall system throughput",
-            "measurement": "end-to-end performance",
-            "priority": "high"
-          },
-          "reliabilityScore": {
-            "target": "99.9%",
-            "description": "Three nines reliability",
-            "measurement": "system uptime and stability",
-            "priority": "high"
-          }
-        },
-        "gates": {
-          "required": ["overallThroughput", "reliabilityScore"],
-          "optional": ["flashAttention", "searchImprovement", "memoryReduction"]
-        }
-      }
-    },
-
-    "monitoring": {
-      "frequency": "continuous",
-      "alerting": {
-        "regressionThreshold": "10%",
-        "criticalThreshold": "25%",
-        "notificationChannels": ["console", "metrics"]
-      },
-      "benchmarks": {
-        "automated": true,
-        "schedule": "daily",
-        "regressionDetection": true
-      }
-    },
-
-    "rollbackTriggers": [
-      "Security score drops below 70/100",
-      "Startup time exceeds 1000ms",
-      "Memory usage increases by >50%",
-      "Critical functionality broken",
-      "Performance regression >25%"
-    ],
-
-    "success_metrics": {
-      "phase1_success": {
-        "security_baseline": "Achieved 75/100 security score",
-        "stability": "No critical regressions",
-        "performance": "Baseline improvements established"
-      },
-      "phase2_success": {
-        "performance": "Mid-range targets achieved",
-        "coordination": "15-agent swarm operational",
-        "optimization": "Core systems optimized"
-      },
-      "phase3_success": {
-        "integration": "agentic-flow integration complete",
-        "performance": "High-performance targets met",
-        "features": "All v3 features operational"
-      },
-      "phase4_success": {
-        "excellence": "Stretch targets achieved where possible",
-        "reliability": "Production-ready stability",
-        "optimization": "Peak performance validated"
-      }
-    },
-
-    "adaptive_strategy": {
-      "enabled": true,
-      "description": "Targets adjust based on actual achievement rates",
-      "rules": {
-        "if_ahead_of_schedule": "Attempt next phase targets early",
-        "if_behind_schedule": "Focus on required gates, defer optional",
-        "if_critical_issues": "Halt advancement, focus on resolution"
-      }
-    }
-  }
-}

package/.claude/guidance/moflo-bootstrap.md

@@ -1,129 +0,0 @@
-<!-- AUTO-GENERATED by moflo session-start. Do not edit — changes will be overwritten. -->
-<!-- Source: node_modules/moflo/.claude/guidance/agent-bootstrap.md -->
-
-# MoFlo Agent Bootstrap Guide
-
-**Purpose:** Quick-start reference for subagents spawned by coordinators. Every subagent should follow this protocol before doing any work.
-
----
-
-## 1. Search Memory FIRST
-
-**Before reading any files or exploring code, search memory for guidance relevant to your task.**
-
-### Three namespaces to search:
-
-| Namespace | When to search | What it returns |
-|-----------|---------------|-----------------|
-| `guidance` | Understanding patterns, rules, conventions | Guidance docs, coding rules, domain context |
-| `code-map` | Finding where code lives (files, types, services) | Project overviews, directory contents, type-to-file mappings |
-| `patterns` | Prior solutions, gotchas, implementation patterns | Learned patterns from previous task execution |
-
-**Always search `patterns` alongside `guidance`.** It contains solutions to problems already solved — skipping it means repeating past mistakes or re-discovering known approaches.
-
-**Search `code-map` BEFORE using Glob/Grep for navigation.** It's faster and returns structured results including file-level type mappings.
-
-### Option A: MCP Tools (Preferred)
-
-If you have MCP tools available (check for `mcp__moflo__*`), use them directly:
-
-| Tool | Purpose |
-|------|---------|
-| `mcp__moflo__memory_search` | Semantic search with domain-aware embeddings |
-| `mcp__moflo__memory_store` | Store patterns with auto-vectorization |
-| `mcp__moflo__hooks_route` | Get agent routing suggestions |
-
-### Option B: CLI via Bash
-
-```bash
-npx flo memory search --query "[describe your task]" --namespace guidance --limit 5
-```
-
-| Your task involves... | Search namespace | Example query |
-|-----------------------|------------------|---------------|
-| Database/entities | `guidance` + `patterns` | `"database entity migration"` |
-| Frontend components | `guidance` + `patterns` | `"React frontend component"` |
-| API endpoints | `guidance` + `patterns` | `"API route endpoint pattern"` |
-| Authentication | `guidance` + `patterns` | `"auth middleware JWT"` |
-| Unit tests | `guidance` + `patterns` | `"test mock vitest"` |
-| Prior solutions/gotchas | `patterns` | `"audit log service pattern"` |
-| Where is a file/type? | `code-map` | `"CompanyEntity file location"` |
-| What's in a directory? | `code-map` | `"back-office api routes"` |
-
-Use results with score > 0.3. If no good results, fall back to reading project guidance docs.
-
----
-
-## 2. Check Project-Specific Bootstrap
-
-**After reading this file, check for a project-specific bootstrap:**
-
-```bash
-# Project-specific bootstrap (has domain rules, patterns, templates)
-cat .claude/guidance/agent-bootstrap.md 2>/dev/null | head -10
-```
-
-If `.claude/guidance/agent-bootstrap.md` exists, **read it next**. It contains project-specific rules (entity patterns, multi-tenancy, tech stack conventions) that override generic guidance.
-
-If no project bootstrap exists, look for general project guidance:
-
-```bash
-ls .claude/guidance/ 2>/dev/null
-cat .claude/guidance/core.md 2>/dev/null | head -50
-```
-
-Project guidance always takes precedence over generic patterns.
-
----
-
-## 3. Universal Rules
-
-### Memory Protocol
-- Search memory before exploring files
-- Store discoveries back to memory when done
-- Use `patterns` namespace for solutions and gotchas
-- Use `decisions` namespace for architectural choices
-
-### Git/Branches
-- Use conventional commit prefixes: `feat:`, `fix:`, `refactor:`, `test:`, `chore:`
-- Use branch prefixes: `feature/`, `fix/`, `refactor/`
-- Use kebab-case for branch names
-
-### File Organization
-- Never save working files to repository root
-- Keep changes focused (3-10 files)
-- Stay within feature scope
-
-### Build & Test
-- Build and test after code changes
-- Never leave failing tests
-
----
-
-## 4. Store Discoveries
-
-If you discover something new (pattern, solution, gotcha), store it:
-
-### MCP (Preferred):
-```
-mcp__moflo__memory_store
-  namespace: "patterns"
-  key: "brief-descriptive-key"
-  value: "1-2 sentence insight"
-```
-
-### CLI Fallback:
-```bash
-npx flo memory store --namespace patterns --key "brief-descriptive-key" --value "1-2 sentence insight"
-```
-
-**Store:** Solutions to tricky bugs, patterns that worked, gotchas, workarounds
-**Skip:** Summaries of retrieved guidance, general rules, file locations
-
----
-
-## 5. When Complete
-
-1. Report findings to coordinator
-2. Store learnings if you discovered something new
-3. Coordinator will mark your task as completed

package/.claude/mcp.json

@@ -1,13 +0,0 @@
-{
-  "mcpServers": {
-    "flow-nexus": {
-      "command": "node",
-      "args": ["/workspaces/flow-cloud/mcp/flow-nexus-sse/mcp-server-supabase.js"],
-      "env": {
-        "SUPABASE_URL": "${SUPABASE_URL}",
-        "SUPABASE_ANON_KEY": "${SUPABASE_ANON_KEY}",
-        "NODE_NO_WARNINGS": "1"
-      }
-    }
-  }
-}