tapps-agents 3.6.0__py3-none-any.whl → 3.6.1__py3-none-any.whl

tapps_agents/cli/parsers/implementer.py

@@ -1,168 +1,168 @@
-"""
-Implementer agent parser definitions
-"""
-import argparse
-
-
-def add_implementer_parser(subparsers: argparse._SubParsersAction) -> None:
-    """Add implementer agent parser and subparsers"""
-    implementer_parser = subparsers.add_parser(
-        "implementer",
-        help="Implementer Agent commands",
-        description="""Code generation and implementation agent.
-        
-The Implementer Agent generates and writes code based on specifications:
-  • Generate code from specifications
-  • Write code to files
-  • Refactor existing code
-  • Follow project patterns and conventions
-  • Integrate with existing codebase
-
-Use this agent to implement features, create new modules, or refactor
-existing code according to your project's standards.""",
-    )
-    implementer_subparsers = implementer_parser.add_subparsers(
-        dest="command", help="Implementer agent subcommand (use 'help' to see all available commands)"
-    )
-
-    implement_parser = implementer_subparsers.add_parser(
-        "implement",
-        aliases=["*implement"],
-        help="Generate and write code to file",
-        description="""Generate code from a specification and write it to a file.
-        
-Creates new code or modifies existing files based on your specification.
-The agent analyzes the target file and existing codebase to ensure
-proper integration and adherence to project patterns.
-
-Example:
-  tapps-agents implementer implement "Create a User model with email and name fields" src/models/user.py
-  tapps-agents implementer implement "Add authentication endpoint" src/api/auth.py --context "Use JWT tokens\"""",
-    )
-    implement_parser.add_argument(
-        "specification", help="Detailed specification or description of what code to implement. Can be a feature description, function specification, or detailed requirements. Be specific for best results."
-    )
-    implement_parser.add_argument("file_path", help="Path to the target file where code will be written. If the file exists, code will be integrated with existing content. If it doesn't exist, a new file will be created.")
-    implement_parser.add_argument(
-        "--context", help="Additional context about the implementation such as existing patterns to follow, dependencies to use, constraints, or integration requirements"
-    )
-    implement_parser.add_argument(
-        "--language",
-        default="python",
-        help="Programming language for code generation: 'python' (default), 'javascript', 'typescript', 'java', 'go', 'rust', etc. Determines syntax and conventions used.",
-    )
-    implement_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
-    implement_parser.add_argument(
-        "--format",
-        choices=["json", "text", "markdown"],
-        default="json",
-        help="Output format: 'json' for structured output with metadata (default), 'text' for plain text code output, 'markdown' for markdown format",
-    )
-    implement_parser.add_argument(
-        "--no-enhance",
-        action="store_true",
-        help="Disable automatic prompt enhancement for this command",
-    )
-    implement_parser.add_argument(
-        "--enhance",
-        action="store_true",
-        help="Force prompt enhancement even if quality is high",
-    )
-    implement_parser.add_argument(
-        "--enhance-mode",
-        choices=["quick", "full"],
-        help="Override enhancement mode: 'quick' for fast 3-stage enhancement, 'full' for complete 7-stage enhancement",
-    )
-    implement_parser.add_argument(
-        "--verbose-output",
-        action="store_true",
-        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
-    )
-
-    generate_code_parser = implementer_subparsers.add_parser(
-        "generate-code",
-        aliases=["*generate-code"],
-        help="Generate code without writing to file",
-        description="""Generate code from a specification without writing to a file.
-        
-Useful for:
-  • Previewing code before writing
-  • Generating code snippets
-  • Testing specifications
-  • Getting code suggestions
-
-The generated code is returned in the output but not written to disk.
-
-Example:
-  tapps-agents implementer generate-code "Create a function to validate email addresses"
-  tapps-agents implementer generate-code "Add error handling" --file src/api.py""",
-    )
-    generate_code_parser.add_argument(
-        "specification", help="Code specification or description of what to generate. Describes the functionality, inputs, outputs, and behavior of the code to be generated."
-    )
-    generate_code_parser.add_argument(
-        "--file", help="Optional path to an existing file for context. The agent will analyze this file to understand existing patterns, imports, and structure to ensure generated code integrates well."
-    )
-    generate_code_parser.add_argument("--context", help="Additional context such as project conventions, framework usage, or specific requirements that should influence code generation")
-    generate_code_parser.add_argument(
-        "--language", default="python", help="Programming language for code generation: 'python' (default), 'javascript', 'typescript', 'java', 'go', 'rust', etc."
-    )
-    generate_code_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
-    generate_code_parser.add_argument(
-        "--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured output with metadata (default), 'text' for plain code output, 'markdown' for markdown format"
-    )
-    generate_code_parser.add_argument(
-        "--no-enhance",
-        action="store_true",
-        help="Disable automatic prompt enhancement for this command",
-    )
-    generate_code_parser.add_argument(
-        "--enhance",
-        action="store_true",
-        help="Force prompt enhancement even if quality is high",
-    )
-    generate_code_parser.add_argument(
-        "--enhance-mode",
-        choices=["quick", "full"],
-        help="Override enhancement mode: 'quick' for fast 3-stage enhancement, 'full' for complete 7-stage enhancement",
-    )
-    generate_code_parser.add_argument(
-        "--verbose-output",
-        action="store_true",
-        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
-    )
-
-    refactor_parser = implementer_subparsers.add_parser(
-        "refactor",
-        aliases=["*refactor"],
-        help="Refactor existing code file",
-        description="""Refactor existing code according to instructions.
-        
-Modifies code in place to:
-  • Improve code structure
-  • Apply design patterns
-  • Fix code smells
-  • Improve readability
-  • Optimize performance
-
-Example:
-  tapps-agents implementer refactor src/utils.py "Extract common logic into helper functions"
-  tapps-agents implementer refactor src/api.py "Apply dependency injection pattern\"""",
-    )
-    refactor_parser.add_argument("file_path", help="Path to the source code file to refactor. The file will be analyzed and refactored according to the instruction.")
-    refactor_parser.add_argument("instruction", help="Detailed refactoring instruction describing what changes to make (e.g., 'Extract common logic into helper functions', 'Apply dependency injection pattern', 'Improve error handling'). Be specific about the refactoring goal.")
-    refactor_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
-    refactor_parser.add_argument(
-        "--format", choices=["json", "text", "markdown", "diff"], default="json", help="Output format: 'json' for structured output with change descriptions (default), 'text' for plain refactored code, 'markdown' for markdown format, 'diff' for showing changes only"
-    )
-    refactor_parser.add_argument(
-        "--verbose-output",
-        action="store_true",
-        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
-    )
-
-    implementer_subparsers.add_parser(
-        "help", aliases=["*help"], help="Show implementer commands"
-    )
-
-
+"""
+Implementer agent parser definitions
+"""
+import argparse
+
+
+def add_implementer_parser(subparsers: argparse._SubParsersAction) -> None:
+    """Add implementer agent parser and subparsers"""
+    implementer_parser = subparsers.add_parser(
+        "implementer",
+        help="Implementer Agent commands",
+        description="""Code generation and implementation agent.
+        
+The Implementer Agent generates and writes code based on specifications:
+  • Generate code from specifications
+  • Write code to files
+  • Refactor existing code
+  • Follow project patterns and conventions
+  • Integrate with existing codebase
+
+Use this agent to implement features, create new modules, or refactor
+existing code according to your project's standards.""",
+    )
+    implementer_subparsers = implementer_parser.add_subparsers(
+        dest="command", help="Implementer agent subcommand (use 'help' to see all available commands)"
+    )
+
+    implement_parser = implementer_subparsers.add_parser(
+        "implement",
+        aliases=["*implement"],
+        help="Generate and write code to file",
+        description="""Generate code from a specification and write it to a file.
+        
+Creates new code or modifies existing files based on your specification.
+The agent analyzes the target file and existing codebase to ensure
+proper integration and adherence to project patterns.
+
+Example:
+  tapps-agents implementer implement "Create a User model with email and name fields" src/models/user.py
+  tapps-agents implementer implement "Add authentication endpoint" src/api/auth.py --context "Use JWT tokens\"""",
+    )
+    implement_parser.add_argument(
+        "specification", help="Detailed specification or description of what code to implement. Can be a feature description, function specification, or detailed requirements. Be specific for best results."
+    )
+    implement_parser.add_argument("file_path", help="Path to the target file where code will be written. If the file exists, code will be integrated with existing content. If it doesn't exist, a new file will be created.")
+    implement_parser.add_argument(
+        "--context", help="Additional context about the implementation such as existing patterns to follow, dependencies to use, constraints, or integration requirements"
+    )
+    implement_parser.add_argument(
+        "--language",
+        default="python",
+        help="Programming language for code generation: 'python' (default), 'javascript', 'typescript', 'java', 'go', 'rust', etc. Determines syntax and conventions used.",
+    )
+    implement_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
+    implement_parser.add_argument(
+        "--format",
+        choices=["json", "text", "markdown"],
+        default="json",
+        help="Output format: 'json' for structured output with metadata (default), 'text' for plain text code output, 'markdown' for markdown format",
+    )
+    implement_parser.add_argument(
+        "--no-enhance",
+        action="store_true",
+        help="Disable automatic prompt enhancement for this command",
+    )
+    implement_parser.add_argument(
+        "--enhance",
+        action="store_true",
+        help="Force prompt enhancement even if quality is high",
+    )
+    implement_parser.add_argument(
+        "--enhance-mode",
+        choices=["quick", "full"],
+        help="Override enhancement mode: 'quick' for fast 3-stage enhancement, 'full' for complete 7-stage enhancement",
+    )
+    implement_parser.add_argument(
+        "--verbose-output",
+        action="store_true",
+        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
+    )
+
+    generate_code_parser = implementer_subparsers.add_parser(
+        "generate-code",
+        aliases=["*generate-code"],
+        help="Generate code without writing to file",
+        description="""Generate code from a specification without writing to a file.
+        
+Useful for:
+  • Previewing code before writing
+  • Generating code snippets
+  • Testing specifications
+  • Getting code suggestions
+
+The generated code is returned in the output but not written to disk.
+
+Example:
+  tapps-agents implementer generate-code "Create a function to validate email addresses"
+  tapps-agents implementer generate-code "Add error handling" --file src/api.py""",
+    )
+    generate_code_parser.add_argument(
+        "specification", help="Code specification or description of what to generate. Describes the functionality, inputs, outputs, and behavior of the code to be generated."
+    )
+    generate_code_parser.add_argument(
+        "--file", help="Optional path to an existing file for context. The agent will analyze this file to understand existing patterns, imports, and structure to ensure generated code integrates well."
+    )
+    generate_code_parser.add_argument("--context", help="Additional context such as project conventions, framework usage, or specific requirements that should influence code generation")
+    generate_code_parser.add_argument(
+        "--language", default="python", help="Programming language for code generation: 'python' (default), 'javascript', 'typescript', 'java', 'go', 'rust', etc."
+    )
+    generate_code_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
+    generate_code_parser.add_argument(
+        "--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured output with metadata (default), 'text' for plain code output, 'markdown' for markdown format"
+    )
+    generate_code_parser.add_argument(
+        "--no-enhance",
+        action="store_true",
+        help="Disable automatic prompt enhancement for this command",
+    )
+    generate_code_parser.add_argument(
+        "--enhance",
+        action="store_true",
+        help="Force prompt enhancement even if quality is high",
+    )
+    generate_code_parser.add_argument(
+        "--enhance-mode",
+        choices=["quick", "full"],
+        help="Override enhancement mode: 'quick' for fast 3-stage enhancement, 'full' for complete 7-stage enhancement",
+    )
+    generate_code_parser.add_argument(
+        "--verbose-output",
+        action="store_true",
+        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
+    )
+
+    refactor_parser = implementer_subparsers.add_parser(
+        "refactor",
+        aliases=["*refactor"],
+        help="Refactor existing code file",
+        description="""Refactor existing code according to instructions.
+        
+Modifies code in place to:
+  • Improve code structure
+  • Apply design patterns
+  • Fix code smells
+  • Improve readability
+  • Optimize performance
+
+Example:
+  tapps-agents implementer refactor src/utils.py "Extract common logic into helper functions"
+  tapps-agents implementer refactor src/api.py "Apply dependency injection pattern\"""",
+    )
+    refactor_parser.add_argument("file_path", help="Path to the source code file to refactor. The file will be analyzed and refactored according to the instruction.")
+    refactor_parser.add_argument("instruction", help="Detailed refactoring instruction describing what changes to make (e.g., 'Extract common logic into helper functions', 'Apply dependency injection pattern', 'Improve error handling'). Be specific about the refactoring goal.")
+    refactor_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
+    refactor_parser.add_argument(
+        "--format", choices=["json", "text", "markdown", "diff"], default="json", help="Output format: 'json' for structured output with change descriptions (default), 'text' for plain refactored code, 'markdown' for markdown format, 'diff' for showing changes only"
+    )
+    refactor_parser.add_argument(
+        "--verbose-output",
+        action="store_true",
+        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
+    )
+
+    implementer_subparsers.add_parser(
+        "help", aliases=["*help"], help="Show implementer commands"
+    )
+
+

tapps_agents/cli/parsers/improver.py

@@ -1,132 +1,132 @@
-"""
-Improver agent parser definitions
-"""
-import argparse
-
-
-def add_improver_parser(subparsers: argparse._SubParsersAction) -> None:
-    """Add improver agent parser and subparsers"""
-    improver_parser = subparsers.add_parser(
-        "improver",
-        help="Improver Agent commands",
-        description="""Code improvement and optimization agent.
-        
-The Improver Agent enhances existing code:
-  • Refactor code for better structure
-  • Optimize performance and memory usage
-  • Improve overall code quality
-  • Apply best practices
-  • Reduce technical debt
-
-Use this agent to improve existing code without changing functionality.""",
-    )
-    improver_subparsers = improver_parser.add_subparsers(
-        dest="command", help="Improver agent subcommand (use 'help' to see all available commands)"
-    )
-
-    refactor_improver_parser = improver_subparsers.add_parser(
-        "refactor", 
-        aliases=["*refactor"], 
-        help="Refactor existing code to improve structure and maintainability",
-        description="""Refactor code to improve structure, readability, and maintainability.
-        
-Improves code by:
-  • Extracting common patterns
-  • Reducing complexity
-  • Improving naming and organization
-  • Applying design patterns
-  • Reducing duplication
-
-Use --instruction to specify particular refactoring goals, or let the agent identify improvement opportunities automatically.""",
-    )
-    refactor_improver_parser.add_argument("file_path", help="Path to the source code file to refactor. The file will be analyzed for improvement opportunities.")
-    refactor_improver_parser.add_argument(
-        "--instruction", help="Optional specific refactoring instructions (e.g., 'extract methods', 'simplify conditionals', 'improve error handling'). If not provided, the agent will identify and apply general improvements."
-    )
-    refactor_improver_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
-    refactor_improver_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
-    refactor_improver_parser.add_argument(
-        "--verbose-output",
-        action="store_true",
-        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
-    )
-
-    optimize_parser = improver_subparsers.add_parser(
-        "optimize",
-        aliases=["*optimize"],
-        help="Optimize code for performance, memory usage, or both",
-        description="""Optimize code for better performance or reduced memory usage.
-        
-Performance optimizations:
-  • Algorithm improvements
-  • Caching strategies
-  • Loop optimizations
-  • Lazy evaluation
-  • Parallel processing opportunities
-
-Memory optimizations:
-  • Reducing object allocations
-  • Memory-efficient data structures
-  • Garbage collection improvements
-  • Resource cleanup
-
-Use --type to specify the optimization focus.""",
-    )
-    optimize_parser.add_argument("file_path", help="Path to the source code file to optimize. The file will be analyzed for optimization opportunities.")
-    optimize_parser.add_argument(
-        "--type",
-        choices=["performance", "memory", "both"],
-        default="performance",
-        help="Type of optimization to focus on: 'performance' for speed improvements (default), 'memory' for memory usage reduction, 'both' for comprehensive optimization",
-    )
-    optimize_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
-    optimize_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
-    optimize_parser.add_argument(
-        "--verbose-output",
-        action="store_true",
-        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
-    )
-
-    improve_quality_parser = improver_subparsers.add_parser(
-        "improve-quality",
-        aliases=["*improve-quality"],
-        help="Improve overall code quality through comprehensive analysis",
-        description="""Perform comprehensive code quality improvements.
-        
-Addresses multiple quality aspects:
-  • Code structure and organization
-  • Readability and maintainability
-  • Best practices and patterns
-  • Error handling
-  • Documentation
-  • Testability
-
-This is a general quality improvement that addresses multiple concerns simultaneously.""",
-    )
-    improve_quality_parser.add_argument("file_path", help="Path to the source code file to improve. The file will be comprehensively analyzed and improved across multiple quality dimensions.")
-    improve_quality_parser.add_argument(
-        "--focus",
-        help="Comma-separated list of quality aspects to focus on (e.g., 'security, maintainability, type-safety'). If not provided, performs comprehensive quality improvement.",
-    )
-    improve_quality_parser.add_argument(
-        "--auto-apply",
-        action="store_true",
-        help="Automatically apply improvements to the file. Creates a backup before modifying. Returns a diff of changes made and runs verification review.",
-    )
-    improve_quality_parser.add_argument(
-        "--preview",
-        action="store_true",
-        help="Preview improvements as a diff without modifying the file. Shows what changes would be made without applying them.",
-    )
-    improve_quality_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
-    improve_quality_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
-    improve_quality_parser.add_argument(
-        "--verbose-output",
-        action="store_true",
-        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
-    )
-
-    improver_subparsers.add_parser(
-        "help", aliases=["*help"], help="Show improver commands"
-    )
-
+"""
+Improver agent parser definitions
+"""
+import argparse
+
+
+def add_improver_parser(subparsers: argparse._SubParsersAction) -> None:
+    """Add improver agent parser and subparsers"""
+    improver_parser = subparsers.add_parser(
+        "improver",
+        help="Improver Agent commands",
+        description="""Code improvement and optimization agent.
+        
+The Improver Agent enhances existing code:
+  • Refactor code for better structure
+  • Optimize performance and memory usage
+  • Improve overall code quality
+  • Apply best practices
+  • Reduce technical debt
+
+Use this agent to improve existing code without changing functionality.""",
+    )
+    improver_subparsers = improver_parser.add_subparsers(
+        dest="command", help="Improver agent subcommand (use 'help' to see all available commands)"
+    )
+
+    refactor_improver_parser = improver_subparsers.add_parser(
+        "refactor", 
+        aliases=["*refactor"], 
+        help="Refactor existing code to improve structure and maintainability",
+        description="""Refactor code to improve structure, readability, and maintainability.
+        
+Improves code by:
+  • Extracting common patterns
+  • Reducing complexity
+  • Improving naming and organization
+  • Applying design patterns
+  • Reducing duplication
+
+Use --instruction to specify particular refactoring goals, or let the agent identify improvement opportunities automatically.""",
+    )
+    refactor_improver_parser.add_argument("file_path", help="Path to the source code file to refactor. The file will be analyzed for improvement opportunities.")
+    refactor_improver_parser.add_argument(
+        "--instruction", help="Optional specific refactoring instructions (e.g., 'extract methods', 'simplify conditionals', 'improve error handling'). If not provided, the agent will identify and apply general improvements."
+    )
+    refactor_improver_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
+    refactor_improver_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
+    refactor_improver_parser.add_argument(
+        "--verbose-output",
+        action="store_true",
+        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
+    )
+
+    optimize_parser = improver_subparsers.add_parser(
+        "optimize",
+        aliases=["*optimize"],
+        help="Optimize code for performance, memory usage, or both",
+        description="""Optimize code for better performance or reduced memory usage.
+        
+Performance optimizations:
+  • Algorithm improvements
+  • Caching strategies
+  • Loop optimizations
+  • Lazy evaluation
+  • Parallel processing opportunities
+
+Memory optimizations:
+  • Reducing object allocations
+  • Memory-efficient data structures
+  • Garbage collection improvements
+  • Resource cleanup
+
+Use --type to specify the optimization focus.""",
+    )
+    optimize_parser.add_argument("file_path", help="Path to the source code file to optimize. The file will be analyzed for optimization opportunities.")
+    optimize_parser.add_argument(
+        "--type",
+        choices=["performance", "memory", "both"],
+        default="performance",
+        help="Type of optimization to focus on: 'performance' for speed improvements (default), 'memory' for memory usage reduction, 'both' for comprehensive optimization",
+    )
+    optimize_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
+    optimize_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
+    optimize_parser.add_argument(
+        "--verbose-output",
+        action="store_true",
+        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
+    )
+
+    improve_quality_parser = improver_subparsers.add_parser(
+        "improve-quality",
+        aliases=["*improve-quality"],
+        help="Improve overall code quality through comprehensive analysis",
+        description="""Perform comprehensive code quality improvements.
+        
+Addresses multiple quality aspects:
+  • Code structure and organization
+  • Readability and maintainability
+  • Best practices and patterns
+  • Error handling
+  • Documentation
+  • Testability
+
+This is a general quality improvement that addresses multiple concerns simultaneously.""",
+    )
+    improve_quality_parser.add_argument("file_path", help="Path to the source code file to improve. The file will be comprehensively analyzed and improved across multiple quality dimensions.")
+    improve_quality_parser.add_argument(
+        "--focus",
+        help="Comma-separated list of quality aspects to focus on (e.g., 'security, maintainability, type-safety'). If not provided, performs comprehensive quality improvement.",
+    )
+    improve_quality_parser.add_argument(
+        "--auto-apply",
+        action="store_true",
+        help="Automatically apply improvements to the file. Creates a backup before modifying. Returns a diff of changes made and runs verification review.",
+    )
+    improve_quality_parser.add_argument(
+        "--preview",
+        action="store_true",
+        help="Preview improvements as a diff without modifying the file. Shows what changes would be made without applying them.",
+    )
+    improve_quality_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
+    improve_quality_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
+    improve_quality_parser.add_argument(
+        "--verbose-output",
+        action="store_true",
+        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
+    )
+
+    improver_subparsers.add_parser(
+        "help", aliases=["*help"], help="Show improver commands"
+    )
+