evlet 0.4.2__tar.gz → 0.4.3__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 (359) hide show
  1. {evlet-0.4.2 → evlet-0.4.3}/CHANGELOG.md +80 -0
  2. {evlet-0.4.2 → evlet-0.4.3}/MANIFEST.in +1 -0
  3. {evlet-0.4.2/evlet.egg-info → evlet-0.4.3}/PKG-INFO +4 -4
  4. {evlet-0.4.2 → evlet-0.4.3}/README.md +3 -3
  5. {evlet-0.4.2 → evlet-0.4.3}/build_support.py +1 -0
  6. {evlet-0.4.2 → evlet-0.4.3}/docs/app-upgrades.md +63 -3
  7. {evlet-0.4.2 → evlet-0.4.3}/docs/cli.md +107 -15
  8. {evlet-0.4.2 → evlet-0.4.3}/docs/controls.md +6 -6
  9. {evlet-0.4.2 → evlet-0.4.3}/docs/jobs-realtime.md +35 -2
  10. {evlet-0.4.2 → evlet-0.4.3}/docs/performance.md +104 -0
  11. {evlet-0.4.2 → evlet-0.4.3}/docs/postgresql.md +5 -0
  12. {evlet-0.4.2 → evlet-0.4.3}/docs/production-operations.md +18 -2
  13. {evlet-0.4.2 → evlet-0.4.3}/docs/routing.md +89 -9
  14. {evlet-0.4.2 → evlet-0.4.3}/docs/tenancy-deployment.md +1 -1
  15. {evlet-0.4.2 → evlet-0.4.3}/docs/ui.md +1 -1
  16. {evlet-0.4.2 → evlet-0.4.3}/evlet/app.py +33 -5
  17. {evlet-0.4.2 → evlet-0.4.3}/evlet/assistants.py +4 -0
  18. {evlet-0.4.2 → evlet-0.4.3}/evlet/auth.py +48 -25
  19. evlet-0.4.3/evlet/cli/backup.py +116 -0
  20. evlet-0.4.3/evlet/cli/hosts.py +283 -0
  21. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/install.py +41 -15
  22. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/instance.py +1 -1
  23. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/main.py +64 -0
  24. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/proxy.py +23 -7
  25. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/serve.py +3 -2
  26. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/site.py +32 -2
  27. {evlet-0.4.2 → evlet-0.4.3}/evlet/controls.py +5 -4
  28. {evlet-0.4.2 → evlet-0.4.3}/evlet/database.py +143 -20
  29. {evlet-0.4.2 → evlet-0.4.3}/evlet/documents.py +5 -4
  30. {evlet-0.4.2 → evlet-0.4.3}/evlet/eva.py +21 -10
  31. {evlet-0.4.2 → evlet-0.4.3}/evlet/framework.py +10 -2
  32. {evlet-0.4.2 → evlet-0.4.3}/evlet/images.py +2 -1
  33. {evlet-0.4.2 → evlet-0.4.3}/evlet/instances.py +1 -1
  34. {evlet-0.4.2 → evlet-0.4.3}/evlet/jobs.py +51 -3
  35. {evlet-0.4.2 → evlet-0.4.3}/evlet/postgres.py +7 -2
  36. {evlet-0.4.2 → evlet-0.4.3}/evlet/routing.py +56 -5
  37. {evlet-0.4.2 → evlet-0.4.3}/evlet/secrets.py +3 -2
  38. {evlet-0.4.2 → evlet-0.4.3}/evlet/services.py +1 -1
  39. {evlet-0.4.2 → evlet-0.4.3}/evlet/states.py +2 -2
  40. {evlet-0.4.2 → evlet-0.4.3}/evlet/tools.py +8 -4
  41. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/routes.py +16 -3
  42. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/serving.py +68 -15
  43. evlet-0.4.3/evlet/writes.py +501 -0
  44. {evlet-0.4.2 → evlet-0.4.3/evlet.egg-info}/PKG-INFO +4 -4
  45. {evlet-0.4.2 → evlet-0.4.3}/evlet.egg-info/SOURCES.txt +9 -0
  46. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/app.py +10 -3
  47. evlet-0.4.3/examples/playground/site/404.html +16 -0
  48. evlet-0.4.3/examples/playground/site/about/index.html +16 -0
  49. evlet-0.4.3/examples/playground/site/index.html +17 -0
  50. evlet-0.4.3/examples/playground/site/robots.txt +3 -0
  51. evlet-0.4.3/examples/playground/site/site.css +4 -0
  52. evlet-0.4.3/examples/playground/site/sitemap.xml +5 -0
  53. {evlet-0.4.2 → evlet-0.4.3}/pyproject.toml +1 -1
  54. {evlet-0.4.2 → evlet-0.4.3}/LICENSE +0 -0
  55. {evlet-0.4.2 → evlet-0.4.3}/docs/amendment-v2.md +0 -0
  56. {evlet-0.4.2 → evlet-0.4.3}/docs/api-stability.md +0 -0
  57. {evlet-0.4.2 → evlet-0.4.3}/docs/application-generation.md +0 -0
  58. {evlet-0.4.2 → evlet-0.4.3}/docs/architecture.md +0 -0
  59. {evlet-0.4.2 → evlet-0.4.3}/docs/business-capabilities.md +0 -0
  60. {evlet-0.4.2 → evlet-0.4.3}/docs/connector.md +0 -0
  61. {evlet-0.4.2 → evlet-0.4.3}/docs/customizing.md +0 -0
  62. {evlet-0.4.2 → evlet-0.4.3}/docs/document-lifecycle.md +0 -0
  63. {evlet-0.4.2 → evlet-0.4.3}/docs/effects.md +0 -0
  64. {evlet-0.4.2 → evlet-0.4.3}/docs/eva.md +0 -0
  65. {evlet-0.4.2 → evlet-0.4.3}/docs/finite-calculations.md +0 -0
  66. {evlet-0.4.2 → evlet-0.4.3}/docs/getting-started.md +0 -0
  67. {evlet-0.4.2 → evlet-0.4.3}/docs/journal.md +0 -0
  68. {evlet-0.4.2 → evlet-0.4.3}/docs/ledger.md +0 -0
  69. {evlet-0.4.2 → evlet-0.4.3}/docs/lifecycle-specification.md +0 -0
  70. {evlet-0.4.2 → evlet-0.4.3}/docs/meaning.md +0 -0
  71. {evlet-0.4.2 → evlet-0.4.3}/docs/measures.md +0 -0
  72. {evlet-0.4.2 → evlet-0.4.3}/docs/model-engine.md +0 -0
  73. {evlet-0.4.2 → evlet-0.4.3}/docs/printing.md +0 -0
  74. {evlet-0.4.2 → evlet-0.4.3}/docs/reports.md +0 -0
  75. {evlet-0.4.2 → evlet-0.4.3}/docs/sequences.md +0 -0
  76. {evlet-0.4.2 → evlet-0.4.3}/docs/settings.md +0 -0
  77. {evlet-0.4.2 → evlet-0.4.3}/docs/slips.md +0 -0
  78. {evlet-0.4.2 → evlet-0.4.3}/docs/states-actions.md +0 -0
  79. {evlet-0.4.2 → evlet-0.4.3}/docs/tools.md +0 -0
  80. {evlet-0.4.2 → evlet-0.4.3}/docs/ui-framework.md +0 -0
  81. {evlet-0.4.2 → evlet-0.4.3}/evlet/__init__.py +0 -0
  82. {evlet-0.4.2 → evlet-0.4.3}/evlet/__main__.py +0 -0
  83. {evlet-0.4.2 → evlet-0.4.3}/evlet/audit.py +0 -0
  84. {evlet-0.4.2 → evlet-0.4.3}/evlet/builds.py +0 -0
  85. {evlet-0.4.2 → evlet-0.4.3}/evlet/business.py +0 -0
  86. {evlet-0.4.2 → evlet-0.4.3}/evlet/calc.py +0 -0
  87. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/__init__.py +0 -0
  88. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/app.py +0 -0
  89. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/connector.py +0 -0
  90. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/devlink.py +0 -0
  91. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/docs.py +0 -0
  92. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/effects.py +0 -0
  93. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/ids.py +0 -0
  94. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/jobs.py +0 -0
  95. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/journal.py +0 -0
  96. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/ledger.py +0 -0
  97. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/playground.py +0 -0
  98. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/project.py +0 -0
  99. {evlet-0.4.2 → evlet-0.4.3}/evlet/cli/setup.py +0 -0
  100. {evlet-0.4.2 → evlet-0.4.3}/evlet/connector.py +0 -0
  101. {evlet-0.4.2 → evlet-0.4.3}/evlet/connectors.py +0 -0
  102. {evlet-0.4.2 → evlet-0.4.3}/evlet/controls_export.py +0 -0
  103. {evlet-0.4.2 → evlet-0.4.3}/evlet/controls_system.py +0 -0
  104. {evlet-0.4.2 → evlet-0.4.3}/evlet/corrections.py +0 -0
  105. {evlet-0.4.2 → evlet-0.4.3}/evlet/currencies.py +0 -0
  106. {evlet-0.4.2 → evlet-0.4.3}/evlet/customization.py +0 -0
  107. {evlet-0.4.2 → evlet-0.4.3}/evlet/declarations.py +0 -0
  108. {evlet-0.4.2 → evlet-0.4.3}/evlet/deployment.py +0 -0
  109. {evlet-0.4.2 → evlet-0.4.3}/evlet/devlink.py +0 -0
  110. {evlet-0.4.2 → evlet-0.4.3}/evlet/discovery.py +0 -0
  111. {evlet-0.4.2 → evlet-0.4.3}/evlet/effects.py +0 -0
  112. {evlet-0.4.2 → evlet-0.4.3}/evlet/events.py +0 -0
  113. {evlet-0.4.2 → evlet-0.4.3}/evlet/expressions.py +0 -0
  114. {evlet-0.4.2 → evlet-0.4.3}/evlet/fields.py +0 -0
  115. {evlet-0.4.2 → evlet-0.4.3}/evlet/forms.py +0 -0
  116. {evlet-0.4.2 → evlet-0.4.3}/evlet/identity.py +0 -0
  117. {evlet-0.4.2 → evlet-0.4.3}/evlet/indexes.py +0 -0
  118. {evlet-0.4.2 → evlet-0.4.3}/evlet/journal.py +0 -0
  119. {evlet-0.4.2 → evlet-0.4.3}/evlet/ledger.py +0 -0
  120. {evlet-0.4.2 → evlet-0.4.3}/evlet/lifecycle.py +0 -0
  121. {evlet-0.4.2 → evlet-0.4.3}/evlet/mailboxes.py +0 -0
  122. {evlet-0.4.2 → evlet-0.4.3}/evlet/mcp.py +0 -0
  123. {evlet-0.4.2 → evlet-0.4.3}/evlet/meaning.py +0 -0
  124. {evlet-0.4.2 → evlet-0.4.3}/evlet/measures.py +0 -0
  125. {evlet-0.4.2 → evlet-0.4.3}/evlet/mentions.py +0 -0
  126. {evlet-0.4.2 → evlet-0.4.3}/evlet/migrations.py +0 -0
  127. {evlet-0.4.2 → evlet-0.4.3}/evlet/models.py +0 -0
  128. {evlet-0.4.2 → evlet-0.4.3}/evlet/naming.py +0 -0
  129. {evlet-0.4.2 → evlet-0.4.3}/evlet/object_storage.py +0 -0
  130. {evlet-0.4.2 → evlet-0.4.3}/evlet/packages.py +0 -0
  131. {evlet-0.4.2 → evlet-0.4.3}/evlet/periods.py +0 -0
  132. {evlet-0.4.2 → evlet-0.4.3}/evlet/permissions.py +0 -0
  133. {evlet-0.4.2 → evlet-0.4.3}/evlet/postgres_schema.py +0 -0
  134. {evlet-0.4.2 → evlet-0.4.3}/evlet/printing.py +0 -0
  135. {evlet-0.4.2 → evlet-0.4.3}/evlet/py.typed +0 -0
  136. {evlet-0.4.2 → evlet-0.4.3}/evlet/query.py +0 -0
  137. {evlet-0.4.2 → evlet-0.4.3}/evlet/reactivity.py +0 -0
  138. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/__init__.py +0 -0
  139. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/print/fonts/NotoSans-Bold.woff2 +0 -0
  140. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/print/fonts/NotoSans-OFL.txt +0 -0
  141. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/print/fonts/NotoSans-Regular.woff2 +0 -0
  142. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/print/fonts/NotoSansArabic-Bold.woff2 +0 -0
  143. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/print/fonts/NotoSansArabic-OFL.txt +0 -0
  144. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/print/fonts/NotoSansArabic-Regular.woff2 +0 -0
  145. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/.gitignore.tpl +0 -0
  146. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/README.md.tpl +0 -0
  147. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/__app__/__init__.py.tpl +0 -0
  148. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/__app__/actions/__init__.py.tpl +0 -0
  149. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/__app__/hooks.py.tpl +0 -0
  150. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/__app__/migrations/__init__.py.tpl +0 -0
  151. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/__app__/models/__init__.py.tpl +0 -0
  152. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/__app__/permissions.py.tpl +0 -0
  153. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/pyproject.toml.tpl +0 -0
  154. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app/tests/test_models.py.tpl +0 -0
  155. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app_flat/.gitignore.tpl +0 -0
  156. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app_flat/README.md.tpl +0 -0
  157. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app_flat/__init__.py.tpl +0 -0
  158. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app_flat/models/__init__.py.tpl +0 -0
  159. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app_flat/models/item.py.tpl +0 -0
  160. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app_flat/pyproject.toml.tpl +0 -0
  161. {evlet-0.4.2 → evlet-0.4.3}/evlet/resources/templates/app_flat/setup.py.tpl +0 -0
  162. {evlet-0.4.2 → evlet-0.4.3}/evlet/richtext.py +0 -0
  163. {evlet-0.4.2 → evlet-0.4.3}/evlet/sections.py +0 -0
  164. {evlet-0.4.2 → evlet-0.4.3}/evlet/sequences.py +0 -0
  165. {evlet-0.4.2 → evlet-0.4.3}/evlet/serverless.py +0 -0
  166. {evlet-0.4.2 → evlet-0.4.3}/evlet/settings.py +0 -0
  167. {evlet-0.4.2 → evlet-0.4.3}/evlet/slips.py +0 -0
  168. {evlet-0.4.2 → evlet-0.4.3}/evlet/storage.py +0 -0
  169. {evlet-0.4.2 → evlet-0.4.3}/evlet/tenancy.py +0 -0
  170. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/__init__.py +0 -0
  171. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/application.py +0 -0
  172. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/metadata.py +0 -0
  173. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/IBMPlexSans-OFL.txt +0 -0
  174. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/JetBrainsMono-Medium-3S3k2nMz.woff2 +0 -0
  175. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/JetBrainsMono-OFL.txt +0 -0
  176. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/JetBrainsMono-Regular-BQaDgvhP.woff2 +0 -0
  177. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ai-BoNaQPi6.js +0 -0
  178. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/app-0SduO6OB.css +0 -0
  179. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/app-CJDDr7hE.js +0 -0
  180. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/consent-CJkpbF5L.js +0 -0
  181. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/email-BAMmEqz2.js +0 -0
  182. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/evlet-icon-blue.svg +0 -0
  183. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/evlet-logo-primary.svg +0 -0
  184. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/evlet-logo-white.svg +0 -0
  185. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-400-italic-CZTNEAuW.woff2 +0 -0
  186. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-400-normal-CDDApCn2.woff2 +0 -0
  187. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-500-normal-6ng42L7E.woff2 +0 -0
  188. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-600-normal-CuJfVYMP.woff2 +0 -0
  189. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-700-normal-Bxkt5Cjx.woff2 +0 -0
  190. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-400-italic-Du9zzoL2.woff2 +0 -0
  191. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-400-normal-C5H60-Va.woff2 +0 -0
  192. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-500-normal-DakdToA3.woff2 +0 -0
  193. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-600-normal-DOrvGEcy.woff2 +0 -0
  194. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/ibm-plex-sans-latin-ext-700-normal-aMgXseD4.woff2 +0 -0
  195. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/index-D1OKAsr0.js +0 -0
  196. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/index-UqEST1u4.css +0 -0
  197. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/assets/keys-D9Qq-LDr.js +0 -0
  198. {evlet-0.4.2 → evlet-0.4.3}/evlet/ui/static/index.html +0 -0
  199. {evlet-0.4.2 → evlet-0.4.3}/evlet/unsaved.py +0 -0
  200. {evlet-0.4.2 → evlet-0.4.3}/evlet/workspaces.py +0 -0
  201. {evlet-0.4.2 → evlet-0.4.3}/evlet.egg-info/dependency_links.txt +0 -0
  202. {evlet-0.4.2 → evlet-0.4.3}/evlet.egg-info/entry_points.txt +0 -0
  203. {evlet-0.4.2 → evlet-0.4.3}/evlet.egg-info/requires.txt +0 -0
  204. {evlet-0.4.2 → evlet-0.4.3}/evlet.egg-info/top_level.txt +0 -0
  205. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/items.py +0 -0
  206. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/manage.py +0 -0
  207. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/migrate.py +0 -0
  208. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/models.py +0 -0
  209. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/portal/index.html +0 -0
  210. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/portal/portal.css +0 -0
  211. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/portal/portal.js +0 -0
  212. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/prints.py +0 -0
  213. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/reports.py +0 -0
  214. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/settings.py +0 -0
  215. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/slips.py +0 -0
  216. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/team.py +0 -0
  217. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/tenants.py +0 -0
  218. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/worker.py +0 -0
  219. {evlet-0.4.2 → evlet-0.4.3}/examples/playground/workspaces.py +0 -0
  220. {evlet-0.4.2 → evlet-0.4.3}/frontend/.node-version +0 -0
  221. {evlet-0.4.2 → evlet-0.4.3}/frontend/.npmrc +0 -0
  222. {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/IBMPlexSans-OFL.txt +0 -0
  223. {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/JetBrainsMono-Medium.woff2 +0 -0
  224. {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/JetBrainsMono-OFL.txt +0 -0
  225. {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/JetBrainsMono-Regular.woff2 +0 -0
  226. {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-400-italic.woff2 +0 -0
  227. {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-400-normal.woff2 +0 -0
  228. {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-500-normal.woff2 +0 -0
  229. {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-600-normal.woff2 +0 -0
  230. {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-700-normal.woff2 +0 -0
  231. {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-ext-400-italic.woff2 +0 -0
  232. {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-ext-400-normal.woff2 +0 -0
  233. {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-ext-500-normal.woff2 +0 -0
  234. {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-ext-600-normal.woff2 +0 -0
  235. {evlet-0.4.2 → evlet-0.4.3}/frontend/fonts/ibm-plex-sans-latin-ext-700-normal.woff2 +0 -0
  236. {evlet-0.4.2 → evlet-0.4.3}/frontend/index.html +0 -0
  237. {evlet-0.4.2 → evlet-0.4.3}/frontend/package-lock.json +0 -0
  238. {evlet-0.4.2 → evlet-0.4.3}/frontend/package.json +0 -0
  239. {evlet-0.4.2 → evlet-0.4.3}/frontend/public/assets/evlet-icon-blue.svg +0 -0
  240. {evlet-0.4.2 → evlet-0.4.3}/frontend/public/assets/evlet-logo-primary.svg +0 -0
  241. {evlet-0.4.2 → evlet-0.4.3}/frontend/public/assets/evlet-logo-white.svg +0 -0
  242. {evlet-0.4.2 → evlet-0.4.3}/frontend/scripts/bench-ui.mjs +0 -0
  243. {evlet-0.4.2 → evlet-0.4.3}/frontend/scripts/dev-proxy.mjs +0 -0
  244. {evlet-0.4.2 → evlet-0.4.3}/frontend/scripts/dev-proxy.test.mjs +0 -0
  245. {evlet-0.4.2 → evlet-0.4.3}/frontend/scripts/install-ui.mjs +0 -0
  246. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/api.ts +0 -0
  247. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/app.ts +0 -0
  248. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/client.ts +0 -0
  249. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/composer.ts +0 -0
  250. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/config.ts +0 -0
  251. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/context.ts +0 -0
  252. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/docs.ts +0 -0
  253. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/duplicate.ts +0 -0
  254. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/explorer.ts +0 -0
  255. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/filters.ts +0 -0
  256. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/inbox.ts +0 -0
  257. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/last-page.ts +0 -0
  258. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/list-page.ts +0 -0
  259. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/login.ts +0 -0
  260. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/main.ts +0 -0
  261. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/meta.ts +0 -0
  262. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/nav-icons.ts +0 -0
  263. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/palette.ts +0 -0
  264. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/prefs.ts +0 -0
  265. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/recents.ts +0 -0
  266. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/record-blocks.ts +0 -0
  267. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/record-compact.ts +0 -0
  268. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/record-page.ts +0 -0
  269. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/related-data.ts +0 -0
  270. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/report-page.ts +0 -0
  271. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/revisions.ts +0 -0
  272. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/screens.css +0 -0
  273. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/settings.css +0 -0
  274. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/settings.ts +0 -0
  275. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/shell.ts +0 -0
  276. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/shortcuts.ts +0 -0
  277. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/slips.ts +0 -0
  278. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/unsaved-bar.ts +0 -0
  279. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/unsaved.ts +0 -0
  280. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/workspace-editor.ts +0 -0
  281. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/app/workspaces.ts +0 -0
  282. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/access.ts +0 -0
  283. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/ai.ts +0 -0
  284. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/app.ts +0 -0
  285. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/client.ts +0 -0
  286. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/connections.ts +0 -0
  287. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/controls.css +0 -0
  288. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/currencies.ts +0 -0
  289. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/drafts.ts +0 -0
  290. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/eva.ts +0 -0
  291. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/keys.ts +0 -0
  292. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/log.ts +0 -0
  293. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/models.ts +0 -0
  294. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/naming.ts +0 -0
  295. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/people.ts +0 -0
  296. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/periods.ts +0 -0
  297. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/prints.ts +0 -0
  298. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/system.ts +0 -0
  299. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/controls/unsaved.ts +0 -0
  300. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/dev.ts +0 -0
  301. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/dom.ts +0 -0
  302. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/eva/chat.ts +0 -0
  303. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/eva/client.ts +0 -0
  304. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/eva/eva.css +0 -0
  305. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/eva/tasks.ts +0 -0
  306. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ids.ts +0 -0
  307. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/changes.ts +0 -0
  308. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/finite.ts +0 -0
  309. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/format.ts +0 -0
  310. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/links.ts +0 -0
  311. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/record.ts +0 -0
  312. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/schema.ts +0 -0
  313. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/session.ts +0 -0
  314. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/model/unsaved.ts +0 -0
  315. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/reactive.ts +0 -0
  316. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/editor.ts +0 -0
  317. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/history.ts +0 -0
  318. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/html.ts +0 -0
  319. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/images.ts +0 -0
  320. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/model.ts +0 -0
  321. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/ops.ts +0 -0
  322. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/render.ts +0 -0
  323. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/richtext/richtext.css +0 -0
  324. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/router.ts +0 -0
  325. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/settings/ai.ts +0 -0
  326. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/settings/consent.ts +0 -0
  327. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/settings/email.ts +0 -0
  328. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/settings/keys.ts +0 -0
  329. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/autofocus.ts +0 -0
  330. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/base.ts +0 -0
  331. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/catalog.json +0 -0
  332. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/chart.ts +0 -0
  333. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/childtable.ts +0 -0
  334. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/core.ts +0 -0
  335. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/dateparse.ts +0 -0
  336. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/doc.ts +0 -0
  337. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/draglist.ts +0 -0
  338. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/explain.ts +0 -0
  339. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/fields.ts +0 -0
  340. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/fold.ts +0 -0
  341. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/icon-data.ts +0 -0
  342. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/index.ts +0 -0
  343. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/inline.ts +0 -0
  344. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/kinds.ts +0 -0
  345. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/layers.ts +0 -0
  346. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/library.ts +0 -0
  347. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/list.ts +0 -0
  348. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/money.ts +0 -0
  349. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/pickers.ts +0 -0
  350. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/shortcuts.ts +0 -0
  351. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/split.ts +0 -0
  352. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/styles.css +0 -0
  353. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/table.ts +0 -0
  354. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/theme.ts +0 -0
  355. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/time.ts +0 -0
  356. {evlet-0.4.2 → evlet-0.4.3}/frontend/src/evlet/ui/tooltip.ts +0 -0
  357. {evlet-0.4.2 → evlet-0.4.3}/frontend/tsconfig.json +0 -0
  358. {evlet-0.4.2 → evlet-0.4.3}/frontend/vite.config.js +0 -0
  359. {evlet-0.4.2 → evlet-0.4.3}/setup.cfg +0 -0
@@ -4,6 +4,86 @@ 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.3 (12-11-2026)
8
+
9
+ ### Added
10
+
11
+ - **Public websites from app frontends.** A sub-host whose root frontend has `auth=None` is a
12
+ public host. It serves only the site's own files and the `public=True` service endpoints its
13
+ API scopes list. `/login`, `/api/auth/session` and the rest of `/api`, `/_/...`,
14
+ `/.well-known/...` and `/health` answer 404 there, every refusal looks like the site's own
15
+ missing page, and pages carry no `evlet-config` block, so nothing names the instance, its
16
+ application or its version. The site owns every other path, `/docs` and `/assets` included.
17
+ See [Public websites](docs/routing.md#public-websites).
18
+ - **`Frontend(..., routing="pages")`** for multi-page static sites: `/about/` serves
19
+ `about/index.html`, `/pricing` serves `pricing.html`, the other form redirects (301) to the one
20
+ that exists, and an unknown path gets the frontend's `404.html` with status 404. `"app"` is the
21
+ default and keeps the single-page behaviour. See [Multi-page sites](docs/routing.md#multi-page-sites).
22
+ - **More file types for static frontends:** `txt`, `xml`, `webmanifest`, `pdf`, `gif`, `avif` and
23
+ `woff`, so `robots.txt` and `sitemap.xml` are served. HEAD works for pages and files.
24
+ - **`Frontend(..., suggested_host="www")`.** When `evlet install` adds the app to an instance with a
25
+ domain, it offers `www.<domain>` or your own domain and writes the `Host(...)` line into
26
+ `routes.py`. `--yes` takes the suggestion and `--no-host` skips it.
27
+ - **`evlet host add | remove | list`.** `host add acme www.example.com --root site.www` checks DNS,
28
+ edits `routes.py` safely, rewrites the Caddy site and, with `--apply`, installs it, reloads Caddy
29
+ and restarts the service. `--routes-only` suits Caddy with on-demand TLS. See
30
+ [Serve a website on its own host](docs/cli.md#serve-a-website-on-its-own-host).
31
+ - **`Host(root="app.frontend")`** names a frontend by its id, so `routes.py` needs no import.
32
+ - **Four SQLite files per instance.** `data/database.sqlite3` keeps records, the audit trail, the
33
+ journal, jobs, accounts and settings. Sign-in sessions, two-step tickets and sign-in attempts
34
+ move to `sessions.sqlite3`; the tool-call log, public rate counts and proxy header notes to
35
+ `logs.sqlite3`; Eva's chats, messages, files, usage and tasks to `eva.sqlite3`. All four use
36
+ WAL, and a write locks only the file it changes, so a long job no longer holds up sign-in, the
37
+ tool log or Eva. SQL names tables as before. `database.transaction(store="sessions")` (or
38
+ `"logs"`, `"eva"`) writes one side file only. See
39
+ [Busy writing on SQLite](docs/performance.md#busy-writing-on-sqlite).
40
+ - **Writers take turns.** Within a process each file has a line of writers: requests first, in
41
+ order, and a waiting job step goes next once it has waited 0.25 s, so jobs are never starved.
42
+ A resumable job gives up its turn after every step, and while people are writing it rests as
43
+ long as each step, so it gets about half of the file's time. With a job writing in 0.1 s
44
+ transactions, eight people completed 42 saves in 20 s on 0.4.2 (16 failed with "database is
45
+ locked") and 768 on 0.4.3 with none failed, against 779 with no job at all. The wait limit stays 5 s.
46
+ - **Slow write warning.** A write that holds a file longer than 1 s (`Database.slow_write`) logs
47
+ a warning naming the request or the job.
48
+ - **Batched counters.** API key last use, AI assistant call counts and proxy header notes are
49
+ saved by one background thread about every 250 ms, and on shutdown.
50
+ - **Delayed and follow-up jobs.** `Context.enqueue(..., run_at=...)` delays a job, and
51
+ `JobContext.follow_up(tx, payload=None, *, run_at, key=None)` queues a job's next run in its
52
+ own transaction with the same identity. See [Follow-up runs](docs/jobs-realtime.md#follow-up-runs).
53
+ - **`evlet backup` and `evlet restore`** copy and put back an instance's four files as one set.
54
+ Restore asks for the instance name (or `--yes NAME`), keeps the files it replaces, and also
55
+ takes a single-file backup from 0.4.2. See [Back up and restore](docs/cli.md#back-up-and-restore).
56
+ - `evlet.writes.data_files(path)` lists an instance's database files, and `evlet.writes.connect(path)`
57
+ opens a main file with the others attached, for tools that open SQLite themselves.
58
+ - `scripts/busy_queue_benchmark.py` and `scripts/benchmark_busy_writes.py` measure saves while a job writes.
59
+
60
+ ### Changed
61
+
62
+ - **The built-in System Administrator's username is now `admin`**, not `administrator`. Its full
63
+ name stays "System Administrator". `evlet migrate` runs the new step `0009_admin_username`,
64
+ which renames the 0.4.2 account and keeps its password, email and two-step sign-in. An instance
65
+ with an active admin already named `admin` (common before 0.4.2) keeps that account as the
66
+ Administrator, and the 0.4.2 `administrator` becomes an ordinary admin, disabled when it never
67
+ had a password. Any other account named `admin` stops the step until it is renamed. Sign in,
68
+ `evlet users set-password <instance> admin` and `evlet users set-email <instance> admin` use
69
+ the new name ([docs/app-upgrades.md](docs/app-upgrades.md#from-042-to-043)).
70
+ - **Caddy refuses a `Host` that differs from the TLS server name.** `evlet proxy --caddy` starts
71
+ with a global options block that turns on `strict_sni_host`. `evlet setup --host --apply`
72
+ installs it as `/etc/caddy/evlet-global.caddy` and imports it on the first line of the
73
+ Caddyfile; if your Caddyfile has its own global options block, it asks you to add the option
74
+ there. The nginx output answers such a request with 421. Run `evlet setup ... --host ... --apply`
75
+ again to update an existing site.
76
+ - `evlet proxy` no longer refuses `/controls` and `/docs` on a public host; the instance answers
77
+ them with the site's page or its 404.
78
+ - Framework step `0010_split_files` moves the tables on `evlet migrate`, after the backup, on the
79
+ staged copy. It checks row counts before dropping each table from the main file, is safe to run
80
+ again after a crash, and stops early when the disk is short. A no-op on PostgreSQL. See
81
+ [From 0.4.2 to 0.4.3](docs/app-upgrades.md#from-042-to-043).
82
+ - The moved tables no longer declare foreign keys to `evlet_users` (SQLite cannot check them
83
+ across files); Evlet removes sessions and Eva data of accounts that no longer exist at startup.
84
+ After a crash the side files are best effort for the last moment of writes.
85
+ - `evlet migrate` backs up and stages all four files, and checks free disk space first.
86
+
7
87
  ## 0.4.2 (11-11-2026)
8
88
 
9
89
  ### 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.3
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'):
@@ -79,7 +79,9 @@ modified time and user columns to every model table and fills them from the Jour
79
79
  unsaved changes people leave on saved records ([ui.md](ui.md#unsaved-changes)). `0006_fixed_ids` adds the
80
80
  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
81
  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.
82
+ ([model-engine.md](model-engine.md#decimal-places-per-currency)). `0010_split_files` moves sign-in sessions, the
83
+ tool-call log and Eva into their own SQLite files next to the database (see From 0.4.2 to 0.4.3 below).
84
+ Steps never run while an instance is served.
83
85
  `evlet migrate acme --plan` lists the pending ones without writing anything. If a step fails, the staged copy is
84
86
  discarded and the database and lock stay as they were; restore the earlier Evlet
85
87
  before restarting.
@@ -97,6 +99,61 @@ first applies the steps and the others find them applied. Do not keep data you c
97
99
  Main uses a development version between releases; a source build is not the same
98
100
  artifact as the last PyPI release.
99
101
 
102
+ ### From 0.4.2 to 0.4.3
103
+
104
+ 0.4.3 renames the built-in System Administrator's username from `administrator` to `admin`, and splits
105
+ each instance's SQLite database into four files with writers taking turns, so a long job no longer
106
+ makes pages fail with "database is locked". Apps keep their `evlet>=0.4.0,<0.5` dependency.
107
+
108
+ `evlet migrate` applies both steps in order, after one backup.
109
+
110
+ The Administrator's username:
111
+
112
+ - Run `evlet migrate` for each instance. It applies `0009_admin_username`, which renames the
113
+ account and keeps its password, email and two-step sign-in. Sign in as `admin` afterwards.
114
+ - An instance that also has an ordinary active admin named `admin` keeps that account as the
115
+ Administrator, with its own password. The 0.4.2 `administrator` account becomes an ordinary
116
+ admin, disabled when it never had a password. Remove it in Controls if you don't need it.
117
+ - An account named `admin` that is not an active admin stops the step: rename it first.
118
+ - Tests and scripts that sign in as `administrator` use `admin`. A test fixture that adds its own
119
+ account named `admin` now meets the Administrator: give it a password instead of inserting it,
120
+ for example with `INSERT ... ON CONFLICT(username) DO UPDATE SET password=excluded.password`.
121
+ Set any other column the fixture needs, such as `allow_mcp`, in the same update.
122
+ - Setting up `admin` through `/api/auth/setup` gives the Administrator its password, so the
123
+ accounts a test adds after it start at 2 again, as before 0.4.2. Records it writes show
124
+ "Administrator" or "System Administrator", not "admin".
125
+ - The Administrator passes every role check. A test that checks a Rule limiting the admin role
126
+ needs an ordinary admin with another username, such as `owner`.
127
+
128
+ The four SQLite files:
129
+
130
+ - Stop the instance and run `evlet migrate` before you serve it. It backs up
131
+ `data/database.sqlite3` first, then step `0010_split_files` moves these tables out of it:
132
+ `evlet_sessions`, `evlet_two_step_tickets` and `evlet_login_limits` into `sessions.sqlite3`;
133
+ `evlet_tool_calls`, `evlet_public_limits` and `evlet_forwarded_peers` into `logs.sqlite3`; and
134
+ the ten `evlet_eva_*` tables into `eva.sqlite3`. Everything else stays in `database.sqlite3`.
135
+ People stay signed in and nothing else changes for them.
136
+ - The move copies each table with its rows, indexes and id counter, checks that the row counts
137
+ match, and only then drops it from the main file. It works on the staged copy `evlet migrate`
138
+ already uses, so a failure leaves the instance as it was, and it is safe to run again after a
139
+ crash at any point. It first checks the disk has room for the backup, the staged copy and the
140
+ moved tables, and stops with a clear message, changing nothing, when it does not.
141
+ - Back up and restore the four files together: `evlet backup --instance NAME` and
142
+ `evlet restore BACKUP --instance NAME` are new ([cli.md](cli.md#back-up-and-restore)). A
143
+ single-file backup from 0.4.2 still restores; run `evlet migrate` after it.
144
+ - App code keeps naming tables as before: SQL finds a table in whichever file holds it. A
145
+ write transaction that touches a sessions, logs or Eva table takes that file's turn too.
146
+ Code that opens the SQLite file itself with `sqlite3.connect` sees only the main file; use
147
+ `evlet.writes.connect(path)` to get the others attached.
148
+ - SQLite cannot check a foreign key from one file to another, so the moved tables no longer
149
+ declare one to `evlet_users`; Evlet checks those links itself. A table in your app should not
150
+ reference a moved table.
151
+ - New for jobs: `Context.enqueue(..., run_at=...)` delays a job, and a running job queues its
152
+ own next run with `context.follow_up(tx, payload, run_at=...)`, in the same transaction and
153
+ with the same identity ([jobs-realtime.md](jobs-realtime.md#follow-up-runs)). An app that
154
+ polls with an every-minute schedule can use a follow-up run instead.
155
+ - PostgreSQL instances keep one database; the step only records itself there.
156
+
100
157
  ### From 0.4.1 to 0.4.2
101
158
 
102
159
  0.4.2 adds the built-in System Administrator and new sign-in rules in config.py. Apps keep
@@ -193,7 +250,10 @@ requires trust. Keep `apps.lock` and its matching database together.
193
250
  ## Keep backups manageable
194
251
 
195
252
  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.
253
+ instance's `data/backups/`: the main file `<time>.sqlite3` and, from 0.4.3, its
254
+ `<time>-sessions.sqlite3`, `<time>-logs.sqlite3` and `<time>-eva.sqlite3`. `evlet backup` writes
255
+ 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
256
  After verifying recovery, remove obsolete backup files according to your own
198
257
  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.
258
+ each retained snapshot. Never delete the active `data/database.sqlite3` file or its `sessions`, `logs` and `eva`
259
+ files.
@@ -82,6 +82,7 @@ evlet build --trust
82
82
  evlet instance acme
83
83
  evlet instance --list
84
84
  evlet install notes --instance acme --trust
85
+ evlet install site --instance acme --trust --yes
85
86
  evlet serve acme --port 8000
86
87
  evlet dev --instance acme
87
88
  evlet dev-link
@@ -94,13 +95,18 @@ evlet ids check acme
94
95
  evlet journal verify acme
95
96
  evlet ledger list --instance acme
96
97
  evlet jobs list --instance acme
98
+ evlet backup --instance acme
99
+ evlet restore instances/acme/data/backups/20261112T061500000000Z.sqlite3 --instance acme
97
100
  evlet routes acme
98
101
  evlet proxy acme --caddy --check
102
+ evlet host add acme www.example.com --root site.www --apply
103
+ evlet host remove acme www.example.com --apply
104
+ evlet host list acme
99
105
  evlet link-user acme buyer customer 42
100
106
  evlet controls grant acme mariam
101
107
  evlet users reset-two-step acme mariam
102
108
  evlet users set-password acme mariam
103
- evlet users set-email acme administrator ops@example.com
109
+ evlet users set-email acme admin ops@example.com
104
110
  evlet secrets rotate acme
105
111
  evlet playground --port 8000
106
112
  evlet docs --port 8001
@@ -149,16 +155,16 @@ that process. No worker is mandatory.
149
155
  `bench browse --user` in Frappe:
150
156
 
151
157
  ```text
152
- The administrator account has no password yet. Open this link to sign in and choose one (works once, for 10 minutes):
158
+ The admin account has no password yet. Open this link to sign in and choose one (works once, for 10 minutes):
153
159
  http://127.0.0.1:8000/_dev/signin?token=...
154
160
  ```
155
161
 
156
- Every instance has the built-in System Administrator (`administrator`), with no password at
162
+ Every instance has the built-in System Administrator (`admin`), with no password at
157
163
  first ([controls.md](controls.md#the-administrator)). The first link signs it in and opens a
158
164
  "Set your password" screen that follows config.py's admin minimum. When admins need two-step
159
165
  sign-in (`Security(admin_two_step=True)`, the default), that session then ends and the
160
166
  authenticator set-up follows, as at a normal sign-in; finishing it opens the app. Later starts
161
- print `Sign in as administrator (works once, for 10 minutes): ...` and the link signs straight
167
+ print `Sign in as admin (works once, for 10 minutes): ...` and the link signs straight
162
168
  in, sent to `/`. The sign-in page never offers a "Sign in as administrator" button: the link is
163
169
  only printed in the terminal of the person who started the server.
164
170
 
@@ -174,7 +180,7 @@ project it serves the project's instance (`--instance` picks one, `--port` match
174
180
  Instances that already have other admins (such as `admin` or `demo-admin` from 0.4.1 and
175
181
  earlier) keep them unchanged.
176
182
  - `--no-link` on `evlet dev` or `evlet playground` skips the startup link. The browser setup
177
- page then asks for the first admin; choosing the username `administrator` there gives the
183
+ page then asks for the first admin; choosing the username `admin` there gives the
178
184
  Administrator its password.
179
185
  - The app itself serves `/_dev/signin` on the same host and port. The route exists
180
186
  only under `evlet dev` and `evlet playground`. `evlet serve`, tenant applications
@@ -224,13 +230,22 @@ it exits with status 1 when there is any difference. See [effects.md](effects.md
224
230
  does, then prints the resolved hosts and paths, marking locked rows and where each
225
231
  row came from. See [routing.md](routing.md).
226
232
  `proxy` prints a Caddy (`--caddy`) or nginx (`--nginx`) configuration for the
227
- instance hosts, refusing `/controls` and `/docs` on sub-hosts and framework `/_/`
228
- paths other than the MCP, OAuth and mailbox sign-in routes. `--write PATH` writes
229
- it to that file instead; nothing else is written and no service is reloaded.
233
+ instance hosts, refusing `/controls` and `/docs` on portal sub-hosts and framework `/_/`
234
+ paths other than the MCP, OAuth and mailbox sign-in routes. It refuses a request whose
235
+ `Host` differs from the TLS server name: the Caddy file starts with a global options block
236
+ that turns on `strict_sni_host`, and each nginx server answers such a request with 421.
237
+ `--write PATH` writes it to that file instead; nothing else is written and no service is reloaded.
230
238
  `--check` reports where each host's A and AAAA records point. It warns when a host
231
239
  points at a public address this server cannot see as its own (behind NAT), and exits
232
240
  with status 1 only when a host has no record, or points only at private addresses while
233
241
  this server has a public one. `--ip` names this server's public address.
242
+ `install` offers a host for each frontend of a newly installed app that sets
243
+ `suggested_host` ([routing.md](routing.md#public-websites)), when the instance has a domain:
244
+ `<label>.<instance domain>`, such as `www.erp.example.com`, or a domain you type. `--yes`
245
+ takes the suggestion without asking, and `--no-host` offers nothing. Without a terminal and
246
+ without `--yes`, it only prints the `evlet host add` command. It writes the `Host(...)` line
247
+ into `instances/<name>/routes.py` and nothing else; run the printed `evlet host add ... --apply`
248
+ to check DNS, update Caddy and restart the service.
234
249
  `link-user` links an account to a record, such as a portal user to their customer,
235
250
  for row scopes like `own_customer`, or a staff user to their employee record for a
236
251
  team scope (`Hierarchy.team`). `--remove` removes the link. Both are written to the Controls
@@ -394,7 +409,7 @@ security = Security(password_min=15, admin_two_step=True, two_step=False, admin_
394
409
  - `password_min`: 1 to 64 characters (15). 1 means no rule: even "1" is a password.
395
410
  - `admin_two_step`: admins, the built-in Administrator too, must use two-step sign-in (on).
396
411
  - `two_step`: everyone else must use it too (off). Controls can turn it on or off.
397
- - `admin_sign_in`: the sign-in page opens with the username `administrator` filled in (off).
412
+ - `admin_sign_in`: the sign-in page opens with the username `admin` filled in (off).
398
413
  - `session_hours` 1 to 168 (12) and `lockout` 3 to 50 failed sign-ins (5).
399
414
 
400
415
  Admins always follow config.py. Controls can change the password minimum and two-step sign-in
@@ -414,7 +429,7 @@ It will reject it rather than adopt it. Existing Playground data stays in place.
414
429
 
415
430
  `evlet serve` never prints sign-in links. While the built-in Administrator has no password
416
431
  it prints `The built-in Administrator has no password yet. Set one with: evlet users set-password
417
- acme administrator` at start.
432
+ acme admin` at start.
418
433
 
419
434
  For a conventional deployment, provision the administrator locally first, then
420
435
  set `domain="app.example.com"`. This selects that exact HTTPS origin, secure
@@ -453,10 +468,23 @@ After installing the apps it:
453
468
  check passes with it, the address is kept in `deploy/server.json` and used by later
454
469
  runs; a new `--ip` replaces it.
455
470
  5. Prints the privileged steps: copy the two files into `/etc/systemd/system/`
456
- and `/etc/caddy/`, add an `import` line to `/etc/caddy/Caddyfile`, then
457
- `systemctl daemon-reload`, `systemctl enable --now evlet-acme` and
471
+ and `/etc/caddy/`, copy `deploy/evlet-global.caddy` to `/etc/caddy/`, add an `import`
472
+ line for the site to the end of `/etc/caddy/Caddyfile` and one for the global options
473
+ to its first line, then `systemctl daemon-reload`, `systemctl enable --now evlet-acme` and
458
474
  `systemctl reload caddy`, each with `sudo`.
459
475
 
476
+ `deploy/evlet-global.caddy` holds Caddy's global options, which turn on `strict_sni_host`
477
+ so that Caddy refuses a request whose `Host` differs from the TLS server name. Caddy reads
478
+ global options only from the first block of the Caddyfile, so this file is imported on line 1
479
+ and the site file has none. If your Caddyfile already starts with a global options block of its
480
+ own, `--apply` stops and asks you to add these lines inside it:
481
+
482
+ ```text
483
+ servers :443 {
484
+ strict_sni_host on
485
+ }
486
+ ```
487
+
460
488
  Review the two files, then run those steps yourself, or run the same command again
461
489
  with `--apply`. Every run writes both files again from the current Evlet. When the copy
462
490
  in `/etc/caddy/` or `/etc/systemd/system/` differs, it says the copy is out of date, and
@@ -491,6 +519,42 @@ service again.
491
519
  nothing outside `--apply` changes `/etc` or calls `sudo`. Controls, AI, MCP has a
492
520
  **Check** button that tests the public address from the server.
493
521
 
522
+ ### Serve a website on its own host
523
+
524
+ A static or server frontend can have its own host, such as a public website on
525
+ `www.example.com` next to the ERP on `erp.example.com`:
526
+
527
+ ```sh
528
+ evlet host add acme www.example.com --root site.www
529
+ evlet host add acme www.example.com --root site.www --apply
530
+ ```
531
+
532
+ `host add` refuses a host that is not a public lowercase name, the primary host, or a root
533
+ that is not a static or server frontend of an installed app. The instance needs a domain. Then:
534
+
535
+ 1. It checks the host's DNS like `evlet proxy --check` (with `--ip` or the address saved in
536
+ `deploy/server.json`). When the check fails, nothing is changed.
537
+ 2. It adds `Host("www.example.com", root="site.www")` to `hosts` in `instances/acme/routes.py`,
538
+ creating the file if needed, and checks that the instance still starts with it. It edits only a
539
+ `hosts = (...)` tuple of `Host(...)` entries without comments; when `routes.py` sets `hosts` any
540
+ other way, it changes nothing and prints the line to add yourself.
541
+ 3. It writes `deploy/evlet-acme.caddy`, the service unit and `deploy/evlet-global.caddy` again,
542
+ keeping the port of the unit in `deploy/` (or `--port`).
543
+ 4. It prints the same `sudo` steps as `evlet setup --host`, plus a restart of the service, since the
544
+ instance reads `routes.py` when it starts. `--apply` runs them, each shown first.
545
+
546
+ `host remove` takes a host out of `routes.py` and rewrites the Caddy file the same way. `host list`
547
+ prints the primary host and each sub-host with its root frontend and sign-in realm.
548
+
549
+ With Caddy's on-demand TLS ([routing.md](routing.md#many-instances-on-one-server)) no Caddy file
550
+ changes: Caddy asks the instance before it gets a certificate. Then only `routes.py` and a restart
551
+ are needed:
552
+
553
+ ```sh
554
+ evlet host add acme www.example.com --root site.www --routes-only
555
+ sudo systemctl restart evlet-acme
556
+ ```
557
+
494
558
  ### Serve an instance behind Caddy
495
559
 
496
560
  This is a minimal manual setup for one instance on one Linux server. It assumes
@@ -533,7 +597,9 @@ app.example.com {
533
597
  }
534
598
  ```
535
599
 
536
- `evlet proxy acme --caddy` prints this block for your hosts.
600
+ `evlet proxy acme --caddy` prints this block for your hosts, after a global options block
601
+ that turns on `strict_sni_host`. Put that block first in `/etc/caddy/Caddyfile`, or add its
602
+ `servers :443 { strict_sni_host on }` lines to the global options block you have.
537
603
 
538
604
  Caddy obtains the certificate and passes the original Host header, which must
539
605
  match `domain`. Then run:
@@ -610,8 +676,34 @@ sources. Recovery reconciles the lock only when the database matches one of the
610
676
  recorded states, then retries normal validation. Unknown mismatches fail closed
611
677
  and require restoring the matching database, files, lock and app source together.
612
678
 
613
- There are no automatic app update/removal, source checkout, rollback or backup/
614
- restore commands. Use [App upgrades](app-upgrades.md) for the supported workflow.
679
+ There are no automatic app update/removal, source checkout or rollback commands. Use
680
+ [App upgrades](app-upgrades.md) for the supported workflow.
681
+
682
+ ### Back up and restore
683
+
684
+ An instance keeps four SQLite files in `data/`: `database.sqlite3`, `sessions.sqlite3`,
685
+ `logs.sqlite3` and `eva.sqlite3` ([performance.md](performance.md#busy-writing-on-sqlite)).
686
+ They are one set.
687
+
688
+ `evlet backup --instance acme` copies all four into `data/backups/` as
689
+ `<time>.sqlite3`, `<time>-sessions.sqlite3`, `<time>-logs.sqlite3` and `<time>-eva.sqlite3`.
690
+ `--to DIR` writes them somewhere else. It uses SQLite's online backup API from one read
691
+ snapshot of the four files, so the server may keep running. It checks there is room first.
692
+
693
+ `evlet restore <backup> --instance acme` replaces the four files with a set. Give it the main
694
+ file of the set; it finds the others next to it. Stop the server first: restore holds the
695
+ instance lock and refuses while the instance is in use. It asks you to type the instance name;
696
+ `--yes acme` answers for automation and must name the same instance. The files it replaces are
697
+ copied into `data/backups/` first, named `<time>-before-restore`. `apps.lock` is set to what the
698
+ restored database says was installed, so run `evlet migrate acme` after restoring an older
699
+ backup.
700
+
701
+ A single-file backup from before 0.4.3, such as one `evlet migrate` wrote, restores too. Its
702
+ sessions, logs and Eva are still inside it, so restore clears the other three files and says to
703
+ run `evlet migrate acme`, which moves them out again before you serve.
704
+
705
+ Backups hold only the database. Keep `secret.key`, `files/` and the app sources with them.
706
+ Tools that remove or reset an instance can list the set with `evlet.writes.data_files(path)`.
615
707
  Do not remove app source used by an instance. Calendar `@cron` schedules reconcile
616
708
  changes while preserving operator-disabled state and history. Changing a legacy
617
709
  interval schedule's task, payload or interval needs a later explicit
@@ -19,7 +19,7 @@ has no two-step sign-in, and nothing is listed for it.
19
19
  the instance accepts counts as primary, except sub-hosts. So each tenant of a
20
20
  `TenantApplication` manages its own users on its own host, in its own database.
21
21
  - Only desk roles open Controls. Portal roles never do, whatever their settings.
22
- - Every instance has the built-in **System Administrator** (username `administrator`, role
22
+ - Every instance has the built-in **System Administrator** (username `admin`, role
23
23
  admin), like the Administrator in ERPNext. See [The Administrator](#the-administrator).
24
24
  - Open to roles with "Opens Controls" on. `admin` always has it; it can't be turned off.
25
25
  - Opening Controls is not the same as being admin. Only admins can give or remove the admin
@@ -65,16 +65,16 @@ has no two-step sign-in, and nothing is listed for it.
65
65
 
66
66
  ### The Administrator
67
67
 
68
- Every instance has one account it creates itself: username `administrator`, full name
68
+ Every instance has one account it creates itself: username `admin`, full name
69
69
  "System Administrator", role admin, marked `builtin` in `evlet_users`. New databases get it at
70
70
  startup. Older ones get it from the framework step `0008_administrator`, which `evlet migrate`
71
- runs; if another account already uses the username `administrator`, the step stops with a
71
+ runs; if another account already uses the username `admin`, the step stops with a
72
72
  message and changes nothing, so rename that account first.
73
73
 
74
74
  - It starts with **no password**, so nobody can sign in as it until one is set: through the
75
75
  development sign-in link and the "Set your password" screen ([cli.md](cli.md#development-sign-in-links)),
76
- with `evlet users set-password <instance> administrator`, by an admin in Controls, or on first-run
77
- setup in the browser by choosing `administrator` as the username.
76
+ with `evlet users set-password <instance> admin`, by an admin in Controls, or on first-run
77
+ setup in the browser by choosing `admin` as the username.
78
78
  - Its username, full name and role never change, and it can't be deactivated or deleted. Every
79
79
  route refuses with 409 "The Administrator account is built in...": Controls Users, the older
80
80
  `/api/auth/users` routes and the profile (`/api/_settings/me/profile` and the photo answer 409
@@ -214,7 +214,7 @@ security = Security(password_min=8, admin_two_step=True, two_step=False, admin_s
214
214
  | `password_min` | 15 | 1 to 64 characters. 1 means no rule: "1" is a valid password. |
215
215
  | `admin_two_step` | `True` | Admin accounts, the Administrator too, must use two-step sign-in. Only config.py decides this. |
216
216
  | `two_step` | `False` | Everyone else must use two-step sign-in. Controls can turn it on or off. |
217
- | `admin_sign_in` | `False` | The sign-in page opens with the username `administrator` filled in, so you type only the password (and a code when needed). |
217
+ | `admin_sign_in` | `False` | The sign-in page opens with the username `admin` filled in, so you type only the password (and a code when needed). |
218
218
  | `session_hours` | 12 | 1 to 168. |
219
219
  | `lockout` | 5 | 3 to 50. |
220
220
 
@@ -115,7 +115,7 @@ checks, use the job's [business context](#a-jobs-business-context).
115
115
  ## Queue a job from an action
116
116
 
117
117
  An `@action` (or a Move `run` method, or any trusted code with a document context) queues a
118
- registered task with `context.enqueue(task, payload, *, key=None, target=None)`:
118
+ registered task with `context.enqueue(task, payload, *, key=None, target=None, run_at=None)`:
119
119
 
120
120
  ```python
121
121
  class PriceList(Model):
@@ -136,6 +136,7 @@ class PriceList(Model):
136
136
  * An action that returns the receipt adds `_job` (`{"id", "state"}`) to its detail. It is not
137
137
  part of the ETag. `GET /api/_jobs/<id>` follows it.
138
138
  * `key=` deduplicates as with `JobQueue.enqueue`. The context must not be read only.
139
+ * `run_at=` (UTC seconds) delays the job: it stays queued until then.
139
140
 
140
141
  `JobQueue.wake()` and `JobQueue.wait(timeout)` are the signal underneath, for app workers that
141
142
  run their own loop: `wait` returns True when a committed transaction queued a job since the last
@@ -225,7 +226,13 @@ jobs = JobQueue(database, [Task('rebuild_balances', rebuild_balances, resumable=
225
226
  The handler is called again and again until it returns `None`. Any other return value is the
226
227
  checkpoint: JSON of at most 16 KiB, committed with that step's writes and progress, and given
227
228
  to the next step as `context.checkpoint`. Each step is short, so it holds the database write
228
- lock only briefly and other requests run between steps. Every step reloads the job, checks the
229
+ lock only briefly and other requests run between steps. On SQLite, writers in one process take
230
+ turns: a job step waits behind requests that came first, but never more than about a quarter of a
231
+ second, and after each step the job gives up its turn and joins the back of the line. While people
232
+ are writing, the job rests after each step for as long as the step took, so it gets about half of the
233
+ database's time and runs at full speed again when they stop. So a request
234
+ waits at most about one step, and a step that holds the database longer than a second logs a
235
+ warning naming the job ([performance.md](performance.md#busy-writing-on-sqlite)). Every step reloads the job, checks the
229
236
  lease and rechecks the account and the target record, like the first one. Each committed step
230
237
  also extends the claim's lease to at least 300 seconds from that step.
231
238
 
@@ -254,6 +261,32 @@ The Playground's **Rebuild all points balances** action on a customer queues `re
254
261
  which recomputes every customer's balance from the points ledger 20 customers per step
255
262
  ([ledger.md](ledger.md)).
256
263
 
264
+ ## Follow-up runs
265
+
266
+ A job can queue its own next run with `context.follow_up(tx, payload=None, *, run_at, key=None)`.
267
+ Use it for work that comes back later, such as checking a payment provider again in ten minutes,
268
+ instead of a schedule that runs every minute whether or not there is work:
269
+
270
+ ```python
271
+ import time
272
+
273
+ def check_payment(tx, context, payload):
274
+ # Payment belongs to this application.
275
+ payment = tx.get(Payment, payload['payment'])
276
+ if payment.status == 'pending':
277
+ context.follow_up(tx, run_at=int(time.time()) + 600)
278
+ ```
279
+
280
+ * The next run is written in the job's own transaction (the step's, for a resumable task). It is
281
+ queued only if this run commits; a run that fails and is retried does not leave one behind.
282
+ * `payload` defaults to this run's payload. `run_at` is UTC seconds; the worker claims it then.
283
+ * It runs with this job's identity: the same account (read again when it starts), the same API
284
+ key or AI assistant narrowing, or the same system role. It never runs as anyone else, such as
285
+ the Administrator.
286
+ * `key` defaults to one per job and `run_at`, so the same run queues the same follow-up only once.
287
+ Pass your own key to merge follow-ups from several runs.
288
+ * The next run is a new job with its own attempts and its own entry in Controls > Jobs.
289
+
257
290
  ## Schedules and operator commands
258
291
 
259
292
  `jobs.schedule(name, task, payload, every=seconds, start_at=timestamp, user=user,