Merge pull request #46 from BruinGrowly/cursor/codebase-review-and-improvement-suggestions-claude-4.5-sonnet-thinking-1a1d

Codebase review and improvement suggestions

Author: BruinGrowly

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,42 @@
+---
+name: Bug Report
+about: Report a bug in Semantic Compressor
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Bug Description
+<!-- Clear and concise description of the bug -->
+
+## To Reproduce
+Steps to reproduce the behavior:
+1. Run command: `...`
+2. With input: `...`
+3. See error: `...`
+
+## Expected Behavior
+<!-- What you expected to happen -->
+
+## Actual Behavior
+<!-- What actually happened (include full error messages) -->
+
+## Environment
+- **OS:** [e.g., Ubuntu 22.04, macOS 13.2, Windows 11]
+- **Python version:** [e.g., 3.11.2]
+- **Semantic Compressor version:** [e.g., 2.0.0]
+- **Installation method:** [e.g., pip install, git clone]
+
+## Code Sample
+<!-- If applicable, provide minimal code to reproduce -->
+```python
+# Your code here
+```
+
+## Additional Context
+<!-- Any other relevant information -->
+
+## Checklist
+- [ ] I have searched existing issues
+- [ ] I am using the latest version
+- [ ] I have included all relevant information above

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,34 @@
+---
+name: Feature Request
+about: Suggest a new feature for Semantic Compressor
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Feature Description
+<!-- Clear description of the proposed feature -->
+
+## Use Case
+<!-- Why is this feature needed? What problem does it solve? -->
+
+## Proposed Solution
+<!-- How would you like this feature to work? -->
+
+## Example Usage
+<!-- Show how this feature would be used -->
+```python
+# Example code showing the feature
+result = new_feature(input)
+```
+
+## Alternatives Considered
+<!-- Other ways this could be implemented or solved -->
+
+## Additional Context
+<!-- Mockups, links to related projects, etc. -->
+
+## Checklist
+- [ ] I have checked the [Roadmap](../ROADMAP.md) to see if this is already planned
+- [ ] I have searched existing feature requests
+- [ ] I have described a clear use case

.github/workflows/tests.yml

@@ -0,0 +1,96 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', '3.12']
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install pytest pytest-cov
+
+    - name: Run tests
+      run: |
+        python3 -m pytest tests/ -v --cov=src/ljpw --cov-report=xml --cov-report=term
+
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v3
+      if: matrix.python-version == '3.11' && matrix.os == 'ubuntu-latest'
+      with:
+        file: ./coverage.xml
+        fail_ci_if_error: false
+        verbose: true
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+
+    - name: Install linting tools
+      run: |
+        python -m pip install --upgrade pip
+        pip install flake8 black isort mypy
+
+    - name: Check code formatting with black
+      run: |
+        black --check src/ tests/ tools/ examples/ || true
+
+    - name: Check import sorting with isort
+      run: |
+        isort --check-only src/ tests/ tools/ examples/ || true
+
+    - name: Lint with flake8
+      run: |
+        flake8 src/ tests/ tools/ examples/ --count --select=E9,F63,F7,F82 --show-source --statistics || true
+        flake8 src/ tests/ tools/ examples/ --count --exit-zero --max-complexity=10 --max-line-length=100 --statistics || true
+
+  test-install:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+
+    - name: Test installation
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e .
+
+    - name: Test CLI
+      run: |
+        ljpw help || python -m src.ljpw.ljpw_standalone help
+
+    - name: Test basic analysis
+      run: |
+        echo 'def hello(): print("world")' > test.py
+        ljpw analyze test.py || python -m src.ljpw.ljpw_standalone analyze test.py