empathy-framework 4.6.6__py3-none-any.whl → 4.7.0__py3-none-any.whl

empathy_os/scaffolding/cli.py

@@ -1,9 +1,9 @@
-"""CLI for wizard scaffolding.
+"""CLI for workflow scaffolding.
 
 Usage:
-    python -m scaffolding create my_wizard --domain healthcare
-    python -m scaffolding create my_wizard --methodology tdd --domain finance
-    python -m scaffolding create my_wizard --interactive
+    python -m scaffolding create my_workflow --domain healthcare
+    python -m scaffolding create my_workflow --methodology tdd --domain finance
+    python -m scaffolding create my_workflow --interactive
 
 Copyright 2025 Smart AI Memory, LLC
 Licensed under Fair Source 0.9
@@ -26,29 +26,29 @@ logger = logging.getLogger(__name__)
 
 
 def cmd_create(args):
-    """Create a new wizard using specified methodology.
+    """Create a new workflow using specified methodology.
 
     Args:
         args: Command line arguments
 
     """
-    wizard_name = args.name
+    workflow_name = args.name
     domain = args.domain or "general"
-    wizard_type = args.type or "domain"
+    workflow_type = args.type or "domain"
     methodology = args.methodology or "pattern"
 
     print(f"\n{'=' * 60}")
-    print(f"Creating Wizard: {wizard_name}")
+    print(f"Creating Workflow: {workflow_name}")
     print(f"{'=' * 60}\n")
     print(f"Domain: {domain}")
-    print(f"Type: {wizard_type}")
+    print(f"Type: {workflow_type}")
     print(f"Methodology: {methodology}")
     print()
 
     # Get pattern recommendations
     registry = get_pattern_registry()
-    recommended = registry.recommend_for_wizard(
-        wizard_type=wizard_type,
+    recommended = registry.recommend_for_workflow(
+        workflow_type=workflow_type,
         domain=domain,
     )
 
@@ -82,23 +82,23 @@ def cmd_create(args):
     for pid in selected_patterns:
         print(f"  - {pid}")
 
-    # Create wizard using selected methodology
-    print(f"\nCreating wizard with {methodology} methodology...")
+    # Create workflow using selected methodology
+    print(f"\nCreating workflow with {methodology} methodology...")
 
     if methodology == "pattern":
         method = PatternCompose()
-        result = method.create_wizard(
-            name=wizard_name,
+        result = method.create_workflow(
+            name=workflow_name,
             domain=domain,
-            wizard_type=wizard_type,
+            workflow_type=workflow_type,
             selected_patterns=selected_patterns,
         )
     elif methodology == "tdd":
         method = TDDFirst()
-        result = method.create_wizard(
-            name=wizard_name,
+        result = method.create_workflow(
+            name=workflow_name,
             domain=domain,
-            wizard_type=wizard_type,
+            workflow_type=workflow_type,
             pattern_ids=selected_patterns,
         )
     else:
@@ -107,7 +107,7 @@ def cmd_create(args):
 
     # Display results
     print(f"\n{'=' * 60}")
-    print("✅ Wizard Created Successfully!")
+    print("✅ Workflow Created Successfully!")
     print(f"{'=' * 60}\n")
 
     print("Generated Files:")
@@ -162,21 +162,21 @@ def cmd_list_patterns(args):
 def main():
     """Main CLI entry point."""
     parser = argparse.ArgumentParser(
-        description="Wizard Scaffolding for Empathy Framework",
+        description="Workflow Scaffolding for Empathy Framework",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""
 Examples:
-  # Create healthcare wizard (recommended approach)
+  # Create healthcare workflow (recommended approach)
   %(prog)s create patient_intake --domain healthcare
 
   # Create with TDD methodology
-  %(prog)s create my_wizard --methodology tdd --domain finance
+  %(prog)s create my_workflow --methodology tdd --domain finance
 
   # Interactive pattern selection
-  %(prog)s create my_wizard --interactive --domain legal
+  %(prog)s create my_workflow --interactive --domain legal
 
   # Specify patterns manually
-  %(prog)s create my_wizard --patterns linear_flow,approval,structured_fields
+  %(prog)s create my_workflow --patterns linear_flow,approval,structured_fields
 
   # List available patterns
   %(prog)s list-patterns
@@ -186,8 +186,8 @@ Examples:
     subparsers = parser.add_subparsers(dest="command", help="Command to run")
 
     # Create command
-    create_parser = subparsers.add_parser("create", help="Create a new wizard")
-    create_parser.add_argument("name", help="Wizard name (e.g., patient_intake)")
+    create_parser = subparsers.add_parser("create", help="Create a new workflow")
+    create_parser.add_argument("name", help="Workflow name (e.g., patient_intake)")
     create_parser.add_argument(
         "--domain",
         "-d",
@@ -197,7 +197,7 @@ Examples:
         "--type",
         "-t",
         choices=["domain", "coach", "ai"],
-        help="Wizard type (default: domain)",
+        help="Workflow type (default: domain)",
     )
     create_parser.add_argument(
         "--methodology",

empathy_os/socratic/__init__.py

@@ -43,12 +43,7 @@ from .ab_testing import (
     Variant,
     WorkflowABTester,
 )
-from .blueprint import (
-    AgentBlueprint,
-    AgentSpec,
-    ToolSpec,
-    WorkflowBlueprint,
-)
+from .blueprint import AgentBlueprint, AgentSpec, ToolSpec, WorkflowBlueprint
 
 # CLI interface
 from .cli import Console
@@ -110,13 +105,7 @@ from .feedback import (
     FeedbackLoop,
     WorkflowPattern,
 )
-from .forms import (
-    FieldType,
-    Form,
-    FormField,
-    FormResponse,
-    ValidationResult,
-)
+from .forms import FieldType, Form, FormField, FormResponse, ValidationResult
 from .generator import AgentGenerator
 
 # LLM-powered analysis
@@ -133,12 +122,7 @@ from .mcp_server import SOCRATIC_TOOLS, SocraticMCPServer
 from .session import SessionState, SocraticSession
 
 # Persistent storage
-from .storage import (
-    JSONFileStorage,
-    SQLiteStorage,
-    StorageBackend,
-    StorageManager,
-)
+from .storage import JSONFileStorage, SQLiteStorage, StorageBackend, StorageManager
 from .success import MetricType, SuccessCriteria, SuccessMetric
 
 # Visual editor

empathy_os/socratic/ab_testing.py

@@ -166,24 +166,16 @@ class Experiment:
             variants=[Variant.from_dict(v) for v in data["variants"]],
             domain_filter=data.get("domain_filter"),
             goal_filter=data.get("goal_filter"),
-            allocation_strategy=AllocationStrategy(
-                data.get("allocation_strategy", "fixed")
-            ),
+            allocation_strategy=AllocationStrategy(data.get("allocation_strategy", "fixed")),
             min_sample_size=data.get("min_sample_size", 100),
             max_duration_days=data.get("max_duration_days", 30),
             confidence_level=data.get("confidence_level", 0.95),
             status=ExperimentStatus(data.get("status", "draft")),
             created_at=datetime.fromisoformat(data["created_at"]),
             started_at=(
-                datetime.fromisoformat(data["started_at"])
-                if data.get("started_at")
-                else None
-            ),
-            ended_at=(
-                datetime.fromisoformat(data["ended_at"])
-                if data.get("ended_at")
-                else None
+                datetime.fromisoformat(data["started_at"]) if data.get("started_at") else None
             ),
+            ended_at=(datetime.fromisoformat(data["ended_at"]) if data.get("ended_at") else None),
         )
 
     @property
@@ -360,7 +352,7 @@ class StatisticalAnalyzer:
         # Continued fraction approximation (simplified)
         result = 0.0
         for k in range(100):
-            term = (x ** k) * math.gamma(a + k) / (math.gamma(k + 1) * math.gamma(a))
+            term = (x**k) * math.gamma(a + k) / (math.gamma(k + 1) * math.gamma(a))
             result += term * ((1 - x) ** b) / (a + k)
             if abs(term) < 1e-10:
                 break
@@ -421,10 +413,12 @@ class TrafficAllocator:
     def _fixed_allocation(self, user_id: str) -> Variant:
         """Deterministic allocation based on user ID hash."""
         # Hash user ID for consistent assignment (not for security)
-        hash_val = int(hashlib.md5(
-            f"{self.experiment.experiment_id}:{user_id}".encode(),
-            usedforsecurity=False
-        ).hexdigest(), 16)
+        hash_val = int(
+            hashlib.md5(
+                f"{self.experiment.experiment_id}:{user_id}".encode(), usedforsecurity=False
+            ).hexdigest(),
+            16,
+        )
         bucket = hash_val % 100
 
         cumulative = 0.0
@@ -471,12 +465,10 @@ class TrafficAllocator:
         for variant in self.experiment.variants:
             if variant.impressions == 0:
                 # Give unvisited variants high priority
-                ucb_scores.append((float('inf'), variant))
+                ucb_scores.append((float("inf"), variant))
             else:
                 mean = variant.avg_success_score
-                exploration = math.sqrt(
-                    2 * math.log(total_impressions) / variant.impressions
-                )
+                exploration = math.sqrt(2 * math.log(total_impressions) / variant.impressions)
                 ucb = mean + exploration
                 ucb_scores.append((ucb, variant))
 
@@ -532,9 +524,7 @@ class ExperimentManager:
         Returns:
             Created experiment
         """
-        experiment_id = hashlib.sha256(
-            f"{name}:{time.time()}".encode()
-        ).hexdigest()[:12]
+        experiment_id = hashlib.sha256(f"{name}:{time.time()}".encode()).hexdigest()[:12]
 
         # Create variants
         num_variants = 1 + len(treatment_configs)
@@ -552,14 +542,16 @@ class ExperimentManager:
         ]
 
         for i, config in enumerate(treatment_configs):
-            variants.append(Variant(
-                variant_id=f"{experiment_id}_treatment_{i}",
-                name=config.get("name", f"Treatment {i + 1}"),
-                description=config.get("description", ""),
-                config=config.get("config", config),
-                is_control=False,
-                traffic_percentage=traffic_each,
-            ))
+            variants.append(
+                Variant(
+                    variant_id=f"{experiment_id}_treatment_{i}",
+                    name=config.get("name", f"Treatment {i + 1}"),
+                    description=config.get("description", ""),
+                    config=config.get("config", config),
+                    is_control=False,
+                    traffic_percentage=traffic_each,
+                )
+            )
 
         experiment = Experiment(
             experiment_id=experiment_id,
@@ -724,8 +716,7 @@ class ExperimentManager:
         # Calculate lift
         if control.conversion_rate > 0:
             lift = (
-                (best_treatment.conversion_rate - control.conversion_rate)
-                / control.conversion_rate
+                (best_treatment.conversion_rate - control.conversion_rate) / control.conversion_rate
             ) * 100
         else:
             lift = 0.0
@@ -750,9 +741,7 @@ class ExperimentManager:
                 )
             else:
                 winner = control
-                recommendation = (
-                    "Keep control. Treatment did not show improvement."
-                )
+                recommendation = "Keep control. Treatment did not show improvement."
         else:
             recommendation = (
                 f"No significant difference detected (p={p_value:.4f}). "

empathy_os/socratic/blueprint.py

@@ -404,27 +404,21 @@ class WorkflowBlueprint:
         # Validate all agents
         for agent in self.agents:
             if not agent.validate():
-                errors.extend(
-                    f"Agent '{agent.spec.id}': {e}" for e in agent.validation_errors
-                )
+                errors.extend(f"Agent '{agent.spec.id}': {e}" for e in agent.validation_errors)
 
         # Validate stages reference valid agents
         agent_ids = {a.spec.id for a in self.agents}
         for stage in self.stages:
             for agent_id in stage.agent_ids:
                 if agent_id not in agent_ids:
-                    errors.append(
-                        f"Stage '{stage.id}' references unknown agent '{agent_id}'"
-                    )
+                    errors.append(f"Stage '{stage.id}' references unknown agent '{agent_id}'")
 
         # Validate stage dependencies
         stage_ids = {s.id for s in self.stages}
         for stage in self.stages:
             for dep in stage.depends_on:
                 if dep not in stage_ids:
-                    errors.append(
-                        f"Stage '{stage.id}' depends on unknown stage '{dep}'"
-                    )
+                    errors.append(f"Stage '{stage.id}' depends on unknown stage '{dep}'")
 
         return len(errors) == 0, errors
 
@@ -497,37 +491,43 @@ class WorkflowBlueprint:
 
             # Parse tools
             for tool_data in spec_data.get("tools", []):
-                spec.tools.append(ToolSpec(
-                    id=tool_data.get("id", ""),
-                    name=tool_data.get("name", ""),
-                    category=ToolCategory(tool_data.get("category", "code_analysis")),
-                    description=tool_data.get("description", ""),
-                    parameters=tool_data.get("parameters", {}),
-                    requires_confirmation=tool_data.get("requires_confirmation", False),
-                    is_mutating=tool_data.get("is_mutating", False),
-                    cost_tier=tool_data.get("cost_tier", "cheap"),
-                ))
-
-            blueprint.agents.append(AgentBlueprint(
-                spec=spec,
-                generated_from=agent_data.get("generated_from", "socratic"),
-                template_id=agent_data.get("template_id"),
-                customizations=agent_data.get("customizations", {}),
-            ))
+                spec.tools.append(
+                    ToolSpec(
+                        id=tool_data.get("id", ""),
+                        name=tool_data.get("name", ""),
+                        category=ToolCategory(tool_data.get("category", "code_analysis")),
+                        description=tool_data.get("description", ""),
+                        parameters=tool_data.get("parameters", {}),
+                        requires_confirmation=tool_data.get("requires_confirmation", False),
+                        is_mutating=tool_data.get("is_mutating", False),
+                        cost_tier=tool_data.get("cost_tier", "cheap"),
+                    )
+                )
+
+            blueprint.agents.append(
+                AgentBlueprint(
+                    spec=spec,
+                    generated_from=agent_data.get("generated_from", "socratic"),
+                    template_id=agent_data.get("template_id"),
+                    customizations=agent_data.get("customizations", {}),
+                )
+            )
 
         # Parse stages
         for stage_data in data.get("stages", []):
-            blueprint.stages.append(StageSpec(
-                id=stage_data.get("id", ""),
-                name=stage_data.get("name", ""),
-                description=stage_data.get("description", ""),
-                agent_ids=stage_data.get("agent_ids", []),
-                parallel=stage_data.get("parallel", False),
-                run_when=stage_data.get("run_when"),
-                depends_on=stage_data.get("depends_on", []),
-                input_mapping=stage_data.get("input_mapping", {}),
-                output_aggregation=stage_data.get("output_aggregation", "merge"),
-                timeout=stage_data.get("timeout", 300),
-            ))
+            blueprint.stages.append(
+                StageSpec(
+                    id=stage_data.get("id", ""),
+                    name=stage_data.get("name", ""),
+                    description=stage_data.get("description", ""),
+                    agent_ids=stage_data.get("agent_ids", []),
+                    parallel=stage_data.get("parallel", False),
+                    run_when=stage_data.get("run_when"),
+                    depends_on=stage_data.get("depends_on", []),
+                    input_mapping=stage_data.get("input_mapping", {}),
+                    output_aggregation=stage_data.get("output_aggregation", "merge"),
+                    timeout=stage_data.get("timeout", 300),
+                )
+            )
 
         return blueprint

empathy_os/socratic/cli.py

@@ -109,17 +109,13 @@ class Console:
                     widths[i] = max(widths[i], len(str(cell)))
 
         # Print header
-        header_line = " | ".join(
-            self._c("bold", h.ljust(widths[i])) for i, h in enumerate(headers)
-        )
+        header_line = " | ".join(self._c("bold", h.ljust(widths[i])) for i, h in enumerate(headers))
         print(header_line)
         print("-" * (sum(widths) + len(widths) * 3 - 1))
 
         # Print rows
         for row in rows:
-            row_line = " | ".join(
-                str(cell).ljust(widths[i]) for i, cell in enumerate(row)
-            )
+            row_line = " | ".join(str(cell).ljust(widths[i]) for i, cell in enumerate(row))
             print(row_line)
 
 
@@ -469,12 +465,18 @@ def cmd_list(args: argparse.Namespace) -> int:
     headers = ["ID", "State", "Goal", "Updated"]
     rows = []
     for s in sessions:
-        rows.append([
-            s["session_id"][:8],
-            s["state"],
-            (s.get("goal") or "")[:40] + "..." if len(s.get("goal") or "") > 40 else s.get("goal") or "",
-            s.get("updated_at", "")[:16],
-        ])
+        rows.append(
+            [
+                s["session_id"][:8],
+                s["state"],
+                (
+                    (s.get("goal") or "")[:40] + "..."
+                    if len(s.get("goal") or "") > 40
+                    else s.get("goal") or ""
+                ),
+                s.get("updated_at", "")[:16],
+            ]
+        )
 
     console.table(headers, rows)
     return 0
@@ -495,13 +497,15 @@ def cmd_blueprints(args: argparse.Namespace) -> int:
     headers = ["ID", "Name", "Domain", "Agents", "Generated"]
     rows = []
     for b in blueprints:
-        rows.append([
-            b["id"][:8] if b.get("id") else "?",
-            b.get("name", "")[:30],
-            b.get("domain", ""),
-            str(b.get("agents_count", 0)),
-            (b.get("generated_at") or "")[:16],
-        ])
+        rows.append(
+            [
+                b["id"][:8] if b.get("id") else "?",
+                b.get("name", "")[:30],
+                b.get("domain", ""),
+                str(b.get("agents_count", 0)),
+                (b.get("generated_at") or "")[:16],
+            ]
+        )
 
     console.table(headers, rows)
     return 0
@@ -625,7 +629,17 @@ def create_parser() -> argparse.ArgumentParser:
 
     # list
     list_parser = subparsers.add_parser("list", help="List sessions")
-    list_parser.add_argument("--state", "-s", choices=["awaiting_goal", "awaiting_answers", "ready_to_generate", "completed", "cancelled"])
+    list_parser.add_argument(
+        "--state",
+        "-s",
+        choices=[
+            "awaiting_goal",
+            "awaiting_answers",
+            "ready_to_generate",
+            "completed",
+            "cancelled",
+        ],
+    )
     list_parser.add_argument("--limit", "-n", type=int, default=20)
 
     # blueprints

empathy_os/socratic/collaboration.py

@@ -348,9 +348,7 @@ class CollaborationManager:
         Returns:
             The created session
         """
-        session_id = hashlib.sha256(
-            f"{base_session_id}:{time.time()}".encode()
-        ).hexdigest()[:12]
+        session_id = hashlib.sha256(f"{base_session_id}:{time.time()}".encode()).hexdigest()[:12]
 
         owner = Participant(
             user_id=owner_id,
@@ -485,9 +483,9 @@ class CollaborationManager:
         if not author:
             return None
 
-        comment_id = hashlib.sha256(
-            f"{session_id}:{author_id}:{time.time()}".encode()
-        ).hexdigest()[:12]
+        comment_id = hashlib.sha256(f"{session_id}:{author_id}:{time.time()}".encode()).hexdigest()[
+            :12
+        ]
 
         comment = Comment(
             comment_id=comment_id,
@@ -614,9 +612,14 @@ class CollaborationManager:
 
         # Check if already voted
         existing = next(
-            (v for v in session.votes
-             if v.voter_id == voter_id and v.target_type == target_type and v.target_id == target_id),
-            None
+            (
+                v
+                for v in session.votes
+                if v.voter_id == voter_id
+                and v.target_type == target_type
+                and v.target_id == target_id
+            ),
+            None,
         )
         if existing:
             # Update existing vote
@@ -676,8 +679,7 @@ class CollaborationManager:
 
         # Get votes for this target
         votes = [
-            v for v in session.votes
-            if v.target_type == target_type and v.target_id == target_id
+            v for v in session.votes if v.target_type == target_type and v.target_id == target_id
         ]
 
         # Count by type
@@ -686,10 +688,7 @@ class CollaborationManager:
         abstentions = sum(1 for v in votes if v.vote_type == VoteType.ABSTAIN)
 
         # Calculate quorum
-        eligible_voters = [
-            p for p in session.participants
-            if p.role != ParticipantRole.VIEWER
-        ]
+        eligible_voters = [p for p in session.participants if p.role != ParticipantRole.VIEWER]
         participation_rate = len(votes) / len(eligible_voters) if eligible_voters else 0
         quorum_reached = participation_rate >= session.quorum
 
@@ -731,8 +730,7 @@ class CollaborationManager:
             return []
 
         comments = [
-            c for c in session.comments
-            if c.target_type == target_type and c.target_id == target_id
+            c for c in session.comments if c.target_type == target_type and c.target_id == target_id
         ]
 
         if not include_resolved:
@@ -786,8 +784,7 @@ class CollaborationManager:
         session = self._sessions.get(session_id)
         if session:
             self._track_change(
-                session, change_type, author_id, description,
-                before_value, after_value
+                session, change_type, author_id, description, before_value, after_value
             )
             self._save_session(session)
 
@@ -818,9 +815,7 @@ class CollaborationManager:
         after_value: Any = None,
     ):
         """Internal method to track a change."""
-        change_id = hashlib.sha256(
-            f"{session.session_id}:{time.time()}".encode()
-        ).hexdigest()[:12]
+        change_id = hashlib.sha256(f"{session.session_id}:{time.time()}".encode()).hexdigest()[:12]
 
         change = Change(
             change_id=change_id,
@@ -836,7 +831,9 @@ class CollaborationManager:
         for listener in self._change_listeners:
             try:
                 listener(change)
-            except Exception:
+            except Exception:  # noqa: BLE001
+                # INTENTIONAL: Listener failure should not break change tracking.
+                # One bad listener shouldn't prevent others from executing.
                 pass
 
     def _save_session(self, session: CollaborativeSession):
@@ -853,7 +850,9 @@ class CollaborationManager:
                     data = json.load(f)
                 session = CollaborativeSession.from_dict(data)
                 self._sessions[session.session_id] = session
-            except Exception:
+            except Exception:  # noqa: BLE001
+                # INTENTIONAL: Skip corrupted session files gracefully.
+                # Loading should not fail due to one malformed file.
                 pass
 
     def list_sessions(self) -> list[CollaborativeSession]:
@@ -874,8 +873,7 @@ class CollaborationManager:
             List of sessions the user participates in
         """
         return [
-            s for s in self._sessions.values()
-            if any(p.user_id == user_id for p in s.participants)
+            s for s in self._sessions.values() if any(p.user_id == user_id for p in s.participants)
         ]
 
 
@@ -930,7 +928,9 @@ class SyncAdapter:
         for handler in self._event_handlers:
             try:
                 handler(event)
-            except Exception:
+            except Exception:  # noqa: BLE001
+                # INTENTIONAL: Handler failure should not prevent other handlers.
+                # Event propagation must continue for sync reliability.
                 pass
 
     def on_event(self, handler: Callable[[SyncEvent], None]):
@@ -1038,6 +1038,7 @@ class InvitationManager:
         ).hexdigest()[:16]
 
         from datetime import timedelta
+
         expires = datetime.now() + timedelta(hours=expires_hours)
 
         invitation = Invitation(
@@ -1105,7 +1106,8 @@ class InvitationManager:
         """
         now = datetime.now()
         return [
-            inv for inv in self._invitations.values()
+            inv
+            for inv in self._invitations.values()
             if inv.session_id == session_id
             and not inv.accepted
             and (inv.expires_at is None or inv.expires_at > now)

empathy_os/socratic/domain_templates.py

@@ -777,7 +777,15 @@ class DomainTemplateRegistry:
             agents=[SECURITY_SCANNER, COMPLIANCE_AUDITOR, RESULT_SYNTHESIZER],
             workflows=[SECURITY_AUDIT_WORKFLOW],
             default_workflow="security_audit_comprehensive",
-            keywords=["security", "vulnerability", "audit", "compliance", "penetration", "CVE", "OWASP"],
+            keywords=[
+                "security",
+                "vulnerability",
+                "audit",
+                "compliance",
+                "penetration",
+                "CVE",
+                "OWASP",
+            ],
             required_tools=["read_file", "security_scan"],
             optional_tools=["grep_code", "analyze_ast"],
         )