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

tapps_agents/resources/workflows/presets/brownfield-analysis.yaml

@@ -0,0 +1,235 @@
+# Brownfield Analysis Workflow
+# Comprehensive analysis of existing (brownfield) projects
+
+workflow:
+  id: brownfield-analysis
+  name: Brownfield Project Analysis
+  description: |
+    Comprehensive analysis workflow for existing codebases that provides:
+    - Project discovery and profiling
+    - Code quality assessment
+    - Architecture pattern analysis
+    - Codebase structure evaluation
+    - Technical debt categorization and prioritization
+    - Dependency and integration mapping
+    - Test and documentation coverage analysis
+    - Modernization roadmap generation
+    
+    This workflow orchestrates multiple agents to provide a complete picture
+    of a brownfield project's current state and recommended improvements.
+  type: brownfield
+
+sequence:
+  - step: discovery
+    agent: analyst
+    action: analyze-brownfield
+    parameters:
+      phase: discovery
+    creates:
+      - project_profile
+      - service_inventory
+      - tech_stack_summary
+      - file_structure_map
+    notes: |
+      Phase 1: Discover project structure, services, tech stack, and file organization.
+      Uses ProjectProfileDetector, ServiceDiscovery, and LanguageDetector.
+    output: |
+      - Project profile saved to .tapps-agents/project-profile.yaml
+      - Service inventory JSON
+      - Tech stack summary
+
+  - step: quality_analysis
+    agent: reviewer
+    action: analyze-project
+    requires:
+      - discovery
+    creates:
+      - quality_scores
+      - duplication_report
+      - security_scan_results
+    notes: |
+      Phase 2: Comprehensive code quality analysis across all services.
+      Uses reviewer analyze-project, duplication detection, and security scanning.
+    output: |
+      - Quality scores by service
+      - Duplication report
+      - Security vulnerabilities list
+
+  - step: architecture_analysis
+    agent: analyst
+    action: analyze-brownfield
+    parameters:
+      phase: architecture
+    requires:
+      - discovery
+    creates:
+      - architecture_patterns
+      - component_graph
+      - coupling_metrics
+      - architectural_debt
+    notes: |
+      Phase 3: Analyze architecture patterns, component relationships, and coupling.
+      Uses ArchitectureAnalyzer for import graph analysis and pattern detection.
+    output: |
+      - Architecture pattern inventory
+      - Component dependency graph
+      - Coupling/cohesion metrics
+      - Architectural debt assessment
+
+  - step: structure_analysis
+    agent: analyst
+    action: analyze-brownfield
+    parameters:
+      phase: structure
+    requires:
+      - discovery
+    creates:
+      - structure_quality_metrics
+      - module_organization
+      - structural_issues
+    notes: |
+      Phase 4: Assess codebase structure, module organization, and structural quality.
+      Uses StructureAnalyzer for organization and coupling analysis.
+    output: |
+      - Structure quality scores
+      - Module organization report
+      - Structural issue list
+
+  - step: dependency_analysis
+    agent: ops
+    action: audit-dependencies
+    requires:
+      - discovery
+    creates:
+      - dependency_tree
+      - security_vulnerabilities
+      - outdated_packages
+      - integration_points
+    notes: |
+      Phase 6: Analyze dependencies, security vulnerabilities, and integration points.
+      Uses ops audit-dependencies and DependencyAnalyzer.
+    output: |
+      - Dependency tree visualization
+      - Security vulnerability report
+      - Outdated package list
+      - Integration point map
+
+  - step: test_doc_analysis
+    agent: analyst
+    action: analyze-brownfield
+    parameters:
+      phase: tests_docs
+    requires:
+      - discovery
+    creates:
+      - test_coverage_report
+      - test_gaps
+      - documentation_coverage
+      - documentation_gaps
+    notes: |
+      Phase 7: Analyze test coverage and documentation completeness.
+      Uses TestCoverageAnalyzer and DocumentationAnalyzer.
+    output: |
+      - Test coverage report
+      - Test gap analysis
+      - Documentation coverage report
+      - Documentation gap analysis
+
+  - step: technical_debt_assessment
+    agent: analyst
+    action: analyze-brownfield
+    parameters:
+      phase: technical_debt
+    requires:
+      - quality_analysis
+      - architecture_analysis
+      - structure_analysis
+      - dependency_analysis
+      - test_doc_analysis
+    creates:
+      - debt_inventory
+      - debt_categorization
+      - prioritized_debt
+      - remediation_roadmap
+    notes: |
+      Phase 5: Aggregate and categorize technical debt from all analysis phases.
+      Uses TechnicalDebtAnalyzer to prioritize and generate recommendations.
+    output: |
+      - Technical debt inventory
+      - Debt categorization (code, architecture, dependencies, tests, docs)
+      - Prioritized debt list
+      - Remediation recommendations
+
+  - step: modernization_roadmap
+    agent: analyst
+    action: analyze-brownfield
+    parameters:
+      phase: modernization
+    requires:
+      - technical_debt_assessment
+    creates:
+      - modernization_opportunities
+      - prioritized_improvements
+      - effort_estimates
+      - implementation_roadmap
+    notes: |
+      Phase 8: Generate modernization roadmap with prioritized improvements.
+      Uses ModernizationRoadmapGenerator to synthesize all findings.
+    output: |
+      - Modernization opportunities list
+      - Prioritized improvement plan
+      - Effort estimates
+      - Implementation timeline
+
+  - step: generate_report
+    agent: analyst
+    action: analyze-brownfield
+    parameters:
+      phase: report_generation
+    requires:
+      - modernization_roadmap
+    creates:
+      - comprehensive_report_json
+      - comprehensive_report_markdown
+      - comprehensive_report_html
+    notes: |
+      Final step: Generate comprehensive reports in multiple formats.
+      Consolidates all phase results into unified reports.
+    output: |
+      - JSON report (machine-readable)
+      - Markdown report (human-readable)
+      - HTML report (interactive dashboard)
+
+gates:
+  - name: discovery_complete
+    condition: discovery.status == "success"
+    message: "Discovery phase must complete successfully"
+    
+  - name: quality_analysis_complete
+    condition: quality_analysis.status == "success"
+    message: "Quality analysis phase must complete successfully"
+
+outputs:
+  reports:
+    - type: json
+      path: reports/brownfield-analysis/analysis-report.json
+      description: "Complete analysis results in JSON format"
+    - type: markdown
+      path: reports/brownfield-analysis/analysis-report.md
+      description: "Human-readable markdown report"
+    - type: html
+      path: reports/brownfield-analysis/analysis-report.html
+      description: "Interactive HTML dashboard"
+
+metadata:
+  version: "1.0.0"
+  created: "2025-01-XX"
+  author: "TappsCodingAgents Framework"
+  estimated_duration: "15-30 minutes"
+  complexity: "high"
+  project_types:
+    - brownfield
+    - existing-project
+    - legacy-modernization
+    - codebase-assessment
+

tapps_agents/resources/workflows/presets/fix.yaml

@@ -0,0 +1,78 @@
+# Fix Workflow
+# Best for: Bug fixes, hotfixes, maintenance, refactoring. Replaces maintenance, quick-fix, simple-fix-issues.
+
+workflow:
+  id: fix
+  name: "Fix"
+  description: "Debug, fix, and verify issues in existing code"
+  version: "1.0.0"
+
+  type: brownfield
+  auto_detect: true
+
+  settings:
+    quality_gates: true
+    code_scoring: true
+    context_tier_default: 2
+
+  steps:
+    - id: enhance
+      agent: enhancer
+      action: enhance_prompt
+      context_tier: 1
+      creates:
+        - enhanced-requirements.md
+      requires: []
+      condition: optional
+      next: debug
+
+    - id: debug
+      agent: debugger
+      action: analyze_error
+      context_tier: 2
+      requires: []
+      creates:
+        - debug-report.md
+      next: fix
+
+    - id: fix
+      agent: implementer
+      action: write_code
+      context_tier: 3
+      requires:
+        - debug-report.md
+      creates:
+        - fixed-code/
+      next: review
+
+    - id: review
+      agent: reviewer
+      action: review_code
+      context_tier: 2
+      requires:
+        - fixed-code/
+      scoring:
+        enabled: true
+        thresholds:
+          overall_min: 65
+          security_min: 6.5
+      gate:
+        condition: "scoring.passed == true"
+        on_pass: testing
+        on_fail: fix
+      next: testing
+
+    - id: testing
+      agent: tester
+      action: write_tests
+      context_tier: 2
+      requires:
+        - fixed-code/
+      creates:
+        - tests/
+      next: complete
+
+    - id: complete
+      agent: orchestrator
+      action: finalize
+      context_tier: 1

tapps_agents/resources/workflows/presets/full-sdlc.yaml

@@ -0,0 +1,122 @@
+# Full SDLC Pipeline Workflow
+# Best for: Enterprise projects, new applications, compliance-heavy systems
+
+workflow:
+  id: full-sdlc
+  name: "Full SDLC Pipeline"
+  description: "Complete software development lifecycle with all quality gates"
+  version: "1.0.0"
+  
+  type: greenfield
+  auto_detect: true
+  
+  settings:
+    quality_gates: true
+    code_scoring: true
+    context_tier_default: 2
+  
+  steps:
+    - id: requirements
+      agent: analyst
+      action: gather_requirements
+      context_tier: 1
+      creates:
+        - requirements.md
+      requires: []
+      condition: required
+      next: planning
+      
+    - id: planning
+      agent: planner
+      action: create_stories
+      context_tier: 1
+      requires:
+        - requirements.md
+      creates:
+        - stories/
+      next: design
+      
+    - id: design
+      agent: architect
+      action: design_system
+      context_tier: 2
+      requires:
+        - requirements.md
+        - stories/
+      creates:
+        - architecture.md
+      next: api_design
+      
+    - id: api_design
+      agent: designer
+      action: api_design
+      context_tier: 2
+      requires:
+        - architecture.md
+      creates:
+        - api-specs/
+      next: implementation
+      
+    - id: implementation
+      agent: implementer
+      action: write_code
+      context_tier: 3
+      requires:
+        - architecture.md
+        - api-specs/
+        - stories/
+      creates:
+        - src/
+      next: review
+      
+    - id: review
+      agent: reviewer
+      action: review_code
+      context_tier: 2
+      requires:
+        - src/
+      scoring:
+        enabled: true
+        thresholds:
+          overall_min: 70
+          security_min: 7.0
+          maintainability_min: 7.0
+      gate:
+        condition: "scoring.passed == true"
+        on_pass: testing
+        on_fail: implementation
+      next: testing
+      
+    - id: testing
+      agent: tester
+      action: write_tests
+      context_tier: 2
+      requires:
+        - src/
+      creates:
+        - tests/
+      next: security
+      
+    - id: security
+      agent: ops
+      action: security_scan
+      context_tier: 1
+      requires:
+        - src/
+      next: documentation
+      
+    - id: documentation
+      agent: documenter
+      action: generate_docs
+      context_tier: 1
+      requires:
+        - src/
+      creates:
+        - docs/
+      next: complete
+      
+    - id: complete
+      agent: orchestrator
+      action: finalize
+      context_tier: 1
+

tapps_agents/resources/workflows/presets/quality.yaml

@@ -0,0 +1,82 @@
+# Quality-Focused Workflow
+# Best for: Code quality initiatives, refactoring sprints, quality gates
+
+workflow:
+  id: quality
+  name: "Quality Improvement"
+  description: "Comprehensive code review and improvement cycle"
+  version: "1.0.0"
+  
+  type: brownfield
+  auto_detect: true
+  
+  settings:
+    quality_gates: true
+    code_scoring: true
+    context_tier_default: 2
+  
+  steps:
+    - id: initial_review
+      agent: reviewer
+      action: review_code
+      context_tier: 2
+      requires: []
+      scoring:
+        enabled: true
+        thresholds:
+          overall_min: 0
+      creates:
+        - review-report.md
+      next: improve
+      
+    - id: improve
+      agent: improver
+      action: refactor
+      context_tier: 3
+      requires:
+        - review-report.md
+      creates:
+        - improved-code/
+      next: re_review
+      
+    - id: re_review
+      agent: reviewer
+      action: review_code
+      context_tier: 2
+      requires:
+        - improved-code/
+      scoring:
+        enabled: true
+        thresholds:
+          overall_min: 75
+          maintainability_min: 8.0
+          security_min: 7.5
+      gate:
+        condition: "scoring.passed == true"
+        on_pass: testing
+        on_fail: improve
+      next: testing
+      
+    - id: testing
+      agent: tester
+      action: write_tests
+      context_tier: 2
+      requires:
+        - improved-code/
+      creates:
+        - tests/
+      next: security
+      
+    - id: security
+      agent: ops
+      action: security_scan
+      context_tier: 1
+      requires:
+        - improved-code/
+      next: complete
+      
+    - id: complete
+      agent: orchestrator
+      action: finalize
+      context_tier: 1
+

tapps_agents/resources/workflows/presets/rapid-dev.yaml

@@ -0,0 +1,84 @@
+# Rapid Development Workflow
+# Best for: Feature development, sprint work, iterative development
+
+workflow:
+  id: rapid-dev
+  name: "Rapid Development"
+  description: "Fast feature development with quality checks"
+  version: "1.0.0"
+  
+  type: brownfield
+  auto_detect: true
+  
+  settings:
+    quality_gates: true
+    code_scoring: true
+    context_tier_default: 2
+  
+  steps:
+    - id: enhance
+      agent: enhancer
+      action: enhance_prompt
+      context_tier: 1
+      creates:
+        - enhanced-requirements.md
+      requires: []
+      condition: optional
+      next: planning
+      
+    - id: planning
+      agent: planner
+      action: create_stories
+      context_tier: 1
+      requires: []
+      creates:
+        - stories/
+      next: implementation
+      
+    - id: implementation
+      agent: implementer
+      action: write_code
+      context_tier: 3
+      requires:
+        - stories/
+      creates:
+        - src/
+      next: review
+      
+    - id: review
+      agent: reviewer
+      action: review_code
+      context_tier: 2
+      requires:
+        - src/
+      scoring:
+        enabled: true
+        thresholds:
+          overall_min: 65
+          security_min: 6.5
+      gate:
+        condition: "scoring.passed == true"
+        on_pass: testing
+        on_fail: implementation
+      next: testing
+      
+    - id: testing
+      agent: tester
+      action: write_tests
+      context_tier: 2
+      requires:
+        - src/
+      creates:
+        - tests/
+      condition: mandatory
+      gate:
+        condition: "test_coverage >= 70"
+        on_pass: complete
+        on_fail: testing
+      next: complete
+      
+    - id: complete
+      agent: orchestrator
+      action: finalize
+      context_tier: 1
+

tapps_agents/session/__init__.py

@@ -1,19 +1,19 @@
-"""
-CLI session lifecycle for TappsCodingAgents.
-
-Provides session tracking (session ID), SessionStart on first command,
-SessionEnd on process exit via atexit, and optional session log/state
-under .tapps-agents/sessions/.
-"""
-
-from .manager import (
-    get_session_id,
-    ensure_session_started,
-    register_session_end_atexit,
-)
-
-__all__ = [
-    "get_session_id",
-    "ensure_session_started",
-    "register_session_end_atexit",
-]
+"""
+CLI session lifecycle for TappsCodingAgents.
+
+Provides session tracking (session ID), SessionStart on first command,
+SessionEnd on process exit via atexit, and optional session log/state
+under .tapps-agents/sessions/.
+"""
+
+from .manager import (
+    get_session_id,
+    ensure_session_started,
+    register_session_end_atexit,
+)
+
+__all__ = [
+    "get_session_id",
+    "ensure_session_started",
+    "register_session_end_atexit",
+]