utterplan 0.6.17__tar.gz → 0.6.18__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 (257) hide show
  1. {utterplan-0.6.17 → utterplan-0.6.18}/PKG-INFO +1 -1
  2. {utterplan-0.6.17 → utterplan-0.6.18}/docs/changelog.md +10 -2
  3. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_bundle_book_services.py +4 -0
  4. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_bundle_services.py +146 -2
  5. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/__init__.py +16 -0
  6. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/_version.py +3 -3
  7. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/batch.py +15 -3
  8. utterplan-0.6.18/utterplan/bundle_inspection.py +687 -0
  9. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/config.py +14 -0
  10. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan.egg-info/PKG-INFO +1 -1
  11. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan.egg-info/SOURCES.txt +1 -0
  12. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan.egg-info/scm_file_list.json +12 -0
  13. utterplan-0.6.18/utterplan.egg-info/scm_version.json +8 -0
  14. utterplan-0.6.17/utterplan.egg-info/scm_version.json +0 -8
  15. {utterplan-0.6.17 → utterplan-0.6.18}/.codecrate.toml +0 -0
  16. {utterplan-0.6.17 → utterplan-0.6.18}/.github/workflows/codecov.yml +0 -0
  17. {utterplan-0.6.17 → utterplan-0.6.18}/.github/workflows/pre-commit.yml +0 -0
  18. {utterplan-0.6.17 → utterplan-0.6.18}/.github/workflows/python-publish.yml +0 -0
  19. {utterplan-0.6.17 → utterplan-0.6.18}/.github/workflows/tests.yml +0 -0
  20. {utterplan-0.6.17 → utterplan-0.6.18}/.gitignore +0 -0
  21. {utterplan-0.6.17 → utterplan-0.6.18}/.pre-commit-config.yaml +0 -0
  22. {utterplan-0.6.17 → utterplan-0.6.18}/AGENTS.md +0 -0
  23. {utterplan-0.6.17 → utterplan-0.6.18}/LICENSE +0 -0
  24. {utterplan-0.6.17 → utterplan-0.6.18}/MANIFEST.in +0 -0
  25. {utterplan-0.6.17 → utterplan-0.6.18}/NOTICE +0 -0
  26. {utterplan-0.6.17 → utterplan-0.6.18}/README.md +0 -0
  27. {utterplan-0.6.17 → utterplan-0.6.18}/docs/Makefile +0 -0
  28. {utterplan-0.6.17 → utterplan-0.6.18}/docs/architecture.md +0 -0
  29. {utterplan-0.6.17 → utterplan-0.6.18}/docs/bundles.md +0 -0
  30. {utterplan-0.6.17 → utterplan-0.6.18}/docs/cli.md +0 -0
  31. {utterplan-0.6.17 → utterplan-0.6.18}/docs/conf.py +0 -0
  32. {utterplan-0.6.17 → utterplan-0.6.18}/docs/consumer-guide.md +0 -0
  33. {utterplan-0.6.17 → utterplan-0.6.18}/docs/coordinate-spaces.md +0 -0
  34. {utterplan-0.6.17 → utterplan-0.6.18}/docs/debugging.md +0 -0
  35. {utterplan-0.6.17 → utterplan-0.6.18}/docs/format.md +0 -0
  36. {utterplan-0.6.17 → utterplan-0.6.18}/docs/getting-started.md +0 -0
  37. {utterplan-0.6.17 → utterplan-0.6.18}/docs/index.md +0 -0
  38. {utterplan-0.6.17 → utterplan-0.6.18}/docs/make.bat +0 -0
  39. {utterplan-0.6.17 → utterplan-0.6.18}/docs/pause-timing-architecture.md +0 -0
  40. {utterplan-0.6.17 → utterplan-0.6.18}/docs/phase-a-completion.md +0 -0
  41. {utterplan-0.6.17 → utterplan-0.6.18}/docs/pykokoro-integration.md +0 -0
  42. {utterplan-0.6.17 → utterplan-0.6.18}/docs/python-api.md +0 -0
  43. {utterplan-0.6.17 → utterplan-0.6.18}/docs/requirements.txt +0 -0
  44. {utterplan-0.6.17 → utterplan-0.6.18}/examples/basic.py +0 -0
  45. {utterplan-0.6.17 → utterplan-0.6.18}/examples/chapter.ssmd +0 -0
  46. {utterplan-0.6.17 → utterplan-0.6.18}/examples/compile_file.py +0 -0
  47. {utterplan-0.6.17 → utterplan-0.6.18}/examples/inspect_plan.py +0 -0
  48. {utterplan-0.6.17 → utterplan-0.6.18}/examples/multilingual.py +0 -0
  49. {utterplan-0.6.17 → utterplan-0.6.18}/examples/ssmd_example.py +0 -0
  50. {utterplan-0.6.17 → utterplan-0.6.18}/pyproject.toml +0 -0
  51. {utterplan-0.6.17 → utterplan-0.6.18}/setup.cfg +0 -0
  52. {utterplan-0.6.17 → utterplan-0.6.18}/spec/schemas/v1.schema.json +0 -0
  53. {utterplan-0.6.17 → utterplan-0.6.18}/spec/schemas/v2.schema.json +0 -0
  54. {utterplan-0.6.17 → utterplan-0.6.18}/spec/schemas/v3.schema.json +0 -0
  55. {utterplan-0.6.17 → utterplan-0.6.18}/spec/schemas/v4.schema.json +0 -0
  56. {utterplan-0.6.17 → utterplan-0.6.18}/spec/utterplan.schema.json +0 -0
  57. {utterplan-0.6.17 → utterplan-0.6.18}/tests/__init__.py +0 -0
  58. {utterplan-0.6.17 → utterplan-0.6.18}/tests/compiler_helpers.py +0 -0
  59. {utterplan-0.6.17 → utterplan-0.6.18}/tests/fixtures/canonical_consumer_contract.expected.toml +0 -0
  60. {utterplan-0.6.17 → utterplan-0.6.18}/tests/fixtures/canonical_consumer_contract.ssmd +0 -0
  61. {utterplan-0.6.17 → utterplan-0.6.18}/tests/fixtures/document-bundle-v1/story.ssmd-bundle/document.ssmd.md +0 -0
  62. {utterplan-0.6.17 → utterplan-0.6.18}/tests/fixtures/document-bundle-v1/story.ssmd-bundle/manifest.json +0 -0
  63. {utterplan-0.6.17 → utterplan-0.6.18}/tests/fixtures/ssmd_09_comprehensive.ssmd +0 -0
  64. {utterplan-0.6.17 → utterplan-0.6.18}/tests/golden/basic_en.utterplan.toml +0 -0
  65. {utterplan-0.6.17 → utterplan-0.6.18}/tests/golden/directives.utterplan.toml +0 -0
  66. {utterplan-0.6.17 → utterplan-0.6.18}/tests/golden/markers.utterplan.toml +0 -0
  67. {utterplan-0.6.17 → utterplan-0.6.18}/tests/golden/multilingual.utterplan.toml +0 -0
  68. {utterplan-0.6.17 → utterplan-0.6.18}/tests/golden/parenthetical.utterplan.toml +0 -0
  69. {utterplan-0.6.17 → utterplan-0.6.18}/tests/golden/spokenform_offsets.utterplan.toml +0 -0
  70. {utterplan-0.6.17 → utterplan-0.6.18}/tests/golden/ssmd_09_comprehensive.utterplan.toml +0 -0
  71. {utterplan-0.6.17 → utterplan-0.6.18}/tests/golden/ssmd_breaks.utterplan.toml +0 -0
  72. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/__init__.py +0 -0
  73. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/cases.py +0 -0
  74. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/fixtures/v4/basic_en.utterplan.json +0 -0
  75. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/fixtures/v4/directives.utterplan.json +0 -0
  76. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/fixtures/v4/markers.utterplan.json +0 -0
  77. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/fixtures/v4/multilingual.utterplan.json +0 -0
  78. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/fixtures/v4/parenthetical.utterplan.json +0 -0
  79. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/fixtures/v4/spokenform_offsets.utterplan.json +0 -0
  80. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/fixtures/v4/ssmd_09_comprehensive.utterplan.json +0 -0
  81. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/fixtures/v4/ssmd_breaks.utterplan.json +0 -0
  82. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/goldens/multilingual_preparation.json +0 -0
  83. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/goldens/spokenform_numbers.json +0 -0
  84. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/goldens/ssmd_break.json +0 -0
  85. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/goldens/ssmd_language_detection.json +0 -0
  86. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/goldens/ssmd_marker.json +0 -0
  87. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/goldens/ssmd_pronunciation.json +0 -0
  88. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/test_legacy_json_import.py +0 -0
  89. {utterplan-0.6.17 → utterplan-0.6.18}/tests/migration/test_semantic_migration_regressions.py +0 -0
  90. {utterplan-0.6.17 → utterplan-0.6.18}/tests/schema_history/README.md +0 -0
  91. {utterplan-0.6.17 → utterplan-0.6.18}/tests/schema_history/v1/basic.json +0 -0
  92. {utterplan-0.6.17 → utterplan-0.6.18}/tests/schema_history/v1/directives.json +0 -0
  93. {utterplan-0.6.17 → utterplan-0.6.18}/tests/schema_history/v1/markers.json +0 -0
  94. {utterplan-0.6.17 → utterplan-0.6.18}/tests/schema_history/v1/multilingual.json +0 -0
  95. {utterplan-0.6.17 → utterplan-0.6.18}/tests/schema_history/v1/parenthetical.json +0 -0
  96. {utterplan-0.6.17 → utterplan-0.6.18}/tests/schema_history/v1/spokenform_offsets.json +0 -0
  97. {utterplan-0.6.17 → utterplan-0.6.18}/tests/schema_history/v1/ssmd_breaks.json +0 -0
  98. {utterplan-0.6.17 → utterplan-0.6.18}/tests/schema_history/v2/directives.json +0 -0
  99. {utterplan-0.6.17 → utterplan-0.6.18}/tests/schema_history/v3/multilingual.json +0 -0
  100. {utterplan-0.6.17 → utterplan-0.6.18}/tests/schema_history/v3/ssmd_09_comprehensive.json +0 -0
  101. {utterplan-0.6.17 → utterplan-0.6.18}/tests/schema_history/v5/canonical_consumer_contract.toml +0 -0
  102. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_atomic_io.py +0 -0
  103. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_batch.py +0 -0
  104. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_boundaries.py +0 -0
  105. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_bundle_book_replan.py +0 -0
  106. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_bundle_document_compile.py +0 -0
  107. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_bundle_document_render.py +0 -0
  108. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_bundle_replan.py +0 -0
  109. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_bundle_role_inventory.py +0 -0
  110. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_cli.py +0 -0
  111. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_cli_batch.py +0 -0
  112. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_cli_bundle_compile_book.py +0 -0
  113. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_cli_bundle_document.py +0 -0
  114. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_cli_bundle_render_book.py +0 -0
  115. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_cli_bundle_render_document.py +0 -0
  116. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_cli_bundle_replan_book.py +0 -0
  117. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_compiler.py +0 -0
  118. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_consumer_contract.py +0 -0
  119. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_consumer_readiness.py +0 -0
  120. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_coordinates.py +0 -0
  121. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_dependency_architecture.py +0 -0
  122. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_directives.py +0 -0
  123. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_explain.py +0 -0
  124. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_fake_renderer.py +0 -0
  125. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_flow_compilation.py +0 -0
  126. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_format.py +0 -0
  127. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_golden.py +0 -0
  128. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_identity_units.py +0 -0
  129. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_import_boundaries.py +0 -0
  130. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_language.py +0 -0
  131. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_linguistics.py +0 -0
  132. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_migration_framework.py +0 -0
  133. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_migration_v3_to_v4.py +0 -0
  134. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_migration_v4_to_v5.py +0 -0
  135. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_pauses.py +0 -0
  136. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_planner.py +0 -0
  137. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_preparation.py +0 -0
  138. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_prepared_semantics.py +0 -0
  139. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_preview.py +0 -0
  140. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_progress.py +0 -0
  141. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_public_identity.py +0 -0
  142. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_renderability.py +0 -0
  143. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_renderability_repair.py +0 -0
  144. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_renderplan_batch.py +0 -0
  145. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_renderplan_dependency_contract.py +0 -0
  146. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_renderplan_export.py +0 -0
  147. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_renderplan_pause_timing.py +0 -0
  148. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_renderplan_replan.py +0 -0
  149. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_renderplan_v7_contract.py +0 -0
  150. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_replacement_provenance.py +0 -0
  151. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_role_coverage.py +0 -0
  152. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_schema_history.py +0 -0
  153. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_schema_registry.py +0 -0
  154. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_schema_strict.py +0 -0
  155. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_schema_v6_source.py +0 -0
  156. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_schema_v7.py +0 -0
  157. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_segment_topology.py +0 -0
  158. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_segmentation_adapter.py +0 -0
  159. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_segmentation_recovery.py +0 -0
  160. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_semantic_boundaries.py +0 -0
  161. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_sentence_topology.py +0 -0
  162. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_source_input.py +0 -0
  163. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_ssmd_09_parser.py +0 -0
  164. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_ssmd_bundle.py +0 -0
  165. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_ssmd_bundle_book.py +0 -0
  166. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_ssmd_bundle_document.py +0 -0
  167. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_ssmd_substitution_preparation.py +0 -0
  168. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_token_topology.py +0 -0
  169. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_toml_format.py +0 -0
  170. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_ttsready_preparation_adapter.py +0 -0
  171. {utterplan-0.6.17 → utterplan-0.6.18}/tests/test_version.py +0 -0
  172. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/__main__.py +0 -0
  173. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/_book_replan.py +0 -0
  174. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/_book_service.py +0 -0
  175. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/_document_service.py +0 -0
  176. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/atomic_io.py +0 -0
  177. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/attempt_serialization.py +0 -0
  178. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/attempts.py +0 -0
  179. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/boundaries.py +0 -0
  180. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/bundle.py +0 -0
  181. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/bundle_replan.py +0 -0
  182. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/bundle_role_inventory.py +0 -0
  183. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/cli.py +0 -0
  184. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/codecs/__init__.py +0 -0
  185. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/codecs/v4_toml.py +0 -0
  186. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/codecs/v5_toml.py +0 -0
  187. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/codecs/v6_toml.py +0 -0
  188. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/codecs/v7_toml.py +0 -0
  189. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/compiler.py +0 -0
  190. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/diagnostics.py +0 -0
  191. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/directives.py +0 -0
  192. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/exceptions.py +0 -0
  193. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/explain.py +0 -0
  194. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/flow_projection.py +0 -0
  195. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/format.py +0 -0
  196. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/hashing.py +0 -0
  197. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/language.py +0 -0
  198. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/linguistics.py +0 -0
  199. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/migration.py +0 -0
  200. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/migrations/__init__.py +0 -0
  201. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/migrations/registry.py +0 -0
  202. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/migrations/v1_to_v2.py +0 -0
  203. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/migrations/v2_to_v3.py +0 -0
  204. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/migrations/v3_to_v4.py +0 -0
  205. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/migrations/v4_to_v5.py +0 -0
  206. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/migrations/v5_to_v6.py +0 -0
  207. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/migrations/v6_to_v7.py +0 -0
  208. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/model.py +0 -0
  209. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/parsers.py +0 -0
  210. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/pauses.py +0 -0
  211. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/planner.py +0 -0
  212. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/preparation.py +0 -0
  213. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/prepared_semantics.py +0 -0
  214. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/preview.py +0 -0
  215. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/progress.py +0 -0
  216. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/py.typed +0 -0
  217. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/renderability.py +0 -0
  218. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/renderplan_batch.py +0 -0
  219. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/renderplan_export.py +0 -0
  220. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/renderplan_grouping.py +0 -0
  221. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/renderplan_pause_timing.py +0 -0
  222. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/renderplan_projection.py +0 -0
  223. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/renderplan_replan.py +0 -0
  224. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/renderplan_workspace.py +0 -0
  225. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/renderprofile_io.py +0 -0
  226. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/role_coverage.py +0 -0
  227. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/schema_registry.py +0 -0
  228. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/schemas/v1.schema.json +0 -0
  229. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/schemas/v2.schema.json +0 -0
  230. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/schemas/v3.schema.json +0 -0
  231. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/schemas/v4.schema.json +0 -0
  232. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/segmentation.py +0 -0
  233. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/serialization.py +0 -0
  234. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/source_input.py +0 -0
  235. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/spacy_models.py +0 -0
  236. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/spans.py +0 -0
  237. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/ssmd_bundle.py +0 -0
  238. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/stages/__init__.py +0 -0
  239. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/stages/document/__init__.py +0 -0
  240. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/stages/document/plain.py +0 -0
  241. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/stages/document/ssmd.py +0 -0
  242. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/stages/preparation/__init__.py +0 -0
  243. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/stages/preparation/identity.py +0 -0
  244. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/stages/preparation/ssmd.py +0 -0
  245. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/stages/preparation/ttsready.py +0 -0
  246. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/stages/protocols.py +0 -0
  247. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/token_topology.py +0 -0
  248. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/toml_codec.py +0 -0
  249. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/trace_codec.py +0 -0
  250. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/units.py +0 -0
  251. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/utterplan.schema.json +0 -0
  252. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/versioning.py +0 -0
  253. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan/workspace_paths.py +0 -0
  254. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan.egg-info/dependency_links.txt +0 -0
  255. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan.egg-info/entry_points.txt +0 -0
  256. {utterplan-0.6.17 → utterplan-0.6.18}/utterplan.egg-info/requires.txt +0 -0
  257. {utterplan-0.6.17 → utterplan-0.6.18}/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.17
3
+ Version: 0.6.18
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
@@ -4,11 +4,19 @@
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
- ## [0.6.17] - Unreleased
7
+ ## [0.6.18] - 2026-11-05
8
+
9
+ ### Added
10
+
11
+ - Added read-only bundle freshness inspection with incremental selectors and profile/config drift diagnostics
12
+
13
+ <!-- generated by releaseledger -->
14
+
15
+ ## [0.6.17] - 2026-11-04
8
16
 
9
17
  ### Fixed
10
18
 
11
- - Kept resumed host syntax in the same speech request across inline parenthetical asides
19
+ - Fixed resumed host syntax in the same speech request across inline parenthetical asides
12
20
 
13
21
  <!-- generated by releaseledger -->
14
22
 
@@ -75,6 +75,10 @@ def test_package_root_exports_unified_bundle_services_not_split_services() -> No
75
75
  assert callable(utterplan.compile_bundle)
76
76
  assert callable(utterplan.render_bundle)
77
77
  assert callable(utterplan.replan_bundle)
78
+ assert callable(utterplan.inspect_bundle_compile)
79
+ assert callable(utterplan.inspect_bundle_projection)
80
+ assert hasattr(utterplan, "BundleCompileInspection")
81
+ assert hasattr(utterplan, "BundleProjectionInspection")
78
82
  for name in ("compile_book", "render_book", "replan_book"):
79
83
  assert not hasattr(utterplan, name)
80
84
 
@@ -2,6 +2,7 @@ from __future__ import annotations
2
2
 
3
3
  import json
4
4
  import shutil
5
+ from dataclasses import replace
5
6
  from pathlib import Path
6
7
 
7
8
  import pytest
@@ -10,6 +11,7 @@ from renderplan import codec as renderplan_codec
10
11
 
11
12
  from utterplan._book_service import BookServiceError, compile_book, render_book
12
13
  from utterplan.bundle import BundleServiceError, compile_bundle, render_bundle
14
+ from utterplan.bundle_inspection import inspect_bundle_compile, inspect_bundle_projection
13
15
  from utterplan.bundle_role_inventory import load_bundle_role_inventory, sha256_file
14
16
  from utterplan.config import LinguisticsConfig, PlannerConfig
15
17
  from utterplan.model import FlowPlan
@@ -67,9 +69,11 @@ def _planner_config() -> PlannerConfig:
67
69
  )
68
70
 
69
71
 
70
- def _profile(path: Path) -> RenderProfile:
72
+ def _profile(path: Path, *, voice: str = "test") -> RenderProfile:
71
73
  profile = RenderProfile(
72
- roles={"narrator": RoleProfile(language="en-US", binding={"engine": "test"})},
74
+ roles={
75
+ "narrator": RoleProfile(language="en-US", binding={"engine": "test", "voice": voice})
76
+ },
73
77
  default_role="narrator",
74
78
  planning=PlanningPolicy(split="sentence", capacity_fallback=("token",)),
75
79
  pauses=PausePolicy(mode="manual", durations_ms={"sentence": 250}),
@@ -243,3 +247,143 @@ def test_render_bundle_dispatches_book_and_document_with_uniform_outputs(
243
247
  assert starts[0].kind == kind
244
248
  assert starts[0].output_paths == result.outputs
245
249
  assert starts[0].report_path == result.report_path
250
+
251
+
252
+ def _tree_snapshot(root: Path) -> dict[str, bytes | None]:
253
+ return {
254
+ path.relative_to(root).as_posix(): None if path.is_dir() else path.read_bytes()
255
+ for path in sorted(root.rglob("*"))
256
+ }
257
+
258
+
259
+ def test_compile_inspector_tracks_source_and_planner_config_without_writes(tmp_path: Path) -> None:
260
+ root = _book(tmp_path / "inspect.ssmd-bundle")
261
+ config = _planner_config()
262
+ before = _tree_snapshot(root)
263
+ fresh = inspect_bundle_compile(root, planner_config=config)
264
+ assert fresh.state == "not_started"
265
+ assert fresh.recommended_selector == "5-6"
266
+ assert _tree_snapshot(root) == before
267
+
268
+ compile_bundle(root, chapters="5", planner_config=config)
269
+ partial = inspect_bundle_compile(root, planner_config=config)
270
+ assert [item.state for item in partial.items] == ["complete", "not_started"]
271
+ assert partial.recommended_selector == "6"
272
+ assert not partial.force_required
273
+ assert partial.replacement_safe
274
+
275
+ source = root / "chapters/chapter-0005.ssmd.md"
276
+ source.write_text(
277
+ '---\nssmd_version: "0.9"\nlanguage: en-US\n---\nEdited chapter 5.\n',
278
+ encoding="utf-8",
279
+ )
280
+ stale = inspect_bundle_compile(root, planner_config=config)
281
+ assert [item.state for item in stale.items] == ["stale", "not_started"]
282
+ assert stale.recommended_selector == "5-6"
283
+ assert stale.force_required
284
+ assert stale.replacement_safe
285
+
286
+ compile_bundle(root, chapters="5", planner_config=config, force=True)
287
+ assert inspect_bundle_compile(root, chapters="5", planner_config=config).state == "complete"
288
+ changed_config = replace(config, overlap_mode="strict")
289
+ config_stale = inspect_bundle_compile(root, planner_config=changed_config)
290
+ assert config_stale.items[0].state == "stale"
291
+ assert config_stale.recommended_selector == "5-6"
292
+ assert config_stale.force_required
293
+ assert config_stale.replacement_safe
294
+ before = _tree_snapshot(root)
295
+ inspect_bundle_compile(root, planner_config=config)
296
+ assert _tree_snapshot(root) == before
297
+
298
+
299
+ def test_projection_inspector_supports_incremental_extension_and_safe_rebuild(
300
+ tmp_path: Path,
301
+ ) -> None:
302
+ root = _book(tmp_path / "projection.ssmd-bundle")
303
+ config = _planner_config()
304
+ compile_bundle(root, planner_config=config)
305
+ profile_path = root / "narration.renderprofile.toml"
306
+ profile = _profile(profile_path)
307
+ before = _tree_snapshot(root)
308
+
309
+ initial = inspect_bundle_projection(root, profile=profile_path)
310
+ assert initial.state == "not_started"
311
+ assert initial.profile_id == profile.computed_id()
312
+ assert initial.missing_chapters == ("chapter-0005", "chapter-0006")
313
+ assert initial.recommended_selector == "5-6"
314
+ assert not initial.force_required
315
+ assert initial.replacement_safe
316
+ assert _tree_snapshot(root) == before
317
+
318
+ render_bundle(root, profile=profile_path, chapters="5")
319
+ first = inspect_bundle_projection(root, profile=profile_path)
320
+ assert first.state == "partial"
321
+ assert first.chapters_in_set == ("chapter-0005",)
322
+ assert first.missing_chapters == ("chapter-0006",)
323
+ assert first.recommended_selector == "6"
324
+ assert not first.force_required
325
+ assert first.replacement_safe
326
+ first_projection_bytes = first.items[0].renderplan_path.read_bytes()
327
+
328
+ render_bundle(root, profile=profile_path, chapters="6")
329
+ complete = inspect_bundle_projection(root, profile=profile_path)
330
+ assert complete.state == "complete"
331
+ assert complete.items[0].renderplan_path.read_bytes() == first_projection_bytes
332
+ assert complete.recommended_selector is None
333
+ first_renderplan = complete.items[0].renderplan_path.read_bytes()
334
+ second_renderplan = complete.items[1].renderplan_path.read_bytes()
335
+
336
+ source = root / "chapters/chapter-0005.ssmd.md"
337
+ source.write_text(
338
+ '---\nssmd_version: "0.9"\nlanguage: en-US\n---\nEdited chapter 5.\n',
339
+ encoding="utf-8",
340
+ )
341
+ compile_bundle(root, chapters="5", planner_config=config, force=True)
342
+ stale = inspect_bundle_projection(root, profile=profile_path)
343
+ assert stale.stale_chapters == ("chapter-0005",)
344
+ assert stale.recommended_selector == "5"
345
+ assert stale.force_required
346
+ before = _tree_snapshot(root)
347
+ inspect_bundle_projection(root, profile=profile_path)
348
+ assert _tree_snapshot(root) == before
349
+
350
+ render_bundle(root, profile=profile_path, chapters="5", force=True)
351
+ rebuilt = inspect_bundle_projection(root, profile=profile_path)
352
+ assert rebuilt.state == "complete"
353
+ assert rebuilt.items[1].renderplan_path.read_bytes() == second_renderplan
354
+ assert rebuilt.items[0].renderplan_path.read_bytes() != first_renderplan
355
+
356
+ profile_b_path = root / "alternate.renderprofile.toml"
357
+ profile_b = _profile(profile_b_path, voice="sarah")
358
+ before_alternate_inspect = _tree_snapshot(root)
359
+ alternate = inspect_bundle_projection(root, profile=profile_b_path)
360
+ assert alternate.profile_id == profile_b.computed_id()
361
+ assert alternate.variant != complete.variant
362
+ assert alternate.state == "not_started"
363
+ assert _tree_snapshot(root) == before_alternate_inspect
364
+ shutil.copyfile(profile_b_path, complete.items[0].renderplan_path.parent / "renderprofile.toml")
365
+ mismatch = inspect_bundle_projection(root, profile=profile_path)
366
+ assert profile_b.computed_id() != profile.computed_id()
367
+ assert mismatch.profile_snapshot_mismatch
368
+ assert mismatch.state == "profile_mismatch"
369
+ assert mismatch.recommended_selector is None
370
+
371
+
372
+ def test_document_bundle_inspectors_report_single_item_convergence(tmp_path: Path) -> None:
373
+ root = _document(tmp_path / "story.ssmd-bundle")
374
+ config = _planner_config()
375
+ compile_bundle(root, planner_config=config)
376
+ compiled = inspect_bundle_compile(root, planner_config=config)
377
+ assert compiled.state == "complete"
378
+ assert compiled.recommended_selector is None
379
+
380
+ profile_path = root / "document.renderprofile.toml"
381
+ _profile(profile_path)
382
+ missing = inspect_bundle_projection(root, profile=profile_path)
383
+ assert missing.state == "not_started"
384
+ assert missing.recommended_selector == "all"
385
+ render_bundle(root, profile=profile_path)
386
+ projected = inspect_bundle_projection(root, profile=profile_path)
387
+ assert projected.state == "complete"
388
+ assert projected.recommended_selector is None
389
+ assert projected.items[0].render_plan_id is not None
@@ -13,6 +13,15 @@ from .bundle import (
13
13
  compile_bundle,
14
14
  render_bundle,
15
15
  )
16
+ from .bundle_inspection import (
17
+ BundleCompileInspection,
18
+ BundleCompileItemInspection,
19
+ BundleInspectionError,
20
+ BundleProjectionInspection,
21
+ BundleProjectionItemInspection,
22
+ inspect_bundle_compile,
23
+ inspect_bundle_projection,
24
+ )
16
25
  from .bundle_replan import (
17
26
  BundleReplanError,
18
27
  BundleReplanResult,
@@ -148,6 +157,8 @@ __all__ = [
148
157
  "BundleKind",
149
158
  "BundleCompileResult",
150
159
  "BundleCompileStart",
160
+ "BundleCompileInspection",
161
+ "BundleCompileItemInspection",
151
162
  "BundleCompileStartCallback",
152
163
  "BundleRole",
153
164
  "BundleRoleInventory",
@@ -161,13 +172,18 @@ __all__ = [
161
172
  "BundleReplanStart",
162
173
  "BundleReplanStartCallback",
163
174
  "BundleRenderResult",
175
+ "BundleProjectionInspection",
176
+ "BundleProjectionItemInspection",
164
177
  "BundleRenderStart",
165
178
  "BundleRenderStartCallback",
166
179
  "BundleServiceError",
180
+ "BundleInspectionError",
167
181
  "SsmdBundleError",
168
182
  "SsmdBundleIndex",
169
183
  "bundle_item_path",
170
184
  "compile_bundle",
185
+ "inspect_bundle_compile",
186
+ "inspect_bundle_projection",
171
187
  "load_ssmd_bundle",
172
188
  "replan_bundle",
173
189
  "render_bundle",
@@ -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.17'
22
- __version_tuple__ = version_tuple = (0, 6, 17)
21
+ __version__ = version = '0.6.18'
22
+ __version_tuple__ = version_tuple = (0, 6, 18)
23
23
 
24
- __commit_id__ = commit_id = 'gb68b48df5'
24
+ __commit_id__ = commit_id = 'g2a83b882a'
@@ -3,7 +3,7 @@
3
3
  from __future__ import annotations
4
4
 
5
5
  from collections.abc import Callable, Generator, Iterable, Sized
6
- from dataclasses import dataclass
6
+ from dataclasses import dataclass, replace
7
7
  from pathlib import Path
8
8
  from typing import Literal
9
9
 
@@ -11,7 +11,7 @@ import tomlkit
11
11
 
12
12
  from .atomic_io import atomic_write_text
13
13
  from .compiler import InputFormat, compile_document
14
- from .config import PlannerConfig
14
+ from .config import PlannerConfig, semantic_config_fingerprint
15
15
  from .exceptions import (
16
16
  PlanFormatError,
17
17
  PlanRenderabilityError,
@@ -194,7 +194,19 @@ def _compile_one(
194
194
  except UtterPlanError as error:
195
195
  return _compile_failure(request, index, total, error, stage="compile")
196
196
 
197
- plan = result.plan
197
+ effective_config = (
198
+ replace(config, language=request.fallback_language)
199
+ if request.fallback_language is not None
200
+ else config
201
+ )
202
+ effective_config = replace(effective_config, document_format=input_format)
203
+ plan = replace(
204
+ result.plan,
205
+ producer={
206
+ **result.plan.producer,
207
+ "planner_config_sha256": semantic_config_fingerprint(effective_config),
208
+ },
209
+ )
198
210
  try:
199
211
  plan.validate()
200
212
  except PlanValidationError as error: