ouroboros-ai 0.25.3.dev1__tar.gz → 0.25.3.dev2__tar.gz

{ouroboros_ai-0.25.3.dev1 → ouroboros_ai-0.25.3.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ouroboros-ai
-Version: 0.25.3.dev1
+Version: 0.25.3.dev2
 Summary: Self-Improving AI Workflow System
 Author-email: Q00 <jqyu.lee@gmail.com>
 License-File: LICENSE

{ouroboros_ai-0.25.3.dev1 → ouroboros_ai-0.25.3.dev2}/docs/cli-reference.md

@@ -83,7 +83,7 @@ ouroboros init [start] [OPTIONS] [CONTEXT]
 |--------|-------------|
 | `-r, --resume TEXT` | Resume an existing interview by ID |
 | `--state-dir DIRECTORY` | Custom directory for interview state files |
-| `-o, --orchestrator` | Use Claude Code (Max Plan) instead of LiteLLM. No API key required |
+| `-o, --orchestrator` | Use Claude Code (Max Plan) instead of Anthropic API. No API key required |
 | `-d, --debug` | Show verbose logs including debug messages |
 
 **Examples:**
@@ -493,21 +493,21 @@ ouroboros run seed.yaml
 ouroboros monitor
 ```
 
-### Using LiteLLM (External API)
+### Using Anthropic API (Default Non-Orchestrator Path)
 
-Requires API key (OPENROUTER_API_KEY, ANTHROPIC_API_KEY, etc.)
+Requires `ANTHROPIC_API_KEY`.
 
 ```bash
 # 1. Initialize configuration
 ouroboros config init
 
-# 2. Set your API key
-ouroboros config set providers.openrouter.api_key $OPENROUTER_API_KEY
+# 2. Export your API key
+export ANTHROPIC_API_KEY=your-key-here
 
 # 3. Start interview
 ouroboros init "Build a REST API for task management"
 
-# 4. Execute workflow (use --no-orchestrator for LiteLLM path)
+# 4. Execute workflow (use --no-orchestrator for the standard path)
 ouroboros run seed.yaml --no-orchestrator
 ```
 
@@ -517,8 +517,8 @@ ouroboros run seed.yaml --no-orchestrator
 
 | Variable | Description |
 |----------|-------------|
-| `OPENROUTER_API_KEY` | OpenRouter API key for LiteLLM |
-| `ANTHROPIC_API_KEY` | Anthropic API key for LiteLLM |
+| `OPENROUTER_API_KEY` | OpenRouter API key for optional LiteLLM-based integrations |
+| `ANTHROPIC_API_KEY` | Anthropic API key for direct Anthropic-backed interview mode |
 | `OPENAI_API_KEY` | OpenAI API key for LiteLLM |
 
 ---

{ouroboros_ai-0.25.3.dev1 → ouroboros_ai-0.25.3.dev2}/docs/running-with-claude-code.md

@@ -136,7 +136,7 @@ The orchestrator uses `claude-agent-sdk` which connects directly to your authent
 # Start interactive interview (Claude Code)
 uv run ouroboros init start --orchestrator "Your idea here"
 
-# Start interactive interview (LiteLLM - needs API key)
+# Start interactive interview (Anthropic API - needs ANTHROPIC_API_KEY)
 uv run ouroboros init start "Your idea here"
 
 # Resume an interrupted interview

{ouroboros_ai-0.25.3.dev1 → ouroboros_ai-0.25.3.dev2}/src/ouroboros/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.25.3.dev1'
-__version_tuple__ = version_tuple = (0, 25, 3, 'dev1')
+__version__ = version = '0.25.3.dev2'
+__version_tuple__ = version_tuple = (0, 25, 3, 'dev2')
 
 __commit_id__ = commit_id = None

{ouroboros_ai-0.25.3.dev1 → ouroboros_ai-0.25.3.dev2}/src/ouroboros/bigbang/ambiguity.py

@@ -20,12 +20,7 @@ import structlog
 from ouroboros.bigbang.interview import InterviewState
 from ouroboros.core.errors import ProviderError
 from ouroboros.core.types import Result
-from ouroboros.providers.base import CompletionConfig, Message, MessageRole
-
-try:
-    from ouroboros.providers.litellm_adapter import LiteLLMAdapter
-except ImportError:
-    LiteLLMAdapter = None  # type: ignore[assignment,misc]
+from ouroboros.providers.base import CompletionConfig, LLMAdapter, Message, MessageRole
 
 log = structlog.get_logger()
 
@@ -138,7 +133,7 @@ class AmbiguityScorer:
         max_retries: Maximum retry attempts, or None for unlimited (default).
 
     Example:
-        scorer = AmbiguityScorer(llm_adapter=LiteLLMAdapter())
+        scorer = AmbiguityScorer(llm_adapter=some_adapter)
 
         result = await scorer.score(interview_state)
         if result.is_ok:
@@ -151,7 +146,7 @@ class AmbiguityScorer:
                 questions = scorer.generate_clarification_questions(ambiguity.breakdown)
     """
 
-    llm_adapter: LiteLLMAdapter
+    llm_adapter: LLMAdapter
     model: str = DEFAULT_MODEL
     temperature: float = SCORING_TEMPERATURE
     initial_max_tokens: int = 2048
@@ -414,17 +409,14 @@ Analyze each component and provide scores with justifications."""
         except json.JSONDecodeError as e:
             raise ValueError(f"Invalid JSON response: {e}") from e
 
-        # Validate all required fields are present
-        required_fields = [
+        # Numeric score fields must be present. Missing justifications are recoverable.
+        required_score_fields = [
             "goal_clarity_score",
-            "goal_clarity_justification",
             "constraint_clarity_score",
-            "constraint_clarity_justification",
             "success_criteria_clarity_score",
-            "success_criteria_clarity_justification",
         ]
 
-        for field_name in required_fields:
+        for field_name in required_score_fields:
             if field_name not in data:
                 raise ValueError(f"Missing required field: {field_name}")
 
@@ -433,6 +425,15 @@ Analyze each component and provide scores with justifications."""
             score = float(value)
             return max(0.0, min(1.0, score))
 
+        def justification_for(field_name: str, component_name: str) -> str:
+            value = data.get(field_name)
+            if value is None:
+                return f"{component_name} justification not provided by model."
+            text = str(value).strip()
+            if not text:
+                return f"{component_name} justification not provided by model."
+            return text
+
         # Select weights based on project type
         if is_brownfield:
             goal_weight = BROWNFIELD_GOAL_CLARITY_WEIGHT
@@ -450,7 +451,10 @@ Analyze each component and provide scores with justifications."""
                 name="Context Clarity",
                 clarity_score=clamp_score(data["context_clarity_score"]),
                 weight=BROWNFIELD_CONTEXT_CLARITY_WEIGHT,
-                justification=str(data.get("context_clarity_justification", "")),
+                justification=justification_for(
+                    "context_clarity_justification",
+                    "Context Clarity",
+                ),
             )
 
         return ScoreBreakdown(
@@ -458,19 +462,28 @@ Analyze each component and provide scores with justifications."""
                 name="Goal Clarity",
                 clarity_score=clamp_score(data["goal_clarity_score"]),
                 weight=goal_weight,
-                justification=str(data["goal_clarity_justification"]),
+                justification=justification_for(
+                    "goal_clarity_justification",
+                    "Goal Clarity",
+                ),
             ),
             constraint_clarity=ComponentScore(
                 name="Constraint Clarity",
                 clarity_score=clamp_score(data["constraint_clarity_score"]),
                 weight=constraint_weight,
-                justification=str(data["constraint_clarity_justification"]),
+                justification=justification_for(
+                    "constraint_clarity_justification",
+                    "Constraint Clarity",
+                ),
             ),
             success_criteria_clarity=ComponentScore(
                 name="Success Criteria Clarity",
                 clarity_score=clamp_score(data["success_criteria_clarity_score"]),
                 weight=criteria_weight,
-                justification=str(data["success_criteria_clarity_justification"]),
+                justification=justification_for(
+                    "success_criteria_clarity_justification",
+                    "Success Criteria Clarity",
+                ),
             ),
             context_clarity=context_clarity,
         )

{ouroboros_ai-0.25.3.dev1 → ouroboros_ai-0.25.3.dev2}/src/ouroboros/cli/commands/init.py

@@ -1,7 +1,7 @@
 """Init command for starting interactive interview.
 
 This command initiates the Big Bang phase interview process.
-Supports both LiteLLM (external API) and Claude Code (Max Plan) modes.
+Supports both direct Anthropic API and Claude Code (Max Plan) modes.
 """
 
 import asyncio
@@ -27,13 +27,9 @@ from ouroboros.bigbang.seed_generator import SeedGenerator
 from ouroboros.cli.formatters import console
 from ouroboros.cli.formatters.panels import print_error, print_info, print_success, print_warning
 from ouroboros.observability import LoggingConfig, configure_logging
+from ouroboros.providers.anthropic_adapter import AnthropicAdapter
 from ouroboros.providers.base import LLMAdapter
 
-try:
-    from ouroboros.providers.litellm_adapter import LiteLLMAdapter
-except ImportError:
-    LiteLLMAdapter = None  # type: ignore[assignment,misc]
-
 
 class SeedGenerationResult(Enum):
     """Result of seed generation attempt."""
@@ -140,7 +136,7 @@ def _get_adapter(
     """Get the appropriate LLM adapter.
 
     Args:
-        use_orchestrator: If True, use Claude Code (Max Plan). Otherwise LiteLLM.
+        use_orchestrator: If True, use Claude Code (Max Plan). Otherwise Anthropic API.
         for_interview: If True, enable Read/Glob/Grep tools for codebase exploration.
         debug: If True, show streaming messages (thinking, tool use).
 
@@ -160,8 +156,7 @@ def _get_adapter(
                 on_message=_make_message_callback(debug),
             )
         return ClaudeCodeAdapter()
-    else:
-        return LiteLLMAdapter()
+    return AnthropicAdapter()
 
 
 async def _run_interview_loop(
@@ -262,7 +257,7 @@ async def _run_interview(
         initial_context: Initial context or idea for the interview.
         resume_id: Optional interview ID to resume.
         state_dir: Optional custom state directory.
-        use_orchestrator: If True, use Claude Code (Max Plan) instead of LiteLLM.
+        use_orchestrator: If True, use Claude Code (Max Plan) instead of Anthropic API.
     """
     # Initialize components
     llm_adapter = _get_adapter(use_orchestrator, for_interview=True, debug=debug)
@@ -500,7 +495,7 @@ def start(
         typer.Option(
             "--orchestrator",
             "-o",
-            help="Use Claude Code (Max Plan) instead of LiteLLM. No API key required.",
+            help="Use Claude Code (Max Plan) instead of Anthropic API. No API key required.",
         ),
     ] = False,
     debug: Annotated[
@@ -553,7 +548,7 @@ def start(
     if orchestrator:
         print_info("Using Claude Code (Max Plan) - no API key required")
     else:
-        print_info("Using LiteLLM - API key required")
+        print_info("Using Anthropic API - ANTHROPIC_API_KEY required")
 
     # Run interview
     try:
@@ -581,7 +576,7 @@ def list_interviews(
     ] = None,
 ) -> None:
     """List all interview sessions."""
-    llm_adapter = LiteLLMAdapter()
+    llm_adapter = AnthropicAdapter()
     engine = InterviewEngine(
         llm_adapter=llm_adapter,
         state_dir=state_dir or Path.home() / ".ouroboros" / "data",

{ouroboros_ai-0.25.3.dev1 → ouroboros_ai-0.25.3.dev2}/tests/e2e/test_cli_commands.py

@@ -74,7 +74,7 @@ class TestInitCommand:
     ) -> None:
         """Test init start with context argument."""
         # Mock the LLM adapter and asyncio.run
-        with patch("ouroboros.cli.commands.init.LiteLLMAdapter") as mock_adapter_class:
+        with patch("ouroboros.cli.commands.init.AnthropicAdapter") as mock_adapter_class:
             mock_adapter = MagicMock()
             mock_adapter.complete = mock_interview_llm_provider.complete
             mock_adapter_class.return_value = mock_adapter
@@ -107,7 +107,7 @@ class TestInitCommand:
 
     def test_init_list_no_interviews(self, temp_state_dir: Path) -> None:
         """Test init list when no interviews exist."""
-        with patch("ouroboros.cli.commands.init.LiteLLMAdapter"):
+        with patch("ouroboros.cli.commands.init.AnthropicAdapter"):
             with patch("ouroboros.cli.commands.init.asyncio.run") as mock_run:
                 mock_run.return_value = []
 
@@ -121,7 +121,7 @@ class TestInitCommand:
 
     def test_init_resume_missing_interview(self, temp_state_dir: Path) -> None:
         """Test init resume with non-existent interview ID."""
-        with patch("ouroboros.cli.commands.init.LiteLLMAdapter") as mock_adapter_class:
+        with patch("ouroboros.cli.commands.init.AnthropicAdapter") as mock_adapter_class:
             mock_adapter = MagicMock()
             mock_adapter_class.return_value = mock_adapter
 

{ouroboros_ai-0.25.3.dev1 → ouroboros_ai-0.25.3.dev2}/tests/unit/bigbang/test_ambiguity.py

@@ -665,6 +665,68 @@ class TestAmbiguityScorerParseResponse:
         with pytest.raises(ValueError, match="Missing required field"):
             scorer._parse_scoring_response(response)
 
+    def test_parse_response_missing_success_justification_uses_fallback(self) -> None:
+        """_parse_scoring_response tolerates missing success justification."""
+        mock_adapter = MagicMock()
+        scorer = AmbiguityScorer(llm_adapter=mock_adapter)
+
+        response = (
+            '{"goal_clarity_score": 0.9, "goal_clarity_justification": "Good goal.", '
+            '"constraint_clarity_score": 0.8, "constraint_clarity_justification": '
+            '"Clear constraints.", "success_criteria_clarity_score": 0.7}'
+        )
+
+        breakdown = scorer._parse_scoring_response(response)
+
+        assert breakdown.success_criteria_clarity.clarity_score == 0.7
+        assert (
+            breakdown.success_criteria_clarity.justification
+            == "Success Criteria Clarity justification not provided by model."
+        )
+
+    def test_parse_response_missing_goal_justification_uses_fallback(self) -> None:
+        """_parse_scoring_response tolerates missing goal justification."""
+        mock_adapter = MagicMock()
+        scorer = AmbiguityScorer(llm_adapter=mock_adapter)
+
+        response = (
+            '{"goal_clarity_score": 0.85, "constraint_clarity_score": 0.75, '
+            '"constraint_clarity_justification": "Good constraints.", '
+            '"success_criteria_clarity_score": 0.65, '
+            '"success_criteria_clarity_justification": "Clear criteria."}'
+        )
+
+        breakdown = scorer._parse_scoring_response(response)
+
+        assert breakdown.goal_clarity.clarity_score == 0.85
+        assert (
+            breakdown.goal_clarity.justification
+            == "Goal Clarity justification not provided by model."
+        )
+
+    def test_parse_brownfield_response_missing_context_justification_uses_fallback(self) -> None:
+        """_parse_scoring_response tolerates missing brownfield context justification."""
+        mock_adapter = MagicMock()
+        scorer = AmbiguityScorer(llm_adapter=mock_adapter)
+
+        response = (
+            '{"goal_clarity_score": 0.9, "goal_clarity_justification": "Good goal.", '
+            '"constraint_clarity_score": 0.8, "constraint_clarity_justification": '
+            '"Clear constraints.", "success_criteria_clarity_score": 0.7, '
+            '"success_criteria_clarity_justification": "Clear criteria.", '
+            '"context_clarity_score": 0.6}'
+        )
+
+        breakdown = scorer._parse_scoring_response(response, is_brownfield=True)
+
+        assert breakdown.context_clarity is not None
+        assert breakdown.context_clarity.clarity_score == 0.6
+        assert breakdown.context_clarity.weight == 0.15
+        assert (
+            breakdown.context_clarity.justification
+            == "Context Clarity justification not provided by model."
+        )
+
     def test_parse_response_invalid_json(self) -> None:
         """_parse_scoring_response raises error for invalid JSON."""
         mock_adapter = MagicMock()

{ouroboros_ai-0.25.3.dev1 → ouroboros_ai-0.25.3.dev2}/tests/unit/cli/test_main.py

@@ -240,7 +240,7 @@ class TestShorthandCommands:
 
     def test_init_list_subcommand_still_works(self) -> None:
         """Test backward compat: 'ouroboros init list' still routes to list."""
-        with patch("ouroboros.cli.commands.init.LiteLLMAdapter"):
+        with patch("ouroboros.cli.commands.init.AnthropicAdapter"):
             with patch("ouroboros.cli.commands.init.asyncio.run") as mock_run:
                 mock_run.return_value = []
                 result = runner.invoke(app, ["init", "list"])