LogFlow Foundation (dev/main -> main)

[Gearlux]

1. Major Features

   • Multiprocess-Safe Logging: Core engine built on Loguru with enqueue=True and a cross-platform spawn context fix to prevent CI hangs.
   • Distributed Awareness: Automatic rank detection for PyTorch DDP, SLURM, and MPI. Console output is cleanly filtered to Rank 0.
   • Hierarchical Configuration: Supports pyproject.toml, logflow.yaml, environment variables, and XDG user configs with a strictly defined priority.
   • Framework Interoperability: Intercepts standard logging and warnings (from TF/PyTorch) into a unified stream.
   • CI/CD Pipeline: Fully configured GitHub Actions and local Jenkins pipeline with Linting (Black, Isort, Flake8), Type Checking (Mypy), and Test Coverage (94%).

2. Files Added

• logflow/core.py, logflow/config.py, logflow/discovery.py, logflow/intercept.py: Logic.
• tests/: Comprehensive test suite (core, config, discovery, intercept, MP).
• .github/workflows/ci.yml & Jenkinsfile: Automation.
• README.md, RATIONALE.md, FUTURE_DEVELOPMENT.md: Documentation.
• logflow.example.yaml: Config template.

3. Engineering Assessment
   The code adheres to PEP 8, is strictly typed, and has high test coverage (94%). It uses surgical replace operations and avoids sleep() for synchronization.