aether-colony 5.1.0 → 5.2.1

package/.aether/utils/queen.sh

@@ -488,8 +488,9 @@ _queen_promote() {
     ev_separator=$(grep -n "^|------|" "$tmp_file" | tail -1 | cut -d: -f1 || true)
 
     # Use awk for cross-platform insertion (only if separator found)
+    # Use ENVIRON instead of -v for user content to avoid C-escape interpretation (\n, \t, \\)
     if [[ -n "$ev_separator" ]]; then
-      awk -v line="$ev_separator" -v entry="$ev_entry" 'NR==line{print; print entry; next}1' "$tmp_file" > "${tmp_file}.ev" && mv "${tmp_file}.ev" "$tmp_file"
+      AETHER_EV_ENTRY="$ev_entry" awk -v line="$ev_separator" 'NR==line{print; print ENVIRON["AETHER_EV_ENTRY"]; next}1' "$tmp_file" > "${tmp_file}.ev" && mv "${tmp_file}.ev" "$tmp_file"
     fi
 
     # Update METADATA stats in temp file
@@ -528,9 +529,10 @@ _queen_promote() {
     ev_log_entry="{\"timestamp\": \"$ts\", \"action\": \"promote\", \"wisdom_type\": \"$wisdom_type\", \"content_hash\": \"$content_hash\", \"colony\": \"$colony_name\"}"
 
     # Check if evolution_log exists in metadata, add if not
+    # Use ENVIRON instead of -v for user content to avoid C-escape interpretation (\n, \t, \\)
     if ! grep -q '"evolution_log"' "$tmp_file"; then
       # Add evolution_log array after stats
-      awk -v entry="$ev_log_entry" '
+      AETHER_EV_LOG_ENTRY="$ev_log_entry" awk '
         /"stats": \{/ {
           print
           # Read until closing brace of stats
@@ -540,19 +542,19 @@ _queen_promote() {
           }
           # Add comma and evolution_log
           print ","
-          print "  \"evolution_log\": [" entry "]"
+          print "  \"evolution_log\": [" ENVIRON["AETHER_EV_LOG_ENTRY"] "]"
           next
         }
         { print }
       ' "$tmp_file" > "${tmp_file}.evlog" && mv "${tmp_file}.evlog" "$tmp_file"
     else
       # Append to existing evolution_log array
-      awk -v entry="$ev_log_entry" '
+      AETHER_EV_LOG_ENTRY="$ev_log_entry" awk '
         /"evolution_log": \[/ {
           # Check if array is empty or has items
           if (/\]/) {
             # Empty array - replace with entry
-            gsub(/"evolution_log": \[\]/, "\"evolution_log\": [" entry "]")
+            gsub(/"evolution_log": \[\]/, "\"evolution_log\": [" ENVIRON["AETHER_EV_LOG_ENTRY"] "]")
           } else {
             # Has items - need to add before closing bracket
             # For now, just print and handle in next iteration
@@ -566,7 +568,7 @@ _queen_promote() {
           getline
           if (/\]/) {
             # Was empty, now add entry
-            print entry
+            print ENVIRON["AETHER_EV_LOG_ENTRY"]
             print "]"
           } else {
             # Has items, add comma and entry before closing
@@ -574,7 +576,7 @@ _queen_promote() {
             while (getline > 0) {
               if (/^\s*\]/) {
                 print ","
-                print entry
+                print ENVIRON["AETHER_EV_LOG_ENTRY"]
                 print "]"
                 break
               }
@@ -628,12 +630,18 @@ _queen_promote() {
       if [[ -n "$meta_section" ]]; then
         # SUPPRESS:OK -- read-default: returns fallback on failure
         updated_meta=$(echo "$meta_section" | jq --arg hash "$content_hash" --argjson cols "$colonies_json" '.colonies_contributed[$hash] = $cols' 2>/dev/null || echo "$meta_section")
-        # Replace metadata section
-        new_comment="<!-- METADATA"
-        new_comment="$new_comment
-$updated_meta
--->"
-        awk -v new="$new_comment" '/<!-- METADATA/,/-->/{ if (/<!-- METADATA/) print new; next }1' "$tmp_file" > "${tmp_file}.metaupd" && mv "${tmp_file}.metaupd" "$tmp_file"
+        # Replace metadata section using head/tail to handle multi-line content safely
+        # awk -v cannot handle embedded newlines in variable values (C-escape interpretation)
+        local meta_start_line meta_end_line
+        meta_start_line=$(grep -n "^<!-- METADATA$" "$tmp_file" | head -1 | cut -d: -f1)
+        meta_end_line=$(grep -n "^-->$" "$tmp_file" | head -1 | cut -d: -f1)
+        if [[ -n "$meta_start_line" && -n "$meta_end_line" ]]; then
+          {
+            head -n $((meta_start_line - 1)) "$tmp_file"
+            printf '<!-- METADATA\n%s\n-->\n' "$updated_meta"
+            tail -n +$((meta_end_line + 1)) "$tmp_file"
+          } > "${tmp_file}.metaupd" && mv "${tmp_file}.metaupd" "$tmp_file"
+        fi
       fi
     fi
 
@@ -837,7 +845,8 @@ _queen_write_learnings() {
     local ev_separator
     ev_separator=$(grep -n "^|------|" "$tmp_file" | tail -1 | cut -d: -f1 || true)
     if [[ -n "$ev_separator" ]]; then
-      awk -v line="$ev_separator" -v entry="$ev_entry" 'NR==line{print; print entry; next}1' "$tmp_file" > "${tmp_file}.ev" && mv "${tmp_file}.ev" "$tmp_file"
+      # Use ENVIRON instead of -v for user content to avoid C-escape interpretation (\n, \t, \\)
+      AETHER_EV_ENTRY="$ev_entry" awk -v line="$ev_separator" 'NR==line{print; print ENVIRON["AETHER_EV_ENTRY"]; next}1' "$tmp_file" > "${tmp_file}.ev" && mv "${tmp_file}.ev" "$tmp_file"
     fi
 
     # Update METADATA stats: increment total_build_learnings
@@ -967,7 +976,8 @@ _queen_promote_instinct() {
     local ev_separator
     ev_separator=$(grep -n "^|------|" "$tmp_file" | tail -1 | cut -d: -f1 || true)
     if [[ -n "$ev_separator" ]]; then
-      awk -v line="$ev_separator" -v entry="$ev_entry" 'NR==line{print; print entry; next}1' "$tmp_file" > "${tmp_file}.ev" && mv "${tmp_file}.ev" "$tmp_file"
+      # Use ENVIRON instead of -v for user content to avoid C-escape interpretation (\n, \t, \\)
+      AETHER_EV_ENTRY="$ev_entry" awk -v line="$ev_separator" 'NR==line{print; print ENVIRON["AETHER_EV_ENTRY"]; next}1' "$tmp_file" > "${tmp_file}.ev" && mv "${tmp_file}.ev" "$tmp_file"
     fi
 
     # Update METADATA stats: increment total_instincts
@@ -1110,7 +1120,8 @@ _queen_seed_from_hive() {
     local ev_separator
     ev_separator=$(grep -n "^|------|" "$tmp_file" | tail -1 | cut -d: -f1 || true)
     if [[ -n "$ev_separator" ]]; then
-      awk -v line="$ev_separator" -v entry="$ev_entry" 'NR==line{print; print entry; next}1' "$tmp_file" > "${tmp_file}.ev" && mv "${tmp_file}.ev" "$tmp_file"
+      # Use ENVIRON instead of -v for user content to avoid C-escape interpretation (\n, \t, \\)
+      AETHER_EV_ENTRY="$ev_entry" awk -v line="$ev_separator" 'NR==line{print; print ENVIRON["AETHER_EV_ENTRY"]; next}1' "$tmp_file" > "${tmp_file}.ev" && mv "${tmp_file}.ev" "$tmp_file"
     fi
 
     # Update METADATA stats: increment total_codebase_patterns
@@ -1601,7 +1612,8 @@ _queen_write_charter() {
     local ev_separator
     ev_separator=$(grep -n "^|------|" "$tmp_file" | tail -1 | cut -d: -f1 || true)
     if [[ -n "$ev_separator" ]]; then
-        awk -v line="$ev_separator" -v entry="$ev_entry" 'NR==line{print; print entry; next}1' "$tmp_file" > "${tmp_file}.ev" && mv "${tmp_file}.ev" "$tmp_file"
+        # Use ENVIRON instead of -v for user content to avoid C-escape interpretation (\n, \t, \\)
+        AETHER_EV_ENTRY="$ev_entry" awk -v line="$ev_separator" 'NR==line{print; print ENVIRON["AETHER_EV_ENTRY"]; next}1' "$tmp_file" > "${tmp_file}.ev" && mv "${tmp_file}.ev" "$tmp_file"
     fi
 
     # Update METADATA stats -- count non-charter list items in each section, add charter entries

package/.aether/utils/session.sh

@@ -550,3 +550,267 @@ _session_summary() {
       [[ "$cleared" == "true" ]] && echo "Status: Context was cleared"
     fi
 }
+
+# ============================================================================
+# _pending_decision_add
+# Add a decision to the pending decisions queue
+# Usage: pending-decision-add --type <type> --description <desc> [--phase N] [--source <src>]
+# Types: visual_checkpoint, replan, escalation, runtime_verification, user_input
+# ============================================================================
+_pending_decision_add() {
+    local pd_type=""
+    local pd_description=""
+    local pd_phase="null"
+    local pd_source=""
+
+    while [[ $# -gt 0 ]]; do
+      case "$1" in
+        --type) pd_type="$2"; shift 2 ;;
+        --description) pd_description="$2"; shift 2 ;;
+        --phase) pd_phase="$2"; shift 2 ;;
+        --source) pd_source="$2"; shift 2 ;;
+        *) shift ;;
+      esac
+    done
+
+    [[ -z "$pd_type" ]] && json_err "$E_VALIDATION_FAILED" "pending-decision-add requires --type"
+    [[ -z "$pd_description" ]] && json_err "$E_VALIDATION_FAILED" "pending-decision-add requires --description"
+
+    local pd_file="$COLONY_DATA_DIR/pending-decisions.json"
+    local pd_id="pd_$(date +%s)_$$"
+    local pd_now
+    pd_now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+    # Acquire lock for concurrent access
+    if type acquire_lock &>/dev/null; then
+      acquire_lock "$pd_file" || json_err "$E_LOCK_FAILED" "Failed to acquire lock on pending-decisions.json"
+      trap 'release_lock 2>/dev/null || true' EXIT  # SUPPRESS:OK -- cleanup: lock may not be held
+    fi
+
+    # Initialize file if missing
+    if [[ ! -f "$pd_file" ]]; then
+      echo '{"version":"1.0","decisions":[]}' > "$pd_file"
+    fi
+
+    local pd_current
+    pd_current=$(cat "$pd_file" 2>/dev/null || echo '{"version":"1.0","decisions":[]}')  # SUPPRESS:OK -- read-default: file may not exist yet
+
+    # Build new decision entry
+    local pd_phase_val
+    if [[ "$pd_phase" == "null" ]]; then
+      pd_phase_val="null"
+    else
+      pd_phase_val="$pd_phase"
+    fi
+
+    local pd_updated
+    pd_updated=$(echo "$pd_current" | jq \
+      --arg id "$pd_id" \
+      --arg type "$pd_type" \
+      --arg description "$pd_description" \
+      --argjson phase "${pd_phase_val}" \
+      --arg source "$pd_source" \
+      --arg created_at "$pd_now" \
+      '.decisions += [{
+        id: $id,
+        type: $type,
+        description: $description,
+        phase: $phase,
+        source: $source,
+        created_at: $created_at,
+        resolved: false
+      }]' 2>/dev/null) || {
+      type release_lock &>/dev/null && release_lock 2>/dev/null || true  # SUPPRESS:OK -- cleanup: lock may not be held
+      json_err "$E_JSON_INVALID" "Failed to append decision to pending-decisions.json"
+    }
+
+    atomic_write "$pd_file" "$pd_updated" || {
+      type release_lock &>/dev/null && release_lock 2>/dev/null || true  # SUPPRESS:OK -- cleanup: lock may not be held
+      json_err "$E_JSON_INVALID" "Failed to write pending-decisions.json"
+    }
+
+    type release_lock &>/dev/null && { release_lock 2>/dev/null || true; trap - EXIT; }  # SUPPRESS:OK -- cleanup: lock may not be held
+
+    local pd_count
+    pd_count=$(echo "$pd_updated" | jq '.decisions | length')
+
+    json_ok "$(jq -n --arg id "$pd_id" --argjson count "$pd_count" \
+      '{id: $id, decision_count: $count}')"
+}
+
+# ============================================================================
+# _pending_decision_list
+# List decisions from the pending decisions queue
+# Usage: pending-decision-list [--unresolved] [--type <type>]
+# Default: show only unresolved
+# ============================================================================
+_pending_decision_list() {
+    local pd_unresolved_only="true"
+    local pd_filter_type=""
+
+    while [[ $# -gt 0 ]]; do
+      case "$1" in
+        --unresolved) pd_unresolved_only="true"; shift ;;
+        --type) pd_filter_type="$2"; shift 2 ;;
+        *) shift ;;
+      esac
+    done
+
+    local pd_file="$COLONY_DATA_DIR/pending-decisions.json"
+
+    if [[ ! -f "$pd_file" ]]; then
+      json_ok '{"total":0,"unresolved":0,"decisions":[]}'
+      exit 0
+    fi
+
+    local pd_data
+    pd_data=$(cat "$pd_file" 2>/dev/null || echo '{"version":"1.0","decisions":[]}')  # SUPPRESS:OK -- read-default: file may not exist yet
+
+    # Build jq filter
+    local pd_filter='.decisions'
+
+    # Apply type filter if provided
+    if [[ -n "$pd_filter_type" ]]; then
+      pd_filter="$pd_filter | map(select(.type == \"$pd_filter_type\"))"
+    fi
+
+    # Apply resolved filter (default: only unresolved)
+    if [[ "$pd_unresolved_only" == "true" ]]; then
+      pd_filter="$pd_filter | map(select(.resolved == false))"
+    fi
+
+    local pd_total pd_unresolved pd_decisions
+    pd_total=$(echo "$pd_data" | jq '.decisions | length')
+    pd_unresolved=$(echo "$pd_data" | jq '[.decisions[] | select(.resolved == false)] | length')
+    pd_decisions=$(echo "$pd_data" | jq "$pd_filter")
+
+    json_ok "$(jq -n --argjson total "$pd_total" --argjson unresolved "$pd_unresolved" \
+      --argjson decisions "$pd_decisions" \
+      '{total: $total, unresolved: $unresolved, decisions: $decisions}')"
+}
+
+# ============================================================================
+# _pending_decision_resolve
+# Mark a pending decision as resolved
+# Usage: pending-decision-resolve --id <id> --resolution <text>
+# ============================================================================
+_pending_decision_resolve() {
+    local pd_id=""
+    local pd_resolution=""
+
+    while [[ $# -gt 0 ]]; do
+      case "$1" in
+        --id) pd_id="$2"; shift 2 ;;
+        --resolution) pd_resolution="$2"; shift 2 ;;
+        *) shift ;;
+      esac
+    done
+
+    [[ -z "$pd_id" ]] && json_err "$E_VALIDATION_FAILED" "pending-decision-resolve requires --id"
+    [[ -z "$pd_resolution" ]] && json_err "$E_VALIDATION_FAILED" "pending-decision-resolve requires --resolution"
+
+    local pd_file="$COLONY_DATA_DIR/pending-decisions.json"
+
+    if [[ ! -f "$pd_file" ]]; then
+      json_err "$E_RESOURCE_NOT_FOUND" "No pending decisions file found"
+    fi
+
+    # Acquire lock for concurrent access
+    if type acquire_lock &>/dev/null; then
+      acquire_lock "$pd_file" || json_err "$E_LOCK_FAILED" "Failed to acquire lock on pending-decisions.json"
+      trap 'release_lock 2>/dev/null || true' EXIT  # SUPPRESS:OK -- cleanup: lock may not be held
+    fi
+
+    local pd_data
+    pd_data=$(cat "$pd_file" 2>/dev/null || echo '{"version":"1.0","decisions":[]}')  # SUPPRESS:OK -- read-default: file may not exist yet
+
+    # Check if ID exists
+    local pd_exists
+    pd_exists=$(echo "$pd_data" | jq --arg id "$pd_id" '[.decisions[] | select(.id == $id)] | length')
+    if [[ "$pd_exists" -eq 0 ]]; then
+      type release_lock &>/dev/null && release_lock 2>/dev/null || true  # SUPPRESS:OK -- cleanup: lock may not be held
+      json_err "$E_RESOURCE_NOT_FOUND" "Decision not found: $pd_id"
+    fi
+
+    local pd_now
+    pd_now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+    local pd_updated
+    pd_updated=$(echo "$pd_data" | jq \
+      --arg id "$pd_id" \
+      --arg resolution "$pd_resolution" \
+      --arg resolved_at "$pd_now" \
+      '(.decisions[] | select(.id == $id)) |= (. + {resolved: true, resolution: $resolution, resolved_at: $resolved_at})' 2>/dev/null) || {
+      type release_lock &>/dev/null && release_lock 2>/dev/null || true  # SUPPRESS:OK -- cleanup: lock may not be held
+      json_err "$E_JSON_INVALID" "Failed to resolve decision in pending-decisions.json"
+    }
+
+    atomic_write "$pd_file" "$pd_updated" || {
+      type release_lock &>/dev/null && release_lock 2>/dev/null || true  # SUPPRESS:OK -- cleanup: lock may not be held
+      json_err "$E_JSON_INVALID" "Failed to write pending-decisions.json"
+    }
+
+    type release_lock &>/dev/null && { release_lock 2>/dev/null || true; trap - EXIT; }  # SUPPRESS:OK -- cleanup: lock may not be held
+
+    json_ok "$(jq -n --arg id "$pd_id" '{resolved: true, id: $id}')"
+}
+
+# ============================================================================
+# _autopilot_headless_check
+# Check whether headless mode is active in run-state.json
+# Usage: autopilot-headless-check
+# Returns: {"ok":true,"result":{"headless":true|false}}
+# ============================================================================
+_autopilot_headless_check() {
+    local ah_state_file="$COLONY_DATA_DIR/run-state.json"
+
+    if [[ ! -f "$ah_state_file" ]]; then
+      json_ok '{"headless":false}'
+      exit 0
+    fi
+
+    local ah_headless
+    ah_headless=$(jq -r '.headless // false' "$ah_state_file" 2>/dev/null || echo "false")  # SUPPRESS:OK -- read-default: field may not exist
+
+    # Normalize to boolean
+    if [[ "$ah_headless" == "true" ]]; then
+      json_ok '{"headless":true}'
+    else
+      json_ok '{"headless":false}'
+    fi
+}
+
+# ============================================================================
+# _autopilot_set_headless
+# Set the headless flag in run-state.json
+# Usage: autopilot-set-headless <true|false>
+# Returns: {"ok":true,"result":{"headless":true|false,"updated":true}}
+# ============================================================================
+_autopilot_set_headless() {
+    local ah_value="${1:-}"
+
+    if [[ "$ah_value" != "true" && "$ah_value" != "false" ]]; then
+      json_err "$E_VALIDATION_FAILED" "autopilot-set-headless requires true or false argument"
+    fi
+
+    local ah_state_file="$COLONY_DATA_DIR/run-state.json"
+
+    if [[ ! -f "$ah_state_file" ]]; then
+      json_err "$E_FILE_NOT_FOUND" "run-state.json not found — autopilot not active"
+    fi
+
+    local ah_headless_bool
+    [[ "$ah_value" == "true" ]] && ah_headless_bool=true || ah_headless_bool=false
+
+    local ah_current ah_updated
+    ah_current=$(cat "$ah_state_file" 2>/dev/null || echo '{}')  # SUPPRESS:OK -- read-default: file may not exist yet
+    ah_updated=$(echo "$ah_current" | jq --argjson headless "$ah_headless_bool" '.headless = $headless' 2>/dev/null) || {
+      json_err "$E_JSON_INVALID" "Failed to update headless flag in run-state.json"
+    }
+
+    atomic_write "$ah_state_file" "$ah_updated" || {
+      json_err "$E_JSON_INVALID" "Failed to write run-state.json"
+    }
+
+    json_ok "$(jq -n --argjson headless "$ah_headless_bool" '{headless: $headless, updated: true}')"
+}

package/.aether/utils/spawn-tree.sh

@@ -51,9 +51,9 @@ parse_spawn_tree() {
     printf "\"spawns\":["
     for (i = 0; i < n; i++) {
       if (i > 0) printf ","
-      nm = names[i]; gsub(/\\/, "\\\\", nm); gsub(/"/, "\\\"", nm); gsub(/\t/, "\\t", nm)
-      pr = parents[i]; gsub(/\\/, "\\\\", pr); gsub(/"/, "\\\"", pr); gsub(/\t/, "\\t", pr)
-      tk = tasks[i]; gsub(/\\/, "\\\\", tk); gsub(/"/, "\\\"", tk); gsub(/\t/, "\\t", tk)
+      nm = names[i]; gsub(/\\/, "\\\\", nm); gsub(/"/, "\\\"", nm); gsub(/\t/, "\\t", nm); gsub(/\n/, "\\n", nm); gsub(/\r/, "\\r", nm)
+      pr = parents[i]; gsub(/\\/, "\\\\", pr); gsub(/"/, "\\\"", pr); gsub(/\t/, "\\t", pr); gsub(/\n/, "\\n", pr); gsub(/\r/, "\\r", pr)
+      tk = tasks[i]; gsub(/\\/, "\\\\", tk); gsub(/"/, "\\\"", tk); gsub(/\t/, "\\t", tk); gsub(/\n/, "\\n", tk); gsub(/\r/, "\\r", tk)
       printf "{\"name\":\"%s\",\"parent\":\"%s\",\"caste\":\"%s\",", nm, pr, castes[i]
       printf "\"task\":\"%s\",\"status\":\"%s\",", tk, statuses[i]
       printf "\"spawned_at\":\"%s\",\"completed_at\":\"%s\",", timestamps[i], completed_at[i]
@@ -63,7 +63,7 @@ parse_spawn_tree() {
         for (j = 1; j <= length(cidxs); j++) {
           if (j > 1) printf ","
           cn = names[cidxs[j]+0]
-          gsub(/\\/, "\\\\", cn); gsub(/"/, "\\\"", cn); gsub(/\t/, "\\t", cn)
+          gsub(/\\/, "\\\\", cn); gsub(/"/, "\\\"", cn); gsub(/\t/, "\\t", cn); gsub(/\n/, "\\n", cn); gsub(/\r/, "\\r", cn)
           printf "\"%s\"", cn
         }
       }
@@ -149,9 +149,9 @@ get_active_spawns() {
       if (!(spawn_names[i] in done_set)) {
         if (!first) printf ","
         first = 0
-        nm = spawn_names[i]; gsub(/\\/, "\\\\", nm); gsub(/"/, "\\\"", nm); gsub(/\t/, "\\t", nm)
-        pr = spawn_parents[i]; gsub(/\\/, "\\\\", pr); gsub(/"/, "\\\"", pr); gsub(/\t/, "\\t", pr)
-        tk = spawn_tasks[i]; gsub(/\\/, "\\\\", tk); gsub(/"/, "\\\"", tk); gsub(/\t/, "\\t", tk)
+        nm = spawn_names[i]; gsub(/\\/, "\\\\", nm); gsub(/"/, "\\\"", nm); gsub(/\t/, "\\t", nm); gsub(/\n/, "\\n", nm); gsub(/\r/, "\\r", nm)
+        pr = spawn_parents[i]; gsub(/\\/, "\\\\", pr); gsub(/"/, "\\\"", pr); gsub(/\t/, "\\t", pr); gsub(/\n/, "\\n", pr); gsub(/\r/, "\\r", pr)
+        tk = spawn_tasks[i]; gsub(/\\/, "\\\\", tk); gsub(/"/, "\\\"", tk); gsub(/\t/, "\\t", tk); gsub(/\n/, "\\n", tk); gsub(/\r/, "\\r", tk)
         printf "{\"name\":\"%s\",\"caste\":\"%s\",\"parent\":\"%s\",\"task\":\"%s\",\"spawned_at\":\"%s\"}", nm, spawn_castes[i], pr, tk, spawn_ts[i]
       }
     }

package/.aether/utils/spawn.sh

@@ -25,7 +25,7 @@ _spawn_log() {
     emoji=$(get_caste_emoji "$child_caste")
     parent_emoji=$(get_caste_emoji "$parent_id")
     # Log to activity log with spawn format, emojis, and model info
-    echo "[$ts] ⚡ SPAWN $parent_emoji $parent_id -> $emoji $child_name ($child_caste): $task_summary [model: $model]" >> "$COLONY_DATA_DIR/activity.log"
+    [[ "${AETHER_TESTING:-}" != "1" ]] && echo "[$ts] ⚡ SPAWN $parent_emoji $parent_id -> $emoji $child_name ($child_caste): $task_summary [model: $model]" >> "$COLONY_DATA_DIR/activity.log"
     # Log to spawn tree file for visualization (NEW FORMAT: includes model field)
     echo "$ts_full|$parent_id|$child_caste|$child_name|$task_summary|$model|$status" >> "$COLONY_DATA_DIR/spawn-tree.txt"
     # Return emoji-formatted result for display (jq-safe: child_name may contain JSON-special chars)
@@ -46,7 +46,7 @@ _spawn_complete() {
     status_icon="✅"
     [[ "$status" == "failed" ]] && status_icon="❌"
     [[ "$status" == "blocked" ]] && status_icon="🚫"
-    echo "[$ts] $status_icon $emoji $ant_name: $status${summary:+ - $summary}" >> "$COLONY_DATA_DIR/activity.log"
+    [[ "${AETHER_TESTING:-}" != "1" ]] && echo "[$ts] $status_icon $emoji $ant_name: $status${summary:+ - $summary}" >> "$COLONY_DATA_DIR/activity.log"
     # Update spawn tree
     echo "$ts_full|$ant_name|$status|$summary" >> "$COLONY_DATA_DIR/spawn-tree.txt"
     # Log failed spawns to events array as pipe-delimited strings (matching template format)

package/.aether/utils/state-api.sh

@@ -1,6 +1,7 @@
 #!/bin/bash
 # State API facade -- centralized COLONY_STATE.json access
-# Provides: _state_read, _state_write, _state_read_field, _state_mutate, _state_migrate
+# Provides: _state_read, _state_write, _state_read_field, _state_mutate, _state_migrate,
+#           _colony_vital_signs
 #
 # These functions are sourced by aether-utils.sh at startup.
 # All shared infrastructure (json_ok, json_err, atomic_write, acquire_lock,
@@ -197,3 +198,192 @@ _state_migrate() {
         [[ "$sm_lock_held" == "true" ]] && release_lock 2>/dev/null || true  # SUPPRESS:OK -- cleanup: lock may not be held
     fi
 }
+
+# ============================================================================
+# _colony_vital_signs
+# Compute colony health metrics from existing data files
+# Usage: colony-vital-signs
+# Returns: JSON with build_velocity, error_rate, signal_health, memory_pressure,
+#          colony_age_hours, and overall_health (0-100)
+# Gracefully degrades: missing files produce zero/default values
+# ============================================================================
+_colony_vital_signs() {
+    local cvs_state_file="$COLONY_DATA_DIR/COLONY_STATE.json"
+    local cvs_midden_file="$COLONY_DATA_DIR/midden/midden.json"
+    local cvs_phero_file="$COLONY_DATA_DIR/pheromones.json"
+    local cvs_session_file="$COLONY_DATA_DIR/session.json"
+
+    # --- Compute 24h window boundary ---
+    local cvs_now
+    cvs_now=$(date -u +%s 2>/dev/null || echo "0")
+    local cvs_window_start=$(( cvs_now - 86400 ))
+
+    # ---- build_velocity: count phase_completed events in last 24h ----
+    local cvs_phases_per_day=0
+    if [[ -f "$cvs_state_file" ]]; then
+        cvs_phases_per_day=$(jq --argjson win "$cvs_window_start" '
+            [.events[]? |
+             select(. != null) |
+             select(test("\\|phase_completed\\|")) |
+             capture("^(?P<ts>[^|]+)\\|") |
+             .ts |
+             gsub("[TZ:-]"; " ") |
+             split(" ") |
+             if length >= 6 then
+               (.[0:6] | join(" ")) |
+               # convert to comparable string for ordering -- full ISO compare
+               . as $s | $s
+             else . end
+            ] | length
+        ' "$cvs_state_file" 2>/dev/null || echo "0")
+
+        # Simpler approach: use string comparison on ISO timestamps
+        # Compute the 24h-ago timestamp as ISO string
+        local cvs_cutoff_iso
+        cvs_cutoff_iso=$(date -u -r "$cvs_window_start" '+%Y-%m-%dT%H:%M:%SZ' 2>/dev/null \
+            || date -u -d "@$cvs_window_start" '+%Y-%m-%dT%H:%M:%SZ' 2>/dev/null \
+            || echo "")
+
+        if [[ -n "$cvs_cutoff_iso" ]]; then
+            cvs_phases_per_day=$(jq --arg cutoff "$cvs_cutoff_iso" '
+                [.events[]? |
+                 select(. != null and (type == "string")) |
+                 select(test("\\|phase_completed\\|")) |
+                 split("|") | .[0] |
+                 select(. >= $cutoff)
+                ] | length
+            ' "$cvs_state_file" 2>/dev/null || echo "0")
+        fi
+    fi
+    # Normalize: ensure integer
+    cvs_phases_per_day=$(( cvs_phases_per_day + 0 )) 2>/dev/null || cvs_phases_per_day=0
+
+    # Determine trend (simple heuristic: any builds = steady, 0 = idle)
+    local cvs_bv_trend="idle"
+    [[ "$cvs_phases_per_day" -ge 1 ]] && cvs_bv_trend="steady"
+    [[ "$cvs_phases_per_day" -ge 3 ]] && cvs_bv_trend="accelerating"
+
+    # ---- error_rate: unreviewed midden entries in last 24h ----
+    local cvs_errors_per_day=0
+    local cvs_err_status="clean"
+    if [[ -f "$cvs_midden_file" ]]; then
+        local cvs_cutoff_iso_err
+        cvs_cutoff_iso_err=$(date -u -r "$cvs_window_start" '+%Y-%m-%dT%H:%M:%SZ' 2>/dev/null \
+            || date -u -d "@$cvs_window_start" '+%Y-%m-%dT%H:%M:%SZ' 2>/dev/null \
+            || echo "")
+
+        if [[ -n "$cvs_cutoff_iso_err" ]]; then
+            cvs_errors_per_day=$(jq --arg cutoff "$cvs_cutoff_iso_err" '
+                [(.entries // [])[]? |
+                 select(.reviewed == false or .reviewed == null) |
+                 select((.timestamp // "") >= $cutoff)
+                ] | length
+            ' "$cvs_midden_file" 2>/dev/null || echo "0")
+        else
+            # Fallback: count all unreviewed
+            cvs_errors_per_day=$(jq '
+                [(.entries // [])[]? | select(.reviewed == false or .reviewed == null)] | length
+            ' "$cvs_midden_file" 2>/dev/null || echo "0")
+        fi
+    fi
+    cvs_errors_per_day=$(( cvs_errors_per_day + 0 )) 2>/dev/null || cvs_errors_per_day=0
+
+    if [[ "$cvs_errors_per_day" -eq 0 ]]; then
+        cvs_err_status="clean"
+    elif [[ "$cvs_errors_per_day" -le 2 ]]; then
+        cvs_err_status="nominal"
+    elif [[ "$cvs_errors_per_day" -le 5 ]]; then
+        cvs_err_status="elevated"
+    else
+        cvs_err_status="critical"
+    fi
+
+    # ---- signal_health: count active pheromones ----
+    local cvs_active_count=0
+    local cvs_sig_status="dormant"
+    if [[ -f "$cvs_phero_file" ]]; then
+        cvs_active_count=$(jq '
+            [.signals[]? | select(.active == true)] | length
+        ' "$cvs_phero_file" 2>/dev/null || echo "0")
+    fi
+    cvs_active_count=$(( cvs_active_count + 0 )) 2>/dev/null || cvs_active_count=0
+
+    if [[ "$cvs_active_count" -eq 0 ]]; then
+        cvs_sig_status="dormant"
+    elif [[ "$cvs_active_count" -le 3 ]]; then
+        cvs_sig_status="guided"
+    else
+        cvs_sig_status="active"
+    fi
+
+    # ---- memory_pressure: count instincts ----
+    local cvs_instinct_count=0
+    local cvs_mem_status="empty"
+    if [[ -f "$cvs_state_file" ]]; then
+        # instincts may be a JSON string (serialized array) or a real array
+        local cvs_raw_instincts
+        cvs_raw_instincts=$(jq -r '.memory.instincts // "[]"' "$cvs_state_file" 2>/dev/null || echo "[]")
+        # Handle both string-encoded and native array
+        cvs_instinct_count=$(echo "$cvs_raw_instincts" | jq -r 'if type == "string" then (. | fromjson | length) elif type == "array" then length else 0 end' 2>/dev/null || echo "0")
+    fi
+    cvs_instinct_count=$(( cvs_instinct_count + 0 )) 2>/dev/null || cvs_instinct_count=0
+
+    if [[ "$cvs_instinct_count" -eq 0 ]]; then
+        cvs_mem_status="empty"
+    elif [[ "$cvs_instinct_count" -le 5 ]]; then
+        cvs_mem_status="growing"
+    elif [[ "$cvs_instinct_count" -le 15 ]]; then
+        cvs_mem_status="healthy"
+    else
+        cvs_mem_status="rich"
+    fi
+
+    # ---- colony_age_hours: hours since initialized_at ----
+    local cvs_age_hours=0
+    if [[ -f "$cvs_state_file" ]]; then
+        local cvs_init_at
+        cvs_init_at=$(jq -r '.initialized_at // empty' "$cvs_state_file" 2>/dev/null || echo "")
+        if [[ -n "$cvs_init_at" ]]; then
+            local cvs_init_ts
+            cvs_init_ts=$(date -u -j -f '%Y-%m-%dT%H:%M:%SZ' "$cvs_init_at" '+%s' 2>/dev/null \
+                || date -u -d "$cvs_init_at" '+%s' 2>/dev/null \
+                || echo "0")
+            if [[ "$cvs_init_ts" -gt 0 && "$cvs_now" -gt "$cvs_init_ts" ]]; then
+                cvs_age_hours=$(( (cvs_now - cvs_init_ts) / 3600 ))
+            fi
+        fi
+    fi
+
+    # ---- overall_health: weighted 0-100 score ----
+    # Components (max points each):
+    #   recent builds (+30): has at least one phase_completed in 24h
+    #   low errors (+30):    zero unreviewed errors in 24h
+    #   signals exist (+20): at least one active pheromone
+    #   instincts growing (+20): at least one instinct
+    local cvs_score=0
+    [[ "$cvs_phases_per_day" -ge 1 ]] && cvs_score=$(( cvs_score + 30 ))
+    [[ "$cvs_errors_per_day" -eq 0 ]] && cvs_score=$(( cvs_score + 30 ))
+    [[ "$cvs_active_count" -ge 1 ]] && cvs_score=$(( cvs_score + 20 ))
+    [[ "$cvs_instinct_count" -ge 1 ]] && cvs_score=$(( cvs_score + 20 ))
+    [[ "$cvs_score" -gt 100 ]] && cvs_score=100
+
+    json_ok "$(jq -n \
+        --argjson phases_per_day "$cvs_phases_per_day" \
+        --arg bv_trend "$cvs_bv_trend" \
+        --argjson errors_per_day "$cvs_errors_per_day" \
+        --arg err_status "$cvs_err_status" \
+        --argjson active_count "$cvs_active_count" \
+        --arg sig_status "$cvs_sig_status" \
+        --argjson instinct_count "$cvs_instinct_count" \
+        --arg mem_status "$cvs_mem_status" \
+        --argjson age_hours "$cvs_age_hours" \
+        --argjson overall_health "$cvs_score" \
+        '{
+            build_velocity:   {phases_per_day: $phases_per_day, trend: $bv_trend},
+            error_rate:       {errors_per_day: $errors_per_day, status: $err_status},
+            signal_health:    {active_count: $active_count, status: $sig_status},
+            memory_pressure:  {instinct_count: $instinct_count, status: $mem_status},
+            colony_age_hours: $age_hours,
+            overall_health:   $overall_health
+        }')"
+}

package/.claude/commands/ant/colonize.md

@@ -69,6 +69,8 @@ Read `.aether/data/COLONY_STATE.json`.
 
 **If the file exists:** continue.
 
+**If `milestone` == `"Crowned Anthill"`:** output "This colony has been sealed. Start a new colony with `/ant:init \"new goal\"`.", stop.
+
 **If `plan.phases` is not empty:** output "Colony already has phases. Use /ant:continue.", stop.
 
 ### Step 2: Quick Surface Scan (for session context)