utterplan 0.6.16__tar.gz → 0.6.17__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 (256) hide show
  1. {utterplan-0.6.16 → utterplan-0.6.17}/PKG-INFO +1 -1
  2. {utterplan-0.6.16 → utterplan-0.6.17}/docs/architecture.md +1 -1
  3. {utterplan-0.6.16 → utterplan-0.6.17}/docs/changelog.md +8 -0
  4. {utterplan-0.6.16 → utterplan-0.6.17}/docs/consumer-guide.md +2 -2
  5. {utterplan-0.6.16 → utterplan-0.6.17}/docs/format.md +1 -1
  6. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_renderplan_replan.py +68 -5
  7. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_renderplan_v7_contract.py +528 -93
  8. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/_version.py +3 -3
  9. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/renderplan_grouping.py +141 -5
  10. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan.egg-info/PKG-INFO +1 -1
  11. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan.egg-info/scm_file_list.json +2 -0
  12. utterplan-0.6.17/utterplan.egg-info/scm_version.json +8 -0
  13. utterplan-0.6.16/utterplan.egg-info/scm_version.json +0 -8
  14. {utterplan-0.6.16 → utterplan-0.6.17}/.codecrate.toml +0 -0
  15. {utterplan-0.6.16 → utterplan-0.6.17}/.github/workflows/codecov.yml +0 -0
  16. {utterplan-0.6.16 → utterplan-0.6.17}/.github/workflows/pre-commit.yml +0 -0
  17. {utterplan-0.6.16 → utterplan-0.6.17}/.github/workflows/python-publish.yml +0 -0
  18. {utterplan-0.6.16 → utterplan-0.6.17}/.github/workflows/tests.yml +0 -0
  19. {utterplan-0.6.16 → utterplan-0.6.17}/.gitignore +0 -0
  20. {utterplan-0.6.16 → utterplan-0.6.17}/.pre-commit-config.yaml +0 -0
  21. {utterplan-0.6.16 → utterplan-0.6.17}/AGENTS.md +0 -0
  22. {utterplan-0.6.16 → utterplan-0.6.17}/LICENSE +0 -0
  23. {utterplan-0.6.16 → utterplan-0.6.17}/MANIFEST.in +0 -0
  24. {utterplan-0.6.16 → utterplan-0.6.17}/NOTICE +0 -0
  25. {utterplan-0.6.16 → utterplan-0.6.17}/README.md +0 -0
  26. {utterplan-0.6.16 → utterplan-0.6.17}/docs/Makefile +0 -0
  27. {utterplan-0.6.16 → utterplan-0.6.17}/docs/bundles.md +0 -0
  28. {utterplan-0.6.16 → utterplan-0.6.17}/docs/cli.md +0 -0
  29. {utterplan-0.6.16 → utterplan-0.6.17}/docs/conf.py +0 -0
  30. {utterplan-0.6.16 → utterplan-0.6.17}/docs/coordinate-spaces.md +0 -0
  31. {utterplan-0.6.16 → utterplan-0.6.17}/docs/debugging.md +0 -0
  32. {utterplan-0.6.16 → utterplan-0.6.17}/docs/getting-started.md +0 -0
  33. {utterplan-0.6.16 → utterplan-0.6.17}/docs/index.md +0 -0
  34. {utterplan-0.6.16 → utterplan-0.6.17}/docs/make.bat +0 -0
  35. {utterplan-0.6.16 → utterplan-0.6.17}/docs/pause-timing-architecture.md +0 -0
  36. {utterplan-0.6.16 → utterplan-0.6.17}/docs/phase-a-completion.md +0 -0
  37. {utterplan-0.6.16 → utterplan-0.6.17}/docs/pykokoro-integration.md +0 -0
  38. {utterplan-0.6.16 → utterplan-0.6.17}/docs/python-api.md +0 -0
  39. {utterplan-0.6.16 → utterplan-0.6.17}/docs/requirements.txt +0 -0
  40. {utterplan-0.6.16 → utterplan-0.6.17}/examples/basic.py +0 -0
  41. {utterplan-0.6.16 → utterplan-0.6.17}/examples/chapter.ssmd +0 -0
  42. {utterplan-0.6.16 → utterplan-0.6.17}/examples/compile_file.py +0 -0
  43. {utterplan-0.6.16 → utterplan-0.6.17}/examples/inspect_plan.py +0 -0
  44. {utterplan-0.6.16 → utterplan-0.6.17}/examples/multilingual.py +0 -0
  45. {utterplan-0.6.16 → utterplan-0.6.17}/examples/ssmd_example.py +0 -0
  46. {utterplan-0.6.16 → utterplan-0.6.17}/pyproject.toml +0 -0
  47. {utterplan-0.6.16 → utterplan-0.6.17}/setup.cfg +0 -0
  48. {utterplan-0.6.16 → utterplan-0.6.17}/spec/schemas/v1.schema.json +0 -0
  49. {utterplan-0.6.16 → utterplan-0.6.17}/spec/schemas/v2.schema.json +0 -0
  50. {utterplan-0.6.16 → utterplan-0.6.17}/spec/schemas/v3.schema.json +0 -0
  51. {utterplan-0.6.16 → utterplan-0.6.17}/spec/schemas/v4.schema.json +0 -0
  52. {utterplan-0.6.16 → utterplan-0.6.17}/spec/utterplan.schema.json +0 -0
  53. {utterplan-0.6.16 → utterplan-0.6.17}/tests/__init__.py +0 -0
  54. {utterplan-0.6.16 → utterplan-0.6.17}/tests/compiler_helpers.py +0 -0
  55. {utterplan-0.6.16 → utterplan-0.6.17}/tests/fixtures/canonical_consumer_contract.expected.toml +0 -0
  56. {utterplan-0.6.16 → utterplan-0.6.17}/tests/fixtures/canonical_consumer_contract.ssmd +0 -0
  57. {utterplan-0.6.16 → utterplan-0.6.17}/tests/fixtures/document-bundle-v1/story.ssmd-bundle/document.ssmd.md +0 -0
  58. {utterplan-0.6.16 → utterplan-0.6.17}/tests/fixtures/document-bundle-v1/story.ssmd-bundle/manifest.json +0 -0
  59. {utterplan-0.6.16 → utterplan-0.6.17}/tests/fixtures/ssmd_09_comprehensive.ssmd +0 -0
  60. {utterplan-0.6.16 → utterplan-0.6.17}/tests/golden/basic_en.utterplan.toml +0 -0
  61. {utterplan-0.6.16 → utterplan-0.6.17}/tests/golden/directives.utterplan.toml +0 -0
  62. {utterplan-0.6.16 → utterplan-0.6.17}/tests/golden/markers.utterplan.toml +0 -0
  63. {utterplan-0.6.16 → utterplan-0.6.17}/tests/golden/multilingual.utterplan.toml +0 -0
  64. {utterplan-0.6.16 → utterplan-0.6.17}/tests/golden/parenthetical.utterplan.toml +0 -0
  65. {utterplan-0.6.16 → utterplan-0.6.17}/tests/golden/spokenform_offsets.utterplan.toml +0 -0
  66. {utterplan-0.6.16 → utterplan-0.6.17}/tests/golden/ssmd_09_comprehensive.utterplan.toml +0 -0
  67. {utterplan-0.6.16 → utterplan-0.6.17}/tests/golden/ssmd_breaks.utterplan.toml +0 -0
  68. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/__init__.py +0 -0
  69. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/cases.py +0 -0
  70. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/fixtures/v4/basic_en.utterplan.json +0 -0
  71. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/fixtures/v4/directives.utterplan.json +0 -0
  72. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/fixtures/v4/markers.utterplan.json +0 -0
  73. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/fixtures/v4/multilingual.utterplan.json +0 -0
  74. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/fixtures/v4/parenthetical.utterplan.json +0 -0
  75. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/fixtures/v4/spokenform_offsets.utterplan.json +0 -0
  76. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/fixtures/v4/ssmd_09_comprehensive.utterplan.json +0 -0
  77. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/fixtures/v4/ssmd_breaks.utterplan.json +0 -0
  78. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/goldens/multilingual_preparation.json +0 -0
  79. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/goldens/spokenform_numbers.json +0 -0
  80. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/goldens/ssmd_break.json +0 -0
  81. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/goldens/ssmd_language_detection.json +0 -0
  82. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/goldens/ssmd_marker.json +0 -0
  83. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/goldens/ssmd_pronunciation.json +0 -0
  84. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/test_legacy_json_import.py +0 -0
  85. {utterplan-0.6.16 → utterplan-0.6.17}/tests/migration/test_semantic_migration_regressions.py +0 -0
  86. {utterplan-0.6.16 → utterplan-0.6.17}/tests/schema_history/README.md +0 -0
  87. {utterplan-0.6.16 → utterplan-0.6.17}/tests/schema_history/v1/basic.json +0 -0
  88. {utterplan-0.6.16 → utterplan-0.6.17}/tests/schema_history/v1/directives.json +0 -0
  89. {utterplan-0.6.16 → utterplan-0.6.17}/tests/schema_history/v1/markers.json +0 -0
  90. {utterplan-0.6.16 → utterplan-0.6.17}/tests/schema_history/v1/multilingual.json +0 -0
  91. {utterplan-0.6.16 → utterplan-0.6.17}/tests/schema_history/v1/parenthetical.json +0 -0
  92. {utterplan-0.6.16 → utterplan-0.6.17}/tests/schema_history/v1/spokenform_offsets.json +0 -0
  93. {utterplan-0.6.16 → utterplan-0.6.17}/tests/schema_history/v1/ssmd_breaks.json +0 -0
  94. {utterplan-0.6.16 → utterplan-0.6.17}/tests/schema_history/v2/directives.json +0 -0
  95. {utterplan-0.6.16 → utterplan-0.6.17}/tests/schema_history/v3/multilingual.json +0 -0
  96. {utterplan-0.6.16 → utterplan-0.6.17}/tests/schema_history/v3/ssmd_09_comprehensive.json +0 -0
  97. {utterplan-0.6.16 → utterplan-0.6.17}/tests/schema_history/v5/canonical_consumer_contract.toml +0 -0
  98. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_atomic_io.py +0 -0
  99. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_batch.py +0 -0
  100. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_boundaries.py +0 -0
  101. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_bundle_book_replan.py +0 -0
  102. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_bundle_book_services.py +0 -0
  103. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_bundle_document_compile.py +0 -0
  104. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_bundle_document_render.py +0 -0
  105. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_bundle_replan.py +0 -0
  106. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_bundle_role_inventory.py +0 -0
  107. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_bundle_services.py +0 -0
  108. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_cli.py +0 -0
  109. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_cli_batch.py +0 -0
  110. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_cli_bundle_compile_book.py +0 -0
  111. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_cli_bundle_document.py +0 -0
  112. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_cli_bundle_render_book.py +0 -0
  113. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_cli_bundle_render_document.py +0 -0
  114. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_cli_bundle_replan_book.py +0 -0
  115. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_compiler.py +0 -0
  116. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_consumer_contract.py +0 -0
  117. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_consumer_readiness.py +0 -0
  118. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_coordinates.py +0 -0
  119. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_dependency_architecture.py +0 -0
  120. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_directives.py +0 -0
  121. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_explain.py +0 -0
  122. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_fake_renderer.py +0 -0
  123. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_flow_compilation.py +0 -0
  124. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_format.py +0 -0
  125. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_golden.py +0 -0
  126. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_identity_units.py +0 -0
  127. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_import_boundaries.py +0 -0
  128. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_language.py +0 -0
  129. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_linguistics.py +0 -0
  130. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_migration_framework.py +0 -0
  131. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_migration_v3_to_v4.py +0 -0
  132. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_migration_v4_to_v5.py +0 -0
  133. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_pauses.py +0 -0
  134. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_planner.py +0 -0
  135. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_preparation.py +0 -0
  136. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_prepared_semantics.py +0 -0
  137. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_preview.py +0 -0
  138. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_progress.py +0 -0
  139. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_public_identity.py +0 -0
  140. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_renderability.py +0 -0
  141. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_renderability_repair.py +0 -0
  142. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_renderplan_batch.py +0 -0
  143. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_renderplan_dependency_contract.py +0 -0
  144. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_renderplan_export.py +0 -0
  145. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_renderplan_pause_timing.py +0 -0
  146. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_replacement_provenance.py +0 -0
  147. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_role_coverage.py +0 -0
  148. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_schema_history.py +0 -0
  149. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_schema_registry.py +0 -0
  150. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_schema_strict.py +0 -0
  151. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_schema_v6_source.py +0 -0
  152. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_schema_v7.py +0 -0
  153. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_segment_topology.py +0 -0
  154. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_segmentation_adapter.py +0 -0
  155. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_segmentation_recovery.py +0 -0
  156. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_semantic_boundaries.py +0 -0
  157. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_sentence_topology.py +0 -0
  158. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_source_input.py +0 -0
  159. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_ssmd_09_parser.py +0 -0
  160. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_ssmd_bundle.py +0 -0
  161. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_ssmd_bundle_book.py +0 -0
  162. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_ssmd_bundle_document.py +0 -0
  163. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_ssmd_substitution_preparation.py +0 -0
  164. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_token_topology.py +0 -0
  165. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_toml_format.py +0 -0
  166. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_ttsready_preparation_adapter.py +0 -0
  167. {utterplan-0.6.16 → utterplan-0.6.17}/tests/test_version.py +0 -0
  168. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/__init__.py +0 -0
  169. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/__main__.py +0 -0
  170. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/_book_replan.py +0 -0
  171. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/_book_service.py +0 -0
  172. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/_document_service.py +0 -0
  173. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/atomic_io.py +0 -0
  174. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/attempt_serialization.py +0 -0
  175. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/attempts.py +0 -0
  176. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/batch.py +0 -0
  177. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/boundaries.py +0 -0
  178. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/bundle.py +0 -0
  179. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/bundle_replan.py +0 -0
  180. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/bundle_role_inventory.py +0 -0
  181. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/cli.py +0 -0
  182. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/codecs/__init__.py +0 -0
  183. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/codecs/v4_toml.py +0 -0
  184. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/codecs/v5_toml.py +0 -0
  185. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/codecs/v6_toml.py +0 -0
  186. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/codecs/v7_toml.py +0 -0
  187. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/compiler.py +0 -0
  188. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/config.py +0 -0
  189. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/diagnostics.py +0 -0
  190. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/directives.py +0 -0
  191. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/exceptions.py +0 -0
  192. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/explain.py +0 -0
  193. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/flow_projection.py +0 -0
  194. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/format.py +0 -0
  195. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/hashing.py +0 -0
  196. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/language.py +0 -0
  197. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/linguistics.py +0 -0
  198. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/migration.py +0 -0
  199. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/migrations/__init__.py +0 -0
  200. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/migrations/registry.py +0 -0
  201. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/migrations/v1_to_v2.py +0 -0
  202. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/migrations/v2_to_v3.py +0 -0
  203. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/migrations/v3_to_v4.py +0 -0
  204. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/migrations/v4_to_v5.py +0 -0
  205. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/migrations/v5_to_v6.py +0 -0
  206. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/migrations/v6_to_v7.py +0 -0
  207. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/model.py +0 -0
  208. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/parsers.py +0 -0
  209. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/pauses.py +0 -0
  210. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/planner.py +0 -0
  211. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/preparation.py +0 -0
  212. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/prepared_semantics.py +0 -0
  213. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/preview.py +0 -0
  214. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/progress.py +0 -0
  215. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/py.typed +0 -0
  216. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/renderability.py +0 -0
  217. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/renderplan_batch.py +0 -0
  218. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/renderplan_export.py +0 -0
  219. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/renderplan_pause_timing.py +0 -0
  220. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/renderplan_projection.py +0 -0
  221. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/renderplan_replan.py +0 -0
  222. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/renderplan_workspace.py +0 -0
  223. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/renderprofile_io.py +0 -0
  224. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/role_coverage.py +0 -0
  225. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/schema_registry.py +0 -0
  226. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/schemas/v1.schema.json +0 -0
  227. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/schemas/v2.schema.json +0 -0
  228. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/schemas/v3.schema.json +0 -0
  229. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/schemas/v4.schema.json +0 -0
  230. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/segmentation.py +0 -0
  231. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/serialization.py +0 -0
  232. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/source_input.py +0 -0
  233. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/spacy_models.py +0 -0
  234. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/spans.py +0 -0
  235. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/ssmd_bundle.py +0 -0
  236. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/stages/__init__.py +0 -0
  237. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/stages/document/__init__.py +0 -0
  238. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/stages/document/plain.py +0 -0
  239. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/stages/document/ssmd.py +0 -0
  240. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/stages/preparation/__init__.py +0 -0
  241. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/stages/preparation/identity.py +0 -0
  242. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/stages/preparation/ssmd.py +0 -0
  243. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/stages/preparation/ttsready.py +0 -0
  244. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/stages/protocols.py +0 -0
  245. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/token_topology.py +0 -0
  246. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/toml_codec.py +0 -0
  247. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/trace_codec.py +0 -0
  248. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/units.py +0 -0
  249. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/utterplan.schema.json +0 -0
  250. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/versioning.py +0 -0
  251. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan/workspace_paths.py +0 -0
  252. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan.egg-info/SOURCES.txt +0 -0
  253. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan.egg-info/dependency_links.txt +0 -0
  254. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan.egg-info/entry_points.txt +0 -0
  255. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan.egg-info/requires.txt +0 -0
  256. {utterplan-0.6.16 → utterplan-0.6.17}/utterplan.egg-info/top_level.txt +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: utterplan
3
- Version: 0.6.16
3
+ Version: 0.6.17
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
@@ -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 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.
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` key enables UtterPlan's selective parenthetical-entry policy: an oriented OPEN may split when both the accumulated host group and opening aside have at least four lexical tokens; CLOSE edges normally join resumed host syntax. Short asides remain joined. The projection uses stored token facts and a local bracket fallback, never a global punctuation reparse. `0ms` enables an eligible entry split without audible silence; an omitted key or `mode = "none"` disables the policy. Authored timed/named breaks remain authoritative at either edge, and authored `none` suppresses a pure automatic entry split. No schema change or FlowPlan mutation is required.
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,6 +4,14 @@
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ ## [0.6.17] - Unreleased
8
+
9
+ ### Fixed
10
+
11
+ - Kept resumed host syntax in the same speech request across inline parenthetical asides
12
+
13
+ <!-- generated by releaseledger -->
14
+
7
15
  ## [v0.6.16] - 2026-10-31
8
16
 
9
17
  ### Fixed
@@ -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. 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.
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 may selectively split before a substantial oriented parenthetical OPEN when its manual profile explicitly includes `pauses.parenthetical`; closing edges normally remain joined to resumed host syntax. This projection 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,7 +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
+ RenderPlan's parenthetical policy is an UtterPlan projection decision, independent of FlowPlan compilation. A manual RenderProfile must explicitly include `pauses.parenthetical` to enable selective entry splitting. Only a substantial oriented OPEN edge is eligible (at least four lexical tokens in both the accumulated host request and opening aside); CLOSE edges normally join resumed host syntax, and short inline asides remain joined. Orientation comes from persisted token facts with a local bracket-surface fallback, not a global punctuation scan. `0ms` still enables an eligible request split without audible silence; omitting the key or using `mode = "none"` disables the policy. Authored timed/named breaks retain precedence at either edge, while authored `none` suppresses a pure automatic entry split. This projection does not alter FlowPlan or rewrite the original parentheses. Newly created VoiceRender profiles may seed `180ms`; existing profiles are not mutated.
43
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.
44
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.
45
45
 
@@ -42,7 +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
+ In optional RenderPlan projection, only a manual RenderProfile with an explicit `pauses.parenthetical` key enables UtterPlan's selective parenthetical-entry policy. An entry may split when the accumulated host group and opening aside each contain at least four lexical tokens; closing edges normally remain joined to resumed host syntax. UtterPlan classifies local persisted token facts (with a local bracket-surface fallback) and does not reparse punctuation globally. Short inline asides stay joined. The key's presence enables an eligible entry split even at `0ms`; omitting it or setting `mode = "none"` disables the automatic policy. Authored timed or named breaks still split at either edge, and authored `none` suppresses a pure automatic entry split. Text, source spans, and segment-local facts are unchanged; FlowPlan remains renderer-independent.
46
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.
47
47
 
48
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.
@@ -1,5 +1,6 @@
1
1
  from __future__ import annotations
2
2
 
3
+ import re
3
4
  from dataclasses import replace
4
5
 
5
6
  import pytest
@@ -184,11 +185,14 @@ def test_replan_replaces_only_failed_occurrence_and_preserves_later_id() -> None
184
185
 
185
186
 
186
187
  def test_replan_preserves_parenthetical_semantic_end_on_last_clause_child() -> None:
188
+ head = "The preceding host has enough words "
189
+ tail = "before the aside begins "
190
+ aside = "(this aside includes enough words)"
187
191
  plan = _plan(
188
- FlowSegment("A ", "en-US", boundary_after=("clause",)),
189
- FlowSegment("B ", "en-US", boundary_after=("parenthetical",)),
192
+ FlowSegment(head, "en-US", boundary_after=("clause",)),
193
+ FlowSegment(tail, "en-US", boundary_after=("parenthetical",)),
190
194
  FlowSegment(
191
- "(x)",
195
+ aside,
192
196
  "en-US",
193
197
  boundary_before=("parenthetical",),
194
198
  boundary_after=("sentence",),
@@ -204,13 +208,13 @@ def test_replan_preserves_parenthetical_semantic_end_on_last_clause_child() -> N
204
208
  )
205
209
  index, profile, previous = _build_previous(plan, profile)
206
210
  failed = previous.speech[0]
207
- assert failed.text == "A B "
211
+ assert failed.text == head + tail
208
212
  assert failed.semantic_end == "parenthetical"
209
213
 
210
214
  flow = replan_flow(index, profile, previous, _preflight(previous, profile, (failed,)))
211
215
  speech = _speech_text(flow)
212
216
 
213
- assert [item.text for item in speech] == ["A ", "B ", "(x)"]
217
+ assert [item.text for item in speech] == [head, tail, aside]
214
218
  assert [item.semantic_end for item in speech] == ["clause", "parenthetical", "sentence"]
215
219
  assert [item.reason for item in flow if isinstance(item, PauseItem)] == [
216
220
  "capacity",
@@ -436,3 +440,62 @@ def test_stale_preflight_wrong_previous_and_stale_source_are_rejected() -> None:
436
440
  with pytest.raises(RenderPlanProjectionError) as stale_source:
437
441
  replan_flow(index, profile, stale_previous, stale_request)
438
442
  assert stale_source.value.code == "renderplan.replan.source_stale"
443
+
444
+
445
+ def _space_tokens(text: str) -> tuple[TokenView, ...]:
446
+ return tuple(TokenView(match.start(), match.end()) for match in re.finditer(r"\S+", text))
447
+
448
+
449
+ def test_failed_parenthetical_request_replans_without_closing_parenthetical_pause() -> None:
450
+ host = "The host group already contains enough words "
451
+ aside = "(this aside contains enough lexical words)"
452
+ continuation = " and this continuation has many words for a safe token split."
453
+ plan = _plan(
454
+ FlowSegment(
455
+ host,
456
+ "en-US",
457
+ tokens=_space_tokens(host),
458
+ boundary_after=("parenthetical",),
459
+ ),
460
+ FlowSegment(
461
+ aside,
462
+ "en-US",
463
+ tokens=_space_tokens(aside),
464
+ boundary_before=("parenthetical",),
465
+ boundary_after=("parenthetical",),
466
+ ),
467
+ FlowSegment(
468
+ continuation,
469
+ "en-US",
470
+ tokens=_space_tokens(continuation),
471
+ boundary_before=("parenthetical",),
472
+ boundary_after=("sentence",),
473
+ ),
474
+ )
475
+ profile = replace(
476
+ _profile(fallback=("token",)),
477
+ pauses=PausePolicy(
478
+ mode="manual",
479
+ durations_ms={"clause": 180, "parenthetical": 180, "sentence": 500},
480
+ ),
481
+ profile_id=None,
482
+ )
483
+ index, profile, previous = _build_previous(plan, profile)
484
+ assert [item.text for item in previous.speech] == [host, aside + continuation]
485
+ failed = previous.speech[1]
486
+
487
+ flow = replan_flow(index, profile, previous, _preflight(previous, profile, (failed,)))
488
+ rebuilt = RenderPlan(
489
+ source_plan_id=previous.source_plan_id,
490
+ render_profile_id=previous.render_profile_id,
491
+ flow=flow,
492
+ ).with_identity()
493
+ rebuilt.validate_against_profile(profile)
494
+
495
+ assert len(_speech_text(flow)) > len(previous.speech)
496
+ assert [item.reason for item in flow if isinstance(item, PauseItem)] == [
497
+ "parenthetical",
498
+ "capacity",
499
+ "sentence",
500
+ ]
501
+ assert sum(item.reason == "parenthetical" for item in flow if isinstance(item, PauseItem)) == 1