cloudfall 0.8.0rc4__tar.gz → 0.8.0rc6__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 (418) hide show
  1. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/ARCHITECTURE.md +4 -3
  2. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/PKG-INFO +1 -1
  3. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/ROADMAP.md +3 -3
  4. cloudfall-0.8.0rc6/changelog.d/113-component-build-validation.md +3 -0
  5. cloudfall-0.8.0rc6/changelog.d/114-refuse-node-runtimes.md +3 -0
  6. cloudfall-0.8.0rc6/changelog.d/116-converge-one-domain.md +3 -0
  7. cloudfall-0.8.0rc6/changelog.d/119-release-command.md +3 -0
  8. cloudfall-0.8.0rc6/changelog.d/121-owned-postgresql-validation.md +3 -0
  9. cloudfall-0.8.0rc6/changelog.d/90-domain-upstream-early.md +3 -0
  10. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/component.schema.json +113 -0
  11. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/deployment-receipt.schema.json +11 -0
  12. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/release-receipt.schema.json +38 -0
  13. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/service.schema.json +103 -3
  14. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/render-migration-guide.md +2 -1
  15. cloudfall-0.8.0rc6/docs/specs/002-component-build-steps.md +141 -0
  16. cloudfall-0.8.0rc6/docs/specs/004-domains-apply.md +129 -0
  17. cloudfall-0.8.0rc6/docs/specs/005-release-command.md +131 -0
  18. cloudfall-0.8.0rc6/docs/specs/006-standalone-postgresql.md +144 -0
  19. cloudfall-0.8.0rc6/docs/specs/007-data-copy-schemas.md +133 -0
  20. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/README.md +17 -2
  21. cloudfall-0.8.0rc6/engine/ansible/playbooks/deploy.yml +85 -0
  22. cloudfall-0.8.0rc6/engine/ansible/playbooks/domains.yml +75 -0
  23. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_deploy/defaults/main.yml +7 -0
  24. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_deploy/meta/argument_specs.yml +24 -0
  25. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_deploy/tasks/main.yml +36 -1
  26. cloudfall-0.8.0rc6/engine/ansible/roles/cloudfall_deploy/tasks/release_command.yml +88 -0
  27. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_nginx_site/tasks/main.yml +16 -0
  28. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/src/cloudfall_engine/ansible_inventory.py +10 -1
  29. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/tests/test_ansible_inventory.py +32 -0
  30. cloudfall-0.8.0rc6/engine/tests/test_domains_one_domain.py +179 -0
  31. cloudfall-0.8.0rc6/engine/tests/test_domains_playbook.py +161 -0
  32. cloudfall-0.8.0rc6/engine/tests/test_release_command.py +644 -0
  33. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/pyproject.toml +1 -1
  34. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/app.py +26 -11
  35. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/domain.py +272 -1
  36. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/importer.py +23 -36
  37. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/inventory.py +252 -2
  38. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/lifecycle.py +61 -3
  39. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/validation.py +272 -3
  40. cloudfall-0.8.0rc6/sdk/tests/test_component_build_validation.py +247 -0
  41. cloudfall-0.8.0rc6/sdk/tests/test_domains_converge.py +345 -0
  42. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_importer.py +33 -0
  43. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_inventory.py +53 -0
  44. cloudfall-0.8.0rc6/sdk/tests/test_owned_postgresql.py +336 -0
  45. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_validation.py +113 -0
  46. cloudfall-0.8.0rc4/engine/ansible/playbooks/deploy.yml +0 -35
  47. cloudfall-0.8.0rc4/engine/ansible/playbooks/domains.yml +0 -21
  48. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/.ansible-lint +0 -0
  49. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/.gitignore +0 -0
  50. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/CHANGELOG.md +0 -0
  51. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/CODE_OF_CONDUCT.md +0 -0
  52. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/CONTRIBUTING.md +0 -0
  53. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/LICENSE +0 -0
  54. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/MANIFESTO.md +0 -0
  55. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/README.md +0 -0
  56. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/SECURITY.md +0 -0
  57. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/Taskfile.yml +0 -0
  58. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/changelog.d/89-ci-deploy-guide.md +0 -0
  59. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/changelog.d/96-healthcheck-none.md +0 -0
  60. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/changelog.d/97-stale-proposals.md +0 -0
  61. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/changelog.d/README.md +0 -0
  62. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/README.md +0 -0
  63. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/examples/alert-rules/postgresql-down.yaml +0 -0
  64. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/examples/applications/crm.yaml +0 -0
  65. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/examples/components/crm-backend.yaml +0 -0
  66. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/examples/domains/crm-site.yaml +0 -0
  67. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/examples/logging-stacks/operations.yaml +0 -0
  68. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/examples/operator-policies/production.yaml +0 -0
  69. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/examples/server-types/debian-application.yaml +0 -0
  70. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/examples/servers/h1.yaml +0 -0
  71. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/examples/servers/h2.yaml +0 -0
  72. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/examples/services/postgresql-main.yaml +0 -0
  73. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/examples/services/redis-cache.yaml +0 -0
  74. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/examples/ssh-public-keys/example-admin.yaml +0 -0
  75. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/agent-investigation.schema.json +0 -0
  76. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/alert-rule.schema.json +0 -0
  77. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/application.schema.json +0 -0
  78. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/artifact.schema.json +0 -0
  79. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/backup-receipt.schema.json +0 -0
  80. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/common.schema.json +0 -0
  81. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/domain.schema.json +0 -0
  82. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/environment-receipt.schema.json +0 -0
  83. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/logging-stack.schema.json +0 -0
  84. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/observed-domain.schema.json +0 -0
  85. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/observed-server.schema.json +0 -0
  86. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/operation-decision.schema.json +0 -0
  87. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/operation.schema.json +0 -0
  88. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/operator-policy.schema.json +0 -0
  89. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/operator-proposal.schema.json +0 -0
  90. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/server-type.schema.json +0 -0
  91. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/server.schema.json +0 -0
  92. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/schemas/v1/ssh-public-key.schema.json +0 -0
  93. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/tests/invalid/missing-server/applications/crm.yaml +0 -0
  94. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/tests/invalid/missing-server/components/crm-backend.yaml +0 -0
  95. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/tests/invalid/missing-server/server-types/debian-application.yaml +0 -0
  96. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/tests/invalid/missing-server/servers/h1.yaml +0 -0
  97. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/tests/invalid/schema/components/component-unknown-field.yaml +0 -0
  98. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/tests/observed/compliant/h1.json +0 -0
  99. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/config/tests/observed/compliant/h2.json +0 -0
  100. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/README.md +0 -0
  101. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/.gitignore +0 -0
  102. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/ansible.cfg +0 -0
  103. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/inventories/production/hosts.yml +0 -0
  104. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/operations/converge.yml +0 -0
  105. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/operations/disk-report.yml +0 -0
  106. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/operations/journal-vacuum.yml +0 -0
  107. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/operations/postgresql-reinit.yml +0 -0
  108. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/operations/postgresql-restart.yml +0 -0
  109. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/operations/service-logs.yml +0 -0
  110. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/operations/shop-logrotate.yml +0 -0
  111. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/playbooks/disk-report.yml +0 -0
  112. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/playbooks/journal-vacuum.yml +0 -0
  113. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/playbooks/postgresql-reinit.yml +0 -0
  114. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/playbooks/postgresql-restart.yml +0 -0
  115. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/playbooks/postgresql.yml +0 -0
  116. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/playbooks/service-logs.yml +0 -0
  117. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/playbooks/shop-logrotate.yml +0 -0
  118. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/playbooks/shop.yml +0 -0
  119. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/disk-report-20261008170744.diff +0 -0
  120. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/disk-report-20261008170744.json +0 -0
  121. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/journal-vacuum-20261008171016.diff +0 -0
  122. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/journal-vacuum-20261008171016.json +0 -0
  123. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/postgresql-reinit-20261008171010.diff +0 -0
  124. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/postgresql-reinit-20261008171010.json +0 -0
  125. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/postgresql-restart-20261008170624.diff +0 -0
  126. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/postgresql-restart-20261008170624.json +0 -0
  127. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/service-logs-20261008170612.diff +0 -0
  128. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/service-logs-20261008170612.json +0 -0
  129. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/service-logs-20261008170740.diff +0 -0
  130. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/service-logs-20261008170740.json +0 -0
  131. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/service-logs-20261008170742.diff +0 -0
  132. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/service-logs-20261008170742.json +0 -0
  133. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/service-logs-20261008170838.diff +0 -0
  134. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/service-logs-20261008170838.json +0 -0
  135. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/service-logs-20261008170920.diff +0 -0
  136. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/service-logs-20261008170920.json +0 -0
  137. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/shop-logrotate-20261008170752.diff +0 -0
  138. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full/shop-logrotate-20261008170752.json +0 -0
  139. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full-approved/disk-report-20261008204348.diff +0 -0
  140. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full-approved/disk-report-20261008204348.json +0 -0
  141. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full-approved/disk-report-20261008204421.diff +0 -0
  142. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full-approved/disk-report-20261008204421.json +0 -0
  143. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full-approved/postgresql-restart-20261008204358.diff +0 -0
  144. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full-approved/postgresql-restart-20261008204358.json +0 -0
  145. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full-approved/shop-logrotate-20261008204351.diff +0 -0
  146. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/recordings/disk-full-approved/shop-logrotate-20261008204351.json +0 -0
  147. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/scenario/break.yml +0 -0
  148. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/incident/site.yml +0 -0
  149. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/pyproject.toml +0 -0
  150. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/src/cloudfall_demo/__init__.py +0 -0
  151. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/src/cloudfall_demo/server.py +0 -0
  152. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/src/cloudfall_demo/static/evaluation.json +0 -0
  153. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/src/cloudfall_demo/static/index.html +0 -0
  154. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/tests/test_demo.py +0 -0
  155. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/demo/uv.lock +0 -0
  156. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/ansible-context.md +0 -0
  157. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/assets/logo.svg +0 -0
  158. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/availability-design.md +0 -0
  159. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/brownfield-design.md +0 -0
  160. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/ci-deploy-guide.md +0 -0
  161. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/decisions/2026-09-14-no-ansible-replacement.md +0 -0
  162. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/decisions/2026-09-14-no-nixos-base.md +0 -0
  163. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/decisions/2026-09-14-no-rust-rewrite.md +0 -0
  164. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/decisions.md +0 -0
  165. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/fleet-goals.md +0 -0
  166. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/getting-started.md +0 -0
  167. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/hybrid-storage-design.md +0 -0
  168. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/images/demo.png +0 -0
  169. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/landscape.md +0 -0
  170. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/logging-service-guide.md +0 -0
  171. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/neon-migration-guide.md +0 -0
  172. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/new-server-storage-guide.md +0 -0
  173. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/operator-guide.md +0 -0
  174. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/proving-runs/2026-09-08-debian-container-m1.md +0 -0
  175. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/proving-runs/2026-09-08-dns-cutover.md +0 -0
  176. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/proving-runs/2026-09-08-guided-data-migration.md +0 -0
  177. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/proving-runs/2026-09-08-hetzner-m1.md +0 -0
  178. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/proving-runs/2026-09-08-hetzner-m2-m3.md +0 -0
  179. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/proving-runs/2026-09-08-hetzner-m4-m5.md +0 -0
  180. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/proving-runs/2026-09-08-render-cutover.md +0 -0
  181. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/proving-runs/2026-09-10-hetzner-m7.md +0 -0
  182. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/proving-runs/2026-09-10-hetzner-m8.md +0 -0
  183. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/proving-runs/2026-09-10-hetzner-m9.md +0 -0
  184. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/proving-runs/2026-09-11-hetzner-m10.md +0 -0
  185. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/proving-runs/2026-10-08-disk-full-agent.md +0 -0
  186. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/secrets-guide.md +0 -0
  187. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/docs/specs/001-stale-proposals.md +0 -0
  188. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/ansible.cfg +0 -0
  189. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/playbooks/backup.yml +0 -0
  190. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/playbooks/baseline.yml +0 -0
  191. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/playbooks/bootstrap.yml +0 -0
  192. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/playbooks/data.yml +0 -0
  193. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/playbooks/health.yml +0 -0
  194. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/playbooks/inspect.yml +0 -0
  195. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/playbooks/logging.yml +0 -0
  196. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/playbooks/restart.yml +0 -0
  197. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/playbooks/rollback.yml +0 -0
  198. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/playbooks/services.yml +0 -0
  199. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/playbooks/time.yml +0 -0
  200. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_access/defaults/main.yml +0 -0
  201. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_access/handlers/main.yml +0 -0
  202. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_access/meta/argument_specs.yml +0 -0
  203. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_access/meta/main.yml +0 -0
  204. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_access/tasks/main.yml +0 -0
  205. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_bootstrap/defaults/main.yml +0 -0
  206. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_bootstrap/meta/argument_specs.yml +0 -0
  207. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_bootstrap/meta/main.yml +0 -0
  208. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_bootstrap/tasks/main.yml +0 -0
  209. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_data_migration/defaults/main.yml +0 -0
  210. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_data_migration/meta/argument_specs.yml +0 -0
  211. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_data_migration/meta/main.yml +0 -0
  212. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_data_migration/tasks/main.yml +0 -0
  213. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_deploy/meta/main.yml +0 -0
  214. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_deploy/tasks/health.yml +0 -0
  215. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_deploy/tasks/health_gate.yml +0 -0
  216. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_deploy/tasks/restart.yml +0 -0
  217. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_deploy/tasks/rollback.yml +0 -0
  218. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_deploy/templates/component.service.j2 +0 -0
  219. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_firewall/defaults/main.yml +0 -0
  220. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_firewall/handlers/main.yml +0 -0
  221. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_firewall/meta/argument_specs.yml +0 -0
  222. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_firewall/meta/main.yml +0 -0
  223. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_firewall/tasks/main.yml +0 -0
  224. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_firewall/templates/nftables.conf.j2 +0 -0
  225. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_inspect/defaults/main.yml +0 -0
  226. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_inspect/meta/argument_specs.yml +0 -0
  227. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_inspect/meta/main.yml +0 -0
  228. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_inspect/tasks/main.yml +0 -0
  229. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/defaults/main.yml +0 -0
  230. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/handlers/main.yml +0 -0
  231. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/meta/argument_specs.yml +0 -0
  232. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/meta/main.yml +0 -0
  233. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/tasks/main.yml +0 -0
  234. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/templates/alertmanager-defaults.j2 +0 -0
  235. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/templates/alertmanager.yaml.j2 +0 -0
  236. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/templates/grafana.ini.j2 +0 -0
  237. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/templates/loki-datasource.yml.j2 +0 -0
  238. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/templates/loki-systemd-override.conf.j2 +0 -0
  239. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/templates/loki.yaml.j2 +0 -0
  240. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/templates/nginx-loki-gateway.conf.j2 +0 -0
  241. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/templates/prometheus-datasource.yml.j2 +0 -0
  242. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/templates/prometheus-defaults.j2 +0 -0
  243. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/templates/prometheus-rules.yaml.j2 +0 -0
  244. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_backend/templates/prometheus.yaml.j2 +0 -0
  245. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_collector/defaults/main.yml +0 -0
  246. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_collector/handlers/main.yml +0 -0
  247. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_collector/meta/argument_specs.yml +0 -0
  248. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_collector/meta/main.yml +0 -0
  249. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_collector/tasks/main.yml +0 -0
  250. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_collector/templates/alloy-systemd-override.conf.j2 +0 -0
  251. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_logging_collector/templates/config.alloy.j2 +0 -0
  252. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_nginx_site/defaults/main.yml +0 -0
  253. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_nginx_site/handlers/main.yml +0 -0
  254. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_nginx_site/meta/argument_specs.yml +0 -0
  255. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_nginx_site/meta/main.yml +0 -0
  256. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_nginx_site/tasks/apply_virtual_host.yml +0 -0
  257. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_nginx_site/templates/domain-site.conf.j2 +0 -0
  258. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_postgresql/defaults/main.yml +0 -0
  259. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_postgresql/handlers/main.yml +0 -0
  260. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_postgresql/meta/argument_specs.yml +0 -0
  261. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_postgresql/meta/main.yml +0 -0
  262. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_postgresql/tasks/main.yml +0 -0
  263. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_postgresql/templates/backup.service.j2 +0 -0
  264. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_postgresql/templates/backup.sh.j2 +0 -0
  265. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_postgresql/templates/backup.timer.j2 +0 -0
  266. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_postgresql/templates/cloudfall.conf.j2 +0 -0
  267. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_postgresql/templates/restore-check.service.j2 +0 -0
  268. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_postgresql/templates/restore-check.sh.j2 +0 -0
  269. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_postgresql/templates/restore-check.timer.j2 +0 -0
  270. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_redis/defaults/main.yml +0 -0
  271. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_redis/handlers/main.yml +0 -0
  272. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_redis/meta/argument_specs.yml +0 -0
  273. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_redis/meta/main.yml +0 -0
  274. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_redis/tasks/main.yml +0 -0
  275. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_redis/templates/backup.service.j2 +0 -0
  276. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_redis/templates/backup.sh.j2 +0 -0
  277. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_redis/templates/backup.timer.j2 +0 -0
  278. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_redis/templates/cloudfall.conf.j2 +0 -0
  279. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_redis/templates/restore-check.service.j2 +0 -0
  280. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_redis/templates/restore-check.sh.j2 +0 -0
  281. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_redis/templates/restore-check.timer.j2 +0 -0
  282. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_time/defaults/main.yml +0 -0
  283. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_time/meta/argument_specs.yml +0 -0
  284. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_time/meta/main.yml +0 -0
  285. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_time/tasks/main.yml +0 -0
  286. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_unattended_upgrades/defaults/main.yml +0 -0
  287. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_unattended_upgrades/meta/argument_specs.yml +0 -0
  288. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_unattended_upgrades/meta/main.yml +0 -0
  289. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/ansible/roles/cloudfall_unattended_upgrades/tasks/main.yml +0 -0
  290. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/src/cloudfall_engine/__init__.py +0 -0
  291. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/src/cloudfall_engine/__main__.py +0 -0
  292. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/src/cloudfall_engine/artifact.py +0 -0
  293. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/src/cloudfall_engine/cli.py +0 -0
  294. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/src/cloudfall_engine/playbook.py +0 -0
  295. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/src/cloudfall_engine/py.typed +0 -0
  296. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/tests/test_artifact_builder.py +0 -0
  297. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/tests/test_deploy_role.py +0 -0
  298. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/tests/test_deploy_templates.py +0 -0
  299. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/tests/test_firewall_templates.py +0 -0
  300. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/tests/test_logging_templates.py +0 -0
  301. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/tests/test_nginx_site_role.py +0 -0
  302. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/tests/test_nginx_site_templates.py +0 -0
  303. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/tests/test_playbook.py +0 -0
  304. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/tests/test_postgresql_templates.py +0 -0
  305. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/engine/tests/test_time_role.py +0 -0
  306. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/.gitignore +0 -0
  307. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/README.md +0 -0
  308. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/ansible.cfg +0 -0
  309. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/inventories/production/hosts.yml +0 -0
  310. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/operations/converge.yml +0 -0
  311. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/operations/disk-report.yml +0 -0
  312. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/operations/journal-vacuum.yml +0 -0
  313. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/operations/postgresql-reinit.yml +0 -0
  314. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/operations/postgresql-restart.yml +0 -0
  315. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/operations/service-logs.yml +0 -0
  316. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/operations/shop-logrotate.yml +0 -0
  317. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/playbooks/disk-report.yml +0 -0
  318. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/playbooks/journal-vacuum.yml +0 -0
  319. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/playbooks/postgresql-reinit.yml +0 -0
  320. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/playbooks/postgresql-restart.yml +0 -0
  321. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/playbooks/postgresql.yml +0 -0
  322. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/playbooks/service-logs.yml +0 -0
  323. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/playbooks/shop-logrotate.yml +0 -0
  324. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/playbooks/shop.yml +0 -0
  325. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/disk-report-20261008170744.diff +0 -0
  326. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/disk-report-20261008170744.json +0 -0
  327. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/journal-vacuum-20261008171016.diff +0 -0
  328. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/journal-vacuum-20261008171016.json +0 -0
  329. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/postgresql-reinit-20261008171010.diff +0 -0
  330. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/postgresql-reinit-20261008171010.json +0 -0
  331. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/postgresql-restart-20261008170624.diff +0 -0
  332. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/postgresql-restart-20261008170624.json +0 -0
  333. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/service-logs-20261008170612.diff +0 -0
  334. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/service-logs-20261008170612.json +0 -0
  335. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/service-logs-20261008170740.diff +0 -0
  336. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/service-logs-20261008170740.json +0 -0
  337. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/service-logs-20261008170742.diff +0 -0
  338. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/service-logs-20261008170742.json +0 -0
  339. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/service-logs-20261008170838.diff +0 -0
  340. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/service-logs-20261008170838.json +0 -0
  341. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/service-logs-20261008170920.diff +0 -0
  342. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/service-logs-20261008170920.json +0 -0
  343. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/shop-logrotate-20261008170752.diff +0 -0
  344. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full/shop-logrotate-20261008170752.json +0 -0
  345. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full-approved/disk-report-20261008204348.diff +0 -0
  346. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full-approved/disk-report-20261008204348.json +0 -0
  347. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full-approved/disk-report-20261008204421.diff +0 -0
  348. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full-approved/disk-report-20261008204421.json +0 -0
  349. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full-approved/postgresql-restart-20261008204358.diff +0 -0
  350. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full-approved/postgresql-restart-20261008204358.json +0 -0
  351. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full-approved/shop-logrotate-20261008204351.diff +0 -0
  352. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/recordings/disk-full-approved/shop-logrotate-20261008204351.json +0 -0
  353. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/scenario/break.yml +0 -0
  354. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/disk-full-incident/site.yml +0 -0
  355. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/render-demo/README.md +0 -0
  356. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/render-demo/pyproject.toml +0 -0
  357. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/render-demo/render.yaml +0 -0
  358. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/render-demo/src/demo/__init__.py +0 -0
  359. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/render-demo/src/demo/asgi.py +0 -0
  360. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/examples/render-demo/uv.lock +0 -0
  361. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/README.md +0 -0
  362. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/__init__.py +0 -0
  363. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/__main__.py +0 -0
  364. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/agent_server.py +0 -0
  365. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/agent_tools.py +0 -0
  366. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/ansible_api.py +0 -0
  367. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/ansible_reader.py +0 -0
  368. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/audit.py +0 -0
  369. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/authoring.py +0 -0
  370. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/callback_plugins/__init__.py +0 -0
  371. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/callback_plugins/cloudfall_host_stats.py +0 -0
  372. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/catalog.py +0 -0
  373. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/cli.py +0 -0
  374. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/commands.py +0 -0
  375. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/cutover.py +0 -0
  376. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/dashboard.py +0 -0
  377. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/dashboard_server.py +0 -0
  378. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/decision.py +0 -0
  379. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/investigation.py +0 -0
  380. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/migrate.py +0 -0
  381. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/observation.py +0 -0
  382. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/observe.py +0 -0
  383. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/operations.py +0 -0
  384. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/operator.py +0 -0
  385. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/project.py +0 -0
  386. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/py.typed +0 -0
  387. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/recording.py +0 -0
  388. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/render_api.py +0 -0
  389. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/resources.py +0 -0
  390. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/secrets.py +0 -0
  391. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/service_evidence.py +0 -0
  392. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/src/cloudfall/why.py +0 -0
  393. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_agent_server.py +0 -0
  394. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_ansible_reader.py +0 -0
  395. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_app.py +0 -0
  396. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_arguments.py +0 -0
  397. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_audit.py +0 -0
  398. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_authoring.py +0 -0
  399. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_catalog.py +0 -0
  400. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_commands.py +0 -0
  401. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_cutover.py +0 -0
  402. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_dashboard_server.py +0 -0
  403. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_data_migration.py +0 -0
  404. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_decision.py +0 -0
  405. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_host_stats.py +0 -0
  406. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_investigation.py +0 -0
  407. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_lifecycle.py +0 -0
  408. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_migrate.py +0 -0
  409. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_observe.py +0 -0
  410. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_operations_dashboard.py +0 -0
  411. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_operator.py +0 -0
  412. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_project.py +0 -0
  413. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_render_api.py +0 -0
  414. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_resources.py +0 -0
  415. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_secrets.py +0 -0
  416. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_service_evidence.py +0 -0
  417. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_stale.py +0 -0
  418. {cloudfall-0.8.0rc4 → cloudfall-0.8.0rc6}/sdk/tests/test_why.py +0 -0
@@ -161,9 +161,10 @@ automatic or manual per application.
161
161
  ## Supported workloads
162
162
 
163
163
  Applications run as native systemd units on long-lived Debian hosts, not
164
- in containers. The primary stacks are Python (uv, Gunicorn/Uvicorn, Celery)
165
- and Node.js; anything that runs as a systemd service with a health endpoint
166
- fits the model.
164
+ in containers. The deployable stack today is Python (uv, Gunicorn/Uvicorn,
165
+ Celery); Node.js runtimes are reserved in the schema and refused by
166
+ `cloudfall config validate` until they ship. Anything that runs as a systemd
167
+ service with a health endpoint fits the model.
167
168
 
168
169
  ## Infrastructure model
169
170
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: cloudfall
3
- Version: 0.8.0rc4
3
+ Version: 0.8.0rc6
4
4
  Summary: The operator's record for self-hosted servers run by an AI agent: Ansible executes, Cloudfall gates, verifies and keeps the receipts
5
5
  Project-URL: Homepage, https://cloudfall.dev
6
6
  Project-URL: Repository, https://github.com/cloudfall-dev/cloudfall
@@ -136,9 +136,9 @@ records an explicit origin skip when origin and proxy share a host.
136
136
  [guided data-migration report](docs/proving-runs/2026-09-08-guided-data-migration.md))
137
137
  - Cutover generator: DNS TTL lowering, parallel-run verification, switch, and
138
138
  a rollback window (DNS steps surface in the import report today)
139
- - v1 limitation: native Python and Node builds; container runtimes are a
140
- tracked decision ✔ (documented and enforced — container services land in
141
- the gap report)
139
+ - v1 limitation: native Python (uv) services; Node and container runtimes
140
+ are not deployable ✔ (documented and enforced: `config validate` refuses a
141
+ Node runtime, and Node and container services land in the gap report)
142
142
 
143
143
  Exit: a real PaaS application migrated onto one host with its data, TLS,
144
144
  monitoring, and rollback path. **Met on 2026-09-08** in two stages: a
@@ -0,0 +1,3 @@
1
+ ### Added
2
+
3
+ - A Component can declare `spec.buildTools` (tool name to minimum version), `spec.build` (ordered steps, each a `workingDirectory` inside the packaged root, an argv `command` and an optional `timeoutSeconds` from 1 to 3600, default 900) and `spec.artifact.include` (relative paths the build produces); `cloudfall config validate` refuses a step whose `command[0]` is not in `buildTools` (`component_build_tool_undeclared`), an absolute or `..` path, and `buildTools` or `artifact` without `build`. Validation only: `artifact build` does not run the steps yet. Components without `build` validate as before (#113)
@@ -0,0 +1,3 @@
1
+ ### Changed
2
+
3
+ - **Breaking:** `cloudfall config validate` now refuses a Component with `runtime.type` `node` or `pm2`, or `runtime.packageManager` `npm`, `pnpm` or `yarn`, with `CONFIG_INVALID` and code `component_runtime_unsupported` naming the field: these configs validated before but could never deploy, since the deploy role runs only Python with uv. The schema keeps those values as reserved. The Render importer no longer writes a Component for a Node service; it lists the service as an unsupported gap instead (#114)
@@ -0,0 +1,3 @@
1
+ ### Added
2
+
3
+ - The `converge_domains` MCP tool takes an optional `domain`: given, `domains.yml` runs only on that Domain's proxy server (`--limit`) and renders only that Domain, and an unknown id exits `PRECONDITION` (`lifecycle_domain_missing`) before the inventory render; omitted, it runs on every server as before. Each domain receipt now records `previousConfigurationSha256`, the sha256 of the vhost file the run replaced, or `null` when none was there; receipts without it still load (#116)
@@ -0,0 +1,3 @@
1
+ ### Added
2
+
3
+ - Components: a `release.command` (with optional `workingDirectory` and `timeoutSeconds`, 1 to 1800, default 300) runs once per deploy on the first server of `deployment.servers`, which now deploys first, after the release's dependencies are materialized and before the unit file changes or `current` moves; it runs as the application's user with the component's env file loaded under systemd's `EnvironmentFile=` rules. A non-zero exit or a timeout fails the deploy with `ENGINE_STEP_FAILED` before any server switches, and a passing run is recorded as `releaseCommand` (server, command, exit code, last 2000 characters of output) in every release receipt of that deploy (#119)
@@ -0,0 +1,3 @@
1
+ ### Added
2
+
3
+ - A PostgreSQL `Service` database may name an `owner` role and its `passwordRef` (`environment`, `path`, `key` in the secrets store) instead of an `application`, so a project of a server and its database alone validates; `spec.postgresql.remoteAccess` declares a listen address and the client networks allowed in. `config validate` refuses an entry with both or neither of `application` and `owner`, an `owner` without `passwordRef` or a `passwordRef` next to `application`, a reserved owner (`service_database_owner_reserved`), and a `remoteAccess` with no owner database, no firewall, the port already open, or a source of every address. Converging these declarations comes later: until then the PostgreSQL role refuses them before any task runs (#121)
@@ -0,0 +1,3 @@
1
+ ### Fixed
2
+
3
+ - `domains.yml` now fails before it changes any server when a Domain it would render has no `proxy.upstream`, and names every such Domain; before, the site role's assert stopped the run only on that Domain's server, after `serial: 1` had already converged the servers before it. `upstream` stays optional in the schema, for a Domain the fleet routes with its own proxy (#90)
@@ -124,6 +124,34 @@
124
124
  ],
125
125
  "additionalProperties": false
126
126
  },
127
+ "release": {
128
+ "type": "object",
129
+ "properties": {
130
+ "command": {
131
+ "type": "array",
132
+ "items": {
133
+ "type": "string",
134
+ "minLength": 1
135
+ },
136
+ "minItems": 1
137
+ },
138
+ "workingDirectory": {
139
+ "type": "string",
140
+ "minLength": 1,
141
+ "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))[^\\u0000-\\u001f\\u007f]+$"
142
+ },
143
+ "timeoutSeconds": {
144
+ "type": "integer",
145
+ "minimum": 1,
146
+ "maximum": 1800,
147
+ "default": 300
148
+ }
149
+ },
150
+ "required": [
151
+ "command"
152
+ ],
153
+ "additionalProperties": false
154
+ },
127
155
  "healthCheck": {
128
156
  "oneOf": [
129
157
  {
@@ -211,6 +239,70 @@
211
239
  "$ref": "common.schema.json#/$defs/secretReference"
212
240
  },
213
241
  "uniqueItems": true
242
+ },
243
+ "buildTools": {
244
+ "type": "object",
245
+ "minProperties": 1,
246
+ "propertyNames": {
247
+ "$ref": "#/$defs/controlCharacterFree"
248
+ },
249
+ "patternProperties": {
250
+ "^[A-Za-z0-9][A-Za-z0-9._+-]{0,63}$": {
251
+ "type": "string",
252
+ "pattern": "^[0-9]{1,9}(?:\\.[0-9]{1,9}){0,7}$",
253
+ "$ref": "#/$defs/controlCharacterFree"
254
+ }
255
+ },
256
+ "additionalProperties": false
257
+ },
258
+ "build": {
259
+ "type": "array",
260
+ "minItems": 1,
261
+ "items": {
262
+ "type": "object",
263
+ "properties": {
264
+ "workingDirectory": {
265
+ "$ref": "#/$defs/relativePath"
266
+ },
267
+ "command": {
268
+ "type": "array",
269
+ "items": {
270
+ "type": "string",
271
+ "minLength": 1,
272
+ "pattern": "^[^\\u0000]+$"
273
+ },
274
+ "minItems": 1
275
+ },
276
+ "timeoutSeconds": {
277
+ "type": "integer",
278
+ "minimum": 1,
279
+ "maximum": 3600,
280
+ "default": 900
281
+ }
282
+ },
283
+ "required": [
284
+ "workingDirectory",
285
+ "command"
286
+ ],
287
+ "additionalProperties": false
288
+ }
289
+ },
290
+ "artifact": {
291
+ "type": "object",
292
+ "properties": {
293
+ "include": {
294
+ "type": "array",
295
+ "items": {
296
+ "$ref": "#/$defs/relativePath"
297
+ },
298
+ "minItems": 1,
299
+ "uniqueItems": true
300
+ }
301
+ },
302
+ "required": [
303
+ "include"
304
+ ],
305
+ "additionalProperties": false
214
306
  }
215
307
  },
216
308
  "required": [
@@ -221,9 +313,30 @@
221
313
  "service",
222
314
  "healthCheck"
223
315
  ],
316
+ "dependentRequired": {
317
+ "buildTools": [
318
+ "build"
319
+ ],
320
+ "artifact": [
321
+ "build"
322
+ ]
323
+ },
224
324
  "additionalProperties": false
225
325
  }
226
326
  },
327
+ "$defs": {
328
+ "relativePath": {
329
+ "type": "string",
330
+ "minLength": 1,
331
+ "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+$",
332
+ "$ref": "#/$defs/controlCharacterFree"
333
+ },
334
+ "controlCharacterFree": {
335
+ "not": {
336
+ "pattern": "[\\u0000-\\u001f\\u007f]"
337
+ }
338
+ }
339
+ },
227
340
  "required": [
228
341
  "apiVersion",
229
342
  "kind",
@@ -31,6 +31,17 @@
31
31
  },
32
32
  "configurationSha256": {
33
33
  "$ref": "common.schema.json#/$defs/sha256"
34
+ },
35
+ "previousConfigurationSha256": {
36
+ "description": "sha256 of the file at configurationPath before this run rendered it, or null when no file was there",
37
+ "anyOf": [
38
+ {
39
+ "$ref": "common.schema.json#/$defs/sha256"
40
+ },
41
+ {
42
+ "type": "null"
43
+ }
44
+ ]
34
45
  }
35
46
  },
36
47
  "required": [
@@ -42,6 +42,44 @@
42
42
  },
43
43
  "healthCheckPassed": {
44
44
  "const": true
45
+ },
46
+ "releaseCommand": {
47
+ "type": "object",
48
+ "properties": {
49
+ "server": {
50
+ "$ref": "common.schema.json#/$defs/resourceId"
51
+ },
52
+ "command": {
53
+ "type": "array",
54
+ "items": {
55
+ "type": "string",
56
+ "minLength": 1
57
+ },
58
+ "minItems": 1
59
+ },
60
+ "workingDirectory": {
61
+ "type": [
62
+ "string",
63
+ "null"
64
+ ],
65
+ "minLength": 1
66
+ },
67
+ "exitCode": {
68
+ "const": 0
69
+ },
70
+ "outputTail": {
71
+ "type": "string",
72
+ "maxLength": 2000
73
+ }
74
+ },
75
+ "required": [
76
+ "server",
77
+ "command",
78
+ "workingDirectory",
79
+ "exitCode",
80
+ "outputTail"
81
+ ],
82
+ "additionalProperties": false
45
83
  }
46
84
  },
47
85
  "required": [
@@ -10,6 +10,72 @@
10
10
  "maxLength": 63,
11
11
  "pattern": "^[a-z][a-z0-9_]*$"
12
12
  },
13
+ "postgresRoleName": {
14
+ "type": "string",
15
+ "minLength": 1,
16
+ "maxLength": 63,
17
+ "pattern": "^[a-z][a-z0-9_]*$"
18
+ },
19
+ "secretValueReference": {
20
+ "type": "object",
21
+ "properties": {
22
+ "environment": {
23
+ "$ref": "common.schema.json#/$defs/resourceId"
24
+ },
25
+ "path": {
26
+ "$ref": "common.schema.json#/$defs/absolutePath"
27
+ },
28
+ "key": {
29
+ "type": "string",
30
+ "minLength": 1,
31
+ "maxLength": 255,
32
+ "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
33
+ }
34
+ },
35
+ "required": [
36
+ "environment",
37
+ "path",
38
+ "key"
39
+ ],
40
+ "additionalProperties": false
41
+ },
42
+ "remoteAccess": {
43
+ "type": "object",
44
+ "properties": {
45
+ "listenAddress": {
46
+ "type": "string",
47
+ "anyOf": [
48
+ {
49
+ "format": "ipv4"
50
+ },
51
+ {
52
+ "format": "ipv6"
53
+ }
54
+ ],
55
+ "not": {
56
+ "enum": [
57
+ "0.0.0.0",
58
+ "::"
59
+ ]
60
+ }
61
+ },
62
+ "allowedSources": {
63
+ "type": "array",
64
+ "items": {
65
+ "type": "string",
66
+ "minLength": 1,
67
+ "maxLength": 49
68
+ },
69
+ "minItems": 1,
70
+ "uniqueItems": true
71
+ }
72
+ },
73
+ "required": [
74
+ "listenAddress",
75
+ "allowedSources"
76
+ ],
77
+ "additionalProperties": false
78
+ },
13
79
  "systemdCalendar": {
14
80
  "type": "string",
15
81
  "minLength": 1,
@@ -83,16 +149,50 @@
83
149
  },
84
150
  "application": {
85
151
  "$ref": "common.schema.json#/$defs/resourceId"
152
+ },
153
+ "owner": {
154
+ "$ref": "#/$defs/postgresRoleName"
155
+ },
156
+ "passwordRef": {
157
+ "$ref": "#/$defs/secretValueReference"
86
158
  }
87
159
  },
88
160
  "required": [
89
- "name",
90
- "application"
161
+ "name"
162
+ ],
163
+ "additionalProperties": false,
164
+ "oneOf": [
165
+ {
166
+ "required": [
167
+ "application"
168
+ ]
169
+ },
170
+ {
171
+ "required": [
172
+ "owner"
173
+ ]
174
+ }
91
175
  ],
92
- "additionalProperties": false
176
+ "dependentRequired": {
177
+ "owner": [
178
+ "passwordRef"
179
+ ]
180
+ },
181
+ "dependentSchemas": {
182
+ "application": {
183
+ "not": {
184
+ "required": [
185
+ "passwordRef"
186
+ ]
187
+ }
188
+ }
189
+ }
93
190
  },
94
191
  "minItems": 1,
95
192
  "uniqueItems": true
193
+ },
194
+ "remoteAccess": {
195
+ "$ref": "#/$defs/remoteAccess"
96
196
  }
97
197
  },
98
198
  "required": [
@@ -47,7 +47,8 @@ Not imported today; each lands in the gap report instead of being guessed at:
47
47
  | Cron job (`type: cron`) | Recreate the schedule as a systemd timer; timers are modeled and audited |
48
48
  | Static site (`type: static`) | Serve via an Nginx site manually for now |
49
49
  | Redis / key-value (`type: redis`, `keyvalue`) | Not mapped by the importer; declare a Redis `Service` by hand (loopback-only, receipted RDB backups) and point the component at it |
50
- | Docker runtime (`runtime: docker` / `image`) | Not supported in v1; native Python and Node builds only |
50
+ | Docker runtime (`runtime: docker` / `image`) | Not supported in v1; native Python services only |
51
+ | Node service (`runtime: node`) | Not deployable yet: the server runs Python with uv only, so the importer writes no Component for it |
51
52
 
52
53
  ## What you need
53
54
 
@@ -0,0 +1,141 @@
1
+ # S-002: Component build steps
2
+
3
+ status: approved
4
+
5
+ ## Problem
6
+
7
+ A component can't ship a frontend build. `artifact build`
8
+ (`engine/src/cloudfall_engine/artifact.py`) clones the repository at a ref and tars the tree
9
+ (or `repository.subdirectory`) with no build step, so a Vite app's `web/dist/` never reaches
10
+ the artifact. `cloudfall_deploy` (`engine/ansible/roles/cloudfall_deploy/tasks/main.yml`)
11
+ asserts `runtime.type == "python"` and `runtime.packageManager == "uv"` and runs only
12
+ `uv sync` on the server. Abecra (Cloudfall's customer zero) works around it with a side
13
+ script that builds and rsyncs the web app into its own release tree: no digest check, no
14
+ receipt, and no rollback together with the API release (cloudfall-dev/cloudfall#86).
15
+
16
+ The same issue shows the schema promising more than the engine does: `component.schema.json`
17
+ accepts `runtime.type: node | pm2` and `packageManager: npm | pnpm | yarn`, which pass
18
+ `cloudfall config validate` and then fail in the role.
19
+
20
+ S-003 (Domain routes) is the pair to this spec: it serves the build output from the
21
+ component's release.
22
+
23
+ ## Behaviour
24
+
25
+ A Component may declare build steps that run on the controller before packaging:
26
+
27
+ ```yaml
28
+ spec:
29
+ buildTools:
30
+ node: "22.0.0"
31
+ pnpm: "9.0.0"
32
+ build:
33
+ - workingDirectory: web
34
+ command: [pnpm, install, --frozen-lockfile]
35
+ - workingDirectory: web
36
+ command: [pnpm, build]
37
+ artifact:
38
+ include: [web/dist]
39
+ ```
40
+
41
+ - `spec.build` is an ordered list of steps, each with `workingDirectory` (relative, no `..`,
42
+ same rule as `repository.subdirectory`), `command` (an argv list, never a shell string) and
43
+ an optional `timeoutSeconds` (1 to 3600, default 900)
44
+ - `spec.buildTools` maps each tool a step runs to its minimum version, like a command's
45
+ `required_tools`. Every step's `command[0]` must be a key of `buildTools`; it is looked up
46
+ on the controller's `PATH`
47
+ - `spec.artifact.include` lists paths (relative, no `..`) that the build produces and the
48
+ archive must keep, even when the repository's `.gitignore` names them
49
+ - `buildTools`, `build` and `artifact` are optional. `artifact` and `buildTools` require
50
+ `build`. A Component without `build` validates, builds and deploys exactly as today
51
+
52
+ `artifact build` with declared steps works in this order:
53
+
54
+ 1. Before cloning, each `buildTools` entry is checked: the tool must be on `PATH`
55
+ (`artifact_build_tool_missing` otherwise) and `<tool> --version` must print a version at
56
+ least the declared one (`artifact_build_tool_unsupported` otherwise, also when no version
57
+ can be read). Both exit `ARTIFACT_BUILD_FAILED` with the code in the error context
58
+ 2. The clean checkout is made as today, at the resolved commit
59
+ 3. Each step runs in order, in `<packaged root>/<workingDirectory>`, where the packaged root is
60
+ `repository.subdirectory` when set and the checkout otherwise. A step that exits non-zero
61
+ or outruns its timeout stops the build with `artifact_build_step_failed`, naming the step
62
+ index, its argv and its exit code, with the tail of its stderr
63
+ 4. Each `artifact.include` path must exist after the last step (`artifact_include_missing`
64
+ otherwise)
65
+ 5. The archive holds the files git tracks at the commit under the packaged root, plus every
66
+ `artifact.include` path. Other files the build left behind (`node_modules/`, caches) are
67
+ not packaged. Without `build`, the archive is the tree as today
68
+
69
+ Any failure in steps 1 to 4 writes no archive and no metadata file. Step output never goes to
70
+ stdout, so `artifact build` still answers one JSON envelope there; it goes to stderr.
71
+
72
+ Build steps run on the controller (the operator's machine or CI), not on the server, with the
73
+ operator's user and file access. A step runs code from the component's repository
74
+ (`package.json` scripts, install hooks). To limit what that code sees, a step gets only
75
+ `PATH`, `HOME`, `LANG`, `TMPDIR` from the controller's environment plus `CI=true`; cloud
76
+ tokens, SOPS keys and other variables are not passed. The `build_artifact` MCP tool stays
77
+ `mutating`, so an agent can only start a build where the operator's policy allows mutating
78
+ tools.
79
+
80
+ The Artifact metadata file (`config/schemas/v1/artifact.schema.json`, written by
81
+ `build_artifact`) gains an optional `spec.build` object: `steps` (each step's
82
+ `workingDirectory` and `command` as run) and `tools` (each tool's version as read in step 1).
83
+ Metadata without `build` validates as before, and a build without steps writes none.
84
+
85
+ The archive is then deployed by `cloudfall_deploy` unchanged: the digest check, the
86
+ `releases/<release>/` unpack, the `current` symlink switch, the receipt, and
87
+ `cloudfall rollback` cover the build output with the rest of the release.
88
+
89
+ `cloudfall config validate` refuses a Component whose runtime the deploy role can't run: any
90
+ `runtime.type` other than `python` or any `runtime.packageManager` other than `uv`, with
91
+ `component_runtime_unsupported` naming the field and saying only Python with uv deploys
92
+ today. The schema enums keep the other values as reserved. This refuses configs that validate
93
+ today but could never deploy. The Render importer (`sdk/src/cloudfall/importer.py`) records a
94
+ Node service as an unsupported gap and writes no Component for it, instead of writing one
95
+ that `config validate` now refuses.
96
+
97
+ Touches `engine/src/cloudfall_engine/artifact.py`, `engine/src/cloudfall_engine/cli.py`
98
+ (`artifact build`), `config/schemas/v1/component.schema.json`,
99
+ `config/schemas/v1/artifact.schema.json`, `sdk/src/cloudfall/inventory.py`,
100
+ `sdk/src/cloudfall/validation.py`, `sdk/src/cloudfall/importer.py`, `cloudfall config
101
+ validate`, and the `build_artifact` MCP tool.
102
+
103
+ ## Acceptance criteria
104
+
105
+ - S-002-1: A Component with `buildTools`, a `pnpm install` and a `pnpm build` step in `web`, and `artifact.include: [web/dist]` passes `cloudfall config validate`; every existing Component without `build` still validates
106
+ - S-002-2: `artifact build --ref <sha>` for that Component produces a tarball containing `web/dist/index.html`, even though the repository's `.gitignore` lists `web/dist`
107
+ - S-002-3: The same tarball contains no `web/node_modules/` entry and contains every file `git ls-files` lists at that commit
108
+ - S-002-4: The metadata file next to the tarball has `spec.build.steps` listing both steps' `workingDirectory` and `command` in order, and `spec.build.tools` with the versions `node --version` and `pnpm --version` printed, and validates against `artifact.schema.json`
109
+ - S-002-5: When a declared build tool is not on `PATH`, `artifact build` exits `ARTIFACT_BUILD_FAILED` with code `artifact_build_tool_missing` naming the tool, and no git clone runs
110
+ - S-002-6: When a declared build tool prints a version older than its `buildTools` minimum, `artifact build` exits `ARTIFACT_BUILD_FAILED` with code `artifact_build_tool_unsupported` naming the tool and both versions
111
+ - S-002-7: A build step that exits non-zero makes `artifact build` exit `ARTIFACT_BUILD_FAILED` with code `artifact_build_step_failed` naming the step and its exit code, and the output directory holds no new `.tar.gz` or `.json` file
112
+ - S-002-8: A step that finishes but leaves an `artifact.include` path missing makes `artifact build` exit `ARTIFACT_BUILD_FAILED` with code `artifact_include_missing` and write no artifact
113
+ - S-002-9: A step that prints to stdout leaves the stdout of `artifact build` a single valid JSON envelope
114
+ - S-002-10: A build step sees `CI=true` and does not see a variable such as `HCLOUD_TOKEN` set in the controller's environment
115
+ - S-002-11: `cloudfall config validate` refuses a step whose `command[0]` is not a key of `buildTools`, a `workingDirectory` or `include` path that is absolute or contains `..`, and `artifact` or `buildTools` declared without `build`
116
+ - S-002-12: `cloudfall deploy` of a built release puts `web/dist/index.html` under `<installRoot>/releases/<release>/`, and `cloudfall rollback` to the previous release makes `<installRoot>/current/web/dist/` that release's files
117
+ - S-002-13: For a Component without `build`, `artifact build` packages the same file list as before this change and writes metadata with no `spec.build` key
118
+ - S-002-14: `cloudfall config validate` on a Component with `runtime.type: node`, `runtime.type: pm2`, or `runtime.packageManager` of `npm`, `pnpm` or `yarn` exits `CONFIG_INVALID` with code `component_runtime_unsupported` naming the field
119
+ - S-002-15: Importing a Render blueprint with a Node web service writes no Component for it and lists the service as an unsupported gap
120
+
121
+ ## Out of scope
122
+
123
+ - Node runtimes on the server (`runtime.type: node | pm2`, npm, pnpm or yarn installs and a Node process under systemd): a separate feature. Until it ships, S-002-14 refuses those runtimes at validate time rather than in the role
124
+ - Building on the server: the server keeps running only `uv sync`, so build toolchains stay off production hosts
125
+ - Pinning exact tool versions or installing tools: `buildTools` checks minimums like `required_tools`; the operator or CI image provides the tools, and the metadata records the versions that ran
126
+ - Sandboxing build steps (containers, network off): the reduced environment limits what a step sees, not what it can do. Revisit with container runtimes
127
+ - Build steps outside the packaged root (a monorepo root lockfile when `repository.subdirectory` is set): `workingDirectory` stays inside the packaged root so the archive and the build see the same tree
128
+ - A separate `static` component kind with its own artifact: two artifacts for one commit would still need a joint rollback, which one artifact gives for free
129
+ - Build caching between runs: each build starts from a clean checkout
130
+
131
+ ## Decisions relied on
132
+
133
+ - none
134
+
135
+ ## Issues
136
+
137
+ - cloudfall-dev/cloudfall#113: S-002-1, S-002-11
138
+ - cloudfall-dev/cloudfall#114: S-002-14, S-002-15
139
+ - cloudfall-dev/cloudfall#115: S-002-2, S-002-3, S-002-4, S-002-5, S-002-6, S-002-7, S-002-8, S-002-9, S-002-10, S-002-12, S-002-13
140
+
141
+ ## Verification