moflo 4.8.26 → 4.8.29

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

@@ -50,6 +50,9 @@ export interface MofloConfig {
         circuit_breaker: boolean;
         agent_overrides: Record<string, string>;
     };
+    daemon: {
+        auto_start: boolean;
+    };
     auto_update: {
         enabled: boolean;
         scripts: boolean;

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

@@ -69,6 +69,9 @@ const DEFAULT_CONFIG = {
         circuit_breaker: true,
         agent_overrides: {},
     },
+    daemon: {
+        auto_start: true,
+    },
     auto_update: {
         enabled: true,
         scripts: true,
@@ -164,6 +167,9 @@ function mergeConfig(raw, root) {
             circuit_breaker: raw.model_routing?.circuit_breaker ?? raw.modelRouting?.circuitBreaker ?? DEFAULT_CONFIG.model_routing.circuit_breaker,
             agent_overrides: raw.model_routing?.agent_overrides ?? raw.modelRouting?.agentOverrides ?? DEFAULT_CONFIG.model_routing.agent_overrides,
         },
+        daemon: {
+            auto_start: raw.daemon?.auto_start ?? raw.daemon?.autoStart ?? DEFAULT_CONFIG.daemon.auto_start,
+        },
         auto_update: {
             enabled: raw.auto_update?.enabled ?? raw.autoUpdate?.enabled ?? DEFAULT_CONFIG.auto_update.enabled,
             scripts: raw.auto_update?.scripts ?? raw.autoUpdate?.scripts ?? DEFAULT_CONFIG.auto_update.scripts,
@@ -255,97 +261,101 @@ export function generateMofloConfig(projectRoot) {
         }
     }
     const detectedExtensions = extensions.size > 0 ? [...extensions] : ['.ts', '.tsx', '.js', '.jsx'];
-    const config = `# 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: [${detectedExtensions.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          # Search memory before Glob/Grep
-  task_create_first: true     # TaskCreate before Agent tool
-  context_tracking: true      # Track context bracket (FRESH/MODERATE/DEPLETED/CRITICAL)
-
-# Auto-index on session start
-auto_index:
-  guidance: true
-  code_map: true
-
-# Memory backend
-memory:
-  backend: sql.js              # sql.js (WASM, no native deps) | agentdb | json
-  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: true                   # Workflow gate enforcement (memory-first, task-create-first)
-  route: true                  # Intelligent task routing on each prompt
-  stop_hook: true              # Session-end persistence and metric export
-  session_restore: true        # Restore session state on start
-  notification: true           # Hook into Claude Code notifications
-
-# 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
-  # agent_overrides:
-  #   security-architect: opus     # Always use opus for security
-  #   researcher: sonnet           # Pin research to sonnet
-
-# Auto-update on session start (syncs scripts and helpers when moflo version changes)
-auto_update:
-  enabled: true                  # Master toggle for version-change auto-sync
-  scripts: true                  # Sync .claude/scripts/ from moflo bin/
-  helpers: true                  # Sync .claude/helpers/ from moflo source
-
-# Status line items (show/hide individual sections)
-status_line:
-  enabled: true
-  branding: "Moflo V4"            # Text shown in status bar
-  show_git: true                  # Git branch, changes, ahead/behind
-  show_model: true                # Current model name
-  show_session: true              # Session duration
-  show_intelligence: true         # Intelligence % indicator
-  show_swarm: true                # Active swarm agents count
-  show_hooks: true                # Enabled hooks count
-  show_mcp: true                  # MCP server count
-  show_security: true             # CVE/security status (dashboard only)
-  show_adrs: true                 # ADR compliance (dashboard only)
-  show_agentdb: true              # AgentDB vectors/size (dashboard only)
-  show_tests: true                # Test file count (dashboard only)
-  mode: single-line              # single-line (default) or dashboard (multi-line)
+    const config = `# 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: [${detectedExtensions.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          # Search memory before Glob/Grep
+  task_create_first: true     # TaskCreate before Agent tool
+  context_tracking: true      # Track context bracket (FRESH/MODERATE/DEPLETED/CRITICAL)
+
+# Auto-index on session start
+auto_index:
+  guidance: true
+  code_map: true
+
+# Memory backend
+memory:
+  backend: sql.js              # sql.js (WASM, no native deps) | agentdb | json
+  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: true                   # Workflow gate enforcement (memory-first, task-create-first)
+  route: true                  # Intelligent task routing on each prompt
+  stop_hook: true              # Session-end persistence and metric export
+  session_restore: true        # Restore session state on start
+  notification: true           # Hook into Claude Code notifications
+
+# Worker daemon (background indexing, optimization, test gap detection)
+daemon:
+  auto_start: true              # Start daemon automatically on CLI/MCP init (set false to disable)
+
+# 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
+  # agent_overrides:
+  #   security-architect: opus     # Always use opus for security
+  #   researcher: sonnet           # Pin research to sonnet
+
+# Auto-update on session start (syncs scripts and helpers when moflo version changes)
+auto_update:
+  enabled: true                  # Master toggle for version-change auto-sync
+  scripts: true                  # Sync .claude/scripts/ from moflo bin/
+  helpers: true                  # Sync .claude/helpers/ from moflo source
+
+# Status line items (show/hide individual sections)
+status_line:
+  enabled: true
+  branding: "Moflo V4"            # Text shown in status bar
+  show_git: true                  # Git branch, changes, ahead/behind
+  show_model: true                # Current model name
+  show_session: true              # Session duration
+  show_intelligence: true         # Intelligence % indicator
+  show_swarm: true                # Active swarm agents count
+  show_hooks: true                # Enabled hooks count
+  show_mcp: true                  # MCP server count
+  show_security: true             # CVE/security status (dashboard only)
+  show_adrs: true                 # ADR compliance (dashboard only)
+  show_agentdb: true              # AgentDB vectors/size (dashboard only)
+  show_tests: true                # Test file count (dashboard only)
+  mode: single-line              # single-line (default) or dashboard (multi-line)
 `;
     return config;
 }

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

@@ -43,6 +43,11 @@ export declare class CLI {
      * Shows notification if updates are available
      */
     private checkForUpdatesOnStartup;
+    /**
+     * Auto-start daemon if moflo.yaml enables it and no daemon is running.
+     * Non-blocking — fires and forgets. Errors are silently swallowed.
+     */
+    private maybeAutoStartDaemon;
     /**
      * Load configuration file
      */

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

@@ -12,6 +12,8 @@ import { output } from './output.js';
 import { commands, commandsByCategory, getCommand, getCommandAsync, getCommandNames, hasCommand } from './commands/index.js';
 import { suggestCommand } from './suggest.js';
 import { runStartupUpdateCheck } from './update/index.js';
+import { loadMofloConfig } from './config/moflo-config.js';
+import { getDaemonLockHolder } from './services/daemon-lock.js';
 // Read version from package.json at runtime
 function getPackageVersion() {
     try {
@@ -84,6 +86,11 @@ export class CLI {
             if (!flags.noUpdate && commandPath[0] !== 'update') {
                 this.checkForUpdatesOnStartup().catch(() => { });
             }
+            // Auto-start daemon if configured and not already running (non-blocking).
+            // Skip if user is explicitly running a daemon command to avoid interference.
+            if (commandPath[0] !== 'daemon') {
+                this.maybeAutoStartDaemon().catch(() => { });
+            }
             // Handle lazy-loaded commands that weren't recognized by the parser
             // If commandPath is empty but positional has a command name, check if it's lazy-loadable
             if (commandPath.length === 0 && positional.length > 0 && !positional[0].startsWith('-')) {
@@ -390,6 +397,43 @@ export class CLI {
             // Silently fail - don't interrupt CLI usage
         }
     }
+    /**
+     * Auto-start daemon if moflo.yaml enables it and no daemon is running.
+     * Non-blocking — fires and forgets. Errors are silently swallowed.
+     */
+    async maybeAutoStartDaemon() {
+        const config = loadMofloConfig(process.cwd());
+        if (!config.daemon.auto_start)
+            return;
+        // Already running?
+        const holder = getDaemonLockHolder(process.cwd());
+        if (holder)
+            return;
+        // Dynamically import to avoid circular deps and keep CLI startup fast
+        const { spawn } = await import('child_process');
+        const { fileURLToPath } = await import('url');
+        const { dirname, join, resolve } = await import('path');
+        const { existsSync, openSync, mkdirSync } = await import('fs');
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        const cliPath = resolve(join(__dirname, '..', '..', 'bin', 'cli.js'));
+        if (!existsSync(cliPath))
+            return;
+        const projectRoot = process.cwd();
+        const stateDir = join(projectRoot, '.claude-flow');
+        if (!existsSync(stateDir))
+            mkdirSync(stateDir, { recursive: true });
+        const logFile = join(stateDir, 'daemon.log');
+        const isWin = process.platform === 'win32';
+        const child = spawn(process.execPath, [cliPath, 'daemon', 'start', '--foreground', '--quiet'], {
+            cwd: projectRoot,
+            detached: !isWin,
+            stdio: ['ignore', openSync(logFile, 'a'), openSync(logFile, 'a')],
+            env: { ...process.env, CLAUDE_FLOW_DAEMON: '1' },
+            ...(isWin ? { shell: true, windowsHide: true } : {}),
+        });
+        child.unref();
+    }
     /**
      * Load configuration file
      */

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

@@ -1,30 +1,30 @@
-/**
- * CLAUDE.md Generator
- *
- * Generates ONLY the MoFlo section to inject into a project's CLAUDE.md.
- * This must be minimal — just enough for Claude to work with moflo.
- * All detailed docs live in .claude/guidance/shipped/moflo.md (copied at install).
- *
- * Principle: we are guests in the user's CLAUDE.md. Keep it small.
- */
-import type { InitOptions, ClaudeMdTemplate } from './types.js';
-declare const MARKER_START = "<!-- MOFLO:INJECTED:START -->";
-declare const MARKER_END = "<!-- MOFLO:INJECTED:END -->";
-export { MARKER_START, MARKER_END };
-/**
- * Generate the MoFlo section to inject into CLAUDE.md.
- * Template parameter is accepted for backward compatibility but ignored —
- * all templates now produce the same minimal injection.
- */
-export declare function generateClaudeMd(_options: InitOptions, _template?: ClaudeMdTemplate): string;
-/**
- * Generate minimal CLAUDE.md content (backward-compatible alias).
- */
-export declare function generateMinimalClaudeMd(options: InitOptions): string;
-/** Available template names for CLI wizard (kept for backward compat, all produce same output) */
-export declare const CLAUDE_MD_TEMPLATES: Array<{
-    name: ClaudeMdTemplate;
-    description: string;
-}>;
-export default generateClaudeMd;
+/**
+ * CLAUDE.md Generator
+ *
+ * Generates ONLY the MoFlo section to inject into a project's CLAUDE.md.
+ * This must be minimal — just enough for Claude to work with moflo.
+ * All detailed docs live in .claude/guidance/shipped/moflo.md (copied at install).
+ *
+ * Principle: we are guests in the user's CLAUDE.md. Keep it small.
+ */
+import type { InitOptions, ClaudeMdTemplate } from './types.js';
+declare const MARKER_START = "<!-- MOFLO:INJECTED:START -->";
+declare const MARKER_END = "<!-- MOFLO:INJECTED:END -->";
+export { MARKER_START, MARKER_END };
+/**
+ * Generate the MoFlo section to inject into CLAUDE.md.
+ * Template parameter is accepted for backward compatibility but ignored —
+ * all templates now produce the same minimal injection.
+ */
+export declare function generateClaudeMd(_options: InitOptions, _template?: ClaudeMdTemplate): string;
+/**
+ * Generate minimal CLAUDE.md content (backward-compatible alias).
+ */
+export declare function generateMinimalClaudeMd(options: InitOptions): string;
+/** Available template names for CLI wizard (kept for backward compat, all produce same output) */
+export declare const CLAUDE_MD_TEMPLATES: Array<{
+    name: ClaudeMdTemplate;
+    description: string;
+}>;
+export default generateClaudeMd;
 //# sourceMappingURL=claudemd-generator.d.ts.map

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

@@ -1,88 +1,90 @@
-/**
- * CLAUDE.md Generator
- *
- * Generates ONLY the MoFlo section to inject into a project's CLAUDE.md.
- * This must be minimal — just enough for Claude to work with moflo.
- * All detailed docs live in .claude/guidance/shipped/moflo.md (copied at install).
- *
- * Principle: we are guests in the user's CLAUDE.md. Keep it small.
- */
-const MARKER_START = '<!-- MOFLO:INJECTED:START -->';
-const MARKER_END = '<!-- MOFLO:INJECTED:END -->';
-/**
- * The single moflo section injected into CLAUDE.md.
- * ~40 lines. Points to moflo.md for everything else.
- */
-function mofloSection() {
-    return `${MARKER_START}
-## 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
-
-- **Agent bootstrap protocol:** \`.claude/guidance/shipped/agent-bootstrap.md\`
-- **Task + swarm coordination:** \`.claude/guidance/shipped/task-swarm-integration.md\`
-- **CLI, hooks, swarm, memory, moflo.yaml:** \`.claude/guidance/shipped/moflo.md\`
-${MARKER_END}`;
-}
-// --- Public API ---
-export { MARKER_START, MARKER_END };
-/**
- * Generate the MoFlo section to inject into CLAUDE.md.
- * Template parameter is accepted for backward compatibility but ignored —
- * all templates now produce the same minimal injection.
- */
-export function generateClaudeMd(_options, _template) {
-    return mofloSection() + '\n';
-}
-/**
- * Generate minimal CLAUDE.md content (backward-compatible alias).
- */
-export function generateMinimalClaudeMd(options) {
-    return generateClaudeMd(options, 'minimal');
-}
-/** Available template names for CLI wizard (kept for backward compat, all produce same output) */
-export const CLAUDE_MD_TEMPLATES = [
-    { name: 'minimal', description: 'Recommended — memory search, workflow gates, MCP tools (~40 lines injected)' },
-    { name: 'standard', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
-    { name: 'full', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
-    { name: 'security', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
-    { name: 'performance', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
-    { name: 'solo', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
-];
-export default generateClaudeMd;
+/**
+ * CLAUDE.md Generator
+ *
+ * Generates ONLY the MoFlo section to inject into a project's CLAUDE.md.
+ * This must be minimal — just enough for Claude to work with moflo.
+ * All detailed docs live in .claude/guidance/shipped/moflo.md (copied at install).
+ *
+ * Principle: we are guests in the user's CLAUDE.md. Keep it small.
+ */
+const MARKER_START = '<!-- MOFLO:INJECTED:START -->';
+const MARKER_END = '<!-- MOFLO:INJECTED:END -->';
+/**
+ * The single moflo section injected into CLAUDE.md.
+ * ~40 lines. Points to moflo.md for everything else.
+ */
+function mofloSection() {
+    return `${MARKER_START}
+## 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/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
+
+- **Agent bootstrap protocol:** \`.claude/guidance/shipped/agent-bootstrap.md\`
+- **Task + swarm coordination:** \`.claude/guidance/shipped/task-swarm-integration.md\`
+- **CLI, hooks, swarm, memory, moflo.yaml:** \`.claude/guidance/shipped/moflo.md\`
+${MARKER_END}`;
+}
+// --- Public API ---
+export { MARKER_START, MARKER_END };
+/**
+ * Generate the MoFlo section to inject into CLAUDE.md.
+ * Template parameter is accepted for backward compatibility but ignored —
+ * all templates now produce the same minimal injection.
+ */
+export function generateClaudeMd(_options, _template) {
+    return mofloSection() + '\n';
+}
+/**
+ * Generate minimal CLAUDE.md content (backward-compatible alias).
+ */
+export function generateMinimalClaudeMd(options) {
+    return generateClaudeMd(options, 'minimal');
+}
+/** Available template names for CLI wizard (kept for backward compat, all produce same output) */
+export const CLAUDE_MD_TEMPLATES = [
+    { name: 'minimal', description: 'Recommended — memory search, workflow gates, MCP tools (~40 lines injected)' },
+    { name: 'standard', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
+    { name: 'full', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
+    { name: 'security', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
+    { name: 'performance', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
+    { name: 'solo', description: 'Same as minimal (detailed docs in .claude/guidance/shipped/moflo.md)' },
+];
+export default generateClaudeMd;
 //# sourceMappingURL=claudemd-generator.js.map