claude-flow 3.27.4 → 3.29.0

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

@@ -7,276 +7,276 @@
  */
 // --- Section Generators ---
 function behavioralRules() {
-    return `## Rules
-
-- Do what has been asked; nothing more, nothing less
-- NEVER create files unless absolutely necessary — prefer editing existing files
-- NEVER create documentation files unless explicitly requested
-- NEVER save working files or tests to root — use \`/src\`, \`/tests\`, \`/docs\`, \`/config\`, \`/scripts\`
-- ALWAYS read a file before editing it
-- NEVER commit secrets, credentials, or .env files
-- NEVER add a \`Co-Authored-By\` trailer to user commits unless this project's \`.claude/settings.json\` has \`attribution.commit\` set (#2078). The Claude Code Bash tool may suggest one in its default commit-message template — ignore it. \`Co-Authored-By\` is semantic authorship attribution under git/GitHub convention; the tool is the facilitator, not a co-author.
-- Keep files under 500 lines
+    return `## Rules
+
+- Do what has been asked; nothing more, nothing less
+- NEVER create files unless absolutely necessary — prefer editing existing files
+- NEVER create documentation files unless explicitly requested
+- NEVER save working files or tests to root — use \`/src\`, \`/tests\`, \`/docs\`, \`/config\`, \`/scripts\`
+- ALWAYS read a file before editing it
+- NEVER commit secrets, credentials, or .env files
+- NEVER add a \`Co-Authored-By\` trailer to user commits unless this project's \`.claude/settings.json\` has \`attribution.commit\` set (#2078). The Claude Code Bash tool may suggest one in its default commit-message template — ignore it. \`Co-Authored-By\` is semantic authorship attribution under git/GitHub convention; the tool is the facilitator, not a co-author.
+- Keep files under 500 lines
 - Validate input at system boundaries`;
 }
 function agentComms() {
-    return `## Agent Comms (SendMessage-First Coordination)
-
-Named agents coordinate via \`SendMessage\`, not polling or shared state.
-
-\`\`\`
-Lead (you) ←→ architect ←→ developer ←→ tester ←→ reviewer
-              (named agents message each other directly)
-\`\`\`
-
-### Spawning a Coordinated Team
-
-\`\`\`javascript
-// ALL agents in ONE message, each knows WHO to message next
-Agent({ prompt: "Research the codebase. SendMessage findings to 'architect'.",
-  subagent_type: "researcher", name: "researcher", run_in_background: true })
-Agent({ prompt: "Wait for 'researcher'. Design solution. SendMessage to 'coder'.",
-  subagent_type: "system-architect", name: "architect", run_in_background: true })
-Agent({ prompt: "Wait for 'architect'. Implement it. SendMessage to 'tester'.",
-  subagent_type: "coder", name: "coder", run_in_background: true })
-Agent({ prompt: "Wait for 'coder'. Write tests. SendMessage results to 'reviewer'.",
-  subagent_type: "tester", name: "tester", run_in_background: true })
-Agent({ prompt: "Wait for 'tester'. Review code quality and security.",
-  subagent_type: "reviewer", name: "reviewer", run_in_background: true })
-
-// Kick off the pipeline
-SendMessage({ to: "researcher", summary: "Start", message: "[task context]" })
-\`\`\`
-
-### Patterns
-
-| Pattern | Flow | Use When |
-|---------|------|----------|
-| **Pipeline** | A → B → C → D | Sequential dependencies (feature dev) |
-| **Fan-out** | Lead → A, B, C → Lead | Independent parallel work (research) |
-| **Supervisor** | Lead ↔ workers | Ongoing coordination (complex refactor) |
-
-### Rules
-
-- ALWAYS name agents — \`name: "role"\` makes them addressable
-- ALWAYS include comms instructions in prompts — who to message, what to send
-- Spawn ALL agents in ONE message with \`run_in_background: true\`
-- After spawning: STOP, tell user what's running, wait for results
+    return `## Agent Comms (SendMessage-First Coordination)
+
+Named agents coordinate via \`SendMessage\`, not polling or shared state.
+
+\`\`\`
+Lead (you) ←→ architect ←→ developer ←→ tester ←→ reviewer
+              (named agents message each other directly)
+\`\`\`
+
+### Spawning a Coordinated Team
+
+\`\`\`javascript
+// ALL agents in ONE message, each knows WHO to message next
+Agent({ prompt: "Research the codebase. SendMessage findings to 'architect'.",
+  subagent_type: "researcher", name: "researcher", run_in_background: true })
+Agent({ prompt: "Wait for 'researcher'. Design solution. SendMessage to 'coder'.",
+  subagent_type: "system-architect", name: "architect", run_in_background: true })
+Agent({ prompt: "Wait for 'architect'. Implement it. SendMessage to 'tester'.",
+  subagent_type: "coder", name: "coder", run_in_background: true })
+Agent({ prompt: "Wait for 'coder'. Write tests. SendMessage results to 'reviewer'.",
+  subagent_type: "tester", name: "tester", run_in_background: true })
+Agent({ prompt: "Wait for 'tester'. Review code quality and security.",
+  subagent_type: "reviewer", name: "reviewer", run_in_background: true })
+
+// Kick off the pipeline
+SendMessage({ to: "researcher", summary: "Start", message: "[task context]" })
+\`\`\`
+
+### Patterns
+
+| Pattern | Flow | Use When |
+|---------|------|----------|
+| **Pipeline** | A → B → C → D | Sequential dependencies (feature dev) |
+| **Fan-out** | Lead → A, B, C → Lead | Independent parallel work (research) |
+| **Supervisor** | Lead ↔ workers | Ongoing coordination (complex refactor) |
+
+### Rules
+
+- ALWAYS name agents — \`name: "role"\` makes them addressable
+- ALWAYS include comms instructions in prompts — who to message, what to send
+- Spawn ALL agents in ONE message with \`run_in_background: true\`
+- After spawning: STOP, tell user what's running, wait for results
 - NEVER poll status — agents message back or complete automatically`;
 }
 function swarmConfig(options) {
-    return `## Swarm & Routing
-
-### Config
-- **Topology**: ${options.runtime.topology} (anti-drift)
-- **Max Agents**: ${options.runtime.maxAgents}
-- **Memory**: ${options.runtime.memoryBackend}
-- **HNSW**: ${options.runtime.enableHNSW ? 'Enabled' : 'Disabled'}
-- **Neural**: ${options.runtime.enableNeural ? 'Enabled' : 'Disabled'}
-
-\`\`\`bash
-npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 8 --strategy specialized
-\`\`\`
-
-### Agent Routing
-
-| Task | Agents | Topology |
-|------|--------|----------|
-| Bug Fix | researcher, coder, tester | hierarchical |
-| Feature | architect, coder, tester, reviewer | hierarchical |
-| Refactor | architect, coder, reviewer | hierarchical |
-| Performance | perf-engineer, coder | hierarchical |
-| Security | security-architect, auditor | hierarchical |
-
-### When to Swarm
-- **YES**: 3+ files, new features, cross-module refactoring, API changes, security, performance
-- **NO**: single file edits, 1-2 line fixes, docs updates, config changes, questions
-
-### 3-Tier Model Routing
-
-| Tier | Handler | Use Cases |
-|------|---------|-----------|
-| 1 | Agent Booster (WASM) | Simple transforms — skip LLM, use Edit directly |
-| 2 | Haiku | Simple tasks, low complexity |
+    return `## Swarm & Routing
+
+### Config
+- **Topology**: ${options.runtime.topology} (anti-drift)
+- **Max Agents**: ${options.runtime.maxAgents}
+- **Memory**: ${options.runtime.memoryBackend}
+- **HNSW**: ${options.runtime.enableHNSW ? 'Enabled' : 'Disabled'}
+- **Neural**: ${options.runtime.enableNeural ? 'Enabled' : 'Disabled'}
+
+\`\`\`bash
+npx @claude-flow/cli@latest swarm init --topology hierarchical --max-agents 8 --strategy specialized
+\`\`\`
+
+### Agent Routing
+
+| Task | Agents | Topology |
+|------|--------|----------|
+| Bug Fix | researcher, coder, tester | hierarchical |
+| Feature | architect, coder, tester, reviewer | hierarchical |
+| Refactor | architect, coder, reviewer | hierarchical |
+| Performance | perf-engineer, coder | hierarchical |
+| Security | security-architect, auditor | hierarchical |
+
+### When to Swarm
+- **YES**: 3+ files, new features, cross-module refactoring, API changes, security, performance
+- **NO**: single file edits, 1-2 line fixes, docs updates, config changes, questions
+
+### 3-Tier Model Routing
+
+| Tier | Handler | Use Cases |
+|------|---------|-----------|
+| 1 | Agent Booster (WASM) | Simple transforms — skip LLM, use Edit directly |
+| 2 | Haiku | Simple tasks, low complexity |
 | 3 | Sonnet/Opus | Architecture, security, complex reasoning |`;
 }
 function memoryAndLearning() {
-    return `## Memory & Learning
-
-### Before Any Task
-\`\`\`bash
-npx @claude-flow/cli@latest memory search --query "[task keywords]" --namespace patterns
-npx @claude-flow/cli@latest hooks route --task "[task description]"
-\`\`\`
-
-### After Success
-\`\`\`bash
-npx @claude-flow/cli@latest memory store --namespace patterns --key "[name]" --value "[what worked]"
-npx @claude-flow/cli@latest hooks post-task --task-id "[id]" --success true --store-results true
-\`\`\`
-
-### MCP Tools (use \`ToolSearch("keyword")\` to discover)
-
-| Category | Key Tools |
-|----------|-----------|
-| **Memory** | \`memory_store\`, \`memory_search\`, \`memory_search_unified\` |
-| **Bridge** | \`memory_import_claude\`, \`memory_bridge_status\` |
-| **Swarm** | \`swarm_init\`, \`swarm_status\`, \`swarm_health\` |
-| **Agents** | \`agent_spawn\`, \`agent_list\`, \`agent_status\` |
-| **Hooks** | \`hooks_route\`, \`hooks_post-task\`, \`hooks_worker-dispatch\` |
-| **Security** | \`aidefence_scan\`, \`aidefence_is_safe\`, \`aidefence_has_pii\` |
-| **Hive-Mind** | \`hive-mind_init\`, \`hive-mind_consensus\`, \`hive-mind_spawn\` |
-
-### Background Workers
-
-| Worker | When |
-|--------|------|
-| \`audit\` | After security changes |
-| \`optimize\` | After performance work |
-| \`testgaps\` | After adding features |
-| \`map\` | Every 5+ file changes |
-| \`document\` | After API changes |
-
-\`\`\`bash
-npx @claude-flow/cli@latest hooks worker dispatch --trigger audit
+    return `## Memory & Learning
+
+### Before Any Task
+\`\`\`bash
+npx @claude-flow/cli@latest memory search --query "[task keywords]" --namespace patterns
+npx @claude-flow/cli@latest hooks route --task "[task description]"
+\`\`\`
+
+### After Success
+\`\`\`bash
+npx @claude-flow/cli@latest memory store --namespace patterns --key "[name]" --value "[what worked]"
+npx @claude-flow/cli@latest hooks post-task --task-id "[id]" --success true --store-results true
+\`\`\`
+
+### MCP Tools (use \`ToolSearch("keyword")\` to discover)
+
+| Category | Key Tools |
+|----------|-----------|
+| **Memory** | \`memory_store\`, \`memory_search\`, \`memory_search_unified\` |
+| **Bridge** | \`memory_import_claude\`, \`memory_bridge_status\` |
+| **Swarm** | \`swarm_init\`, \`swarm_status\`, \`swarm_health\` |
+| **Agents** | \`agent_spawn\`, \`agent_list\`, \`agent_status\` |
+| **Hooks** | \`hooks_route\`, \`hooks_post-task\`, \`hooks_worker-dispatch\` |
+| **Security** | \`aidefence_scan\`, \`aidefence_is_safe\`, \`aidefence_has_pii\` |
+| **Hive-Mind** | \`hive-mind_init\`, \`hive-mind_consensus\`, \`hive-mind_spawn\` |
+
+### Background Workers
+
+| Worker | When |
+|--------|------|
+| \`audit\` | After security changes |
+| \`optimize\` | After performance work |
+| \`testgaps\` | After adding features |
+| \`map\` | Every 5+ file changes |
+| \`document\` | After API changes |
+
+\`\`\`bash
+npx @claude-flow/cli@latest hooks worker dispatch --trigger audit
 \`\`\``;
 }
 function agentTypes() {
-    return `## Agents
-
-**Core**: \`coder\`, \`reviewer\`, \`tester\`, \`planner\`, \`researcher\`
-**Architecture**: \`system-architect\`, \`backend-dev\`, \`mobile-dev\`
-**Security**: \`security-architect\`, \`security-auditor\`
-**Performance**: \`performance-engineer\`, \`perf-analyzer\`
-**Coordination**: \`hierarchical-coordinator\`, \`mesh-coordinator\`, \`adaptive-coordinator\`
-**GitHub**: \`pr-manager\`, \`code-review-swarm\`, \`issue-tracker\`, \`release-manager\`
-
+    return `## Agents
+
+**Core**: \`coder\`, \`reviewer\`, \`tester\`, \`planner\`, \`researcher\`
+**Architecture**: \`system-architect\`, \`backend-dev\`, \`mobile-dev\`
+**Security**: \`security-architect\`, \`security-auditor\`
+**Performance**: \`performance-engineer\`, \`perf-analyzer\`
+**Coordination**: \`hierarchical-coordinator\`, \`mesh-coordinator\`, \`adaptive-coordinator\`
+**GitHub**: \`pr-manager\`, \`code-review-swarm\`, \`issue-tracker\`, \`release-manager\`
+
 Any string works as a custom agent type.`;
 }
 function cliQuickRef() {
-    return `## CLI Quick Reference
-
-\`\`\`bash
-npx @claude-flow/cli@latest init --wizard           # Setup
-npx @claude-flow/cli@latest swarm init --v3-mode     # Start swarm
-npx @claude-flow/cli@latest memory search --query "" # Vector search
-npx @claude-flow/cli@latest hooks route --task ""    # Route to agent
-npx @claude-flow/cli@latest doctor --fix             # Diagnostics
-npx @claude-flow/cli@latest security scan            # Security scan
-npx @claude-flow/cli@latest performance benchmark    # Benchmarks
-\`\`\`
-
+    return `## CLI Quick Reference
+
+\`\`\`bash
+npx @claude-flow/cli@latest init --wizard           # Setup
+npx @claude-flow/cli@latest swarm init --v3-mode     # Start swarm
+npx @claude-flow/cli@latest memory search --query "" # Vector search
+npx @claude-flow/cli@latest hooks route --task ""    # Route to agent
+npx @claude-flow/cli@latest doctor --fix             # Diagnostics
+npx @claude-flow/cli@latest security scan            # Security scan
+npx @claude-flow/cli@latest performance benchmark    # Benchmarks
+\`\`\`
+
 26 commands, 140+ subcommands. Use \`--help\` on any command for details.`;
 }
 function setupAndBoundary() {
-    return `## Setup
-
-\`\`\`bash
-claude mcp add claude-flow -- npx -y ruflo@latest mcp start
-npx ruflo@latest doctor --fix
-\`\`\`
-
-> The background \`daemon\` is optional. It runs interval workers that each spawn
-> a headless \`claude\` session, so it consumes tokens continuously. Start it only
-> if you want those sweeps: \`npx ruflo@latest daemon start\` (self-stops after 12h
-> by default; \`--ttl 0\` to disable, \`daemon status --all\` to audit running daemons).
-
+    return `## Setup
+
+\`\`\`bash
+claude mcp add claude-flow -- npx -y ruflo@latest mcp start
+npx ruflo@latest doctor --fix
+\`\`\`
+
+> The background \`daemon\` is optional. It runs interval workers that each spawn
+> a headless \`claude\` session, so it consumes tokens continuously. Start it only
+> if you want those sweeps: \`npx ruflo@latest daemon start\` (self-stops after 12h
+> by default; \`--ttl 0\` to disable, \`daemon status --all\` to audit running daemons).
+
 **Agent tool** handles execution (agents, files, code, git). **MCP tools** handle coordination (swarm, memory, hooks). **CLI** is the same via Bash.`;
 }
 function buildAndTest() {
-    return `## Build & Test
-
-- ALWAYS run tests after code changes
-- ALWAYS verify build succeeds before committing
-
-\`\`\`bash
-npm run build && npm test
+    return `## Build & Test
+
+- ALWAYS run tests after code changes
+- ALWAYS verify build succeeds before committing
+
+\`\`\`bash
+npm run build && npm test
 \`\`\``;
 }
 function securitySection() {
-    return `## Security
-
-- NEVER hardcode secrets in source — use environment variables
-- Always validate input at boundaries (Zod schemas)
-- Always sanitize file paths (prevent traversal)
-- Always use parameterized queries (prevent injection)
-
-\`\`\`bash
-npx @claude-flow/cli@latest security scan --depth full
-npx @claude-flow/cli@latest security audit --report
-\`\`\`
-
+    return `## Security
+
+- NEVER hardcode secrets in source — use environment variables
+- Always validate input at boundaries (Zod schemas)
+- Always sanitize file paths (prevent traversal)
+- Always use parameterized queries (prevent injection)
+
+\`\`\`bash
+npx @claude-flow/cli@latest security scan --depth full
+npx @claude-flow/cli@latest security audit --report
+\`\`\`
+
 Agents: \`security-architect\` (threat modeling), \`security-auditor\` (vulnerability detection)`;
 }
 function performanceSection() {
-    return `## Performance
-
-- Always benchmark before AND after optimization
-- Always profile before optimizing — never guess bottlenecks
-- Use HNSW/DiskANN for vector search, Int8 quantization for memory reduction
-
-\`\`\`bash
-npx @claude-flow/cli@latest performance benchmark --suite all
-npx @claude-flow/cli@latest performance profile --target "[component]"
-\`\`\`
-
+    return `## Performance
+
+- Always benchmark before AND after optimization
+- Always profile before optimizing — never guess bottlenecks
+- Use HNSW/DiskANN for vector search, Int8 quantization for memory reduction
+
+\`\`\`bash
+npx @claude-flow/cli@latest performance benchmark --suite all
+npx @claude-flow/cli@latest performance profile --target "[component]"
+\`\`\`
+
 Agents: \`performance-engineer\` (profiling), \`perf-analyzer\` (bottleneck detection)`;
 }
 function hooksRef() {
-    return `## Hooks
-
-| Hook | Purpose |
-|------|---------|
-| \`pre-task\` / \`post-task\` | Task lifecycle + learning |
-| \`pre-edit\` / \`post-edit\` | File editing + neural training |
-| \`session-start\` / \`session-end\` | Session persistence |
-| \`route\` | Route to optimal agent |
-| \`intelligence\` | Pattern learning (SONA) |
-| \`worker\` | Background worker dispatch |
-
-\`\`\`bash
-npx @claude-flow/cli@latest hooks pre-task --description "[task]"
-npx @claude-flow/cli@latest hooks post-task --task-id "[id]" --success true
-npx @claude-flow/cli@latest hooks session-start --session-id "[id]"
-npx @claude-flow/cli@latest hooks route --task "[task]"
-npx @claude-flow/cli@latest hooks worker dispatch --trigger audit
+    return `## Hooks
+
+| Hook | Purpose |
+|------|---------|
+| \`pre-task\` / \`post-task\` | Task lifecycle + learning |
+| \`pre-edit\` / \`post-edit\` | File editing + neural training |
+| \`session-start\` / \`session-end\` | Session persistence |
+| \`route\` | Route to optimal agent |
+| \`intelligence\` | Pattern learning (SONA) |
+| \`worker\` | Background worker dispatch |
+
+\`\`\`bash
+npx @claude-flow/cli@latest hooks pre-task --description "[task]"
+npx @claude-flow/cli@latest hooks post-task --task-id "[id]" --success true
+npx @claude-flow/cli@latest hooks session-start --session-id "[id]"
+npx @claude-flow/cli@latest hooks route --task "[task]"
+npx @claude-flow/cli@latest hooks worker dispatch --trigger audit
 \`\`\``;
 }
 function intelligenceSystem() {
-    return `## Intelligence (SONA + HNSW)
-
-Pipeline: **RETRIEVE** (vector search) → **JUDGE** (success/failure) → **DISTILL** (extract patterns) → **CONSOLIDATE** (persist)
-
-- **ONNX Embeddings**: all-MiniLM-L6-v2, 384-dim
-- **HNSW/DiskANN**: 150x-12,500x faster search
-- **SONA**: Sub-millisecond pattern adaptation
+    return `## Intelligence (SONA + HNSW)
+
+Pipeline: **RETRIEVE** (vector search) → **JUDGE** (success/failure) → **DISTILL** (extract patterns) → **CONSOLIDATE** (persist)
+
+- **ONNX Embeddings**: all-MiniLM-L6-v2, 384-dim
+- **HNSW/DiskANN**: 150x-12,500x faster search
+- **SONA**: Sub-millisecond pattern adaptation
 - **Claude Bridge**: Auto-imports \`~/.claude/projects/*/memory/*.md\` into AgentDB`;
 }
 function federationRef() {
-    return `## Federation
-
-Cross-installation agent collaboration with zero-trust security.
-
-\`\`\`bash
-npx @claude-flow/cli@latest federation init
-npx @claude-flow/cli@latest federation join wss://peer:8443
-npx @claude-flow/cli@latest federation send --to peer --type task-request --message "..."
-npx @claude-flow/cli@latest federation status
-\`\`\`
-
-- 5-tier trust: UNTRUSTED → VERIFIED → ATTESTED → TRUSTED → PRIVILEGED
-- PII pipeline: 14 types auto-stripped before data leaves your node
-- mTLS + ed25519 handshake, HMAC-signed envelopes
+    return `## Federation
+
+Cross-installation agent collaboration with zero-trust security.
+
+\`\`\`bash
+npx @claude-flow/cli@latest federation init
+npx @claude-flow/cli@latest federation join wss://peer:8443
+npx @claude-flow/cli@latest federation send --to peer --type task-request --message "..."
+npx @claude-flow/cli@latest federation status
+\`\`\`
+
+- 5-tier trust: UNTRUSTED → VERIFIED → ATTESTED → TRUSTED → PRIVILEGED
+- PII pipeline: 14 types auto-stripped before data leaves your node
+- mTLS + ed25519 handshake, HMAC-signed envelopes
 - Compliance: HIPAA, SOC2, GDPR audit modes`;
 }
 function envVars() {
-    return `## Environment
-
-\`\`\`bash
-CLAUDE_FLOW_CONFIG=./claude-flow.config.json
-CLAUDE_FLOW_LOG_LEVEL=info
-CLAUDE_FLOW_MEMORY_BACKEND=hybrid
-CLAUDE_FLOW_MEMORY_PATH=./data/memory
+    return `## Environment
+
+\`\`\`bash
+CLAUDE_FLOW_CONFIG=./claude-flow.config.json
+CLAUDE_FLOW_LOG_LEVEL=info
+CLAUDE_FLOW_MEMORY_BACKEND=hybrid
+CLAUDE_FLOW_MEMORY_PATH=./data/memory
 \`\`\``;
 }
 // --- Template Composers ---