feat: add comprehensive code quality tools and configuration

[uelkerd]

PR-15: Code Quality Infrastructure

Implements comprehensive code quality tools and configuration for the SAMO-DL project.

Changes

• pyproject.toml: Project configuration with Black, Flake8, Pylint, MyPy, Bandit, Safety
• .pylintrc: SAMO-DL specific linting rules and configuration
• .pre-commit-config.yaml: Automated quality checks on commit
• .flake8: Code style enforcement configuration
• Makefile: Convenient development commands
• GitHub Actions: CI/CD quality checks workflow
• CONTRIBUTING.md: Development guidelines and standards
• Quality Scripts: Automated quality checking and dev environment setup

Files Added

• .pylintrc - Pylint configuration
• pyproject.toml - Project configuration and tool settings
• .pre-commit-config.yaml - Pre-commit hooks configuration
• .flake8 - Flake8 linting configuration
• Makefile - Development commands
• .github/workflows/quality.yml - CI/CD quality checks
• CONTRIBUTING.md - Contribution guidelines
• scripts/run_quality_checks.py - Quality checking script
• scripts/setup_dev_environment.py - Dev environment setup

Quality Standards

• Code Formatting: Black (88 char line length)
• Import Sorting: isort with Black profile
• Linting: Flake8 + Pylint
• Type Checking: MyPy with strict settings
• Security: Bandit + Safety
• Testing: pytest with 80% coverage requirement
• Pre-commit: Automated quality checks

Usage

# Set up development environment
make setup

# Run quality checks
make quality-check

# Format code
make format

# Run tests
make test

Files: 10 files, ~300 lines
Purpose: Code quality infrastructure and development tooling
Part of: Surgical breakdown PR #145
References: PR #147

Summary by CodeRabbit

• New Features

  • Added multiple REST endpoints (emotion, summarization, transcription, complete analysis), API docs/examples, health and metrics endpoints, and a local Flask server.

• Security

  • API key auth, in-memory rate limiting, stricter JWT secret enforcement, and more generic client-facing error messages.

• Documentation

  • Streamlined CONTRIBUTING and README; updated API docs/examples and redacted secret sample.

• Tests

  • Extensive unit, integration, and system tests covering endpoints and health/monitoring.

• Chores

  • CI/code-quality workflow, pre-commit/tooling updates, Makefile and developer setup/quality scripts.