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

tapps_agents/cli/parsers/ops.py

@@ -1,159 +1,159 @@
-"""
-Ops agent parser definitions
-"""
-import argparse
-
-
-def add_ops_parser(subparsers: argparse._SubParsersAction) -> None:
-    """Add ops agent parser and subparsers"""
-    ops_parser = subparsers.add_parser(
-        "ops",
-        help="Ops Agent commands",
-        description="""DevOps and operations agent.
-        
-The Ops Agent handles deployment and operations tasks:
-  • Security scanning
-  • Compliance checking (GDPR, HIPAA, SOC2)
-  • Deployment automation
-  • Infrastructure setup
-  • Dependency auditing
-
-Use this agent for security, compliance, and deployment tasks.""",
-    )
-    ops_subparsers = ops_parser.add_subparsers(
-        dest="command", help="Ops agent subcommand (use 'help' to see all available commands)"
-    )
-
-    security_scan_parser = ops_subparsers.add_parser(
-        "security-scan",
-        aliases=["*security-scan"],
-        help="Perform security vulnerability scanning",
-        description="""Scan code for security vulnerabilities.
-        
-Detects:
-  • SQL injection vulnerabilities
-  • XSS (Cross-Site Scripting) issues
-  • Secret keys and credentials
-  • Insecure dependencies
-  • Authentication/authorization flaws
-  • Input validation issues
-
-Example:
-  tapps-agents ops security-scan
-  tapps-agents ops security-scan --target src/api/ --type sql_injection""",
-    )
-    security_scan_parser.add_argument(
-        "--target", help="File or directory path to scan for security vulnerabilities. Defaults to project root if not specified. Can be a specific file, directory, or pattern."
-    )
-    security_scan_parser.add_argument(
-        "--type",
-        default="all",
-        help="Type of security scan to perform: 'all' for comprehensive scan (default), 'sql_injection' for SQL injection vulnerabilities, 'xss' for cross-site scripting, 'secrets' for exposed credentials, or other specific vulnerability types",
-    )
-    security_scan_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")
-    security_scan_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.",
-    )
-
-    compliance_check_parser = ops_subparsers.add_parser(
-        "compliance-check",
-        aliases=["*compliance-check"],
-        help="Check compliance with regulatory standards",
-        description="""Check code and configuration for regulatory compliance.
-        
-Validates compliance with:
-  • GDPR (General Data Protection Regulation)
-  • HIPAA (Health Insurance Portability)
-  • SOC 2 (Service Organization Control)
-  • General security best practices
-
-Example:
-  tapps-agents ops compliance-check --type GDPR
-  tapps-agents ops compliance-check --type all""",
-    )
-    compliance_check_parser.add_argument(
-        "--type",
-        default="general",
-        help="Compliance standard to check: 'general' for general security best practices (default), 'GDPR' for General Data Protection Regulation, 'HIPAA' for Health Insurance Portability, 'SOC2' for Service Organization Control, 'all' for comprehensive compliance check",
-    )
-    compliance_check_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")
-    compliance_check_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.",
-    )
-
-    deploy_parser = ops_subparsers.add_parser(
-        "deploy", 
-        aliases=["*deploy"], 
-        help="Deploy application to specified environment",
-        description="""Deploy application to a target environment.
-        
-Handles:
-  • Environment configuration
-  • Dependency installation
-  • Service startup
-  • Health checks
-  • Rollback procedures
-
-Use this to automate deployment processes. Ensure deployment configurations are properly set up before use.""",
-    )
-    deploy_parser.add_argument(
-        "--target",
-        default="local",
-        help="Deployment target environment: 'local' for local development (default), 'staging' for staging environment, 'production' for production deployment",
-    )
-    deploy_parser.add_argument("--environment", help="Name of a specific environment configuration to use. Overrides --target if a matching configuration exists.")
-    deploy_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")
-
-    infrastructure_setup_parser = ops_subparsers.add_parser(
-        "infrastructure-setup",
-        aliases=["*infrastructure-setup"],
-        help="Set up infrastructure configuration and deployment files",
-        description="""Generate infrastructure setup files and configurations.
-        
-Creates configuration for:
-  • Docker containers and docker-compose
-  • Kubernetes deployments and services
-  • Terraform infrastructure as code
-  • CI/CD pipeline configurations
-
-Use this to bootstrap infrastructure setup for your project.""",
-    )
-    infrastructure_setup_parser.add_argument(
-        "--type",
-        default="docker",
-        help="Infrastructure type to set up: 'docker' for Docker and docker-compose (default), 'kubernetes' for K8s manifests, 'terraform' for Terraform configurations",
-    )
-
-    audit_dependencies_parser = ops_subparsers.add_parser(
-        "audit-dependencies",
-        aliases=["*audit-dependencies"],
-        help="Audit dependencies for security vulnerabilities (Phase 6.4.3)",
-    )
-    audit_dependencies_parser.add_argument(
-        "--severity-threshold",
-        choices=["low", "medium", "high", "critical"],
-        default="high",
-        help="Minimum vulnerability severity to report: 'low' for all vulnerabilities, 'medium' for medium and above, 'high' for high and critical (default), 'critical' for critical only",
-    )
-    audit_dependencies_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.")
-    audit_dependencies_parser.add_argument(
-        "--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured vulnerability data (default), 'text' for human-readable report, 'markdown' for markdown format"
-    )
-    audit_dependencies_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.",
-    )
-
-    audit_bundle_parser = ops_subparsers.add_parser(
-        "audit-bundle",
-        aliases=["*audit-bundle"],
-        help="Opt-in bundle analysis for Node/React/Vue (§3.8); best-effort, does not block",
-    )
-
-    ops_subparsers.add_parser("help", aliases=["*help"], help="Show ops commands")
-
+"""
+Ops agent parser definitions
+"""
+import argparse
+
+
+def add_ops_parser(subparsers: argparse._SubParsersAction) -> None:
+    """Add ops agent parser and subparsers"""
+    ops_parser = subparsers.add_parser(
+        "ops",
+        help="Ops Agent commands",
+        description="""DevOps and operations agent.
+        
+The Ops Agent handles deployment and operations tasks:
+  • Security scanning
+  • Compliance checking (GDPR, HIPAA, SOC2)
+  • Deployment automation
+  • Infrastructure setup
+  • Dependency auditing
+
+Use this agent for security, compliance, and deployment tasks.""",
+    )
+    ops_subparsers = ops_parser.add_subparsers(
+        dest="command", help="Ops agent subcommand (use 'help' to see all available commands)"
+    )
+
+    security_scan_parser = ops_subparsers.add_parser(
+        "security-scan",
+        aliases=["*security-scan"],
+        help="Perform security vulnerability scanning",
+        description="""Scan code for security vulnerabilities.
+        
+Detects:
+  • SQL injection vulnerabilities
+  • XSS (Cross-Site Scripting) issues
+  • Secret keys and credentials
+  • Insecure dependencies
+  • Authentication/authorization flaws
+  • Input validation issues
+
+Example:
+  tapps-agents ops security-scan
+  tapps-agents ops security-scan --target src/api/ --type sql_injection""",
+    )
+    security_scan_parser.add_argument(
+        "--target", help="File or directory path to scan for security vulnerabilities. Defaults to project root if not specified. Can be a specific file, directory, or pattern."
+    )
+    security_scan_parser.add_argument(
+        "--type",
+        default="all",
+        help="Type of security scan to perform: 'all' for comprehensive scan (default), 'sql_injection' for SQL injection vulnerabilities, 'xss' for cross-site scripting, 'secrets' for exposed credentials, or other specific vulnerability types",
+    )
+    security_scan_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")
+    security_scan_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.",
+    )
+
+    compliance_check_parser = ops_subparsers.add_parser(
+        "compliance-check",
+        aliases=["*compliance-check"],
+        help="Check compliance with regulatory standards",
+        description="""Check code and configuration for regulatory compliance.
+        
+Validates compliance with:
+  • GDPR (General Data Protection Regulation)
+  • HIPAA (Health Insurance Portability)
+  • SOC 2 (Service Organization Control)
+  • General security best practices
+
+Example:
+  tapps-agents ops compliance-check --type GDPR
+  tapps-agents ops compliance-check --type all""",
+    )
+    compliance_check_parser.add_argument(
+        "--type",
+        default="general",
+        help="Compliance standard to check: 'general' for general security best practices (default), 'GDPR' for General Data Protection Regulation, 'HIPAA' for Health Insurance Portability, 'SOC2' for Service Organization Control, 'all' for comprehensive compliance check",
+    )
+    compliance_check_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")
+    compliance_check_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.",
+    )
+
+    deploy_parser = ops_subparsers.add_parser(
+        "deploy", 
+        aliases=["*deploy"], 
+        help="Deploy application to specified environment",
+        description="""Deploy application to a target environment.
+        
+Handles:
+  • Environment configuration
+  • Dependency installation
+  • Service startup
+  • Health checks
+  • Rollback procedures
+
+Use this to automate deployment processes. Ensure deployment configurations are properly set up before use.""",
+    )
+    deploy_parser.add_argument(
+        "--target",
+        default="local",
+        help="Deployment target environment: 'local' for local development (default), 'staging' for staging environment, 'production' for production deployment",
+    )
+    deploy_parser.add_argument("--environment", help="Name of a specific environment configuration to use. Overrides --target if a matching configuration exists.")
+    deploy_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")
+
+    infrastructure_setup_parser = ops_subparsers.add_parser(
+        "infrastructure-setup",
+        aliases=["*infrastructure-setup"],
+        help="Set up infrastructure configuration and deployment files",
+        description="""Generate infrastructure setup files and configurations.
+        
+Creates configuration for:
+  • Docker containers and docker-compose
+  • Kubernetes deployments and services
+  • Terraform infrastructure as code
+  • CI/CD pipeline configurations
+
+Use this to bootstrap infrastructure setup for your project.""",
+    )
+    infrastructure_setup_parser.add_argument(
+        "--type",
+        default="docker",
+        help="Infrastructure type to set up: 'docker' for Docker and docker-compose (default), 'kubernetes' for K8s manifests, 'terraform' for Terraform configurations",
+    )
+
+    audit_dependencies_parser = ops_subparsers.add_parser(
+        "audit-dependencies",
+        aliases=["*audit-dependencies"],
+        help="Audit dependencies for security vulnerabilities (Phase 6.4.3)",
+    )
+    audit_dependencies_parser.add_argument(
+        "--severity-threshold",
+        choices=["low", "medium", "high", "critical"],
+        default="high",
+        help="Minimum vulnerability severity to report: 'low' for all vulnerabilities, 'medium' for medium and above, 'high' for high and critical (default), 'critical' for critical only",
+    )
+    audit_dependencies_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.")
+    audit_dependencies_parser.add_argument(
+        "--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured vulnerability data (default), 'text' for human-readable report, 'markdown' for markdown format"
+    )
+    audit_dependencies_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.",
+    )
+
+    audit_bundle_parser = ops_subparsers.add_parser(
+        "audit-bundle",
+        aliases=["*audit-bundle"],
+        help="Opt-in bundle analysis for Node/React/Vue (§3.8); best-effort, does not block",
+    )
+
+    ops_subparsers.add_parser("help", aliases=["*help"], help="Show ops commands")
+

tapps_agents/cli/parsers/orchestrator.py

@@ -1,98 +1,98 @@
-"""
-Orchestrator agent parser definitions
-"""
-import argparse
-
-
-def add_orchestrator_parser(subparsers: argparse._SubParsersAction) -> None:
-    """Add orchestrator agent parser and subparsers"""
-    orchestrator_parser = subparsers.add_parser(
-        "orchestrator",
-        help="Orchestrator Agent commands",
-        description="""Workflow orchestration and coordination agent.
-        
-The Orchestrator Agent manages multi-agent workflows:
-  • List available workflows
-  • Start and manage workflows
-  • Track workflow status
-  • Make gate decisions
-  • Resume interrupted workflows
-
-Use this agent to coordinate complex multi-step development processes.""",
-    )
-    orchestrator_subparsers = orchestrator_parser.add_subparsers(
-        dest="command", help="Orchestrator agent subcommand (use 'help' to see all available commands)"
-    )
-
-    orchestrator_subparsers.add_parser(
-        "workflow-list", 
-        aliases=["*workflow-list"], 
-        help="List all available workflows with descriptions",
-        description="Display all available workflows that can be orchestrated, including their purposes, steps, and use cases."
-    )
-
-    workflow_start_parser = orchestrator_subparsers.add_parser(
-        "workflow-start", 
-        aliases=["*workflow-start"], 
-        help="Start execution of a workflow",
-        description="Begin execution of a workflow by its ID. The orchestrator will coordinate all workflow steps and agents."
-    )
-    workflow_start_parser.add_argument("workflow_id", help="The ID of the workflow to start. Obtain workflow IDs from 'workflow-list' command.")
-
-    orchestrator_subparsers.add_parser(
-        "workflow-status",
-        aliases=["*workflow-status"],
-        help="Show current status of running workflows",
-        description="Display the current status of all active workflows including current step, progress, and any errors or warnings."
-    )
-
-    orchestrator_subparsers.add_parser(
-        "workflow-next", 
-        aliases=["*workflow-next"], 
-        help="Show the next step in the current workflow",
-        description="Display information about the next step that will be executed in the current workflow, including what agent will run and what it will do."
-    )
-
-    workflow_skip_parser = orchestrator_subparsers.add_parser(
-        "workflow-skip", 
-        aliases=["*workflow-skip"], 
-        help="Skip an optional step in the current workflow",
-        description="Skip an optional workflow step that is not required for workflow completion. Use this to bypass steps that are not needed for your use case."
-    )
-    workflow_skip_parser.add_argument("step_id", help="The ID of the workflow step to skip. Obtain step IDs from workflow status or workflow definition.")
-
-    orchestrator_subparsers.add_parser(
-        "workflow-resume",
-        aliases=["*workflow-resume"],
-        help="Resume an interrupted or paused workflow",
-        description="Resume execution of a workflow that was interrupted, paused, or failed. Continues from the last completed step."
-    )
-
-    workflow_parser = orchestrator_subparsers.add_parser(
-        "workflow",
-        aliases=["*workflow"],
-        help="Execute a workflow from a YAML file path",
-        description="Execute a workflow directly from a YAML file path. Supports both relative and absolute paths."
-    )
-    workflow_parser.add_argument(
-        "workflow_file",
-        help="Path to the workflow YAML file (e.g., 'workflows/custom/my-workflow.yaml' or absolute path)"
-    )
-
-    gate_parser = orchestrator_subparsers.add_parser(
-        "gate", 
-        aliases=["*gate"], 
-        help="Make a gate decision for workflow control flow",
-        description="""Evaluate a gate condition to determine workflow control flow.
-        
-Gates are decision points in workflows that determine whether to proceed, skip, or take alternative paths based on conditions. Use this to manually evaluate gates or provide gate decision data.""",
-    )
-    gate_parser.add_argument("--condition", help="Gate condition expression to evaluate (e.g., 'score > 80', 'tests_passed == true'). Used to determine workflow path.")
-    gate_parser.add_argument(
-        "--scoring-data", help="JSON string containing scoring or evaluation data to use in gate condition evaluation. Defaults to empty object if not provided.", default="{}"
-    )
-
-    orchestrator_subparsers.add_parser(
-        "help", aliases=["*help"], help="Show orchestrator commands"
-    )
-
+"""
+Orchestrator agent parser definitions
+"""
+import argparse
+
+
+def add_orchestrator_parser(subparsers: argparse._SubParsersAction) -> None:
+    """Add orchestrator agent parser and subparsers"""
+    orchestrator_parser = subparsers.add_parser(
+        "orchestrator",
+        help="Orchestrator Agent commands",
+        description="""Workflow orchestration and coordination agent.
+        
+The Orchestrator Agent manages multi-agent workflows:
+  • List available workflows
+  • Start and manage workflows
+  • Track workflow status
+  • Make gate decisions
+  • Resume interrupted workflows
+
+Use this agent to coordinate complex multi-step development processes.""",
+    )
+    orchestrator_subparsers = orchestrator_parser.add_subparsers(
+        dest="command", help="Orchestrator agent subcommand (use 'help' to see all available commands)"
+    )
+
+    orchestrator_subparsers.add_parser(
+        "workflow-list", 
+        aliases=["*workflow-list"], 
+        help="List all available workflows with descriptions",
+        description="Display all available workflows that can be orchestrated, including their purposes, steps, and use cases."
+    )
+
+    workflow_start_parser = orchestrator_subparsers.add_parser(
+        "workflow-start", 
+        aliases=["*workflow-start"], 
+        help="Start execution of a workflow",
+        description="Begin execution of a workflow by its ID. The orchestrator will coordinate all workflow steps and agents."
+    )
+    workflow_start_parser.add_argument("workflow_id", help="The ID of the workflow to start. Obtain workflow IDs from 'workflow-list' command.")
+
+    orchestrator_subparsers.add_parser(
+        "workflow-status",
+        aliases=["*workflow-status"],
+        help="Show current status of running workflows",
+        description="Display the current status of all active workflows including current step, progress, and any errors or warnings."
+    )
+
+    orchestrator_subparsers.add_parser(
+        "workflow-next", 
+        aliases=["*workflow-next"], 
+        help="Show the next step in the current workflow",
+        description="Display information about the next step that will be executed in the current workflow, including what agent will run and what it will do."
+    )
+
+    workflow_skip_parser = orchestrator_subparsers.add_parser(
+        "workflow-skip", 
+        aliases=["*workflow-skip"], 
+        help="Skip an optional step in the current workflow",
+        description="Skip an optional workflow step that is not required for workflow completion. Use this to bypass steps that are not needed for your use case."
+    )
+    workflow_skip_parser.add_argument("step_id", help="The ID of the workflow step to skip. Obtain step IDs from workflow status or workflow definition.")
+
+    orchestrator_subparsers.add_parser(
+        "workflow-resume",
+        aliases=["*workflow-resume"],
+        help="Resume an interrupted or paused workflow",
+        description="Resume execution of a workflow that was interrupted, paused, or failed. Continues from the last completed step."
+    )
+
+    workflow_parser = orchestrator_subparsers.add_parser(
+        "workflow",
+        aliases=["*workflow"],
+        help="Execute a workflow from a YAML file path",
+        description="Execute a workflow directly from a YAML file path. Supports both relative and absolute paths."
+    )
+    workflow_parser.add_argument(
+        "workflow_file",
+        help="Path to the workflow YAML file (e.g., 'workflows/custom/my-workflow.yaml' or absolute path)"
+    )
+
+    gate_parser = orchestrator_subparsers.add_parser(
+        "gate", 
+        aliases=["*gate"], 
+        help="Make a gate decision for workflow control flow",
+        description="""Evaluate a gate condition to determine workflow control flow.
+        
+Gates are decision points in workflows that determine whether to proceed, skip, or take alternative paths based on conditions. Use this to manually evaluate gates or provide gate decision data.""",
+    )
+    gate_parser.add_argument("--condition", help="Gate condition expression to evaluate (e.g., 'score > 80', 'tests_passed == true'). Used to determine workflow path.")
+    gate_parser.add_argument(
+        "--scoring-data", help="JSON string containing scoring or evaluation data to use in gate condition evaluation. Defaults to empty object if not provided.", default="{}"
+    )
+
+    orchestrator_subparsers.add_parser(
+        "help", aliases=["*help"], help="Show orchestrator commands"
+    )
+