moflo 4.8.48 → 4.8.50

package/README.md

@@ -233,6 +233,17 @@ The memory-first gate doesn't blindly block every request. It classifies each pr
 - **Simple directives** (e.g., "commit", "yes", "continue", "looks good") — skip the gate entirely, no memory search required
 - **Task-oriented prompts** (e.g., "fix the auth bug", "add pagination to the API") — gate enforced, must search memory first
 
+### Escape hatch
+
+Prefix any prompt with `@@` to bypass the memory-first gate for that turn. Useful for conversational questions, thinking out loud, or discussions that don't need prior context:
+
+```
+@@ what do you think about this approach?
+@@ question — is there a better way to handle auth tokens?
+```
+
+The `@@` prefix is stripped before Claude sees the prompt, so it won't affect the response.
+
 ### Disabling gates
 
 All gates are configurable in `moflo.yaml`:

package/bin/gate.cjs

@@ -41,7 +41,14 @@ 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'];
+// Short replies starting with directive words ("ok", "yes", etc.) bypass the
+// memory gate — but only if the prompt is under 20 chars. Longer prompts that
+// start with a directive but contain a real question/task still get gated.
 var DIRECTIVE_RE = /^(yes|no|yeah|yep|nope|sure|ok|okay|correct|right|exactly|perfect)\b/i;
+var DIRECTIVE_MAX_LEN = 20;
+// @@ prefix = explicit escape hatch. User signals "this is conversational,
+// skip the memory gate." Strips the prefix before Claude sees the prompt.
+var ESCAPE_PREFIX = '@@';
 var TASK_RE = /\b(fix|bug|error|implement|add|create|build|write|refactor|debug|test|feature|issue|security|optimi)\b/i;
 
 switch (command) {
@@ -65,17 +72,22 @@ switch (command) {
     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;
-    process.stderr.write('BLOCKED: Search memory before exploring files. Use mcp__moflo__memory_search.\n');
+    process.stderr.write('BLOCKED: Search memory before exploring files. Use mcp__moflo__memory_search with namespace "code-map", "patterns", "knowledge", or "guidance".\n');
     process.exit(2);
+    break; // unreachable but prevents fall-through lint warnings
   }
   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;
-    process.stderr.write('BLOCKED: Search memory before reading guidance files. Use mcp__moflo__memory_search.\n');
+    // Exempt: node_modules, CLAUDE.md, MEMORY.md, workflow-state
+    // NOT exempt: .claude/guidance/ (guidance files must require memory search)
+    var isGuidance = fp.indexOf('.claude/guidance/') >= 0 || fp.indexOf('.claude\\guidance\\') >= 0;
+    if (!isGuidance && EXEMPT.some(function(p) { return fp.indexOf(p) >= 0; })) break;
+    process.stderr.write('BLOCKED: Search memory before reading files. Use mcp__moflo__memory_search with namespace "code-map", "patterns", "knowledge", or "guidance".\n');
     process.exit(2);
+    break; // unreachable but prevents fall-through lint warnings
   }
   case 'record-task-created': {
     var s = readState();
@@ -113,7 +125,10 @@ switch (command) {
     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);
+    var isEscaped = prompt.indexOf(ESCAPE_PREFIX) === 0;
+    if (isEscaped) prompt = prompt.slice(ESCAPE_PREFIX.length).trimStart();
+    var isShortDirective = DIRECTIVE_RE.test(prompt) && prompt.length < DIRECTIVE_MAX_LEN;
+    s.memoryRequired = !isEscaped && prompt.length >= 4 && !isShortDirective && (TASK_RE.test(prompt) || prompt.length > DIRECTIVE_MAX_LEN);
     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.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moflo",
-  "version": "4.8.48",
+  "version": "4.8.50",
   "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",
@@ -40,7 +40,6 @@
     ".claude/commands/**/*.md",
     ".claude/agents/**/*.md",
     ".claude/helpers/**",
-    ".claude/scripts/**",
     ".claude/guidance/shipped/**",
     "!.claude/**/*.db",
     "!.claude/**/*.map",

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

@@ -69,12 +69,8 @@ const SKILLS_MAP = {
  */
 const COMMANDS_MAP = {
     core: ['claude-flow-help.md', 'claude-flow-swarm.md', 'claude-flow-memory.md'],
-    analysis: ['analysis'],
-    automation: ['automation'],
     github: ['github'],
     hooks: ['hooks'],
-    monitoring: ['monitoring'],
-    optimization: ['optimization'],
     sparc: ['sparc'],
 };
 /**

package/src/@claude-flow/cli/dist/src/version.js

@@ -2,5 +2,5 @@
  * Auto-generated by build. Do not edit manually.
  * Source of truth: root package.json → scripts/sync-version.mjs
  */
-export const VERSION = '4.8.48';
+export const VERSION = '4.8.50';
 //# sourceMappingURL=version.js.map

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

@@ -1,106 +1,106 @@
-{
-  "name": "@moflo/cli",
-  "version": "4.8.48",
-  "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"
-  },
-  "dependencies": {
-    "@noble/ed25519": "^2.1.0",
-    "semver": "^7.6.0"
-  },
-  "optionalDependencies": {
-    "@claude-flow/aidefence": "file:../aidefence",
-    "@claude-flow/embeddings": "file:../embeddings",
-    "@claude-flow/guidance": "file:../guidance",
-    "@claude-flow/memory": "file:../memory",
-    "@claude-flow/plugin-gastown-bridge": "^0.1.3",
-    "agentic-flow": "^2.0.7",
-    "@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.8.50",
+  "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"
+  },
+  "dependencies": {
+    "@noble/ed25519": "^2.1.0",
+    "semver": "^7.6.0"
+  },
+  "optionalDependencies": {
+    "@claude-flow/aidefence": "file:../aidefence",
+    "@claude-flow/embeddings": "file:../embeddings",
+    "@claude-flow/guidance": "file:../guidance",
+    "@claude-flow/memory": "file:../memory",
+    "@claude-flow/plugin-gastown-bridge": "^0.1.3",
+    "agentic-flow": "^2.0.7",
+    "@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"
+  }
+}

package/.claude/agents/dual-mode/codex-coordinator.md

@@ -1,224 +0,0 @@
----
-name: codex-coordinator
-type: coordinator
-color: "#9B59B6"
-description: Coordinates multiple headless Codex workers for parallel execution
-capabilities:
-  - swarm_coordination
-  - task_decomposition
-  - result_aggregation
-  - worker_management
-  - parallel_orchestration
-priority: high
-platform: dual
-execution:
-  mode: interactive
-  spawns_workers: true
-  worker_type: codex-worker
-hooks:
-  pre: |
-    echo "🎯 Codex Coordinator initializing parallel workers"
-    # Initialize swarm for tracking
-    npx claude-flow@v3alpha swarm init --topology hierarchical --max-agents ${WORKER_COUNT:-4}
-  post: |
-    echo "✨ Parallel execution complete"
-    # Collect results from all workers
-    npx claude-flow@v3alpha memory list --namespace results
----
-
-# Codex Parallel Coordinator
-
-You coordinate multiple headless Codex workers for parallel task execution. You run interactively and spawn background workers using `claude -p`.
-
-## Architecture
-
-```
-┌─────────────────────────────────────────────────┐
-│   🎯 COORDINATOR (You - Interactive)            │
-│   ├─ Decompose task into sub-tasks             │
-│   ├─ Spawn parallel workers                     │
-│   ├─ Monitor progress via memory               │
-│   └─ Aggregate results                          │
-└───────────────┬─────────────────────────────────┘
-                │ spawns
-        ┌───────┼───────┬───────┐
-        ▼       ▼       ▼       ▼
-    ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐
-    │ 🤖-1 │ │ 🤖-2 │ │ 🤖-3 │ │ 🤖-4 │
-    │worker│ │worker│ │worker│ │worker│
-    └──────┘ └──────┘ └──────┘ └──────┘
-        │       │       │       │
-        └───────┴───────┴───────┘
-                    │
-                    ▼
-            ┌─────────────┐
-            │   MEMORY    │
-            │  (results)  │
-            └─────────────┘
-```
-
-## Core Responsibilities
-
-1. **Task Decomposition**: Break complex tasks into parallelizable units
-2. **Worker Spawning**: Launch headless Codex instances via `claude -p`
-3. **Coordination**: Track progress through shared memory
-4. **Result Aggregation**: Collect and combine worker outputs
-
-## Coordination Workflow
-
-### Step 1: Initialize Swarm
-```bash
-npx claude-flow@v3alpha swarm init --topology hierarchical --max-agents 6
-```
-
-### Step 2: Spawn Parallel Workers
-```bash
-# Spawn all workers in parallel
-claude -p "Implement core auth logic" --session-id auth-core &
-claude -p "Implement auth middleware" --session-id auth-middleware &
-claude -p "Write auth tests" --session-id auth-tests &
-claude -p "Document auth API" --session-id auth-docs &
-
-# Wait for all to complete
-wait
-```
-
-### Step 3: Collect Results
-```bash
-npx claude-flow@v3alpha memory list --namespace results
-```
-
-## Coordination Patterns
-
-### Parallel Workers Pattern
-```yaml
-description: Spawn multiple workers for parallel execution
-steps:
-  - swarm_init: { topology: hierarchical, maxAgents: 8 }
-  - spawn_workers:
-      - { type: coder, count: 2 }
-      - { type: tester, count: 1 }
-      - { type: reviewer, count: 1 }
-  - wait_for_completion
-  - aggregate_results
-```
-
-### Sequential Pipeline Pattern
-```yaml
-description: Chain workers in sequence
-steps:
-  - spawn: architect
-  - wait_for: architecture
-  - spawn: [coder-1, coder-2]
-  - wait_for: implementation
-  - spawn: tester
-  - wait_for: tests
-  - aggregate_results
-```
-
-## Prompt Templates
-
-### Coordinate Parallel Work
-```javascript
-// Template for coordinating parallel workers
-const workers = [
-  { id: "coder-1", task: "Implement user service" },
-  { id: "coder-2", task: "Implement API endpoints" },
-  { id: "tester", task: "Write integration tests" },
-  { id: "docs", task: "Document the API" }
-];
-
-// Spawn all workers
-workers.forEach(w => {
-  console.log(`claude -p "${w.task}" --session-id ${w.id} &`);
-});
-```
-
-### Worker Spawn Template
-```bash
-claude -p "
-You are {{worker_name}}.
-
-TASK: {{worker_task}}
-
-1. Search memory: memory_search(query='{{task_keywords}}')
-2. Execute your task
-3. Store results: memory_store(key='result-{{session_id}}', namespace='results', upsert=true)
-" --session-id {{session_id}} &
-```
-
-## MCP Tool Integration
-
-### Initialize Coordination
-```javascript
-// Initialize swarm tracking
-mcp__ruv-swarm__swarm_init {
-  topology: "hierarchical",
-  maxAgents: 8,
-  strategy: "specialized"
-}
-```
-
-### Track Worker Status
-```javascript
-// Store coordination state
-mcp__moflo__memory_store {
-  key: "coordination/parallel-task",
-  value: JSON.stringify({
-    workers: ["worker-1", "worker-2", "worker-3"],
-    started: new Date().toISOString(),
-    status: "running"
-  }),
-  namespace: "coordination"
-}
-```
-
-### Aggregate Results
-```javascript
-// Collect all worker results
-mcp__moflo__memory_list {
-  namespace: "results"
-}
-```
-
-## Example: Feature Implementation Swarm
-
-```bash
-#!/bin/bash
-FEATURE="user-auth"
-
-# Initialize
-npx claude-flow@v3alpha swarm init --topology hierarchical --max-agents 4
-
-# Spawn workers in parallel
-claude -p "Architect: Design $FEATURE" --session-id ${FEATURE}-arch &
-claude -p "Coder: Implement $FEATURE" --session-id ${FEATURE}-code &
-claude -p "Tester: Test $FEATURE" --session-id ${FEATURE}-test &
-claude -p "Docs: Document $FEATURE" --session-id ${FEATURE}-docs &
-
-# Wait for all
-wait
-
-# Collect results
-npx claude-flow@v3alpha memory list --namespace results
-```
-
-## Best Practices
-
-1. **Size Workers Appropriately**: Each worker should complete in < 5 minutes
-2. **Use Meaningful IDs**: Session IDs should identify the worker's purpose
-3. **Share Context**: Store shared context in memory before spawning
-4. **Budget Limits**: Use `--max-budget-usd` to control costs
-5. **Error Handling**: Check for partial failures when collecting results
-
-## Worker Types Reference
-
-| Type | Purpose | Spawn Command |
-|------|---------|---------------|
-| `coder` | Implement code | `claude -p "Implement [feature]"` |
-| `tester` | Write tests | `claude -p "Write tests for [module]"` |
-| `reviewer` | Review code | `claude -p "Review [files]"` |
-| `docs` | Documentation | `claude -p "Document [component]"` |
-| `architect` | Design | `claude -p "Design [system]"` |
-
-Remember: You coordinate, workers execute. Use memory for all communication between processes.