@yunuseon/kayra 0.18.0 → 0.20.0

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 (164) hide show
  1. package/agent/skills/kayra-release/SKILL.md +1 -4
  2. package/agent/skills/kayra-rollout/SKILL.md +4 -6
  3. package/ansible/playbooks/edge.yml +5 -0
  4. package/ansible/playbooks/nas.yml +9 -1
  5. package/ansible/playbooks/platform.yml +8 -2
  6. package/ansible/roles/app/tasks/main.yml +33 -3
  7. package/ansible/roles/kayra-version/defaults/main.yml +5 -0
  8. package/ansible/roles/kayra-version/tasks/main.yml +18 -0
  9. package/ansible/roles/platform/defaults/main.yml +3 -0
  10. package/ansible/roles/platform/tasks/main.yml +6 -84
  11. package/ansible/roles/platform/templates/platform.env.j2 +2 -0
  12. package/bin/kayra-app-hook.js +6 -0
  13. package/bin/kayra-app-init.js +6 -0
  14. package/bin/kayra-app-launch.js +6 -0
  15. package/bin/kayra-app-values.js +6 -0
  16. package/cli/dist/app-hook.js +75 -0
  17. package/cli/dist/app-init.js +65 -0
  18. package/cli/dist/app-launch.js +89 -0
  19. package/cli/dist/app-values.js +37 -0
  20. package/cli/dist/browser/assets/ibm-plex-sans-cyrillic-400-normal-BTotfTJu.woff +0 -0
  21. package/cli/dist/browser/assets/ibm-plex-sans-cyrillic-400-normal-DZqxrq2p.woff2 +0 -0
  22. package/cli/dist/browser/assets/ibm-plex-sans-cyrillic-600-normal-71GNu3SW.woff2 +0 -0
  23. package/cli/dist/browser/assets/ibm-plex-sans-cyrillic-600-normal-BGq0mW3O.woff +0 -0
  24. package/cli/dist/browser/assets/ibm-plex-sans-cyrillic-ext-400-normal-Dsrv2Tcn.woff +0 -0
  25. package/cli/dist/browser/assets/ibm-plex-sans-cyrillic-ext-400-normal-g30qAdWV.woff2 +0 -0
  26. package/cli/dist/browser/assets/ibm-plex-sans-cyrillic-ext-600-normal-Bz0x94Yp.woff +0 -0
  27. package/cli/dist/browser/assets/ibm-plex-sans-cyrillic-ext-600-normal-DUMzJB7m.woff2 +0 -0
  28. package/cli/dist/browser/assets/ibm-plex-sans-greek-400-normal-D9ESIMu3.woff +0 -0
  29. package/cli/dist/browser/assets/ibm-plex-sans-greek-400-normal-_efipK4i.woff2 +0 -0
  30. package/cli/dist/browser/assets/ibm-plex-sans-greek-600-normal-D-CqTdkO.woff +0 -0
  31. package/cli/dist/browser/assets/ibm-plex-sans-greek-600-normal-DzTrcv_p.woff2 +0 -0
  32. package/cli/dist/browser/assets/ibm-plex-sans-latin-400-normal-CDDApCn2.woff2 +0 -0
  33. package/cli/dist/browser/assets/ibm-plex-sans-latin-400-normal-CYLoc0-x.woff +0 -0
  34. package/cli/dist/browser/assets/ibm-plex-sans-latin-600-normal-Cu4Hd6ag.woff +0 -0
  35. package/cli/dist/browser/assets/ibm-plex-sans-latin-600-normal-CuJfVYMP.woff2 +0 -0
  36. package/cli/dist/browser/assets/ibm-plex-sans-latin-ext-400-normal-C5H60-Va.woff2 +0 -0
  37. package/cli/dist/browser/assets/ibm-plex-sans-latin-ext-400-normal-RBey6euL.woff +0 -0
  38. package/cli/dist/browser/assets/ibm-plex-sans-latin-ext-600-normal-DIrixKbi.woff +0 -0
  39. package/cli/dist/browser/assets/ibm-plex-sans-latin-ext-600-normal-DOrvGEcy.woff2 +0 -0
  40. package/cli/dist/browser/assets/ibm-plex-sans-vietnamese-400-normal-DG4YqDda.woff2 +0 -0
  41. package/cli/dist/browser/assets/ibm-plex-sans-vietnamese-400-normal-fK1oJ5dG.woff +0 -0
  42. package/cli/dist/browser/assets/ibm-plex-sans-vietnamese-600-normal-DgdngZtN.woff +0 -0
  43. package/cli/dist/browser/assets/ibm-plex-sans-vietnamese-600-normal-DpPYBSTl.woff2 +0 -0
  44. package/cli/dist/browser/assets/index-DzIVPXyL.css +1 -0
  45. package/cli/dist/browser/assets/index-SP8bCDrl.js +7 -0
  46. package/cli/dist/browser/assets/jetbrains-mono-cyrillic-400-normal-BEIGL1Tu.woff2 +0 -0
  47. package/cli/dist/browser/assets/jetbrains-mono-cyrillic-400-normal-ugxPyKxw.woff +0 -0
  48. package/cli/dist/browser/assets/jetbrains-mono-cyrillic-500-normal-DJqRU3vO.woff +0 -0
  49. package/cli/dist/browser/assets/jetbrains-mono-cyrillic-500-normal-DmUKJPL_.woff2 +0 -0
  50. package/cli/dist/browser/assets/jetbrains-mono-cyrillic-600-normal-8K4wrrwR.woff +0 -0
  51. package/cli/dist/browser/assets/jetbrains-mono-cyrillic-600-normal-EVf6-Yzo.woff2 +0 -0
  52. package/cli/dist/browser/assets/jetbrains-mono-cyrillic-700-normal-BWTpRfYl.woff2 +0 -0
  53. package/cli/dist/browser/assets/jetbrains-mono-cyrillic-700-normal-CEoEElIJ.woff +0 -0
  54. package/cli/dist/browser/assets/jetbrains-mono-greek-400-normal-B9oWc5Lo.woff +0 -0
  55. package/cli/dist/browser/assets/jetbrains-mono-greek-400-normal-C190GLew.woff2 +0 -0
  56. package/cli/dist/browser/assets/jetbrains-mono-greek-500-normal-D7SFKleX.woff +0 -0
  57. package/cli/dist/browser/assets/jetbrains-mono-greek-500-normal-JpySY46c.woff2 +0 -0
  58. package/cli/dist/browser/assets/jetbrains-mono-greek-600-normal-H7WoG9Et.woff2 +0 -0
  59. package/cli/dist/browser/assets/jetbrains-mono-greek-600-normal-mc2nkWzM.woff +0 -0
  60. package/cli/dist/browser/assets/jetbrains-mono-greek-700-normal-C6CZE3T8.woff2 +0 -0
  61. package/cli/dist/browser/assets/jetbrains-mono-greek-700-normal-DEigVDxa.woff +0 -0
  62. package/cli/dist/browser/assets/jetbrains-mono-latin-400-normal-6-qcROiO.woff +0 -0
  63. package/cli/dist/browser/assets/jetbrains-mono-latin-400-normal-V6pRDFza.woff2 +0 -0
  64. package/cli/dist/browser/assets/jetbrains-mono-latin-500-normal-BWZEU5yA.woff2 +0 -0
  65. package/cli/dist/browser/assets/jetbrains-mono-latin-500-normal-CJOVTJB7.woff +0 -0
  66. package/cli/dist/browser/assets/jetbrains-mono-latin-600-normal-BfsvjouI.woff +0 -0
  67. package/cli/dist/browser/assets/jetbrains-mono-latin-600-normal-C8RAYTDA.woff2 +0 -0
  68. package/cli/dist/browser/assets/jetbrains-mono-latin-700-normal-BYuf6tUa.woff2 +0 -0
  69. package/cli/dist/browser/assets/jetbrains-mono-latin-700-normal-D3wTyLJW.woff +0 -0
  70. package/cli/dist/browser/assets/jetbrains-mono-latin-ext-400-normal-Bc8Ftmh3.woff2 +0 -0
  71. package/cli/dist/browser/assets/jetbrains-mono-latin-ext-400-normal-fXTG6kC5.woff +0 -0
  72. package/cli/dist/browser/assets/jetbrains-mono-latin-ext-500-normal-Cut-4mMH.woff2 +0 -0
  73. package/cli/dist/browser/assets/jetbrains-mono-latin-ext-500-normal-ckzbgY84.woff +0 -0
  74. package/cli/dist/browser/assets/jetbrains-mono-latin-ext-600-normal-BfB_LPfz.woff2 +0 -0
  75. package/cli/dist/browser/assets/jetbrains-mono-latin-ext-600-normal-DObL3zCW.woff +0 -0
  76. package/cli/dist/browser/assets/jetbrains-mono-latin-ext-700-normal-CZipNAKV.woff2 +0 -0
  77. package/cli/dist/browser/assets/jetbrains-mono-latin-ext-700-normal-CxPITLHs.woff +0 -0
  78. package/cli/dist/browser/assets/jetbrains-mono-vietnamese-400-normal-CqNFfHCs.woff +0 -0
  79. package/cli/dist/browser/assets/jetbrains-mono-vietnamese-500-normal-DNRqzVM1.woff +0 -0
  80. package/cli/dist/browser/assets/jetbrains-mono-vietnamese-600-normal-OWROknRo.woff +0 -0
  81. package/cli/dist/browser/assets/jetbrains-mono-vietnamese-700-normal-BDLVIk2r.woff +0 -0
  82. package/cli/dist/browser/index.html +10 -3
  83. package/cli/dist/clients/api/start.js +1 -1
  84. package/cli/dist/clients/cli/invocation.js +25 -0
  85. package/cli/dist/clients/cli/parser.js +24 -7
  86. package/cli/dist/clients/cli/status.js +28 -7
  87. package/cli/dist/clients/cli/text.js +3 -3
  88. package/cli/dist/clients/cli/values.js +0 -1
  89. package/cli/dist/clients/cli/views.js +9 -2
  90. package/cli/dist/clients/mcp/tools.js +8 -1
  91. package/cli/dist/clients/ui/assets.js +1 -0
  92. package/cli/dist/clients/wire/contract.js +2 -2
  93. package/cli/dist/clients/wire/queries.js +1 -0
  94. package/cli/dist/clients/wire/schemas.js +6 -2
  95. package/cli/dist/clients/wire/status.js +7 -1
  96. package/cli/dist/clients/wire/words.js +14 -0
  97. package/cli/dist/core/adapters/network.js +20 -1
  98. package/cli/dist/core/adapters/opentofu.js +1 -1
  99. package/cli/dist/core/app-hook/hooks.js +90 -0
  100. package/cli/dist/core/app-hook/token.js +49 -0
  101. package/cli/dist/core/app-init/plan.js +208 -0
  102. package/cli/dist/core/app-values/model.js +45 -0
  103. package/cli/dist/core/app-values/store.js +124 -0
  104. package/cli/dist/core/ctl/answers.js +14 -9
  105. package/cli/dist/core/fleet/brand.js +10 -7
  106. package/cli/dist/core/fleet/parse.js +10 -1
  107. package/cli/dist/core/fleet/settings.js +32 -12
  108. package/cli/dist/core/operations/catalog.js +46 -1
  109. package/cli/dist/core/operations/dispatch.js +40 -9
  110. package/cli/dist/core/recipes/app-check.js +14 -1
  111. package/cli/dist/core/recipes/app-hook.js +26 -0
  112. package/cli/dist/core/recipes/app-values.js +21 -0
  113. package/cli/dist/core/recipes/doctor.js +5 -5
  114. package/cli/dist/core/recipes/host.js +8 -3
  115. package/cli/dist/core/recipes/launch.js +51 -0
  116. package/cli/dist/core/status/look.js +33 -13
  117. package/cli/dist/core/status/model.js +2 -0
  118. package/cli/dist/core/validation/facts.js +1 -3
  119. package/cli/dist/deployer/brand.js +9 -1
  120. package/cli/dist/deployer/build/builder.js +15 -4
  121. package/cli/dist/deployer/build/bundle.js +5 -0
  122. package/cli/dist/deployer/build/client.js +44 -0
  123. package/cli/dist/deployer/build/compose.js +21 -8
  124. package/cli/dist/deployer/build/routes.js +149 -0
  125. package/cli/dist/deployer/ctl/answers.js +6 -2
  126. package/cli/dist/deployer/ctl/ctl.js +66 -9
  127. package/cli/dist/deployer/deployer.js +114 -191
  128. package/cli/dist/deployer/forges/forge.js +0 -12
  129. package/cli/dist/deployer/forges/notify.js +3 -3
  130. package/cli/dist/deployer/http/http.js +0 -1
  131. package/cli/dist/deployer/http/page.js +4 -2
  132. package/cli/dist/deployer/http/webhook.js +0 -1
  133. package/cli/dist/deployer/runs/effects.js +70 -0
  134. package/cli/dist/deployer/runs/queue.js +5 -4
  135. package/cli/dist/deployer/runs/records.js +22 -3
  136. package/cli/dist/deployer/runs/restore.js +6 -0
  137. package/cli/dist/deployer/runs/run.js +64 -11
  138. package/cli/dist/deployer/runs/store.js +19 -3
  139. package/cli/dist/deployer/settings.js +69 -0
  140. package/cli/dist/lib/forge-repo.js +15 -0
  141. package/cli/dist/lib/names.js +13 -0
  142. package/cli/dist/main.js +46 -25
  143. package/compose/docker-compose.ci.yml +2 -0
  144. package/package.json +2 -2
  145. package/schema/app.json +69 -8
  146. package/schema/defaults.json +8 -0
  147. package/schema/vars-platform.json +8 -0
  148. package/scripts/local/app-check.sh +12 -9
  149. package/scripts/local/app-manifests.sh +11 -6
  150. package/scripts/local/verify.sh +30 -12
  151. package/scripts/platform/compose-policy.sh +37 -40
  152. package/terraform/modules/platform-dns/main.tf +66 -0
  153. package/terraform/modules/platform-dns/outputs.tf +9 -0
  154. package/terraform/modules/platform-dns/tests/fleet/.cache/apps/blog/site/app.yml +3 -0
  155. package/terraform/modules/platform-dns/tests/fleet/.cache/apps/shop/app.yml +6 -0
  156. package/terraform/modules/platform-dns/tests/fleet/servers/nested/server.yml +6 -0
  157. package/terraform/modules/platform-dns/tests/fleet/servers/shop/server.yml +7 -0
  158. package/terraform/modules/platform-dns/tests/fleet/servers/uncloned/server.yml +6 -0
  159. package/terraform/modules/platform-dns/tests/platform-dns.tftest.hcl +64 -0
  160. package/terraform/modules/platform-dns/variables.tf +25 -0
  161. package/cli/dist/browser/assets/index-Ct0Eudk4.css +0 -1
  162. package/cli/dist/browser/assets/index-hcyM6f6T.js +0 -7
  163. package/compose/traefik/dynamic/ratelimit.yml +0 -21
  164. package/scripts/agent/guard.sh +0 -125
@@ -9,11 +9,15 @@
9
9
  # browser to the login, not a 403 from rules Authelia never loaded
10
10
  # - every certificate is a real one (Let's Encrypt or mkcert), never
11
11
  # Traefik's default
12
- # - an unsigned webhook is refused; every app hostname answers, not 5xx
12
+ # - an unsigned webhook is refused (with webhooks: false, /hook is not
13
+ # served at all); every app route answers, not 5xx
13
14
  # On the server (one SSH call):
14
15
  # - every app in server.yml is registered, and nothing else
15
16
  # - every app's containers run, none unhealthy; its last run did not fail
16
17
  # - every platform container runs, none unhealthy; no alert is open
18
+ # - which kayra set it up (/opt/kayra/version): one that is not this kayra
19
+ # (KAYRA_VERSION, the fleet's pin) is noted, not failed — it still works,
20
+ # and every server runs the last release until its rollout reaches it
17
21
  #
18
22
  # Certificates and routes can lag a fresh deploy (ACME, DNS-01's minute), so
19
23
  # the probes retry for VERIFY_WAIT seconds (default 150) before failing.
@@ -23,6 +27,7 @@ set -euo pipefail
23
27
 
24
28
  KAYRA_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
25
29
  FLEET_ROOT="${FLEET_ROOT:?the directory of the fleet (servers/), set by kayra}"
30
+ pin="${KAYRA_VERSION:?the kayra that runs, set by kayra}"
26
31
  name="${1:?Usage: verify.sh <server>}"
27
32
  dir="${FLEET_ROOT}/servers/${name}"
28
33
  wait="${VERIFY_WAIT:-150}"
@@ -30,8 +35,11 @@ failed=0
30
35
 
31
36
  fail() { echo " ✗ $*"; failed=1; }
32
37
  pass() { echo " ✓ $*"; }
38
+ note() { echo " ! $*"; }
33
39
 
34
40
  domain="$(yq -r '.domain' "${dir}/server.yml")"
41
+ # Not yq's `//`: it takes false for missing too.
42
+ webhooks="$( { [ -f "${dir}/vars.yml" ] && yq -r '.webhooks' "${dir}/vars.yml"; } || echo true)"
35
43
  inventory="${dir}/inventory.ini"
36
44
  [ -f "$inventory" ] || { fail "no inventory for ${name}: provision it first"; exit 1; }
37
45
  field() { awk -v key="$1" '{for (i = 1; i <= NF; i++) if (index($i, key "=") == 1) {print substr($i, length(key) + 2); exit}}' "$inventory"; }
@@ -42,12 +50,12 @@ key="$(field ansible_ssh_private_key_file)"
42
50
  registered_wanted="$(yq -r '.apps // [] | .[].name' "${dir}/server.yml")"
43
51
 
44
52
  # ── From outside ────────────────────────────────────────────────────────────
45
- # "<status> <redirect> <verify result> <issuer CN>" for a host, pinned to the server.
53
+ # "<status> <redirect> <verify result> <issuer CN>" for a host (and path), pinned to the server.
46
54
  probe() {
47
- local host="$1" method="${2:-GET}" result issuer
55
+ local host="$1" method="${2:-GET}" path="${3:-/}" result issuer
48
56
  result="$(curl -s -o /dev/null -m 10 -X "$method" -H 'Accept: text/html' \
49
57
  --resolve "${host}:443:${address}" -w '%{http_code} %{redirect_url} %{ssl_verify_result}' \
50
- "https://${host}/" 2>/dev/null || echo "000 - -")"
58
+ "https://${host}${path}" 2>/dev/null || echo "000 - -")"
51
59
  issuer="$(openssl s_client -connect "${address}:443" -servername "$host" </dev/null 2>/dev/null \
52
60
  | openssl x509 -noout -issuer 2>/dev/null | sed -n 's/.*CN *= *//p')"
53
61
  echo "${result} ${issuer:-none}"
@@ -55,10 +63,10 @@ probe() {
55
63
 
56
64
  # Probes until `test` accepts the answer or VERIFY_WAIT runs out; prints the last answer.
57
65
  until_ok() {
58
- local host="$1" method="$2" test="$3" deadline answer
66
+ local host="$1" method="$2" test="$3" path="${4:-/}" deadline answer
59
67
  deadline=$(( $(date +%s) + wait ))
60
68
  while :; do
61
- answer="$(probe "$host" "$method")"
69
+ answer="$(probe "$host" "$method" "$path")"
62
70
  if "$test" "$answer"; then echo "$answer"; return 0; fi
63
71
  [ "$(date +%s)" -lt "$deadline" ] || { echo "$answer"; return 1; }
64
72
  sleep 10
@@ -74,8 +82,8 @@ refused() { real_cert "$1" && [ "$(cut -d' ' -f1 <<< "$1")" = 401 ]; }
74
82
  describe() { echo "HTTP $(cut -d' ' -f1 <<< "$1"), certificate by $(cut -d' ' -f4- <<< "$1") (verify $(cut -d' ' -f3 <<< "$1"))"; }
75
83
 
76
84
  check() {
77
- local label="$1" host="$2" method="$3" test="$4" answer
78
- if answer="$(until_ok "$host" "$method" "$test")"; then pass "$label"; else fail "${label}: $(describe "$answer")"; fi
85
+ local label="$1" host="$2" method="$3" test="$4" path="${5:-/}" answer
86
+ if answer="$(until_ok "$host" "$method" "$test" "$path")"; then pass "$label"; else fail "${label}: $(describe "$answer")"; fi
79
87
  }
80
88
 
81
89
  check "auth.${domain} answers" "auth.${domain}" GET answers
@@ -90,10 +98,14 @@ if [ -n "$first_app" ]; then
90
98
  -w '%{http_code}' "https://deploy.${domain}/hook/${first_app}" 2>/dev/null || echo 000
91
99
  }
92
100
  code="$(hook)"
93
- [ "$code" = 401 ] && pass "an unsigned webhook is refused" || fail "an unsigned webhook to /hook/${first_app}: HTTP ${code}, not 401"
94
- while IFS= read -r sub; do
95
- [ -z "$sub" ] || check "${sub}.${domain} answers" "${sub}.${domain}" GET not_5xx
96
- done < <(bash "${KAYRA_ROOT}/scripts/local/app-manifests.sh" --subdomains "$name")
101
+ if [ "$webhooks" = false ]; then
102
+ [ "$code" = 404 ] && pass "webhooks are off: /hook is not served" || fail "webhooks: false, yet /hook/${first_app} answers HTTP ${code}, not 404"
103
+ else
104
+ [ "$code" = 401 ] && pass "an unsigned webhook is refused" || fail "an unsigned webhook to /hook/${first_app}: HTTP ${code}, not 401"
105
+ fi
106
+ while read -r sub path; do
107
+ [ -z "$sub" ] || check "${sub}.${domain}${path%/} answers" "${sub}.${domain}" GET not_5xx "$path"
108
+ done < <(bash "${KAYRA_ROOT}/scripts/local/app-manifests.sh" --routes "$name")
97
109
  fi
98
110
 
99
111
  # ── On the server ───────────────────────────────────────────────────────────
@@ -102,6 +114,7 @@ facts="$(ssh -p "${port:-22}" -i "$key" -o StrictHostKeyChecking=no -o UserKnown
102
114
  cd /opt/platform
103
115
  echo "registered $(ls apps 2>/dev/null | sed -n "s/\.json$//p" | sort | tr "\n" " ")"
104
116
  echo "alerts $(ls alerts 2>/dev/null | tr "\n" " ")"
117
+ echo "kayra $(cat /opt/kayra/version 2>/dev/null || true)"
105
118
  docker compose ps -a --format "{{.Service}}|{{.State}}|{{.Health}}" | sed "s/^/platform /"
106
119
  for app in $(ls apps 2>/dev/null | sed -n "s/\.json$//p"); do
107
120
  docker ps -a --filter "label=com.docker.compose.project=$app" --format "{{.Names}}|{{.State}}|{{.Status}}" | sed "s/^/container $app /"
@@ -116,6 +129,11 @@ have="$(xargs <<< "$have")"
116
129
  [ "$wanted" = "$have" ] && pass "registered: ${have:-no apps}" \
117
130
  || fail "registered: ${have:-nothing}; server.yml says ${wanted:-no apps} (kayra apps ${name})"
118
131
 
132
+ running="$(sed -n 's/^kayra //p' <<< "$facts" | xargs)"
133
+ if [ "$running" = "$pin" ]; then pass "set up by kayra ${pin}, the fleet's pin"
134
+ elif [ -z "$running" ]; then note "set up by a kayra that recorded no version; the fleet pins ${pin} (kayra deploy ${name})"
135
+ else note "set up by kayra ${running}; the fleet pins ${pin} (kayra deploy ${name})"; fi
136
+
119
137
  alerts="$(sed -n 's/^alerts //p' <<< "$facts" | xargs)"
120
138
  [ -z "$alerts" ] && pass "no alert is open" || fail "open alerts: ${alerts}"
121
139
 
@@ -1,31 +1,41 @@
1
1
  #!/usr/bin/env bash
2
2
  # =============================================================================
3
- # compose-policy.sh <app> <allowed-host>... < config.json
3
+ # compose-policy.sh <app> <domain> <routes> <allowed-host>... < config.json
4
4
  #
5
5
  # The platform's admission check, run by the deployer before every
6
6
  # `docker compose up`. Input is `docker compose config --no-env-resolution
7
- # --format json`: the fully resolved config, so variables, overlays and
8
- # defaults cannot hide anything. Env files stay unresolved on purpose: the
9
- # deployer would read them from its own filesystem, platform secrets
10
- # included. Prints one line per violation and exits 1 if there is any.
7
+ # --format json` of the app's own compose files: the fully resolved config, so
8
+ # variables, overlays and defaults cannot hide anything. Env files stay
9
+ # unresolved on purpose: the deployer would read them from its own filesystem,
10
+ # platform secrets included. Prints one line per violation and exits 1 if
11
+ # there is any.
11
12
  #
12
13
  # An allow-list: a service key the platform has not thought about is refused,
13
14
  # rather than a new Compose feature quietly opening a hole. Modelled on
14
15
  # Kubernetes' Pod Security "restricted" profile, adapted to what matters on a
15
16
  # shared Docker host: an app must not reach the host, other apps, or the
16
- # platform, must not claim anyone else's hostnames or Traefik names, and must
17
- # declare how much memory it may take. Running as root inside the container is
18
- # allowed (unlike restricted): without capabilities or host access it gets
19
- # nothing a non-root user would not.
17
+ # platform, and must declare how much memory it may take. Running as root
18
+ # inside the container is allowed (unlike restricted): without capabilities or
19
+ # host access it gets nothing a non-root user would not.
20
+ #
21
+ # Routing is the platform's: the app's routes (app.yml `routes`, as JSON) are
22
+ # checked here against its config, each to one of its services on one of its
23
+ # registered hosts, and the deployer writes the Traefik labels and the
24
+ # platform network from them after admission. So an app's own files carry
25
+ # neither: no `traefik.*` label, no `platform-*` network.
20
26
  # =============================================================================
21
27
  set -euo pipefail
22
28
 
23
- app="${1:?Usage: compose-policy.sh <app> <allowed-host>... < config.json}"
24
- shift
25
- hosts=$(printf '%s\n' "$@" | jq -R . | jq -s .)
29
+ usage="Usage: compose-policy.sh <app> <domain> <routes> <allowed-host>... < config.json"
30
+ app="${1:?$usage}"
31
+ domain="${2:?$usage}"
32
+ routes="${3:?$usage}"
33
+ shift 3
34
+ hosts=$(printf '%s\n' "$@" | jq -R 'select(. != "")' | jq -s .)
26
35
 
27
- jq -r --arg app "$app" --argjson hosts "$hosts" '
36
+ jq -r --arg app "$app" --arg domain "$domain" --argjson routes "$routes" --argjson hosts "$hosts" '
28
37
  def own($name): $name | startswith($app + "_");
38
+ def platform($name): $name | startswith("platform-");
29
39
  def registry_ref: test("^(localhost|registry):5000/");
30
40
  def allowed: ["image", "command", "entrypoint", "environment", "labels",
31
41
  "networks", "volumes", "tmpfs", "healthcheck", "depends_on", "restart",
@@ -42,43 +52,30 @@ jq -r --arg app "$app" --argjson hosts "$hosts" '
42
52
  (if ($s.mem_limit // $s.deploy.resources.limits.memory) == null
43
53
  then "no memory limit (set mem_limit)" else empty end),
44
54
  ($s.networks // {} | to_entries[] | .key as $net | .value // {} |
45
- (keys - ["aliases"] | .[] | "networks.\($net).\(.) is not allowed"),
46
- (select($root.networks[$net].name == "platform-public") | .aliases // [] | .[]
47
- | select(startswith($app + "-") | not)
48
- | "alias \(.) on platform-public must start with \($app)-")),
55
+ (keys - ["aliases"] | .[] | "networks.\($net).\(.) is not allowed")),
49
56
  ($s.volumes // [] | .[] | select(.type != "volume" and .type != "tmpfs")
50
57
  | "\(.type) mount \(.source // "") -> \(.target) (named volumes only)"),
51
58
  (if ($s.image // "") | registry_ref and (test("^[^/]+/" + $app + "/") | not)
52
59
  then "image \($s.image) is outside the \($app)/ namespace" else empty end),
53
- ($s.labels // {} | to_entries[] |
54
- (select(.key | test("^traefik\\.(tcp|udp)\\.")) | "\(.key) (HTTP routers only)"),
55
- (select(.key | test("^traefik\\.http\\.(routers|services|middlewares)\\."))
56
- | (.key | split(".")[3]) as $name
57
- | select($name | startswith($app + "-") | not)
58
- | "\(.key): Traefik names must start with \($app)-"),
59
- (select(.value | test("@internal")) | "\(.key) references an @internal service"),
60
- (select(.key | test("^traefik\\.http\\.routers\\.[^.]+\\.middlewares$"))
61
- | select(.value | split(",") | map(gsub("\\s"; "")) | index("authelia@file"))
62
- | "\(.key): authelia@file is the platform'"'"'s login; apps bring their own"),
63
- (select(.key | test("^traefik\\.http\\.routers\\.[^.]+\\.rule$")) | .key as $k | .value as $rule |
64
- ([$rule | scan("Host\\(`([^`]*)`\\)") | .[0]]) as $claimed |
65
- if ($rule | test("HostRegexp|HostSNI")) then "\($k): only Host() rules are allowed"
66
- elif ($claimed | length) == 0 then "\($k): rule must name a Host()"
67
- else ($claimed[] | select(. as $h | $hosts | index($h) | not)
68
- | "\($k): host \(.) is not one of this app'"'"'s")
69
- end)
70
- )
60
+ ($s.labels // {} | keys[] | select(ascii_downcase | startswith("traefik."))
61
+ | "label \(.): Traefik labels are the platform'"'"'s; declare routes in app.yml")
71
62
  ) | "service \($svc): \(.)"
72
63
  ),
73
64
  (.networks // {} | to_entries[] | .value as $n |
74
- (select(($n.name // "") != "platform-public" and (own($n.name // "") | not))
75
- | "network \(.key): \($n.name // "?") is neither the app'"'"'s own nor platform-public"),
76
- (select($n.name == "platform-public" and $n.external != true)
77
- | "network \(.key): platform-public is the platform'"'"'s, declare it external: true")),
65
+ if platform(.key) or platform($n.name // "")
66
+ then "network \(.key): platform networks are the platform'"'"'s; it attaches routed services itself"
67
+ elif own($n.name // "") | not
68
+ then "network \(.key): \($n.name // "?") is not the app'"'"'s own"
69
+ else empty end),
78
70
  (.volumes // {} | to_entries[] | .value as $v |
79
71
  (select($v.external) | "volume \(.key): external volumes are not allowed"),
80
72
  (select(($v.driver_opts // {}) | length > 0) | "volume \(.key): driver_opts are not allowed"),
81
73
  (select(own($v.name // "") | not) | "volume \(.key): \($v.name) belongs to another project")),
82
74
  (.secrets // {}, .configs // {} | to_entries[] | select(.value.file)
83
- | "\(.key): file-backed secrets/configs read the host filesystem")
75
+ | "\(.key): file-backed secrets/configs read the host filesystem"),
76
+ ($routes | to_entries[] | .value as $r | "route \($r.host)\($r.path // "")" as $route |
77
+ (select($root.services[$r.service] == null)
78
+ | "\($route): no service \($r.service) in the compose files"),
79
+ (select($hosts | index("\($r.host).\($domain)") | not)
80
+ | "\($route): \($r.host).\($domain) is not one of this app'"'"'s hosts (kayra apps registers new ones)"))
84
81
  ' | { violations=$(cat); [ -z "$violations" ] || { echo "$violations"; exit 1; }; }
@@ -0,0 +1,66 @@
1
+ # =============================================================================
2
+ # A platform server's DNS: an A record for each host it serves, derived from
3
+ # the fleet, never listed by hand. The platform's own subdomains (kayra's
4
+ # hosts.conf) and every route host of every app in server.yml, as the app's
5
+ # app.yml in the fleet's clone (.cache/apps, which kayra doctor fills) says.
6
+ # A new route host in an app is a new record on the next apply.
7
+ # =============================================================================
8
+
9
+ terraform {
10
+ required_version = ">= 1.6.0"
11
+
12
+ required_providers {
13
+ hcloud = {
14
+ source = "hetznercloud/hcloud"
15
+ version = "~> 1.70"
16
+ }
17
+ }
18
+ }
19
+
20
+ locals {
21
+ descriptor = yamldecode(file("${var.fleet_root}/servers/${var.server}/server.yml"))
22
+ domain = local.descriptor.domain
23
+ apps = try(local.descriptor.apps, [])
24
+
25
+ manifests = {
26
+ for app in local.apps :
27
+ app.name => "${var.fleet_root}/.cache/apps/${app.name}/${try(app.path, ".")}/app.yml"
28
+ }
29
+ uncloned = [for name, manifest in local.manifests : name if !fileexists(manifest)]
30
+
31
+ platform_subdomains = [
32
+ for line in split("\n", file("${path.module}/../../../hosts.conf")) :
33
+ split(" ", trimspace(line))[0] if trimspace(line) != "" && !startswith(trimspace(line), "#")
34
+ ]
35
+ app_subdomains = flatten([
36
+ for name, manifest in local.manifests :
37
+ fileexists(manifest) ? [for route in try(yamldecode(file(manifest)).routes, []) : route.host] : []
38
+ ])
39
+ subdomains = toset(concat(local.platform_subdomains, local.app_subdomains))
40
+
41
+ # A host's name in the zone: www under ippo-club.net in ippo-club.net is www;
42
+ # under shop.example.com in example.com it is www.shop.
43
+ suffix = local.domain == var.zone ? "" : trimsuffix(local.domain, ".${var.zone}")
44
+ names = { for sub in local.subdomains : sub => local.suffix == "" ? sub : "${sub}.${local.suffix}" }
45
+ }
46
+
47
+ resource "hcloud_zone_rrset" "a" {
48
+ for_each = local.names
49
+
50
+ zone = var.zone
51
+ name = each.value
52
+ type = "A"
53
+ ttl = var.ttl
54
+ records = [{ value = var.address }]
55
+
56
+ lifecycle {
57
+ precondition {
58
+ condition = local.domain == var.zone || endswith(local.domain, ".${var.zone}")
59
+ error_message = "${var.server}'s domain ${local.domain} is not in the zone ${var.zone}."
60
+ }
61
+ precondition {
62
+ condition = length(local.uncloned) == 0
63
+ error_message = "No app.yml in .cache/apps for ${join(", ", local.uncloned)}: run kayra doctor in the fleet, which clones every app, then apply again."
64
+ }
65
+ }
66
+ }
@@ -0,0 +1,9 @@
1
+ output "records" {
2
+ description = "Every A record, its name in the zone => address"
3
+ value = { for sub, rrset in hcloud_zone_rrset.a : rrset.name => var.address }
4
+ }
5
+
6
+ output "hosts" {
7
+ description = "Every host this server serves, fully qualified"
8
+ value = sort([for sub in local.subdomains : "${sub}.${local.domain}"])
9
+ }
@@ -0,0 +1,3 @@
1
+ name: blog
2
+ compose: [compose.yml]
3
+ routes: [{host: blog, service: web, port: 80}]
@@ -0,0 +1,6 @@
1
+ name: shop
2
+ compose: [compose.yml]
3
+ routes:
4
+ - {host: www, service: web, port: 3000}
5
+ - {host: www, path: /api, service: api, port: 3000}
6
+ - {host: api, service: api, port: 3000}
@@ -0,0 +1,6 @@
1
+ kind: platform
2
+ target: hetzner
3
+ domain: shop.example.com
4
+ vault: true
5
+ apps:
6
+ - {name: shop, repo: https://github.com/acme/shop.git}
@@ -0,0 +1,7 @@
1
+ kind: platform
2
+ target: hetzner
3
+ domain: example.com
4
+ vault: true
5
+ apps:
6
+ - {name: shop, repo: https://github.com/acme/shop.git}
7
+ - {name: blog, repo: https://github.com/acme/blog.git, path: site}
@@ -0,0 +1,6 @@
1
+ kind: platform
2
+ target: hetzner
3
+ domain: example.com
4
+ vault: true
5
+ apps:
6
+ - {name: missing, repo: https://github.com/acme/missing.git}
@@ -0,0 +1,64 @@
1
+ mock_provider "hcloud" {}
2
+
3
+ variables {
4
+ fleet_root = "./tests/fleet"
5
+ address = "192.0.2.10"
6
+ }
7
+
8
+ # The platform's hosts and every app's route hosts, once each.
9
+ run "every_host_once" {
10
+ command = plan
11
+
12
+ variables {
13
+ server = "shop"
14
+ zone = "example.com"
15
+ }
16
+
17
+ assert {
18
+ condition = output.hosts == sort(["api.example.com", "auth.example.com", "blog.example.com", "deploy.example.com", "traefik.example.com", "www.example.com"])
19
+ error_message = "Unexpected hosts: ${jsonencode(output.hosts)}"
20
+ }
21
+
22
+ assert {
23
+ condition = hcloud_zone_rrset.a["www"].name == "www" && one(hcloud_zone_rrset.a["www"].records).value == "192.0.2.10"
24
+ error_message = "www is not an A record to the server"
25
+ }
26
+ }
27
+
28
+ # A server under the zone: its names carry the rest of its domain.
29
+ run "domain_under_the_zone" {
30
+ command = plan
31
+
32
+ variables {
33
+ server = "nested"
34
+ zone = "example.com"
35
+ }
36
+
37
+ assert {
38
+ condition = hcloud_zone_rrset.a["www"].name == "www.shop" && hcloud_zone_rrset.a["deploy"].name == "deploy.shop"
39
+ error_message = "Names under shop.example.com in example.com should end in .shop"
40
+ }
41
+ }
42
+
43
+ run "domain_outside_the_zone" {
44
+ command = plan
45
+
46
+ variables {
47
+ server = "shop"
48
+ zone = "example.org"
49
+ }
50
+
51
+ expect_failures = [hcloud_zone_rrset.a]
52
+ }
53
+
54
+ # An app the fleet has not cloned: no guessing its hosts, a pointer to kayra doctor.
55
+ run "app_not_cloned" {
56
+ command = plan
57
+
58
+ variables {
59
+ server = "uncloned"
60
+ zone = "example.com"
61
+ }
62
+
63
+ expect_failures = [hcloud_zone_rrset.a]
64
+ }
@@ -0,0 +1,25 @@
1
+ variable "fleet_root" {
2
+ description = "The fleet's directory (the one holding servers/): the module reads servers/<server>/server.yml and each app's app.yml from .cache/apps"
3
+ type = string
4
+ }
5
+
6
+ variable "server" {
7
+ description = "The platform server whose hosts these are"
8
+ type = string
9
+ }
10
+
11
+ variable "zone" {
12
+ description = "The DNS zone the records go in: the server's domain, or a domain it is under"
13
+ type = string
14
+ }
15
+
16
+ variable "address" {
17
+ description = "The server's IPv4 address, e.g. from its OpenTofu state"
18
+ type = string
19
+ }
20
+
21
+ variable "ttl" {
22
+ description = "The records' TTL in seconds"
23
+ type = number
24
+ default = 300
25
+ }
@@ -1 +0,0 @@
1
- :root{--bg:#f7f7f8;--panel:#fff;--panel-2:#f2f2f4;--line:#e4e4e8;--line-strong:#d4d4da;--fg:#18181b;--fg-2:#52525b;--muted:#8a8a94;--accent:#5b5bd6;--accent-soft:#ededfc;--ok:#18794e;--ok-soft:#e6f6ed;--bad:#ce2c31;--bad-soft:#feebec;--warn:#ab6400;--warn-soft:#fff4d5;--active:#0d74ce;--active-soft:#e6f2fd;--code-bg:#0f0f12;--code-fg:#e4e4e8;--radius:10px;--shadow:0 1px 2px #0000000a, 0 4px 16px #0000000a;--mono:ui-monospace, "SF Mono", "JetBrains Mono", Menlo, monospace;--sans:-apple-system, BlinkMacSystemFont, "Inter", "Segoe UI", system-ui, sans-serif;--lightningcss-light:initial;--lightningcss-dark: ;color-scheme:light dark}@media (prefers-color-scheme:dark){:root{--lightningcss-light: ;--lightningcss-dark:initial;--bg:#0e0e11;--panel:#16161a;--panel-2:#1c1c21;--line:#26262c;--line-strong:#33333b;--fg:#ededf0;--fg-2:#b4b4bd;--muted:#7c7c87;--accent:#8b8bf5;--accent-soft:#23234a;--ok:#4cc38a;--ok-soft:#12291d;--bad:#ff6369;--bad-soft:#3b1219;--warn:#f1a10d;--warn-soft:#2e2309;--active:#70b8ff;--active-soft:#0d2847;--code-bg:#0a0a0c;--shadow:0 1px 2px #0000004d, 0 4px 16px #0003}}*{box-sizing:border-box}body{font:14px/1.5 var(--sans);color:var(--fg);background:var(--bg);-webkit-font-smoothing:antialiased;margin:0}a{color:inherit}code,pre,kbd{font-family:var(--mono);font-size:12.5px}h1,h2,h3{letter-spacing:-.01em;margin:0}button,input{font:inherit;color:inherit}.shell{grid-template-columns:248px 1fr;min-height:100vh;display:grid}.sidebar{border-right:1px solid var(--line);background:var(--panel);flex-direction:column;gap:18px;height:100vh;padding:16px 12px;display:flex;position:sticky;top:0;overflow-y:auto}.brand{align-items:center;gap:10px;padding:4px 8px 8px;text-decoration:none;display:flex}.brand strong{font-size:15px;display:block}.brand-sub{color:var(--muted);font-size:12px;display:block}.logo{background:var(--accent);color:#fff;width:30px;height:30px;font-weight:700;font-family:var(--mono);border-radius:8px;place-items:center;display:grid}.nav-title{text-transform:uppercase;letter-spacing:.06em;color:var(--muted);padding:0 10px 4px;font-size:11px;font-weight:600}.nav-item{color:var(--fg-2);border-radius:7px;align-items:center;gap:9px;padding:6px 10px;text-decoration:none;display:flex}.nav-item:hover{background:var(--panel-2);color:var(--fg)}.nav-item.current{background:var(--accent-soft);color:var(--fg);font-weight:550}.nav-meta{color:var(--muted);margin-left:auto;font-size:11px}.sidebar-foot{color:var(--muted);font-size:12px;font-family:var(--mono);margin-top:auto;padding:0 10px}.main{width:100%;max-width:1180px;padding:20px 36px 64px}@media (width<=860px){.shell{grid-template-columns:1fr}.sidebar{height:auto;position:static}.main{padding:16px}}.topbar{justify-content:flex-end;gap:10px;margin-bottom:18px;display:flex}.search{border:1px solid var(--line);background:var(--panel);min-width:260px;color:var(--muted);cursor:pointer;border-radius:8px;align-items:center;gap:24px;padding:6px 8px 6px 12px;display:flex}.search kbd{border:1px solid var(--line-strong);border-radius:5px;margin-left:auto;padding:1px 6px;font-size:11px}.page-header{justify-content:space-between;align-items:flex-end;gap:16px;margin:8px 0 22px;display:flex}.page-header h1{align-items:center;gap:10px;font-size:24px;font-weight:650;display:flex}.page-header .sub,.sub{color:var(--muted);margin-top:4px}.actions,.inline{align-items:center;gap:8px;display:flex}.card{background:var(--panel);border:1px solid var(--line);border-radius:var(--radius);box-shadow:var(--shadow);margin-bottom:16px;padding:16px 18px}.card h2{color:var(--fg-2);margin-bottom:10px;font-size:13px;font-weight:600}.cards{grid-template-columns:repeat(auto-fill,minmax(310px,1fr));gap:16px;display:grid}.columns{grid-template-columns:1fr 1fr;gap:16px;display:grid}@media (width<=860px){.columns{grid-template-columns:1fr}}.card-head{align-items:center;gap:8px;margin-bottom:6px;display:flex}.card-head h2{color:var(--fg);margin:0;font-size:16px}.server-card{text-decoration:none;transition:border-color .15s,transform .15s;display:block}.server-card:hover{border-color:var(--line-strong);transform:translateY(-1px)}.domain{font-family:var(--mono);color:var(--muted);margin-bottom:12px;font-size:12.5px}.facts{gap:6px;margin:0;display:grid}.fact{grid-template-columns:72px 1fr;align-items:center;display:grid}.fact dt{color:var(--muted);font-size:12.5px}.fact dd{font-family:var(--mono);align-items:center;gap:7px;margin:0;font-size:12.5px;display:flex}.chips{flex-wrap:wrap;gap:6px;margin-top:12px;display:flex}.grow{flex:1}.pill{background:var(--panel-2);color:var(--fg-2);border:1px solid var(--line);border-radius:999px;align-items:center;padding:1px 8px;font-size:11.5px;font-weight:550;display:inline-flex}.pill-ok{background:var(--ok-soft);color:var(--ok);border-color:#0000}.pill-bad{background:var(--bad-soft);color:var(--bad);border-color:#0000}.pill-warn{background:var(--warn-soft);color:var(--warn);border-color:#0000}.pill-active{background:var(--active-soft);color:var(--active);border-color:#0000}.pill-accent{background:var(--accent-soft);color:var(--accent);border-color:#0000}.pill-muted{color:var(--muted)}.dot{background:var(--muted);border-radius:50%;flex:none;width:8px;height:8px;display:inline-block}.dot-ok{background:var(--ok);box-shadow:0 0 0 3px var(--ok-soft)}.dot-bad{background:var(--bad);box-shadow:0 0 0 3px var(--bad-soft)}.dot-warn{background:var(--warn);box-shadow:0 0 0 3px var(--warn-soft)}.dot-active,.dot-accent{background:var(--active)}.dot-waiting{background:var(--active);animation:1.2s ease-in-out infinite breathe}@keyframes breathe{50%{opacity:.25}}.tone-ok{color:var(--ok)}.tone-bad{color:var(--bad)}.tone-warn{color:var(--warn)}.tone-active{color:var(--active)}.tone-muted{color:var(--muted)}.tone-strong{font-weight:600}.tone-accent{color:var(--accent);font-weight:600}.button{border:1px solid var(--line-strong);background:var(--panel);cursor:pointer;border-radius:7px;padding:6px 12px;font-weight:550}.button:hover{background:var(--panel-2)}.button:disabled{opacity:.5;cursor:default}.button.primary{background:var(--accent);border-color:var(--accent);color:#fff}.button.danger{background:var(--bad);border-color:var(--bad);color:#fff}.button.small{padding:2px 8px;font-size:12.5px}.link{cursor:pointer;background:0 0;border:none;padding:0;text-decoration:underline}.danger-link{color:var(--bad)}input{border:1px solid var(--line-strong);background:var(--panel);border-radius:7px;padding:6px 10px}input:focus,button:focus-visible,a:focus-visible{outline:2px solid var(--accent);outline-offset:1px}.action-grid{grid-template-columns:repeat(auto-fill,minmax(220px,1fr));gap:10px;display:grid}.action{text-align:left;border:1px solid var(--line);background:var(--panel-2);cursor:pointer;border-radius:9px;gap:2px;padding:10px 12px;display:grid}.action strong{font-family:var(--mono);font-size:13px}.action span{color:var(--muted);font-size:12.5px}.action:hover{border-color:var(--accent)}.action.primary{border-color:var(--accent);background:var(--accent-soft)}.action.danger strong{color:var(--bad)}.action:disabled{opacity:.45;cursor:default}.table{border-collapse:collapse;width:100%}.table th{text-align:left;color:var(--muted);border-bottom:1px solid var(--line);padding:6px 8px;font-size:12px;font-weight:550}.table td{border-bottom:1px solid var(--line);padding:8px}.table tr:last-child td{border-bottom:none}.table .narrow{width:20px}.right{text-align:right}.clickable{cursor:pointer}.clickable:hover td{background:var(--panel-2)}.links{gap:4px;margin:0;padding:0;list-style:none;display:grid}.releases{margin:0;padding:0;list-style:none}.releases li{border-bottom:1px solid var(--line);align-items:center;gap:14px;padding:8px 0;display:flex}.findings{gap:6px;margin:8px 0 0;padding:0;list-style:none;display:grid}.finding{grid-template-columns:18px 1fr;display:grid}.hint{color:var(--muted);font-size:12.5px;display:block}.empty,.waiting{color:var(--muted)}.waiting{align-items:center;gap:8px;padding:6px 0;display:flex}.small{font-size:12.5px}.notice{background:var(--warn-soft);color:var(--warn);border-radius:8px;margin-bottom:16px;padding:10px 14px}.problem{background:var(--bad-soft);color:var(--bad);border-radius:8px;margin:8px 0;padding:12px 14px}.problem pre{white-space:pre-wrap;color:var(--fg);margin:6px 0 0}.tabs{gap:4px;margin-bottom:10px;display:flex}.tab{cursor:pointer;color:var(--muted);background:0 0;border:none;border-radius:7px;padding:6px 12px;font-weight:550}.tab.current{background:var(--panel);color:var(--fg);box-shadow:var(--shadow)}.log{background:var(--code-bg);max-height:70vh;color:var(--code-fg);border-radius:8px;margin:0;padding:12px;overflow:auto}.spinner{border:2px solid var(--line-strong);border-top-color:var(--active);border-radius:50%;width:12px;height:12px;animation:.7s linear infinite spin;display:inline-block}@keyframes spin{to{transform:rotate(360deg)}}.overlay{z-index:10;-webkit-backdrop-filter:blur(2px);backdrop-filter:blur(2px);background:#00000059;justify-content:center;align-items:flex-start;padding:8vh 16px;display:flex;position:fixed;inset:0}.sheet{background:var(--panel);border:1px solid var(--line);border-radius:14px;flex-direction:column;width:min(760px,100%);max-height:84vh;display:flex;box-shadow:0 24px 64px #00000040}.sheet-head{border-bottom:1px solid var(--line);padding:18px 20px 12px}.sheet-body{padding:6px 20px 12px;overflow-y:auto}.sheet-foot{border-top:1px solid var(--line);gap:12px;padding:14px 20px;display:grid}.command{font-size:15px;font-weight:600}.part{text-transform:uppercase;letter-spacing:.06em;color:var(--accent);margin:14px 0 6px;font-size:11px;font-weight:650}.plan{gap:8px;margin:0;padding:0;list-style:none;display:grid}.plan-step{grid-template-columns:26px 1fr;display:grid}.plan-index{color:var(--muted);font-family:var(--mono);padding-top:2px;font-size:12px}.plan-title{align-items:center;gap:8px;display:flex}.plan-command{color:var(--muted);word-break:break-all;margin-top:3px;font-size:12px;display:block}.confirm{gap:6px;display:grid}.buttons{justify-content:flex-end;gap:8px;display:flex}.timeline{gap:6px;display:grid}.step{border:1px solid var(--line);background:var(--panel);border-radius:9px}.step summary{cursor:pointer;grid-template-columns:22px 1fr auto auto;align-items:center;gap:10px;padding:9px 12px;list-style:none;display:grid}.step summary::-webkit-details-marker{display:none}.step-icon{place-items:center;font-weight:700;display:grid}.step-passed .step-icon{color:var(--ok)}.step-failed .step-icon{color:var(--bad)}.step-stopped .step-icon{color:var(--warn)}.step-waiting,.step-skipped{opacity:.55}.step-failed{border-color:var(--bad)}.step-running{border-color:var(--active)}.step-kind{color:var(--muted);font-size:11px;font-family:var(--mono)}.step-time{font-family:var(--mono);color:var(--muted);text-align:right;min-width:64px;font-size:12px}.output{background:var(--code-bg);max-height:60vh;color:var(--code-fg);font-family:var(--mono);white-space:pre-wrap;word-break:break-word;border-radius:8px;margin:0 12px 12px;padding:10px 12px;font-size:12.5px;overflow:auto}.output .stderr{color:#f0b3b3}.said{color:var(--code-fg)}.said-err{color:#ffb4b4}.run-footer{background:var(--panel);border:1px solid var(--line);font-family:var(--mono);border-radius:10px;margin-top:16px;padding:14px 16px}.tone-border-ok{border-left:4px solid var(--ok)}.tone-border-bad{border-left:4px solid var(--bad)}.tone-border-warn{border-left:4px solid var(--warn)}.tone-border-active{border-left:4px solid var(--active)}.lines div{white-space:pre-wrap}.ask{background:var(--bad-soft);border-radius:10px;flex-wrap:wrap;align-items:center;gap:10px;margin-bottom:14px;padding:14px 16px;display:flex}.sgr-red{color:#ff7b72}.sgr-green{color:#7ee787}.sgr-yellow{color:#f2cc60}.sgr-blue{color:#79c0ff}.sgr-magenta{color:#d2a8ff}.sgr-cyan{color:#76e3ea}.sgr-white,.sgr-bright-white{color:#fff}.sgr-black{color:#8b949e}.sgr-bright-red{color:#ffa198}.sgr-bright-green{color:#56d364}.sgr-bright-yellow{color:#e3b341}.sgr-bright-blue{color:#a5d6ff}.sgr-bright-magenta{color:#e2c5ff}.sgr-bright-cyan{color:#b3f0ff}.sgr-bright-black{color:#8b949e}.sgr-bold{font-weight:700}.sgr-dim{opacity:.6}.palette{background:var(--panel);border:1px solid var(--line);border-radius:14px;width:min(620px,100%);overflow:hidden;box-shadow:0 24px 64px #00000040}.palette input{border:none;border-bottom:1px solid var(--line);background:0 0;border-radius:0;outline:none;width:100%;padding:14px 16px;font-size:15px}.palette ul{max-height:50vh;margin:0;padding:6px;list-style:none;overflow-y:auto}.palette li{cursor:pointer;border-radius:8px;justify-content:space-between;padding:8px 10px;display:flex}.palette li .hint{display:inline}.palette li.selected{background:var(--accent-soft)}button,input,select,textarea{font:inherit;color:inherit}select,textarea{border:1px solid var(--line-strong);background:var(--panel);border-radius:6px;padding:7px 10px}.operation-fields{gap:18px;display:grid}.operation-field{gap:5px;display:grid}.operation-field>label{font-weight:550}.operation-field input,.operation-field select,.operation-field textarea{width:100%;min-width:0}.operation-field .inline input{flex:1}.operation-field .inline button{flex-shrink:0}.toggle{align-items:center;gap:8px;display:flex}.toggle input{width:auto}.run-options{border:1px solid var(--line);border-radius:8px;gap:10px;padding:12px;display:grid}.run-options legend{color:var(--muted);padding:0 5px}.query-result{white-space:pre-wrap;overflow-wrap:anywhere;margin:0}.directory-picker{border:1px solid var(--line);border-radius:8px;padding:12px}.directory-path{overflow-wrap:anywhere;margin:10px 0;display:block}.directory-list{max-height:220px;padding:0;list-style:none;overflow-y:auto}.directory-list button{text-align:left;cursor:pointer;background:0 0;border:0;width:100%;padding:6px}.directory-list button:hover{background:var(--panel-2)}.terminal-scroll{background:#0a0a0c;border-radius:8px;padding:12px;overflow-x:auto}.terminal{min-width:max-content}.sheet{max-height:90vh;overflow-y:auto}.xterm{cursor:text;-webkit-user-select:none;user-select:none;position:relative}.xterm.focus,.xterm:focus{outline:none}.xterm .xterm-helpers{z-index:5;position:absolute;top:0}.xterm .xterm-helper-textarea{opacity:0;z-index:-5;white-space:nowrap;resize:none;border:0;width:0;height:0;margin:0;padding:0;position:absolute;top:0;left:-9999em;overflow:hidden}.xterm .composition-view{color:#fff;white-space:nowrap;z-index:1;background:#000;display:none;position:absolute}.xterm .composition-view.active{display:block}.xterm .xterm-viewport{cursor:default;background-color:#000;position:absolute;inset:0;overflow-y:scroll}.xterm .xterm-screen{position:relative}.xterm .xterm-screen canvas{position:absolute;top:0;left:0}.xterm-char-measure-element{visibility:hidden;line-height:normal;display:inline-block;position:absolute;top:0;left:-9999em}.xterm.enable-mouse-events{cursor:default}.xterm.xterm-cursor-pointer,.xterm .xterm-cursor-pointer{cursor:pointer}.xterm.column-select.focus{cursor:crosshair}.xterm .xterm-accessibility:not(.debug),.xterm .xterm-message{z-index:10;color:#0000;pointer-events:none;position:absolute;inset:0}.xterm .xterm-accessibility-tree:not(.debug) ::selection{color:#0000}.xterm .xterm-accessibility-tree{-webkit-user-select:text;user-select:text;white-space:pre;font-family:monospace}.xterm .xterm-accessibility-tree>div{transform-origin:0;width:fit-content}.xterm .live-region{width:1px;height:1px;position:absolute;left:-9999px;overflow:hidden}.xterm-dim{opacity:1!important}.xterm-underline-1{text-decoration:underline}.xterm-underline-2{-webkit-text-decoration:underline double;text-decoration:underline double}.xterm-underline-3{-webkit-text-decoration:underline wavy;text-decoration:underline wavy}.xterm-underline-4{-webkit-text-decoration:underline dotted;text-decoration:underline dotted}.xterm-underline-5{-webkit-text-decoration:underline dashed;text-decoration:underline dashed}.xterm-overline{text-decoration:overline}.xterm-overline.xterm-underline-1{text-decoration:underline overline}.xterm-overline.xterm-underline-2{-webkit-text-decoration:overline double underline;text-decoration:overline double underline}.xterm-overline.xterm-underline-3{-webkit-text-decoration:overline wavy underline;text-decoration:overline wavy underline}.xterm-overline.xterm-underline-4{-webkit-text-decoration:overline dotted underline;text-decoration:overline dotted underline}.xterm-overline.xterm-underline-5{-webkit-text-decoration:overline dashed underline;text-decoration:overline dashed underline}.xterm-strikethrough{text-decoration:line-through}.xterm-screen .xterm-decoration-container .xterm-decoration{z-index:6;position:absolute}.xterm-screen .xterm-decoration-container .xterm-decoration.xterm-decoration-top-layer{z-index:7}.xterm-decoration-overview-ruler{z-index:8;pointer-events:none;position:absolute;top:0;right:0}.xterm-decoration-top{z-index:2;position:relative}.xterm .xterm-scrollable-element>.scrollbar{cursor:default}.xterm .xterm-scrollable-element>.scrollbar>.scra{cursor:pointer;font-size:11px!important}.xterm .xterm-scrollable-element>.visible{opacity:1;z-index:11;background:0 0;transition:opacity .1s linear}.xterm .xterm-scrollable-element>.invisible{opacity:0;pointer-events:none}.xterm .xterm-scrollable-element>.invisible.fade{transition:opacity .8s linear}.xterm .xterm-scrollable-element>.shadow{display:none;position:absolute}.xterm .xterm-scrollable-element>.shadow.top{width:100%;height:3px;box-shadow:var(--vscode-scrollbar-shadow,#000) 0 6px 6px -6px inset;display:block;top:0;left:3px}.xterm .xterm-scrollable-element>.shadow.left{width:3px;height:100%;box-shadow:var(--vscode-scrollbar-shadow,#000) 6px 0 6px -6px inset;display:block;top:3px;left:0}.xterm .xterm-scrollable-element>.shadow.top-left-corner{width:3px;height:3px;display:block;top:0;left:0}.xterm .xterm-scrollable-element>.shadow.top.left{box-shadow:var(--vscode-scrollbar-shadow,#000) 6px 0 6px -6px inset}