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

tapps_agents/workflow/__init__.py

@@ -1,171 +1,171 @@
-"""Workflow Engine - YAML-based workflow orchestration.
-
-2025 Enhancements:
-- DurableWorkflowState: Event-sourced state with checkpoints for resume
-- Automatic recovery from any failure point
-- Complete audit trail via event log
-"""
-
-# Foreground Agent Artifacts (Epic 2)
-from .code_artifact import CodeArtifact, CodeChange
-from .context_artifact import (
-    ContextArtifact,
-    ContextQuery,
-    LibraryCacheEntry,
-    ProjectProfile,
-)
-from .dependency_resolver import DependencyGraph, DependencyResolver
-from .design_artifact import Component, DesignArtifact
-from .detector import (
-    ProjectCharacteristics,
-    ProjectDetector,
-    ProjectType,
-    WorkflowTrack,
-)
-
-# Background Agents removed - Artifact classes remain (data structures only)
-# Background Agent Artifacts (data structures, not Background Agent implementations)
-from .docs_artifact import DocFileResult, DocumentationArtifact
-
-# 2025: Durable Workflow State Machine
-from .durable_state import (
-    Checkpoint,
-    DurableWorkflowState,
-    EventStore,
-    EventType,
-    WorkflowEvent as DurableWorkflowEvent,
-    get_durable_state,
-    resume_workflow,
-)
-from .enhancement_artifact import EnhancementArtifact, EnhancementStage
-from .event_log import WorkflowEvent, WorkflowEventLog
-from .exceptions import (
-    DashboardGenerationError,
-    EmptyWorkflowError,
-    GraphGenerationError,
-    InvalidTraceError,
-    ObservabilityError,
-    OpenTelemetryExportError,
-)
-from .execution_graph import ExecutionGraph, ExecutionGraphGenerator
-from .executor import WorkflowExecutor
-from .graph_visualizer import GraphVisualizer
-from .observability_dashboard import ObservabilityDashboard
-from .logging_helper import WorkflowLogger
-from .messaging import (
-    FileMessageBus,
-    StatusUpdateMessage,
-    TaskAssignmentMessage,
-    TaskCompleteMessage,
-)
-from .models import (
-    Artifact,
-    Workflow,
-    WorkflowSettings,
-    WorkflowState,
-    WorkflowStep,
-    WorkflowType,
-)
-from .ops_artifact import (
-    ComplianceCheck,
-    DeploymentStep,
-    InfrastructureFile,
-    OperationsArtifact,
-    SecurityIssue,
-)
-from .parser import WorkflowParser
-from .planning_artifact import PlanningArtifact, UserStory
-from .progress_monitor import ProgressMetrics, WorkflowProgressMonitor
-from .quality_artifact import QualityArtifact, ToolResult
-from .recommender import (
-    WorkflowRecommendation,
-    WorkflowRecommender,
-)
-
-# Result Aggregation (Epic 2)
-from .result_aggregator import Conflict, ResultAggregator
-from .review_artifact import ReviewArtifact, ReviewComment
-from .schema_validator import SchemaVersion, ValidationError, WorkflowSchemaValidator
-from .testing_artifact import CoverageSummary, TestingArtifact, TestResult
-
-__all__ = [
-    "WorkflowParser",
-    "WorkflowExecutor",
-    "Workflow",
-    "WorkflowStep",
-    "WorkflowState",
-    "WorkflowType",
-    "Artifact",
-    "WorkflowSettings",
-    "FileMessageBus",
-    "TaskAssignmentMessage",
-    "StatusUpdateMessage",
-    "TaskCompleteMessage",
-    "WorkflowLogger",
-    "ProjectDetector",
-    "ProjectType",
-    "ProjectCharacteristics",
-    "WorkflowTrack",
-    "WorkflowRecommender",
-    "WorkflowRecommendation",
-    # Background Agents removed - Artifact classes remain (data structures only)
-    "DocumentationArtifact",
-    "DocFileResult",
-    "OperationsArtifact",
-    "SecurityIssue",
-    "ComplianceCheck",
-    "DeploymentStep",
-    "InfrastructureFile",
-    "ContextArtifact",
-    "LibraryCacheEntry",
-    "ContextQuery",
-    "ProjectProfile",
-    "QualityArtifact",
-    "ToolResult",
-    "TestingArtifact",
-    "TestResult",
-    "CoverageSummary",
-    # Foreground Agent Artifacts
-    "CodeArtifact",
-    "CodeChange",
-    "DesignArtifact",
-    "Component",
-    "ReviewArtifact",
-    "ReviewComment",
-    "PlanningArtifact",
-    "UserStory",
-    "EnhancementArtifact",
-    "EnhancementStage",
-    # Result Aggregation
-    "ResultAggregator",
-    "Conflict",
-    # Epic 5: Workflow Engine Enhancements
-    "WorkflowSchemaValidator",
-    "SchemaVersion",
-    "ValidationError",
-    "DependencyResolver",
-    "DependencyGraph",
-    "WorkflowEventLog",
-    "WorkflowEvent",
-    "WorkflowProgressMonitor",
-    "ProgressMetrics",
-    "ExecutionGraph",
-    "ExecutionGraphGenerator",
-    "GraphVisualizer",
-    "ObservabilityDashboard",
-    # Observability exceptions
-    "ObservabilityError",
-    "GraphGenerationError",
-    "EmptyWorkflowError",
-    "InvalidTraceError",
-    "DashboardGenerationError",
-    "OpenTelemetryExportError",
-    # 2025: Durable Workflow State Machine
-    "DurableWorkflowState",
-    "DurableWorkflowEvent",
-    "EventStore",
-    "EventType",
-    "Checkpoint",
-    "get_durable_state",
-    "resume_workflow",
-]
+"""Workflow Engine - YAML-based workflow orchestration.
+
+2025 Enhancements:
+- DurableWorkflowState: Event-sourced state with checkpoints for resume
+- Automatic recovery from any failure point
+- Complete audit trail via event log
+"""
+
+# Foreground Agent Artifacts (Epic 2)
+from .code_artifact import CodeArtifact, CodeChange
+from .context_artifact import (
+    ContextArtifact,
+    ContextQuery,
+    LibraryCacheEntry,
+    ProjectProfile,
+)
+from .dependency_resolver import DependencyGraph, DependencyResolver
+from .design_artifact import Component, DesignArtifact
+from .detector import (
+    ProjectCharacteristics,
+    ProjectDetector,
+    ProjectType,
+    WorkflowTrack,
+)
+
+# Background Agents removed - Artifact classes remain (data structures only)
+# Background Agent Artifacts (data structures, not Background Agent implementations)
+from .docs_artifact import DocFileResult, DocumentationArtifact
+
+# 2025: Durable Workflow State Machine
+from .durable_state import (
+    Checkpoint,
+    DurableWorkflowState,
+    EventStore,
+    EventType,
+    WorkflowEvent as DurableWorkflowEvent,
+    get_durable_state,
+    resume_workflow,
+)
+from .enhancement_artifact import EnhancementArtifact, EnhancementStage
+from .event_log import WorkflowEvent, WorkflowEventLog
+from .exceptions import (
+    DashboardGenerationError,
+    EmptyWorkflowError,
+    GraphGenerationError,
+    InvalidTraceError,
+    ObservabilityError,
+    OpenTelemetryExportError,
+)
+from .execution_graph import ExecutionGraph, ExecutionGraphGenerator
+from .executor import WorkflowExecutor
+from .graph_visualizer import GraphVisualizer
+from .observability_dashboard import ObservabilityDashboard
+from .logging_helper import WorkflowLogger
+from .messaging import (
+    FileMessageBus,
+    StatusUpdateMessage,
+    TaskAssignmentMessage,
+    TaskCompleteMessage,
+)
+from .models import (
+    Artifact,
+    Workflow,
+    WorkflowSettings,
+    WorkflowState,
+    WorkflowStep,
+    WorkflowType,
+)
+from .ops_artifact import (
+    ComplianceCheck,
+    DeploymentStep,
+    InfrastructureFile,
+    OperationsArtifact,
+    SecurityIssue,
+)
+from .parser import WorkflowParser
+from .planning_artifact import PlanningArtifact, UserStory
+from .progress_monitor import ProgressMetrics, WorkflowProgressMonitor
+from .quality_artifact import QualityArtifact, ToolResult
+from .recommender import (
+    WorkflowRecommendation,
+    WorkflowRecommender,
+)
+
+# Result Aggregation (Epic 2)
+from .result_aggregator import Conflict, ResultAggregator
+from .review_artifact import ReviewArtifact, ReviewComment
+from .schema_validator import SchemaVersion, ValidationError, WorkflowSchemaValidator
+from .testing_artifact import CoverageSummary, TestingArtifact, TestResult
+
+__all__ = [
+    "WorkflowParser",
+    "WorkflowExecutor",
+    "Workflow",
+    "WorkflowStep",
+    "WorkflowState",
+    "WorkflowType",
+    "Artifact",
+    "WorkflowSettings",
+    "FileMessageBus",
+    "TaskAssignmentMessage",
+    "StatusUpdateMessage",
+    "TaskCompleteMessage",
+    "WorkflowLogger",
+    "ProjectDetector",
+    "ProjectType",
+    "ProjectCharacteristics",
+    "WorkflowTrack",
+    "WorkflowRecommender",
+    "WorkflowRecommendation",
+    # Background Agents removed - Artifact classes remain (data structures only)
+    "DocumentationArtifact",
+    "DocFileResult",
+    "OperationsArtifact",
+    "SecurityIssue",
+    "ComplianceCheck",
+    "DeploymentStep",
+    "InfrastructureFile",
+    "ContextArtifact",
+    "LibraryCacheEntry",
+    "ContextQuery",
+    "ProjectProfile",
+    "QualityArtifact",
+    "ToolResult",
+    "TestingArtifact",
+    "TestResult",
+    "CoverageSummary",
+    # Foreground Agent Artifacts
+    "CodeArtifact",
+    "CodeChange",
+    "DesignArtifact",
+    "Component",
+    "ReviewArtifact",
+    "ReviewComment",
+    "PlanningArtifact",
+    "UserStory",
+    "EnhancementArtifact",
+    "EnhancementStage",
+    # Result Aggregation
+    "ResultAggregator",
+    "Conflict",
+    # Epic 5: Workflow Engine Enhancements
+    "WorkflowSchemaValidator",
+    "SchemaVersion",
+    "ValidationError",
+    "DependencyResolver",
+    "DependencyGraph",
+    "WorkflowEventLog",
+    "WorkflowEvent",
+    "WorkflowProgressMonitor",
+    "ProgressMetrics",
+    "ExecutionGraph",
+    "ExecutionGraphGenerator",
+    "GraphVisualizer",
+    "ObservabilityDashboard",
+    # Observability exceptions
+    "ObservabilityError",
+    "GraphGenerationError",
+    "EmptyWorkflowError",
+    "InvalidTraceError",
+    "DashboardGenerationError",
+    "OpenTelemetryExportError",
+    # 2025: Durable Workflow State Machine
+    "DurableWorkflowState",
+    "DurableWorkflowEvent",
+    "EventStore",
+    "EventType",
+    "Checkpoint",
+    "get_durable_state",
+    "resume_workflow",
+]

tapps_agents/workflow/acceptance_verifier.py

@@ -1,132 +1,132 @@
-"""
-Acceptance Criteria Verifier
-
-Verifies acceptance criteria for story-level workflow steps.
-Basic text matching implementation for Phase 3.
-"""
-
-from pathlib import Path
-from typing import Any
-
-from .models import Artifact
-
-
-class AcceptanceCriteriaVerifier:
-    """Verify acceptance criteria for stories (basic text matching)."""
-
-    def verify(
-        self,
-        criteria: list[str],
-        artifacts: dict[str, Artifact],
-        code_files: list[Path] | None = None,
-    ) -> dict[str, Any]:
-        """
-        Verify acceptance criteria against artifacts and code files.
-
-        Args:
-            criteria: List of acceptance criteria strings
-            artifacts: Dictionary of artifacts created by the step
-            code_files: Optional list of code file paths to check
-
-        Returns:
-            Dictionary with verification results:
-            {
-                "all_passed": bool,
-                "results": [
-                    {
-                        "criterion": str,
-                        "passed": bool,
-                        "evidence": str | None
-                    }
-                ]
-            }
-        """
-        results = []
-        all_passed = True
-
-        for criterion in criteria:
-            passed = False
-            evidence = None
-
-            # Simple text matching: check if criterion keywords appear in artifacts
-            criterion_lower = criterion.lower()
-
-            # Check artifacts
-            for artifact_name, artifact in artifacts.items():
-                artifact_content = self._get_artifact_content(artifact)
-                if artifact_content and self._matches_criterion(
-                    criterion_lower, artifact_content
-                ):
-                    passed = True
-                    evidence = f"Found in artifact: {artifact_name}"
-                    break
-
-            # Check code files if provided
-            if not passed and code_files:
-                for code_file in code_files:
-                    if code_file.exists():
-                        try:
-                            content = code_file.read_text(encoding="utf-8")
-                            if self._matches_criterion(criterion_lower, content):
-                                passed = True
-                                evidence = f"Found in code file: {code_file}"
-                                break
-                        except Exception:
-                            # Skip files that can't be read
-                            continue
-
-            if not passed:
-                all_passed = False
-
-            results.append(
-                {
-                    "criterion": criterion,
-                    "passed": passed,
-                    "evidence": evidence,
-                }
-            )
-
-        return {
-            "all_passed": all_passed,
-            "results": results,
-        }
-
-    def _get_artifact_content(self, artifact: Artifact) -> str | None:
-        """Extract text content from artifact for matching."""
-        if artifact.path:
-            artifact_path = Path(artifact.path)
-            if artifact_path.exists():
-                try:
-                    return artifact_path.read_text(encoding="utf-8")
-                except Exception:
-                    return None
-        return None
-
-    def _matches_criterion(self, criterion: str, content: str) -> bool:
-        """
-        Simple text matching: check if criterion keywords appear in content.
-
-        This is a basic implementation for Phase 3. Future enhancements could
-        use more sophisticated matching (semantic, structured parsing, etc.).
-        """
-        content_lower = content.lower()
-
-        # Extract key phrases from criterion (simple approach)
-        # Look for important keywords (skip common words)
-        common_words = {"the", "a", "an", "and", "or", "but", "in", "on", "at", "to", "for", "of", "with", "by"}
-        criterion_words = [
-            word.strip()
-            for word in criterion.split()
-            if word.strip().lower() not in common_words and len(word.strip()) > 2
-        ]
-
-        # Check if at least 50% of key words appear in content
-        if not criterion_words:
-            # If no keywords, check if criterion phrase appears
-            return criterion in content_lower
-
-        matches = sum(1 for word in criterion_words if word in content_lower)
-        match_ratio = matches / len(criterion_words) if criterion_words else 0
-
-        # Require at least 50% keyword match or exact phrase match
-        return match_ratio >= 0.5 or criterion in content_lower
+"""
+Acceptance Criteria Verifier
+
+Verifies acceptance criteria for story-level workflow steps.
+Basic text matching implementation for Phase 3.
+"""
+
+from pathlib import Path
+from typing import Any
+
+from .models import Artifact
+
+
+class AcceptanceCriteriaVerifier:
+    """Verify acceptance criteria for stories (basic text matching)."""
+
+    def verify(
+        self,
+        criteria: list[str],
+        artifacts: dict[str, Artifact],
+        code_files: list[Path] | None = None,
+    ) -> dict[str, Any]:
+        """
+        Verify acceptance criteria against artifacts and code files.
+
+        Args:
+            criteria: List of acceptance criteria strings
+            artifacts: Dictionary of artifacts created by the step
+            code_files: Optional list of code file paths to check
+
+        Returns:
+            Dictionary with verification results:
+            {
+                "all_passed": bool,
+                "results": [
+                    {
+                        "criterion": str,
+                        "passed": bool,
+                        "evidence": str | None
+                    }
+                ]
+            }
+        """
+        results = []
+        all_passed = True
+
+        for criterion in criteria:
+            passed = False
+            evidence = None
+
+            # Simple text matching: check if criterion keywords appear in artifacts
+            criterion_lower = criterion.lower()
+
+            # Check artifacts
+            for artifact_name, artifact in artifacts.items():
+                artifact_content = self._get_artifact_content(artifact)
+                if artifact_content and self._matches_criterion(
+                    criterion_lower, artifact_content
+                ):
+                    passed = True
+                    evidence = f"Found in artifact: {artifact_name}"
+                    break
+
+            # Check code files if provided
+            if not passed and code_files:
+                for code_file in code_files:
+                    if code_file.exists():
+                        try:
+                            content = code_file.read_text(encoding="utf-8")
+                            if self._matches_criterion(criterion_lower, content):
+                                passed = True
+                                evidence = f"Found in code file: {code_file}"
+                                break
+                        except Exception:
+                            # Skip files that can't be read
+                            continue
+
+            if not passed:
+                all_passed = False
+
+            results.append(
+                {
+                    "criterion": criterion,
+                    "passed": passed,
+                    "evidence": evidence,
+                }
+            )
+
+        return {
+            "all_passed": all_passed,
+            "results": results,
+        }
+
+    def _get_artifact_content(self, artifact: Artifact) -> str | None:
+        """Extract text content from artifact for matching."""
+        if artifact.path:
+            artifact_path = Path(artifact.path)
+            if artifact_path.exists():
+                try:
+                    return artifact_path.read_text(encoding="utf-8")
+                except Exception:
+                    return None
+        return None
+
+    def _matches_criterion(self, criterion: str, content: str) -> bool:
+        """
+        Simple text matching: check if criterion keywords appear in content.
+
+        This is a basic implementation for Phase 3. Future enhancements could
+        use more sophisticated matching (semantic, structured parsing, etc.).
+        """
+        content_lower = content.lower()
+
+        # Extract key phrases from criterion (simple approach)
+        # Look for important keywords (skip common words)
+        common_words = {"the", "a", "an", "and", "or", "but", "in", "on", "at", "to", "for", "of", "with", "by"}
+        criterion_words = [
+            word.strip()
+            for word in criterion.split()
+            if word.strip().lower() not in common_words and len(word.strip()) > 2
+        ]
+
+        # Check if at least 50% of key words appear in content
+        if not criterion_words:
+            # If no keywords, check if criterion phrase appears
+            return criterion in content_lower
+
+        matches = sum(1 for word in criterion_words if word in content_lower)
+        match_ratio = matches / len(criterion_words) if criterion_words else 0
+
+        # Require at least 50% keyword match or exact phrase match
+        return match_ratio >= 0.5 or criterion in content_lower