Clean up test files in main directory (#17)

* refactor: reorganize repository structure into src/, tests/, and docs/

- Move all Python source files to src/ directory
- Move all test files to tests/ directory
- Move documentation files (MIGRATION_STATUS.md, UPGRADE_PLAN.md) to docs/
- Update all imports to use src. prefix for proper package structure
- Update pyproject.toml to reference src package and src.main:run_server
- Update Dockerfile to reference src.main:app
- Add src/__init__.py for proper package initialization

This cleanup improves code organization and follows Python best practices
for project structure.

* fix: update import in claude_cli.py to use src.auth

* fix: correct model support and test validation

- Remove Claude 3.x models from CLAUDE_MODELS (not supported by Claude Agent SDK)
- Update parameter_validator to use CLAUDE_MODELS constant (single source of truth)
- Fix test_basic.py to use supported model (claude-sonnet-4-5-20250929)
- Add error detection in tests to properly fail when API returns errors

The Claude Agent SDK only supports Claude 4+ models. The tests were
incorrectly reporting success when getting error responses because the
OpenAI SDK returns errors in the content rather than raising exceptions.

* fix: update import path in test_working_directory.py

Update import statement to use src.claude_cli path to match the
reorganized repository structure.

* fix: update imports in test files to use src. prefix

- Update test_docker_workspace.sh to import from src.claude_cli
- Update test_working_directory.py to import from src.claude_cli
- Update test_sdk_migration.py to import from src.constants, src.models, and src.message_adapter
- Fix sys.path adjustment in test_working_directory.py to point to parent directory

All test files now use the new src/ package structure.

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: RichardAtCT

Dockerfile

@@ -29,4 +29,4 @@ RUN poetry install --no-root
 EXPOSE 8000
 
 # Run the app with Uvicorn (development mode with reload; switch to --no-reload for prod)
-CMD ["poetry", "run", "uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000", "--reload"]
+CMD ["poetry", "run", "uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "8000", "--reload"]

MIGRATION_STATUS.md docs/MIGRATION_STATUS.mdMIGRATION_STATUS.md renamed to docs/MIGRATION_STATUS.md

@@ -5,7 +5,7 @@ description = "OpenAI API-compatible wrapper for Claude Code"
 authors = ["Richard Atkinson <richardatk01@gmail.com>"]
 readme = "README.md"
 license = "MIT"
-packages = [{include = "*.py"}]
+packages = [{include = "src"}]
 
 [tool.poetry.dependencies]
 python = "^3.10"
@@ -35,4 +35,4 @@ line-length = 100
 target-version = ['py310']
 
 [tool.poetry.scripts]
-claude-wrapper = "main:run_server"
+claude-wrapper = "src.main:run_server"

UPGRADE_PLAN.md docs/UPGRADE_PLAN.mdUPGRADE_PLAN.md renamed to docs/UPGRADE_PLAN.md

@@ -0,0 +1,3 @@
+"""Claude Code OpenAI Wrapper - A FastAPI-based OpenAI-compatible API for Claude Code."""
+
+__version__ = "1.0.0"

pyproject.toml

@@ -21,7 +21,7 @@ def get_api_key(self):
         """Get the active API key (environment or runtime-generated)."""
         # Try to import runtime_api_key from main module
         try:
-            import main
+            from src import main
             if hasattr(main, 'runtime_api_key') and main.runtime_api_key:
                 return main.runtime_api_key
         except ImportError:

src/__init__.py

@@ -39,7 +39,7 @@ def __init__(self, timeout: int = 600000, cwd: Optional[str] = None):
             atexit.register(self._cleanup_temp_dir)
 
         # Import auth manager
-        from auth import auth_manager, validate_claude_code_auth
+        from src.auth import auth_manager, validate_claude_code_auth
 
         # Validate authentication
         is_valid, auth_info = validate_claude_code_auth()

auth.py src/auth.pyauth.py renamed to src/auth.py

@@ -43,9 +43,10 @@
 ]
 
 # Claude Models
-# All currently supported Claude models (as of November 2025)
+# Models supported by Claude Agent SDK (as of November 2025)
+# NOTE: Claude Agent SDK only supports Claude 4+ models, not Claude 3.x
 CLAUDE_MODELS = [
-    # Claude 4.5 Family (Latest - Fall 2025)
+    # Claude 4.5 Family (Latest - Fall 2025) - RECOMMENDED
     "claude-sonnet-4-5-20250929",   # Recommended - best coding model
     "claude-haiku-4-5-20251001",    # Fast & cheap
 
@@ -56,10 +57,12 @@
     "claude-opus-4-20250514",
     "claude-sonnet-4-20250514",
 
-    # Claude 3.x Family
-    "claude-3-7-sonnet-20250219",
-    "claude-3-5-sonnet-20241022",
-    "claude-3-5-haiku-20241022",
+    # Claude 3.x Family - NOT SUPPORTED by Claude Agent SDK
+    # These models work with Anthropic API but NOT with Claude Code
+    # Uncomment only if using direct Anthropic API (not Claude Agent SDK)
+    # "claude-3-7-sonnet-20250219",
+    # "claude-3-5-sonnet-20241022",
+    # "claude-3-5-haiku-20241022",
 ]
 
 # Default model (recommended for most use cases)

claude_cli.py src/claude_cli.pyclaude_cli.py renamed to src/claude_cli.py

@@ -15,26 +15,26 @@
 from pydantic import ValidationError
 from dotenv import load_dotenv
 
-from models import (
-    ChatCompletionRequest, 
-    ChatCompletionResponse, 
+from src.models import (
+    ChatCompletionRequest,
+    ChatCompletionResponse,
     ChatCompletionStreamResponse,
-    Choice, 
-    Message, 
+    Choice,
+    Message,
     Usage,
     StreamChoice,
     ErrorResponse,
     ErrorDetail,
     SessionInfo,
     SessionListResponse
 )
-from claude_cli import ClaudeCodeCLI
-from message_adapter import MessageAdapter
-from auth import verify_api_key, security, validate_claude_code_auth, get_claude_code_auth_info
-from parameter_validator import ParameterValidator, CompatibilityReporter
-from session_manager import session_manager
-from rate_limiter import limiter, rate_limit_exceeded_handler, get_rate_limit_for_endpoint, rate_limit_endpoint
-from constants import CLAUDE_MODELS, DEFAULT_MODEL, FAST_MODEL, CLAUDE_TOOLS
+from src.claude_cli import ClaudeCodeCLI
+from src.message_adapter import MessageAdapter
+from src.auth import verify_api_key, security, validate_claude_code_auth, get_claude_code_auth_info
+from src.parameter_validator import ParameterValidator, CompatibilityReporter
+from src.session_manager import session_manager
+from src.rate_limiter import limiter, rate_limit_exceeded_handler, get_rate_limit_for_endpoint, rate_limit_endpoint
+from src.constants import CLAUDE_MODELS, DEFAULT_MODEL, FAST_MODEL, CLAUDE_TOOLS
 
 # Load environment variables
 load_dotenv()
@@ -778,7 +778,7 @@ async def debug_request_validation(request: Request):
 @rate_limit_endpoint("auth")
 async def get_auth_status(request: Request):
     """Get Claude Code authentication status."""
-    from auth import auth_manager
+    from src.auth import auth_manager
 
     auth_info = get_claude_code_auth_info()
     active_api_key = auth_manager.get_api_key()

constants.py src/constants.pyconstants.py renamed to src/constants.py

@@ -1,5 +1,5 @@
 from typing import List, Optional, Dict, Any
-from models import Message
+from src.models import Message
 import re