openstatspec 0.7.1__tar.gz → 0.8.1__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 (211) hide show
  1. {openstatspec-0.7.1 → openstatspec-0.8.1}/.github/workflows/ci.yml +11 -4
  2. {openstatspec-0.7.1 → openstatspec-0.8.1}/.github/workflows/release.yml +3 -3
  3. {openstatspec-0.7.1 → openstatspec-0.8.1}/CHANGELOG.md +56 -2
  4. {openstatspec-0.7.1 → openstatspec-0.8.1}/PKG-INFO +24 -10
  5. {openstatspec-0.7.1 → openstatspec-0.8.1}/README.md +23 -9
  6. openstatspec-0.8.1/docs/release-readiness.md +233 -0
  7. {openstatspec-0.7.1 → openstatspec-0.8.1}/docs/sav-profile.md +1 -1
  8. {openstatspec-0.7.1 → openstatspec-0.8.1}/docs/transformations.md +135 -0
  9. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/.github/workflows/ci.yml +2 -0
  10. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/CHANGELOG.md +44 -6
  11. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/README.md +33 -5
  12. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/RELEASING.md +21 -0
  13. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/ROADMAP.md +42 -14
  14. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/VERSIONING.md +9 -0
  15. openstatspec-0.8.1/openstatspec-specification/conformance/spss-syntax-frontend-0.3.json +714 -0
  16. openstatspec-0.8.1/openstatspec-specification/docs/database-io-policy-v1.md +146 -0
  17. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/docs/implementation-profiles/python-pyspssio-0.5.1.md +5 -0
  18. openstatspec-0.8.1/openstatspec-specification/docs/spss-frontend-roadmap.md +158 -0
  19. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/docs/spss-sav-zsav-profile-1.0.md +5 -0
  20. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/docs/spss-syntax-frontend-profile-0.2.md +2 -1
  21. openstatspec-0.8.1/openstatspec-specification/docs/spss-syntax-frontend-profile-0.3.md +164 -0
  22. openstatspec-0.8.1/openstatspec-specification/docs/superpowers/plans/2026-08-12-roadmap-v030-bookkeeping.md +64 -0
  23. openstatspec-0.8.1/openstatspec-specification/docs/superpowers/plans/2026-08-21-spss-frontend-03.md +1361 -0
  24. openstatspec-0.8.1/openstatspec-specification/docs/superpowers/specs/2026-08-21-spss-frontend-expansion-design.md +193 -0
  25. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/docs/transformation-plan-profile-0.2.md +2 -1
  26. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/docs/transformation-plan-sql-binding-0.2.md +2 -1
  27. openstatspec-0.8.1/openstatspec-specification/examples/spss-syntax-transformation-0.3.md +41 -0
  28. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/pyproject.toml +2 -1
  29. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/sql/dialect-profiles.md +6 -0
  30. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/sql/dolt-adapter-declarations/README.md +7 -0
  31. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/sql/profile-capabilities.md +8 -0
  32. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/sql/server-version-policy.md +7 -0
  33. openstatspec-0.8.1/openstatspec-specification/src/openstatspec_specification/artifacts.py +923 -0
  34. openstatspec-0.8.1/openstatspec-specification/tests/test_contract_artifacts.py +272 -0
  35. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/tools/validate_repository.py +34 -1
  36. openstatspec-0.8.1/openstatspec-specification/transformation/spss-syntax-frontend-0.3.schema.json +57 -0
  37. {openstatspec-0.7.1 → openstatspec-0.8.1}/pyproject.toml +1 -1
  38. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/api.py +8 -2
  39. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/spss/sav.py +16 -298
  40. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/sql/capabilities.py +71 -27
  41. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/sql/catalog_api.py +3 -0
  42. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/sql/database_urls.py +17 -0
  43. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/sql/dolt_conformance.py +5 -2
  44. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/sql/inplace_transform.py +68 -13
  45. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/sql/wide.py +199 -449
  46. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/sql/workflow.py +88 -82
  47. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/transform/validation.py +32 -41
  48. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_atomic_import.py +117 -0
  49. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_catalog_lifecycle.py +0 -56
  50. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_catalog_persistence_review.py +0 -90
  51. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_cli.py +6 -3
  52. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_dolt_conformance.py +51 -62
  53. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_inplace_transform.py +484 -11
  54. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_loss_reports.py +2 -15
  55. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_normative_catalog.py +1 -17
  56. openstatspec-0.8.1/tests/test_read_only_export.py +466 -0
  57. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_review_transaction_boundary.py +13 -82
  58. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_sql_profiles.py +36 -35
  59. openstatspec-0.8.1/tests/test_sql_services.py +587 -0
  60. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_sql_workflow.py +50 -0
  61. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_strict_catalog_review.py +4 -3
  62. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_transform_frontend.py +109 -0
  63. openstatspec-0.7.1/docs/release-readiness.md +0 -127
  64. openstatspec-0.7.1/tests/test_sql_services.py +0 -299
  65. {openstatspec-0.7.1 → openstatspec-0.8.1}/.github/verify_release_ref.py +0 -0
  66. {openstatspec-0.7.1 → openstatspec-0.8.1}/.gitignore +0 -0
  67. {openstatspec-0.7.1 → openstatspec-0.8.1}/THIRD_PARTY_NOTICES.md +0 -0
  68. {openstatspec-0.7.1 → openstatspec-0.8.1}/docs/architecture.md +0 -0
  69. {openstatspec-0.7.1 → openstatspec-0.8.1}/docs/in-place-transformation.md +0 -0
  70. {openstatspec-0.7.1 → openstatspec-0.8.1}/docs/pyspssio-spike.md +0 -0
  71. {openstatspec-0.7.1 → openstatspec-0.8.1}/docs/sql-transformation-workflow.md +0 -0
  72. {openstatspec-0.7.1 → openstatspec-0.8.1}/docs/superpowers/plans/2026-08-12-python-v071-stable-pin.md +0 -0
  73. {openstatspec-0.7.1 → openstatspec-0.8.1}/docs/superpowers/specs/2026-08-12-python-stable-specification-pin-design.md +0 -0
  74. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/.github/workflows/release.yml +0 -0
  75. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/.gitignore +0 -0
  76. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/CONTRIBUTING.md +0 -0
  77. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/fixtures/LICENSE.md +0 -0
  78. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/fixtures/README.md +0 -0
  79. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/fixtures/core-numeric-string.sav +0 -0
  80. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/fixtures/dictionary-and-display.sav +0 -0
  81. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/fixtures/generate-fixtures.sps +0 -0
  82. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/fixtures/long-utf8-and-attributes.sav +0 -0
  83. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/fixtures/missing-rules.sav +0 -0
  84. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/fixtures/sets.sav +0 -0
  85. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/fixtures/weight-and-string-mr.sav +0 -0
  86. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/fixtures/zsav-compressed.zsav +0 -0
  87. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/in-place-transformation-0.1.json +0 -0
  88. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/in-place-transformation-0.2.json +0 -0
  89. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/spss-sav-zsav-1.0.json +0 -0
  90. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/spss-syntax-frontend-0.1.json +0 -0
  91. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/spss-syntax-frontend-0.2.json +0 -0
  92. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/sql-transformation-workflow-0.1.json +0 -0
  93. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/transformation-plan-0.1.json +0 -0
  94. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/conformance/transformation-plan-0.2.json +0 -0
  95. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/docs/architecture.md +0 -0
  96. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/docs/mssql-dialect-roadmap.md +0 -0
  97. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/docs/spss-profile.md +0 -0
  98. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/docs/spss-syntax-frontend-profile-0.1.md +0 -0
  99. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/docs/sql-transformation-workflow-profile-0.1.md +0 -0
  100. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/docs/transformation-plan-profile-0.1.md +0 -0
  101. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/docs/transformation-plan-sql-binding-0.1.md +0 -0
  102. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/examples/basic-spss-mapping.md +0 -0
  103. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/examples/spss-syntax-transformation-0.2.md +0 -0
  104. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/examples/spss-syntax-transformation.md +0 -0
  105. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/examples/sql-transformation-workflow.md +0 -0
  106. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/sql/dialect-profile-baseline.json +0 -0
  107. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/sql/dolt-adapter-declaration-schema.json +0 -0
  108. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/sql/schema-outline.sql +0 -0
  109. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/sql/transformation-plan-profile-schema.sql +0 -0
  110. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/sql/transformation-workflow-profile-schema.sql +0 -0
  111. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/src/openstatspec_specification/__init__.py +0 -0
  112. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/src/openstatspec_specification/dolt.py +0 -0
  113. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/tests/test_dolt_declarations.py +0 -0
  114. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/transformation/plan-0.1.schema.json +0 -0
  115. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/transformation/plan-0.2.schema.json +0 -0
  116. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/transformation/spss-syntax-frontend-0.1.schema.json +0 -0
  117. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification/transformation/spss-syntax-frontend-0.2.schema.json +0 -0
  118. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/.github/workflows/ci.yml +0 -0
  119. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/.github/workflows/publish.yml +0 -0
  120. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/.gitignore +0 -0
  121. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/CHANGELOG.md +0 -0
  122. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/CONTRIBUTING.md +0 -0
  123. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/README.md +0 -0
  124. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/RELEASING.md +0 -0
  125. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/ROADMAP.md +0 -0
  126. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/VERSIONING.md +0 -0
  127. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/fixtures/LICENSE.md +0 -0
  128. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/fixtures/README.md +0 -0
  129. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/fixtures/core-numeric-string.sav +0 -0
  130. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/fixtures/dictionary-and-display.sav +0 -0
  131. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/fixtures/generate-fixtures.sps +0 -0
  132. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/fixtures/long-utf8-and-attributes.sav +0 -0
  133. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/fixtures/missing-rules.sav +0 -0
  134. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/fixtures/sets.sav +0 -0
  135. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/fixtures/weight-and-string-mr.sav +0 -0
  136. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/fixtures/zsav-compressed.zsav +0 -0
  137. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/in-place-transformation-0.1.json +0 -0
  138. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/in-place-transformation-0.2.json +0 -0
  139. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/spss-sav-zsav-1.0.json +0 -0
  140. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/spss-syntax-frontend-0.1.json +0 -0
  141. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/spss-syntax-frontend-0.2.json +0 -0
  142. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/sql-transformation-workflow-0.1.json +0 -0
  143. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/transformation-plan-0.1.json +0 -0
  144. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/conformance/transformation-plan-0.2.json +0 -0
  145. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/docs/architecture.md +0 -0
  146. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/docs/implementation-profiles/python-pyspssio-0.5.1.md +0 -0
  147. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/docs/mssql-dialect-roadmap.md +0 -0
  148. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/docs/spss-profile.md +0 -0
  149. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/docs/spss-sav-zsav-profile-1.0.md +0 -0
  150. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/docs/spss-syntax-frontend-profile-0.1.md +0 -0
  151. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/docs/spss-syntax-frontend-profile-0.2.md +0 -0
  152. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/docs/sql-transformation-workflow-profile-0.1.md +0 -0
  153. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/docs/transformation-plan-profile-0.1.md +0 -0
  154. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/docs/transformation-plan-profile-0.2.md +0 -0
  155. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/docs/transformation-plan-sql-binding-0.1.md +0 -0
  156. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/docs/transformation-plan-sql-binding-0.2.md +0 -0
  157. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/examples/basic-spss-mapping.md +0 -0
  158. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/examples/spss-syntax-transformation-0.2.md +0 -0
  159. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/examples/spss-syntax-transformation.md +0 -0
  160. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/examples/sql-transformation-workflow.md +0 -0
  161. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/pyproject.toml +0 -0
  162. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/sql/dialect-profile-baseline.json +0 -0
  163. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/sql/dialect-profiles.md +0 -0
  164. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/sql/dolt-adapter-declaration-schema.json +0 -0
  165. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/sql/dolt-adapter-declarations/README.md +0 -0
  166. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/sql/profile-capabilities.md +0 -0
  167. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/sql/schema-outline.sql +0 -0
  168. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/sql/server-version-policy.md +0 -0
  169. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/sql/transformation-plan-profile-schema.sql +0 -0
  170. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/sql/transformation-workflow-profile-schema.sql +0 -0
  171. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/src/openstatspec_specification/__init__.py +0 -0
  172. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/src/openstatspec_specification/dolt.py +0 -0
  173. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/tests/test_dolt_declarations.py +0 -0
  174. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/tools/validate_repository.py +0 -0
  175. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/transformation/plan-0.1.schema.json +0 -0
  176. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/transformation/plan-0.2.schema.json +0 -0
  177. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/transformation/spss-syntax-frontend-0.1.schema.json +0 -0
  178. {openstatspec-0.7.1 → openstatspec-0.8.1}/openstatspec-specification-package/transformation/spss-syntax-frontend-0.2.schema.json +0 -0
  179. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/__init__.py +0 -0
  180. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/cli.py +0 -0
  181. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/core/__init__.py +0 -0
  182. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/core/results.py +0 -0
  183. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/frontends/__init__.py +0 -0
  184. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/frontends/sas/.gitkeep +0 -0
  185. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/frontends/spss/__init__.py +0 -0
  186. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/frontends/spss/binding.py +0 -0
  187. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/frontends/spss/compiler.py +0 -0
  188. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/frontends/spss/execution.py +0 -0
  189. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/frontends/spss/syntax.py +0 -0
  190. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/frontends/stata/.gitkeep +0 -0
  191. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/spss/__init__.py +0 -0
  192. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/spss/dictionary.py +0 -0
  193. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/spss/raw_dictionary.py +0 -0
  194. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/sql/__init__.py +0 -0
  195. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/sql/catalog_verification.py +0 -0
  196. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/sql/normative.py +0 -0
  197. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/sql/profiles.py +0 -0
  198. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/transform/__init__.py +0 -0
  199. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/transform/errors.py +0 -0
  200. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/transform/plan.py +0 -0
  201. {openstatspec-0.7.1 → openstatspec-0.8.1}/src/openstatspec/transform/schema.py +0 -0
  202. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/conformance.py +0 -0
  203. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_attribute_catalog.py +0 -0
  204. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_conditional_inplace_transform.py +0 -0
  205. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_document_round_trip.py +0 -0
  206. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_official_conformance.py +0 -0
  207. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_pyspssio_catalog_authority.py +0 -0
  208. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_release_ref.py +0 -0
  209. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_sav_sqlite.py +0 -0
  210. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_spss_catalog_preflight.py +0 -0
  211. {openstatspec-0.7.1 → openstatspec-0.8.1}/tests/test_vls_compatible_names.py +0 -0
@@ -20,7 +20,7 @@ jobs:
20
20
  uses: actions/checkout@v7
21
21
  with: &specification-checkout
22
22
  repository: OpenStatSpec/specification
23
- ref: cd8f198c68b849eb8ed018a894670a0904c2181d
23
+ ref: 864e84479f554b8ee250ffed44c4dfb963750d4a
24
24
  path: openstatspec-specification
25
25
  - name: Checkout required SPSS engine
26
26
  uses: actions/checkout@v7
@@ -53,9 +53,9 @@ jobs:
53
53
  - run: python -m pip install --upgrade pip build
54
54
  - run: python -m build
55
55
  - run: python -m venv /tmp/openstatspec-wheel-smoke
56
- - run: /tmp/openstatspec-wheel-smoke/bin/python -m pip install ./openstatspec-pyspssio
57
56
  - run: /tmp/openstatspec-wheel-smoke/bin/python -m pip install dist/*.whl
58
- - run: /tmp/openstatspec-wheel-smoke/bin/openstatspec capabilities
57
+ - run: env -u PYTHONPATH /tmp/openstatspec-wheel-smoke/bin/openstatspec capabilities
58
+ working-directory: /tmp
59
59
 
60
60
  postgres-integration:
61
61
  name: PostgreSQL ${{ matrix.postgres }} integration
@@ -143,7 +143,7 @@ jobs:
143
143
  steps: *sql-test-steps
144
144
 
145
145
  dolt-integration:
146
- name: Dolt ${{ matrix.dolt }} read-only / fail-closed integration
146
+ name: Dolt ${{ matrix.dolt }} default-write integration
147
147
  runs-on: ubuntu-latest
148
148
  strategy:
149
149
  fail-fast: false
@@ -155,6 +155,7 @@ jobs:
155
155
  image: dolthub/dolt:2.2.3@sha256:1a651e738a2e7275b9c69fec8c5f42c6e23954314405c412f4dc9287ee7c0080
156
156
  env:
157
157
  OPENSTATSPEC_DOLT_URL: mysql+pymysql://openstatspec:openstatspec@127.0.0.1:13308/openstatspec
158
+ OPENSTATSPEC_TEST_DOLT_ADMIN_URL: mysql+pymysql://openstatspec_test_admin:ci-admin@127.0.0.1:13308/
158
159
  OPENSTATSPEC_EXPECTED_DOLT_VERSION: ${{ matrix.dolt }}
159
160
  OPENSTATSPEC_DOLT_IMAGE: ${{ matrix.image }}
160
161
  steps:
@@ -186,6 +187,11 @@ jobs:
186
187
  --workdir /var/lib/dolt \
187
188
  "$OPENSTATSPEC_DOLT_IMAGE" sql \
188
189
  -q "CREATE USER 'openstatspec'@'%' IDENTIFIED BY 'openstatspec'; GRANT ALL PRIVILEGES ON openstatspec.* TO 'openstatspec'@'%'"
190
+ docker run --rm \
191
+ --volume "$RUNNER_TEMP/openstatspec-dolt:/var/lib/dolt" \
192
+ --workdir /var/lib/dolt \
193
+ "$OPENSTATSPEC_DOLT_IMAGE" sql \
194
+ -q "CREATE USER 'openstatspec_test_admin'@'%' IDENTIFIED BY 'ci-admin'; GRANT ALL PRIVILEGES ON *.* TO 'openstatspec_test_admin'@'%' WITH GRANT OPTION"
189
195
  docker run --detach --name openstatspec-dolt \
190
196
  --publish 127.0.0.1:13308:3306 \
191
197
  --volume "$RUNNER_TEMP/openstatspec-dolt:/var/lib/dolt" \
@@ -218,6 +224,7 @@ jobs:
218
224
  break
219
225
  PY
220
226
  - run: python -m pytest -m "services and not candidate_evidence"
227
+ - run: python -m pytest tests/test_read_only_export.py
221
228
  - name: Show Dolt logs on failure and stop server
222
229
  if: always()
223
230
  run: |
@@ -48,7 +48,7 @@ jobs:
48
48
  uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
49
49
  with:
50
50
  repository: OpenStatSpec/specification
51
- ref: cd8f198c68b849eb8ed018a894670a0904c2181d
51
+ ref: 864e84479f554b8ee250ffed44c4dfb963750d4a
52
52
  path: openstatspec-specification
53
53
  - name: Checkout specification package source
54
54
  uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
@@ -159,9 +159,9 @@ jobs:
159
159
  - run: python -m pip install -e ".[dev]"
160
160
  - run: python -m pytest -m "not services"
161
161
  - run: python -m venv /tmp/openstatspec-release-smoke
162
- - run: /tmp/openstatspec-release-smoke/bin/python -m pip install ./openstatspec-pyspssio
163
162
  - run: /tmp/openstatspec-release-smoke/bin/python -m pip install dist/openstatspec/openstatspec-*.whl
164
- - run: /tmp/openstatspec-release-smoke/bin/openstatspec capabilities
163
+ - run: env -u PYTHONPATH /tmp/openstatspec-release-smoke/bin/openstatspec capabilities
164
+ working-directory: /tmp
165
165
  - name: Smoke-test specification wheel
166
166
  run: |
167
167
  python -m venv /tmp/openstatspec-specification-release-smoke
@@ -2,9 +2,63 @@
2
2
 
3
3
  All notable changes to this reference implementation are documented here.
4
4
 
5
- ## Unreleased
5
+ ## 0.8.1 - 2026-09-10
6
6
 
7
- _No unreleased changes._
7
+ ### Fixed
8
+
9
+ - Preserve other variables' shared value labels when replacing one variable's
10
+ labels. Reject deletion of variables referenced by published derived lineage
11
+ before any plan mutation, with `variable_has_dependents`.
12
+ - Enable and verify SQLite foreign keys on in-place apply connections.
13
+ - Read export values, dictionary metadata, import fidelity events and validation
14
+ reflection from one native database snapshot; close it before writing SAV/ZSAV.
15
+ - Scope transformation label reads to the target variable's dataset. Unrelated
16
+ malformed labels no longer fail the operation; malformed target-linked labels
17
+ still fail, and shared/foreign-owned linked label sets remain supported.
18
+
19
+ ### Performance
20
+
21
+ - Remove quadratic suffix/name scans from canonical-plan binding and reuse one
22
+ canonical plan encoding/hash per public canonical or SPSS apply.
23
+ - Remove redundant full case-row dictionary collections from database reads and
24
+ imports. Results remain buffered; this is not a streaming API.
25
+ - Avoid the discarded core relation hash during SQLite workflow registration,
26
+ retaining physical projection validation and derived-parent integrity checks.
27
+ Execution-time hashes remain required; their loop avoids a redundant tuple copy.
28
+
29
+ ### Documentation and cleanup
30
+
31
+ - Document numeric create/replace, RECODE and separately provisioned target
32
+ recipes, with bounded local SQLite measurements in the transformations manual.
33
+ - Remove an unreachable view-creation branch; workflow output remains
34
+ materialized-only.
35
+
36
+ The specification pin, engine dependency, database/profile claims, catalog schema,
37
+ public call signatures and Dolt-owned versioning policy remain unchanged.
38
+
39
+ ## 0.8.0 - 2026-09-07
40
+
41
+ ### Changed
42
+
43
+ - Pin released specification `v0.5.0` at exact commit
44
+ `864e84479f554b8ee250ffed44c4dfb963750d4a`, with normative status `released`.
45
+ Capabilities identify adapter version 0.8.0 and explicitly select SAV/ZSAV 1.0
46
+ with `database_io_policy=openstatspec-database-io-v1`.
47
+ - Reads, inspection, validation, and SAV/ZSAV export no longer write database
48
+ operation/fidelity audit records, including on failure. Export diagnostics
49
+ and loss consent remain operation-scoped; export results omit `operation_id`.
50
+ - Default Dolt writes use the packaged tested exact-version policy for 2.2.2
51
+ and 2.2.3 without user-supplied evidence files. Unknown/untested versions
52
+ remain blocked before mutation; explicit external overrides remain strict.
53
+ Safety budgets are not claimed as proven native server limits.
54
+ - Dolt reads no longer require write-version declarations or the write
55
+ variable-count ceiling. Missing SQLite files are rejected without creation.
56
+ - Exact Dolt 2.2.2/2.2.3 CI explicitly runs SELECT-only export success/failure
57
+ tests using a separate fixture-admin account; normal service permissions
58
+ and adapter permissions are unchanged. Wheel smoke installs resolve the
59
+ required engine from PyPI rather than a source checkout.
60
+
61
+ No optional Transformation Workflow 0.3 implementation is claimed.
8
62
 
9
63
  ## 0.7.1 - 2026-08-12
10
64
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: openstatspec
3
- Version: 0.7.1
3
+ Version: 0.8.1
4
4
  Summary: Reference adapter for the OpenStatSpec relational contract
5
5
  Author: OpenStatSpec
6
6
  License: Apache-2.0
@@ -23,6 +23,10 @@ The reference Python implementation of the OpenStatSpec specification.
23
23
 
24
24
  This package implements the specification; it does not define or extend it.
25
25
  The normative model lives in the `OpenStatSpec/specification` repository.
26
+ Python 0.8.1 pins released specification `v0.5.0` at
27
+ `864e84479f554b8ee250ffed44c4dfb963750d4a` and selects SAV/ZSAV 1.0 with
28
+ `database_io_policy=openstatspec-database-io-v1`. This does not claim
29
+ implementation of the optional Transformation Workflow 0.3 profile.
26
30
 
27
31
  ## Boundaries
28
32
 
@@ -115,17 +119,19 @@ SAV/ZSAV export for the semantics exposed by that engine. SQLite is the local
115
119
  reference path.
116
120
  PostgreSQL, MySQL, MariaDB, and Dolt are each covered by separate service-backed CI
117
121
  conformance checks. Dolt support is an independent core profile for the
118
- canonical stable range `>=2.2.2,<2.3.0`; earlier patches, other families,
119
- noncanonical versions, and unknown MySQL-wire products fail closed.
122
+ exact write-supported versions 2.2.2 and 2.2.3; all other versions (including
123
+ 2.3.0), noncanonical versions, and unknown MySQL-wire products fail closed for writes.
120
124
 
121
125
  The supported family claims are broader than the deliberately exact CI
122
126
  evidence points: PostgreSQL 17.x/18.x is exercised at 17.10/18.4, MySQL
123
127
  8.4.x/9.7.x at 8.4.11/9.7.2, and MariaDB 11.4.x/11.8.x/12.3.x at
124
128
  11.4.12/11.8.8/12.3.2. Each service job checks the normalized live server
125
129
  version against its exact matrix entry before that run can count as evidence.
126
- Dolt claims the conservative 2.2.x range `>=2.2.2,<2.3.0`; its full service
127
- suite is exercised independently at exact versions 2.2.2 and 2.2.3 using
128
- immutable container-image digests.
130
+ Dolt's default-write service checks run independently at exact versions 2.2.2
131
+ and 2.2.3 using immutable container-image digests. Release/CI owns this evidence;
132
+ normal callers need no declaration or evidence files. The optional explicit
133
+ `DoltConformanceSource` override remains strict and does not fall back to the
134
+ default policy if its declarations are missing, invalid, or mismatched.
129
135
 
130
136
  | Engine/profile | Runtime supported policy | Exact CI-tested versions |
131
137
  | --- | --- | --- |
@@ -133,7 +139,7 @@ immutable container-image digests.
133
139
  | PostgreSQL | 17.x and 18.x | 17.10 and 18.4 |
134
140
  | MySQL | 8.4.x and 9.7.x | 8.4.11 and 9.7.2 |
135
141
  | MariaDB | 11.4.x, 11.8.x, and 12.3.x | 11.4.12, 11.8.8, and 12.3.2 |
136
- | Dolt | 2.2.x with `>=2.2.2,<2.3.0` | 2.2.2 and 2.2.3 |
142
+ | Dolt writes | Exactly 2.2.2 and 2.2.3 | 2.2.2 and 2.2.3 |
137
143
 
138
144
  Microsoft SQL Server (MSSQL) remains roadmap-only and is not a supported
139
145
  runtime profile; see the specification's [MSSQL roadmap](https://github.com/OpenStatSpec/specification/blob/main/docs/mssql-dialect-roadmap.md).
@@ -143,7 +149,7 @@ Use these explicit SQLAlchemy URLs:
143
149
  - SQLite: `sqlite:///dataset.sqlite`
144
150
  - PostgreSQL: `postgresql+psycopg://user:password@host/database`
145
151
  - MySQL/MariaDB: `mysql+pymysql://user:password@host/database`
146
- - Dolt `>=2.2.2,<2.3.0`: `mysql+pymysql://user:password@host/database` (detected by server identity)
152
+ - Dolt 2.2.2 or 2.2.3: `mysql+pymysql://user:password@host/database` (detected by server identity)
147
153
 
148
154
  The Dolt core profile supports strict wide-table import, validation, and export;
149
155
  the separate Transformation Workflow is unsupported.
@@ -151,8 +157,16 @@ the separate Transformation Workflow is unsupported.
151
157
  Run `openstatspec capabilities` before an integration to inspect the
152
158
  machine-readable feature matrix. Export is deliberately strict: if known
153
159
  dictionary semantics cannot be reproduced, it stops until you pass the exact
154
- diagnostic code with `--allow-loss`. This avoids silent loss while making an
155
- intentional lossy export auditable.
160
+ diagnostic code with `--allow-loss`. Diagnostics are returned to the caller, not
161
+ persisted. Reads, validation, and SAV/ZSAV export never write to the database,
162
+ including on failure. Export returns no `operation_id` and needs only read
163
+ permissions; Dolt reads have no write-version or write-variable-count gate.
164
+ Read operations reject missing SQLite files without creating them. Imports and transformations
165
+ use the packaged exact-version policy by default. Active driver/identity checks,
166
+ limit preflight, and the clean expected branch/HEAD guard for in-place apply
167
+ remain mandatory. Dolt's reported limits are adapter safety budgets, narrowed
168
+ by the active packet limit, not proven native server ceilings; full boundary
169
+ conformance is not claimed.
156
170
 
157
171
  The matrix is also available to Python callers as
158
172
  `openstatspec.capability_matrix()`. It distinguishes supported semantics from
@@ -4,6 +4,10 @@ The reference Python implementation of the OpenStatSpec specification.
4
4
 
5
5
  This package implements the specification; it does not define or extend it.
6
6
  The normative model lives in the `OpenStatSpec/specification` repository.
7
+ Python 0.8.1 pins released specification `v0.5.0` at
8
+ `864e84479f554b8ee250ffed44c4dfb963750d4a` and selects SAV/ZSAV 1.0 with
9
+ `database_io_policy=openstatspec-database-io-v1`. This does not claim
10
+ implementation of the optional Transformation Workflow 0.3 profile.
7
11
 
8
12
  ## Boundaries
9
13
 
@@ -96,17 +100,19 @@ SAV/ZSAV export for the semantics exposed by that engine. SQLite is the local
96
100
  reference path.
97
101
  PostgreSQL, MySQL, MariaDB, and Dolt are each covered by separate service-backed CI
98
102
  conformance checks. Dolt support is an independent core profile for the
99
- canonical stable range `>=2.2.2,<2.3.0`; earlier patches, other families,
100
- noncanonical versions, and unknown MySQL-wire products fail closed.
103
+ exact write-supported versions 2.2.2 and 2.2.3; all other versions (including
104
+ 2.3.0), noncanonical versions, and unknown MySQL-wire products fail closed for writes.
101
105
 
102
106
  The supported family claims are broader than the deliberately exact CI
103
107
  evidence points: PostgreSQL 17.x/18.x is exercised at 17.10/18.4, MySQL
104
108
  8.4.x/9.7.x at 8.4.11/9.7.2, and MariaDB 11.4.x/11.8.x/12.3.x at
105
109
  11.4.12/11.8.8/12.3.2. Each service job checks the normalized live server
106
110
  version against its exact matrix entry before that run can count as evidence.
107
- Dolt claims the conservative 2.2.x range `>=2.2.2,<2.3.0`; its full service
108
- suite is exercised independently at exact versions 2.2.2 and 2.2.3 using
109
- immutable container-image digests.
111
+ Dolt's default-write service checks run independently at exact versions 2.2.2
112
+ and 2.2.3 using immutable container-image digests. Release/CI owns this evidence;
113
+ normal callers need no declaration or evidence files. The optional explicit
114
+ `DoltConformanceSource` override remains strict and does not fall back to the
115
+ default policy if its declarations are missing, invalid, or mismatched.
110
116
 
111
117
  | Engine/profile | Runtime supported policy | Exact CI-tested versions |
112
118
  | --- | --- | --- |
@@ -114,7 +120,7 @@ immutable container-image digests.
114
120
  | PostgreSQL | 17.x and 18.x | 17.10 and 18.4 |
115
121
  | MySQL | 8.4.x and 9.7.x | 8.4.11 and 9.7.2 |
116
122
  | MariaDB | 11.4.x, 11.8.x, and 12.3.x | 11.4.12, 11.8.8, and 12.3.2 |
117
- | Dolt | 2.2.x with `>=2.2.2,<2.3.0` | 2.2.2 and 2.2.3 |
123
+ | Dolt writes | Exactly 2.2.2 and 2.2.3 | 2.2.2 and 2.2.3 |
118
124
 
119
125
  Microsoft SQL Server (MSSQL) remains roadmap-only and is not a supported
120
126
  runtime profile; see the specification's [MSSQL roadmap](https://github.com/OpenStatSpec/specification/blob/main/docs/mssql-dialect-roadmap.md).
@@ -124,7 +130,7 @@ Use these explicit SQLAlchemy URLs:
124
130
  - SQLite: `sqlite:///dataset.sqlite`
125
131
  - PostgreSQL: `postgresql+psycopg://user:password@host/database`
126
132
  - MySQL/MariaDB: `mysql+pymysql://user:password@host/database`
127
- - Dolt `>=2.2.2,<2.3.0`: `mysql+pymysql://user:password@host/database` (detected by server identity)
133
+ - Dolt 2.2.2 or 2.2.3: `mysql+pymysql://user:password@host/database` (detected by server identity)
128
134
 
129
135
  The Dolt core profile supports strict wide-table import, validation, and export;
130
136
  the separate Transformation Workflow is unsupported.
@@ -132,8 +138,16 @@ the separate Transformation Workflow is unsupported.
132
138
  Run `openstatspec capabilities` before an integration to inspect the
133
139
  machine-readable feature matrix. Export is deliberately strict: if known
134
140
  dictionary semantics cannot be reproduced, it stops until you pass the exact
135
- diagnostic code with `--allow-loss`. This avoids silent loss while making an
136
- intentional lossy export auditable.
141
+ diagnostic code with `--allow-loss`. Diagnostics are returned to the caller, not
142
+ persisted. Reads, validation, and SAV/ZSAV export never write to the database,
143
+ including on failure. Export returns no `operation_id` and needs only read
144
+ permissions; Dolt reads have no write-version or write-variable-count gate.
145
+ Read operations reject missing SQLite files without creating them. Imports and transformations
146
+ use the packaged exact-version policy by default. Active driver/identity checks,
147
+ limit preflight, and the clean expected branch/HEAD guard for in-place apply
148
+ remain mandatory. Dolt's reported limits are adapter safety budgets, narrowed
149
+ by the active packet limit, not proven native server ceilings; full boundary
150
+ conformance is not claimed.
137
151
 
138
152
  The matrix is also available to Python callers as
139
153
  `openstatspec.capability_matrix()`. It distinguishes supported semantics from
@@ -0,0 +1,233 @@
1
+ # 0.8.1 release readiness
2
+
3
+ This page records the expected release contract, not a publication event.
4
+ Creating a version tag remains a separate maintainer action.
5
+
6
+ ## Patch scope
7
+
8
+ Version 0.8.1 includes the merged metadata-integrity, consistent-read-snapshot,
9
+ row-copy, transformation-planning and SQLite workflow fixes described in the
10
+ [release notes](../CHANGELOG.md). It introduces no catalog
11
+ migration, dependency change, new database support or specification pin update.
12
+ The local 0.8.0 evidence below is historical, not verification of this patch.
13
+ Re-run the gates below on the exact selected 0.8.1 release commit.
14
+
15
+ The release selects SAV/ZSAV 1.0 with the optional Database I/O Execution
16
+ Policy `openstatspec-database-io-v1`. Reads and exports, including failures,
17
+ write no database audit records; export results omit `operation_id` and return
18
+ diagnostics to the caller. Reads must not create missing SQLite files or apply
19
+ Dolt write-variable-count ceilings. This release does not claim implementation
20
+ of the optional Transformation Workflow 0.3 profile.
21
+
22
+ ## Supported workflow
23
+
24
+ For a supported unencrypted SAV or ZSAV source, the adapter imports one source
25
+ dataset into exactly one dedicated wide data table plus the complete singular,
26
+ UUID-keyed normative catalog from the SPSS profile. It can validate that
27
+ representation and export it back to SAV or ZSAV. Historical `*_catalog`
28
+ tables remain private compatibility storage and do not replace the normative
29
+ database contract.
30
+
31
+ ## SQL profiles
32
+
33
+ | Profile | Connection URL | Claimed versions | Exact CI evidence |
34
+ | --- | --- | --- | --- |
35
+ | SQLite | `sqlite:///dataset.sqlite` | `>=3.24.0,<4.0.0` | Active Python 3.11–3.14 runner version |
36
+ | PostgreSQL | `postgresql+psycopg://…` | 17.x and 18.x | 17.10 and 18.4 |
37
+ | MySQL | `mysql+pymysql://…` | 8.4.x and 9.7.x | 8.4.11 and 9.7.2 |
38
+ | MariaDB | `mysql+pymysql://…` | 11.4.x, 11.8.x, and 12.3.x | 11.4.12, 11.8.8, and 12.3.2 |
39
+ | Dolt writes | `mysql+pymysql://…` | Exactly 2.2.2 and 2.2.3 | 2.2.2 and 2.2.3 |
40
+
41
+ Separate service matrices test the shared MySQL/MariaDB profile contract while
42
+ retaining distinct active-server identities and version claims. Dolt is an
43
+ independent core profile with a packaged exact-version write policy; normal
44
+ callers supply no conformance files. An explicit external declaration source
45
+ remains a strict override. Read-only validation/export has no write-version gate.
46
+ The optional Transformation Workflow remains SQLite-only. This does not claim
47
+ coverage for every server configuration or proven Dolt native limit ceilings.
48
+ Dolt capabilities report adapter safety budgets and active packet constraints;
49
+ full boundary conformance remains pending.
50
+ Every server service job compares the normalized live product version with its
51
+ exact matrix entry, so a moved or mismatched image cannot substantiate the CI
52
+ declaration. SQLite's optional Transformation Workflow retains its narrower
53
+ `>=3.35.0,<4.0.0` live preflight alongside the core `>=3.24.0,<4.0.0` policy.
54
+ Microsoft SQL Server remains unsupported and must not appear in runtime
55
+ capabilities; future implementation requirements are documented in the
56
+ specification's
57
+ [MSSQL dialect roadmap](https://github.com/OpenStatSpec/specification/blob/main/docs/mssql-dialect-roadmap.md).
58
+
59
+
60
+ ## Export-loss policy
61
+
62
+ `capability_matrix()` and `openstatspec capabilities` expose the current
63
+ feature state. Before export, the adapter combines source and writer
64
+ diagnostics. An export with known loss fails unless the caller passes the
65
+ relevant diagnostic codes through `allow_loss` or repeats `--allow-loss CODE`
66
+ in the CLI.
67
+
68
+ The concrete pyspssio boundaries are documented in the [SAV profile](sav-profile.md).
69
+ The pinned OpenStatSpec fork preserves document text, file labels, legacy
70
+ compatible names, separate print/write formats, variable sets,
71
+ multiple-response sets, alignment, scalar attributes, and ordered
72
+ custom-attribute arrays. Non-UTF-8 output requires an explicit matching locale;
73
+ otherwise the strict export policy reports and blocks the loss. A caller
74
+ that supplies consent for an available loss code receives the
75
+ machine-readable loss report with the export result.
76
+
77
+ ## Transformation release gates
78
+
79
+ The canonical transformation core and SPSS syntax frontend are separate public
80
+ surfaces. A release must run the specification-owned canonical-plan and SPSS
81
+ frontend conformance fixtures, then exercise both the generic plan apply API
82
+ and the SPSS compatibility apply path.
83
+
84
+ The gate must prove that:
85
+
86
+ - a TransformationPlan object and its strict JSON mapping produce the same
87
+ plan hash and in-place result;
88
+ - the exact bounded `COMPUTE`/`IF` program compiles to all seven ordered
89
+ operations without dropping `FORMATS`, `VARIABLE LEVEL`, or `EXECUTE`;
90
+ - bounded `STRING` declarations and `DELETE VARIABLES` operations preserve
91
+ the resulting schema and physical-column identity on supported profiles;
92
+ - boolean data results match the equivalent expression and the target's label,
93
+ 0/1 value labels, `F1.0` print/write format, and nominal level exist in the
94
+ normative catalog;
95
+ - injected schema, data, catalog, and audit failures leave no partial apply;
96
+ - compensation tracks only newly created targets and never drops or rewrites a
97
+ pre-existing target;
98
+ - MySQL, MariaDB, and Dolt reject create-target plans before mutation; their
99
+ service evidence covers assignment to a separately provisioned physical and
100
+ catalog target without schema DDL;
101
+ - top-level SPSS compiler imports and legacy openstatspec.transform re-exports
102
+ still load from an installed wheel;
103
+ - install-in-place-schema, apply-plan, and apply-spss execute their documented
104
+ CLI workflows;
105
+ - invalid or unsupported plans fail before the first data or metadata mutation;
106
+ - successful applies retain the same dataset ID, physical schema/table
107
+ identity, dataset count, and persistent physical data-table count;
108
+ - audit rows distinguish canonical plans from SPSS syntax, preserve correct
109
+ source/plan hashes and frontend contract, and contain no copied data;
110
+ - no OpenStatSpec rollback, snapshot, staging, copy, derived-dataset, or
111
+ parallel history artifacts are created; and
112
+ - Dolt checks expected branch, HEAD, and a clean working set; success changes
113
+ neither HEAD nor branch and never commits or resets; state is rechecked after
114
+ the dataset lock and success must leave an inspectable working-set diff;
115
+ other supported SQL connections remain allowed; and
116
+ - string comparisons and v0.2 string assignments remain fail-closed.
117
+
118
+ The built wheel must contain the generic openstatspec.transform modules and the
119
+ implemented openstatspec.frontends.spss package. Stata and SAS remain empty
120
+ source-tree placeholders and must expose no compiler, apply API, CLI choice,
121
+ capability claim, or implied support.
122
+
123
+ ## Prior default Dolt write verification (before the 0.8.0 pin)
124
+
125
+ Local release verification used the exact 2.2.2 and 2.2.3 image digests in
126
+ `.github/workflows/ci.yml`, isolated ports 13482/13483, and disposable `/tmp`
127
+ database directories. With `PYTHONPATH=src:../pyspssio`,
128
+ `OPENSTATSPEC_SPECIFICATION_DIR=/tmp/oss-php-spec-cd8f198`, and each matching
129
+ `OPENSTATSPEC_DOLT_URL` / `OPENSTATSPEC_EXPECTED_DOLT_VERSION`:
130
+
131
+ - `../python/.venv/bin/python -m pytest`: **366 passed, 49 skipped per pin**.
132
+ - CI selection `-m 'services and not candidate_evidence'`: **7 passed,
133
+ 41 skipped per pin**; other database services were not configured locally.
134
+ - Dolt 2.3.0 on port 13387: read-only export and unknown-version write rejection
135
+ checks passed (**19 passed**) using disposable fixture databases/users.
136
+ - `python -m compileall -q src tests` and `git diff --check` passed.
137
+
138
+ Live failures exposed and now cover two previously dormant write blockers:
139
+ owned table additions being misclassified as unrelated diffs, and Dolt retaining
140
+ `@@autocommit=1` despite the driver's setting. Writes now explicitly begin their
141
+ transaction. The candidate storage/identifier/column smoke probe also passed on
142
+ both pins; it does **not** establish full value/row/statement limit conformance.
143
+
144
+ ## 0.8.0 local verification
145
+
146
+ Using `../python/.venv/bin/python`, `PYTHONPATH=src:../pyspssio`, and
147
+ `OPENSTATSPEC_SPECIFICATION_DIR=/tmp/oss-python-spec-v050-5dSTna` (an archive
148
+ of exact `864e84479f554b8ee250ffed44c4dfb963750d4a`):
149
+
150
+ - `python -m pytest -ra`: **381 passed, 49 skipped**, with
151
+ `OPENSTATSPEC_TEST_DOLT_ADMIN_URL=mysql+pymysql://root@127.0.0.1:13387/`
152
+ exercising live Dolt 2.3.0 through disposable SELECT-only users.
153
+ - Both immutable CI images, exact Dolt 2.2.2/2.2.3, bootstrapped with the
154
+ unchanged service user and separate global fixture admin on ports 13582/13583:
155
+ `python -m pytest -m 'services and not candidate_evidence'`: **7 passed,
156
+ 41 skipped, 382 deselected per pin**; explicit
157
+ `python -m pytest tests/test_read_only_export.py`: **33 passed per pin**.
158
+ - `python -m compileall -q src tests`, `git diff --check`, wheel/sdist build,
159
+ and `python -m twine check /tmp/oss-python-v080-dist/*` passed.
160
+ - A clean wheel install resolved the required engine from PyPI. Isolated
161
+ imports came only from the smoke environment's `site-packages`; installed
162
+ capabilities reported adapter 0.8.0, the selected policy, released v0.5.0
163
+ provenance, and exactly 2.2.2/2.2.3 for default Dolt writes.
164
+
165
+ Other database services were not configured locally. This is local evidence,
166
+ not a claim that the updated remote CI or release publication has completed.
167
+
168
+ ## 0.8.1 local preparation verification
169
+
170
+ On Python 3.13.2 with SQLAlchemy 2.0.52 and the exact v0.5.0 specification
171
+ checkout, without configured database services:
172
+
173
+ - `python -m pytest -p no:cacheprovider -m 'not services'`: **414 passed,
174
+ 9 skipped, 53 deselected**. The release-ref guard tests also passed (**5**).
175
+ - `compileall`, `git diff --check`, wheel/sdist build and `twine check` passed.
176
+ - A clean wheel install outside the checkout resolved the required engine
177
+ `openstatspec-pyspssio==0.5.1.post2` from PyPI. Installed capabilities reported
178
+ 0.8.1, released specification v0.5.0 at the expected commit, and the selected
179
+ database I/O policy. Core, SPSS frontend and legacy compiler re-exports loaded
180
+ from `site-packages` without a source-path override.
181
+
182
+ This is local candidate evidence, not final release-commit service CI or
183
+ publication evidence. No v0.8.1 tag or registry upload was made by these checks.
184
+
185
+ ## Maintainer release checklist
186
+
187
+ 1. Publish the pinned `openstatspec-pyspssio==0.5.1.post2` engine distribution
188
+ first and confirm that a clean environment can download it from PyPI. The
189
+ main package has no fallback SPSS engine.
190
+ 2. Run `python -m pytest -m "not services"`.
191
+ 3. Confirm the GitHub Actions matrix is green for exact PostgreSQL 17.10/18.4,
192
+ MySQL 8.4.11/9.7.2, MariaDB 11.4.12/11.8.8/12.3.2, and exact Dolt
193
+ 2.2.2/2.2.3 service evidence from the immutable image pins in CI. The Dolt
194
+ jobs must perform default import/validate/SAV+ZSAV export, in-place recode
195
+ and labels with unchanged dataset/table counts and HEAD, injected data,
196
+ catalog, and audit rollback checks, and failed-import cleanup. Release/CI
197
+ owns this evidence, not per-user runtime declaration files. Candidate limit
198
+ probes remain non-claiming and separate from these write gates.
199
+ Each Dolt job must also run `python -m pytest tests/test_read_only_export.py`
200
+ explicitly, outside the `services` marker filter. Bootstrap a separate
201
+ `openstatspec_test_admin` on the isolated CI server with global database/user
202
+ creation and grant privileges, and set `OPENSTATSPEC_TEST_DOLT_ADMIN_URL`.
203
+ The fixture creates its own database and SELECT-only reader and removes
204
+ both afterward; the normal service user remains unchanged.
205
+ 4. Build with `python -m build` and install the generated wheel in a clean
206
+ environment, resolving `openstatspec-pyspssio==0.5.1.post2` from PyPI.
207
+ Run the installed CLI outside the source checkout with `PYTHONPATH` unset;
208
+ verify adapter version `0.8.1` and the selected database I/O policy.
209
+ 5. Confirm `openstatspec capabilities` reflects the intended support boundary.
210
+ 6. Confirm CI, release fixtures, and capabilities use the published OpenStatSpec
211
+ specification `v0.5.0` at exact commit
212
+ `864e84479f554b8ee250ffed44c4dfb963750d4a`, publish
213
+ `specification_status=released`, and set `specification_release` to `v0.5.0`.
214
+ Use an exact checkout via `OPENSTATSPEC_SPECIFICATION_DIR` for local tests.
215
+ 7. Review this document, the README, and CHANGELOG for accurate scope. Finalize
216
+ the 0.8.1 changelog date before selecting the final release commit.
217
+ 8. Confirm the exact release commit's CI matrix and package smoke passed, and
218
+ verify the protected `pypi` environment and Trusted Publishing setup before
219
+ pushing a new annotated/protected `v0.8.1` tag. A `v*` tag push starts the
220
+ publishing workflow; it is not a preparation-only check. Do not move an
221
+ existing tag. The workflow also rebuilds the unchanged specification companion
222
+ package 0.1.0 at its existing pin and uses `skip-existing`; it does not release
223
+ the newer specification validator changes.
224
+ 9. After publication, verify the tag resolves to the intended commit, the
225
+ tag-triggered workflow succeeded, and PyPI installs `openstatspec==0.8.1` in a
226
+ clean environment. Record the tag, CI and registry evidence before claiming
227
+ the release is published.
228
+
229
+ The tag-triggered release workflow repeats the non-service test suite, builds
230
+ the distributions, and installs the wheel with the exact required SPSS engine
231
+ in a clean environment before it can reach the protected `pypi` environment.
232
+ It fails closed if that exact engine version is not already downloadable from
233
+ PyPI, preventing publication of an uninstallable OpenStatSpec release.
@@ -49,7 +49,7 @@ equivalence of supported values, order, and dictionary metadata.
49
49
 
50
50
  The `openstatspec capabilities` command and the
51
51
  `openstatspec.capability_matrix()` function are the machine-readable declaration
52
- of this boundary. It records the pinned source commit and installed engine version, and the adapter stores the same identity in every import and export operation record. The matrix deliberately distinguishes a supported feature from a feature that the underlying engine cannot observe or write faithfully.
52
+ of this boundary. It records the pinned source commit and installed engine version, and the adapter stores the same identity in import operation records. Export is database-read-only: no operation, fidelity, recovery, or Dolt-history records are written, even on failure. Loss diagnostics are returned to the caller. Dolt export identifies the server and validates the catalog and data without requiring write-conformance declarations; write entry points retain that requirement. The matrix deliberately distinguishes a supported feature from a feature that the underlying engine cannot observe or write faithfully.
53
53
 
54
54
  | SPSS semantic | Pinned pyspssio status | Behaviour |
55
55
  | --- | --- | --- |