@sdd-method/sdd-cli 0.110.0 → 0.111.0

package/scripts/sync-method-baseline.sh

@@ -1,274 +0,0 @@
-#!/bin/bash
-#
-# sync-method-baseline.sh
-# Apply a built method baseline bundle to a target repository.
-#
-# Usage:
-#   ./orchestration/scripts/sync-method-baseline.sh --bundle dist/method-baseline/method-baseline-v0.1.0.tar.gz
-#   ./orchestration/scripts/sync-method-baseline.sh --bundle ... --target-repo /path/to/repo --dry-run
-
-set -euo pipefail
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-BLUE='\033[0;34m'
-NC='\033[0m'
-REPO_KIND_FILE=".sdd-repo-kind"
-PROTECTED_PREFIXES=("content/")
-
-log_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
-log_fail() { echo -e "${RED}[FAIL]${NC} $1"; }
-log_pass() { echo -e "${GREEN}[PASS]${NC} $1"; }
-log_section() {
-  echo -e "\n${BLUE}═══════════════════════════════════════════════════════════${NC}"
-  echo -e "${BLUE}  $1${NC}"
-  echo -e "${BLUE}═══════════════════════════════════════════════════════════${NC}\n"
-}
-
-usage() {
-  cat <<USAGE
-Usage: $(basename "$0") --bundle <path.tar.gz> [--target-repo <dir>] [--dry-run] [--allow-overwrite] [--no-delete]
-
-Options:
-  --bundle           Required bundle archive generated by build-method-baseline-bundle.sh
-  --target-repo      Target repository root (default: current working directory)
-  --dry-run          Report plan only; do not modify files
-  --allow-overwrite  Overwrite conflicting managed files (default: fail on conflict)
-  --no-delete        Do not delete previously managed files removed from the incoming bundle
-USAGE
-}
-
-BUNDLE=""
-TARGET_REPO="$(pwd)"
-DRY_RUN=0
-ALLOW_OVERWRITE=0
-NO_DELETE=0
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --bundle)
-      BUNDLE="${2:-}"
-      shift 2
-      ;;
-    --target-repo)
-      TARGET_REPO="${2:-}"
-      shift 2
-      ;;
-    --dry-run)
-      DRY_RUN=1
-      shift
-      ;;
-    --allow-overwrite)
-      ALLOW_OVERWRITE=1
-      shift
-      ;;
-    --no-delete)
-      NO_DELETE=1
-      shift
-      ;;
-    -h|--help)
-      usage
-      exit 0
-      ;;
-    *)
-      log_fail "Unknown argument: $1"
-      usage
-      exit 1
-      ;;
-  esac
-done
-
-if [[ -z "$BUNDLE" ]]; then
-  log_fail "--bundle is required"
-  usage
-  exit 1
-fi
-
-if [[ ! -f "$BUNDLE" ]]; then
-  log_fail "Bundle not found: $BUNDLE"
-  exit 1
-fi
-
-if [[ ! -d "$TARGET_REPO" ]]; then
-  log_fail "Target repo not found: $TARGET_REPO"
-  exit 1
-fi
-
-log_section "Sync Method Baseline"
-
-TMP_DIR="$(mktemp -d)"
-trap 'rm -rf "$TMP_DIR"' EXIT
-
-tar -xzf "$BUNDLE" -C "$TMP_DIR"
-BUNDLE_ROOT="$(find "$TMP_DIR" -mindepth 1 -maxdepth 1 -type d | head -n 1)"
-if [[ -z "$BUNDLE_ROOT" ]]; then
-  log_fail "Could not find extracted bundle root"
-  exit 1
-fi
-
-MANAGED_PATHS_FILE="$BUNDLE_ROOT/MANAGED_PATHS.txt"
-PAYLOAD_DIR="$BUNDLE_ROOT/payload"
-MANIFEST_FILE="$BUNDLE_ROOT/BUNDLE_MANIFEST.yaml"
-LOCK_FILE="$TARGET_REPO/method-baseline.lock"
-
-if [[ ! -f "$MANAGED_PATHS_FILE" || ! -d "$PAYLOAD_DIR" || ! -f "$MANIFEST_FILE" ]]; then
-  log_fail "Bundle missing required files (MANAGED_PATHS.txt, payload/, or BUNDLE_MANIFEST.yaml)"
-  exit 1
-fi
-
-BUNDLE_VERSION="$(awk -F': ' '/^bundle_version:/{gsub(/"/,"",$2); print $2}' "$MANIFEST_FILE")"
-SOURCE_COMMIT="$(awk -F': ' '/^source_commit:/{gsub(/"/,"",$2); print $2}' "$MANIFEST_FILE")"
-BUNDLE_NAME="$(awk -F': ' '/^bundle_name:/{gsub(/"/,"",$2); print $2}' "$MANIFEST_FILE")"
-
-case "$BUNDLE_NAME" in
-  platform-baseline)
-    REPO_KIND_VALUE="platform-product"
-    ;;
-  app-baseline)
-    REPO_KIND_VALUE="application-product"
-    ;;
-  integration-baseline)
-    REPO_KIND_VALUE="integration-product"
-    ;;
-  *)
-    log_fail "Unknown bundle_name in manifest: $BUNDLE_NAME"
-    exit 1
-    ;;
-esac
-
-mapfile -t INCOMING_PATHS < "$MANAGED_PATHS_FILE"
-
-for p in "${INCOMING_PATHS[@]}"; do
-  if [[ ! -f "$PAYLOAD_DIR/$p" ]]; then
-    log_fail "Missing payload file listed in MANAGED_PATHS.txt: $p"
-    exit 1
-  fi
-  for prefix in "${PROTECTED_PREFIXES[@]}"; do
-    if [[ "$p" == "$prefix"* ]]; then
-      log_fail "Incoming bundle attempts to manage protected product-owned path: $p"
-      log_fail "Method baseline bundles must not manage files under: ${PROTECTED_PREFIXES[*]}"
-      exit 1
-    fi
-  done
-done
-
-# Detect conflicts unless caller explicitly allows overwrite.
-CONFLICTS=()
-for p in "${INCOMING_PATHS[@]}"; do
-  target_file="$TARGET_REPO/$p"
-  incoming_file="$PAYLOAD_DIR/$p"
-  if [[ -f "$target_file" ]] && ! cmp -s "$incoming_file" "$target_file"; then
-    CONFLICTS+=("$p")
-  fi
-done
-
-if [[ ${#CONFLICTS[@]} -gt 0 && "$ALLOW_OVERWRITE" -ne 1 ]]; then
-  log_fail "Found ${#CONFLICTS[@]} conflicting managed file(s). Re-run with --allow-overwrite to apply."
-  printf '%s\n' "${CONFLICTS[@]}" | sed 's/^/  - /'
-  exit 1
-fi
-
-# Load previously managed paths from lock file (if present).
-# Supports v2 format (lock_version: 2) with bundles array.
-PREV_PATHS=()
-if [[ -f "$LOCK_FILE" ]]; then
-  while IFS= read -r p; do
-    PREV_PATHS+=("$p")
-  done < <(awk '
-    /managed_paths:/ {in_list=1; next}
-    in_list && /^      - / {sub(/^      - /, ""); print; next}
-    in_list && /^  - / {sub(/^  - /, ""); print; next}
-    in_list && !/^  / {in_list=0}
-  ' "$LOCK_FILE")
-fi
-
-for p in "${PREV_PATHS[@]}"; do
-  for prefix in "${PROTECTED_PREFIXES[@]}"; do
-    if [[ "$p" == "$prefix"* ]]; then
-      log_fail "Existing lock file contains protected product-owned path: $p"
-      log_fail "Resolve this manually before refreshing the method baseline."
-      exit 1
-    fi
-  done
-done
-
-# Compute removal set: paths previously managed but not in incoming list.
-REMOVE_PATHS=()
-if [[ "$NO_DELETE" -ne 1 && ${#PREV_PATHS[@]} -gt 0 ]]; then
-  for prev in "${PREV_PATHS[@]}"; do
-    keep=0
-    for cur in "${INCOMING_PATHS[@]}"; do
-      if [[ "$prev" == "$cur" ]]; then
-        keep=1
-        break
-      fi
-    done
-    if [[ "$keep" -eq 0 ]]; then
-      REMOVE_PATHS+=("$prev")
-    fi
-  done
-fi
-
-log_info "Bundle: $BUNDLE_NAME (version: $BUNDLE_VERSION)"
-log_info "Incoming managed files: ${#INCOMING_PATHS[@]}"
-log_info "Conflicts: ${#CONFLICTS[@]}"
-log_info "Removals from previous sync of this bundle: ${#REMOVE_PATHS[@]}"
-log_info "Protected ownership prefixes: ${PROTECTED_PREFIXES[*]}"
-
-if [[ "$DRY_RUN" -eq 1 ]]; then
-  log_info "Dry run enabled. No files modified."
-  if [[ ${#CONFLICTS[@]} -gt 0 ]]; then
-    log_info "Conflicting files:"
-    printf '%s\n' "${CONFLICTS[@]}" | sed 's/^/  - /'
-  fi
-  if [[ ${#REMOVE_PATHS[@]} -gt 0 ]]; then
-    log_info "Files that would be removed:"
-    printf '%s\n' "${REMOVE_PATHS[@]}" | sed 's/^/  - /'
-  fi
-  exit 0
-fi
-
-# Apply incoming managed files.
-for p in "${INCOMING_PATHS[@]}"; do
-  mkdir -p "$TARGET_REPO/$(dirname "$p")"
-  cp "$PAYLOAD_DIR/$p" "$TARGET_REPO/$p"
-done
-
-# Remove files no longer managed by this baseline.
-for p in "${REMOVE_PATHS[@]}"; do
-  rm -f "$TARGET_REPO/$p"
-done
-
-printf '%s\n' "$REPO_KIND_VALUE" > "$TARGET_REPO/$REPO_KIND_FILE"
-
-SYNCED_AT_UTC="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
-BUNDLE_SHA="$(sha256sum "$BUNDLE" | awk '{print $1}')"
-
-{
-  echo "method_repo: sdd-method"
-  echo "lock_version: 3"
-  echo "bundles:"
-  echo "  - name: $BUNDLE_NAME"
-  echo "    bundle_version: \"$BUNDLE_VERSION\""
-  echo "    source_commit: \"$SOURCE_COMMIT\""
-  echo "    bundle_sha256: \"$BUNDLE_SHA\""
-  echo "    synced_at_utc: \"$SYNCED_AT_UTC\""
-  echo "    is_forward_base: true"
-  echo "    managed_paths:"
-  # lock_version 3: `- <sha256>  <path>`. The digest comes from the PAYLOAD —
-  # what this sync applied — matching sdd-cli exactly, because the parity test
-  # asserts byte equality. Updated in lockstep deliberately: a bash path still
-  # writing version 2 would DOWNGRADE a v3 lock on its next run and destroy the
-  # digests that make pristine-vs-edited decidable.
-  for p in "${INCOMING_PATHS[@]}"; do
-    if [[ -f "$PAYLOAD_DIR/$p" ]]; then
-      echo "      - $(sha256sum "$PAYLOAD_DIR/$p" | awk '{print $1}')  $p"
-    else
-      echo "      - $p"
-    fi
-  done
-} > "$LOCK_FILE"
-
-log_pass "Method baseline synced to: $TARGET_REPO"
-log_info "Updated lock file: method-baseline.lock (lock_version: 3)"
-log_info "Set repo kind marker: $REPO_KIND_FILE = $REPO_KIND_VALUE"