gaia-framework 1.66.0 → 1.83.2

package/gaia-install.sh

@@ -76,6 +76,7 @@ TARGET=""
 OPT_YES=false
 OPT_DRY_RUN=false
 OPT_VERBOSE=false
+OPT_BRANCH=""
 
 # ─── Utility Functions ──────────────────────────────────────────────────────
 
@@ -95,7 +96,11 @@ clone_from_github() {
   fi
   TEMP_CLONE_DIR="$(mktemp -d "${TMPDIR:-/tmp}/gaia-framework-XXXXXX")"
   info "Cloning GAIA from GitHub..." >&2
-  if git clone --depth 1 "$GITHUB_REPO" "$TEMP_CLONE_DIR" 2>/dev/null; then
+  local branch_args=()
+  if [[ -n "$OPT_BRANCH" ]]; then
+    branch_args=(--branch "$OPT_BRANCH")
+  fi
+  if git clone --depth 1 "${branch_args[@]}" "$GITHUB_REPO" "$TEMP_CLONE_DIR" 2>/dev/null; then
     success "Cloned to temporary directory" >&2
   else
     error "Failed to clone from $GITHUB_REPO"
@@ -495,7 +500,7 @@ cmd_init() {
 
   # Step 8: Create custom directories (ADR-020: user-owned write targets)
   step "Creating custom directories..."
-  for cdir in skills templates; do
+  for cdir in skills templates stakeholders; do
     if [[ "$OPT_DRY_RUN" == true ]]; then
       detail "[dry-run] Would create: custom/$cdir/"
     else
@@ -628,6 +633,35 @@ cmd_update() {
     "_config/manifest.yaml"
   )
 
+  # ─── Migrate .customize.yaml files before _gaia/ overwrite (E10-S19, FR-153) ──
+  # Copy user customize.yaml files from _gaia/_config/agents/ to custom/skills/
+  # before the framework overwrite replaces _gaia/ contents with defaults.
+  # Copy-only semantics: originals are left in place as fallback (AC2).
+  step "Migrating customize.yaml files to custom/skills/..."
+  if [[ "$OPT_DRY_RUN" != true ]]; then
+    mkdir -p "$TARGET/custom/skills"
+  fi
+  local migrated=0
+  for cust_file in "$TARGET/_gaia/_config/agents/"*.customize.yaml; do
+    [[ -f "$cust_file" ]] || continue
+    local cust_basename
+    cust_basename="$(basename "$cust_file")"
+    if [[ -f "$TARGET/custom/skills/$cust_basename" ]]; then
+      [[ "$OPT_VERBOSE" == true ]] && detail "Skipped (already exists): custom/skills/$cust_basename"
+      continue
+    fi
+    if [[ "$OPT_DRY_RUN" == true ]]; then
+      detail "[dry-run] Would migrate: _gaia/_config/agents/$cust_basename → custom/skills/$cust_basename"
+    else
+      cp "$cust_file" "$TARGET/custom/skills/$cust_basename"
+      info "[migrate] _gaia/_config/agents/$cust_basename → custom/skills/$cust_basename"
+      migrated=$((migrated + 1))
+    fi
+  done
+  if [[ "$migrated" -gt 0 ]]; then
+    detail "Migrated $migrated customize.yaml file(s) to custom/skills/"
+  fi
+
   step "Updating framework files..."
   local updated=0 skipped=0 changed=0
 
@@ -690,7 +724,7 @@ cmd_update() {
   done
 
   # Ensure custom directories exist (user-owned, never overwritten — ADR-020)
-  for cdir in skills templates; do
+  for cdir in skills templates stakeholders; do
     if [[ "$OPT_DRY_RUN" == true ]]; then
       [[ ! -d "$TARGET/custom/$cdir" ]] && detail "[dry-run] Would create: custom/$cdir/"
     else
@@ -740,6 +774,29 @@ cmd_update() {
     fi
   fi
 
+  # ─── Post-install verification: check skill references in customize.yaml (E10-S19, AC4) ──
+  step "Verifying skill references in custom/skills/*.customize.yaml..."
+  for cust_file in "$TARGET/custom/skills/"*.customize.yaml; do
+    [[ -f "$cust_file" ]] || continue
+    local cust_name
+    cust_name="$(basename "$cust_file")"
+    # Extract source: values from customize.yaml (simple grep — no full YAML parser needed)
+    while IFS= read -r source_line; do
+      # Strip key prefix, leading whitespace, and surrounding quotes via parameter expansion
+      local ref_path="${source_line#*source:}"
+      ref_path="${ref_path#"${ref_path%%[![:space:]]*}"}"  # trim leading whitespace
+      ref_path="${ref_path#[\"\']}"                        # trim leading quote
+      ref_path="${ref_path%[\"\']}"                        # trim trailing quote
+      [[ -z "$ref_path" ]] && continue
+      # Resolve relative paths against TARGET
+      local full_path="$TARGET/$ref_path"
+      [[ "$ref_path" == /* ]] && full_path="$ref_path"
+      if [[ ! -f "$full_path" ]]; then
+        warn "[warn] Broken skill reference in $cust_name: $ref_path not found"
+      fi
+    done < <(grep 'source:' "$cust_file" || true)
+  done
+
   # Summary
   echo ""
   if [[ -d "$backup_dir" ]]; then
@@ -832,9 +889,10 @@ cmd_validate() {
     [[ -d "$TARGET/docs/$dir" ]]; check "Docs: $dir" $?
   done
 
-  # Custom directories (ADR-020: user-owned write targets)
+  # Custom directories (ADR-020: user-owned write targets, ADR-026: stakeholder agents)
   [[ -d "$TARGET/custom/skills" ]]; check "custom/skills/ exists" $?
   [[ -d "$TARGET/custom/templates" ]]; check "custom/templates/ exists" $?
+  [[ -d "$TARGET/custom/stakeholders" ]]; check "custom/stakeholders/ exists" $?
 
   # Version
   local version
@@ -938,6 +996,7 @@ ${BOLD}Commands:${RESET}
 
 ${BOLD}Options:${RESET}
   --source <path>   Local GAIA source (or clones from GitHub if omitted)
+  --branch <name>   Clone from a specific branch
   --yes             Skip confirmation prompts
   --dry-run         Show what would be done without making changes
   --verbose         Show detailed progress
@@ -1011,6 +1070,14 @@ parse_args() {
         OPT_VERBOSE=true
         shift
         ;;
+      --branch)
+        if [[ -z "${2:-}" ]]; then
+          error "--branch requires a branch name argument"
+          exit 1
+        fi
+        OPT_BRANCH="$2"
+        shift 2
+        ;;
       --help|-h)
         usage
         exit 0

package/package.json

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

package/_gaia/_memory/tier2-results/checkpoint-resume-2026-03-24.yaml

@@ -1,6 +0,0 @@
-test_name: "checkpoint-resume-reliability"
-date: "2026-03-24"
-result: "pass"
-observations: "All 10 test scenarios passed. Checkpoint validation (schema, checksums, legacy format), resume state reconstruction (happy path, error cases), and file modification detection (modified, deleted) all verified. 45 total tests: 31 unit + 14 Tier 2."
-runner: "Cleo (typescript-dev)"
-framework_version: "1.48.3"

package/_gaia/_memory/tier2-results/engine-scenarios-2026-03-22.yaml

@@ -1,14 +0,0 @@
-test_name: engine-scenarios
-date: "2026-03-22T00:00:00Z"
-result: pass
-observations: |
-  All 6 ACs validated via 18 structural tests:
-  - AC1: Step ordering verified in workflow.xml and dev-story instructions.xml (4 tests)
-  - AC2: Checkpoint YAML schema validated with all required fields (3 tests)
-  - AC3: Quality gate structure validated across all workflow configs (3 tests)
-  - AC4: Variable resolution verified — all vars in known set, engine requires global.yaml (3 tests)
-  - AC5: Execution mode switching definitions validated in workflow.xml (3 tests)
-  - AC6: tier2-results directory exists, result YAML schema validated (2 tests)
-  Zero regressions in existing Tier 1 tests (3486 passing).
-runner: vitest
-framework_version: "1.45.0"