moflo 4.8.10 → 4.8.12

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

@@ -1,508 +1,87 @@
-/**
- * CLAUDE.md Generator
- * Generates enforceable, analyzer-optimized Claude Code configuration
- * with template variants for different usage patterns.
- *
- * Templates: minimal | standard | full | security | performance | solo
- * All templates use bullet-format rules with imperative keywords for enforceability.
- */
-// --- Section Generators (each returns enforceable markdown) ---
-function behavioralRules() {
-    return `## Behavioral Rules (Always Enforced)
+/**
+ * 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.
 
-- Do what has been asked; nothing more, nothing less
-- NEVER create files unless they're absolutely necessary for achieving your goal
-- ALWAYS prefer editing an existing file to creating a new one
-- NEVER proactively create documentation files (*.md) or README files unless explicitly requested
-- NEVER save working files, text/mds, or tests to the root folder
-- Never continuously check status after spawning a swarm — wait for results
-- ALWAYS read a file before editing it
-- NEVER commit secrets, credentials, or .env files`;
-}
-function fileOrganization() {
-    return `## File Organization
-
-- NEVER save to root folder — use the directories below
-- Use \`/src\` for source code files
-- Use \`/tests\` for test files
-- Use \`/docs\` for documentation and markdown files
-- Use \`/config\` for configuration files
-- Use \`/scripts\` for utility scripts
-- Use \`/examples\` for example code`;
-}
-function projectArchitecture(options) {
-    return `## Project Architecture
-
-- Follow Domain-Driven Design with bounded contexts
-- Keep files under 500 lines
-- Use typed interfaces for all public APIs
-- Prefer TDD London School (mock-first) for new code
-- Use event sourcing for state changes
-- Ensure input validation at system boundaries
-
-### Project Config
-
-- **Topology**: ${options.runtime.topology}
-- **Max Agents**: ${options.runtime.maxAgents}
-- **Memory**: ${options.runtime.memoryBackend}
-- **HNSW**: ${options.runtime.enableHNSW ? 'Enabled' : 'Disabled'}
-- **Neural**: ${options.runtime.enableNeural ? 'Enabled' : 'Disabled'}`;
-}
-function concurrencyRules() {
-    return `## Concurrency: 1 MESSAGE = ALL RELATED OPERATIONS
-
-- All operations MUST be concurrent/parallel in a single message
-- Use Claude Code's Task tool for spawning agents, not just MCP
-- ALWAYS batch ALL todos in ONE TodoWrite call (5-10+ minimum)
-- ALWAYS spawn ALL agents in ONE message with full instructions via Task tool
-- ALWAYS batch ALL file reads/writes/edits in ONE message
-- ALWAYS batch ALL Bash commands in ONE message`;
-}
-function swarmOrchestration() {
-    return `## Swarm Orchestration
-
-- MUST initialize the swarm using CLI tools when starting complex tasks
-- MUST spawn concurrent agents using Claude Code's Task tool
-- Never use CLI tools alone for execution — Task tool agents do the actual work
-- MUST call CLI tools AND Task tool in ONE message for complex work
-
-### 3-Tier Model Routing (ADR-026)
-
-| Tier | Handler | Latency | Cost | Use Cases |
-|------|---------|---------|------|-----------|
-| **1** | Agent Booster (WASM) | <1ms | $0 | Simple transforms (var→const, add types) — Skip LLM |
-| **2** | Haiku | ~500ms | $0.0002 | Simple tasks, low complexity (<30%) |
-| **3** | Sonnet/Opus | 2-5s | $0.003-0.015 | Complex reasoning, architecture, security (>30%) |
-
-- Always check for \`[AGENT_BOOSTER_AVAILABLE]\` or \`[TASK_MODEL_RECOMMENDATION]\` before spawning agents
-- Use Edit tool directly when \`[AGENT_BOOSTER_AVAILABLE]\``;
-}
-function antiDriftConfig() {
-    return `## Swarm Configuration & Anti-Drift
-
-- ALWAYS use hierarchical topology for coding swarms
-- Keep maxAgents at 6-8 for tight coordination
-- Use specialized strategy for clear role boundaries
-- Use \`raft\` consensus for hive-mind (leader maintains authoritative state)
-- Run frequent checkpoints via \`post-task\` hooks
-- Keep shared memory namespace for all agents
-
-\`\`\`bash
-npx moflo swarm init --topology hierarchical --max-agents 8 --strategy specialized
-\`\`\``;
-}
-function autoStartProtocol() {
-    return `## Swarm Protocols & Routing
-
-### Auto-Start Swarm Protocol
-
-When the user requests a complex task, spawn agents in background and WAIT:
-
-\`\`\`javascript
-// STEP 1: Initialize swarm coordination
-Bash("npx moflo swarm init --topology hierarchical --max-agents 8 --strategy specialized")
-
-// STEP 2: Spawn ALL agents IN BACKGROUND in a SINGLE message
-Task({prompt: "Research requirements...", subagent_type: "researcher", run_in_background: true})
-Task({prompt: "Design architecture...", subagent_type: "system-architect", run_in_background: true})
-Task({prompt: "Implement solution...", subagent_type: "coder", run_in_background: true})
-Task({prompt: "Write tests...", subagent_type: "tester", run_in_background: true})
-Task({prompt: "Review code quality...", subagent_type: "reviewer", run_in_background: true})
 \`\`\`
-
-### Agent Routing
-
-| Code | Task | Agents |
-|------|------|--------|
-| 1 | Bug Fix | coordinator, researcher, coder, tester |
-| 3 | Feature | coordinator, architect, coder, tester, reviewer |
-| 5 | Refactor | coordinator, architect, coder, reviewer |
-| 7 | Performance | coordinator, perf-engineer, coder |
-| 9 | Security | coordinator, security-architect, auditor |
-
-### Task Complexity Detection
-
-- AUTO-INVOKE SWARM when task involves: 3+ files, new features, cross-module refactoring, API changes, security, or performance work
-- SKIP SWARM for: single file edits, simple bug fixes (1-2 lines), documentation updates, configuration changes`;
-}
-function executionRules() {
-    return `## Swarm Execution Rules
-
-- ALWAYS use \`run_in_background: true\` for all agent Task calls
-- ALWAYS put ALL agent Task calls in ONE message for parallel execution
-- After spawning, STOP — do NOT add more tool calls or check status
-- Never poll TaskOutput or check swarm status — trust agents to return
-- When agent results arrive, review ALL results before proceeding`;
-}
-function cliCommandsTable() {
-    return `## V3 CLI Commands
-
-### Core Commands
-
-| Command | Subcommands | Description |
-|---------|-------------|-------------|
-| \`init\` | 4 | Project initialization |
-| \`agent\` | 8 | Agent lifecycle management |
-| \`swarm\` | 6 | Multi-agent swarm coordination |
-| \`memory\` | 11 | AgentDB memory with HNSW search |
-| \`task\` | 6 | Task creation and lifecycle |
-| \`session\` | 7 | Session state management |
-| \`hooks\` | 17 | Self-learning hooks + 12 workers |
-| \`hive-mind\` | 6 | Byzantine fault-tolerant consensus |
-
-### Quick CLI Examples
-
-\`\`\`bash
-npx moflo init --wizard
-npx moflo agent spawn -t coder --name my-coder
-npx moflo swarm init --v3-mode
-npx moflo memory search --query "authentication patterns"
-npx moflo doctor --fix
-\`\`\``;
-}
-function agentTypes() {
-    return `## Available Agents (60+ Types)
-
-### Core Development
-\`coder\`, \`reviewer\`, \`tester\`, \`planner\`, \`researcher\`
-
-### Specialized
-\`security-architect\`, \`security-auditor\`, \`memory-specialist\`, \`performance-engineer\`
-
-### Swarm Coordination
-\`hierarchical-coordinator\`, \`mesh-coordinator\`, \`adaptive-coordinator\`
-
-### GitHub & Repository
-\`pr-manager\`, \`code-review-swarm\`, \`issue-tracker\`, \`release-manager\`
-
-### SPARC Methodology
-\`sparc-coord\`, \`sparc-coder\`, \`specification\`, \`pseudocode\`, \`architecture\``;
-}
-function hooksSystem() {
-    return `## Hooks System (27 Hooks + 12 Workers)
-
-### Essential Hooks
-
-| Hook | Description |
-|------|-------------|
-| \`pre-task\` / \`post-task\` | Task lifecycle with learning |
-| \`pre-edit\` / \`post-edit\` | File editing with neural training |
-| \`session-start\` / \`session-end\` | Session state persistence |
-| \`route\` | Route task to optimal agent |
-| \`intelligence\` | RuVector intelligence system |
-| \`worker\` | Background worker management |
-
-### 12 Background Workers
-
-| Worker | Priority | Description |
-|--------|----------|-------------|
-| \`optimize\` | high | Performance optimization |
-| \`audit\` | critical | Security analysis |
-| \`testgaps\` | normal | Test coverage analysis |
-| \`map\` | normal | Codebase mapping |
-| \`deepdive\` | normal | Deep code analysis |
-| \`document\` | normal | Auto-documentation |
-
-\`\`\`bash
-npx moflo hooks pre-task --description "[task]"
-npx moflo hooks post-task --task-id "[id]" --success true
-npx moflo hooks worker dispatch --trigger audit
-\`\`\``;
-}
-function learningProtocol() {
-    return `## Auto-Learning Protocol
-
-### Before Starting Any Task
-\`\`\`bash
-npx moflo memory search --query "[task keywords]" --namespace patterns
-npx moflo memory search --query "[task keywords]" --namespace knowledge
-npx moflo hooks route --task "[task description]"
-\`\`\`
-
-### After Completing Any Task Successfully
-\`\`\`bash
-npx moflo memory store --namespace patterns --key "[pattern-name]" --value "[what worked]"
-npx moflo hooks post-task --task-id "[id]" --success true
-\`\`\`
-
-### When the User Asks You to Remember Something
-\`\`\`bash
-npx moflo memory store --namespace knowledge --key "[topic]" --value "[what to remember]"
-\`\`\`
-
-The \`knowledge\` namespace is for user-directed project knowledge — things like "always use soft delete",
-"don't use MUI DataGrid, use TableComponent", or "the billing service uses Stripe". These are searchable
-during the memory-first gate and persist across sessions.
-
-- ALWAYS check memory before starting new features, debugging, or refactoring
-- ALWAYS store user-directed knowledge in the \`knowledge\` namespace when asked to remember something
-- ALWAYS store code patterns in the \`patterns\` namespace after solving bugs or finding optimizations`;
-}
-function memoryCommands() {
-    return `## Memory Commands Reference
-
-\`\`\`bash
-# Store a code pattern
-npx moflo memory store --key "pattern-auth" --value "JWT with refresh" --namespace patterns
-
-# Store user-directed knowledge (remember for next time)
-npx moflo memory store --key "soft-delete" --value "Always use soft delete on entities" --namespace knowledge
-
-# Search (searches across all namespaces if --namespace omitted)
-npx moflo memory search --query "authentication patterns"
-
-# List entries in a namespace
-npx moflo memory list --namespace knowledge --limit 10
-
-# Retrieve a specific key
-npx moflo memory retrieve --key "pattern-auth" --namespace patterns
-\`\`\`
-
-### Namespaces
-| Namespace | Purpose | Populated by |
-|-----------|---------|-------------|
-| \`guidance\` | Doc chunks from .claude/guidance + docs/ | \`flo-index\` (session start) |
-| \`code-map\` | File/dir structure for navigation | \`flo-codemap\` (session start) |
-| \`patterns\` | Code patterns from repo analysis | \`hooks pretrain\` (session start) |
-| \`knowledge\` | User-directed project knowledge | User ("remember X for next time") |`;
-}
-function securityRulesLight() {
-    return `## Security Rules
-
-- NEVER hardcode API keys, secrets, or credentials in source files
-- NEVER commit .env files or any file containing secrets
-- Always validate user input at system boundaries
-- Always sanitize file paths to prevent directory traversal
-- Run \`npx moflo security scan\` after security-related changes`;
-}
-function buildAndTest() {
-    return `## Build & Test
-
-\`\`\`bash
-# Build
-npm run build
-
-# Test
-npm test
-
-# Lint
-npm run lint
-\`\`\`
-
-- ALWAYS run tests after making code changes
-- ALWAYS verify build succeeds before committing`;
-}
-function securitySection() {
-    return `## Security Protocol
-
-- NEVER hardcode API keys, secrets, or credentials in source files
-- NEVER commit .env files or any file containing secrets
-- Always validate all user input at system boundaries using Zod schemas
-- Always sanitize file paths to prevent directory traversal attacks
-- Always use parameterized queries — never concatenate SQL strings
-- Run security audit after any authentication or authorization changes
-
-### Security Scanning
-\`\`\`bash
-npx moflo security scan --depth full
-npx moflo security audit --report
-npx moflo security cve --check
+mcp__moflo__memory_search — query: "<task description>", namespace: "guidance" or "patterns" or "code-map"
 \`\`\`
 
-### Security Agents
-- \`security-architect\` — threat modeling, architecture review
-- \`security-auditor\` — code audit, vulnerability detection
-- Use agent routing code 9 (hierarchical/specialized) for security tasks`;
-}
-function performanceSection() {
-    return `## Performance Optimization Protocol
+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\`.
 
-- Always run benchmarks before and after performance changes
-- Always profile before optimizing — never guess at bottlenecks
-- Prefer algorithmic improvements over micro-optimizations
-- Keep HNSW search within 150x-12,500x faster target
-- Keep memory reduction within 50-75% target with quantization
+### Workflow Gates (enforced automatically)
 
-### Performance Tooling
-\`\`\`bash
-npx moflo performance benchmark --suite all
-npx moflo performance profile --target "[component]"
-npx moflo performance metrics --format table
-\`\`\`
+- **Memory-first**: Must search memory before Glob/Grep/Read
+- **TaskCreate-first**: Must call TaskCreate before spawning Agent tool
 
-### Performance Agents
-- \`performance-engineer\` — profiling, benchmarking, optimization
-- \`perf-analyzer\` — bottleneck detection, analysis
-- Use agent routing code 7 (hierarchical/specialized) for performance tasks`;
-}
-function intelligenceSystem() {
-    return `## Intelligence System (RuVector)
+### MCP Tools (preferred over CLI)
 
-- **SONA**: Self-Optimizing Neural Architecture (<0.05ms adaptation)
-- **HNSW**: 150x-12,500x faster pattern search
-- **EWC++**: Elastic Weight Consolidation (prevents forgetting)
-- **Flash Attention**: 2.49x-7.47x speedup
+| 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 |
 
-The 4-step intelligence pipeline:
-1. **RETRIEVE** - Fetch relevant patterns via HNSW
-2. **JUDGE** - Evaluate with verdicts (success/failure)
-3. **DISTILL** - Extract key learnings via LoRA
-4. **CONSOLIDATE** - Prevent catastrophic forgetting via EWC++`;
-}
-function envVars() {
-    return `## Environment Variables
+### CLI Fallback
 
 \`\`\`bash
-CLAUDE_FLOW_CONFIG=./claude-flow.config.json
-CLAUDE_FLOW_LOG_LEVEL=info
-ANTHROPIC_API_KEY=sk-ant-...
-CLAUDE_FLOW_MEMORY_BACKEND=hybrid
-CLAUDE_FLOW_MEMORY_PATH=./data/memory
-\`\`\``;
-}
-function setupAndBoundary() {
-    return `## Quick Setup
-
-\`\`\`bash
-claude mcp add claude-flow -- npx -y moflo
-npx moflo daemon start
-npx moflo doctor --fix
+npx flo-search "[query]" --namespace guidance   # Semantic search
+npx flo doctor --fix                             # Health check
 \`\`\`
 
-## Claude Code vs CLI Tools
-
-- Claude Code's Task tool handles ALL execution: agents, file ops, code generation, git
-- CLI tools handle coordination via Bash: swarm init, memory, hooks, routing
-- NEVER use CLI tools as a substitute for Task tool agents
-
-## Support
-
-- Documentation: https://github.com/eric-cielo/moflo
-- Issues: https://github.com/eric-cielo/moflo/issues`;
-}
-// --- Template Composers ---
-/**
- * Template section map — defines which sections are included per template.
- */
-const TEMPLATE_SECTIONS = {
-    minimal: [
-        behavioralRules,
-        fileOrganization,
-        projectArchitecture,
-        (_opts) => buildAndTest(),
-        (_opts) => securityRulesLight(),
-        concurrencyRules,
-        (_opts) => antiDriftConfig(),
-        executionRules,
-        (_opts) => cliCommandsTable(),
-        (_opts) => setupAndBoundary(),
-    ],
-    standard: [
-        behavioralRules,
-        fileOrganization,
-        projectArchitecture,
-        (_opts) => buildAndTest(),
-        (_opts) => securityRulesLight(),
-        concurrencyRules,
-        (_opts) => swarmOrchestration(),
-        (_opts) => antiDriftConfig(),
-        executionRules,
-        (_opts) => cliCommandsTable(),
-        (_opts) => agentTypes(),
-        (_opts) => memoryCommands(),
-        (_opts) => setupAndBoundary(),
-    ],
-    full: [
-        behavioralRules,
-        fileOrganization,
-        projectArchitecture,
-        (_opts) => buildAndTest(),
-        (_opts) => securityRulesLight(),
-        concurrencyRules,
-        (_opts) => swarmOrchestration(),
-        (_opts) => antiDriftConfig(),
-        (_opts) => autoStartProtocol(),
-        executionRules,
-        (_opts) => cliCommandsTable(),
-        (_opts) => agentTypes(),
-        (_opts) => hooksSystem(),
-        (_opts) => learningProtocol(),
-        (_opts) => memoryCommands(),
-        (_opts) => intelligenceSystem(),
-        (_opts) => envVars(),
-        (_opts) => setupAndBoundary(),
-    ],
-    security: [
-        behavioralRules,
-        fileOrganization,
-        projectArchitecture,
-        (_opts) => buildAndTest(),
-        concurrencyRules,
-        (_opts) => swarmOrchestration(),
-        (_opts) => antiDriftConfig(),
-        executionRules,
-        (_opts) => securitySection(),
-        (_opts) => cliCommandsTable(),
-        (_opts) => agentTypes(),
-        (_opts) => memoryCommands(),
-        (_opts) => setupAndBoundary(),
-    ],
-    performance: [
-        behavioralRules,
-        fileOrganization,
-        projectArchitecture,
-        (_opts) => buildAndTest(),
-        (_opts) => securityRulesLight(),
-        concurrencyRules,
-        (_opts) => swarmOrchestration(),
-        (_opts) => antiDriftConfig(),
-        executionRules,
-        (_opts) => performanceSection(),
-        (_opts) => cliCommandsTable(),
-        (_opts) => agentTypes(),
-        (_opts) => memoryCommands(),
-        (_opts) => intelligenceSystem(),
-        (_opts) => setupAndBoundary(),
-    ],
-    solo: [
-        behavioralRules,
-        fileOrganization,
-        projectArchitecture,
-        (_opts) => buildAndTest(),
-        (_opts) => securityRulesLight(),
-        concurrencyRules,
-        executionRules,
-        (_opts) => cliCommandsTable(),
-        (_opts) => memoryCommands(),
-        (_opts) => setupAndBoundary(),
-    ],
-};
-// --- Public API ---
-/**
- * Generate CLAUDE.md content based on init options and template.
- * Template is determined by: options.runtime.claudeMdTemplate > explicit param > 'standard'
- */
-export function generateClaudeMd(options, template) {
-    const tmpl = template ?? options.runtime.claudeMdTemplate ?? 'standard';
-    const sections = TEMPLATE_SECTIONS[tmpl] ?? TEMPLATE_SECTIONS.standard;
-    const header = `# Claude Code Configuration - MoFlo V4\n`;
-    const body = sections.map(fn => fn(options)).join('\n\n');
-    return `${header}\n${body}\n`;
-}
-/**
- * Generate minimal CLAUDE.md content (backward-compatible alias).
- */
-export function generateMinimalClaudeMd(options) {
-    return generateClaudeMd(options, 'minimal');
-}
-/** Available template names for CLI wizard */
-export const CLAUDE_MD_TEMPLATES = [
-    { name: 'minimal', description: 'Quick start — behavioral rules, anti-drift config, CLI reference (~120 lines)' },
-    { name: 'standard', description: 'Recommended — swarm orchestration, agents, memory commands (~250 lines)' },
-    { name: 'full', description: 'Everything — hooks, learning protocol, intelligence system (~400 lines)' },
-    { name: 'security', description: 'Security-focused — adds security scanning, audit protocols, CVE checks' },
-    { name: 'performance', description: 'Performance-focused — adds benchmarking, profiling, optimization protocols' },
-    { name: 'solo', description: 'Solo developer — no swarm, simple agent usage, memory commands (~150 lines)' },
-];
-export default generateClaudeMd;
+### Full Reference
+
+For CLI commands, hooks, agents, swarm config, memory commands, and moflo.yaml options, see:
+\`.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