gaia-framework 1.52.0 → 1.53.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.52.0"
+framework_version: "1.53.0"
 user_name: "your-name"
 project_name: "your-project"
 ```

package/bin/gaia-framework.js

@@ -5,10 +5,10 @@
 // Clones the GAIA repo, delegates to gaia-install.sh, and cleans up.
 // ─────────────────────────────────────────────────────────────────────────────
 
-const { execSync, execFileSync } = require("child_process");
-const { mkdtempSync, rmSync, existsSync } = require("fs");
-const { join } = require("path");
-const { tmpdir } = require("os");
+const childProcess = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
 
 const REPO_URL = "https://github.com/jlouage/Gaia-framework.git";
 const SCRIPT_NAME = "gaia-install.sh";
@@ -23,19 +23,19 @@ function findBash() {
 
   // Try bash in PATH first (WSL, Git Bash in PATH, etc.)
   try {
-    execSync("bash --version", { stdio: "ignore" });
+    childProcess.execSync("bash --version", { stdio: "ignore" });
     return "bash";
   } catch {}
 
   // Try Git for Windows default locations
   const gitBashPaths = [
-    join(process.env.ProgramFiles || "C:\\Program Files", "Git", "bin", "bash.exe"),
-    join(process.env["ProgramFiles(x86)"] || "C:\\Program Files (x86)", "Git", "bin", "bash.exe"),
-    join(process.env.LOCALAPPDATA || "", "Programs", "Git", "bin", "bash.exe"),
+    path.join(process.env.ProgramFiles || "C:\\Program Files", "Git", "bin", "bash.exe"),
+    path.join(process.env["ProgramFiles(x86)"] || "C:\\Program Files (x86)", "Git", "bin", "bash.exe"),
+    path.join(process.env.LOCALAPPDATA || "", "Programs", "Git", "bin", "bash.exe"),
   ];
 
   for (const p of gitBashPaths) {
-    if (existsSync(p)) return p;
+    if (fs.existsSync(p)) return p;
   }
 
   return null;
@@ -51,9 +51,9 @@ function info(message) {
 }
 
 function cleanup() {
-  if (tempDir && existsSync(tempDir)) {
+  if (tempDir && fs.existsSync(tempDir)) {
     try {
-      rmSync(tempDir, { recursive: true, force: true });
+      fs.rmSync(tempDir, { recursive: true, force: true });
     } catch {
       // Best-effort cleanup
     }
@@ -62,7 +62,7 @@ function cleanup() {
 
 function ensureGit() {
   try {
-    execSync("git --version", { stdio: "ignore" });
+    childProcess.execSync("git --version", { stdio: "ignore" });
   } catch {
     fail(
       "git is required but was not found.\n" +
@@ -72,8 +72,7 @@ function ensureGit() {
 }
 
 function readPackageVersion(pkgPath) {
-  const { readFileSync } = require("fs");
-  const raw = readFileSync(pkgPath, "utf8");
+  const raw = fs.readFileSync(pkgPath, "utf8");
   const pkg = JSON.parse(raw);
   if (!pkg.version) {
     throw new Error(`No version field found in ${pkgPath}`);
@@ -111,7 +110,15 @@ Examples:
 
 // ─── Main ───────────────────────────────────────────────────────────────────
 
-function main() {
+function main(deps) {
+  // Dependency injection for testability — defaults to real modules
+  const _exec = deps && deps.execSync || childProcess.execSync;
+  const _execFile = deps && deps.execFileSync || childProcess.execFileSync;
+  const _mkdtemp = deps && deps.mkdtempSync || fs.mkdtempSync;
+  const _exists = deps && deps.existsSync || fs.existsSync;
+  const _join = deps && deps.join || path.join;
+  const _tmpdir = deps && deps.tmpdir || os.tmpdir;
+
   const args = process.argv.slice(2);
 
   // Handle help / no args
@@ -137,7 +144,7 @@ function main() {
   ensureGit();
 
   // Clone the repo to a temp directory
-  tempDir = mkdtempSync(join(tmpdir(), "gaia-framework-"));
+  tempDir = _mkdtemp(_join(_tmpdir(), "gaia-framework-"));
 
   // Register cleanup for all exit scenarios
   process.on("exit", cleanup);
@@ -147,7 +154,7 @@ function main() {
   info("Cloning GAIA framework from GitHub...");
 
   try {
-    execSync(`git clone --depth 1 ${REPO_URL} "${tempDir}"`, {
+    _exec(`git clone --depth 1 ${REPO_URL} "${tempDir}"`, {
       stdio: ["ignore", "ignore", "pipe"],
     });
   } catch (err) {
@@ -158,8 +165,8 @@ function main() {
   }
 
   // Locate the installer script
-  const scriptPath = join(tempDir, SCRIPT_NAME);
-  if (!existsSync(scriptPath)) {
+  const scriptPath = _join(tempDir, SCRIPT_NAME);
+  if (!_exists(scriptPath)) {
     fail(`Installer script not found in cloned repo: ${SCRIPT_NAME}`);
   }
 
@@ -182,7 +189,7 @@ function main() {
   info("Running installer...\n");
 
   try {
-    execFileSync(bashPath, [scriptPath, ...passthrough], {
+    _execFile(bashPath, [scriptPath, ...passthrough], {
       stdio: "inherit",
       env: { ...process.env, GAIA_SOURCE: tempDir },
     });
@@ -191,4 +198,8 @@ function main() {
   }
 }
 
-main();
+if (require.main === module) {
+  main();
+}
+
+module.exports = { findBash, ensureGit, showUsage, fail, info, cleanup, readPackageVersion, main };

package/gaia-install.sh

@@ -6,7 +6,7 @@ set -euo pipefail
 # Installs, updates, validates, and reports on GAIA installations.
 # ─────────────────────────────────────────────────────────────────────────────
 
-readonly VERSION="1.52.0"
+readonly VERSION="1.53.0"
 readonly GITHUB_REPO="https://github.com/jlouage/Gaia-framework.git"
 readonly MANIFEST_REL="_gaia/_config/manifest.yaml"
 
@@ -182,77 +182,6 @@ 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
@@ -332,22 +261,18 @@ 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
-    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
+    detail "[dry-run] Would copy _gaia/ (excluding checkpoints and .resolved/*.yaml)"
   else
     mkdir -p "$TARGET/_gaia"
-    copy_gaia_files "$source" "$TARGET"
+    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/"
   fi
 
   # Step 3: Create _memory/ directory tree at project root (ADR-013)

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "gaia-framework",
-  "version": "1.52.0",
+  "version": "1.53.0",
   "description": "GAIA — Generative Agile Intelligence Architecture installer",
   "bin": {
     "gaia-framework": "./bin/gaia-framework.js"
   },
   "scripts": {
-    "test": "vitest run",
+    "test": "vitest run --coverage",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "test:unit": "vitest run test/unit",