massgen · Henry-811 · Apr 27, 2026 · Apr 23, 2026 · Apr 25, 2026 · Apr 25, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,6 +9,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Recent Releases
 
+**v0.1.81 (April 27, 2026)** - Multi-Region Circuit Breaker Failover (Phase 6)
+LLM circuit breaker can now fail over to backup regions when the primary trips OPEN, with automatic recovery when the primary returns to healthy. Builds on Phase 4 (distributed store) and Phase 5 (adaptive thresholds).
+
 **v0.1.80 (April 22, 2026)** - Adaptive Circuit Breaker & Checkpoint Modes
 Circuit breaker Phase 5 adds adaptive thresholds that tune to each backend's behavior. New standalone checkpoint modes: single checkpoint (no recheckpointing) and draft plan verify mode.
 
@@ -20,6 +23,18 @@ Pluggable distributed state store for the LLM circuit breaker — share state ac
 
 ---
 
+## [0.1.81] - 2026-04-27
+
+### Added
+- **Multi-Region Circuit Breaker Failover (Phase 6)** ([#1072](https://github.com/massgen/MassGen/pull/1072)): LLM circuit breaker fails over to backup regions when the primary trips OPEN, with automatic recovery when the primary returns to healthy
+
+### Technical Details
+- **Major Focus**: Multi-region failover for production-grade circuit breaker resilience — completes the circuit breaker series (Phase 1-6)
+- **PRs Merged**: [#1072](https://github.com/massgen/MassGen/pull/1072)
+- **Contributors**: @amabito, @HenryQi and the MassGen team
+
+---
+
 ## [0.1.80] - 2026-04-22
 
 ### Added

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -359,7 +359,7 @@ Create a `.env` file in the `massgen` directory as described in [README](README.
 
 ## 🔧 Development Workflow
 
-> **Important**: Our next version is v0.1.81. If you want to contribute, please contribute to the `dev/v0.1.81` branch (or `main` if dev/v0.1.81 doesn't exist yet).
+> **Important**: Our next version is v0.1.82. If you want to contribute, please contribute to the `dev/v0.1.82` branch (or `main` if dev/v0.1.82 doesn't exist yet).
 
 ### 1. Create Feature Branch
 
@@ -368,7 +368,7 @@ Create a `.env` file in the `massgen` directory as described in [README](README.
 git fetch upstream
 
 # Create feature branch from dev/v0.1.60 (or main if dev branch doesn't exist yet)
-git checkout -b feature/your-feature-name upstream/dev/v0.1.81
+git checkout -b feature/your-feature-name upstream/dev/v0.1.82
 ```
 
 ### 2. Make Your Changes
@@ -507,7 +507,7 @@ git push origin feature/your-feature-name
 ```
 
 Then create a pull request on GitHub:
-- Base branch: `dev/v0.1.81` (or `main` if dev branch doesn't exist yet)
+- Base branch: `dev/v0.1.82` (or `main` if dev branch doesn't exist yet)
 - Compare branch: `feature/your-feature-name`
 - Add clear description of changes
 - Link any related issues
@@ -617,7 +617,7 @@ Have a significant feature idea not covered by existing tracks?
 - [ ] Tests pass locally
 - [ ] Documentation is updated if needed
 - [ ] Commit messages follow convention
-- [ ] PR targets `dev/v0.1.81` branch (or `main` if dev branch doesn't exist yet)
+- [ ] PR targets `dev/v0.1.82` branch (or `main` if dev branch doesn't exist yet)
 
 ### PR Description Should Include
 

diff --git a/README.md b/README.md
@@ -69,7 +69,7 @@ This project started with the "threads of thought" and "iterative refinement" id
 <details open>
 <summary><h3>🆕 Latest Features</h3></summary>
 
-- [v0.1.80 Features](#-latest-features-v0180)
+- [v0.1.81 Features](#-latest-features-v0181)
 </details>
 
 <details open>
@@ -122,15 +122,15 @@ This project started with the "threads of thought" and "iterative refinement" id
 <details open>
 <summary><h3>🗺️ Roadmap</h3></summary>
 
-- [Recent Achievements (v0.1.80)](#recent-achievements-v0180)
-- [Previous Achievements (v0.0.3 - v0.1.79)](#previous-achievements-v003---v0179)
+- [Recent Achievements (v0.1.81)](#recent-achievements-v0181)
+- [Previous Achievements (v0.0.3 - v0.1.80)](#previous-achievements-v003---v0180)
 - [Key Future Enhancements](#key-future-enhancements)
   - Bug Fixes & Backend Improvements
   - Advanced Agent Collaboration
   - Expanded Model, Tool & Agent Integrations
   - Improved Performance & Scalability
   - Enhanced Developer Experience
-- [v0.1.81 Roadmap](#v0181-roadmap)
+- [v0.1.82 Roadmap](#v0182-roadmap)
 </details>
 
 <details open>
@@ -155,21 +155,17 @@ This project started with the "threads of thought" and "iterative refinement" id
 
 ---
 
-## 🆕 Latest Features (v0.1.80)
+## 🆕 Latest Features (v0.1.81)
 
-**🎉 Released: April 22, 2026**
+**🎉 Released: April 27, 2026**
 
-**What's New in v0.1.80:**
-- **🎯 Circuit Breaker Adaptive Thresholds (Phase 5)** - Self-tuning thresholds that respond to each backend's actual failure patterns.
-- **🛡️ Single Checkpoint Mode** - New standalone checkpoint mode — no recheckpointing within a single operation.
-- **📋 Draft Plan Verify Mode** - New standalone checkpoint mode — verify a draft plan before executing.
+**What's New in v0.1.81:**
+- **🌐 Multi-Region Circuit Breaker Failover (Phase 6)** - LLM circuit breaker fails over to backup regions when the primary trips OPEN, with automatic recovery when the primary returns to healthy.
 
-**Try v0.1.80 Features:**
+**Try v0.1.81 Features:**
 ```bash
-pip install massgen==0.1.80
-# Try checkpoint MCP in Claude Code
-claude mcp add massgen-checkpoint-mcp -- \
-  uvx --from massgen massgen-checkpoint-mcp --config path/to/config.yaml
+pip install massgen==0.1.81
+uv run massgen --config @examples/features/fast_iteration.yaml "Create an svg of an AI agent coding."
 ```
 
 → [See full release history and examples](massgen/configs/README.md#release-history--examples)
@@ -1241,16 +1237,17 @@ MassGen is currently in its foundational stage, with a focus on parallel, asynch
 
 ⚠️ **Early Stage Notice:** As MassGen is in active development, please expect upcoming breaking architecture changes as we continue to refine and improve the system.
 
-### Recent Achievements (v0.1.80)
+### Recent Achievements (v0.1.81)
 
-**🎉 Released: April 22, 2026**
+**🎉 Released: April 27, 2026**
 
-#### Adaptive Circuit Breaker & Checkpoint Modes
-- **Circuit Breaker Adaptive Thresholds (Phase 5)** ([#1065](https://github.com/massgen/MassGen/pull/1065)): Self-tuning thresholds that respond to each backend's actual failure patterns
-- **Single Checkpoint Mode** ([#1070](https://github.com/massgen/MassGen/pull/1070)): No recheckpointing within a single operation
-- **Draft Plan Verify Mode** ([#1070](https://github.com/massgen/MassGen/pull/1070)): Verify a draft plan before executing
+#### Multi-Region Circuit Breaker Failover (Phase 6)
+- **Multi-Region Failover** ([#1072](https://github.com/massgen/MassGen/pull/1072)): LLM circuit breaker fails over to backup regions when the primary trips OPEN, with automatic recovery when the primary returns to healthy
+- **Production-Grade Resilience**: Builds on Phase 4 (distributed store) and Phase 5 (adaptive thresholds)
 
-### Previous Achievements (v0.0.3 - v0.1.79)
+### Previous Achievements (v0.0.3 - v0.1.80)
+
+✅ **Adaptive Circuit Breaker & Checkpoint Modes (v0.1.80)**: Circuit breaker Phase 5 with self-tuning adaptive thresholds. New standalone checkpoint modes: single checkpoint and draft plan verify.
 
 ✅ **Fast Mode Speed Control & Broader Checkpoint Framing (v0.1.79)**: New fast mode options for fine-grained speed vs. quality control. Checkpoint framing broadened from safety-only to high-stakes and coordinated phases.
 
@@ -1555,9 +1552,9 @@ MassGen is currently in its foundational stage, with a focus on parallel, asynch
 
 We welcome community contributions to achieve these goals.
 
-### v0.1.81 Roadmap
+### v0.1.82 Roadmap
 
-Version 0.1.81 focuses on cloud execution (deferred again from v0.1.80):
+Version 0.1.82 focuses on cloud execution (deferred again from v0.1.81):
 
 #### Planned Features
 - **Cloud Modal MVP** ([#982](https://github.com/massgen/MassGen/issues/982)): Run MassGen as a cloud job on Modal — progress streams to terminal, results saved locally under `.massgen/cloud_jobs/`

diff --git a/README_PYPI.md b/README_PYPI.md
@@ -68,7 +68,7 @@ This project started with the "threads of thought" and "iterative refinement" id
 <details open>
 <summary><h3>🆕 Latest Features</h3></summary>
 
-- [v0.1.80 Features](#-latest-features-v0180)
+- [v0.1.81 Features](#-latest-features-v0181)
 </details>
 
 <details open>
@@ -121,15 +121,15 @@ This project started with the "threads of thought" and "iterative refinement" id
 <details open>
 <summary><h3>🗺️ Roadmap</h3></summary>
 
-- [Recent Achievements (v0.1.80)](#recent-achievements-v0180)
-- [Previous Achievements (v0.0.3 - v0.1.79)](#previous-achievements-v003---v0179)
+- [Recent Achievements (v0.1.81)](#recent-achievements-v0181)
+- [Previous Achievements (v0.0.3 - v0.1.80)](#previous-achievements-v003---v0180)
 - [Key Future Enhancements](#key-future-enhancements)
   - Bug Fixes & Backend Improvements
   - Advanced Agent Collaboration
   - Expanded Model, Tool & Agent Integrations
   - Improved Performance & Scalability
   - Enhanced Developer Experience
-- [v0.1.81 Roadmap](#v0181-roadmap)
+- [v0.1.82 Roadmap](#v0182-roadmap)
 </details>
 
 <details open>
@@ -154,21 +154,17 @@ This project started with the "threads of thought" and "iterative refinement" id
 
 ---
 
-## 🆕 Latest Features (v0.1.80)
+## 🆕 Latest Features (v0.1.81)
 
-**🎉 Released: April 22, 2026**
+**🎉 Released: April 27, 2026**
 
-**What's New in v0.1.80:**
-- **🎯 Circuit Breaker Adaptive Thresholds (Phase 5)** - Self-tuning thresholds that respond to each backend's actual failure patterns.
-- **🛡️ Single Checkpoint Mode** - New standalone checkpoint mode — no recheckpointing within a single operation.
-- **📋 Draft Plan Verify Mode** - New standalone checkpoint mode — verify a draft plan before executing.
+**What's New in v0.1.81:**
+- **🌐 Multi-Region Circuit Breaker Failover (Phase 6)** - LLM circuit breaker fails over to backup regions when the primary trips OPEN, with automatic recovery when the primary returns to healthy.
 
-**Try v0.1.80 Features:**
+**Try v0.1.81 Features:**
 ```bash
-pip install massgen==0.1.80
-# Try checkpoint MCP in Claude Code
-claude mcp add massgen-checkpoint-mcp -- \
-  uvx --from massgen massgen-checkpoint-mcp --config path/to/config.yaml
+pip install massgen==0.1.81
+uv run massgen --config @examples/features/fast_iteration.yaml "Create an svg of an AI agent coding."
 ```
 
 → [See full release history and examples](massgen/configs/README.md#release-history--examples)
@@ -1240,16 +1236,17 @@ MassGen is currently in its foundational stage, with a focus on parallel, asynch
 
 ⚠️ **Early Stage Notice:** As MassGen is in active development, please expect upcoming breaking architecture changes as we continue to refine and improve the system.
 
-### Recent Achievements (v0.1.80)
+### Recent Achievements (v0.1.81)
 
-**🎉 Released: April 22, 2026**
+**🎉 Released: April 27, 2026**
 
-#### Adaptive Circuit Breaker & Checkpoint Modes
-- **Circuit Breaker Adaptive Thresholds (Phase 5)** ([#1065](https://github.com/massgen/MassGen/pull/1065)): Self-tuning thresholds that respond to each backend's actual failure patterns
-- **Single Checkpoint Mode** ([#1070](https://github.com/massgen/MassGen/pull/1070)): No recheckpointing within a single operation
-- **Draft Plan Verify Mode** ([#1070](https://github.com/massgen/MassGen/pull/1070)): Verify a draft plan before executing
+#### Multi-Region Circuit Breaker Failover (Phase 6)
+- **Multi-Region Failover** ([#1072](https://github.com/massgen/MassGen/pull/1072)): LLM circuit breaker fails over to backup regions when the primary trips OPEN, with automatic recovery when the primary returns to healthy
+- **Production-Grade Resilience**: Builds on Phase 4 (distributed store) and Phase 5 (adaptive thresholds)
 
-### Previous Achievements (v0.0.3 - v0.1.79)
+### Previous Achievements (v0.0.3 - v0.1.80)
+
+✅ **Adaptive Circuit Breaker & Checkpoint Modes (v0.1.80)**: Circuit breaker Phase 5 with self-tuning adaptive thresholds. New standalone checkpoint modes: single checkpoint and draft plan verify.
 
 ✅ **Fast Mode Speed Control & Broader Checkpoint Framing (v0.1.79)**: New fast mode options for fine-grained speed vs. quality control. Checkpoint framing broadened from safety-only to high-stakes and coordinated phases.
 
@@ -1554,9 +1551,9 @@ MassGen is currently in its foundational stage, with a focus on parallel, asynch
 
 We welcome community contributions to achieve these goals.
 
-### v0.1.81 Roadmap
+### v0.1.82 Roadmap
 
-Version 0.1.81 focuses on cloud execution (deferred again from v0.1.80):
+Version 0.1.82 focuses on cloud execution (deferred again from v0.1.81):
 
 #### Planned Features
 - **Cloud Modal MVP** ([#982](https://github.com/massgen/MassGen/issues/982)): Run MassGen as a cloud job on Modal — progress streams to terminal, results saved locally under `.massgen/cloud_jobs/`

diff --git a/ROADMAP.md b/ROADMAP.md
@@ -1,10 +1,10 @@
 # MassGen Roadmap
 
-**Current Version:** v0.1.80
+**Current Version:** v0.1.81
 
 **Release Schedule:** Mondays, Wednesdays, Fridays @ 9am PT
 
-**Last Updated:** April 22, 2026
+**Last Updated:** April 27, 2026
 
 This roadmap outlines MassGen's development priorities for upcoming releases. Each release focuses on specific capabilities with real-world use cases.
 
@@ -42,14 +42,27 @@ Want to contribute or collaborate on a specific track? Reach out to the track ow
 
 | Release | Target | Feature | Owner | Use Case |
 |---------|--------|---------|-------|----------|
-| **v0.1.81** | 04/24/26 | Cloud Modal MVP | @ncrispino | Run MassGen as a cloud job on Modal — deferred again ([#982](https://github.com/massgen/MassGen/issues/982)) |
-| **v0.1.82** | 04/27/26 | OpenAI Audio API | @ncrispino | Support OpenAI audio API for audio understanding ([#960](https://github.com/massgen/MassGen/issues/960)) |
-| **v0.1.83** | 04/29/26 | Image/Video Edit Capabilities | @ncrispino | Check and support img/video editing capabilities ([#959](https://github.com/massgen/MassGen/issues/959)) |
+| **v0.1.82** | 04/29/26 | Cloud Modal MVP | @ncrispino | Run MassGen as a cloud job on Modal — deferred again ([#982](https://github.com/massgen/MassGen/issues/982)) |
+| **v0.1.83** | 05/01/26 | OpenAI Audio API | @ncrispino | Support OpenAI audio API for audio understanding ([#960](https://github.com/massgen/MassGen/issues/960)) |
+| **v0.1.84** | 05/04/26 | Image/Video Edit Capabilities | @ncrispino | Check and support img/video editing capabilities ([#959](https://github.com/massgen/MassGen/issues/959)) |
 
 *All releases ship on MWF @ 9am PT when ready*
 
 ---
 
+## ✅ v0.1.81 - Multi-Region Circuit Breaker Failover (Phase 6) (Completed)
+
+**Released:** April 27, 2026 | PRs: [#1072](https://github.com/massgen/MassGen/pull/1072)
+
+### Features
+- **Multi-Region Failover**: LLM circuit breaker fails over to backup regions when the primary trips OPEN, with automatic recovery when the primary returns to healthy
+- **Production-Grade Resilience**: Builds on Phase 4 (distributed store) and Phase 5 (adaptive thresholds) for full multi-region resilience
+
+### Notes
+- Cloud Modal MVP originally planned for v0.1.81 — deferred again to v0.1.82.
+
+---
+
 ## ✅ v0.1.80 - Adaptive Circuit Breaker & Checkpoint Modes (Completed)
 
 **Released:** April 22, 2026 | PRs: [#1065](https://github.com/massgen/MassGen/pull/1065), [#1070](https://github.com/massgen/MassGen/pull/1070)
@@ -126,7 +139,7 @@ Want to contribute or collaborate on a specific track? Reach out to the track ow
 
 ---
 
-## 📋 v0.1.81 - Cloud Modal MVP (Deferred from v0.1.80)
+## 📋 v0.1.82 - Cloud Modal MVP (Deferred from v0.1.81)
 
 ### Features
 
@@ -142,7 +155,7 @@ Want to contribute or collaborate on a specific track? Reach out to the track ow
 
 ---
 
-## 📋 v0.1.82 - OpenAI Audio API
+## 📋 v0.1.83 - OpenAI Audio API
 
 ### Features
 
@@ -158,7 +171,7 @@ Want to contribute or collaborate on a specific track? Reach out to the track ow
 
 ---
 
-## 📋 v0.1.83 - Image/Video Edit Capabilities
+## 📋 v0.1.84 - Image/Video Edit Capabilities
 
 ### Features
 

diff --git a/ROADMAP_v0.1.81.md b/ROADMAP_v0.1.81.md
diff --git a/ROADMAP_v0.1.82.md b/ROADMAP_v0.1.82.md
@@ -0,0 +1,36 @@
+# MassGen v0.1.82 Roadmap
+
+**Target Release:** April 29, 2026
+
+## Overview
+
+Version 0.1.82 picks up the Cloud Modal MVP originally planned for v0.1.81 (deferred again because v0.1.81 shipped Multi-Region Circuit Breaker Failover (Phase 6) instead).
+
+---
+
+## Feature: Cloud Modal MVP
+
+**Issue:** [#982](https://github.com/massgen/MassGen/issues/982)
+**Owner:** @ncrispino
+
+### Goals
+
+- **Cloud Execution**: Run MassGen jobs in the cloud via `--cloud` option on Modal
+- Progress streams to terminal, results saved locally under `.massgen/cloud_jobs/`
+
+### Success Criteria
+
+- [ ] Cloud job execution functional on Modal
+- [ ] Progress streaming and artifact extraction working
+
+---
+
+## Related Tracks
+
+- **v0.1.81**: Multi-Region Circuit Breaker Failover (Phase 6) — regional failover, automatic recovery ([#1072](https://github.com/massgen/MassGen/pull/1072))
+- **v0.1.83**: OpenAI Audio API ([#960](https://github.com/massgen/MassGen/issues/960))
+
+## What's Next
+
+- **v0.1.83**: OpenAI Audio API — integrate OpenAI audio API with existing `read_media` tool for audio understanding
+- **v0.1.84**: Image/Video Edit Capabilities — investigate and support image/video editing across providers