moflo 4.0.0

package/v3/@claude-flow/cli/dist/src/init/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * V3 Init Module
+ * Comprehensive initialization system for Claude Code integration
+ */
+export { type InitOptions, type InitComponents, type InitResult, type HooksConfig, type SkillsConfig, type CommandsConfig, type AgentsConfig, type StatuslineConfig, type MCPConfig, type RuntimeConfig, type EmbeddingsConfig, type PlatformInfo, DEFAULT_INIT_OPTIONS, MINIMAL_INIT_OPTIONS, FULL_INIT_OPTIONS, detectPlatform, } from './types.js';
+export { generateSettings, generateSettingsJson, } from './settings-generator.js';
+export { generateMCPConfig, generateMCPJson, generateMCPCommands, } from './mcp-generator.js';
+export { generateStatuslineScript, generateStatuslineHook, } from './statusline-generator.js';
+export { generatePreCommitHook, generatePostCommitHook, generateSessionManager, generateAgentRouter, generateMemoryHelper, generateHelpers, generateWindowsDaemonManager, generateWindowsBatchWrapper, generateCrossPlatformSessionManager, } from './helpers-generator.js';
+export { generateClaudeMd, generateMinimalClaudeMd, CLAUDE_MD_TEMPLATES, } from './claudemd-generator.js';
+export { executeInit, executeUpgrade, executeUpgradeWithMissing, default } from './executor.js';
+export type { UpgradeResult } from './executor.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,15 @@
+/**
+ * V3 Init Module
+ * Comprehensive initialization system for Claude Code integration
+ */
+// Types
+export { DEFAULT_INIT_OPTIONS, MINIMAL_INIT_OPTIONS, FULL_INIT_OPTIONS, detectPlatform, } from './types.js';
+// Generators
+export { generateSettings, generateSettingsJson, } from './settings-generator.js';
+export { generateMCPConfig, generateMCPJson, generateMCPCommands, } from './mcp-generator.js';
+export { generateStatuslineScript, generateStatuslineHook, } from './statusline-generator.js';
+export { generatePreCommitHook, generatePostCommitHook, generateSessionManager, generateAgentRouter, generateMemoryHelper, generateHelpers, generateWindowsDaemonManager, generateWindowsBatchWrapper, generateCrossPlatformSessionManager, } from './helpers-generator.js';
+export { generateClaudeMd, generateMinimalClaudeMd, CLAUDE_MD_TEMPLATES, } from './claudemd-generator.js';
+// Main executor
+export { executeInit, executeUpgrade, executeUpgradeWithMissing, default } from './executor.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,26 @@
+/**
+ * MCP Configuration Generator
+ * Creates .mcp.json for Claude Code MCP server integration
+ * Handles cross-platform compatibility (Windows requires cmd /c wrapper)
+ */
+import type { InitOptions } from './types.js';
+/**
+ * Generate MCP configuration
+ */
+export declare function generateMCPConfig(options: InitOptions): object;
+/**
+ * Generate .mcp.json as formatted string
+ */
+export declare function generateMCPJson(options: InitOptions): string;
+/**
+ * Generate MCP server add commands for manual setup
+ */
+export declare function generateMCPCommands(options: InitOptions): string[];
+/**
+ * Get platform-specific setup instructions
+ */
+export declare function getPlatformInstructions(): {
+    platform: string;
+    note: string;
+};
+//# sourceMappingURL=mcp-generator.d.ts.map

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

@@ -0,0 +1,116 @@
+/**
+ * MCP Configuration Generator
+ * Creates .mcp.json for Claude Code MCP server integration
+ * Handles cross-platform compatibility (Windows requires cmd /c wrapper)
+ */
+/**
+ * Check if running on Windows
+ */
+function isWindows() {
+    return process.platform === 'win32';
+}
+/**
+ * Generate platform-specific MCP server entry
+ * - Windows: uses 'cmd /c npx' directly
+ * - Unix: uses 'npx' directly (simple, reliable)
+ */
+function createMCPServerEntry(npxArgs, env, additionalProps = {}) {
+    if (isWindows()) {
+        return {
+            command: 'cmd',
+            args: ['/c', 'npx', '-y', ...npxArgs],
+            env,
+            ...additionalProps,
+        };
+    }
+    // Unix: direct npx invocation — simple and reliable
+    return {
+        command: 'npx',
+        args: ['-y', ...npxArgs],
+        env,
+        ...additionalProps,
+    };
+}
+/**
+ * Generate MCP configuration
+ */
+export function generateMCPConfig(options) {
+    const config = options.mcp;
+    const mcpServers = {};
+    const npmEnv = {
+        npm_config_update_notifier: 'false',
+    };
+    // Claude Flow MCP server (core)
+    if (config.claudeFlow) {
+        mcpServers['claude-flow'] = createMCPServerEntry(['@claude-flow/cli@latest', 'mcp', 'start'], {
+            ...npmEnv,
+            CLAUDE_FLOW_MODE: 'v3',
+            CLAUDE_FLOW_HOOKS_ENABLED: 'true',
+            CLAUDE_FLOW_TOPOLOGY: options.runtime.topology,
+            CLAUDE_FLOW_MAX_AGENTS: String(options.runtime.maxAgents),
+            CLAUDE_FLOW_MEMORY_BACKEND: options.runtime.memoryBackend,
+        }, { autoStart: config.autoStart });
+    }
+    // Ruv-Swarm MCP server (enhanced coordination)
+    if (config.ruvSwarm) {
+        mcpServers['ruv-swarm'] = createMCPServerEntry(['ruv-swarm', 'mcp', 'start'], { ...npmEnv }, { optional: true });
+    }
+    // Flow Nexus MCP server (cloud features)
+    if (config.flowNexus) {
+        mcpServers['flow-nexus'] = createMCPServerEntry(['flow-nexus@latest', 'mcp', 'start'], { ...npmEnv }, { optional: true, requiresAuth: true });
+    }
+    return { mcpServers };
+}
+/**
+ * Generate .mcp.json as formatted string
+ */
+export function generateMCPJson(options) {
+    const config = generateMCPConfig(options);
+    return JSON.stringify(config, null, 2);
+}
+/**
+ * Generate MCP server add commands for manual setup
+ */
+export function generateMCPCommands(options) {
+    const commands = [];
+    const config = options.mcp;
+    if (isWindows()) {
+        if (config.claudeFlow) {
+            commands.push('claude mcp add claude-flow -- cmd /c npx -y @claude-flow/cli@latest mcp start');
+        }
+        if (config.ruvSwarm) {
+            commands.push('claude mcp add ruv-swarm -- cmd /c npx -y ruv-swarm mcp start');
+        }
+        if (config.flowNexus) {
+            commands.push('claude mcp add flow-nexus -- cmd /c npx -y flow-nexus@latest mcp start');
+        }
+    }
+    else {
+        if (config.claudeFlow) {
+            commands.push("claude mcp add claude-flow -- npx -y @claude-flow/cli@latest mcp start");
+        }
+        if (config.ruvSwarm) {
+            commands.push("claude mcp add ruv-swarm -- npx -y ruv-swarm mcp start");
+        }
+        if (config.flowNexus) {
+            commands.push("claude mcp add flow-nexus -- npx -y flow-nexus@latest mcp start");
+        }
+    }
+    return commands;
+}
+/**
+ * Get platform-specific setup instructions
+ */
+export function getPlatformInstructions() {
+    if (isWindows()) {
+        return {
+            platform: 'Windows',
+            note: 'MCP configuration uses cmd /c wrapper for npx compatibility.',
+        };
+    }
+    return {
+        platform: process.platform === 'darwin' ? 'macOS' : 'Linux',
+        note: 'MCP configuration uses npx directly.',
+    };
+}
+//# sourceMappingURL=mcp-generator.js.map

package/v3/@claude-flow/cli/dist/src/init/moflo-init.d.ts

@@ -0,0 +1,14 @@
+export interface MofloInitOptions {
+    projectRoot: string;
+    force?: boolean;
+    skipIndex?: boolean;
+}
+export interface MofloInitResult {
+    steps: {
+        name: string;
+        status: 'created' | 'updated' | 'skipped' | 'error';
+        detail?: string;
+    }[];
+}
+export declare function initMoflo(options: MofloInitOptions): Promise<MofloInitResult>;
+//# sourceMappingURL=moflo-init.d.ts.map

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

@@ -0,0 +1,392 @@
+/**
+ * MoFlo Project Initializer
+ *
+ * One-stop setup that makes MoFlo work out of the box:
+ * 1. Generate moflo.yaml (project config)
+ * 2. Set up .claude/settings.json hooks
+ * 3. Create .claude/skills/mf/ skill
+ * 4. Append MoFlo section to CLAUDE.md
+ * 5. Initialize memory DB
+ * 6. Auto-index guidance + code map
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+// ============================================================================
+// Init
+// ============================================================================
+export async function initMoflo(options) {
+    const { projectRoot, force, skipIndex } = options;
+    const steps = [];
+    // Step 1: moflo.yaml
+    steps.push(generateConfig(projectRoot, force));
+    // Step 2: .claude/settings.json hooks
+    steps.push(generateHooks(projectRoot, force));
+    // Step 3: .claude/skills/mf/
+    steps.push(generateSkill(projectRoot, force));
+    // Step 4: CLAUDE.md MoFlo section
+    steps.push(generateClaudeMd(projectRoot, force));
+    // Step 5: .gitignore entries
+    steps.push(updateGitignore(projectRoot));
+    return { steps };
+}
+// ============================================================================
+// Step 1: moflo.yaml
+// ============================================================================
+function generateConfig(root, force) {
+    const configPath = path.join(root, 'moflo.yaml');
+    if (fs.existsSync(configPath) && !force) {
+        return { name: 'moflo.yaml', status: 'skipped', detail: 'Already exists (use --force to overwrite)' };
+    }
+    const projectName = path.basename(root);
+    // Detect guidance directories
+    const guidanceCandidates = ['.claude/guidance', 'docs/guides', 'docs'];
+    const guidanceDirs = guidanceCandidates.filter(d => fs.existsSync(path.join(root, d)));
+    if (guidanceDirs.length === 0)
+        guidanceDirs.push('.claude/guidance');
+    // Detect source directories
+    const srcCandidates = ['src', 'packages', 'lib', 'app', 'apps', 'services'];
+    const srcDirs = srcCandidates.filter(d => fs.existsSync(path.join(root, d)));
+    if (srcDirs.length === 0)
+        srcDirs.push('src');
+    // Detect languages
+    const extensions = new Set();
+    for (const dir of srcDirs) {
+        const fullDir = path.join(root, dir);
+        if (fs.existsSync(fullDir)) {
+            try {
+                scanExtensions(fullDir, extensions, 0, 3);
+            }
+            catch { /* skip */ }
+        }
+    }
+    const detectedExts = extensions.size > 0
+        ? [...extensions].sort()
+        : ['.ts', '.tsx', '.js', '.jsx'];
+    const yaml = `# MoFlo — Project Configuration
+# Generated by: moflo init
+# Docs: https://github.com/eric-cielo/moflo
+
+project:
+  name: "${projectName}"
+
+# Guidance/knowledge docs to index for semantic search
+guidance:
+  directories:
+${guidanceDirs.map(d => `    - ${d}`).join('\n')}
+  namespace: guidance
+
+# Source directories for code navigation map
+code_map:
+  directories:
+${srcDirs.map(d => `    - ${d}`).join('\n')}
+  extensions: [${detectedExts.map(e => `"${e}"`).join(', ')}]
+  exclude: [node_modules, dist, .next, coverage, build, __pycache__, target, .git]
+  namespace: code-map
+
+# Workflow gates (enforced via Claude Code hooks)
+gates:
+  memory_first: true
+  task_create_first: true
+  context_tracking: true
+
+# Auto-index on session start
+auto_index:
+  guidance: true
+  code_map: true
+
+# Model preferences
+models:
+  default: opus
+  review: opus
+`;
+    fs.writeFileSync(configPath, yaml, 'utf-8');
+    return { name: 'moflo.yaml', status: 'created', detail: `Detected: ${srcDirs.join(', ')} | ${detectedExts.join(', ')}` };
+}
+function scanExtensions(dir, extensions, depth, maxDepth) {
+    if (depth > maxDepth)
+        return;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries.slice(0, 100)) {
+        if (entry.isDirectory() && !['node_modules', '.git', 'dist', 'build'].includes(entry.name)) {
+            scanExtensions(path.join(dir, entry.name), extensions, depth + 1, maxDepth);
+        }
+        else if (entry.isFile()) {
+            const ext = path.extname(entry.name);
+            if (['.ts', '.tsx', '.js', '.jsx', '.py', '.go', '.rs', '.java', '.kt', '.swift', '.rb', '.cs'].includes(ext)) {
+                extensions.add(ext);
+            }
+        }
+    }
+}
+// ============================================================================
+// Step 2: .claude/settings.json hooks
+// ============================================================================
+function generateHooks(root, force) {
+    const settingsPath = path.join(root, '.claude', 'settings.json');
+    const settingsDir = path.dirname(settingsPath);
+    if (!fs.existsSync(settingsDir)) {
+        fs.mkdirSync(settingsDir, { recursive: true });
+    }
+    let existing = {};
+    if (fs.existsSync(settingsPath)) {
+        try {
+            existing = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+        }
+        catch { /* start fresh */ }
+        // Check if MoFlo hooks already set up
+        const hasGateHooks = JSON.stringify(existing).includes('moflo gate');
+        if (hasGateHooks && !force) {
+            return { name: '.claude/settings.json', status: 'skipped', detail: 'MoFlo hooks already configured' };
+        }
+    }
+    // Build hooks config
+    const hooks = {
+        "PreToolUse": [
+            {
+                "matcher": "Glob|Grep",
+                "hooks": [{
+                        "type": "command",
+                        "command": "npx moflo gate check-before-scan"
+                    }]
+            },
+            {
+                "matcher": "Read",
+                "hooks": [{
+                        "type": "command",
+                        "command": "npx moflo gate check-before-read"
+                    }]
+            },
+            {
+                "matcher": "Agent",
+                "hooks": [{
+                        "type": "command",
+                        "command": "npx moflo gate check-before-agent"
+                    }]
+            }
+        ],
+        "PostToolUse": [
+            {
+                "matcher": "TaskCreate",
+                "hooks": [{
+                        "type": "command",
+                        "command": "npx moflo gate record-task-created"
+                    }]
+            },
+            {
+                "matcher": "Bash",
+                "hooks": [{
+                        "type": "command",
+                        "command": "npx moflo gate check-bash-memory"
+                    }]
+            },
+            {
+                "matcher": "mcp__claude-flow__memory_search",
+                "hooks": [{
+                        "type": "command",
+                        "command": "npx moflo gate record-memory-searched"
+                    }]
+            }
+        ],
+        "UserPromptSubmit": [
+            {
+                "hooks": [{
+                        "type": "command",
+                        "command": "npx moflo gate prompt-reminder"
+                    }]
+            }
+        ]
+    };
+    // Merge: preserve existing non-MoFlo hooks, add MoFlo hooks
+    existing.hooks = hooks;
+    fs.writeFileSync(settingsPath, JSON.stringify(existing, null, 2), 'utf-8');
+    return { name: '.claude/settings.json', status: existing.hooks ? 'updated' : 'created', detail: '7 workflow gate hooks configured' };
+}
+// ============================================================================
+// Step 3: .claude/skills/mf/ skill
+// ============================================================================
+function generateSkill(root, force) {
+    const skillDir = path.join(root, '.claude', 'skills', 'mf');
+    const skillFile = path.join(skillDir, 'SKILL.md');
+    if (fs.existsSync(skillFile) && !force) {
+        return { name: '.claude/skills/mf/', status: 'skipped', detail: 'Already exists' };
+    }
+    if (!fs.existsSync(skillDir)) {
+        fs.mkdirSync(skillDir, { recursive: true });
+    }
+    const skillContent = `---
+name: mf
+description: MoFlo ticket workflow - analyze and execute GitHub issues
+arguments: "[options] <issue-number>"
+---
+
+# /mf - MoFlo Ticket Workflow
+
+Execute GitHub issues through a full automated workflow.
+
+**Arguments:** $ARGUMENTS
+
+## Usage
+
+\`\`\`
+/mf <issue-number>                    # Full workflow (default: swarm mode)
+/mf -e <issue-number>                 # Enhance only: research and update ticket
+/mf -r <issue-number>                 # Research only: analyze issue
+/mf -n <issue-number>                 # Naked mode: single Claude, no agents
+/mf -sw <issue-number>                # Swarm mode (explicit, default)
+\`\`\`
+
+## Workflow
+
+1. **Research** — Fetch issue, search memory, read guidance, explore codebase
+2. **Enhance** — Update issue with implementation plan, affected files, test plan
+3. **Implement** — Create branch, implement changes following the plan
+4. **Test** — Write and run unit/integration/E2E tests (ALL must pass)
+5. **Simplify** — Run /simplify on changed code for quality review
+6. **PR** — Commit, create PR, update issue status, store learnings
+
+## Parse Arguments
+
+\`\`\`javascript
+const args = "$ARGUMENTS".trim().split(/\\s+/);
+let workflowMode = "full";
+let execMode = "swarm";
+let issueNumber = null;
+
+for (let i = 0; i < args.length; i++) {
+  const arg = args[i];
+  if (arg === "-e" || arg === "--enhance") workflowMode = "enhance";
+  else if (arg === "-r" || arg === "--research") workflowMode = "research";
+  else if (arg === "-sw" || arg === "--swarm") execMode = "swarm";
+  else if (arg === "-n" || arg === "--naked") execMode = "naked";
+  else if (/^\\d+$/.test(arg)) issueNumber = arg;
+}
+
+if (!issueNumber) throw new Error("Issue number required. Usage: /mf <issue-number>");
+\`\`\`
+
+## Execution
+
+Full mode executes without prompts:
+1. Fetch issue via \`gh issue view\`
+2. Search memory for relevant patterns
+3. Research codebase with Explore agents
+4. Enhance issue with implementation plan
+5. Create branch, assign issue, implement
+6. Run tests (unit + integration + E2E)
+7. Run /simplify on changed code
+8. Create PR, update issue, store learnings
+
+All testing, linting, and quality gates are mandatory. PR cannot be created until all tests pass.
+`;
+    fs.writeFileSync(skillFile, skillContent, 'utf-8');
+    return { name: '.claude/skills/mf/', status: 'created', detail: '/mf skill ready' };
+}
+// ============================================================================
+// Step 4: CLAUDE.md MoFlo section
+// ============================================================================
+const MOFLO_MARKER = '<!-- MOFLO:START -->';
+const MOFLO_MARKER_END = '<!-- MOFLO:END -->';
+function generateClaudeMd(root, force) {
+    const claudeMdPath = path.join(root, 'CLAUDE.md');
+    let existing = '';
+    if (fs.existsSync(claudeMdPath)) {
+        existing = fs.readFileSync(claudeMdPath, 'utf-8');
+        // Check if MoFlo section already exists
+        if (existing.includes(MOFLO_MARKER)) {
+            if (!force) {
+                return { name: 'CLAUDE.md', status: 'skipped', detail: 'MoFlo section already present' };
+            }
+            // Remove existing MoFlo section for replacement
+            const startIdx = existing.indexOf(MOFLO_MARKER);
+            const endIdx = existing.indexOf(MOFLO_MARKER_END);
+            if (endIdx > startIdx) {
+                existing = existing.substring(0, startIdx) + existing.substring(endIdx + MOFLO_MARKER_END.length);
+            }
+        }
+    }
+    const mofloSection = `
+${MOFLO_MARKER}
+## MoFlo — AI Agent Orchestration
+
+This project uses [MoFlo](https://github.com/eric-cielo/moflo) for AI-assisted development workflows.
+
+### FIRST ACTION ON EVERY PROMPT: Search Memory
+
+Your first tool call for every new user prompt MUST be a memory search. Do this BEFORE Glob, Grep, Read, or any file exploration.
+
+\`\`\`
+mcp__claude-flow__memory_search  — query: "<task description>", namespace: "guidance" or "patterns" or "code-map"
+\`\`\`
+
+For codebase navigation, search the \`code-map\` namespace first. For patterns and domain knowledge, search \`patterns\` and \`guidance\`.
+
+### Workflow Gates (enforced automatically)
+
+These are enforced by hooks — you cannot bypass them:
+- **Memory-first**: Must search memory before Glob/Grep/Read on guidance files
+- **TaskCreate-first**: Must call TaskCreate before spawning Agent tool
+- **Context tracking**: Session tracked as FRESH → MODERATE → DEPLETED → CRITICAL
+
+### /mf Skill — Issue Execution
+
+Use \`/mf <issue-number>\` to execute GitHub issues through the full workflow:
+Research → Enhance → Implement → Test → Simplify → PR
+
+### MCP Tools Reference
+
+| Tool | Purpose |
+|------|---------|
+| \`mcp__claude-flow__memory_search\` | Semantic search across indexed knowledge |
+| \`mcp__claude-flow__memory_store\` | Store patterns and decisions |
+| \`mcp__claude-flow__hooks_route\` | Route task to optimal agent type |
+| \`mcp__claude-flow__hooks_pre-task\` | Record task start |
+| \`mcp__claude-flow__hooks_post-task\` | Record task completion for learning |
+
+### Agent Icon Mapping
+
+| Icon | Agent Type | Use For |
+|------|------------|---------|
+| 🔍 | Explore | Research, codebase exploration |
+| 📐 | Plan | Architecture, design |
+| ⚙️ | General | General coding tasks |
+| 🧪 | Test | Writing tests |
+| 🔬 | Analyzer | Code review, analysis |
+| 🔧 | Backend | API implementation |
+
+### Non-Trivial Task Workflow
+
+For any task beyond a single-line fix:
+1. Search memory first (mandatory gate)
+2. Create tasks with TaskCreate (mandatory gate)
+3. Spawn agents in waves (Explore first, then Implement + Test)
+4. Update task status as you go
+5. Store learnings after completion
+${MOFLO_MARKER_END}
+`;
+    const finalContent = existing.trimEnd() + '\n' + mofloSection;
+    fs.writeFileSync(claudeMdPath, finalContent, 'utf-8');
+    return {
+        name: 'CLAUDE.md',
+        status: existing ? 'updated' : 'created',
+        detail: 'MoFlo workflow section appended',
+    };
+}
+// ============================================================================
+// Step 5: .gitignore
+// ============================================================================
+function updateGitignore(root) {
+    const gitignorePath = path.join(root, '.gitignore');
+    const entries = ['.claude-orc/', '.swarm/', '.moflo/'];
+    if (!fs.existsSync(gitignorePath)) {
+        fs.writeFileSync(gitignorePath, entries.join('\n') + '\n', 'utf-8');
+        return { name: '.gitignore', status: 'created', detail: entries.join(', ') };
+    }
+    const existing = fs.readFileSync(gitignorePath, 'utf-8');
+    const toAdd = entries.filter(e => !existing.includes(e));
+    if (toAdd.length === 0) {
+        return { name: '.gitignore', status: 'skipped', detail: 'Entries already present' };
+    }
+    fs.appendFileSync(gitignorePath, '\n# MoFlo state (gitignored)\n' + toAdd.join('\n') + '\n');
+    return { name: '.gitignore', status: 'updated', detail: `Added: ${toAdd.join(', ')}` };
+}
+//# sourceMappingURL=moflo-init.js.map

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

@@ -0,0 +1,14 @@
+/**
+ * Settings.json Generator
+ * Creates .claude/settings.json with V3-optimized hook configurations
+ */
+import type { InitOptions } from './types.js';
+/**
+ * Generate the complete settings.json content
+ */
+export declare function generateSettings(options: InitOptions): object;
+/**
+ * Generate settings.json as formatted string
+ */
+export declare function generateSettingsJson(options: InitOptions): string;
+//# sourceMappingURL=settings-generator.d.ts.map