gaia-framework 1.50.0 → 1.52.0

package/README.md

@@ -460,7 +460,7 @@ The single source of truth is `_gaia/_config/global.yaml`:
 
 ```yaml
 framework_name: "GAIA"
-framework_version: "1.50.0"
+framework_version: "1.52.0"
 user_name: "your-name"
 project_name: "your-project"
 ```

package/gaia-install.sh

@@ -6,7 +6,7 @@ set -euo pipefail
 # Installs, updates, validates, and reports on GAIA installations.
 # ─────────────────────────────────────────────────────────────────────────────
 
-readonly VERSION="1.50.0"
+readonly VERSION="1.52.0"
 readonly GITHUB_REPO="https://github.com/jlouage/Gaia-framework.git"
 readonly MANIFEST_REL="_gaia/_config/manifest.yaml"
 
@@ -182,6 +182,77 @@ copy_with_backup() {
   [[ "$OPT_VERBOSE" == true ]] && detail "Updated (backed up): $dst" || true
 }
 
+# Remove .resolved/*.yaml files from target _gaia/ directory.
+# Called after cp/tar copy to replicate rsync's --exclude behavior.
+# Only .resolved/*.yaml is relevant to the _gaia/ subtree; the other rsync
+# --exclude patterns target _memory/ paths outside _gaia/ and never match.
+clean_resolved_yaml() {
+  local target_gaia="$1"
+  find "$target_gaia" -path '*/.resolved/*.yaml' -delete 2>/dev/null || true
+}
+
+# Copy _gaia/ directory from source to target using a fallback chain:
+#   rsync → cp -rp → tar
+# Tries each tool in order. If a tool is found but fails at runtime (e.g.,
+# broken rsync stub on Windows), falls through to the next tool. Exits with
+# a diagnostic error if all tools fail or none are available.
+#
+# Excludes .resolved/*.yaml files from the final output (rsync handles this
+# natively via --exclude; cp and tar do a post-copy cleanup).
+#
+# Note: No symlinks currently exist in _gaia/. If symlinks are introduced
+# in the future, verify that cp -rp behavior matches rsync -a on all
+# target platforms (ADR-004).
+copy_gaia_files() {
+  local src="$1" dst="$2"
+  local copy_done=false
+
+  # Try rsync first (preferred — handles excludes natively)
+  if command -v rsync >/dev/null 2>&1; then
+    if rsync -a \
+      --exclude='_memory/checkpoints/*.yaml' \
+      --exclude='_memory/checkpoints/completed/*.yaml' \
+      --exclude='.resolved/*.yaml' \
+      --exclude='_memory/*-sidecar/*.md' \
+      --exclude='_memory/*-sidecar/*.yaml' \
+      "$src/_gaia/" "$dst/_gaia/" 2>/dev/null; then
+      detail "Copied framework files using rsync"
+      copy_done=true
+    else
+      detail "rsync found but failed — trying fallback methods"
+    fi
+  fi
+
+  # Fallback: cp -rp (preserves permissions like rsync -a)
+  if [[ "$copy_done" == false ]] && command -v cp >/dev/null 2>&1; then
+    if cp -rp "$src/_gaia/" "$dst/_gaia/" 2>/dev/null; then
+      clean_resolved_yaml "$dst/_gaia"
+      detail "Copied framework files using cp -rp (rsync unavailable)"
+      copy_done=true
+    else
+      error "cp failed to copy framework files — check permissions and disk space"
+      exit 1
+    fi
+  fi
+
+  # Fallback: tar (last resort — available on virtually all POSIX systems)
+  if [[ "$copy_done" == false ]] && command -v tar >/dev/null 2>&1; then
+    if (tar -cf - -C "$src" _gaia | tar -xf - -C "$dst") 2>/dev/null; then
+      clean_resolved_yaml "$dst/_gaia"
+      detail "Copied framework files using tar (rsync and cp unavailable)"
+      copy_done=true
+    else
+      error "tar failed to copy framework files — check permissions and disk space"
+      exit 1
+    fi
+  fi
+
+  if [[ "$copy_done" == false ]]; then
+    error "No suitable copy tool found (tried rsync, cp, tar). Cannot copy framework files."
+    exit 1
+  fi
+}
+
 append_if_missing() {
   local file="$1" marker="$2" content="$3"
   if [[ -f "$file" ]] && grep -qF "$marker" "$file"; then
@@ -261,18 +332,22 @@ cmd_init() {
   done
 
   # Step 2: Copy _gaia/ recursively (excluding checkpoints and .resolved/*.yaml)
+  # Uses rsync if available, falls back to cp -rp, then tar (ADR-004: Windows best-effort)
   step "Copying framework files..."
   if [[ "$OPT_DRY_RUN" == true ]]; then
-    detail "[dry-run] Would copy _gaia/ (excluding checkpoints and .resolved/*.yaml)"
+    if command -v rsync >/dev/null 2>&1; then
+      detail "[dry-run] Would copy _gaia/ using rsync (excluding checkpoints and .resolved/*.yaml)"
+    elif command -v cp >/dev/null 2>&1; then
+      detail "[dry-run] Would copy _gaia/ using cp -rp (rsync unavailable)"
+    elif command -v tar >/dev/null 2>&1; then
+      detail "[dry-run] Would copy _gaia/ using tar (rsync and cp unavailable)"
+    else
+      error "No suitable copy tool found (tried rsync, cp, tar)"
+      exit 1
+    fi
   else
     mkdir -p "$TARGET/_gaia"
-    rsync -a \
-      --exclude='_memory/checkpoints/*.yaml' \
-      --exclude='_memory/checkpoints/completed/*.yaml' \
-      --exclude='.resolved/*.yaml' \
-      --exclude='_memory/*-sidecar/*.md' \
-      --exclude='_memory/*-sidecar/*.yaml' \
-      "$source/_gaia/" "$TARGET/_gaia/"
+    copy_gaia_files "$source" "$TARGET"
   fi
 
   # Step 3: Create _memory/ directory tree at project root (ADR-013)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gaia-framework",
-  "version": "1.50.0",
+  "version": "1.52.0",
   "description": "GAIA — Generative Agile Intelligence Architecture installer",
   "bin": {
     "gaia-framework": "./bin/gaia-framework.js"