evlet 0.4.4__tar.gz → 0.4.6__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 (371) hide show
  1. {evlet-0.4.4 → evlet-0.4.6}/CHANGELOG.md +165 -0
  2. {evlet-0.4.4/evlet.egg-info → evlet-0.4.6}/PKG-INFO +7 -9
  3. {evlet-0.4.4 → evlet-0.4.6}/README.md +6 -5
  4. {evlet-0.4.4 → evlet-0.4.6}/docs/amendment-v2.md +8 -15
  5. {evlet-0.4.4 → evlet-0.4.6}/docs/api-stability.md +36 -30
  6. {evlet-0.4.4 → evlet-0.4.6}/docs/app-upgrades.md +6 -1
  7. {evlet-0.4.4 → evlet-0.4.6}/docs/architecture.md +26 -29
  8. {evlet-0.4.4 → evlet-0.4.6}/docs/business-capabilities.md +9 -9
  9. {evlet-0.4.4 → evlet-0.4.6}/docs/cli.md +2 -4
  10. {evlet-0.4.4 → evlet-0.4.6}/docs/connector.md +3 -3
  11. {evlet-0.4.4 → evlet-0.4.6}/docs/controls.md +8 -10
  12. evlet-0.4.6/docs/database-adapters.md +211 -0
  13. evlet-0.4.6/docs/document-lifecycle.md +100 -0
  14. {evlet-0.4.4 → evlet-0.4.6}/docs/effects.md +61 -84
  15. {evlet-0.4.4 → evlet-0.4.6}/docs/finite-calculations.md +16 -18
  16. {evlet-0.4.4 → evlet-0.4.6}/docs/jobs-realtime.md +5 -7
  17. {evlet-0.4.4 → evlet-0.4.6}/docs/journal.md +33 -29
  18. {evlet-0.4.4 → evlet-0.4.6}/docs/ledger.md +14 -24
  19. {evlet-0.4.4 → evlet-0.4.6}/docs/meaning.md +2 -5
  20. {evlet-0.4.4 → evlet-0.4.6}/docs/measures.md +4 -6
  21. {evlet-0.4.4 → evlet-0.4.6}/docs/model-engine.md +46 -52
  22. {evlet-0.4.4 → evlet-0.4.6}/docs/performance.md +56 -111
  23. {evlet-0.4.4 → evlet-0.4.6}/docs/production-operations.md +5 -19
  24. {evlet-0.4.4 → evlet-0.4.6}/docs/routing.md +1 -2
  25. {evlet-0.4.4 → evlet-0.4.6}/docs/sequences.md +19 -31
  26. {evlet-0.4.4 → evlet-0.4.6}/docs/settings.md +1 -1
  27. {evlet-0.4.4 → evlet-0.4.6}/docs/slips.md +3 -2
  28. evlet-0.4.6/docs/states-actions.md +657 -0
  29. {evlet-0.4.4 → evlet-0.4.6}/docs/tools.md +15 -14
  30. {evlet-0.4.4 → evlet-0.4.6}/docs/ui-framework.md +8 -10
  31. {evlet-0.4.4 → evlet-0.4.6}/docs/ui.md +11 -15
  32. {evlet-0.4.4 → evlet-0.4.6}/evlet/__init__.py +8 -9
  33. evlet-0.4.6/evlet/adapter.py +254 -0
  34. {evlet-0.4.4 → evlet-0.4.6}/evlet/app.py +6 -4
  35. {evlet-0.4.4 → evlet-0.4.6}/evlet/assistants.py +82 -59
  36. {evlet-0.4.4 → evlet-0.4.6}/evlet/audit.py +27 -43
  37. {evlet-0.4.4 → evlet-0.4.6}/evlet/auth.py +171 -132
  38. {evlet-0.4.4 → evlet-0.4.6}/evlet/business.py +84 -88
  39. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/backup.py +7 -36
  40. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/ids.py +1 -1
  41. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/install.py +6 -29
  42. evlet-0.4.6/evlet/cli/journal.py +27 -0
  43. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/main.py +2 -1
  44. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/restart.py +5 -5
  45. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/serve.py +10 -9
  46. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/site.py +6 -7
  47. {evlet-0.4.4 → evlet-0.4.6}/evlet/connectors.py +25 -14
  48. {evlet-0.4.4 → evlet-0.4.6}/evlet/controls.py +159 -179
  49. {evlet-0.4.4 → evlet-0.4.6}/evlet/controls_system.py +14 -18
  50. {evlet-0.4.4 → evlet-0.4.6}/evlet/currencies.py +26 -25
  51. {evlet-0.4.4 → evlet-0.4.6}/evlet/customization.py +50 -73
  52. {evlet-0.4.4 → evlet-0.4.6}/evlet/database.py +109 -116
  53. {evlet-0.4.4 → evlet-0.4.6}/evlet/declarations.py +0 -41
  54. {evlet-0.4.4 → evlet-0.4.6}/evlet/devlink.py +20 -12
  55. {evlet-0.4.4 → evlet-0.4.6}/evlet/documents.py +159 -264
  56. {evlet-0.4.4 → evlet-0.4.6}/evlet/effects.py +53 -86
  57. {evlet-0.4.4 → evlet-0.4.6}/evlet/eva.py +249 -199
  58. {evlet-0.4.4 → evlet-0.4.6}/evlet/events.py +21 -13
  59. {evlet-0.4.4 → evlet-0.4.6}/evlet/fields.py +8 -82
  60. {evlet-0.4.4 → evlet-0.4.6}/evlet/forms.py +14 -3
  61. evlet-0.4.6/evlet/framework.py +254 -0
  62. evlet-0.4.4/evlet/states.py → evlet-0.4.6/evlet/guards.py +20 -306
  63. {evlet-0.4.4 → evlet-0.4.6}/evlet/identity.py +10 -31
  64. {evlet-0.4.4 → evlet-0.4.6}/evlet/images.py +24 -31
  65. {evlet-0.4.4 → evlet-0.4.6}/evlet/indexes.py +4 -17
  66. {evlet-0.4.4 → evlet-0.4.6}/evlet/instances.py +33 -22
  67. {evlet-0.4.4 → evlet-0.4.6}/evlet/jobs.py +142 -99
  68. {evlet-0.4.4 → evlet-0.4.6}/evlet/journal.py +121 -161
  69. {evlet-0.4.4 → evlet-0.4.6}/evlet/ledger.py +19 -67
  70. {evlet-0.4.4 → evlet-0.4.6}/evlet/mailboxes.py +71 -61
  71. {evlet-0.4.4 → evlet-0.4.6}/evlet/meaning.py +0 -2
  72. {evlet-0.4.4 → evlet-0.4.6}/evlet/measures.py +128 -128
  73. {evlet-0.4.4 → evlet-0.4.6}/evlet/mentions.py +38 -27
  74. {evlet-0.4.4 → evlet-0.4.6}/evlet/migrations.py +198 -294
  75. {evlet-0.4.4 → evlet-0.4.6}/evlet/models.py +33 -68
  76. {evlet-0.4.4 → evlet-0.4.6}/evlet/naming.py +11 -20
  77. {evlet-0.4.4 → evlet-0.4.6}/evlet/object_storage.py +18 -6
  78. {evlet-0.4.4 → evlet-0.4.6}/evlet/packages.py +1 -1
  79. {evlet-0.4.4 → evlet-0.4.6}/evlet/periods.py +11 -12
  80. {evlet-0.4.4 → evlet-0.4.6}/evlet/permissions.py +31 -55
  81. {evlet-0.4.4 → evlet-0.4.6}/evlet/printing.py +23 -11
  82. evlet-0.4.6/evlet/qb.py +643 -0
  83. {evlet-0.4.4 → evlet-0.4.6}/evlet/query.py +48 -52
  84. {evlet-0.4.4 → evlet-0.4.6}/evlet/routing.py +2 -2
  85. {evlet-0.4.4 → evlet-0.4.6}/evlet/secrets.py +27 -26
  86. {evlet-0.4.4 → evlet-0.4.6}/evlet/sections.py +16 -18
  87. {evlet-0.4.4 → evlet-0.4.6}/evlet/sequences.py +43 -61
  88. {evlet-0.4.4 → evlet-0.4.6}/evlet/services.py +5 -4
  89. {evlet-0.4.4 → evlet-0.4.6}/evlet/settings.py +137 -97
  90. {evlet-0.4.4 → evlet-0.4.6}/evlet/slips.py +5 -5
  91. evlet-0.4.6/evlet/sqlite.py +538 -0
  92. evlet-0.4.6/evlet/statemanager.py +1449 -0
  93. {evlet-0.4.4 → evlet-0.4.6}/evlet/storage.py +31 -13
  94. {evlet-0.4.4 → evlet-0.4.6}/evlet/tenancy.py +42 -30
  95. {evlet-0.4.4 → evlet-0.4.6}/evlet/tools.py +91 -94
  96. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/metadata.py +4 -4
  97. evlet-0.4.4/evlet/ui/static/assets/ai-Dxes-Y5x.js → evlet-0.4.6/evlet/ui/static/assets/ai-D6v6uzJl.js +1 -1
  98. evlet-0.4.4/evlet/ui/static/assets/app-DV2K7-Sc.js → evlet-0.4.6/evlet/ui/static/assets/app-C37OLm9O.js +1 -1
  99. evlet-0.4.4/evlet/ui/static/assets/consent-CQhXzR61.js → evlet-0.4.6/evlet/ui/static/assets/consent-CodBrk72.js +1 -1
  100. evlet-0.4.4/evlet/ui/static/assets/email-BQhe29I0.js → evlet-0.4.6/evlet/ui/static/assets/email-DxkXuU5k.js +1 -1
  101. evlet-0.4.4/evlet/ui/static/assets/index-UqEST1u4.css → evlet-0.4.6/evlet/ui/static/assets/index-BUi88rTP.css +1 -1
  102. evlet-0.4.6/evlet/ui/static/assets/index-Cnv8Z1nq.js +948 -0
  103. evlet-0.4.4/evlet/ui/static/assets/keys-Czr55W8K.js → evlet-0.4.6/evlet/ui/static/assets/keys-BjRw2MrO.js +1 -1
  104. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/index.html +2 -2
  105. {evlet-0.4.4 → evlet-0.4.6}/evlet/unsaved.py +46 -37
  106. {evlet-0.4.4 → evlet-0.4.6}/evlet/writes.py +127 -13
  107. {evlet-0.4.4 → evlet-0.4.6/evlet.egg-info}/PKG-INFO +7 -9
  108. {evlet-0.4.4 → evlet-0.4.6}/evlet.egg-info/SOURCES.txt +13 -15
  109. {evlet-0.4.4 → evlet-0.4.6}/evlet.egg-info/requires.txt +0 -4
  110. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/app.py +1 -18
  111. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/migrate.py +8 -10
  112. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/models.py +20 -13
  113. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/slips.py +3 -1
  114. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/team.py +1 -1
  115. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/api.ts +5 -5
  116. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/client.ts +3 -44
  117. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/list-page.ts +27 -20
  118. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/meta.ts +24 -48
  119. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/record-page.ts +50 -144
  120. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/screens.css +0 -5
  121. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/record.ts +3 -3
  122. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/schema.ts +4 -5
  123. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/doc.ts +11 -14
  124. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/library.ts +1 -1
  125. {evlet-0.4.4 → evlet-0.4.6}/pyproject.toml +1 -2
  126. evlet-0.4.4/docs/document-lifecycle.md +0 -216
  127. evlet-0.4.4/docs/lifecycle-specification.md +0 -549
  128. evlet-0.4.4/docs/postgresql.md +0 -166
  129. evlet-0.4.4/docs/states-actions.md +0 -772
  130. evlet-0.4.4/evlet/cli/journal.py +0 -42
  131. evlet-0.4.4/evlet/corrections.py +0 -690
  132. evlet-0.4.4/evlet/framework.py +0 -178
  133. evlet-0.4.4/evlet/lifecycle.py +0 -460
  134. evlet-0.4.4/evlet/postgres.py +0 -283
  135. evlet-0.4.4/evlet/postgres_schema.py +0 -343
  136. evlet-0.4.4/evlet/ui/static/assets/index-BZFjJUtE.js +0 -960
  137. evlet-0.4.4/frontend/src/evlet/app/revisions.ts +0 -77
  138. {evlet-0.4.4 → evlet-0.4.6}/LICENSE +0 -0
  139. {evlet-0.4.4 → evlet-0.4.6}/MANIFEST.in +0 -0
  140. {evlet-0.4.4 → evlet-0.4.6}/build_support.py +0 -0
  141. {evlet-0.4.4 → evlet-0.4.6}/docs/application-generation.md +0 -0
  142. {evlet-0.4.4 → evlet-0.4.6}/docs/customizing.md +0 -0
  143. {evlet-0.4.4 → evlet-0.4.6}/docs/eva.md +0 -0
  144. {evlet-0.4.4 → evlet-0.4.6}/docs/getting-started.md +0 -0
  145. {evlet-0.4.4 → evlet-0.4.6}/docs/printing.md +0 -0
  146. {evlet-0.4.4 → evlet-0.4.6}/docs/reports.md +0 -0
  147. {evlet-0.4.4 → evlet-0.4.6}/docs/tenancy-deployment.md +0 -0
  148. {evlet-0.4.4 → evlet-0.4.6}/evlet/__main__.py +0 -0
  149. {evlet-0.4.4 → evlet-0.4.6}/evlet/builds.py +0 -0
  150. {evlet-0.4.4 → evlet-0.4.6}/evlet/calc.py +0 -0
  151. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/__init__.py +0 -0
  152. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/app.py +0 -0
  153. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/connector.py +0 -0
  154. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/devlink.py +0 -0
  155. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/docs.py +0 -0
  156. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/effects.py +0 -0
  157. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/hosts.py +0 -0
  158. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/instance.py +0 -0
  159. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/jobs.py +0 -0
  160. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/ledger.py +0 -0
  161. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/playground.py +0 -0
  162. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/project.py +0 -0
  163. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/proxy.py +0 -0
  164. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/setup.py +0 -0
  165. {evlet-0.4.4 → evlet-0.4.6}/evlet/cli/upgrade.py +0 -0
  166. {evlet-0.4.4 → evlet-0.4.6}/evlet/connector.py +0 -0
  167. {evlet-0.4.4 → evlet-0.4.6}/evlet/controls_export.py +0 -0
  168. {evlet-0.4.4 → evlet-0.4.6}/evlet/deployment.py +0 -0
  169. {evlet-0.4.4 → evlet-0.4.6}/evlet/discovery.py +0 -0
  170. {evlet-0.4.4 → evlet-0.4.6}/evlet/expressions.py +0 -0
  171. {evlet-0.4.4 → evlet-0.4.6}/evlet/mcp.py +0 -0
  172. {evlet-0.4.4 → evlet-0.4.6}/evlet/py.typed +0 -0
  173. {evlet-0.4.4 → evlet-0.4.6}/evlet/reactivity.py +0 -0
  174. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/__init__.py +0 -0
  175. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/print/fonts/NotoSans-Bold.woff2 +0 -0
  176. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/print/fonts/NotoSans-OFL.txt +0 -0
  177. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/print/fonts/NotoSans-Regular.woff2 +0 -0
  178. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/print/fonts/NotoSansArabic-Bold.woff2 +0 -0
  179. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/print/fonts/NotoSansArabic-OFL.txt +0 -0
  180. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/print/fonts/NotoSansArabic-Regular.woff2 +0 -0
  181. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/.gitignore.tpl +0 -0
  182. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/README.md.tpl +0 -0
  183. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/__app__/__init__.py.tpl +0 -0
  184. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/__app__/actions/__init__.py.tpl +0 -0
  185. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/__app__/hooks.py.tpl +0 -0
  186. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/__app__/migrations/__init__.py.tpl +0 -0
  187. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/__app__/models/__init__.py.tpl +0 -0
  188. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/__app__/permissions.py.tpl +0 -0
  189. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/pyproject.toml.tpl +0 -0
  190. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app/tests/test_models.py.tpl +0 -0
  191. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app_flat/.gitignore.tpl +0 -0
  192. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app_flat/README.md.tpl +0 -0
  193. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app_flat/__init__.py.tpl +0 -0
  194. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app_flat/models/__init__.py.tpl +0 -0
  195. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app_flat/models/item.py.tpl +0 -0
  196. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app_flat/pyproject.toml.tpl +0 -0
  197. {evlet-0.4.4 → evlet-0.4.6}/evlet/resources/templates/app_flat/setup.py.tpl +0 -0
  198. {evlet-0.4.4 → evlet-0.4.6}/evlet/richtext.py +0 -0
  199. {evlet-0.4.4 → evlet-0.4.6}/evlet/serverless.py +0 -0
  200. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/__init__.py +0 -0
  201. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/application.py +0 -0
  202. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/routes.py +0 -0
  203. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/serving.py +0 -0
  204. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/IBMPlexSans-OFL.txt +0 -0
  205. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/JetBrainsMono-Medium-3S3k2nMz.woff2 +0 -0
  206. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/JetBrainsMono-OFL.txt +0 -0
  207. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/JetBrainsMono-Regular-BQaDgvhP.woff2 +0 -0
  208. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/app-0SduO6OB.css +0 -0
  209. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/evlet-icon-blue.svg +0 -0
  210. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/evlet-logo-primary.svg +0 -0
  211. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/evlet-logo-white.svg +0 -0
  212. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-400-italic-CZTNEAuW.woff2 +0 -0
  213. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-400-normal-CDDApCn2.woff2 +0 -0
  214. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-500-normal-6ng42L7E.woff2 +0 -0
  215. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-600-normal-CuJfVYMP.woff2 +0 -0
  216. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-700-normal-Bxkt5Cjx.woff2 +0 -0
  217. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-400-italic-Du9zzoL2.woff2 +0 -0
  218. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-400-normal-C5H60-Va.woff2 +0 -0
  219. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-500-normal-DakdToA3.woff2 +0 -0
  220. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-600-normal-DOrvGEcy.woff2 +0 -0
  221. {evlet-0.4.4 → evlet-0.4.6}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-700-normal-aMgXseD4.woff2 +0 -0
  222. {evlet-0.4.4 → evlet-0.4.6}/evlet/workspaces.py +0 -0
  223. {evlet-0.4.4 → evlet-0.4.6}/evlet.egg-info/dependency_links.txt +0 -0
  224. {evlet-0.4.4 → evlet-0.4.6}/evlet.egg-info/entry_points.txt +0 -0
  225. {evlet-0.4.4 → evlet-0.4.6}/evlet.egg-info/top_level.txt +0 -0
  226. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/items.py +0 -0
  227. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/manage.py +0 -0
  228. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/portal/index.html +0 -0
  229. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/portal/portal.css +0 -0
  230. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/portal/portal.js +0 -0
  231. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/prints.py +0 -0
  232. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/reports.py +0 -0
  233. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/settings.py +0 -0
  234. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/site/404.html +0 -0
  235. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/site/about/index.html +0 -0
  236. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/site/index.html +0 -0
  237. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/site/robots.txt +0 -0
  238. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/site/site.css +0 -0
  239. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/site/sitemap.xml +0 -0
  240. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/tenants.py +0 -0
  241. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/worker.py +0 -0
  242. {evlet-0.4.4 → evlet-0.4.6}/examples/playground/workspaces.py +0 -0
  243. {evlet-0.4.4 → evlet-0.4.6}/frontend/.node-version +0 -0
  244. {evlet-0.4.4 → evlet-0.4.6}/frontend/.npmrc +0 -0
  245. {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/IBMPlexSans-OFL.txt +0 -0
  246. {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/JetBrainsMono-Medium.woff2 +0 -0
  247. {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/JetBrainsMono-OFL.txt +0 -0
  248. {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/JetBrainsMono-Regular.woff2 +0 -0
  249. {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-400-italic.woff2 +0 -0
  250. {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-400-normal.woff2 +0 -0
  251. {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-500-normal.woff2 +0 -0
  252. {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-600-normal.woff2 +0 -0
  253. {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-700-normal.woff2 +0 -0
  254. {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-ext-400-italic.woff2 +0 -0
  255. {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-ext-400-normal.woff2 +0 -0
  256. {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-ext-500-normal.woff2 +0 -0
  257. {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-ext-600-normal.woff2 +0 -0
  258. {evlet-0.4.4 → evlet-0.4.6}/frontend/fonts/ibm-plex-sans-latin-ext-700-normal.woff2 +0 -0
  259. {evlet-0.4.4 → evlet-0.4.6}/frontend/index.html +0 -0
  260. {evlet-0.4.4 → evlet-0.4.6}/frontend/package-lock.json +0 -0
  261. {evlet-0.4.4 → evlet-0.4.6}/frontend/package.json +0 -0
  262. {evlet-0.4.4 → evlet-0.4.6}/frontend/public/assets/evlet-icon-blue.svg +0 -0
  263. {evlet-0.4.4 → evlet-0.4.6}/frontend/public/assets/evlet-logo-primary.svg +0 -0
  264. {evlet-0.4.4 → evlet-0.4.6}/frontend/public/assets/evlet-logo-white.svg +0 -0
  265. {evlet-0.4.4 → evlet-0.4.6}/frontend/scripts/bench-ui.mjs +0 -0
  266. {evlet-0.4.4 → evlet-0.4.6}/frontend/scripts/dev-proxy.mjs +0 -0
  267. {evlet-0.4.4 → evlet-0.4.6}/frontend/scripts/dev-proxy.test.mjs +0 -0
  268. {evlet-0.4.4 → evlet-0.4.6}/frontend/scripts/install-ui.mjs +0 -0
  269. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/app.ts +0 -0
  270. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/composer.ts +0 -0
  271. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/config.ts +0 -0
  272. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/context.ts +0 -0
  273. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/docs.ts +0 -0
  274. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/duplicate.ts +0 -0
  275. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/explorer.ts +0 -0
  276. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/filters.ts +0 -0
  277. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/inbox.ts +0 -0
  278. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/last-page.ts +0 -0
  279. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/login.ts +0 -0
  280. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/main.ts +0 -0
  281. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/nav-icons.ts +0 -0
  282. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/palette.ts +0 -0
  283. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/prefs.ts +0 -0
  284. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/recents.ts +0 -0
  285. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/record-blocks.ts +0 -0
  286. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/record-compact.ts +0 -0
  287. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/related-data.ts +0 -0
  288. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/report-page.ts +0 -0
  289. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/settings.css +0 -0
  290. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/settings.ts +0 -0
  291. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/shell.ts +0 -0
  292. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/shortcuts.ts +0 -0
  293. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/slips.ts +0 -0
  294. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/unsaved-bar.ts +0 -0
  295. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/unsaved.ts +0 -0
  296. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/workspace-editor.ts +0 -0
  297. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/app/workspaces.ts +0 -0
  298. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/access.ts +0 -0
  299. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/ai.ts +0 -0
  300. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/app.ts +0 -0
  301. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/client.ts +0 -0
  302. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/connections.ts +0 -0
  303. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/controls.css +0 -0
  304. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/currencies.ts +0 -0
  305. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/drafts.ts +0 -0
  306. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/eva.ts +0 -0
  307. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/keys.ts +0 -0
  308. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/log.ts +0 -0
  309. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/models.ts +0 -0
  310. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/naming.ts +0 -0
  311. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/people.ts +0 -0
  312. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/periods.ts +0 -0
  313. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/prints.ts +0 -0
  314. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/system.ts +0 -0
  315. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/controls/unsaved.ts +0 -0
  316. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/dev.ts +0 -0
  317. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/dom.ts +0 -0
  318. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/eva/chat.ts +0 -0
  319. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/eva/client.ts +0 -0
  320. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/eva/eva.css +0 -0
  321. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/eva/tasks.ts +0 -0
  322. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ids.ts +0 -0
  323. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/changes.ts +0 -0
  324. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/finite.ts +0 -0
  325. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/format.ts +0 -0
  326. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/links.ts +0 -0
  327. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/session.ts +0 -0
  328. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/model/unsaved.ts +0 -0
  329. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/reactive.ts +0 -0
  330. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/editor.ts +0 -0
  331. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/history.ts +0 -0
  332. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/html.ts +0 -0
  333. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/images.ts +0 -0
  334. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/model.ts +0 -0
  335. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/ops.ts +0 -0
  336. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/render.ts +0 -0
  337. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/richtext/richtext.css +0 -0
  338. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/router.ts +0 -0
  339. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/settings/ai.ts +0 -0
  340. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/settings/consent.ts +0 -0
  341. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/settings/email.ts +0 -0
  342. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/settings/keys.ts +0 -0
  343. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/autofocus.ts +0 -0
  344. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/base.ts +0 -0
  345. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/catalog.json +0 -0
  346. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/chart.ts +0 -0
  347. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/childtable.ts +0 -0
  348. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/core.ts +0 -0
  349. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/dateparse.ts +0 -0
  350. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/draglist.ts +0 -0
  351. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/explain.ts +0 -0
  352. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/fields.ts +0 -0
  353. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/fold.ts +0 -0
  354. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/icon-data.ts +0 -0
  355. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/index.ts +0 -0
  356. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/inline.ts +0 -0
  357. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/kinds.ts +0 -0
  358. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/layers.ts +0 -0
  359. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/list.ts +0 -0
  360. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/money.ts +0 -0
  361. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/pickers.ts +0 -0
  362. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/shortcuts.ts +0 -0
  363. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/split.ts +0 -0
  364. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/styles.css +0 -0
  365. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/table.ts +0 -0
  366. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/theme.ts +0 -0
  367. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/time.ts +0 -0
  368. {evlet-0.4.4 → evlet-0.4.6}/frontend/src/evlet/ui/tooltip.ts +0 -0
  369. {evlet-0.4.4 → evlet-0.4.6}/frontend/tsconfig.json +0 -0
  370. {evlet-0.4.4 → evlet-0.4.6}/frontend/vite.config.js +0 -0
  371. {evlet-0.4.4 → evlet-0.4.6}/setup.cfg +0 -0
@@ -4,6 +4,171 @@ Evlet is pre-1.0 and not production ready. From 0.3, a public name or argument t
4
4
  removed or changed keeps working with a `DeprecationWarning` for at least one minor release
5
5
  first ([docs/api-stability.md](docs/api-stability.md)). The notes below say what to change.
6
6
 
7
+ ## 0.4.6 (13-11-2026)
8
+
9
+ ### Upgrading to 0.4.6
10
+
11
+ - **One state manager replaces the old lifecycle.** `evlet/statemanager.py` holds a document's
12
+ State: its steps, the rules between them and its hooks. The old forms are removed outright, with
13
+ no aliases and no deprecation release, by owner decision. A model that still declares
14
+ `before_close`, `changed`, `check_lifecycle` or an undecorated `validate()`, or sets
15
+ `confirmable` or `track_changes`, fails when the class is created with a message naming the
16
+ replacement. See [docs/states-actions.md](docs/states-actions.md) and
17
+ [docs/document-lifecycle.md](docs/document-lifecycle.md).
18
+ - **Apps that use `confirmable` must move to a State.** Declare draft, a locked release step and a
19
+ final cancelled step with rules, as the Lifecycle Playground does. Framework step
20
+ `0011_state_manager` then converts the rows of `evlet_document_lifecycle` and
21
+ `evlet_document_revisions` and backfills v0 for records already in a release step.
22
+ - **Rewriting a State.** `State(("draft", "issued"), moves=(Move("draft", "issued", "Issue"),),
23
+ locked=("issued",), final=(...), voidable=(...))` becomes `State(State.Step("draft"),
24
+ State.Step("issued", lock=True), rules=(State.Rule("draft", "issued", "Issue"),))`. Routes,
25
+ `context.move()` and `_moves` now name a rule by its key, which defaults to `<from>_to_<to>`;
26
+ give each rule `key=` to keep the old move URLs (`key="issued"`). `roles=` becomes `by=`;
27
+ `system=True` becomes `by=()`. A `colors=` map moves onto each step's `color=`.
28
+ - **Hooks.** `Move(..., run="m")` becomes `@state("to")` on `m`; `before_close` becomes
29
+ `@state.exit(...)` or `@validate`; `changed()` becomes `@state(...)` or a job queued from a hook;
30
+ `Model.validate()` (also on Dialogs, Slips and Reports) and `@validate.confirm/.cancel` become
31
+ `@validate`; `@action.confirm/.cancel` become `@state(...)` and `@state.exit(...)`.
32
+ - **Corrections.** Void is a final step reached by a rule, usually with `remark="required"`.
33
+ Revise and unpost become a rule back (Reopen); repost becomes moving into the posting state
34
+ again. `Rule` operations `void`, `revise`, `unpost`, `repost`, `confirm`, `cancel` and `reopen`
35
+ are gone: a rule's `by` and update permission decide a move. Remove them from `permissions`,
36
+ Controls overrides and `ApiScope.actions`.
37
+ - **Renamed.** `editable_when_locked=True` is now `versioned=False`.
38
+ - **Database.** A Select may become a State, and step colours may change, with `AlterField`
39
+ alone; no data moves. The Playground's `0020_project_state` does this for Project.
40
+
41
+ ### Removed
42
+
43
+ - `Move`, and `State(choices, moves=, locked=, final=, voidable=, cancelled=)`.
44
+ - `confirmable`, `track_changes`, `lifecycle_labels`, `Meta.revisable` with `revises` and
45
+ `revised_by`, `Naming(assign_on="confirm")` (use the state's name).
46
+ - The routes `/confirm`, `/cancel`, `/reopen`, `/void`, `/revise`, `/unpost`, `/repost`,
47
+ `/revisions`, `/snapshot` and the lifecycle `/diff`, with their `Context` methods, detail keys
48
+ (`_lifecycle`, `_lifecycle_actions`, `_void`, `_revise`, `_unpost`, `_repost`) and schema keys
49
+ (`lifecycle`, `voidable`, `revisable`, `unpostable`, `state.states`, `state.moves`,
50
+ `state.locked`, `state.final`, `state.voidable`, `state.cancelled`).
51
+ - `context.document()` and `BoundDocument`, `context.record_approval()`,
52
+ `context.lifecycle_execution`, `context.reference_effect()`, `check_lifecycle`, `before_close`,
53
+ `changed()` and `Change`, `@validate.confirm/.cancel`, `@action.confirm/.cancel`,
54
+ `Model.validate()`, and the record page's Revisions part (`revisions` in `Meta.panel`).
55
+ - `evlet/lifecycle.py` and `evlet/corrections.py`. `evlet/states.py` is now `evlet/guards.py`
56
+ (internal). `docs/lifecycle-specification.md`.
57
+ - Unpost and repost audit rows, and the unpost dependents check (it returns with restore).
58
+
59
+ ### Added
60
+
61
+ - `State(*steps, rules=(), default=, show=)` with `State.Step(key, label, color=, lock=,
62
+ release=, final=)` and `State.Rule(from_, to, label, key=, by=, when=, remark=, ask=, primary=,
63
+ reject=)`. `by` takes role names and `F("field")` user fields. `State.Remark(mode, label=,
64
+ required_when=)` asks for a remark.
65
+ - Releases: entering a `release=True` step, or `POST /api/{model}/{id}/release` (`release`
66
+ permission), makes a numbered version when the content changed; `@release` runs then. Snapshots
67
+ are lazy and drift is detected. `_version` in details; `GET .../versions`, `.../versions/{n}`
68
+ and `.../versions/{a}/diff/{b|current}`. Framework step `0011_state_manager` converts
69
+ confirmable lifecycle and revision rows and backfills v0 for records already in a release step.
70
+ - Restore: `POST /api/{model}/{id}/restore` with `{version, remark}` (`restore` permission, unlocked
71
+ steps only) writes a release's content back as a new change, re-creating deleted rows under their
72
+ ids; it is refused while other records link to the document.
73
+ - Rules on an instance: Controls overrides of kind `state` (a step's label and colour) and `rule`
74
+ (change or turn off a code rule by key, or add one, with conditions as expression text), checked
75
+ on save as a whole rule set, compiled once per config version; orphans are ignored and reported.
76
+ - Approval levels: `State.Rule(..., levels=(State.Level(by=, when=, pending=), ...),
77
+ self_approve=)` moves once the last level that applies is approved; each approval is an
78
+ `approved` journal entry. `reject=True` rules are for the waiting level's approvers.
79
+ `_moves` carries `level`, `pending` and `can_approve`; `GET /api/{model}?awaiting=me` lists what
80
+ the user may approve now.
81
+ - The hooks `@validate`, `@state(...)`, `@state.exit(...)` and `@release`, with `self.is_new` and `self.before` inside them.
82
+ - `POST /api/{model}/{id}/moves/{key}` with `{"remark": ..., ...values}`, and
83
+ `context.move(model, id, key, *, remark=None, **values)`. A missing required remark is 422
84
+ `{"remark": "<Label> needs a remark"}`; an unknown key is 404 `Move not found`.
85
+ - `_moves` items carry `key`, `primary` and `remark`; the schema's `state` entry has `steps` and
86
+ `rules`.
87
+ - `evlet_journal` gains nullable `rule`, `remark`, `level`, `base` and `rules_version` columns. A
88
+ `moved` entry records the rule key and the remark, shown to readers of the State. The hash covers
89
+ these only when set, so existing chains verify unchanged.
90
+ - The Playground's Project has Start and Complete rules; Complete checks in `@state("done")` that
91
+ every task is done.
92
+
93
+ ### Changed
94
+
95
+ - `Effect(on=...)` must name a `lock=True, release=True` step that is not the default. Rows post
96
+ when the record enters `on` and are reversed when any rule leaves it, before `@state.exit`
97
+ hooks; `reverse` is required whenever a rule leaves `on`. `Recompute` keeps the saved results of
98
+ records with live postings and of records that posted and are in a final state.
99
+ - The `change_state` tool takes `{model, id, rule, remark, values}`. A move into a final step is in
100
+ the destructive confirmation group for MCP clients and Eva write confirmations.
101
+ - The record page asks for a rule's remark in the move dialog and reads a cancelled look from a
102
+ final step coloured `rose`, never from state names.
103
+
104
+ ## 0.4.5 (13-11-2026)
105
+
106
+ ### Upgrading to 0.4.5
107
+
108
+ - **Sites on PostgreSQL: stay on 0.4.4.** 0.4.5 runs on SQLite only, and `evlet upgrade` and app
109
+ pins such as `evlet>=0.4.3,<0.5` pick it up on their own. Before upgrading a site whose app builds
110
+ a `PostgreSQLDatabase`, pin `evlet==0.4.4` in that app (or in the environment that runs it) and
111
+ keep it there until its data has moved to SQLite. On 0.4.5, `from evlet import PostgreSQLDatabase`,
112
+ a PostgreSQL DSN given to `Database(...)` and `Instance(database="postgresql")` each stop at
113
+ startup with a message that names 0.4.4 as the last version supporting PostgreSQL. SQLite sites
114
+ upgrade as usual.
115
+ - **PostgreSQL is removed.** SQLite, with the four-file layout and fair write line-up from 0.4.3,
116
+ is the only built-in database. `evlet.PostgreSQLDatabase`, the `evlet.postgres` and
117
+ `evlet.postgres_schema` modules, the `evlet[postgres]` extra, `requirements-postgres.lock`,
118
+ `docs/postgresql.md`, and the `--postgres` option of `scripts/benchmark.py` and
119
+ `scripts/benchmark_hierarchy.py` are gone. This removal skips the usual deprecation release:
120
+ it is an owner decision for 0.4.5.
121
+ - **Apps and tools that import `evlet.postgres` or `PostgreSQLDatabase` must stop.** Remove the
122
+ import and the code path that builds a PostgreSQL database. For example, an app CLI option such
123
+ as Finance's `EVLET_FINANCE_POSTGRES_DSN` must be dropped, along with any `psycopg` dependency
124
+ the app added for it. The Playground no longer reads `EVLET_POSTGRES_DSN`.
125
+ - **SQLite instances need no migration.** Stored data, schema and migration checksums are
126
+ unchanged. A test opens a database written by 0.4.3 and checks that nothing in it changes.
127
+ - **Moving data off PostgreSQL.** An app that ran on PostgreSQL in 0.4 should export its records
128
+ (for example through the HTTP API) into a new SQLite instance before
129
+ upgrading, or stay on 0.4.4 until a PostgreSQL adapter exists again.
130
+
131
+ ### Changed
132
+
133
+ - **A query builder in front of the database.** Framework code describes what it reads and writes
134
+ with `evlet/qb.py` (select, insert, update, delete, upserts, conditions, joins, aggregates,
135
+ windows) and runs it with `connection.run(statement)`. A dialect compiles the statements to SQL;
136
+ SQLite (`evlet/sqlite.py`) is the one dialect. Schema changes go through named connection methods
137
+ (`inspect`, `create_table`, `set_required`, `ensure_table`, `make_append_only`, `guard_id` and a
138
+ few more), and migrations compare models against one neutral table shape. PostgreSQL, MariaDB or
139
+ another database can be added later as a dialect: a compiler, a connection class and a `Database`
140
+ subclass, passed explicitly where the app builds its database. See
141
+ [docs/database-adapters.md](docs/database-adapters.md). The query builder and the adapter
142
+ interface are provisional.
143
+ - **Every framework module is on the query builder:** the record API, queries, migrations, row
144
+ scopes and record helpers, accounts and sign-in, Controls and customization, jobs, events, mail,
145
+ connectors and tools, Eva and assistants, reports (measures), printing, storage and the rest.
146
+ Framework tables are `TableDefinition`s created with `connection.ensure_table`. The instance
147
+ tools (backup, restore, install, `evlet journal verify`, the tenant catalog, the Administrator
148
+ checks of `evlet serve` and `evlet site`) open SQLite files with small file tools in
149
+ `evlet/writes.py` and run query builder statements on the connection they get.
150
+ `tests/test_query_builder_boundary.py` fails on SQL text anywhere outside the dialect.
151
+ Query plans and the number of statements per operation are unchanged.
152
+ - `Column(referenced_column=...)`: a framework table's reference may point at a key other than
153
+ `id` (the tenant catalog's domains point at tenants by slug).
154
+ - `database.logs.add(store, statement)` (the batched log writes) takes a query builder statement
155
+ instead of SQL text and values.
156
+ - **Conformance tests.** `tests/test_database_adapter.py` is the checklist a new dialect must pass:
157
+ every query builder statement and condition, value round trips, exact amounts, foreign keys, ids,
158
+ the table shape, every schema change, framework table rules, append-only tables, the id guard,
159
+ error mapping, busy writers, savepoints and rollback, and a database written by 0.4.3.
160
+ - Internal helpers changed shape. They lost their `postgres` argument (for example
161
+ `ledger.add_triggers`, `identity.add_id_guard`, `identity.check_ids`, `naming.add_columns`,
162
+ `audit.add_columns`, `journal.ensure_table`, framework step functions).
163
+ `Database.columns(connection, table)` is now `connection.columns(table)`.
164
+ `SqlQuery.where()` and `ordering()` return query builder objects, and `Policy.scope()` returns a row
165
+ scope as a condition. The text forms (`SqlQuery.where_sql`, `ordering_sql`, `reference_sql`,
166
+ `Policy.scope_sql`) and `evlet.sqlite.compile_condition` are removed. These are internal names; apps
167
+ that used them build a statement with `evlet.qb` and pass the condition to `.where(...)`.
168
+ - New SQLite databases write the CREATE statements of framework tables and the append-only guards
169
+ of `evlet_journal`, `evlet_audit` and `evlet_document_revisions` in a slightly different text with
170
+ the same rules. Existing databases keep theirs.
171
+
7
172
  ## 0.4.4 (13-11-2026)
8
173
 
9
174
  ### Added
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: evlet
3
- Version: 0.4.4
3
+ Version: 0.4.6
4
4
  Summary: A small Python application framework with SQLite and a neutral UI schema
5
5
  License-Expression: MIT
6
6
  Project-URL: Homepage, https://github.com/evlet-io/evlet
@@ -12,9 +12,6 @@ License-File: LICENSE
12
12
  Requires-Dist: cryptography<52,>=44.0.1
13
13
  Requires-Dist: packaging<27,>=24
14
14
  Requires-Dist: uvicorn<1,>=0.34
15
- Provides-Extra: postgres
16
- Requires-Dist: psycopg[binary]<4,>=3.3.6; extra == "postgres"
17
- Requires-Dist: psycopg-pool<4,>=3.3.3; extra == "postgres"
18
15
  Provides-Extra: s3
19
16
  Requires-Dist: boto3<2,>=1.43.119; extra == "s3"
20
17
  Provides-Extra: print
@@ -30,8 +27,9 @@ Dynamic: license-file
30
27
  # Evlet
31
28
 
32
29
  Evlet is a Python application framework. Define your models in Python and get
33
- forms, lists, permissions and APIs in the browser. SQLite is the default;
34
- PostgreSQL is optional.
30
+ forms, lists, permissions and APIs in the browser. It runs on SQLite, with no
31
+ database server to set up. Another database can be added later through one adapter
32
+ boundary ([database adapters](docs/database-adapters.md)).
35
33
 
36
34
  ## Install, create a site, open it
37
35
 
@@ -140,10 +138,10 @@ else ([controls.md](docs/controls.md#security-rules)).
140
138
 
141
139
  ## Optional capabilities
142
140
 
143
- PostgreSQL, S3 and PDF printing are available as `evlet[postgres]`, `evlet[s3]` and
144
- `evlet[print]` ([print designs](docs/printing.md)). The existing
141
+ S3 and PDF printing are available as `evlet[s3]` and `evlet[print]`
142
+ ([print designs](docs/printing.md)). The existing
145
143
  [tenant deployment](docs/tenancy-deployment.md), [jobs and live updates](docs/jobs-realtime.md),
146
- [connector](docs/connector.md), [Tool Engine](docs/tools.md), [Eva](docs/eva.md), [PostgreSQL](docs/postgresql.md) and
144
+ [connector](docs/connector.md), [Tool Engine](docs/tools.md), [Eva](docs/eva.md), [database adapters](docs/database-adapters.md) and
147
145
  [operations](docs/production-operations.md) guides describe their limits.
148
146
  No database server, Redis, Docker or worker is required for a local SQLite app.
149
147
 
@@ -1,8 +1,9 @@
1
1
  # Evlet
2
2
 
3
3
  Evlet is a Python application framework. Define your models in Python and get
4
- forms, lists, permissions and APIs in the browser. SQLite is the default;
5
- PostgreSQL is optional.
4
+ forms, lists, permissions and APIs in the browser. It runs on SQLite, with no
5
+ database server to set up. Another database can be added later through one adapter
6
+ boundary ([database adapters](docs/database-adapters.md)).
6
7
 
7
8
  ## Install, create a site, open it
8
9
 
@@ -111,10 +112,10 @@ else ([controls.md](docs/controls.md#security-rules)).
111
112
 
112
113
  ## Optional capabilities
113
114
 
114
- PostgreSQL, S3 and PDF printing are available as `evlet[postgres]`, `evlet[s3]` and
115
- `evlet[print]` ([print designs](docs/printing.md)). The existing
115
+ S3 and PDF printing are available as `evlet[s3]` and `evlet[print]`
116
+ ([print designs](docs/printing.md)). The existing
116
117
  [tenant deployment](docs/tenancy-deployment.md), [jobs and live updates](docs/jobs-realtime.md),
117
- [connector](docs/connector.md), [Tool Engine](docs/tools.md), [Eva](docs/eva.md), [PostgreSQL](docs/postgresql.md) and
118
+ [connector](docs/connector.md), [Tool Engine](docs/tools.md), [Eva](docs/eva.md), [database adapters](docs/database-adapters.md) and
118
119
  [operations](docs/production-operations.md) guides describe their limits.
119
120
  No database server, Redis, Docker or worker is required for a local SQLite app.
120
121
 
@@ -211,37 +211,30 @@ from masquerading as authoritative totals. Legacy permissions remain unchanged.
211
211
 
212
212
  After merging inputs, the operation runs an explicit action if requested,
213
213
  settles authoritative values, validates children/parent, persists deltas and
214
- calls optional `changed(change)` before commit. `validate()` is the sole model
215
- validation convention. Actions use `@action`, explicit allowed roles and typed
214
+ commits. `@validate` methods are the model validation convention, and `@state`
215
+ hooks react to moves ([states-actions.md](states-actions.md#hooks)). Actions use `@action`, explicit allowed roles and typed
216
216
  scalar arguments (`str/int/bool/float`); the native UI presents those inputs.
217
217
  Protect status fields with `read_only=True` when an ordinary PATCH must not
218
218
  bypass an action. Declaring `@action` makes a model a document: its PATCH,
219
219
  actions and deletion then require `If-Match`, and it gains draft evaluation.
220
220
  Legacy `Action` registrations on a document model keep their legacy route and
221
- also require `If-Match`; their trusted handlers bypass document settlement and
222
- `validate()`.
221
+ also require `If-Match`; their trusted handlers bypass document settlement.
223
222
  A legacy `ChildTable` under a document parent is saved through the document
224
223
  route, which sets the parent link itself and ignores a client-supplied one.
225
224
 
226
- `Change` contains operation, actor, immutable before/after snapshots, changed
227
- stored fields and added/updated/removed/reordered child information. Deletion
228
- uses `operation="delete"`, a before snapshot and `after=None`. A true no-op,
229
- virtual query refresh or related-only action does not fire a source reaction.
230
- The source draft is frozen during its reaction; resaving it and cascades deeper
231
- than 16 operations fail. A reaction error rolls back the source, related writes
232
- and queued intents. External I/O does not belong inside a reaction.
225
+ 0.4.6 removed `changed(change)` and the `Change` object; a model that declares
226
+ `changed` fails when the class is created.
233
227
 
234
228
  ## Dialogs and reports
235
229
 
236
230
  A nested `Dialog` exposes one source action without a second empty method.
237
- Implement `load(source)`, optional `validate()` and `submit(source)`. Fields and
231
+ Implement `load(source)`, optional `@validate` checks and `submit(source)`. Fields and
238
232
  tables are transient, with no business SQL tables. `parent` in a dialog row is
239
233
  the dialog; `source` is the authorized persisted source snapshot. Load/evaluate
240
234
  never save it. Submit requires its current revision and a scoped idempotency
241
235
  key. A retry returns the stored outcome only for identical input and an actor
242
236
  who still has source access. Conflicting input under the same key fails.
243
- The operation uses the existing serialized write transaction, including the
244
- PostgreSQL advisory transaction lock.
237
+ The operation uses the existing serialized write transaction.
245
238
 
246
239
  A `Report` defines title, roles, fields, typed `Column`s, `autorun` and `run()`.
247
240
  Set `roles = ('admin', 'editor')` to name the roles that may see and run it.
@@ -324,7 +317,7 @@ existing regressions:
324
317
  | Definitions, expressions, children, permissions | `test_documents.py`, `test_document_boundaries.py`, shared document fixtures/vectors, existing business/security suites |
325
318
  | Dialogs, reports, APIs, cron | `test_forms_services.py`, reference app end-to-end test, native document/report tests, existing queue tests |
326
319
  | Build failure, generation pinning, recovery | `test_builds.py`, existing install/backup/recovery and reload tests |
327
- | Adapter compatibility | Full Python suite, PostgreSQL regression suite plus declarative document rollback/revision test |
320
+ | Adapter compatibility | Full Python suite, adapter conformance tests plus declarative document rollback/revision test |
328
321
  | UI and distribution | Native frontend suite/typecheck/build, installed-wheel HTTP smoke, clean flat-app wheel/sdist/editable imports |
329
322
 
330
323
  Run `python -m scripts.generate_document_fixtures` only after an intentional
@@ -7,16 +7,27 @@ production ready, but the rules below hold from 0.3 on.
7
7
  ## The app-facing surface
8
8
 
9
9
  - **Root exports.** Every name in `evlet.__all__`: fields, `Model`, `Child`, `Registry`,
10
- migrations, permissions (`Policy`, `Rule`, `own_customer`, `SCOPES`), lifecycle
11
- (`State`, `Move`, `action`, `validate`), form sections and record layouts (`Section`,
10
+ migrations, permissions (`Policy`, `Rule`, `own_customer`, `SCOPES`), the state manager
11
+ (`State` with `State.Step`, `State.Rule` and `State.Remark`, the hooks `validate`, `state`,
12
+ `state.exit` and `release`, and `action`), form sections and record layouts (`Section`,
12
13
  `Main`, `Html`, and `Related` and `Chart` as layout blocks), slips, measures, settings, connectors,
13
14
  storage, jobs, routing and the application classes. Import them from `evlet`, not from the
14
15
  module that defines them. `AppDefinition(views=())` stays accepted for apps scaffolded
15
16
  before 0.4; a non-empty `views` or a `ui` registry is refused.
16
17
  - **Field keywords.** The keywords every field takes (`required`, `default`, `label`,
17
18
  `help_text`, `visible_if` and the rest), which are defined once on the field base class.
18
- - **Lifecycle decorators.** `validate.confirm`, `validate.cancel`, `action.confirm` and
19
- `action.cancel`, plus `Model.to_dict` and `Model.validate`.
19
+ - **States and moves.** `State(*steps, rules=(), default=, show=)`, `State.Step(key, label,
20
+ color=, lock=, release=, final=)` and `State.Rule(from_, to, label, key=, by=, when=, remark=,
21
+ ask=, primary=, reject=)` with rule keys, `POST /api/{model}/{id}/moves/{key}` with its body,
22
+ checks and answers, `context.move(model, id, key, *, remark=None, **values)`, `_moves`,
23
+ `_locked`, the schema's `state` entry, the Journal's `rule` and `remark`, `versioned=False`,
24
+ and `by=()` for rules only the application makes, with its 403 `<label> is made by the
25
+ application only` ([states-actions.md](states-actions.md)). `State.Level` and `self_approve=`
26
+ are declared but not public until approval levels land (0.4.6, PR 2). 0.4.6 removed `Move`,
27
+ `confirmable`, `track_changes`, `Meta.revisable`, void, revise, unpost and repost,
28
+ `before_close`, `changed`, `Model.validate()` and the lifecycle decorators without a
29
+ deprecation release, by owner decision ([CHANGELOG.md](../CHANGELOG.md)).
30
+ - **Records.** `Model.to_dict`.
20
31
  - **No `evlet.ui` page names.** The Python page API was removed in 0.4 without a
21
32
  deprecation release, by owner decision, since the browser never rendered it
22
33
  ([CHANGELOG.md](../CHANGELOG.md)). `evlet.ui.metadata` stays internal.
@@ -64,7 +75,7 @@ production ready, but the rules below hold from 0.3 on.
64
75
  entry (left out when there are none). A broken unique entry raises `ValidationError` with the
65
76
  entry's fields as keys (HTTP 422). Ledger entries may name `id`. `Session.reserve_ids(model,
66
77
  count)` and an `id` in `insert_many` rows for reserved ids. A raw update or delete that an
67
- append-only table refuses raises `ConflictError` on SQLite and PostgreSQL
78
+ append-only table refuses raises `ConflictError`
68
79
  ([model-engine.md](model-engine.md#composite-and-unique-indexes), [ledger.md](ledger.md)).
69
80
 
70
81
  - **Aggregates in a transaction.** `Session.aggregate(model, *, measures, group_by=(), filters=None,
@@ -80,22 +91,20 @@ production ready, but the rules below hold from 0.3 on.
80
91
  ([model-engine.md](model-engine.md#long-in-lists-in-trusted-code)). HTTP, `Context`, Eva,
81
92
  tools, MCP and Connector keep 100 values per `in` and 500 groups per aggregate.
82
93
 
83
- - **The transaction session in handlers.** `self.context.session` in a Move's `run` method or an
84
- `@action` handler: the move or action's own `evlet.Session`, open only while the method runs and
85
- refused (`AccessError`, 403) on every other context
86
- ([states-actions.md](states-actions.md#the-transaction-session-in-run-methods-and-actions)).
94
+ - **The transaction session in handlers.** `self.context.session` in a `@state` or `@state.exit`
95
+ hook or an `@action` handler: the move or action's own `evlet.Session`, open only while the
96
+ method runs and refused (`AccessError`, 403) on every other context
97
+ ([states-actions.md](states-actions.md#the-transaction-session-in-hooks-and-actions)).
87
98
 
88
- - **Derived values and closing checks.** `Meta.derives` with `derive(self)` (field, Table and
89
- `"table.field"` row field names), and
90
- `before_close(self, to)` on a model: when they run, what `to` is, the read-only
91
- `self.context.session` they get (`get`, `list`, `count`, `related`, `aggregate`), the
99
+ - **Derived values.** `Meta.derives` with `derive(self)` (field, Table and
100
+ `"table.field"` row field names): when it runs, the read-only
101
+ `self.context.session` it gets (`get`, `list`, `count`, `related`, `aggregate`), the
92
102
  `DERIVED_FIELD_WRITE` refusal (keyed `table.field` for a row field), the `read_only` flag on
93
103
  a derived field, a derived row field and a derived `children` entry in `/api/schema`, `self.model`
94
- (the model class) on the drafts the hooks get, and trusted `session.create`, `update` and
104
+ (the model class) on the drafts it gets, and trusted `session.create`, `update` and
95
105
  `delete` of a model with `derive()` or of its rows settling the saved document, with
96
106
  `children=` on its create and update (a bare
97
- `Database` refuses them; `maintenance()` skips it) ([model-engine.md](model-engine.md#derived-values),
98
- [states-actions.md](states-actions.md#before-a-record-closes)).
107
+ `Database` refuses them; `maintenance()` skips it) ([model-engine.md](model-engine.md#derived-values)).
99
108
 
100
109
  - **Measure trends and colours.** `trend=` and `color=` on `Count`, `CountDistinct`, `Sum`, `Min` and
101
110
  `Max` in `Meta.measures`: a trend is a Date field name or `(field, grain, points)` with grain `day`,
@@ -140,11 +149,7 @@ production ready, but the rules below hold from 0.3 on.
140
149
  done), `progress` in `GET /api/_jobs/<id>`, and `evlet jobs list`
141
150
  ([jobs-realtime.md](jobs-realtime.md#progress-and-long-jobs)).
142
151
 
143
- - **System moves and jobs that act.** `Move(..., system=True)` (a boolean; refused together with
144
- `roles=`), its 403 `<label> is made by the application only` to every HTTP caller and its absence
145
- from `_moves` and the schema's `state.moves`
146
- ([states-actions.md](states-actions.md#system-moves)).
147
- `JobContext.business(tx, *, user=None, system=None, role=None)` with the identities and checks
152
+ - **Jobs that act.** `JobContext.business(tx, *, user=None, system=None, role=None)` with the identities and checks
148
153
  in [jobs-realtime.md](jobs-realtime.md#a-jobs-business-context), `User.system`, the Journal's
149
154
  `via` for a system name, `Context.enqueue(task, payload, *, key=None, target=None)` queuing after
150
155
  commit, `_job` on an action's detail, and `JobQueue.wake()` and `JobQueue.wait(timeout)`
@@ -160,12 +165,9 @@ production ready, but the rules below hold from 0.3 on.
160
165
  someone who opens Controls without the flag ([controls.md](controls.md#workspaces)).
161
166
 
162
167
  - **How a state shows.** `State(..., show=...)` takes `"badge"` (the default), `"bar"` or `"none"`,
163
- and `Select(..., colors=...)` maps choices to badge colours. The values and the default are
164
- public ([states-actions.md](states-actions.md#how-a-state-and-a-status-show)).
165
-
166
- - **Cancelled states.** `State(..., cancelled=...)`, a list of final state names (empty by
167
- default), the rule that `"void"` on a voidable State counts as cancelled, and `cancelled` in the
168
- schema's `state` entry ([states-actions.md](states-actions.md#cancelled-states)).
168
+ and `State.Step(color=...)` and `Select(..., colors=...)` take the badge colours `blue`, `green`,
169
+ `amber`, `rose`, `violet`, `teal` and `slate`. The values and the default are public
170
+ ([states-actions.md](states-actions.md#how-a-state-and-a-status-show)).
169
171
 
170
172
  - **Currency display.** `set_currency_display(application, value, *, actor='cli')`, the setting
171
173
  `display.currencies` with its entry form (`symbol`, `image`, `position`, `space`, `tint`,
@@ -216,10 +218,14 @@ with `-W error::DeprecationWarning` before they move to the next series.
216
218
  Apps must not depend on these. They can change in any release without a deprecation:
217
219
 
218
220
  - Modules and names that are not listed above, even when they can be imported, such as
219
- `evlet.lifecycle`, `evlet.database` helpers, `evlet.cli`, `evlet.controls_*`,
220
- `evlet.postgres_schema` and `evlet.ui.metadata`.
221
+ `evlet.statemanager` and `evlet.guards` (import from `evlet`), `evlet.database` helpers, `evlet.cli`, `evlet.controls_*`, `evlet.sqlite`
222
+ and `evlet.ui.metadata`.
223
+ - The query builder (`evlet.qb`) and the database adapter interface (`evlet.adapter`, the
224
+ connection methods and the `Database` methods listed in [database-adapters.md](database-adapters.md)).
225
+ They are documented for framework work and for people who write a dialect, and are provisional:
226
+ they may change in a minor release, with a `CHANGELOG.md` note.
221
227
  - Names that start with an underscore, and dunder attributes such as `__fields__`.
222
- - Methods of exported classes that the app guides do not document, such as `Policy.scope_sql`
228
+ - Methods of exported classes that the app guides do not document, such as `Policy.scope`
223
229
  or `Registry.plan_for`.
224
230
  - The stored layout of tables Evlet manages (`evlet_*`), and the browser framework in
225
231
  `frontend/`.
@@ -102,6 +102,12 @@ trigger that refuses an id change to every model table ([model-engine.md](model-
102
102
  Currency amount is stored at 6 places; `evlet migrate` moves the amounts before any app migration runs
103
103
  ([model-engine.md](model-engine.md#decimal-places-per-currency)). `0010_split_files` moves sign-in sessions, the
104
104
  tool-call log and Eva into their own SQLite files next to the database (see From 0.4.2 to 0.4.3 below).
105
+ `0011_state_manager` adds the journal's `rule`, `remark`, `level`, `base` and `rules_version` columns
106
+ (old entries keep their values and their hashes), creates `evlet_releases`, lets `evlet_overrides` take the
107
+ kinds `state` and `rule`, turns confirmable
108
+ revisions into releases and lifecycle states into State values (it refuses, naming the models, when
109
+ a model has no State with those steps), and gives every record already in a release step a v0
110
+ release ([states-actions.md](states-actions.md#releases-and-versions)).
105
111
  Steps never run while an instance is served.
106
112
  `evlet migrate acme --plan` lists the pending ones without writing anything. If a step fails, the staged copy is
107
113
  discarded and the database and lock stay as they were; restore the earlier Evlet
@@ -173,7 +179,6 @@ The four SQLite files:
173
179
  own next run with `context.follow_up(tx, payload, run_at=...)`, in the same transaction and
174
180
  with the same identity ([jobs-realtime.md](jobs-realtime.md#follow-up-runs)). An app that
175
181
  polls with an every-minute schedule can use a follow-up run instead.
176
- - PostgreSQL instances keep one database; the step only records itself there.
177
182
 
178
183
  ### From 0.4.1 to 0.4.2
179
184
 
@@ -34,8 +34,9 @@ SolidJS by Evlet's own UI framework.
34
34
  referenced record's 63-bit id and uses a real database foreign key; JSON and URLs
35
35
  carry the 13-character text form of the id. Schema creation is
36
36
  supported; migrations are not. Changing a model requires a new disposable
37
- development database until migrations exist. A future PostgreSQL adapter can
38
- implement the same small operations without introducing a generic ORM now.
37
+ development database until migrations exist. Another database can implement
38
+ the same small operations without introducing a generic ORM
39
+ ([database adapters](database-adapters.md)).
39
40
  3. **Portable ASGI, with Uvicorn only as a development server.** The core
40
41
  implements HTTP and lifespan directly. It exposes health, versioned metadata,
41
42
  and explicitly registered models' create/list/detail operations. Database work
@@ -253,35 +254,32 @@ approval responsibilities, limits, and the application development workflow.
253
254
 
254
255
  ## Deferred work
255
256
 
256
- WebSockets, arbitrary schema conversions, PostgreSQL tenant-catalog integration,
257
- parallel write scheduling, and production-target validation remain later work.
257
+ WebSockets, arbitrary schema conversions, parallel write scheduling, and
258
+ production-target validation remain later work.
258
259
 
259
260
 
260
261
  ## Milestone 8 decisions
261
262
 
262
- PostgreSQL is an optional driver-backed Database implementation. Models, validation,
263
- query compilation, authentication, permissions, and business handlers stay shared.
264
- A small private connection adapter binds parameters and adapts framework-generated
265
- SQL; native schema introspection and migrations live separately. A bounded optional
266
- Psycopg pool reuses connections and resets session state after each operation. It is not a general
267
- SQL translation layer. The base wheel imports without Psycopg installed.
268
-
269
- An explicit transaction advisory lock preserves the existing serialized-write
270
- contract across PostgreSQL processes, including business actions and queue claims.
271
- Read pages use repeatable-read snapshots. This initial adapter does not provide
272
- parallel writes within one database, and the operator-managed SQLite tenant catalog
273
- is not extended to remote credentials or PostgreSQL provisioning.
274
-
275
263
  Private storage, events, and jobs check their owning database through a shared
276
264
  boundary instead of assuming a SQLite file. Session revocation/expiry and login
277
265
  counter cleanup now have explicit indexes. Repeated security headers are rejected
278
- before authentication. Nullable ordering is explicit on both adapters.
266
+ before authentication. Nullable ordering is explicit.
279
267
 
280
268
  Reproducible benchmarks use synthetic large ledgers and real databases, with
281
269
  continuous authenticated ASGI readers, paced invoice transactions, SQL reports,
282
270
  index comparisons, and measured resource/bundle sizes. They do not model a complete
283
- accounting system or prove deployment capacity. See [performance](performance.md),
284
- [PostgreSQL](postgresql.md), and [operations](production-operations.md).
271
+ accounting system or prove deployment capacity. See [performance](performance.md)
272
+ and [operations](production-operations.md).
273
+
274
+ ## Database adapters
275
+
276
+ SQLite is the one database Evlet ships with. Framework code reads and writes through the
277
+ query builder (`evlet/qb.py`): plain statement objects run with `connection.run(...)`. The SQLite
278
+ dialect (`evlet/sqlite.py`) compiles them to SQL and implements the connection interface in
279
+ `evlet/adapter.py`. `evlet/database.py` opens connections and runs transactions, and
280
+ `evlet/writes.py` holds the SQLite files and their write line-up. Other modules never write SQL
281
+ text or ask which database they run on; the modules still being moved are listed in
282
+ [database adapters](database-adapters.md), with the plan and how another database would be added.
285
283
 
286
284
  ## Projects, app packages and instances
287
285
 
@@ -292,12 +290,12 @@ trusted installation stages database changes and publishes a separate app lock
292
290
  with a recoverable journal. Existing framework modules retain their public names.
293
291
  See [the CLI guide](cli.md) for commands, resource packaging and boundaries.
294
292
 
295
- ## Document lifecycle amendment
293
+ ## State manager
296
294
 
297
- Confirmable models now use decorator validators/actions, same-identity revisions,
298
- immutable snapshots and unified history. See [document lifecycle](document-lifecycle.md)
299
- for the APIs, permission and transaction contract, approval boundaries and adoption
300
- from existing State/Move applications.
295
+ `evlet/statemanager.py` holds a document's State: its steps, the rules that move it between
296
+ them, and the hooks `@validate`, `@state`, `@state.exit` and `@release`. Confirm, cancel,
297
+ reopen and void are steps and rules, not separate operations. See
298
+ [states-actions.md](states-actions.md) and [document lifecycle](document-lifecycle.md).
301
299
 
302
300
  ## Ledger models
303
301
 
@@ -305,10 +303,9 @@ from existing State/Move applications.
305
303
  declared, registered and migrated like any model and read through the same session, measures and
306
304
  reports, but its table holds an integer id the database assigns and the declared columns only, and
307
305
  `Meta.api` is forced to `None`, so every caller surface already leaves it out. Append-only tables use
308
- database triggers, as `evlet_audit` and `evlet_journal` do. Named locks (`tx.lock`) are PostgreSQL
309
- transaction advisory locks on hashed business keys and a no-op on SQLite, whose writers are already
310
- serialised. The framework adds no finance or stock concepts; balancing, reversals and cache rebuilds
311
- are app code. See [ledger models](ledger.md).
306
+ database triggers, as `evlet_audit` and `evlet_journal` do. Named locks (`tx.lock`) only check that a
307
+ write transaction is open on SQLite, whose writers are already serialised. The framework adds no
308
+ finance or stock concepts; balancing, reversals and cache rebuilds are app code. See [ledger models](ledger.md).
312
309
 
313
310
  ## The Tool Engine
314
311
 
@@ -152,8 +152,8 @@ class Leave(Model):
152
152
  - `any_of(*scopes)` allows a row when any of its scopes or filter objects allows it. An empty
153
153
  filter object among them allows every row.
154
154
 
155
- The team is resolved inside one SQL statement with a recursive query (`WITH RECURSIVE`) on
156
- SQLite and PostgreSQL, so it has no size limit and needs no Python lookups. The values bound
155
+ The team is resolved inside one SQL statement with a recursive query (`WITH RECURSIVE`),
156
+ so it has no size limit and needs no Python lookups. The values bound
157
157
  are the user's linked record IDs only. `UNION` stops at a cycle in the data. Policies check
158
158
  each declared team when they are built: the parent must be a Link to the same model, and the
159
159
  field must lead to it. Declare the parent Link with `index=True` so each level is an index
@@ -170,12 +170,12 @@ for. The Playground's Employees show a manager, a team member and an outsider
170
170
  A link decides what a team scope shows, so `LocalAuth.link_user` and `unlink_user` write each
171
171
  change to the Controls audit log (area Users, with an `actor` argument; `evlet link-user` records
172
172
  `cli`). A move in the tree is an ordinary edit of the parent Link: declare the hierarchy model with
173
- `track_changes = True` to keep who moved whom and when, as the Playground's Employee does.
173
+ `Meta.journal = Journal(tamper_evident=True)` to keep who moved whom and when, as the
174
+ Playground's Employee does.
174
175
 
175
176
  Operations may also name `print` (printing with a print design; admin has it by default, see
176
- [printing.md](printing.md#permission)) and `void`, `revise`, `unpost` and `repost` on models that support them.
177
- Admin always has them; naming one in a Rule adds that role. See the "Void and revise" and
178
- "Unpost and repost" sections of [states-actions.md](states-actions.md).
177
+ [printing.md](printing.md#permission)). Moves need no operation of their own: a State rule's
178
+ `by` and update permission decide them ([states-actions.md](states-actions.md)).
179
179
 
180
180
  Restricted fields are removed from responses, search, and schema metadata. Querying
181
181
  or sorting on unavailable fields is rejected. Link IDs are returned as null when
@@ -311,8 +311,8 @@ records they touch. They must not call external services inside the transaction.
311
311
  Do not expose an arbitrary method dispatcher.
312
312
 
313
313
  Model actions declared with `@action` on a document may also take validated `inputs`
314
- and declare `available_when`. A `State` field with `Move` declarations changes a
315
- document's state through `POST /api/{model}/{id}/moves/{to}` and can lock it against
314
+ and declare `available_when`. A `State` field with steps and rules changes a
315
+ document's state through `POST /api/{model}/{id}/moves/{key}` and can lock it against
316
316
  ordinary writes. See [states-actions.md](states-actions.md). The record page shows the
317
317
  State as a header badge by default; declare `show="bar"` on a pipeline (draft, submitted,
318
318
  approved) for the stage bar, or `show="none"`. `Meta.status = "<field>"` shows a Select the
@@ -320,7 +320,7 @@ system sets, such as a calculated payment status, as a badge that is never edite
320
320
  header ([states-actions.md](states-actions.md#how-a-state-and-a-status-show)). The list offers a
321
321
  board, one column per state, only when `Meta.board` names the State field, such as
322
322
  `board = "stage"`; any other field fails registration. A move only the application makes,
323
- such as one a background job takes, is declared `Move(..., system=True)`: it has no roles, no
323
+ such as one a background job takes, is declared `State.Rule(..., by=())`: it has no roles, no
324
324
  caller can make it, and trusted Python makes it with `context.move()`
325
325
  ([states-actions.md](states-actions.md#system-moves)). A job gets that context with
326
326
  `job.business(tx, ...)`, and an action queues a job with `self.context.enqueue(...)`
@@ -427,10 +427,8 @@ for everyone else in either direction, and can only shorten sessions and the loc
427
427
  `"local"`, the only values accepted today. New `config.py` files leave them out.
428
428
  Older files that set them to those values keep working.
429
429
 
430
- The CLI supports SQLite/local storage. Existing PostgreSQL, tenant routing, S3 and
431
- other framework APIs remain available through explicit Python configuration.
432
- PostgreSQL instance creation is intentionally rejected until its isolation strategy
433
- is specified. Do not point the new installer at an existing unmanaged database.
430
+ The CLI supports SQLite/local storage. Tenant routing, S3 and other framework APIs
431
+ remain available through explicit Python configuration. Do not point the new installer at an existing unmanaged database.
434
432
  It will reject it rather than adopt it. Existing Playground data stays in place.
435
433
 
436
434
  `evlet serve` never prints sign-in links. While the built-in Administrator has no password
@@ -8,8 +8,8 @@ secrets and connector secrets (see [Controls](controls.md#connectors-and-secrets
8
8
  writing our own cipher is not an option. The connector calls the same authenticated HTTP routes used by
9
9
  the browser, so tenant, account, model, row, field, and action checks stay on the
10
10
  server. It has no database handle, arbitrary SQL, Python execution, or file tool.
11
- No context it reaches opens the transaction session of a move or action handler
12
- ([states-actions.md](states-actions.md#the-transaction-session-in-run-methods-and-actions)).
11
+ No context it reaches opens the transaction session of a state hook or action handler
12
+ ([states-actions.md](states-actions.md#the-transaction-session-in-hooks-and-actions)).
13
13
  The same tools are also served over HTTP at `/_/mcp` with OAuth sign-in; see
14
14
  [Remote MCP with OAuth](#remote-mcp-with-oauth).
15
15
 
@@ -145,7 +145,7 @@ so the application decides what this person may call and logs every call.
145
145
  | `job_status` | Read a permitted queued action's status when jobs are configured |
146
146
  | `create_record` | Create with backend validation |
147
147
  | `update_record` | Apply partial values and any supplied child replacements |
148
- | `change_state` | Move a document to another state, or confirm, cancel or reopen a confirmable one |
148
+ | `change_state` | Move a document with one of its State rules (`rule`, `remark`, `values`) |
149
149
  | `run_action` | Invoke a registered action, including queued actions |
150
150
  | `delete_record` | Delete a permitted record and owned children |
151
151