moflo 4.8.24 → 4.8.26

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

@@ -1,31 +1,31 @@
-export interface MofloInitOptions {
-    projectRoot: string;
-    force?: boolean;
-    skipIndex?: boolean;
-    interactive?: boolean;
-    minimal?: boolean;
-}
-export interface MofloInitAnswers {
-    guidance: boolean;
-    guidanceDirs: string[];
-    codeMap: boolean;
-    srcDirs: string[];
-    tests: boolean;
-    testDirs: string[];
-    gates: boolean;
-    stopHook: boolean;
-}
-export interface MofloInitResult {
-    steps: {
-        name: string;
-        status: 'created' | 'updated' | 'skipped' | 'error';
-        detail?: string;
-    }[];
-}
-/**
- * Discover test directories by checking common locations and walking for
- * colocated __tests__ dirs. Returns relative paths.
- */
-export declare function discoverTestDirs(root: string): string[];
-export declare function initMoflo(options: MofloInitOptions): Promise<MofloInitResult>;
+export interface MofloInitOptions {
+    projectRoot: string;
+    force?: boolean;
+    skipIndex?: boolean;
+    interactive?: boolean;
+    minimal?: boolean;
+}
+export interface MofloInitAnswers {
+    guidance: boolean;
+    guidanceDirs: string[];
+    codeMap: boolean;
+    srcDirs: string[];
+    tests: boolean;
+    testDirs: string[];
+    gates: boolean;
+    stopHook: boolean;
+}
+export interface MofloInitResult {
+    steps: {
+        name: string;
+        status: 'created' | 'updated' | 'skipped' | 'error';
+        detail?: string;
+    }[];
+}
+/**
+ * Discover test directories by checking common locations and walking for
+ * colocated __tests__ dirs. Returns relative paths.
+ */
+export declare function discoverTestDirs(root: string): string[];
+export declare function initMoflo(options: MofloInitOptions): Promise<MofloInitResult>;
 //# sourceMappingURL=moflo-init.d.ts.map

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

@@ -241,8 +241,6 @@ export async function initMoflo(options) {
     steps.push(updateGitignore(projectRoot));
     // Step 7: .claude/guidance/moflo-bootstrap.md (subagent bootstrap protocol)
     steps.push(syncBootstrapGuidance(projectRoot, force));
-    // Step 8: Sync ALL shipped guidance docs from moflo to project
-    steps.push(...syncAllShippedGuidance(projectRoot, force));
     return { steps };
 }
 // ============================================================================
@@ -272,102 +270,102 @@ function generateConfig(root, force, answers) {
     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
-
-# Test file discovery and indexing
-tests:
-  directories:
-${testDirs.map(d => `    - ${d}`).join('\n')}
-  patterns: ["*.test.*", "*.spec.*", "*.test-*"]
-  extensions: [".ts", ".tsx", ".js", ".jsx"]
-  exclude: [node_modules, coverage, dist]
-  namespace: tests
-
-# Workflow gates (enforced via Claude Code hooks)
-gates:
-  memory_first: ${gatesEnabled}
-  task_create_first: ${gatesEnabled}
-  context_tracking: ${gatesEnabled}
-
-# Auto-index on session start
-auto_index:
-  guidance: ${answers?.guidance ?? true}
-  code_map: ${answers?.codeMap ?? true}
-  tests: ${answers?.tests ?? true}
-
-# Memory backend
-memory:
-  backend: sql.js
-  embedding_model: Xenova/all-MiniLM-L6-v2
-  namespace: default
-
-# Hook toggles (all on by default — disable to slim down)
-hooks:
-  pre_edit: true               # Track file edits for learning
-  post_edit: true              # Record edit outcomes, train neural patterns
-  pre_task: true               # Get agent routing before task spawn
-  post_task: true              # Record task results for learning
-  gate: ${gatesEnabled}                   # Workflow gate enforcement (memory-first, task-create-first)
-  route: true                  # Intelligent task routing on each prompt
-  stop_hook: ${answers?.stopHook ?? true}              # Session-end persistence and metric export
-  session_restore: true        # Restore session state on start
-  notification: true           # Hook into Claude Code notifications
-
-# MCP server options
-mcp:
-  tool_defer: deferred           # Defer 150+ tool schemas; loaded on demand via ToolSearch
-  auto_start: false              # Auto-start MCP server on session begin
-
-# Status line display (shown at bottom of Claude Code)
-# mode: "compact" (default), "single-line", or "dashboard" (full multi-line)
-status_line:
-  enabled: true
-  mode: compact
-  branding: "MoFlo V4"
-  show_git: true
-  show_session: true
-  show_swarm: true
-  show_agentdb: true
-  show_mcp: true
-
-# Model preferences (haiku, sonnet, opus)
-models:
-  default: opus        # Model for general tasks
-  research: sonnet     # Model for research/exploration agents
-  review: opus         # Model for code review agents
-  test: sonnet         # Model for test-writing agents
-
-# Intelligent model routing (auto-selects haiku/sonnet/opus per task)
-# When enabled, overrides the static model preferences above
-# by analyzing task complexity and routing to the cheapest capable model.
-model_routing:
-  enabled: false                   # Set to true to enable dynamic routing
-  confidence_threshold: 0.85       # Min confidence before escalating to a more capable model
-  cost_optimization: true          # Prefer cheaper models when confidence is high
-  circuit_breaker: true            # Penalize models that fail repeatedly
-  # Per-agent overrides (set to "inherit" to use routing, or a specific model to pin)
-  # agent_overrides:
-  #   security-architect: opus     # Always use opus for security
-  #   researcher: sonnet           # Pin research to sonnet
+    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
+
+# Test file discovery and indexing
+tests:
+  directories:
+${testDirs.map(d => `    - ${d}`).join('\n')}
+  patterns: ["*.test.*", "*.spec.*", "*.test-*"]
+  extensions: [".ts", ".tsx", ".js", ".jsx"]
+  exclude: [node_modules, coverage, dist]
+  namespace: tests
+
+# Workflow gates (enforced via Claude Code hooks)
+gates:
+  memory_first: ${gatesEnabled}
+  task_create_first: ${gatesEnabled}
+  context_tracking: ${gatesEnabled}
+
+# Auto-index on session start
+auto_index:
+  guidance: ${answers?.guidance ?? true}
+  code_map: ${answers?.codeMap ?? true}
+  tests: ${answers?.tests ?? true}
+
+# Memory backend
+memory:
+  backend: sql.js
+  embedding_model: Xenova/all-MiniLM-L6-v2
+  namespace: default
+
+# Hook toggles (all on by default — disable to slim down)
+hooks:
+  pre_edit: true               # Track file edits for learning
+  post_edit: true              # Record edit outcomes, train neural patterns
+  pre_task: true               # Get agent routing before task spawn
+  post_task: true              # Record task results for learning
+  gate: ${gatesEnabled}                   # Workflow gate enforcement (memory-first, task-create-first)
+  route: true                  # Intelligent task routing on each prompt
+  stop_hook: ${answers?.stopHook ?? true}              # Session-end persistence and metric export
+  session_restore: true        # Restore session state on start
+  notification: true           # Hook into Claude Code notifications
+
+# MCP server options
+mcp:
+  tool_defer: deferred           # Defer 150+ tool schemas; loaded on demand via ToolSearch
+  auto_start: false              # Auto-start MCP server on session begin
+
+# Status line display (shown at bottom of Claude Code)
+# mode: "compact" (default), "single-line", or "dashboard" (full multi-line)
+status_line:
+  enabled: true
+  mode: compact
+  branding: "MoFlo V4"
+  show_git: true
+  show_session: true
+  show_swarm: true
+  show_agentdb: true
+  show_mcp: true
+
+# Model preferences (haiku, sonnet, opus)
+models:
+  default: opus        # Model for general tasks
+  research: sonnet     # Model for research/exploration agents
+  review: opus         # Model for code review agents
+  test: sonnet         # Model for test-writing agents
+
+# Intelligent model routing (auto-selects haiku/sonnet/opus per task)
+# When enabled, overrides the static model preferences above
+# by analyzing task complexity and routing to the cheapest capable model.
+model_routing:
+  enabled: false                   # Set to true to enable dynamic routing
+  confidence_threshold: 0.85       # Min confidence before escalating to a more capable model
+  cost_optimization: true          # Prefer cheaper models when confidence is high
+  circuit_breaker: true            # Penalize models that fail repeatedly
+  # Per-agent overrides (set to "inherit" to use routing, or a specific model to pin)
+  # agent_overrides:
+  #   security-architect: opus     # Always use opus for security
+  #   researcher: sonnet           # Pin research to sonnet
 `;
     fs.writeFileSync(configPath, yaml, 'utf-8');
     return { name: 'moflo.yaml', status: 'created', detail: `Detected: ${srcDirs.join(', ')} | ${detectedExts.join(', ')}` };
@@ -647,8 +645,10 @@ function generateClaudeMd(root, force) {
         const allEndMarkers = [MOFLO_MARKER_END, ...LEGACY_MARKERS_END];
         for (let i = 0; i < allStartMarkers.length; i++) {
             if (existing.includes(allStartMarkers[i])) {
-                // Always strip the existing section so we can re-inject the latest version.
-                // This ensures CLAUDE.md stays current when moflo updates its injected content.
+                if (!force && allStartMarkers[i] === MOFLO_MARKER) {
+                    return { name: 'CLAUDE.md', status: 'skipped', detail: 'MoFlo section already present' };
+                }
+                // Remove existing section for replacement
                 const startIdx = existing.indexOf(allStartMarkers[i]);
                 const endIdx = existing.indexOf(allEndMarkers[i]);
                 if (endIdx > startIdx) {
@@ -659,51 +659,50 @@ function generateClaudeMd(root, force) {
     }
     // Minimal injection — just enough for Claude to work with moflo.
     // All detailed docs live in .claude/guidance/shipped/moflo.md.
-    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__moflo__memory_search — query: "<task description>", namespace: "guidance" or "patterns" or "code-map"
-\`\`\`
-
-Search \`guidance\` and \`patterns\` namespaces on every prompt. Search \`code-map\` when navigating the codebase.
-When the user asks you to remember something: \`mcp__moflo__memory_store\` with namespace \`knowledge\`.
-
-### Workflow Gates (enforced automatically)
-
-- **Memory-first**: Must search memory before Glob/Grep/Read
-- **TaskCreate-first**: Must call TaskCreate before spawning Agent tool
-- **Task Icons**: \`TaskCreate\` MUST use ICON+[Role] format — see \`.claude/guidance/shipped/task-icons.md\`
-
-### MCP Tools (preferred over CLI)
-
-| Tool | Purpose |
-|------|---------|
-| \`mcp__moflo__memory_search\` | Semantic search across indexed knowledge |
-| \`mcp__moflo__memory_store\` | Store patterns and decisions |
-| \`mcp__moflo__hooks_route\` | Route task to optimal agent type |
-| \`mcp__moflo__hooks_pre-task\` | Record task start |
-| \`mcp__moflo__hooks_post-task\` | Record task completion for learning |
-
-### CLI Fallback
-
-\`\`\`bash
-npx flo-search "[query]" --namespace guidance   # Semantic search
-npx flo doctor --fix                             # Health check
-\`\`\`
-
-### Full Reference
-
-For CLI commands, hooks, agents, swarm config, memory commands, and moflo.yaml options, see:
-\`.claude/guidance/shipped/moflo.md\`
-${MOFLO_MARKER_END}
+    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__moflo__memory_search — query: "<task description>", namespace: "guidance" or "patterns" or "code-map"
+\`\`\`
+
+Search \`guidance\` and \`patterns\` namespaces on every prompt. Search \`code-map\` when navigating the codebase.
+When the user asks you to remember something: \`mcp__moflo__memory_store\` with namespace \`knowledge\`.
+
+### Workflow Gates (enforced automatically)
+
+- **Memory-first**: Must search memory before Glob/Grep/Read
+- **TaskCreate-first**: Must call TaskCreate before spawning Agent tool
+
+### MCP Tools (preferred over CLI)
+
+| Tool | Purpose |
+|------|---------|
+| \`mcp__moflo__memory_search\` | Semantic search across indexed knowledge |
+| \`mcp__moflo__memory_store\` | Store patterns and decisions |
+| \`mcp__moflo__hooks_route\` | Route task to optimal agent type |
+| \`mcp__moflo__hooks_pre-task\` | Record task start |
+| \`mcp__moflo__hooks_post-task\` | Record task completion for learning |
+
+### CLI Fallback
+
+\`\`\`bash
+npx flo-search "[query]" --namespace guidance   # Semantic search
+npx flo doctor --fix                             # Health check
+\`\`\`
+
+### Full Reference
+
+For CLI commands, hooks, agents, swarm config, memory commands, and moflo.yaml options, see:
+\`.claude/guidance/shipped/moflo.md\`
+${MOFLO_MARKER_END}
 `;
     const finalContent = existing.trimEnd() + '\n' + mofloSection;
     fs.writeFileSync(claudeMdPath, finalContent, 'utf-8');
@@ -847,59 +846,4 @@ function syncBootstrapGuidance(root, force) {
         detail: 'Subagent bootstrap protocol'
     };
 }
-// ============================================================================
-// Step 8: Sync ALL shipped guidance docs
-// Discovers all .md files in moflo/.claude/guidance/shipped/ and copies them
-// to project .claude/guidance/. Skips agent-bootstrap.md (handled by Step 7).
-// ============================================================================
-function syncAllShippedGuidance(root, force) {
-    const guidanceDir = path.join(root, '.claude', 'guidance');
-    let sourceDir;
-    try {
-        sourceDir = path.dirname(fileURLToPath(import.meta.url));
-    }
-    catch {
-        sourceDir = typeof __dirname !== 'undefined' ? __dirname : '';
-    }
-    // Find the shipped guidance directory
-    const shippedCandidates = [
-        path.join(root, 'node_modules', 'moflo', '.claude', 'guidance', 'shipped'),
-        ...(sourceDir ? [path.join(sourceDir, '..', '..', '..', '..', '.claude', 'guidance', 'shipped')] : []),
-    ];
-    const shippedDir = shippedCandidates.find(d => { try {
-        return fs.existsSync(d) && fs.statSync(d).isDirectory();
-    }
-    catch {
-        return false;
-    } });
-    if (!shippedDir) {
-        return [{ name: 'guidance/shipped/*', status: 'skipped', detail: 'Shipped guidance directory not found' }];
-    }
-    // Discover all .md files, skip agent-bootstrap.md (synced separately as moflo-bootstrap.md)
-    const files = fs.readdirSync(shippedDir).filter(f => f.endsWith('.md') && f !== 'agent-bootstrap.md');
-    if (files.length === 0) {
-        return [{ name: 'guidance/shipped/*', status: 'skipped', detail: 'No shipped guidance files found' }];
-    }
-    const results = [];
-    for (const filename of files) {
-        const sourceFile = path.join(shippedDir, filename);
-        const targetFile = path.join(guidanceDir, filename);
-        if (fs.existsSync(targetFile) && !force) {
-            if (!isStale(sourceFile, targetFile)) {
-                results.push({ name: `guidance/${filename}`, status: 'skipped', detail: 'Already up to date' });
-                continue;
-            }
-        }
-        const content = fs.readFileSync(sourceFile, 'utf-8');
-        const header = `<!-- AUTO-GENERATED by moflo init. Do not edit — changes will be overwritten on next init. -->\n<!-- Source: moflo/.claude/guidance/shipped/${filename} -->\n\n`;
-        fs.mkdirSync(guidanceDir, { recursive: true });
-        fs.writeFileSync(targetFile, header + content, 'utf-8');
-        results.push({
-            name: `guidance/${filename}`,
-            status: 'updated',
-            detail: `Shipped guidance synced`,
-        });
-    }
-    return results;
-}
 //# sourceMappingURL=moflo-init.js.map