aether-colony 3.1.4 → 3.1.15

package/runtime/model-profiles.yaml

@@ -0,0 +1,100 @@
+version: '1.0'
+description: Default model assignments for Aether colony workers
+profile: default
+worker_models:
+  prime: glm-5
+  archaeologist: glm-5
+  architect: glm-5
+  oracle: minimax-2.5
+  route_setter: kimi-k2.5
+  builder: kimi-k2.5
+  watcher: kimi-k2.5
+  scout: kimi-k2.5
+  chaos: kimi-k2.5
+  colonizer: kimi-k2.5
+model_metadata:
+  glm-5:
+    description: '744B MoE model (40B active), long-horizon agentic engineering'
+    provider: z_ai
+    capabilities:
+      - planning
+      - coordination
+      - long_context
+      - complex_reasoning
+      - agentic_workflows
+    context_window: 200000
+    speed: medium
+    cost_tier: high
+    best_for:
+      - 'Long-horizon task execution (tested: 1 year business simulation)'
+      - Strategic coordination and planning
+      - Historical pattern analysis across large contexts
+      - Multi-step autonomous workflows
+  minimax-2.5:
+    description: Frontier model for architectural planning and agentic tool use
+    provider: minimax
+    capabilities:
+      - system_design
+      - architecture
+      - browse
+      - search
+      - task_decomposition
+    context_window: 200000
+    speed: fast
+    cost_tier: medium
+    best_for:
+      - Architectural-level planning and system design
+      - Research with browse/search (76.3% BrowseComp)
+      - Efficient task decomposition (20% fewer search rounds)
+      - Full-stack development (80.2% SWE-Bench Verified)
+  kimi-k2.5:
+    description: '1T MoE model (32B active), multimodal agent with swarm capabilities'
+    provider: kimi
+    capabilities:
+      - coding
+      - multimodal
+      - agent_swarm
+      - visual_coding
+      - validation
+    context_window: 256000
+    speed: fast
+    cost_tier: low
+    best_for:
+      - Code generation and refactoring (76.8% SWE-Bench)
+      - Visual coding (screenshots to code)
+      - Parallel exploration (up to 100 sub-agents)
+      - Validation and testing workflows
+task_routing:
+  default_model: kimi-k2.5
+  complexity_indicators:
+    complex:
+      keywords:
+        - design
+        - architecture
+        - plan
+        - coordinate
+        - synthesize
+        - strategize
+        - optimize
+      model: glm-5
+    simple:
+      keywords:
+        - implement
+        - code
+        - refactor
+        - write
+        - create
+      model: kimi-k2.5
+    validate:
+      keywords:
+        - test
+        - validate
+        - verify
+        - check
+        - review
+        - audit
+      model: minimax-2.5
+proxy:
+  endpoint: 'http://localhost:4000'
+  auth_token: ${LITELLM_AUTH_TOKEN:-sk-litellm-local}
+  health_check: 'http://localhost:4000/health'

package/runtime/recover.sh

@@ -0,0 +1,136 @@
+#!/bin/bash
+# Aether v3.1 Recovery Script
+# Run this after reading RECOVERY-PLAN.md
+
+set -e
+
+echo "╔══════════════════════════════════════════════════════════════╗"
+echo "║     AETHER v3.1 RECOVERY - RUNNING SYNC                      ║"
+echo "╚══════════════════════════════════════════════════════════════╝"
+echo ""
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Step 1: Check if we're in the right place
+if [ ! -f "package.json" ] || [ ! -d ".aether" ] || [ ! -d "runtime" ]; then
+    echo -e "${RED}ERROR: Must run from Aether repo root${NC}"
+    exit 1
+fi
+
+# Step 2: Commit any staged changes
+echo "Step 1: Checking git status..."
+if ! git diff --cached --quiet; then
+    echo "Found staged changes. Committing..."
+    git commit -m "recovery: staged changes before sync"
+fi
+
+# Step 3: Sync runtime/ from .aether/
+echo ""
+echo "Step 2: Syncing runtime/ from .aether/..."
+echo "------------------------------------------"
+
+# Core files
+echo "  → workers.md"
+cp .aether/workers.md runtime/workers.md
+
+echo "  → aether-utils.sh"
+cp .aether/aether-utils.sh runtime/aether-utils.sh
+
+echo "  → verification-loop.md"
+cp .aether/verification-loop.md runtime/verification-loop.md 2>/dev/null || echo "    (skipped - not in .aether)"
+
+# Utils - sync all files
+echo ""
+echo "  → utilities/"
+for file in .aether/utils/*.sh; do
+    if [ -f "$file" ]; then
+        filename=$(basename "$file")
+        echo "     copying $filename"
+        cp "$file" "runtime/utils/$filename"
+    fi
+done
+
+# Docs - ensure runtime/docs/ exists and has files
+if [ -d ".aether/docs" ]; then
+    echo ""
+    echo "  → docs/"
+    mkdir -p runtime/docs
+    for file in .aether/docs/*.md .aether/docs/*.json 2>/dev/null; do
+        if [ -f "$file" ]; then
+            filename=$(basename "$file")
+            echo "     copying $filename"
+            cp "$file" "runtime/docs/$filename"
+        fi
+    done
+fi
+
+# Step 4: Verify the sync
+echo ""
+echo "Step 3: Verifying sync..."
+echo "------------------------------------------"
+
+# Check emoji section
+if grep -q "Caste Emoji Mapping:" runtime/workers.md; then
+    echo -e "${GREEN}  ✓ workers.md has emoji section${NC}"
+else
+    echo -e "${RED}  ✗ workers.md MISSING emoji section${NC}"
+fi
+
+# Check get_caste_emoji
+if grep -q "get_caste_emoji()" runtime/aether-utils.sh; then
+    echo -e "${GREEN}  ✓ aether-utils.sh has get_caste_emoji${NC}"
+else
+    echo -e "${RED}  ✗ aether-utils.sh MISSING get_caste_emoji${NC}"
+fi
+
+# Count utils files
+RUNTIME_UTILS=$(ls runtime/utils/*.sh 2>/dev/null | wc -l)
+AETHER_UTILS=$(ls .aether/utils/*.sh 2>/dev/null | wc -l)
+echo "  → runtime/utils: $RUNTIME_UTILS files"
+echo "  → .aether/utils: $AETHER_UTILS files"
+
+if [ "$RUNTIME_UTILS" -eq "$AETHER_UTILS" ]; then
+    echo -e "${GREEN}  ✓ Utils counts match${NC}"
+else
+    echo -e "${YELLOW}  ⚠ Utils counts differ (may be okay if some are .aether-specific)${NC}"
+fi
+
+# Step 5: Stage the changes
+echo ""
+echo "Step 4: Staging changes..."
+git add runtime/
+
+# Show status
+echo ""
+echo "Git status after sync:"
+git status --short runtime/
+
+# Step 6: Instructions
+echo ""
+echo "╔══════════════════════════════════════════════════════════════╗"
+echo "║     RECOVERY SYNC COMPLETE                                   ║"
+echo "╚══════════════════════════════════════════════════════════════╝"
+echo ""
+echo "Next steps:"
+echo ""
+echo "  1. Review the changes:"
+echo "     git diff --cached runtime/"
+echo ""
+echo "  2. Commit the sync:"
+echo "     git commit -m 'sync: runtime/ updated from working .aether/'"
+echo ""
+echo "  3. Reinstall to update hub:"
+echo "     npm install -g ."
+echo ""
+echo "  4. Verify hub updated:"
+echo "     grep 'Caste Emoji Mapping:' ~/.aether/system/workers.md"
+echo ""
+echo "  5. Test in this repo:"
+echo "     /ant:init 'Test recovery'"
+echo ""
+echo "Remember: .aether/ is the SOURCE OF TRUTH. runtime/ is auto-populated by bin/sync-to-runtime.sh"
+echo ""

package/runtime/templates/QUEEN.md.template

@@ -0,0 +1,79 @@
+# QUEEN.md — Colony Wisdom
+
+> Last evolved: {TIMESTAMP}
+> Colonies contributed: 0
+> Wisdom version: 1.0.0
+
+---
+
+## 📜 Philosophies
+
+Core beliefs that guide all colony work. These are validated through repeated successful application across multiple colonies.
+
+*No philosophies recorded yet. Philosophies are promoted from PHILOSOPHY pheromones after 5+ validations.*
+
+---
+
+## 🧭 Patterns
+
+Validated approaches that consistently work. These represent discovered best practices that have proven themselves in the field.
+
+*No patterns recorded yet. Patterns are promoted from PATTERN pheromones after 3+ validations.*
+
+---
+
+## ⚠️ Redirects
+
+Anti-patterns to avoid. These represent approaches that have caused problems and should be redirected away from.
+
+*No redirects recorded yet. Redirects are promoted from REDIRECT pheromones after 2+ triggers.*
+
+---
+
+## 🔧 Stack Wisdom
+
+Technology-specific insights and constraints detected through codebase analysis.
+
+*No stack wisdom recorded yet. Stack wisdom is auto-populated by `/ant:colonize`.*
+
+---
+
+## 🏛️ Decrees
+
+User-mandated rules that override other guidance. These represent explicit directives from the Queen.
+
+*No decrees recorded yet. Decrees are added via `/ant:decree "<rule>"`.*
+
+---
+
+## 📊 Evolution Log
+
+Track how wisdom has evolved over time.
+
+| Date | Colony | Change | Details |
+|------|--------|--------|---------|
+| {TIMESTAMP} | system | initialized | QUEEN.md created from template |
+
+---
+
+<!-- METADATA
+{
+  "version": "1.0.0",
+  "last_evolved": "{TIMESTAMP}",
+  "colonies_contributed": [],
+  "promotion_thresholds": {
+    "philosophy": 5,
+    "pattern": 3,
+    "redirect": 2,
+    "stack": 1,
+    "decree": 0
+  },
+  "stats": {
+    "total_philosophies": 0,
+    "total_patterns": 0,
+    "total_redirects": 0,
+    "total_stack_entries": 0,
+    "total_decrees": 0
+  }
+}
+-->

package/runtime/utils/atomic-write.sh

@@ -62,6 +62,11 @@ atomic_write() {
         return 1
     fi
 
+    # Create backup if target exists (do this BEFORE validation to avoid race condition)
+    if [ -f "$target_file" ]; then
+        create_backup "$target_file"
+    fi
+
     # Validate JSON if it's a JSON file
     if [[ "$target_file" == *.json ]]; then
         if ! python3 -c "import json; json.load(open('$temp_file'))" 2>/dev/null; then
@@ -71,11 +76,6 @@ atomic_write() {
         fi
     fi
 
-    # Create backup if target exists
-    if [ -f "$target_file" ]; then
-        create_backup "$target_file"
-    fi
-
     # Atomic rename (overwrites target if exists)
     if ! mv "$temp_file" "$target_file"; then
         echo "Failed to rename temp file to target: $target_file"

package/runtime/utils/chamber-utils.sh

@@ -15,9 +15,12 @@ set -euo pipefail
 LOCK_ACQUIRED=${LOCK_ACQUIRED:-false}
 CURRENT_LOCK=${CURRENT_LOCK:-""}
 
-# Get script directory for sourcing
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-AETHER_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd 2>/dev/null || echo "$SCRIPT_DIR/../..")"
+# Get script directory for sourcing (preserve parent SCRIPT_DIR if set)
+__chamber_utils_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+AETHER_ROOT="$(cd "$__chamber_utils_dir/../.." && pwd 2>/dev/null || echo "$__chamber_utils_dir/../..")"
+
+# Use parent SCRIPT_DIR if available, otherwise use local
+SCRIPT_DIR="${SCRIPT_DIR:-$__chamber_utils_dir}"
 
 # Source atomic-write for safe file operations
 [[ -f "$SCRIPT_DIR/atomic-write.sh" ]] && source "$SCRIPT_DIR/atomic-write.sh"

package/runtime/utils/error-handler.sh

@@ -0,0 +1,200 @@
+#!/bin/bash
+# Aether Colony Error Handler Module
+# Structured JSON error handling for bash utilities
+#
+# Usage: source "$SCRIPT_DIR/utils/error-handler.sh"
+#
+# Provides consistent error format between Node.js CLI and bash utilities
+
+# --- Error Code Constants (matching Node.js error codes) ---
+E_UNKNOWN="E_UNKNOWN"
+E_HUB_NOT_FOUND="E_HUB_NOT_FOUND"
+E_REPO_NOT_INITIALIZED="E_REPO_NOT_INITIALIZED"
+E_FILE_NOT_FOUND="E_FILE_NOT_FOUND"
+E_JSON_INVALID="E_JSON_INVALID"
+E_LOCK_FAILED="E_LOCK_FAILED"
+E_GIT_ERROR="E_GIT_ERROR"
+E_VALIDATION_FAILED="E_VALIDATION_FAILED"
+E_FEATURE_UNAVAILABLE="E_FEATURE_UNAVAILABLE"
+E_BASH_ERROR="E_BASH_ERROR"
+
+# --- Recovery Suggestion Functions (internal, prefixed with _) ---
+_recovery_hub_not_found() { echo '"Run: aether install"'; }
+_recovery_repo_not_init() { echo '"Run /ant:init in this repo first"'; }
+_recovery_file_not_found() { echo '"Check file path and permissions"'; }
+_recovery_json_invalid() { echo '"Validate JSON syntax"'; }
+_recovery_lock_failed() { echo '"Wait for other operations to complete"'; }
+_recovery_git_error() { echo '"Check git status and resolve conflicts"'; }
+_recovery_default() { echo 'null'; }
+
+# Get recovery suggestion based on error code
+_get_recovery() {
+  local code="$1"
+  case "$code" in
+    "$E_HUB_NOT_FOUND") _recovery_hub_not_found ;;
+    "$E_REPO_NOT_INITIALIZED") _recovery_repo_not_init ;;
+    "$E_FILE_NOT_FOUND") _recovery_file_not_found ;;
+    "$E_JSON_INVALID") _recovery_json_invalid ;;
+    "$E_LOCK_FAILED") _recovery_lock_failed ;;
+    "$E_GIT_ERROR") _recovery_git_error ;;
+    *) _recovery_default ;;
+  esac
+}
+
+# --- Enhanced json_err function ---
+# Signature: json_err [code] [message] [details] [recovery]
+# All parameters optional with sensible defaults
+json_err() {
+  local code="${1:-$E_UNKNOWN}"
+  local message="${2:-An unknown error occurred}"
+  local details="${3:-null}"
+  local recovery="${4:-}"
+  local timestamp
+  timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+  # Get recovery suggestion if not provided
+  if [[ -z "$recovery" ]]; then
+    recovery=$(_get_recovery "$code")
+  else
+    # Escape and quote the recovery string
+    recovery=$(echo "$recovery" | sed 's/"/\\"/g' | tr '\n' ' ')
+    recovery="\"$recovery\""
+  fi
+
+  # Escape message for JSON
+  local escaped_message
+  escaped_message=$(echo "$message" | sed 's/"/\\"/g' | tr '\n' ' ')
+
+  # Build details JSON
+  local details_json
+  if [[ "$details" == "null" || -z "$details" ]]; then
+    details_json="null"
+  else
+    details_json="$details"
+  fi
+
+  # Output structured JSON to stderr
+  printf '{"ok":false,"error":{"code":"%s","message":"%s","details":%s,"recovery":%s,"timestamp":"%s"}}\n' \
+    "$code" "$escaped_message" "$details_json" "$recovery" "$timestamp" >&2
+
+  # Log to activity.log (best effort)
+  if [[ -n "${DATA_DIR:-}" ]]; then
+    echo "[$timestamp] ERROR $code: $escaped_message" >> "$DATA_DIR/activity.log" 2>/dev/null || true
+  fi
+
+  exit 1
+}
+
+# --- json_warn function for non-fatal warnings ---
+# Signature: json_warn [code] [message]
+json_warn() {
+  local code="${1:-W_UNKNOWN}"
+  local message="${2:-Warning}"
+  local timestamp
+  timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+  # Escape message for JSON
+  local escaped_message
+  escaped_message=$(echo "$message" | sed 's/"/\\"/g' | tr '\n' ' ')
+
+  # Output warning JSON to stdout (not stderr - this is non-fatal)
+  printf '{"ok":true,"warning":{"code":"%s","message":"%s","timestamp":"%s"}}\n' \
+    "$code" "$escaped_message" "$timestamp"
+
+  # Log to activity.log (best effort)
+  if [[ -n "${DATA_DIR:-}" ]]; then
+    echo "[$timestamp] WARN $code: $escaped_message" >> "$DATA_DIR/activity.log" 2>/dev/null || true
+  fi
+}
+
+# --- error_handler function for trap ERR ---
+# Captures: line number, command, exit code
+# Usage: trap 'error_handler ${LINENO} "$BASH_COMMAND" $?' ERR
+error_handler() {
+  local line_num="${1:-unknown}"
+  local command="${2:-unknown}"
+  local exit_code="${3:-1}"
+  local timestamp
+  timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+  # Escape command for JSON
+  local escaped_command
+  escaped_command=$(echo "$command" | sed 's/"/\\"/g' | tr '\n' ' ')
+
+  # Build details JSON
+  local details
+  details="{\"line\":$line_num,\"command\":\"$escaped_command\",\"exit_code\":$exit_code}"
+
+  # Output structured JSON to stderr
+  printf '{"ok":false,"error":{"code":"%s","message":"Bash command failed","details":%s,"recovery":%s,"timestamp":"%s"}}\n' \
+    "$E_BASH_ERROR" "$details" "$(_recovery_default)" "$timestamp" >&2
+
+  # Log to activity.log (best effort)
+  if [[ -n "${DATA_DIR:-}" ]]; then
+    echo "[$timestamp] ERROR $E_BASH_ERROR: Command failed at line $line_num (exit $exit_code)" >> "$DATA_DIR/activity.log" 2>/dev/null || true
+  fi
+
+  exit 1
+}
+
+# --- Feature flag functions for graceful degradation ---
+# Using simple variables for bash 3.2+ compatibility (no associative arrays)
+
+# Track disabled features as colon-separated list: "feature1:reason1|feature2:reason2"
+_FEATURES_DISABLED=""
+
+# Enable a feature (remove from disabled list if present)
+feature_enable() {
+  local name="$1"
+  # Remove from disabled list if present
+  _FEATURES_DISABLED=$(echo "$_FEATURES_DISABLED" | sed "s/:$name:[^|]*//g" | sed 's/^|//;s/|$//')
+}
+
+# Disable a feature with reason
+feature_disable() {
+  local name="$1"
+  local reason="${2:-disabled}"
+  # Remove existing entry if present, then add new
+  _FEATURES_DISABLED=$(echo "$_FEATURES_DISABLED" | sed "s/:$name:[^|]*//g")
+  if [[ -z "$_FEATURES_DISABLED" ]]; then
+    _FEATURES_DISABLED=":$name:$reason"
+  else
+    _FEATURES_DISABLED="${_FEATURES_DISABLED}|:$name:$reason"
+  fi
+}
+
+# Check if feature is enabled (returns 0 if enabled, 1 if disabled)
+feature_enabled() {
+  local name="$1"
+  if echo "$_FEATURES_DISABLED" | grep -q ":$name:"; then
+    return 1
+  fi
+  return 0
+}
+
+# Get reason for feature being disabled
+_feature_reason() {
+  local name="$1"
+  echo "$_FEATURES_DISABLED" | grep -o ":$name:[^|]*" | sed "s/:$name://" || echo "unknown"
+}
+
+# Log degradation warning
+feature_log_degradation() {
+  local name="$1"
+  local reason="${2:-}"
+  if [[ -z "$reason" ]]; then
+    reason=$(_feature_reason "$name")
+  fi
+  json_warn "W_DEGRADED" "Feature '$name' is disabled: $reason"
+}
+
+# --- Export all functions and variables ---
+export -f json_err json_warn error_handler
+export -f feature_enable feature_disable feature_enabled feature_log_degradation
+export -f _get_recovery _recovery_hub_not_found _recovery_repo_not_init
+export -f _recovery_file_not_found _recovery_json_invalid _recovery_lock_failed
+export -f _recovery_git_error _recovery_default _feature_reason
+export E_UNKNOWN E_HUB_NOT_FOUND E_REPO_NOT_INITIALIZED E_FILE_NOT_FOUND
+export E_JSON_INVALID E_LOCK_FAILED E_GIT_ERROR E_VALIDATION_FAILED
+export E_FEATURE_UNAVAILABLE E_BASH_ERROR
+export _FEATURES_DISABLED