ouroboros-ai 0.2.3__py3-none-any.whl → 0.4.0__py3-none-any.whl

ouroboros/providers/claude_code_adapter.py

@@ -10,11 +10,24 @@ Usage:
         messages=[Message(role=MessageRole.USER, content="Hello!")],
         config=CompletionConfig(model="claude-sonnet-4-20250514"),
     )
+
+Custom CLI Path:
+    You can specify a custom Claude CLI binary path to use instead of
+    the SDK's bundled CLI. This is useful for:
+    - Using an instrumented CLI wrapper (e.g., for OTEL tracing)
+    - Testing with a specific CLI version
+    - Using a locally built CLI
+
+    Set via constructor parameter or environment variable:
+        adapter = ClaudeCodeAdapter(cli_path="/path/to/claude")
+        # or
+        export OUROBOROS_CLI_PATH=/path/to/claude
 """
 
 from __future__ import annotations
 
 import os
+from pathlib import Path
 
 import structlog
 
@@ -38,6 +51,10 @@ class ClaudeCodeAdapter:
     the Claude Agent SDK under the hood. This allows users to leverage
     their Claude Code Max Plan subscription without needing separate API keys.
 
+    Attributes:
+        cli_path: Path to the Claude CLI binary. If not set, the SDK will
+            use its bundled CLI. Set this to use a custom/instrumented CLI.
+
     Example:
         adapter = ClaudeCodeAdapter()
         result = await adapter.complete(
@@ -46,11 +63,15 @@ class ClaudeCodeAdapter:
         )
         if result.is_ok:
             print(result.value.content)
+
+    Example with custom CLI:
+        adapter = ClaudeCodeAdapter(cli_path="/usr/local/bin/claude")
     """
 
     def __init__(
         self,
         permission_mode: str = "default",
+        cli_path: str | Path | None = None,
     ) -> None:
         """Initialize Claude Code adapter.
 
@@ -58,12 +79,65 @@ class ClaudeCodeAdapter:
             permission_mode: Permission mode for SDK operations.
                 - "default": Standard permissions
                 - "acceptEdits": Auto-approve edits (not needed for interview)
+            cli_path: Path to the Claude CLI binary. If not provided,
+                checks OUROBOROS_CLI_PATH env var, then falls back to
+                SDK's bundled CLI.
         """
         self._permission_mode: str = permission_mode
+        self._cli_path: Path | None = self._resolve_cli_path(cli_path)
         log.info(
             "claude_code_adapter.initialized",
             permission_mode=permission_mode,
+            cli_path=str(self._cli_path) if self._cli_path else None,
+        )
+
+    def _resolve_cli_path(self, cli_path: str | Path | None) -> Path | None:
+        """Resolve the CLI path from parameter or environment variable.
+
+        Args:
+            cli_path: Explicit CLI path from constructor.
+
+        Returns:
+            Resolved Path if set and exists, None otherwise (falls back to SDK default).
+        """
+        # Priority: explicit parameter > environment variable > None (SDK default)
+        path_str = str(cli_path) if cli_path else os.environ.get("OUROBOROS_CLI_PATH", "")
+        path_str = path_str.strip()
+
+        if not path_str:
+            return None
+
+        resolved = Path(path_str).expanduser().resolve()
+
+        if not resolved.exists():
+            log.warning(
+                "claude_code_adapter.cli_path_not_found",
+                cli_path=str(resolved),
+                fallback="using SDK bundled CLI",
+            )
+            return None
+
+        if not resolved.is_file():
+            log.warning(
+                "claude_code_adapter.cli_path_not_file",
+                cli_path=str(resolved),
+                fallback="using SDK bundled CLI",
+            )
+            return None
+
+        if not os.access(resolved, os.X_OK):
+            log.warning(
+                "claude_code_adapter.cli_not_executable",
+                cli_path=str(resolved),
+                fallback="using SDK bundled CLI",
+            )
+            return None
+
+        log.debug(
+            "claude_code_adapter.using_custom_cli",
+            cli_path=str(resolved),
         )
+        return resolved
 
     async def complete(
         self,
@@ -107,6 +181,7 @@ class ClaudeCodeAdapter:
                 allowed_tools=[],  # No tools - pure conversation
                 permission_mode=self._permission_mode,  # type: ignore[arg-type]
                 cwd=os.getcwd(),
+                cli_path=self._cli_path,
             )
 
             # Collect the response

ouroboros/strategies/__init__.py

@@ -0,0 +1,23 @@
+"""Ontological Analysis Strategies.
+
+This module contains strategy implementations for the AOP-based
+ontological framework. Each strategy is designed for a specific
+join point (phase) in Ouroboros.
+
+Available Strategies:
+- DevilAdvocateStrategy: Consensus phase (Phase 4)
+- InterviewOntologyStrategy: Interview phase (Phase 0) [planned]
+- ContrarianStrategy: Resilience phase (Phase 3) [planned]
+
+Reference: docs/ontological-framework/aop-design.md
+"""
+
+from ouroboros.strategies.devil_advocate import (
+    ConsensusContext,
+    DevilAdvocateStrategy,
+)
+
+__all__ = [
+    "ConsensusContext",
+    "DevilAdvocateStrategy",
+]

ouroboros/strategies/devil_advocate.py

@@ -0,0 +1,197 @@
+"""Devil's Advocate Strategy for Consensus Phase.
+
+This strategy implements ontological analysis for the Consensus phase (Phase 4).
+The Devil's Advocate critically examines whether a solution addresses the
+ROOT CAUSE or merely treats SYMPTOMS.
+
+Usage:
+    strategy = DevilAdvocateStrategy(llm_adapter)
+    aspect = OntologicalAspect(strategy=strategy)
+
+    result = await aspect.execute(
+        context=ConsensusContext(artifact=..., goal=...),
+        core_operation=lambda ctx: consensus.deliberate(ctx),
+    )
+
+Reference: docs/ontological-framework/aop-design.md
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+import hashlib
+import json
+from typing import TYPE_CHECKING
+
+from ouroboros.core.ontology_aspect import (
+    AnalysisResult,
+    OntologicalJoinPoint,
+)
+from ouroboros.core.ontology_questions import (
+    OntologicalQuestionType,
+    analyze_ontologically,
+)
+
+if TYPE_CHECKING:
+    from ouroboros.providers.base import LLMAdapter
+
+
+@dataclass(frozen=True, slots=True)
+class ConsensusContext:
+    """Context for consensus phase ontological analysis.
+
+    Attributes:
+        artifact: The artifact/solution being evaluated.
+        goal: The original goal or problem statement.
+        current_ac: Current acceptance criteria.
+        constraints: Any constraints on the solution.
+    """
+
+    artifact: str
+    goal: str
+    current_ac: str = ""
+    constraints: tuple[str, ...] = ()
+
+
+@dataclass
+class DevilAdvocateStrategy:
+    """Strategy for Consensus phase (Phase 4).
+
+    The Devil's Advocate role: Critically examine whether
+    the solution addresses the ROOT CAUSE or just symptoms.
+
+    This strategy uses the centralized analyze_ontologically() function
+    from ontology_questions.py, focusing on ROOT_CAUSE and ESSENCE questions.
+
+    Attributes:
+        llm_adapter: LLM adapter for analysis.
+        model: Model to use (default: gemini-2.0-flash).
+        confidence_threshold: Minimum confidence to pass (default: 0.7).
+        temperature: Sampling temperature for LLM (default: 0.3).
+        max_tokens: Maximum tokens for LLM response (default: 2048).
+    """
+
+    llm_adapter: LLMAdapter
+    model: str = "openrouter/google/gemini-2.0-flash-001"
+    confidence_threshold: float = 0.7
+    temperature: float = 0.3
+    max_tokens: int = 2048
+
+    @property
+    def join_point(self) -> OntologicalJoinPoint:
+        """This strategy is for the Consensus phase."""
+        return OntologicalJoinPoint.CONSENSUS
+
+    def get_cache_key(self, context: ConsensusContext) -> str:
+        """Compute cache key from artifact and goal hash.
+
+        Only artifact content and goal matter for caching -
+        the same solution for the same problem should get the same result.
+
+        Args:
+            context: The consensus context.
+
+        Returns:
+            SHA256 hash of artifact + goal (first 16 chars).
+        """
+        cache_data = {
+            "artifact": context.artifact,
+            "goal": context.goal,
+        }
+        return hashlib.sha256(
+            json.dumps(cache_data, sort_keys=True).encode()
+        ).hexdigest()[:16]
+
+    async def analyze(self, context: ConsensusContext) -> AnalysisResult:
+        """Analyze solution using Devil's Advocate lens.
+
+        Applies ontological analysis focusing on:
+        - Is this solving the root cause or just a symptom?
+        - What is the essential nature of the problem?
+
+        Args:
+            context: The consensus context with artifact and goal.
+
+        Returns:
+            AnalysisResult with validity based on is_root_problem.
+        """
+        # Build analysis context string
+        analysis_context = self._build_analysis_context(context)
+
+        # Use centralized ontological analysis
+        insight_result = await analyze_ontologically(
+            llm_adapter=self.llm_adapter,
+            context=analysis_context,
+            question_types=(
+                OntologicalQuestionType.ROOT_CAUSE,
+                OntologicalQuestionType.ESSENCE,
+            ),
+            model=self.model,
+            temperature=self.temperature,
+            max_tokens=self.max_tokens,
+        )
+
+        # Handle LLM failure
+        if insight_result.is_err:
+            # Return invalid with error info - let Aspect handle retry/fail
+            return AnalysisResult.invalid(
+                reasoning=[f"Analysis failed: {insight_result.error.message}"],
+                suggestions=["Retry the analysis", "Check LLM provider status"],
+                confidence=0.0,
+            )
+
+        insight = insight_result.value
+
+        # Convert OntologicalInsight to AnalysisResult
+        if insight.is_root_problem and insight.confidence >= self.confidence_threshold:
+            return AnalysisResult.valid(
+                confidence=insight.confidence,
+                reasoning=[insight.reasoning],
+            )
+        else:
+            suggestions = list(insight.hidden_assumptions)
+            if not insight.is_root_problem:
+                suggestions.insert(0, "This appears to treat symptoms, not root cause")
+            if insight.confidence < self.confidence_threshold:
+                suggestions.append(
+                    f"Low confidence ({insight.confidence:.2f}). Consider more analysis."
+                )
+
+            return AnalysisResult.invalid(
+                reasoning=[insight.reasoning],
+                suggestions=tuple(suggestions),
+                confidence=insight.confidence,
+            )
+
+    def _build_analysis_context(self, context: ConsensusContext) -> str:
+        """Build the context string for ontological analysis.
+
+        Args:
+            context: The consensus context.
+
+        Returns:
+            Formatted context string for analysis.
+        """
+        parts = [
+            "## Goal/Problem",
+            context.goal,
+            "",
+            "## Proposed Solution/Artifact",
+            context.artifact,
+        ]
+
+        if context.current_ac:
+            parts.extend(["", "## Acceptance Criteria", context.current_ac])
+
+        if context.constraints:
+            parts.extend(
+                ["", "## Constraints", *[f"- {c}" for c in context.constraints]]
+            )
+
+        return "\n".join(parts)
+
+
+__all__ = [
+    "ConsensusContext",
+    "DevilAdvocateStrategy",
+]

{ouroboros_ai-0.2.3.dist-info → ouroboros_ai-0.4.0.dist-info}/METADATA

@@ -1,14 +1,16 @@
 Metadata-Version: 2.4
 Name: ouroboros-ai
-Version: 0.2.3
+Version: 0.4.0
 Summary: Self-Improving AI Workflow System
 Author-email: Q00 <jqyu.lee@gmail.com>
 License-File: LICENSE
 Requires-Python: >=3.14
 Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: cachetools>=5.0.0
 Requires-Dist: claude-agent-sdk>=0.1.0
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: litellm>=1.80.0
+Requires-Dist: mcp>=1.26.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pyyaml>=6.0.0
 Requires-Dist: rich>=13.0.0
@@ -41,18 +43,26 @@ Description-Content-Type: text/markdown
   <em>The serpent that devours itself to be reborn anew.</em>
 </p>
 
+<p align="center">
+  <a href="https://pypi.org/project/ouroboros-ai/"><img src="https://img.shields.io/pypi/v/ouroboros-ai?color=blue" alt="PyPI"></a>
+  <a href="https://python.org"><img src="https://img.shields.io/badge/python-3.14+-blue" alt="Python"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License"></a>
+</p>
+
 <p align="center">
   <a href="#-philosophy">Philosophy</a> •
   <a href="#-the-six-phases">Phases</a> •
   <a href="#-architecture">Architecture</a> •
+  <a href="#-prerequisites">Prerequisites</a> •
   <a href="#-quick-start">Start</a> •
-  <a href="#-the-personas-lateral-thinking-agents">Personas</a>
+  <a href="#-roadmap">Roadmap</a> •
+  <a href="#-contributing">Contributing</a>
 </p>
 
 <br/>
 
 <p align="center">
-  <code>74 modules</code> · <code>1,341 tests</code> · <code>97%+ coverage</code>
+  <code>75 modules</code> · <code>1,341 tests</code> · <code>97%+ coverage</code>
 </p>
 
 <br/>
@@ -236,7 +246,7 @@ These iterate until a **Seed** crystallizes—a specification with `Ambiguity
 ┃      └────┬────┘                                                               ┃
 ┃           │      Stage 1: Mechanical ($0) — lint, build, test                  ┃
 ┃           │      Stage 2: Semantic ($$) — AC compliance, drift                 ┃
-┃           │      Stage 3: Consensus ($$$$) — multi-model vote                  ┃
+┃           │      Stage 3: Consensus ($$$$) — Advocate/Devil/Judge debate       ┃
 ┃           ▼                                                                    ┃
 ┃      ┌─────────┐                                                               ┃
 ┃      │ PHASE 5 │  S E C O N D A R Y   L O O P                                  ┃
@@ -304,9 +314,9 @@ def select_approach(task):
 ```
 src/ouroboros/
 │
-├── core/           ◆ The essence: types, errors, seed, context
+├── core/           ◆ The essence: types, errors, seed, ontology
 │
-├── bigbang/        ◇ Phase 0: Interview → Ambiguity → Seed
+├── bigbang/        ◇ Phase 0: Interview → Ontology → Ambiguity → Seed
 │
 ├── routing/        ◇ Phase 1: PAL router, complexity, tiers
 │
@@ -349,10 +359,11 @@ src/ouroboros/
 | **THE RESEARCHER** | *"Stop coding. Read the docs."* | Knowledge gap detected | Search, read documentation, find examples |
 | **THE SIMPLIFIER** | *"Cut scope in half. Return to MVP."* | Overengineering detected | Remove features, reduce complexity |
 | **THE ARCHITECT** | *"Question the foundation. Rebuild if needed."* | Structural issues | Redesign, refactor core assumptions |
+| **THE CONTRARIAN** | *"What if we're solving the wrong problem?"* | Root cause unclear | Challenge assumptions using ontological questions |
 
 <br/>
 
-**작동 방식**: Stagnation Detection (4 patterns) → Persona Rotation → 새로운 관점으로 재시도
+**How it works**: Stagnation Detection (4 patterns) → Persona Rotation → Retry with fresh perspective
 
 <br/>
 
@@ -415,6 +426,22 @@ not to restart, but to **re-crystallize** with new understanding.
 
 <br/>
 
+## ◈ Prerequisites
+
+<br/>
+
+| Requirement | Description |
+|-------------|-------------|
+| **Python 3.14+** | Required (uses latest language features) |
+| **Claude Code Max Plan** | For orchestrator mode (no API key needed) |
+| **OR API Key** | OpenRouter, Anthropic, or OpenAI for LiteLLM mode |
+
+<br/>
+
+---
+
+<br/>
+
 ## ◈ Installation
 
 <br/>
@@ -476,7 +503,7 @@ uv run ouroboros init start "I want to build a task management CLI"
 uv run ouroboros status health
 ```
 
-> 📖 **[Full Guide: Running with Claude Code](docs/running-with-claude-code.md)**
+> 📖 **[Full Guide: Running with Claude Code](docs/running-with-claude-code.md)** | **[CLI Reference](docs/cli-reference.md)**
 
 <br/>
 
@@ -563,22 +590,51 @@ uv run ruff format src/
 
 <br/>
 
+## ◈ Contributing
+
+<br/>
+
+Contributions are welcome! Please see:
+
+- **Issues**: [GitHub Issues](https://github.com/Q00/ouroboros/issues) for bugs and feature requests
+- **Discussions**: [GitHub Discussions](https://github.com/Q00/ouroboros/discussions) for questions and ideas
+
+<br/>
+
+---
+
+<br/>
+
 ## ◈ Roadmap
 
 <br/>
 
+### Completed
+
 ```
-[■■■■■■■■■■] Epic 0  Foundation
-[■■■■■■■■■■] Epic 1  Big Bang
-[■■■■■■■■■■] Epic 2  PAL Router
-[■■■■■■■■■■] Epic 3  Double Diamond
-[■■■■■■■■■■] Epic 4  Resilience
-[■■■■■■■■■■] Epic 5  Evaluation
-[■■■■■■■■■■] Epic 6  Drift Control
-[■■■■■■■■■■] Epic 7  Secondary Loop
-[■■■■■■■■■■] Epic 8  Orchestrator      ✓ Complete
+[■■■■■■■■■■] Epic 0  Foundation          ✓
+[■■■■■■■■■■] Epic 1  Big Bang            ✓
+[■■■■■■■■■■] Epic 2  PAL Router          ✓
+[■■■■■■■■■■] Epic 3  Double Diamond      ✓
+[■■■■■■■■■■] Epic 4  Resilience          ✓
+[■■■■■■■■■■] Epic 5  Evaluation          ✓
+[■■■■■■■■■■] Epic 6  Drift Control       ✓
+[■■■■■■■■■■] Epic 7  Secondary Loop      ✓
+[■■■■■■■■■■] Epic 8  Orchestrator        ✓
+[■■■■■■■■■■] Epic 9  MCP Integration     ✓
+[■■■■■■■■■■] Epic 10 TUI Mode            ✓
 ```
 
+### Upcoming
+
+| Feature | Description | Status |
+|---------|-------------|--------|
+| **Worker MCP** | MCP server for distributed task execution | Planned |
+| **TUI Enhancement** | Rich terminal UI with real-time progress | Planned |
+| **AC Tree Visualization** | Interactive acceptance criteria graph | Planned |
+| **Plugin System** | Custom evaluators and personas | Planned |
+| **Web Dashboard** | Execution monitoring and analytics | Planned |
+
 <br/>
 
 ---

{ouroboros_ai-0.2.3.dist-info → ouroboros_ai-0.4.0.dist-info}/RECORD

@@ -1,16 +1,18 @@
-ouroboros/__init__.py,sha256=lmQgHmNOWxGlmwayNvp1ckCuJycL8WzX5Y-7IzrFaVM,701
+ouroboros/__init__.py,sha256=LhxtSCpFGoqFURoFs0JIc99GgkGvx6-kdLuyqcADqLU,701
 ouroboros/__main__.py,sha256=f_qnL0zPJwh9kfQqynX5adpqzj8ilj94zW5Q2loqGxE,168
 ouroboros/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ouroboros/bigbang/__init__.py,sha256=9xGqOYwMKBifb7QVwonc_wndNLMZb7ZH7xgMHaz_70A,951
+ouroboros/bigbang/__init__.py,sha256=lNYGEbPaeUB201jFPHsvJ-jIJC2XP-LtOyA32gVMb7o,1241
 ouroboros/bigbang/ambiguity.py,sha256=5KM8xjATknjLZguVa90Yii6o3pzXE4PU4BJIP6Ii938,17955
-ouroboros/bigbang/interview.py,sha256=zm1VrDNqE8ouGG62h8qnNkIpnUf3HHv4NjzMKDIaWcY,17147
+ouroboros/bigbang/interview.py,sha256=ku1MVppSmIS9OZeiqC208el4ZqoYYQwT78ycLenwID4,17200
+ouroboros/bigbang/ontology.py,sha256=7sgNQav3KF7TBtw_25UflVc4QGQK29D-QY8eXgPMKBo,6145
 ouroboros/bigbang/seed_generator.py,sha256=7MY9a7Eua_zVGDWIVDlzOZJjeAwz0DRatXJg0PvMgiY,20082
 ouroboros/cli/__init__.py,sha256=CRpxsqJadZL7bCS-yrULWC51tqPKfPsxQLgt0JiwP4g,225
-ouroboros/cli/main.py,sha256=ldvqtVpw2xZwE8G7M34qY_7qg0RuNiydjdmmU-hdJvM,1485
-ouroboros/cli/commands/__init__.py,sha256=LZpEvU80R4Cq0LwgkwOluEGNsmmJ9K7roeDQ6bsbbDc,193
+ouroboros/cli/main.py,sha256=6TTrm9moBH5RCcJZ2xBNq4jrmI71p01PUqUZvJjSPfA,1525
+ouroboros/cli/commands/__init__.py,sha256=Nc55qcwCsQm4vfA1UTAs6okTxKbGeqohJIkJi5689Uc,258
 ouroboros/cli/commands/config.py,sha256=kcqi0Wo09oo1MMyZIX4k2IDICV1SAX6HzAXZaIJGdKY,2100
-ouroboros/cli/commands/init.py,sha256=HmXwTLyso6p8Df5aAguxh-XTIYZGkzGltGXqJvDxI78,13536
-ouroboros/cli/commands/run.py,sha256=DnxfbSdATDIaNYJXLcwAcR9NqNVGkVlHgYJImaSVn4I,6328
+ouroboros/cli/commands/init.py,sha256=y2hlHnqFkc9-44_mJUs3GmQvX4Tg6yTIyb0e0KCPl30,16130
+ouroboros/cli/commands/mcp.py,sha256=S-PkEyjwwQcdbrhrn4UUxjHCi-uBhfuy5gsDkyVjGZM,4343
+ouroboros/cli/commands/run.py,sha256=MgwFlTorVsoz0Vk2m9x-g81flrYuWa2ZiJoNDpGIzqg,11014
 ouroboros/cli/commands/status.py,sha256=Bnqpj1UkqhpBPYA11DV-Z63Bz8pjrebhlzeMKwz3_Ps,2217
 ouroboros/cli/formatters/__init__.py,sha256=-Ik7KXajaIExBxSAp5iYp8gO9SfXudGjyDe2nm2_msw,691
 ouroboros/cli/formatters/panels.py,sha256=d5TANIZy6FEEdpfnZaZ0epe-qIHJbh13qTCt23ur1jA,3388
@@ -23,13 +25,15 @@ ouroboros/core/__init__.py,sha256=VHGSB01i56Rncbx-vfKqpvZ1oXDJUu0xp0kQ6tuwRqw,16
 ouroboros/core/ac_tree.py,sha256=GNyeWB3GVrQhYI83_g2ISYoviKnUf-U6vTY9p6xkklM,11949
 ouroboros/core/context.py,sha256=A5WVPgsJlK-CDnDJx-_Tcfh_lE2AE3EYud45NKnYI2E,15675
 ouroboros/core/errors.py,sha256=e4kiduueE3e2HvNyOJLnFRGFoue2vfW8JTerzxjp5TM,8057
+ouroboros/core/ontology_aspect.py,sha256=j7nZbNGido18Qh2ECYSe1C33ZHP5S7O2G9zXQRi7HyI,14964
+ouroboros/core/ontology_questions.py,sha256=R4VOe81J4Gx4ka6IF9XSqiyv6EahYpJhADzANH_GXU8,15133
 ouroboros/core/security.py,sha256=LJq5FJzWdUIcjZGujI9xv1k3sFaD3XArBOlmArW-brg,9594
 ouroboros/core/seed.py,sha256=OIO4p1evYqpIrt841LVDVMaBZq9RCkM-e78MOb94BS8,7114
 ouroboros/core/types.py,sha256=SIc7XSIRizkeQU0kq4U02mZFsLtqVLmAo3ANypyUUfQ,6137
-ouroboros/evaluation/__init__.py,sha256=rwNeCtbFvDmq2Ad3YXj2n1tz2i9fESHQKwgjIyCZtCs,3067
-ouroboros/evaluation/consensus.py,sha256=iPa21cdLHWBBBuFaHDxI638UH3n-XFmp5TZrrxJ23k0,10727
+ouroboros/evaluation/__init__.py,sha256=LC1JHcewk_SBTjdwrrTQx3TiIcYC2qBxXBaCcxvgrWY,3461
+ouroboros/evaluation/consensus.py,sha256=Z5XSQw5W9H3DHLbLUZMVXfSvSi87DRfhoVidhdASOuQ,29394
 ouroboros/evaluation/mechanical.py,sha256=gWvCUaR8Ibmpnrl9gjv0LYhwC5MgJ65gyTFcjzHqLZc,11285
-ouroboros/evaluation/models.py,sha256=SpUOhchp2G0zzsXiNiIZ8txJhxK1vcgPxS1_4tWvZUY,7538
+ouroboros/evaluation/models.py,sha256=IrnmV_gueO2gGtS73pNRVCMiS06oiMju33raP1N4LMo,10062
 ouroboros/evaluation/pipeline.py,sha256=k4gQzkKxzMvqKpMxK4bAVAm-Ux06RYjlwNOCDD5EvQI,10056
 ouroboros/evaluation/semantic.py,sha256=qSKrYHMzt8DLygULH5xI2Sy_pXfis9-_bIjjziUf3kI,9406
 ouroboros/evaluation/trigger.py,sha256=yNQZrVAP8L6KOKNDQNqeCxDqxbYIZY8b7w-lBSMlL5A,9695
@@ -37,19 +41,38 @@ ouroboros/events/__init__.py,sha256=LIvrE41r1eGo6Qb1-mOfoyVAcZ3hObS4o7Jq3sCnVPU,
 ouroboros/events/base.py,sha256=y4ZIqs_HK66GRVZz7HZ02pkQ8lS2NxIkJFOB3frm8y0,2627
 ouroboros/events/decomposition.py,sha256=rA2E4SLB5UgEZMXzGPFVO75r1D96PWQ8PnBBJKug3nE,4357
 ouroboros/events/evaluation.py,sha256=HfQ6xu5JLV5tIjL-NxsXykDIvKmjBSrLr1tQHcr4aAI,6922
+ouroboros/events/ontology.py,sha256=XRj788ekkLpDNIvvo163JfbaP8jrhTKfqtw9kriGd6s,3855
 ouroboros/execution/__init__.py,sha256=nG9f51vi1O3zLGusbZfOqZebvUgMxm9R7JjoUDPGC1E,1101
 ouroboros/execution/atomicity.py,sha256=JacsYaUhm9r05R8sMBoJRDnTmba4jpMXQU6SvQIuAzM,13988
 ouroboros/execution/decomposition.py,sha256=NWTVuQoLw4vzMMGNdtCv-i5olOGIZADd2ogdFURzssU,14682
 ouroboros/execution/double_diamond.py,sha256=lbk9cY3Awd0h_YFp1G5OJnDpkV8htanSDhQIYn0LA_8,49837
 ouroboros/execution/subagent.py,sha256=_0-Ayz1p4r-cJP6kAYQP-bf9g2yLKXV81wffurBK9YM,8727
+ouroboros/mcp/__init__.py,sha256=C3vtzrnNcxjsnelhCiDpYHjMl8EoER-Ojx4K5q5mfr4,2071
+ouroboros/mcp/errors.py,sha256=dzk6E1iQE8Lyc3zd_0Xpm3wQzmAzyCPPcyswpvx_VQ4,11585
+ouroboros/mcp/types.py,sha256=uQEtzhFn5sNyoHhXLE4D4u35A3Gd-NpMkzMPEcnT47M,9081
+ouroboros/mcp/client/__init__.py,sha256=o0vDlamaRLQLrjsZfd9gthTD-iuknuJnbCxlgfKWM5Y,603
+ouroboros/mcp/client/adapter.py,sha256=_tGxM71IRCwWN3-qvQuW6K9GbpPkXNjVV60CrIN28OE,21629
+ouroboros/mcp/client/manager.py,sha256=0z0U9LlUez6hJRfBn-PYo1yAU5T1wILpeqluOoZF2AM,20294
+ouroboros/mcp/client/protocol.py,sha256=GEK0zoPo10r4M2TwwQ6LjT_eadvBwF1sa8UnZZIlXWs,4809
+ouroboros/mcp/resources/__init__.py,sha256=o7EJL9XEJYXy1-aqAnavuYVkTHeHH_hrg_TcEbeni58,467
+ouroboros/mcp/resources/handlers.py,sha256=kq8ks8hiOlwDlFC-H1u9Xmjf9mE155PHRS7LsoYjhMQ,10851
+ouroboros/mcp/server/__init__.py,sha256=Tb7SATt1rHnuVLfMCTwEJIf9R3CkeCc-POqZ3xZvWP0,598
+ouroboros/mcp/server/adapter.py,sha256=jyxoKw9gjUI_QQoXJ81mROttxKWHD7tBbXyrShexmJ8,13128
+ouroboros/mcp/server/protocol.py,sha256=ZCYeWwDXeRdktUtP-mX0AktnypMVTbYFm8uTwsJIu6w,8120
+ouroboros/mcp/server/security.py,sha256=IUf21iSbF7C4IBC5_1hfYnTi0mfLl-wgiFWQR7WK4uk,20017
+ouroboros/mcp/tools/__init__.py,sha256=eigHzFsdKtRrJAYbmLVra3csRBqpL1UNQqc0l-Zz8D8,566
+ouroboros/mcp/tools/definitions.py,sha256=saOE_Wz1B9pHQUma4KEDH2uXJtR0-DmnSJc52n_NIyk,11509
+ouroboros/mcp/tools/registry.py,sha256=_tETlbheZYQr03X3YxzsMn0jxz7CpIQ4dl4LP66RcbI,7482
 ouroboros/observability/__init__.py,sha256=jgLIxPgBPJgSLCUjxR28tO3gkOuknbnb0H87NwkCl6Q,1654
 ouroboros/observability/drift.py,sha256=1BxZq-XIfhOJpTiBzbqgMpxziiJsb9KcLg_F5QKBIeM,11361
 ouroboros/observability/logging.py,sha256=MC_VzyAyJtTq_3iv7uLxvlO9eCxtdY2ZyJ7ObwDds98,16994
 ouroboros/observability/retrospective.py,sha256=FH_9UC20RnH7OHNXMVIbsqC74B_4KIUy0UjtK-rguXU,11177
-ouroboros/orchestrator/__init__.py,sha256=g1aZSEM9gbl12mHINYoS93X1gacqePwrK4ElujoN0Uk,2130
+ouroboros/orchestrator/__init__.py,sha256=JAapdYn03B1Fqpz4atJMGfp612uEDMTJ91swD4OGq2A,3005
 ouroboros/orchestrator/adapter.py,sha256=TpvgVMNfvNqvuffn41JDMYjWt2MFCLqTW1MtwOEZ-6E,13152
-ouroboros/orchestrator/events.py,sha256=Ti83WTW9sGNJtR-KKcJ_Ie62oEqggIoivgfzIl19Ydg,7604
-ouroboros/orchestrator/runner.py,sha256=AbD8vAyUlXQk8KUpmizkm_i4YM03XeqaE-15ElxwsnA,20386
+ouroboros/orchestrator/events.py,sha256=BuY6N6uXBAN8fWdlnHT2EfpztnzIa4HyBgk98su0BgQ,8756
+ouroboros/orchestrator/mcp_config.py,sha256=FZvEfQmlC9qnvj18bWnL8XFFN8ROYQmrAb5tkEs9fj4,12293
+ouroboros/orchestrator/mcp_tools.py,sha256=MvHbjRmgqG9S0T3ZMgFm6tofeUNM7n7Ny8CAaaL9ZJ0,15418
+ouroboros/orchestrator/runner.py,sha256=zGKWQrPkTGXK0fluVhlJb7B9KYflxQyfODuV6RXnAKs,24668
 ouroboros/orchestrator/session.py,sha256=JWfQfwwlf7_f80l9Ed45zQA6iDb32XoOnaYbGjA6ChU,15536
 ouroboros/persistence/__init__.py,sha256=O9lVtKUNgtpamzo-OAeEVYXByqpy83853DKepvo3Zj8,601
 ouroboros/persistence/checkpoint.py,sha256=FC68lOmNcRJooFEYXGrGWR0TZcQG-YA9qvPPnl4QMUc,17580
@@ -61,7 +84,7 @@ ouroboros/persistence/migrations/runner.py,sha256=FPlnmjT0U-wTDRdHHImM6wMzEzMAGX
 ouroboros/persistence/migrations/scripts/001_initial.sql,sha256=ZkABj9VKEyvwYwCmnT7PZt8bODMKUw4oThnuhHdxHwg,848
 ouroboros/providers/__init__.py,sha256=sFQ049Gizx2GxWUTlsCLZHaskV8NVwPDdkXiLEWhrbc,583
 ouroboros/providers/base.py,sha256=u86bWAXtNIVCL1SxqXFK9sqpL6SZOc9h2vxAuVh7mxo,3823
-ouroboros/providers/claude_code_adapter.py,sha256=rVz_5eYRPL9SMt5PQBIbYGHLkRymTCXjCwZ6oZwMrCM,7285
+ouroboros/providers/claude_code_adapter.py,sha256=72Evb__QZMCg9_E1C5duk1e1hPfh_6F0mAAQiWoXNzI,9990
 ouroboros/providers/litellm_adapter.py,sha256=ljl1SywN1QXEy6LrLhsUYvh9qc0RUuKIG8XFCRtU4yg,10761
 ouroboros/resilience/__init__.py,sha256=jcMdyk5WwaIh7iFVQ5rwaexCnnVpnumJUgWf4GO6w_4,1980
 ouroboros/resilience/lateral.py,sha256=Z4B7pOrD93D6bXu8BqrUvibqYSGyjv8Ubp6nWfLipjM,21582
@@ -75,8 +98,10 @@ ouroboros/routing/tiers.py,sha256=QhBQUOo2-h5Z3dEtC0lcOzkRnqTi2W7Jl46750AVNig,73
 ouroboros/secondary/__init__.py,sha256=kYQ7C4bnBzwDlPrU8qZrOPr2ZuTBaftGktOXl5WZl5Q,1123
 ouroboros/secondary/scheduler.py,sha256=sPVVWJ1q0yewRAM-Rm1j_HMerSe4cavIvP9z4xlUuL4,13737
 ouroboros/secondary/todo_registry.py,sha256=4W3C9Uro29VrVLCPKUlpH_BYpzQSbRNW1oMnDYyEhEw,13880
-ouroboros_ai-0.2.3.dist-info/METADATA,sha256=pAjfUYPmqTUzuLJoNQcoJx88R8yZwj_ALVniBc6jLGg,19661
-ouroboros_ai-0.2.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-ouroboros_ai-0.2.3.dist-info/entry_points.txt,sha256=MoETHup6rVkR6AsyjoRzAgIuvVtYYm3Jw40itV3_VyI,53
-ouroboros_ai-0.2.3.dist-info/licenses/LICENSE,sha256=n2X-q26TqpXnoBo0t_WouhFxWw663_q5FmbYDZayoHo,1060
-ouroboros_ai-0.2.3.dist-info/RECORD,,
+ouroboros/strategies/__init__.py,sha256=OuSimhS6q37e_D6F5Lb1ZahXTLkYZBfcUUAxspPSorw,623
+ouroboros/strategies/devil_advocate.py,sha256=i32pseJDc44klb4Vr-gQfPBdZvMHCJhobb2wR7VSeG4,6289
+ouroboros_ai-0.4.0.dist-info/METADATA,sha256=3cFNN3hEAL5Y_MB1NXd1NA9qZ9NbXLA6M2cimeZUCMs,21645
+ouroboros_ai-0.4.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+ouroboros_ai-0.4.0.dist-info/entry_points.txt,sha256=MoETHup6rVkR6AsyjoRzAgIuvVtYYm3Jw40itV3_VyI,53
+ouroboros_ai-0.4.0.dist-info/licenses/LICENSE,sha256=n2X-q26TqpXnoBo0t_WouhFxWw663_q5FmbYDZayoHo,1060
+ouroboros_ai-0.4.0.dist-info/RECORD,,