kcreate-scaffolding-gcp-script 0.0.0-stage → 0.2.1

package/skill/scripts/01_init_config.sh

@@ -0,0 +1,151 @@
+#!/usr/bin/env bash
+# Etapa: Pre requisitos — paso 1.
+# Crea (o localiza, si ya existe de una corrida anterior) el archivo de
+# configuración de esta ejecución, autodetectando lo que se pueda desde
+# SOURCE_ENV.
+#
+# Uso: 01_init_config.sh <SOURCE_ENV> <NEW_ENV>
+#
+# Salidas (código de salida, no solo texto — para que el agente no tenga
+# que interpretar el mensaje):
+#   0  CONFIG_READY     — no quedan campos __PENDIENTE__, se puede continuar.
+#   2  CONFIG_PENDING   — faltan campos por llenar; se listan por nombre.
+#   1  error de uso/validación (SOURCE_ENV no existe, NEW_ENV ya existe, etc.)
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/common.sh
+source "$SCRIPT_DIR/lib/common.sh"
+
+SOURCE_ENV="${1:-}"
+NEW_ENV="${2:-}"
+[[ -n "$SOURCE_ENV" && -n "$NEW_ENV" ]] || ksc_die "uso: 01_init_config.sh <SOURCE_ENV> <NEW_ENV>"
+
+REPO_ROOT="$(ksc_repo_root)"
+SOURCE_DIR="$REPO_ROOT/live/$SOURCE_ENV"
+NEW_DIR="$REPO_ROOT/live/$NEW_ENV"
+
+[[ -f "$SOURCE_DIR/project/terragrunt.hcl" ]] || ksc_die \
+  "SOURCE_ENV '$SOURCE_ENV' no existe (no se encontró $SOURCE_DIR/project/terragrunt.hcl)"
+[[ "$NEW_ENV" =~ ^[a-z0-9]+-(qa|prod)$ ]] || ksc_die \
+  "NEW_ENV '$NEW_ENV' no cumple el patrón <app>-<entorno>, minúsculas, entorno = qa|prod"
+
+CONFIG_FILE="$(ksc_config_path "$REPO_ROOT" "$NEW_ENV")"
+mkdir -p "$(dirname "$CONFIG_FILE")"
+
+# Si live/<NEW_ENV>/ ya existe PERO el config de esta ejecución todavía
+# no, puede ser (a) una colisión real (otra cosa ocupa ese nombre) o (b)
+# un rescate legítimo cuyo config se perdió — ej. alguien corrió
+# `uninstall.sh --clean-gitignore`, que borra `.kcreate-scaffolding/`
+# completa, con un build a medias todavía en `live/` (Review V3, P-2:
+# antes esto SIEMPRE moría como colisión, incluso cuando era claramente
+# un rescate, y no había forma automática de recuperarlo). Se distinguen
+# por una firma mínima: si `project.hcl` existe y su `project_id` es
+# exactamente `NEW_ENV`, es la huella que este mismo skill deja siempre
+# (ver build_project_hcl) — se trata como rescate (regenerar el config
+# desde cero) en vez de colisión. Cualquier otra cosa sí se trata como
+# colisión real y se detiene.
+if [[ -d "$NEW_DIR" && ! -f "$CONFIG_FILE" ]]; then
+  RESCUE_PROJECT_ID=""
+  [[ -f "$NEW_DIR/project.hcl" ]] && RESCUE_PROJECT_ID="$(ksc_hcl_get "$NEW_DIR/project.hcl" project_id)"
+  if [[ "$RESCUE_PROJECT_ID" == "$NEW_ENV" ]]; then
+    ksc_info "$NEW_DIR ya existe sin config (se perdió, ej. por un uninstall --clean-gitignore) pero tiene la firma de haber sido generado por este skill (project.hcl con project_id=\"$NEW_ENV\") — se trata como rescate: regenerando el config desde cero."
+  else
+    ksc_die "NEW_ENV '$NEW_ENV' ya existe en $NEW_DIR pero no hay un config de este skill para esa ejecución ($CONFIG_FILE no existe), y $NEW_DIR/project.hcl no tiene la firma de haber sido generado por este skill — parece una colisión real con otra cosa, no se sobreescribe. Si es intencional, bórralo tú mismo primero (este skill nunca borra)."
+  fi
+fi
+if [[ -d "$NEW_DIR" && -f "$CONFIG_FILE" ]]; then
+  ksc_info "$NEW_DIR ya existe (reintento de una corrida anterior) — no es un error, continuando con el config existente."
+fi
+
+GITIGNORE="$REPO_ROOT/.gitignore"
+if ! grep -qxF '.kcreate-scaffolding/' "$GITIGNORE" 2>/dev/null; then
+  printf '\n# kcreate-scaffolding-gcp-script: configuracion de ejecucion, no comitear\n.kcreate-scaffolding/\n' >> "$GITIGNORE"
+  ksc_info "agregado .kcreate-scaffolding/ a $GITIGNORE"
+fi
+
+if [[ -f "$CONFIG_FILE" ]]; then
+  ksc_info "ya existe un archivo de configuración de una corrida anterior: $CONFIG_FILE"
+  ksc_info "no se vuelve a generar (reanudación) — usa 02_print_config.sh para revisarlo."
+else
+  ksc_info "generando $CONFIG_FILE desde la plantilla y autodetectando valores de $SOURCE_ENV ..."
+
+  sed -e "s/__SOURCE_ENV__/$SOURCE_ENV/" -e "s/__NEW_ENV__/$NEW_ENV/" \
+    "$SCRIPT_DIR/../templates/scaffolding.config.template" > "$CONFIG_FILE"
+
+  PROJECT_NAME_GUESS="$(ksc_infer_project_name "$NEW_ENV")"
+  sed -i "s/^PROJECT_NAME=\"__PENDIENTE__\"/PROJECT_NAME=\"$PROJECT_NAME_GUESS\"/" "$CONFIG_FILE"
+
+  ORG_ID="$(ksc_hcl_get "$SOURCE_DIR/project/terragrunt.hcl" org_id)"
+  ORG_BILLING_ACCOUNT="$(ksc_hcl_get "$SOURCE_DIR/project/terragrunt.hcl" org_billing_account)"
+  REGION="$(ksc_hcl_get "$SOURCE_DIR/project.hcl" region)"
+  ZONE="$(ksc_hcl_get "$SOURCE_DIR/project.hcl" zone)"
+  LABEL_OWNER="$(ksc_hcl_get "$SOURCE_DIR/project/terragrunt.hcl" owner)"
+  GITHUB_ORG="$(ksc_hcl_get "$SOURCE_DIR/github_workload_identity/terragrunt.hcl" github_organization)"
+  GKE_VERSION="$(ksc_hcl_get "$SOURCE_DIR/gke_private/terragrunt.hcl" gke_version)"
+  DB_VERSION="$(ksc_hcl_get "$SOURCE_DIR/sql_postgres/terragrunt.hcl" database_version)"
+
+  # authorized_networks fijos (todo lo que NO empiece con "dev-"): se extraen
+  # de entradas en una sola línea como
+  # `{ name = "cloudadmin", address = "1.2.3.4/32" },` (formato real de
+  # todos los entornos existentes). Portable (grep+sed), sin depender de
+  # extensiones de gawk.
+  FIXED_NETWORKS=""
+  if [[ -f "$SOURCE_DIR/sql_postgres/terragrunt.hcl" ]]; then
+    while IFS= read -r line; do
+      name="$(printf '%s' "$line" | grep -oE 'name[[:space:]]*=[[:space:]]*"[^"]*"' | sed -E 's/.*"([^"]*)"/\1/')"
+      addr="$(printf '%s' "$line" | grep -oE 'address[[:space:]]*=[[:space:]]*"[^"]*"' | sed -E 's/.*"([^"]*)"/\1/')"
+      [[ -n "$name" && -n "$addr" ]] || continue
+      [[ "$name" == dev-* ]] && continue
+      FIXED_NETWORKS="${FIXED_NETWORKS}${FIXED_NETWORKS:+;}${name}=${addr}"
+    done < <(grep -E '\{[[:space:]]*name[[:space:]]*=' "$SOURCE_DIR/sql_postgres/terragrunt.hcl")
+  fi
+
+  # SI hay una mayoría CLARA (>mitad de los entornos reales) para una IP
+  # fija y SOURCE_ENV tiene un valor distinto para ese mismo nombre,
+  # preferir el valor mayoritario en vez de propagar lo que probablemente
+  # sea un typo (Review V2, N-6: antes el doctor avisaba del typo de
+  # xoloshop-qa pero el config igual terminaba con el valor roto).
+  BEST_NET=""; BEST_N=0; TOTAL_REAL_ENVS=0
+  read -r BEST_NET BEST_N TOTAL_REAL_ENVS < <(ksc_majority_fixed_network "$REPO_ROOT")
+  if [[ -n "$BEST_NET" && "$BEST_N" -gt $((TOTAL_REAL_ENVS / 2)) ]]; then
+    BEST_NAME="${BEST_NET%%=*}"
+    SOURCE_VALUE_FOR_NAME="$(tr ';' '\n' <<<"$FIXED_NETWORKS" | grep "^${BEST_NAME}=" || true)"
+    if [[ -n "$SOURCE_VALUE_FOR_NAME" && "$SOURCE_VALUE_FOR_NAME" != "$BEST_NET" ]]; then
+      FIXED_NETWORKS="$(tr ';' '\n' <<<"$FIXED_NETWORKS" | { grep -v "^${BEST_NAME}=" || true; } | paste -sd ';' -)"
+      FIXED_NETWORKS="${FIXED_NETWORKS}${FIXED_NETWORKS:+;}${BEST_NET}"
+      ksc_warn "$SOURCE_ENV tiene '$SOURCE_VALUE_FOR_NAME' pero $BEST_N/$TOTAL_REAL_ENVS entornos reales usan '$BEST_NET' — se adoptó el valor mayoritario en FIXED_ADMIN_NETWORKS en vez del de $SOURCE_ENV (probable typo, ver lessons-learned.md A4). Corrígelo a mano en el config si el valor de $SOURCE_ENV era el correcto a propósito."
+    fi
+  fi
+
+  for pair in "ORG_ID:$ORG_ID" "ORG_BILLING_ACCOUNT:$ORG_BILLING_ACCOUNT" \
+              "REGION:$REGION" "ZONE:$ZONE" "LABEL_OWNER:$LABEL_OWNER" \
+              "GITHUB_ORGANIZATION:$GITHUB_ORG" \
+              "GKE_VERSION_NEEDS_VERIFICATION:$GKE_VERSION" \
+              "DATABASE_VERSION_NEEDS_VERIFICATION:$DB_VERSION" \
+              "FIXED_ADMIN_NETWORKS:$FIXED_NETWORKS"; do
+    key="${pair%%:*}"; val="${pair#*:}"
+    if [[ -n "$val" ]]; then
+      val_escaped="$(printf '%s' "$val" | sed -e 's/[\/&]/\\&/g')"
+      sed -i "s/^${key}=\"__PENDIENTE__\"/${key}=\"${val_escaped}\"/" "$CONFIG_FILE"
+    else
+      ksc_warn "no se pudo autodetectar $key desde $SOURCE_ENV — queda __PENDIENTE__"
+    fi
+  done
+
+  ksc_ok "config generado en $CONFIG_FILE"
+fi
+
+PENDING=$(ksc_config_pending_fields "$CONFIG_FILE" || true)
+if [[ -n "$PENDING" ]]; then
+  echo
+  ksc_warn "CONFIG_PENDING — faltan estos campos en $CONFIG_FILE:"
+  echo "$PENDING" | sed 's/^/  - /'
+  echo
+  echo "Llénalos y vuelve a correr este mismo script para confirmar que ya quedó completo."
+  exit 2
+fi
+
+ksc_ok "CONFIG_READY — $CONFIG_FILE no tiene campos pendientes."
+echo "$CONFIG_FILE"

package/skill/scripts/02_print_config.sh

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+# Etapa: Pre requisitos — paso 2.
+# Solo imprime el contenido completo del archivo de configuración para que
+# el agente lo muestre al humano y pida confirmación explícita antes de
+# construir nada. Este script NUNCA decide por sí mismo si los datos son
+# correctos — esa es una pregunta que el agente debe hacerle al humano
+# textualmente, y detenerse si la respuesta es "no".
+#
+# Uso: 02_print_config.sh <NEW_ENV>
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/common.sh
+source "$SCRIPT_DIR/lib/common.sh"
+
+NEW_ENV="${1:-}"
+[[ -n "$NEW_ENV" ]] || ksc_die "uso: 02_print_config.sh <NEW_ENV>"
+
+REPO_ROOT="$(ksc_repo_root)"
+CONFIG_FILE="$(ksc_config_path "$REPO_ROOT" "$NEW_ENV")"
+[[ -f "$CONFIG_FILE" ]] || ksc_die \
+  "no existe $CONFIG_FILE — corre primero 01_init_config.sh <SOURCE_ENV> $NEW_ENV"
+
+PENDING=$(ksc_config_pending_fields "$CONFIG_FILE" || true)
+if [[ -n "$PENDING" ]]; then
+  ksc_die "este archivo todavía tiene campos __PENDIENTE__ — no se puede confirmar así. Corre 01_init_config.sh de nuevo después de llenarlos."
+fi
+
+# shellcheck disable=SC1090
+source "$CONFIG_FILE"
+
+# Persistir también los WARN del doctor (no solo los de la Construcción):
+# si la sesión muere entre este paso y 10_build_components.sh, no se
+# pierden (Review V2, N-5). Se trunca aquí porque cada corrida de 02
+# vuelve a mostrar el estado completo desde cero; 10_build_components.sh
+# hace APPEND sobre este mismo archivo, nunca lo trunca, para no perder
+# lo que el doctor ya escribió.
+export KSC_WARNINGS_FILE="$(ksc_warnings_file_path "$REPO_ROOT" "$NEW_ENV")"
+: > "$KSC_WARNINGS_FILE"
+
+# "Doctor" de SOURCE_ENV (ver lib/common.sh:ksc_check_source_health):
+# avisa ANTES de que el humano confirme si SOURCE_ENV le falta algo que
+# el entorno más reciente/mayoritario de live/ ya tiene (API de
+# project_services, entradas de org_policies, IP fija de cloudadmin).
+ksc_check_source_health "$REPO_ROOT" "$SOURCE_ENV"
+echo
+
+echo "=================================================================="
+echo " Configuración completa para NEW_ENV=$NEW_ENV"
+echo " Archivo: $CONFIG_FILE"
+echo "=================================================================="
+cat "$CONFIG_FILE"
+echo "=================================================================="
+echo
+echo "AGENTE: muestra este contenido completo al humano tal cual y"
+echo "pregúntale explícitamente si los datos son correctos. Si dice que"
+echo "NO, DETENTE por completo — no corrijas nada por tu cuenta, no sigas"
+echo "a la etapa de Construcción. Si dice que SÍ, continúa con"
+echo "10_build_components.sh."