Files
narratio/docs/releases/v2.2.1.md
Eric Rakestraw 70f1dbfb59
All checks were successful
ci/woodpecker/push/verify Pipeline was successful
ci/woodpecker/tag/release Pipeline was successful
Prepare the v2.2.1 release
2026-09-22 18:18:45 +00:00

1.5 KiB

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 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.