utterplan 0.6.12__tar.gz → 0.6.13__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (253) hide show
  1. {utterplan-0.6.12 → utterplan-0.6.13}/.github/workflows/python-publish.yml +1 -1
  2. {utterplan-0.6.12 → utterplan-0.6.13}/.github/workflows/tests.yml +2 -2
  3. {utterplan-0.6.12 → utterplan-0.6.13}/PKG-INFO +2 -2
  4. {utterplan-0.6.12 → utterplan-0.6.13}/docs/architecture.md +1 -1
  5. {utterplan-0.6.12 → utterplan-0.6.13}/docs/changelog.md +9 -1
  6. {utterplan-0.6.12 → utterplan-0.6.13}/docs/consumer-guide.md +2 -1
  7. {utterplan-0.6.12 → utterplan-0.6.13}/docs/format.md +1 -0
  8. {utterplan-0.6.12 → utterplan-0.6.13}/pyproject.toml +1 -1
  9. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_renderplan_dependency_contract.py +1 -1
  10. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_renderplan_replan.py +36 -0
  11. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_renderplan_v7_contract.py +267 -0
  12. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/_version.py +3 -3
  13. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/renderplan_grouping.py +46 -19
  14. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan.egg-info/PKG-INFO +2 -2
  15. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan.egg-info/requires.txt +1 -1
  16. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan.egg-info/scm_file_list.json +10 -0
  17. utterplan-0.6.13/utterplan.egg-info/scm_version.json +8 -0
  18. utterplan-0.6.12/utterplan.egg-info/scm_version.json +0 -8
  19. {utterplan-0.6.12 → utterplan-0.6.13}/.codecrate.toml +0 -0
  20. {utterplan-0.6.12 → utterplan-0.6.13}/.github/workflows/codecov.yml +0 -0
  21. {utterplan-0.6.12 → utterplan-0.6.13}/.github/workflows/pre-commit.yml +0 -0
  22. {utterplan-0.6.12 → utterplan-0.6.13}/.gitignore +0 -0
  23. {utterplan-0.6.12 → utterplan-0.6.13}/.pre-commit-config.yaml +0 -0
  24. {utterplan-0.6.12 → utterplan-0.6.13}/AGENTS.md +0 -0
  25. {utterplan-0.6.12 → utterplan-0.6.13}/LICENSE +0 -0
  26. {utterplan-0.6.12 → utterplan-0.6.13}/MANIFEST.in +0 -0
  27. {utterplan-0.6.12 → utterplan-0.6.13}/NOTICE +0 -0
  28. {utterplan-0.6.12 → utterplan-0.6.13}/README.md +0 -0
  29. {utterplan-0.6.12 → utterplan-0.6.13}/docs/Makefile +0 -0
  30. {utterplan-0.6.12 → utterplan-0.6.13}/docs/bundles.md +0 -0
  31. {utterplan-0.6.12 → utterplan-0.6.13}/docs/cli.md +0 -0
  32. {utterplan-0.6.12 → utterplan-0.6.13}/docs/conf.py +0 -0
  33. {utterplan-0.6.12 → utterplan-0.6.13}/docs/coordinate-spaces.md +0 -0
  34. {utterplan-0.6.12 → utterplan-0.6.13}/docs/debugging.md +0 -0
  35. {utterplan-0.6.12 → utterplan-0.6.13}/docs/getting-started.md +0 -0
  36. {utterplan-0.6.12 → utterplan-0.6.13}/docs/index.md +0 -0
  37. {utterplan-0.6.12 → utterplan-0.6.13}/docs/make.bat +0 -0
  38. {utterplan-0.6.12 → utterplan-0.6.13}/docs/phase-a-completion.md +0 -0
  39. {utterplan-0.6.12 → utterplan-0.6.13}/docs/pykokoro-integration.md +0 -0
  40. {utterplan-0.6.12 → utterplan-0.6.13}/docs/python-api.md +0 -0
  41. {utterplan-0.6.12 → utterplan-0.6.13}/docs/requirements.txt +0 -0
  42. {utterplan-0.6.12 → utterplan-0.6.13}/examples/basic.py +0 -0
  43. {utterplan-0.6.12 → utterplan-0.6.13}/examples/chapter.ssmd +0 -0
  44. {utterplan-0.6.12 → utterplan-0.6.13}/examples/compile_file.py +0 -0
  45. {utterplan-0.6.12 → utterplan-0.6.13}/examples/inspect_plan.py +0 -0
  46. {utterplan-0.6.12 → utterplan-0.6.13}/examples/multilingual.py +0 -0
  47. {utterplan-0.6.12 → utterplan-0.6.13}/examples/ssmd_example.py +0 -0
  48. {utterplan-0.6.12 → utterplan-0.6.13}/setup.cfg +0 -0
  49. {utterplan-0.6.12 → utterplan-0.6.13}/spec/schemas/v1.schema.json +0 -0
  50. {utterplan-0.6.12 → utterplan-0.6.13}/spec/schemas/v2.schema.json +0 -0
  51. {utterplan-0.6.12 → utterplan-0.6.13}/spec/schemas/v3.schema.json +0 -0
  52. {utterplan-0.6.12 → utterplan-0.6.13}/spec/schemas/v4.schema.json +0 -0
  53. {utterplan-0.6.12 → utterplan-0.6.13}/spec/utterplan.schema.json +0 -0
  54. {utterplan-0.6.12 → utterplan-0.6.13}/tests/__init__.py +0 -0
  55. {utterplan-0.6.12 → utterplan-0.6.13}/tests/compiler_helpers.py +0 -0
  56. {utterplan-0.6.12 → utterplan-0.6.13}/tests/fixtures/canonical_consumer_contract.expected.toml +0 -0
  57. {utterplan-0.6.12 → utterplan-0.6.13}/tests/fixtures/canonical_consumer_contract.ssmd +0 -0
  58. {utterplan-0.6.12 → utterplan-0.6.13}/tests/fixtures/document-bundle-v1/story.ssmd-bundle/document.ssmd.md +0 -0
  59. {utterplan-0.6.12 → utterplan-0.6.13}/tests/fixtures/document-bundle-v1/story.ssmd-bundle/manifest.json +0 -0
  60. {utterplan-0.6.12 → utterplan-0.6.13}/tests/fixtures/ssmd_09_comprehensive.ssmd +0 -0
  61. {utterplan-0.6.12 → utterplan-0.6.13}/tests/golden/basic_en.utterplan.toml +0 -0
  62. {utterplan-0.6.12 → utterplan-0.6.13}/tests/golden/directives.utterplan.toml +0 -0
  63. {utterplan-0.6.12 → utterplan-0.6.13}/tests/golden/markers.utterplan.toml +0 -0
  64. {utterplan-0.6.12 → utterplan-0.6.13}/tests/golden/multilingual.utterplan.toml +0 -0
  65. {utterplan-0.6.12 → utterplan-0.6.13}/tests/golden/parenthetical.utterplan.toml +0 -0
  66. {utterplan-0.6.12 → utterplan-0.6.13}/tests/golden/spokenform_offsets.utterplan.toml +0 -0
  67. {utterplan-0.6.12 → utterplan-0.6.13}/tests/golden/ssmd_09_comprehensive.utterplan.toml +0 -0
  68. {utterplan-0.6.12 → utterplan-0.6.13}/tests/golden/ssmd_breaks.utterplan.toml +0 -0
  69. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/__init__.py +0 -0
  70. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/cases.py +0 -0
  71. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/fixtures/v4/basic_en.utterplan.json +0 -0
  72. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/fixtures/v4/directives.utterplan.json +0 -0
  73. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/fixtures/v4/markers.utterplan.json +0 -0
  74. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/fixtures/v4/multilingual.utterplan.json +0 -0
  75. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/fixtures/v4/parenthetical.utterplan.json +0 -0
  76. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/fixtures/v4/spokenform_offsets.utterplan.json +0 -0
  77. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/fixtures/v4/ssmd_09_comprehensive.utterplan.json +0 -0
  78. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/fixtures/v4/ssmd_breaks.utterplan.json +0 -0
  79. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/goldens/multilingual_preparation.json +0 -0
  80. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/goldens/spokenform_numbers.json +0 -0
  81. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/goldens/ssmd_break.json +0 -0
  82. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/goldens/ssmd_language_detection.json +0 -0
  83. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/goldens/ssmd_marker.json +0 -0
  84. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/goldens/ssmd_pronunciation.json +0 -0
  85. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/test_legacy_json_import.py +0 -0
  86. {utterplan-0.6.12 → utterplan-0.6.13}/tests/migration/test_semantic_migration_regressions.py +0 -0
  87. {utterplan-0.6.12 → utterplan-0.6.13}/tests/schema_history/README.md +0 -0
  88. {utterplan-0.6.12 → utterplan-0.6.13}/tests/schema_history/v1/basic.json +0 -0
  89. {utterplan-0.6.12 → utterplan-0.6.13}/tests/schema_history/v1/directives.json +0 -0
  90. {utterplan-0.6.12 → utterplan-0.6.13}/tests/schema_history/v1/markers.json +0 -0
  91. {utterplan-0.6.12 → utterplan-0.6.13}/tests/schema_history/v1/multilingual.json +0 -0
  92. {utterplan-0.6.12 → utterplan-0.6.13}/tests/schema_history/v1/parenthetical.json +0 -0
  93. {utterplan-0.6.12 → utterplan-0.6.13}/tests/schema_history/v1/spokenform_offsets.json +0 -0
  94. {utterplan-0.6.12 → utterplan-0.6.13}/tests/schema_history/v1/ssmd_breaks.json +0 -0
  95. {utterplan-0.6.12 → utterplan-0.6.13}/tests/schema_history/v2/directives.json +0 -0
  96. {utterplan-0.6.12 → utterplan-0.6.13}/tests/schema_history/v3/multilingual.json +0 -0
  97. {utterplan-0.6.12 → utterplan-0.6.13}/tests/schema_history/v3/ssmd_09_comprehensive.json +0 -0
  98. {utterplan-0.6.12 → utterplan-0.6.13}/tests/schema_history/v5/canonical_consumer_contract.toml +0 -0
  99. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_atomic_io.py +0 -0
  100. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_batch.py +0 -0
  101. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_boundaries.py +0 -0
  102. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_bundle_book_replan.py +0 -0
  103. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_bundle_book_services.py +0 -0
  104. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_bundle_document_compile.py +0 -0
  105. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_bundle_document_render.py +0 -0
  106. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_bundle_replan.py +0 -0
  107. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_bundle_role_inventory.py +0 -0
  108. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_bundle_services.py +0 -0
  109. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_cli.py +0 -0
  110. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_cli_batch.py +0 -0
  111. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_cli_bundle_compile_book.py +0 -0
  112. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_cli_bundle_document.py +0 -0
  113. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_cli_bundle_render_book.py +0 -0
  114. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_cli_bundle_render_document.py +0 -0
  115. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_cli_bundle_replan_book.py +0 -0
  116. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_compiler.py +0 -0
  117. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_consumer_contract.py +0 -0
  118. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_consumer_readiness.py +0 -0
  119. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_coordinates.py +0 -0
  120. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_dependency_architecture.py +0 -0
  121. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_directives.py +0 -0
  122. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_explain.py +0 -0
  123. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_fake_renderer.py +0 -0
  124. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_flow_compilation.py +0 -0
  125. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_format.py +0 -0
  126. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_golden.py +0 -0
  127. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_identity_units.py +0 -0
  128. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_import_boundaries.py +0 -0
  129. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_language.py +0 -0
  130. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_linguistics.py +0 -0
  131. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_migration_framework.py +0 -0
  132. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_migration_v3_to_v4.py +0 -0
  133. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_migration_v4_to_v5.py +0 -0
  134. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_pauses.py +0 -0
  135. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_planner.py +0 -0
  136. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_preparation.py +0 -0
  137. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_prepared_semantics.py +0 -0
  138. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_preview.py +0 -0
  139. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_progress.py +0 -0
  140. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_public_identity.py +0 -0
  141. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_renderability.py +0 -0
  142. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_renderability_repair.py +0 -0
  143. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_renderplan_batch.py +0 -0
  144. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_renderplan_export.py +0 -0
  145. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_replacement_provenance.py +0 -0
  146. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_role_coverage.py +0 -0
  147. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_schema_history.py +0 -0
  148. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_schema_registry.py +0 -0
  149. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_schema_strict.py +0 -0
  150. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_schema_v6_source.py +0 -0
  151. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_schema_v7.py +0 -0
  152. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_segment_topology.py +0 -0
  153. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_segmentation_adapter.py +0 -0
  154. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_segmentation_recovery.py +0 -0
  155. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_semantic_boundaries.py +0 -0
  156. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_sentence_topology.py +0 -0
  157. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_source_input.py +0 -0
  158. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_ssmd_09_parser.py +0 -0
  159. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_ssmd_bundle.py +0 -0
  160. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_ssmd_bundle_book.py +0 -0
  161. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_ssmd_bundle_document.py +0 -0
  162. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_ssmd_substitution_preparation.py +0 -0
  163. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_token_topology.py +0 -0
  164. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_toml_format.py +0 -0
  165. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_ttsready_preparation_adapter.py +0 -0
  166. {utterplan-0.6.12 → utterplan-0.6.13}/tests/test_version.py +0 -0
  167. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/__init__.py +0 -0
  168. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/__main__.py +0 -0
  169. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/_book_replan.py +0 -0
  170. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/_book_service.py +0 -0
  171. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/_document_service.py +0 -0
  172. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/atomic_io.py +0 -0
  173. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/attempt_serialization.py +0 -0
  174. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/attempts.py +0 -0
  175. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/batch.py +0 -0
  176. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/boundaries.py +0 -0
  177. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/bundle.py +0 -0
  178. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/bundle_replan.py +0 -0
  179. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/bundle_role_inventory.py +0 -0
  180. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/cli.py +0 -0
  181. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/codecs/__init__.py +0 -0
  182. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/codecs/v4_toml.py +0 -0
  183. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/codecs/v5_toml.py +0 -0
  184. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/codecs/v6_toml.py +0 -0
  185. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/codecs/v7_toml.py +0 -0
  186. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/compiler.py +0 -0
  187. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/config.py +0 -0
  188. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/diagnostics.py +0 -0
  189. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/directives.py +0 -0
  190. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/exceptions.py +0 -0
  191. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/explain.py +0 -0
  192. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/flow_projection.py +0 -0
  193. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/format.py +0 -0
  194. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/hashing.py +0 -0
  195. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/language.py +0 -0
  196. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/linguistics.py +0 -0
  197. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/migration.py +0 -0
  198. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/migrations/__init__.py +0 -0
  199. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/migrations/registry.py +0 -0
  200. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/migrations/v1_to_v2.py +0 -0
  201. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/migrations/v2_to_v3.py +0 -0
  202. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/migrations/v3_to_v4.py +0 -0
  203. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/migrations/v4_to_v5.py +0 -0
  204. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/migrations/v5_to_v6.py +0 -0
  205. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/migrations/v6_to_v7.py +0 -0
  206. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/model.py +0 -0
  207. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/parsers.py +0 -0
  208. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/pauses.py +0 -0
  209. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/planner.py +0 -0
  210. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/preparation.py +0 -0
  211. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/prepared_semantics.py +0 -0
  212. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/preview.py +0 -0
  213. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/progress.py +0 -0
  214. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/py.typed +0 -0
  215. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/renderability.py +0 -0
  216. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/renderplan_batch.py +0 -0
  217. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/renderplan_export.py +0 -0
  218. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/renderplan_projection.py +0 -0
  219. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/renderplan_replan.py +0 -0
  220. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/renderplan_workspace.py +0 -0
  221. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/renderprofile_io.py +0 -0
  222. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/role_coverage.py +0 -0
  223. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/schema_registry.py +0 -0
  224. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/schemas/v1.schema.json +0 -0
  225. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/schemas/v2.schema.json +0 -0
  226. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/schemas/v3.schema.json +0 -0
  227. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/schemas/v4.schema.json +0 -0
  228. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/segmentation.py +0 -0
  229. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/serialization.py +0 -0
  230. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/source_input.py +0 -0
  231. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/spacy_models.py +0 -0
  232. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/spans.py +0 -0
  233. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/ssmd_bundle.py +0 -0
  234. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/stages/__init__.py +0 -0
  235. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/stages/document/__init__.py +0 -0
  236. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/stages/document/plain.py +0 -0
  237. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/stages/document/ssmd.py +0 -0
  238. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/stages/preparation/__init__.py +0 -0
  239. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/stages/preparation/identity.py +0 -0
  240. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/stages/preparation/ssmd.py +0 -0
  241. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/stages/preparation/ttsready.py +0 -0
  242. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/stages/protocols.py +0 -0
  243. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/token_topology.py +0 -0
  244. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/toml_codec.py +0 -0
  245. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/trace_codec.py +0 -0
  246. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/units.py +0 -0
  247. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/utterplan.schema.json +0 -0
  248. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/versioning.py +0 -0
  249. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan/workspace_paths.py +0 -0
  250. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan.egg-info/SOURCES.txt +0 -0
  251. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan.egg-info/dependency_links.txt +0 -0
  252. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan.egg-info/entry_points.txt +0 -0
  253. {utterplan-0.6.12 → utterplan-0.6.13}/utterplan.egg-info/top_level.txt +0 -0
@@ -82,7 +82,7 @@ jobs:
82
82
  assert has_range(requirements, "phrasplit", "0.3.9", "0.4")
83
83
  assert has_range(requirements, "ssmd", "0.9.3", "0.10")
84
84
  assert has_range(requirements, "ttsready", "0.2.3", "0.3")
85
- assert has_range(requirements, "renderplan", "0.2.0", "0.3")
85
+ assert has_range(requirements, "renderplan", "0.2.1", "0.3")
86
86
  names = set(archive.namelist())
87
87
  expected = {
88
88
  "utterplan/py.typed",
@@ -51,7 +51,7 @@ jobs:
51
51
  "ssmd==0.9.3" \
52
52
  "ttsready==0.2.3" \
53
53
  "spokenform==0.4.5" \
54
- "renderplan==0.2.0" \
54
+ "renderplan==0.2.1" \
55
55
  "typing_extensions==4.0.0" \
56
56
  "tomlkit==0.13.0"
57
57
  python -m pip install --no-deps -e .
@@ -120,7 +120,7 @@ jobs:
120
120
  "phrasplit": ("0.3.9", "0.4"),
121
121
  "ssmd": ("0.9.3", "0.10"),
122
122
  "ttsready": ("0.2.3", "0.3"),
123
- "renderplan": ("0.2.0", "0.3"),
123
+ "renderplan": ("0.2.1", "0.3"),
124
124
  }
125
125
 
126
126
  def check_metadata(contents):
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: utterplan
3
- Version: 0.6.12
3
+ Version: 0.6.13
4
4
  Summary: Engine-independent text-to-speech planning compiler and interchange format
5
5
  Author-email: Holger Nahrstaedt <nahrstaedt@gmail.com>
6
6
  License: Apache License
@@ -227,7 +227,7 @@ Requires-Dist: ssmd<0.10,>=0.9.3
227
227
  Requires-Dist: ttsready<0.3,>=0.2.3
228
228
  Requires-Dist: typing_extensions>=4.0
229
229
  Requires-Dist: tomlkit<1,>=0.13
230
- Requires-Dist: renderplan<0.3,>=0.2.0
230
+ Requires-Dist: renderplan<0.3,>=0.2.1
231
231
  Provides-Extra: dev
232
232
  Requires-Dist: build; extra == "dev"
233
233
  Requires-Dist: jsonschema; extra == "dev"
@@ -241,7 +241,7 @@ Supporting tactics:
241
241
 
242
242
  After written-to-spoken preparation and before segmentation, UtterPlan inspects verified replacement records for the exact character-spelling transformation: an ASCII uppercase-letter/digit core of at least two characters becomes the same characters joined by single spaces, optionally retaining an identical `'s` or `’s` suffix. This derives a compiler-owned `say_as=characters` annotation over only the prepared character core. For example, `[ART]{sub=\"A R T\"}` keeps prepared text `A R T`; `[ART's]{sub=\"A R T's\"}` keeps `A R T's` and marks only `A R T`.
243
243
 
244
- The derivation is portable executable intent, not a renderer-specific spelling rewrite. Prepared text never becomes `A- R- T`; a renderer adapter may choose that frontend form. Existing semantic-edge segmentation produces the exact controlled span, while RenderPlan sentence grouping retains the full sentence as one normal speech request with a request-local control. This feature adds neither a sentence split nor an automatic pause.
244
+ The derivation is portable executable intent, not a renderer-specific spelling rewrite. Prepared text never becomes `A- R- T`; a renderer adapter may choose that frontend form. Existing semantic-edge segmentation produces the exact controlled span, while default RenderPlan sentence grouping retains the full sentence as one normal speech request with a request-local control. An explicit manual `pauses.parenthetical` duration is a separate opt-in policy: RenderPlan may split at UtterPlan's stored parenthetical edges and project pauses without reparsing or rewriting text; profiles without it keep the existing grouping.
245
245
 
246
246
  Authored `say-as` semantics take precedence, and the consumed SSMD `sub` annotation remains consumed. The derived directive uses existing schema-v7 `SayAsDirective` serialization and identity hashing; replacement records remain diagnostic provenance and are not synthesis input. No schema version or migration changes are required.
247
247
 
@@ -4,7 +4,15 @@
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
- ## [v0.6.12] - Unreleased
7
+ ## [v0.6.13] - 2026-10-30
8
+
9
+ ### Added
10
+
11
+ - Added opt-in parenthetical request splitting and configurable pauses to RenderPlan projection
12
+
13
+ <!-- generated by releaseledger -->
14
+
15
+ ## [v0.6.12] - 2026-10-29
8
16
 
9
17
  ### Changed
10
18
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  UtterPlan ends at a semantic planning boundary. A renderer consumes the public `FlowPlan` and begins G2P after planning. It does not need a TOML round trip when planner and renderer run in the same process.
4
4
 
5
- The schema-v7 plan is renderer-independent: `FlowUnit` grouping is fixed paragraph-local, while `FlowSegment` boundary arrays carry safe cut opportunities. Segments are not necessarily TTS calls, and UtterPlan's linguistic tokens are not model-token counts. A consumer may choose sentence, paragraph, or engine-token-budget chunks and native, automatic, or manual pause realization without changing the saved plan.
5
+ The schema-v7 plan is renderer-independent: `FlowUnit` grouping is fixed paragraph-local, while `FlowSegment` boundary arrays carry safe cut opportunities. Segments are not necessarily TTS calls, and UtterPlan's linguistic tokens are not model-token counts. Consumers choose sentence, paragraph, or engine-token-budget chunks and native, automatic, or manual pause realization without changing the saved plan. Optional RenderPlan projection can also opt in to splitting sentence requests at stored parenthetical edges through an explicit manual RenderProfile pause policy; this does not change the FlowPlan.
6
6
 
7
7
  For persistence across processes, save a current plan as `.utterplan.toml` and load it with `FlowPlan.load()`. `to_toml()` / `from_toml()` provide text round-tripping, and `plan_id` identifies executable semantics rather than TOML formatting. Batch reports and optional compiler traces are operational/provenance artifacts, not plans.
8
8
 
@@ -39,6 +39,7 @@ In Python, `PlannerConfig.document_format` defaults to `"plain"`; select `"ssmd"
39
39
  - `directives`: typed voice, pronunciation, prosody, emphasis, say-as, substitution, audio, and extension data.
40
40
  - `markers` and optional `heading` metadata already localized to the owning segment.
41
41
 
42
+ RenderPlan's parenthetical policy is independent of FlowPlan compilation. Only a manual RenderProfile that explicitly includes `pauses.parenthetical` activates it; a zero duration still splits requests; omitting the key preserves current behavior, and `mode = "none"` disables this automatic policy even if a stale duration remains. Newly created Kokoro profiles seed `180ms` in VoiceRender, but existing user profiles are not mutated. The original `(` and `)` remain in speech text, and only UtterPlan's stored semantic boundaries are used.
42
43
  Token offsets are half-open Python-character ranges into the owning `segment.text`. Do not use them to slice document text or add offsets from another segment. Consumers preserve stored segment order but decide downstream chunk boundaries; a segment is not necessarily one TTS call.
43
44
  Token `pos`, `tag`, `lemma`, and `morph` describe that exact prepared text and are the authoritative linguistic context, not model-token IDs or counts. Consumers may pass them through without retokenizing or rerunning spaCy. Optional replacements are provenance only: their output spans are segment-local, source values are original spellings, and they do not alter hashes independently of the source digest and are not synthesis inputs.
44
45
 
@@ -42,6 +42,7 @@ Each ordered `flow` entry is a `FlowUnit` with a stable local `hash` and one or
42
42
 
43
43
  `boundary_before` / `boundary_after` list unique safe opportunities from `clause`, `sentence`, `paragraph`, `parenthetical`, and `voice_change` in canonical order; a parenthetical or sentence opportunity is not a pause directive. Authored pause intents are kept separately, so a boundary and an authored `none`, strength, or timed break can coexist at one edge. A `FlowSegment` is a semantic plan segment, not necessarily a renderer call or final TTS chunk.
44
44
 
45
+ In optional RenderPlan projection, a RenderProfile with `pauses.mode = "manual"` and an explicit `pauses.parenthetical = "180ms"` turns each stored parenthetical edge into a speech-request boundary and one `PauseItem`. The key's presence activates the split even at `0ms`; omitting it preserves existing grouping, and `mode = "none"` disables it. Canonical text, source spans, and segment-local facts are not rewritten.
45
46
  Consumers may project saved flow into `segment`, `clause`, `sentence`, or `paragraph` preview chunks without changing schema-v7 data. The public preview concatenates each selected chunk's stored `segment.text` exactly; token and replacement spans remain local to their original segments. Pause policies are projections only and do not persist renderer timing or activate boundaries in the plan.
46
47
 
47
48
  Token `span` entries are half-open Python-character ranges local to their owning segment's `text`. `pos`, `tag`, `lemma`, and `morph` carry final prepared-text linguistic facts; dense columns align with spans and sparse columns use ascending `[token_index, value]` pairs. Absent lemma values derive from case-folded surface text; an explicit empty sparse lemma preserves an unknown value. These fields describe linguistic tokens, not engine token IDs or model-token counts; consumers may pass the context through without retokenizing or rerunning spaCy.
@@ -17,7 +17,7 @@ dependencies = [
17
17
  "ttsready>=0.2.3,<0.3",
18
18
  "typing_extensions>=4.0",
19
19
  "tomlkit>=0.13,<1",
20
- "renderplan>=0.2.0,<0.3",
20
+ "renderplan>=0.2.1,<0.3",
21
21
  ]
22
22
  classifiers = [
23
23
  "Development Status :: 3 - Alpha",
@@ -29,4 +29,4 @@ def test_renderplan_collection_api_minimum_is_declared_as_runtime_dependency() -
29
29
  project = tomlkit.parse(
30
30
  (Path(__file__).resolve().parents[1] / "pyproject.toml").read_text(encoding="utf-8")
31
31
  ).unwrap()
32
- assert "renderplan>=0.2.0,<0.3" in project["project"]["dependencies"]
32
+ assert "renderplan>=0.2.1,<0.3" in project["project"]["dependencies"]
@@ -183,6 +183,42 @@ def test_replan_replaces_only_failed_occurrence_and_preserves_later_id() -> None
183
183
  assert rebuilt.plan_id != previous.plan_id
184
184
 
185
185
 
186
+ def test_replan_preserves_parenthetical_semantic_end_on_last_clause_child() -> None:
187
+ plan = _plan(
188
+ FlowSegment("A ", "en-US", boundary_after=("clause",)),
189
+ FlowSegment("B ", "en-US", boundary_after=("parenthetical",)),
190
+ FlowSegment(
191
+ "(x)",
192
+ "en-US",
193
+ boundary_before=("parenthetical",),
194
+ boundary_after=("sentence",),
195
+ ),
196
+ )
197
+ profile = replace(
198
+ _profile(),
199
+ pauses=PausePolicy(
200
+ mode="manual",
201
+ durations_ms={"clause": 180, "parenthetical": 180, "sentence": 500},
202
+ ),
203
+ profile_id=None,
204
+ )
205
+ index, profile, previous = _build_previous(plan, profile)
206
+ failed = previous.speech[0]
207
+ assert failed.text == "A B "
208
+ assert failed.semantic_end == "parenthetical"
209
+
210
+ flow = replan_flow(index, profile, previous, _preflight(previous, profile, (failed,)))
211
+ speech = _speech_text(flow)
212
+
213
+ assert [item.text for item in speech] == ["A ", "B ", "(x)"]
214
+ assert [item.semantic_end for item in speech] == ["clause", "parenthetical", "sentence"]
215
+ assert [item.reason for item in flow if isinstance(item, PauseItem)] == [
216
+ "capacity",
217
+ "parenthetical",
218
+ "sentence",
219
+ ]
220
+
221
+
186
222
  def test_successful_prior_splits_survive_replanning_an_unrelated_child() -> None:
187
223
  plan = _plan(
188
224
  FlowSegment("A1 ", "en-US", boundary_after=("clause",)),
@@ -1,5 +1,7 @@
1
1
  from __future__ import annotations
2
2
 
3
+ from dataclasses import replace
4
+
3
5
  import pytest
4
6
  from renderplan import (
5
7
  AudioItem,
@@ -217,6 +219,45 @@ def _group(plan: FlowPlan, profile: RenderProfile):
217
219
  return group_initial_plan(build_source_index(plan), profile)
218
220
 
219
221
 
222
+ def _parenthetical_plan(
223
+ *,
224
+ entry_pause: PauseIntent | None = None,
225
+ exit_pause: PauseIntent | None = None,
226
+ ) -> FlowPlan:
227
+ return FlowPlan(
228
+ language="en-US",
229
+ flow=(
230
+ FlowUnit(
231
+ (
232
+ FlowSegment(
233
+ "Before ",
234
+ "en-US",
235
+ tokens=(TokenView(0, 6),),
236
+ pause_after=entry_pause,
237
+ boundary_after=("parenthetical",),
238
+ ),
239
+ FlowSegment(
240
+ "(aside)",
241
+ "en-US",
242
+ directives=SegmentDirectives(emphasis=EmphasisDirective("strong")),
243
+ tokens=(TokenView(1, 6),),
244
+ boundary_before=("parenthetical",),
245
+ pause_after=exit_pause,
246
+ boundary_after=("parenthetical",),
247
+ ),
248
+ FlowSegment(
249
+ " after.",
250
+ "en-US",
251
+ tokens=(TokenView(1, 6),),
252
+ boundary_before=("parenthetical",),
253
+ boundary_after=("sentence",),
254
+ ),
255
+ )
256
+ ),
257
+ ),
258
+ )
259
+
260
+
220
261
  def test_sentence_grouping_joins_exact_prepared_text_and_ignores_clause_boundaries() -> None:
221
262
  plan = FlowPlan(
222
263
  language="en-US",
@@ -240,6 +281,232 @@ def test_sentence_grouping_joins_exact_prepared_text_and_ignores_clause_boundari
240
281
  assert next(item for item in flow if isinstance(item, PauseItem)).reason == "sentence"
241
282
 
242
283
 
284
+ def test_parenthetical_boundaries_remain_joined_when_pause_policy_is_unset() -> None:
285
+ plan = _parenthetical_plan()
286
+ profile = _profile(pauses={"sentence": 500})
287
+
288
+ flow = _group(plan, profile)
289
+ speech = [item for item in flow if isinstance(item, SpeechItem)]
290
+ pauses = [item for item in flow if isinstance(item, PauseItem)]
291
+
292
+ assert [item.text for item in speech] == ["Before (aside) after."]
293
+ assert [item.semantic_end for item in speech] == ["sentence"]
294
+ assert [(item.duration_ms, item.reason) for item in pauses] == [(500, "sentence")]
295
+ assert _group(plan, profile) == flow
296
+
297
+
298
+ @pytest.mark.parametrize("duration", (180, 0))
299
+ def test_configured_parenthetical_edges_split_once_and_preserve_request_fidelity(
300
+ duration: int,
301
+ ) -> None:
302
+ plan = _parenthetical_plan()
303
+ profile = _profile(pauses={"parenthetical": duration, "sentence": 500})
304
+
305
+ flow = _group(plan, profile)
306
+ speech = [item for item in flow if isinstance(item, SpeechItem)]
307
+ pauses = [item for item in flow if isinstance(item, PauseItem)]
308
+
309
+ assert [type(item) for item in flow] == [
310
+ SpeechItem,
311
+ PauseItem,
312
+ SpeechItem,
313
+ PauseItem,
314
+ SpeechItem,
315
+ PauseItem,
316
+ ]
317
+ assert [item.text for item in speech] == ["Before ", "(aside)", " after."]
318
+ assert [item.semantic_end for item in speech] == [
319
+ "parenthetical",
320
+ "parenthetical",
321
+ "sentence",
322
+ ]
323
+ assert [(item.duration_ms, item.reason) for item in pauses] == [
324
+ (duration, "parenthetical"),
325
+ (duration, "parenthetical"),
326
+ (500, "sentence"),
327
+ ]
328
+ assert "".join(item.text for item in speech) == "Before (aside) after."
329
+ assert [item.source for item in speech] == [
330
+ (SourceSpan("f000000.s000", 0, 7),),
331
+ (SourceSpan("f000000.s001", 0, 7),),
332
+ (SourceSpan("f000000.s002", 0, 7),),
333
+ ]
334
+ assert [item.tokens.span if item.tokens is not None else None for item in speech] == [
335
+ ((0, 6),),
336
+ ((1, 6),),
337
+ ((1, 6),),
338
+ ]
339
+ assert [
340
+ [(control.start, control.end, control.name) for control in item.controls] for item in speech
341
+ ] == [[], [(0, 7, "emphasis")], []]
342
+ assert _group(plan, profile) == flow
343
+
344
+
345
+ def test_parenthetical_policy_is_disabled_by_none_mode() -> None:
346
+ plan = _parenthetical_plan()
347
+ profile = _profile()
348
+ profile = replace(
349
+ profile,
350
+ pauses=PausePolicy(mode="none", durations_ms={"parenthetical": 180}),
351
+ profile_id=None,
352
+ )
353
+
354
+ flow = _group(plan, profile)
355
+
356
+ assert [item.text for item in flow if isinstance(item, SpeechItem)] == ["Before (aside) after."]
357
+ assert not any(isinstance(item, PauseItem) and item.reason == "parenthetical" for item in flow)
358
+
359
+
360
+ def test_authored_none_suppresses_only_parenthetical_policy_splits() -> None:
361
+ plan = _parenthetical_plan(
362
+ entry_pause=PauseIntent("none"),
363
+ exit_pause=PauseIntent("none"),
364
+ )
365
+ profile = _profile(pauses={"parenthetical": 180, "sentence": 500})
366
+
367
+ flow = _group(plan, profile)
368
+
369
+ assert [item.text for item in flow if isinstance(item, SpeechItem)] == ["Before (aside) after."]
370
+ assert [(item.duration_ms, item.reason) for item in flow if isinstance(item, PauseItem)] == [
371
+ (500, "sentence")
372
+ ]
373
+
374
+
375
+ def test_authored_none_resolves_coincident_sentence_parenthetical_edge() -> None:
376
+ edge = ("sentence", "parenthetical")
377
+ plan = FlowPlan(
378
+ language="en-US",
379
+ flow=(
380
+ FlowUnit(
381
+ (
382
+ FlowSegment(
383
+ "Before ",
384
+ "en-US",
385
+ pause_after=PauseIntent("none"),
386
+ boundary_after=edge,
387
+ ),
388
+ FlowSegment(
389
+ "(aside)",
390
+ "en-US",
391
+ boundary_before=edge,
392
+ boundary_after=("sentence",),
393
+ ),
394
+ )
395
+ ),
396
+ ),
397
+ )
398
+ profile = _profile(pauses={"parenthetical": 180, "sentence": 500})
399
+
400
+ flow = _group(plan, profile)
401
+ speech = [item for item in flow if isinstance(item, SpeechItem)]
402
+ pauses = [item for item in flow if isinstance(item, PauseItem)]
403
+
404
+ assert [item.text for item in speech] == ["Before ", "(aside)"]
405
+ assert speech[0].semantic_end == "sentence"
406
+ assert [(item.duration_ms, item.reason) for item in pauses] == [
407
+ (0, "authored_none"),
408
+ (500, "sentence"),
409
+ ]
410
+
411
+
412
+ @pytest.mark.parametrize(
413
+ ("intent", "extra_pause", "expected"),
414
+ (
415
+ (PauseIntent("timed", "350ms"), {}, (350, "timed")),
416
+ (PauseIntent("strong"), {"strong": 400}, (400, "strong")),
417
+ ),
418
+ )
419
+ def test_authored_timed_and_named_pauses_win_at_parenthetical_edges(
420
+ intent: PauseIntent,
421
+ extra_pause: dict[str, int],
422
+ expected: tuple[int, str],
423
+ ) -> None:
424
+ plan = _parenthetical_plan(entry_pause=intent)
425
+ profile = _profile(pauses={"parenthetical": 180, **extra_pause})
426
+
427
+ flow = _group(plan, profile)
428
+
429
+ assert [
430
+ (item.duration_ms, item.reason)
431
+ for item in flow
432
+ if isinstance(item, PauseItem) and item.reason != "sentence"
433
+ ] == [expected, (180, "parenthetical")]
434
+
435
+
436
+ def test_parenthetical_policy_uses_boundaries_not_surface_punctuation() -> None:
437
+ plan = FlowPlan(
438
+ language="en-US",
439
+ flow=(
440
+ FlowUnit(
441
+ (FlowSegment("The value (x) is fixed.", "en-US", boundary_after=("sentence",)),)
442
+ ),
443
+ ),
444
+ )
445
+ profile = _profile(pauses={"parenthetical": 180, "sentence": 500})
446
+
447
+ flow = _group(plan, profile)
448
+
449
+ assert [item.text for item in flow if isinstance(item, SpeechItem)] == [
450
+ "The value (x) is fixed."
451
+ ]
452
+ assert [item.reason for item in flow if isinstance(item, PauseItem)] == ["sentence"]
453
+
454
+
455
+ def test_nested_parenthetical_edges_emit_one_pause_per_adjacency() -> None:
456
+ plan = FlowPlan(
457
+ language="en-US",
458
+ flow=(
459
+ FlowUnit(
460
+ (
461
+ FlowSegment("outer ", "en-US", boundary_after=("parenthetical",)),
462
+ FlowSegment(
463
+ "(inside ",
464
+ "en-US",
465
+ boundary_before=("parenthetical",),
466
+ boundary_after=("parenthetical",),
467
+ ),
468
+ FlowSegment(
469
+ "(nested)",
470
+ "en-US",
471
+ boundary_before=("parenthetical",),
472
+ boundary_after=("parenthetical",),
473
+ ),
474
+ FlowSegment(
475
+ " again)",
476
+ "en-US",
477
+ boundary_before=("parenthetical",),
478
+ boundary_after=("parenthetical",),
479
+ ),
480
+ FlowSegment(
481
+ " end.",
482
+ "en-US",
483
+ boundary_before=("parenthetical",),
484
+ boundary_after=("sentence",),
485
+ ),
486
+ )
487
+ ),
488
+ ),
489
+ )
490
+ profile = _profile(pauses={"parenthetical": 180, "sentence": 500})
491
+
492
+ flow = _group(plan, profile)
493
+
494
+ assert [item.text for item in flow if isinstance(item, SpeechItem)] == [
495
+ "outer ",
496
+ "(inside ",
497
+ "(nested)",
498
+ " again)",
499
+ " end.",
500
+ ]
501
+ assert [(item.duration_ms, item.reason) for item in flow if isinstance(item, PauseItem)] == [
502
+ (180, "parenthetical"),
503
+ (180, "parenthetical"),
504
+ (180, "parenthetical"),
505
+ (180, "parenthetical"),
506
+ (500, "sentence"),
507
+ ]
508
+
509
+
243
510
  def test_clause_and_paragraph_grouping_follow_topology_not_punctuation() -> None:
244
511
  plan = FlowPlan(
245
512
  language="en-US",
@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
18
18
  commit_id: str | None
19
19
  __commit_id__: str | None
20
20
 
21
- __version__ = version = '0.6.12'
22
- __version_tuple__ = version_tuple = (0, 6, 12)
21
+ __version__ = version = '0.6.13'
22
+ __version_tuple__ = version_tuple = (0, 6, 13)
23
23
 
24
- __commit_id__ = commit_id = 'g90bcab31c'
24
+ __commit_id__ = commit_id = 'g17f1aed9c'
@@ -3,7 +3,7 @@
3
3
  from __future__ import annotations
4
4
 
5
5
  import re
6
- from collections.abc import Sequence
6
+ from collections.abc import Iterable, Sequence
7
7
  from dataclasses import replace
8
8
  from typing import Any, TypeAlias
9
9
 
@@ -22,7 +22,7 @@ from .renderplan_projection import RenderPlanProjectionError, SourceSegmentIndex
22
22
  FlowItem: TypeAlias = AudioItem | PauseItem | SpeechItem
23
23
 
24
24
  _TIMED_PAUSE = re.compile(r"^(0|[1-9][0-9]*)ms$")
25
- _BOUNDARY_PRIORITY = {"clause": 1, "sentence": 2, "paragraph": 3, "voice_change": 4}
25
+ _STRUCTURAL_BOUNDARY_PRIORITY = {"clause": 1, "sentence": 2, "paragraph": 3, "voice_change": 4}
26
26
  _AUTHORED_PAUSES = frozenset({"timed", "x-weak", "weak", "medium", "strong", "x-strong"})
27
27
 
28
28
 
@@ -88,7 +88,8 @@ def group_initial_plan(index: SourceSegmentIndex, profile: RenderProfile) -> tup
88
88
  else:
89
89
  left_ref = refs[position - 1]
90
90
  left = left_ref.segment
91
- boundary = _boundary_kind(left, segment)
91
+ edge_kinds = _boundary_kinds(left, segment)
92
+ boundary = _structural_boundary_kind(edge_kinds)
92
93
  left_pause = _pause_intent(left.pause_after, left_ref.locator)
93
94
  right_pause = _pause_intent(segment.pause_before, ref.locator)
94
95
  media_change = (left.directives.audio is None) != (audio is None)
@@ -108,29 +109,44 @@ def group_initial_plan(index: SourceSegmentIndex, profile: RenderProfile) -> tup
108
109
  else None
109
110
  )
110
111
  authored_break = _has_timed_or_named(left_pause) or _has_timed_or_named(right_pause)
111
- should_close = policy_split or hard_reason is not None or authored_break
112
+ authored_none_only = not authored_break and any(
113
+ intent is not None and intent.type == "none" for intent in (left_pause, right_pause)
114
+ )
115
+ parenthetical_policy_break = (
116
+ "parenthetical" in edge_kinds
117
+ and _parenthetical_pause_enabled(profile)
118
+ and not authored_none_only
119
+ )
120
+ should_close = (
121
+ policy_split
122
+ or hard_reason is not None
123
+ or authored_break
124
+ or parenthetical_policy_break
125
+ )
112
126
  if should_close:
113
- actual_end = (
114
- "voice_change" if voice_change else boundary if policy_split else "none"
115
- )
127
+ if voice_change:
128
+ semantic_boundary = "voice_change"
129
+ elif policy_split:
130
+ semantic_boundary = boundary
131
+ elif parenthetical_policy_break:
132
+ semantic_boundary = "parenthetical"
133
+ else:
134
+ semantic_boundary = None
116
135
  if group_source:
117
136
  close_group(
118
137
  planning_level="hard" if hard_reason else profile.planning.split,
119
138
  split_reason=hard_reason or "policy",
120
- semantic_end=actual_end,
139
+ semantic_end=semantic_boundary or "none",
121
140
  )
122
141
  pause = _resolve_pause(
123
142
  left_pause,
124
143
  right_pause,
125
- semantic_end=("voice_change" if voice_change else boundary)
126
- if policy_split or voice_change
127
- else None,
144
+ semantic_end=semantic_boundary,
128
145
  profile=profile,
129
146
  capacity_cut=False,
130
147
  )
131
148
  if pause is not None:
132
149
  flow.append(pause)
133
-
134
150
  if audio is not None:
135
151
  if group_source:
136
152
  close_group(planning_level="hard", split_reason="media", semantic_end=boundary)
@@ -210,19 +226,30 @@ def _effective_state(
210
226
  return role_name, role.language, segment.language, role
211
227
 
212
228
 
213
- def _boundary_kind(left: FlowSegment, right: FlowSegment) -> str:
214
- kinds = set(left.boundary_after).union(right.boundary_before)
215
- return max(kinds, key=lambda kind: _BOUNDARY_PRIORITY.get(kind, 0), default="none")
229
+ def _boundary_kinds(left: FlowSegment, right: FlowSegment) -> frozenset[str]:
230
+ return frozenset(left.boundary_after).union(right.boundary_before)
216
231
 
217
232
 
218
- def _terminal_boundary(segment: FlowSegment) -> str:
233
+ def _structural_boundary_kind(kinds: Iterable[str]) -> str:
219
234
  return max(
220
- segment.boundary_after,
221
- key=lambda kind: _BOUNDARY_PRIORITY.get(kind, 0),
235
+ (kind for kind in kinds if kind in _STRUCTURAL_BOUNDARY_PRIORITY),
236
+ key=_STRUCTURAL_BOUNDARY_PRIORITY.__getitem__,
222
237
  default="none",
223
238
  )
224
239
 
225
240
 
241
+ def _boundary_kind(left: FlowSegment, right: FlowSegment) -> str:
242
+ return _structural_boundary_kind(_boundary_kinds(left, right))
243
+
244
+
245
+ def _terminal_boundary(segment: FlowSegment) -> str:
246
+ return _structural_boundary_kind(segment.boundary_after)
247
+
248
+
249
+ def _parenthetical_pause_enabled(profile: RenderProfile) -> bool:
250
+ return profile.pauses.mode == "manual" and "parenthetical" in profile.pauses.durations_ms
251
+
252
+
226
253
  def _policy_splits(policy: str, boundary: str) -> bool:
227
254
  if boundary == "voice_change":
228
255
  return True
@@ -692,7 +719,7 @@ def _child_speech(
692
719
  planning_level=planning_level,
693
720
  split_reason=split_reason,
694
721
  semantic_end=semantic_end
695
- if semantic_end in {"clause", "sentence", "paragraph", "voice_change"}
722
+ if semantic_end in {"clause", "sentence", "paragraph", "parenthetical", "voice_change"}
696
723
  else "none",
697
724
  tokens=index.tokens_for(source, required_fields=role_profile.requirements.token_fields),
698
725
  controls=index.controls_for(source),
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: utterplan
3
- Version: 0.6.12
3
+ Version: 0.6.13
4
4
  Summary: Engine-independent text-to-speech planning compiler and interchange format
5
5
  Author-email: Holger Nahrstaedt <nahrstaedt@gmail.com>
6
6
  License: Apache License
@@ -227,7 +227,7 @@ Requires-Dist: ssmd<0.10,>=0.9.3
227
227
  Requires-Dist: ttsready<0.3,>=0.2.3
228
228
  Requires-Dist: typing_extensions>=4.0
229
229
  Requires-Dist: tomlkit<1,>=0.13
230
- Requires-Dist: renderplan<0.3,>=0.2.0
230
+ Requires-Dist: renderplan<0.3,>=0.2.1
231
231
  Provides-Extra: dev
232
232
  Requires-Dist: build; extra == "dev"
233
233
  Requires-Dist: jsonschema; extra == "dev"
@@ -3,7 +3,7 @@ ssmd<0.10,>=0.9.3
3
3
  ttsready<0.3,>=0.2.3
4
4
  typing_extensions>=4.0
5
5
  tomlkit<1,>=0.13
6
- renderplan<0.3,>=0.2.0
6
+ renderplan<0.3,>=0.2.1
7
7
 
8
8
  [dev]
9
9
  build
@@ -149,6 +149,9 @@
149
149
  ".ledger/releaseledger/data/ledgers/main/releases/v0.6.10/release.md",
150
150
  ".ledger/releaseledger/data/ledgers/main/releases/v0.6.12/entries/entry-0001.md",
151
151
  ".ledger/releaseledger/data/ledgers/main/releases/v0.6.12/release.md",
152
+ ".ledger/releaseledger/data/ledgers/main/releases/v0.6.13/audit/commit-audit.yaml",
153
+ ".ledger/releaseledger/data/ledgers/main/releases/v0.6.13/entries/entry-0002.md",
154
+ ".ledger/releaseledger/data/ledgers/main/releases/v0.6.13/release.md",
152
155
  ".ledger/releaseledger/data/ledgers/main/releases/v0.6.2/audit/commit-audit.yaml",
153
156
  ".ledger/releaseledger/data/ledgers/main/releases/v0.6.2/entries/entry-0001.md",
154
157
  ".ledger/releaseledger/data/ledgers/main/releases/v0.6.2/release.md",
@@ -285,6 +288,13 @@
285
288
  ".ledger/releaseledger/work/v0.6.10/evidence/ec4b806.patch",
286
289
  ".ledger/releaseledger/work/v0.6.10/evidence/manifest.json",
287
290
  ".ledger/releaseledger/work/v0.6.10/range.json",
291
+ ".ledger/releaseledger/work/v0.6.13/audit-decisions.yaml",
292
+ ".ledger/releaseledger/work/v0.6.13/audit.yaml",
293
+ ".ledger/releaseledger/work/v0.6.13/entries.yaml",
294
+ ".ledger/releaseledger/work/v0.6.13/evidence/874da57.patch",
295
+ ".ledger/releaseledger/work/v0.6.13/evidence/88dc839.patch",
296
+ ".ledger/releaseledger/work/v0.6.13/evidence/manifest.json",
297
+ ".ledger/releaseledger/work/v0.6.13/range.json",
288
298
  ".ledger/releaseledger/work/v0.6.2/audit-decisions.yaml",
289
299
  ".ledger/releaseledger/work/v0.6.2/audit.yaml",
290
300
  ".ledger/releaseledger/work/v0.6.2/entries.yaml",
@@ -0,0 +1,8 @@
1
+ {
2
+ "tag": "0.6.13",
3
+ "distance": 0,
4
+ "node": "g17f1aed9ce485ed86b9b3de9a28791cc3e435577",
5
+ "dirty": false,
6
+ "branch": "HEAD",
7
+ "node_date": "2026-10-30"
8
+ }