moflo 4.8.12 → 4.8.14

package/.claude/settings.json

@@ -156,7 +156,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/scripts/session-start-launcher.mjs\"",
+            "command": "node \"$CLAUDE_PROJECT_DIR/bin/session-start-launcher.mjs\"",
             "timeout": 3000
           }
         ]

package/.claude/workflow-state.json

@@ -2,8 +2,8 @@
   "tasksCreated": true,
   "taskCount": 2,
   "memorySearched": false,
-  "sessionStart": "2026-03-22T21:38:40.085Z",
+  "sessionStart": "2026-03-23T02:45:57.764Z",
   "memoryRequired": true,
-  "interactionCount": 9,
-  "lastBlockedAt": "2026-03-22T21:51:54.015Z"
+  "interactionCount": 34,
+  "lastBlockedAt": "2026-03-23T04:05:05.816Z"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moflo",
-  "version": "4.8.12",
+  "version": "4.8.14",
   "description": "MoFlo — AI agent orchestration for Claude Code. Forked from ruflo/claude-flow with patches applied to source, plus feature-level orchestration.",
   "main": "dist/index.js",
   "type": "module",
@@ -12,7 +12,6 @@
     "flo-embeddings": "bin/build-embeddings.mjs",
     "flo-index": "bin/index-guidance.mjs",
     "flo-testmap": "bin/index-tests.mjs",
-    "flo-learn": ".claude/helpers/learning-service.mjs",
     "moflo": "bin/cli.js",
     "claude-flow": "bin/cli.js"
   },
@@ -39,7 +38,6 @@
     "src/@claude-flow/memory/dist/**/*.d.ts",
     "!src/@claude-flow/memory/dist/**/*.map",
     "src/@claude-flow/memory/package.json",
-    ".claude-plugin/**",
     ".claude/**",
     "!.claude/guidance/internal/**",
     "!.claude/**/*.db",
@@ -85,7 +83,7 @@
     "@types/bcrypt": "^5.0.2",
     "@types/node": "^20.19.37",
     "eslint": "^8.0.0",
-    "moflo": "^4.8.11",
+    "moflo": "^4.8.13",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.0"

package/src/@claude-flow/cli/dist/src/commands/hooks.js

@@ -336,11 +336,11 @@ const routeCommand = {
         { command: 'claude-flow hooks route -t "Optimize database queries" -K 5', description: 'Get top 5 suggestions' }
     ],
     action: async (ctx) => {
-        const task = ctx.args[0] || ctx.flags.task;
+        const task = ctx.args[0] || ctx.flags.task || process.env.CLAUDE_USER_PROMPT || '';
         const topK = ctx.flags.topK || 3;
         if (!task) {
-            output.printError('Task description is required. Use --task or -t flag.');
-            return { success: false, exitCode: 1 };
+            // No task available (e.g. called from UserPromptSubmit hook with no prompt) — exit cleanly
+            return { success: true };
         }
         output.printInfo(`Routing task: ${output.highlight(task)}`);
         try {

package/src/@claude-flow/cli/dist/src/init/claudemd-generator.js

@@ -1,19 +1,19 @@
-/**
- * CLAUDE.md Generator
- *
- * Generates ONLY the MoFlo section to inject into a project's CLAUDE.md.
- * This must be minimal — just enough for Claude to work with moflo.
- * All detailed docs live in .claude/guidance/shipped/moflo.md (copied at install).
- *
- * Principle: we are guests in the user's CLAUDE.md. Keep it small.
- */
-const MARKER_START = '<!-- MOFLO:INJECTED:START -->';
-const MARKER_END = '<!-- MOFLO:INJECTED:END -->';
-/**
- * The single moflo section injected into CLAUDE.md.
- * ~40 lines. Points to moflo.md for everything else.
- */
-function mofloSection() {
+/**
+ * CLAUDE.md Generator
+ *
+ * Generates ONLY the MoFlo section to inject into a project's CLAUDE.md.
+ * This must be minimal — just enough for Claude to work with moflo.
+ * All detailed docs live in .claude/guidance/shipped/moflo.md (copied at install).
+ *
+ * Principle: we are guests in the user's CLAUDE.md. Keep it small.
+ */
+const MARKER_START = '<!-- MOFLO:INJECTED:START -->';
+const MARKER_END = '<!-- MOFLO:INJECTED:END -->';
+/**
+ * The single moflo section injected into CLAUDE.md.
+ * ~40 lines. Points to moflo.md for everything else.
+ */
+function mofloSection() {
     return `${MARKER_START}
 ## MoFlo — AI Agent Orchestration
 
@@ -54,34 +54,35 @@ npx flo doctor --fix                             # Health check
 
 ### Full Reference
 
-For CLI commands, hooks, agents, swarm config, memory commands, and moflo.yaml options, see:
-\`.claude/guidance/shipped/moflo.md\`
-${MARKER_END}`;
-}
-// --- Public API ---
-export { MARKER_START, MARKER_END };
-/**
- * Generate the MoFlo section to inject into CLAUDE.md.
- * Template parameter is accepted for backward compatibility but ignored —
- * all templates now produce the same minimal injection.
- */
-export function generateClaudeMd(_options, _template) {
-    return mofloSection() + '\n';
-}
-/**
- * Generate minimal CLAUDE.md content (backward-compatible alias).
- */
-export function generateMinimalClaudeMd(options) {
-    return generateClaudeMd(options, 'minimal');
-}
-/** Available template names for CLI wizard (kept for backward compat, all produce same output) */
-export const CLAUDE_MD_TEMPLATES = [
-    { name: 'minimal', description: 'Recommended — memory search, workflow gates, MCP tools (~40 lines injected)' },
-    { name: 'standard', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
-    { name: 'full', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
-    { name: 'security', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
-    { name: 'performance', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
-    { name: 'solo', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
-];
-export default generateClaudeMd;
+- **Agent bootstrap protocol:** \`.claude/guidance/shipped/agent-bootstrap.md\`
+- **Task + swarm coordination:** \`.claude/guidance/shipped/task-swarm-integration.md\`
+- **CLI, hooks, swarm, memory, moflo.yaml:** \`.claude/guidance/shipped/moflo.md\`
+${MARKER_END}`;
+}
+// --- Public API ---
+export { MARKER_START, MARKER_END };
+/**
+ * Generate the MoFlo section to inject into CLAUDE.md.
+ * Template parameter is accepted for backward compatibility but ignored —
+ * all templates now produce the same minimal injection.
+ */
+export function generateClaudeMd(_options, _template) {
+    return mofloSection() + '\n';
+}
+/**
+ * Generate minimal CLAUDE.md content (backward-compatible alias).
+ */
+export function generateMinimalClaudeMd(options) {
+    return generateClaudeMd(options, 'minimal');
+}
+/** Available template names for CLI wizard (kept for backward compat, all produce same output) */
+export const CLAUDE_MD_TEMPLATES = [
+    { name: 'minimal', description: 'Recommended — memory search, workflow gates, MCP tools (~40 lines injected)' },
+    { name: 'standard', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
+    { name: 'full', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
+    { name: 'security', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
+    { name: 'performance', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
+    { name: 'solo', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
+];
+export default generateClaudeMd;
 //# sourceMappingURL=claudemd-generator.js.map

package/src/@claude-flow/cli/dist/src/services/workflow-gate.js

@@ -52,13 +52,21 @@ const TASK_PATTERNS = [
  * Checked first — if matched, memory gate is skipped regardless of task patterns.
  */
 const DIRECTIVE_PATTERNS = [
-    /^(yes|no|yeah|yep|nope|sure|ok|okay|correct|right|exactly|perfect)\b/i,
+    // Confirmations and short answers
+    /^(yes|no|yeah|yep|nope|sure|ok|okay|correct|right|exactly|perfect|thanks|thank you|got it|sounds good|go ahead|do it|lgtm)\b/i,
+    // Git and package management
     /\b(commit|push|pull|merge|rebase|cherry-pick)\b/,
+    /\bpublish\b/, /\bversion\b/, /\bnpm\b/, /\byarn\b/, /\bpnpm\b/,
+    // File management directives
     /\b(rename|move|delete|remove)\b/,
     /^(show|read|open|cat|look at|check)\s/,
     /^(run|execute|start|stop|kill|restart)\s/,
-    /\bpublish\b/, /\bversion\b/, /\bnpm\b/,
     /^let'?s\s+(commit|push|publish|deploy|ship|merge)/i,
+    // Short follow-ups that reference the current conversation (not new tasks)
+    // These are anchored to start-of-string to avoid matching mid-sentence task words
+    /^(do the same|same for|same thing)\b/i,
+    /^(also|too|and also)\s+(for|with|on)\b/i,
+    /^(what about|how about)\s+(the\s+)?(other|rest|same)\b/i,
 ];
 const BRACKET_MESSAGES = {
     MODERATE: 'Context: MODERATE. Re-state goal before architectural decisions. Use agents for >300 LOC.',
@@ -304,78 +312,98 @@ export class WorkflowGateService {
  * Used by hooks.mjs dispatcher.
  */
 export function processGateCommand(command, env = process.env) {
-    const gate = new WorkflowGateService();
-    switch (command) {
-        case 'check-before-agent': {
-            const result = gate.checkBeforeAgent();
-            if (!result.allowed) {
-                if (result.message)
-                    process.stderr.write(result.message + '\n');
-                process.exit(2); // Exit 2 = block tool call in Claude Code
-            }
-            process.exit(0);
-        }
-        case 'check-before-scan': {
-            const result = gate.checkBeforeScan(env.TOOL_INPUT_pattern, env.TOOL_INPUT_path);
-            if (!result.allowed) {
-                if (result.message)
-                    process.stderr.write(result.message + '\n');
-                process.exit(2);
+    // Gate commands (check-before-*) are STRICT — errors propagate, exit 2 blocks.
+    // Non-gate commands (record-*, prompt-reminder, etc.) are FAULT-TOLERANT —
+    // they catch errors and exit 0 so classification failures never surface as
+    // "hook error" to the user while gates remain fully enforced.
+    // --- STRICT GATE COMMANDS (must block on failure) ---
+    if (command.startsWith('check-before-') || command === 'check-dangerous-command') {
+        const gate = new WorkflowGateService();
+        switch (command) {
+            case 'check-before-agent': {
+                const result = gate.checkBeforeAgent();
+                if (!result.allowed) {
+                    if (result.message)
+                        process.stderr.write(result.message + '\n');
+                    process.exit(2); // Exit 2 = block tool call in Claude Code
+                }
+                process.exit(0);
             }
-            process.exit(0);
-        }
-        case 'check-before-read': {
-            const result = gate.checkBeforeRead(env.TOOL_INPUT_file_path);
-            if (!result.allowed) {
-                if (result.message)
-                    process.stderr.write(result.message + '\n');
-                process.exit(2);
+            case 'check-before-scan': {
+                const result = gate.checkBeforeScan(env.TOOL_INPUT_pattern, env.TOOL_INPUT_path);
+                if (!result.allowed) {
+                    if (result.message)
+                        process.stderr.write(result.message + '\n');
+                    process.exit(2);
+                }
+                process.exit(0);
             }
-            process.exit(0);
-        }
-        case 'record-task-created':
-            gate.recordTaskCreated();
-            process.exit(0);
-        case 'check-bash-memory':
-            gate.checkBashMemory(env.TOOL_INPUT_command || '');
-            process.exit(0);
-        case 'record-memory-searched':
-            gate.recordMemorySearched();
-            process.exit(0);
-        case 'prompt-reminder': {
-            const userPrompt = env.CLAUDE_USER_PROMPT || '';
-            const { reminder, bracket } = gate.promptReminder(userPrompt);
-            if (reminder)
-                console.log(reminder);
-            if (bracket)
-                console.log(bracket);
-            process.exit(0);
-        }
-        case 'compact-guidance': {
-            console.log('Pre-Compact Guidance:');
-            console.log('IMPORTANT: Before compacting, preserve key context:');
-            console.log('   - Check CLAUDE.md for project rules and architecture');
-            console.log('   - Memory namespaces: guidance, code-map, patterns, knowledge');
-            console.log('   - Use memory search to recover context after compact');
-            console.log('   - Batch all operations in single messages (GOLDEN RULE)');
-            process.exit(0);
-        }
-        case 'check-dangerous-command': {
-            const cmd = (env.TOOL_INPUT_command || '').toLowerCase();
-            const dangerous = ['rm -rf /', 'format c:', 'del /s /q c:\\', ':(){:|:&};:', 'mkfs.', '> /dev/sda'];
-            for (const pattern of dangerous) {
-                if (cmd.includes(pattern)) {
-                    process.stderr.write(`[BLOCKED] Dangerous command detected: ${pattern}\n`);
+            case 'check-before-read': {
+                const result = gate.checkBeforeRead(env.TOOL_INPUT_file_path);
+                if (!result.allowed) {
+                    if (result.message)
+                        process.stderr.write(result.message + '\n');
                     process.exit(2);
                 }
+                process.exit(0);
+            }
+            case 'check-dangerous-command': {
+                const cmd = (env.TOOL_INPUT_command || '').toLowerCase();
+                const dangerous = ['rm -rf /', 'format c:', 'del /s /q c:\\', ':(){:|:&};:', 'mkfs.', '> /dev/sda'];
+                for (const pattern of dangerous) {
+                    if (cmd.includes(pattern)) {
+                        process.stderr.write(`[BLOCKED] Dangerous command detected: ${pattern}\n`);
+                        process.exit(2);
+                    }
+                }
+                process.exit(0);
+            }
+            default:
+                process.exit(0);
+        }
+    }
+    // --- FAULT-TOLERANT COMMANDS (never surface errors to user) ---
+    try {
+        const gate = new WorkflowGateService();
+        switch (command) {
+            case 'record-task-created':
+                gate.recordTaskCreated();
+                process.exit(0);
+            case 'check-bash-memory':
+                gate.checkBashMemory(env.TOOL_INPUT_command || '');
+                process.exit(0);
+            case 'record-memory-searched':
+                gate.recordMemorySearched();
+                process.exit(0);
+            case 'prompt-reminder': {
+                const userPrompt = env.CLAUDE_USER_PROMPT || '';
+                const { reminder, bracket } = gate.promptReminder(userPrompt);
+                if (reminder)
+                    console.log(reminder);
+                if (bracket)
+                    console.log(bracket);
+                process.exit(0);
             }
-            process.exit(0);
+            case 'compact-guidance': {
+                console.log('Pre-Compact Guidance:');
+                console.log('IMPORTANT: Before compacting, preserve key context:');
+                console.log('   - Check CLAUDE.md for project rules and architecture');
+                console.log('   - Memory namespaces: guidance, code-map, patterns, knowledge');
+                console.log('   - Use memory search to recover context after compact');
+                console.log('   - Batch all operations in single messages (GOLDEN RULE)');
+                process.exit(0);
+            }
+            case 'session-reset':
+                gate.sessionReset();
+                process.exit(0);
+            default:
+                process.exit(0);
         }
-        case 'session-reset':
-            gate.sessionReset();
-            process.exit(0);
-        default:
-            process.exit(0);
+    }
+    catch (err) {
+        // Non-gate commands must never crash — log for debugging but exit clean
+        process.stderr.write(`[gate:${command}] ${err.message ?? err}\n`);
+        process.exit(0);
     }
 }
 //# sourceMappingURL=workflow-gate.js.map

package/src/@claude-flow/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moflo/cli",
-  "version": "4.8.12",
+  "version": "4.8.14",
   "type": "module",
   "description": "MoFlo CLI — AI agent orchestration with specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",

package/.claude/agents/MIGRATION_SUMMARY.md

@@ -1,222 +0,0 @@
----
-name: Migration Summary
-type: documentation
-category: migration
-description: Complete migration plan for converting command-based system to intelligent agent-based system
----
-
-# Claude Flow Commands to Agent System Migration Summary
-
-## Executive Summary
-This document provides a complete migration plan for converting the existing command-based system (`.claude/commands/`) to the new intelligent agent-based system (`.claude/agents/`). The migration preserves all functionality while adding natural language understanding, intelligent coordination, and improved parallelization.
-
-## Key Migration Benefits
-
-### 1. Natural Language Activation
-- **Before**: `/sparc orchestrator "task"`
-- **After**: "Orchestrate the development of the authentication system"
-
-### 2. Intelligent Coordination
-- Agents understand context and collaborate
-- Automatic agent spawning based on task requirements
-- Optimal resource allocation and topology selection
-
-### 3. Enhanced Parallelization
-- Agents execute independent tasks simultaneously
-- Improved performance through concurrent operations
-- Better resource utilization
-
-## Complete Command to Agent Mapping
-
-### Coordination Commands → Coordination Agents
-
-| Command | Agent | Key Changes |
-|---------|-------|-------------|
-| `/coordination/init.md` | `coordinator-swarm-init.md` | Auto-topology selection, resource optimization |
-| `/coordination/spawn.md` | `coordinator-agent-spawn.md` | Intelligent capability matching |
-| `/coordination/orchestrate.md` | `orchestrator-task.md` | Enhanced parallel execution |
-
-### GitHub Commands → GitHub Specialist Agents
-
-| Command | Agent | Key Changes |
-|---------|-------|-------------|
-| `/github/pr-manager.md` | `github-pr-manager.md` | Multi-reviewer coordination, CI/CD integration |
-| `/github/code-review-swarm.md` | `github-code-reviewer.md` | Parallel review execution |
-| `/github/release-manager.md` | `github-release-manager.md` | Multi-repo coordination |
-| `/github/issue-tracker.md` | `github-issue-tracker.md` | Project board integration |
-
-### SPARC Commands → SPARC Methodology Agents
-
-| Command | Agent | Key Changes |
-|---------|-------|-------------|
-| `/sparc/orchestrator.md` | `sparc-coordinator.md` | Phase management, quality gates |
-| `/sparc/coder.md` | `implementer-sparc-coder.md` | Parallel TDD implementation |
-| `/sparc/tester.md` | `qa-sparc-tester.md` | Comprehensive test strategies |
-| `/sparc/designer.md` | `architect-sparc-designer.md` | System architecture focus |
-| `/sparc/documenter.md` | `docs-sparc-documenter.md` | Multi-format documentation |
-
-### Analysis Commands → Analysis Agents
-
-| Command | Agent | Key Changes |
-|---------|-------|-------------|
-| `/analysis/performance-bottlenecks.md` | `performance-analyzer.md` | Predictive analysis, ML integration |
-| `/analysis/token-efficiency.md` | `analyst-token-efficiency.md` | Cost optimization focus |
-| `/analysis/COMMAND_COMPLIANCE_REPORT.md` | `analyst-compliance-checker.md` | Automated compliance validation |
-
-### Memory Commands → Memory Management Agents
-
-| Command | Agent | Key Changes |
-|---------|-------|-------------|
-| `/memory/usage.md` | `memory-coordinator.md` | Enhanced search, compression |
-| `/memory/neural.md` | `ai-neural-patterns.md` | Advanced ML capabilities |
-
-### Automation Commands → Automation Agents
-
-| Command | Agent | Key Changes |
-|---------|-------|-------------|
-| `/automation/smart-agents.md` | `automation-smart-agent.md` | ML-based agent selection |
-| `/automation/self-healing.md` | `reliability-self-healing.md` | Proactive fault prevention |
-| `/automation/session-memory.md` | `memory-session-manager.md` | Cross-session continuity |
-
-### Optimization Commands → Optimization Agents
-
-| Command | Agent | Key Changes |
-|---------|-------|-------------|
-| `/optimization/parallel-execution.md` | `optimizer-parallel-exec.md` | Dynamic parallelization |
-| `/optimization/auto-topology.md` | `optimizer-topology.md` | Adaptive topology selection |
-
-## Agent Definition Structure
-
-Each agent follows this standardized format:
-
-```yaml
----
-role: agent-role-type
-name: Human Readable Agent Name
-responsibilities:
-  - Primary responsibility
-  - Secondary responsibility
-  - Additional responsibilities
-capabilities:
-  - capability-1
-  - capability-2
-  - capability-3
-tools:
-  allowed:
-    - tool-name-1
-    - tool-name-2
-  restricted:
-    - restricted-tool-1
-    - restricted-tool-2
-triggers:
-  - pattern: "regex pattern for activation"
-    priority: high
-  - keyword: "simple-keyword"
-    priority: medium
----
-
-# Agent Name
-
-## Purpose
-[Agent description and primary function]
-
-## Core Functionality
-[Detailed capabilities and operations]
-
-## Usage Examples
-[Real-world usage scenarios]
-
-## Integration Points
-[How this agent works with others]
-
-## Best Practices
-[Guidelines for effective use]
-```
-
-## Migration Implementation Plan
-
-### Phase 1: Agent Creation (Complete)
-✅ Create agent definitions for all critical commands
-✅ Define YAML frontmatter with roles and triggers
-✅ Map tool permissions appropriately
-✅ Document integration patterns
-
-### Phase 2: Parallel Operation
-- Deploy agents alongside existing commands
-- Route requests to appropriate system
-- Collect usage metrics and feedback
-- Refine agent triggers and capabilities
-
-### Phase 3: User Migration
-- Update documentation with agent examples
-- Provide migration guides for common workflows
-- Show performance improvements
-- Encourage natural language usage
-
-### Phase 4: Command Deprecation
-- Add deprecation warnings to commands
-- Provide agent alternatives in warnings
-- Monitor remaining command usage
-- Set sunset date for command system
-
-### Phase 5: Full Agent System
-- Remove deprecated commands
-- Optimize agent interactions
-- Implement advanced features
-- Enable agent learning
-
-## Key Improvements
-
-### 1. Natural Language Understanding
-- No need to remember command syntax
-- Context-aware activation
-- Intelligent intent recognition
-- Conversational interactions
-
-### 2. Intelligent Coordination
-- Agents collaborate automatically
-- Optimal task distribution
-- Resource-aware execution
-- Self-organizing teams
-
-### 3. Performance Optimization
-- Parallel execution by default
-- Predictive resource allocation
-- Automatic scaling
-- Bottleneck prevention
-
-### 4. Learning and Adaptation
-- Agents learn from patterns
-- Continuous improvement
-- Personalized strategies
-- Knowledge accumulation
-
-## Success Metrics
-
-### Technical Metrics
-- ✅ 100% feature parity with command system
-- ✅ Improved execution speed (30-50% faster)
-- ✅ Higher parallelization ratio
-- ✅ Reduced error rates
-
-### User Experience Metrics
-- Natural language adoption rate
-- User satisfaction scores
-- Task completion rates
-- Time to productivity
-
-## Next Steps
-
-1. **Immediate**: Begin using agents for new tasks
-2. **Short-term**: Migrate existing workflows to agents
-3. **Medium-term**: Optimize agent interactions
-4. **Long-term**: Implement advanced AI features
-
-## Support and Resources
-
-- Agent documentation: `.claude/agents/README.md`
-- Migration guides: `.claude/agents/migration/`
-- Example workflows: `.claude/agents/examples/`
-- Community support: GitHub discussions
-
-The new agent system represents a significant advancement in AI-assisted development, providing a more intuitive, powerful, and efficient way to accomplish complex tasks.