refactor(cli): rename operator command to tht

scripts/unified-deployment-smoke.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # End-to-end release gate for the canonical two-service Compose distribution.
-# This file is also sourced by thothctl-update-smoke.sh so both entry points use the same
+# This file is also sourced by tht-update-smoke.sh so both entry points use the same
 # isolated fixture, exact cleanup, and sanitized failure reporting.
 set -euo pipefail
 
@@ -556,23 +556,23 @@ task13_seed_registry() {
   task13_commit_registry_change 'Seed Task 13 workspace registry'
 }
 
-task13_build_thothctl() {
+task13_build_tht() {
   local os arch
-  mkdir -p "$TASK13_THOTHCTL_DIR"
-  task13_run_logged "build thothctl cross-platform binaries" env \
-    THT_THOTHCTL_OUTPUT_DIRECTORY="$TASK13_THOTHCTL_DIR" \
-    bash "$TASK13_ROOT/scripts/build-thothctl.sh"
+  mkdir -p "$TASK13_THT_DIR"
+  task13_run_logged "build tht cross-platform binaries" env \
+    THT_THT_OUTPUT_DIRECTORY="$TASK13_THT_DIR" \
+    bash "$TASK13_ROOT/scripts/build-tht.sh"
   os="$(uname -s)"
   arch="$(uname -m)"
   case "$os/$arch" in
-    Darwin/x86_64) TASK13_THOTHCTL="$TASK13_THOTHCTL_DIR/thothctl-darwin-amd64" ;;
-    Darwin/arm64) TASK13_THOTHCTL="$TASK13_THOTHCTL_DIR/thothctl-darwin-arm64" ;;
-    Linux/x86_64|Linux/amd64) TASK13_THOTHCTL="$TASK13_THOTHCTL_DIR/thothctl-linux-amd64" ;;
-    Linux/aarch64|Linux/arm64) TASK13_THOTHCTL="$TASK13_THOTHCTL_DIR/thothctl-linux-arm64" ;;
+    Darwin/x86_64) TASK13_THT="$TASK13_THT_DIR/tht-darwin-amd64" ;;
+    Darwin/arm64) TASK13_THT="$TASK13_THT_DIR/tht-darwin-arm64" ;;
+    Linux/x86_64|Linux/amd64) TASK13_THT="$TASK13_THT_DIR/tht-linux-amd64" ;;
+    Linux/aarch64|Linux/arm64) TASK13_THT="$TASK13_THT_DIR/tht-linux-arm64" ;;
     *) task13_fail "unsupported smoke host: $os/$arch" ;;
   esac
-  chmod 0700 "$TASK13_THOTHCTL"
-  task13_run_logged "invoke host thothctl" "$TASK13_THOTHCTL" --help
+  chmod 0700 "$TASK13_THT"
+  task13_run_logged "invoke host tht" "$TASK13_THT" --help
 }
 
 task13_assert_rendered_contract() {
@@ -670,12 +670,12 @@ task13_assert_runtime() {
     || task13_fail "core lacks the explicit Task 13 resource label"
   task13_compose_logged "internal Pi provider smoke" exec -T core \
     curl --connect-timeout 3 --max-time 45 -fsS -X POST \
-    -H 'x-thoth-principal-issuer: thothctl' \
-    -H 'x-thoth-principal-subject: thothctl-maintenance' \
-    -H 'x-thoth-principal-display-name: Thothctl maintenance' \
+    -H 'x-thoth-principal-issuer: tht' \
+    -H 'x-thoth-principal-subject: tht-maintenance' \
+    -H 'x-thoth-principal-display-name: Tht maintenance' \
     -H 'x-thoth-is-admin: 1' \
     http://127.0.0.1:8787/pi-management/test
-  task13_run_logged "thothctl Pi doctor" "$TASK13_THOTHCTL" --installation "$TASK13_INSTALLATION" pi doctor
+  task13_run_logged "tht Pi doctor" "$TASK13_THT" --installation "$TASK13_INSTALLATION" pi doctor
 }
 
 task13_server_auth_headers() {
@@ -950,20 +950,20 @@ task13_update_rollback() {
   TASK13_PREVIOUS_IMAGE_ID="$before_image"
   before_mounts="$(task13_mount_fingerprint)"
   before_head="$(task13_active_registry_head)"
-  output="$TASK13_TMP/thothctl-update.out"
+  output="$TASK13_TMP/tht-update.out"
   set +e
-  "$TASK13_THOTHCTL" --installation "$TASK13_INSTALLATION" pi update \
+  "$TASK13_THT" --installation "$TASK13_INSTALLATION" pi update \
     --version "$TASK13_BAD_PI_VERSION" --source pull --image "$TASK13_BAD_CANDIDATE_IMAGE" --yes \
     >"$output" 2>&1
   rc=$?
   set -e
   [[ "$rc" -ne 0 ]] || task13_fail "bad Pi candidate unexpectedly passed update verification"
   if grep -Fq "$TASK13_SECRET_VALUE" "$output"; then
-    task13_fail "thothctl update output exposed the fixture secret"
+    task13_fail "tht update output exposed the fixture secret"
   fi
   grep -Fq 'previous core image was restored' "$output" \
-    || { task13_sanitize <"$output" >&2; task13_fail "thothctl did not report automatic rollback"; }
-  [[ -f "$TASK13_UPDATE_STATE" ]] || task13_fail "thothctl update state was not persisted"
+    || { task13_sanitize <"$output" >&2; task13_fail "tht did not report automatic rollback"; }
+  [[ -f "$TASK13_UPDATE_STATE" ]] || task13_fail "tht update state was not persisted"
   phase="$(sed -n 's/.*"phase": "\([^"]*\)".*/\1/p' "$TASK13_UPDATE_STATE" | head -n 1)"
   [[ "$phase" == rolled_back ]] || task13_fail "update state phase is not rolled_back"
   if grep -Fq "$TASK13_SECRET_VALUE" "$TASK13_UPDATE_STATE"; then
@@ -977,8 +977,8 @@ task13_update_rollback() {
   [[ "$after_mounts" == "$before_mounts" ]] || task13_fail "rollback changed persistence volume identity"
   [[ "$after_head" == "$before_head" ]] || task13_fail "rollback changed the active registry revision"
   task13_assert_sentinels
-  task13_run_logged "post-rollback thothctl doctor" \
-    "$TASK13_THOTHCTL" --installation "$TASK13_INSTALLATION" pi doctor
+  task13_run_logged "post-rollback tht doctor" \
+    "$TASK13_THT" --installation "$TASK13_INSTALLATION" pi doctor
   task13_compose exec -T core curl --connect-timeout 3 --max-time 10 -fsS \
     http://127.0.0.1:8787/workspaces \
     | grep -Fq 'Task 13 Smoke' || task13_fail "rollback lost the active workspace"
@@ -1020,7 +1020,7 @@ task13_remove_transaction_image() {
   if ! docker image inspect "$reference" >/dev/null 2>&1; then
     return 0
   fi
-  if [[ ! "$reference" =~ ^thothii-core:thothctl-[0-9a-f]{16}-(candidate|previous)$ \
+  if [[ ! "$reference" =~ ^thothii-core:tht-[0-9a-f]{16}-(candidate|previous)$ \
     || ! "$expected_id" =~ ^sha256:([0-9a-f]{64}|owned)$ ]]; then
     printf 'refusing to remove invalid transaction image reference %s\n' "$reference" >&2
     return 1
@@ -1108,9 +1108,9 @@ task13_cleanup() {
     transaction="$(sed -n 's/.*"transaction": "\([^"]*\)".*/\1/p' "$TASK13_UPDATE_STATE" | head -n 1)"
   fi
   if [[ -n "$transaction" ]]; then
-    task13_remove_transaction_image "thothii-core:thothctl-$transaction-candidate" \
+    task13_remove_transaction_image "thothii-core:tht-$transaction-candidate" \
       "${TASK13_BAD_CANDIDATE_ID:-}" >>"${TASK13_LOG:-/dev/null}" 2>&1 || cleanup_rc=1
-    task13_remove_transaction_image "thothii-core:thothctl-$transaction-previous" \
+    task13_remove_transaction_image "thothii-core:tht-$transaction-previous" \
       "${TASK13_PREVIOUS_IMAGE_ID:-}" >>"${TASK13_LOG:-/dev/null}" 2>&1 || cleanup_rc=1
   fi
   for image in \
@@ -1126,7 +1126,7 @@ task13_cleanup() {
     done < <(docker image ls -q --filter "label=io.thothii.task13.run=$TASK13_RUN_ID" | sort -u)
   fi
   if [[ -n "${TASK13_CONTROL_DIR:-}" ]]; then
-    if [[ "$TASK13_CONTROL_DIR" == "$TASK13_ROOT/.thothctl/$TASK13_PROJECT" \
+    if [[ "$TASK13_CONTROL_DIR" == "$TASK13_ROOT/.tht/$TASK13_PROJECT" \
       && "$TASK13_PROJECT" =~ ^thothii-[0-9a-f]{12}$ ]]; then
       rm -rf "$TASK13_CONTROL_DIR"
     else
@@ -1319,8 +1319,8 @@ task13_self_test_transaction_image_cleanup() {
   local calls foreign_error owned_ref foreign_ref
   calls="$(mktemp "${TMPDIR:-/tmp}/thothii-task13-transaction-cleanup-contract.XXXXXX")"
   foreign_error="$calls.foreign-error"
-  owned_ref="thothii-core:thothctl-0123456789abcdef-candidate"
-  foreign_ref="thothii-core:thothctl-fedcba9876543210-candidate"
+  owned_ref="thothii-core:tht-0123456789abcdef-candidate"
+  foreign_ref="thothii-core:tht-fedcba9876543210-candidate"
 
   if ! declare -F task13_remove_transaction_image >/dev/null; then
     rm -f "$calls" "$foreign_error"
@@ -1478,7 +1478,7 @@ task13_self_test_public_timeout_contract() {
     "$root/scripts/unified-deployment-smoke.sh" \
     || task13_fail "direct unified smoke invocation lacks an internal supervisor"
   grep -Eq 'task13_supervise[[:space:]].*task13_smoke_main[[:space:]]+update' \
-    "$root/scripts/thothctl-update-smoke.sh" \
+    "$root/scripts/tht-update-smoke.sh" \
     || task13_fail "direct update smoke invocation lacks an internal supervisor"
   grep -Eq 'task13_supervise[[:space:]].*task13_internal_semantic_smoke_main' \
     "$root/scripts/internal-semantic-smoke.sh" \
@@ -1562,7 +1562,7 @@ task13_self_test_source_contract() {
   registry_function='task13_start_''registry'
   if rg -n 'docker[[:space:]]+(system[[:space:]]+)?prune' \
     "$root/scripts/unified-deployment-smoke.sh" \
-    "$root/scripts/thothctl-update-smoke.sh" \
+    "$root/scripts/tht-update-smoke.sh" \
     "$root/scripts/internal-semantic-smoke.sh" >/dev/null; then
     task13_fail "Task 13 smoke scripts must never prune global Docker state"
   fi
@@ -1577,8 +1577,8 @@ task13_self_test_source_contract() {
     || task13_fail "the bad rollback candidate must be an immutable digest reference"
   grep -Eq 'timeout .*scripts/unified-deployment-smoke\.sh' "$workflow" \
     || task13_fail "CI lacks an outer timeout for the unified deployment smoke"
-  grep -Eq 'timeout .*scripts/thothctl-update-smoke\.sh' "$workflow" \
-    || task13_fail "CI lacks an outer timeout for the thothctl update smoke"
+  grep -Eq 'timeout .*scripts/tht-update-smoke\.sh' "$workflow" \
+    || task13_fail "CI lacks an outer timeout for the tht update smoke"
   uses_count="$(grep -Ec '^[[:space:]]+uses:' "$workflow")"
   pinned_uses_count="$(grep -Ec '^[[:space:]]+uses: [^[:space:]]+@[0-9a-f]{40}([[:space:]]|$)' "$workflow")"
   [[ "$uses_count" -gt 0 && "$uses_count" -eq "$pinned_uses_count" ]] \
@@ -1697,8 +1697,8 @@ task13_initialize() {
   TASK13_PROFILE="local"
   TASK13_INSTALLATION="$TASK13_TMP/thothii-installation.yaml"
   TASK13_PROJECT="thothii-$(task13_sha256_text "$TASK13_INSTALLATION" | cut -c1-12)"
-  TASK13_CONTROL_DIR="$TASK13_ROOT/.thothctl/$TASK13_PROJECT"
-  [[ ! -e "$TASK13_CONTROL_DIR" ]] || task13_fail "unique thothctl control directory already exists"
+  TASK13_CONTROL_DIR="$TASK13_ROOT/.tht/$TASK13_PROJECT"
+  [[ ! -e "$TASK13_CONTROL_DIR" ]] || task13_fail "unique tht control directory already exists"
   TASK13_CURRENT_IMAGE_OVERRIDE="$TASK13_CONTROL_DIR/current-image.yaml"
   TASK13_UPDATE_STATE="$TASK13_CONTROL_DIR/update-state.json"
   TASK13_REMOTE="$TASK13_TMP/remote.git"
@@ -1711,7 +1711,7 @@ task13_initialize() {
   TASK13_PI_MODELS="$TASK13_TMP/models.json"
   TASK13_PI_SETTINGS="$TASK13_TMP/pi-settings.json"
   TASK13_LLM_SERVER="$TASK13_TMP/fake-llm.mjs"
-  TASK13_THOTHCTL_DIR="$TASK13_TMP/thothctl"
+  TASK13_THT_DIR="$TASK13_TMP/tht"
   TASK13_LLM_CONTAINER="$TASK13_PROJECT-llm"
   TASK13_BAD_CANDIDATE_CONTAINER="$TASK13_PROJECT-bad-candidate"
   TASK13_CORE_IMAGE="task13-core-$TASK13_RUN_ID:local"
@@ -1748,7 +1748,7 @@ task13_smoke_main() {
   task13_write_fixture_files
   task13_write_environment /fixtures/remote.git
   task13_seed_registry
-  task13_build_thothctl
+  task13_build_tht
   task13_start_stack
   task13_assert_project_ownership
   task13_assert_built_image_ownership