moflo 4.0.4 → 4.1.0

package/.claude-plugin/hooks/hooks.json

@@ -1,74 +1,74 @@
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cat | npx claude-flow@alpha hooks modify-bash"
-          }
-        ]
-      },
-      {
-        "matcher": "Write|Edit|MultiEdit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cat | npx claude-flow@alpha hooks modify-file"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cat | jq -r '.tool_input.command // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx claude-flow@alpha hooks post-command --command '{}' --track-metrics true --store-results true"
-          }
-        ]
-      },
-      {
-        "matcher": "Write|Edit|MultiEdit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx claude-flow@alpha hooks post-edit --file '{}' --format true --update-memory true"
-          }
-        ]
-      }
-    ],
-    "PreCompact": [
-      {
-        "matcher": "manual",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "/bin/bash -c 'INPUT=$(cat); CUSTOM=$(echo \"$INPUT\" | jq -r \".custom_instructions // \\\"\\\"\"); echo \"🔄 PreCompact Guidance:\"; echo \"📋 IMPORTANT: Review CLAUDE.md in project root for:\"; echo \"   • 54 available agents and concurrent usage patterns\"; echo \"   • Swarm coordination strategies (hierarchical, mesh, adaptive)\"; echo \"   • SPARC methodology workflows with batchtools optimization\"; echo \"   • Critical concurrent execution rules (GOLDEN RULE: 1 MESSAGE = ALL OPERATIONS)\"; if [ -n \"$CUSTOM\" ]; then echo \"🎯 Custom compact instructions: $CUSTOM\"; fi; echo \"✅ Ready for compact operation\"'"
-          }
-        ]
-      },
-      {
-        "matcher": "auto",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "/bin/bash -c 'echo \"🔄 Auto-Compact Guidance (Context Window Full):\"; echo \"📋 CRITICAL: Before compacting, ensure you understand:\"; echo \"   • All 54 agents available in .claude/agents/ directory\"; echo \"   • Concurrent execution patterns from CLAUDE.md\"; echo \"   • Batchtools optimization for 300% performance gains\"; echo \"   • Swarm coordination strategies for complex tasks\"; echo \"⚡ Apply GOLDEN RULE: Always batch operations in single messages\"; echo \"✅ Auto-compact proceeding with full agent context\"'"
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "npx claude-flow@alpha hooks session-end --generate-summary true --persist-state true --export-metrics true"
-          }
-        ]
-      }
-    ]
-  }
-}
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat | npx claude-flow@alpha hooks modify-bash"
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat | npx claude-flow@alpha hooks modify-file"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat | jq -r '.tool_input.command // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx claude-flow@alpha hooks post-command --command '{}' --track-metrics true --store-results true"
+          }
+        ]
+      },
+      {
+        "matcher": "Write|Edit|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cat | jq -r '.tool_input.file_path // .tool_input.path // empty' | tr '\\n' '\\0' | xargs -0 -I {} npx claude-flow@alpha hooks post-edit --file '{}' --format true --update-memory true"
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "manual",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/bin/bash -c 'INPUT=$(cat); CUSTOM=$(echo \"$INPUT\" | jq -r \".custom_instructions // \\\"\\\"\"); echo \"🔄 PreCompact Guidance:\"; echo \"📋 IMPORTANT: Review CLAUDE.md in project root for:\"; echo \"   • 54 available agents and concurrent usage patterns\"; echo \"   • Swarm coordination strategies (hierarchical, mesh, adaptive)\"; echo \"   • SPARC methodology workflows with batchtools optimization\"; echo \"   • Critical concurrent execution rules (GOLDEN RULE: 1 MESSAGE = ALL OPERATIONS)\"; if [ -n \"$CUSTOM\" ]; then echo \"🎯 Custom compact instructions: $CUSTOM\"; fi; echo \"✅ Ready for compact operation\"'"
+          }
+        ]
+      },
+      {
+        "matcher": "auto",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/bin/bash -c 'echo \"🔄 Auto-Compact Guidance (Context Window Full):\"; echo \"📋 CRITICAL: Before compacting, ensure you understand:\"; echo \"   • All 54 agents available in .claude/agents/ directory\"; echo \"   • Concurrent execution patterns from CLAUDE.md\"; echo \"   • Batchtools optimization for 300% performance gains\"; echo \"   • Swarm coordination strategies for complex tasks\"; echo \"⚡ Apply GOLDEN RULE: Always batch operations in single messages\"; echo \"✅ Auto-compact proceeding with full agent context\"'"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx claude-flow@alpha hooks session-end --generate-summary true --persist-state true --export-metrics true"
+          }
+        ]
+      }
+    ]
+  }
+}

package/.claude-plugin/marketplace.json

@@ -7,8 +7,8 @@
   "metadata": {
     "description": "Enterprise AI agent orchestration marketplace for Claude Code",
     "version": "2.5.0",
-    "homepage": "https://github.com/ruvnet/claude-flow",
-    "repository": "https://github.com/ruvnet/claude-flow"
+    "homepage": "https://github.com/eric-cielo/moflo",
+    "repository": "https://github.com/eric-cielo/moflo"
   },
   "plugins": [
     {
@@ -18,12 +18,12 @@
       "version": "2.5.0",
       "author": {
         "name": "rUv",
-        "email": "ruv@ruv.net"
+        "email": "eric@motailz.com"
       },
       "homepage": "https://claude-flow.ruv.io",
-      "repository": "https://github.com/ruvnet/claude-flow",
+      "repository": "https://github.com/eric-cielo/moflo",
       "bugs": {
-        "url": "https://github.com/ruvnet/claude-flow/issues"
+        "url": "https://github.com/eric-cielo/moflo/issues"
       },
       "license": "MIT",
       "keywords": [

package/.claude-plugin/plugin.json

@@ -4,15 +4,15 @@
   "description": "Enterprise AI agent orchestration plugin with 150+ commands, 74+ specialized agents, SPARC methodology, swarm coordination, GitHub integration, and neural training capabilities",
   "author": {
     "name": "rUv",
-    "email": "ruv@ruv.net"
+    "email": "eric@motailz.com"
   },
-  "homepage": "https://github.com/ruvnet/claude-flow",
+  "homepage": "https://github.com/eric-cielo/moflo",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ruvnet/claude-flow.git"
+    "url": "https://github.com/eric-cielo/moflo.git"
   },
   "bugs": {
-    "url": "https://github.com/ruvnet/claude-flow/issues"
+    "url": "https://github.com/eric-cielo/moflo/issues"
   },
   "license": "MIT",
   "keywords": [

package/README.md

@@ -1,148 +1,148 @@
-# MoFlo
-
-**AI agent orchestration for Claude Code.** MoFlo gives your project semantic memory, workflow enforcement, learned routing, and automated issue execution — install it as a dev dependency and run `moflo init`.
-
-Forked from [ruflo/claude-flow](https://github.com/ruvnet/ruflo) with all patches applied to source and wrapper scripts merged into the CLI.
-
-## Features
-
-| Feature | What It Does |
-|---------|-------------|
-| **Semantic Memory** | 384-dim domain-aware embeddings. Store knowledge, search it instantly. |
-| **Code Navigation** | Indexes your codebase structure so Claude can answer "where does X live?" without Glob/Grep. |
-| **Guidance Indexing** | Chunks your project docs (`.claude/guidance/`, `docs/`) and makes them searchable. |
-| **Workflow Gates** | Enforces memory-first and task-creation patterns via Claude Code hooks. Prevents Claude from skipping steps. |
-| **Learned Routing** | Routes tasks to the right agent type. Learns from outcomes — gets better over time. |
-| **`/mf` Skill** | Execute GitHub issues through a full workflow: research → enhance → implement → test → simplify → PR. |
-| **Context Tracking** | Monitors context window usage (FRESH → MODERATE → DEPLETED → CRITICAL) and advises accordingly. |
-| **Cross-Platform** | Works on macOS, Linux, and Windows. |
-
-## Quick Start
-
-```bash
-# Install as a dev dependency
-npm install --save-dev github:eric-cielo/moflo
-
-# Initialize your project (generates config, hooks, skill, CLAUDE.md section)
-npx moflo init
-
-# Index your project's knowledge base
-npx moflo memory index-guidance
-npx moflo memory code-map
-
-# Verify everything works
-npx moflo doctor
-```
-
-That's it. `moflo init` sets up everything:
-- `moflo.yaml` — project config (auto-detects source dirs, languages, guidance paths)
-- `.claude/settings.json` — workflow gate hooks
-- `.claude/skills/mf/` — the `/mf` issue execution skill
-- `CLAUDE.md` — appends a MoFlo workflow section so Claude knows how to use it
-- `.gitignore` — adds state directories
-
-## Commands
-
-### Memory
-
-```bash
-moflo memory store -k "key" --value "data"    # Store with 384-dim embedding
-moflo memory search -q "auth patterns"         # Semantic search
-moflo memory index-guidance                    # Index guidance docs
-moflo memory code-map                          # Index code structure
-moflo memory rebuild-index                     # Regenerate all embeddings
-moflo memory stats                             # Show statistics
-```
-
-### Routing & Learning
-
-```bash
-moflo hooks route --task "description"          # Route task to optimal agent
-moflo hooks learn --pattern "..." --domain "."  # Store a pattern
-moflo hooks patterns                            # List learned patterns
-moflo hooks consolidate                         # Promote/prune patterns
-```
-
-### Workflow Gates
-
-```bash
-moflo gate check-before-scan       # Blocks Glob/Grep if memory not searched
-moflo gate check-before-agent      # Blocks Agent tool if no TaskCreate
-moflo gate prompt-reminder         # Context bracket tracking
-moflo gate session-reset           # Reset workflow state
-```
-
-### System
-
-```bash
-moflo init                          # Initialize project (one-time setup)
-moflo doctor                       # Health check
-moflo --version                    # Show version
-```
-
-## Configuration
-
-`moflo init` generates a `moflo.yaml` at your project root:
-
-```yaml
-project:
-  name: "my-project"
-
-guidance:
-  directories: [.claude/guidance]    # Where your knowledge docs live
-  namespace: guidance
-
-code_map:
-  directories: [src, packages]       # Source dirs to index
-  extensions: [".ts", ".tsx"]        # Auto-detected from your project
-  exclude: [node_modules, dist]
-  namespace: code-map
-
-gates:
-  memory_first: true                 # Must search memory before file exploration
-  task_create_first: true            # Must TaskCreate before Agent tool
-  context_tracking: true             # Track context window depletion
-
-auto_index:
-  guidance: true                     # Auto-index docs on session start
-  code_map: true                     # Auto-index code on session start
-
-models:
-  default: opus
-  review: opus
-```
-
-## How It Works
-
-### For Humans
-
-MoFlo sits between Claude Code and your project. When Claude starts a session, MoFlo's hooks enforce good habits: search memory before exploring files, create tasks before spawning agents, and track how depleted the context window is. Over time, MoFlo learns which agent types work best for which tasks and routes accordingly.
-
-The `/mf <issue>` skill gives Claude a full automated workflow for executing GitHub issues — from research through PR creation — with mandatory testing and code review gates.
-
-### For Claude
-
-When `moflo init` runs, it appends a workflow section to your CLAUDE.md that teaches Claude:
-- Always search memory before Glob/Grep/Read (enforced by gates)
-- Use `mcp__claude-flow__memory_search` for knowledge retrieval
-- Use `/mf <issue>` for issue execution
-- Follow the agent icon convention for task visibility
-- Store learnings after task completion
-
-## Architecture
-
-MoFlo is a maintained fork of [ruflo v3.5.7](https://github.com/ruvnet/ruflo) with:
-
-- **3 patches applied to TypeScript source** (no more monkey-patching node_modules):
-  - 384-dim domain-aware embeddings for consistent CLI ↔ MCP search
-  - `windowsHide: true` on all spawn/exec calls (Windows UX)
-  - Routing learned patterns (task outcomes feed back into routing)
-- **6 wrapper scripts merged into CLI**: semantic-search, build-embeddings, index-guidance, code-map, workflow-gate, learning-service
-- **Project config system**: `moflo.yaml` for per-project settings
-- **One-stop init**: `moflo init` generates everything needed for OOTB operation
-
-Upstream remote preserved for cherry-picking future ruflo fixes.
-
-## License
-
-MIT (inherited from [upstream](https://github.com/ruvnet/ruflo))
+# MoFlo
+
+**AI agent orchestration for Claude Code.** MoFlo gives your project semantic memory, workflow enforcement, learned routing, and automated issue execution — install it as a dev dependency and run `moflo init`.
+
+Forked from [ruflo/claude-flow](https://github.com/ruvnet/ruflo) with all patches applied to source and wrapper scripts merged into the CLI.
+
+## Features
+
+| Feature | What It Does |
+|---------|-------------|
+| **Semantic Memory** | 384-dim domain-aware embeddings. Store knowledge, search it instantly. |
+| **Code Navigation** | Indexes your codebase structure so Claude can answer "where does X live?" without Glob/Grep. |
+| **Guidance Indexing** | Chunks your project docs (`.claude/guidance/`, `docs/`) and makes them searchable. |
+| **Workflow Gates** | Enforces memory-first and task-creation patterns via Claude Code hooks. Prevents Claude from skipping steps. |
+| **Learned Routing** | Routes tasks to the right agent type. Learns from outcomes — gets better over time. |
+| **`/mf` Skill** | Execute GitHub issues through a full workflow: research → enhance → implement → test → simplify → PR. |
+| **Context Tracking** | Monitors context window usage (FRESH → MODERATE → DEPLETED → CRITICAL) and advises accordingly. |
+| **Cross-Platform** | Works on macOS, Linux, and Windows. |
+
+## Quick Start
+
+```bash
+# Install as a dev dependency
+npm install --save-dev github:eric-cielo/moflo
+
+# Initialize your project (generates config, hooks, skill, CLAUDE.md section)
+npx moflo init
+
+# Index your project's knowledge base
+npx moflo memory index-guidance
+npx moflo memory code-map
+
+# Verify everything works
+npx moflo doctor
+```
+
+That's it. `moflo init` sets up everything:
+- `moflo.yaml` — project config (auto-detects source dirs, languages, guidance paths)
+- `.claude/settings.json` — workflow gate hooks
+- `.claude/skills/mf/` — the `/mf` issue execution skill
+- `CLAUDE.md` — appends a MoFlo workflow section so Claude knows how to use it
+- `.gitignore` — adds state directories
+
+## Commands
+
+### Memory
+
+```bash
+moflo memory store -k "key" --value "data"    # Store with 384-dim embedding
+moflo memory search -q "auth patterns"         # Semantic search
+moflo memory index-guidance                    # Index guidance docs
+moflo memory code-map                          # Index code structure
+moflo memory rebuild-index                     # Regenerate all embeddings
+moflo memory stats                             # Show statistics
+```
+
+### Routing & Learning
+
+```bash
+moflo hooks route --task "description"          # Route task to optimal agent
+moflo hooks learn --pattern "..." --domain "."  # Store a pattern
+moflo hooks patterns                            # List learned patterns
+moflo hooks consolidate                         # Promote/prune patterns
+```
+
+### Workflow Gates
+
+```bash
+moflo gate check-before-scan       # Blocks Glob/Grep if memory not searched
+moflo gate check-before-agent      # Blocks Agent tool if no TaskCreate
+moflo gate prompt-reminder         # Context bracket tracking
+moflo gate session-reset           # Reset workflow state
+```
+
+### System
+
+```bash
+moflo init                          # Initialize project (one-time setup)
+moflo doctor                       # Health check
+moflo --version                    # Show version
+```
+
+## Configuration
+
+`moflo init` generates a `moflo.yaml` at your project root:
+
+```yaml
+project:
+  name: "my-project"
+
+guidance:
+  directories: [.claude/guidance]    # Where your knowledge docs live
+  namespace: guidance
+
+code_map:
+  directories: [src, packages]       # Source dirs to index
+  extensions: [".ts", ".tsx"]        # Auto-detected from your project
+  exclude: [node_modules, dist]
+  namespace: code-map
+
+gates:
+  memory_first: true                 # Must search memory before file exploration
+  task_create_first: true            # Must TaskCreate before Agent tool
+  context_tracking: true             # Track context window depletion
+
+auto_index:
+  guidance: true                     # Auto-index docs on session start
+  code_map: true                     # Auto-index code on session start
+
+models:
+  default: opus
+  review: opus
+```
+
+## How It Works
+
+### For Humans
+
+MoFlo sits between Claude Code and your project. When Claude starts a session, MoFlo's hooks enforce good habits: search memory before exploring files, create tasks before spawning agents, and track how depleted the context window is. Over time, MoFlo learns which agent types work best for which tasks and routes accordingly.
+
+The `/mf <issue>` skill gives Claude a full automated workflow for executing GitHub issues — from research through PR creation — with mandatory testing and code review gates.
+
+### For Claude
+
+When `moflo init` runs, it appends a workflow section to your CLAUDE.md that teaches Claude:
+- Always search memory before Glob/Grep/Read (enforced by gates)
+- Use `mcp__claude-flow__memory_search` for knowledge retrieval
+- Use `/mf <issue>` for issue execution
+- Follow the agent icon convention for task visibility
+- Store learnings after task completion
+
+## Architecture
+
+MoFlo is a maintained fork of [ruflo v3.5.7](https://github.com/ruvnet/ruflo) with:
+
+- **3 patches applied to TypeScript source** (no more monkey-patching node_modules):
+  - 384-dim domain-aware embeddings for consistent CLI ↔ MCP search
+  - `windowsHide: true` on all spawn/exec calls (Windows UX)
+  - Routing learned patterns (task outcomes feed back into routing)
+- **6 wrapper scripts merged into CLI**: semantic-search, build-embeddings, index-guidance, code-map, workflow-gate, learning-service
+- **Project config system**: `moflo.yaml` for per-project settings
+- **One-stop init**: `moflo init` generates everything needed for OOTB operation
+
+Upstream remote preserved for cherry-picking future ruflo fixes.
+
+## License
+
+MIT (inherited from [upstream](https://github.com/ruvnet/ruflo))

package/bin/cli.js

@@ -1,12 +1,12 @@
-#!/usr/bin/env node
-/**
- * MoFlo CLI - Entry point
- * Proxies to @claude-flow/cli bin for cross-platform compatibility.
- * Forked from ruflo/claude-flow with Motailz patches applied to source.
- */
-import { pathToFileURL, fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const cliPath = join(__dirname, '..', 'v3', '@claude-flow', 'cli', 'bin', 'cli.js');
-await import(pathToFileURL(cliPath).href);
+#!/usr/bin/env node
+/**
+ * MoFlo CLI - Entry point
+ * Proxies to @claude-flow/cli bin for cross-platform compatibility.
+ * Forked from ruflo/claude-flow with Motailz patches applied to source.
+ */
+import { pathToFileURL, fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cliPath = join(__dirname, '..', 'v3', '@claude-flow', 'cli', 'bin', 'cli.js');
+await import(pathToFileURL(cliPath).href);

package/bin/npx-repair.js

@@ -1,7 +1,7 @@
-#!/usr/bin/env node
-// NPX cache repair — no-op (removed in 3.1.0-alpha.53)
-// Kept as empty module for backwards compatibility with older bin/cli.js imports.
-export function repairNpxCache() { return 0; }
-export function repairCacheIntegrity() { return 0; }
-export function removeNpxCacheEntry() { return false; }
-export function nukeNpxCache() { return false; }
+#!/usr/bin/env node
+// NPX cache repair — no-op (removed in 3.1.0-alpha.53)
+// Kept as empty module for backwards compatibility with older bin/cli.js imports.
+export function repairNpxCache() { return 0; }
+export function repairCacheIntegrity() { return 0; }
+export function removeNpxCacheEntry() { return false; }
+export function nukeNpxCache() { return false; }

package/bin/npx-safe-launch.js

@@ -1,9 +1,9 @@
-#!/usr/bin/env node
-// Safe NPX launcher — no-op wrapper (cache repair removed in 3.1.0-alpha.53)
-// Proxies directly to the CLI entry point.
-import { pathToFileURL, fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const cliPath = join(__dirname, '..', 'v3', '@claude-flow', 'cli', 'bin', 'cli.js');
-await import(pathToFileURL(cliPath).href);
+#!/usr/bin/env node
+// Safe NPX launcher — no-op wrapper (cache repair removed in 3.1.0-alpha.53)
+// Proxies directly to the CLI entry point.
+import { pathToFileURL, fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cliPath = join(__dirname, '..', 'v3', '@claude-flow', 'cli', 'bin', 'cli.js');
+await import(pathToFileURL(cliPath).href);