moflo 4.7.4 → 4.7.7

package/.claude/helpers/gate.cjs

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+'use strict';
+var fs = require('fs');
+var path = require('path');
+
+var PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+var STATE_FILE = path.join(PROJECT_DIR, '.claude', 'workflow-state.json');
+
+function readState() {
+  try {
+    if (fs.existsSync(STATE_FILE)) return JSON.parse(fs.readFileSync(STATE_FILE, 'utf-8'));
+  } catch (e) { /* reset on corruption */ }
+  return { tasksCreated: false, taskCount: 0, memorySearched: false, memoryRequired: true, interactionCount: 0, sessionStart: null, lastBlockedAt: null };
+}
+
+function writeState(s) {
+  try {
+    var dir = path.dirname(STATE_FILE);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(STATE_FILE, JSON.stringify(s, null, 2));
+  } catch (e) { /* non-fatal */ }
+}
+
+// Load moflo.yaml gate config (defaults: all enabled)
+function loadGateConfig() {
+  var defaults = { memory_first: true, task_create_first: true, context_tracking: true };
+  try {
+    var yamlPath = path.join(PROJECT_DIR, 'moflo.yaml');
+    if (fs.existsSync(yamlPath)) {
+      var content = fs.readFileSync(yamlPath, 'utf-8');
+      if (/memory_first:\s*false/i.test(content)) defaults.memory_first = false;
+      if (/task_create_first:\s*false/i.test(content)) defaults.task_create_first = false;
+      if (/context_tracking:\s*false/i.test(content)) defaults.context_tracking = false;
+    }
+  } catch (e) { /* use defaults */ }
+  return defaults;
+}
+
+var config = loadGateConfig();
+var command = process.argv[2];
+
+var EXEMPT = ['.claude/', '.claude\\', 'CLAUDE.md', 'MEMORY.md', 'workflow-state', 'node_modules'];
+var DANGEROUS = ['rm -rf /', 'format c:', 'del /s /q c:\\', ':(){:|:&};:', 'mkfs.', '> /dev/sda'];
+var DIRECTIVE_RE = /^(yes|no|yeah|yep|nope|sure|ok|okay|correct|right|exactly|perfect)\b/i;
+var TASK_RE = /\b(fix|bug|error|implement|add|create|build|write|refactor|debug|test|feature|issue|security|optimi)\b/i;
+
+switch (command) {
+  case 'check-before-agent': {
+    var s = readState();
+    if (config.task_create_first && !s.tasksCreated) {
+      console.log('BLOCKED: Call TaskCreate before spawning agents.');
+      process.exit(1);
+    }
+    if (config.memory_first && !s.memorySearched) {
+      console.log('BLOCKED: Search memory before spawning agents.');
+      process.exit(1);
+    }
+    break;
+  }
+  case 'check-before-scan': {
+    if (!config.memory_first) break;
+    var s = readState();
+    if (s.memorySearched || !s.memoryRequired) break;
+    var target = (process.env.TOOL_INPUT_pattern || '') + ' ' + (process.env.TOOL_INPUT_path || '');
+    if (EXEMPT.some(function(p) { return target.indexOf(p) >= 0; })) break;
+    var now = Date.now();
+    var last = s.lastBlockedAt ? new Date(s.lastBlockedAt).getTime() : 0;
+    if (now - last > 2000) {
+      s.lastBlockedAt = new Date(now).toISOString();
+      writeState(s);
+      console.log('BLOCKED: Search memory before exploring files.');
+    }
+    process.exit(1);
+  }
+  case 'check-before-read': {
+    if (!config.memory_first) break;
+    var s = readState();
+    if (s.memorySearched || !s.memoryRequired) break;
+    var fp = process.env.TOOL_INPUT_file_path || '';
+    if (fp.indexOf('.claude/guidance/') < 0 && fp.indexOf('.claude\\guidance\\') < 0) break;
+    var now = Date.now();
+    var last = s.lastBlockedAt ? new Date(s.lastBlockedAt).getTime() : 0;
+    if (now - last > 2000) {
+      s.lastBlockedAt = new Date(now).toISOString();
+      writeState(s);
+      console.log('BLOCKED: Search memory before reading guidance files.');
+    }
+    process.exit(1);
+  }
+  case 'record-task-created': {
+    var s = readState();
+    s.tasksCreated = true;
+    s.taskCount = (s.taskCount || 0) + 1;
+    writeState(s);
+    break;
+  }
+  case 'record-memory-searched': {
+    var s = readState();
+    s.memorySearched = true;
+    writeState(s);
+    break;
+  }
+  case 'check-bash-memory': {
+    var cmd = process.env.TOOL_INPUT_command || '';
+    if (/semantic-search|memory search|memory retrieve|memory-search/.test(cmd)) {
+      var s = readState();
+      s.memorySearched = true;
+      writeState(s);
+    }
+    break;
+  }
+  case 'check-dangerous-command': {
+    var cmd = (process.env.TOOL_INPUT_command || '').toLowerCase();
+    for (var i = 0; i < DANGEROUS.length; i++) {
+      if (cmd.indexOf(DANGEROUS[i]) >= 0) {
+        console.log('[BLOCKED] Dangerous command: ' + DANGEROUS[i]);
+        process.exit(2);
+      }
+    }
+    break;
+  }
+  case 'prompt-reminder': {
+    var s = readState();
+    s.memorySearched = false;
+    var prompt = process.env.CLAUDE_USER_PROMPT || '';
+    s.memoryRequired = prompt.length >= 4 && !DIRECTIVE_RE.test(prompt) && (TASK_RE.test(prompt) || prompt.length > 80);
+    s.interactionCount = (s.interactionCount || 0) + 1;
+    writeState(s);
+    if (!s.tasksCreated) console.log('REMINDER: Use TaskCreate before spawning agents. Task tool is blocked until then.');
+    if (config.context_tracking) {
+      var ic = s.interactionCount;
+      if (ic > 30) console.log('Context: CRITICAL. Commit, store learnings, suggest new session.');
+      else if (ic > 20) console.log('Context: DEPLETED. Checkpoint progress. Recommend /compact or fresh session.');
+      else if (ic > 10) console.log('Context: MODERATE. Re-state goal before architectural decisions.');
+    }
+    break;
+  }
+  case 'compact-guidance': {
+    console.log('Pre-Compact: Check CLAUDE.md for rules. Use memory search to recover context after compact.');
+    break;
+  }
+  case 'session-reset': {
+    writeState({ tasksCreated: false, taskCount: 0, memorySearched: false, memoryRequired: true, interactionCount: 0, sessionStart: new Date().toISOString(), lastBlockedAt: null });
+    break;
+  }
+  default:
+    break;
+}

package/.claude/workflow-state.json

@@ -0,0 +1,9 @@
+{
+  "tasksCreated": false,
+  "taskCount": 0,
+  "memorySearched": false,
+  "memoryRequired": true,
+  "interactionCount": 10,
+  "sessionStart": null,
+  "lastBlockedAt": "2026-03-21T05:00:01.929Z"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moflo",
-  "version": "4.7.4",
+  "version": "4.7.7",
   "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",
@@ -85,6 +85,7 @@
     "@types/bcrypt": "^5.0.2",
     "@types/node": "^20.0.0",
     "eslint": "^8.0.0",
+    "moflo": "^4.7.4",
     "tsx": "^4.21.0",
     "typescript": "^5.0.0",
     "vitest": "^1.0.0"

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

@@ -118,7 +118,7 @@ _claude_flow_completions() {
 }
 
 complete -F _claude_flow_completions claude-flow
-complete -F _claude_flow_completions npx\\ @claude-flow/cli@v3alpha
+complete -F _claude_flow_completions npx\\ moflo
 `;
 }
 // Generate zsh completion script

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

@@ -297,8 +297,8 @@ async function checkVersionFreshness() {
             (latest.major === current.major && latest.minor === current.minor && latest.patch === current.patch && latest.prerelease > current.prerelease));
         if (isOutdated) {
             const fix = isNpx
-                ? 'rm -rf ~/.npm/_npx/* && npx -y @claude-flow/cli@latest'
-                : 'npm update @claude-flow/cli';
+                ? 'rm -rf ~/.npm/_npx/* && npx -y moflo'
+                : 'npm update moflo';
             return {
                 name: 'Version Freshness',
                 status: 'warn',

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

@@ -364,7 +364,7 @@ function setupAndBoundary() {
     return `## Quick Setup
 
 \`\`\`bash
-claude mcp add claude-flow -- npx -y @claude-flow/cli@latest
+claude mcp add claude-flow -- npx -y moflo
 npx moflo daemon start
 npx moflo doctor --fix
 \`\`\`

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

@@ -14,7 +14,7 @@ import { detectPlatform, DEFAULT_INIT_OPTIONS } from './types.js';
 import { generateSettingsJson, generateSettings } from './settings-generator.js';
 import { generateMCPJson } from './mcp-generator.js';
 import { generateStatuslineScript } from './statusline-generator.js';
-import { generatePreCommitHook, generatePostCommitHook, generateAutoMemoryHook, } from './helpers-generator.js';
+import { generatePreCommitHook, generatePostCommitHook, generateAutoMemoryHook, generateGateScript, generateHookHandlerScript, } from './helpers-generator.js';
 import { generateClaudeMd } from './claudemd-generator.js';
 /**
  * Skills to copy based on configuration
@@ -284,14 +284,13 @@ function mergeSettingsForUpgrade(existing) {
     // Their configuration lives in claudeFlow.agentTeams.hooks instead.
     // 3. Fix statusLine config (remove invalid fields, ensure correct format)
     // Claude Code only supports: type, command, padding
+    // Always ensure statusLine is present — add it if missing (e.g. from older inits)
     const existingStatusLine = existing.statusLine;
-    if (existingStatusLine) {
-        merged.statusLine = {
-            type: 'command',
-            command: existingStatusLine.command || `node -e "var c=require('child_process'),p=require('path'),r;try{r=c.execSync('git rev-parse --show-toplevel',{encoding:'utf8'}).trim()}catch(e){r=process.cwd()}var s=p.join(r,'.claude/helpers/statusline.cjs');process.argv.splice(1,0,s);require(s)"`,
-            // Remove invalid fields: refreshMs, enabled (not supported by Claude Code)
-        };
-    }
+    merged.statusLine = {
+        type: 'command',
+        command: existingStatusLine?.command || `node "$CLAUDE_PROJECT_DIR/.claude/helpers/statusline.cjs"`,
+        // Remove invalid fields: refreshMs, enabled (not supported by Claude Code)
+    };
     // 4. Merge claudeFlow settings (preserve existing, add agentTeams + memory)
     const existingClaudeFlow = existing.claudeFlow || {};
     const existingMemory = existingClaudeFlow.memory || {};
@@ -356,7 +355,7 @@ export async function executeUpgrade(targetDir, upgradeSettings = false) {
         // 0. ALWAYS update critical helpers (force overwrite)
         const sourceHelpersForUpgrade = findSourceHelpersDir();
         if (sourceHelpersForUpgrade) {
-            const criticalHelpers = ['auto-memory-hook.mjs', 'hook-handler.cjs', 'intelligence.cjs'];
+            const criticalHelpers = ['auto-memory-hook.mjs', 'hook-handler.cjs', 'gate.cjs', 'intelligence.cjs'];
             for (const helperName of criticalHelpers) {
                 const targetPath = path.join(targetDir, '.claude', 'helpers', helperName);
                 const sourcePath = path.join(sourceHelpersForUpgrade, helperName);
@@ -379,6 +378,8 @@ export async function executeUpgrade(targetDir, upgradeSettings = false) {
             // Source not found (npx with broken paths) — use generated fallbacks
             const generatedCritical = {
                 'auto-memory-hook.mjs': generateAutoMemoryHook(),
+                'gate.cjs': generateGateScript(),
+                'hook-handler.cjs': generateHookHandlerScript(),
             };
             for (const [helperName, content] of Object.entries(generatedCritical)) {
                 const targetPath = path.join(targetDir, '.claude', 'helpers', helperName);
@@ -494,7 +495,22 @@ export async function executeUpgrade(targetDir, upgradeSettings = false) {
         else {
             result.preserved.push('.claude-flow/security/audit-status.json');
         }
-        // 3. Merge settings if requested
+        // 3. Fix .mcp.json — replace stale @claude-flow/cli references with moflo
+        const mcpPath = path.join(targetDir, '.mcp.json');
+        if (fs.existsSync(mcpPath)) {
+            try {
+                const mcpRaw = fs.readFileSync(mcpPath, 'utf-8');
+                if (mcpRaw.includes('@claude-flow/cli')) {
+                    const mcpFixed = mcpRaw.replace(/@claude-flow\/cli(@latest)?/g, 'moflo');
+                    fs.writeFileSync(mcpPath, mcpFixed, 'utf-8');
+                    result.updated.push('.mcp.json (replaced @claude-flow/cli with moflo)');
+                }
+            }
+            catch {
+                // Non-fatal — .mcp.json may be malformed
+            }
+        }
+        // 4. Merge settings if requested
         if (upgradeSettings) {
             const settingsPath = path.join(targetDir, '.claude', 'settings.json');
             if (fs.existsSync(settingsPath)) {
@@ -853,7 +869,7 @@ function findSourceHelpersDir(sourceBaseDir) {
     // Strategy 1: require.resolve to find package root (most reliable for npx)
     try {
         const esmRequire = createRequire(import.meta.url);
-        const pkgJsonPath = esmRequire.resolve('@claude-flow/cli/package.json');
+        const pkgJsonPath = esmRequire.resolve('moflo/package.json');
         const pkgRoot = path.dirname(pkgJsonPath);
         possiblePaths.push(path.join(pkgRoot, '.claude', 'helpers'));
     }
@@ -919,18 +935,17 @@ async function writeHelpers(targetDir, options, result) {
                 result.skipped.push(`.claude/helpers/${file}`);
             }
         }
-        if (copiedCount > 0) {
-            return; // Skip generating if we copied from source
-        }
+        // Don't return early — still need to generate any missing required helpers below
     }
-    // Fall back to generating helpers if source not available.
-    // Only generate actively used helpers — hooks now go through npx flo CLI,
-    // so hook-handler.cjs, router.js, session.js, memory.js, intelligence.cjs
-    // are no longer needed.
+    // Generate required helpers that weren't copied from source.
+    // gate.cjs and hook-handler.cjs are critical — hooks call them directly
+    // via `node` instead of `npx flo` to avoid CLI bootstrap overhead.
     const helpers = {
         'pre-commit': generatePreCommitHook(),
         'post-commit': generatePostCommitHook(),
         'auto-memory-hook.mjs': generateAutoMemoryHook(),
+        'gate.cjs': generateGateScript(),
+        'hook-handler.cjs': generateHookHandlerScript(),
     };
     for (const [name, content] of Object.entries(helpers)) {
         const filePath = path.join(helpersDir, name);
@@ -1571,7 +1586,7 @@ npx moflo hive-mind consensus --propose "task"
 ### MCP Server Setup
 \`\`\`bash
 # Add Claude Flow MCP
-claude mcp add claude-flow -- npx -y @claude-flow/cli@latest
+claude mcp add claude-flow -- npx -y moflo
 
 # Optional servers
 claude mcp add ruv-swarm -- npx -y ruv-swarm mcp start
@@ -1653,7 +1668,7 @@ function findSourceDir(type, sourceBaseDir) {
     }
     // IMPORTANT: Check the package's own .claude directory first
     // This is the primary path when running as an npm package
-    // __dirname is typically /path/to/node_modules/@claude-flow/cli/dist/src/init
+    // __dirname is typically /path/to/node_modules/moflo/dist/src/init
     // We need to go up 3 levels to reach the package root (dist/src/init -> dist/src -> dist -> root)
     const packageRoot = path.resolve(__dirname, '..', '..', '..');
     const packageDotClaude = path.join(packageRoot, '.claude', type);

package/src/@claude-flow/cli/dist/src/init/helpers-generator.d.ts

@@ -21,4 +21,17 @@ export declare function generateAutoMemoryHook(): string;
  * Generate all helper files
  */
 export declare function generateHelpers(options: InitOptions): Record<string, string>;
+/**
+ * Generate lightweight gate.cjs — workflow gates without CLI bootstrap.
+ * Handles JSON state file read/write for memory-first and TaskCreate gates.
+ * This replaces `npx flo gate <command>` to avoid spawning a full CLI process
+ * on every tool call (~500ms npx overhead → ~20ms direct node).
+ */
+export declare function generateGateScript(): string;
+/**
+ * Generate lightweight hook-handler.cjs — hook dispatch without CLI bootstrap.
+ * Handles routing, edit/task tracking, session lifecycle, and notifications.
+ * This replaces `npx flo hooks <command>` to avoid spawning a full CLI process.
+ */
+export declare function generateHookHandlerScript(): string;
 //# sourceMappingURL=helpers-generator.d.ts.map

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

@@ -177,12 +177,253 @@ export function generateHelpers(options) {
     if (options.components.helpers) {
         helpers['pre-commit'] = generatePreCommitHook();
         helpers['post-commit'] = generatePostCommitHook();
-        // Hook dispatch now goes through npx flo CLI — no more hook-handler.cjs,
-        // router.js, session.js, memory.js, or intelligence.cjs stubs needed.
+        helpers['gate.cjs'] = generateGateScript();
+        helpers['hook-handler.cjs'] = generateHookHandlerScript();
     }
     if (options.components.statusline) {
         helpers['statusline.cjs'] = generateStatuslineScript(options);
     }
     return helpers;
 }
+/**
+ * Generate lightweight gate.cjs — workflow gates without CLI bootstrap.
+ * Handles JSON state file read/write for memory-first and TaskCreate gates.
+ * This replaces `npx flo gate <command>` to avoid spawning a full CLI process
+ * on every tool call (~500ms npx overhead → ~20ms direct node).
+ */
+export function generateGateScript() {
+    return `#!/usr/bin/env node
+'use strict';
+var fs = require('fs');
+var path = require('path');
+
+var PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+var STATE_FILE = path.join(PROJECT_DIR, '.claude', 'workflow-state.json');
+
+function readState() {
+  try {
+    if (fs.existsSync(STATE_FILE)) return JSON.parse(fs.readFileSync(STATE_FILE, 'utf-8'));
+  } catch (e) { /* reset on corruption */ }
+  return { tasksCreated: false, taskCount: 0, memorySearched: false, memoryRequired: true, interactionCount: 0, sessionStart: null, lastBlockedAt: null };
+}
+
+function writeState(s) {
+  try {
+    var dir = path.dirname(STATE_FILE);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(STATE_FILE, JSON.stringify(s, null, 2));
+  } catch (e) { /* non-fatal */ }
+}
+
+// Load moflo.yaml gate config (defaults: all enabled)
+function loadGateConfig() {
+  var defaults = { memory_first: true, task_create_first: true, context_tracking: true };
+  try {
+    var yamlPath = path.join(PROJECT_DIR, 'moflo.yaml');
+    if (fs.existsSync(yamlPath)) {
+      var content = fs.readFileSync(yamlPath, 'utf-8');
+      if (/memory_first:\\s*false/i.test(content)) defaults.memory_first = false;
+      if (/task_create_first:\\s*false/i.test(content)) defaults.task_create_first = false;
+      if (/context_tracking:\\s*false/i.test(content)) defaults.context_tracking = false;
+    }
+  } catch (e) { /* use defaults */ }
+  return defaults;
+}
+
+var config = loadGateConfig();
+var command = process.argv[2];
+
+var EXEMPT = ['.claude/', '.claude\\\\', 'CLAUDE.md', 'MEMORY.md', 'workflow-state', 'node_modules'];
+var DANGEROUS = ['rm -rf /', 'format c:', 'del /s /q c:\\\\', ':(){:|:&};:', 'mkfs.', '> /dev/sda'];
+var DIRECTIVE_RE = /^(yes|no|yeah|yep|nope|sure|ok|okay|correct|right|exactly|perfect)\\b/i;
+var TASK_RE = /\\b(fix|bug|error|implement|add|create|build|write|refactor|debug|test|feature|issue|security|optimi)\\b/i;
+
+switch (command) {
+  case 'check-before-agent': {
+    var s = readState();
+    if (config.task_create_first && !s.tasksCreated) {
+      console.log('BLOCKED: Call TaskCreate before spawning agents.');
+      process.exit(1);
+    }
+    if (config.memory_first && !s.memorySearched) {
+      console.log('BLOCKED: Search memory before spawning agents.');
+      process.exit(1);
+    }
+    break;
+  }
+  case 'check-before-scan': {
+    if (!config.memory_first) break;
+    var s = readState();
+    if (s.memorySearched || !s.memoryRequired) break;
+    var target = (process.env.TOOL_INPUT_pattern || '') + ' ' + (process.env.TOOL_INPUT_path || '');
+    if (EXEMPT.some(function(p) { return target.indexOf(p) >= 0; })) break;
+    var now = Date.now();
+    var last = s.lastBlockedAt ? new Date(s.lastBlockedAt).getTime() : 0;
+    if (now - last > 2000) {
+      s.lastBlockedAt = new Date(now).toISOString();
+      writeState(s);
+      console.log('BLOCKED: Search memory before exploring files.');
+    }
+    process.exit(1);
+  }
+  case 'check-before-read': {
+    if (!config.memory_first) break;
+    var s = readState();
+    if (s.memorySearched || !s.memoryRequired) break;
+    var fp = process.env.TOOL_INPUT_file_path || '';
+    if (fp.indexOf('.claude/guidance/') < 0 && fp.indexOf('.claude\\\\guidance\\\\') < 0) break;
+    var now = Date.now();
+    var last = s.lastBlockedAt ? new Date(s.lastBlockedAt).getTime() : 0;
+    if (now - last > 2000) {
+      s.lastBlockedAt = new Date(now).toISOString();
+      writeState(s);
+      console.log('BLOCKED: Search memory before reading guidance files.');
+    }
+    process.exit(1);
+  }
+  case 'record-task-created': {
+    var s = readState();
+    s.tasksCreated = true;
+    s.taskCount = (s.taskCount || 0) + 1;
+    writeState(s);
+    break;
+  }
+  case 'record-memory-searched': {
+    var s = readState();
+    s.memorySearched = true;
+    writeState(s);
+    break;
+  }
+  case 'check-bash-memory': {
+    var cmd = process.env.TOOL_INPUT_command || '';
+    if (/semantic-search|memory search|memory retrieve|memory-search/.test(cmd)) {
+      var s = readState();
+      s.memorySearched = true;
+      writeState(s);
+    }
+    break;
+  }
+  case 'check-dangerous-command': {
+    var cmd = (process.env.TOOL_INPUT_command || '').toLowerCase();
+    for (var i = 0; i < DANGEROUS.length; i++) {
+      if (cmd.indexOf(DANGEROUS[i]) >= 0) {
+        console.log('[BLOCKED] Dangerous command: ' + DANGEROUS[i]);
+        process.exit(2);
+      }
+    }
+    break;
+  }
+  case 'prompt-reminder': {
+    var s = readState();
+    s.memorySearched = false;
+    var prompt = process.env.CLAUDE_USER_PROMPT || '';
+    s.memoryRequired = prompt.length >= 4 && !DIRECTIVE_RE.test(prompt) && (TASK_RE.test(prompt) || prompt.length > 80);
+    s.interactionCount = (s.interactionCount || 0) + 1;
+    writeState(s);
+    if (!s.tasksCreated) console.log('REMINDER: Use TaskCreate before spawning agents. Task tool is blocked until then.');
+    if (config.context_tracking) {
+      var ic = s.interactionCount;
+      if (ic > 30) console.log('Context: CRITICAL. Commit, store learnings, suggest new session.');
+      else if (ic > 20) console.log('Context: DEPLETED. Checkpoint progress. Recommend /compact or fresh session.');
+      else if (ic > 10) console.log('Context: MODERATE. Re-state goal before architectural decisions.');
+    }
+    break;
+  }
+  case 'compact-guidance': {
+    console.log('Pre-Compact: Check CLAUDE.md for rules. Use memory search to recover context after compact.');
+    break;
+  }
+  case 'session-reset': {
+    writeState({ tasksCreated: false, taskCount: 0, memorySearched: false, memoryRequired: true, interactionCount: 0, sessionStart: new Date().toISOString(), lastBlockedAt: null });
+    break;
+  }
+  default:
+    break;
+}
+`;
+}
+/**
+ * Generate lightweight hook-handler.cjs — hook dispatch without CLI bootstrap.
+ * Handles routing, edit/task tracking, session lifecycle, and notifications.
+ * This replaces `npx flo hooks <command>` to avoid spawning a full CLI process.
+ */
+export function generateHookHandlerScript() {
+    return `#!/usr/bin/env node
+'use strict';
+var fs = require('fs');
+var path = require('path');
+
+var PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+var METRICS_FILE = path.join(PROJECT_DIR, '.claude-flow', 'metrics', 'learning.json');
+var command = process.argv[2];
+
+// Read stdin (Claude Code sends hook data as JSON)
+function readStdin() {
+  if (process.stdin.isTTY) return Promise.resolve('');
+  return new Promise(function(resolve) {
+    var data = '';
+    var timer = setTimeout(function() {
+      process.stdin.removeAllListeners();
+      process.stdin.pause();
+      resolve(data);
+    }, 500);
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', function(chunk) { data += chunk; });
+    process.stdin.on('end', function() { clearTimeout(timer); resolve(data); });
+    process.stdin.on('error', function() { clearTimeout(timer); resolve(data); });
+    process.stdin.resume();
+  });
+}
+
+function bumpMetric(key) {
+  try {
+    var metrics = {};
+    if (fs.existsSync(METRICS_FILE)) metrics = JSON.parse(fs.readFileSync(METRICS_FILE, 'utf-8'));
+    metrics[key] = (metrics[key] || 0) + 1;
+    metrics.lastUpdated = new Date().toISOString();
+    var dir = path.dirname(METRICS_FILE);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(METRICS_FILE, JSON.stringify(metrics, null, 2));
+  } catch (e) { /* non-fatal */ }
+}
+
+readStdin().then(function(stdinData) {
+  var hookInput = {};
+  if (stdinData && stdinData.trim()) {
+    try { hookInput = JSON.parse(stdinData); } catch (e) { /* ignore */ }
+  }
+
+  switch (command) {
+    case 'route': {
+      var prompt = hookInput.prompt || hookInput.command || process.env.PROMPT || '';
+      if (prompt) console.log('[INFO] Routing: ' + prompt.substring(0, 80));
+      else console.log('[INFO] Ready');
+      break;
+    }
+    case 'pre-edit':
+    case 'post-edit':
+      bumpMetric('edits');
+      console.log('[OK] Edit recorded');
+      break;
+    case 'pre-task':
+      bumpMetric('tasks');
+      console.log('[OK] Task started');
+      break;
+    case 'post-task':
+      bumpMetric('tasksCompleted');
+      console.log('[OK] Task completed');
+      break;
+    case 'session-end':
+      console.log('[OK] Session ended');
+      break;
+    case 'notification':
+      // Silent — just acknowledge
+      break;
+    default:
+      if (command) console.log('[OK] Hook: ' + command);
+      break;
+  }
+});
+`;
+}
 //# sourceMappingURL=helpers-generator.js.map

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

@@ -34,7 +34,7 @@ export function generateMCPConfig(options) {
     const deferProps = config.toolDefer ? { toolDefer: 'deferred' } : {};
     // Claude Flow MCP server (core)
     if (config.claudeFlow) {
-        mcpServers['claude-flow'] = createMCPServerEntry(['@claude-flow/cli@latest', 'mcp', 'start'], {
+        mcpServers['claude-flow'] = createMCPServerEntry(['moflo', 'mcp', 'start'], {
             ...npmEnv,
             CLAUDE_FLOW_MODE: 'v3',
             CLAUDE_FLOW_HOOKS_ENABLED: 'true',
@@ -67,7 +67,7 @@ export function generateMCPCommands(options) {
     const commands = [];
     const config = options.mcp;
     if (config.claudeFlow) {
-        commands.push('claude mcp add claude-flow -- npx -y @claude-flow/cli@latest mcp start');
+        commands.push('claude mcp add claude-flow -- npx -y moflo mcp start');
     }
     if (config.ruvSwarm) {
         commands.push('claude mcp add ruv-swarm -- npx -y ruv-swarm mcp start');

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

@@ -19,8 +19,8 @@ export function generateSettings(options) {
     // Add permissions
     settings.permissions = {
         allow: [
-            'Bash(npx @claude-flow*)',
-            'Bash(npx claude-flow*)',
+            'Bash(npx moflo*)',
+            'Bash(npx flo*)',
             'Bash(node .claude/*)',
             'mcp__claude-flow__:*',
         ],
@@ -172,6 +172,10 @@ function hookHandlerCmd(subcommand) {
 function autoMemoryCmd(subcommand) {
     return hookCmdEsm('"$CLAUDE_PROJECT_DIR/.claude/helpers/auto-memory-hook.mjs"', subcommand);
 }
+/** Shorthand for gate commands (lightweight JSON state checks) */
+function gateCmd(subcommand) {
+    return hookCmd('"$CLAUDE_PROJECT_DIR/.claude/helpers/gate.cjs"', subcommand);
+}
 /**
  * Generate statusLine configuration for Claude Code
  * Uses local helper script for cross-platform compatibility (no npx cold-start)
@@ -189,8 +193,9 @@ function generateStatusLineConfig(_options) {
 }
 /**
  * Generate hooks configuration
- * All hooks route through the npx flo CLI for consistent behavior.
- * The CLI handles routing, gates, learning, and session management.
+ * All hooks use direct node invocation via lightweight helper scripts
+ * (gate.cjs, hook-handler.cjs) instead of `npx flo` to avoid spawning
+ * a full CLI process on every tool call.
  */
 function generateHooksConfig(config) {
     const hooks = {};
@@ -199,26 +204,26 @@ function generateHooksConfig(config) {
         hooks.PreToolUse = [
             {
                 matcher: '^(Write|Edit|MultiEdit)$',
-                hooks: [{ type: 'command', command: 'npx flo hooks pre-edit', timeout: 5000 }],
+                hooks: [{ type: 'command', command: hookHandlerCmd('post-edit'), timeout: 5000 }],
             },
             {
                 matcher: '^(Glob|Grep)$',
-                hooks: [{ type: 'command', command: 'npx flo gate check-before-scan', timeout: 3000 }],
+                hooks: [{ type: 'command', command: gateCmd('check-before-scan'), timeout: 3000 }],
             },
             {
                 matcher: '^Read$',
-                hooks: [{ type: 'command', command: 'npx flo gate check-before-read', timeout: 3000 }],
+                hooks: [{ type: 'command', command: gateCmd('check-before-read'), timeout: 3000 }],
             },
             {
                 matcher: '^Task$',
                 hooks: [
-                    { type: 'command', command: 'npx flo gate check-before-agent', timeout: 3000 },
-                    { type: 'command', command: 'npx flo hooks pre-task', timeout: 5000 },
+                    { type: 'command', command: gateCmd('check-before-agent'), timeout: 3000 },
+                    { type: 'command', command: hookHandlerCmd('pre-task'), timeout: 5000 },
                 ],
             },
             {
                 matcher: '^Bash$',
-                hooks: [{ type: 'command', command: 'npx flo gate check-dangerous-command', timeout: 2000 }],
+                hooks: [{ type: 'command', command: gateCmd('check-dangerous-command'), timeout: 2000 }],
             },
         ];
     }
@@ -227,23 +232,23 @@ function generateHooksConfig(config) {
         hooks.PostToolUse = [
             {
                 matcher: '^(Write|Edit|MultiEdit)$',
-                hooks: [{ type: 'command', command: 'npx flo hooks post-edit', timeout: 5000 }],
+                hooks: [{ type: 'command', command: hookHandlerCmd('post-edit'), timeout: 5000 }],
             },
             {
                 matcher: '^Task$',
-                hooks: [{ type: 'command', command: 'npx flo hooks post-task', timeout: 5000 }],
+                hooks: [{ type: 'command', command: hookHandlerCmd('post-task'), timeout: 5000 }],
             },
             {
                 matcher: '^TaskCreate$',
-                hooks: [{ type: 'command', command: 'npx flo gate record-task-created', timeout: 2000 }],
+                hooks: [{ type: 'command', command: gateCmd('record-task-created'), timeout: 2000 }],
             },
             {
                 matcher: '^Bash$',
-                hooks: [{ type: 'command', command: 'npx flo gate check-bash-memory', timeout: 2000 }],
+                hooks: [{ type: 'command', command: gateCmd('check-bash-memory'), timeout: 2000 }],
             },
             {
                 matcher: '^mcp__claude-flow__memory_(search|retrieve)$',
-                hooks: [{ type: 'command', command: 'npx flo gate record-memory-searched', timeout: 2000 }],
+                hooks: [{ type: 'command', command: gateCmd('record-memory-searched'), timeout: 2000 }],
             },
         ];
     }
@@ -252,8 +257,8 @@ function generateHooksConfig(config) {
         hooks.UserPromptSubmit = [
             {
                 hooks: [
-                    { type: 'command', command: 'npx flo gate prompt-reminder', timeout: 2000 },
-                    { type: 'command', command: 'npx flo hooks route', timeout: 5000 },
+                    { type: 'command', command: gateCmd('prompt-reminder'), timeout: 2000 },
+                    { type: 'command', command: hookHandlerCmd('route'), timeout: 5000 },
                 ],
             },
         ];
@@ -282,7 +287,7 @@ function generateHooksConfig(config) {
         hooks.Stop = [
             {
                 hooks: [
-                    { type: 'command', command: 'npx flo hooks session-end', timeout: 5000 },
+                    { type: 'command', command: hookHandlerCmd('session-end'), timeout: 5000 },
                     { type: 'command', command: autoMemoryCmd('sync'), timeout: 10000 },
                 ],
             },
@@ -292,7 +297,7 @@ function generateHooksConfig(config) {
     if (config.preCompact) {
         hooks.PreCompact = [
             {
-                hooks: [{ type: 'command', command: 'npx flo gate compact-guidance', timeout: 3000 }],
+                hooks: [{ type: 'command', command: gateCmd('compact-guidance'), timeout: 3000 }],
             },
         ];
     }
@@ -303,7 +308,7 @@ function generateHooksConfig(config) {
                 hooks: [
                     {
                         type: 'command',
-                        command: 'npx flo hooks notification',
+                        command: hookHandlerCmd('notification'),
                         timeout: 3000,
                     },
                 ],

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

@@ -150,8 +150,8 @@ export const MINIMAL_INIT_OPTIONS = {
         skills: true,
         commands: false,
         agents: false,
-        helpers: false,
-        statusline: false,
+        helpers: true,
+        statusline: true,
         mcp: true,
         runtime: true,
         claudeMd: true,

package/src/@claude-flow/cli/dist/src/update/checker.d.ts

@@ -1,5 +1,5 @@
 /**
- * Update checker for @claude-flow packages
+ * Update checker for moflo packages
  * Queries npm registry and compares versions
  */
 export interface UpdateCheckResult {

package/src/@claude-flow/cli/dist/src/update/checker.js

@@ -1,5 +1,5 @@
 /**
- * Update checker for @claude-flow packages
+ * Update checker for moflo packages
  * Queries npm registry and compares versions
  */
 import * as semver from 'semver';
@@ -13,21 +13,21 @@ const DEFAULT_CONFIG = {
         major: false,
     },
     priority: {
-        '@claude-flow/security': 'critical',
-        '@claude-flow/cli': 'high',
-        '@claude-flow/embeddings': 'normal',
-        '@claude-flow/integration': 'normal',
-        '@claude-flow/testing': 'low',
+        'moflo': 'high',
+        '@moflo/security': 'critical',
+        '@moflo/embeddings': 'normal',
+        '@moflo/integration': 'normal',
+        '@moflo/testing': 'low',
     },
     exclude: [],
 };
 // Packages to check for updates
 const CLAUDE_FLOW_PACKAGES = [
-    '@claude-flow/cli',
-    '@claude-flow/embeddings',
-    '@claude-flow/security',
-    '@claude-flow/integration',
-    '@claude-flow/testing',
+    'moflo',
+    '@moflo/embeddings',
+    '@moflo/security',
+    '@moflo/integration',
+    '@moflo/testing',
 ];
 async function fetchPackageInfo(packageName) {
     try {

package/src/@claude-flow/cli/dist/src/update/validator.js

@@ -3,31 +3,31 @@
  * Ensures updates don't break the ecosystem
  */
 import * as semver from 'semver';
-// Known compatibility matrix between @claude-flow packages
+// Known compatibility matrix between moflo packages
 const COMPATIBILITY_MATRIX = {
-    '@claude-flow/cli': {
-        '@claude-flow/embeddings': { minVersion: '3.0.0-alpha.1' },
-        '@claude-flow/security': { minVersion: '3.0.0-alpha.1' },
-        '@claude-flow/integration': { minVersion: '3.0.0-alpha.1' },
+    'moflo': {
+        '@moflo/embeddings': { minVersion: '3.0.0-alpha.1' },
+        '@moflo/security': { minVersion: '3.0.0-alpha.1' },
+        '@moflo/integration': { minVersion: '3.0.0-alpha.1' },
     },
-    '@claude-flow/embeddings': {
-        '@claude-flow/cli': { minVersion: '3.0.0-alpha.50' },
+    '@moflo/embeddings': {
+        'moflo': { minVersion: '3.0.0-alpha.50' },
     },
-    '@claude-flow/integration': {
-        '@claude-flow/cli': { minVersion: '3.0.0-alpha.70' },
+    '@moflo/integration': {
+        'moflo': { minVersion: '3.0.0-alpha.70' },
         'agentic-flow': { minVersion: '3.0.0-alpha.1' },
     },
 };
 // Known breaking changes by version
 const BREAKING_CHANGES = {
-    '@claude-flow/cli': {
+    'moflo': {
         '3.0.0': [
             'Memory API changed from key-value to vector-based',
             'Hooks system completely redesigned',
             'Agent spawning now requires type parameter',
         ],
     },
-    '@claude-flow/embeddings': {
+    '@moflo/embeddings': {
         '3.0.0': [
             'Switched from better-sqlite3 to sql.js',
             'New initialization required with initEmbeddings()',

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

@@ -1,110 +1,110 @@
-{
-  "name": "@moflo/cli",
-  "version": "4.7.4",
-  "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",
-  "types": "dist/src/index.d.ts",
-  "sideEffects": false,
-  "bin": {
-    "cli": "./bin/cli.js",
-    "claude-flow": "./bin/cli.js",
-    "claude-flow-mcp": "./bin/mcp-server.js"
-  },
-  "homepage": "https://github.com/eric-cielo/moflo#readme",
-  "bugs": {
-    "url": "https://github.com/eric-cielo/moflo/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/eric-cielo/moflo.git",
-    "directory": "v3/@claude-flow/cli"
-  },
-  "keywords": [
-    "claude",
-    "claude-code",
-    "anthropic",
-    "ai-agents",
-    "multi-agent",
-    "swarm",
-    "mcp",
-    "model-context-protocol",
-    "llm",
-    "cli",
-    "orchestration",
-    "automation",
-    "developer-tools",
-    "coding-assistant",
-    "vector-database",
-    "embeddings",
-    "self-learning",
-    "enterprise"
-  ],
-  "author": {
-    "name": "Eric Cielo",
-    "email": "eric@motailz.com",
-    "url": "https://github.com/eric-cielo"
-  },
-  "license": "MIT",
-  "exports": {
-    ".": {
-      "types": "./dist/src/index.d.ts",
-      "import": "./dist/src/index.js"
-    },
-    "./ruvector": {
-      "types": "./dist/src/ruvector/index.d.ts",
-      "import": "./dist/src/ruvector/index.js"
-    },
-    "./ruvector/*": {
-      "types": "./dist/src/ruvector/*.d.ts",
-      "import": "./dist/src/ruvector/*.js"
-    },
-    "./mcp-tools": {
-      "types": "./dist/src/mcp-tools/index.d.ts",
-      "import": "./dist/src/mcp-tools/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "bin",
-    ".claude",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "test:plugin-store": "npx tsx src/plugins/tests/standalone-test.ts",
-    "test:pattern-store": "npx tsx src/transfer/store/tests/standalone-test.ts",
-    "preinstall": "node bin/preinstall.cjs || true",
-    "prepublishOnly": "cp ../../../README.md ./README.md",
-    "release": "npm version prerelease --preid=alpha && npm run publish:all",
-    "publish:all": "./scripts/publish.sh"
-  },
-  "devDependencies": {
-    "typescript": "^5.3.0",
-    "vitest": "^4.0.16"
-  },
-  "dependencies": {
-    "@claude-flow/mcp": "^3.0.0-alpha.8",
-    "@claude-flow/shared": "^3.0.0-alpha.1",
-    "@noble/ed25519": "^2.1.0",
-    "semver": "^7.6.0"
-  },
-  "optionalDependencies": {
-    "@claude-flow/aidefence": "^3.0.2",
-    "@claude-flow/codex": "^3.0.0-alpha.8",
-    "@claude-flow/embeddings": "^3.0.0-alpha.12",
-    "@claude-flow/guidance": "^3.0.0-alpha.1",
-    "@claude-flow/memory": "^3.0.0-alpha.11",
-    "@claude-flow/plugin-gastown-bridge": "^0.1.3",
-    "agentic-flow": "^3.0.0-alpha.1",
-    "@ruvector/attention": "^0.1.4",
-    "@ruvector/learning-wasm": "^0.1.29",
-    "@ruvector/router": "^0.1.27",
-    "@ruvector/sona": "^0.1.5"
-  },
-  "publishConfig": {
-    "access": "public",
-    "tag": "latest"
-  }
-}
+{
+  "name": "@moflo/cli",
+  "version": "4.7.7",
+  "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",
+  "types": "dist/src/index.d.ts",
+  "sideEffects": false,
+  "bin": {
+    "cli": "./bin/cli.js",
+    "claude-flow": "./bin/cli.js",
+    "claude-flow-mcp": "./bin/mcp-server.js"
+  },
+  "homepage": "https://github.com/eric-cielo/moflo#readme",
+  "bugs": {
+    "url": "https://github.com/eric-cielo/moflo/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eric-cielo/moflo.git",
+    "directory": "v3/@claude-flow/cli"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "anthropic",
+    "ai-agents",
+    "multi-agent",
+    "swarm",
+    "mcp",
+    "model-context-protocol",
+    "llm",
+    "cli",
+    "orchestration",
+    "automation",
+    "developer-tools",
+    "coding-assistant",
+    "vector-database",
+    "embeddings",
+    "self-learning",
+    "enterprise"
+  ],
+  "author": {
+    "name": "Eric Cielo",
+    "email": "eric@motailz.com",
+    "url": "https://github.com/eric-cielo"
+  },
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./ruvector": {
+      "types": "./dist/src/ruvector/index.d.ts",
+      "import": "./dist/src/ruvector/index.js"
+    },
+    "./ruvector/*": {
+      "types": "./dist/src/ruvector/*.d.ts",
+      "import": "./dist/src/ruvector/*.js"
+    },
+    "./mcp-tools": {
+      "types": "./dist/src/mcp-tools/index.d.ts",
+      "import": "./dist/src/mcp-tools/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    ".claude",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:plugin-store": "npx tsx src/plugins/tests/standalone-test.ts",
+    "test:pattern-store": "npx tsx src/transfer/store/tests/standalone-test.ts",
+    "preinstall": "node bin/preinstall.cjs || true",
+    "prepublishOnly": "cp ../../../README.md ./README.md",
+    "release": "npm version prerelease --preid=alpha && npm run publish:all",
+    "publish:all": "./scripts/publish.sh"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.16"
+  },
+  "dependencies": {
+    "@claude-flow/mcp": "^3.0.0-alpha.8",
+    "@claude-flow/shared": "^3.0.0-alpha.1",
+    "@noble/ed25519": "^2.1.0",
+    "semver": "^7.6.0"
+  },
+  "optionalDependencies": {
+    "@claude-flow/aidefence": "^3.0.2",
+    "@claude-flow/codex": "^3.0.0-alpha.8",
+    "@claude-flow/embeddings": "^3.0.0-alpha.12",
+    "@claude-flow/guidance": "^3.0.0-alpha.1",
+    "@claude-flow/memory": "^3.0.0-alpha.11",
+    "@claude-flow/plugin-gastown-bridge": "^0.1.3",
+    "agentic-flow": "^3.0.0-alpha.1",
+    "@ruvector/attention": "^0.1.4",
+    "@ruvector/learning-wasm": "^0.1.29",
+    "@ruvector/router": "^0.1.27",
+    "@ruvector/sona": "^0.1.5"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  }
+}