solarwindpy 0.0.1.dev0__py3-none-any.whl → 0.1.0__py3-none-any.whl

plans/completed/test-directory-consolidation/3-Import-Transformation.md

@@ -0,0 +1,117 @@
+# Phase 3: Import Transformation
+
+## Phase Tasks
+- [ ] **Transform internal test module imports** (Est: 45 min) - Update imports from solarwindpy.tests to direct package imports
+  - Commit: `<checksum>`
+  - Status: Pending
+- [ ] **Update test utility imports** (Est: 30 min) - Replace conftest imports with pytest fixtures
+  - Commit: `<checksum>`
+  - Status: Pending
+- [ ] **Fix test data path references** (Est: 30 min) - Update paths from package location to root /tests/data/
+  - Commit: `<checksum>`
+  - Status: Pending
+- [ ] **Validate import resolution** (Est: 15 min) - Verify all imports resolve correctly
+  - Commit: `<checksum>`
+  - Status: Pending
+
+## Import Pattern Transformations
+
+### Type 1: Internal Test Module Imports
+**Before:**
+```python
+from solarwindpy.tests import test_base as base
+```
+**After:**
+```python
+from solarwindpy.core import base  # Direct package import
+```
+
+### Type 2: Test Utility Imports
+**Before:**
+```python
+from solarwindpy.tests.conftest import sample_plasma_data
+```
+**After:**
+```python
+import pytest
+# Use @pytest.fixture in consolidated conftest.py
+```
+
+### Type 3: Test Data Path References
+**Before:**
+```python
+data_path = "solarwindpy/tests/data/plasma.csv"
+```
+**After:**
+```python
+import os
+data_path = os.path.join("tests", "data", "plasma.csv")
+```
+
+### Type 4: Relative Internal Imports
+**Before:**
+```python
+from . import conftest
+from ..test_base import BaseTestCase
+```
+**After:**
+```python
+import pytest
+from solarwindpy.core.base import BaseClass  # Direct imports
+```
+
+## Systematic Import Update Process
+
+### Step 1: Identify Import Patterns
+Scan all migrated test files for:
+- `from solarwindpy.tests import`
+- `from solarwindpy.tests.conftest import`
+- Relative imports starting with `.`
+- Hard-coded paths to `solarwindpy/tests/data/`
+
+### Step 2: Update Core Test Imports
+For each file in `/tests/core/`:
+1. Replace internal test imports with direct package imports
+2. Update test data path references
+3. Remove relative imports
+4. Verify pytest fixture compatibility
+
+### Step 3: Update Plotting Test Imports  
+For each file in `/tests/plotting/`:
+1. Update label test imports to use package modules
+2. Fix any cross-test dependencies
+3. Ensure proper pytest discovery
+
+### Step 4: Update Utility Test Imports
+For utility tests in `/tests/`:
+1. Replace any internal test module references
+2. Update configuration imports to use fixtures
+3. Maintain test isolation and independence
+
+## Expected Import Transformations
+
+### Core Module Tests
+- `test_base.py`: Update base class imports
+- `test_plasma.py`: Fix plasma module imports and data paths
+- `test_ions.py`: Update ion class imports
+- `test_spacecraft.py`: Fix spacecraft imports and data references
+
+### Plotting Tests
+- Label tests: Update to import from `solarwindpy.plotting.labels`
+- Remove internal plotting test dependencies
+
+### Utility Tests
+- `test_circular_imports.py`: Update import analysis code
+- `test_planning_agents_architecture.py`: Fix agent architecture imports
+
+## Validation Checks
+- [ ] All imports resolve without errors
+- [ ] No circular import warnings
+- [ ] Test data paths point to correct locations
+- [ ] Pytest can discover all tests
+- [ ] No broken relative imports remain
+
+## Navigation
+- **Previous Phase**: [2-File-Migration.md](./2-File-Migration.md)
+- **Next Phase**: [4-Configuration-Consolidation.md](./4-Configuration-Consolidation.md)
+- **Overview**: [0-Overview.md](./0-Overview.md)

plans/completed/test-directory-consolidation/4-Configuration-Consolidation.md

@@ -0,0 +1,140 @@
+# Phase 4: Configuration Consolidation
+
+## Phase Tasks
+- [ ] **Analyze existing conftest.py files** (Est: 20 min) - Inventory fixtures from both locations
+  - Commit: `<checksum>`
+  - Status: Pending
+- [ ] **Merge conftest.py configurations** (Est: 30 min) - Create consolidated root conftest.py
+  - Commit: `<checksum>`
+  - Status: Pending
+- [ ] **Eliminate redundant configurations** (Est: 10 min) - Remove duplicated or conflicting settings
+  - Commit: `<checksum>`
+  - Status: Pending
+
+## Configuration Analysis
+
+### Current Configuration Files
+
+#### Root `/tests/conftest.py` (Fitfunctions)
+- Fitfunction-specific fixtures
+- Simple linear data generators
+- Gaussian data fixtures
+- Edge case data for error testing
+- Standard pytest configuration
+
+#### Package `/solarwindpy/tests/conftest.py` (Core)
+- Core module fixtures
+- Plasma data fixtures
+- Ion species test data
+- Spacecraft trajectory fixtures  
+- Development-specific setup
+
+### Consolidation Strategy
+
+#### Root Level `/tests/conftest.py`
+Create comprehensive fixture collection:
+- **Data Fixtures**: Plasma, ion, spacecraft test data
+- **Fitfunction Fixtures**: Mathematical function test data
+- **Utility Fixtures**: Common test utilities and helpers
+- **Configuration**: Global pytest settings
+
+#### Subdirectory Specific Fixtures
+Keep specialized fixtures in subdirectories:
+- `/tests/fitfunctions/conftest.py`: Fitfunction-specific fixtures only
+- Remove redundant fixtures that are now in root conftest.py
+
+## Fixture Consolidation Plan
+
+### Step 1: Fixture Inventory
+**From Root conftest.py:**
+- `simple_linear_data()`
+- `gaussian_data()`
+- `edge_case_data()`
+- Fitfunction-specific utilities
+
+**From Package conftest.py:**
+- `sample_plasma_data()`
+- `test_ions_data()`
+- `spacecraft_trajectory()`
+- Core module utilities
+
+### Step 2: Merged Root Configuration
+```python
+# /tests/conftest.py - Consolidated Configuration
+import pytest
+import pandas as pd
+import numpy as np
+
+# Core data fixtures
+@pytest.fixture
+def sample_plasma_data():
+    """Plasma test data for core module tests"""
+    # Implementation from package conftest
+
+@pytest.fixture  
+def test_ions_data():
+    """Ion species test data"""
+    # Implementation from package conftest
+
+# Fitfunction data fixtures
+@pytest.fixture
+def simple_linear_data():
+    """Simple linear data for fitfunction tests"""
+    # Implementation from root conftest
+
+@pytest.fixture
+def gaussian_data():
+    """Gaussian data for fitfunction tests"""
+    # Implementation from root conftest
+
+# Global pytest configuration
+pytest_plugins = ['pytest_cov']
+```
+
+### Step 3: Specialized Subdirectory Fixtures
+```python
+# /tests/fitfunctions/conftest.py - Specialized Only
+import pytest
+
+@pytest.fixture
+def fitfunction_specific_fixture():
+    """Fixtures unique to fitfunctions only"""
+    # Keep only fitfunction-specific fixtures here
+```
+
+## Configuration Migration Process
+
+### Phase 4a: Backup Current Configurations
+```bash
+cp tests/conftest.py tests/conftest.py.backup
+cp solarwindpy/tests/conftest.py solarwindpy/tests/conftest.py.backup
+```
+
+### Phase 4b: Create Consolidated Root Configuration
+1. Merge fixture definitions from both sources
+2. Eliminate duplicate or redundant fixtures
+3. Standardize fixture naming and documentation
+4. Add global pytest settings
+
+### Phase 4c: Update Subdirectory Configurations
+1. Remove fixtures now available at root level
+2. Keep only specialized, subdirectory-specific fixtures
+3. Update fixture references to use root-level fixtures
+
+### Phase 4d: Remove Package Configurations
+```bash
+rm solarwindpy/tests/conftest.py
+rmdir solarwindpy/tests  # If empty after migration
+```
+
+## Validation Steps
+- [ ] All fixtures available to appropriate tests
+- [ ] No duplicate fixture definitions
+- [ ] Pytest discovery works correctly
+- [ ] All test dependencies satisfied
+- [ ] Configuration settings preserved
+
+## Navigation
+- **Previous Phase**: [3-Import-Transformation.md](./3-Import-Transformation.md)
+- **Next Phase**: [5-Validation.md](./5-Validation.md)
+- **Overview**: [0-Overview.md](./0-Overview.md)

plans/completed/test-directory-consolidation/5-Validation.md

@@ -0,0 +1,152 @@
+# Phase 5: Validation
+
+## Phase Tasks
+- [ ] **Run full test suite** (Est: 10 min) - Execute pytest -q to verify all tests pass
+  - Commit: `<checksum>`
+  - Status: Pending
+- [ ] **Verify pytest discovery** (Est: 5 min) - Confirm pytest finds all tests correctly
+  - Commit: `<checksum>`
+  - Status: Pending
+- [ ] **Check CI/CD pipeline** (Est: 10 min) - Validate GitHub Actions continue working
+  - Commit: `<checksum>`
+  - Status: Pending
+- [ ] **Validate import resolution** (Est: 5 min) - Ensure all import statements resolve properly
+  - Commit: `<checksum>`
+  - Status: Pending
+
+## Comprehensive Validation Protocol
+
+### Step 1: Local Test Suite Execution
+```bash
+# Full test suite - must pass 100%
+pytest -q
+
+# Verbose output for debugging if needed
+pytest -v
+
+# Test with coverage to ensure all code paths tested
+pytest --cov=solarwindpy --cov-report=term-missing
+```
+
+**Success Criteria:**
+- [ ] All tests pass (0 failures, 0 errors)
+- [ ] No import errors or warnings
+- [ ] Test discovery finds all expected tests
+- [ ] Coverage metrics maintained or improved
+
+### Step 2: Test Discovery Verification
+```bash
+# Verify pytest discovers all tests
+pytest --collect-only
+
+# Check specific subdirectories
+pytest tests/core --collect-only
+pytest tests/plotting --collect-only  
+pytest tests/fitfunctions --collect-only
+```
+
+**Expected Results:**
+- Total test count: ~170+ tests (existing + migrated)
+- All subdirectories properly discovered
+- No collection warnings or errors
+- Fixture resolution successful
+
+### Step 3: Import Resolution Testing
+```bash
+# Test imports independently
+python -c "import tests.conftest; print('Root conftest imported successfully')"
+
+# Verify test modules import correctly  
+python -c "from tests.core import test_plasma; print('Core tests import successfully')"
+python -c "from tests.plotting.labels import test_base; print('Plotting tests import successfully')"
+```
+
+**Validation Checks:**
+- [ ] No circular import errors
+- [ ] All external package imports resolve
+- [ ] Test data paths accessible
+- [ ] Fixture dependencies satisfied
+
+### Step 4: CI/CD Pipeline Validation
+```bash
+# Simulate GitHub Actions locally
+pytest -q --tb=short
+
+# Check formatting requirements
+black --check tests/
+flake8 tests/
+```
+
+**CI/CD Compatibility:**
+- [ ] Standard pytest discovery works (no custom configuration needed)
+- [ ] Code formatting standards maintained
+- [ ] No additional dependencies required
+- [ ] Existing workflow commands continue working
+
+### Step 5: Specific Test Category Validation
+
+#### Core Module Tests
+```bash
+pytest tests/core/ -v
+```
+Expected: ~11 core tests pass with proper fixture access
+
+#### Plotting Tests  
+```bash
+pytest tests/plotting/ -v
+```
+Expected: ~5 plotting tests pass with label functionality
+
+#### Fitfunction Tests
+```bash
+pytest tests/fitfunctions/ -v
+```
+Expected: ~170 fitfunction tests pass (already working)
+
+#### Utility Tests
+```bash
+pytest tests/test_circular_imports.py -v
+pytest tests/test_issue_titles.py -v
+pytest tests/test_planning_agents_architecture.py -v
+```
+Expected: Utility tests pass with updated imports
+
+## Performance Validation
+
+### Test Execution Time
+- Monitor test execution time (should remain comparable)
+- Identify any significant performance regressions
+- Ensure parallel test execution still works
+
+### Memory Usage
+- Verify test memory usage patterns
+- Check for fixture memory leaks
+- Validate test isolation maintained
+
+## Rollback Criteria
+
+If validation fails:
+1. **Immediate Issues**: Import errors, test failures
+2. **Performance Issues**: >50% slower execution
+3. **CI/CD Issues**: GitHub Actions failures
+4. **Coverage Issues**: Significant coverage reduction
+
+**Rollback Process:**
+```bash
+git reset --hard [checkpoint-commit]
+git clean -fd
+```
+
+## Success Validation Checklist
+- [ ] 100% test pass rate maintained
+- [ ] All tests discoverable by pytest
+- [ ] No import resolution errors
+- [ ] CI/CD pipeline functions normally
+- [ ] Test execution performance acceptable
+- [ ] Coverage metrics maintained
+- [ ] No regression in functionality
+
+## Navigation
+- **Previous Phase**: [4-Configuration-Consolidation.md](./4-Configuration-Consolidation.md)
+- **Next Phase**: [6-Cleanup.md](./6-Cleanup.md)
+- **Overview**: [0-Overview.md](./0-Overview.md)

plans/completed/test-directory-consolidation/6-Cleanup.md

@@ -0,0 +1,156 @@
+# Phase 6: Cleanup
+
+## Phase Tasks
+- [ ] **Remove old test directories** (Est: 10 min) - Clean up empty /solarwindpy/tests/ directory structure
+  - Commit: `<checksum>`
+  - Status: Pending
+- [ ] **Update documentation references** (Est: 15 min) - Fix any documentation pointing to old test locations
+  - Commit: `<checksum>`
+  - Status: Pending
+- [ ] **Final consolidation verification** (Est: 5 min) - Confirm complete migration and no orphaned files
+  - Commit: `<checksum>`
+  - Status: Pending
+
+## Cleanup Operations
+
+### Step 1: Remove Old Directory Structure
+```bash
+# Remove empty test directories (after confirming they're empty)
+rmdir solarwindpy/tests/plotting/labels/
+rmdir solarwindpy/tests/plotting/
+rmdir solarwindpy/tests/data/
+rmdir solarwindpy/tests/
+
+# Remove any remaining test-related files in package
+find solarwindpy/ -name "*test*" -type f
+find solarwindpy/ -name "conftest.py" -type f
+```
+
+**Verification:**
+- [ ] All test files successfully migrated
+- [ ] No orphaned test files remain in package
+- [ ] Directory structure completely removed
+- [ ] Package structure is clean
+
+### Step 2: Update Documentation References
+
+#### Files to Check and Update:
+1. **README.rst** - Update test running instructions
+2. **CONTRIBUTING.md** - Update development setup instructions  
+3. **docs/source/** - Update any testing documentation
+4. **pyproject.toml** - Verify test discovery configuration
+5. **setup.cfg** - Update pytest configuration if needed
+
+#### Documentation Updates:
+
+**Before:**
+```markdown
+Run tests: pytest solarwindpy/tests/
+Test location: /solarwindpy/tests/
+```
+
+**After:**
+```markdown
+Run tests: pytest tests/ (or simply pytest -q)
+Test location: /tests/
+```
+
+### Step 3: Configuration File Updates
+
+#### pyproject.toml Testing Configuration
+```toml
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+addopts = "--strict-markers --disable-warnings"
+```
+
+#### GitHub Actions Workflow
+Verify `.github/workflows/` files use:
+```yaml
+- name: Run tests
+  run: pytest -q
+```
+(Should already work with standard discovery)
+
+### Step 4: Package Configuration Cleanup
+
+#### setup.py / pyproject.toml
+Ensure test files are properly excluded from package distribution:
+```python
+# In setup.py
+packages=find_packages(exclude=["tests", "tests.*"])
+
+# Or in pyproject.toml
+[tool.setuptools.packages.find]
+exclude = ["tests*"]
+```
+
+### Step 5: Final Verification
+
+#### Complete Migration Checklist
+- [ ] All 33 test files successfully migrated to /tests/
+- [ ] No test files remain in /solarwindpy/
+- [ ] Documentation updated with new test locations
+- [ ] Configuration files reflect new structure
+- [ ] CI/CD pipelines work with new structure
+- [ ] Package distribution excludes test files
+
+#### File Count Verification
+```bash
+# Count tests in new location
+find tests/ -name "test_*.py" | wc -l
+# Expected: 33 total test files
+
+# Verify no tests remain in package
+find solarwindpy/ -name "test_*.py" | wc -l  
+# Expected: 0 test files
+```
+
+#### Final Test Run
+```bash
+# Complete test suite in new location
+pytest -q
+# Expected: All tests pass, ~170+ test cases
+
+# Verify test discovery
+pytest --collect-only | grep "test session starts"
+# Expected: All tests discovered from /tests/
+```
+
+## Documentation Updates Summary
+
+### Files Updated:
+1. **README.rst**: Test running instructions
+2. **CONTRIBUTING.md**: Development setup guidance
+3. **docs/source/**: Any testing documentation
+4. **pyproject.toml**: Test configuration (if needed)
+
+### Key Changes:
+- Test location: `/solarwindpy/tests/` → `/tests/`  
+- Test commands: `pytest solarwindpy/tests/` → `pytest -q`
+- Development setup: Updated directory references
+
+## Success Criteria
+- [ ] Complete directory cleanup with no orphaned files
+- [ ] All documentation references updated
+- [ ] Configuration files reflect new structure  
+- [ ] Package properly excludes test files from distribution
+- [ ] Final test suite passes completely
+- [ ] CI/CD pipeline functions with new structure
+
+## Post-Completion Benefits Achieved
+✅ **Industry Standard Compliance**: Python packaging best practices implemented  
+✅ **Clean Package Distribution**: Tests excluded from installations  
+✅ **Superior Tooling Integration**: Standard pytest discovery working  
+✅ **Clear Architecture**: Clean separation between source and tests  
+✅ **CI/CD Compatibility**: Existing workflows maintained  
+✅ **Reduced Package Size**: Test files no longer included in distributions
+
+## Navigation
+- **Previous Phase**: [5-Validation.md](./5-Validation.md)
+- **Overview**: [0-Overview.md](./0-Overview.md)
+
+---
+**Plan Status**: Ready for systematic implementation with rollback capabilities

plans/completed/test-planning-agents-architecture/0-Overview.md

@@ -0,0 +1,79 @@
+# Test Planning Agents Architecture - Overview
+
+## Plan Metadata
+- **Plan Name**: Test Planning Agents Architecture
+- **Created**: 2025-08-09
+- **Branch**: plan/test-planning-agents-architecture
+- **Implementation Branch**: feature/test-planning-agents-architecture
+- **PlanManager**: PlanManager
+- **PlanImplementer**: PlanImplementer
+- **Structure**: Multi-Phase
+- **Total Phases**: 3
+- **Dependencies**: Planning agents system implementation
+- **Affects**: .claude/agents/, planning agent test infrastructure
+- **Estimated Duration**: 20 minutes
+- **Status**: COMPLETED
+
+## PlanImplementer Fields
+- **Implementation Strategy**: Test-driven validation
+- **Testing Approach**: Branch isolation and workflow validation
+- **Rollback Plan**: N/A (testing only, no production changes)
+- **Performance Impact**: None
+- **Security Considerations**: Git branch permissions only
+
+## 🎯 Objective
+Validate the plan-per-branch architecture by testing branch isolation, cross-branch coordination, and the complete merge workflow (feature → plan → master).
+
+## 🧠 Context
+Testing the planning agents system we just implemented to ensure:
+1. Plan branches can be created and isolated properly
+2. Feature branches can coordinate with plan branches
+3. Checksum management works correctly
+4. Merge workflow operates as designed (feature → plan → master)
+
+## 🔧 Technical Requirements
+- Git branch management
+- Plan template system
+- Checksum placeholder system (`<checksum>`)
+- Cross-branch file coordination
+
+## 📂 Affected Areas
+- `.claude/agents/` - New planning agents
+- `solarwindpy/plans/` - Plan templates and test plans
+- Git branches - Plan and feature branch architecture
+
+## 📋 Phase Structure
+1. **Phase 1**: Branch Isolation Testing (8 min)
+2. **Phase 2**: Cross-Branch Coordination (7 min)
+3. **Phase 3**: Merge Workflow Testing (5 min)
+
+## ✅ Acceptance Criteria
+- [x] Plan branch created successfully with isolated plan files
+- [x] Feature branch can coordinate with plan branch
+- [x] Checksum placeholders can be replaced with actual commit hashes
+- [x] Cross-branch status updates work correctly
+- [x] Complete merge workflow (feature → plan → master) functions properly
+- [x] Branch isolation maintains true separation between concurrent plans
+
+## 🧪 Testing Strategy
+1. **Branch Creation**: Verify plan and feature branches can be created independently
+2. **File Isolation**: Confirm plan files only exist on their respective plan branches
+3. **Checksum Functionality**: Test placeholder replacement with real commit hashes
+4. **Cross-Branch Updates**: Validate status synchronization between branches
+5. **Merge Workflow**: Complete full workflow from feature through to master
+
+## 📊 Final Results
+- **Phases Completed**: 3/3
+- **Tasks Completed**: 8/8
+- **Time Invested**: 0.33h of 0.33h
+- **Final Status**: COMPLETED ✅
+
+## 🔗 Related Plans
+- Primary implementation: Planning agents system (completed)
+- Future testing: Status tracking system validation
+
+## 💬 Notes & Considerations
+This is a meta-test of our planning system - using the planning agents to test themselves. This validates that the plan-per-branch architecture can handle recursive planning scenarios.
+
+---
+*This plan follows the plan-per-branch architecture where implementation occurs on feature/test-planning-agents-architecture branch with progress tracked via commit checksums.*

plans/completed/test-planning-agents-architecture/1-Branch-Isolation-Testing.md

@@ -0,0 +1,49 @@
+# Phase 1: Branch Isolation Testing
+
+## Phase Overview
+- **Duration**: 8 minutes
+- **Status**: COMPLETED
+- **Objective**: Test plan branch creation and verify proper isolation from other branches
+
+## Tasks
+
+### Task 1.1: Create plan branch
+- **Estimate**: 2 minutes
+- **Status**: ✅ Completed
+- **Commit**: `<checksum>`
+- **Description**: Create dedicated plan/test-planning-agents-architecture branch
+
+**Implementation Notes:**
+- Plan branch created successfully
+- Proper isolation established from master branch
+
+### Task 1.2: Create test plan file
+- **Estimate**: 3 minutes
+- **Status**: ✅ Completed
+- **Commit**: `eff9e0b`
+- **Description**: Use new plan template on plan branch
+
+**Implementation Notes:**
+- Plan template system working correctly
+- File created on plan branch only
+
+### Task 1.3: Test branch isolation
+- **Estimate**: 3 minutes
+- **Status**: ✅ Completed
+- **Commit**: `<checksum>`
+- **Description**: Verify plan files only exist on plan branch
+
+**Implementation Notes:**
+- Branch isolation confirmed
+- Plan files properly separated from master branch
+
+## Phase Results
+- **Tasks Completed**: 3/3
+- **Time Taken**: 8 minutes (as estimated)
+- **Key Achievements**:
+  - Successfully created isolated plan branch
+  - Validated plan template system functionality
+  - Confirmed proper branch isolation mechanisms
+
+## Next Phase
+Proceed to Phase 2: Cross-Branch Coordination