* feat: add comprehensive error handling, logging, and type hints

- Add structured logging with file and console output across all modules
- Implement robust error handling with graceful degradation
- Add comprehensive type hints to all functions and methods
- Add concise docstrings for all public functions
- Improve validation and input checking throughout codebase
- Enhance OpenAI API error handling with better user messages

* feat: enhance Streamlit UI with better UX and error handling

- Add improved status indicators and connection validation
- Implement conversation context retention within sessions
- Add loading states and user-friendly error messages
- Include sidebar controls with clear conversation functionality
- Add example queries and helpful tips for new users
- Improve page layout and visual feedback

* feat: add code quality tools and pre-commit configuration

- Add pre-commit hooks with Black, Flake8, isort, and MyPy
- Configure pyproject.toml for consistent code formatting
- Set up automated code quality checks on commits
- Include trailing whitespace and file formatting hooks
- Configure type checking and import sorting standards

* ci: add GitHub Actions workflow for automated code quality checks

- Create CI pipeline testing Python 3.8-3.12 compatibility
- Add automated Black, isort, Flake8, and MyPy checks
- Include import structure validation for all modules
- Set up continuous integration for pull requests and pushes
- Enable early detection of code quality issues

* docs: modernize README with comprehensive documentation

- Convert from RST to Markdown format with modern styling
- Add badges for Python version, license, and build status
- Include architecture diagram and visual project overview
- Add detailed quick start guide and usage examples
- Provide comprehensive troubleshooting section
- Include contribution guidelines and development setup

* docs: add comprehensive development guide

- Create detailed developer setup instructions
- Add code quality standards and guidelines
- Include testing and debugging tips
- Provide architecture overview and project structure
- Document common development issues and solutions

* fix: apply code formatting and linting fixes

- Apply Black code formatting to all Python files
- Fix import sorting with isort
- Resolve all Flake8 linting issues
- Fix MyPy type checking errors
- Remove unused imports and variables
- Fix line length violations and formatting inconsistencies
- Add proper type annotations for global variables
- Add test_env to .gitignore

* fix: resolve Python 3.8 compatibility issues

- Create separate requirements-py38.txt for Python 3.8 compatibility
- Use numpy>=1.21.0,<1.25.0 for Python 3.8 (numpy 1.26.4 requires Python 3.9+)
- Use pandas>=1.5.0,<2.1.0 for Python 3.8 compatibility
- Update Python 3.8 workflow to use Python 3.8 compatible requirements
- Update cache key to reference correct requirements file

* simplify: streamline CI/CD pipeline to Python 3.11 only

- Remove Python 3.8 compatibility workflow and requirements
- Simplify code quality workflow to use single Python 3.11 version
- Update pyproject.toml configurations to target Python 3.11
- Reduce CI complexity while maintaining code quality checks

* refactor: simplify CI/CD - remove code quality checks

- Remove Black, isort, Flake8, and MyPy checks from CI/CD
- Code quality should be enforced via pre-commit hooks locally
- Rename workflow from 'Code Quality' to 'CI Tests'
- Keep only dependency installation and import structure tests
- Prevents PR failures due to formatting issues

* feat: apply PR review fixes

- Centralize logging in entrypoints; Streamlit force logging; gate file logs via env
- Embeddings: chunk + mean pool, retry/backoff, timeouts
- Similarity: switch to cosine (L2-normalize + IndexFlatIP); show proper score
- Metadata: truncate stored content to keep index lean
- Config: default WATCHED_DIR to cwd
- Tests: remove OpenAI dependency; dummy vector test
- CI: add lint/mypy/pytest job; README 3.11+
- Docs: add AGENTS.md contributor guide

* style: fix import order per isort

* ci: align flake8 flags with project (88 cols, ignore E203,W503)

* ci: ensure coderag is importable during pytest (set PYTHONPATH)

Co-authored-by: Neverdecel <[email protected]>