markweave 0.7.0__tar.gz → 0.7.2__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 (232) hide show
  1. {markweave-0.7.0 → markweave-0.7.2}/PKG-INFO +12 -5
  2. {markweave-0.7.0 → markweave-0.7.2}/README.md +11 -4
  3. {markweave-0.7.0 → markweave-0.7.2}/pyproject.toml +8 -6
  4. markweave-0.7.2/src/markweave/broker/inventory.py +419 -0
  5. markweave-0.7.0/src/markweave/broker/inventory.py → markweave-0.7.2/src/markweave/broker/inventory_storage.py +35 -377
  6. markweave-0.7.2/src/markweave/broker/kubernetes_attester_protocol.py +204 -0
  7. markweave-0.7.2/src/markweave/broker/kubernetes_attester_service.py +472 -0
  8. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/kubernetes_attester_transport.py +29 -622
  9. markweave-0.7.2/src/markweave/broker/kubernetes_contracts.py +283 -0
  10. markweave-0.7.2/src/markweave/broker/kubernetes_pod_contract.py +448 -0
  11. markweave-0.7.2/src/markweave/broker/kubernetes_recovery.py +316 -0
  12. markweave-0.7.2/src/markweave/broker/kubernetes_runtime.py +756 -0
  13. markweave-0.7.2/src/markweave/broker/mtls_identity.py +225 -0
  14. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/mtls_transport.py +42 -203
  15. markweave-0.7.2/src/markweave/broker/podman_cgroups.py +211 -0
  16. markweave-0.7.2/src/markweave/broker/podman_contract.py +469 -0
  17. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/podman_runtime.py +77 -599
  18. markweave-0.7.2/src/markweave/broker/response_binding.py +130 -0
  19. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/unix_transport.py +14 -119
  20. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/workspace_protocol.py +42 -10
  21. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/commands/conversion_http.py +31 -3
  22. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/commands/reversions.py +108 -1
  23. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/config.py +6 -0
  24. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/responses.py +1 -0
  25. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/routers/conversions.py +16 -1
  26. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/routers/reversions.py +18 -0
  27. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/schemas.py +13 -0
  28. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/jobs/models.py +7 -0
  29. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/jobs/ports.py +10 -1
  30. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/jobs/service.py +17 -2
  31. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/jobs/queries.py +33 -3
  32. markweave-0.7.2/src/markweave/persistence/migrations/versions/20260921_19_reversion_options.py +41 -0
  33. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/reversion_jobs/admission.py +3 -0
  34. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/reversion_jobs/common.py +8 -1
  35. markweave-0.7.2/src/markweave/persistence/reversion_jobs/reconciliation.py +532 -0
  36. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/reversion_jobs/repository.py +7 -500
  37. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/schema.py +1 -0
  38. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversion_jobs/models.py +34 -0
  39. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversion_jobs/reconciliation.py +6 -7
  40. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversion_jobs/result_validation.py +19 -2
  41. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversion_jobs/runtime.py +23 -13
  42. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversion_jobs/service.py +9 -2
  43. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversion_jobs/worker.py +19 -19
  44. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversion_jobs/worker_execution.py +1 -0
  45. markweave-0.7.2/src/markweave/reversions/_anydoc_compat/__init__.py +629 -0
  46. markweave-0.7.2/src/markweave/reversions/_anydoc_compat/blocks.py +359 -0
  47. markweave-0.7.2/src/markweave/reversions/_anydoc_compat/escaping.py +306 -0
  48. markweave-0.7.2/src/markweave/reversions/_anydoc_compat/inlines.py +319 -0
  49. markweave-0.7.2/src/markweave/reversions/_anydoc_compat/render_context.py +50 -0
  50. markweave-0.7.2/src/markweave/reversions/_anydoc_compat/traversal.py +107 -0
  51. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversions/attempt_channel.py +48 -28
  52. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversions/attempt_main.py +30 -0
  53. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversions/manifest.py +11 -0
  54. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversions/models.py +31 -1
  55. markweave-0.7.2/src/markweave/reversions/options.py +66 -0
  56. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversions/package.py +2 -0
  57. markweave-0.7.2/src/markweave/reversions/pptx.py +475 -0
  58. markweave-0.7.2/src/markweave/reversions/pptx_archive.py +227 -0
  59. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/version.py +1 -1
  60. markweave-0.7.0/src/markweave/broker/kubernetes_runtime.py +0 -1656
  61. markweave-0.7.0/src/markweave/reversions/_anydoc_compat.py +0 -1631
  62. {markweave-0.7.0 → markweave-0.7.2}/.gitignore +0 -0
  63. {markweave-0.7.0 → markweave-0.7.2}/LICENSE +0 -0
  64. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/__init__.py +0 -0
  65. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/app.py +0 -0
  66. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/auth/__init__.py +0 -0
  67. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/auth/errors.py +0 -0
  68. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/auth/memory.py +0 -0
  69. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/auth/models.py +0 -0
  70. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/auth/policy_errors.py +0 -0
  71. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/auth/ports.py +0 -0
  72. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/auth/provisioning.py +0 -0
  73. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/auth/security.py +0 -0
  74. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/auth/service.py +0 -0
  75. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/__init__.py +0 -0
  76. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/_cri_runtime_v1.proto +0 -0
  77. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/_cri_runtime_v1_pb2.py +0 -0
  78. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/_cri_runtime_v1_pb2.pyi +0 -0
  79. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/command_runner.py +0 -0
  80. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/dispatch.py +0 -0
  81. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/errors.py +0 -0
  82. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/fake_runtime.py +0 -0
  83. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/kubernetes_api.py +0 -0
  84. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/kubernetes_attester.py +0 -0
  85. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/kubernetes_attester_inventory.py +0 -0
  86. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/kubernetes_cri.py +0 -0
  87. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/kubernetes_inspector.py +0 -0
  88. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/models.py +0 -0
  89. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/mtls_control.py +0 -0
  90. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/podman_workspace.py +0 -0
  91. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/ports.py +0 -0
  92. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/process.py +0 -0
  93. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/protocol.py +0 -0
  94. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/reconciliation_protocol.py +0 -0
  95. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker/service.py +0 -0
  96. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/broker_process.py +0 -0
  97. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/__init__.py +0 -0
  98. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/commands/__init__.py +0 -0
  99. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/commands/_placeholders.py +0 -0
  100. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/commands/administration.py +0 -0
  101. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/commands/authentication.py +0 -0
  102. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/commands/conversions.py +0 -0
  103. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/commands/recovery.py +0 -0
  104. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/commands/runtime.py +0 -0
  105. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/commands/templates.py +0 -0
  106. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/errors.py +0 -0
  107. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/http.py +0 -0
  108. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/main.py +0 -0
  109. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/output.py +0 -0
  110. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/profiles.py +0 -0
  111. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/cli/types.py +0 -0
  112. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/conversion/__init__.py +0 -0
  113. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/conversion/archive.py +0 -0
  114. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/conversion/errors.py +0 -0
  115. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/conversion/images.py +0 -0
  116. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/conversion/libreoffice.py +0 -0
  117. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/conversion/mermaid.py +0 -0
  118. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/conversion/pandoc.py +0 -0
  119. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/conversion/processor.py +0 -0
  120. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/conversion/service.py +0 -0
  121. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/conversion/validation.py +0 -0
  122. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/__init__.py +0 -0
  123. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/components.py +0 -0
  124. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/dependencies.py +0 -0
  125. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/errors.py +0 -0
  126. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/lifecycle.py +0 -0
  127. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/middleware.py +0 -0
  128. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/openapi.py +0 -0
  129. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/routers/__init__.py +0 -0
  130. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/routers/administration.py +0 -0
  131. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/routers/audit_observability.py +0 -0
  132. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/routers/authentication.py +0 -0
  133. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/routers/presentations.py +0 -0
  134. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/http/routers/templates.py +0 -0
  135. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/jobs/__init__.py +0 -0
  136. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/jobs/errors.py +0 -0
  137. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/jobs/policy.py +0 -0
  138. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/jobs/runner.py +0 -0
  139. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/jobs/runtime.py +0 -0
  140. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/jobs/worker.py +0 -0
  141. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/jobs/worker_execution.py +0 -0
  142. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/jobs/worker_maintenance.py +0 -0
  143. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/jobs/worker_publication.py +0 -0
  144. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/kubernetes_attester_process.py +0 -0
  145. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/malware.py +0 -0
  146. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/observability.py +0 -0
  147. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/__init__.py +0 -0
  148. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/errors.py +0 -0
  149. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/job_admission.py +0 -0
  150. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/jobs/__init__.py +0 -0
  151. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/jobs/claims.py +0 -0
  152. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/jobs/cleanup.py +0 -0
  153. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/jobs/common.py +0 -0
  154. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/jobs/lifecycle.py +0 -0
  155. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/jobs/repository.py +0 -0
  156. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/jobs/submission.py +0 -0
  157. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/__init__.py +0 -0
  158. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/env.py +0 -0
  159. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/script.py.mako +0 -0
  160. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260823_01_auth_tables.py +0 -0
  161. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260823_02_template_identity.py +0 -0
  162. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260824_03_conversion_jobs.py +0 -0
  163. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260824_04_template_versions.py +0 -0
  164. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260824_05_template_integrity.py +0 -0
  165. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260824_06_template_publication_leases.py +0 -0
  166. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260824_07_retention_cleanup.py +0 -0
  167. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260824_08_immutable_retention_records.py +0 -0
  168. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260824_09_immutable_cleanup_evidence.py +0 -0
  169. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260824_10_job_correlation.py +0 -0
  170. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260824_11_authentication_audit.py +0 -0
  171. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260825_12_job_integrity_metadata.py +0 -0
  172. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260828_13_optional_job_template.py +0 -0
  173. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260829_14_password_change_required.py +0 -0
  174. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260901_15_idle_session_policy.py +0 -0
  175. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260906_16_reversion_queue.py +0 -0
  176. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260906_17_broker_reconciliation.py +0 -0
  177. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/migrations/versions/20260920_18_presentations.py +0 -0
  178. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/observability.py +0 -0
  179. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/retention.py +0 -0
  180. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/reversion_jobs/__init__.py +0 -0
  181. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/reversion_jobs/retention.py +0 -0
  182. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/sql.py +0 -0
  183. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/templates/__init__.py +0 -0
  184. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/templates/audit.py +0 -0
  185. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/templates/common.py +0 -0
  186. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/templates/identity.py +0 -0
  187. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/templates/publication.py +0 -0
  188. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/templates/publication_recovery.py +0 -0
  189. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/templates/repository.py +0 -0
  190. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/templates/search.py +0 -0
  191. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/templates/selection.py +0 -0
  192. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/persistence/templates/versions.py +0 -0
  193. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/presentations/__init__.py +0 -0
  194. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/presentations/models.py +0 -0
  195. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/presentations/pandoc.py +0 -0
  196. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/presentations/preparation.py +0 -0
  197. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/presentations/processor.py +0 -0
  198. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/presentations/runtime.py +0 -0
  199. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/presentations/templates.py +0 -0
  200. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/recovery.py +0 -0
  201. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/recovery_adapters.py +0 -0
  202. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/recovery_manifest.py +0 -0
  203. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/recovery_service.py +0 -0
  204. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/retention.py +0 -0
  205. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversion_jobs/__init__.py +0 -0
  206. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversion_jobs/errors.py +0 -0
  207. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversion_jobs/policy.py +0 -0
  208. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversion_jobs/ports.py +0 -0
  209. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversion_jobs/runner.py +0 -0
  210. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversion_jobs/worker_maintenance.py +0 -0
  211. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversion_jobs/worker_publication.py +0 -0
  212. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversions/ANYDOC_COMPAT_LICENSE.txt +0 -0
  213. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversions/__init__.py +0 -0
  214. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversions/assets.py +0 -0
  215. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversions/capabilities.py +0 -0
  216. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversions/detection.py +0 -0
  217. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversions/errors.py +0 -0
  218. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversions/formats.py +0 -0
  219. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/reversions/hyperlinks.py +0 -0
  220. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/runtime.py +0 -0
  221. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/runtime_diagnostics.py +0 -0
  222. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/runtime_migrations.py +0 -0
  223. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/storage.py +0 -0
  224. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/templates/__init__.py +0 -0
  225. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/templates/engines.py +0 -0
  226. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/templates/errors.py +0 -0
  227. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/templates/models.py +0 -0
  228. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/templates/ports.py +0 -0
  229. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/templates/processor.py +0 -0
  230. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/templates/runtime.py +0 -0
  231. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/templates/service.py +0 -0
  232. {markweave-0.7.0 → markweave-0.7.2}/src/markweave/templates/validation.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: markweave
3
- Version: 0.7.0
3
+ Version: 0.7.2
4
4
  Summary: Secure Markdown-to-DOCX and PDF conversion service and HTTP CLI
5
5
  Project-URL: Documentation, https://github.com/Guillaume-Lombardo/simple-md-to-docx-converter/blob/main/docs/python-distribution.md
6
6
  Project-URL: Issues, https://github.com/Guillaume-Lombardo/simple-md-to-docx-converter/issues
@@ -106,10 +106,11 @@ Markweave turns a Markdown file into DOCX, PDF, or an editable PowerPoint presen
106
106
  your Word and PowerPoint templates and completed jobs on local persistent storage. It scans every upload with
107
107
  ClamAV by default and can explicitly delegate that boundary to a trusted upstream proxy.
108
108
 
109
- The project is licensed under [Apache-2.0](LICENSE). The source package version is `0.7.0`.
110
- The default public quickstart pins the matched published `0.6.4` backend and Next.js frontend pair
111
- to the immutable digests recorded in the release evidence. Candidate testing may override both
112
- image references together with another matched immutable pair.
109
+ The project is licensed under [Apache-2.0](LICENSE). The source package version is `0.7.2`.
110
+ The default public quickstart remains pinned to the matched published `0.7.1` backend and Next.js
111
+ frontend pair until 0.7.2 publication completes and records new receipts. Do not substitute
112
+ candidate or inferred digests; candidate testing may override both image references together with
113
+ another matched immutable pair.
113
114
 
114
115
  The [documentation index](docs/index.md) provides longer guides organized by role. You do not need
115
116
  to read them before trying the local profile.
@@ -148,6 +149,8 @@ and the explicit trusted-upstream and insecure SSH-tunnel modes with their restr
148
149
 
149
150
  ## Use and operate Markweave
150
151
 
152
+ - [Command-line interface](docs/cli.md)
153
+ - [Python package and optional dependencies](docs/python-distribution.md)
151
154
  - [Provision users from a startup CSV and require password renewal](docs/authentication.md#startup-csv-provisioning)
152
155
  - [Conversion interface](docs/conversion-ui.md)
153
156
  - [PowerPoint and Marp workflow](docs/powerpoint.md)
@@ -157,6 +160,10 @@ and the explicit trusted-upstream and insecure SSH-tunnel modes with their restr
157
160
  - [Jobs, cancellation, retention, and recovery](docs/jobs.md)
158
161
  - [Logs, metrics, audit, and readiness](docs/observability.md)
159
162
  - [Release and image update process](docs/releasing.md)
163
+ - [Upgrade and rollback guidance](docs/upgrading.md)
164
+ - [Changelog](CHANGELOG.md)
165
+ - [Security policy](SECURITY.md)
166
+ - [Support policy](SUPPORT.md)
160
167
 
161
168
  ## How it works
162
169
 
@@ -6,10 +6,11 @@ Markweave turns a Markdown file into DOCX, PDF, or an editable PowerPoint presen
6
6
  your Word and PowerPoint templates and completed jobs on local persistent storage. It scans every upload with
7
7
  ClamAV by default and can explicitly delegate that boundary to a trusted upstream proxy.
8
8
 
9
- The project is licensed under [Apache-2.0](LICENSE). The source package version is `0.7.0`.
10
- The default public quickstart pins the matched published `0.6.4` backend and Next.js frontend pair
11
- to the immutable digests recorded in the release evidence. Candidate testing may override both
12
- image references together with another matched immutable pair.
9
+ The project is licensed under [Apache-2.0](LICENSE). The source package version is `0.7.2`.
10
+ The default public quickstart remains pinned to the matched published `0.7.1` backend and Next.js
11
+ frontend pair until 0.7.2 publication completes and records new receipts. Do not substitute
12
+ candidate or inferred digests; candidate testing may override both image references together with
13
+ another matched immutable pair.
13
14
 
14
15
  The [documentation index](docs/index.md) provides longer guides organized by role. You do not need
15
16
  to read them before trying the local profile.
@@ -48,6 +49,8 @@ and the explicit trusted-upstream and insecure SSH-tunnel modes with their restr
48
49
 
49
50
  ## Use and operate Markweave
50
51
 
52
+ - [Command-line interface](docs/cli.md)
53
+ - [Python package and optional dependencies](docs/python-distribution.md)
51
54
  - [Provision users from a startup CSV and require password renewal](docs/authentication.md#startup-csv-provisioning)
52
55
  - [Conversion interface](docs/conversion-ui.md)
53
56
  - [PowerPoint and Marp workflow](docs/powerpoint.md)
@@ -57,6 +60,10 @@ and the explicit trusted-upstream and insecure SSH-tunnel modes with their restr
57
60
  - [Jobs, cancellation, retention, and recovery](docs/jobs.md)
58
61
  - [Logs, metrics, audit, and readiness](docs/observability.md)
59
62
  - [Release and image update process](docs/releasing.md)
63
+ - [Upgrade and rollback guidance](docs/upgrading.md)
64
+ - [Changelog](CHANGELOG.md)
65
+ - [Security policy](SECURITY.md)
66
+ - [Support policy](SUPPORT.md)
60
67
 
61
68
  ## How it works
62
69
 
@@ -1,11 +1,11 @@
1
1
  [build-system]
2
- requires = ["hatchling==1.32.0"]
2
+ requires = ["hatchling==1.32.3"]
3
3
  build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "markweave"
7
7
  # A version change merged to main is the sole automatic publication trigger.
8
- version = "0.7.0"
8
+ version = "0.7.2"
9
9
  description = "Secure Markdown-to-DOCX and PDF conversion service and HTTP CLI"
10
10
  readme = "README.md"
11
11
  license = "Apache-2.0"
@@ -79,7 +79,7 @@ Source = "https://github.com/Guillaume-Lombardo/simple-md-to-docx-converter"
79
79
  Support = "https://github.com/Guillaume-Lombardo/simple-md-to-docx-converter/discussions"
80
80
 
81
81
  [dependency-groups]
82
- build = ["hatchling==1.32.0"]
82
+ build = ["hatchling==1.32.3"]
83
83
  dev = [
84
84
  "grpcio-tools==1.76.0",
85
85
  "httpx>=0.28,<1",
@@ -99,7 +99,7 @@ attempt = 1
99
99
 
100
100
  [tool.uv]
101
101
  build-constraint-dependencies = [
102
- "hatchling==1.32.0",
102
+ "hatchling==1.32.3",
103
103
  "packaging==26.3",
104
104
  "pathspec==1.1.1",
105
105
  "pluggy==1.6.0",
@@ -192,6 +192,7 @@ show_missing = true
192
192
 
193
193
  [tool.mutmut]
194
194
  source_paths = ["src/markweave"]
195
+ also_copy = ["scripts"]
195
196
  only_mutate = [
196
197
  "src/markweave/auth/service.py",
197
198
  "src/markweave/conversion/archive.py",
@@ -201,11 +202,11 @@ only_mutate = [
201
202
  "src/markweave/observability.py",
202
203
  "src/markweave/persistence/jobs/claims.py",
203
204
  "src/markweave/retention.py",
205
+ "src/markweave/reversion_jobs/service.py",
204
206
  "src/markweave/storage.py",
205
207
  ]
206
208
  pytest_add_cli_args = [
207
- "-c",
208
- "/dev/null",
209
+ "--no-cov",
209
210
  "-q",
210
211
  "tests/unit/test_observability.py",
211
212
  "tests/unit/auth/test_service.py",
@@ -214,6 +215,7 @@ pytest_add_cli_args = [
214
215
  "tests/unit/jobs/test_job_service.py",
215
216
  "tests/unit/jobs/test_job_worker.py",
216
217
  "tests/unit/test_retention.py",
218
+ "tests/unit/reversions/test_reversion_service.py",
217
219
  "tests/unit/test_storage_adapters.py",
218
220
  "tests/integration/sqlite/test_sqlite_jobs.py",
219
221
  ]
@@ -0,0 +1,419 @@
1
+ """Crash-consistent authenticated SQLite inventory for managed broker units."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from typing import Any
6
+ from uuid import UUID
7
+
8
+ import markweave.broker.inventory_storage as _inventory_storage
9
+ from markweave.broker.errors import BrokerErrorCategory
10
+ from markweave.broker.models import (
11
+ EvidenceDigest,
12
+ ManagedUnit,
13
+ ManagedUnitState,
14
+ ReplayPosition,
15
+ RuntimeIncarnation,
16
+ RuntimeRecoveryBinding,
17
+ TerminationProof,
18
+ is_next_unit_state,
19
+ )
20
+ from markweave.broker.reconciliation_protocol import ReconciliationTombstone
21
+
22
+ _APPLICATION_ID = _inventory_storage._APPLICATION_ID
23
+ _SCHEMA_VERSION = _inventory_storage._SCHEMA_VERSION
24
+ _LEGACY_SCHEMA_VERSION = _inventory_storage._LEGACY_SCHEMA_VERSION
25
+ _MAC_VERSION = _inventory_storage._MAC_VERSION
26
+ _MINIMUM_HMAC_KEY_BYTES = _inventory_storage._MINIMUM_HMAC_KEY_BYTES
27
+ _SQLITE_FULL_SYNCHRONOUS = _inventory_storage._SQLITE_FULL_SYNCHRONOUS
28
+ _PRINCIPAL_COLUMNS = _inventory_storage._PRINCIPAL_COLUMNS
29
+ _MANIFEST_COLUMNS = _inventory_storage._MANIFEST_COLUMNS
30
+ _SELECT_PRINCIPALS = _inventory_storage._SELECT_PRINCIPALS
31
+ _SELECT_MANIFEST = _inventory_storage._SELECT_MANIFEST
32
+ _INSERT_MANIFEST = _inventory_storage._INSERT_MANIFEST
33
+ _UNIT_COLUMNS = _inventory_storage._UNIT_COLUMNS
34
+ _SELECT_UNITS = _inventory_storage._SELECT_UNITS
35
+ _INSERT_UNIT = _inventory_storage._INSERT_UNIT
36
+ _UPDATE_UNIT = _inventory_storage._UPDATE_UNIT
37
+ _SELECT_UNIT_BY = _inventory_storage._SELECT_UNIT_BY
38
+ _CREATE_PRINCIPALS = _inventory_storage._CREATE_PRINCIPALS
39
+ _CREATE_UNITS = _inventory_storage._CREATE_UNITS
40
+ _LEGACY_UNIT_COLUMNS = _inventory_storage._LEGACY_UNIT_COLUMNS
41
+ _LEGACY_SELECT_UNITS = _inventory_storage._LEGACY_SELECT_UNITS
42
+ _LEGACY_CREATE_UNITS = _inventory_storage._LEGACY_CREATE_UNITS
43
+ _CREATE_MANIFEST = _inventory_storage._CREATE_MANIFEST
44
+ _fail = _inventory_storage._fail
45
+ _inventory_fail = _inventory_storage._inventory_fail
46
+ _SQLiteInventoryStorage = _inventory_storage._SQLiteInventoryStorage
47
+
48
+
49
+ class SQLiteBrokerInventory(_SQLiteInventoryStorage):
50
+ """Bounded local inventory with a canonical HMAC over every durable row."""
51
+
52
+ def reserve(self, unit: ManagedUnit, replay: ReplayPosition) -> ManagedUnit:
53
+ """Reserve before runtime mutation, with exact-attempt replay idempotency."""
54
+
55
+ if (
56
+ type(unit) is not ManagedUnit
57
+ or type(replay) is not ReplayPosition
58
+ or unit.state is not ManagedUnitState.RESERVED
59
+ or unit.revision != 0
60
+ or unit.runtime_incarnation is not None
61
+ or unit.principal != replay.principal
62
+ or unit.create_sequence != replay.sequence
63
+ ):
64
+ _fail()
65
+ with self._transaction() as connection:
66
+ self._verify_all(connection)
67
+ principal_id = str(replay.principal.principal_id)
68
+ same_sequence = connection.execute(
69
+ _SELECT_UNITS + " WHERE principal_id = ? AND create_sequence = ?",
70
+ (principal_id, replay.sequence),
71
+ ).fetchone()
72
+ if same_sequence is not None:
73
+ existing = self._unit_from_row(same_sequence)
74
+ if existing.attempt_id == unit.attempt_id:
75
+ return existing
76
+ _fail(BrokerErrorCategory.REPLAY_REJECTED)
77
+ high_water = self._principal_high_water(connection, principal_id)
78
+ if replay.sequence <= high_water:
79
+ _fail(BrokerErrorCategory.REPLAY_REJECTED)
80
+ if (
81
+ connection.execute(
82
+ "SELECT 1 FROM units WHERE unit_id = ? OR attempt_id = ?",
83
+ (str(unit.unit_id), str(unit.attempt_id)),
84
+ ).fetchone()
85
+ is not None
86
+ ):
87
+ _fail(BrokerErrorCategory.REPLAY_REJECTED)
88
+ if (
89
+ self._scalar(connection, "SELECT COUNT(*) FROM units")
90
+ >= self._max_records
91
+ ):
92
+ _fail(BrokerErrorCategory.INVENTORY_FULL)
93
+ if high_water == 0 and (
94
+ self._scalar(connection, "SELECT COUNT(*) FROM principals")
95
+ >= self._max_records
96
+ ):
97
+ _fail(BrokerErrorCategory.INVENTORY_FULL)
98
+
99
+ self._store_principal(connection, principal_id, replay.sequence)
100
+ values: tuple[Any, ...] = (
101
+ str(unit.unit_id),
102
+ str(unit.attempt_id),
103
+ principal_id,
104
+ unit.create_sequence,
105
+ unit.policy_revision,
106
+ unit.policy_specification.value,
107
+ self._runtime_name(unit.unit_id),
108
+ unit.state.value,
109
+ unit.revision,
110
+ None,
111
+ None,
112
+ None,
113
+ None,
114
+ None,
115
+ None,
116
+ None,
117
+ None,
118
+ None,
119
+ 0,
120
+ _MAC_VERSION,
121
+ )
122
+ connection.execute(_INSERT_UNIT, (*values, self._mac("unit", values)))
123
+ self._refresh_manifest(connection)
124
+ row = self._select_unit(connection, "unit_id", str(unit.unit_id))
125
+ if row is None:
126
+ _inventory_fail()
127
+ return self._unit_from_row(row)
128
+
129
+ def create_sequence_high_watermark(self, principal_id: UUID) -> int:
130
+ if type(principal_id) is not UUID:
131
+ _fail()
132
+ with self._verified_connection() as connection:
133
+ return self._principal_high_water(connection, str(principal_id))
134
+
135
+ def reconciliation_page(
136
+ self, principal_id: UUID, after_create_sequence: int
137
+ ) -> tuple[int, ReconciliationTombstone | None]:
138
+ """Return only the authenticated principal's next retained proof."""
139
+
140
+ if (
141
+ type(principal_id) is not UUID
142
+ or type(after_create_sequence) is not int
143
+ or not 0 <= after_create_sequence <= (1 << 63) - 1
144
+ ):
145
+ _fail()
146
+ principal = str(principal_id)
147
+ with self._verified_connection() as connection:
148
+ high_water = self._principal_high_water(connection, principal)
149
+ row = connection.execute(
150
+ _SELECT_UNITS + " WHERE principal_id = ? AND create_sequence > ? "
151
+ "AND state = ? AND proof_id IS NOT NULL "
152
+ "ORDER BY create_sequence, unit_id LIMIT 1",
153
+ (principal, after_create_sequence, ManagedUnitState.REMOVED.value),
154
+ ).fetchone()
155
+ if row is None:
156
+ return high_water, None
157
+ unit = self._unit_from_row(row)
158
+ proof = self._proof_from_row(row)
159
+ return high_water, ReconciliationTombstone(
160
+ unit.create_sequence, unit.policy_specification, proof
161
+ )
162
+
163
+ def discard_reserved(self, unit_id: UUID, *, expected_revision: int) -> bool:
164
+ """Discard only a proven pre-create reservation and retain replay state."""
165
+
166
+ if (
167
+ type(unit_id) is not UUID
168
+ or type(expected_revision) is not int
169
+ or expected_revision < 0
170
+ ):
171
+ _fail()
172
+ with self._transaction() as connection:
173
+ self._verify_all(connection)
174
+ cursor = connection.execute(
175
+ "DELETE FROM units WHERE unit_id = ? AND state = ? AND revision = ?",
176
+ (
177
+ str(unit_id),
178
+ ManagedUnitState.RESERVED.value,
179
+ expected_revision,
180
+ ),
181
+ )
182
+ if cursor.rowcount == 1:
183
+ self._refresh_manifest(connection)
184
+ return cursor.rowcount == 1
185
+
186
+ def get(self, unit_id: UUID) -> ManagedUnit | None:
187
+ if type(unit_id) is not UUID:
188
+ _fail()
189
+ with self._verified_connection() as connection:
190
+ row = self._select_unit(connection, "unit_id", str(unit_id))
191
+ return None if row is None else self._unit_from_row(row)
192
+
193
+ def find_attempt(self, principal_id: UUID, attempt_id: UUID) -> ManagedUnit | None:
194
+ if type(principal_id) is not UUID or type(attempt_id) is not UUID:
195
+ _fail()
196
+ with self._verified_connection() as connection:
197
+ row = connection.execute(
198
+ _SELECT_UNITS + " WHERE principal_id = ? AND attempt_id = ?",
199
+ (str(principal_id), str(attempt_id)),
200
+ ).fetchone()
201
+ return None if row is None else self._unit_from_row(row)
202
+
203
+ def unacknowledged(self, *, limit: int) -> tuple[ManagedUnit, ...]:
204
+ """Return a bounded ordered sweep, including REMOVED proof tombstones."""
205
+
206
+ if type(limit) is not int or not 1 <= limit <= self._max_records:
207
+ _fail()
208
+ with self._verified_connection() as connection:
209
+ rows = connection.execute(
210
+ _SELECT_UNITS
211
+ + " ORDER BY principal_id, create_sequence, unit_id LIMIT ?",
212
+ (limit + 1,),
213
+ ).fetchall()
214
+ if len(rows) > limit:
215
+ _fail(BrokerErrorCategory.INVENTORY_FULL)
216
+ return tuple(self._unit_from_row(row) for row in rows)
217
+
218
+ def transition( # noqa: PLR0913 - protocol transition has explicit fenced fields
219
+ self,
220
+ unit_id: UUID,
221
+ *,
222
+ expected_revision: int,
223
+ target: ManagedUnitState,
224
+ evidence: EvidenceDigest | None = None,
225
+ runtime_incarnation: RuntimeIncarnation | None = None,
226
+ runtime_recovery: RuntimeRecoveryBinding | None = None,
227
+ ) -> ManagedUnit:
228
+ """Commit one legal pre-removal transition with revision fencing."""
229
+
230
+ if (
231
+ type(unit_id) is not UUID
232
+ or type(expected_revision) is not int
233
+ or expected_revision < 0
234
+ or type(target) is not ManagedUnitState
235
+ or target is ManagedUnitState.REMOVED
236
+ ):
237
+ _fail()
238
+ with self._transaction() as connection:
239
+ self._verify_all(connection)
240
+ row = self._select_unit(connection, "unit_id", str(unit_id))
241
+ if row is None:
242
+ _fail()
243
+ current = self._unit_from_row(row)
244
+ if current.revision != expected_revision or not is_next_unit_state(
245
+ current.state, target
246
+ ):
247
+ _fail(BrokerErrorCategory.REPLAY_REJECTED)
248
+ self._validate_transition_payload(
249
+ target, evidence, runtime_incarnation, runtime_recovery
250
+ )
251
+ updated = list(row[:-1])
252
+ updated[_UNIT_COLUMNS.index("state")] = target.value
253
+ updated[_UNIT_COLUMNS.index("revision")] = expected_revision + 1
254
+ if runtime_incarnation is not None:
255
+ updated[_UNIT_COLUMNS.index("incarnation_id")] = str(
256
+ runtime_incarnation.incarnation_id
257
+ )
258
+ updated[_UNIT_COLUMNS.index("specification")] = (
259
+ runtime_incarnation.specification.value
260
+ )
261
+ if runtime_recovery is not None:
262
+ updated[_UNIT_COLUMNS.index("recovery_backend")] = (
263
+ runtime_recovery.backend
264
+ )
265
+ updated[_UNIT_COLUMNS.index("recovery_version")] = (
266
+ runtime_recovery.schema_version
267
+ )
268
+ updated[_UNIT_COLUMNS.index("recovery_payload")] = (
269
+ runtime_recovery.payload
270
+ )
271
+ evidence_column = self._evidence_column(target)
272
+ if evidence_column is not None and evidence is not None:
273
+ updated[_UNIT_COLUMNS.index(evidence_column)] = evidence.value
274
+ return self._write_updated_unit(
275
+ connection, updated, unit_id, expected_revision
276
+ )
277
+
278
+ def mark_removed(
279
+ self,
280
+ unit_id: UUID,
281
+ *,
282
+ expected_revision: int,
283
+ removal_evidence: EvidenceDigest,
284
+ proof: TerminationProof,
285
+ ) -> ManagedUnit:
286
+ """Atomically persist REMOVED, positive evidence, and the proof tombstone."""
287
+
288
+ if (
289
+ type(unit_id) is not UUID
290
+ or type(expected_revision) is not int
291
+ or expected_revision < 0
292
+ or type(removal_evidence) is not EvidenceDigest
293
+ or type(proof) is not TerminationProof
294
+ ):
295
+ _fail()
296
+ with self._transaction() as connection:
297
+ self._verify_all(connection)
298
+ row = self._select_unit(connection, "unit_id", str(unit_id))
299
+ if row is None:
300
+ _fail()
301
+ unit = self._unit_from_row(row)
302
+ if (
303
+ unit.state is not ManagedUnitState.EMPTY_CONFIRMED
304
+ or unit.revision != expected_revision
305
+ or unit.unit_id != proof.unit_id
306
+ or unit.attempt_id != proof.attempt_id
307
+ or unit.principal != proof.principal
308
+ or unit.policy_revision != proof.policy_revision
309
+ or unit.exit_evidence != proof.exit_evidence
310
+ or unit.empty_evidence != proof.empty_evidence
311
+ or removal_evidence != proof.removal_evidence
312
+ ):
313
+ _fail()
314
+ updated = list(row[:-1])
315
+ updated[_UNIT_COLUMNS.index("state")] = ManagedUnitState.REMOVED.value
316
+ updated[_UNIT_COLUMNS.index("revision")] = expected_revision + 1
317
+ updated[_UNIT_COLUMNS.index("removal_evidence")] = removal_evidence.value
318
+ updated[_UNIT_COLUMNS.index("proof_id")] = str(proof.proof_id)
319
+ return self._write_updated_unit(
320
+ connection, updated, unit_id, expected_revision
321
+ )
322
+
323
+ def get_proof(self, unit_id: UUID) -> TerminationProof | None:
324
+ if type(unit_id) is not UUID:
325
+ _fail()
326
+ with self._verified_connection() as connection:
327
+ row = self._select_unit(connection, "unit_id", str(unit_id))
328
+ if row is None or row[_UNIT_COLUMNS.index("proof_id")] is None:
329
+ return None
330
+ return self._proof_from_row(row)
331
+
332
+ def acknowledge(
333
+ self,
334
+ principal_id: UUID,
335
+ attempt_id: UUID,
336
+ unit_id: UUID,
337
+ proof_id: UUID,
338
+ ) -> bool:
339
+ """Delete only the exact principal/attempt/unit/proof-bound tombstone."""
340
+
341
+ if any(
342
+ type(value) is not UUID
343
+ for value in (principal_id, attempt_id, unit_id, proof_id)
344
+ ):
345
+ _fail()
346
+ with self._transaction() as connection:
347
+ self._verify_all(connection)
348
+ row = self._select_unit(connection, "unit_id", str(unit_id))
349
+ if row is None:
350
+ return True
351
+ unit = self._unit_from_row(row)
352
+ if unit.state is not ManagedUnitState.REMOVED:
353
+ return False
354
+ proof = self._proof_from_row(row)
355
+ if (
356
+ proof.principal.principal_id != principal_id
357
+ or proof.attempt_id != attempt_id
358
+ or proof.proof_id != proof_id
359
+ ):
360
+ return False
361
+ connection.execute("DELETE FROM units WHERE unit_id = ?", (str(unit_id),))
362
+ self._refresh_manifest(connection)
363
+ return True
364
+
365
+ def mark_acknowledged(
366
+ self,
367
+ principal_id: UUID,
368
+ attempt_id: UUID,
369
+ unit_id: UUID,
370
+ proof_id: UUID,
371
+ ) -> ManagedUnit | None:
372
+ """Durably mark an exact retained proof acknowledged, idempotently."""
373
+
374
+ if any(
375
+ type(value) is not UUID
376
+ for value in (principal_id, attempt_id, unit_id, proof_id)
377
+ ):
378
+ _fail()
379
+ with self._transaction() as connection:
380
+ self._verify_all(connection)
381
+ row = self._select_unit(connection, "unit_id", str(unit_id))
382
+ if row is None:
383
+ return None
384
+ unit = self._unit_from_row(row)
385
+ if unit.state is not ManagedUnitState.REMOVED:
386
+ return None
387
+ proof = self._proof_from_row(row)
388
+ if (
389
+ proof.principal.principal_id != principal_id
390
+ or proof.attempt_id != attempt_id
391
+ or proof.proof_id != proof_id
392
+ ):
393
+ return None
394
+ if unit.proof_acknowledged:
395
+ return unit
396
+ updated = list(row[:-1])
397
+ updated[_UNIT_COLUMNS.index("revision")] = unit.revision + 1
398
+ updated[_UNIT_COLUMNS.index("proof_acknowledged")] = 1
399
+ return self._write_updated_unit(connection, updated, unit_id, unit.revision)
400
+
401
+ def discard_acknowledged(self, unit_id: UUID, *, expected_revision: int) -> bool:
402
+ """Delete only an exact durably acknowledged proof tombstone."""
403
+
404
+ if (
405
+ type(unit_id) is not UUID
406
+ or type(expected_revision) is not int
407
+ or expected_revision < 0
408
+ ):
409
+ _fail()
410
+ with self._transaction() as connection:
411
+ self._verify_all(connection)
412
+ cursor = connection.execute(
413
+ "DELETE FROM units WHERE unit_id = ? AND state = ? "
414
+ "AND proof_acknowledged = 1 AND revision = ?",
415
+ (str(unit_id), ManagedUnitState.REMOVED.value, expected_revision),
416
+ )
417
+ if cursor.rowcount == 1:
418
+ self._refresh_manifest(connection)
419
+ return cursor.rowcount == 1