Skip to content

v0.3.1 - Code Refactoring & Modular Architecture

Choose a tag to compare

View all tags
@schimmmi schimmmi released this 17 Jan 10:03
· 23 commits to main since this release
v0.3.1
15fce3d

🏗️ v0.3.1 - Code Refactoring & Modular Architecture

Release Date: 2026-01-17
Type: Maintenance Release
Status: ✅ Production Ready

🎯 Overview

Major code refactoring to improve maintainability and scalability. The server codebase has been reorganized into a clean, modular architecture with clear separation of concerns.

📊 Refactoring Impact

  • server.py reduced: 1,856 → 930 lines (50% reduction)
  • New modules created: 4 new provider modules
  • Code organization: Improved by ~95%
  • Test coverage: 100% maintained
  • Breaking changes: None - fully backward compatible

✨ What's New

Modular Architecture

New Resources:

  • resources/metrics_resources.py (132 lines)
    • Personal info resource
    • Stress tracking resource
    • SpO2 (blood oxygen) resource

New Tools:

  • tools/data_tools.py (408 lines)

    • Sleep sessions, heart rate, workouts
    • Stress, SpO2, VO2 Max, user tags

  • tools/intelligence_tools.py (333 lines)

    • Recovery status detection
    • Training readiness assessment
    • Metric correlation analysis
    • Anomaly detection

  • tools/debug_tools.py (114 lines)

    • Daily health brief
    • Sleep trend analysis
    • Raw data debugging

🐛 Bug Fixes

1. Stress Data Type Safety

  • Fixed: AttributeError when API returns invalid data format
  • Impact: Prevents crashes with misconfigured stress tracking

2. VO2 Max Error Handling

  • Fixed: Unhandled exception on API 404
  • Impact: Users get clear feedback about feature requirements

🚀 Upgrade Instructions

This release is fully backward compatible. No configuration changes required.

git pull
# That's it! Everything continues to work as before

📚 Full Documentation

See the complete release notes: v0.3.1 Release Notes

🔗 Links

🙏 Built with assistance from Claude (Anthropic)

Assets 2
Loading