claude-flow 2.7.3 → 2.7.5

package/CHANGELOG.md

@@ -5,6 +5,51 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.7.5] - 2025-10-24
+
+> **🐛 Critical Bug Fix**: MCP Server Stdio Mode - Fixed stdout corruption in stdio mode
+
+### 🐛 Bug Fixes
+
+#### **MCP Server Stdio Mode Protocol Corruption (Critical)** - Issue #835
+- **Fixed stdout pollution in stdio mode**: MCP server now maintains clean stdout for JSON-RPC protocol
+  - Added module-level `isStdioMode` flag for state tracking
+  - Implemented smart logging helpers that auto-route output based on mode
+  - In stdio mode: all messages route to stderr (keeps stdout clean for JSON-RPC)
+  - In HTTP mode: normal stdout behavior preserved
+
+- **Comprehensive output replacement**: Replaced all 150+ console.log() and print*() calls
+  - `startMcpServer()` - All startup messages use smart helpers
+  - `stopMcpServer()` - All shutdown messages use smart helpers
+  - `listMcpTools()` - All tool listing uses smart helpers
+  - `manageMcpAuth()` - All auth messages use smart helpers
+  - `showMcpConfig()` - All config display uses smart helpers
+  - `showMcpHelp()` - All help text uses smart helpers
+  - `showMcpStatus()` - All status messages use smart helpers
+
+### 📁 Files Changed
+- `src/cli/simple-commands/mcp.js` - Complete rewrite of logging system
+- `tests/test-mcp-stdio.js` - Added verification test suite
+
+### 🧪 Testing
+- ✅ Test 1: Module structure verification
+- ✅ Test 2: Smart logging helpers present
+- ✅ Test 3: No direct stdout usage in critical functions
+- ✅ Build: Compilation successful
+
+### 📊 Impact
+- **Before**: ⚠️ MCP server unusable in stdio mode due to protocol corruption
+- **After**: ✅ MCP server fully compatible with standard MCP clients in stdio mode
+
+### ✅ Backward Compatibility
+- Fully backward compatible - no breaking changes
+- HTTP mode retains original stdout behavior
+- Only affects stdio mode output routing
+
+### 🔗 Related
+- Fixes #835 - MCP server stdio mode corrupted by stdout log messages
+- Bug existed since July 8, 2025 (commit 29800626c, PR #167)
+
 ## [2.7.1] - 2025-10-22
 
 > **🐛 Critical Bug Fix**: MCP Pattern Persistence - Fixed neural pattern storage, search, and statistics

package/bin/claude-flow

@@ -1,7 +1,7 @@
 #!/bin/sh
 # Claude-Flow Smart Dispatcher - Detects and uses the best available runtime
 
-VERSION="2.7.3"
+VERSION="2.7.5"
 
 # Determine the correct path based on how the script is invoked
 if [ -L "$0" ]; then

package/dist/src/cli/help-formatter.js

@@ -24,9 +24,6 @@ export class HelpFormatter {
         if (info.examples && info.examples.length > 0) {
             sections.push(this.formatSection('EXAMPLES', info.examples));
         }
-        if (info.details) {
-            sections.push('\n' + info.details);
-        }
         if (info.commands && info.commands.length > 0) {
             sections.push(`Run '${info.name} <command> --help' for more information on a command.`);
         }

package/dist/src/cli/help-formatter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/cli/help-formatter.js"],"sourcesContent":["/**\n * Standardized CLI Help Formatter\n * Follows Unix/Linux conventions for help output\n */\n\nexport class HelpFormatter {\n  static INDENT = '    ';\n  static COLUMN_GAP = 2;\n  static MIN_DESCRIPTION_COLUMN = 25;\n\n  /**\n   * Format main command help\n   */\n  static formatHelp(info) {\n    const sections = [];\n\n    // NAME section\n    sections.push(this.formatSection('NAME', [`${info.name} - ${info.description}`]));\n\n    // SYNOPSIS section\n    if (info.usage) {\n      sections.push(this.formatSection('SYNOPSIS', [info.usage]));\n    }\n\n    // COMMANDS section\n    if (info.commands && info.commands.length > 0) {\n      sections.push(this.formatSection('COMMANDS', this.formatCommands(info.commands)));\n    }\n\n    // OPTIONS section\n    if (info.options && info.options.length > 0) {\n      sections.push(this.formatSection('OPTIONS', this.formatOptions(info.options)));\n    }\n\n    // GLOBAL OPTIONS section\n    if (info.globalOptions && info.globalOptions.length > 0) {\n      sections.push(this.formatSection('GLOBAL OPTIONS', this.formatOptions(info.globalOptions)));\n    }\n\n    // EXAMPLES section\n    if (info.examples && info.examples.length > 0) {\n      sections.push(this.formatSection('EXAMPLES', info.examples));\n    }\n\n    // DETAILS section (additional information)\n    if (info.details) {\n      sections.push('\\n' + info.details);\n    }\n\n    // Footer\n    if (info.commands && info.commands.length > 0) {\n      sections.push(`Run '${info.name} <command> --help' for more information on a command.`);\n    }\n\n    return sections.join('\\n\\n');\n  }\n\n  /**\n   * Format error message with usage hint\n   */\n  static formatError(error, command, usage) {\n    const lines = [`Error: ${error}`, ''];\n\n    if (usage) {\n      lines.push(`Usage: ${usage}`);\n    }\n\n    lines.push(`Try '${command} --help' for more information.`);\n\n    return lines.join('\\n');\n  }\n\n  /**\n   * Format validation error with valid options\n   */\n  static formatValidationError(value, paramName, validOptions, command) {\n    return this.formatError(\n      `'${value}' is not a valid ${paramName}. Valid options are: ${validOptions.join(', ')}.`,\n      command,\n    );\n  }\n\n  static formatSection(title, content) {\n    return `${title}\\n${content.map((line) => `${this.INDENT}${line}`).join('\\n')}`;\n  }\n\n  static formatCommands(commands) {\n    const maxNameLength = Math.max(\n      this.MIN_DESCRIPTION_COLUMN,\n      ...commands.map((cmd) => {\n        const nameLength = cmd.name.length;\n        const aliasLength = cmd.aliases ? ` (${cmd.aliases.join(', ')})`.length : 0;\n        return nameLength + aliasLength;\n      }),\n    );\n\n    return commands.map((cmd) => {\n      let name = cmd.name;\n      if (cmd.aliases && cmd.aliases.length > 0) {\n        name += ` (${cmd.aliases.join(', ')})`;\n      }\n      const padding = ' '.repeat(maxNameLength - name.length + this.COLUMN_GAP);\n      return `${name}${padding}${cmd.description}`;\n    });\n  }\n\n  static formatOptions(options) {\n    const maxFlagsLength = Math.max(\n      this.MIN_DESCRIPTION_COLUMN,\n      ...options.map((opt) => opt.flags.length),\n    );\n\n    return options.map((opt) => {\n      const padding = ' '.repeat(maxFlagsLength - opt.flags.length + this.COLUMN_GAP);\n      let description = opt.description;\n\n      // Add default value\n      if (opt.defaultValue !== undefined) {\n        description += ` [default: ${opt.defaultValue}]`;\n      }\n\n      // Add valid values on next line if present\n      if (opt.validValues && opt.validValues.length > 0) {\n        const validValuesLine =\n          ' '.repeat(maxFlagsLength + this.COLUMN_GAP) + `Valid: ${opt.validValues.join(', ')}`;\n        return `${opt.flags}${padding}${description}\\n${this.INDENT}${validValuesLine}`;\n      }\n\n      return `${opt.flags}${padding}${description}`;\n    });\n  }\n\n  /**\n   * Strip ANSI color codes and emojis from text\n   */\n  static stripFormatting(text) {\n    // Remove ANSI color codes\n    text = text.replace(/\\x1b\\[[0-9;]*m/g, '');\n\n    // Remove common emojis used in the CLI\n    const emojiPattern =\n      /[\\u{1F300}-\\u{1F9FF}]|[\\u{2600}-\\u{27BF}]|[\\u{1F000}-\\u{1F6FF}]|[\\u{1F680}-\\u{1F6FF}]/gu;\n    text = text.replace(emojiPattern, '').trim();\n\n    // Remove multiple spaces\n    text = text.replace(/\\s+/g, ' ');\n\n    return text;\n  }\n}\n"],"names":["HelpFormatter","INDENT","COLUMN_GAP","MIN_DESCRIPTION_COLUMN","formatHelp","info","sections","push","formatSection","name","description","usage","commands","length","formatCommands","options","formatOptions","globalOptions","examples","details","join","formatError","error","command","lines","formatValidationError","value","paramName","validOptions","title","content","map","line","maxNameLength","Math","max","cmd","nameLength","aliasLength","aliases","padding","repeat","maxFlagsLength","opt","flags","defaultValue","undefined","validValues","validValuesLine","stripFormatting","text","replace","emojiPattern","trim"],"mappings":"AAKA,OAAO,MAAMA;IACX,OAAOC,SAAS,OAAO;IACvB,OAAOC,aAAa,EAAE;IACtB,OAAOC,yBAAyB,GAAG;IAKnC,OAAOC,WAAWC,IAAI,EAAE;QACtB,MAAMC,WAAW,EAAE;QAGnBA,SAASC,IAAI,CAAC,IAAI,CAACC,aAAa,CAAC,QAAQ;YAAC,GAAGH,KAAKI,IAAI,CAAC,GAAG,EAAEJ,KAAKK,WAAW,EAAE;SAAC;QAG/E,IAAIL,KAAKM,KAAK,EAAE;YACdL,SAASC,IAAI,CAAC,IAAI,CAACC,aAAa,CAAC,YAAY;gBAACH,KAAKM,KAAK;aAAC;QAC3D;QAGA,IAAIN,KAAKO,QAAQ,IAAIP,KAAKO,QAAQ,CAACC,MAAM,GAAG,GAAG;YAC7CP,SAASC,IAAI,CAAC,IAAI,CAACC,aAAa,CAAC,YAAY,IAAI,CAACM,cAAc,CAACT,KAAKO,QAAQ;QAChF;QAGA,IAAIP,KAAKU,OAAO,IAAIV,KAAKU,OAAO,CAACF,MAAM,GAAG,GAAG;YAC3CP,SAASC,IAAI,CAAC,IAAI,CAACC,aAAa,CAAC,WAAW,IAAI,CAACQ,aAAa,CAACX,KAAKU,OAAO;QAC7E;QAGA,IAAIV,KAAKY,aAAa,IAAIZ,KAAKY,aAAa,CAACJ,MAAM,GAAG,GAAG;YACvDP,SAASC,IAAI,CAAC,IAAI,CAACC,aAAa,CAAC,kBAAkB,IAAI,CAACQ,aAAa,CAACX,KAAKY,aAAa;QAC1F;QAGA,IAAIZ,KAAKa,QAAQ,IAAIb,KAAKa,QAAQ,CAACL,MAAM,GAAG,GAAG;YAC7CP,SAASC,IAAI,CAAC,IAAI,CAACC,aAAa,CAAC,YAAYH,KAAKa,QAAQ;QAC5D;QAGA,IAAIb,KAAKc,OAAO,EAAE;YAChBb,SAASC,IAAI,CAAC,OAAOF,KAAKc,OAAO;QACnC;QAGA,IAAId,KAAKO,QAAQ,IAAIP,KAAKO,QAAQ,CAACC,MAAM,GAAG,GAAG;YAC7CP,SAASC,IAAI,CAAC,CAAC,KAAK,EAAEF,KAAKI,IAAI,CAAC,qDAAqD,CAAC;QACxF;QAEA,OAAOH,SAASc,IAAI,CAAC;IACvB;IAKA,OAAOC,YAAYC,KAAK,EAAEC,OAAO,EAAEZ,KAAK,EAAE;QACxC,MAAMa,QAAQ;YAAC,CAAC,OAAO,EAAEF,OAAO;YAAE;SAAG;QAErC,IAAIX,OAAO;YACTa,MAAMjB,IAAI,CAAC,CAAC,OAAO,EAAEI,OAAO;QAC9B;QAEAa,MAAMjB,IAAI,CAAC,CAAC,KAAK,EAAEgB,QAAQ,8BAA8B,CAAC;QAE1D,OAAOC,MAAMJ,IAAI,CAAC;IACpB;IAKA,OAAOK,sBAAsBC,KAAK,EAAEC,SAAS,EAAEC,YAAY,EAAEL,OAAO,EAAE;QACpE,OAAO,IAAI,CAACF,WAAW,CACrB,CAAC,CAAC,EAAEK,MAAM,iBAAiB,EAAEC,UAAU,qBAAqB,EAAEC,aAAaR,IAAI,CAAC,MAAM,CAAC,CAAC,EACxFG;IAEJ;IAEA,OAAOf,cAAcqB,KAAK,EAAEC,OAAO,EAAE;QACnC,OAAO,GAAGD,MAAM,EAAE,EAAEC,QAAQC,GAAG,CAAC,CAACC,OAAS,GAAG,IAAI,CAAC/B,MAAM,GAAG+B,MAAM,EAAEZ,IAAI,CAAC,OAAO;IACjF;IAEA,OAAON,eAAeF,QAAQ,EAAE;QAC9B,MAAMqB,gBAAgBC,KAAKC,GAAG,CAC5B,IAAI,CAAChC,sBAAsB,KACxBS,SAASmB,GAAG,CAAC,CAACK;YACf,MAAMC,aAAaD,IAAI3B,IAAI,CAACI,MAAM;YAClC,MAAMyB,cAAcF,IAAIG,OAAO,GAAG,CAAC,EAAE,EAAEH,IAAIG,OAAO,CAACnB,IAAI,CAAC,MAAM,CAAC,CAAC,CAACP,MAAM,GAAG;YAC1E,OAAOwB,aAAaC;QACtB;QAGF,OAAO1B,SAASmB,GAAG,CAAC,CAACK;YACnB,IAAI3B,OAAO2B,IAAI3B,IAAI;YACnB,IAAI2B,IAAIG,OAAO,IAAIH,IAAIG,OAAO,CAAC1B,MAAM,GAAG,GAAG;gBACzCJ,QAAQ,CAAC,EAAE,EAAE2B,IAAIG,OAAO,CAACnB,IAAI,CAAC,MAAM,CAAC,CAAC;YACxC;YACA,MAAMoB,UAAU,IAAIC,MAAM,CAACR,gBAAgBxB,KAAKI,MAAM,GAAG,IAAI,CAACX,UAAU;YACxE,OAAO,GAAGO,OAAO+B,UAAUJ,IAAI1B,WAAW,EAAE;QAC9C;IACF;IAEA,OAAOM,cAAcD,OAAO,EAAE;QAC5B,MAAM2B,iBAAiBR,KAAKC,GAAG,CAC7B,IAAI,CAAChC,sBAAsB,KACxBY,QAAQgB,GAAG,CAAC,CAACY,MAAQA,IAAIC,KAAK,CAAC/B,MAAM;QAG1C,OAAOE,QAAQgB,GAAG,CAAC,CAACY;YAClB,MAAMH,UAAU,IAAIC,MAAM,CAACC,iBAAiBC,IAAIC,KAAK,CAAC/B,MAAM,GAAG,IAAI,CAACX,UAAU;YAC9E,IAAIQ,cAAciC,IAAIjC,WAAW;YAGjC,IAAIiC,IAAIE,YAAY,KAAKC,WAAW;gBAClCpC,eAAe,CAAC,WAAW,EAAEiC,IAAIE,YAAY,CAAC,CAAC,CAAC;YAClD;YAGA,IAAIF,IAAII,WAAW,IAAIJ,IAAII,WAAW,CAAClC,MAAM,GAAG,GAAG;gBACjD,MAAMmC,kBACJ,IAAIP,MAAM,CAACC,iBAAiB,IAAI,CAACxC,UAAU,IAAI,CAAC,OAAO,EAAEyC,IAAII,WAAW,CAAC3B,IAAI,CAAC,OAAO;gBACvF,OAAO,GAAGuB,IAAIC,KAAK,GAAGJ,UAAU9B,YAAY,EAAE,EAAE,IAAI,CAACT,MAAM,GAAG+C,iBAAiB;YACjF;YAEA,OAAO,GAAGL,IAAIC,KAAK,GAAGJ,UAAU9B,aAAa;QAC/C;IACF;IAKA,OAAOuC,gBAAgBC,IAAI,EAAE;QAE3BA,OAAOA,KAAKC,OAAO,CAAC,mBAAmB;QAGvC,MAAMC,eACJ;QACFF,OAAOA,KAAKC,OAAO,CAACC,cAAc,IAAIC,IAAI;QAG1CH,OAAOA,KAAKC,OAAO,CAAC,QAAQ;QAE5B,OAAOD;IACT;AACF"}AEgC,IAAIE,YAAY,CAAC,CAAC,CAAC;YAClD;YAGA,IAAIF,IAAII,WAAW,IAAIJ,IAAII,WAAW,CAACjC,MAAM,GAAG,GAAG;gBACjD,MAAMkC,kBACJ,IAAIP,MAAM,CAACC,iBAAiB,IAAI,CAACvC,UAAU,IAAI,CAAC,OAAO,EAAEwC,IAAII,WAAW,CAAC3B,IAAI,CAAC,OAAO;gBACvF,OAAO,GAAGuB,IAAIC,KAAK,GAAGJ,UAAU7B,YAAY,EAAE,EAAE,IAAI,CAACT,MAAM,GAAG8C,iBAAiB;YACjF;YAEA,OAAO,GAAGL,IAAIC,KAAK,GAAGJ,UAAU7B,aAAa;QAC/C;IACF;IAKA,OAAOsC,gBAAgBC,IAAY,EAAU;QAE3CA,OAAOA,KAAKC,OAAO,CAAC,mBAAmB;QAGvC,MAAMC,eACJ;QACFF,OAAOA,KAAKC,OAAO,CAACC,cAAc,IAAIC,IAAI;QAG1CH,OAAOA,KAAKC,OAAO,CAAC,QAAQ;QAE5B,OAAOD;IACT;AACF"}
+{"version":3,"sources":["../../../src/cli/help-formatter.ts"],"sourcesContent":["/**\n * Standardized CLI Help Formatter\n * Follows Unix/Linux conventions for help output\n */\n\nexport interface CommandInfo {\n  name: string;\n  description: string;\n  usage?: string;\n  commands?: CommandItem[];\n  options?: OptionItem[];\n  examples?: string[];\n  globalOptions?: OptionItem[];\n}\n\nexport interface CommandItem {\n  name: string;\n  description: string;\n  aliases?: string[];\n}\n\nexport interface OptionItem {\n  flags: string;\n  description: string;\n  defaultValue?: string;\n  validValues?: string[];\n}\n\nexport class HelpFormatter {\n  private static readonly INDENT = '    ';\n  private static readonly COLUMN_GAP = 2;\n  private static readonly MIN_DESCRIPTION_COLUMN = 25;\n\n  /**\n   * Format main command help\n   */\n  static formatHelp(info: CommandInfo): string {\n    const sections: string[] = [];\n\n    // NAME section\n    sections.push(this.formatSection('NAME', [`${info.name} - ${info.description}`]));\n\n    // SYNOPSIS section\n    if (info.usage) {\n      sections.push(this.formatSection('SYNOPSIS', [info.usage]));\n    }\n\n    // COMMANDS section\n    if (info.commands && info.commands.length > 0) {\n      sections.push(this.formatSection('COMMANDS', this.formatCommands(info.commands)));\n    }\n\n    // OPTIONS section\n    if (info.options && info.options.length > 0) {\n      sections.push(this.formatSection('OPTIONS', this.formatOptions(info.options)));\n    }\n\n    // GLOBAL OPTIONS section\n    if (info.globalOptions && info.globalOptions.length > 0) {\n      sections.push(this.formatSection('GLOBAL OPTIONS', this.formatOptions(info.globalOptions)));\n    }\n\n    // EXAMPLES section\n    if (info.examples && info.examples.length > 0) {\n      sections.push(this.formatSection('EXAMPLES', info.examples));\n    }\n\n    // Footer\n    if (info.commands && info.commands.length > 0) {\n      sections.push(`Run '${info.name} <command> --help' for more information on a command.`);\n    }\n\n    return sections.join('\\n\\n');\n  }\n\n  /**\n   * Format error message with usage hint\n   */\n  static formatError(error: string, command: string, usage?: string): string {\n    const lines: string[] = [`Error: ${error}`, ''];\n\n    if (usage) {\n      lines.push(`Usage: ${usage}`);\n    }\n\n    lines.push(`Try '${command} --help' for more information.`);\n\n    return lines.join('\\n');\n  }\n\n  /**\n   * Format validation error with valid options\n   */\n  static formatValidationError(\n    value: string,\n    paramName: string,\n    validOptions: string[],\n    command: string,\n  ): string {\n    return this.formatError(\n      `'${value}' is not a valid ${paramName}. Valid options are: ${validOptions.join(', ')}.`,\n      command,\n    );\n  }\n\n  private static formatSection(title: string, content: string[]): string {\n    return `${title}\\n${content.map((line) => `${this.INDENT}${line}`).join('\\n')}`;\n  }\n\n  private static formatCommands(commands: CommandItem[]): string[] {\n    const maxNameLength = Math.max(\n      this.MIN_DESCRIPTION_COLUMN,\n      ...commands.map((cmd) => {\n        const nameLength = cmd.name.length;\n        const aliasLength = cmd.aliases ? ` (${cmd.aliases.join(', ')})`.length : 0;\n        return nameLength + aliasLength;\n      }),\n    );\n\n    return commands.map((cmd) => {\n      let name = cmd.name;\n      if (cmd.aliases && cmd.aliases.length > 0) {\n        name += ` (${cmd.aliases.join(', ')})`;\n      }\n      const padding = ' '.repeat(maxNameLength - name.length + this.COLUMN_GAP);\n      return `${name}${padding}${cmd.description}`;\n    });\n  }\n\n  private static formatOptions(options: OptionItem[]): string[] {\n    const maxFlagsLength = Math.max(\n      this.MIN_DESCRIPTION_COLUMN,\n      ...options.map((opt) => opt.flags.length),\n    );\n\n    return options.map((opt) => {\n      const padding = ' '.repeat(maxFlagsLength - opt.flags.length + this.COLUMN_GAP);\n      let description = opt.description;\n\n      // Add default value\n      if (opt.defaultValue !== undefined) {\n        description += ` [default: ${opt.defaultValue}]`;\n      }\n\n      // Add valid values on next line if present\n      if (opt.validValues && opt.validValues.length > 0) {\n        const validValuesLine =\n          ' '.repeat(maxFlagsLength + this.COLUMN_GAP) + `Valid: ${opt.validValues.join(', ')}`;\n        return `${opt.flags}${padding}${description}\\n${this.INDENT}${validValuesLine}`;\n      }\n\n      return `${opt.flags}${padding}${description}`;\n    });\n  }\n\n  /**\n   * Strip ANSI color codes and emojis from text\n   */\n  static stripFormatting(text: string): string {\n    // Remove ANSI color codes\n    text = text.replace(/\\x1b\\[[0-9;]*m/g, '');\n\n    // Remove common emojis used in the CLI\n    const emojiPattern =\n      /[\\u{1F300}-\\u{1F9FF}]|[\\u{2600}-\\u{27BF}]|[\\u{1F000}-\\u{1F6FF}]|[\\u{1F680}-\\u{1F6FF}]/gu;\n    text = text.replace(emojiPattern, '').trim();\n\n    // Remove multiple spaces\n    text = text.replace(/\\s+/g, ' ');\n\n    return text;\n  }\n}\n"],"names":["HelpFormatter","INDENT","COLUMN_GAP","MIN_DESCRIPTION_COLUMN","formatHelp","info","sections","push","formatSection","name","description","usage","commands","length","formatCommands","options","formatOptions","globalOptions","examples","join","formatError","error","command","lines","formatValidationError","value","paramName","validOptions","title","content","map","line","maxNameLength","Math","max","cmd","nameLength","aliasLength","aliases","padding","repeat","maxFlagsLength","opt","flags","defaultValue","undefined","validValues","validValuesLine","stripFormatting","text","replace","emojiPattern","trim"],"mappings":"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"}

package/dist/src/cli/simple-cli.js

@@ -2973,4 +2973,108 @@ if (import.meta.url === `file://${process.argv[1]}`) {
     await main();
 }
 
+//# sourceMappingURL=simple-cli.js.map sparc run spec-pseudocode "User profile management feature"
+
+# 2. Design architecture
+npx claude-flow sparc run architect "Profile service architecture with data validation"
+
+# 3. Implement with TDD
+npx claude-flow sparc tdd "user profile CRUD operations"
+
+# 4. Security review
+npx claude-flow sparc run security-review "profile data access and validation"
+
+# 5. Integration testing
+npx claude-flow sparc run integration "profile service with authentication system"
+
+# 6. Documentation
+npx claude-flow sparc run docs-writer "profile service API documentation"
+\`\`\`
+
+### Bug Fix Workflow
+\`\`\`bash
+# 1. Debug and analyze
+npx claude-flow sparc run debug "authentication token expiration issue"
+
+# 2. Write regression tests
+npx claude-flow sparc run tdd "token refresh mechanism tests"
+
+# 3. Implement fix
+npx claude-flow sparc run code "fix token refresh in authentication service"
+
+# 4. Security review
+npx claude-flow sparc run security-review "token handling security implications"
+\`\`\`
+
+## Configuration Files
+
+### SPARC Configuration
+- **\`.roomodes\`**: SPARC mode definitions and configurations
+- **\`.roo/\`**: Templates, workflows, and mode-specific rules
+
+### Claude-Flow Configuration
+- **\`memory/\`**: Persistent memory and session data
+- **\`coordination/\`**: Multi-agent coordination settings
+
+## Git Workflow Integration
+
+### Commit Strategy with SPARC
+- **Specification commits**: After completing requirements analysis
+- **Architecture commits**: After design phase completion
+- **TDD commits**: After each Red-Green-Refactor cycle
+- **Integration commits**: After successful component integration
+- **Documentation commits**: After completing documentation updates
+
+### Branch Strategy
+- **\`feature/sparc-<feature-name>\`**: Feature development with SPARC methodology
+- **\`hotfix/sparc-<issue>\`**: Bug fixes using SPARC debugging workflow
+- **\`refactor/sparc-<component>\`**: Refactoring using optimization mode
+
+## Troubleshooting
+
+### Common SPARC Issues
+- **Mode not found**: Check \`.roomodes\` file exists and is valid JSON
+- **Memory persistence**: Ensure \`memory/\` directory has write permissions
+- **Tool access**: Verify required tools are available for the selected mode
+- **Namespace conflicts**: Use unique memory namespaces for different features
+
+### Debug Commands
+\`\`\`bash
+# Check SPARC configuration
+npx claude-flow sparc modes
+
+# Verify memory system
+npx claude-flow memory stats
+
+# Check system status
+npx claude-flow status
+
+# View detailed mode information
+npx claude-flow sparc info <mode-name>
+\`\`\`
+
+## Project Architecture
+
+This SPARC-enabled project follows a systematic development approach:
+- **Clear separation of concerns** through modular design
+- **Test-driven development** ensuring reliability and maintainability
+- **Iterative refinement** for continuous improvement
+- **Comprehensive documentation** for team collaboration
+- **AI-assisted development** through specialized SPARC modes
+
+## Important Notes
+
+- Always run tests before committing (\`npm run test\`)
+- Use SPARC memory system to maintain context across sessions
+- Follow the Red-Green-Refactor cycle during TDD phases
+- Document architectural decisions in memory for future reference
+- Regular security reviews for any authentication or data handling code
+
+For more information about SPARC methodology, see: https://github.com/ruvnet/claude-code-flow/docs/sparc.md
+`;
+}
+if (isMainModule(import.meta.url)) {
+    await main();
+}
+
 //# sourceMappingURL=simple-cli.js.map