computer-playbook/scripts/container/purge/apps.sh

#!/usr/bin/env bash
# App-keyed purge orchestrator. Maps each app id in $apps to its
# compose entity, then for each entity runs the entity-keyed primitives
# (db, compose, dir) and finally wipes the matching token-store entries
# via utils.data.tokens. Tokens live outside /opt/compose and would
# otherwise survive entity purges, breaking matrix-deploy variant
# transitions (stale token slips past the empty-token guard in
# sys-front-inj-matomo and the next round 502s on the public matomo URL).
#
# Expects:
#   apps  (required) e.g. "web-app-nextcloud" or "web-app-keycloak,web-app-matomo"
#
# Designed to be invoked from the host via:
#   docker exec -e apps="${apps}" <container> \
#     bash ${INFINITO_SRC_DIR}/scripts/container/purge/apps.sh  # nocheck: self-path-reference

set -euo pipefail
: "${INFINITO_SRC_DIR:?INFINITO_SRC_DIR must be set by the container environment}"
cd "${INFINITO_SRC_DIR}"

: "${apps:?apps is not set (e.g. apps=web-app-nextcloud)}"

SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
ENTITY_DIR="${SCRIPT_DIR}/entity"

apps_raw="${apps//,/ }"
read -r -a apps <<<"${apps_raw}"

if [[ "${#apps[@]}" -lt 1 ]]; then
	echo "!!! WARNING: apps is empty after parsing: skipping purge"
	exit 0
fi

if [[ -f "scripts/meta/env/load.sh" ]]; then
	# shellcheck source=scripts/meta/env/load.sh
	source "scripts/meta/env/load.sh"
fi
python_bin="${PYTHON:-python3}"

declare -A seen_entities=()
entities=()

for app in "${apps[@]}"; do
	[[ -n "${app}" ]] || continue

	entity="$("${python_bin}" -c 'from utils.roles.entity.name import get_entity_name; import sys; print(get_entity_name(sys.argv[1]) or "")' "${app}")"

	if [[ -z "${entity}" ]]; then
		echo "!!! WARNING: could not derive entity from apps=${app}: skipping"
		continue
	fi

	if [[ -z "${seen_entities[${entity}]:-}" ]]; then
		seen_entities[${entity}]=1
		entities+=("${entity}")
		echo ">>> Derived entity from apps=${app}: ${entity}"
	fi
done

echo ">>> Wiping token-store entries for: ${apps[*]}"
"${python_bin}" -m utils.cleanup.tokens "${apps[@]}" || true # nocheck: shell-or-true -- grandfathered: worked in practice; TODO: sharpen to catch only the exact tolerated error

echo ">>> Wiping databases.csv entries for: ${apps[*]}"
"${python_bin}" -m utils.cleanup.databases_csv "${apps[@]}" || true # nocheck: shell-or-true -- grandfathered: worked in practice; TODO: sharpen to catch only the exact tolerated error

if [[ "${#entities[@]}" -lt 1 ]]; then
	echo "!!! WARNING: no valid entities found: skipping entity purge"
	exit 0
fi

for entity in "${entities[@]}"; do
	echo
	echo ">>> Purging entity: ${entity}"
	bash "${ENTITY_DIR}/nginx.sh" "${entity}" || true # nocheck: shell-or-true -- grandfathered: worked in practice; TODO: sharpen to catch only the exact tolerated error
	if [[ -d "/opt/compose/${entity}" ]]; then
		bash "${ENTITY_DIR}/db.sh" "${entity}" || true      # nocheck: shell-or-true -- grandfathered: worked in practice; TODO: sharpen to catch only the exact tolerated error
		bash "${ENTITY_DIR}/compose.sh" "${entity}" || true # nocheck: shell-or-true -- grandfathered: worked in practice; TODO: sharpen to catch only the exact tolerated error
		bash "${ENTITY_DIR}/dir.sh" "${entity}" || true     # nocheck: shell-or-true -- grandfathered: worked in practice; TODO: sharpen to catch only the exact tolerated error
		bash "${ENTITY_DIR}/network.sh" "${entity}" || true # nocheck: shell-or-true -- grandfathered: worked in practice; TODO: sharpen to catch only the exact tolerated error
	else
		echo ">>> /opt/compose/${entity} not present — skipping compose/db/dir/network purges"
	fi
done

if docker info >/dev/null 2>&1; then
	docker network prune -f
else
	echo ">>> docker daemon not reachable — skipping 'docker network prune'"
fi