evlet 0.4.2__tar.gz → 0.4.4__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 (361) hide show
  1. {evlet-0.4.2 → evlet-0.4.4}/CHANGELOG.md +242 -0
  2. {evlet-0.4.2 → evlet-0.4.4}/MANIFEST.in +1 -0
  3. {evlet-0.4.2/evlet.egg-info → evlet-0.4.4}/PKG-INFO +4 -4
  4. {evlet-0.4.2 → evlet-0.4.4}/README.md +3 -3
  5. {evlet-0.4.2 → evlet-0.4.4}/build_support.py +1 -0
  6. {evlet-0.4.2 → evlet-0.4.4}/docs/app-upgrades.md +90 -9
  7. {evlet-0.4.2 → evlet-0.4.4}/docs/business-capabilities.md +4 -1
  8. {evlet-0.4.2 → evlet-0.4.4}/docs/cli.md +206 -18
  9. {evlet-0.4.2 → evlet-0.4.4}/docs/connector.md +6 -2
  10. {evlet-0.4.2 → evlet-0.4.4}/docs/controls.md +38 -15
  11. {evlet-0.4.2 → evlet-0.4.4}/docs/eva.md +19 -4
  12. {evlet-0.4.2 → evlet-0.4.4}/docs/finite-calculations.md +70 -11
  13. {evlet-0.4.2 → evlet-0.4.4}/docs/jobs-realtime.md +39 -3
  14. {evlet-0.4.2 → evlet-0.4.4}/docs/performance.md +109 -0
  15. {evlet-0.4.2 → evlet-0.4.4}/docs/postgresql.md +5 -0
  16. {evlet-0.4.2 → evlet-0.4.4}/docs/printing.md +5 -0
  17. {evlet-0.4.2 → evlet-0.4.4}/docs/production-operations.md +45 -2
  18. {evlet-0.4.2 → evlet-0.4.4}/docs/reports.md +3 -1
  19. {evlet-0.4.2 → evlet-0.4.4}/docs/routing.md +89 -9
  20. {evlet-0.4.2 → evlet-0.4.4}/docs/sequences.md +4 -1
  21. {evlet-0.4.2 → evlet-0.4.4}/docs/settings.md +5 -2
  22. {evlet-0.4.2 → evlet-0.4.4}/docs/slips.md +8 -0
  23. {evlet-0.4.2 → evlet-0.4.4}/docs/tenancy-deployment.md +1 -1
  24. {evlet-0.4.2 → evlet-0.4.4}/docs/tools.md +17 -4
  25. {evlet-0.4.2 → evlet-0.4.4}/docs/ui.md +1 -1
  26. {evlet-0.4.2 → evlet-0.4.4}/evlet/app.py +33 -5
  27. {evlet-0.4.2 → evlet-0.4.4}/evlet/assistants.py +4 -0
  28. {evlet-0.4.2 → evlet-0.4.4}/evlet/auth.py +48 -25
  29. {evlet-0.4.2 → evlet-0.4.4}/evlet/business.py +21 -18
  30. {evlet-0.4.2 → evlet-0.4.4}/evlet/calc.py +176 -111
  31. evlet-0.4.4/evlet/cli/backup.py +116 -0
  32. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/connector.py +7 -1
  33. evlet-0.4.4/evlet/cli/hosts.py +283 -0
  34. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/install.py +41 -15
  35. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/instance.py +1 -1
  36. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/main.py +131 -4
  37. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/proxy.py +23 -7
  38. evlet-0.4.4/evlet/cli/restart.py +301 -0
  39. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/serve.py +3 -2
  40. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/setup.py +39 -0
  41. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/site.py +32 -2
  42. evlet-0.4.4/evlet/cli/upgrade.py +130 -0
  43. {evlet-0.4.2 → evlet-0.4.4}/evlet/connectors.py +9 -3
  44. {evlet-0.4.2 → evlet-0.4.4}/evlet/controls.py +64 -17
  45. {evlet-0.4.2 → evlet-0.4.4}/evlet/controls_export.py +3 -0
  46. {evlet-0.4.2 → evlet-0.4.4}/evlet/database.py +143 -20
  47. {evlet-0.4.2 → evlet-0.4.4}/evlet/documents.py +43 -12
  48. {evlet-0.4.2 → evlet-0.4.4}/evlet/eva.py +31 -15
  49. {evlet-0.4.2 → evlet-0.4.4}/evlet/expressions.py +96 -42
  50. {evlet-0.4.2 → evlet-0.4.4}/evlet/fields.py +5 -0
  51. {evlet-0.4.2 → evlet-0.4.4}/evlet/framework.py +10 -2
  52. {evlet-0.4.2 → evlet-0.4.4}/evlet/images.py +2 -1
  53. {evlet-0.4.2 → evlet-0.4.4}/evlet/instances.py +1 -1
  54. {evlet-0.4.2 → evlet-0.4.4}/evlet/jobs.py +100 -30
  55. {evlet-0.4.2 → evlet-0.4.4}/evlet/mailboxes.py +15 -5
  56. {evlet-0.4.2 → evlet-0.4.4}/evlet/models.py +16 -0
  57. {evlet-0.4.2 → evlet-0.4.4}/evlet/permissions.py +20 -7
  58. {evlet-0.4.2 → evlet-0.4.4}/evlet/postgres.py +17 -3
  59. {evlet-0.4.2 → evlet-0.4.4}/evlet/printing.py +18 -8
  60. {evlet-0.4.2 → evlet-0.4.4}/evlet/routing.py +56 -5
  61. {evlet-0.4.2 → evlet-0.4.4}/evlet/secrets.py +3 -2
  62. {evlet-0.4.2 → evlet-0.4.4}/evlet/services.py +1 -1
  63. {evlet-0.4.2 → evlet-0.4.4}/evlet/settings.py +14 -4
  64. {evlet-0.4.2 → evlet-0.4.4}/evlet/states.py +2 -2
  65. {evlet-0.4.2 → evlet-0.4.4}/evlet/tools.py +113 -40
  66. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/routes.py +16 -3
  67. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/serving.py +68 -15
  68. evlet-0.4.2/evlet/ui/static/assets/ai-BoNaQPi6.js → evlet-0.4.4/evlet/ui/static/assets/ai-Dxes-Y5x.js +1 -1
  69. evlet-0.4.2/evlet/ui/static/assets/app-CJDDr7hE.js → evlet-0.4.4/evlet/ui/static/assets/app-DV2K7-Sc.js +12 -10
  70. evlet-0.4.2/evlet/ui/static/assets/consent-CJkpbF5L.js → evlet-0.4.4/evlet/ui/static/assets/consent-CQhXzR61.js +1 -1
  71. evlet-0.4.2/evlet/ui/static/assets/email-BAMmEqz2.js → evlet-0.4.4/evlet/ui/static/assets/email-BQhe29I0.js +1 -1
  72. evlet-0.4.2/evlet/ui/static/assets/index-D1OKAsr0.js → evlet-0.4.4/evlet/ui/static/assets/index-BZFjJUtE.js +339 -339
  73. evlet-0.4.2/evlet/ui/static/assets/keys-D9Qq-LDr.js → evlet-0.4.4/evlet/ui/static/assets/keys-Czr55W8K.js +1 -1
  74. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/index.html +1 -1
  75. {evlet-0.4.2 → evlet-0.4.4}/evlet/unsaved.py +30 -22
  76. evlet-0.4.4/evlet/writes.py +501 -0
  77. {evlet-0.4.2 → evlet-0.4.4/evlet.egg-info}/PKG-INFO +4 -4
  78. {evlet-0.4.2 → evlet-0.4.4}/evlet.egg-info/SOURCES.txt +17 -6
  79. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/app.py +10 -3
  80. evlet-0.4.4/examples/playground/site/404.html +16 -0
  81. evlet-0.4.4/examples/playground/site/about/index.html +16 -0
  82. evlet-0.4.4/examples/playground/site/index.html +17 -0
  83. evlet-0.4.4/examples/playground/site/robots.txt +3 -0
  84. evlet-0.4.4/examples/playground/site/site.css +4 -0
  85. evlet-0.4.4/examples/playground/site/sitemap.xml +5 -0
  86. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/access.ts +12 -2
  87. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/ai.ts +1 -1
  88. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/drafts.ts +1 -0
  89. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/eva.ts +1 -1
  90. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/people.ts +4 -1
  91. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/model/finite.ts +66 -230
  92. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/model/session.ts +15 -0
  93. {evlet-0.4.2 → evlet-0.4.4}/pyproject.toml +1 -1
  94. {evlet-0.4.2 → evlet-0.4.4}/LICENSE +0 -0
  95. {evlet-0.4.2 → evlet-0.4.4}/docs/amendment-v2.md +0 -0
  96. {evlet-0.4.2 → evlet-0.4.4}/docs/api-stability.md +0 -0
  97. {evlet-0.4.2 → evlet-0.4.4}/docs/application-generation.md +0 -0
  98. {evlet-0.4.2 → evlet-0.4.4}/docs/architecture.md +0 -0
  99. {evlet-0.4.2 → evlet-0.4.4}/docs/customizing.md +0 -0
  100. {evlet-0.4.2 → evlet-0.4.4}/docs/document-lifecycle.md +0 -0
  101. {evlet-0.4.2 → evlet-0.4.4}/docs/effects.md +0 -0
  102. {evlet-0.4.2 → evlet-0.4.4}/docs/getting-started.md +0 -0
  103. {evlet-0.4.2 → evlet-0.4.4}/docs/journal.md +0 -0
  104. {evlet-0.4.2 → evlet-0.4.4}/docs/ledger.md +0 -0
  105. {evlet-0.4.2 → evlet-0.4.4}/docs/lifecycle-specification.md +0 -0
  106. {evlet-0.4.2 → evlet-0.4.4}/docs/meaning.md +0 -0
  107. {evlet-0.4.2 → evlet-0.4.4}/docs/measures.md +0 -0
  108. {evlet-0.4.2 → evlet-0.4.4}/docs/model-engine.md +0 -0
  109. {evlet-0.4.2 → evlet-0.4.4}/docs/states-actions.md +0 -0
  110. {evlet-0.4.2 → evlet-0.4.4}/docs/ui-framework.md +0 -0
  111. {evlet-0.4.2 → evlet-0.4.4}/evlet/__init__.py +0 -0
  112. {evlet-0.4.2 → evlet-0.4.4}/evlet/__main__.py +0 -0
  113. {evlet-0.4.2 → evlet-0.4.4}/evlet/audit.py +0 -0
  114. {evlet-0.4.2 → evlet-0.4.4}/evlet/builds.py +0 -0
  115. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/__init__.py +0 -0
  116. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/app.py +0 -0
  117. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/devlink.py +0 -0
  118. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/docs.py +0 -0
  119. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/effects.py +0 -0
  120. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/ids.py +0 -0
  121. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/jobs.py +0 -0
  122. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/journal.py +0 -0
  123. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/ledger.py +0 -0
  124. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/playground.py +0 -0
  125. {evlet-0.4.2 → evlet-0.4.4}/evlet/cli/project.py +0 -0
  126. {evlet-0.4.2 → evlet-0.4.4}/evlet/connector.py +0 -0
  127. {evlet-0.4.2 → evlet-0.4.4}/evlet/controls_system.py +0 -0
  128. {evlet-0.4.2 → evlet-0.4.4}/evlet/corrections.py +0 -0
  129. {evlet-0.4.2 → evlet-0.4.4}/evlet/currencies.py +0 -0
  130. {evlet-0.4.2 → evlet-0.4.4}/evlet/customization.py +0 -0
  131. {evlet-0.4.2 → evlet-0.4.4}/evlet/declarations.py +0 -0
  132. {evlet-0.4.2 → evlet-0.4.4}/evlet/deployment.py +0 -0
  133. {evlet-0.4.2 → evlet-0.4.4}/evlet/devlink.py +0 -0
  134. {evlet-0.4.2 → evlet-0.4.4}/evlet/discovery.py +0 -0
  135. {evlet-0.4.2 → evlet-0.4.4}/evlet/effects.py +0 -0
  136. {evlet-0.4.2 → evlet-0.4.4}/evlet/events.py +0 -0
  137. {evlet-0.4.2 → evlet-0.4.4}/evlet/forms.py +0 -0
  138. {evlet-0.4.2 → evlet-0.4.4}/evlet/identity.py +0 -0
  139. {evlet-0.4.2 → evlet-0.4.4}/evlet/indexes.py +0 -0
  140. {evlet-0.4.2 → evlet-0.4.4}/evlet/journal.py +0 -0
  141. {evlet-0.4.2 → evlet-0.4.4}/evlet/ledger.py +0 -0
  142. {evlet-0.4.2 → evlet-0.4.4}/evlet/lifecycle.py +0 -0
  143. {evlet-0.4.2 → evlet-0.4.4}/evlet/mcp.py +0 -0
  144. {evlet-0.4.2 → evlet-0.4.4}/evlet/meaning.py +0 -0
  145. {evlet-0.4.2 → evlet-0.4.4}/evlet/measures.py +0 -0
  146. {evlet-0.4.2 → evlet-0.4.4}/evlet/mentions.py +0 -0
  147. {evlet-0.4.2 → evlet-0.4.4}/evlet/migrations.py +0 -0
  148. {evlet-0.4.2 → evlet-0.4.4}/evlet/naming.py +0 -0
  149. {evlet-0.4.2 → evlet-0.4.4}/evlet/object_storage.py +0 -0
  150. {evlet-0.4.2 → evlet-0.4.4}/evlet/packages.py +0 -0
  151. {evlet-0.4.2 → evlet-0.4.4}/evlet/periods.py +0 -0
  152. {evlet-0.4.2 → evlet-0.4.4}/evlet/postgres_schema.py +0 -0
  153. {evlet-0.4.2 → evlet-0.4.4}/evlet/py.typed +0 -0
  154. {evlet-0.4.2 → evlet-0.4.4}/evlet/query.py +0 -0
  155. {evlet-0.4.2 → evlet-0.4.4}/evlet/reactivity.py +0 -0
  156. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/__init__.py +0 -0
  157. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/print/fonts/NotoSans-Bold.woff2 +0 -0
  158. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/print/fonts/NotoSans-OFL.txt +0 -0
  159. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/print/fonts/NotoSans-Regular.woff2 +0 -0
  160. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/print/fonts/NotoSansArabic-Bold.woff2 +0 -0
  161. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/print/fonts/NotoSansArabic-OFL.txt +0 -0
  162. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/print/fonts/NotoSansArabic-Regular.woff2 +0 -0
  163. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app/.gitignore.tpl +0 -0
  164. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app/README.md.tpl +0 -0
  165. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app/__app__/__init__.py.tpl +0 -0
  166. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app/__app__/actions/__init__.py.tpl +0 -0
  167. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app/__app__/hooks.py.tpl +0 -0
  168. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app/__app__/migrations/__init__.py.tpl +0 -0
  169. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app/__app__/models/__init__.py.tpl +0 -0
  170. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app/__app__/permissions.py.tpl +0 -0
  171. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app/pyproject.toml.tpl +0 -0
  172. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app/tests/test_models.py.tpl +0 -0
  173. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app_flat/.gitignore.tpl +0 -0
  174. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app_flat/README.md.tpl +0 -0
  175. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app_flat/__init__.py.tpl +0 -0
  176. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app_flat/models/__init__.py.tpl +0 -0
  177. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app_flat/models/item.py.tpl +0 -0
  178. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app_flat/pyproject.toml.tpl +0 -0
  179. {evlet-0.4.2 → evlet-0.4.4}/evlet/resources/templates/app_flat/setup.py.tpl +0 -0
  180. {evlet-0.4.2 → evlet-0.4.4}/evlet/richtext.py +0 -0
  181. {evlet-0.4.2 → evlet-0.4.4}/evlet/sections.py +0 -0
  182. {evlet-0.4.2 → evlet-0.4.4}/evlet/sequences.py +0 -0
  183. {evlet-0.4.2 → evlet-0.4.4}/evlet/serverless.py +0 -0
  184. {evlet-0.4.2 → evlet-0.4.4}/evlet/slips.py +0 -0
  185. {evlet-0.4.2 → evlet-0.4.4}/evlet/storage.py +0 -0
  186. {evlet-0.4.2 → evlet-0.4.4}/evlet/tenancy.py +0 -0
  187. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/__init__.py +0 -0
  188. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/application.py +0 -0
  189. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/metadata.py +0 -0
  190. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/IBMPlexSans-OFL.txt +0 -0
  191. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/JetBrainsMono-Medium-3S3k2nMz.woff2 +0 -0
  192. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/JetBrainsMono-OFL.txt +0 -0
  193. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/JetBrainsMono-Regular-BQaDgvhP.woff2 +0 -0
  194. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/app-0SduO6OB.css +0 -0
  195. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/evlet-icon-blue.svg +0 -0
  196. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/evlet-logo-primary.svg +0 -0
  197. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/evlet-logo-white.svg +0 -0
  198. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/ibm-plex-sans-latin-400-italic-CZTNEAuW.woff2 +0 -0
  199. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/ibm-plex-sans-latin-400-normal-CDDApCn2.woff2 +0 -0
  200. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/ibm-plex-sans-latin-500-normal-6ng42L7E.woff2 +0 -0
  201. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/ibm-plex-sans-latin-600-normal-CuJfVYMP.woff2 +0 -0
  202. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/ibm-plex-sans-latin-700-normal-Bxkt5Cjx.woff2 +0 -0
  203. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-400-italic-Du9zzoL2.woff2 +0 -0
  204. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-400-normal-C5H60-Va.woff2 +0 -0
  205. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-500-normal-DakdToA3.woff2 +0 -0
  206. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-600-normal-DOrvGEcy.woff2 +0 -0
  207. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-700-normal-aMgXseD4.woff2 +0 -0
  208. {evlet-0.4.2 → evlet-0.4.4}/evlet/ui/static/assets/index-UqEST1u4.css +0 -0
  209. {evlet-0.4.2 → evlet-0.4.4}/evlet/workspaces.py +0 -0
  210. {evlet-0.4.2 → evlet-0.4.4}/evlet.egg-info/dependency_links.txt +0 -0
  211. {evlet-0.4.2 → evlet-0.4.4}/evlet.egg-info/entry_points.txt +0 -0
  212. {evlet-0.4.2 → evlet-0.4.4}/evlet.egg-info/requires.txt +0 -0
  213. {evlet-0.4.2 → evlet-0.4.4}/evlet.egg-info/top_level.txt +0 -0
  214. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/items.py +0 -0
  215. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/manage.py +0 -0
  216. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/migrate.py +0 -0
  217. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/models.py +0 -0
  218. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/portal/index.html +0 -0
  219. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/portal/portal.css +0 -0
  220. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/portal/portal.js +0 -0
  221. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/prints.py +0 -0
  222. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/reports.py +0 -0
  223. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/settings.py +0 -0
  224. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/slips.py +0 -0
  225. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/team.py +0 -0
  226. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/tenants.py +0 -0
  227. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/worker.py +0 -0
  228. {evlet-0.4.2 → evlet-0.4.4}/examples/playground/workspaces.py +0 -0
  229. {evlet-0.4.2 → evlet-0.4.4}/frontend/.node-version +0 -0
  230. {evlet-0.4.2 → evlet-0.4.4}/frontend/.npmrc +0 -0
  231. {evlet-0.4.2 → evlet-0.4.4}/frontend/fonts/IBMPlexSans-OFL.txt +0 -0
  232. {evlet-0.4.2 → evlet-0.4.4}/frontend/fonts/JetBrainsMono-Medium.woff2 +0 -0
  233. {evlet-0.4.2 → evlet-0.4.4}/frontend/fonts/JetBrainsMono-OFL.txt +0 -0
  234. {evlet-0.4.2 → evlet-0.4.4}/frontend/fonts/JetBrainsMono-Regular.woff2 +0 -0
  235. {evlet-0.4.2 → evlet-0.4.4}/frontend/fonts/ibm-plex-sans-latin-400-italic.woff2 +0 -0
  236. {evlet-0.4.2 → evlet-0.4.4}/frontend/fonts/ibm-plex-sans-latin-400-normal.woff2 +0 -0
  237. {evlet-0.4.2 → evlet-0.4.4}/frontend/fonts/ibm-plex-sans-latin-500-normal.woff2 +0 -0
  238. {evlet-0.4.2 → evlet-0.4.4}/frontend/fonts/ibm-plex-sans-latin-600-normal.woff2 +0 -0
  239. {evlet-0.4.2 → evlet-0.4.4}/frontend/fonts/ibm-plex-sans-latin-700-normal.woff2 +0 -0
  240. {evlet-0.4.2 → evlet-0.4.4}/frontend/fonts/ibm-plex-sans-latin-ext-400-italic.woff2 +0 -0
  241. {evlet-0.4.2 → evlet-0.4.4}/frontend/fonts/ibm-plex-sans-latin-ext-400-normal.woff2 +0 -0
  242. {evlet-0.4.2 → evlet-0.4.4}/frontend/fonts/ibm-plex-sans-latin-ext-500-normal.woff2 +0 -0
  243. {evlet-0.4.2 → evlet-0.4.4}/frontend/fonts/ibm-plex-sans-latin-ext-600-normal.woff2 +0 -0
  244. {evlet-0.4.2 → evlet-0.4.4}/frontend/fonts/ibm-plex-sans-latin-ext-700-normal.woff2 +0 -0
  245. {evlet-0.4.2 → evlet-0.4.4}/frontend/index.html +0 -0
  246. {evlet-0.4.2 → evlet-0.4.4}/frontend/package-lock.json +0 -0
  247. {evlet-0.4.2 → evlet-0.4.4}/frontend/package.json +0 -0
  248. {evlet-0.4.2 → evlet-0.4.4}/frontend/public/assets/evlet-icon-blue.svg +0 -0
  249. {evlet-0.4.2 → evlet-0.4.4}/frontend/public/assets/evlet-logo-primary.svg +0 -0
  250. {evlet-0.4.2 → evlet-0.4.4}/frontend/public/assets/evlet-logo-white.svg +0 -0
  251. {evlet-0.4.2 → evlet-0.4.4}/frontend/scripts/bench-ui.mjs +0 -0
  252. {evlet-0.4.2 → evlet-0.4.4}/frontend/scripts/dev-proxy.mjs +0 -0
  253. {evlet-0.4.2 → evlet-0.4.4}/frontend/scripts/dev-proxy.test.mjs +0 -0
  254. {evlet-0.4.2 → evlet-0.4.4}/frontend/scripts/install-ui.mjs +0 -0
  255. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/api.ts +0 -0
  256. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/app.ts +0 -0
  257. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/client.ts +0 -0
  258. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/composer.ts +0 -0
  259. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/config.ts +0 -0
  260. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/context.ts +0 -0
  261. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/docs.ts +0 -0
  262. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/duplicate.ts +0 -0
  263. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/explorer.ts +0 -0
  264. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/filters.ts +0 -0
  265. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/inbox.ts +0 -0
  266. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/last-page.ts +0 -0
  267. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/list-page.ts +0 -0
  268. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/login.ts +0 -0
  269. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/main.ts +0 -0
  270. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/meta.ts +0 -0
  271. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/nav-icons.ts +0 -0
  272. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/palette.ts +0 -0
  273. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/prefs.ts +0 -0
  274. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/recents.ts +0 -0
  275. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/record-blocks.ts +0 -0
  276. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/record-compact.ts +0 -0
  277. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/record-page.ts +0 -0
  278. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/related-data.ts +0 -0
  279. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/report-page.ts +0 -0
  280. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/revisions.ts +0 -0
  281. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/screens.css +0 -0
  282. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/settings.css +0 -0
  283. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/settings.ts +0 -0
  284. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/shell.ts +0 -0
  285. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/shortcuts.ts +0 -0
  286. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/slips.ts +0 -0
  287. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/unsaved-bar.ts +0 -0
  288. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/unsaved.ts +0 -0
  289. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/workspace-editor.ts +0 -0
  290. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/app/workspaces.ts +0 -0
  291. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/app.ts +0 -0
  292. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/client.ts +0 -0
  293. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/connections.ts +0 -0
  294. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/controls.css +0 -0
  295. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/currencies.ts +0 -0
  296. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/keys.ts +0 -0
  297. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/log.ts +0 -0
  298. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/models.ts +0 -0
  299. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/naming.ts +0 -0
  300. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/periods.ts +0 -0
  301. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/prints.ts +0 -0
  302. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/system.ts +0 -0
  303. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/controls/unsaved.ts +0 -0
  304. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/dev.ts +0 -0
  305. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/dom.ts +0 -0
  306. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/eva/chat.ts +0 -0
  307. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/eva/client.ts +0 -0
  308. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/eva/eva.css +0 -0
  309. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/eva/tasks.ts +0 -0
  310. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ids.ts +0 -0
  311. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/model/changes.ts +0 -0
  312. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/model/format.ts +0 -0
  313. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/model/links.ts +0 -0
  314. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/model/record.ts +0 -0
  315. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/model/schema.ts +0 -0
  316. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/model/unsaved.ts +0 -0
  317. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/reactive.ts +0 -0
  318. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/richtext/editor.ts +0 -0
  319. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/richtext/history.ts +0 -0
  320. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/richtext/html.ts +0 -0
  321. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/richtext/images.ts +0 -0
  322. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/richtext/model.ts +0 -0
  323. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/richtext/ops.ts +0 -0
  324. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/richtext/render.ts +0 -0
  325. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/richtext/richtext.css +0 -0
  326. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/router.ts +0 -0
  327. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/settings/ai.ts +0 -0
  328. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/settings/consent.ts +0 -0
  329. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/settings/email.ts +0 -0
  330. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/settings/keys.ts +0 -0
  331. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/autofocus.ts +0 -0
  332. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/base.ts +0 -0
  333. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/catalog.json +0 -0
  334. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/chart.ts +0 -0
  335. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/childtable.ts +0 -0
  336. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/core.ts +0 -0
  337. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/dateparse.ts +0 -0
  338. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/doc.ts +0 -0
  339. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/draglist.ts +0 -0
  340. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/explain.ts +0 -0
  341. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/fields.ts +0 -0
  342. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/fold.ts +0 -0
  343. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/icon-data.ts +0 -0
  344. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/index.ts +0 -0
  345. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/inline.ts +0 -0
  346. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/kinds.ts +0 -0
  347. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/layers.ts +0 -0
  348. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/library.ts +0 -0
  349. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/list.ts +0 -0
  350. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/money.ts +0 -0
  351. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/pickers.ts +0 -0
  352. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/shortcuts.ts +0 -0
  353. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/split.ts +0 -0
  354. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/styles.css +0 -0
  355. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/table.ts +0 -0
  356. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/theme.ts +0 -0
  357. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/time.ts +0 -0
  358. {evlet-0.4.2 → evlet-0.4.4}/frontend/src/evlet/ui/tooltip.ts +0 -0
  359. {evlet-0.4.2 → evlet-0.4.4}/frontend/tsconfig.json +0 -0
  360. {evlet-0.4.2 → evlet-0.4.4}/frontend/vite.config.js +0 -0
  361. {evlet-0.4.2 → evlet-0.4.4}/setup.cfg +0 -0
@@ -4,6 +4,248 @@ 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.4 (13-11-2026)
8
+
9
+ ### Added
10
+
11
+ - **Formula helpers: `choose`, `isin`, `is_empty`, `has_value`, `least`, `greatest` and
12
+ `absolute`** (from `evlet.calc`). `choose(F("stage"), {"won": 100, "lost": 0}, default=10)`
13
+ replaces a chain of nested `when()`, and `F("status").isin("new", "failed")` replaces
14
+ several `==` joined with `|`. `is_empty(x)` and `has_value(x)` replace `x == None` and
15
+ `x != None`, which needed `# noqa` comments. Each helper builds exactly the formula of its
16
+ long form, so rewriting a model with them changes no formula hash and needs no
17
+ recalculation. The testCRM deal's stage probability now uses `choose`. See
18
+ [docs/finite-calculations.md](docs/finite-calculations.md#helpers).
19
+ - **`evlet restart <instance>` checks before it restarts.** On a server set up with
20
+ `evlet setup --host --apply`, it checks that the instance loads, its apps match `apps.lock`
21
+ and import, its routes resolve, no framework or app migration is pending, and the
22
+ `evlet-<instance>` unit serves this instance. Only then does it show and run
23
+ `sudo systemctl restart`, wait for `/health` and say the site is back up. When a check
24
+ fails, the running service is left alone; pending migrations are refused with
25
+ `Run evlet migrate <instance> first`. When the site does not come back in 30 seconds, it
26
+ prints the last 20 journal lines. `--check` runs the checks only, `--yes` skips the
27
+ question, `--service` names another unit and `--timeout` changes the wait
28
+ ([docs/cli.md](docs/cli.md#restart-a-site-safely)).
29
+ - **`evlet upgrade <instance>` moves an instance to a newer Evlet.** It runs pip in the project's
30
+ `.venv`, prints `evlet migrate --plan`, and after one question runs `evlet backup`,
31
+ `sudo systemctl stop`, `evlet migrate` and `evlet restart --yes`. Every step after pip runs as
32
+ its own `.venv/bin/python -P -m evlet` process, so none mixes old and new code. On 0.x it stays
33
+ within the current minor (0.4.\*); `--to VERSION` picks another. When a step fails it prints
34
+ the rollback commands ([docs/cli.md](docs/cli.md#upgrade-evlet-on-a-server)).
35
+ - **`evlet --version`** prints the Evlet version and, inside a project, the one in its `.venv`.
36
+ When the two differ, every project command says so before it runs with the `.venv` one.
37
+ - **`evlet migrate --plan` says `Planned with Evlet X`.**
38
+
39
+ ### Changed
40
+
41
+ - **Roles that open Controls must use two-step sign-in.** A new Controls setting,
42
+ `security.controls_two_step`, is on by default: every desk role other than admin with "Opens
43
+ Controls" turned on must use two-step sign-in, as admins already do. Only an admin can switch
44
+ it off, in Controls > Security. See [Security](docs/controls.md#security-rules).
45
+ - **Passwords set by a role that is not admin are named in the audit log.** A Controls role can
46
+ still set the password of someone who is not an admin, but the audit row now reads
47
+ `Password set by <username> (role <role>), who is not an admin`. Admin accounts stay refused.
48
+ - **Hints say `evlet restart`.** `evlet host add` and `host remove` with `--routes-only`, and
49
+ `evlet proxy --write`, now suggest `evlet restart <instance>` instead of
50
+ `sudo systemctl restart`.
51
+ - **Naming-series conditions run on the formula evaluator.** A condition such as
52
+ `total >= 250000 and status == "sent"` is still parsed by the same rules with the same error
53
+ messages, but it now compiles to finite-v1 expression nodes and runs on the finite-v1
54
+ evaluator, instead of a third evaluator of its own. Every condition decides exactly as
55
+ before; a test compares both over many conditions and records. Nothing to change.
56
+ - **`evlet controls grant` keeps the allowed networks set in Controls.** It used to clear them
57
+ every time and only its output said so. Now it clears them only with `--clear-allowlist`. When
58
+ networks remain, it lists them, and on an SSH session it says whether the address you
59
+ connected from is outside them and you are still locked out. **What to change:** if you rely
60
+ on the command to reopen Controls from anywhere, add `--clear-allowlist`
61
+ ([docs/controls.md](docs/controls.md#access)).
62
+
63
+ - **Personal mailboxes reach only public mail servers.** A mailbox a person connects with a
64
+ password must use a public address, SSL/TLS or STARTTLS, and the standard mail ports. Private
65
+ ranges such as 10.x, 192.168.x, 100.64.x and fc00::, and servers on this machine, are refused
66
+ with a message that says to ask an admin. The check also runs on every sync and send.
67
+ **What to change:** if people used a mail server on a private network for their own mailbox,
68
+ an admin now sets it up as an Email sending or Email receiving connector in Controls. Admin
69
+ connectors still accept private addresses. `evlet.connectors.safe_address` takes a new
70
+ `public=True` argument for addresses typed in by people who are not admins.
71
+ - **The shared formula fixtures check results, not internal counters.** The browser and
72
+ server engines must still agree on values, states, causes, rule states, Link lookup
73
+ requests, refused commands and which results changed. They no longer have to evaluate
74
+ formulas in the same order or count the same steps. Nothing changes for apps.
75
+ - **The browser formula engine is smaller.** `FiniteDocument` no longer has `explain`,
76
+ `subscriptions`, `moveRow`, `replaceRows`, `sources`, `observeTable` or `rebase`, and Python's
77
+ `calc.Document` no longer has `move_row` or `rebase`. No app or framework code called them.
78
+ The browser also stops hashing each plan again with its own SHA-256 code; it still checks
79
+ the plan's shape, and the server still refuses a save made against a different plan. Code
80
+ that called one of these methods directly should rebuild the session instead (after a save,
81
+ for `rebase`) or use `addRow`, `removeRow` and `reorder`.
82
+ - **Formula batches no longer copy the whole document.** Both formula engines used to copy
83
+ every row and result at the start of each batch so a failure could be undone, which made
84
+ each keystroke on a large document cost more. Every command now checks its input before it
85
+ changes anything, so a refused command still changes nothing. What changes: if code inside
86
+ a `batch` callback throws after some commands ran, those commands are now kept and settled
87
+ before the error is raised again, instead of being undone. If a batch cannot settle (an
88
+ engine limit), the document refuses further commands, and an open record starts a new
89
+ calculation session. Apps only call these engines through records, so nothing changes for
90
+ them.
91
+ - **Eva asks before every change once a chat has read stored data.** Records, journals,
92
+ reports and files can hold text written to steer Eva. After a chat has read any of them,
93
+ every create, update, move or action asks first, even when Controls → AI → Eva says "Never
94
+ asks" for that kind of change. Scheduled tasks skip such changes. A chat that only creates
95
+ records follows the settings. See [When Eva asks first](docs/eva.md#when-eva-asks-first).
96
+ - **`change_state` moves State documents.** It now takes `{model, id, to, values?, reason?}` and
97
+ calls `POST /api/{model}/{id}/moves/{to}` with every role, guard and state check, so Eva and MCP
98
+ clients can post a document or move a record. For confirmable documents `to` is `confirm`,
99
+ `cancel` or `reopen`. Clients that sent `operation` send `to` instead. See
100
+ [tools.md](docs/tools.md#tools).
101
+ - A tool approval is no longer requested for a field the role can't write: the call is refused
102
+ at once, as the route would refuse it.
103
+
104
+ ### Fixed
105
+
106
+ - **A backup code works only once, also under a race.** Two sign-ins sending the same backup
107
+ code at the same moment (on PostgreSQL, say) could both succeed. The remaining codes are now
108
+ written back only if nobody changed them since they were read, like app codes.
109
+ - **Connector commands after logout say you're signed out.** `evlet describe` and `evlet mcp`
110
+ with a removed session file printed a raw `[Errno 2] No such file` error. They now say you're
111
+ signed out and show the `evlet login` command to run; `evlet logout` again says you're already
112
+ signed out.
113
+ - **The upgrade docs mention `evlet backup` and `evlet restore`.** `docs/app-upgrades.md` still
114
+ said there was no restore command. It now shows both commands and how to go back after a
115
+ migration.
116
+
117
+ - **The draft preview no longer shows records you can't read.** `POST /api/_draft/{Model}`
118
+ returned the id behind a Link or Reference even when a row rule hid that record, while a
119
+ normal read showed it as empty. The preview now empties them the same way, and so do
120
+ calculated Link and Reference values on record responses. All these read paths share one
121
+ check, `Policy.hide_unfollowable`.
122
+ - **A formula over a `Query` source respects the source's row rule.** A calculated field that
123
+ reads a source model the role can only partly see (a row rule) is no longer shown to that
124
+ role, since it was built from rows the role cannot see. Fields over child tables and Link
125
+ lookups already worked this way. Roles with a row rule on a source model may now see fewer
126
+ calculated fields.
127
+ - **Trusted code no longer decides what callers may read.** The read checks for calculated
128
+ fields were cached per role only. When a job, a schedule or start-up code checked a field
129
+ first, a later request reused that answer, even for a field built from a `Meta.api = None`
130
+ model that requests may not reach. Requests and trusted code now get separate answers.
131
+ - **A PDF render no longer blocks saves.** Printing a record and the designer's preview read the
132
+ record first and render with no write transaction open. Before, the render ran inside the main
133
+ file's write transaction, so a heavy PDF made everyone else's saves wait or fail with Busy.
134
+ File a copy now keeps the PDF in a short write afterwards that checks `update` and `print`
135
+ again, and answers 409 when the record changed while it was printing.
136
+ - **An idle job worker no longer writes.** Each pass first reads whether a job, an expired lease
137
+ or a schedule is due, and skips both writes when nothing is. When something is due, ticking
138
+ schedules and claiming the next job share one write transaction instead of two. A queued job
139
+ is still picked up on the next pass, and `wake()` still starts it at once.
140
+ - **Opening kept unsaved changes is a read.** `GET /api/_unsaved/{model}/{id}` no longer opens two
141
+ write transactions. It writes only when an entry can no longer be used and is removed.
142
+ - **Mention emails on PostgreSQL.** A mention that should send an email now sends it. The
143
+ PostgreSQL adapter did not return the new inbox row's id, so every mention email was skipped
144
+ without an error. SQLite was not affected.
145
+ - **Eva's provider client no longer follows redirects.** A redirect from the AI provider (or
146
+ from the Controls connector test) is now an error, so the API key is never sent to another
147
+ address.
148
+ - **One rule for kept results.** The save, the draft preview (`/api/_draft`), a record's detail
149
+ and a trusted Session settle now use one internal rule to decide whether a saved document
150
+ keeps its stored results. Before, the preview and the detail left out confirmed and
151
+ cancelled confirmable documents, so they could show recalculated values (for example a price
152
+ read through a Link that changed after confirmation) that the save would not keep. A trusted
153
+ Session write still keeps only posted results, as before; the reason is written next to it.
154
+ - **Slips, report filters and dialogs refuse finite expressions.** They run the string rules and
155
+ have no finite plan yet, so `applies_when=` and the other finite rules were silently ignored and
156
+ `compute=F(...)` failed with a server error when the form was checked. Declaring one now raises
157
+ `ValueError` when the class is defined, naming the field and pointing to `visible_if`,
158
+ `required_if`, `read_only_if` and `compute='...'`. Move any such field to the string rules.
159
+
160
+ ### Upgrading
161
+
162
+ - People in a role that opens Controls (not admin) who have not set up two-step sign-in are
163
+ asked to set it up at their next sign-in, the same flow admins use. Their current browser
164
+ sessions stop working until they sign in again; API keys keep working. This needs the
165
+ instance to keep secrets (a secret key and the cryptography package); without them nothing
166
+ changes. To keep the old behaviour, an admin switches off "Roles that open Controls" under
167
+ Controls > Security > Two-step sign-in.
168
+
169
+ ## 0.4.3 (12-11-2026)
170
+
171
+ ### Added
172
+
173
+ - **Public websites from app frontends.** A sub-host whose root frontend has `auth=None` is a
174
+ public host. It serves only the site's own files and the `public=True` service endpoints its
175
+ API scopes list. `/login`, `/api/auth/session` and the rest of `/api`, `/_/...`,
176
+ `/.well-known/...` and `/health` answer 404 there, every refusal looks like the site's own
177
+ missing page, and pages carry no `evlet-config` block, so nothing names the instance, its
178
+ application or its version. The site owns every other path, `/docs` and `/assets` included.
179
+ See [Public websites](docs/routing.md#public-websites).
180
+ - **`Frontend(..., routing="pages")`** for multi-page static sites: `/about/` serves
181
+ `about/index.html`, `/pricing` serves `pricing.html`, the other form redirects (301) to the one
182
+ that exists, and an unknown path gets the frontend's `404.html` with status 404. `"app"` is the
183
+ default and keeps the single-page behaviour. See [Multi-page sites](docs/routing.md#multi-page-sites).
184
+ - **More file types for static frontends:** `txt`, `xml`, `webmanifest`, `pdf`, `gif`, `avif` and
185
+ `woff`, so `robots.txt` and `sitemap.xml` are served. HEAD works for pages and files.
186
+ - **`Frontend(..., suggested_host="www")`.** When `evlet install` adds the app to an instance with a
187
+ domain, it offers `www.<domain>` or your own domain and writes the `Host(...)` line into
188
+ `routes.py`. `--yes` takes the suggestion and `--no-host` skips it.
189
+ - **`evlet host add | remove | list`.** `host add acme www.example.com --root site.www` checks DNS,
190
+ edits `routes.py` safely, rewrites the Caddy site and, with `--apply`, installs it, reloads Caddy
191
+ and restarts the service. `--routes-only` suits Caddy with on-demand TLS. See
192
+ [Serve a website on its own host](docs/cli.md#serve-a-website-on-its-own-host).
193
+ - **`Host(root="app.frontend")`** names a frontend by its id, so `routes.py` needs no import.
194
+ - **Four SQLite files per instance.** `data/database.sqlite3` keeps records, the audit trail, the
195
+ journal, jobs, accounts and settings. Sign-in sessions, two-step tickets and sign-in attempts
196
+ move to `sessions.sqlite3`; the tool-call log, public rate counts and proxy header notes to
197
+ `logs.sqlite3`; Eva's chats, messages, files, usage and tasks to `eva.sqlite3`. All four use
198
+ WAL, and a write locks only the file it changes, so a long job no longer holds up sign-in, the
199
+ tool log or Eva. SQL names tables as before. `database.transaction(store="sessions")` (or
200
+ `"logs"`, `"eva"`) writes one side file only. See
201
+ [Busy writing on SQLite](docs/performance.md#busy-writing-on-sqlite).
202
+ - **Writers take turns.** Within a process each file has a line of writers: requests first, in
203
+ order, and a waiting job step goes next once it has waited 0.25 s, so jobs are never starved.
204
+ A resumable job gives up its turn after every step, and while people are writing it rests as
205
+ long as each step, so it gets about half of the file's time. With a job writing in 0.1 s
206
+ transactions, eight people completed 42 saves in 20 s on 0.4.2 (16 failed with "database is
207
+ locked") and 768 on 0.4.3 with none failed, against 779 with no job at all. The wait limit stays 5 s.
208
+ - **Slow write warning.** A write that holds a file longer than 1 s (`Database.slow_write`) logs
209
+ a warning naming the request or the job.
210
+ - **Batched counters.** API key last use, AI assistant call counts and proxy header notes are
211
+ saved by one background thread about every 250 ms, and on shutdown.
212
+ - **Delayed and follow-up jobs.** `Context.enqueue(..., run_at=...)` delays a job, and
213
+ `JobContext.follow_up(tx, payload=None, *, run_at, key=None)` queues a job's next run in its
214
+ own transaction with the same identity. See [Follow-up runs](docs/jobs-realtime.md#follow-up-runs).
215
+ - **`evlet backup` and `evlet restore`** copy and put back an instance's four files as one set.
216
+ Restore asks for the instance name (or `--yes NAME`), keeps the files it replaces, and also
217
+ takes a single-file backup from 0.4.2. See [Back up and restore](docs/cli.md#back-up-and-restore).
218
+ - `evlet.writes.data_files(path)` lists an instance's database files, and `evlet.writes.connect(path)`
219
+ opens a main file with the others attached, for tools that open SQLite themselves.
220
+ - `scripts/busy_queue_benchmark.py` and `scripts/benchmark_busy_writes.py` measure saves while a job writes.
221
+
222
+ ### Changed
223
+
224
+ - **The built-in System Administrator's username is now `admin`**, not `administrator`. Its full
225
+ name stays "System Administrator". `evlet migrate` runs the new step `0009_admin_username`,
226
+ which renames the 0.4.2 account and keeps its password, email and two-step sign-in. An instance
227
+ with an active admin already named `admin` (common before 0.4.2) keeps that account as the
228
+ Administrator, and the 0.4.2 `administrator` becomes an ordinary admin, disabled when it never
229
+ had a password. Any other account named `admin` stops the step until it is renamed. Sign in,
230
+ `evlet users set-password <instance> admin` and `evlet users set-email <instance> admin` use
231
+ the new name ([docs/app-upgrades.md](docs/app-upgrades.md#from-042-to-043)).
232
+ - **Caddy refuses a `Host` that differs from the TLS server name.** `evlet proxy --caddy` starts
233
+ with a global options block that turns on `strict_sni_host`. `evlet setup --host --apply`
234
+ installs it as `/etc/caddy/evlet-global.caddy` and imports it on the first line of the
235
+ Caddyfile; if your Caddyfile has its own global options block, it asks you to add the option
236
+ there. The nginx output answers such a request with 421. Run `evlet setup ... --host ... --apply`
237
+ again to update an existing site.
238
+ - `evlet proxy` no longer refuses `/controls` and `/docs` on a public host; the instance answers
239
+ them with the site's page or its 404.
240
+ - Framework step `0010_split_files` moves the tables on `evlet migrate`, after the backup, on the
241
+ staged copy. It checks row counts before dropping each table from the main file, is safe to run
242
+ again after a crash, and stops early when the disk is short. A no-op on PostgreSQL. See
243
+ [From 0.4.2 to 0.4.3](docs/app-upgrades.md#from-042-to-043).
244
+ - The moved tables no longer declare foreign keys to `evlet_users` (SQLite cannot check them
245
+ across files); Evlet removes sessions and Eva data of accounts that no longer exist at startup.
246
+ After a crash the side files are best effort for the last moment of writes.
247
+ - `evlet migrate` backs up and stages all four files, and checks free disk space first.
248
+
7
249
  ## 0.4.2 (11-11-2026)
8
250
 
9
251
  ### Added
@@ -2,6 +2,7 @@ include README.md CHANGELOG.md build_support.py
2
2
  include docs/*.md
3
3
  include examples/playground/*.py
4
4
  recursive-include examples/playground/portal *.html *.css *.js
5
+ recursive-include examples/playground/site *.html *.css *.txt *.xml
5
6
  include frontend/package.json frontend/package-lock.json frontend/index.html frontend/vite.config.js
6
7
  include frontend/.node-version frontend/.npmrc frontend/tsconfig.json
7
8
  recursive-include frontend/src *.ts *.css *.json
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: evlet
3
- Version: 0.4.2
3
+ Version: 0.4.4
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
@@ -59,8 +59,8 @@ evlet install notes --instance acme
59
59
  evlet serve acme
60
60
  ```
61
61
 
62
- Every instance has a built-in **System Administrator** (username `administrator`) with no
63
- password. `evlet serve` tells you to set one with `evlet users set-password acme administrator`;
62
+ Every instance has a built-in **System Administrator** (username `admin`) with no
63
+ password. `evlet serve` tells you to set one with `evlet users set-password acme admin`;
64
64
  then open **http://127.0.0.1:8000** and sign in. There is no default password. To serve a site on your own domain behind Caddy, see
65
65
  [Serve a site on a domain in one go](docs/cli.md#serve-a-site-on-a-domain-in-one-go).
66
66
 
@@ -122,7 +122,7 @@ opens at **http://127.0.0.1:8001**.
122
122
  `evlet playground` and `evlet dev` print a sign-in link for the built-in Administrator when they start:
123
123
 
124
124
  ```text
125
- The administrator account has no password yet. Open this link to sign in and choose one (works once, for 10 minutes):
125
+ The admin account has no password yet. Open this link to sign in and choose one (works once, for 10 minutes):
126
126
  http://127.0.0.1:8000/_dev/signin?token=...
127
127
  ```
128
128
 
@@ -30,8 +30,8 @@ evlet install notes --instance acme
30
30
  evlet serve acme
31
31
  ```
32
32
 
33
- Every instance has a built-in **System Administrator** (username `administrator`) with no
34
- password. `evlet serve` tells you to set one with `evlet users set-password acme administrator`;
33
+ Every instance has a built-in **System Administrator** (username `admin`) with no
34
+ password. `evlet serve` tells you to set one with `evlet users set-password acme admin`;
35
35
  then open **http://127.0.0.1:8000** and sign in. There is no default password. To serve a site on your own domain behind Caddy, see
36
36
  [Serve a site on a domain in one go](docs/cli.md#serve-a-site-on-a-domain-in-one-go).
37
37
 
@@ -93,7 +93,7 @@ opens at **http://127.0.0.1:8001**.
93
93
  `evlet playground` and `evlet dev` print a sign-in link for the built-in Administrator when they start:
94
94
 
95
95
  ```text
96
- The administrator account has no password yet. Open this link to sign in and choose one (works once, for 10 minutes):
96
+ The admin account has no password yet. Open this link to sign in and choose one (works once, for 10 minutes):
97
97
  http://127.0.0.1:8000/_dev/signin?token=...
98
98
  ```
99
99
 
@@ -18,6 +18,7 @@ class BuildPy(build_py):
18
18
  for name in ('app.py', 'items.py', 'models.py', 'migrate.py', 'prints.py', 'reports.py', 'settings.py', 'slips.py', 'workspaces.py'):
19
19
  shutil.copy2(root / 'examples/playground' / name, playground / name)
20
20
  shutil.copytree(root / 'examples/playground/portal', playground / 'portal', dirs_exist_ok=True)
21
+ shutil.copytree(root / 'examples/playground/site', playground / 'site', dirs_exist_ok=True)
21
22
  docs = resources / 'docs'
22
23
  docs.mkdir(parents=True, exist_ok=True)
23
24
  for path in (root / 'docs').glob('*.md'):
@@ -1,8 +1,21 @@
1
1
  # Upgrade or retire an app
2
2
 
3
- Apps are shared source code; instances hold separate data. There is no automated
4
- `upgrade`, `uninstall`, `restore` or backup-cleanup command yet. Use the explicit
5
- workflow below.
3
+ Apps are shared source code; instances hold separate data. Evlet has no automated
4
+ app `upgrade` or `uninstall` command and does not clean up old backups. Use the
5
+ explicit workflow below.
6
+
7
+ `evlet backup` and `evlet restore` save and put back an instance's database
8
+ ([cli.md](cli.md#back-up-and-restore)):
9
+
10
+ ```sh
11
+ evlet backup --instance acme
12
+ evlet restore instances/acme/data/backups/20261112T061500000000Z.sqlite3 --instance acme
13
+ ```
14
+
15
+ `evlet backup` copies the instance's four SQLite files into `data/backups/` while the
16
+ server may keep running. `evlet restore` puts a set back with the server stopped,
17
+ after keeping a copy of the files it replaces. Both hold only the database: keep
18
+ `secret.key`, `files/` and the app sources with them.
6
19
 
7
20
  ## Upgrade an app
8
21
 
@@ -10,8 +23,10 @@ workflow below.
10
23
  version, its dependency changes and appended migrations.
11
24
  2. Keep a copy of the project while it is stopped, including app source,
12
25
  `instances/*/config.py`, `apps.lock`, databases and private files. Keep the Python
13
- environment's dependency lock too. An automatic SQLite backup contains only
14
- database data, not uploaded files or app source.
26
+ environment's dependency lock too. `evlet backup --instance acme` makes a
27
+ database backup you can put back with `evlet restore`. It, like the automatic
28
+ backup `evlet migrate` writes, contains only database data, not uploaded files,
29
+ `secret.key` or app source.
15
30
  3. Update the app's source to the reviewed revision. For an app fetched from Git,
16
31
  fetch the remote and check out the app's reviewed tag or commit. For example:
17
32
 
@@ -37,7 +52,9 @@ workflow below.
37
52
 
38
53
  A changed installation is staged and checked before publication. On a migration
39
54
  failure the current database and lock remain intact. Restore the matching old
40
- source before restarting an instance whose migration failed. An unchanged
55
+ source before restarting an instance whose migration failed. To go back to the
56
+ database as it was before a migration that succeeded, stop the instance, restore
57
+ the old source and run `evlet restore` with the backup `evlet migrate` printed. An unchanged
41
58
  `migrate`, with the same apps and the same Evlet version, validates the current
42
59
  instance without making another full backup.
43
60
 
@@ -65,6 +82,10 @@ framework versioning have no `evlet` entry and are treated the same way. To upgr
65
82
  The output lists the framework migrations it applied and the backup path.
66
83
  4. Start the instance and check it.
67
84
 
85
+ On a server set up with `evlet setup --host --apply`, `evlet upgrade acme` runs these steps
86
+ for you after one question, and prints the rollback commands when one fails
87
+ ([cli.md](cli.md#upgrade-evlet-on-a-server)).
88
+
68
89
  Framework migrations are ordered, checksummed steps recorded in the
69
90
  `evlet_framework_migrations` table with the Evlet version that applied them. The
70
91
  first step, `0001_startup_tables`, adopts the tables that Evlet 0.2.0 and earlier
@@ -79,7 +100,9 @@ modified time and user columns to every model table and fills them from the Jour
79
100
  unsaved changes people leave on saved records ([ui.md](ui.md#unsaved-changes)). `0006_fixed_ids` adds the
80
101
  trigger that refuses an id change to every model table ([model-engine.md](model-engine.md#only-evlet-makes-ids)). `0007_money_scale` records that every
81
102
  Currency amount is stored at 6 places; `evlet migrate` moves the amounts before any app migration runs
82
- ([model-engine.md](model-engine.md#decimal-places-per-currency)). Steps never run while an instance is served.
103
+ ([model-engine.md](model-engine.md#decimal-places-per-currency)). `0010_split_files` moves sign-in sessions, the
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
+ Steps never run while an instance is served.
83
106
  `evlet migrate acme --plan` lists the pending ones without writing anything. If a step fails, the staged copy is
84
107
  discarded and the database and lock stay as they were; restore the earlier Evlet
85
108
  before restarting.
@@ -97,6 +120,61 @@ first applies the steps and the others find them applied. Do not keep data you c
97
120
  Main uses a development version between releases; a source build is not the same
98
121
  artifact as the last PyPI release.
99
122
 
123
+ ### From 0.4.2 to 0.4.3
124
+
125
+ 0.4.3 renames the built-in System Administrator's username from `administrator` to `admin`, and splits
126
+ each instance's SQLite database into four files with writers taking turns, so a long job no longer
127
+ makes pages fail with "database is locked". Apps keep their `evlet>=0.4.0,<0.5` dependency.
128
+
129
+ `evlet migrate` applies both steps in order, after one backup.
130
+
131
+ The Administrator's username:
132
+
133
+ - Run `evlet migrate` for each instance. It applies `0009_admin_username`, which renames the
134
+ account and keeps its password, email and two-step sign-in. Sign in as `admin` afterwards.
135
+ - An instance that also has an ordinary active admin named `admin` keeps that account as the
136
+ Administrator, with its own password. The 0.4.2 `administrator` account becomes an ordinary
137
+ admin, disabled when it never had a password. Remove it in Controls if you don't need it.
138
+ - An account named `admin` that is not an active admin stops the step: rename it first.
139
+ - Tests and scripts that sign in as `administrator` use `admin`. A test fixture that adds its own
140
+ account named `admin` now meets the Administrator: give it a password instead of inserting it,
141
+ for example with `INSERT ... ON CONFLICT(username) DO UPDATE SET password=excluded.password`.
142
+ Set any other column the fixture needs, such as `allow_mcp`, in the same update.
143
+ - Setting up `admin` through `/api/auth/setup` gives the Administrator its password, so the
144
+ accounts a test adds after it start at 2 again, as before 0.4.2. Records it writes show
145
+ "Administrator" or "System Administrator", not "admin".
146
+ - The Administrator passes every role check. A test that checks a Rule limiting the admin role
147
+ needs an ordinary admin with another username, such as `owner`.
148
+
149
+ The four SQLite files:
150
+
151
+ - Stop the instance and run `evlet migrate` before you serve it. It backs up
152
+ `data/database.sqlite3` first, then step `0010_split_files` moves these tables out of it:
153
+ `evlet_sessions`, `evlet_two_step_tickets` and `evlet_login_limits` into `sessions.sqlite3`;
154
+ `evlet_tool_calls`, `evlet_public_limits` and `evlet_forwarded_peers` into `logs.sqlite3`; and
155
+ the ten `evlet_eva_*` tables into `eva.sqlite3`. Everything else stays in `database.sqlite3`.
156
+ People stay signed in and nothing else changes for them.
157
+ - The move copies each table with its rows, indexes and id counter, checks that the row counts
158
+ match, and only then drops it from the main file. It works on the staged copy `evlet migrate`
159
+ already uses, so a failure leaves the instance as it was, and it is safe to run again after a
160
+ crash at any point. It first checks the disk has room for the backup, the staged copy and the
161
+ moved tables, and stops with a clear message, changing nothing, when it does not.
162
+ - Back up and restore the four files together: `evlet backup --instance NAME` and
163
+ `evlet restore BACKUP --instance NAME` are new ([cli.md](cli.md#back-up-and-restore)). A
164
+ single-file backup from 0.4.2 still restores; run `evlet migrate` after it.
165
+ - App code keeps naming tables as before: SQL finds a table in whichever file holds it. A
166
+ write transaction that touches a sessions, logs or Eva table takes that file's turn too.
167
+ Code that opens the SQLite file itself with `sqlite3.connect` sees only the main file; use
168
+ `evlet.writes.connect(path)` to get the others attached.
169
+ - SQLite cannot check a foreign key from one file to another, so the moved tables no longer
170
+ declare one to `evlet_users`; Evlet checks those links itself. A table in your app should not
171
+ reference a moved table.
172
+ - New for jobs: `Context.enqueue(..., run_at=...)` delays a job, and a running job queues its
173
+ own next run with `context.follow_up(tx, payload, run_at=...)`, in the same transaction and
174
+ with the same identity ([jobs-realtime.md](jobs-realtime.md#follow-up-runs)). An app that
175
+ 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
+
100
178
  ### From 0.4.1 to 0.4.2
101
179
 
102
180
  0.4.2 adds the built-in System Administrator and new sign-in rules in config.py. Apps keep
@@ -193,7 +271,10 @@ requires trust. Keep `apps.lock` and its matching database together.
193
271
  ## Keep backups manageable
194
272
 
195
273
  Changed installs and Evlet upgrades save a timestamped SQLite backup under the
196
- instance's `data/backups/`. Unchanged migrations do not add one. There is no retention command.
274
+ instance's `data/backups/`: the main file `<time>.sqlite3` and, from 0.4.3, its
275
+ `<time>-sessions.sqlite3`, `<time>-logs.sqlite3` and `<time>-eva.sqlite3`. `evlet backup` writes
276
+ the same kind of set. Keep or remove the files of a set together. Unchanged migrations do not add one. There is no retention command.
197
277
  After verifying recovery, remove obsolete backup files according to your own
198
278
  retention policy while keeping the source, lock and private files needed to restore
199
- each retained snapshot. Never delete the active `data/database.sqlite3` file.
279
+ each retained snapshot. Never delete the active `data/database.sqlite3` file or its `sessions`, `logs` and `eva`
280
+ files.
@@ -106,7 +106,10 @@ A scope returns the same bounded typed filter object as an ordinary query, or on
106
106
  the team forms below. It is
107
107
  combined with client filters using AND in SQL, before pagination and counting.
108
108
  The same scope checks record reads, writes, actions, attachments, and referenced
109
- Link values. Creates and updates that leave the allowed scope roll back. Write
109
+ Link values. A Link or Reference to a record outside the scope shows as empty on every
110
+ read: lists, details, draft previews and calculated values. A calculated field that reads
111
+ a child table, a Link lookup or a `Query` source with a scope for this role is not shown
112
+ to the role at all, because it was built from rows the role cannot see. Creates and updates that leave the allowed scope roll back. Write
110
113
  permissions require read access. Omitted field sets mean all fields; empty tuples
111
114
  mean no fields. `read_only` fields also reject HTTP writes.
112
115