Changelog

Improved sentence topology with validated fallback recovery and token-edge safeguards

Fixed fallback token projection and sentence-boundary repair for punctuation-separated text

Added compile-book for selecting and compiling SSMDBook chapters into independent v5 plans with operational reports

BREAKING: Changed plan persistence to schema v5 with deterministic TOML, sequential legacy migration, and optional trace sidecars

Added persistable planning attempts with inspectable renderability outcomes and safe repair assessments

Changed planning APIs to expose blocked candidates without weakening canonical plan validation

Fixed legacy SSMD scene breaks to preserve front-matter boundaries and clean-to-source offsets

Documented planning-attempt artifacts, inspection workflows, and renderability guarantees

Added stable spoken-coordinate semantic boundaries for clause, parenthetical, sentence, and paragraph splits

Changed serialized plans to schema v4 with deterministic v3-to-v4 migration and boundary-sensitive unit identity

Changed plan persistence to deterministic TOML with explicit legacy JSON import and incremental batch compilation

Documented spoken-coordinate semantics, pause separation, migration limits, and consumer lowering

Improved package publishing workflow for the release toolchain

Added strict renderability checks and deterministic repair for isolated neutral punctuation segments

Fixed planner segmentation to keep neutral punctuation with adjacent speech while preserving exact annotation spans

Added typed planner progress events and reused unchanged linguistic analyses

Fixed renderer segmentation to retain adjacent neutral punctuation

Added canonical single-document compilation with plain-text support and preparation traces

Added SSMD sequence fallback mode controls for spoken-form preparation

Fixed text preparation so authored SSMD substitutions and say-as annotations remain unchanged

Added renderer-neutral SSMD audio segments with opaque sources and optional spoken fallback

Added PEP 561 metadata and SSMD 0.9 package checks

BREAKING: Changed source compatibility to SSMD 0.9 with typed schema v3 plans

BREAKING: Changed Python input defaults and renamed SSMDConfig options

Changed clause enrichment to reuse provider-owned spaCy docs

Fixed precedence so authored SSMD breaks override generated pauses

Documented the 0.2-to-0.3 migration paths

Added schema version 2 with embedded token annotations, linguistic run provenance, and a v1-to-v2 migration

Improved inspect and explain output with token annotations and linguistic run metadata

Fixed runnable examples with command-line arguments, path-safe outputs, and a dedicated SSMD example script

Added explain CLI command that renders compiled plans as human-readable speech narratives

Added schema versioning with frozen v1 schema and migration framework

Improved consumer contract with stable renderer input view and directive handling

Removed PyKokoro references and related test infrastructure

Documented changelog with release entries for v0.1.0, v0.1.1, and v0.1.2

Fixed obsolete migration test for PyKokoro frontend dump

Renamed package from wandler to utterplan

Added interactive text, stdin, SSMD, and file compilation workflows

Aligned migration dependency floors and packaged typing metadata

Added buildable MyST user and developer documentation for the public planning boundary

Expanded renderer consumer tests and optional PyKokoro parity evidence