#!/usr/bin/env bats # Seam: service-scoped deployment planning. # A repository commit can contain changes for several workloads while only a # subset is safe to restart. The planner must keep inference isolated from # unrelated service changes and treat docs-only changes as a no-op. load helpers PLANNER="$REPO_ROOT/scripts/deploy-plan.py" REMOTE_DEPLOY="$REPO_ROOT/scripts/deploy-remote.sh" @test "deployment planner maps SearXNG changes to SearXNG only" { run python3 "$PLANNER" --target dankclaw --paths \ shared/searxng/settings.yml serverAppConfigs-docs/Dankclaw/SearXNG.md [ "$status" -eq 0 ] [ "$output" = "searxng" ] } @test "deployment planner maps large-model changes to the large model only" { run python3 "$PLANNER" --target dankclaw --paths \ scripts/frank-large.env [ "$status" -eq 0 ] [ "$output" = "frank-large" ] } @test "the retired NPU endpoint is absent from the deployment inventory" { ! grep -q '"frank-npu"' "$PLANNER" ! grep -q 'frank_npu\|frank-npu' "$REMOTE_DEPLOY" } @test "the retired ik chat template plans nothing, and its archive is still here" { # scripts/chat-template.jinja existed only for the ik_llama.cpp runtime # (retired 2026-09-16 in favour of halogen-flash-server again). The # llama.cpp frank-small runtime serves the template the GGUF itself # carries, which is the one with reasoning_effort, preserve_thinking and # the tool-call grammar. Editing the archive must deploy nothing -- and the # archive must still be present, so this cannot pass by the file having # vanished. [ -f "$REPO_ROOT/scripts/.AGENTTRASH/chat-template.jinja.ik-llama-qwen-sharp" ] run python3 "$PLANNER" --target dankclaw --paths scripts/chat-template.jinja [ "$status" -eq 0 ] [ -z "$output" ] run python3 "$PLANNER" --target dankserver --paths scripts/chat-template.jinja [ "$status" -eq 0 ] [ -z "$output" ] } @test "the retired frank-medium tree plans nothing, from any archive" { # frank-medium left the live tree on 2026-09-26 — first the radiance # Quadlet (and its vLLM replica archive before it), then the llama.cpp # layersplit trio and its fetch tooling. Every shape is archive material # now, and a planner rule matching any of them would restart a service # nobody maintains. run python3 "$PLANNER" --target dankserver --paths \ dankserver/.AGENTTRASH/20260916-vllm-radiance/frank-medium-a.container \ dankserver/.AGENTTRASH/20260926-frank-medium-radiance/frank-medium.container \ dankserver/.AGENTTRASH/20260926-frank-medium-radiance/radiance-entrypoint.sh \ scripts/.AGENTTRASH/20260920-llama-layersplit/frank-medium.env.llamacpp-layersplit \ scripts/.AGENTTRASH/20260926-frank-medium-radiance/download-frank-medium-gguf.sh \ scripts/.AGENTTRASH/20260926-frank-medium-radiance/swap-frank-medium.sh [ "$status" -eq 0 ] [ -z "$output" ] } @test "deployment planner maps the frank-primary container dir to frank-primary only" { run python3 "$PLANNER" --target dankserver --paths \ dankserver/frank-primary/quadlet/frank-primary.container \ dankserver/frank-primary/frank-primary-entrypoint.sh \ dankserver/frank-primary/frank-primary-healthcheck.py [ "$status" -eq 0 ] [ "$output" = "frank-primary" ] } @test "the small endpoint is Dankclaw's again, and Dankserver's copy stays retired" { run python3 "$PLANNER" --target dankclaw --paths \ scripts/frank-small.env scripts/frank-small.service scripts/serve-frank-small.sh [ "$status" -eq 0 ] [ "$output" = "frank-small" ] # frank-small runs on Dankclaw on the RTX 3090; the Dankserver endpoint of # that name was retired with the FreeToken runtime on 2026-09-15 and must # not come back through a planner mapping. run python3 "$PLANNER" --target dankserver --paths \ scripts/frank-small.env scripts/frank-small.service scripts/serve-frank-small.sh [ "$status" -eq 0 ] [ -z "$output" ] } @test "documentation-only changes plan no runtime deployment" { run python3 "$PLANNER" --target dankclaw --paths \ serverAppConfigs-docs/Architecture/Deployment\ Flow.md serverAppConfigs-docs/Dankclaw/SearXNG.md [ "$status" -eq 0 ] [ -z "$output" ] } @test "deployment planner maps shared config to one service" { run python3 "$PLANNER" --target dankclaw --paths \ shared/prometheus/prometheus.yml [ "$status" -eq 0 ] [ "$output" = "prometheus" ] } @test "deployment planner maps shared observability configs independently" { run python3 "$PLANNER" --target dankclaw --paths shared/loki/loki-config.yaml [ "$status" -eq 0 ] [ "$output" = "loki" ] run python3 "$PLANNER" --target dankclaw --paths shared/alloy/config.alloy [ "$status" -eq 0 ] [ "$output" = "alloy" ] } @test "deployment planner maps service-owned non-compose files" { run python3 "$PLANNER" --target dankclaw --paths dankclaw/hermes/config.yaml.example [ "$status" -eq 0 ] [ "$output" = "hermes" ] } @test "homepage is owned by Dankclaw's consolidated proxy" { run python3 "$PLANNER" --target dankserver --paths shared/homepage/index.html [ "$status" -eq 0 ] [ -z "$output" ] } @test "compose planner narrows a compose edit to the changed service" { local base head base=$(git -C "$REPO_ROOT" rev-parse HEAD) head=$(git -C "$REPO_ROOT" rev-parse HEAD) run python3 "$PLANNER" --target dankclaw --repo "$REPO_ROOT" \ --base "$base" --head "$head" --paths dankclaw/compose.yaml [ "$status" -eq 0 ] [ -z "$output" ] } @test "network-coupled SearXNG config changes include the required peers" { run python3 "$PLANNER" --target dankclaw --paths \ dankclaw/searxng/quadlet/gluetun.container [ "$status" -eq 0 ] [ "$output" = $'gluetun\nsearxng\nmarreta' ] } @test "retiring the standalone Gitea proxy deploys the canonical Caddy" { run python3 "$PLANNER" --target dankclaw --paths \ dankclaw/gitea/quadlet/gitea-caddy.container [ "$status" -eq 0 ] [ "$output" = "caddy" ] } @test "Gitea network changes exclude the retired standalone proxy" { run python3 "$PLANNER" --target dankclaw --paths \ dankclaw/gitea/quadlet/gitea.network [ "$status" -eq 0 ] [ "$output" = $'gitea-postgres\ngitea-server' ] } @test "frankbook-pro gluetun changes carry the whole netns family; arr changes stay scoped" { run python3 "$PLANNER" --target frankbook-pro --paths \ frankbook-pro/gluetun/quadlet/gluetun.container [ "$status" -eq 0 ] [ "$output" = $'gluetun\nprowlarr\nqbittorrent\nradarr\nsonarr\nlidarr\nreadarr' ] run python3 "$PLANNER" --target frankbook-pro --paths \ frankbook-pro/sonarr/quadlet/sonarr.container [ "$status" -eq 0 ] [ "$output" = "sonarr" ] } @test "remote Caddy deployment no longer blocks on the retired Gitea proxy" { ! grep -q 'refusing to replace it with caddy' "$REMOTE_DEPLOY" ! grep -q 'podman container exists gitea-caddy &&' "$REMOTE_DEPLOY" } @test "remote Caddy deployment retires the installed Gitea proxy" { grep -q 'retire_legacy_gitea_caddy' "$REMOTE_DEPLOY" grep -q 'systemctl --user stop gitea-caddy.service' "$REMOTE_DEPLOY" grep -q 'systemctl --user disable gitea-caddy.service' "$REMOTE_DEPLOY" grep -q 'gitea-caddy.container' "$REMOTE_DEPLOY" grep -q 'HOME/.AGENTTRASH' "$REMOTE_DEPLOY" grep -q 'stage_legacy_gitea_caddy_state' "$REMOTE_DEPLOY" } @test "remote deployment inventory no longer accepts gitea-caddy as a service" { ! grep -qE 'dankclaw:gitea-caddy|gitea-caddy\) deploy' "$REPO_ROOT/scripts/deploy.sh" "$REPO_ROOT/scripts/deploy-remote.sh" ! grep -q '"gitea-caddy"' "$REPO_ROOT/scripts/deploy-plan.py" } @test "remote deployer carries per-service deployment state" { [ -x "$REMOTE_DEPLOY" ] grep -q 'deploy-state' "$REMOTE_DEPLOY" grep -q 'STATE\[' "$REMOTE_DEPLOY" grep -q 'mark_status.*pending\|status=pending' "$REMOTE_DEPLOY" grep -q 'mark_status.*deployed\|status=deployed' "$REMOTE_DEPLOY" } @test "remote deployer routes inference restarts through selected handlers" { # The runner may restart inference only from the service-dispatch path. It # must not contain a host-wide restart loop. grep -q 'deploy_llm_large' "$REMOTE_DEPLOY" grep -q 'deploy_llm_primary' "$REMOTE_DEPLOY" grep -q 'deploy_service' "$REMOTE_DEPLOY" ! grep -qE 'for .*frank-(small|large|npu)-?' "$REMOTE_DEPLOY" } @test "remote runner rejects services belonging to the other host" { run env DEPLOY_STATE_DIR="$(mktemp -d)" REMOTE_DIR="$REPO_ROOT" \ bash "$REMOTE_DEPLOY" dankserver "$(git rev-parse HEAD)" frank-default-large [ "$status" -eq 2 ] } @test "remote runner recognizes a pending service at the same revision" { # Contract superseded 2026-09-17: recognition used to mean "retry and # hard-fail at the dispatcher" (exit 2), which let a retired service's # stale pending entry (frank-default-sightsound) block every deploy # before the e2e gate. Recognition now means: name the entry, prune it # to the trash, and keep the run going. local state_dir="$(mktemp -d)" printf 'revision=%s\nstatus=pending\n' "$(git rev-parse HEAD)" > "$state_dir/unknown-service" run env DEPLOY_STATE_DIR="$state_dir" REMOTE_DIR="$REPO_ROOT" HOME="$(mktemp -d)" \ bash "$REMOTE_DEPLOY" dankclaw "$(git rev-parse HEAD)" --pending [ "$status" -eq 0 ] [[ "$output" == *"unknown-service"* ]] [ ! -e "$state_dir/unknown-service" ] } @test "top-level deployer delegates to the service-scoped remote runner" { grep -q 'deploy-remote.sh' "$REPO_ROOT/scripts/deploy.sh" grep -qE 'SERVICE|service' "$REPO_ROOT/scripts/deploy.sh" grep -q 'OLD_REVISION' "$REPO_ROOT/scripts/deploy.sh" grep -q 'OLD_REVISION\|old checkout revision' "$REPO_ROOT/scripts/deploy.sh" } @test "legacy service deploy wrappers delegate to the scoped deployer" { for script in deploy-searxng-quadlet.sh deploy-pihole-quadlet.sh deploy-open-webui-quadlet.sh; do grep -q 'deploy.sh' "$REPO_ROOT/scripts/$script" || { echo "$script does not delegate to deploy.sh" return 1 } done }