enhace phase I

Author: bitshifterr

.gitignore

@@ -33,6 +33,16 @@ logs/
 models/
 *.log
 
+# Test artifacts
+tests/env/tmp/
+tests/**/*.tmp
+tests/**/*.temp
+tests/**/__pycache__/
+.pytest_cache/
+.coverage
+htmlcov/
+*.coverage
+
 # Temporary files
 *.tmp
 *.temp

commands/subs/dev/precommit.py

@@ -90,7 +90,7 @@ def precommit(fix: bool, ci: bool) -> None:
     # 4. Run tests if in CI mode
     if ci:
         click.echo("\n🧪 Running tests...")
-        test_cmd = ["pytest", "commands/tests/"]
+        test_cmd = ["pytest", "tests/commands/"]
         result = subprocess.run(test_cmd, capture_output=True, text=True)
         if result.returncode != 0:
             click.echo("   ✗ Tests failed")

pyproject.toml

@@ -30,7 +30,7 @@ cli = "commands.main:main"
 [tool.setuptools.packages.find]
 where = ["."]
 include = ["commands", "commands.*"]
-exclude = ["commands.tests*"]
+exclude = ["tests*"]
 
 [tool.setuptools.dynamic]
 version = {attr = "commands.__version__"}
@@ -69,3 +69,9 @@ warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = true
 ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]

tests/README.md

@@ -0,0 +1,58 @@
+# Tests Directory Structure
+
+This directory contains all test-related files organized by functionality.
+
+## Directory Structure
+
+```
+tests/
+├── commands/      # Unit tests for CLI commands (moved from commands/tests/)
+├── docker/        # Docker-related test configurations
+├── env/           # Test environment setups and fixtures
+├── integration/   # Integration tests
+├── rust/          # Rust-related tests (when applicable)
+└── e2e/           # End-to-end tests (future)
+```
+
+## Test Categories
+
+### commands/
+Unit tests for all CLI commands. These test individual command functionality in isolation.
+
+### docker/
+Contains Docker Compose files and Dockerfiles for testing the application in containerized environments.
+
+### env/
+Test environment configurations, fixtures, and temporary test data. Virtual environments for testing should be created here.
+
+### integration/
+Integration tests that test multiple components working together.
+
+### rust/ (future)
+Tests for Rust components when building mixed-language projects.
+
+## Running Tests
+
+```bash
+# Run all tests
+cli dev test
+
+# Run with coverage
+pytest --cov=commands
+
+# Run specific test category
+pytest tests/commands/
+pytest tests/integration/
+```
+
+## Test Conventions
+
+1. **Naming**: Test files should be named `test_*.py`
+2. **Structure**: Mirror the source code structure within each test category
+3. **Isolation**: Each test should be independent and not rely on other tests
+4. **Cleanup**: Tests should clean up any temporary files or directories they create
+5. **Documentation**: Complex tests should include docstrings explaining what they test
+
+## Temporary Files
+
+Any temporary files or directories created during testing should be placed in `tests/env/tmp/` and cleaned up after the test completes.