diff --git a/docs/releases/v2.2.1.md b/docs/releases/v2.2.1.md new file mode 100644 index 0000000..3606862 --- /dev/null +++ b/docs/releases/v2.2.1.md @@ -0,0 +1,35 @@ +# Narratio v2.2.1 + +This maintenance release consolidates checkpoint persistence for transcription +and analysis without changing their operator-facing behavior. + +## Summary + +Transcribe and analyze now share one internal operation for preparing isolated +checkpoint candidates, saving them, and promoting successfully saved progress +into live state. Each stage retains its own progress model and recovery policy. + +## Compatibility + +CLI commands, configuration, manifest schemas, artifact formats, and external +integration contracts are unchanged. Speaker concurrency, artifact selection, +force behavior, and ordinary resume semantics are preserved. No dependency +upgrade or new external-tool version requirement is introduced. + +## Upgrade + +No special upgrade action or configuration migration is required when upgrading +from v2.2.0. See the [v2.2.0 release notes](v2.2.0.md) when upgrading from an +earlier version for the original speaker-checkpoint upgrade considerations. + +## Changes + +- Replace duplicate analyze/transcribe save-and-promote sequences with a + shared, private checkpoint helper. +- Isolate checkpoint collections from live state, including analyze records + normalized during a transcription checkpoint save. +- Preserve transcription's caller-owned locking and failure handling, and + analysis's working/committed collections and rollback behavior. +- Add focused checkpoint integrity tests while retaining stage and application + recovery coverage. +- Document the shared [checkpoint persistence boundary](../internal/manifest.md#checkpoint-persistence-boundary).